gestament 0.1.0 → 0.2.0

package/dist/index.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
  */
 
 export * from './types.js';

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { n as nativeElementInfo, a as nativeClick, b as nativeImageInfo, c as nativeCaptureBounds, d as nativeTableDeselectColumn, e as nativeTableSelectColumn, f as nativeTableDeselectRow, g as nativeTableSelectRow, h as nativeTableIsCellSelected, i as nativeTableIsColumnSelected, j as nativeTableIsRowSelected, k as nativeTableSelectedColumns, l as nativeTableSelectedRows, m as nativeTableColumnCount, o as nativeTableRowCount, p as nativeClearSelection, q as nativeSelectAllChildren, r as nativeDeselectChildAt, s as nativeSelectChildAt, t as nativeIsChildSelected, u as nativeSelectedChildAt, v as nativeSelectedChildCount, w as createGtkOperationFailedError, x as nativeChildCount, y as nativeChildAt, z as nativeValueInfo, A as nativeSetValue, B as nativeText, C as nativeSetText, D as nativeCapture, E as createGtkInvalidArgumentError, F as nativeTableCellAt, G as createGtkUnsupportedInterfaceError, H as createGtkElementNotFoundError, I as nativeFindAnyById, J as nativeTrayItems, K as createGtkStaleElementError, L as normalizeNativeError, M as nativeWindowCount, N as nativeWindowAt, O as nativeCaptureScreen, P as nativeFindById, Q as createGtkAppExitedError, R as nativeProcessAtspiReadiness } from "./native-DAhTiLnf.js";
+import { n as nativeElementInfo, a as nativeClick, b as nativeImageInfo, c as nativeCaptureBounds, d as nativeTableDeselectColumn, e as nativeTableSelectColumn, f as nativeTableDeselectRow, g as nativeTableSelectRow, h as nativeTableIsCellSelected, i as nativeTableIsColumnSelected, j as nativeTableIsRowSelected, k as nativeTableSelectedColumns, l as nativeTableSelectedRows, m as nativeTableColumnCount, o as nativeTableRowCount, p as nativeClearSelection, q as nativeSelectAllChildren, r as nativeDeselectChildAt, s as nativeSelectChildAt, t as nativeIsChildSelected, u as nativeSelectedChildAt, v as nativeSelectedChildCount, w as createGtkOperationFailedError, x as nativeChildCount, y as nativeChildAt, z as nativeValueInfo, A as nativeSetValue, B as nativeText, C as nativeSetText, D as nativeCapture, E as createGtkInvalidArgumentError, F as nativeTableCellAt, G as createGtkUnsupportedInterfaceError, H as createGtkElementNotFoundError, I as nativeFindAnyById, J as nativeTrayItems, K as createGtkStaleElementError, L as normalizeNativeError, M as nativeWindowCount, N as nativeWindowAt, O as nativeCaptureScreen, P as nativeFindById, Q as createGtkAppExitedError, R as nativeProcessAtspiReadiness } from "./native-DUeVYIBs.js";
 /*!
 * name: async-primitives
 * version: 1.7.0
@@ -850,6 +850,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 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 createGtkInvalidArgumentError(
+        "path child indexes must be non-negative decimal integers."
+      );
+    }
+    const childIndex = Number(segment);
+    if (!Number.isSafeInteger(childIndex)) {
+      throw 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);
@@ -944,6 +971,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 = 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 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 createGtkElementNotFoundError(
+        `Element path was not found: ${path}`
+      );
+    }
+    return element;
+  };
   const findTrayItem = async (selector) => {
     const startedAt = Date.now();
     while (Date.now() - startedAt <= _timeoutMs) {
@@ -987,7 +1058,9 @@ const launchGtkApp = (appPath, args, options) => {
       }
     },
     findById,
+    findByPath,
     getById,
+    getByPath,
     windowAt: async (index) => {
       assertNonNegativeIndex("index", index);
       const processId = await waitForAtspiReady(