autokap 1.0.7 → 1.0.10

package/dist/web-playwright-local.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Capture Agent — WebPlaywrightLocal RuntimeAdapter
+ *
+ * Thin adapter delegating to the existing Browser class from src/browser.ts.
+ * This is the first (and for now only) RuntimeAdapter implementation.
+ */
+import type { Browser } from './browser.js';
+import type { AKTree, VideoPageSignals } from './types.js';
+import type { RuntimeAdapter, ClickOptions, WaitCondition, RecordingOptions, RecordingResult, SemanticTarget } from './execution-types.js';
+import { type ResolveOptions } from './semantic-resolver.js';
+export declare class WebPlaywrightLocal implements RuntimeAdapter {
+    private browser;
+    private recordingDir?;
+    private readonly sessionStartedAt;
+    private recording;
+    private clipCursor;
+    constructor(browser: Browser, recordingDir?: string | undefined);
+    navigate(url: string): Promise<void>;
+    getCurrentUrl(): Promise<string>;
+    getAKTree(): Promise<AKTree>;
+    getPageSignals(): Promise<VideoPageSignals>;
+    click(selector: string, options?: ClickOptions): Promise<void>;
+    /**
+     * Click an element using semantic target resolution.
+     * Tries CSS selector first, falls back to Playwright semantic locators.
+     */
+    clickByTarget(opts: ResolveOptions): Promise<void>;
+    /**
+     * Type into an element using semantic target resolution.
+     */
+    typeByTarget(opts: ResolveOptions, text: string, clearFirst?: boolean): Promise<void>;
+    /**
+     * Wait for an element using semantic target resolution.
+     */
+    waitForTarget(opts: ResolveOptions, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Scroll an element into view using semantic target resolution.
+     */
+    scrollIntoViewByTarget(opts: ResolveOptions): Promise<void>;
+    type(selector: string, text: string, clearFirst?: boolean): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    scroll(direction: 'up' | 'down' | 'left' | 'right', amount?: number): Promise<void>;
+    scrollIntoView(selector: string): Promise<void>;
+    waitFor(condition: WaitCondition): Promise<boolean>;
+    dismissOverlays(): Promise<{
+        dismissed: boolean;
+        method: string | null;
+    }>;
+    takeScreenshot(): Promise<Buffer>;
+    takeElementScreenshot(selector: string): Promise<Buffer>;
+    takeCleanScreenshot(): Promise<Buffer>;
+    beginRecording(options: RecordingOptions): Promise<void>;
+    endRecording(): Promise<RecordingResult>;
+    setLocale(locale: string): Promise<void>;
+    setColorScheme(scheme: 'light' | 'dark'): Promise<void>;
+    reloadPage(): Promise<void>;
+    writeStorageHint(params: {
+        storage: 'localStorage' | 'sessionStorage' | 'cookie';
+        key: string;
+        value: string;
+        kind: 'locale' | 'theme';
+    }): Promise<boolean>;
+    hover(selector: string): Promise<void>;
+    hoverByTarget(opts: ResolveOptions): Promise<void>;
+    selectOption(selector: string, option: {
+        label?: string;
+        value?: string;
+        index?: number;
+    }): Promise<void>;
+    check(selector: string, checked: boolean): Promise<void>;
+    doubleClick(selector: string): Promise<void>;
+    drag(opts: {
+        selector?: string;
+        target?: SemanticTarget;
+        selectorAlternates?: string[];
+        toSelector?: string;
+        toTarget?: SemanticTarget;
+        toSelectorAlternates?: string[];
+        offset?: {
+            dx: number;
+            dy: number;
+        };
+    }): Promise<void>;
+    cloneElement(opts: {
+        sourceSelector: string;
+        containerSelector: string;
+        count: number;
+        removeSource?: boolean;
+    }): Promise<{
+        clonedCount: number;
+    }>;
+    setAttribute(opts: {
+        selector: string;
+        attribute: string;
+        value: string;
+    }): Promise<void>;
+    setTextContent(opts: {
+        selector: string;
+        text: string;
+    }): Promise<void>;
+    removeElement(opts: {
+        selector: string;
+    }): Promise<{
+        removedCount: number;
+    }>;
+    setInputValue(opts: {
+        selector: string;
+        value: string;
+    }): Promise<void>;
+    clickHidden(opts: {
+        selector: string;
+    }): Promise<void>;
+    serializeDom(selector?: string): Promise<{
+        html: string;
+        assetUrls: string[];
+        viewport: {
+            width: number;
+            height: number;
+        };
+        capturedAt: string;
+    }>;
+    serializeFragment(selector: string): Promise<{
+        html: string;
+        assetUrls: string[];
+        capturedAt: string;
+    }>;
+    extractFavicon(): Promise<{
+        buffer: Buffer;
+        mimeType: string;
+    } | null>;
+    close(): Promise<void>;
+    private typeIntoLocator;
+    private seedClipCursor;
+    private moveClipCursorToViewportCenter;
+    /**
+     * Animate the cursor to a point inside `locator` and return that point so
+     * the caller can click at the SAME coordinates (via
+     * `locator.click({ position })`). Returning the target avoids the "snap"
+     * bug where Playwright's default click recentered the mouse after the
+     * human-like Bezier landed somewhere off-center.
+     *
+     * Returns null when the cursor overlay is disabled, when the element has
+     * no bounding box, or when the cursor is already inside the element (no
+     * move needed, caller should let Playwright click at its default center).
+     */
+    private moveClipCursorToLocator;
+    /**
+     * Convert an absolute viewport point to a position relative to `locator`'s
+     * bounding box, suitable for `locator.click({ position })`. Returns null
+     * if the point is outside the box (defensive fallback — callers should
+     * then let Playwright click at the default center).
+     */
+    private relativeClickPosition;
+    private moveClipCursorToPoint;
+    private emitClipClickPulse;
+}