npm - appium-desktop-driver - Versions diffs - 1.4.2 → 1.5.0 - Mend

appium-desktop-driver 1.4.2 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

package/build/eslint.config.d.mts +3 -0
package/build/eslint.config.d.mts.map +1 -0
package/build/eslint.config.mjs +22 -0
package/build/eslint.config.mjs.map +1 -0
package/build/lib/commands/actions.d.ts +10 -10
package/build/lib/commands/actions.d.ts.map +1 -1
package/build/lib/commands/actions.js.map +1 -1
package/build/lib/commands/app.d.ts +16 -16
package/build/lib/commands/app.d.ts.map +1 -1
package/build/lib/commands/app.js.map +1 -1
package/build/lib/commands/device.d.ts +10 -10
package/build/lib/commands/device.d.ts.map +1 -1
package/build/lib/commands/device.js.map +1 -1
package/build/lib/commands/element.d.ts +14 -14
package/build/lib/commands/element.d.ts.map +1 -1
package/build/lib/commands/element.js.map +1 -1
package/build/lib/commands/extension.d.ts +39 -38
package/build/lib/commands/extension.d.ts.map +1 -1
package/build/lib/commands/extension.js +6 -0
package/build/lib/commands/extension.js.map +1 -1
package/build/lib/commands/index.d.ts +98 -89
package/build/lib/commands/index.d.ts.map +1 -1
package/build/lib/commands/index.js +2 -0
package/build/lib/commands/index.js.map +1 -1
package/build/lib/commands/powershell.d.ts +5 -5
package/build/lib/commands/powershell.d.ts.map +1 -1
package/build/lib/commands/powershell.js.map +1 -1
package/build/lib/commands/system.d.ts +2 -2
package/build/lib/commands/system.d.ts.map +1 -1
package/build/lib/commands/vision.d.ts +10 -0
package/build/lib/commands/vision.d.ts.map +1 -0
package/build/lib/commands/vision.js +33 -0
package/build/lib/commands/vision.js.map +1 -0
package/build/lib/constraints.d.ts +1 -1
package/build/lib/constraints.d.ts.map +1 -1
package/build/lib/driver.d.ts +5 -5
package/build/lib/driver.d.ts.map +1 -1
package/build/lib/driver.js +3 -3
package/build/lib/driver.js.map +1 -1
package/build/lib/mcp/tools/index.d.ts.map +1 -1
package/build/lib/mcp/tools/index.js +2 -0
package/build/lib/mcp/tools/index.js.map +1 -1
package/build/lib/mcp/tools/vision.d.ts +4 -0
package/build/lib/mcp/tools/vision.d.ts.map +1 -0
package/build/lib/mcp/tools/vision.js +76 -0
package/build/lib/mcp/tools/vision.js.map +1 -0
package/build/lib/util.d.ts +9 -0
package/build/lib/util.d.ts.map +1 -1
package/build/lib/util.js +10 -0
package/build/lib/util.js.map +1 -1
package/build/lib/vision-utils.d.ts +33 -0
package/build/lib/vision-utils.d.ts.map +1 -0
package/build/lib/vision-utils.js +90 -0
package/build/lib/vision-utils.js.map +1 -0
package/build/lib/winapi/user32.d.ts +1 -0
package/build/lib/winapi/user32.d.ts.map +1 -1
package/build/lib/winapi/user32.js +2 -3
package/build/lib/winapi/user32.js.map +1 -1
package/build/tsconfig.tsbuildinfo +1 -0
package/package.json +11 -3
package/docs/driver-demo.mp4 +0 -0
package/docs/index.html +0 -582
package/docs/logo.png +0 -0
package/docs/mcp-demo.mp4 +0 -0
package/docs/script.js +0 -69
package/docs/style.css +0 -706
package/npm-shrinkwrap.json +0 -5951

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "appium-desktop-driver",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Appium driver for Windows",
   "keywords": [
     "appium",
@@ -21,8 +21,15 @@
     "lint": "eslint .",
     "test": "npx vitest run",
     "test:e2e": "npx vitest run --config vitest.e2e.config.ts",
-    "mcp:start": "node build/lib/mcp/index.js"
+    "mcp:start": "node build/lib/mcp/index.js",
+    "pack:dist": "node scripts/pack-dist.js"
   },
+  "files": [
+    "build",
+    "LICENSE",
+    "node_modules",
+    "README.md"
+  ],
   "author": "VeriSoft",
   "license": "Apache-2.0",
   "repository": {
@@ -36,6 +43,7 @@
     "appium": "^3.0.0-rc.2"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.82.0",
     "@appium/base-driver": "^10.1.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "bezier-easing": "^2.1.0",
@@ -51,7 +59,7 @@
     "platformNames": [
       "Windows"
     ],
-    "mainClass": "NovaWindowsDriver"
+    "mainClass": "AppiumDesktopDriver"
   },
   "devDependencies": {
     "@appium/eslint-config-appium-ts": "^2.0.3",

package/docs/driver-demo.mp4 DELETED Viewed

Binary file

package/docs/index.html DELETED Viewed

@@ -1,582 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Appium Desktop Driver — Windows UI Automation That Actually Works</title>
-  <meta name="description" content="A drop-in Appium 2/3 driver for Windows that outperforms WinAppDriver on speed, reliability, and modern app support." />
-  <!-- Prism.js (syntax highlighting) -->
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism.min.css" />
-  <link rel="stylesheet" href="style.css" />
-</head>
-<body>
-<!-- ============================================================
-     NAV
-     ============================================================ -->
-<nav>
-  <div class="nav-inner">
-    <div class="nav-brand">
-      <img src="logo.png" alt="VeriSoft" class="nav-logo" />
-      Appium Desktop Driver
-    </div>
-    <ul class="nav-links">
-      <li><a href="#demo">Demo</a></li>
-      <li><a href="#features">Features</a></li>
-      <li><a href="#mcp">MCP Server</a></li>
-      <li><a href="#quickstart">Quick Start</a></li>
-      <li><a href="https://github.com/verisoft-ai/appium-desktop-driver" target="_blank" rel="noopener">GitHub ↗</a></li>
-    </ul>
-  </div>
-</nav>
-<!-- ============================================================
-     1. HERO
-     ============================================================ -->
-<section id="hero">
-  <div class="container">
-    <div class="hero-eyebrow">Appium 2 &amp; 3 compatible</div>
-    <h1>Windows UI Automation<br><span class="accent">That Actually Works</span></h1>
-    <p class="hero-pitch">
-      A drop-in Appium 2/3 driver for Windows that tackles the limitations of WinAppDriver — faster XPath, layout-safe input, and no extra setup required.
-    </p>
-    <div class="hero-install-row">
-      <div class="hero-install">
-        <pre><code>npm install -g appium
-appium driver install --source=npm appium-desktop-driver</code></pre>
-      </div>
-      <a href="https://github.com/verisoft-ai/appium-desktop-driver" class="btn-primary" target="_blank" rel="noopener">
-        <svg width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg>
-        View on GitHub
-      </a>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     3. DEMO VIDEO
-     ============================================================ -->
-<section id="demo">
-  <div class="container">
-    <p class="section-label">See it in action</p>
-    <h2>Driver Demo</h2>
-    <p class="section-intro">Watch the driver automate a real Windows application end-to-end — element finding, input simulation, and test execution.</p>
-    <div class="video-outer">
-      <div class="video-wrapper">
-        <video autoplay muted loop playsinline controls>
-          <source src="driver-demo.mp4" type="video/mp4" />
-        </video>
-      </div>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     3. WHY NOT WINAPPDRIVER
-     ============================================================ -->
-<section id="why">
-  <div class="container">
-    <p class="section-label">Why switch</p>
-    <h2>Why Not WinAppDriver?</h2>
-    <p class="section-intro">WinAppDriver is abandoned and ships known pain points. Here's what this driver does instead.</p>
-    <div class="data-table-wrap">
-      <table class="comparison-table">
-        <thead>
-          <tr>
-            <th>Problem with WinAppDriver</th>
-            <th>What this driver does instead</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr>
-            <td><span class="cross">✗</span>Slow XPath on complex UIs</td>
-            <td><span class="check">✓</span>Faster XPath via direct UIA3 tree traversal</td>
-          </tr>
-          <tr>
-            <td><span class="cross">✗</span>Can't access hidden/raw elements</td>
-            <td><span class="check">✓</span>RawView element support</td>
-          </tr>
-          <tr>
-            <td><span class="cross">✗</span>Keyboard layout–dependent input</td>
-            <td><span class="check">✓</span>Unicode-safe text input with layout bypass</td>
-          </tr>
-          <tr>
-            <td><span class="cross">✗</span>Requires Developer Mode or extra setup</td>
-            <td><span class="check">✓</span>Zero extra prerequisites — PowerShell only</td>
-          </tr>
-          <tr>
-            <td><span class="cross">✗</span>No MCP / AI agent support</td>
-            <td><span class="check">✓</span>Built-in MCP server with 30+ tools</td>
-          </tr>
-        </tbody>
-      </table>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     SUPPORTED APP TYPES
-     ============================================================ -->
-<section id="app-types">
-  <div class="container">
-    <p class="section-label">Compatibility</p>
-    <h2>Supported App Types</h2>
-    <p class="section-intro">Works with every Windows application framework — including legacy apps with sparse accessibility trees.</p>
-    <div class="app-chips">
-      <div class="app-chip"><span class="chip-icon">🪟</span>UWP (Universal Windows Platform)</div>
-      <div class="app-chip"><span class="chip-icon">🖼️</span>WinForms</div>
-      <div class="app-chip"><span class="chip-icon">💠</span>WPF (Windows Presentation Foundation)</div>
-      <div class="app-chip"><span class="chip-icon">⚙️</span>Win32 / Classic Windows</div>
-      <div class="app-chip"><span class="chip-icon">🔧</span>Legacy / accessibility-sparse apps</div>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     4. CORE FEATURES
-     ============================================================ -->
-<section id="features">
-  <div class="container">
-    <p class="section-label">What you get</p>
-    <h2>Core Features</h2>
-    <p class="section-intro">Everything you need for production-grade Windows UI automation.</p>
-    <div class="feature-grid">
-      <div class="feature-card">
-        <div class="feature-icon">🔌</div>
-        <h3>Appium 2/3 Native</h3>
-        <p>Drop-in driver for the modern Appium stack. Familiar W3C WebDriver protocol — works with any Appium client.</p>
-      </div>
-      <div class="feature-card">
-        <div class="feature-icon">⚡</div>
-        <h3>Fast Element Finding</h3>
-        <p>Element lookups via Windows UI Automation 3 (UIA3). XPath evaluated against the live UIA tree with RawView access for hidden elements.</p>
-      </div>
-      <div class="feature-card">
-        <div class="feature-icon">🖱️</div>
-        <h3>Rich Input Simulation</h3>
-        <p>Mouse (click, scroll, hover, drag, Bezier easing), keyboard (unicode, virtual key codes, modifier combos), and clipboard. All via native <code>user32.dll</code> calls.</p>
-      </div>
-      <div class="feature-card">
-        <div class="feature-icon">🛠️</div>
-        <h3>Platform Extensions</h3>
-        <p>30+ <code>executeScript</code> commands: invoke/expand/collapse/toggle UI patterns, set/get values, manage windows, control monitors, run PowerShell, record screen.</p>
-      </div>
-      <div class="feature-card">
-        <div class="feature-icon">🤖</div>
-        <h3>MCP Server</h3>
-        <p>An out-of-the-box Model Context Protocol server (<code>desktop-driver-mcp</code>) exposes 30+ tools so AI agents can automate Windows UIs without writing traditional test scripts.</p>
-      </div>
-      <div class="feature-card">
-        <div class="feature-icon">💻</div>
-        <h3>PowerShell Escape Hatch</h3>
-        <p>Run arbitrary PowerShell before/after sessions (<code>prerun</code>/<code>postrun</code>), inject environment variables, and execute raw scripts mid-test.</p>
-      </div>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     5. LOCATOR STRATEGIES
-     ============================================================ -->
-<section id="locators">
-  <div class="container">
-    <p class="section-label">Element finding</p>
-    <h2>Locator Strategies</h2>
-    <p class="section-intro">All supported locators with their UIA mapping and an example selector.</p>
-    <div class="data-table-wrap">
-      <table class="data-table">
-        <thead>
-          <tr>
-            <th>Strategy</th>
-            <th>Maps to</th>
-            <th>Example</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr>
-            <td><code>accessibility id</code></td>
-            <td>UIA AutomationId</td>
-            <td><code>AppNameTitle</code></td>
-          </tr>
-          <tr>
-            <td><code>name</code></td>
-            <td>UIA Name</td>
-            <td><code>Calculator</code></td>
-          </tr>
-          <tr>
-            <td><code>class name</code></td>
-            <td>UIA ClassName</td>
-            <td><code>TextBlock</code></td>
-          </tr>
-          <tr>
-            <td><code>tag name</code></td>
-            <td>UIA ControlType</td>
-            <td><code>Button</code></td>
-          </tr>
-          <tr>
-            <td><code>xpath</code></td>
-            <td>Live UIA tree XPath 1.0</td>
-            <td><code>//Button[@Name="OK"]</code></td>
-          </tr>
-          <tr>
-            <td><code>id</code></td>
-            <td>Alias for accessibility id</td>
-            <td><code>42.333896.3.1</code></td>
-          </tr>
-          <tr>
-            <td><code>-windows uiautomation</code></td>
-            <td>Raw UIA condition (C#/PS syntax)</td>
-            <td><code>new PropertyCondition(...)</code></td>
-          </tr>
-        </tbody>
-      </table>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     6. MCP SERVER
-     ============================================================ -->
-<section id="mcp">
-  <div class="container">
-    <p class="section-label">AI agent integration</p>
-    <h2>MCP Server for AI Agents</h2>
-    <p class="section-intro">
-      Connect Claude, Copilot, or any MCP-compatible AI agent to any Windows app in minutes.
-    </p>
-    <div class="mcp-steps">
-      <div class="mcp-step">
-        <div class="step-num">1</div>
-        <h3>Run <code>desktop-driver-mcp</code></h3>
-        <p>Start your Appium server, then run <code>desktop-driver-mcp</code> to connect and create a session.</p>
-      </div>
-      <div class="mcp-step">
-        <div class="step-num">2</div>
-        <h3>Connect your AI client</h3>
-        <p>Point Claude Desktop, Cursor, or any MCP-compatible client to the server via stdio transport.</p>
-      </div>
-      <div class="mcp-step">
-        <div class="step-num">3</div>
-        <h3>Let the agent work</h3>
-        <p>The agent finds elements, clicks, types, takes screenshots, and reads the UI tree — all without you writing test code.</p>
-      </div>
-    </div>
-    <!-- MCP showcase video -->
-    <div class="video-outer mt-8">
-      <div class="video-wrapper">
-        <video autoplay muted loop playsinline controls>
-          <source src="mcp-demo.mp4" type="video/mp4" />
-        </video>
-      </div>
-    </div>
-    <!-- MCP config snippet -->
-    <div class="mt-12">
-      <h3>MCP Config (Claude Desktop / Cursor)</h3>
-      <div class="code-block-wrap mt-4">
-        <pre><code class="language-json">{
-  "mcpServers": {
-    "windows": {
-      "command": "desktop-driver-mcp",
-      "args": [],
-      "env": {
-        "APP": "C:\\Windows\\System32\\notepad.exe"
-      }
-    }
-  }
-}</code></pre>
-      </div>
-    </div>
-    <!-- MCP tool groups -->
-    <div class="mt-12">
-      <h3>Tool Groups (30+ tools)</h3>
-      <div class="data-table-wrap mt-4">
-        <table class="data-table mcp-group-table">
-          <thead>
-            <tr>
-              <th>Group</th>
-              <th>Tools</th>
-              <th>Description</th>
-            </tr>
-          </thead>
-          <tbody>
-            <tr>
-              <td>Session</td>
-              <td><code>start_session</code>, <code>get_session_info</code>, <code>end_session</code></td>
-              <td>Lifecycle management</td>
-            </tr>
-            <tr>
-              <td>Find</td>
-              <td><code>find_element</code>, <code>find_elements</code>, <code>find_child_element</code>, <code>wait_for_element</code></td>
-              <td>Element discovery with selector guidance</td>
-            </tr>
-            <tr>
-              <td>Inspect</td>
-              <td><code>get_element_info</code></td>
-              <td>Reads UIA properties and returns ranked selector suggestions</td>
-            </tr>
-            <tr>
-              <td>Interact</td>
-              <td><code>click_element</code>, <code>set_value</code>, <code>clear_element</code>, <code>get_text</code>, <code>get_attribute</code>, <code>is_element_displayed</code>, <code>is_element_enabled</code></td>
-              <td>Basic interactions</td>
-            </tr>
-            <tr>
-              <td>Advanced</td>
-              <td><code>advanced_click</code>, <code>send_keys</code>, <code>hover</code>, <code>scroll</code>, <code>click_and_drag</code></td>
-              <td>Complex input (right-click, double-click, drag, modifier keys)</td>
-            </tr>
-            <tr>
-              <td>Window</td>
-              <td><code>take_screenshot</code>, <code>get_page_source</code>, <code>get_window_rect</code>, <code>get_window_handles</code>, <code>switch_to_window</code>, <code>maximize_window</code>, <code>minimize_window</code>, <code>restore_window</code>, <code>close_window</code>, <code>get_monitors</code></td>
-              <td>Window &amp; screen control</td>
-            </tr>
-            <tr>
-              <td>UI Patterns</td>
-              <td><code>invoke</code>, <code>expand_element</code>, <code>collapse_element</code>, <code>toggle_element</code>, <code>scroll_into_view</code>, <code>select_element</code>, <code>get_selected_item</code>, <code>get_all_selected_items</code>, <code>add_to_selection</code>, <code>remove_from_selection</code>, <code>get_element_value</code>, <code>set_element_value</code>, <code>is_multiple_selection</code></td>
-              <td>UIA interaction patterns</td>
-            </tr>
-            <tr>
-              <td>App</td>
-              <td><code>get_window_element</code>, <code>launch_app</code>, <code>close_app</code>, <code>get_device_time</code></td>
-              <td>App lifecycle</td>
-            </tr>
-            <tr>
-              <td>Clipboard</td>
-              <td><code>set_clipboard</code>, <code>get_clipboard</code></td>
-              <td>Clipboard read/write (text and images)</td>
-            </tr>
-          </tbody>
-        </table>
-      </div>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     7. QUICK START CODE
-     ============================================================ -->
-<section id="quickstart">
-  <div class="container">
-    <p class="section-label">Get started fast</p>
-    <h2>Quick Start</h2>
-    <p class="section-intro">Connect to any Windows app in under 10 lines.</p>
-    <div class="code-block-wrap">
-      <div class="lang-tabs">
-        <button class="lang-tab" data-lang="python" data-active>Python</button>
-        <button class="lang-tab" data-lang="java">Java</button>
-        <button class="lang-tab" data-lang="js">JavaScript (WDIO)</button>
-        <button class="lang-tab" data-lang="csharp">C#</button>
-      </div>
-      <div class="tabbed-code">
-        <pre data-lang="python" data-active><code class="language-python">from appium import webdriver
-from appium.options.windows import WindowsOptions
-options = WindowsOptions()
-options.app = 'C:\\Windows\\System32\\notepad.exe'
-options.automation_name = 'DesktopDriver'
-driver = webdriver.Remote('http://127.0.0.1:4723', options=options)
-# Find and interact
-title_bar = driver.find_element('name', 'Notepad')
-driver.execute_script('windows: maximize', title_bar)</code></pre>
-        <pre data-lang="java"><code class="language-java">import io.appium.java_client.windows.WindowsDriver;
-import org.openqa.selenium.remote.DesiredCapabilities;
-import java.net.URL;
-DesiredCapabilities caps = new DesiredCapabilities();
-caps.setCapability("platformName", "Windows");
-caps.setCapability("appium:automationName", "DesktopDriver");
-caps.setCapability("appium:app", "C:\\Windows\\System32\\notepad.exe");
-WindowsDriver driver = new WindowsDriver(
-    new URL("http://127.0.0.1:4723"),
-    caps
-);
-driver.findElementByName("Notepad").click();</code></pre>
-        <pre data-lang="js"><code class="language-javascript">import { remote } from 'webdriverio';
-const driver = await remote({
-  hostname: '127.0.0.1',
-  port: 4723,
-  capabilities: {
-    platformName: 'Windows',
-    'appium:automationName': 'DesktopDriver',
-    'appium:app': 'C:\\Windows\\System32\\notepad.exe',
-  },
-});
-const el = await driver.$('~AppNameTitle');
-await el.click();</code></pre>
-        <pre data-lang="csharp"><code class="language-csharp">using OpenQA.Selenium.Appium;
-using OpenQA.Selenium.Appium.Windows;
-var options = new AppiumOptions();
-options.PlatformName = "Windows";
-options.AddAdditionalAppiumOption("automationName", "DesktopDriver");
-options.AddAdditionalAppiumOption("app", @"C:\Windows\System32\notepad.exe");
-var driver = new WindowsDriver(
-    new Uri("http://127.0.0.1:4723"),
-    options
-);
-driver.FindElement(MobileBy.AccessibilityId("AppNameTitle")).Click();</code></pre>
-      </div>
-    </div>
-    <!-- Advanced options (collapsed) -->
-    <details class="mt-8">
-      <summary style="cursor:pointer; color:var(--text-muted); font-size:0.9rem; padding:8px 0;">
-        Advanced session capabilities (Python)
-      </summary>
-      <div class="code-block-wrap mt-4">
-        <pre><code class="language-python">options.smooth_pointer_move = 'ease-in-out'
-options.delay_before_click = 100        # ms
-options.app_top_level_window = 0x12345  # attach to existing window
-options.prerun = {'script': 'Start-Process notepad'}
-options.postrun = {'command': 'Stop-Process -Name notepad'}
-options.app_environment = {'MY_VAR': 'hello'}
-options.return_all_window_handles = True</code></pre>
-      </div>
-    </details>
-  </div>
-</section>
-<!-- ============================================================
-     8. SESSION CAPABILITIES
-     ============================================================ -->
-<section id="capabilities">
-  <div class="container">
-    <p class="section-label">Configuration</p>
-    <h2>Session Capabilities</h2>
-    <p class="section-intro">All supported capabilities and their defaults.</p>
-    <div class="data-table-wrap">
-      <table class="data-table">
-        <thead>
-          <tr>
-            <th>Capability</th>
-            <th>Type</th>
-            <th>Default</th>
-            <th>Description</th>
-          </tr>
-        </thead>
-        <tbody>
-          <tr><td><code>platformName</code></td><td>string</td><td>—</td><td>Must be <code>Windows</code></td></tr>
-          <tr><td><code>automationName</code></td><td>string</td><td>—</td><td>Must be <code>DesktopDriver</code></td></tr>
-          <tr><td><code>app</code></td><td>string</td><td>—</td><td>App path or UWP App User Model ID</td></tr>
-          <tr><td><code>appTopLevelWindow</code></td><td>string/number</td><td>—</td><td>Attach to existing window by handle</td></tr>
-          <tr><td><code>appArguments</code></td><td>string</td><td>—</td><td>CLI arguments for app launch</td></tr>
-          <tr><td><code>appWorkingDir</code></td><td>string</td><td>—</td><td>Working directory for app</td></tr>
-          <tr><td><code>smoothPointerMove</code></td><td>string</td><td>—</td><td>CSS easing for mouse movement (e.g. <code>ease-in</code>)</td></tr>
-          <tr><td><code>delayBeforeClick</code></td><td>number</td><td>—</td><td>ms delay before each click</td></tr>
-          <tr><td><code>delayAfterClick</code></td><td>number</td><td>—</td><td>ms delay after each click</td></tr>
-          <tr><td><code>shouldCloseApp</code></td><td>boolean</td><td><code>true</code></td><td>Close app window when session ends</td></tr>
-          <tr><td><code>prerun</code></td><td>object</td><td>—</td><td><code>{script: '...'}</code> or <code>{command: '...'}</code> to run before session</td></tr>
-          <tr><td><code>postrun</code></td><td>object</td><td>—</td><td>Same as prerun, runs after session</td></tr>
-          <tr><td><code>isolatedScriptExecution</code></td><td>boolean</td><td><code>false</code></td><td>Run PowerShell scripts in isolated scope</td></tr>
-          <tr><td><code>appEnvironment</code></td><td>object</td><td>—</td><td>Custom env vars injected into PS session</td></tr>
-          <tr><td><code>returnAllWindowHandles</code></td><td>boolean</td><td><code>false</code></td><td>Return all top-level windows (not just app's)</td></tr>
-          <tr><td><code>ms:waitForAppLaunch</code></td><td>number</td><td>0</td><td>Seconds to wait for app window after launch</td></tr>
-          <tr><td><code>ms:windowSwitchRetries</code></td><td>number</td><td>20</td><td>Retry count for <code>setWindow()</code></td></tr>
-          <tr><td><code>ms:windowSwitchInterval</code></td><td>number</td><td>500</td><td>ms between <code>setWindow()</code> retries</td></tr>
-        </tbody>
-      </table>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     9. EXECUTESCRIPT EXTENSIONS
-     ============================================================ -->
-<section id="extensions">
-  <div class="container">
-    <p class="section-label">Platform commands</p>
-    <h2><code>executeScript</code> Extensions</h2>
-    <p class="section-intro">All <code>windows:</code> commands grouped by category.</p>
-    <div class="ext-groups">
-      <div class="ext-group">
-        <h3>Mouse &amp; Keyboard</h3>
-        <ul>
-          <li><code>windows: click</code> — advanced click with modifier keys, multi-click, duration</li>
-          <li><code>windows: scroll</code> — mouse wheel (horizontal or vertical)</li>
-          <li><code>windows: hover</code> — mouse move from A to B</li>
-          <li><code>windows: keys</code> — keyboard input (text, virtual key codes, modifiers)</li>
-          <li><code>windows: clickAndDrag</code> — click-press-move-release drag</li>
-        </ul>
-      </div>
-      <div class="ext-group">
-        <h3>UI Patterns</h3>
-        <ul>
-          <li><code>windows: invoke</code>, <code>windows: expand</code>, <code>windows: collapse</code></li>
-          <li><code>windows: toggle</code>, <code>windows: setValue</code>, <code>windows: getValue</code></li>
-          <li><code>windows: select</code>, <code>windows: addToSelection</code>, <code>windows: removeFromSelection</code></li>
-          <li><code>windows: selectedItem</code>, <code>windows: allSelectedItems</code>, <code>windows: isMultiple</code></li>
-          <li><code>windows: scrollIntoView</code>, <code>windows: setFocus</code></li>
-        </ul>
-      </div>
-      <div class="ext-group">
-        <h3>Window Management</h3>
-        <ul>
-          <li><code>windows: maximize</code>, <code>windows: minimize</code>, <code>windows: restore</code>, <code>windows: close</code></li>
-          <li><code>windows: getMonitors</code> — multi-monitor info</li>
-          <li><code>windows: getWindowElement</code> — root element of current window</li>
-          <li><code>windows: launchApp</code>, <code>windows: closeApp</code></li>
-        </ul>
-      </div>
-      <div class="ext-group">
-        <h3>System</h3>
-        <ul>
-          <li><code>windows: setClipboard</code>, <code>windows: getClipboard</code></li>
-          <li><code>windows: startRecordingScreen</code>, <code>windows: stopRecordingScreen</code></li>
-          <li><code>windows: deleteFile</code>, <code>windows: deleteFolder</code></li>
-          <li><code>windows: pushCacheRequest</code> — UIA RawView element caching</li>
-        </ul>
-      </div>
-    </div>
-  </div>
-</section>
-<!-- ============================================================
-     FOOTER
-     ============================================================ -->
-<footer>
-  <div class="footer-inner">
-    <span>Built by <a href="https://verisoft.ai" target="_blank" rel="noopener"><img src="logo.png" alt="VeriSoft" class="footer-logo" /></a> · Apache 2.0</span>
-    <ul class="footer-links">
-      <li><a href="https://github.com/verisoft-ai/appium-desktop-driver" target="_blank" rel="noopener">GitHub</a></li>
-      <li><a href="https://www.npmjs.com/package/appium-desktop-driver" target="_blank" rel="noopener">npm</a></li>
-      <li><a href="https://github.com/verisoft-ai/appium-desktop-driver/issues" target="_blank" rel="noopener">Issues</a></li>
-      <li><a href="https://github.com/verisoft-ai/appium-desktop-driver/blob/main/LICENSE" target="_blank" rel="noopener">License</a></li>
-    </ul>
-  </div>
-</footer>
-<!-- Prism.js (syntax highlighting) -->
-<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-core.min.js"></script>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/autoloader/prism-autoloader.min.js"></script>
-<script src="script.js"></script>
-</body>
-</html>

package/docs/logo.png DELETED Viewed

Binary file

package/docs/mcp-demo.mp4 DELETED Viewed

Binary file