gestament 0.1.0

package/dist/native.d.ts

@@ -0,0 +1,170 @@
+/*!
+ * name: gestament
+ * version: 0.1.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
+ */
+
+export interface NativeCaptureBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface NativeCapture {
+    readonly image: Buffer;
+    readonly bounds: NativeCaptureBounds;
+    readonly visibleBounds: NativeCaptureBounds;
+    readonly clipped: boolean;
+}
+export interface NativeElementInfo {
+    readonly roleName: string;
+    readonly localizedRoleName: string;
+    readonly accessibleId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly interfaces: string[];
+    readonly states: string[];
+}
+/** AT-SPI Value metadata returned by the native layer. */
+export interface NativeValueInfo {
+    /** Current numeric value. */
+    readonly value: number;
+    /** Minimum accepted numeric value. */
+    readonly minimum: number;
+    /** Maximum accepted numeric value. */
+    readonly maximum: number;
+    /** Minimum increment used by step-based controls. */
+    readonly minimumIncrement: number;
+    /** Text representation reported by AT-SPI, when available. */
+    readonly text: string;
+}
+/** Point returned by the native layer. */
+export interface NativeImagePoint {
+    /** Horizontal pixel coordinate. */
+    readonly x: number;
+    /** Vertical pixel coordinate. */
+    readonly y: number;
+}
+/** Image size returned by the native layer. */
+export interface NativeImageSize {
+    /** Image width in physical pixels. */
+    readonly width: number;
+    /** Image height in physical pixels. */
+    readonly height: number;
+}
+/** AT-SPI Image metadata returned by the native layer. */
+export interface NativeImageInfo {
+    /** Text description reported by AT-SPI. */
+    readonly description: string;
+    /** Image locale reported by AT-SPI. */
+    readonly locale: string;
+    /** Image position reported by AT-SPI. */
+    readonly position: NativeImagePoint;
+    /** Image size reported by AT-SPI. */
+    readonly size: NativeImageSize;
+    /** Screen-relative image bounds reported by AT-SPI. */
+    readonly bounds: NativeCaptureBounds;
+}
+/** Opaque native element handle backed by an AT-SPI accessible proxy. */
+export type NativeElementHandle = object;
+/** AT-SPI readiness state reported by the native layer. */
+export type NativeAtspiReadiness = 'ready' | 'missing-bus-name' | 'missing-root' | 'missing-cache';
+/** StatusNotifier tray item metadata reported by the native layer. */
+export interface NativeTrayItem {
+    readonly busName: string;
+    readonly objectPath: string;
+    readonly id: string;
+    readonly title: string;
+    readonly status: string;
+    readonly iconName: string;
+    readonly accessibleId: string;
+}
+/** Resolves an accessible id to a native element when it exists. */
+export declare const nativeFindById: (processId: number, id: string) => NativeElementHandle | undefined;
+/** Checks whether a GTK process has completed AT-SPI root/cache registration. */
+export declare const nativeProcessAtspiReadiness: (processId: number) => NativeAtspiReadiness;
+/** Resolves an accessible id to a native element across all exposed processes. */
+export declare const nativeFindAnyById: (id: string) => NativeElementHandle | undefined;
+/** Sets text contents on the accessible with the given id. */
+export declare const nativeSetTextById: (processId: number, id: string, text: string) => void;
+/** Executes the first action on the accessible with the given id. */
+export declare const nativeClickById: (processId: number, id: string) => void;
+/** Reads text from the accessible with the given id. */
+export declare const nativeTextById: (processId: number, id: string) => string;
+/** Captures real screen pixels for the accessible with the given id. */
+export declare const nativeCaptureById: (processId: number, id: string) => NativeCapture;
+/** Counts top-level windows hosted by the process. */
+export declare const nativeWindowCount: (processId: number) => number;
+/** Resolves a top-level window index to an element handle when it exists. */
+export declare const nativeWindowAt: (processId: number, index: number) => NativeElementHandle | undefined;
+/** Counts direct children for an element handle. */
+export declare const nativeChildCount: (element: NativeElementHandle) => number;
+/** Resolves a direct child index to an element handle when it exists. */
+export declare const nativeChildAt: (element: NativeElementHandle, index: number) => NativeElementHandle | undefined;
+/** Counts selected children for a selectable element handle. */
+export declare const nativeSelectedChildCount: (element: NativeElementHandle) => number;
+/** Resolves a selected child index to an element handle when it exists. */
+export declare const nativeSelectedChildAt: (element: NativeElementHandle, index: number) => NativeElementHandle | undefined;
+/** Reads whether a direct child is selected. */
+export declare const nativeIsChildSelected: (element: NativeElementHandle, index: number) => boolean;
+/** Selects a direct child for a selectable element handle. */
+export declare const nativeSelectChildAt: (element: NativeElementHandle, index: number) => void;
+/** Deselects a direct child for a selectable element handle. */
+export declare const nativeDeselectChildAt: (element: NativeElementHandle, index: number) => void;
+/** Selects all children for a selectable element handle. */
+export declare const nativeSelectAllChildren: (element: NativeElementHandle) => void;
+/** Clears child selection for a selectable element handle. */
+export declare const nativeClearSelection: (element: NativeElementHandle) => void;
+/** Counts table rows for a table element handle. */
+export declare const nativeTableRowCount: (element: NativeElementHandle) => number;
+/** Counts table columns for a table element handle. */
+export declare const nativeTableColumnCount: (element: NativeElementHandle) => number;
+/** Resolves a table cell element handle by row and column when it exists. */
+export declare const nativeTableCellAt: (element: NativeElementHandle, row: number, column: number) => NativeElementHandle | undefined;
+/** Reads selected table row indexes. */
+export declare const nativeTableSelectedRows: (element: NativeElementHandle) => number[];
+/** Reads selected table column indexes. */
+export declare const nativeTableSelectedColumns: (element: NativeElementHandle) => number[];
+/** Reads whether a table row is selected. */
+export declare const nativeTableIsRowSelected: (element: NativeElementHandle, row: number) => boolean;
+/** Reads whether a table column is selected. */
+export declare const nativeTableIsColumnSelected: (element: NativeElementHandle, column: number) => boolean;
+/** Reads whether a table cell is selected. */
+export declare const nativeTableIsCellSelected: (element: NativeElementHandle, row: number, column: number) => boolean;
+/** Selects a table row. */
+export declare const nativeTableSelectRow: (element: NativeElementHandle, row: number) => void;
+/** Deselects a table row. */
+export declare const nativeTableDeselectRow: (element: NativeElementHandle, row: number) => void;
+/** Selects a table column. */
+export declare const nativeTableSelectColumn: (element: NativeElementHandle, column: number) => void;
+/** Deselects a table column. */
+export declare const nativeTableDeselectColumn: (element: NativeElementHandle, column: number) => void;
+/** Sets text contents on the accessible resolved by an element handle. */
+export declare const nativeSetText: (element: NativeElementHandle, text: string) => void;
+/** Executes the first action on the accessible resolved by an element handle. */
+export declare const nativeClick: (element: NativeElementHandle) => void;
+/** Reads text from the accessible resolved by an element handle. */
+export declare const nativeText: (element: NativeElementHandle) => string;
+/** Reads value metadata from the accessible resolved by an element handle. */
+export declare const nativeValueInfo: (element: NativeElementHandle) => NativeValueInfo;
+/** Reads image metadata from the accessible resolved by an element handle. */
+export declare const nativeImageInfo: (element: NativeElementHandle) => NativeImageInfo;
+/** Sets a numeric value on the accessible resolved by an element handle. */
+export declare const nativeSetValue: (element: NativeElementHandle, value: number) => void;
+/** Captures real screen pixels for the accessible resolved by an element handle. */
+export declare const nativeCapture: (element: NativeElementHandle) => NativeCapture;
+/** Captures the full X11 root window currently addressed by DISPLAY. */
+export declare const nativeCaptureScreen: () => NativeCapture;
+/** Captures real screen pixels for explicit screen-relative bounds. */
+export declare const nativeCaptureBounds: (bounds: NativeCaptureBounds) => NativeCapture;
+/** Reads AT-SPI metadata for the accessible resolved by an element handle. */
+export declare const nativeElementInfo: (element: NativeElementHandle) => NativeElementInfo;
+/** Lists StatusNotifier tray items owned by the process. */
+export declare const nativeTrayItems: (processId: number) => NativeTrayItem[];
+/** Runs the test tray host until the process is terminated. */
+export declare const nativeRunTrayHost: () => void;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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"}