@keepsnappy/appium-driver 0.1.0-alpha.22 → 0.1.0-alpha.23

package/README.md

@@ -63,9 +63,11 @@ await scrollCycles(t, {
 });
 ```
 
-`scrollList(t, { list, row, field, screen, above }, toward, { cache, hold })` is the one way the driver scrolls a list; every helper below sends its gesture through it. With `mustMove` (a to-top pass, the first fling of an end pass) the gesture is checked: one the device did not take (Android: no view-scrolled event; iOS: the held row's frame unchanged) is confirmed by the row ids inside the list's frame, sent once more and counted in the driver log's `defects`; a second one throws `GestureNotTaken`. Every list gesture is one touch, `FLING`, on both platforms: from 85 % of the list frame to 25 % (toward the end) or from 30 % to 90 % (toward the top), i.e. 60 % of the list, at least 250 dp (Android) or pt (iOS), held for 150 ms. Android sends it as a native UiAutomator fling over that span at the speed that makes it last 150 ms (density cached per driver), iOS as a 150 ms drag. A touch that would reach into the bottom system-gesture zone or past the window's top moves whole; its start stays at least 10 % of the list inside the list's frame, and a touch that still does not fit is cut and logs `clamped: true` and `travel`. An app takes a touch as a pan 19–60 ms after it lands, so a shorter touch can move nothing. `longScroll` is that gesture on a given rectangle. `flingUntilShown` stops when any part of the target shows: three gestures maximum, five toward the top on iOS. `scrollUntilShown` exposes the same capped look/move loop for custom checks. `waitCoasted` waits for two matching row frames 300 ms apart (up to 3000 ms); `holdBeforeScroll` captures a row before an iOS gesture so coast checks can reuse its handle.
+`scrollList(t, { list, row, field, screen, above }, toward, { cache, hold })` is the one way the driver scrolls a list; every helper below sends its gesture through it. With `mustMove` (a to-top pass, the first fling of an end pass) the gesture is checked: one the device did not take (the held row's frame unchanged, both platforms) is confirmed by the row ids inside the list's frame, sent once more and counted in the driver log's `defects`; a second one throws `GestureNotTaken`. Every list gesture is one touch, `FLING`, on both platforms: from 85 % of the list frame to 25 % (toward the end) or from 30 % to 90 % (toward the top), i.e. 60 % of the list, at least 250 dp (Android) or pt (iOS), held for 150 ms. Android sends it as a native UiAutomator `mobile: swipeGesture` over that span at the speed that makes it last 150 ms (density cached per driver; a swipe answers when the finger lifts, a fling waits about 5 s for a scroll event), iOS as a 150 ms drag. A touch that would reach into the bottom system-gesture zone or past the window's top moves whole; its start stays at least 10 % of the list inside the list's frame, and a touch that still does not fit is cut and logs `clamped: true` and `travel`. An app takes a touch as a pan 19–60 ms after it lands, so a shorter touch can move nothing. `longScroll` is that gesture on a given rectangle. In a measured step `flingUntilShown` stops when any part of the target shows: three gestures maximum, five toward the top on iOS. `scrollUntilShown` exposes the same capped look/move loop for custom checks. `waitCoasted` waits for two matching row frames 300 ms apart (up to 3000 ms); `holdBeforeScroll` captures a row before an iOS gesture so coast checks can reuse its handle.
 
-`scrollToEnd` performs three long scrolls. Each page marker starts a 3000 ms load wait after coast stops (6000 ms Android, 10000 ms iOS); scrolls without a page marker pause 500 ms. Supply `beforePages` to permit exactly one additional fling when the loaded end was missed. `scrollCycles` repeats three end/top pairs, waiting for page markers only in cycle one and checking `lastPage` loaded in every cycle. `pageNumbers` preserves numeric page labels in command summaries; otherwise summaries use selector descriptions. Page sizes and seed data stay in the journey's page selectors. Options expose the counts and timeouts; their defaults are exported constants. `frameTimeoutMs` (20000) bounds the wait for the list frame to stop moving, `checkTimeoutMs` (20000) bounds a step check (`passChecked`, `endChecked`; in `scrollCycles` the top check reads `fling.checkTimeoutMs`), and `lookWindowMs` (1000) is the window in which a look after a gesture is retried. The `lookMs` field in the log stays the cumulative time spent looking.
+`scrollToEnd` performs three long scrolls and no other: never a catch-up gesture. Each page marker starts a 3000 ms load wait after coast stops (6000 ms Android, 10000 ms iOS); scrolls without a page marker pause 500 ms. A page that has not landed fails the pass, or with `deferPages` is logged (`landed`) and left to navigation. `scrollCycles` repeats three end/top pairs, each step a fixed count of the measured gesture (3 toward the end, 2 toward the top), waiting for page markers only in cycle one; after each step a navigation pass finishes the way and the end check (`lastPage` loaded) and top check run.
+
+Navigation passes (`navigate`, `Session.navigation`): getting somewhere — to the top, to the loaded end, a target into view — is not a measured gesture. A pass is wrapped in `nav` start/end markers, outside any measured step, and its list gestures are the navigation stroke (`NAV_STROKE`: a 100 ms slow move the app takes as a pan, then a 45 ms flick, one W3C actions call on both platforms). It ends when the target is found by lookup and the list's first and last rows are unchanged 300 ms apart, never on a frame test; two strokes that leave them as they were throw `NavigationStuck`. `flingUntilShown`, `scrollToTarget`, `Session.flingUntil` and `Session.scrollUntil` are navigation passes outside a step and send the measured gesture inside one. `pageNumbers` preserves numeric page labels in command summaries; otherwise summaries use selector descriptions. Page sizes and seed data stay in the journey's page selectors. Options expose the counts and timeouts; their defaults are exported constants. `frameTimeoutMs` (20000) bounds the wait for the list frame to stop moving, `checkTimeoutMs` (20000) bounds a step check (`passChecked`, `endChecked`; in `scrollCycles` the top check reads `fling.checkTimeoutMs`), and `lookWindowMs` (1000) is the window in which a look after a gesture is retried. The `lookMs` field in the log stays the cumulative time spent looking.
 
 `passChecked` and `endChecked` create step checks; share a `ListCache` with `flingUntilShown`/`scrollToEnd` for each visit to a list. `passChecked` permits one repair using only the original pass's remaining budget. `scoped: false` searches globally when row selectors are unique. `field: 'text' | 'description'` limits Android row lookups to the attribute the app uses. `rowAlternatives(from, to, format)` builds page-marker alternations from journey data; `rowAtOrBelow` checks whether a row has moved under a boundary. `t.frameOf` and `t.settledFrame` expose the existing stale-safe frame readers for custom mechanics.
 

package/dist/src/gestures.d.ts

@@ -9,6 +9,14 @@ export interface Point {
 /** Default scroll budget; the third gesture is logged as extra. */
 export declare const LONG_SCROLL_CAP = 3;
 export declare const LONG_SCROLL_PLANNED = 2;
+/**
+ * The measured top step of `scrollCycles`: exactly `gestures` of them, sent without looking in between; the first row is looked
+ * for after them and a navigation pass finishes the way (F3, lab 10-29: one FLING never reaches the top of a TapIn-sized list,
+ * so the count was the same either way and the look cost 2–4 s a step).
+ */
+export declare const TOP_STEP: {
+    readonly gestures: 2;
+};
 /** Additional iOS gestures allowed when returning to the top. */
 export declare const IOS_TOP_EXTRA = 2;
 /**
@@ -27,6 +35,33 @@ export declare const FLING: {
 export declare const CLOSE_SWIPE_MS = 400;
 export declare const TAP_HOLD_MS = 100;
 export declare const BURST_GAP_MS = 45;
+/**
+ * The navigation stroke: "take, then flick", for the passes that only get somewhere (return to top, go to the loaded end, bring a
+ * target into view) and never for a measured gesture. One touch in one W3C actions call: a slow first move over `slow` of the
+ * list's height in `slowMs`, which the app takes as a pan (it takes a touch 19–60 ms after it lands, up to 100 ms under load, so
+ * a touch that flicks at once is dropped by races: D1), then a fast move over the rest of the way in `fastMs`, so the release
+ * velocity is high and the list coasts about as far as the old 12 000 dp/s fling did. The span is 80 % of the list frame; its
+ * ends keep FLING's clearance (starts at least `startMargin` of the list inside its frame, ends above the bottom system zone).
+ * Navigation windows are keyed `nav:<list>` and never judged (ctl-arek-nav-scroll, D1 narrowed to measured gestures).
+ */
+export declare const NAV_STROKE: {
+    readonly end: readonly [0.9, 0.1];
+    readonly top: readonly [0.2, 1];
+    readonly slow: 0.1;
+    readonly slowMs: 100;
+    readonly fastMs: 45;
+    readonly minTravel: 250;
+    /**
+     * The drag a pass turns round with after a stroke carried a mid-list target past the view: from `margin` to 1 − `margin` of
+     * the list in `moveMs`, held `holdMs` before release so the list keeps no speed (Android drops velocity samples older than
+     * 40 ms): it moves 60 % of the list, so no row can be skipped.
+     */
+    readonly precise: {
+        readonly margin: 0.2;
+        readonly moveMs: 600;
+        readonly holdMs: 150;
+    };
+};
 /** A vertical touch in window units; `clamped` when the list left no room for its whole travel. */
 export interface Stroke {
     from: number;
@@ -34,11 +69,17 @@ export interface Stroke {
     travel: number;
     clamped: boolean;
 }
+/** The navigation stroke's touch: `mid` is where the slow move ends and the flick starts. */
+export interface NavStroke extends Stroke {
+    mid: number;
+}
 /**
  * FLING's touch in list frame `r` toward `toward`, in window units of which `unit` make a dp (Android) or pt (iOS), between the
  * window's top and `safeBottom`. `start` replaces the frame's start fraction (a drawn row's centre).
  */
 export declare function flingStroke(r: Rect, toward: ScrollDirection, unit: number, safeBottom: number, start?: number): Stroke;
+/** NAV_STROKE's touch in list frame `r` toward `toward`, laid like flingStroke's; the slow move is its first `slow` of the list. */
+export declare function navStroke(r: Rect, toward: ScrollDirection, unit: number, safeBottom: number): NavStroke;
 /**
  * Closes a sheet between window points. Android uses native dragGesture; iOS uses a 400 ms drag. Logs commands only.
  * Does not consume readiness itself; use closeSwipeAt/From when readiness is pending.

package/dist/src/gestures.js

@@ -1,6 +1,12 @@
 /** Default scroll budget; the third gesture is logged as extra. */
 export const LONG_SCROLL_CAP = 3;
 export const LONG_SCROLL_PLANNED = 2;
+/**
+ * The measured top step of `scrollCycles`: exactly `gestures` of them, sent without looking in between; the first row is looked
+ * for after them and a navigation pass finishes the way (F3, lab 10-29: one FLING never reaches the top of a TapIn-sized list,
+ * so the count was the same either way and the look cost 2–4 s a step).
+ */
+export const TOP_STEP = { gestures: LONG_SCROLL_PLANNED };
 /** Additional iOS gestures allowed when returning to the top. */
 export const IOS_TOP_EXTRA = 2;
 /**
@@ -20,13 +26,32 @@ export const CLOSE_SWIPE_MS = 400;
 export const TAP_HOLD_MS = 100;
 export const BURST_GAP_MS = 45;
 /**
- * FLING's touch in list frame `r` toward `toward`, in window units of which `unit` make a dp (Android) or pt (iOS), between the
- * window's top and `safeBottom`. `start` replaces the frame's start fraction (a drawn row's centre).
+ * The navigation stroke: "take, then flick", for the passes that only get somewhere (return to top, go to the loaded end, bring a
+ * target into view) and never for a measured gesture. One touch in one W3C actions call: a slow first move over `slow` of the
+ * list's height in `slowMs`, which the app takes as a pan (it takes a touch 19–60 ms after it lands, up to 100 ms under load, so
+ * a touch that flicks at once is dropped by races: D1), then a fast move over the rest of the way in `fastMs`, so the release
+ * velocity is high and the list coasts about as far as the old 12 000 dp/s fling did. The span is 80 % of the list frame; its
+ * ends keep FLING's clearance (starts at least `startMargin` of the list inside its frame, ends above the bottom system zone).
+ * Navigation windows are keyed `nav:<list>` and never judged (ctl-arek-nav-scroll, D1 narrowed to measured gestures).
  */
-export function flingStroke(r, toward, unit, safeBottom, start) {
-    const [f, t] = FLING[toward];
-    const travel = Math.round(Math.max(Math.abs(t - f) * r.height, FLING.minTravel * unit));
-    const step = toward === 'end' ? -travel : travel;
+export const NAV_STROKE = {
+    end: [0.9, 0.1],
+    top: [0.2, 1],
+    slow: 0.1,
+    slowMs: 100,
+    fastMs: 45,
+    minTravel: 250,
+    /**
+     * The drag a pass turns round with after a stroke carried a mid-list target past the view: from `margin` to 1 − `margin` of
+     * the list in `moveMs`, held `holdMs` before release so the list keeps no speed (Android drops velocity samples older than
+     * 40 ms): it moves 60 % of the list, so no row can be skipped.
+     */
+    precise: { margin: 0.2, moveMs: 600, holdMs: 150 },
+};
+/** A touch from fraction `f` to `t` of list frame `r`, kept above `safeBottom` and its start inside the frame; see flingStroke. */
+function fit(r, f, t, minTravel, unit, safeBottom, start) {
+    const travel = Math.round(Math.max(Math.abs(t - f) * r.height, minTravel * unit));
+    const step = t > f ? travel : -travel;
     const clamp = (y) => Math.min(Math.max(y, 0), safeBottom);
     let from = Math.round(start ?? r.y + r.height * f);
     const below = Math.max(from, from + step) - safeBottom;
@@ -39,6 +64,21 @@ export function flingStroke(r, toward, unit, safeBottom, start) {
     const to = clamp(from + step);
     return { from, to, travel, clamped: Math.abs(to - from) < travel };
 }
+/**
+ * FLING's touch in list frame `r` toward `toward`, in window units of which `unit` make a dp (Android) or pt (iOS), between the
+ * window's top and `safeBottom`. `start` replaces the frame's start fraction (a drawn row's centre).
+ */
+export function flingStroke(r, toward, unit, safeBottom, start) {
+    const [f, t] = FLING[toward];
+    return fit(r, f, t, FLING.minTravel, unit, safeBottom, start);
+}
+/** NAV_STROKE's touch in list frame `r` toward `toward`, laid like flingStroke's; the slow move is its first `slow` of the list. */
+export function navStroke(r, toward, unit, safeBottom) {
+    const [f, t] = NAV_STROKE[toward];
+    const s = fit(r, f, t, NAV_STROKE.minTravel, unit, safeBottom);
+    const slow = Math.min(Math.round(NAV_STROKE.slow * r.height), Math.floor(Math.abs(s.to - s.from) / 2));
+    return { ...s, mid: s.from + (s.to > s.from ? slow : -slow) };
+}
 /**
  * Closes a sheet between window points. Android uses native dragGesture; iOS uses a 400 ms drag. Logs commands only.
  * Does not consume readiness itself; use closeSwipeAt/From when readiness is pending.

package/dist/src/gestures.js.map

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

package/dist/src/index.d.ts

@@ -3,11 +3,11 @@ export { END_GC_DEFAULT, RUN_DEFAULTS, acceptAlert, activationLink, flushLink, g
 export { defineJourney, type JourneyContext, type JourneyFn, type JourneyModule } from './journey.js';
 export { ANDROID, IOS, PLATFORMS, platformOf, type Platform, type PlatformName } from './platform.js';
 export { androidLocators, childOf, describeSelector, id, idText, locator, text, toSelector, type Selector, type SelectorLike } from './selectors.js';
-export { FLUSH_END_RUN_FAILED, FLUSH_ERROR, FLUSH_OFF, FLUSH_NOT_ACKNOWLEDGED, FLUSH_RESEND_MS, FLUSH_UNREADABLE, FLUSH_WAIT_MS, type FlushEvidence, HOST_CLOCK_TRIPS, Session, sendMarkers, type ActionGc, type GestureDefect, type ClockTrip, type Condition, type Marker } from './session.js';
+export { FLUSH_END_RUN_FAILED, FLUSH_ERROR, FLUSH_OFF, FLUSH_NOT_ACKNOWLEDGED, FLUSH_RESEND_MS, FLUSH_UNREADABLE, FLUSH_WAIT_MS, type FlushEvidence, HOST_CLOCK_TRIPS, NAV_EDGE_MS, NAV_STEP, Session, sendMarkers, type ActionGc, type GestureDefect, type ClockTrip, type Condition, type Marker } from './session.js';
 export { loadElements, parseTokensJs, plan, type PlannedRun } from './tokens.js';
 export { runDriver, DRIVER_OPTIONS, type IterationRecord, type RunDeps } from './run.js';
 export { loadJourneyModule, main } from './load.js';
 export { DRIVER_NAME, driverVersion, journeyVersion } from './version.js';
-export { closeSwipe, closeSwipeAt, closeSwipeFrom, tapAllAt, flingStroke, FLING, LONG_SCROLL_CAP, LONG_SCROLL_PLANNED, IOS_TOP_EXTRA, CLOSE_SWIPE_MS, TAP_HOLD_MS, BURST_GAP_MS, type ScrollDirection, type Point, type Stroke } from './gestures.js';
-export { rowAlternatives, rowAtOrBelow, scrollUntilShown, scrollCap, flingUntilShown, passChecked, scrollToEnd, endChecked, scrollCycles, scrollToTarget, END_SCROLLS, SCROLL_CYCLES, PAGE_PAUSE_MS, PAGE_WAIT_MS, PAGE_POLL_MS, PAGE_COAST_MAX_MS, PAGE_COAST_MAX_MS_IOS, LOOK_MS, LOOK_POLL_MS, CHECK_TIMEOUT_MS, TARGET_SETTLE_MS, type UntilShownOptions, type FlingUntilShownOptions, type ScrollToEndOptions, type EndCheckOptions, type PassCheckOptions, type ScrollCyclesOptions, type ScrollToTargetOptions } from './lists.js';
-export { scrollList, GestureNotTaken, longScroll, androidScreenScroll, scrollFromDrawnRow, waitCoasted, holdBeforeScroll, FLING_UNMOVED_MS, COAST_POLL_MS, COAST_MAX_MS, type ScrollSpec, type ScrollOptions, type ScrollResult, type RowField, type ListHandle, type RowHold, type ListCache } from './scroll.js';
+export { closeSwipe, closeSwipeAt, closeSwipeFrom, tapAllAt, flingStroke, navStroke, FLING, NAV_STROKE, LONG_SCROLL_CAP, LONG_SCROLL_PLANNED, TOP_STEP, IOS_TOP_EXTRA, CLOSE_SWIPE_MS, TAP_HOLD_MS, BURST_GAP_MS, type ScrollDirection, type Point, type Stroke, type NavStroke } from './gestures.js';
+export { rowAlternatives, rowAtOrBelow, scrollUntilShown, scrollCap, flingUntilShown, passChecked, scrollToEnd, endChecked, scrollCycles, scrollToTarget, navigate, END_SCROLLS, SCROLL_CYCLES, PAGE_PAUSE_MS, PAGE_WAIT_MS, PAGE_POLL_MS, PAGE_COAST_MAX_MS, PAGE_COAST_MAX_MS_IOS, LOOK_MS, LOOK_POLL_MS, CHECK_TIMEOUT_MS, TARGET_SETTLE_MS, NAV_MAX_MS, NAV_STUCK_STROKES, type NavigateOptions, type NavigateResult, type UntilShownOptions, type FlingUntilShownOptions, type ScrollToEndOptions, type EndCheckOptions, type PassCheckOptions, type ScrollCyclesOptions, type ScrollToTargetOptions } from './lists.js';
+export { scrollList, GestureNotTaken, NavigationStuck, longScroll, androidScreenScroll, scrollFromDrawnRow, waitCoasted, holdBeforeScroll, COAST_POLL_MS, COAST_MAX_MS, type ScrollSpec, type ScrollOptions, type ScrollResult, type RowField, type ListHandle, type RowHold, type ListCache } from './scroll.js';

package/dist/src/index.js

@@ -3,12 +3,12 @@ export { END_GC_DEFAULT, RUN_DEFAULTS, acceptAlert, activationLink, flushLink, g
 export { defineJourney } from './journey.js';
 export { ANDROID, IOS, PLATFORMS, platformOf } from './platform.js';
 export { androidLocators, childOf, describeSelector, id, idText, locator, text, toSelector } from './selectors.js';
-export { FLUSH_END_RUN_FAILED, FLUSH_ERROR, FLUSH_OFF, FLUSH_NOT_ACKNOWLEDGED, FLUSH_RESEND_MS, FLUSH_UNREADABLE, FLUSH_WAIT_MS, HOST_CLOCK_TRIPS, Session, sendMarkers } from './session.js';
+export { FLUSH_END_RUN_FAILED, FLUSH_ERROR, FLUSH_OFF, FLUSH_NOT_ACKNOWLEDGED, FLUSH_RESEND_MS, FLUSH_UNREADABLE, FLUSH_WAIT_MS, HOST_CLOCK_TRIPS, NAV_EDGE_MS, NAV_STEP, Session, sendMarkers } from './session.js';
 export { loadElements, parseTokensJs, plan } from './tokens.js';
 export { runDriver, DRIVER_OPTIONS } from './run.js';
 export { loadJourneyModule, main } from './load.js';
 export { DRIVER_NAME, driverVersion, journeyVersion } from './version.js';
-export { closeSwipe, closeSwipeAt, closeSwipeFrom, tapAllAt, flingStroke, FLING, LONG_SCROLL_CAP, LONG_SCROLL_PLANNED, IOS_TOP_EXTRA, CLOSE_SWIPE_MS, TAP_HOLD_MS, BURST_GAP_MS } from './gestures.js';
-export { rowAlternatives, rowAtOrBelow, scrollUntilShown, scrollCap, flingUntilShown, passChecked, scrollToEnd, endChecked, scrollCycles, scrollToTarget, END_SCROLLS, SCROLL_CYCLES, PAGE_PAUSE_MS, PAGE_WAIT_MS, PAGE_POLL_MS, PAGE_COAST_MAX_MS, PAGE_COAST_MAX_MS_IOS, LOOK_MS, LOOK_POLL_MS, CHECK_TIMEOUT_MS, TARGET_SETTLE_MS } from './lists.js';
-export { scrollList, GestureNotTaken, longScroll, androidScreenScroll, scrollFromDrawnRow, waitCoasted, holdBeforeScroll, FLING_UNMOVED_MS, COAST_POLL_MS, COAST_MAX_MS } from './scroll.js';
+export { closeSwipe, closeSwipeAt, closeSwipeFrom, tapAllAt, flingStroke, navStroke, FLING, NAV_STROKE, LONG_SCROLL_CAP, LONG_SCROLL_PLANNED, TOP_STEP, IOS_TOP_EXTRA, CLOSE_SWIPE_MS, TAP_HOLD_MS, BURST_GAP_MS } from './gestures.js';
+export { rowAlternatives, rowAtOrBelow, scrollUntilShown, scrollCap, flingUntilShown, passChecked, scrollToEnd, endChecked, scrollCycles, scrollToTarget, navigate, END_SCROLLS, SCROLL_CYCLES, PAGE_PAUSE_MS, PAGE_WAIT_MS, PAGE_POLL_MS, PAGE_COAST_MAX_MS, PAGE_COAST_MAX_MS_IOS, LOOK_MS, LOOK_POLL_MS, CHECK_TIMEOUT_MS, TARGET_SETTLE_MS, NAV_MAX_MS, NAV_STUCK_STROKES } from './lists.js';
+export { scrollList, GestureNotTaken, NavigationStuck, longScroll, androidScreenScroll, scrollFromDrawnRow, waitCoasted, holdBeforeScroll, COAST_POLL_MS, COAST_MAX_MS } from './scroll.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAmD,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAC5J,OAAO,EAAE,aAAa,EAA2D,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAoC,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AACrJ,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAsB,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAkF,MAAM,cAAc,CAAC;AAClS,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAsC,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAiD,MAAM,eAAe,CAAC;AACtP,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAmL,MAAM,YAAY,CAAC;AAC1gB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAwH,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAmD,MAAM,gBAAgB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAC5J,OAAO,EAAE,aAAa,EAA2D,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAoC,MAAM,eAAe,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAoC,MAAM,gBAAgB,CAAC;AACrJ,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAsB,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAkF,MAAM,cAAc,CAAC;AACzT,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,cAAc,EAAsC,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAiE,MAAM,eAAe,CAAC;AACvS,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAA8N,MAAM,YAAY,CAAC;AAC9lB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAwH,MAAM,aAAa,CAAC"}

package/dist/src/lists.d.ts

@@ -21,6 +21,10 @@ export declare const LOOK_POLL_MS = 100;
 export declare const CHECK_TIMEOUT_MS = 20000;
 /** Initial visibility wait before trying an indicator or fallback scroll. */
 export declare const TARGET_SETTLE_MS = 10000;
+/** A navigation pass that still has not arrived after this long fails (it has no stroke count to end it). */
+export declare const NAV_MAX_MS = 120000;
+/** Two navigation strokes in a row that leave the first and last visible rows as they were stop the pass. */
+export declare const NAV_STUCK_STROKES = 2;
 export interface UntilShownOptions {
     cmd: string;
     field: string;
@@ -34,6 +38,10 @@ export interface UntilShownOptions {
     extra?: () => Record<string, unknown>;
     lookWindowMs?: number;
     lookPollMs?: number;
+    /** Reaching `cap` without the target ends the loop with the log's `reached: false` instead of throwing `missing`. */
+    soft?: boolean;
+    /** Between blind moves, one look (no look window): a target already shown ends the blind moves (a sheet list at its top). */
+    lookBetweenBlind?: boolean;
 }
 export interface FlingUntilShownOptions {
     scoped?: boolean;
@@ -48,6 +56,8 @@ export interface FlingUntilShownOptions {
     coastMaxMs?: number;
     lookWindowMs?: number;
     lookPollMs?: number;
+    /** In a measured step: reaching `cap` without the target is not a failure; a navigation pass after the step finishes the way. */
+    soft?: boolean;
 }
 export interface ScrollToEndOptions {
     pages: readonly SelectorLike[];
@@ -64,6 +74,8 @@ export interface ScrollToEndOptions {
     coastMaxMs?: number;
     coastMaxMsIos?: number;
     frameTimeoutMs?: number;
+    /** A page that has not landed after its wait is logged, not an error: the caller's navigation pass fetches it (scrollCycles). */
+    deferPages?: boolean;
 }
 export interface EndCheckOptions {
     checkTimeoutMs?: number;
@@ -82,6 +94,35 @@ export interface ScrollCyclesOptions extends ScrollToEndOptions {
     stepName: (toward: ScrollDirection, cycle: number) => string;
     fling?: PassCheckOptions;
 }
+export interface NavigateOptions {
+    /** The target is there, by element lookup: never by a frame test (an overlay can cover a row whose frame lies in the list). */
+    until: () => Promise<boolean>;
+    /** The list's rows: the first and last row inside the list are read on them, twice 300 ms apart, to tell a coast from a rest. */
+    row: SelectorLike;
+    field?: RowField;
+    scoped?: boolean;
+    cache?: ListCache;
+    /** Toward the end: after a stroke has come to rest, how long to wait for the target (a page) before the next stroke. */
+    pageWaitMs?: number;
+    /** Bound of the wait for the list to come to rest after a stroke (default PAGE_COAST_MAX_MS, iOS PAGE_COAST_MAX_MS_IOS). */
+    coastMaxMs?: number;
+    frameTimeoutMs?: number;
+    maxMs?: number;
+    /** Names the target in the log and in errors. */
+    label?: string;
+    /** Strokes needed here mean the measured gestures fell short: counted as the harness defect `navCatchUp`. */
+    catchUp?: boolean;
+    /**
+     * The target may sit mid-list, so a stroke can carry it past the view: stalled at the edge after the list moved, the pass turns
+     * round once with precise drags. Off for edge targets (the top, the loaded end, a page still to land): there the stall is stuck.
+     */
+    turnRound?: boolean;
+}
+export interface NavigateResult {
+    strokes: number;
+    arrived: boolean;
+    ms: number;
+}
 export interface ScrollToTargetOptions {
     target: SelectorLike;
     row: SelectorLike;
@@ -98,17 +139,34 @@ export interface ScrollToTargetOptions {
  * begins at least lookWindowMs (1000) after it; lookPollMs defaults to 100. Optional settle runs before those looks.
  * Logs cmd with the gesture count under field, blind/cap, looks/lookMs, status, duration, optional extra and planned overrun.
  */
-export declare function scrollUntilShown(t: Session, { cmd, field, cap, blind, planned, settle, look: once, move, missing, extra, lookWindowMs, lookPollMs }: UntilShownOptions): Promise<number>;
+export declare function scrollUntilShown(t: Session, { cmd, field, cap, blind, planned, settle, look: once, move, missing, extra, lookWindowMs, lookPollMs, soft, lookBetweenBlind }: UntilShownOptions): Promise<number>;
 /** Platform gesture budget: cap (3), plus iosTopExtra (2) only when returning to the top on iOS. No commands or logs. */
 export declare const scrollCap: (t: Session, toward: ScrollDirection, cap?: number, iosTopExtra?: number) => number;
 /**
- * Long-scrolls list toward a partly visible target; scoped defaults true. Refetches missing/stale list handles before
+ * Brings `target` of `list` into view toward `toward`. Outside a measured step it is a navigation pass (`navigate`: marked `nav`,
+ * the navigation stroke, no gesture cap: it ends on the target found by lookup and the rows at rest, and stops when two strokes
+ * leave the rows as they were; `blind`, `cap`, `planned`, `iosTopExtra` and `used` do not apply). Inside a step its gestures stay
+ * the measured gesture, as below, and nothing is marked `nav`.
+ *
+ * In a step it long-scrolls list toward a partly visible target; scoped defaults true. Refetches missing/stale list handles before
  * moving and rereads the frame before every gesture. A shared cache stores the settled frame, held iOS row and moves used.
  * Defaults: 3 gestures (5 to top on iOS), 2 planned, 20 s frameTimeoutMs, 3 s coast. used subtracts the prior pass budget.
- * A to-top gesture is checked (scrollList `mustMove`); its retry is a logged defect and does not use the budget.
+ * A to-top gesture is checked (scrollList `mustMove`); its retry is a logged defect and does not use the budget. With `soft`, the
+ * cap ends the loop quietly (`reached: false` in the log) where it would throw.
  * Logs fling-to-end/top with flings, blind/cap, looks/lookMs, extra, relists, settled, status and duration, including failures.
  */
-export declare function flingUntilShown(t: Session, list: SelectorLike, target: SelectorLike, toward: ScrollDirection, { scoped, blind, cache, row, used, cap, planned, iosTopExtra, frameTimeoutMs, coastMaxMs, lookWindowMs, lookPollMs }?: FlingUntilShownOptions): Promise<void>;
+export declare function flingUntilShown(t: Session, list: SelectorLike, target: SelectorLike, toward: ScrollDirection, { scoped, blind, cache, row, used, cap, planned, iosTopExtra, frameTimeoutMs, coastMaxMs, lookWindowMs, lookPollMs, soft }?: FlingUntilShownOptions): Promise<void>;
+/**
+ * A navigation pass: gets `list` toward its top or end until `until` finds the target, with the navigation stroke, between `nav`
+ * markers (`Session.navigation`; never inside a measured step). Before the pass and after each stroke it waits for the list to
+ * come to rest: its first and last row (`rowEdges`) read twice, 300 ms apart, are the same. The pass ends when the target is
+ * found by lookup with the list at rest; toward the end, a stroke that rests with no target waits `pageWaitMs` for one (a page
+ * lands only once the list rests at its loaded end) before the next. No frame test decides arrival. There is no stroke count: when
+ * two strokes in a row leave those rows as they were after the list had moved, the target was passed: the pass turns round once
+ * with `NAV_STROKE.precise` drags; when two strokes leave them as they were again (or the list never moved) it throws `NavigationStuck` (counted in `t.defects.navStuck`; the run
+ * is invalid), and `maxMs` bounds the pass in time. Logs `nav` with toward, strokes, arrived, status and ms, also on failure.
+ */
+export declare function navigate(t: Session, list: SelectorLike, toward: ScrollDirection, { until, row, field, scoped, cache, pageWaitMs, coastMaxMs, frameTimeoutMs, maxMs, label, catchUp, turnRound }: NavigateOptions): Promise<NavigateResult>;
 /**
  * Creates a step check. On its first call only, a missing target triggers a re-scroll sharing cache.used; subsequent calls
  * only wait for visibility (checkTimeoutMs defaults 20000). Logs re-scrolled with toward plus the nested fling summary.
@@ -116,34 +174,41 @@ export declare function flingUntilShown(t: Session, list: SelectorLike, target:
  */
 export declare function passChecked(t: Session, list: SelectorLike, target: SelectorLike, toward: ScrollDirection, scoped: boolean, cache: ListCache, row?: SelectorLike, options?: PassCheckOptions): () => Promise<void>;
 /**
- * Performs scrolls (3) end gestures. A gesture with no page marker pauses pauseMs (500). Otherwise it waits for coast
- * (Android 6000 ms, iOS 10000), optionally adds one gesture if beforePages was not reached, then waits pageWaitMs (3000)
- * for the page's first loaded row, polling every pagePollMs (300). A page that has not landed by then while its beforePages
- * row is cut by (or touches) the list's bottom edge gets that one gesture instead, and a new wait; waitMs counts from the
- * last gesture's coast. scoped defaults true; field narrows Android lookups.
+ * Performs scrolls (3) end gestures, exactly that many and no other: a page that has not landed never gets a catch-up gesture
+ * here (a navigation pass outside the step fetches it). A gesture with no page marker pauses pauseMs (500). Otherwise it waits
+ * for coast (Android 6000 ms, iOS 10000), then waitMs (3000) for the page's first loaded row, polling every pagePollMs (300),
+ * counted from the coast. A page that has not landed by then fails the pass, or with `deferPages` is logged as not landed.
+ * scoped defaults true; field narrows Android lookups. `beforePages` is no longer read.
  * The pass is taken to start at the top, so its first gesture is checked (scrollList `mustMove`): one that moved nothing is
  * sent once more and counted in `t.defects`; `unmoved` is 1 then, and 2 when the retry moved nothing either (GestureNotTaken).
- * Logs fling-to-end: flings, supplied pageNumbers (or descriptions), coastMs, waitMs, per-page extra, unmoved, pauseMs, settled,
- * status and duration. Page checks do not require visibility. All limits and frameTimeoutMs (20000) are configurable.
+ * Logs fling-to-end: flings, supplied pageNumbers (or descriptions), coastMs, waitMs, landed (per page), unmoved, pauseMs,
+ * settled, status and duration. Page checks do not require visibility. All limits and frameTimeoutMs (20000) are configurable.
  */
-export declare function scrollToEnd(t: Session, list: SelectorLike, cache: ListCache, { pages, pageNumbers, beforePages, scoped, field, any, scrolls, pauseMs, pageWaitMs, pagePollMs, coastMaxMs, coastMaxMsIos, frameTimeoutMs }: ScrollToEndOptions): Promise<void>;
+export declare function scrollToEnd(t: Session, list: SelectorLike, cache: ListCache, { pages, pageNumbers, scoped, field, any, scrolls, pauseMs, pageWaitMs, pagePollMs, coastMaxMs, coastMaxMsIos, frameTimeoutMs, deferPages }: ScrollToEndOptions): Promise<void>;
 /**
  * Creates an end-pass check requiring a loaded lastPage row, even off screen. Retries a stale lookup once, then polls
  * every 300 ms for up to 20000 ms. checkTimeoutMs, pagePollMs and scrolls override the defaults in errors. Logs commands only.
  */
 export declare function endChecked(t: Session, list: SelectorLike, lastPage: SelectorLike, scoped: boolean, field?: RowField, { checkTimeoutMs, pagePollMs, scrolls }?: EndCheckOptions): () => Promise<void>;
 /**
- * Runs cycles (3) end/top measured step pairs with names from stepName(toward, oneBasedCycle). Only cycle one waits for
- * page markers; every end check requires lastPage loaded. Shares frame/row cache and each top pass's budget with its
- * check. frameTimeoutMs feeds the end frame wait; checkTimeoutMs feeds its end check. fling configures top passes/checks. Logs step markers and nested helper summaries.
+ * Runs cycles (3) end/top measured step pairs with names from stepName(toward, oneBasedCycle). Each step sends exactly its
+ * planned controlled gestures, the same in every run: the end step `scrolls` (3) end gestures, the top step 2, the top one looking
+ * before the second (a gesture at the top drags a sheet) and stopping quietly short of the top. Nothing is checked inside a step.
+ * After each step's end marker a navigation pass (`navigate`, marked `nav`, evidence only) finishes the way: to the loaded end
+ * until a lastPage row is loaded (strokes needed there are counted as the harness defect `navCatchUp`), to the top until `first`
+ * shows; the pass ends on lookups and rows at rest, never on frames. Then the end check (lastPage loaded, checkTimeoutMs for the
+ * end check) and the top check (first shown). Only cycle one waits for page markers. Shares the frame/row cache across steps and
+ * passes. frameTimeoutMs feeds the end frame wait. `fling` configures the top step: its `cap` and `iosTopExtra` no longer widen
+ * it. Logs step markers, nav passes and nested helper summaries.
  */
 export declare function scrollCycles(t: Session, { list, first, lastPage, cycles, stepName, fling, ...options }: ScrollCyclesOptions): Promise<void>;
 /**
  * Waits settleMs (10000) for target, then taps an optional indicator and/or runs move until visible, at most cap (3)
- * times, coasting on row after each action. Logs cmd (scroll-to-target) with tapped, swipes, extra above planned (2),
- * status and duration. An initially visible target returns without a summary. missing customizes the failure message.
+ * times, coasting on row after each action. Outside a measured step this is a navigation pass: marked `nav`, and the list
+ * gestures `move` sends are the navigation stroke (the pass has no list to read rows on, so `cap` still ends it). Logs cmd
+ * (scroll-to-target) with tapped, swipes, extra above planned (2), status and duration. An initially visible target returns without a summary. missing customizes the failure message.
  */
-export declare function scrollToTarget(t: Session, { target, indicator, row, move, settleMs, cap, planned, cmd, missing }: ScrollToTargetOptions): Promise<void>;
+export declare function scrollToTarget(t: Session, options: ScrollToTargetOptions): Promise<void>;
 /**
  * Builds a regex alternation from the inclusive from/to row numbers. The journey supplies row's formatting and regex
  * escaping; an empty range returns ''. No commands or logs.