doc-detective 4.22.0 → 4.24.0

package/dist/core/tests/mobileBrowser.js

@@ -0,0 +1,141 @@
+// Native app surfaces phase A5: mobile web browsers on managed devices.
+// With a mobile platform entry, `browsers` means the browser ON the device,
+// driven through the same per-device Appium session the app surfaces use:
+// Chrome on the Android emulator (UiAutomator2 + server-managed chromedriver)
+// and Safari on the iOS simulator (XCUITest). Everything here is pure —
+// support-matrix decisions, config rejection, and capability shapes — so the
+// preflights stay unit-testable without a device.
+import path from "node:path";
+// The device browser each mobile target supports. There is exactly one per
+// platform — the on-device browser is part of the device image, not an
+// installable engine choice, so unsupported names SKIP (they can never
+// become available on that target) rather than falling back.
+const SUPPORTED_MOBILE_BROWSER = {
+    android: "chrome",
+    ios: "safari",
+};
+// Subdirectory of the Doc Detective cache where the Appium server stores the
+// chromedrivers it auto-downloads to match the device's Chrome version.
+const MOBILE_CHROMEDRIVER_DIR = "chromedriver-mobile";
+export { mobileBrowserSupport, mobileBrowserConfigError, buildMobileBrowserCapabilities, defaultMobileBrowserName, mobileBrowserGate, MOBILE_CHROMEDRIVER_DIR, };
+// The browser a mobile context gets when the runOn entry names none — the
+// mobile analog of the desktop first-available default.
+function defaultMobileBrowserName(platform) {
+    return SUPPORTED_MOBILE_BROWSER[platform];
+}
+// The A5 support matrix: chrome+android and safari+ios are the only pairs.
+// The reason names both the rejected and the supported browser so the fix is
+// one edit away.
+function mobileBrowserSupport({ platform, browserName, }) {
+    const supported = SUPPORTED_MOBILE_BROWSER[platform];
+    if (browserName === supported)
+        return { supported: true };
+    return {
+        supported: false,
+        reason: `Skipping context: '${browserName}' isn't available on ${platform}. '${supported}' is the supported ${platform} browser — set browsers: "${supported}" (or omit browsers) on the ${platform} runOn entry.`,
+    };
+}
+// Device-fixed browser config is rejected loudly rather than silently
+// ignored: `headless` belongs to the device descriptor, and window/viewport
+// dimensions are fixed by the device's screen. `headless: true` is the
+// schema-injected default (AJV useDefaults), so only an authored `false` is
+// distinguishable and rejectable.
+function mobileBrowserConfigError(browser) {
+    if (!browser)
+        return null;
+    if (browser.headless === false) {
+        return "browser headless is meaningless for a device browser — the device owns its display. Set headless on the device descriptor (device.headless) instead.";
+    }
+    const authoredDimensions = (value) => value && typeof value === "object" && Object.keys(value).length > 0;
+    if (authoredDimensions(browser.window)) {
+        return "browser window dimensions are fixed by the device's screen and can't be set on a mobile context. Choose a different device (device.deviceType) if you need another size.";
+    }
+    if (authoredDimensions(browser.viewport)) {
+        return "browser viewport dimensions are fixed by the device's screen and can't be set on a mobile context. Choose a different device (device.deviceType) if you need another size.";
+    }
+    return null;
+}
+// The one decision point the mobile preflights consult before any toolchain
+// work: does this context get a device-browser session, a SKIP, or a FAIL?
+// Order matters — the mixed guard first (a scope limit, so SKIP, and config
+// on a context that can't run at all shouldn't fail the run), then the loud
+// config rejection, then the support matrix with the platform default filled.
+function mobileBrowserGate({ platform, browser, hasBrowserStep, hasAppStep, }) {
+    if (!hasBrowserStep)
+        return { action: "proceed", browserName: null };
+    if (hasAppStep) {
+        // Interleaving native app surfaces and the device browser in one context
+        // needs foreground + NATIVE_APP/WEBVIEW context switching — its own
+        // subsystem, deferred past A6 (which shipped the interaction vocabulary;
+        // see the design doc's A6 entry). Both halves run today — in separate
+        // tests/contexts.
+        return {
+            action: "skip",
+            level: "warning",
+            reason: `Skipping context on '${platform}': mixing native app surfaces and browser steps in one mobile context isn't supported yet — put the web steps and the app steps in separate tests or contexts. Mobile-web-only and native-app-only contexts both run today.`,
+        };
+    }
+    const configError = mobileBrowserConfigError(browser);
+    if (configError) {
+        return {
+            action: "fail",
+            reason: `Mobile context on '${platform}': ${configError}`,
+        };
+    }
+    const browserName = browser?.name ?? defaultMobileBrowserName(platform);
+    const support = mobileBrowserSupport({ platform, browserName });
+    if (!support.supported) {
+        return { action: "skip", level: "warning", reason: support.reason };
+    }
+    return { action: "proceed", browserName };
+}
+// Session capabilities for the device browser. Mirrors the per-platform app
+// capability shapes in appSurface.ts (APP_DRIVER_PLATFORMS) — same drivers,
+// same udid pinning, same WDA timeout floor and derived-data opt-in — but
+// with `browserName` in place of an app identifier, which puts the session
+// in a web context from the start.
+function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout, }) {
+    if (platform === "android") {
+        return {
+            platformName: "Android",
+            "appium:automationName": "UiAutomator2",
+            browserName: "Chrome",
+            "appium:udid": udid,
+            "appium:newCommandTimeout": 600,
+            // adb operations can be slow on a cold emulator (same floor as app
+            // sessions).
+            "appium:adbExecTimeout": 120000,
+            "wdio:enforceWebDriverClassic": true,
+            // On-device chromedriver management: the server downloads a
+            // chromedriver matching the device's Chrome version. Requires the
+            // Appium server to run with
+            // --allow-insecure=uiautomator2:chromedriver_autodownload. The
+            // download lands in the Doc Detective cache so later runs reuse it.
+            "appium:chromedriverAutodownload": true,
+            "appium:chromedriverExecutableDir": path.join(cacheDir, MOBILE_CHROMEDRIVER_DIR),
+        };
+    }
+    const capabilities = {
+        platformName: "iOS",
+        "appium:automationName": "XCUITest",
+        browserName: "Safari",
+        "appium:udid": udid,
+        "appium:newCommandTimeout": 600,
+        "wdio:enforceWebDriverClassic": true,
+    };
+    // The first-ever XCUITest session cold-builds WebDriverAgent via
+    // xcodebuild (~10 min on CI). App surfaces carry an authored startSurface
+    // timeout for this; a mobile-web session has no step to author one on, so
+    // the default ceiling matches the generous one the apps-ios fixtures use.
+    const effectiveTimeout = timeout ?? 900000;
+    capabilities["appium:wdaLaunchTimeout"] = Math.max(effectiveTimeout, 120000);
+    capabilities["appium:wdaConnectionTimeout"] = Math.max(effectiveTimeout, 120000);
+    // Same opt-in derived-data sharing as iOS app sessions (see appSurface.ts
+    // for the caching contract).
+    const derivedDataPath = process.env.DOC_DETECTIVE_IOS_WDA_DERIVED_DATA_PATH;
+    if (derivedDataPath && derivedDataPath.trim()) {
+        capabilities["appium:derivedDataPath"] = derivedDataPath.trim();
+    }
+    return capabilities;
+}
+//# sourceMappingURL=mobileBrowser.js.map

package/dist/core/tests/mobileBrowser.js.map

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

package/dist/core/tests/mobilePlatform.d.ts

@@ -1,10 +1,4 @@
-export { isMobileTargetPlatform, mobileContextSkipReason };
+export { isMobileTargetPlatform };
 type MobileTarget = "android" | "ios";
 declare function isMobileTargetPlatform(platform: unknown): MobileTarget | null;
-declare function mobileContextSkipReason({ platform, }: {
-    platform: MobileTarget;
-}): {
-    level: "warning" | "info";
-    reason: string;
-};
 //# sourceMappingURL=mobilePlatform.d.ts.map

package/dist/core/tests/mobilePlatform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mobilePlatform.d.ts","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAE3D,KAAK,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAGtC,iBAAS,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAGtE;AASD,iBAAS,uBAAuB,CAAC,EAC/B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;CACxB,GAAG;IAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAahD"}
+{"version":3,"file":"mobilePlatform.d.ts","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,KAAK,YAAY,GAAG,SAAS,GAAG,KAAK,CAAC;AAGtC,iBAAS,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAGtE"}

package/dist/core/tests/mobilePlatform.js

@@ -1,37 +1,15 @@
 // Native app surfaces phase A3: the `android`/`ios` target platforms. Unlike
 // desktop platforms (where host == target), a mobile platform names the
 // TARGET a context runs against and is gated by host *capability*, not host
-// identity. As of A4, native app contexts can pass on both mobile targets
-// when the host is capable. The remaining mobile-target skip reason this
-// module composes is mobile browser testing (A5), which is still gated on both
-// android and ios. The reason composer is pure so it's unit-testable without
-// probing an SDK.
-export { isMobileTargetPlatform, mobileContextSkipReason };
+// identity. Native app contexts (A3/A4) and mobile-web browser contexts (A5)
+// both run on capable hosts; the browser-side decisions (support matrix,
+// device-fixed config rejection, mixed-context deferral) live in
+// mobileBrowser.ts.
+export { isMobileTargetPlatform };
 // Classify a context platform as a mobile target, or null for desktop / junk.
 function isMobileTargetPlatform(platform) {
     if (platform === "android" || platform === "ios")
         return platform;
     return null;
 }
-// Compose the SKIP reason (and log level) for the one mobile-context case still
-// gated by a later phase: a mobile-web (browser) step on either target — mobile
-// browsers land in A5. Native app contexts (no browser step) are NOT routed
-// here; they pass through their platform's context preflight (androidContext-
-// Preflight / iosContextPreflight), which capability-gates and runs them. This
-// composer is only ever called for a mobile-browser context, so it branches on
-// the target platform alone.
-function mobileContextSkipReason({ platform, }) {
-    const roadmap = "docs/design/native-app-surfaces.md";
-    if (platform === "ios") {
-        return {
-            level: "warning",
-            reason: `Skipping context on 'ios': mobile browser testing on iOS lands in phase A5 of the native app roadmap (${roadmap}). Native iOS app tests run on capable macOS hosts.`,
-        };
-    }
-    // android + a browser step: mobile-web testing on Android is phase A5.
-    return {
-        level: "warning",
-        reason: `Skipping context on 'android': mobile browser testing on Android lands in phase A5 of the native app roadmap (${roadmap}). Native Android app tests (no browser steps) run today.`,
-    };
-}
 //# sourceMappingURL=mobilePlatform.js.map

package/dist/core/tests/mobilePlatform.js.map

@@ -1 +1 @@
-{"version":3,"file":"mobilePlatform.js","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,+EAA+E;AAC/E,6EAA6E;AAC7E,kBAAkB;AAElB,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC;AAI3D,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,6BAA6B;AAC7B,SAAS,uBAAuB,CAAC,EAC/B,QAAQ,GAGT;IACC,MAAM,OAAO,GAAG,oCAAoC,CAAC;IACrD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,yGAAyG,OAAO,qDAAqD;SAC9K,CAAC;IACJ,CAAC;IACD,uEAAuE;IACvE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,iHAAiH,OAAO,2DAA2D;KAC5L,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mobilePlatform.js","sourceRoot":"","sources":["../../../src/core/tests/mobilePlatform.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,iEAAiE;AACjE,oBAAoB;AAEpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAIlC,8EAA8E;AAC9E,SAAS,sBAAsB,CAAC,QAAiB;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/tests/movement.d.ts

@@ -0,0 +1,43 @@
+export { directionToPoints, fractionsToPixels, surfaceToAbsolutePixels, performMovement, performElementPress, getBrowserViewportRect, };
+export type { MovementPoint, MovementRect, SwipeDirection };
+type SwipeDirection = "up" | "down" | "left" | "right";
+type MovementPoint = {
+    x: number;
+    y: number;
+};
+type MovementRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare const MOVEMENT_INSET = 0.1;
+export declare const DEFAULT_SWIPE_DISTANCE = 0.5;
+export declare const DEFAULT_SWIPE_DURATION = 500;
+declare function directionToPoints(direction: SwipeDirection, distance?: number): {
+    from: MovementPoint;
+    to: MovementPoint;
+};
+declare function fractionsToPixels(rect: MovementRect, point: MovementPoint): {
+    x: number;
+    y: number;
+};
+declare function surfaceToAbsolutePixels(rect: MovementRect, point: MovementPoint): {
+    x: number;
+    y: number;
+};
+declare function performMovement({ driver, from, to, duration, pointerType, }: {
+    driver: any;
+    from: MovementPoint;
+    to: MovementPoint;
+    duration?: number;
+    pointerType?: "mouse" | "touch";
+}): Promise<void>;
+declare function performElementPress({ driver, element, button, duration, }: {
+    driver: any;
+    element: any;
+    button?: string;
+    duration: number;
+}): Promise<void>;
+declare function getBrowserViewportRect(driver: any): Promise<MovementRect>;
+//# sourceMappingURL=movement.d.ts.map

package/dist/core/tests/movement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../../src/core/tests/movement.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,CAAC;AACF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE5D,KAAK,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACvD,KAAK,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9C,KAAK,YAAY,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAK5E,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAM1C,iBAAS,iBAAiB,CACxB,SAAS,EAAE,cAAc,EACzB,QAAQ,GAAE,MAA+B,GACxC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,aAAa,CAAA;CAAE,CAe5C;AAED,iBAAS,iBAAiB,CACxB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,aAAa,GACnB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAKD,iBAAS,uBAAuB,CAC9B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,aAAa,GACnB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B;AAOD,iBAAe,eAAe,CAAC,EAC7B,MAAM,EACN,IAAI,EACJ,EAAE,EACF,QAAiC,EACjC,WAAqB,GACtB,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAShB;AAMD,iBAAe,mBAAmB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,MAAe,EACf,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED,iBAAe,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAMxE"}

package/dist/core/tests/movement.js

@@ -0,0 +1,92 @@
+// The shared coordinate-movement engine (phase A6). `swipe` is the movement
+// subset of `dragAndDrop`: dragAndDrop locates two elements and moves between
+// them; swipe moves between two points (authored directly, or computed from a
+// direction shorthand). Both concepts meet here — dragAndDrop's future
+// app-surface branch calls performMovement with element-center fractions.
+//
+// Directional shorthands travel as 0-1 fractions of a rect ({x, y, width,
+// height}); authored point-to-point coordinates are literal pixels relative
+// to the surface's top-left (the context/viewport pixel convention). Both
+// convert to absolute pixels before the engine moves anything, so the engine
+// stays driver-agnostic and unit-testable with a fake driver.
+// Functions are hoisted, so the grouped export lists only them; the constants
+// export inline at their declarations (a top-of-file `export {}` referencing
+// a later `const` trips use-before-declaration analysis).
+export { directionToPoints, fractionsToPixels, surfaceToAbsolutePixels, performMovement, performElementPress, getBrowserViewportRect, };
+// Directional swipes keep away from the outer 10% of the surface so a
+// full-length swipe can't trigger a system edge gesture (Android back/home).
+// Explicit point-to-point coordinates are the author's own and aren't inset.
+export const MOVEMENT_INSET = 0.1;
+export const DEFAULT_SWIPE_DISTANCE = 0.5;
+export const DEFAULT_SWIPE_DURATION = 500;
+// A direction is the virtual finger's motion: swiping up moves content up,
+// revealing content further down the page. The from/to pair is centered on
+// the surface and clamped to the inset box, so the maximum effective travel
+// is 1 - 2 * MOVEMENT_INSET.
+function directionToPoints(direction, distance = DEFAULT_SWIPE_DISTANCE) {
+    const clamp = (value) => Math.min(1 - MOVEMENT_INSET, Math.max(MOVEMENT_INSET, value));
+    const near = clamp(0.5 - distance / 2);
+    const far = clamp(0.5 + distance / 2);
+    switch (direction) {
+        case "up":
+            return { from: { x: 0.5, y: far }, to: { x: 0.5, y: near } };
+        case "down":
+            return { from: { x: 0.5, y: near }, to: { x: 0.5, y: far } };
+        case "left":
+            return { from: { x: far, y: 0.5 }, to: { x: near, y: 0.5 } };
+        case "right":
+            return { from: { x: near, y: 0.5 }, to: { x: far, y: 0.5 } };
+    }
+}
+function fractionsToPixels(rect, point) {
+    return {
+        x: Math.round(rect.x + point.x * rect.width),
+        y: Math.round(rect.y + point.y * rect.height),
+    };
+}
+// Offset an author-supplied pixel point (relative to the surface's top-left)
+// into the coordinate space the driver expects (absolute, per the window
+// rect's origin — zero for mobile screens and browser viewports).
+function surfaceToAbsolutePixels(rect, point) {
+    return {
+        x: Math.round(rect.x + point.x),
+        y: Math.round(rect.y + point.y),
+    };
+}
+// One pointer movement through the wdio W3C actions builder: move to the
+// start, press, a short settle pause (so touch drivers register the press as
+// a drag rather than a tap), a timed move to the end, release. `from`/`to`
+// are absolute pixels — callers convert fractions (fractionsToPixels) or
+// surface-relative author pixels (surfaceToAbsolutePixels) first.
+async function performMovement({ driver, from, to, duration = DEFAULT_SWIPE_DURATION, pointerType = "mouse", }) {
+    await driver
+        .action("pointer", { parameters: { pointerType } })
+        .move({ x: Math.round(from.x), y: Math.round(from.y) })
+        .down()
+        .pause(50)
+        .move({ duration, x: Math.round(to.x), y: Math.round(to.y) })
+        .up()
+        .perform();
+}
+// Press-and-hold a located element through the W3C actions builder (browser
+// long-press, and the Mac2 desktop path). Device web contexts (XCUITest web,
+// phase A5) reject the actions endpoint — like non-left buttons, this is
+// desktop-browser-only until those contexts grow actions support.
+async function performElementPress({ driver, element, button = "left", duration, }) {
+    const buttonIndex = { left: 0, middle: 1, right: 2 }[button] ?? 0;
+    await driver
+        .action("pointer", { parameters: { pointerType: "mouse" } })
+        .move({ origin: element })
+        .down({ button: buttonIndex })
+        .pause(duration)
+        .up({ button: buttonIndex })
+        .perform();
+}
+async function getBrowserViewportRect(driver) {
+    const [width, height] = await driver.execute(() => [
+        window.innerWidth,
+        window.innerHeight,
+    ]);
+    return { x: 0, y: 0, width, height };
+}
+//# sourceMappingURL=movement.js.map

package/dist/core/tests/movement.js.map

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

package/dist/core/tests/swipe.d.ts

@@ -0,0 +1,8 @@
+export { swipeSurface };
+declare function swipeSurface({ config, step, driver, appSession, }: {
+    config: any;
+    step: any;
+    driver: any;
+    appSession?: any;
+}): Promise<any>;
+//# sourceMappingURL=swipe.d.ts.map

package/dist/core/tests/swipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../../src/core/tests/swipe.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,YAAY,EAAE,CAAC;AAiCxB,iBAAe,YAAY,CAAC,EAC1B,MAAM,EACN,IAAI,EACJ,MAAM,EACN,UAAU,GACX,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,gBAkIA"}

package/dist/core/tests/swipe.js

@@ -0,0 +1,158 @@
+// The swipe step (phase A6): the movement subset of dragAndDrop — a pointer
+// movement between two points, authored directly (from/to pixels relative to
+// the surface's top-left) or via the direction shorthand (fractions). Valid
+// on app and browser surfaces; a process has no screen to swipe. Pure
+// execution: no implicit assertions, like goTo.
+import { validate } from "../../common/src/validate.js";
+import { parseSurfaceRef, reinterpretForSessions, switchToSurface, } from "./browserSurface.js";
+import { resolveAppSurfaceRef, ensureAppForeground } from "./appSurface.js";
+import { APP_GESTURES } from "./appGestures.js";
+import { directionToPoints, performMovement, getBrowserViewportRect, DEFAULT_SWIPE_DISTANCE, DEFAULT_SWIPE_DURATION, } from "./movement.js";
+export { swipeSurface };
+// Normalize the three schema forms into one gesture shape. The directional
+// forms keep `direction`/`distance` (adapters with a native directional
+// gesture use them as-is); point-to-point carries `from`/`to`.
+function normalizeSwipe(swipe) {
+    if (typeof swipe === "string") {
+        return {
+            direction: swipe,
+            distance: DEFAULT_SWIPE_DISTANCE,
+            duration: DEFAULT_SWIPE_DURATION,
+        };
+    }
+    if (swipe.from && swipe.to) {
+        return {
+            from: swipe.from,
+            to: swipe.to,
+            duration: swipe.duration ?? DEFAULT_SWIPE_DURATION,
+        };
+    }
+    return {
+        direction: swipe.direction,
+        distance: swipe.distance ?? DEFAULT_SWIPE_DISTANCE,
+        duration: swipe.duration ?? DEFAULT_SWIPE_DURATION,
+    };
+}
+async function swipeSurface({ config, step, driver, appSession, }) {
+    const result = {
+        status: "PASS",
+        description: "Swiped the surface.",
+        outputs: {},
+        assertions: [],
+    };
+    // Validate step payload
+    const isValidStep = validate({ schemaKey: "step_v3", object: step });
+    if (!isValidStep.valid) {
+        result.status = "FAIL";
+        result.description = `Invalid step definition: ${isValidStep.errors}`;
+        return result;
+    }
+    step = isValidStep.object;
+    const surface = typeof step.swipe === "object" ? step.swipe.surface : undefined;
+    const gesture = normalizeSwipe(step.swipe);
+    result.outputs = {
+        ...(gesture.direction !== undefined && { direction: gesture.direction }),
+        ...(gesture.distance !== undefined && { distance: gesture.distance }),
+        ...(gesture.from !== undefined && { from: gesture.from, to: gesture.to }),
+        duration: gesture.duration,
+    };
+    // App-surface branch: an app registry hit is authoritative for its name.
+    const appRef = resolveAppSurfaceRef(surface, appSession);
+    if (appRef) {
+        if (appRef.error) {
+            result.status = "FAIL";
+            result.description = appRef.error;
+            return result;
+        }
+        if (appRef.window !== undefined) {
+            result.status = "FAIL";
+            result.description =
+                "Window selectors on app surfaces land in a later part of this phase; act on the app's active window for now (omit `window`).";
+            return result;
+        }
+        const switched = await ensureAppForeground(appRef.entry, appSession);
+        if (switched.error) {
+            result.status = "FAIL";
+            result.description = switched.error;
+            return result;
+        }
+        const platform = appRef.entry.platform ?? "windows";
+        const gestures = APP_GESTURES[platform];
+        if (!gestures) {
+            result.status = "FAIL";
+            result.description = `swipe isn't implemented for the "${platform}" app platform.`;
+            return result;
+        }
+        try {
+            await gestures.swipe(appRef.entry.driver, gesture);
+        }
+        catch (error) {
+            result.status = "FAIL";
+            result.description = `Couldn't swipe the app surface: ${error?.message ?? error}`;
+            return result;
+        }
+        result.description = `Swiped the app surface "${appRef.entry.name}".`;
+        return result;
+    }
+    // Everything else resolves to a browser surface: swipe's schema restricts
+    // bare strings to engine keywords and has NO process branch (a background
+    // process has no screen to swipe — the kind is unrepresentable, per the
+    // byEngineName precedent), so the process kind can't reach this point.
+    const resolved = reinterpretForSessions(driver, parseSurfaceRef(surface));
+    if (resolved.kind === "unsupported") {
+        // An { app: … } reference in a context with no app session lands here.
+        result.status = "FAIL";
+        result.description = `The surface names an app, but no app session is active in this context. Open the app first with startSurface.`;
+        return result;
+    }
+    if (resolved.kind === "browser") {
+        const switched = await switchToSurface(driver, surface);
+        if (!switched.ok) {
+            result.status = "FAIL";
+            result.description = switched.message;
+            return result;
+        }
+        driver = switched.driver ?? driver;
+    }
+    if (!driver) {
+        result.status = "FAIL";
+        result.description = `swipe needs a surface to act on in an app-only context. Name the app surface: { "swipe": { "direction": "up", "surface": { "app": "…" } } }.`;
+        return result;
+    }
+    try {
+        if (gesture.from && gesture.to) {
+            // Point-to-point: a real pointer drag (sliders, canvases, maps).
+            // Authored pixels are viewport-relative, which is what the W3C
+            // viewport-origin actions expect — no conversion needed.
+            await performMovement({
+                driver,
+                from: gesture.from,
+                to: gesture.to,
+                duration: gesture.duration,
+                pointerType: "mouse",
+            });
+        }
+        else {
+            // Directional: scroll the page. A mouse drag on a web page selects text
+            // instead of scrolling, so the finger-motion semantics map onto
+            // scrollBy: swiping up moves content up, revealing content below.
+            const rect = await getBrowserViewportRect(driver);
+            const { from, to } = directionToPoints(gesture.direction, gesture.distance);
+            const dx = Math.round((from.x - to.x) * rect.width);
+            const dy = Math.round((from.y - to.y) * rect.height);
+            await driver.execute(
+            /* c8 ignore next 3 - runs inside the browser via driver.execute() */
+            (x, y) => {
+                window.scrollBy({ left: x, top: y, behavior: "auto" });
+            }, dx, dy);
+        }
+    }
+    catch (error) {
+        result.status = "FAIL";
+        result.description = `Couldn't swipe the browser surface: ${error?.message ?? error}`;
+        return result;
+    }
+    result.description = "Swiped the browser surface.";
+    return result;
+}
+//# sourceMappingURL=swipe.js.map

package/dist/core/tests/swipe.js.map

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

package/dist/core/tests/typeKeys.d.ts

@@ -1,4 +1,11 @@
-export { typeKeys, translateProcessKeys, resolveSurface, resolveInputDelay };
+export { typeKeys, translateProcessKeys, splitKeyRuns, resolveSurface, resolveInputDelay, };
+declare function splitKeyRuns(keys: string[], platform: "android" | "ios"): Array<{
+    kind: "text";
+    text: string;
+} | {
+    kind: "token";
+    token: string;
+}>;
 declare const _processKeyMap: Record<string, string>;
 export { _processKeyMap };
 declare function resolveInputDelay(inputDelay: unknown): number;

package/dist/core/tests/typeKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeKeys.d.ts","sourceRoot":"","sources":["../../../src/core/tests/typeKeys.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAK7E,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY1C,CAAC;AAKF,OAAO,EAAE,cAAc,EAAE,CAAC;AAM1B,iBAAS,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAEtD;AAMD,iBAAS,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuCtD;AAWD,iBAAS,cAAc,CAAC,OAAO,EAAE,GAAG,+CAEnC;AAsMD,iBAAe,QAAQ,CAAC,EACtB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,eAAe,EACf,UAAU,GACX,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,gBAgUA"}
+{"version":3,"file":"typeKeys.d.ts","sourceRoot":"","sources":["../../../src/core/tests/typeKeys.ts"],"names":[],"mappings":"AA+BA,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,CAAC;AAQF,iBAAS,YAAY,CACnB,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,SAAS,GAAG,KAAK,GAC1B,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC1E;AAKD,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY1C,CAAC;AAKF,OAAO,EAAE,cAAc,EAAE,CAAC;AAM1B,iBAAS,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAEtD;AAMD,iBAAS,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuCtD;AAWD,iBAAS,cAAc,CAAC,OAAO,EAAE,GAAG,+CAEnC;AAsMD,iBAAe,QAAQ,CAAC,EACtB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,eAAe,EACf,UAAU,GACX,EAAE;IACD,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,GAAG,CAAC;IACZ,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB,gBAmXA"}