@midscene/ios 0.30.3-beta-20251011080128.0 → 0.30.3-beta-20251014030035.0

package/dist/es/bin.mjs

@@ -31,7 +31,7 @@ import { Agent } from "@midscene/core/agent";
 import { getDebug } from "@midscene/shared/logger";
 import node_assert from "node:assert";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { defineAction, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionScroll, defineActionTap } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionScroll, defineActionTap } from "@midscene/core/device";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
 import { WDAManager, WebDriverClient } from "@midscene/webdriver";
 import "node:os";
@@ -12033,6 +12033,16 @@ class IOSWebDriverClient extends WebDriverClient {
         });
         debugIOS(`Double tapped at coordinates (${x}, ${y})`);
     }
+    async tripleTap(x, y) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/tapWithNumberOfTaps`, {
+            x,
+            y,
+            numberOfTaps: 3,
+            numberOfTouches: 1
+        });
+        debugIOS(`Triple tapped at coordinates (${x}, ${y})`);
+    }
     async getScreenScale() {
         var _screenResponse_value;
         const screenResponse = await this.makeRequest('GET', '/wda/screen');
@@ -12079,6 +12089,7 @@ function device_define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const BackspaceChar = '\u0008';
 class device_IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -12097,17 +12108,23 @@ class device_IOSDevice {
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
                 paramSchema: z.object({
-                    value: z.string().describe('The final that should be filled in the input box. No matter what modifications are required, just provide the final value to replace the existing input value. Giving a blank string means clear the input field.'),
+                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
                     autoDismissKeyboard: z.boolean().optional().describe('If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.'),
+                    mode: z["enum"]([
+                        'replace',
+                        'clear',
+                        'append'
+                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "append" - append the value to existing content; "clear" - clear the field without inputting new text.'),
                     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
                 }),
                 call: async (param)=>{
                     var _this_options;
                     const element = param.locate;
                     if (element) {
-                        await this.clearInput(element);
-                        if (!param || !param.value) return;
+                        if ('append' !== param.mode) await this.clearInput(element);
                     }
+                    if ('clear' === param.mode) return;
+                    if (!param || !param.value) return;
                     const autoDismissKeyboard = param.autoDismissKeyboard ?? (null == (_this_options = this.options) ? void 0 : _this_options.autoDismissKeyboard);
                     await this.typeText(param.value, {
                         autoDismissKeyboard
@@ -12175,6 +12192,11 @@ class device_IOSDevice {
                     const [x, y] = element.center;
                     await this.longPress(x, y, null == param ? void 0 : param.duration);
                 }
+            }),
+            defineActionClearInput(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'Element not found, cannot clear input');
+                await this.clearInput(element);
             })
         ];
         const customActions = this.customActions || [];
@@ -12278,13 +12300,13 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         await this.tap(element.center[0], element.center[1]);
         await sleep(100);
         try {
-            await this.longPress(element.center[0], element.center[1], 800);
+            await this.tripleTap(element.center[0], element.center[1]);
             await sleep(200);
-            await this.wdaBackend.typeText('');
+            await this.wdaBackend.typeText(BackspaceChar);
         } catch (error2) {
             debugDevice(`Method 1 failed, trying method 2: ${error2}`);
             try {
-                const backspaces = Array(30).fill('\u0008').join('');
+                const backspaces = Array(100).fill(BackspaceChar).join('');
                 await this.wdaBackend.typeText(backspaces);
             } catch (error3) {
                 debugDevice(`All clear methods failed: ${error3}`);
@@ -12304,6 +12326,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async doubleTap(x, y) {
         await this.wdaBackend.doubleTap(x, y);
     }
+    async tripleTap(x, y) {
+        await this.wdaBackend.tripleTap(x, y);
+    }
     async longPress(x, y, duration = 1000) {
         await this.wdaBackend.longPress(x, y, duration);
     }

package/dist/es/index.mjs

@@ -1,6 +1,6 @@
 import node_assert from "node:assert";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { defineAction, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionScroll, defineActionTap } from "@midscene/core/device";
+import { defineAction, defineActionClearInput, defineActionDoubleClick, defineActionDragAndDrop, defineActionKeyboardPress, defineActionScroll, defineActionTap } from "@midscene/core/device";
 import { sleep } from "@midscene/core/utils";
 import { DEFAULT_WDA_PORT } from "@midscene/shared/constants";
 import { createImgBase64ByFormat } from "@midscene/shared/img";
@@ -227,6 +227,16 @@ class IOSWebDriverClient extends WebDriverClient {
         });
         debugIOS(`Double tapped at coordinates (${x}, ${y})`);
     }
+    async tripleTap(x, y) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/tapWithNumberOfTaps`, {
+            x,
+            y,
+            numberOfTaps: 3,
+            numberOfTouches: 1
+        });
+        debugIOS(`Triple tapped at coordinates (${x}, ${y})`);
+    }
     async getScreenScale() {
         var _screenResponse_value;
         const screenResponse = await this.makeRequest('GET', '/wda/screen');
@@ -273,6 +283,7 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = getDebug('ios:device');
+const BackspaceChar = '\u0008';
 class IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -291,17 +302,23 @@ class IOSDevice {
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
                 paramSchema: z.object({
-                    value: z.string().describe('The final that should be filled in the input box. No matter what modifications are required, just provide the final value to replace the existing input value. Giving a blank string means clear the input field.'),
+                    value: z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
                     autoDismissKeyboard: z.boolean().optional().describe('If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.'),
+                    mode: z["enum"]([
+                        'replace',
+                        'clear',
+                        'append'
+                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "append" - append the value to existing content; "clear" - clear the field without inputting new text.'),
                     locate: getMidsceneLocationSchema().describe('The input field to be filled').optional()
                 }),
                 call: async (param)=>{
                     var _this_options;
                     const element = param.locate;
                     if (element) {
-                        await this.clearInput(element);
-                        if (!param || !param.value) return;
+                        if ('append' !== param.mode) await this.clearInput(element);
                     }
+                    if ('clear' === param.mode) return;
+                    if (!param || !param.value) return;
                     const autoDismissKeyboard = param.autoDismissKeyboard ?? (null == (_this_options = this.options) ? void 0 : _this_options.autoDismissKeyboard);
                     await this.typeText(param.value, {
                         autoDismissKeyboard
@@ -369,6 +386,11 @@ class IOSDevice {
                     const [x, y] = element.center;
                     await this.longPress(x, y, null == param ? void 0 : param.duration);
                 }
+            }),
+            defineActionClearInput(async (param)=>{
+                const element = param.locate;
+                node_assert(element, 'Element not found, cannot clear input');
+                await this.clearInput(element);
             })
         ];
         const customActions = this.customActions || [];
@@ -472,13 +494,13 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         await this.tap(element.center[0], element.center[1]);
         await sleep(100);
         try {
-            await this.longPress(element.center[0], element.center[1], 800);
+            await this.tripleTap(element.center[0], element.center[1]);
             await sleep(200);
-            await this.wdaBackend.typeText('');
+            await this.wdaBackend.typeText(BackspaceChar);
         } catch (error2) {
             debugDevice(`Method 1 failed, trying method 2: ${error2}`);
             try {
-                const backspaces = Array(30).fill('\u0008').join('');
+                const backspaces = Array(100).fill(BackspaceChar).join('');
                 await this.wdaBackend.typeText(backspaces);
             } catch (error3) {
                 debugDevice(`All clear methods failed: ${error3}`);
@@ -498,6 +520,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async doubleTap(x, y) {
         await this.wdaBackend.doubleTap(x, y);
     }
+    async tripleTap(x, y) {
+        await this.wdaBackend.tripleTap(x, y);
+    }
     async longPress(x, y, duration = 1000) {
         await this.wdaBackend.longPress(x, y, duration);
     }

package/dist/lib/bin.js

@@ -12171,6 +12171,16 @@ var __webpack_exports__ = {};
             });
             debugIOS(`Double tapped at coordinates (${x}, ${y})`);
         }
+        async tripleTap(x, y) {
+            this.ensureSession();
+            await this.makeRequest('POST', `/session/${this.sessionId}/wda/tapWithNumberOfTaps`, {
+                x,
+                y,
+                numberOfTaps: 3,
+                numberOfTouches: 1
+            });
+            debugIOS(`Triple tapped at coordinates (${x}, ${y})`);
+        }
         async getScreenScale() {
             var _screenResponse_value;
             const screenResponse = await this.makeRequest('GET', '/wda/screen');
@@ -12217,6 +12227,7 @@ var __webpack_exports__ = {};
         return obj;
     }
     const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+    const BackspaceChar = '\u0008';
     class device_IOSDevice {
         actionSpace() {
             const defaultActions = [
@@ -12235,17 +12246,23 @@ var __webpack_exports__ = {};
                     description: 'Input text into the input field',
                     interfaceAlias: 'aiInput',
                     paramSchema: core_namespaceObject.z.object({
-                        value: core_namespaceObject.z.string().describe('The final that should be filled in the input box. No matter what modifications are required, just provide the final value to replace the existing input value. Giving a blank string means clear the input field.'),
+                        value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
                         autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.'),
+                        mode: core_namespaceObject.z["enum"]([
+                            'replace',
+                            'clear',
+                            'append'
+                        ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "append" - append the value to existing content; "clear" - clear the field without inputting new text.'),
                         locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
                     }),
                     call: async (param)=>{
                         var _this_options;
                         const element = param.locate;
                         if (element) {
-                            await this.clearInput(element);
-                            if (!param || !param.value) return;
+                            if ('append' !== param.mode) await this.clearInput(element);
                         }
+                        if ('clear' === param.mode) return;
+                        if (!param || !param.value) return;
                         const autoDismissKeyboard = param.autoDismissKeyboard ?? (null == (_this_options = this.options) ? void 0 : _this_options.autoDismissKeyboard);
                         await this.typeText(param.value, {
                             autoDismissKeyboard
@@ -12313,6 +12330,11 @@ var __webpack_exports__ = {};
                         const [x, y] = element.center;
                         await this.longPress(x, y, null == param ? void 0 : param.duration);
                     }
+                }),
+                (0, device_namespaceObject.defineActionClearInput)(async (param)=>{
+                    const element = param.locate;
+                    external_node_assert_default()(element, 'Element not found, cannot clear input');
+                    await this.clearInput(element);
                 })
             ];
             const customActions = this.customActions || [];
@@ -12416,13 +12438,13 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
             await this.tap(element.center[0], element.center[1]);
             await (0, utils_namespaceObject.sleep)(100);
             try {
-                await this.longPress(element.center[0], element.center[1], 800);
+                await this.tripleTap(element.center[0], element.center[1]);
                 await (0, utils_namespaceObject.sleep)(200);
-                await this.wdaBackend.typeText('');
+                await this.wdaBackend.typeText(BackspaceChar);
             } catch (error2) {
                 debugDevice(`Method 1 failed, trying method 2: ${error2}`);
                 try {
-                    const backspaces = Array(30).fill('\u0008').join('');
+                    const backspaces = Array(100).fill(BackspaceChar).join('');
                     await this.wdaBackend.typeText(backspaces);
                 } catch (error3) {
                     debugDevice(`All clear methods failed: ${error3}`);
@@ -12442,6 +12464,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         async doubleTap(x, y) {
             await this.wdaBackend.doubleTap(x, y);
         }
+        async tripleTap(x, y) {
+            await this.wdaBackend.tripleTap(x, y);
+        }
         async longPress(x, y, duration = 1000) {
             await this.wdaBackend.longPress(x, y, duration);
         }

package/dist/lib/index.js

@@ -265,6 +265,16 @@ class IOSWebDriverClient extends webdriver_namespaceObject.WebDriverClient {
         });
         debugIOS(`Double tapped at coordinates (${x}, ${y})`);
     }
+    async tripleTap(x, y) {
+        this.ensureSession();
+        await this.makeRequest('POST', `/session/${this.sessionId}/wda/tapWithNumberOfTaps`, {
+            x,
+            y,
+            numberOfTaps: 3,
+            numberOfTouches: 1
+        });
+        debugIOS(`Triple tapped at coordinates (${x}, ${y})`);
+    }
     async getScreenScale() {
         var _screenResponse_value;
         const screenResponse = await this.makeRequest('GET', '/wda/screen');
@@ -311,6 +321,7 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('ios:device');
+const BackspaceChar = '\u0008';
 class IOSDevice {
     actionSpace() {
         const defaultActions = [
@@ -329,17 +340,23 @@ class IOSDevice {
                 description: 'Input text into the input field',
                 interfaceAlias: 'aiInput',
                 paramSchema: core_namespaceObject.z.object({
-                    value: core_namespaceObject.z.string().describe('The final that should be filled in the input box. No matter what modifications are required, just provide the final value to replace the existing input value. Giving a blank string means clear the input field.'),
+                    value: core_namespaceObject.z.string().describe('The text to input. Provide the final content for replace/append modes, or an empty string when using clear mode to remove existing text.'),
                     autoDismissKeyboard: core_namespaceObject.z.boolean().optional().describe('If true, the keyboard will be dismissed after the input is completed. Do not set it unless the user asks you to do so.'),
+                    mode: core_namespaceObject.z["enum"]([
+                        'replace',
+                        'clear',
+                        'append'
+                    ]).default('replace').optional().describe('Input mode: "replace" (default) - clear the field and input the value; "append" - append the value to existing content; "clear" - clear the field without inputting new text.'),
                     locate: (0, core_namespaceObject.getMidsceneLocationSchema)().describe('The input field to be filled').optional()
                 }),
                 call: async (param)=>{
                     var _this_options;
                     const element = param.locate;
                     if (element) {
-                        await this.clearInput(element);
-                        if (!param || !param.value) return;
+                        if ('append' !== param.mode) await this.clearInput(element);
                     }
+                    if ('clear' === param.mode) return;
+                    if (!param || !param.value) return;
                     const autoDismissKeyboard = param.autoDismissKeyboard ?? (null == (_this_options = this.options) ? void 0 : _this_options.autoDismissKeyboard);
                     await this.typeText(param.value, {
                         autoDismissKeyboard
@@ -407,6 +424,11 @@ class IOSDevice {
                     const [x, y] = element.center;
                     await this.longPress(x, y, null == param ? void 0 : param.duration);
                 }
+            }),
+            (0, device_namespaceObject.defineActionClearInput)(async (param)=>{
+                const element = param.locate;
+                external_node_assert_default()(element, 'Element not found, cannot clear input');
+                await this.clearInput(element);
             })
         ];
         const customActions = this.customActions || [];
@@ -510,13 +532,13 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
         await this.tap(element.center[0], element.center[1]);
         await (0, utils_namespaceObject.sleep)(100);
         try {
-            await this.longPress(element.center[0], element.center[1], 800);
+            await this.tripleTap(element.center[0], element.center[1]);
             await (0, utils_namespaceObject.sleep)(200);
-            await this.wdaBackend.typeText('');
+            await this.wdaBackend.typeText(BackspaceChar);
         } catch (error2) {
             debugDevice(`Method 1 failed, trying method 2: ${error2}`);
             try {
-                const backspaces = Array(30).fill('\u0008').join('');
+                const backspaces = Array(100).fill(BackspaceChar).join('');
                 await this.wdaBackend.typeText(backspaces);
             } catch (error3) {
                 debugDevice(`All clear methods failed: ${error3}`);
@@ -536,6 +558,9 @@ ScreenSize: ${size.width}x${size.height} (DPR: ${size.scale})
     async doubleTap(x, y) {
         await this.wdaBackend.doubleTap(x, y);
     }
+    async tripleTap(x, y) {
+        await this.wdaBackend.tripleTap(x, y);
+    }
     async longPress(x, y, duration = 1000) {
         await this.wdaBackend.longPress(x, y, duration);
     }

package/dist/types/index.d.ts

@@ -59,6 +59,7 @@ export declare class IOSDevice implements AbstractInterface {
     tap(x: number, y: number): Promise<void>;
     mouseClick(x: number, y: number): Promise<void>;
     doubleTap(x: number, y: number): Promise<void>;
+    tripleTap(x: number, y: number): Promise<void>;
     longPress(x: number, y: number, duration?: number): Promise<void>;
     swipe(fromX: number, fromY: number, toX: number, toY: number, duration?: number): Promise<void>;
     typeText(text: string, options?: IOSDeviceInputOpt): Promise<void>;
@@ -120,6 +121,7 @@ export declare class IOSWebDriverClient extends WebDriverClient {
     swipe(fromX: number, fromY: number, toX: number, toY: number, duration?: number): Promise<void>;
     longPress(x: number, y: number, duration?: number): Promise<void>;
     doubleTap(x: number, y: number): Promise<void>;
+    tripleTap(x: number, y: number): Promise<void>;
     getScreenScale(): Promise<number | null>;
     createSession(capabilities?: any): Promise<any>;
     private setupIOSSession;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/ios",
-  "version": "0.30.3-beta-20251011080128.0",
+  "version": "0.30.3-beta-20251014030035.0",
   "description": "iOS automation library for Midscene",
   "keywords": [
     "iOS UI automation",
@@ -38,9 +38,9 @@
   "dependencies": {
     "@inquirer/prompts": "^7.8.6",
     "open": "10.1.0",
-    "@midscene/core": "0.30.3-beta-20251011080128.0",
-    "@midscene/shared": "0.30.3-beta-20251011080128.0",
-    "@midscene/webdriver": "0.30.3-beta-20251011080128.0"
+    "@midscene/core": "0.30.3-beta-20251014030035.0",
+    "@midscene/shared": "0.30.3-beta-20251014030035.0",
+    "@midscene/webdriver": "0.30.3-beta-20251014030035.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.11.2",
@@ -49,7 +49,7 @@
     "typescript": "^5.8.3",
     "tsx": "^4.19.2",
     "vitest": "3.0.5",
-    "@midscene/playground": "0.30.3-beta-20251011080128.0"
+    "@midscene/playground": "0.30.3-beta-20251014030035.0"
   },
   "license": "MIT",
   "scripts": {

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.f566a9ed.js"></script><script defer src="/static/js/657.5a5fe47b.js"></script><script defer src="/static/js/index.8d6e2c5c.js"></script><link href="/static/css/index.44466eb4.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><link rel="icon" href="/favicon.ico"><title>Midscene Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.f566a9ed.js"></script><script defer src="/static/js/657.5a5fe47b.js"></script><script defer src="/static/js/index.ab51350a.js"></script><link href="/static/css/index.44466eb4.css" rel="stylesheet"></head><body><div id="root"></div></body></html>