@midscene/android 1.15.5-beta-20261015030228.0 → 1.15.6

package/dist/es/cli.mjs

@@ -11,7 +11,7 @@ import { Agent } from "@midscene/core/agent";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
 import node_assert from "node:assert";
 import { execFile } from "node:child_process";
-import { createDefaultMobileActions, defineAction, resolveTextInputOptions, sendTextSequentially, shouldInputSequentially } from "@midscene/core/device";
+import { createDefaultMobileActions, defineAction, resolveDefaultMobileScroll, resolveTextInputOptions, sendTextSequentially, shouldInputSequentially } from "@midscene/core/device";
 import { getTmpFile, sleep } from "@midscene/core/utils";
 import { MIDSCENE_ADB_PATH, MIDSCENE_ADB_REMOTE_HOST, MIDSCENE_ADB_REMOTE_PORT, MIDSCENE_ANDROID_IME_STRATEGY, MIDSCENE_ANDROID_SCREENSHOT_STRATEGY, globalConfigManager } from "@midscene/shared/env";
 import { ADB, getSdkRootFromEnv } from "appium-adb";
@@ -2640,10 +2640,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await repeat(defaultScrollUntilTimes, ()=>this.scrollRaw(9999999, 0, defaultFastScrollDuration));
         await sleep(1000);
     }
+    async scrollDefault(direction) {
+        const { from, to } = resolveDefaultMobileScroll(direction, await this.size());
+        const duration = defaultNormalScrollDuration;
+        await this.swipePoint(from, to, duration);
+    }
     async scrollUp(distance, startPoint) {
         await this.visualActions.scrollUp(distance, startPoint);
     }
     async scrollUpRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('up');
         const { height } = await this.size();
         const scrollDistance = Math.round(distance || height);
         const hasExplicitDistance = void 0 !== distance;
@@ -2663,6 +2669,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollDown(distance, startPoint);
     }
     async scrollDownRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('down');
         const { height } = await this.size();
         const scrollDistance = Math.round(distance || height);
         const hasExplicitDistance = void 0 !== distance;
@@ -2682,6 +2689,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollLeft(distance, startPoint);
     }
     async scrollLeftRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('left');
         const { width } = await this.size();
         const scrollDistance = Math.round(distance || width);
         const hasExplicitDistance = void 0 !== distance;
@@ -2701,6 +2709,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollRight(distance, startPoint);
     }
     async scrollRightRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('right');
         const { width } = await this.size();
         const scrollDistance = Math.round(distance || width);
         const hasExplicitDistance = void 0 !== distance;
@@ -2832,8 +2841,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         if (0 === deltaX && 0 === deltaY) throw new Error('Scroll distance cannot be zero in both directions');
         const { width, height } = await this.size();
         const n = 4;
-        const startX = Math.round(deltaX < 0 ? width / n * (n - 1) : width / n);
-        const startY = Math.round(deltaY < 0 ? height / n * (n - 1) : height / n);
+        const axisStart = (delta, size)=>0 === delta ? Math.round(size / 2) : Math.round(delta < 0 ? size / n : size / n * (n - 1));
+        const startX = axisStart(deltaX, width);
+        const startY = axisStart(deltaY, height);
         const maxPositiveDeltaX = startX;
         const maxNegativeDeltaX = width - startX;
         const maxPositiveDeltaY = startY;
@@ -3540,7 +3550,7 @@ class AndroidMidsceneTools extends BaseMidsceneTools {
 const tools = new AndroidMidsceneTools();
 runToolsCLI(tools, 'midscene-android', {
     stripPrefix: 'android_',
-    version: "1.15.5-beta-20261015030228.0",
+    version: "1.15.6",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -6,7 +6,7 @@ import * as __rspack_external_node_path_c5b9b54f from "node:path";
 import node_assert from "node:assert";
 import { execFile } from "node:child_process";
 import { getMidsceneLocationSchema, z } from "@midscene/core";
-import { createDefaultMobileActions, defineAction, resolveTextInputOptions, sendTextSequentially, shouldInputSequentially } from "@midscene/core/device";
+import { createDefaultMobileActions, defineAction, resolveDefaultMobileScroll, resolveTextInputOptions, sendTextSequentially, shouldInputSequentially } from "@midscene/core/device";
 import { getTmpFile, sleep } from "@midscene/core/utils";
 import { MIDSCENE_ADB_PATH, MIDSCENE_ADB_REMOTE_HOST, MIDSCENE_ADB_REMOTE_PORT, MIDSCENE_ANDROID_IME_STRATEGY, MIDSCENE_ANDROID_SCREENSHOT_STRATEGY, globalConfigManager, overrideAIConfig } from "@midscene/shared/env";
 import { mergeAndNormalizeAppNameMapping, normalizeForComparison, repeat } from "@midscene/shared/utils";
@@ -2543,10 +2543,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await repeat(defaultScrollUntilTimes, ()=>this.scrollRaw(9999999, 0, defaultFastScrollDuration));
         await sleep(1000);
     }
+    async scrollDefault(direction) {
+        const { from, to } = resolveDefaultMobileScroll(direction, await this.size());
+        const duration = defaultNormalScrollDuration;
+        await this.swipePoint(from, to, duration);
+    }
     async scrollUp(distance, startPoint) {
         await this.visualActions.scrollUp(distance, startPoint);
     }
     async scrollUpRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('up');
         const { height } = await this.size();
         const scrollDistance = Math.round(distance || height);
         const hasExplicitDistance = void 0 !== distance;
@@ -2566,6 +2572,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollDown(distance, startPoint);
     }
     async scrollDownRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('down');
         const { height } = await this.size();
         const scrollDistance = Math.round(distance || height);
         const hasExplicitDistance = void 0 !== distance;
@@ -2585,6 +2592,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollLeft(distance, startPoint);
     }
     async scrollLeftRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('left');
         const { width } = await this.size();
         const scrollDistance = Math.round(distance || width);
         const hasExplicitDistance = void 0 !== distance;
@@ -2604,6 +2612,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         await this.visualActions.scrollRight(distance, startPoint);
     }
     async scrollRightRaw(distance, startPoint) {
+        if (void 0 === distance && !startPoint) return this.scrollDefault('right');
         const { width } = await this.size();
         const scrollDistance = Math.round(distance || width);
         const hasExplicitDistance = void 0 !== distance;
@@ -2735,8 +2744,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
         if (0 === deltaX && 0 === deltaY) throw new Error('Scroll distance cannot be zero in both directions');
         const { width, height } = await this.size();
         const n = 4;
-        const startX = Math.round(deltaX < 0 ? width / n * (n - 1) : width / n);
-        const startY = Math.round(deltaY < 0 ? height / n * (n - 1) : height / n);
+        const axisStart = (delta, size)=>0 === delta ? Math.round(size / 2) : Math.round(delta < 0 ? size / n : size / n * (n - 1));
+        const startX = axisStart(deltaX, width);
+        const startY = axisStart(deltaY, height);
         const maxPositiveDeltaX = startX;
         const maxNegativeDeltaX = width - startX;
         const maxPositiveDeltaY = startY;

package/dist/lib/cli.js

@@ -2761,10 +2761,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await (0, utils_namespaceObject.repeat)(defaultScrollUntilTimes, ()=>this.scrollRaw(9999999, 0, defaultFastScrollDuration));
             await (0, core_utils_namespaceObject.sleep)(1000);
         }
+        async scrollDefault(direction) {
+            const { from, to } = (0, device_namespaceObject.resolveDefaultMobileScroll)(direction, await this.size());
+            const duration = defaultNormalScrollDuration;
+            await this.swipePoint(from, to, duration);
+        }
         async scrollUp(distance, startPoint) {
             await this.visualActions.scrollUp(distance, startPoint);
         }
         async scrollUpRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('up');
             const { height } = await this.size();
             const scrollDistance = Math.round(distance || height);
             const hasExplicitDistance = void 0 !== distance;
@@ -2784,6 +2790,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollDown(distance, startPoint);
         }
         async scrollDownRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('down');
             const { height } = await this.size();
             const scrollDistance = Math.round(distance || height);
             const hasExplicitDistance = void 0 !== distance;
@@ -2803,6 +2810,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollLeft(distance, startPoint);
         }
         async scrollLeftRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('left');
             const { width } = await this.size();
             const scrollDistance = Math.round(distance || width);
             const hasExplicitDistance = void 0 !== distance;
@@ -2822,6 +2830,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollRight(distance, startPoint);
         }
         async scrollRightRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('right');
             const { width } = await this.size();
             const scrollDistance = Math.round(distance || width);
             const hasExplicitDistance = void 0 !== distance;
@@ -2953,8 +2962,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             if (0 === deltaX && 0 === deltaY) throw new Error('Scroll distance cannot be zero in both directions');
             const { width, height } = await this.size();
             const n = 4;
-            const startX = Math.round(deltaX < 0 ? width / n * (n - 1) : width / n);
-            const startY = Math.round(deltaY < 0 ? height / n * (n - 1) : height / n);
+            const axisStart = (delta, size)=>0 === delta ? Math.round(size / 2) : Math.round(delta < 0 ? size / n : size / n * (n - 1));
+            const startX = axisStart(deltaX, width);
+            const startY = axisStart(deltaY, height);
             const maxPositiveDeltaX = startX;
             const maxNegativeDeltaX = width - startX;
             const maxPositiveDeltaY = startY;
@@ -3560,7 +3570,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
     const tools = new AndroidMidsceneTools();
     (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-android', {
         stripPrefix: 'android_',
-        version: "1.15.5-beta-20261015030228.0",
+        version: "1.15.6",
         extraCommands: (0, core_namespaceObject.createReportCliCommands)()
     }).catch((e)=>{
         process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -2692,10 +2692,16 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await (0, shared_utils_namespaceObject.repeat)(defaultScrollUntilTimes, ()=>this.scrollRaw(9999999, 0, defaultFastScrollDuration));
             await (0, utils_namespaceObject.sleep)(1000);
         }
+        async scrollDefault(direction) {
+            const { from, to } = (0, device_namespaceObject.resolveDefaultMobileScroll)(direction, await this.size());
+            const duration = defaultNormalScrollDuration;
+            await this.swipePoint(from, to, duration);
+        }
         async scrollUp(distance, startPoint) {
             await this.visualActions.scrollUp(distance, startPoint);
         }
         async scrollUpRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('up');
             const { height } = await this.size();
             const scrollDistance = Math.round(distance || height);
             const hasExplicitDistance = void 0 !== distance;
@@ -2715,6 +2721,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollDown(distance, startPoint);
         }
         async scrollDownRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('down');
             const { height } = await this.size();
             const scrollDistance = Math.round(distance || height);
             const hasExplicitDistance = void 0 !== distance;
@@ -2734,6 +2741,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollLeft(distance, startPoint);
         }
         async scrollLeftRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('left');
             const { width } = await this.size();
             const scrollDistance = Math.round(distance || width);
             const hasExplicitDistance = void 0 !== distance;
@@ -2753,6 +2761,7 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             await this.visualActions.scrollRight(distance, startPoint);
         }
         async scrollRightRaw(distance, startPoint) {
+            if (void 0 === distance && !startPoint) return this.scrollDefault('right');
             const { width } = await this.size();
             const scrollDistance = Math.round(distance || width);
             const hasExplicitDistance = void 0 !== distance;
@@ -2884,8 +2893,9 @@ ${Object.keys(size).filter((key)=>size[key]).map((key)=>`  ${key} size: ${size[k
             if (0 === deltaX && 0 === deltaY) throw new Error('Scroll distance cannot be zero in both directions');
             const { width, height } = await this.size();
             const n = 4;
-            const startX = Math.round(deltaX < 0 ? width / n * (n - 1) : width / n);
-            const startY = Math.round(deltaY < 0 ? height / n * (n - 1) : height / n);
+            const axisStart = (delta, size)=>0 === delta ? Math.round(size / 2) : Math.round(delta < 0 ? size / n : size / n * (n - 1));
+            const startX = axisStart(deltaX, width);
+            const startY = axisStart(deltaY, height);
             const maxPositiveDeltaX = startX;
             const maxNegativeDeltaX = width - startX;
             const maxPositiveDeltaY = startY;

package/dist/types/index.d.ts

@@ -244,6 +244,7 @@ export declare class AndroidDevice implements AbstractInterface {
     private scrollUntilLeftRaw;
     scrollUntilRight(startPoint?: Point): Promise<void>;
     private scrollUntilRightRaw;
+    private scrollDefault;
     scrollUp(distance?: number, startPoint?: Point): Promise<void>;
     private scrollUpRaw;
     scrollDown(distance?: number, startPoint?: Point): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android",
-  "version": "1.15.5-beta-20261015030228.0",
+  "version": "1.15.6",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -47,8 +47,8 @@
     "appium-adb": "12.12.1",
     "sharp": "^0.34.3",
     "zod": "^3.25.1",
-    "@midscene/core": "1.15.5-beta-20261015030228.0",
-    "@midscene/shared": "1.15.5-beta-20261015030228.0"
+    "@midscene/core": "1.15.6",
+    "@midscene/shared": "1.15.6"
   },
   "optionalDependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0"
@@ -61,7 +61,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.8.3",
     "undici": "^6.0.0",
-    "@midscene/playground": "1.15.5-beta-20261015030228.0"
+    "@midscene/playground": "1.15.6"
   },
   "license": "MIT",
   "scripts": {