autokap 1.0.7 → 1.0.8

package/dist/browser.d.ts

@@ -1,5 +1,5 @@
 import { type BrowserContext, type Page } from 'playwright';
-import type { BrowserOptions, BrowserSessionStorageState, BrowserStorageState, InteractiveElement, ObservedRequest, OutscaleConfig, PageState, PageStateLite, ResolvedMock, SelectorValidationResult, VideoPageSignals } from './types.js';
+import type { AKNode, AKNodeRuntimeIndexEntry, AKTree, BrowserOptions, BrowserSessionStorageState, BrowserStorageState, InteractiveElement, ObservedRequest, OutscaleConfig, PageState, PageStateLite, ResolvedMock, SelectorValidationResult, VideoPageSignals } from './types.js';
 export interface SelectorCaptureError {
     error: 'no_match' | 'ambiguous' | 'invisible' | 'zero_size';
     errorMessage: string;
@@ -46,6 +46,13 @@ export interface BrowserObservation {
     expandedCount: number;
     loadingIndicatorCount: number;
     textSample: string;
+    surfaceSignature: string;
+    primarySurface: string;
+    overlaySurface: string | null;
+    navigationSurface: string;
+    configurationSurface: string | null;
+    hasBlockingOverlay: boolean;
+    strongSurfaceSignature: string;
 }
 export interface BrowserReaction {
     before: BrowserObservation;
@@ -90,6 +97,7 @@ export declare class Browser {
     private context;
     private page;
     private elementMap;
+    private akNodeIndex;
     private poolContext;
     constructor(options: BrowserOptions);
     /**
@@ -117,6 +125,10 @@ export declare class Browser {
      */
     closeContext(): Promise<void>;
     launch(): Promise<void>;
+    /** Wires debug-only lifecycle listeners on the page/context/browser to surface
+     *  navigations, console errors, page crashes, and unexpected closures.
+     *  No-op when debug logging is disabled. */
+    private attachDebugLifecycleListeners;
     recreateContext(options?: Partial<Pick<BrowserOptions, 'viewport' | 'deviceScaleFactor' | 'lang' | 'colorScheme' | 'storageState'>>): Promise<void>;
     setDeviceScaleFactor(deviceScaleFactor: number): Promise<void>;
     addCookies(cookies: Array<{
@@ -151,6 +163,19 @@ export declare class Browser {
      * Returns clean indented HTML-like text, budget-capped at ~4000 chars.
      */
     getSimplifiedDOM(): Promise<string>;
+    private mapRawNodeType;
+    private convertRawNode;
+    private shouldCollapseNode;
+    private collapseNode;
+    private collectFingerprintEntries;
+    private assignFingerprints;
+    private applyTraitAnnotations;
+    private findFirstPattern;
+    private flattenNodes;
+    private annotateSemanticPatterns;
+    private computeOverlays;
+    private normalizeRawSnapshot;
+    getAKTree(): Promise<AKTree>;
     getPageState(opts?: {
         skipAnnotation?: boolean;
     }): Promise<PageState>;
@@ -188,6 +213,7 @@ export declare class Browser {
     }): Promise<BrowserReaction>;
     private computeVisibilityState;
     private getVisiblePoint;
+    private runClickHitTest;
     private withResolvedLocator;
     private measureElement;
     private ensureElementInView;
@@ -213,7 +239,12 @@ export declare class Browser {
     clickBySelector(selector: string, options?: {
         force?: boolean;
     }): Promise<void>;
+    private resolveActivationTarget;
+    private activateSelectorTarget;
     clickByCoordinates(x: number, y: number): Promise<void>;
+    private buildElementSnapshotFromAKEntry;
+    private activateAKNodeEntry;
+    private clickAKNodeEntryByBounds;
     typeText(text: string, options?: {
         index?: number;
         selector?: string;
@@ -227,6 +258,10 @@ export declare class Browser {
         optionIndex?: number;
     }): Promise<void>;
     scroll(direction: string, amount?: number, selector?: string): Promise<void>;
+    centerNodeInView(centerNodeId: string, options?: {
+        containerNodeId?: string;
+        offset?: number;
+    }): Promise<void>;
     pressKey(key: string): Promise<void>;
     searchText(query: string): Promise<Array<{
         tag: string;
@@ -265,6 +300,21 @@ export declare class Browser {
         width: number;
         height: number;
     }, outscale?: OutscaleConfig | number): Promise<Buffer>;
+    resolveAKNode(nodeId: string, options?: {
+        reparse?: boolean;
+    }): Promise<AKNodeRuntimeIndexEntry | null>;
+    tapNode(nodeId: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    typeIntoNode(nodeId: string, text: string, options?: {
+        clearFirst?: boolean;
+    }): Promise<void>;
+    captureNode(nodeId?: string): Promise<Buffer>;
+    focusTree(query: import('./types.js').FocusQuery): Promise<{
+        tree: AKTree;
+        serialized: string;
+        matches: AKNode[];
+    }>;
     wait(ms: number): Promise<void>;
     /**
      * Force-load all lazy-loaded images on the page before element capture.