@ulpi/browse 2.3.3 → 2.4.0

package/dist/types/browser/events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser event wiring helpers.
+ *
+ * The wirePageEvents() method that wires console, network, dialog, and ref-
+ * invalidation events cannot be extracted as a standalone function because it
+ * closes over many BrowserManager private fields:
+ *   - buffers (SessionBuffers) — console/network ring buffers
+ *   - lastDialog / autoDialogAction / dialogPromptValue — dialog state
+ *   - requestEntryMap (WeakMap) — request → NetworkEntry correlation
+ *   - refTabId / refMap / clearRefs() — ref scoping + invalidation
+ *   - getTabIdForPage() — reverse tab lookup
+ *
+ * TODO: When BrowserManager is decomposed into smaller collaborating objects
+ * (e.g. a DialogManager, a NetworkRecorder, a RefRegistry), move the
+ * corresponding event handlers here.
+ *
+ * For now this module serves as the documentation anchor for that future work.
+ */
+//# sourceMappingURL=events.d.ts.map

package/dist/types/browser/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/browser/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/types/browser/index.d.ts

@@ -0,0 +1,17 @@
+export { BrowserManager, type CoverageEntry, } from './manager';
+export type { BrowserTarget } from './target';
+export { resolveDevice, listDevices, DEVICE_ALIASES, CUSTOM_DEVICES, type DeviceDescriptor, } from './emulation';
+export { getProfileDir, listProfiles, deleteProfile, } from './profiles';
+export { TabManager, type TabEntry } from './tabs';
+export { RefManager } from './refs';
+export { handleSnapshot, parseSnapshotArgs, type SnapshotOptions, } from './snapshot';
+export { expandMacro, listMacros } from './macros';
+export { ensureHook, injectHook, removeHook, isEnabled, requireEnabled, requireReact, getTree, getProps, getSuspense, getErrors, getProfiler, getHydration, getRenders, getOwners, getContext, } from './react-devtools';
+export { isGoogleSearchUrl, isGoogleBlocked, formatGoogleBlockError } from './detection';
+export { dismissConsentDialog } from './consent';
+export { waitForPageReady, type ReadinessOptions } from './readiness';
+export { applySnapshotWindow, formatWindowMetadata, type WindowResult } from './snapshot-window';
+export { isGoogleSerp, extractGoogleSerp } from './serp';
+export { parseNetscapeCookieFile } from './cookie-import';
+export { detectYtDlp, hasYtDlp, extractVideoId, ytDlpTranscript, parseJson3, parseVtt, parseXml, } from './youtube';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EACL,WAAW,EACX,QAAQ,EACR,cAAc,EACd,eAAe,EACf,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,WAAW,CAAC"}

package/dist/types/browser/macros.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Search macros — expand @macro_name + query into search URLs.
+ * Runtime-agnostic. Used by goto handler to support `browse goto @google "query"`.
+ */
+/** Expand a macro URL. Returns the expanded URL or null if not a macro. */
+export declare function expandMacro(url: string): string | null;
+/** List all supported macro names. */
+export declare function listMacros(): string[];
+//# sourceMappingURL=macros.d.ts.map

package/dist/types/browser/macros.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"macros.d.ts","sourceRoot":"","sources":["../../../src/browser/macros.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtD;AAED,sCAAsC;AACtC,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC"}

package/dist/types/browser/manager.d.ts

@@ -0,0 +1,272 @@
+/**
+ * Browser lifecycle manager
+ *
+ * Chromium crash handling:
+ *   browser.on('disconnected') → log error → process.exit(1)
+ *   CLI detects dead server → auto-restarts on next command
+ *   We do NOT try to self-heal — don't hide failure.
+ */
+import { type Browser, type BrowserContext, type BrowserType, type Page, type Locator, type Frame, type FrameLocator } from 'playwright';
+import { SessionBuffers } from '../network/buffers';
+import type { HarRecording } from '../network/har';
+import type { DomainFilter } from '../security/domain-filter';
+import type { TargetCapabilities } from '../automation/target';
+import type { BrowserTarget } from './target';
+import { resolveDevice, listDevices, type DeviceDescriptor } from './emulation';
+import { getProfileDir, listProfiles, deleteProfile } from './profiles';
+export type { DeviceDescriptor };
+export { resolveDevice, listDevices, getProfileDir, listProfiles, deleteProfile };
+export interface CoverageEntry {
+    url: string;
+    totalBytes: number;
+    usedBytes: number;
+    unusedBytes: number;
+    unusedPct: number;
+}
+export declare class BrowserManager implements BrowserTarget {
+    readonly targetType = "browser";
+    private browser;
+    private context;
+    private extraHeaders;
+    private customUserAgent;
+    private currentDevice;
+    private tabs;
+    private refs;
+    private activeFramePerTab;
+    private buffers;
+    private lastDialog;
+    private autoDialogAction;
+    private dialogPromptValue;
+    private requestEntryMap;
+    private offline;
+    private harRecording;
+    private videoRecording;
+    private coverageActive;
+    private captureNetworkBodies;
+    /** Per-session byte budget for captured response bodies (default 5MB) */
+    private bodyBudgetBytes;
+    private bodyBudgetUsed;
+    /** Per-entry body size limit (default 256KB) */
+    private bodyLimitBytes;
+    private initScript;
+    private userRoutes;
+    private domainFilter;
+    private ownsBrowser;
+    private isPersistent;
+    private contextProxy;
+    private isHeaded;
+    private consecutiveFailures;
+    private onCrashCallback;
+    constructor(buffers?: SessionBuffers);
+    getBuffers(): SessionBuffers;
+    getBrowser(): Browser | null;
+    getContext(): BrowserContext | null;
+    /**
+     * Launch a new Chromium browser (single-session / multi-process mode).
+     * This instance owns the browser and will close it on close().
+     */
+    launch(onCrash?: () => void): Promise<void>;
+    /**
+     * Attach to an existing Browser instance (session multiplexing mode).
+     * Creates a new BrowserContext on the shared browser.
+     * This instance does NOT own the browser — close() only closes the context.
+     */
+    launchWithBrowser(browser: Browser, reuseContext?: boolean, contextOptions?: {
+        proxy?: {
+            server: string;
+            username?: string;
+            password?: string;
+        };
+    }): Promise<void>;
+    /**
+     * Launch with a persistent browser profile directory.
+     * Data (cookies, localStorage, cache) persists across restarts.
+     * The context IS the browser — closing it closes everything.
+     */
+    launchPersistent(profileDir: string, onCrash?: () => void, browserType?: BrowserType, extraLaunchOptions?: Record<string, unknown>): Promise<void>;
+    close(): Promise<void>;
+    isHealthy(): boolean;
+    getCapabilities(): TargetCapabilities;
+    getCurrentLocation(): string;
+    isReady(): boolean;
+    getIsPersistent(): boolean;
+    private reactDevToolsEnabled;
+    getReactDevToolsEnabled(): boolean;
+    setReactDevToolsEnabled(enabled: boolean): void;
+    getIsHeaded(): boolean;
+    incrementFailures(): void;
+    resetFailures(): void;
+    getFailureHint(): string | null;
+    private saveState;
+    private applyContextOptions;
+    private restoreState;
+    private handoffCleanup;
+    handoff(message: string, useChromium?: boolean): Promise<string>;
+    resume(): Promise<string>;
+    newTab(url?: string): Promise<number>;
+    closeTab(id?: number): Promise<void>;
+    switchTab(id: number): void;
+    getActiveTabId(): number;
+    hasTab(id: number): boolean;
+    getTabCount(): number;
+    getTabList(): Array<{
+        id: number;
+        url: string;
+        title: string;
+        active: boolean;
+    }>;
+    getTabListWithTitles(): Promise<Array<{
+        id: number;
+        url: string;
+        title: string;
+        active: boolean;
+    }>>;
+    getPage(): Page;
+    getPageById(id: number): Page | undefined;
+    getCurrentUrl(): string;
+    /**
+     * Set the active frame by CSS selector (e.g., '#my-iframe', 'iframe[name="content"]').
+     * Subsequent commands that use resolveRef, getLocatorRoot, or getFrameContext
+     * will target this frame's content instead of the main page.
+     */
+    setFrame(selector: string): void;
+    /**
+     * Reset to main frame — clears the active frame selector for the current tab.
+     */
+    resetFrame(): void;
+    /**
+     * Get the current active frame selector, or null if targeting main page.
+     */
+    getActiveFrameSelector(): string | null;
+    /**
+     * Get a FrameLocator for the active frame.
+     * Returns null if no frame is active (targeting main page).
+     */
+    getFrameLocator(): FrameLocator | null;
+    /**
+     * Get the Frame object for the active frame (needed for evaluate() calls).
+     * Returns null if no frame is active.
+     * Unlike FrameLocator, Frame supports evaluate(), querySelector, etc.
+     */
+    getFrameContext(): Promise<Frame | null>;
+    /**
+     * Get a locator root scoped to the active frame (if any) or the page.
+     * Use this to create locators that respect the current frame context.
+     * Example: bm.getLocatorRoot().locator('button.submit')
+     */
+    getLocatorRoot(): Page | FrameLocator;
+    setRefMap(refs: Map<string, Locator>): void;
+    clearRefs(): void;
+    /**
+     * Resolve a selector that may be a @ref (e.g., "@e3") or a CSS selector.
+     * Returns { locator } for refs or { selector } for CSS selectors.
+     *
+     * When a frame is active and a CSS selector is passed, returns { locator }
+     * scoped to the frame instead of { selector }, so callers automatically
+     * interact with elements inside the iframe.
+     */
+    resolveRef(selector: string): {
+        locator: Locator;
+    } | {
+        selector: string;
+    };
+    /**
+     * Resolve a ref with staleness detection. Throws immediately if the ref's
+     * element no longer exists in the DOM, instead of waiting for action timeout.
+     */
+    resolveRefChecked(selector: string): Promise<{
+        locator: Locator;
+    } | {
+        selector: string;
+    }>;
+    getRefCount(): number;
+    getRefMap(): Map<string, Locator>;
+    /**
+     * Check if refs are valid for the currently active tab.
+     * Used by screenshot --annotate to avoid cross-tab ref leaks.
+     */
+    areRefsValidForActiveTab(): boolean;
+    setLastSnapshot(text: string, opts?: string[]): void;
+    getLastSnapshot(): string | null;
+    getLastSnapshotOpts(): string[];
+    getLastDialog(): {
+        type: string;
+        message: string;
+        defaultValue?: string;
+    } | null;
+    setAutoDialogAction(action: 'accept' | 'dismiss', promptValue?: string): void;
+    getAutoDialogAction(): 'accept' | 'dismiss';
+    setViewport(width: number, height: number): Promise<void>;
+    setExtraHeader(name: string, value: string): Promise<void>;
+    setUserAgent(ua: string): void;
+    getUserAgent(): string | null;
+    /**
+     * Recreate the browser context with new options.
+     * Playwright requires a new context to change UA/device — existing pages are closed.
+     *
+     * Preserves: cookies, all tab URLs (not just active), active tab selection.
+     * Cannot preserve: localStorage/sessionStorage (bound to old context).
+     */
+    private recreateContext;
+    applyUserAgent(): Promise<void>;
+    /**
+     * Emulate a device — recreates context with full device settings.
+     * Pass null to reset to desktop defaults.
+     */
+    emulateDevice(device: DeviceDescriptor | null): Promise<void>;
+    getCurrentDevice(): DeviceDescriptor | null;
+    isOffline(): boolean;
+    setOffline(value: boolean): Promise<void>;
+    startHarRecording(): void;
+    stopHarRecording(): HarRecording | null;
+    getHarRecording(): HarRecording | null;
+    startVideoRecording(dir: string): Promise<void>;
+    stopVideoRecording(): Promise<{
+        dir: string;
+        startedAt: number;
+        paths: string[];
+    } | null>;
+    getVideoRecording(): {
+        dir: string;
+        startedAt: number;
+    } | null;
+    startCoverage(): Promise<void>;
+    stopCoverage(): Promise<{
+        js: CoverageEntry[];
+        css: CoverageEntry[];
+    }>;
+    isCoverageActive(): boolean;
+    private processJSCoverage;
+    private processCSSCoverage;
+    setInitScript(script: string): void;
+    getInitScript(): string | null;
+    addUserRoute(pattern: string, action: 'block' | 'fulfill', status?: number, body?: string): void;
+    clearUserRoutes(): void;
+    getUserRoutes(): {
+        pattern: string;
+        action: "block" | "fulfill";
+        status?: number;
+        body?: string;
+    }[];
+    setDomainFilter(filter: DomainFilter): void;
+    getDomainFilter(): DomainFilter | null;
+    setCaptureNetworkBodies(enabled: boolean): void;
+    getCaptureNetworkBodies(): boolean;
+    /**
+     * Returns the milliseconds since the last observed DOM mutation on the
+     * current page, or Infinity if no mutations have been seen since page load.
+     *
+     * Reads `window.__browseMutationAge` which is kept up-to-date by the
+     * MutationObserver injected via MUTATION_OBSERVER_SCRIPT.
+     */
+    getLastMutationAge(): Promise<number>;
+    /**
+     * Reverse-lookup: find the tab ID that owns this page.
+     * Returns undefined if the page isn't committed to any tab yet (during newTab).
+     */
+    private getTabIdForPage;
+    /** Evict oldest captured response bodies to stay within the per-session byte budget */
+    private evictOldestBodies;
+    private wirePageEvents;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/browser/manager.d.ts.map

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

package/dist/types/browser/png-compare.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Self-contained PNG decoder, encoder + pixel comparator.
+ * No external deps — uses only zlib (Node/Bun built-in).
+ * Works in both dev mode (bun run) and compiled binary ($bunfs).
+ *
+ * Decoder supports: 8-bit RGB (color type 2) and RGBA (color type 6).
+ * Handles all 5 PNG scanline filter types (None/Sub/Up/Average/Paeth).
+ * Encoder outputs: 8-bit RGBA (color type 6), filter None, zlib-compressed.
+ */
+export interface DecodedImage {
+    width: number;
+    height: number;
+    data: Buffer;
+}
+export interface CompareResult {
+    totalPixels: number;
+    diffPixels: number;
+    mismatchPct: number;
+    passed: boolean;
+    diffImage?: Buffer;
+}
+export declare function decodePNG(buf: Buffer): DecodedImage;
+/**
+ * Encode a DecodedImage (RGBA pixels) into a PNG buffer.
+ * Uses filter type None (0) for simplicity — zlib handles compression.
+ */
+export declare function encodePNG(img: DecodedImage): Buffer;
+/**
+ * Generate a visual diff image highlighting pixel differences.
+ * - Pixels only in one image (size mismatch): bright red (255,0,0,255)
+ * - Pixels differing beyond threshold: red-tinted (255, g/3, b/3, 255)
+ * - Pixels matching: dimmed (r/3, g/3, b/3, 128)
+ */
+export declare function generateDiffImage(base: DecodedImage, curr: DecodedImage, colorThreshold: number): Buffer;
+export declare function compareScreenshots(baselineBuf: Buffer, currentBuf: Buffer, thresholdPct?: number, colorThreshold?: number): CompareResult;
+//# sourceMappingURL=png-compare.d.ts.map

package/dist/types/browser/png-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png-compare.d.ts","sourceRoot":"","sources":["../../../src/browser/png-compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAsEnD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CA6CnD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CA8CxG;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAY,EAC1B,cAAc,GAAE,MAAW,GAC1B,aAAa,CAoCf"}

package/dist/types/browser/profiles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Profile lifecycle helpers — standalone functions for managing persistent
+ * browser profile directories.
+ *
+ * The BrowserManager.launchPersistent() method and getIsPersistent() remain
+ * in manager.ts because they depend on private BrowserManager state
+ * (context, browser, isPersistent, nextTabId, etc.).
+ *
+ * TODO: When BrowserManager is further decomposed, move launchPersistent /
+ * getIsPersistent here as well.
+ */
+/**
+ * Get the profile directory path for a named profile.
+ * Profiles live in .browse/profiles/<name>/
+ */
+export declare function getProfileDir(localDir: string, name: string): string;
+/**
+ * List all profiles with metadata.
+ */
+export declare function listProfiles(localDir: string): Array<{
+    name: string;
+    size: string;
+    lastUsed: string;
+}>;
+/**
+ * Delete a profile directory.
+ */
+export declare function deleteProfile(localDir: string, name: string): void;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/types/browser/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../../src/browser/profiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BtG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIlE"}

package/dist/types/browser/react-devtools.d.ts

@@ -0,0 +1,75 @@
+/**
+ * React DevTools integration — lazy download, hook injection, and fiber tree queries.
+ *
+ * Uses React DevTools' installHook.js to install __REACT_DEVTOOLS_GLOBAL_HOOK__
+ * before page JS runs. React auto-discovers the hook and registers renderers.
+ * All queries use page.evaluate() against the hook — no Chrome extension needed.
+ */
+import type { BrowserTarget } from './target';
+import type { Page } from 'playwright';
+/**
+ * Download installHook.js if not cached. Returns the script content.
+ */
+export declare function ensureHook(): Promise<string>;
+/**
+ * Inject the hook into the browser context via addInitScript.
+ * The hook runs before any page JS, so React discovers it on load.
+ */
+export declare function injectHook(bm: BrowserTarget): Promise<void>;
+/**
+ * Mark DevTools as disabled. Can't remove init scripts —
+ * takes effect on next context creation or page reload without the hook.
+ */
+export declare function removeHook(bm: BrowserTarget): void;
+/**
+ * Check if React DevTools hook is currently injected.
+ */
+export declare function isEnabled(bm: BrowserTarget): boolean;
+/**
+ * Helper: check that DevTools is enabled, throw actionable error if not.
+ */
+export declare function requireEnabled(bm: BrowserTarget): void;
+/**
+ * Helper: check that React is detected on the page.
+ * Returns the renderer interface or throws.
+ */
+export declare function requireReact(page: Page): Promise<void>;
+/**
+ * Walk the fiber tree from root and return a formatted component tree.
+ */
+export declare function getTree(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Get props and hook state of the React component that owns the given element.
+ */
+export declare function getProps(bm: BrowserTarget, page: Page, selector: string): Promise<string>;
+/**
+ * Find all Suspense boundaries and report their resolution status.
+ */
+export declare function getSuspense(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Find all error boundaries and report whether they have caught errors.
+ */
+export declare function getErrors(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Report React Profiler timing data (actualDuration / selfBaseDuration).
+ * Requires React profiling build (react-dom/profiling).
+ */
+export declare function getProfiler(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Report hydration timing from performance entries or Next.js instrumentation.
+ */
+export declare function getHydration(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Report which components re-rendered in the most recent commit.
+ * Uses actualDuration > 0 with an alternate fiber as the signal.
+ */
+export declare function getRenders(bm: BrowserTarget, page: Page): Promise<string>;
+/**
+ * Walk up the fiber tree from an element to show the parent component chain.
+ */
+export declare function getOwners(bm: BrowserTarget, page: Page, selector: string): Promise<string>;
+/**
+ * Read React Context values consumed by the component at the given element.
+ */
+export declare function getContext(bm: BrowserTarget, page: Page, selector: string): Promise<string>;
+//# sourceMappingURL=react-devtools.d.ts.map

package/dist/types/browser/react-devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-devtools.d.ts","sourceRoot":"","sources":["../../../src/browser/react-devtools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMvC;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAkBlD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAMtD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAa5D;AAMD;;GAEG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAgD5E;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6D/F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAkChF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B9E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BhF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBjF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B/E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkChG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CjG"}

package/dist/types/browser/readiness.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Page readiness — wait for page to be truly ready after navigation.
+ * Runtime-agnostic. Best-effort, never throws.
+ * Gated by BROWSE_READINESS env var (default '0' = disabled, opt-in only).
+ */
+import type { Page } from 'playwright';
+export interface ReadinessOptions {
+    /** Max time to wait for network idle (ms). Default: 2000. */
+    networkTimeout?: number;
+    /** Settle time after rAF (ms). Default: 100. */
+    settleMs?: number;
+}
+/**
+ * Wait for page readiness: networkidle (soft) + rAF + settle.
+ * Never throws — all steps wrapped in try/catch.
+ * Total overhead bounded: networkTimeout + settleMs.
+ */
+export declare function waitForPageReady(page: Page, opts?: ReadinessOptions): Promise<void>;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/types/browser/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/browser/readiness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAezF"}

package/dist/types/browser/refs.d.ts

@@ -0,0 +1,70 @@
+/**
+ * RefManager — owns @ref state and per-tab snapshot baselines.
+ *
+ * Refs are tab-scoped: the refTabId records which tab produced them.
+ * BrowserManager must pass the current activeTabId to methods that
+ * need it (setRefMap, resolveRef, snapshot accessors).
+ */
+import type { Locator } from 'playwright';
+export declare class RefManager {
+    private refMap;
+    /** Which tab owns the current refMap. */
+    private refTabId;
+    private tabSnapshots;
+    setRefMap(refs: Map<string, Locator>, activeTabId: number): void;
+    clearRefs(): void;
+    getRefMap(): Map<string, Locator>;
+    getRefCount(): number;
+    getRefTabId(): number;
+    /**
+     * Returns true if the ref belongs to the given active tab.
+     * Used by wirePageEvents to decide whether navigation should clear refs.
+     */
+    isRefTab(tabId: number): boolean;
+    areRefsValidForActiveTab(activeTabId: number): boolean;
+    /**
+     * Resolve a selector that may be a @ref (e.g. "@e3") or a plain CSS selector.
+     * Returns { locator } for @refs, or { selector } for CSS selectors.
+     *
+     * `frameScopedLocator` should be non-null when a frame is active; it will be
+     * used to scope plain CSS selectors into the frame.
+     */
+    resolveRef(selector: string, activeTabId: number, frameScopedLocator?: Locator | null): {
+        locator: Locator;
+    } | {
+        selector: string;
+    };
+    setLastSnapshot(text: string, activeTabId: number, opts?: string[]): void;
+    getLastSnapshot(activeTabId: number): string | null;
+    getLastSnapshotOpts(activeTabId: number): string[];
+    deleteSnapshot(tabId: number): void;
+    clearSnapshots(): void;
+    /**
+     * Migrate snapshot entries from old tab IDs to new tab IDs.
+     * Used by recreateContext after tabs are rebuilt in the new context.
+     */
+    migrateSnapshots(idMap: Map<number, number>): void;
+    /**
+     * Save snapshot map for rollback (e.g. recreateContext failure).
+     */
+    snapshotState(): Map<number, {
+        text: string;
+        opts: string[];
+    }>;
+    /**
+     * Restore snapshot map from a saved copy (rollback).
+     */
+    restoreState(saved: Map<number, {
+        text: string;
+        opts: string[];
+    }>): void;
+    /**
+     * Save refMap for rollback.
+     */
+    snapshotRefMap(): Map<string, Locator>;
+    /**
+     * Restore refMap from a saved copy (rollback).
+     */
+    restoreRefMap(saved: Map<string, Locator>): void;
+}
+//# sourceMappingURL=refs.d.ts.map

package/dist/types/browser/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../src/browser/refs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,UAAU;IAErB,OAAO,CAAC,MAAM,CAAmC;IACjD,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAa;IAG7B,OAAO,CAAC,YAAY,CAA4D;IAIhF,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKhE,SAAS,IAAI,IAAI;IAIjB,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,WAAW,IAAI,MAAM;IAIrB,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhC,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAItD;;;;;;OAMG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,GAClC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;IA2B9C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAIzE,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAInD,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAWlD;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI9D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,IAAI;IAIxE;;OAEG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAItC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGjD"}

package/dist/types/browser/serp.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Google SERP fast-path — DOM-based extraction of search results.
+ * Skips ariaSnapshot entirely for ~2x speed on Google search pages.
+ * Opt-in only: activated via --serp flag or BROWSE_SERP_FASTPATH=1.
+ */
+import type { Page } from 'playwright';
+/**
+ * Check if a URL is a Google SERP (search results page).
+ */
+export declare function isGoogleSerp(url: string): boolean;
+/**
+ * Extract structured Google search results via DOM evaluation.
+ * Returns formatted text or null on failure.
+ */
+export declare function extractGoogleSerp(page: Page): Promise<string | null>;
+//# sourceMappingURL=serp.d.ts.map

package/dist/types/browser/serp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serp.d.ts","sourceRoot":"","sources":["../../../src/browser/serp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUjD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkE1E"}

package/dist/types/browser/snapshot-window.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Snapshot windowing — truncate large accessibility snapshots while
+ * preserving pagination/navigation links at the tail.
+ *
+ * Cuts on line boundaries (never splits a line or @ref mid-token).
+ * Extracts actual navigation/pagination lines from the tail, not arbitrary chars.
+ */
+export interface WindowResult {
+    text: string;
+    truncated: boolean;
+    totalChars: number;
+    offset: number;
+    hasMore: boolean;
+    nextOffset: number | null;
+}
+/**
+ * Apply windowing to a snapshot string.
+ * - Splits on line boundaries (never cuts mid-line or mid-@ref).
+ * - offset is a LINE index, not char index.
+ * - Appends actual navigation/pagination tail lines.
+ * - Returns unchanged if under the char limit.
+ */
+export declare function applySnapshotWindow(snapshot: string, opts?: {
+    offset?: number;
+    maxChars?: number;
+}): WindowResult;
+/**
+ * Format window metadata as a human-readable line.
+ */
+export declare function formatWindowMetadata(result: WindowResult): string;
+//# sourceMappingURL=snapshot-window.d.ts.map

package/dist/types/browser/snapshot-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-window.d.ts","sourceRoot":"","sources":["../../../src/browser/snapshot-window.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA4BD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,YAAY,CA4Cd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAIjE"}