appium-mcp 0.0.1 → 1.1.4

package/dist/tools/scroll-to-element.js

@@ -0,0 +1,155 @@
+import { getDriver, getPlatformName } from './session-store.js';
+import { z } from 'zod';
+const scrollToElementSchema = z.object({
+    strategy: z.enum([
+        'xpath',
+        'id',
+        'name',
+        'class name',
+        'accessibility id',
+        'css selector',
+        '-android uiautomator',
+        '-ios predicate string',
+        '-ios class chain',
+    ]),
+    selector: z.string().describe('The selector to find the element'),
+    direction: z
+        .enum(['up', 'down'])
+        .default('down')
+        .describe('Direction to scroll when searching for the element'),
+});
+const getValue = (xpath, expression) => {
+    // Extracts the value from an XPath expression.
+    let start = xpath.indexOf(expression) + expression.length;
+    start = xpath.indexOf("'", start) + 1;
+    let end = xpath.indexOf("'", start);
+    return xpath.substring(start, end);
+};
+const transformXPath = (xpath) => {
+    // normalize xpath expression by replacing " by '
+    xpath = xpath.replace(/"/g, "'");
+    if (xpath.includes('@text='))
+        return { strategy: 'text', selector: getValue(xpath, '@text=') };
+    if (xpath.includes('@content-desc='))
+        return {
+            strategy: 'description',
+            selector: getValue(xpath, '@content-desc='),
+        };
+    if (xpath.includes('contains(@text,'))
+        return {
+            strategy: 'textContains',
+            selector: getValue(xpath, 'contains(@text,'),
+        };
+    if (xpath.includes('contains(@content-desc,'))
+        return {
+            strategy: 'descriptionContains',
+            selector: getValue(xpath, 'contains(@content-desc,'),
+        };
+    throw new Error(`Unsupported XPath expression: ${xpath}. Supported expressions are: @text, @content-desc, contains(@text, ...), contains(@content-desc, ...)`);
+};
+const transformLocator = (strategy, selector) => {
+    if (strategy === 'id')
+        return { strategy: 'resourceId', selector };
+    if (strategy === 'xpath')
+        return transformXPath(selector);
+    if (strategy === 'class name')
+        return { strategy: 'className', selector };
+    return { strategy, selector };
+};
+async function performAndroidScroll(driver, args, direction) {
+    // Use UiAutomator scroll gestures for Android
+    const scrollDirection = direction === 'up' ? 'scrollBackward' : 'scrollForward';
+    const scrollCommand = `new UiScrollable(new UiSelector().scrollable(true)).${scrollDirection}()`;
+    try {
+        await driver.findElement('-android uiautomator', scrollCommand);
+    }
+    catch (error) {
+        // If UiScrollable fails, try touch actions
+        const { width, height } = await driver.getWindowSize();
+        const startX = width / 2;
+        const startY = direction === 'up' ? height * 0.3 : height * 0.7;
+        const endY = direction === 'up' ? height * 0.7 : height * 0.3;
+        await driver.touchAction([
+            { action: 'press', x: startX, y: startY },
+            { action: 'wait', ms: 500 },
+            { action: 'moveTo', x: startX, y: endY },
+            { action: 'release' },
+        ]);
+    }
+}
+async function performiOSScroll(driver, direction) {
+    // Use iOS mobile commands for scrolling
+    const { width, height } = await driver.getWindowSize();
+    await driver.execute('mobile: scroll', {
+        direction: direction,
+        startX: width / 2,
+        startY: direction === 'up' ? height * 0.3 : height * 0.7,
+        endX: width / 2,
+        endY: direction === 'up' ? height * 0.7 : height * 0.3,
+    });
+}
+export default function scrollToElement(server) {
+    server.addTool({
+        name: 'appium_scroll_to_element',
+        description: 'Scrolls the current screen till a certain element is visible',
+        parameters: scrollToElementSchema,
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No active driver session. Please create a session first.');
+            }
+            try {
+                const platform = getPlatformName(driver);
+                // First try to find the element directly (it might already be in viewport)
+                try {
+                    const element = await driver.findElement(args.strategy, args.selector);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Element ${args.selector} is already visible on screen.`,
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    const direction = args.direction || 'down';
+                    switch (platform) {
+                        case 'Android':
+                            await performAndroidScroll(driver, args, direction);
+                            break;
+                        case 'iOS':
+                            await performiOSScroll(driver, direction);
+                            break;
+                        default:
+                            throw new Error('Unsupported driver type. This tool only supports Android and iOS drivers.');
+                    }
+                    const element = await driver.findElement(args.strategy, args.selector);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Successfully scrolled found element ${args.selector} after initial scroll.`,
+                            },
+                        ],
+                    };
+                }
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to scroll and find element. Error: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=scroll-to-element.js.map

package/dist/tools/scroll-to-element.js.map

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

package/dist/tools/scroll.d.ts

@@ -0,0 +1 @@
+export default function scroll(server: any): void;

package/dist/tools/scroll.js

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { getDriver, getPlatformName } from './session-store.js';
+export default function scroll(server) {
+    server.addTool({
+        name: 'appium_scroll',
+        description: 'Scrolls the current screen up or down',
+        parameters: z.object({
+            direction: z
+                .enum(['up', 'down'])
+                .default('down')
+                .describe('Scroll direction'),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            const driver = getDriver();
+            if (!driver) {
+                throw new Error('No active driver session. Please create a session first.');
+            }
+            try {
+                const { width, height } = await driver.getWindowSize();
+                console.log('Device screen size:', { width, height });
+                const startX = Math.floor(width / 2);
+                // calculate start and end Y positions for scrolling depending on the direction
+                // startY is at 80% of the height, endY is at 20% of the height for downward scroll
+                // and vice versa for upward scroll
+                // this ensures that the scroll starts from the bottom of the screen and goes to the top
+                // or starts from the top and goes to the bottom
+                // Adjust these percentages as needed for your specific use case
+                const startY = args.direction === 'down'
+                    ? Math.floor(height * 0.8)
+                    : Math.floor(height * 0.2);
+                const endY = args.direction === 'down'
+                    ? Math.floor(height * 0.2)
+                    : Math.floor(height * 0.8);
+                console.log('Going to scroll from:', { startX, startY });
+                console.log('Going to scroll to:', { startX, endY });
+                if (getPlatformName(driver) === 'Android') {
+                    await driver.performActions([
+                        {
+                            type: 'pointer',
+                            id: 'finger1',
+                            parameters: { pointerType: 'touch' },
+                            actions: [
+                                { type: 'pointerMove', duration: 0, x: startX, y: startY },
+                                { type: 'pointerDown', button: 0 },
+                                { type: 'pause', duration: 250 },
+                                { type: 'pointerMove', duration: 600, x: startX, y: endY },
+                                { type: 'pointerUp', button: 0 },
+                            ],
+                        },
+                    ]);
+                    console.log('Scroll action completed successfully.');
+                }
+                else if (getPlatformName(driver) === 'iOS') {
+                    await driver.execute('mobile: scroll', {
+                        direction: args.direction,
+                        startX: startX,
+                        startY: startY,
+                        endX: startX,
+                        endY: endY,
+                    });
+                }
+                else {
+                    throw new Error(`Unsupported platform: ${getPlatformName(driver)}. Only Android and iOS are supported.`);
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Scrolled ${args.direction} successfully.`,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Failed to scroll ${args.direction}. Error: ${err.toString()}`,
+                        },
+                    ],
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=scroll.js.map

package/dist/tools/scroll.js.map

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

package/dist/tools/select-device.d.ts

@@ -0,0 +1,5 @@
+export declare function getSelectedDevice(): string | null;
+export declare function getSelectedDeviceType(): 'simulator' | 'real' | null;
+export declare function getSelectedDeviceInfo(): any;
+export declare function clearSelectedDevice(): void;
+export default function selectDevice(server: any): void;

package/dist/tools/select-device.js

@@ -0,0 +1,222 @@
+/**
+ * Tool to select a specific device when multiple devices are available
+ */
+import { ADBManager } from '../devicemanager/adb-manager.js';
+import { IOSManager } from '../devicemanager/ios-manager.js';
+import { z } from 'zod';
+import log from '../locators/logger.js';
+// Store selected device globally
+let selectedDeviceUdid = null;
+let selectedDeviceType = null;
+let selectedDeviceInfo = null;
+export function getSelectedDevice() {
+    return selectedDeviceUdid;
+}
+export function getSelectedDeviceType() {
+    return selectedDeviceType;
+}
+export function getSelectedDeviceInfo() {
+    return selectedDeviceInfo;
+}
+export function clearSelectedDevice() {
+    selectedDeviceUdid = null;
+    selectedDeviceType = null;
+    selectedDeviceInfo = null;
+}
+/**
+ * Get and validate Android devices
+ */
+async function getAndroidDevices() {
+    const adb = await ADBManager.getInstance().initialize();
+    const devices = await adb.getConnectedDevices();
+    if (devices.length === 0) {
+        throw new Error('No Android devices/emulators found');
+    }
+    return devices;
+}
+/**
+ * Validate and select Android device by UDID
+ */
+function selectAndroidDevice(deviceUdid, devices) {
+    const selectedDevice = devices.find(d => d.udid === deviceUdid);
+    if (!selectedDevice) {
+        throw new Error(`Device with UDID "${deviceUdid}" not found. Available devices: ${devices.map(d => d.udid).join(', ')}`);
+    }
+    selectedDeviceUdid = deviceUdid;
+    log.info(`Device selected: ${deviceUdid}`);
+}
+/**
+ * Format device selection response for Android
+ */
+function formatAndroidSelectionResponse(deviceUdid) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: `✅ Device selected: ${deviceUdid}`,
+                    instructions: '🚀 You can now create a session using the create_session tool with:',
+                    platform: 'android',
+                    capabilities: {
+                        'appium:udid': deviceUdid,
+                    },
+                }, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Format device list response for Android
+ */
+function formatAndroidListResponse(devices) {
+    const deviceList = devices
+        .map((device, index) => `  ${index + 1}. ${device.udid}`)
+        .join('\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `📱 Available Android devices/emulators (${devices.length}):\n${deviceList}\n\n⚠️ IMPORTANT: Please ask the user which device they want to use.\n\nOnce the user selects a device, call this tool again with the deviceUdid parameter set to their chosen device UDID.`,
+            },
+        ],
+    };
+}
+/**
+ * Validate iOS device type
+ */
+function validateIOSDeviceType(iosDeviceType) {
+    if (!iosDeviceType) {
+        throw new Error("For iOS platform, iosDeviceType ('simulator' or 'real') is required");
+    }
+}
+/**
+ * Get and validate iOS devices by type
+ */
+async function getIOSDevices(iosDeviceType) {
+    const iosManager = IOSManager.getInstance();
+    const devices = await iosManager.getDevicesByType(iosDeviceType);
+    if (devices.length === 0) {
+        throw new Error(`No iOS ${iosDeviceType === 'simulator' ? 'simulators' : 'devices'} found`);
+    }
+    return devices;
+}
+/**
+ * Validate and select iOS device by UDID
+ */
+function selectIOSDevice(deviceUdid, devices, iosDeviceType) {
+    const selectedDevice = devices.find(d => d.udid === deviceUdid);
+    if (!selectedDevice) {
+        const deviceList = devices.map(d => `${d.name} (${d.udid})`).join(', ');
+        throw new Error(`Device with UDID "${deviceUdid}" not found. Available devices: ${deviceList}`);
+    }
+    selectedDeviceUdid = deviceUdid;
+    selectedDeviceType = iosDeviceType;
+    selectedDeviceInfo = selectedDevice;
+    log.info(`iOS ${iosDeviceType} selected: ${selectedDevice.name} (${deviceUdid})`);
+    return selectedDevice;
+}
+/**
+ * Format device selection response for iOS
+ */
+function formatIOSSelectionResponse(deviceName, deviceUdid) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    message: `✅ Device selected: ${deviceName} (${deviceUdid})`,
+                    instructions: '🚀 You can now call the setup_wda tool to setup WDA on the simulator.',
+                    platform: 'ios',
+                    capabilities: {
+                        'appium:udid': deviceUdid,
+                    },
+                }, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Format device list response for iOS
+ */
+function formatIOSListResponse(devices, iosDeviceType) {
+    const deviceList = devices
+        .map((device, index) => `  ${index + 1}. ${device.name} (${device.udid})${device.state ? ` - ${device.state}` : ''}`)
+        .join('\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `📱 Available iOS ${iosDeviceType === 'simulator' ? 'simulators' : 'devices'} (${devices.length}):\n${deviceList}\n\n⚠️ IMPORTANT: Please ask the user which device they want to use.\n\nOnce the user selects a device, call this tool again with the deviceUdid parameter set to their chosen device UDID.`,
+            },
+        ],
+    };
+}
+/**
+ * Handle Android device selection
+ */
+async function handleAndroidDeviceSelection(deviceUdid) {
+    const devices = await getAndroidDevices();
+    if (deviceUdid) {
+        selectAndroidDevice(deviceUdid, devices);
+        return formatAndroidSelectionResponse(deviceUdid);
+    }
+    return formatAndroidListResponse(devices);
+}
+/**
+ * Handle iOS device selection
+ */
+async function handleIOSDeviceSelection(iosDeviceType, deviceUdid) {
+    validateIOSDeviceType(iosDeviceType);
+    const devices = await getIOSDevices(iosDeviceType);
+    if (deviceUdid) {
+        const selectedDevice = selectIOSDevice(deviceUdid, devices, iosDeviceType);
+        return formatIOSSelectionResponse(selectedDevice.name, deviceUdid);
+    }
+    return formatIOSListResponse(devices, iosDeviceType);
+}
+export default function selectDevice(server) {
+    server.addTool({
+        name: 'select_device',
+        description: `REQUIRED when multiple devices are found: Ask the user to select which specific device they want to use from the available devices. 
+      This tool lists all available devices and allows selection by UDID. 
+      You MUST use this tool when select_platform returns multiple devices before calling create_session for android.
+      You MUST use this tool when select_platform returns multiple devices before calling boot_simulator for ios if the user has selected simulator device type.
+      `,
+        parameters: z.object({
+            platform: z
+                .enum(['ios', 'android'])
+                .describe('The platform to list devices for (must match previously selected platform)'),
+            iosDeviceType: z
+                .enum(['simulator', 'real'])
+                .optional()
+                .describe("For iOS only: Specify whether to use 'simulator' or 'real' device. REQUIRED when platform is 'ios'."),
+            deviceUdid: z
+                .string()
+                .optional()
+                .describe('The UDID of the device selected by the user. If not provided, this tool will list available devices for the user to choose from.'),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            openWorldHint: false,
+        },
+        execute: async (args, context) => {
+            try {
+                const { platform, iosDeviceType, deviceUdid } = args;
+                if (platform === 'android') {
+                    return await handleAndroidDeviceSelection(deviceUdid);
+                }
+                else if (platform === 'ios') {
+                    return await handleIOSDeviceSelection(iosDeviceType, deviceUdid);
+                }
+                else {
+                    throw new Error(`Invalid platform: ${platform}. Please choose 'android' or 'ios'.`);
+                }
+            }
+            catch (error) {
+                log.error('Error selecting device:', error);
+                throw new Error(`Failed to select device: ${error.message}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=select-device.js.map

package/dist/tools/select-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-device.js","sourceRoot":"","sources":["../../src/tools/select-device.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,GAAG,MAAM,uBAAuB,CAAC;AAExC,iCAAiC;AACjC,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAC7C,IAAI,kBAAkB,GAAgC,IAAI,CAAC;AAC3D,IAAI,kBAAkB,GAAQ,IAAI,CAAC;AAEnC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,kBAAkB,GAAG,IAAI,CAAC;IAC1B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB;IAC9B,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAEhD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAAkB,EAAE,OAAc;IAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAChE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,mCAAmC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;IACJ,CAAC;IAED,kBAAkB,GAAG,UAAU,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,8BAA8B,CAAC,UAAkB;IACxD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,sBAAsB,UAAU,EAAE;oBAC3C,YAAY,EACV,qEAAqE;oBACvE,QAAQ,EAAE,SAAS;oBACnB,YAAY,EAAE;wBACZ,aAAa,EAAE,UAAU;qBAC1B;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,OAAc;IAC/C,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;SACxD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,2CAA2C,OAAO,CAAC,MAAM,OAAO,UAAU,6LAA6L;aAC9Q;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,aAA+C;IAE/C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,aAAmC;IAEnC,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAEjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,UAAU,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,QAAQ,CAC3E,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACtB,UAAkB,EAClB,OAAc,EACd,aAAmC;IAEnC,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAChE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,mCAAmC,UAAU,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,kBAAkB,GAAG,UAAU,CAAC;IAChC,kBAAkB,GAAG,aAAa,CAAC;IACnC,kBAAkB,GAAG,cAAc,CAAC;IACpC,GAAG,CAAC,IAAI,CACN,OAAO,aAAa,cAAc,cAAc,CAAC,IAAI,KAAK,UAAU,GAAG,CACxE,CAAC;IAEF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CACjC,UAAkB,EAClB,UAAkB;IAElB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,OAAO,EAAE,sBAAsB,UAAU,KAAK,UAAU,GAAG;oBAC3D,YAAY,EACV,uEAAuE;oBACzE,QAAQ,EAAE,KAAK;oBACf,YAAY,EAAE;wBACZ,aAAa,EAAE,UAAU;qBAC1B;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,OAAc,EACd,aAAmC;IAEnC,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CACF,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAChB,KAAK,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/F;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,oBAAoB,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,OAAO,UAAU,6LAA6L;aACpT;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,4BAA4B,CAAC,UAAmB;IAC7D,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAE1C,IAAI,UAAU,EAAE,CAAC;QACf,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,8BAA8B,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CACrC,aAA+C,EAC/C,UAAmB;IAEnB,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,aAAc,CAAC,CAAC;IAEpD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,EAAE,OAAO,EAAE,aAAc,CAAC,CAAC;QAC5E,OAAO,0BAA0B,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,EAAE,aAAc,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,MAAW;IAC9C,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;;OAIV;QACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;iBACxB,QAAQ,CACP,4EAA4E,CAC7E;YACH,aAAa,EAAE,CAAC;iBACb,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;iBAC3B,QAAQ,EAAE;iBACV,QAAQ,CACP,qGAAqG,CACtG;YACH,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kIAAkI,CACnI;SACJ,CAAC;QACF,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,OAAY,EAAgB,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;gBAErD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,OAAO,MAAM,4BAA4B,CAAC,UAAU,CAAC,CAAC;gBACxD,CAAC;qBAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;oBAC9B,OAAO,MAAM,wBAAwB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;gBACnE,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CACb,qBAAqB,QAAQ,qCAAqC,CACnE,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/select-platform.d.ts

@@ -0,0 +1 @@
+export default function selectPlatform(server: any): void;