snapdrive-ios 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masami
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,95 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/images/header.png">
+    <source media="(prefers-color-scheme: light)" srcset="docs/images/header.png">
+    <img src="docs/images/header.png" alt="SnapDrive" width="800" style="max-width: 100%; height: auto;">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a>
+</p>
+
+---
+
+# SnapDrive
+
+iOS用のスナップショットテストツール。AI Agentを活用してiOS Simulatorを自律的に操作し、テストシナリオとBaselineを自動生成します。UIの変更にも柔軟に対応でき、テストケースの陳腐化を防ぎます。
+
+## 必要環境
+
+- macOS + Xcode
+- Node.js 20+
+- Python 3.x + fb-idb
+
+## セットアップ
+
+### 1. fb-idb (Python) をインストール
+
+```bash
+pip install fb-idb
+```
+
+### 2. Claude Desktop/Codeに設定
+
+`.mcp.json`に追加:
+
+```json
+{
+  "mcpServers": {
+    "snapdrive": {
+      "command": "npx",
+      "args": ["snapdrive-ios-mcp"]
+    }
+  }
+}
+```
+
+環境変数を設定する場合:
+
+```json
+{
+  "mcpServers": {
+    "snapdrive": {
+      "command": "npx",
+      "args": ["snapdrive-ios-mcp"],
+      "env": {
+        "SNAPDRIVE_RESULTS_DIR": "/path/to/your/project/results",
+        "SNAPDRIVE_LOG_LEVEL": "debug"
+      }
+    }
+  }
+}
+```
+
+### 環境変数
+
+| 変数 | 説明 | デフォルト |
+|------|------|-----------|
+| `SNAPDRIVE_RESULTS_DIR` | 結果出力先 | `./results` |
+| `SNAPDRIVE_LOG_LEVEL` | ログレベル (debug/info/warn/error) | `info` |
+
+## バージョン管理
+
+`.snapdrive`ディレクトリはGitにコミットしてください:
+
+```bash
+git add .snapdrive/
+git commit -m "Add SnapDrive test cases and baselines"
+```
+
+テストシナリオとBaselineをチームで共有することで、全環境で一貫したビジュアルリグレッションテストが可能になります。
+
+> **Note**: `results/`ディレクトリはテスト実行結果のため、`.gitignore`に追加してください。
+
+## ドキュメント
+
+- [使い方ガイド](docs/usage.md) - 基本的な操作方法
+- [テストケース](docs/test-cases.md) - 構造化テストの作成と実行
+- [CLI](docs/cli.md) - コマンドラインツールの使い方
+- [Fastlane統合](docs/fastlane.md) - FastlaneでのCI/CD連携
+- [MCPツール一覧](docs/tools.md) - 利用可能なツールのリファレンス
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,95 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/images/header.png">
+    <source media="(prefers-color-scheme: light)" srcset="docs/images/header.png">
+    <img src="docs/images/header.png" alt="SnapDrive" width="800" style="max-width: 100%; height: auto;">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a>
+</p>
+
+---
+
+# SnapDrive
+
+Snapshot testing tool for iOS. Leverages AI Agents to autonomously operate iOS Simulator, automatically generating test scenarios and baselines. Adapts flexibly to UI changes, preventing test case decay.
+
+## Requirements
+
+- macOS + Xcode
+- Node.js 20+
+- Python 3.x + fb-idb
+
+## Setup
+
+### 1. Install fb-idb (Python)
+
+```bash
+pip install fb-idb
+```
+
+### 2. Configure Claude Desktop/Code
+
+Add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "snapdrive": {
+      "command": "npx",
+      "args": ["snapdrive-ios-mcp"]
+    }
+  }
+}
+```
+
+With environment variables:
+
+```json
+{
+  "mcpServers": {
+    "snapdrive": {
+      "command": "npx",
+      "args": ["snapdrive-ios-mcp"],
+      "env": {
+        "SNAPDRIVE_RESULTS_DIR": "/path/to/your/project/results",
+        "SNAPDRIVE_LOG_LEVEL": "debug"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SNAPDRIVE_RESULTS_DIR` | Results output directory | `./results` |
+| `SNAPDRIVE_LOG_LEVEL` | Log level (debug/info/warn/error) | `info` |
+
+## Version Control
+
+The `.snapdrive` directory should be committed to Git:
+
+```bash
+git add .snapdrive/
+git commit -m "Add SnapDrive test cases and baselines"
+```
+
+This allows your team to share test scenarios and baselines, ensuring consistent visual regression testing across all environments.
+
+> **Note**: The `results/` directory contains test execution outputs and should be added to `.gitignore`.
+
+## Documentation
+
+- [Usage Guide](docs/usage.md) - Basic operations
+- [Test Cases](docs/test-cases.md) - Creating and running structured tests
+- [CLI](docs/cli.md) - Command-line tool usage
+- [Fastlane Integration](docs/fastlane.md) - CI/CD with Fastlane
+- [MCP Tools Reference](docs/tools.md) - Available tools reference
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * SnapDrive CLI
+ * Run tests directly from command line without Claude/MCP
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/cli.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+/**
+ * SnapDrive CLI
+ * Run tests directly from command line without Claude/MCP
+ */
+import { join } from 'node:path';
+import { mkdir } from 'node:fs/promises';
+import { IDBClient } from './core/idb-client.js';
+import { SimctlClient } from './core/simctl-client.js';
+import { ElementFinder } from './core/element-finder.js';
+import { ImageDiffer } from './core/image-differ.js';
+import { ScenarioRunner } from './core/scenario-runner.js';
+import { ReportGenerator } from './core/report-generator.js';
+import { Logger } from './utils/logger.js';
+const VERSION = '0.1.0';
+function printHelp() {
+    console.log(`
+SnapDrive CLI v${VERSION}
+iOS Simulator UI testing tool
+
+Usage:
+  snapdrive <command> [options]
+
+Commands:
+  list                    List all test cases
+  run <test-case-id>      Run a specific test case
+  run --all               Run all test cases
+  help                    Show this help message
+  version                 Show version
+
+Options:
+  --all                   Run all test cases
+  --update-baselines      Update baseline screenshots instead of comparing
+  --snapdrive-dir <path>  Path to .snapdrive directory (default: ./.snapdrive)
+  --results-dir <path>    Path to results directory (default: ./results)
+  --device <udid>         Target simulator UDID
+  --verbose               Enable verbose logging
+
+Examples:
+  snapdrive list
+  snapdrive run login-flow
+  snapdrive run login-flow --update-baselines
+  snapdrive run --all
+  snapdrive run --all --verbose
+`);
+}
+function parseArgs(args) {
+    const options = {
+        command: 'help',
+    };
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === 'list') {
+            options.command = 'list';
+        }
+        else if (arg === 'run') {
+            options.command = 'run';
+        }
+        else if (arg === 'help' || arg === '--help' || arg === '-h') {
+            options.command = 'help';
+        }
+        else if (arg === 'version' || arg === '--version' || arg === '-v') {
+            options.command = 'version';
+        }
+        else if (arg === '--all' || arg === '-a') {
+            options.all = true;
+        }
+        else if (arg === '--update-baselines' || arg === '-u') {
+            options.updateBaselines = true;
+        }
+        else if (arg === '--verbose') {
+            options.verbose = true;
+        }
+        else if (arg === '--snapdrive-dir' && args[i + 1]) {
+            options.snapdriveDir = args[++i];
+        }
+        else if (arg === '--results-dir' && args[i + 1]) {
+            options.resultsDir = args[++i];
+        }
+        else if (arg === '--device' && args[i + 1]) {
+            options.deviceUdid = args[++i];
+        }
+        else if (!arg.startsWith('-') && options.command === 'run' && !options.testCaseId) {
+            options.testCaseId = arg;
+        }
+        i++;
+    }
+    return options;
+}
+async function createRunner(verbose) {
+    const logLevel = verbose ? 'debug' : 'info';
+    const logger = new Logger('snapdrive-cli', logLevel);
+    const idbClient = new IDBClient({}, undefined, logger);
+    const simctlClient = new SimctlClient({}, undefined, logger);
+    const elementFinder = new ElementFinder();
+    const imageDiffer = new ImageDiffer(logger);
+    const scenarioRunner = new ScenarioRunner({
+        idbClient,
+        simctlClient,
+        elementFinder,
+        imageDiffer,
+        logger,
+    });
+    const reportGenerator = new ReportGenerator(logger);
+    return { scenarioRunner, reportGenerator, logger };
+}
+async function listTestCases(options) {
+    const snapdriveDir = options.snapdriveDir ?? join(process.cwd(), '.snapdrive');
+    const { scenarioRunner } = await createRunner(options.verbose ?? false);
+    console.log(`\nLooking for test cases in: ${snapdriveDir}/test-cases\n`);
+    const testCases = await scenarioRunner.listTestCases(snapdriveDir);
+    if (testCases.length === 0) {
+        console.log('No test cases found.');
+        console.log('\nCreate a test case with Claude:');
+        console.log('  "login-flowという名前でテストケースを作成して"');
+        return;
+    }
+    console.log(`Found ${testCases.length} test case(s):\n`);
+    console.log('─'.repeat(60));
+    for (const tc of testCases) {
+        console.log(`  ${tc.id}`);
+        console.log(`    Name: ${tc.scenario.name}`);
+        if (tc.scenario.description) {
+            console.log(`    Description: ${tc.scenario.description}`);
+        }
+        console.log(`    Steps: ${tc.scenario.steps.length}`);
+        console.log('');
+    }
+}
+async function runTests(options) {
+    const snapdriveDir = options.snapdriveDir ?? join(process.cwd(), '.snapdrive');
+    const baseResultsDir = options.resultsDir ?? join(process.cwd(), 'results');
+    const resultsDir = join(baseResultsDir, new Date().toISOString().replace(/[:.]/g, '-'));
+    const { scenarioRunner, reportGenerator } = await createRunner(options.verbose ?? false);
+    // Ensure results directory exists (do not clean up previous results)
+    await mkdir(resultsDir, { recursive: true });
+    await mkdir(join(resultsDir, 'screenshots'), { recursive: true });
+    await mkdir(join(resultsDir, 'diffs'), { recursive: true });
+    let testCases;
+    if (options.all) {
+        testCases = await scenarioRunner.listTestCases(snapdriveDir);
+        if (testCases.length === 0) {
+            console.error('No test cases found.');
+            process.exit(1);
+        }
+        console.log(`\nRunning all ${testCases.length} test case(s)...\n`);
+    }
+    else if (options.testCaseId) {
+        const tcPath = join(snapdriveDir, 'test-cases', options.testCaseId);
+        try {
+            const testCase = await scenarioRunner.loadTestCase(tcPath);
+            testCases = [testCase];
+            console.log(`\nRunning test case: ${options.testCaseId}\n`);
+        }
+        catch (error) {
+            console.error(`Error: Test case not found: ${options.testCaseId}`);
+            console.error(`Expected path: ${tcPath}`);
+            process.exit(1);
+        }
+    }
+    else {
+        console.error('Error: Specify a test case ID or use --all');
+        console.error('Usage: snapdrive run <test-case-id>');
+        console.error('       snapdrive run --all');
+        process.exit(1);
+    }
+    const startTime = new Date();
+    const results = {
+        runId: new Date().toISOString().replace(/[:.]/g, '-'),
+        startTime: startTime.toISOString(),
+        endTime: '',
+        durationMs: 0,
+        totalTests: testCases.length,
+        passed: 0,
+        failed: 0,
+        results: [],
+        resultsDir,
+    };
+    console.log('─'.repeat(60));
+    for (const testCase of testCases) {
+        const mode = options.updateBaselines ? '[UPDATE BASELINES]' : '[COMPARE]';
+        console.log(`\n${mode} ${testCase.scenario.name}`);
+        try {
+            const result = await scenarioRunner.runTestCase(testCase, {
+                deviceUdid: options.deviceUdid,
+                updateBaselines: options.updateBaselines ?? false,
+                resultsDir,
+                testCasePath: testCase.path,
+            });
+            results.results.push(result);
+            if (result.success) {
+                results.passed++;
+                console.log(`  ✓ PASSED (${(result.durationMs / 1000).toFixed(2)}s)`);
+            }
+            else {
+                results.failed++;
+                console.log(`  ✗ FAILED (${(result.durationMs / 1000).toFixed(2)}s)`);
+                // Show failed steps
+                for (const step of result.steps) {
+                    if (!step.success) {
+                        console.log(`    - Step ${step.stepIndex + 1} (${step.action}): ${step.error}`);
+                    }
+                }
+                // Show checkpoint diffs
+                for (const cp of result.checkpoints) {
+                    if (!cp.match) {
+                        console.log(`    - Checkpoint "${cp.name}": ${cp.differencePercent.toFixed(2)}% different`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            results.failed++;
+            console.log(`  ✗ ERROR: ${String(error)}`);
+        }
+    }
+    const endTime = new Date();
+    results.endTime = endTime.toISOString();
+    results.durationMs = endTime.getTime() - startTime.getTime();
+    console.log('\n' + '─'.repeat(60));
+    console.log('\nSummary:');
+    console.log(`  Total:  ${results.totalTests}`);
+    console.log(`  Passed: ${results.passed}`);
+    console.log(`  Failed: ${results.failed}`);
+    console.log(`  Duration: ${(results.durationMs / 1000).toFixed(2)}s`);
+    // Generate report if comparing (not updating baselines)
+    if (!options.updateBaselines) {
+        const reportPath = await reportGenerator.generateReport(results);
+        console.log(`\n📄 Report: ${reportPath}`);
+    }
+    console.log(`📁 Results: ${resultsDir}`);
+    console.log('');
+    // Exit with error code if tests failed
+    if (results.failed > 0) {
+        process.exit(1);
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const options = parseArgs(args);
+    try {
+        switch (options.command) {
+            case 'list':
+                await listTestCases(options);
+                break;
+            case 'run':
+                await runTests(options);
+                break;
+            case 'version':
+                console.log(`snapdrive v${VERSION}`);
+                break;
+            case 'help':
+            default:
+                printHelp();
+                break;
+        }
+    }
+    catch (error) {
+        console.error('Error:', String(error));
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/command-executor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Command executor for running subprocess commands
+ */
+import type { CommandResult, ExecuteOptions } from '../interfaces/config.interface.js';
+import { type ILogger } from '../utils/logger.js';
+export interface ICommandExecutor {
+    execute(command: string, args: string[], options?: ExecuteOptions): Promise<CommandResult>;
+}
+export declare class CommandExecutor implements ICommandExecutor {
+    private logger;
+    constructor(logger?: ILogger);
+    execute(command: string, args: string[], options?: ExecuteOptions): Promise<CommandResult>;
+}
+export declare const commandExecutor: CommandExecutor;
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/core/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/core/command-executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CACL,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,MAAM,CAAU;gBAEZ,MAAM,CAAC,EAAE,OAAO;IAItB,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;CA6D1B;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/core/command-executor.js

@@ -0,0 +1,64 @@
+/**
+ * Command executor for running subprocess commands
+ */
+import { spawn } from 'node:child_process';
+import { Logger } from '../utils/logger.js';
+export class CommandExecutor {
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? new Logger('command-executor');
+    }
+    async execute(command, args, options = {}) {
+        const { timeoutMs = 30000, cwd, env } = options;
+        const fullCommand = `${command} ${args.join(' ')}`;
+        this.logger.debug(`Executing: ${fullCommand}`);
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            const proc = spawn(command, args, {
+                cwd,
+                env: env ? { ...process.env, ...env } : process.env,
+                shell: false,
+            });
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                proc.kill('SIGTERM');
+                this.logger.warn(`Command timed out after ${timeoutMs}ms: ${fullCommand}`);
+            }, timeoutMs);
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timeoutId);
+                const exitCode = code ?? (timedOut ? -1 : 0);
+                if (exitCode !== 0 && !timedOut) {
+                    this.logger.debug(`Command failed with exit code ${exitCode}: ${fullCommand}`, {
+                        stderr: stderr.slice(0, 200),
+                    });
+                }
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode,
+                    timedOut,
+                });
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timeoutId);
+                this.logger.error(`Command error: ${fullCommand}`, { error: err.message });
+                resolve({
+                    stdout,
+                    stderr: `${stderr}\nError: ${err.message}`,
+                    exitCode: -1,
+                    timedOut: false,
+                });
+            });
+        });
+    }
+}
+export const commandExecutor = new CommandExecutor();
+//# sourceMappingURL=command-executor.js.map

package/dist/core/command-executor.js.map

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

package/dist/core/element-finder.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Element finder - search and locate UI elements
+ */
+import type { AccessibilityElement, Point, ElementSearchResult, ElementPredicate } from '../interfaces/element.interface.js';
+export interface IElementFinder {
+    findByLabel(elements: AccessibilityElement[], label: string): AccessibilityElement[];
+    findByLabelContains(elements: AccessibilityElement[], partial: string): AccessibilityElement[];
+    findByType(elements: AccessibilityElement[], type: string): AccessibilityElement[];
+    findByRole(elements: AccessibilityElement[], role: string): AccessibilityElement[];
+    findByPredicate(elements: AccessibilityElement[], predicate: ElementPredicate): AccessibilityElement[];
+    findBest(elements: AccessibilityElement[], predicate: ElementPredicate, screenCenter?: Point): ElementSearchResult;
+    getCenterPoint(element: AccessibilityElement): Point;
+    getAllLabels(elements: AccessibilityElement[]): string[];
+    findScrollRegion(elements: AccessibilityElement[]): {
+        centerX: number;
+        centerY: number;
+    } | null;
+}
+export declare class ElementFinder implements IElementFinder {
+    /**
+     * Find elements with exact label match
+     */
+    findByLabel(elements: AccessibilityElement[], label: string): AccessibilityElement[];
+    /**
+     * Find elements with partial label match
+     */
+    findByLabelContains(elements: AccessibilityElement[], partial: string): AccessibilityElement[];
+    /**
+     * Find elements by type
+     */
+    findByType(elements: AccessibilityElement[], type: string): AccessibilityElement[];
+    /**
+     * Find elements by role
+     */
+    findByRole(elements: AccessibilityElement[], role: string): AccessibilityElement[];
+    /**
+     * Find elements matching a predicate
+     */
+    findByPredicate(elements: AccessibilityElement[], predicate: ElementPredicate): AccessibilityElement[];
+    /**
+     * Find the best matching element and return search result with tap coordinates
+     */
+    findBest(elements: AccessibilityElement[], predicate: ElementPredicate, screenCenter?: Point): ElementSearchResult;
+    /**
+     * Calculate center point of element's frame
+     */
+    getCenterPoint(element: AccessibilityElement): Point;
+    /**
+     * Get all labels from elements (for debugging/suggestions)
+     */
+    getAllLabels(elements: AccessibilityElement[]): string[];
+    /**
+     * Check if element matches predicate
+     */
+    private matchesPredicate;
+    /**
+     * Rank elements by priority:
+     * 1. Buttons and tappable elements first
+     * 2. Enabled elements before disabled
+     * 3. Closer to screen center
+     */
+    private rankElements;
+    /**
+     * Check if element is button-like (more likely to be tappable)
+     */
+    private isButtonLike;
+    /**
+     * Calculate distance from element center to screen center
+     */
+    private distanceToCenter;
+    /**
+     * Find the best scroll region by analyzing element frames
+     * Returns center point of the largest container that likely contains scrollable content
+     */
+    findScrollRegion(elements: AccessibilityElement[]): {
+        centerX: number;
+        centerY: number;
+    } | null;
+}
+export declare const elementFinder: ElementFinder;
+//# sourceMappingURL=element-finder.d.ts.map