appium-desktop-driver 1.2.0

package/ROADMAP.md

@@ -0,0 +1,175 @@
+# Roadmap
+
+## Tier 1 — Complete What's Started
+
+These are partially implemented or explicitly TODO'd in the code.
+
+### 1. Touch & Pen Input
+
+- [ ] `lib/commands/actions.ts:51-52` throws `NotImplementedError` for
+  touch/pen pointer types
+- [ ] Enable stylus pressure simulation for drawing apps, touchscreen
+  device testing
+
+### 2. Device Command Stubs
+
+- [x] `lib/commands/device.ts` has stubs for: `pushFile`, `pullFile`,
+  `pullFolder`, `hideKeyboard`, `isKeyboardShown`, `activateApp`,
+  `terminateApp`, `isAppInstalled`
+- [x] These are already in the Appium protocol — just need Windows
+  implementations
+
+### 3. Cached Element Support
+
+- [ ] `pushCacheRequest` exists but cached elements are not actually
+  usable yet
+- [ ] Would significantly improve performance for large UI trees
+
+### 4. Configurable Window Retry Parameters
+
+- [x] `lib/commands/app.ts:113,136,137` — retries & sleep are hardcoded
+  at 20 × 500ms
+- [x] Should be session capabilities: `ms:windowSwitchRetries`,
+  `ms:windowSwitchInterval`
+
+---
+
+## Tier 2 — High-Value New Features
+
+### 5. .NET Backend (Replace PowerShell)
+
+- [ ] README explicitly mentions this as a planned migration
+- [ ] Would dramatically improve: startup time, reliability, Unicode
+  support, complex tree traversal
+- [ ] Suggested: embed a .NET named-pipe server as a sidecar process
+
+### 6. Multi-Monitor Support
+
+- [ ] Currently no way to target a specific display
+- [ ] Add capability: `ms:targetMonitor` (index or device name)
+- [ ] Affects: screenshot, `getWindowRect`, mouse coordinate
+  normalization
+
+### 7. UI Automation Event Subscription
+
+- [ ] Currently purely polling-based
+- [ ] UIA supports native event callbacks: focus changed, property
+  changed, window opened/closed, structure changed
+- [ ] Would enable `waitForElement` without polling, and event-driven
+  test patterns
+- [ ] MCP equivalent: `subscribe_to_events` / `wait_for_event` tools
+
+### 8. XPath 2.0 / Ancestor Axis Support
+
+- [ ] Current XPath 1.0 (`lib/xpath/`) lacks `ancestor::`,
+  `following-sibling::`, etc.
+- [ ] Many real-world locator patterns rely on these
+
+### 9. OCR-Based Element Finding
+
+- [ ] New locator strategy: `-windows ocr` using Windows.Media.Ocr API
+  (built into Win10+)
+- [ ] Find elements by visible text when no accessibility properties
+  exist (games, legacy apps)
+- [ ] MCP tool: `find_by_text_ocr`
+
+### 10. Image-Based Element Matching
+
+- [ ] New locator: `-windows image` (template matching)
+- [ ] Appium already defines this strategy in the protocol
+- [ ] Use OpenCV/sharp for pixel-based matching — useful when UIA tree
+  is flat/inaccessible
+
+---
+
+## Tier 3 — Developer & AI Experience
+
+### 11. MCP Session Pooling
+
+- [ ] MCP server currently manages one session at a time
+- [ ] Pool of sessions would allow parallel AI agent workflows on the
+  same machine
+
+### 12. Structured Page Source (JSON)
+
+- [ ] `getPageSource()` returns XML — hard to parse in AI contexts
+- [ ] Add `windows: getPageSourceJson` extension command + MCP tool
+  returning a clean JSON tree with suggested selectors ranked by
+  stability
+
+### 13. Visual Snapshot Tool (MCP)
+
+- [ ] Combined screenshot + annotated element map (bounding boxes +
+  selectors overlaid)
+- [ ] Single MCP call that gives the AI both visual and structural
+  context simultaneously
+
+### 14. Accessibility Audit Command
+
+- [ ] `windows: auditAccessibility` — traverse the UIA tree and report:
+  missing names, non-interactive controls with keyboard handlers,
+  invisible but enabled elements
+- [ ] Useful for teams building accessible Windows apps
+
+### 15. App Performance Telemetry
+
+- [ ] Tap Windows Performance Counters: CPU %, memory, GDI objects,
+  handle count per PID
+- [ ] Extension command: `windows: getAppMetrics`
+- [ ] MCP tool: `get_app_performance`
+
+---
+
+## Tier 4 — Ecosystem & Reliability
+
+### 16. Retry / Wait DSL
+
+- [ ] Currently callers must implement their own polling
+- [ ] Built-in `waitUntil` semantics: `windows: waitForElement`,
+  `windows: waitForCondition`
+- [ ] Configurable timeout + interval, avoids sleep-based hacks in test
+  code
+
+### 17. Session Recording & Replay
+
+- [ ] Record all commands with timing to a JSON log
+- [ ] Replay capability for regression testing without writing test
+  scripts
+
+### 18. DPI-Aware Coordinate Handling
+
+- [ ] `lib/winapi/user32.ts:727` — `getResolutionScalingFactor()`
+  exists but is unused
+- [ ] Apply it consistently across mouse coordinates, element rects,
+  screenshots
+- [ ] Critical for multi-DPI setups (Surface devices, 4K + 1080p mixed)
+
+### 19. Remote Windows Support (WinRM/SSH)
+
+- [ ] Currently assumes local process execution
+- [ ] Long-term: route PowerShell/pipe commands over WinRM for remote
+  desktop automation
+
+---
+
+## Priority Summary
+
+| Priority | Feature | Effort | Impact | Status |
+| --- | --- | --- | --- | --- |
+| P0 | Device command stubs | Low | High | [x] |
+| P0 | Configurable window retry | Low | Medium | [x] |
+| P1 | Touch/pen input | Medium | High | [ ] |
+| P1 | DPI-aware coordinates | Medium | High | [ ] |
+| P1 | `waitForElement` DSL | Medium | High | [ ] |
+| P1 | Structured JSON page source (MCP) | Low | High | [ ] |
+| P2 | UI Automation events | High | High | [ ] |
+| P2 | XPath 2.0 / ancestor axis | Medium | Medium | [ ] |
+| P2 | Visual snapshot MCP tool | Medium | High | [ ] |
+| P2 | App performance telemetry | Medium | Medium | [ ] |
+| P3 | OCR-based locator | High | High | [ ] |
+| P3 | Image-based locator | High | Medium | [ ] |
+| P3 | .NET backend migration | Very High | Very High | [ ] |
+| P3 | Multi-monitor support | Medium | Medium | [ ] |
+| P4 | MCP session pooling | High | Medium | [ ] |
+| P4 | Session recording/replay | High | Medium | [ ] |
+| P4 | Accessibility audit | Medium | Medium | [ ] |

package/build/lib/commands/actions.d.ts

@@ -0,0 +1,12 @@
+import { ActionSequence, KeyAction, KeyActionSequence, NullActionSequence, PointerActionSequence, PointerMoveAction, ScrollAction, WheelActionSequence } from '@appium/types';
+import { NovaWindowsDriver } from '../driver';
+export declare function performActions(this: NovaWindowsDriver, actionSequences: ActionSequence[]): Promise<void>;
+export declare function handleKeyActionSequence(this: NovaWindowsDriver, actionSequence: KeyActionSequence): Promise<void>;
+export declare function handlePointerActionSequence(this: NovaWindowsDriver, actionSequence: PointerActionSequence): Promise<void>;
+export declare function handleMousePointerActionSequence(this: NovaWindowsDriver, actionSequence: PointerActionSequence): Promise<void>;
+export declare function handleWheelActionSequence(this: NovaWindowsDriver, actionSequence: WheelActionSequence): Promise<void>;
+export declare function handleNullActionSequence(this: NovaWindowsDriver, actionSequence: NullActionSequence): Promise<void>;
+export declare function handleMouseMoveAction(this: NovaWindowsDriver, action: PointerMoveAction | ScrollAction): Promise<void>;
+export declare function handleKeyAction(this: NovaWindowsDriver, action: KeyAction): Promise<void>;
+export declare function releaseActions(this: NovaWindowsDriver): Promise<void>;
+//# sourceMappingURL=actions.d.ts.map

package/build/lib/commands/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../lib/commands/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EAEjB,YAAY,EACZ,mBAAmB,EACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAM9C,wBAAsB,cAAc,CAAC,IAAI,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9G;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvH;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS/H;AAED,wBAAsB,gCAAgC,CAAC,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpI;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3H;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzH;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B5H;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF/F;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3E"}

package/build/lib/commands/actions.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performActions = performActions;
+exports.handleKeyActionSequence = handleKeyActionSequence;
+exports.handlePointerActionSequence = handlePointerActionSequence;
+exports.handleMousePointerActionSequence = handleMousePointerActionSequence;
+exports.handleWheelActionSequence = handleWheelActionSequence;
+exports.handleNullActionSequence = handleNullActionSequence;
+exports.handleMouseMoveAction = handleMouseMoveAction;
+exports.handleKeyAction = handleKeyAction;
+exports.releaseActions = releaseActions;
+const base_driver_1 = require("@appium/base-driver");
+const user32_1 = require("../winapi/user32");
+const util_1 = require("../util");
+const powershell_1 = require("../powershell");
+const enums_1 = require("../enums");
+async function performActions(actionSequences) {
+    for (const actionSequence of actionSequences) {
+        switch (actionSequence.type) {
+            case 'key':
+                await this.handleKeyActionSequence(actionSequence);
+                break;
+            case 'wheel':
+                await this.handleWheelActionSequence(actionSequence);
+                break;
+            case 'pointer':
+                await this.handlePointerActionSequence(actionSequence);
+                break;
+            case 'none':
+                await this.handleNullActionSequence(actionSequence);
+                break;
+            default:
+                throw new base_driver_1.errors.InvalidArgumentError();
+        }
+    }
+}
+;
+async function handleKeyActionSequence(actionSequence) {
+    const actions = actionSequence.actions;
+    for (const action of actions) {
+        await this.handleKeyAction(action);
+    }
+}
+async function handlePointerActionSequence(actionSequence) {
+    switch (actionSequence.parameters?.pointerType) {
+        case 'touch':
+        case 'pen':
+            throw new base_driver_1.errors.NotImplementedError(`Pointer type ${actionSequence.parameters?.pointerType} not implemented yet.`);
+        case 'mouse':
+        default:
+            await this.handleMousePointerActionSequence(actionSequence);
+    }
+}
+async function handleMousePointerActionSequence(actionSequence) {
+    const actions = actionSequence.actions;
+    for (const action of actions) {
+        switch (action.type) {
+            case 'pointerMove':
+                await this.handleMouseMoveAction(action);
+                break;
+            case 'pointerDown':
+                (0, user32_1.mouseDown)(action.button);
+                break;
+            case 'pointerUp':
+                (0, user32_1.mouseUp)(action.button);
+                break;
+            case 'pause':
+                if (action.duration) {
+                    await (0, util_1.sleep)(action.duration);
+                }
+                break;
+            default:
+                throw new base_driver_1.errors.InvalidArgumentError();
+        }
+    }
+}
+async function handleWheelActionSequence(actionSequence) {
+    const actions = actionSequence.actions;
+    for (const action of actions) {
+        switch (action.type) {
+            case 'scroll':
+                await this.handleMouseMoveAction(action);
+                (0, user32_1.mouseScroll)(action.deltaX, action.deltaY);
+                break;
+            case 'pause':
+                if (action.duration) {
+                    await (0, util_1.sleep)(action.duration);
+                }
+                break;
+            default:
+                throw new base_driver_1.errors.InvalidArgumentError();
+        }
+    }
+}
+async function handleNullActionSequence(actionSequence) {
+    const actions = actionSequence.actions;
+    for (const action of actions) {
+        if (action.duration) {
+            await (0, util_1.sleep)(action.duration);
+        }
+    }
+}
+async function handleMouseMoveAction(action) {
+    const easingFunction = this.caps.smoothPointerMove;
+    switch (action.origin) {
+        case 'pointer':
+            await (0, user32_1.mouseMoveRelative)(action.x, action.y, action.duration, easingFunction);
+            break;
+        case 'viewport': {
+            const rootRectJson = await this.sendPowerShellCommand(powershell_1.AutomationElement.automationRoot.buildGetElementRectCommand());
+            const rootRect = JSON.parse(rootRectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+            await (0, user32_1.mouseMoveAbsolute)(action.x + rootRect.x, action.y + rootRect.y, action.duration, easingFunction);
+            break;
+        }
+        default:
+            if (action.origin?.[base_driver_1.W3C_ELEMENT_KEY]) {
+                const element = new powershell_1.FoundAutomationElement(action.origin[base_driver_1.W3C_ELEMENT_KEY]);
+                const rectJson = await this.sendPowerShellCommand(element.buildGetElementRectCommand());
+                let rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+                if (Object.values(rect).some((x) => x === 0x7FFFFFFF)) {
+                    await this.sendPowerShellCommand(element.buildScrollIntoViewCommand());
+                    rect = JSON.parse(rectJson.replaceAll(/(?:infinity)/gi, 0x7FFFFFFF.toString()));
+                }
+                await (0, user32_1.mouseMoveAbsolute)(action.x === 0 ? rect.x + rect.width / 2 : action.x, action.y === 0 ? rect.y + rect.height / 2 : action.y, action.duration, easingFunction);
+                break;
+            }
+            throw new base_driver_1.errors.InvalidArgumentError();
+    }
+}
+async function handleKeyAction(action) {
+    if (action.type === 'pause') {
+        if (action.duration) {
+            await (0, util_1.sleep)(action.duration);
+        }
+        return;
+    }
+    switch (action.value) {
+        case enums_1.Key.SHIFT:
+        case enums_1.Key.R_SHIFT:
+            if (action.type === 'keyDown') {
+                (0, user32_1.keyDown)(action.value);
+                this.keyboardState.shift = true;
+                return;
+            }
+            (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+            (0, user32_1.keyUp)(enums_1.Key.R_SHIFT);
+            this.keyboardState.shift = false;
+            return;
+        case enums_1.Key.CONTROL:
+        case enums_1.Key.R_CONTROL:
+            if (action.type === 'keyDown') {
+                (0, user32_1.keyDown)(action.value);
+                this.keyboardState.ctrl = true;
+                return;
+            }
+            (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+            (0, user32_1.keyUp)(enums_1.Key.R_CONTROL);
+            this.keyboardState.ctrl = false;
+            return;
+        case enums_1.Key.META:
+        case enums_1.Key.R_META:
+            if (action.type === 'keyDown') {
+                (0, user32_1.keyDown)(action.value);
+                this.keyboardState.meta = true;
+                return;
+            }
+            (0, user32_1.keyUp)(enums_1.Key.META);
+            (0, user32_1.keyUp)(enums_1.Key.R_META);
+            this.keyboardState.meta = false;
+            return;
+        case enums_1.Key.ALT:
+        case enums_1.Key.R_ALT:
+            if (action.type === 'keyDown') {
+                (0, user32_1.keyDown)(action.value);
+                this.keyboardState.alt = true;
+                return;
+            }
+            (0, user32_1.keyUp)(enums_1.Key.ALT);
+            (0, user32_1.keyUp)(enums_1.Key.R_ALT);
+            this.keyboardState.alt = false;
+            return;
+        case enums_1.Key.NULL:
+            if (action.type === 'keyDown') {
+                if (this.keyboardState.shift) {
+                    await this.handleKeyAction({ type: 'keyUp', value: enums_1.Key.SHIFT });
+                }
+                if (this.keyboardState.ctrl) {
+                    await this.handleKeyAction({ type: 'keyUp', value: enums_1.Key.CONTROL });
+                }
+                if (this.keyboardState.meta) {
+                    await this.handleKeyAction({ type: 'keyUp', value: enums_1.Key.META });
+                }
+                if (this.keyboardState.alt) {
+                    await this.handleKeyAction({ type: 'keyUp', value: enums_1.Key.ALT });
+                }
+                for (const key in Array.of(this.keyboardState.pressed)) {
+                    (0, user32_1.keyUp)(key);
+                    this.keyboardState.pressed.delete(key);
+                }
+            }
+            return;
+        default:
+            if (action.type === 'keyDown') {
+                (0, user32_1.keyDown)(action.value);
+                this.keyboardState.pressed.add(action.value);
+            }
+            else {
+                (0, user32_1.keyUp)(action.value);
+                this.keyboardState.pressed.delete(action.value);
+            }
+    }
+}
+async function releaseActions() {
+    if (this.keyboardState.shift) {
+        (0, user32_1.keyUp)(enums_1.Key.SHIFT);
+        (0, user32_1.keyUp)(enums_1.Key.R_SHIFT);
+        this.keyboardState.shift = false;
+    }
+    if (this.keyboardState.ctrl) {
+        (0, user32_1.keyUp)(enums_1.Key.CONTROL);
+        (0, user32_1.keyUp)(enums_1.Key.R_CONTROL);
+        this.keyboardState.ctrl = false;
+    }
+    if (this.keyboardState.meta) {
+        (0, user32_1.keyUp)(enums_1.Key.META);
+        (0, user32_1.keyUp)(enums_1.Key.R_META);
+        this.keyboardState.meta = false;
+    }
+    if (this.keyboardState.alt) {
+        (0, user32_1.keyUp)(enums_1.Key.ALT);
+        (0, user32_1.keyUp)(enums_1.Key.R_ALT);
+        this.keyboardState.alt = false;
+    }
+    for (const key of this.keyboardState.pressed) {
+        (0, user32_1.keyUp)(key);
+    }
+    this.keyboardState.pressed.clear();
+    (0, user32_1.mouseUp)(0);
+    (0, user32_1.mouseUp)(1);
+    (0, user32_1.mouseUp)(2);
+}
+//# sourceMappingURL=actions.js.map

package/build/lib/commands/actions.js.map

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

package/build/lib/commands/app.d.ts

@@ -0,0 +1,18 @@
+import { Rect } from '@appium/types';
+import { NovaWindowsDriver } from '../driver';
+export declare function getPageSource(this: NovaWindowsDriver): Promise<string>;
+export declare function getScreenshot(this: NovaWindowsDriver): Promise<string>;
+export declare function getWindowRect(this: NovaWindowsDriver): Promise<Rect>;
+export declare function getWindowHandle(this: NovaWindowsDriver): Promise<string>;
+export declare function getWindowHandles(this: NovaWindowsDriver): Promise<string[]>;
+export declare function setWindow(this: NovaWindowsDriver, nameOrHandle: string): Promise<void>;
+export declare function closeApp(this: NovaWindowsDriver): Promise<void>;
+export declare function launchApp(this: NovaWindowsDriver): Promise<void>;
+export declare function changeRootElement(this: NovaWindowsDriver, path: string): Promise<void>;
+export declare function changeRootElement(this: NovaWindowsDriver, nativeWindowHandle: number): Promise<void>;
+export declare function back(this: NovaWindowsDriver): Promise<void>;
+export declare function forward(this: NovaWindowsDriver): Promise<void>;
+export declare function title(this: NovaWindowsDriver): Promise<string>;
+export declare function setWindowRect(this: NovaWindowsDriver, x: number | null, y: number | null, width: number | null, height: number | null): Promise<Rect>;
+export declare function attachToApplicationWindow(this: NovaWindowsDriver, processIds: number[]): Promise<void>;
+//# sourceMappingURL=app.d.ts.map

package/build/lib/commands/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../lib/commands/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,IAAI,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AA4D9C,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBjF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC5F;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtE;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7F,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAsD3G,wBAAsB,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQpE;AAED,wBAAsB,aAAa,CAC/B,IAAI,EAAE,iBAAiB,EACvB,CAAC,EAAE,MAAM,GAAG,IAAI,EAChB,CAAC,EAAE,MAAM,GAAG,IAAI,EAChB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAGD,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD5G"}