@ceraph/react-native-mcp 0.2.2 → 0.3.1

package/dist/screen.d.ts

@@ -1,9 +1,4 @@
-/**
- * WebDriverAgent client with pixel ratio correction.
- *
- * Talks to the WDA HTTP server running on localhost:8100 to perform
- * taps and element lookups on a connected iOS device.
- */
+import { TargetResolver } from "./target.js";
 export interface TapResult {
     success: boolean;
     tappedAt: {
@@ -38,58 +33,152 @@ export interface FindTapResult {
     }>;
     error?: string;
 }
-interface ElementQuery {
+export interface ElementQuery {
     text?: string;
     accessibilityLabel?: string;
     type?: string;
     index?: number;
 }
+export interface SwipeOptions {
+    direction: "up" | "down" | "left" | "right";
+    from?: {
+        x: number;
+        y: number;
+    };
+    distancePx?: number;
+    durationMs?: number;
+    coordinateSource?: "screenshot" | "device";
+}
+export interface SwipeResult {
+    success: boolean;
+    from: {
+        x: number;
+        y: number;
+    };
+    to: {
+        x: number;
+        y: number;
+    };
+    durationMs: number;
+    error?: string;
+}
+export interface SimpleResult {
+    success: boolean;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface ScreenshotResult {
+    success: boolean;
+    base64?: string;
+    error?: string;
+}
+export interface SourceResult {
+    success: boolean;
+    source?: WDAElement;
+    error?: string;
+}
+export interface WaitForResult {
+    success: boolean;
+    found: boolean;
+    elapsedMs: number;
+    element?: ElementInfo;
+    error?: string;
+}
+export interface WDAElement {
+    type?: string;
+    label?: string;
+    name?: string;
+    value?: string;
+    rect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    children?: WDAElement[];
+    [key: string]: unknown;
+}
 export declare class ScreenManager {
     private sessionId;
     private pixelRatio;
-    /**
-     * Check whether WebDriverAgent is reachable.
-     */
+    private targetResolver;
+    private sessionBaseUrl;
+    constructor(opts?: {
+        targetResolver?: TargetResolver;
+    });
+    private snapshotTarget;
+    private wdaFetchAt;
+    private wdaFetch;
     isAvailable(): Promise<boolean>;
-    /**
-     * Get or create a WDA session. Sessions are cached and revalidated.
-     */
     ensureSession(): Promise<string>;
-    /**
-     * Determine the pixel ratio between screenshot coordinates and
-     * device logical coordinates.
-     *
-     * Screenshot images are in physical pixels; WDA taps use logical points.
-     * The ratio is typically 2 (for @2x Retina) or 3 (for @3x).
-     */
     getPixelRatio(): Promise<number>;
-    /**
-     * Tap at the given coordinates.
-     *
-     * When `fromScreenshot` is true (the default), the coordinates are
-     * assumed to come from a screenshot image and are divided by the
-     * pixel ratio to convert to logical device points.
-     */
+    getWindowSize(): Promise<{
+        width: number;
+        height: number;
+    }>;
     tap(x: number, y: number, fromScreenshot?: boolean): Promise<TapResult>;
-    /**
-     * Find an element in the UI tree and tap its center.
-     */
     findAndTap(query: ElementQuery): Promise<FindTapResult>;
-    /**
-     * Recursively search the WDA element tree for elements matching the query.
-     */
+    findElement(query: ElementQuery): Promise<{
+        success: boolean;
+        element?: WDAElement;
+        matchCount?: number;
+        error?: string;
+    }>;
+    swipe(opts: SwipeOptions): Promise<SwipeResult>;
+    scrollToElement(query: ElementQuery, opts?: {
+        maxSwipes?: number;
+        direction?: "up" | "down";
+        distancePx?: number;
+    }): Promise<{
+        success: boolean;
+        swipes: number;
+        element?: ElementInfo;
+        error?: string;
+    }>;
+    longPress(x: number, y: number, durationMs?: number, fromScreenshot?: boolean): Promise<SimpleResult>;
+    longPressElement(query: ElementQuery, durationMs?: number): Promise<SimpleResult & {
+        element?: ElementInfo;
+    }>;
+    type(text: string, opts?: {
+        hideKeyboardAfter?: boolean;
+    }): Promise<SimpleResult>;
+    clearText(query: ElementQuery): Promise<SimpleResult>;
+    pressKey(key: "home" | "volumeUp" | "volumeDown" | "lock"): Promise<SimpleResult>;
+    unlock(): Promise<SimpleResult>;
+    isLocked(): Promise<boolean | null>;
+    screenshot(): Promise<ScreenshotResult>;
+    getSource(): Promise<SourceResult>;
+    waitFor(query: ElementQuery, opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        disappear?: boolean;
+    }): Promise<WaitForResult>;
+    assertVisible(query: ElementQuery): Promise<{
+        success: boolean;
+        visible: boolean;
+        element?: ElementInfo;
+        error?: string;
+    }>;
+    assertNotVisible(query: ElementQuery): Promise<{
+        success: boolean;
+        visible: boolean;
+        error?: string;
+    }>;
+    getOrientation(): Promise<string | null>;
+    setOrientation(orientation: "portrait" | "landscape"): Promise<SimpleResult>;
+    getActiveAppInfo(): Promise<{
+        success: boolean;
+        bundleId?: string;
+        pid?: number;
+        name?: string;
+        error?: string;
+    }>;
+    activateApp(bundleId: string): Promise<SimpleResult>;
+    openUrl(url: string): Promise<SimpleResult>;
+    terminateAppViaWDA(bundleId: string): Promise<SimpleResult>;
+    pingStatus(): Promise<boolean>;
     private searchElements;
-    /**
-     * Check whether a single element matches the given query.
-     */
     private elementMatches;
-    /**
-     * Collect a summary of visible elements for debugging (when no match found).
-     */
     private collectVisibleElements;
-    /**
-     * Invalidate cached session and pixel ratio (e.g., after app restart).
-     */
     reset(): void;
 }
-export {};