gestament 0.1.0 → 0.2.0

package/dist/element.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 import { NativeElementHandle } from './native.js';

package/dist/errors.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 import { GtkAutomationError } from './types.js';

package/dist/generated/packageMetadata.d.ts

@@ -1,18 +1,18 @@
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 export declare const name = "gestament";
-export declare const version = "0.1.0";
+export declare const version = "0.2.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 = "82eaccb340f7304524549a1f95888845deb4a156";
 //# 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.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 export interface GestamentConfigOutput {

package/dist/gestament-tray-host.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 "use strict";
-const native = require("./native-BRnrsqMn.cjs");
+const native = require("./native-ie_XIt1J.cjs");
 try {
   native.nativeRunTrayHost();
 } catch (error) {

package/dist/gestament-tray-host.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 export {};

package/dist/gestament-tray-host.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { S as nativeRunTrayHost } from "./native-DAhTiLnf.js";
+import { S as nativeRunTrayHost } from "./native-DUeVYIBs.js";
 try {
   nativeRunTrayHost();
 } catch (error) {

package/dist/gestament-xvfb-worker.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 export {};

package/dist/gestament-xvfb.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /*!
  * name: gestament
- * version: 0.1.0
+ * version: 0.2.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: 82eaccb340f7304524549a1f95888845deb4a156
  */
 
 export {};

package/dist/index.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const node_child_process = require("node:child_process");
-const native = require("./native-BRnrsqMn.cjs");
+const native = require("./native-ie_XIt1J.cjs");
 /*!
 * name: async-primitives
 * version: 1.7.0
@@ -852,6 +852,33 @@ const assertNonNegativeIndex = (name, index) => {
     );
   }
 };
+const parseElementPath = (path) => {
+  const segments = path.split(/[.:;,]/u);
+  const id = segments[0];
+  if (id === void 0 || id.length === 0) {
+    throw native.createGtkInvalidArgumentError(
+      "path must start with an accessible id."
+    );
+  }
+  const childIndexes = [];
+  for (let index = 1; index < segments.length; index += 1) {
+    const segment = segments[index];
+    if (segment === void 0 || !/^\d+$/u.test(segment)) {
+      throw native.createGtkInvalidArgumentError(
+        "path child indexes must be non-negative decimal integers."
+      );
+    }
+    const childIndex = Number(segment);
+    if (!Number.isSafeInteger(childIndex)) {
+      throw native.createGtkInvalidArgumentError(
+        "path child indexes must be safe non-negative integers."
+      );
+    }
+    childIndexes.push(childIndex);
+  }
+  return { id, childIndexes };
+};
+const isPathChildContainer = (element) => "childAt" in element;
 const waitForAtspiReady = async (state, command, timeoutMs, startedAt) => {
   if (state.atspiReady) {
     return assertProcessRunning(state, command);
@@ -946,6 +973,50 @@ const launchGtkApp = (appPath, args, options) => {
     }
     return element;
   };
+  const findByPath = async (path) => {
+    const parsedPath = parseElementPath(path);
+    const startedAt = Date.now();
+    await waitForAtspiReady(state, appPath, _timeoutMs, startedAt);
+    while (Date.now() - startedAt <= _timeoutMs) {
+      const processId = assertProcessRunning(state, appPath);
+      try {
+        const handle = native.nativeFindById(processId, parsedPath.id);
+        if (handle !== void 0) {
+          let element = createGtkElement(handle);
+          let resolved = true;
+          for (const childIndex of parsedPath.childIndexes) {
+            if (!isPathChildContainer(element)) {
+              resolved = false;
+              break;
+            }
+            const child2 = await element.childAt(childIndex);
+            if (child2 === void 0) {
+              resolved = false;
+              break;
+            }
+            element = child2;
+          }
+          if (resolved) {
+            return element;
+          }
+        }
+      } catch (error) {
+        throw native.normalizeNativeError(error);
+      }
+      await delay(50);
+    }
+    assertProcessRunning(state, appPath);
+    return void 0;
+  };
+  const getByPath = async (path) => {
+    const element = await findByPath(path);
+    if (element === void 0) {
+      throw native.createGtkElementNotFoundError(
+        `Element path was not found: ${path}`
+      );
+    }
+    return element;
+  };
   const findTrayItem = async (selector) => {
     const startedAt = Date.now();
     while (Date.now() - startedAt <= _timeoutMs) {
@@ -989,7 +1060,9 @@ const launchGtkApp = (appPath, args, options) => {
       }
     },
     findById,
+    findByPath,
     getById,
+    getByPath,
     windowAt: async (index) => {
       assertNonNegativeIndex("index", index);
       const processId = await waitForAtspiReady(