jumpy-lion 0.1.6-beta.7 → 1.0.0-beta.0

package/dist/input/input-emulator.js

@@ -0,0 +1,325 @@
+import { log } from 'crawlee';
+import { describeChar, MODIFIER_SHIFT } from '../keyboard-layout.js';
+// --- timing / bitmask constants (moved from page.ts; input-only) ---
+const PRESS_RELEASE_DELAY_MS = 50;
+const HUMAN_KEYBOARD_DELAY_MIN_MS = 45;
+const HUMAN_KEYBOARD_DELAY_MAX_MS = 160;
+const HUMAN_MOUSE_MOVE_DELAY_MIN_MS = 6;
+const HUMAN_MOUSE_MOVE_DELAY_MAX_MS = 18;
+/** Bit values for `MouseEvent.buttons` per the UI Events spec. */
+const MOUSE_BUTTON_BITS = { left: 1, right: 2, middle: 4 };
+const sleep = async (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+// ── bezierMousePath tuning ──────────────────────────────────────────────────
+/** One path point per ~8 px of travel, clamped to [20, 80] points. */
+const MOUSE_PX_PER_STEP = 8;
+const MOUSE_MIN_STEPS = 20;
+const MOUSE_MAX_STEPS = 80;
+/**
+ * How far each control point is pushed sideways off the straight line, as a
+ * fraction of total distance. Randomised in [−FRAC, +FRAC] so the curve bows
+ * left or right by up to 30% of the distance - never a dead-straight move.
+ */
+const MOUSE_CONTROL_BIAS_FRAC = 0.3;
+/** Peak amplitude (px) of the mid-path tremor wobble. */
+const MOUSE_WOBBLE_PEAK_PX = 1.5;
+/** Uniform random in [−magnitude, +magnitude). */
+function randomSymmetric(magnitude) {
+    return (Math.random() * 2 - 1) * magnitude;
+}
+/**
+ * easeInOutCubic: slow start, fast middle, slow end - matches how an arm
+ * accelerates off rest and decelerates onto a target.
+ */
+function easeInOutCubic(t) {
+    return t < 0.5 ? 4 * t * t * t : 1 - ((-2 * t + 2) ** 3) / 2;
+}
+/** Standard cubic Bézier point: B(t) = u³·p0 + 3u²t·c1 + 3ut²·c2 + t³·p3, u = 1−t. */
+function cubicBezier(p0, c1, c2, p3, t) {
+    const u = 1 - t;
+    const w0 = u * u * u;
+    const w1 = 3 * u * u * t;
+    const w2 = 3 * u * t * t;
+    const w3 = t * t * t;
+    return {
+        x: w0 * p0.x + w1 * c1.x + w2 * c2.x + w3 * p3.x,
+        y: w0 * p0.y + w1 * c1.y + w2 * c2.y + w3 * p3.y,
+    };
+}
+/**
+ * Cubic Bézier mouse path from (fromX, fromY) to (toX, toY) in pure TypeScript -
+ * NO `Runtime.evaluate` round-trip per move (which is itself a 2026 CDP-detection
+ * signal). Two perpendicular-offset control points (±30% distance bias) bow each
+ * move unpredictably; eased-in-out timing matches arm motion; sub-pixel wobble
+ * (peaking mid-curve, under ±1.5 px) mimics pointer tremor. Returns rounded
+ * integer points; the caller dispatches one mouse event per point.
+ */
+export function bezierMousePath(fromX, fromY, toX, toY) {
+    const from = { x: fromX, y: fromY };
+    const to = { x: toX, y: toY };
+    const dx = toX - fromX;
+    const dy = toY - fromY;
+    const dist = Math.hypot(dx, dy);
+    if (dist < 1)
+        return [{ x: Math.round(toX), y: Math.round(toY) }];
+    const steps = Math.max(MOUSE_MIN_STEPS, Math.min(MOUSE_MAX_STEPS, Math.round(dist / MOUSE_PX_PER_STEP)));
+    // Unit vector perpendicular to the straight line from→to. Offsetting the
+    // control points along this normal is what bends the path sideways.
+    const perpX = -dy / dist;
+    const perpY = dx / dist;
+    // Two control points at 25% and 75% along the straight line, each shoved
+    // off the line by a random sideways bias → an organically curved path.
+    const bias1 = randomSymmetric(MOUSE_CONTROL_BIAS_FRAC * dist);
+    const bias2 = randomSymmetric(MOUSE_CONTROL_BIAS_FRAC * dist);
+    const control1 = { x: fromX + dx * 0.25 + perpX * bias1, y: fromY + dy * 0.25 + perpY * bias1 };
+    const control2 = { x: fromX + dx * 0.75 + perpX * bias2, y: fromY + dy * 0.75 + perpY * bias2 };
+    const path = [];
+    for (let i = 1; i <= steps; i++) {
+        const progress = i / steps; // 0..1 linear along the path
+        const t = easeInOutCubic(progress); // eased curve parameter
+        const point = cubicBezier(from, control1, control2, to, t);
+        // Hand tremor: largest in the middle of the move (sin peaks at progress
+        // 0.5), zero at the endpoints so we still land exactly on the target.
+        const wobble = Math.sin(Math.PI * progress) * MOUSE_WOBBLE_PEAK_PX;
+        path.push({
+            x: Math.round(point.x + randomSymmetric(wobble)),
+            y: Math.round(point.y + randomSymmetric(wobble)),
+        });
+    }
+    return path;
+}
+/**
+ * True for code points entered through an IME (Korean Hangul, Japanese
+ * Hiragana/Katakana, Chinese Han, Fullwidth/Halfwidth forms). These can't go
+ * through the rawKeyDown → char → keyUp path; Naver / Japanese IME-aware forms
+ * validate the composition event lifecycle, which plain `insertText` skips.
+ */
+export function isCjkChar(char) {
+    if (!char)
+        return false;
+    const code = char.codePointAt(0) ?? 0;
+    return ((code >= 0x3040 && code <= 0x309F)
+        || (code >= 0x30A0 && code <= 0x30FF)
+        || (code >= 0x3400 && code <= 0x4DBF)
+        || (code >= 0x4E00 && code <= 0x9FFF)
+        || (code >= 0xAC00 && code <= 0xD7AF)
+        || (code >= 0xF900 && code <= 0xFAFF)
+        || (code >= 0xFF00 && code <= 0xFFEF));
+}
+/**
+ * Deep module over {@link InputTransport}: turns high-level intents
+ * (move, click, type) into humanized sequences of transport events. Owns
+ * cursor position, the held-button bitmask, and the CJK composition lifecycle.
+ * Coordinate/text level - selector resolution is the caller's job.
+ */
+export class InputEmulator {
+    constructor(transport, humanization = {}) {
+        Object.defineProperty(this, "transport", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: transport
+        });
+        Object.defineProperty(this, "lastMousePosition", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: { x: 0, y: 0 }
+        });
+        Object.defineProperty(this, "heldMouseButtons", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "humanization", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.humanization = {
+            mouse: humanization.mouse ?? false,
+            keyboard: humanization.keyboard ?? false,
+            scroll: humanization.scroll ?? false,
+        };
+    }
+    setHumanization(options) {
+        this.humanization = {
+            mouse: options?.mouse ?? false,
+            keyboard: options?.keyboard ?? false,
+            scroll: options?.scroll ?? false,
+        };
+    }
+    /** Current cursor position (copy). */
+    get position() {
+        return { ...this.lastMousePosition };
+    }
+    buttonsBitmask() {
+        let mask = 0;
+        for (const button of this.heldMouseButtons)
+            mask += MOUSE_BUTTON_BITS[button];
+        return mask;
+    }
+    /**
+     * Move the cursor to (x, y). With mouse humanization on, follows a Bézier
+     * path with eased timing; otherwise a single `mouseMoved`.
+     */
+    async moveTo(x, y) {
+        if (!this.humanization.mouse) {
+            await this.transport.mouse({
+                type: 'mouseMoved',
+                x,
+                y,
+                buttons: this.buttonsBitmask(),
+                pointerType: 'mouse',
+            });
+            this.lastMousePosition = { x, y };
+            return;
+        }
+        const path = bezierMousePath(this.lastMousePosition.x, this.lastMousePosition.y, x, y);
+        for (const point of path) {
+            await this.transport.mouse({
+                type: 'mouseMoved',
+                x: point.x,
+                y: point.y,
+                buttons: this.buttonsBitmask(),
+                pointerType: 'mouse',
+            });
+            await sleep(HUMAN_MOUSE_MOVE_DELAY_MIN_MS
+                + Math.floor(Math.random() * (HUMAN_MOUSE_MOVE_DELAY_MAX_MS - HUMAN_MOUSE_MOVE_DELAY_MIN_MS + 1)));
+        }
+        this.lastMousePosition = { x, y };
+    }
+    /**
+     * Move to (x, y) and perform a human-like click. The held-button set is
+     * updated before each dispatch so `event.buttons` is spec-correct on
+     * mousedown (button present) and mouseup (button cleared).
+     */
+    async clickAt(x, y, options) {
+        const button = options?.button ?? 'left';
+        const clickCount = options?.clickCount ?? 1;
+        const delay = options?.delay ?? 0;
+        await this.moveTo(x, y);
+        if (delay > 0) {
+            await sleep(delay);
+        }
+        else if (this.humanization.mouse) {
+            await sleep(40 + Math.floor(Math.random() * 120));
+        }
+        this.heldMouseButtons.add(button);
+        await this.transport.mouse({
+            type: 'mousePressed',
+            x,
+            y,
+            button,
+            clickCount,
+            buttons: this.buttonsBitmask(),
+            pointerType: 'mouse',
+        });
+        await sleep(PRESS_RELEASE_DELAY_MS);
+        this.heldMouseButtons.delete(button);
+        await this.transport.mouse({
+            type: 'mouseReleased',
+            x,
+            y,
+            button,
+            clickCount,
+            buttons: this.buttonsBitmask(),
+            pointerType: 'mouse',
+        });
+        this.lastMousePosition = { x, y };
+    }
+    /**
+     * Type text at the current focus. ANSI keys go through rawKeyDown → char →
+     * keyUp; CJK characters go through the IME composition path; other Unicode
+     * falls back to insertText. Keyboard humanization adds a bimodal cadence
+     * (mostly fast, occasional "thinking" pauses).
+     */
+    async typeText(text, options) {
+        const delay = options?.delay ?? 0;
+        // Iterate CODE POINTS, not UTF-16 code units. Indexing `text[i]` split
+        // every astral character (emoji, CJK Ext-B, math alphanumerics) into two
+        // lone surrogates: `describeChar` misses them, `isCjkChar` reads the
+        // surrogate half and returns false, and each half was shipped through
+        // `insertText` separately - producing mojibake instead of the character.
+        const chars = Array.from(text);
+        for (let i = 0; i < chars.length; i++) {
+            await this.typeChar(chars[i]);
+            if (i === chars.length - 1)
+                continue;
+            if (delay > 0) {
+                await sleep(delay);
+                continue;
+            }
+            if (!this.humanization.keyboard)
+                continue;
+            if (Math.random() < 0.08) {
+                await sleep(400 + Math.floor(Math.random() * 500));
+                continue;
+            }
+            await sleep(HUMAN_KEYBOARD_DELAY_MIN_MS
+                + Math.floor(Math.random() * (HUMAN_KEYBOARD_DELAY_MAX_MS - HUMAN_KEYBOARD_DELAY_MIN_MS + 1)));
+        }
+    }
+    async typeChar(char) {
+        const mapping = describeChar(char);
+        if (!mapping) {
+            if (isCjkChar(char)) {
+                await this.typeCjkChar(char);
+            }
+            else {
+                await this.transport.text(char);
+            }
+            return;
+        }
+        const { descriptor, shift } = mapping;
+        const modifiers = shift ? MODIFIER_SHIFT : 0;
+        const text = descriptor.text ?? descriptor.key;
+        await this.transport.key({
+            type: 'rawKeyDown',
+            modifiers,
+            key: descriptor.key,
+            code: descriptor.code,
+            windowsVirtualKeyCode: descriptor.keyCode,
+            location: descriptor.location ?? 0,
+        });
+        await this.transport.key({
+            type: 'char',
+            modifiers,
+            key: descriptor.key,
+            code: descriptor.code,
+            text,
+            unmodifiedText: text,
+            windowsVirtualKeyCode: descriptor.keyCode,
+            location: descriptor.location ?? 0,
+        });
+        await this.transport.key({
+            type: 'keyUp',
+            modifiers,
+            key: descriptor.key,
+            code: descriptor.code,
+            windowsVirtualKeyCode: descriptor.keyCode,
+            location: descriptor.location ?? 0,
+        });
+    }
+    /**
+     * Type one CJK character through the IME composition path so the page sees a
+     * real `compositionstart → compositionupdate → compositionend` sequence
+     * (`imeSetComposition` starts it; `text`/insertText commits). Falls back to
+     * plain text if composition is unavailable.
+     */
+    async typeCjkChar(char) {
+        try {
+            const len = Array.from(char).length;
+            await this.transport.ime({ text: char, selectionStart: len, selectionEnd: len });
+            await this.transport.text(char);
+        }
+        catch (err) {
+            log.debug('[input] imeSetComposition unavailable, falling back to insertText', {
+                err: err.message,
+            });
+            await this.transport.text(char);
+        }
+    }
+}
+//# sourceMappingURL=input-emulator.js.map

package/dist/input/input-emulator.js.map

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

package/dist/input/input-transport.d.ts

@@ -0,0 +1,60 @@
+import type CDP from 'chrome-remote-interface';
+/**
+ * InputTransport - the narrow seam over raw CDP input dispatch.
+ *
+ * Four typed primitives, one per CDP `Input.*` call the crawler uses. This is
+ * deliberately dumb: it dispatches events and nothing else. All humanization,
+ * cursor state, button bitmasks, and IME composition *lifecycle* live above it
+ * in {@link InputEmulator}. Keeping the transport this thin is what makes the
+ * emulator testable - swap in {@link RecordingTransport} and assert the exact
+ * event sequence without a browser.
+ */
+export interface MouseEventParams {
+    type: 'mousePressed' | 'mouseReleased' | 'mouseMoved' | 'mouseWheel';
+    x: number;
+    y: number;
+    button?: 'left' | 'right' | 'middle' | 'none';
+    buttons?: number;
+    clickCount?: number;
+    pointerType?: 'mouse' | 'pen';
+    deltaX?: number;
+    deltaY?: number;
+    modifiers?: number;
+}
+export interface KeyEventParams {
+    type: 'keyDown' | 'keyUp' | 'rawKeyDown' | 'char';
+    modifiers?: number;
+    key?: string;
+    code?: string;
+    text?: string;
+    unmodifiedText?: string;
+    windowsVirtualKeyCode?: number;
+    location?: number;
+}
+export interface ImeCompositionParams {
+    text: string;
+    selectionStart: number;
+    selectionEnd: number;
+}
+export interface InputTransport {
+    mouse(params: MouseEventParams): Promise<void>;
+    key(params: KeyEventParams): Promise<void>;
+    /** Commit text directly (CDP `Input.insertText`) - fires beforeinput/input only. */
+    text(value: string): Promise<void>;
+    /** Set an ongoing IME composition (CDP `Input.imeSetComposition`). */
+    ime(params: ImeCompositionParams): Promise<void>;
+}
+/**
+ * Production adapter. Reads the live CDP client through a `getClient` accessor
+ * rather than pinning one, so a session reconnect (which swaps the underlying
+ * client) is invisible here - every dispatch hits the current connection.
+ */
+export declare class CdpInputTransport implements InputTransport {
+    private readonly getClient;
+    constructor(getClient: () => CDP.Client);
+    mouse(params: MouseEventParams): Promise<void>;
+    key(params: KeyEventParams): Promise<void>;
+    text(value: string): Promise<void>;
+    ime(params: ImeCompositionParams): Promise<void>;
+}
+//# sourceMappingURL=input-transport.d.ts.map

package/dist/input/input-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-transport.d.ts","sourceRoot":"","sources":["../../src/input/input-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;IACrE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,oFAAoF;IACpF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,sEAAsE;IACtE,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM;IAElD,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzD"}

package/dist/input/input-transport.js

@@ -0,0 +1,28 @@
+/**
+ * Production adapter. Reads the live CDP client through a `getClient` accessor
+ * rather than pinning one, so a session reconnect (which swaps the underlying
+ * client) is invisible here - every dispatch hits the current connection.
+ */
+export class CdpInputTransport {
+    constructor(getClient) {
+        Object.defineProperty(this, "getClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getClient
+        });
+    }
+    async mouse(params) {
+        await this.getClient().Input.dispatchMouseEvent(params);
+    }
+    async key(params) {
+        await this.getClient().Input.dispatchKeyEvent(params);
+    }
+    async text(value) {
+        await this.getClient().Input.insertText({ text: value });
+    }
+    async ime(params) {
+        await this.getClient().Input.imeSetComposition(params);
+    }
+}
+//# sourceMappingURL=input-transport.js.map

package/dist/input/input-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-transport.js","sourceRoot":"","sources":["../../src/input/input-transport.ts"],"names":[],"mappings":"AAmDA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC1B,YAA6B,SAA2B;QAA5C;;;;mBAAiB,SAAS;WAAkB;IAAG,CAAC;IAE5D,KAAK,CAAC,KAAK,CAAC,MAAwB;QAChC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAe,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAsB;QAC5B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAe,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACpB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAA4B;QAClC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAe,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/input/recording-transport.d.ts

@@ -0,0 +1,32 @@
+import type { ImeCompositionParams, InputTransport, KeyEventParams, MouseEventParams } from './input-transport.js';
+export type RecordedInput = {
+    kind: 'mouse';
+    params: MouseEventParams;
+} | {
+    kind: 'key';
+    params: KeyEventParams;
+} | {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'ime';
+    params: ImeCompositionParams;
+};
+/**
+ * Test adapter for {@link InputTransport}. Records every dispatched event in
+ * order so a test can assert behaviour produced by {@link InputEmulator} -
+ * button bitmasks, humanized path shape, the CJK composition lifecycle - with
+ * no browser and no CDP connection.
+ */
+export declare class RecordingTransport implements InputTransport {
+    readonly events: RecordedInput[];
+    mouse(params: MouseEventParams): Promise<void>;
+    key(params: KeyEventParams): Promise<void>;
+    text(value: string): Promise<void>;
+    ime(params: ImeCompositionParams): Promise<void>;
+    /** Ordered list of event kinds (mouse `type` for mouse/key events). */
+    sequence(): string[];
+    mouseEvents(): MouseEventParams[];
+    clear(): void;
+}
+//# sourceMappingURL=recording-transport.d.ts.map

package/dist/input/recording-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-transport.d.ts","sourceRoot":"","sources":["../../src/input/recording-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACrD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAM;IAEhC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,GAAG,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,uEAAuE;IACvE,QAAQ,IAAI,MAAM,EAAE;IAOpB,WAAW,IAAI,gBAAgB,EAAE;IAIjC,KAAK,IAAI,IAAI;CAGhB"}

package/dist/input/recording-transport.js

@@ -0,0 +1,43 @@
+/**
+ * Test adapter for {@link InputTransport}. Records every dispatched event in
+ * order so a test can assert behaviour produced by {@link InputEmulator} -
+ * button bitmasks, humanized path shape, the CJK composition lifecycle - with
+ * no browser and no CDP connection.
+ */
+export class RecordingTransport {
+    constructor() {
+        Object.defineProperty(this, "events", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+    }
+    async mouse(params) {
+        this.events.push({ kind: 'mouse', params });
+    }
+    async key(params) {
+        this.events.push({ kind: 'key', params });
+    }
+    async text(value) {
+        this.events.push({ kind: 'text', value });
+    }
+    async ime(params) {
+        this.events.push({ kind: 'ime', params });
+    }
+    /** Ordered list of event kinds (mouse `type` for mouse/key events). */
+    sequence() {
+        return this.events.map((e) => {
+            if (e.kind === 'mouse' || e.kind === 'key')
+                return e.params.type;
+            return e.kind;
+        });
+    }
+    mouseEvents() {
+        return this.events.flatMap((e) => (e.kind === 'mouse' ? [e.params] : []));
+    }
+    clear() {
+        this.events.length = 0;
+    }
+}
+//# sourceMappingURL=recording-transport.js.map

package/dist/input/recording-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-transport.js","sourceRoot":"","sources":["../../src/input/recording-transport.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACa;;;;mBAA0B,EAAE;WAAC;IAiC1C,CAAC;IA/BG,KAAK,CAAC,KAAK,CAAC,MAAwB;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAsB;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAA4B;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,uEAAuE;IACvE,QAAQ;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;gBAAE,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;YACjE,OAAO,CAAC,CAAC,IAAI,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;CACJ"}

package/dist/keyboard-layout.d.ts

@@ -3,7 +3,7 @@
  * with realistic `code` / `key` / `keyCode` / `text` / `modifiers` values.
  *
  * Without these, CDP-driven key events arrive at the page with `event.code === ''`
- * and `event.keyCode === 0` — a one-line bot signal that anti-bot SDKs check on
+ * and `event.keyCode === 0` - a one-line bot signal that anti-bot SDKs check on
  * every keystroke.
  *
  * Modeled on Puppeteer's USKeyboardLayout (Apache-2). Trimmed to printable ASCII
@@ -33,7 +33,7 @@ interface CharMapping {
 }
 /**
  * Look up the CDP key descriptor for a single character. Returns null for
- * characters outside the US ANSI printable set (Unicode, emoji, IME chars) —
+ * characters outside the US ANSI printable set (Unicode, emoji, IME chars) -
  * callers should fall back to `Input.insertText` for those.
  *
  * Newlines map to Enter, tabs map to Tab.

package/dist/keyboard-layout.js

@@ -3,7 +3,7 @@
  * with realistic `code` / `key` / `keyCode` / `text` / `modifiers` values.
  *
  * Without these, CDP-driven key events arrive at the page with `event.code === ''`
- * and `event.keyCode === 0` — a one-line bot signal that anti-bot SDKs check on
+ * and `event.keyCode === 0` - a one-line bot signal that anti-bot SDKs check on
  * every keystroke.
  *
  * Modeled on Puppeteer's USKeyboardLayout (Apache-2). Trimmed to printable ASCII
@@ -123,7 +123,7 @@ const SPECIAL_KEYS = {
 };
 /**
  * Look up the CDP key descriptor for a single character. Returns null for
- * characters outside the US ANSI printable set (Unicode, emoji, IME chars) —
+ * characters outside the US ANSI printable set (Unicode, emoji, IME chars) -
  * callers should fall back to `Input.insertText` for those.
  *
  * Newlines map to Enter, tabs map to Tab.

package/dist/navigation/page-navigation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * PageNavigation - the deep module beside NetworkWatch/ElementTarget that owns
+ * the navigation + load-wait protocol: enable Page, fire navigate/reload, race
+ * `domContentEventFired` / `loadEventFired` against a timeout, then reconcile
+ * the landed URL via `getNavigationHistory` (NOT `Runtime.evaluate`, which is a
+ * CDP detection vector). It also caches the last reconciled URL so `url()` can
+ * answer without re-hitting CDP.
+ *
+ * Talks to the page only through the narrow `NavigationPort`, so the whole
+ * protocol is unit-testable with a scripted port - no `new CdpPage(...)` and no
+ * fake CDP client. `CdpPage.goto` / `reload` / `url` are thin delegates and the
+ * `loadedUrl` state lives here, not on the god object.
+ *
+ * The URL reconcile prefers `getNavigationHistory` (Page domain only) and falls
+ * back to `evaluateUrl` (Runtime) only when history is unavailable.
+ */
+export interface GotoOptions {
+    waitUntil?: 'domcontentloaded' | 'load';
+    timeout?: number;
+}
+export interface NavigationHistory {
+    currentIndex: number;
+    entries: {
+        url: string;
+    }[];
+}
+/**
+ * The narrow seam over the page's CDP surface that navigation needs. The
+ * production adapter wraps the live CDP client (read through the PageSession
+ * accessor so a reconnect swap is picked up); the test adapter is scripted.
+ */
+export interface NavigationPort {
+    /** Lazily enable the Page domain (a CDP detection-surface concern owned by the page). */
+    enablePage(): Promise<void>;
+    navigate(url: string): Promise<void>;
+    reload(): Promise<void>;
+    /** Subscribe to the DOMContentLoaded event; returns an unsubscribe fn the caller MUST invoke. */
+    onDomContent(handler: () => void): () => void;
+    /** Subscribe to the load event; returns an unsubscribe fn the caller MUST invoke. */
+    onLoad(handler: () => void): () => void;
+    navigationHistory(): Promise<NavigationHistory>;
+    /** Runtime fallback for the current URL when navigation history is unavailable. */
+    evaluateUrl(): Promise<string>;
+}
+export declare class PageNavigation {
+    private readonly port;
+    private loadedUrl;
+    constructor(port: NavigationPort);
+    /** Last reconciled URL, or - before any navigation - the live URL from CDP. */
+    url(): Promise<string>;
+    /** Navigate to `url`, wait for the requested load milestone, reconcile the landed URL. */
+    goto(url: string, options?: GotoOptions): Promise<void>;
+    /** Reload the current page, wait for the requested load milestone, reconcile the landed URL. */
+    reload(options?: GotoOptions): Promise<void>;
+    /**
+     * Race the requested load event against the timeout. Resolves when the
+     * event fires; rejects with `timeoutMessage` once the timeout elapses.
+     */
+    private waitForLoad;
+    /**
+     * Resolve the current URL without activating the Runtime domain when
+     * possible: `getNavigationHistory` needs only the Page domain. Falls back
+     * to a Runtime evaluation only when history is empty or unavailable.
+     */
+    private currentUrl;
+}
+//# sourceMappingURL=page-navigation.d.ts.map

package/dist/navigation/page-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-navigation.d.ts","sourceRoot":"","sources":["../../src/navigation/page-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,yFAAyF;IACzF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,iGAAiG;IACjG,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9C,qFAAqF;IACrF,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACxC,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,mFAAmF;IACnF,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAID,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,IAAI,EAAE,cAAc;IAIhC,+EAA+E;IACzE,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5B,0FAA0F;IACpF,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7D,gGAAgG;IAC1F,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;;OAGG;YACW,WAAW;IAqCzB;;;;OAIG;YACW,UAAU;CAY3B"}