screenci 0.0.21 → 0.0.22

package/dist/src/autoZoom.d.ts

@@ -1,21 +1,40 @@
 import type { ElementRect, IEventRecorder } from './events.js';
-import type { AutoZoomOptions, Easing } from './types.js';
-export type ZoomLocation = {
-    x: number;
-    y: number;
-    elementRect: ElementRect;
-    eventType: 'click' | 'fill';
+import type { AutoZoomOptions } from './types.js';
+export type CurrentZoomViewport = {
+    focusPoint: {
+        x: number;
+        y: number;
+    };
+    elementRect?: ElementRect;
+    end: {
+        pointPx: {
+            x: number;
+            y: number;
+        };
+        size: {
+            widthPx: number;
+            heightPx: number;
+        };
+    };
+    optimalOffset?: {
+        x: number;
+        y: number;
+    };
+    viewportSize: {
+        width: number;
+        height: number;
+    };
 };
 export declare function setActiveAutoZoomRecorder(recorder: IEventRecorder | null): void;
-export declare function isInsideAutoZoom(): boolean;
-export declare function getZoomDuration(): number | null;
-export declare function getZoomEasing(): Easing | null;
-export declare function getZoomAmount(): number | null;
-export declare function getZoomCentering(): number | null;
-export declare function getAllowZoomingOut(): boolean | null;
-export declare function getPostZoomInOutDelay(): number | null;
-export declare function getLastZoomLocation(): ZoomLocation | null;
-export declare function setLastZoomLocation(loc: ZoomLocation | null): void;
+export declare function getCurrentZoomViewport(): CurrentZoomViewport | null;
+export type AutoZoomState = {
+    insideAutoZoom: boolean;
+    options: AutoZoomOptions;
+    currentZoomViewport: CurrentZoomViewport | null;
+};
+export declare function getAutoZoomState(): AutoZoomState;
+export declare function setAutoZoomState(state: AutoZoomState): void;
+export declare function setCurrentZoomViewport(viewport: CurrentZoomViewport | null): void;
 /**
  * Zooms the camera in on interactions inside `fn`, panning to follow each
  * click and fill. After `fn` resolves the camera zooms back out.

package/dist/src/autoZoom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoZoom.d.ts","sourceRoot":"","sources":["../../src/autoZoom.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEzD,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B,CAAA;AAYD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,IAAI,CAEN;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,GAAG,IAAI,CAEnD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,mBAAmB,IAAI,YAAY,GAAG,IAAI,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAaD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"autoZoom.d.ts","sourceRoot":"","sources":["../../src/autoZoom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,YAAY,CAAA;AAezD,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,GAAG,EAAE;QACH,OAAO,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACjC,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAC5C,CAAA;IACD,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAChD,CAAA;AASD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,IAAI,CAEN;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,OAAO,CAAA;IACvB,OAAO,EAAE,eAAe,CAAA;IACxB,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,CAAA;CAChD,CAAA;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GACnC,IAAI,CAKN;AAeD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAgFf"}

package/dist/src/autoZoom.js

@@ -1,50 +1,49 @@
-import { DEFAULT_ZOOM_DURATION, DEFAULT_ZOOM_EASING, DEFAULT_POST_ZOOM_IN_OUT_DELAY, } from './defaults.js';
+import { DEFAULT_ZOOM_OPTIONS } from './defaults.js';
+import { invalidOptionError, ScreenciError } from './errors.js';
+function assertAutoZoomUnitIntervalOption(value, name) {
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw invalidOptionError({
+            api: 'autoZoom',
+            option: name,
+            expectation: 'must be between 0 and 1',
+            value,
+        });
+    }
+}
 let activeRecorder = null;
-let insideAutoZoom = false;
-let currentZoomDuration = null;
-let currentZoomEasing = null;
-let currentZoomAmount = null;
-let currentZoomCentering = null;
-let currentAllowZoomingOut = null;
-let currentPostZoomInOutDelay = null;
-let lastZoomLocation = null;
+let currentAutoZoomState = {
+    insideAutoZoom: false,
+    options: {},
+    currentZoomViewport: null,
+};
 export function setActiveAutoZoomRecorder(recorder) {
     activeRecorder = recorder;
 }
-export function isInsideAutoZoom() {
-    return insideAutoZoom;
-}
-export function getZoomDuration() {
-    return currentZoomDuration;
-}
-export function getZoomEasing() {
-    return currentZoomEasing;
-}
-export function getZoomAmount() {
-    return currentZoomAmount;
-}
-export function getZoomCentering() {
-    return currentZoomCentering;
+export function getCurrentZoomViewport() {
+    return currentAutoZoomState.currentZoomViewport;
 }
-export function getAllowZoomingOut() {
-    return currentAllowZoomingOut;
+export function getAutoZoomState() {
+    return currentAutoZoomState;
 }
-export function getPostZoomInOutDelay() {
-    return currentPostZoomInOutDelay;
+export function setAutoZoomState(state) {
+    currentAutoZoomState = state;
 }
-export function getLastZoomLocation() {
-    return lastZoomLocation;
-}
-export function setLastZoomLocation(loc) {
-    lastZoomLocation = loc;
+export function setCurrentZoomViewport(viewport) {
+    setAutoZoomState({
+        ...currentAutoZoomState,
+        currentZoomViewport: viewport,
+    });
 }
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function resolveCenteringValue(centering) {
-    if (centering === undefined)
-        return undefined;
-    return centering;
+function resetAutoZoomState() {
+    setAutoZoomState({
+        ...currentAutoZoomState,
+        insideAutoZoom: false,
+        options: {},
+        currentZoomViewport: null,
+    });
 }
 /**
  * Zooms the camera in on interactions inside `fn`, panning to follow each
@@ -71,47 +70,79 @@ function resolveCenteringValue(centering) {
  * ```
  */
 export async function autoZoom(fn, options) {
-    if (insideAutoZoom) {
-        throw new Error('Cannot nest autoZoom() calls');
+    if (currentAutoZoomState.insideAutoZoom) {
+        throw new ScreenciError('Cannot nest autoZoom() calls');
     }
     if (activeRecorder !== null) {
         activeRecorder.addAutoZoomStart(options);
     }
-    const zoomStartTime = Date.now();
-    insideAutoZoom = true;
-    currentZoomDuration = options?.duration ?? DEFAULT_ZOOM_DURATION;
-    currentZoomEasing = (options?.easing ?? DEFAULT_ZOOM_EASING);
-    currentZoomAmount = options?.amount ?? null;
-    currentZoomCentering = resolveCenteringValue(options?.centering) ?? null;
-    currentAllowZoomingOut = options?.allowZoomingOut ?? null;
-    currentPostZoomInOutDelay =
-        options?.postZoomInOutDelay ?? DEFAULT_POST_ZOOM_IN_OUT_DELAY;
+    const resolvedOptions = {
+        ...DEFAULT_ZOOM_OPTIONS,
+        ...(options ?? {}),
+    };
+    assertAutoZoomUnitIntervalOption(resolvedOptions.amount, 'amount');
+    assertAutoZoomUnitIntervalOption(resolvedOptions.centering, 'centering');
+    setAutoZoomState({
+        ...currentAutoZoomState,
+        insideAutoZoom: true,
+        options: {
+            duration: resolvedOptions.duration,
+            easing: resolvedOptions.easing,
+            amount: resolvedOptions.amount,
+            ...(options?.centering !== undefined
+                ? { centering: options.centering }
+                : {}),
+            preZoomDelay: resolvedOptions.preZoomDelay,
+            postZoomDelay: resolvedOptions.postZoomDelay,
+        },
+    });
     try {
         await fn();
+        if (activeRecorder !== null) {
+            activeRecorder.addAutoZoomEnd(options);
+            if (currentAutoZoomState.currentZoomViewport !== null) {
+                const zoomOutStartMs = Date.now();
+                activeRecorder.addInput('focusChange', undefined, [
+                    {
+                        type: 'focusChange',
+                        startMs: zoomOutStartMs,
+                        endMs: zoomOutStartMs +
+                            (currentAutoZoomState.options.duration ??
+                                DEFAULT_ZOOM_OPTIONS.duration),
+                        x: currentAutoZoomState.currentZoomViewport.focusPoint.x,
+                        y: currentAutoZoomState.currentZoomViewport.focusPoint.y,
+                        ...(currentAutoZoomState.currentZoomViewport.elementRect !==
+                            undefined
+                            ? {
+                                elementRect: currentAutoZoomState.currentZoomViewport.elementRect,
+                            }
+                            : {}),
+                        zoom: {
+                            startMs: zoomOutStartMs,
+                            endMs: zoomOutStartMs +
+                                (currentAutoZoomState.options.duration ??
+                                    DEFAULT_ZOOM_OPTIONS.duration),
+                            easing: currentAutoZoomState.options.easing ??
+                                DEFAULT_ZOOM_OPTIONS.easing,
+                            end: {
+                                pointPx: { x: 0, y: 0 },
+                                size: {
+                                    widthPx: currentAutoZoomState.currentZoomViewport.viewportSize.width,
+                                    heightPx: currentAutoZoomState.currentZoomViewport.viewportSize
+                                        .height,
+                                },
+                            },
+                        },
+                    },
+                ]);
+            }
+        }
+        if ((currentAutoZoomState.options.postZoomDelay ?? 0) > 0) {
+            await sleep(currentAutoZoomState.options.postZoomDelay ?? 0);
+        }
     }
     finally {
-        insideAutoZoom = false;
-        lastZoomLocation = null;
-        currentZoomDuration = null;
-        currentZoomEasing = null;
-        currentZoomAmount = null;
-        currentZoomCentering = null;
-        currentAllowZoomingOut = null;
-        currentPostZoomInOutDelay = null;
-    }
-    const duration = options?.duration ?? DEFAULT_ZOOM_DURATION;
-    const postZoomInOutDelay = options?.postZoomInOutDelay ?? DEFAULT_POST_ZOOM_IN_OUT_DELAY;
-    const elapsed = Date.now() - zoomStartTime;
-    const remaining = duration + postZoomInOutDelay - elapsed;
-    if (remaining > 0) {
-        await sleep(remaining);
-    }
-    if (activeRecorder !== null) {
-        activeRecorder.addAutoZoomEnd(options);
-    }
-    const postEndDelay = duration + postZoomInOutDelay;
-    if (postEndDelay > 0) {
-        await sleep(postEndDelay);
+        resetAutoZoomState();
     }
 }
 //# sourceMappingURL=autoZoom.js.map

package/dist/src/autoZoom.js.map

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

package/dist/src/changeFocus.d.ts

@@ -0,0 +1,129 @@
+import type { Locator } from '@playwright/test';
+import type { ElementRect, FocusChangeEvent } from './events.js';
+import type { AutoZoomOptions, Easing } from './types.js';
+type ScrollRectLike = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+};
+export type MouseMoveRequest = {
+    targetPosInElement?: {
+        x: number;
+        y: number;
+    } | undefined;
+    duration?: number;
+    speed?: number;
+    easing: Easing;
+};
+type ViewportSize = {
+    width: number;
+    height: number;
+};
+type Point = {
+    x: number;
+    y: number;
+};
+type FocusSnapshot = {
+    locatorRect: ElementRect;
+    viewportSize: ViewportSize;
+    page: {
+        scrollY: number;
+        scrollX: number;
+        scrollHeight: number;
+        scrollWidth: number;
+    };
+    ancestors: Array<{
+        clientHeight: number;
+        clientWidth: number;
+        scrollHeight: number;
+        scrollWidth: number;
+        scrollTop: number;
+        scrollLeft: number;
+        rect: ScrollRectLike;
+    }>;
+};
+type ScrollPlan = {
+    startTop: number;
+    startLeft: number;
+    targetTop: number;
+    targetLeft: number;
+};
+type PageScrollPlan = {
+    startY: number;
+    startX: number;
+    targetY: number;
+    targetX: number;
+};
+type AxisRange = {
+    min: number;
+    max: number;
+};
+type UnifiedFocusPlan = {
+    finalLocatorRect: ElementRect;
+    ancestorScrollPlans: ScrollPlan[];
+    pageScrollPlan: PageScrollPlan;
+    scrollNeeded: boolean;
+    zoomNeeded: boolean;
+    finalFocusPoint: Point;
+    optimalOffset: Point;
+};
+type ScrollAndZoomTimingPlan = {
+    startDelay: number;
+    duration: number;
+};
+export declare function resolveFixedFocusViewportSize(viewport: ViewportSize, amount: number): ViewportSize;
+export declare function resolveIdealFocusOriginForAxis(params: {
+    rectStart: number;
+    rectSize: number;
+    focusSize: number;
+    centering: number;
+}): number;
+export declare function resolveIdealFocusOrigin(rect: ElementRect, focusViewport: ViewportSize, centering: number): Point;
+export declare function resolveOptimalOffset(ideal: Point, actual: Point): Point;
+export declare function resolveScrollAndZoomTimingPlan(params: {
+    viewportSize: ViewportSize;
+    target: Point;
+    startViewportPos: Point;
+    duration: number;
+    easing: Easing;
+    cursorTriggerEdgeThreshold: number;
+    cursorTriggerMaxProgress: number;
+}): ScrollAndZoomTimingPlan;
+export declare function resolveTargetRectPosition(params: {
+    containerSize: ViewportSize;
+    rect: ElementRect;
+    amount: number;
+    centering: number;
+}): Point;
+export declare function buildAncestorScrollPlans(params: {
+    snapshot: FocusSnapshot;
+    projectedRectRangeX: AxisRange;
+    projectedRectRangeY: AxisRange;
+}): {
+    plans: ScrollPlan[];
+    accumulatedDelta: Point;
+    projectedRect: ElementRect;
+};
+export declare function buildPageScrollPlan(snapshot: FocusSnapshot, ancestorProjection: {
+    accumulatedDelta: Point;
+    projectedRect: ElementRect;
+}, options: {
+    targetRectPositionInViewport: Point;
+    residualOnly?: {
+        x: number;
+        y: number;
+    };
+}): {
+    plan: PageScrollPlan;
+    finalLocatorRect: ElementRect;
+};
+export declare function combineFocusPlan(params: {
+    snapshot: FocusSnapshot;
+    amount: number;
+    centering: number;
+    currentZoomEnd: NonNullable<FocusChangeEvent['zoom']>['end'];
+}): UnifiedFocusPlan;
+export declare function changeFocus(locator: Locator, options?: AutoZoomOptions, mouseMove?: MouseMoveRequest): Promise<FocusChangeEvent>;
+export {};
+//# sourceMappingURL=changeFocus.d.ts.map

package/dist/src/changeFocus.d.ts.map

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