@oyerinde/caliper 0.2.0 → 0.2.2

package/dist/{chunk-ACV6FK43.js → chunk-PRUCSUJA.js}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { JSONRPCErrorResponseSchema as JSONRPCErrorResponseSchema$1, JSONRPCResultResponseSchema as JSONRPCResultResponseSchema$1 } from '@modelcontextprotocol/sdk/types.js';
+import { JSONRPCErrorResponseSchema as JSONRPCErrorResponseSchema$1 } from '@modelcontextprotocol/sdk/types.js';
 
 /**
  * @name @oyerinde/caliper
@@ -228,7 +228,6 @@ var WalkOptionsSchema = z.object({
   minElementSize: z.number().optional(),
   ignoreSelectors: z.array(z.string()).optional()
 });
-var JSONRPCResultResponseSchema = JSONRPCResultResponseSchema$1;
 var JSONRPCErrorResponseSchema = JSONRPCErrorResponseSchema$1;
 var ViewportSchema = z.object({
   width: z.number(),
@@ -288,8 +287,20 @@ var SourceHintsSchema = z.object({
   tagName: z.string()
 });
 var CaliperActionResultSchema = z.union([
-  z.object({ success: z.literal(true), method: z.literal(CALIPER_METHODS.SELECT), selector: z.string(), selection: SelectionMetadataSchema, timestamp: z.number() }),
-  z.object({ success: z.literal(true), method: z.literal(CALIPER_METHODS.MEASURE), selector: z.string(), measurement: MeasurementResultSchema, timestamp: z.number() }),
+  z.object({
+    success: z.literal(true),
+    method: z.literal(CALIPER_METHODS.SELECT),
+    selector: z.string(),
+    selection: SelectionMetadataSchema,
+    timestamp: z.number()
+  }),
+  z.object({
+    success: z.literal(true),
+    method: z.literal(CALIPER_METHODS.MEASURE),
+    selector: z.string(),
+    measurement: MeasurementResultSchema,
+    timestamp: z.number()
+  }),
   z.object({
     success: z.literal(true),
     method: z.literal(CALIPER_METHODS.INSPECT),
@@ -310,8 +321,16 @@ var CaliperActionResultSchema = z.union([
     sourceHints: SourceHintsSchema.optional(),
     timestamp: z.number()
   }),
-  z.object({ success: z.literal(true), method: z.literal(CALIPER_METHODS.FREEZE), timestamp: z.number() }),
-  z.object({ success: z.literal(true), method: z.literal(CALIPER_METHODS.CLEAR), timestamp: z.number() }),
+  z.object({
+    success: z.literal(true),
+    method: z.literal(CALIPER_METHODS.FREEZE),
+    timestamp: z.number()
+  }),
+  z.object({
+    success: z.literal(true),
+    method: z.literal(CALIPER_METHODS.CLEAR),
+    timestamp: z.number()
+  }),
   z.object({
     success: z.literal(true),
     method: z.literal(CALIPER_METHODS.WALK_DOM),
@@ -398,11 +417,7 @@ var CaliperNotificationSchema = z.union([
     params: CaliperAgentStateSchema
   })
 ]);
-z.union([
-  CaliperResponseSchema,
-  CaliperNotificationSchema,
-  JSONRPCResultResponseSchema
-]);
+z.union([CaliperResponseSchema, CaliperNotificationSchema]);
 var CaliperSelectPayloadSchema = z.object({
   selector: z.string()
 });
@@ -1360,10 +1375,12 @@ var Logger = class {
     isGlobalEnabled = enabled;
   }
   debug(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.debug(this.prefix, ...args);
   }
   info(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.info(this.prefix, ...args);
   }
   warn(...args) {
     if (!isGlobalEnabled) return;
@@ -1374,7 +1391,8 @@ var Logger = class {
     console.error(this.prefix, ...args);
   }
   log(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.log(this.prefix, ...args);
   }
 };
 new Logger({ prefix: "Caliper" });
@@ -15072,7 +15090,7 @@ var JSONRPCNotificationSchema = object({
   jsonrpc: literal(JSONRPC_VERSION),
   ...NotificationSchema.shape
 }).strict();
-var JSONRPCResultResponseSchema2 = object({
+var JSONRPCResultResponseSchema = object({
   jsonrpc: literal(JSONRPC_VERSION),
   id: RequestIdSchema,
   result: ResultSchema
@@ -15109,10 +15127,10 @@ var JSONRPCErrorResponseSchema2 = object({
 union([
   JSONRPCRequestSchema,
   JSONRPCNotificationSchema,
-  JSONRPCResultResponseSchema2,
+  JSONRPCResultResponseSchema,
   JSONRPCErrorResponseSchema2
 ]);
-union([JSONRPCResultResponseSchema2, JSONRPCErrorResponseSchema2]);
+union([JSONRPCResultResponseSchema, JSONRPCErrorResponseSchema2]);
 var EmptyResultSchema = ResultSchema.strict();
 var CancelledNotificationParamsSchema = NotificationsParamsSchema.extend({
   /**
@@ -16676,7 +16694,7 @@ var WalkOptionsSchema2 = external_exports.object({
 });
 var JSONRPCRequestSchema2 = JSONRPCRequestSchema;
 var JSONRPCNotificationSchema2 = JSONRPCNotificationSchema;
-var JSONRPCResultResponseSchema22 = JSONRPCResultResponseSchema2;
+var JSONRPCResultResponseSchema2 = JSONRPCResultResponseSchema;
 var JSONRPCErrorResponseSchema22 = JSONRPCErrorResponseSchema2;
 var ViewportSchema2 = external_exports.object({
   width: external_exports.number(),
@@ -16736,8 +16754,20 @@ var SourceHintsSchema2 = external_exports.object({
   tagName: external_exports.string()
 });
 var CaliperActionResultSchema2 = external_exports.union([
-  external_exports.object({ success: external_exports.literal(true), method: external_exports.literal(CALIPER_METHODS2.SELECT), selector: external_exports.string(), selection: SelectionMetadataSchema2, timestamp: external_exports.number() }),
-  external_exports.object({ success: external_exports.literal(true), method: external_exports.literal(CALIPER_METHODS2.MEASURE), selector: external_exports.string(), measurement: MeasurementResultSchema2, timestamp: external_exports.number() }),
+  external_exports.object({
+    success: external_exports.literal(true),
+    method: external_exports.literal(CALIPER_METHODS2.SELECT),
+    selector: external_exports.string(),
+    selection: SelectionMetadataSchema2,
+    timestamp: external_exports.number()
+  }),
+  external_exports.object({
+    success: external_exports.literal(true),
+    method: external_exports.literal(CALIPER_METHODS2.MEASURE),
+    selector: external_exports.string(),
+    measurement: MeasurementResultSchema2,
+    timestamp: external_exports.number()
+  }),
   external_exports.object({
     success: external_exports.literal(true),
     method: external_exports.literal(CALIPER_METHODS2.INSPECT),
@@ -16758,8 +16788,16 @@ var CaliperActionResultSchema2 = external_exports.union([
     sourceHints: SourceHintsSchema2.optional(),
     timestamp: external_exports.number()
   }),
-  external_exports.object({ success: external_exports.literal(true), method: external_exports.literal(CALIPER_METHODS2.FREEZE), timestamp: external_exports.number() }),
-  external_exports.object({ success: external_exports.literal(true), method: external_exports.literal(CALIPER_METHODS2.CLEAR), timestamp: external_exports.number() }),
+  external_exports.object({
+    success: external_exports.literal(true),
+    method: external_exports.literal(CALIPER_METHODS2.FREEZE),
+    timestamp: external_exports.number()
+  }),
+  external_exports.object({
+    success: external_exports.literal(true),
+    method: external_exports.literal(CALIPER_METHODS2.CLEAR),
+    timestamp: external_exports.number()
+  }),
   external_exports.object({
     success: external_exports.literal(true),
     method: external_exports.literal(CALIPER_METHODS2.WALK_DOM),
@@ -16819,13 +16857,21 @@ var RpcFactory = class {
     return JSONRPCRequestSchema2.parse({ jsonrpc: "2.0", method, params, id });
   }
   static response(id, result) {
-    return JSONRPCResultResponseSchema22.parse({ jsonrpc: "2.0", id, result });
+    return JSONRPCResultResponseSchema2.parse({ jsonrpc: "2.0", id, result });
   }
   static error(id, code, message, data) {
-    return JSONRPCErrorResponseSchema22.parse({ jsonrpc: "2.0", id, error: { code, message, data } });
+    return JSONRPCErrorResponseSchema22.parse({
+      jsonrpc: "2.0",
+      id,
+      error: { code, message, data }
+    });
   }
   static notification(method, params) {
-    return JSONRPCNotificationSchema2.parse({ jsonrpc: "2.0", method, params });
+    return JSONRPCNotificationSchema2.parse({
+      jsonrpc: "2.0",
+      method,
+      params
+    });
   }
 };
 var CaliperResponseSchema2 = external_exports.union([
@@ -16860,11 +16906,7 @@ var CaliperNotificationSchema2 = external_exports.union([
     params: CaliperAgentStateSchema2
   })
 ]);
-external_exports.union([
-  CaliperResponseSchema2,
-  CaliperNotificationSchema2,
-  JSONRPCResultResponseSchema22
-]);
+external_exports.union([CaliperResponseSchema2, CaliperNotificationSchema2]);
 external_exports.object({
   selector: external_exports.string()
 });
@@ -18562,6 +18604,12 @@ function CaliperBridge(config2) {
         const disposeSync = initStateSync(stateStore, systems, (state) => {
           wsBridge.sendStateUpdate(state);
           config2.onStateChange?.(state);
+          if (config2.onStateChangeGlobal) {
+            const globalCallback = window[config2.onStateChangeGlobal];
+            if (typeof globalCallback === "function") {
+              globalCallback(state);
+            }
+          }
         });
         window.dispatchCaliperIntent = async (intent) => {
           if (!intentHandler) {

package/dist/{chunk-XYBNY4BT.js → chunk-YLE25XII.js}

@@ -2850,8 +2850,7 @@ function getConfig() {
           ...parsed,
           theme: { ...windowConfig.theme, ...parsed.theme },
           commands: { ...windowConfig.commands, ...parsed.commands },
-          animation: { ...windowConfig.animation, ...parsed.animation },
-          bridge: { ...windowConfig.bridge, ...parsed.bridge }
+          animation: { ...windowConfig.animation, ...parsed.animation }
         };
       } catch (e) {
         console.warn("[CALIPER] Failed to parse data-config attribute", e);
@@ -3031,10 +3030,12 @@ var Logger = class {
     isGlobalEnabled = enabled;
   }
   debug(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.debug(this.prefix, ...args);
   }
   info(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.info(this.prefix, ...args);
   }
   warn(...args) {
     if (!isGlobalEnabled) return;
@@ -3045,7 +3046,8 @@ var Logger = class {
     console.error(this.prefix, ...args);
   }
   log(...args) {
-    return;
+    if (!isGlobalEnabled) return;
+    console.log(this.prefix, ...args);
   }
 };
 var logger = new Logger({ prefix: "Caliper" });
@@ -3434,11 +3436,11 @@ function MeasurementLinesWithCalculator(props) {
             };
           }
           if (line.type === "top" || line.type === "bottom") {
-            if (line.startSync === "primary") end.x = start.x;
-            else start.x = end.x;
+            if (line.type === "top") start.x = end.x;
+            else end.x = start.x;
           } else if (line.type === "left" || line.type === "right") {
-            if (line.startSync === "primary") end.y = start.y;
-            else start.y = end.y;
+            if (line.type === "left") start.y = end.y;
+            else end.y = start.y;
           }
           let liveValue = 0;
           if (line.type === "top" || line.type === "bottom") {
@@ -3536,11 +3538,11 @@ function MeasurementLabels(props) {
             };
           }
           if (line.type === "top" || line.type === "bottom") {
-            if (line.startSync === "primary") end.x = start.x;
-            else start.x = end.x;
+            if (line.type === "top") start.x = end.x;
+            else end.x = start.x;
           } else if (line.type === "left" || line.type === "right") {
-            if (line.startSync === "primary") end.y = start.y;
-            else start.y = end.y;
+            if (line.type === "left") start.y = end.y;
+            else end.y = start.y;
           }
           const naturalX = (start.x + end.x) / 2;
           const naturalY = (start.y + end.y) / 2;
@@ -3755,16 +3757,27 @@ function BoundaryBoxes(props) {
       height: next.height
     };
   };
-  const liveSelectionTarget = createMemo(() => {
+  const isDegenerate = (geo) => geo !== null && geo.width === 0 && geo.height === 0;
+  const liveSelectionTarget = createMemo((prev) => {
     props.viewport.version;
-    return getLiveGeometry(props.metadata.rect, props.metadata.scrollHierarchy, props.metadata.position, props.metadata.stickyConfig, props.metadata.initialWindowX, props.metadata.initialWindowY);
-  });
-  const liveSecondaryTarget = createMemo(() => {
+    if (prev && props.metadata.element && !document.contains(props.metadata.element)) {
+      return prev;
+    }
+    const geo = getLiveGeometry(props.metadata.rect, props.metadata.scrollHierarchy, props.metadata.position, props.metadata.stickyConfig, props.metadata.initialWindowX, props.metadata.initialWindowY);
+    if (isDegenerate(geo)) return prev;
+    return geo;
+  }, null);
+  const liveSecondaryTarget = createMemo((prev) => {
     props.viewport.version;
     const res = props.result;
     if (!(props.isActivatePressed || props.isFrozen) || !res) return null;
-    return getLiveGeometry(res.secondary, res.secondaryHierarchy, res.secondaryPosition, res.secondarySticky, res.secondaryWinX, res.secondaryWinY);
-  });
+    if (prev && res.secondaryElement && !document.contains(res.secondaryElement)) {
+      return prev;
+    }
+    const geo = getLiveGeometry(res.secondary, res.secondaryHierarchy, res.secondaryPosition, res.secondarySticky, res.secondaryWinX, res.secondaryWinY);
+    if (isDegenerate(geo)) return prev;
+    return geo;
+  }, null);
   createEffect(on([liveSelectionTarget, liveSecondaryTarget, () => props.animation.lerpFactor, () => props.metadata.element], ([selection, secondary, factor, element]) => {
     if (!selection) {
       setAnchor(null);
@@ -5093,27 +5106,48 @@ function Root(config) {
         contextEvent.preventDefault();
         contextEvent.stopImmediatePropagation();
         let clipboardContent = "";
-        if (contextEvent.shiftKey && selectedElement) {
-          clipboardContent = selectedElement.getAttribute("data-caliper-agent-id") || "";
-        } else if (measurementResult && system && selectionSystem) {
-          const primaryElement = selectionSystem.getSelected();
-          const secondaryElement = system.getSecondaryElement();
-          if (primaryElement && secondaryElement) {
-            clipboardContent = JSON.stringify({
-              primary: buildSelectorInfo(primaryElement, selectionMetadata()),
-              secondary: buildSelectorInfo(secondaryElement, {
-                rect: measurementResult.secondary,
-                scrollHierarchy: measurementResult.secondaryHierarchy,
-                position: measurementResult.secondaryPosition,
-                stickyConfig: measurementResult.secondarySticky,
-                initialWindowX: measurementResult.secondaryWinX,
-                initialWindowY: measurementResult.secondaryWinY,
-                hasContainingBlock: measurementResult.secondaryHasContainingBlock
-              })
-            });
+        if (contextEvent.shiftKey) {
+          if (measurementResult && system && selectionSystem) {
+            const primaryElement = selectionSystem.getSelected();
+            const secondaryElement = system.getSecondaryElement();
+            if (primaryElement && secondaryElement) {
+              clipboardContent = JSON.stringify({
+                primary: buildSelectorInfo(primaryElement, selectionMetadata()),
+                secondary: buildSelectorInfo(secondaryElement, {
+                  rect: measurementResult.secondary,
+                  scrollHierarchy: measurementResult.secondaryHierarchy,
+                  position: measurementResult.secondaryPosition,
+                  stickyConfig: measurementResult.secondarySticky,
+                  initialWindowX: measurementResult.secondaryWinX,
+                  initialWindowY: measurementResult.secondaryWinY,
+                  hasContainingBlock: measurementResult.secondaryHasContainingBlock
+                })
+              });
+            }
+          } else if (selectedElement) {
+            clipboardContent = JSON.stringify(buildSelectorInfo(selectedElement, selectionMetadata()));
+          }
+        } else {
+          const ensureAgentId = (el) => {
+            let id = el.getAttribute("data-caliper-agent-id");
+            if (!id) {
+              id = generateId("caliper");
+              el.setAttribute("data-caliper-agent-id", id);
+            }
+            return id;
+          };
+          if (measurementResult && system && selectionSystem) {
+            const primaryElement = selectionSystem.getSelected();
+            const secondaryElement = system.getSecondaryElement();
+            if (primaryElement && secondaryElement) {
+              clipboardContent = JSON.stringify({
+                primary: ensureAgentId(primaryElement),
+                secondary: ensureAgentId(secondaryElement)
+              });
+            }
+          } else if (selectedElement) {
+            clipboardContent = ensureAgentId(selectedElement);
           }
-        } else if (selectedElement) {
-          clipboardContent = JSON.stringify(buildSelectorInfo(selectedElement, selectionMetadata()));
         }
         if (clipboardContent) {
           navigator.clipboard.writeText(clipboardContent).then(() => {
@@ -5170,12 +5204,13 @@ function Root(config) {
       if (selectedElement) {
         const hoveredElement = getTopElementAtPoint(e.clientX, e.clientY);
         const isAncestor = hoveredElement && lastHoveredElement && hoveredElement.contains(lastHoveredElement) && hoveredElement !== lastHoveredElement;
+        const lastHoveredDetached = lastHoveredElement && !document.contains(lastHoveredElement);
         if (isAlt) {
           if (system) {
             measureDelegate.execute(!!isAncestor, selectedElement, cursorPoint, hoveredElement);
           }
         } else if (state !== "FROZEN") {
-          if (hoveredElement) {
+          if (hoveredElement && !lastHoveredDetached) {
             selectionDelegate.execute(!!isAncestor, hoveredElement);
           }
         }
@@ -5553,14 +5588,14 @@ function Root(config) {
     let secondaryChanged = false;
     const runUpdates2 = () => {
       if (sentinelResized || primaryChanged) {
-        if (observedPrimary) {
+        if (observedPrimary && document.contains(observedPrimary)) {
           const rect = observedPrimary.getBoundingClientRect();
           selectionSystem?.updateRect(rect);
           if (system) system.updatePrimaryRect(rect);
         }
       }
       if (sentinelResized || secondaryChanged) {
-        if (observedSecondary) {
+        if (observedSecondary && document.contains(observedSecondary)) {
           const rect = observedSecondary.getBoundingClientRect();
           system?.updateSecondaryRect(rect);
         }
@@ -5875,11 +5910,11 @@ function createOverlay(config) {
   return instance;
 }
 if (IS_BROWSER2) {
-  showVersionInfo("0.2.0").catch(() => {
+  showVersionInfo("0.2.2").catch(() => {
   });
 }
 
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.2.2";
 
 export { VERSION, caliperProps, createOverlay, getConfig, setConfig };

package/dist/index.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
-var chunkOSQHATBH_cjs = require('./chunk-OSQHATBH.cjs');
+var chunkAHX2GS7J_cjs = require('./chunk-AHX2GS7J.cjs');
 
 
 
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.VERSION; }
+  get: function () { return chunkAHX2GS7J_cjs.VERSION; }
 });
 Object.defineProperty(exports, "caliperProps", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.caliperProps; }
+  get: function () { return chunkAHX2GS7J_cjs.caliperProps; }
 });
 Object.defineProperty(exports, "getConfig", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.getConfig; }
+  get: function () { return chunkAHX2GS7J_cjs.getConfig; }
 });
 Object.defineProperty(exports, "init", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.createOverlay; }
+  get: function () { return chunkAHX2GS7J_cjs.createOverlay; }
 });
 Object.defineProperty(exports, "setConfig", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.setConfig; }
+  get: function () { return chunkAHX2GS7J_cjs.setConfig; }
 });

package/dist/index.d.cts

@@ -7,6 +7,8 @@ export declare interface AgentBridgeConfig {
     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;
 }
 
 export declare interface AnimationConfig {
@@ -439,6 +441,17 @@ declare const CaliperAgentStateSchema: z.ZodObject<{
     lastUpdated: z.ZodNumber;
 }, z.core.$strip>;
 
+export declare interface CaliperConfig {
+    /** Customize the visual appearance of the overlay (colors, shadows). */
+    theme?: ThemeConfig;
+    /** Customize keyboard shortcuts for all interactions. */
+    commands?: CommandsConfig;
+    /** Control the boundary box lerp animation behavior. */
+    animation?: AnimationConfig;
+    /** Enable debug logging (default: true). All logs are stripped from production builds. */
+    debug?: boolean;
+}
+
 /**
  * A plugin allows extending Caliper's functionality by accessing the
  * OverlayInstance and internal systems.
@@ -491,9 +504,9 @@ export declare interface CommandsConfig {
  * 1. Global window object (`window.__CALIPER_CONFIG__`)
  * 2. `data-config` attribute on the script tag (useful for UMD/CDN usage)
  *
- * @returns The resolved OverlayConfig object.
+ * @returns The resolved CaliperConfig object.
  */
-export declare function getConfig(): OverlayConfig;
+export declare function getConfig(): CaliperConfig;
 
 /**
  * Core factory function to create and mount the Caliper overlay.
@@ -523,7 +536,7 @@ export declare function getConfig(): OverlayConfig;
  * @param config - The initial configuration object to merge with global defaults.
  * @returns An OverlayInstance with mount, dispose, and plugin management capabilities.
  */
-export declare function init(config?: OverlayConfig): OverlayInstance;
+export declare function init(config?: CaliperConfig): OverlayInstance;
 
 export declare type MeasurementLine = MeasurementLine_2;
 
@@ -729,18 +742,8 @@ export declare interface MeasurementSystem {
 
 export declare type MeasurementSystemListener = () => void;
 
-export declare interface OverlayConfig {
-    /** Customize the visual appearance of the overlay (colors, shadows). */
-    theme?: ThemeConfig;
-    /** Customize keyboard shortcuts for all interactions. */
-    commands?: CommandsConfig;
-    /** Control the boundary box lerp animation behavior. */
-    animation?: AnimationConfig;
-    /** Configure the Agent Bridge for AI/MCP integration. */
-    bridge?: AgentBridgeConfig;
-    /** Enable debug logging (default: true). All logs are stripped from production builds. */
-    debug?: boolean;
-}
+/** @deprecated Use CaliperConfig instead */
+export declare type OverlayConfig = CaliperConfig;
 
 /**
  * Handle to a running Caliper overlay.
@@ -948,7 +951,7 @@ export declare interface SelectionSystem {
  * });
  * ```
  */
-export declare function setConfig(config: OverlayConfig): void;
+export declare function setConfig(config: CaliperConfig): void;
 
 export declare interface Systems {
     measurementSystem: MeasurementSystem;

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export declare interface AgentBridgeConfig {
     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;
 }
 
 export declare interface AnimationConfig {
@@ -439,6 +441,17 @@ declare const CaliperAgentStateSchema: z.ZodObject<{
     lastUpdated: z.ZodNumber;
 }, z.core.$strip>;
 
+export declare interface CaliperConfig {
+    /** Customize the visual appearance of the overlay (colors, shadows). */
+    theme?: ThemeConfig;
+    /** Customize keyboard shortcuts for all interactions. */
+    commands?: CommandsConfig;
+    /** Control the boundary box lerp animation behavior. */
+    animation?: AnimationConfig;
+    /** Enable debug logging (default: true). All logs are stripped from production builds. */
+    debug?: boolean;
+}
+
 /**
  * A plugin allows extending Caliper's functionality by accessing the
  * OverlayInstance and internal systems.
@@ -491,9 +504,9 @@ export declare interface CommandsConfig {
  * 1. Global window object (`window.__CALIPER_CONFIG__`)
  * 2. `data-config` attribute on the script tag (useful for UMD/CDN usage)
  *
- * @returns The resolved OverlayConfig object.
+ * @returns The resolved CaliperConfig object.
  */
-export declare function getConfig(): OverlayConfig;
+export declare function getConfig(): CaliperConfig;
 
 /**
  * Core factory function to create and mount the Caliper overlay.
@@ -523,7 +536,7 @@ export declare function getConfig(): OverlayConfig;
  * @param config - The initial configuration object to merge with global defaults.
  * @returns An OverlayInstance with mount, dispose, and plugin management capabilities.
  */
-export declare function init(config?: OverlayConfig): OverlayInstance;
+export declare function init(config?: CaliperConfig): OverlayInstance;
 
 export declare type MeasurementLine = MeasurementLine_2;
 
@@ -729,18 +742,8 @@ export declare interface MeasurementSystem {
 
 export declare type MeasurementSystemListener = () => void;
 
-export declare interface OverlayConfig {
-    /** Customize the visual appearance of the overlay (colors, shadows). */
-    theme?: ThemeConfig;
-    /** Customize keyboard shortcuts for all interactions. */
-    commands?: CommandsConfig;
-    /** Control the boundary box lerp animation behavior. */
-    animation?: AnimationConfig;
-    /** Configure the Agent Bridge for AI/MCP integration. */
-    bridge?: AgentBridgeConfig;
-    /** Enable debug logging (default: true). All logs are stripped from production builds. */
-    debug?: boolean;
-}
+/** @deprecated Use CaliperConfig instead */
+export declare type OverlayConfig = CaliperConfig;
 
 /**
  * Handle to a running Caliper overlay.
@@ -948,7 +951,7 @@ export declare interface SelectionSystem {
  * });
  * ```
  */
-export declare function setConfig(config: OverlayConfig): void;
+export declare function setConfig(config: CaliperConfig): void;
 
 export declare interface Systems {
     measurementSystem: MeasurementSystem;