gestament 0.1.0 → 0.3.0

package/README.md

@@ -66,7 +66,7 @@ describe('sample GTK app', () => {
 - These APIs can be used to check and manipulate widget states.
 - Captures the rendering output of GTK applications to verify the display area and clip state.
 - Detects StatusNotifierItem-based tray icons and allows you to click them, retrieve metadata, and capture screenshots.
-- Runs GTK applications on `xvfb` to enable stable testing in headless environments.
+- Runs GTK applications on launcher-scoped `xvfb` sessions to enable stable testing in headless and concurrent environments.
 
 ### Environment
 
@@ -86,14 +86,12 @@ The following example is for Debian/Ubuntu:
 ```bash
 sudo apt-get update
 sudo apt-get install -y \
-  at-spi2-core dbus dbus-x11 \
-  libx11-6 libxtst6 \
-  xauth xvfb
+  at-spi2-core dbus dbus-x11 libx11-6 libxtst6 xauth xvfb
 ```
 
 - `at-spi2-core` is the AT-SPI runtime environment that gestament uses to identify and operate widgets.
 - `libx11-6` and `libxtst6` are used for X11 screen capture and input operations.
-- `dbus` / `dbus-x11` and `xvfb` / `xauth` are used when running tests headlessly with `gestament-xvfb`.
+- `dbus` / `dbus-x11` and `xvfb` / `xauth` are used when running tests headlessly with gestament's launcher-scoped internal Xvfb sessions or `gestament-xvfb`.
 
 This completes the native environment setup.
 
@@ -115,7 +113,7 @@ npm install -D vitest @types/node gestament
 
 ## Documentation
 
-See [the repository documentation](https://github.com/kekyo/gestament/).
+More information, see [the repository documentation](https://github.com/kekyo/gestament/).
 
 ## License
 

package/dist/displaySession.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * name: gestament
+ * version: 0.3.0
+ * description: TypeScript based test driver for GTK
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/gestament.git
+ * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
+ */
+
+import { GtkAppLauncher, GtkAppLauncherOptions } from './types.js';
+/**
+ * Creates a driver-backed launcher that owns a display session per launcher.
+ * @param options Launcher options.
+ * @returns GtkAppLauncher instance.
+ */
+export declare const createDriverBackedGtkAppLauncher: (options: GtkAppLauncherOptions) => GtkAppLauncher;
+//# sourceMappingURL=displaySession.d.ts.map

package/dist/displaySession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displaySession.d.ts","sourceRoot":"","sources":["../src/displaySession.ts"],"names":[],"mappings":";;;;;;;;;AAyCA,OAAO,KAAK,EAGV,cAAc,EACd,qBAAqB,EAUtB,MAAM,SAAS,CAAC;AAq1DjB;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAC3C,SAAS,qBAAqB,KAC7B,cAgCF,CAAC"}

package/dist/element.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.3.0
  * description: TypeScript based test driver for GTK
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/gestament.git
- * git.commit.hash: 2e2298272ff7a9fff6945b8d87de6223ac4d7847
+ * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
  */
 
 import { NativeElementHandle } from './native.js';

package/dist/errors-6gj5YuLw.cjs

@@ -0,0 +1,36 @@
+"use strict";
+const createGtkAutomationError = (code, message) => {
+  const error = new Error(message);
+  Object.defineProperty(error, "code", {
+    enumerable: true,
+    value: code
+  });
+  error.name = "GtkAutomationError";
+  return error;
+};
+const createGtkAppExitedError = (message) => createGtkAutomationError("APP_EXITED", message);
+const createGtkInvalidArgumentError = (message) => createGtkAutomationError("INVALID_ARGUMENT", message);
+const createGtkElementNotFoundError = (message) => createGtkAutomationError("ELEMENT_NOT_FOUND", message);
+const createGtkStaleElementError = (message) => createGtkAutomationError("STALE_ELEMENT", message);
+const createGtkOperationTimeoutError = (message) => createGtkAutomationError("TIMEOUT", message);
+const createGtkOperationFailedError = (message) => createGtkAutomationError("OPERATION_FAILED", message);
+const createGtkUnsupportedInterfaceError = (message) => createGtkAutomationError("UNSUPPORTED_INTERFACE", message);
+const normalizeNativeError = (error) => {
+  if (error instanceof Error) {
+    const maybeCode = error.code;
+    if (maybeCode === "ELEMENT_NOT_FOUND" || maybeCode === "INVALID_ARGUMENT" || maybeCode === "NATIVE_LOAD_FAILED" || maybeCode === "OPERATION_FAILED" || maybeCode === "STALE_ELEMENT" || maybeCode === "TIMEOUT" || maybeCode === "UNSUPPORTED_INTERFACE") {
+      return createGtkAutomationError(maybeCode, error.message);
+    }
+    return createGtkAutomationError("OPERATION_FAILED", error.message);
+  }
+  return createGtkAutomationError("OPERATION_FAILED", String(error));
+};
+exports.createGtkAppExitedError = createGtkAppExitedError;
+exports.createGtkElementNotFoundError = createGtkElementNotFoundError;
+exports.createGtkInvalidArgumentError = createGtkInvalidArgumentError;
+exports.createGtkOperationFailedError = createGtkOperationFailedError;
+exports.createGtkOperationTimeoutError = createGtkOperationTimeoutError;
+exports.createGtkStaleElementError = createGtkStaleElementError;
+exports.createGtkUnsupportedInterfaceError = createGtkUnsupportedInterfaceError;
+exports.normalizeNativeError = normalizeNativeError;
+//# sourceMappingURL=errors-6gj5YuLw.cjs.map

package/dist/errors-6gj5YuLw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-6gj5YuLw.cjs","sources":["../src/errors.ts"],"sourcesContent":["// gestament - TypeScript based test driver for GTK.\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/gestament\n\nimport type { GtkAutomationError, GtkAutomationErrorCode } from './types';\n\n/////////////////////////////////////////////////////////////////////////////////////////\n\nconst createGtkAutomationError = (\n  code: GtkAutomationErrorCode,\n  message: string\n): GtkAutomationError => {\n  const error = new Error(message) as GtkAutomationError;\n  Object.defineProperty(error, 'code', {\n    enumerable: true,\n    value: code,\n  });\n  error.name = 'GtkAutomationError';\n  return error;\n};\n\n/** Creates an error for a GTK application that exited before an operation completed. */\nexport const createGtkAppExitedError = (message: string): GtkAutomationError =>\n  createGtkAutomationError('APP_EXITED', message);\n\n/** Creates an error for an invalid public API argument. */\nexport const createGtkInvalidArgumentError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('INVALID_ARGUMENT', message);\n\n/** Creates an error for an accessible element that was not found. */\nexport const createGtkElementNotFoundError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('ELEMENT_NOT_FOUND', message);\n\n/** Creates an error for an element whose host object no longer exists. */\nexport const createGtkStaleElementError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('STALE_ELEMENT', message);\n\n/** Creates an error for an operation that exceeded its timeout. */\nexport const createGtkOperationTimeoutError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('TIMEOUT', message);\n\n/** Creates an error for an operation that failed. */\nexport const createGtkOperationFailedError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('OPERATION_FAILED', message);\n\n/** Creates an error for an operation that is not supported by the element. */\nexport const createGtkUnsupportedInterfaceError = (\n  message: string\n): GtkAutomationError =>\n  createGtkAutomationError('UNSUPPORTED_INTERFACE', message);\n\n/** Converts native addon errors into the public error shape. */\nexport const normalizeNativeError = (error: unknown): GtkAutomationError => {\n  if (error instanceof Error) {\n    const maybeCode = (error as { code?: unknown }).code;\n    if (\n      maybeCode === 'ELEMENT_NOT_FOUND' ||\n      maybeCode === 'INVALID_ARGUMENT' ||\n      maybeCode === 'NATIVE_LOAD_FAILED' ||\n      maybeCode === 'OPERATION_FAILED' ||\n      maybeCode === 'STALE_ELEMENT' ||\n      maybeCode === 'TIMEOUT' ||\n      maybeCode === 'UNSUPPORTED_INTERFACE'\n    ) {\n      return createGtkAutomationError(maybeCode, error.message);\n    }\n\n    return createGtkAutomationError('OPERATION_FAILED', error.message);\n  }\n\n  return createGtkAutomationError('OPERATION_FAILED', String(error));\n};\n"],"names":[],"mappings":";AASA,MAAM,2BAA2B,CAC/B,MACA,YACuB;AACvB,QAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,SAAO,eAAe,OAAO,QAAQ;AAAA,IACnC,YAAY;AAAA,IACZ,OAAO;AAAA,EAAA,CACR;AACD,QAAM,OAAO;AACb,SAAO;AACT;AAGO,MAAM,0BAA0B,CAAC,YACtC,yBAAyB,cAAc,OAAO;AAGzC,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,oBAAoB,OAAO;AAGtE,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,qBAAqB,OAAO;AAGvE,MAAM,6BAA6B,CACxC,YACuB,yBAAyB,iBAAiB,OAAO;AAGnE,MAAM,iCAAiC,CAC5C,YACuB,yBAAyB,WAAW,OAAO;AAG7D,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,oBAAoB,OAAO;AAGtE,MAAM,qCAAqC,CAChD,YAEA,yBAAyB,yBAAyB,OAAO;AAGpD,MAAM,uBAAuB,CAAC,UAAuC;AAC1E,MAAI,iBAAiB,OAAO;AAC1B,UAAM,YAAa,MAA6B;AAChD,QACE,cAAc,uBACd,cAAc,sBACd,cAAc,wBACd,cAAc,sBACd,cAAc,mBACd,cAAc,aACd,cAAc,yBACd;AACA,aAAO,yBAAyB,WAAW,MAAM,OAAO;AAAA,IAC1D;AAEA,WAAO,yBAAyB,oBAAoB,MAAM,OAAO;AAAA,EACnE;AAEA,SAAO,yBAAyB,oBAAoB,OAAO,KAAK,CAAC;AACnE;;;;;;;;;"}

package/dist/errors-CCW4ATME.js

@@ -0,0 +1,37 @@
+const createGtkAutomationError = (code, message) => {
+  const error = new Error(message);
+  Object.defineProperty(error, "code", {
+    enumerable: true,
+    value: code
+  });
+  error.name = "GtkAutomationError";
+  return error;
+};
+const createGtkAppExitedError = (message) => createGtkAutomationError("APP_EXITED", message);
+const createGtkInvalidArgumentError = (message) => createGtkAutomationError("INVALID_ARGUMENT", message);
+const createGtkElementNotFoundError = (message) => createGtkAutomationError("ELEMENT_NOT_FOUND", message);
+const createGtkStaleElementError = (message) => createGtkAutomationError("STALE_ELEMENT", message);
+const createGtkOperationTimeoutError = (message) => createGtkAutomationError("TIMEOUT", message);
+const createGtkOperationFailedError = (message) => createGtkAutomationError("OPERATION_FAILED", message);
+const createGtkUnsupportedInterfaceError = (message) => createGtkAutomationError("UNSUPPORTED_INTERFACE", message);
+const normalizeNativeError = (error) => {
+  if (error instanceof Error) {
+    const maybeCode = error.code;
+    if (maybeCode === "ELEMENT_NOT_FOUND" || maybeCode === "INVALID_ARGUMENT" || maybeCode === "NATIVE_LOAD_FAILED" || maybeCode === "OPERATION_FAILED" || maybeCode === "STALE_ELEMENT" || maybeCode === "TIMEOUT" || maybeCode === "UNSUPPORTED_INTERFACE") {
+      return createGtkAutomationError(maybeCode, error.message);
+    }
+    return createGtkAutomationError("OPERATION_FAILED", error.message);
+  }
+  return createGtkAutomationError("OPERATION_FAILED", String(error));
+};
+export {
+  createGtkAppExitedError as a,
+  createGtkStaleElementError as b,
+  createGtkOperationFailedError as c,
+  createGtkUnsupportedInterfaceError as d,
+  createGtkOperationTimeoutError as e,
+  createGtkInvalidArgumentError as f,
+  createGtkElementNotFoundError as g,
+  normalizeNativeError as n
+};
+//# sourceMappingURL=errors-CCW4ATME.js.map

package/dist/errors-CCW4ATME.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CCW4ATME.js","sources":["../src/errors.ts"],"sourcesContent":["// gestament - TypeScript based test driver for GTK.\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/gestament\n\nimport type { GtkAutomationError, GtkAutomationErrorCode } from './types';\n\n/////////////////////////////////////////////////////////////////////////////////////////\n\nconst createGtkAutomationError = (\n  code: GtkAutomationErrorCode,\n  message: string\n): GtkAutomationError => {\n  const error = new Error(message) as GtkAutomationError;\n  Object.defineProperty(error, 'code', {\n    enumerable: true,\n    value: code,\n  });\n  error.name = 'GtkAutomationError';\n  return error;\n};\n\n/** Creates an error for a GTK application that exited before an operation completed. */\nexport const createGtkAppExitedError = (message: string): GtkAutomationError =>\n  createGtkAutomationError('APP_EXITED', message);\n\n/** Creates an error for an invalid public API argument. */\nexport const createGtkInvalidArgumentError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('INVALID_ARGUMENT', message);\n\n/** Creates an error for an accessible element that was not found. */\nexport const createGtkElementNotFoundError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('ELEMENT_NOT_FOUND', message);\n\n/** Creates an error for an element whose host object no longer exists. */\nexport const createGtkStaleElementError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('STALE_ELEMENT', message);\n\n/** Creates an error for an operation that exceeded its timeout. */\nexport const createGtkOperationTimeoutError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('TIMEOUT', message);\n\n/** Creates an error for an operation that failed. */\nexport const createGtkOperationFailedError = (\n  message: string\n): GtkAutomationError => createGtkAutomationError('OPERATION_FAILED', message);\n\n/** Creates an error for an operation that is not supported by the element. */\nexport const createGtkUnsupportedInterfaceError = (\n  message: string\n): GtkAutomationError =>\n  createGtkAutomationError('UNSUPPORTED_INTERFACE', message);\n\n/** Converts native addon errors into the public error shape. */\nexport const normalizeNativeError = (error: unknown): GtkAutomationError => {\n  if (error instanceof Error) {\n    const maybeCode = (error as { code?: unknown }).code;\n    if (\n      maybeCode === 'ELEMENT_NOT_FOUND' ||\n      maybeCode === 'INVALID_ARGUMENT' ||\n      maybeCode === 'NATIVE_LOAD_FAILED' ||\n      maybeCode === 'OPERATION_FAILED' ||\n      maybeCode === 'STALE_ELEMENT' ||\n      maybeCode === 'TIMEOUT' ||\n      maybeCode === 'UNSUPPORTED_INTERFACE'\n    ) {\n      return createGtkAutomationError(maybeCode, error.message);\n    }\n\n    return createGtkAutomationError('OPERATION_FAILED', error.message);\n  }\n\n  return createGtkAutomationError('OPERATION_FAILED', String(error));\n};\n"],"names":[],"mappings":"AASA,MAAM,2BAA2B,CAC/B,MACA,YACuB;AACvB,QAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,SAAO,eAAe,OAAO,QAAQ;AAAA,IACnC,YAAY;AAAA,IACZ,OAAO;AAAA,EAAA,CACR;AACD,QAAM,OAAO;AACb,SAAO;AACT;AAGO,MAAM,0BAA0B,CAAC,YACtC,yBAAyB,cAAc,OAAO;AAGzC,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,oBAAoB,OAAO;AAGtE,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,qBAAqB,OAAO;AAGvE,MAAM,6BAA6B,CACxC,YACuB,yBAAyB,iBAAiB,OAAO;AAGnE,MAAM,iCAAiC,CAC5C,YACuB,yBAAyB,WAAW,OAAO;AAG7D,MAAM,gCAAgC,CAC3C,YACuB,yBAAyB,oBAAoB,OAAO;AAGtE,MAAM,qCAAqC,CAChD,YAEA,yBAAyB,yBAAyB,OAAO;AAGpD,MAAM,uBAAuB,CAAC,UAAuC;AAC1E,MAAI,iBAAiB,OAAO;AAC1B,UAAM,YAAa,MAA6B;AAChD,QACE,cAAc,uBACd,cAAc,sBACd,cAAc,wBACd,cAAc,sBACd,cAAc,mBACd,cAAc,aACd,cAAc,yBACd;AACA,aAAO,yBAAyB,WAAW,MAAM,OAAO;AAAA,IAC1D;AAEA,WAAO,yBAAyB,oBAAoB,MAAM,OAAO;AAAA,EACnE;AAEA,SAAO,yBAAyB,oBAAoB,OAAO,KAAK,CAAC;AACnE;"}

package/dist/errors.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.3.0
  * description: TypeScript based test driver for GTK
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/gestament.git
- * git.commit.hash: 2e2298272ff7a9fff6945b8d87de6223ac4d7847
+ * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
  */
 
 import { GtkAutomationError } from './types.js';

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAiB1E,2FAAwF;AACxF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,KAAG,kBACT,CAAC;AAElD,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA2E,CAAC;AAE/E,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA4E,CAAC;AAEhF,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,KACd,kBAAwE,CAAC;AAE5E,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,GACzC,SAAS,MAAM,KACd,kBAAkE,CAAC;AAEtE,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA2E,CAAC;AAE/E,8EAA8E;AAC9E,eAAO,MAAM,kCAAkC,GAC7C,SAAS,MAAM,KACd,kBACyD,CAAC;AAE7D,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,kBAkBrD,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAiB1E,2FAAwF;AACxF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,KAAG,kBACT,CAAC;AAElD,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA2E,CAAC;AAE/E,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA4E,CAAC;AAEhF,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM,KACd,kBAAwE,CAAC;AAE5E,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,GACzC,SAAS,MAAM,KACd,kBAAkE,CAAC;AAEtE,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,KACd,kBAA2E,CAAC;AAE/E,8EAA8E;AAC9E,eAAO,MAAM,kCAAkC,GAC7C,SAAS,MAAM,KACd,kBACyD,CAAC;AAE7D,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,kBAmBrD,CAAC"}

package/dist/generated/packageMetadata.d.ts

@@ -1,18 +1,18 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.3.0
  * description: TypeScript based test driver for GTK
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/gestament.git
- * git.commit.hash: 2e2298272ff7a9fff6945b8d87de6223ac4d7847
+ * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
  */
 
 export declare const name = "gestament";
-export declare const version = "0.1.0";
+export declare const version = "0.3.0";
 export declare const description = "TypeScript based test driver for GTK";
 export declare const author = "Kouji Matsui (@kekyo@mi.kekyo.net)";
 export declare const license = "MIT";
 export declare const repository_url = "https://github.com/kekyo/gestament.git";
-export declare const git_commit_hash = "2e2298272ff7a9fff6945b8d87de6223ac4d7847";
+export declare const git_commit_hash = "c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4";
 //# sourceMappingURL=packageMetadata.d.ts.map

package/dist/gestament-config.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.3.0
  * description: TypeScript based test driver for GTK
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/gestament.git
- * git.commit.hash: 2e2298272ff7a9fff6945b8d87de6223ac4d7847
+ * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
  */
 
 export interface GestamentConfigOutput {