execbro 0.0.1-reserve → 1.10.13

package/build/core/ios.d.ts

@@ -0,0 +1,263 @@
+export declare const IOS_BUTTON_TYPES: readonly ["HOME", "LOCK", "SIDE_BUTTON", "SIRI", "APPLE_PAY"];
+export type iOSButtonType = (typeof IOS_BUTTON_TYPES)[number];
+/**
+ * Check if IDB is available
+ */
+export declare function isIdbAvailable(): Promise<boolean>;
+/**
+ * Check if AXe CLI is available
+ */
+export declare function isAxeAvailable(): Promise<boolean>;
+/**
+ * Check if the active iOS UI driver is available.
+ * Used by tap.ts for early fail-fast checks.
+ */
+export declare function isUiDriverAvailable(): Promise<boolean>;
+/**
+ * Get install instructions for the active iOS UI driver.
+ */
+export declare function getUiDriverInstallHint(): string;
+export interface iOSSimulator {
+    udid: string;
+    name: string;
+    state: "Booted" | "Shutdown" | "Creating" | string;
+    runtime: string;
+    deviceType?: string;
+    isAvailable?: boolean;
+}
+export interface iOSResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+    data?: Buffer;
+    scaleFactor?: number;
+    originalWidth?: number;
+    originalHeight?: number;
+    simulators?: iOSSimulator[];
+}
+export interface iOSAccessibilityElement {
+    AXLabel?: string;
+    AXValue?: string;
+    AXFrame?: string;
+    frame?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    AXUniqueId?: string;
+    type?: string;
+    children?: iOSAccessibilityElement[];
+    [key: string]: unknown;
+}
+export interface iOSDescribeResult extends iOSResult {
+    elements?: iOSAccessibilityElement[];
+}
+export declare const XCODE_MISSING_ERROR: string;
+/**
+ * Check if simctl is available (cached for the lifetime of the process).
+ */
+export declare function isSimctlAvailable(): Promise<boolean>;
+/**
+ * Reset the cached simctl availability check. Test-only.
+ */
+export declare function resetSimctlAvailableCache(): void;
+/**
+ * List iOS simulators
+ */
+export declare function listIOSSimulators(onlyBooted?: boolean): Promise<iOSResult>;
+/**
+ * Build the actionable "no booted simulator" error message. Lists up to 6
+ * recently-available shutdown simulators by name+UDID and points the agent
+ * at `ios_boot_simulator`, so it can recover instead of giving up.
+ */
+export declare function buildNoSimulatorError(): Promise<string>;
+/**
+ * Get the booted simulator UDID
+ */
+export declare function getBootedSimulatorUdid(): Promise<string | null>;
+/**
+ * Find a booted simulator's UDID by its device name
+ * Matches Metro's deviceName against simulator names from simctl
+ */
+export declare function findSimulatorByName(deviceName: string): Promise<string | null>;
+/**
+ * Get the active simulator UDID (Metro-connected) or fall back to first booted simulator
+ * This enables automatic device scoping based on Metro connection
+ */
+export declare function getActiveOrBootedSimulatorUdid(): Promise<string | null>;
+/**
+ * Take a screenshot from an iOS simulator
+ */
+export declare function iosScreenshot(outputPath?: string, udid?: string): Promise<iOSResult>;
+/**
+ * Install an app on an iOS simulator
+ */
+export declare function iosInstallApp(appPath: string, udid?: string): Promise<iOSResult>;
+/**
+ * Launch an app on an iOS simulator
+ */
+export declare function iosLaunchApp(bundleId: string, udid?: string): Promise<iOSResult>;
+/**
+ * Open a URL in the iOS simulator
+ */
+export declare function iosOpenUrl(url: string, udid?: string): Promise<iOSResult>;
+/**
+ * Terminate an app on an iOS simulator
+ */
+export declare function iosTerminateApp(bundleId: string, udid?: string): Promise<iOSResult>;
+/**
+ * Boot an iOS simulator
+ */
+export declare function iosBootSimulator(udid: string): Promise<iOSResult>;
+/**
+ * Tap at coordinates on an iOS simulator using IDB
+ */
+export declare function iosTap(x: number, y: number, options?: {
+    duration?: number;
+    udid?: string;
+}): Promise<iOSResult>;
+/**
+ * Swipe gesture on an iOS simulator
+ */
+export declare function iosSwipe(startX: number, startY: number, endX: number, endY: number, options?: {
+    duration?: number;
+    delta?: number;
+    udid?: string;
+}): Promise<iOSResult>;
+/**
+ * Input text into the active field on an iOS simulator
+ */
+export declare function iosInputText(text: string, udid?: string): Promise<iOSResult>;
+/**
+ * Press a hardware button on an iOS simulator
+ */
+export declare function iosButton(button: iOSButtonType, options?: {
+    duration?: number;
+    udid?: string;
+}): Promise<iOSResult>;
+/**
+ * Send a key event to an iOS simulator
+ */
+export declare function iosKeyEvent(keycode: number, options?: {
+    duration?: number;
+    udid?: string;
+}): Promise<iOSResult>;
+/**
+ * Send a sequence of key events to an iOS simulator
+ */
+export declare function iosKeySequence(keycodes: number[], udid?: string): Promise<iOSResult>;
+export declare function getIOSSafeAreaTop(udid?: string): Promise<number>;
+/**
+ * Get accessibility info for the entire screen
+ */
+export declare function iosDescribeAll(udid?: string): Promise<iOSDescribeResult>;
+export declare function detectIOSSystemOverlay(udid?: string): Promise<{
+    detected: boolean;
+    description?: string;
+} | null>;
+export declare function formatIOSSystemOverlayWarning(detection: {
+    detected: boolean;
+    description?: string;
+}): string;
+/**
+ * Get accessibility info at a specific point
+ */
+export declare function iosDescribePoint(x: number, y: number, udid?: string): Promise<iOSDescribeResult>;
+/**
+ * Tap an element by its accessibility label using IDB
+ * This simplifies the workflow: no need to manually find coordinates
+ */
+export declare function iosTapElement(options: {
+    label?: string;
+    labelContains?: string;
+    index?: number;
+    duration?: number;
+    udid?: string;
+}): Promise<iOSResult>;
+/**
+ * UI Element from iOS accessibility tree (simplified for find_element)
+ */
+export interface IOSUIElement {
+    label: string;
+    value: string;
+    type: string;
+    identifier: string;
+    frame: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    center: {
+        x: number;
+        y: number;
+    };
+    enabled: boolean;
+    traits: string[];
+}
+/**
+ * Result of iOS element find operations
+ */
+export interface IOSFindElementResult {
+    success: boolean;
+    found: boolean;
+    element?: IOSUIElement;
+    allMatches?: IOSUIElement[];
+    matchCount?: number;
+    error?: string;
+}
+/**
+ * Result of iOS wait for element operations
+ */
+export interface IOSWaitForElementResult extends IOSFindElementResult {
+    elapsedMs?: number;
+    timedOut?: boolean;
+}
+/**
+ * Options for finding iOS elements
+ */
+export interface IOSFindElementOptions {
+    label?: string;
+    labelContains?: string;
+    value?: string;
+    valueContains?: string;
+    type?: string;
+    identifier?: string;
+    identifierContains?: string;
+    index?: number;
+}
+/**
+ * Get UI accessibility tree from iOS simulator using IDB (for find_element)
+ */
+export declare function iosGetUITree(udid?: string): Promise<{
+    success: boolean;
+    elements?: IOSUIElement[];
+    rawOutput?: string;
+    error?: string;
+}>;
+/**
+ * Find element(s) in the iOS UI tree matching the given criteria
+ */
+export declare function iosFindElement(options: IOSFindElementOptions, udid?: string): Promise<IOSFindElementResult>;
+/**
+ * Pure calculation: DPR = screenshotPixelWidth / screenPointWidth.
+ * Exported for unit testing.
+ */
+export declare function calculateDPR(screenshotPixelWidth: number, screenPointWidth: number): number;
+/**
+ * Query the actual device pixel ratio for an iOS simulator.
+ * Uses screenshot pixel width vs accessibility root frame width.
+ * Result is cached per UDID for the session.
+ */
+export declare function getDevicePixelRatio(udid?: string): Promise<number>;
+/** Clear DPR cache (for testing or when devices change) */
+export declare function clearDPRCache(): void;
+/**
+ * Wait for element to appear on iOS screen with polling
+ */
+export declare function iosWaitForElement(options: IOSFindElementOptions & {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}, udid?: string): Promise<IOSWaitForElementResult>;
+//# sourceMappingURL=ios.d.ts.map

package/build/core/ios.d.ts.map

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