@oyerinde/caliper 0.1.4 → 0.2.1

package/dist/bridge.d.cts

@@ -0,0 +1,1651 @@
+import { z } from 'zod';
+import * as z_2 from 'zod/v4';
+
+declare interface AgentBridgeConfig {
+    /** Enable the agentic bridge for AI integration (default: false) */
+    enabled?: boolean;
+    /** WebSocket port for the MCP relay (default: 9876) */
+    wsPort?: number;
+    /** Callback for agent state changes */
+    onStateChange?: (state: CaliperAgentState) => void;
+    /** Name of a global window function to call on state changes (IIFE/CDN-safe, JSON-serializable) */
+    onStateChangeGlobal?: string;
+}
+
+declare interface CalculatorIntegration {
+    getState: () => CalculatorState;
+    open: (baseValue: number) => void;
+    handleInput: (key: string) => void;
+    handleBackspace: () => void;
+    handleDelete: () => void;
+    handleEnter: () => void;
+    close: () => void;
+    syncValue: (value: number) => void;
+    getResult: () => number | null;
+}
+
+/**
+ * Calculator state machine
+ */
+declare type CalculatorOperation = "+" | "-" | "*" | "/";
+
+declare interface CalculatorState {
+    baseValue: number;
+    operation: CalculatorOperation | null;
+    inputValue: string;
+    result: number | null;
+    isActive: boolean;
+}
+
+export declare const CALIPER_METHODS: {
+    readonly SELECT: "CALIPER_SELECT";
+    readonly MEASURE: "CALIPER_MEASURE";
+    readonly INSPECT: "CALIPER_INSPECT";
+    readonly FREEZE: "CALIPER_FREEZE";
+    readonly CLEAR: "CALIPER_CLEAR";
+    readonly WALK_DOM: "CALIPER_WALK_DOM";
+    readonly WALK_AND_MEASURE: "CALIPER_WALK_AND_MEASURE";
+    readonly GET_CONTEXT: "CALIPER_GET_CONTEXT";
+    readonly REGISTER_TAB: "caliper/registerTab";
+    readonly TAB_UPDATE: "caliper/tabUpdate";
+    readonly STATE_UPDATE: "caliper/stateUpdate";
+};
+
+export declare type CaliperActionResult = z.infer<typeof CaliperActionResultSchema>;
+
+export declare const CaliperActionResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_SELECT">;
+    selector: z.ZodString;
+    selection: z.ZodObject<{
+        rect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        scrollHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        position: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        stickyConfig: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        initialWindowX: z.ZodNumber;
+        initialWindowY: z.ZodNumber;
+        depth: z.ZodNumber;
+        hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_MEASURE">;
+    selector: z.ZodString;
+    measurement: z.ZodObject<{
+        context: z.ZodNullable<z.ZodEnum<{
+            parent: "parent";
+            child: "child";
+            sibling: "sibling";
+        }>>;
+        lines: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                top: "top";
+                right: "right";
+                bottom: "bottom";
+                left: "left";
+                distance: "distance";
+            }>;
+            value: z.ZodNumber;
+            start: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            end: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            startSync: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+            }>>;
+            endSync: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+            }>>;
+        }, z.core.$strip>>;
+        primary: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        secondary: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        timestamp: z.ZodNumber;
+        primaryHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        secondaryHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        primaryPosition: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        secondaryPosition: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        primaryWinX: z.ZodNumber;
+        primaryWinY: z.ZodNumber;
+        secondaryWinX: z.ZodNumber;
+        secondaryWinY: z.ZodNumber;
+        primarySticky: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        secondarySticky: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        primaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+        secondaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_INSPECT">;
+    selector: z.ZodString;
+    distances: z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        horizontal: z.ZodNumber;
+        vertical: z.ZodNumber;
+    }, z.core.$strip>;
+    computedStyles: z.ZodObject<{
+        display: z.ZodOptional<z.ZodString>;
+        visibility: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodString>;
+        boxSizing: z.ZodOptional<z.ZodString>;
+        padding: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strip>>;
+        margin: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strip>>;
+        border: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strip>>;
+        gap: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        flexDirection: z.ZodOptional<z.ZodString>;
+        justifyContent: z.ZodOptional<z.ZodString>;
+        alignItems: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        fontWeight: z.ZodOptional<z.ZodString>;
+        fontFamily: z.ZodOptional<z.ZodString>;
+        lineHeight: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        color: z.ZodOptional<z.ZodString>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        borderColor: z.ZodOptional<z.ZodString>;
+        borderRadius: z.ZodOptional<z.ZodString>;
+        boxShadow: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        outline: z.ZodOptional<z.ZodString>;
+        outlineColor: z.ZodOptional<z.ZodString>;
+        zIndex: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+        overflow: z.ZodOptional<z.ZodString>;
+        overflowX: z.ZodOptional<z.ZodString>;
+        overflowY: z.ZodOptional<z.ZodString>;
+        contentVisibility: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    selection: z.ZodObject<{
+        rect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        scrollHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        position: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        stickyConfig: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        initialWindowX: z.ZodNumber;
+        initialWindowY: z.ZodNumber;
+        depth: z.ZodNumber;
+        hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    immediateChildCount: z.ZodOptional<z.ZodNumber>;
+    descendantCount: z.ZodOptional<z.ZodNumber>;
+    descendantsTruncated: z.ZodOptional<z.ZodBoolean>;
+    sourceHints: z.ZodOptional<z.ZodObject<{
+        stableAnchors: z.ZodArray<z.ZodString>;
+        suggestedGrep: z.ZodOptional<z.ZodString>;
+        textContent: z.ZodOptional<z.ZodString>;
+        accessibleName: z.ZodOptional<z.ZodString>;
+        unstableClasses: z.ZodArray<z.ZodString>;
+        tagName: z.ZodString;
+    }, z.core.$strip>>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_FREEZE">;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_CLEAR">;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_WALK_DOM">;
+    selector: z.ZodString;
+    domContext: z.ZodObject<{
+        element: z.ZodObject<{
+            tagName: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+            classList: z.ZodArray<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        parent: z.ZodNullable<z.ZodObject<{
+            tagName: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+            classList: z.ZodArray<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        children: z.ZodArray<z.ZodObject<{
+            tagName: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+            classList: z.ZodArray<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_WALK_AND_MEASURE">;
+    selector: z.ZodString;
+    walkResult: z.ZodObject<{
+        root: z.ZodOptional<z.ZodType<CaliperNode, unknown, z.core.$ZodTypeInternals<CaliperNode, unknown>>>;
+        nodeCount: z.ZodNumber;
+        maxDepthReached: z.ZodNumber;
+        walkDurationMs: z.ZodNumber;
+        hasMore: z.ZodOptional<z.ZodBoolean>;
+        batchInstructions: z.ZodOptional<z.ZodString>;
+        continuationToken: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+    binaryPayload: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    method: z.ZodLiteral<"CALIPER_GET_CONTEXT">;
+    context: z.ZodObject<{
+        rootFontSize: z.ZodNumber;
+        devicePixelRatio: z.ZodNumber;
+        viewportWidth: z.ZodNumber;
+        viewportHeight: z.ZodNumber;
+        visualViewportWidth: z.ZodOptional<z.ZodNumber>;
+        visualViewportHeight: z.ZodOptional<z.ZodNumber>;
+        scrollX: z.ZodNumber;
+        scrollY: z.ZodNumber;
+        documentWidth: z.ZodNumber;
+        documentHeight: z.ZodNumber;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+        preferences: z.ZodObject<{
+            colorScheme: z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+                "no-preference": "no-preference";
+            }>;
+            reducedMotion: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    method: z.ZodEnum<{
+        CALIPER_SELECT: "CALIPER_SELECT";
+        CALIPER_MEASURE: "CALIPER_MEASURE";
+        CALIPER_INSPECT: "CALIPER_INSPECT";
+        CALIPER_FREEZE: "CALIPER_FREEZE";
+        CALIPER_CLEAR: "CALIPER_CLEAR";
+        CALIPER_WALK_DOM: "CALIPER_WALK_DOM";
+        CALIPER_WALK_AND_MEASURE: "CALIPER_WALK_AND_MEASURE";
+        CALIPER_GET_CONTEXT: "CALIPER_GET_CONTEXT";
+        "caliper/registerTab": "caliper/registerTab";
+        "caliper/tabUpdate": "caliper/tabUpdate";
+        "caliper/stateUpdate": "caliper/stateUpdate";
+    }>;
+    selector: z.ZodOptional<z.ZodString>;
+    error: z.ZodString;
+    timestamp: z.ZodNumber;
+    binaryPayload: z.ZodOptional<z.ZodCustom<Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>>>;
+}, z.core.$strip>]>;
+
+export declare type CaliperAgentState = z.infer<typeof CaliperAgentStateSchema>;
+
+export declare const CaliperAgentStateSchema: z.ZodObject<{
+    viewport: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        scrollX: z.ZodNumber;
+        scrollY: z.ZodNumber;
+    }, z.core.$strip>;
+    activeSelection: z.ZodNullable<z.ZodObject<{
+        rect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        scrollHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        position: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        stickyConfig: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        initialWindowX: z.ZodNumber;
+        initialWindowY: z.ZodNumber;
+        depth: z.ZodNumber;
+        hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    selectionFingerprint: z.ZodNullable<z.ZodObject<{
+        selector: z.ZodString;
+        tag: z.ZodString;
+        timestamp: z.ZodNumber;
+        id: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tabId: z.ZodOptional<z.ZodString>;
+        nthChild: z.ZodOptional<z.ZodNumber>;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        depth: z.ZodOptional<z.ZodNumber>;
+        marker: z.ZodOptional<z.ZodString>;
+        scrollHierarchy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        position: z.ZodOptional<z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>>;
+        stickyConfig: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        initialWindowX: z.ZodOptional<z.ZodNumber>;
+        initialWindowY: z.ZodOptional<z.ZodNumber>;
+        hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+        rect: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    lastMeasurement: z.ZodNullable<z.ZodObject<{
+        context: z.ZodNullable<z.ZodEnum<{
+            parent: "parent";
+            child: "child";
+            sibling: "sibling";
+        }>>;
+        lines: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                top: "top";
+                right: "right";
+                bottom: "bottom";
+                left: "left";
+                distance: "distance";
+            }>;
+            value: z.ZodNumber;
+            start: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            end: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>;
+            startSync: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+            }>>;
+            endSync: z.ZodOptional<z.ZodEnum<{
+                primary: "primary";
+                secondary: "secondary";
+            }>>;
+        }, z.core.$strip>>;
+        primary: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        secondary: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        timestamp: z.ZodNumber;
+        primaryHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        secondaryHierarchy: z.ZodArray<z.ZodObject<{
+            initialScrollTop: z.ZodNumber;
+            initialScrollLeft: z.ZodNumber;
+            containerRect: z.ZodNullable<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+            absoluteDepth: z.ZodNumber;
+            hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        primaryPosition: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        secondaryPosition: z.ZodEnum<{
+            static: "static";
+            relative: "relative";
+            absolute: "absolute";
+            fixed: "fixed";
+            sticky: "sticky";
+        }>;
+        primaryWinX: z.ZodNumber;
+        primaryWinY: z.ZodNumber;
+        secondaryWinX: z.ZodNumber;
+        secondaryWinY: z.ZodNumber;
+        primarySticky: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        secondarySticky: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNullable<z.ZodNumber>;
+            bottom: z.ZodNullable<z.ZodNumber>;
+            left: z.ZodNullable<z.ZodNumber>;
+            right: z.ZodNullable<z.ZodNumber>;
+            naturalTop: z.ZodNumber;
+            naturalLeft: z.ZodNumber;
+            containerWidth: z.ZodNumber;
+            containerHeight: z.ZodNumber;
+            elementWidth: z.ZodNumber;
+            elementHeight: z.ZodNumber;
+            anchorAbsoluteDepth: z.ZodNumber;
+        }, z.core.$strip>>;
+        primaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+        secondaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    measurementFingerprint: z.ZodNullable<z.ZodObject<{
+        primary: z.ZodObject<{
+            selector: z.ZodString;
+            tag: z.ZodString;
+            timestamp: z.ZodNumber;
+            id: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tabId: z.ZodOptional<z.ZodString>;
+            nthChild: z.ZodOptional<z.ZodNumber>;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+            depth: z.ZodOptional<z.ZodNumber>;
+            marker: z.ZodOptional<z.ZodString>;
+            scrollHierarchy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                initialScrollTop: z.ZodNumber;
+                initialScrollLeft: z.ZodNumber;
+                containerRect: z.ZodNullable<z.ZodObject<{
+                    top: z.ZodNumber;
+                    right: z.ZodNumber;
+                    bottom: z.ZodNumber;
+                    left: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+                absoluteDepth: z.ZodNumber;
+                hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            position: z.ZodOptional<z.ZodEnum<{
+                static: "static";
+                relative: "relative";
+                absolute: "absolute";
+                fixed: "fixed";
+                sticky: "sticky";
+            }>>;
+            stickyConfig: z.ZodOptional<z.ZodObject<{
+                top: z.ZodNullable<z.ZodNumber>;
+                bottom: z.ZodNullable<z.ZodNumber>;
+                left: z.ZodNullable<z.ZodNumber>;
+                right: z.ZodNullable<z.ZodNumber>;
+                naturalTop: z.ZodNumber;
+                naturalLeft: z.ZodNumber;
+                containerWidth: z.ZodNumber;
+                containerHeight: z.ZodNumber;
+                elementWidth: z.ZodNumber;
+                elementHeight: z.ZodNumber;
+                anchorAbsoluteDepth: z.ZodNumber;
+            }, z.core.$strip>>;
+            initialWindowX: z.ZodOptional<z.ZodNumber>;
+            initialWindowY: z.ZodOptional<z.ZodNumber>;
+            hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+            rect: z.ZodOptional<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        secondary: z.ZodObject<{
+            selector: z.ZodString;
+            tag: z.ZodString;
+            timestamp: z.ZodNumber;
+            id: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            tabId: z.ZodOptional<z.ZodString>;
+            nthChild: z.ZodOptional<z.ZodNumber>;
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+            depth: z.ZodOptional<z.ZodNumber>;
+            marker: z.ZodOptional<z.ZodString>;
+            scrollHierarchy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                initialScrollTop: z.ZodNumber;
+                initialScrollLeft: z.ZodNumber;
+                containerRect: z.ZodNullable<z.ZodObject<{
+                    top: z.ZodNumber;
+                    right: z.ZodNumber;
+                    bottom: z.ZodNumber;
+                    left: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strip>>;
+                absoluteDepth: z.ZodNumber;
+                hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            position: z.ZodOptional<z.ZodEnum<{
+                static: "static";
+                relative: "relative";
+                absolute: "absolute";
+                fixed: "fixed";
+                sticky: "sticky";
+            }>>;
+            stickyConfig: z.ZodOptional<z.ZodObject<{
+                top: z.ZodNullable<z.ZodNumber>;
+                bottom: z.ZodNullable<z.ZodNumber>;
+                left: z.ZodNullable<z.ZodNumber>;
+                right: z.ZodNullable<z.ZodNumber>;
+                naturalTop: z.ZodNumber;
+                naturalLeft: z.ZodNumber;
+                containerWidth: z.ZodNumber;
+                containerHeight: z.ZodNumber;
+                elementWidth: z.ZodNumber;
+                elementHeight: z.ZodNumber;
+                anchorAbsoluteDepth: z.ZodNumber;
+            }, z.core.$strip>>;
+            initialWindowX: z.ZodOptional<z.ZodNumber>;
+            initialWindowY: z.ZodOptional<z.ZodNumber>;
+            hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+            rect: z.ZodOptional<z.ZodObject<{
+                top: z.ZodNumber;
+                right: z.ZodNumber;
+                bottom: z.ZodNumber;
+                left: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    lastUpdated: z.ZodNumber;
+}, z.core.$strip>;
+
+/**
+ * @caliper/agent-bridge
+ * Enables AI agents to use Caliper's high-precision measurement engine
+ *
+ * @example
+ * ```typescript
+ * import { createMeasurementSystem, createSelectionSystem } from "@oyerinde/caliper/core";
+ * import { bridge } from "@oyerinde/caliper-bridge";
+ *
+ * const measurementSystem = createMeasurementSystem();
+ * const selectionSystem = createSelectionSystem();
+ *
+ * const cleanup = bridge({
+ *   enabled: true,
+ *   systems: { measurementSystem, selectionSystem }
+ * });
+ * ```
+ */
+
+/**
+ * CaliperBridge Plugin Factory
+ *
+ * Creates a Caliper plugin that enables AI agents to interact with the overlay via
+ * a WebSocket bridge (local MCP relay) or direct global intent dispatching.
+ *
+ * When installed, this plugin:
+ * 1. Starts a local WebSocket server (or connects to one) to receive agent commands.
+ * 2. Exposes `window.dispatchCaliperIntent` for manual/in-page agentic calls.
+ * 3. Syncs the overlay state (camera, selection, measurements) back to the agent.
+ *
+ * @example
+ * ```ts
+ * import { init } from "@oyerinde/caliper/preset";
+ * import { CaliperBridge } from "@oyerinde/caliper/bridge";
+ *
+ * init({ ... }, [
+ *   new CaliperBridge({
+ *     enabled: true,
+ *     wsPort: 3010,
+ *     onStateChange: (state) => console.log("New Agent State:", state)
+ *   })
+ * ]);
+ * ```
+ *
+ * @param config - The bridge configuration settings.
+ * @returns A CaliperPlugin that can be used with `caliper.use()` or in `init()`.
+ */
+export declare function CaliperBridge(config: AgentBridgeConfig): CaliperPlugin;
+
+/**
+ * All relevant computed styles extracted from getComputedStyle().
+ * Values are parsed to numbers where applicable.
+ */
+declare const CaliperComputedStylesSchema: z.ZodObject<{
+    display: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodString>;
+    boxSizing: z.ZodOptional<z.ZodString>;
+    padding: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+    }, z.core.$strip>>;
+    margin: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+    }, z.core.$strip>>;
+    border: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+    }, z.core.$strip>>;
+    gap: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    flexDirection: z.ZodOptional<z.ZodString>;
+    justifyContent: z.ZodOptional<z.ZodString>;
+    alignItems: z.ZodOptional<z.ZodString>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    fontWeight: z.ZodOptional<z.ZodString>;
+    fontFamily: z.ZodOptional<z.ZodString>;
+    lineHeight: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    letterSpacing: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    color: z.ZodOptional<z.ZodString>;
+    backgroundColor: z.ZodOptional<z.ZodString>;
+    borderColor: z.ZodOptional<z.ZodString>;
+    borderRadius: z.ZodOptional<z.ZodString>;
+    boxShadow: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    outline: z.ZodOptional<z.ZodString>;
+    outlineColor: z.ZodOptional<z.ZodString>;
+    zIndex: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    overflow: z.ZodOptional<z.ZodString>;
+    overflowX: z.ZodOptional<z.ZodString>;
+    overflowY: z.ZodOptional<z.ZodString>;
+    contentVisibility: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+declare interface CaliperCoreSystems {
+    measurementSystem: MeasurementSystem;
+    selectionSystem: SelectionSystem;
+}
+
+export declare type CaliperGetContextPayload = z.infer<typeof CaliperGetContextPayloadSchema>;
+
+export declare const CaliperGetContextPayloadSchema: z.ZodObject<{}, z.core.$strip>;
+
+export declare type CaliperInspectPayload = z.infer<typeof CaliperInspectPayloadSchema>;
+
+export declare const CaliperInspectPayloadSchema: z.ZodObject<{
+    selector: z.ZodString;
+}, z.core.$strip>;
+
+export declare type CaliperIntent = JsonRpcRequest & ({
+    method: typeof CALIPER_METHODS.SELECT;
+    params: CaliperSelectPayload;
+} | {
+    method: typeof CALIPER_METHODS.MEASURE;
+    params: CaliperMeasurePayload;
+} | {
+    method: typeof CALIPER_METHODS.INSPECT;
+    params: CaliperInspectPayload;
+} | {
+    method: typeof CALIPER_METHODS.FREEZE;
+    params: {};
+} | {
+    method: typeof CALIPER_METHODS.CLEAR;
+    params: {};
+} | {
+    method: typeof CALIPER_METHODS.WALK_DOM;
+    params: CaliperWalkDomPayload;
+} | {
+    method: typeof CALIPER_METHODS.WALK_AND_MEASURE;
+    params: CaliperWalkAndMeasurePayload;
+} | {
+    method: typeof CALIPER_METHODS.GET_CONTEXT;
+    params: CaliperGetContextPayload;
+});
+
+/**
+ * All structural measurements for a node.
+ */
+declare const CaliperMeasurementsSchema: z.ZodObject<{
+    toParent: z.ZodObject<{
+        top: z.ZodNumber;
+        left: z.ZodNumber;
+        bottom: z.ZodNumber;
+        right: z.ZodNumber;
+    }, z.core.$strip>;
+    toPreviousSibling: z.ZodNullable<z.ZodObject<{
+        distance: z.ZodNumber;
+        direction: z.ZodNullable<z.ZodEnum<{
+            right: "right";
+            left: "left";
+            above: "above";
+            below: "below";
+        }>>;
+    }, z.core.$strip>>;
+    toNextSibling: z.ZodNullable<z.ZodObject<{
+        distance: z.ZodNumber;
+        direction: z.ZodNullable<z.ZodEnum<{
+            right: "right";
+            left: "left";
+            above: "above";
+            below: "below";
+        }>>;
+    }, z.core.$strip>>;
+    indexInParent: z.ZodNumber;
+    siblingCount: z.ZodNumber;
+}, z.core.$strip>;
+
+export declare type CaliperMeasurePayload = z.infer<typeof CaliperMeasurePayloadSchema>;
+
+export declare const CaliperMeasurePayloadSchema: z.ZodObject<{
+    primarySelector: z.ZodString;
+    secondarySelector: z.ZodString;
+}, z.core.$strip>;
+
+export declare interface CaliperNode {
+    agentId: string;
+    selector: string;
+    tag: string;
+    htmlId?: string;
+    classes: string[];
+    textContent?: string;
+    rect: z.infer<typeof RectSchema>;
+    viewportRect: {
+        top: number;
+        left: number;
+    };
+    styles: z.infer<typeof CaliperComputedStylesSchema>;
+    measurements: z.infer<typeof CaliperMeasurementsSchema>;
+    depth: number;
+    parentAgentId?: string;
+    childCount: number;
+    children: CaliperNode[];
+    marker?: string;
+    ariaHidden?: boolean;
+}
+
+/**
+ * A plugin allows extending Caliper's functionality by accessing the
+ * OverlayInstance and internal systems.
+ */
+declare interface CaliperPlugin {
+    /** Unique identifier for the plugin. Used for deduplication. */
+    name: string;
+    /** Called when the plugin is installed on an overlay instance. */
+    install: (instance: OverlayInstance) => void;
+    /** Optional cleanup logic called when the overlay is disposed. */
+    dispose?: () => void;
+}
+
+export declare type CaliperSelectorInput = z.infer<typeof CaliperSelectorInputSchema>;
+
+/**
+ * The input data structure for a Caliper selection copy.
+ */
+declare const CaliperSelectorInputSchema: z.ZodObject<{
+    selector: z.ZodString;
+    tag: z.ZodString;
+    timestamp: z.ZodNumber;
+    id: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tabId: z.ZodOptional<z.ZodString>;
+    nthChild: z.ZodOptional<z.ZodNumber>;
+    x: z.ZodOptional<z.ZodNumber>;
+    y: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    marker: z.ZodOptional<z.ZodString>;
+    scrollHierarchy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        initialScrollTop: z.ZodNumber;
+        initialScrollLeft: z.ZodNumber;
+        containerRect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        absoluteDepth: z.ZodNumber;
+        hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    position: z.ZodOptional<z.ZodEnum<{
+        static: "static";
+        relative: "relative";
+        absolute: "absolute";
+        fixed: "fixed";
+        sticky: "sticky";
+    }>>;
+    stickyConfig: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNullable<z.ZodNumber>;
+        bottom: z.ZodNullable<z.ZodNumber>;
+        left: z.ZodNullable<z.ZodNumber>;
+        right: z.ZodNullable<z.ZodNumber>;
+        naturalTop: z.ZodNumber;
+        naturalLeft: z.ZodNumber;
+        containerWidth: z.ZodNumber;
+        containerHeight: z.ZodNumber;
+        elementWidth: z.ZodNumber;
+        elementHeight: z.ZodNumber;
+        anchorAbsoluteDepth: z.ZodNumber;
+    }, z.core.$strip>>;
+    initialWindowX: z.ZodOptional<z.ZodNumber>;
+    initialWindowY: z.ZodOptional<z.ZodNumber>;
+    hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    rect: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export declare type CaliperSelectPayload = z.infer<typeof CaliperSelectPayloadSchema>;
+
+export declare const CaliperSelectPayloadSchema: z.ZodObject<{
+    selector: z.ZodString;
+}, z.core.$strip>;
+
+export declare type CaliperWalkAndMeasurePayload = z.infer<typeof CaliperWalkAndMeasurePayloadSchema>;
+
+export declare const CaliperWalkAndMeasurePayloadSchema: z.ZodObject<{
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    maxNodes: z.ZodOptional<z.ZodNumber>;
+    continueFrom: z.ZodOptional<z.ZodString>;
+    minElementSize: z.ZodOptional<z.ZodNumber>;
+    ignoreSelectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    selector: z.ZodString;
+}, z.core.$strip>;
+
+export declare type CaliperWalkDomPayload = z.infer<typeof CaliperWalkDomPayloadSchema>;
+
+export declare const CaliperWalkDomPayloadSchema: z.ZodObject<{
+    selector: z.ZodString;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+
+export declare type CursorContext = Prettify<z.infer<typeof CursorContextSchema>>;
+
+declare const CursorContextSchema: z.ZodEnum<{
+    parent: "parent";
+    child: "child";
+    sibling: "sibling";
+}>;
+
+/**
+ * Dispatches a high-level intent to the Caliper engine.
+ *
+ * This function is used to programmatically trigger Caliper actions (like measuring between elements)
+ * using the standardized intent format. Requires a `CaliperBridge` to be installed and active.
+ *
+ * @param intent - The action to perform (e.g., 'measure', 'select', 'inspect').
+ * @returns A promise resolving to the result of the action, containing success status and metrics.
+ */
+export declare function dispatchCaliperIntent(intent: CaliperIntent): Promise<CaliperActionResult>;
+
+declare type Flatten<T> = T extends Primitive ? T : T extends Array<infer U> ? Array<Flatten<U>> : T extends Set<infer U> ? Set<Flatten<U>> : T extends Map<infer K, infer V> ? Map<Flatten<K>, Flatten<V>> : T extends object ? {
+    [K in keyof T]: Flatten<T[K]>;
+} : T;
+
+declare type Infer<Schema extends z_2.ZodTypeAny> = Flatten<z_2.infer<Schema>>;
+
+export declare type JSONRPCRequest = Infer<typeof JSONRPCRequestSchema>;
+
+declare type JsonRpcRequest = JSONRPCRequest;
+
+/**
+ * A request that expects a response.
+ */
+declare const JSONRPCRequestSchema: z_2.ZodObject<{
+    method: z_2.ZodString;
+    params: z_2.ZodOptional<z_2.ZodObject<{
+        _meta: z_2.ZodOptional<z_2.ZodObject<{
+            /**
+             * If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications.
+             */
+            progressToken: z_2.ZodOptional<z_2.ZodUnion<readonly [z_2.ZodString, z_2.ZodNumber]>>;
+            /**
+             * If specified, this request is related to the provided task.
+             */
+            "io.modelcontextprotocol/related-task": z_2.ZodOptional<z_2.ZodObject<{
+                taskId: z_2.ZodString;
+            }, z_2.core.$strip>>;
+        }, z_2.core.$loose>>;
+    }, z_2.core.$loose>>;
+    jsonrpc: z_2.ZodLiteral<"2.0">;
+    id: z_2.ZodUnion<readonly [z_2.ZodString, z_2.ZodNumber]>;
+}, z_2.core.$strict>;
+
+export declare type MeasurementLine = Prettify<z.infer<typeof MeasurementLineSchema>>;
+
+declare const MeasurementLineSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        top: "top";
+        right: "right";
+        bottom: "bottom";
+        left: "left";
+        distance: "distance";
+    }>;
+    value: z.ZodNumber;
+    start: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    end: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    startSync: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+    }>>;
+    endSync: z.ZodOptional<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+    }>>;
+}, z.core.$strip>;
+
+export declare type MeasurementResult = Prettify<z.infer<typeof MeasurementResultSchema>>;
+
+declare type MeasurementResult_2 = Remap<MeasurementResult, {
+    primary: DOMRect;
+    secondary: DOMRect | null;
+    primaryHierarchy: ScrollState_2[];
+    secondaryHierarchy: ScrollState_2[];
+    secondaryElement: Element | null;
+}>;
+
+declare const MeasurementResultSchema: z.ZodObject<{
+    context: z.ZodNullable<z.ZodEnum<{
+        parent: "parent";
+        child: "child";
+        sibling: "sibling";
+    }>>;
+    lines: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            top: "top";
+            right: "right";
+            bottom: "bottom";
+            left: "left";
+            distance: "distance";
+        }>;
+        value: z.ZodNumber;
+        start: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        end: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>;
+        startSync: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+        }>>;
+        endSync: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+        }>>;
+    }, z.core.$strip>>;
+    primary: z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    secondary: z.ZodNullable<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+    timestamp: z.ZodNumber;
+    primaryHierarchy: z.ZodArray<z.ZodObject<{
+        initialScrollTop: z.ZodNumber;
+        initialScrollLeft: z.ZodNumber;
+        containerRect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        absoluteDepth: z.ZodNumber;
+        hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    secondaryHierarchy: z.ZodArray<z.ZodObject<{
+        initialScrollTop: z.ZodNumber;
+        initialScrollLeft: z.ZodNumber;
+        containerRect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        absoluteDepth: z.ZodNumber;
+        hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    primaryPosition: z.ZodEnum<{
+        static: "static";
+        relative: "relative";
+        absolute: "absolute";
+        fixed: "fixed";
+        sticky: "sticky";
+    }>;
+    secondaryPosition: z.ZodEnum<{
+        static: "static";
+        relative: "relative";
+        absolute: "absolute";
+        fixed: "fixed";
+        sticky: "sticky";
+    }>;
+    primaryWinX: z.ZodNumber;
+    primaryWinY: z.ZodNumber;
+    secondaryWinX: z.ZodNumber;
+    secondaryWinY: z.ZodNumber;
+    primarySticky: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNullable<z.ZodNumber>;
+        bottom: z.ZodNullable<z.ZodNumber>;
+        left: z.ZodNullable<z.ZodNumber>;
+        right: z.ZodNullable<z.ZodNumber>;
+        naturalTop: z.ZodNumber;
+        naturalLeft: z.ZodNumber;
+        containerWidth: z.ZodNumber;
+        containerHeight: z.ZodNumber;
+        elementWidth: z.ZodNumber;
+        elementHeight: z.ZodNumber;
+        anchorAbsoluteDepth: z.ZodNumber;
+    }, z.core.$strip>>;
+    secondarySticky: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNullable<z.ZodNumber>;
+        bottom: z.ZodNullable<z.ZodNumber>;
+        left: z.ZodNullable<z.ZodNumber>;
+        right: z.ZodNullable<z.ZodNumber>;
+        naturalTop: z.ZodNumber;
+        naturalLeft: z.ZodNumber;
+        containerWidth: z.ZodNumber;
+        containerHeight: z.ZodNumber;
+        elementWidth: z.ZodNumber;
+        elementHeight: z.ZodNumber;
+        anchorAbsoluteDepth: z.ZodNumber;
+    }, z.core.$strip>>;
+    primaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+    secondaryHasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
+/**
+ * Measurement state machine
+ * IDLE → ARMED → MEASURING → FROZEN → IDLE
+ */
+declare type MeasurementState = "IDLE" | "ARMED" | "MEASURING" | "FROZEN";
+
+declare interface MeasurementSystem {
+    measure: (selectedElement: Element, cursor: {
+        x: number;
+        y: number;
+    }) => void;
+    abort: () => void;
+    stop: () => void;
+    freeze: () => void;
+    unfreeze: (isAltDown: boolean) => void;
+    cleanup: () => void;
+    getState: () => MeasurementState;
+    getCurrentResult: () => MeasurementResult_2 | null;
+    getSecondaryElement: () => Element | null;
+    getCalculator: () => CalculatorIntegration;
+    getProjection: () => ProjectionSystem;
+    getRuler: () => RulerSystem;
+    onStateChange: (listener: MeasurementSystemListener) => () => void;
+    updatePrimaryRect: (rect: DOMRect) => void;
+    updateSecondaryRect: (rect: DOMRect) => void;
+    applyResult: (result: MeasurementResult_2) => void;
+}
+
+declare type MeasurementSystemListener = () => void;
+
+/**
+ * Handle to a running Caliper overlay.
+ */
+declare interface OverlayInstance {
+    /**
+     * Mounts the overlay into the DOM.
+     * By default, it mounts into document.documentElement (safe for Shadow DOM).
+     */
+    mount: (container?: HTMLElement) => void;
+    /**
+     * Removes the overlay from the DOM and cleans up all event listeners and systems.
+     */
+    dispose: () => void;
+    /**
+     * Synchronously returns the internal systems if they are initialized.
+     */
+    getSystems: () => CaliperCoreSystems | null;
+    /**
+     * Asynchronous helper that resolves when the internal systems are ready.
+     * Useful for plugins that need to interact with the DOM or state immediately.
+     */
+    waitForSystems: () => Promise<CaliperCoreSystems>;
+    /**
+     * Registers a plugin with this instance.
+     */
+    use: (plugin: CaliperPlugin) => OverlayInstance;
+    /** Whether the overlay is currently mounted in the document. */
+    mounted: boolean;
+}
+
+export declare type PositionMode = Prettify<z.infer<typeof PositionModeSchema>>;
+
+declare const PositionModeSchema: z.ZodEnum<{
+    static: "static";
+    relative: "relative";
+    absolute: "absolute";
+    fixed: "fixed";
+    sticky: "sticky";
+}>;
+
+declare type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+declare type Prettify_2<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+declare type Primitive = string | number | boolean | bigint | null | undefined;
+
+declare type ProjectionDirection = "top" | "right" | "bottom" | "left";
+
+declare type ProjectionListener = (state: ProjectionState) => void;
+
+declare interface ProjectionState {
+    direction: ProjectionDirection | null;
+    value: string;
+    element: HTMLElement | null;
+}
+
+declare interface ProjectionSystem {
+    getState: () => ProjectionState;
+    setDirection: (direction: ProjectionDirection | null) => void;
+    setElement: (element: HTMLElement | null) => void;
+    appendValue: (char: string, max?: number) => void;
+    capValue: (max: number) => void;
+    backspace: () => void;
+    clear: () => void;
+    onUpdate: (listener: ProjectionListener) => () => void;
+}
+
+export declare type Rect = Prettify<z.infer<typeof RectSchema>>;
+
+declare const RectSchema: z.ZodObject<{
+    top: z.ZodNumber;
+    right: z.ZodNumber;
+    bottom: z.ZodNumber;
+    left: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>;
+
+declare type Remap<T, U> = Prettify_2<Omit<T, keyof U> & U>;
+
+declare interface RulerLine {
+    id: string;
+    type: "horizontal" | "vertical";
+    position: number;
+}
+
+declare type RulerListener = (state: RulerState) => void;
+
+declare interface RulerState {
+    lines: RulerLine[];
+}
+
+declare interface RulerSystem {
+    getState: () => RulerState;
+    addPair: (x: number, y: number) => string | null;
+    updateLine: (id: string, position: number) => void;
+    removeLine: (id: string) => void;
+    clear: () => void;
+    onUpdate: (listener: RulerListener) => () => void;
+}
+
+export declare type ScrollState = Prettify<z.infer<typeof ScrollStateSchema>>;
+
+declare interface ScrollState_2 extends ScrollState {
+    element?: HTMLElement;
+    containerRect: DOMRect | null;
+}
+
+declare const ScrollStateSchema: z.ZodObject<{
+    initialScrollTop: z.ZodNumber;
+    initialScrollLeft: z.ZodNumber;
+    containerRect: z.ZodNullable<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+    absoluteDepth: z.ZodNumber;
+    hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
+export declare type SelectionMetadata = Prettify<z.infer<typeof SelectionMetadataSchema>>;
+
+/**
+ * Selection system for tracking selected elements
+ */
+declare type SelectionMetadata_2 = Remap<SelectionMetadata, {
+    element: Element | null;
+    rect: DOMRect | null;
+    scrollHierarchy: ScrollState_2[];
+}>;
+
+declare const SelectionMetadataSchema: z.ZodObject<{
+    rect: z.ZodNullable<z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+    scrollHierarchy: z.ZodArray<z.ZodObject<{
+        initialScrollTop: z.ZodNumber;
+        initialScrollLeft: z.ZodNumber;
+        containerRect: z.ZodNullable<z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        absoluteDepth: z.ZodNumber;
+        hasStickyAncestor: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    position: z.ZodEnum<{
+        static: "static";
+        relative: "relative";
+        absolute: "absolute";
+        fixed: "fixed";
+        sticky: "sticky";
+    }>;
+    stickyConfig: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNullable<z.ZodNumber>;
+        bottom: z.ZodNullable<z.ZodNumber>;
+        left: z.ZodNullable<z.ZodNumber>;
+        right: z.ZodNullable<z.ZodNumber>;
+        naturalTop: z.ZodNumber;
+        naturalLeft: z.ZodNumber;
+        containerWidth: z.ZodNumber;
+        containerHeight: z.ZodNumber;
+        elementWidth: z.ZodNumber;
+        elementHeight: z.ZodNumber;
+        anchorAbsoluteDepth: z.ZodNumber;
+    }, z.core.$strip>>;
+    initialWindowX: z.ZodNumber;
+    initialWindowY: z.ZodNumber;
+    depth: z.ZodNumber;
+    hasContainingBlock: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
+declare interface SelectionSystem {
+    select: (element: Element | null) => void;
+    getSelected: () => Element | null;
+    getSelectedRect: () => DOMRect | null;
+    getMetadata: () => SelectionMetadata_2;
+    clear: () => void;
+    onUpdate: (callback: (metadata: SelectionMetadata_2) => void) => () => void;
+    updateRect: (rect: DOMRect) => void;
+}
+
+export declare type StickyConfig = Prettify<z.infer<typeof StickyConfigSchema>>;
+
+declare const StickyConfigSchema: z.ZodObject<{
+    top: z.ZodNullable<z.ZodNumber>;
+    bottom: z.ZodNullable<z.ZodNumber>;
+    left: z.ZodNullable<z.ZodNumber>;
+    right: z.ZodNullable<z.ZodNumber>;
+    naturalTop: z.ZodNumber;
+    naturalLeft: z.ZodNumber;
+    containerWidth: z.ZodNumber;
+    containerHeight: z.ZodNumber;
+    elementWidth: z.ZodNumber;
+    elementHeight: z.ZodNumber;
+    anchorAbsoluteDepth: z.ZodNumber;
+}, z.core.$strip>;
+
+declare const ViewportSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    scrollX: z.ZodNumber;
+    scrollY: z.ZodNumber;
+}, z.core.$strip>;
+
+export declare type ViewportState = z.infer<typeof ViewportSchema>;
+
+export { }