@oyerinde/caliper 0.2.0 → 0.2.2

package/dist/index.js

@@ -1 +1 @@
-export { VERSION, caliperProps, getConfig, createOverlay as init, setConfig } from './chunk-XYBNY4BT.js';
+export { VERSION, caliperProps, getConfig, createOverlay as init, setConfig } from './chunk-YLE25XII.js';

package/dist/mcp.cjs

@@ -297,8 +297,20 @@ var SourceHintsSchema = zod.z.object({
   tagName: zod.z.string()
 });
 var CaliperActionResultSchema = zod.z.union([
-  zod.z.object({ success: zod.z.literal(true), method: zod.z.literal(CALIPER_METHODS.SELECT), selector: zod.z.string(), selection: SelectionMetadataSchema, timestamp: zod.z.number() }),
-  zod.z.object({ success: zod.z.literal(true), method: zod.z.literal(CALIPER_METHODS.MEASURE), selector: zod.z.string(), measurement: MeasurementResultSchema, timestamp: zod.z.number() }),
+  zod.z.object({
+    success: zod.z.literal(true),
+    method: zod.z.literal(CALIPER_METHODS.SELECT),
+    selector: zod.z.string(),
+    selection: SelectionMetadataSchema,
+    timestamp: zod.z.number()
+  }),
+  zod.z.object({
+    success: zod.z.literal(true),
+    method: zod.z.literal(CALIPER_METHODS.MEASURE),
+    selector: zod.z.string(),
+    measurement: MeasurementResultSchema,
+    timestamp: zod.z.number()
+  }),
   zod.z.object({
     success: zod.z.literal(true),
     method: zod.z.literal(CALIPER_METHODS.INSPECT),
@@ -319,8 +331,16 @@ var CaliperActionResultSchema = zod.z.union([
     sourceHints: SourceHintsSchema.optional(),
     timestamp: zod.z.number()
   }),
-  zod.z.object({ success: zod.z.literal(true), method: zod.z.literal(CALIPER_METHODS.FREEZE), timestamp: zod.z.number() }),
-  zod.z.object({ success: zod.z.literal(true), method: zod.z.literal(CALIPER_METHODS.CLEAR), timestamp: zod.z.number() }),
+  zod.z.object({
+    success: zod.z.literal(true),
+    method: zod.z.literal(CALIPER_METHODS.FREEZE),
+    timestamp: zod.z.number()
+  }),
+  zod.z.object({
+    success: zod.z.literal(true),
+    method: zod.z.literal(CALIPER_METHODS.CLEAR),
+    timestamp: zod.z.number()
+  }),
   zod.z.object({
     success: zod.z.literal(true),
     method: zod.z.literal(CALIPER_METHODS.WALK_DOM),
@@ -383,10 +403,18 @@ var RpcFactory = class {
     return JSONRPCResultResponseSchema.parse({ jsonrpc: "2.0", id, result });
   }
   static error(id, code, message, data) {
-    return JSONRPCErrorResponseSchema.parse({ jsonrpc: "2.0", id, error: { code, message, data } });
+    return JSONRPCErrorResponseSchema.parse({
+      jsonrpc: "2.0",
+      id,
+      error: { code, message, data }
+    });
   }
   static notification(method, params) {
-    return JSONRPCNotificationSchema.parse({ jsonrpc: "2.0", method, params });
+    return JSONRPCNotificationSchema.parse({
+      jsonrpc: "2.0",
+      method,
+      params
+    });
   }
 };
 var isId = (value) => {
@@ -427,11 +455,16 @@ var CaliperNotificationSchema = zod.z.union([
     params: CaliperAgentStateSchema
   })
 ]);
-var BridgeMessageSchema = zod.z.union([
-  CaliperResponseSchema,
-  CaliperNotificationSchema,
-  JSONRPCResultResponseSchema
-]);
+var BridgeMessageSchema = zod.z.union([CaliperResponseSchema, CaliperNotificationSchema]);
+function isBridgeNotification(msg) {
+  return "method" in msg;
+}
+function isBridgeErrorResponse(msg) {
+  return "error" in msg;
+}
+function isBridgeResultResponse(msg) {
+  return "result" in msg;
+}
 zod.z.object({
   selector: zod.z.string()
 });
@@ -994,8 +1027,7 @@ var BridgeService = class extends events.EventEmitter {
             resolve();
           });
           server2.on("error", (error) => {
-            const err = error;
-            if (err.code === "EADDRINUSE" && remaining > 0) {
+            if (error.code === "EADDRINUSE" && remaining > 0) {
               const attemptNum = retries - remaining + 1;
               const delay = getExponentialBackoff(attemptNum - 1, 500);
               logger3.warn(
@@ -1007,7 +1039,7 @@ var BridgeService = class extends events.EventEmitter {
                 attemptStart(currentPort, remaining - 1).then(resolve).catch(reject);
               }, delay);
             } else {
-              const errorMessage = err.code === "EADDRINUSE" ? `Port ${currentPort} is already in use by another process. Please close the other instance of Caliper or use a different port.` : `WebSocket server error: ${String(error)}`;
+              const errorMessage = error.code === "EADDRINUSE" ? `Port ${currentPort} is already in use by another process. Please close the other instance of Caliper or use a different port.` : `WebSocket server error: ${String(error)}`;
               logger3.error(errorMessage);
               this.startupError = errorMessage;
               server2.close();
@@ -1060,40 +1092,7 @@ var BridgeService = class extends events.EventEmitter {
             return;
           }
           const message = result.data;
-          if ("id" in message) {
-            if ("result" in message) {
-              const resolve = this.pendingCalls.get(String(message.id));
-              if (resolve) {
-                const finalResult = message.result;
-                if (isCaliperActionResult(finalResult)) {
-                  if (finalResult.success && finalResult.method === CALIPER_METHODS.WALK_AND_MEASURE && binaryPayload) {
-                    try {
-                      const root = BitBridge.deserialize(binaryPayload);
-                      if ("walkResult" in finalResult) {
-                        finalResult.walkResult.root = root;
-                      }
-                    } catch (error) {
-                      logger3.error("Bit-Bridge reconstruction failed:", error);
-                    }
-                  }
-                  resolve(finalResult);
-                } else if (finalResult && typeof finalResult === "object" && "error" in finalResult) {
-                  resolve(finalResult);
-                } else {
-                  resolve({ error: "Unexpected result format received from bridge" });
-                }
-                this.pendingCalls.delete(String(message.id));
-              }
-            } else if ("error" in message) {
-              if (message.id !== null) {
-                const resolve = this.pendingCalls.get(String(message.id));
-                if (resolve) {
-                  resolve({ error: message.error.message });
-                  this.pendingCalls.delete(String(message.id));
-                }
-              }
-            }
-          } else if ("method" in message) {
+          if (isBridgeNotification(message)) {
             if (message.method === CALIPER_METHODS.REGISTER_TAB) {
               const { tabId: newTabId, url, title, isFocused } = message.params;
               tabId = newTabId;
@@ -1110,9 +1109,46 @@ var BridgeService = class extends events.EventEmitter {
                 tabManager.updateTab(tabId, isFocused);
               }
             } else if (message.method === CALIPER_METHODS.STATE_UPDATE) {
-              const state = message.params;
-              this.emit(BRIDGE_EVENTS.STATE, state);
+              this.emit(BRIDGE_EVENTS.STATE, message.params);
+            }
+            return;
+          }
+          if (isBridgeErrorResponse(message)) {
+            if (message.id !== null) {
+              const resolve = this.pendingCalls.get(String(message.id));
+              if (resolve) {
+                resolve({ error: message.error.message });
+                this.pendingCalls.delete(String(message.id));
+              }
+            }
+            return;
+          }
+          if (isBridgeResultResponse(message)) {
+            const resolve = this.pendingCalls.get(String(message.id));
+            if (!resolve) return;
+            const finalResult = message.result;
+            if (isCaliperActionResult(finalResult)) {
+              if ("walkResult" in finalResult && binaryPayload) {
+                try {
+                  const raw = BitBridge.deserialize(binaryPayload);
+                  const parsed = CaliperNodeSchema.safeParse(raw);
+                  if (parsed.success) {
+                    finalResult.walkResult.root = parsed.data;
+                  } else {
+                    logger3.error(
+                      "Bit-Bridge deserialized node failed schema validation",
+                      zod.z.treeifyError(parsed.error)
+                    );
+                  }
+                } catch (error) {
+                  logger3.error("Bit-Bridge reconstruction failed:", error);
+                }
+              }
+              resolve(finalResult);
+            } else {
+              resolve({ error: "Unexpected result format received from bridge" });
             }
+            this.pendingCalls.delete(String(message.id));
           }
         } catch (error) {
           logger3.error("WS Message Processing Error:", error);
@@ -1634,7 +1670,7 @@ var CaliperMcpServer = class {
     this.port = port2;
     this.server = new mcp_js.McpServer({
       name: "caliper-mcp-server",
-      version: "0.2.0"
+      version: "0.2.2"
     });
     this.registerTools();
     this.registerResources();
@@ -2287,7 +2323,7 @@ Options:
 `);
       process.exit(0);
     } else if (args[i] === "--docs" || args[i] === "-d") {
-      console.log("\n\u{1F4DA} View Documentation: https://caliper.danieloyerinde.com/\n");
+      console.error("\n\u{1F4DA} View Documentation: https://caliper.danieloyerinde.com/\n");
       process.exit(0);
     }
   }

package/dist/mcp.js

@@ -2,7 +2,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { JSONRPCErrorResponseSchema as JSONRPCErrorResponseSchema$1, JSONRPCResultResponseSchema as JSONRPCResultResponseSchema$1, JSONRPCRequestSchema as JSONRPCRequestSchema$1, JSONRPCNotificationSchema as JSONRPCNotificationSchema$1 } from '@modelcontextprotocol/sdk/types.js';
+import { JSONRPCErrorResponseSchema as JSONRPCErrorResponseSchema$1, JSONRPCRequestSchema as JSONRPCRequestSchema$1, JSONRPCResultResponseSchema as JSONRPCResultResponseSchema$1, JSONRPCNotificationSchema as JSONRPCNotificationSchema$1 } from '@modelcontextprotocol/sdk/types.js';
 import { WebSocketServer } from 'ws';
 import { EventEmitter } from 'events';
 
@@ -295,8 +295,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),
@@ -317,8 +329,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),
@@ -381,10 +401,18 @@ var RpcFactory = class {
     return JSONRPCResultResponseSchema.parse({ jsonrpc: "2.0", id, result });
   }
   static error(id, code, message, data) {
-    return JSONRPCErrorResponseSchema.parse({ jsonrpc: "2.0", id, error: { code, message, data } });
+    return JSONRPCErrorResponseSchema.parse({
+      jsonrpc: "2.0",
+      id,
+      error: { code, message, data }
+    });
   }
   static notification(method, params) {
-    return JSONRPCNotificationSchema.parse({ jsonrpc: "2.0", method, params });
+    return JSONRPCNotificationSchema.parse({
+      jsonrpc: "2.0",
+      method,
+      params
+    });
   }
 };
 var isId = (value) => {
@@ -425,11 +453,16 @@ var CaliperNotificationSchema = z.union([
     params: CaliperAgentStateSchema
   })
 ]);
-var BridgeMessageSchema = z.union([
-  CaliperResponseSchema,
-  CaliperNotificationSchema,
-  JSONRPCResultResponseSchema
-]);
+var BridgeMessageSchema = z.union([CaliperResponseSchema, CaliperNotificationSchema]);
+function isBridgeNotification(msg) {
+  return "method" in msg;
+}
+function isBridgeErrorResponse(msg) {
+  return "error" in msg;
+}
+function isBridgeResultResponse(msg) {
+  return "result" in msg;
+}
 z.object({
   selector: z.string()
 });
@@ -992,8 +1025,7 @@ var BridgeService = class extends EventEmitter {
             resolve();
           });
           server2.on("error", (error) => {
-            const err = error;
-            if (err.code === "EADDRINUSE" && remaining > 0) {
+            if (error.code === "EADDRINUSE" && remaining > 0) {
               const attemptNum = retries - remaining + 1;
               const delay = getExponentialBackoff(attemptNum - 1, 500);
               logger3.warn(
@@ -1005,7 +1037,7 @@ var BridgeService = class extends EventEmitter {
                 attemptStart(currentPort, remaining - 1).then(resolve).catch(reject);
               }, delay);
             } else {
-              const errorMessage = err.code === "EADDRINUSE" ? `Port ${currentPort} is already in use by another process. Please close the other instance of Caliper or use a different port.` : `WebSocket server error: ${String(error)}`;
+              const errorMessage = error.code === "EADDRINUSE" ? `Port ${currentPort} is already in use by another process. Please close the other instance of Caliper or use a different port.` : `WebSocket server error: ${String(error)}`;
               logger3.error(errorMessage);
               this.startupError = errorMessage;
               server2.close();
@@ -1058,40 +1090,7 @@ var BridgeService = class extends EventEmitter {
             return;
           }
           const message = result.data;
-          if ("id" in message) {
-            if ("result" in message) {
-              const resolve = this.pendingCalls.get(String(message.id));
-              if (resolve) {
-                const finalResult = message.result;
-                if (isCaliperActionResult(finalResult)) {
-                  if (finalResult.success && finalResult.method === CALIPER_METHODS.WALK_AND_MEASURE && binaryPayload) {
-                    try {
-                      const root = BitBridge.deserialize(binaryPayload);
-                      if ("walkResult" in finalResult) {
-                        finalResult.walkResult.root = root;
-                      }
-                    } catch (error) {
-                      logger3.error("Bit-Bridge reconstruction failed:", error);
-                    }
-                  }
-                  resolve(finalResult);
-                } else if (finalResult && typeof finalResult === "object" && "error" in finalResult) {
-                  resolve(finalResult);
-                } else {
-                  resolve({ error: "Unexpected result format received from bridge" });
-                }
-                this.pendingCalls.delete(String(message.id));
-              }
-            } else if ("error" in message) {
-              if (message.id !== null) {
-                const resolve = this.pendingCalls.get(String(message.id));
-                if (resolve) {
-                  resolve({ error: message.error.message });
-                  this.pendingCalls.delete(String(message.id));
-                }
-              }
-            }
-          } else if ("method" in message) {
+          if (isBridgeNotification(message)) {
             if (message.method === CALIPER_METHODS.REGISTER_TAB) {
               const { tabId: newTabId, url, title, isFocused } = message.params;
               tabId = newTabId;
@@ -1108,9 +1107,46 @@ var BridgeService = class extends EventEmitter {
                 tabManager.updateTab(tabId, isFocused);
               }
             } else if (message.method === CALIPER_METHODS.STATE_UPDATE) {
-              const state = message.params;
-              this.emit(BRIDGE_EVENTS.STATE, state);
+              this.emit(BRIDGE_EVENTS.STATE, message.params);
+            }
+            return;
+          }
+          if (isBridgeErrorResponse(message)) {
+            if (message.id !== null) {
+              const resolve = this.pendingCalls.get(String(message.id));
+              if (resolve) {
+                resolve({ error: message.error.message });
+                this.pendingCalls.delete(String(message.id));
+              }
+            }
+            return;
+          }
+          if (isBridgeResultResponse(message)) {
+            const resolve = this.pendingCalls.get(String(message.id));
+            if (!resolve) return;
+            const finalResult = message.result;
+            if (isCaliperActionResult(finalResult)) {
+              if ("walkResult" in finalResult && binaryPayload) {
+                try {
+                  const raw = BitBridge.deserialize(binaryPayload);
+                  const parsed = CaliperNodeSchema.safeParse(raw);
+                  if (parsed.success) {
+                    finalResult.walkResult.root = parsed.data;
+                  } else {
+                    logger3.error(
+                      "Bit-Bridge deserialized node failed schema validation",
+                      z.treeifyError(parsed.error)
+                    );
+                  }
+                } catch (error) {
+                  logger3.error("Bit-Bridge reconstruction failed:", error);
+                }
+              }
+              resolve(finalResult);
+            } else {
+              resolve({ error: "Unexpected result format received from bridge" });
             }
+            this.pendingCalls.delete(String(message.id));
           }
         } catch (error) {
           logger3.error("WS Message Processing Error:", error);
@@ -1632,7 +1668,7 @@ var CaliperMcpServer = class {
     this.port = port2;
     this.server = new McpServer({
       name: "caliper-mcp-server",
-      version: "0.2.0"
+      version: "0.2.2"
     });
     this.registerTools();
     this.registerResources();
@@ -2285,7 +2321,7 @@ Options:
 `);
       process.exit(0);
     } else if (args[i] === "--docs" || args[i] === "-d") {
-      console.log("\n\u{1F4DA} View Documentation: https://caliper.danieloyerinde.com/\n");
+      console.error("\n\u{1F4DA} View Documentation: https://caliper.danieloyerinde.com/\n");
       process.exit(0);
     }
   }

package/dist/preset.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkOSQHATBH_cjs = require('./chunk-OSQHATBH.cjs');
-var chunk3W2YKDGV_cjs = require('./chunk-3W2YKDGV.cjs');
+var chunkAHX2GS7J_cjs = require('./chunk-AHX2GS7J.cjs');
+var chunk2SVFU7M3_cjs = require('./chunk-2SVFU7M3.cjs');
 
 /**
  * @name @oyerinde/caliper
@@ -16,7 +16,7 @@ var chunk3W2YKDGV_cjs = require('./chunk-3W2YKDGV.cjs');
 
 // src/preset.ts
 function init(configuration, extensions = []) {
-  const caliperInstance = chunkOSQHATBH_cjs.createOverlay(configuration);
+  const caliperInstance = chunkAHX2GS7J_cjs.createOverlay(configuration);
   if (extensions && Array.isArray(extensions)) {
     extensions.forEach((extension) => {
       if (typeof extension === "function") {
@@ -31,14 +31,14 @@ function init(configuration, extensions = []) {
 
 Object.defineProperty(exports, "caliperProps", {
   enumerable: true,
-  get: function () { return chunkOSQHATBH_cjs.caliperProps; }
+  get: function () { return chunkAHX2GS7J_cjs.caliperProps; }
 });
 Object.defineProperty(exports, "CaliperAgentStateSchema", {
   enumerable: true,
-  get: function () { return chunk3W2YKDGV_cjs.CaliperAgentStateSchema; }
+  get: function () { return chunk2SVFU7M3_cjs.CaliperAgentStateSchema; }
 });
 Object.defineProperty(exports, "CaliperBridge", {
   enumerable: true,
-  get: function () { return chunk3W2YKDGV_cjs.CaliperBridge; }
+  get: function () { return chunk2SVFU7M3_cjs.CaliperBridge; }
 });
 exports.init = init;

package/dist/preset.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 {
@@ -467,7 +469,7 @@ export declare const CaliperAgentStateSchema: z.ZodObject<{
  * 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.
+ * 3. Syncs the overlay state (selection, measurements) back to the agent.
  *
  * @example
  * ```ts
@@ -488,9 +490,15 @@ export declare const CaliperAgentStateSchema: z.ZodObject<{
  */
 export declare function CaliperBridge(config: AgentBridgeConfig): CaliperPlugin;
 
-export declare interface CaliperCoreSystems {
-    measurementSystem: MeasurementSystem;
-    selectionSystem: SelectionSystem;
+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;
 }
 
 /**
@@ -571,7 +579,7 @@ export declare type Extension = ((instance: OverlayInstance) => void) | CaliperP
  * @param extensions - An array of functions or plugin objects to install immediately.
  * @returns The initialized Caliper OverlayInstance.
  */
-export declare function init(configuration?: OverlayConfig, extensions?: Array<Extension>): OverlayInstance;
+export declare function init(configuration?: CaliperConfig, extensions?: Array<Extension>): OverlayInstance;
 
 declare type MeasurementResult = Remap<MeasurementResult_2, {
     primary: DOMRect;
@@ -746,19 +754,6 @@ declare interface MeasurementSystem {
 
 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;
-}
-
 /**
  * Handle to a running Caliper overlay.
  */
@@ -775,12 +770,12 @@ export declare interface OverlayInstance {
     /**
      * Synchronously returns the internal systems if they are initialized.
      */
-    getSystems: () => CaliperCoreSystems | null;
+    getSystems: () => Systems | 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>;
+    waitForSystems: () => Promise<Systems>;
     /**
      * Registers a plugin with this instance.
      */
@@ -949,6 +944,11 @@ declare interface SelectionSystem {
     updateRect: (rect: DOMRect) => void;
 }
 
+export declare interface Systems {
+    measurementSystem: MeasurementSystem;
+    selectionSystem: SelectionSystem;
+}
+
 export declare interface ThemeConfig {
     primary?: string;
     secondary?: string;

package/dist/preset.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 {
@@ -467,7 +469,7 @@ export declare const CaliperAgentStateSchema: z.ZodObject<{
  * 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.
+ * 3. Syncs the overlay state (selection, measurements) back to the agent.
  *
  * @example
  * ```ts
@@ -488,9 +490,15 @@ export declare const CaliperAgentStateSchema: z.ZodObject<{
  */
 export declare function CaliperBridge(config: AgentBridgeConfig): CaliperPlugin;
 
-export declare interface CaliperCoreSystems {
-    measurementSystem: MeasurementSystem;
-    selectionSystem: SelectionSystem;
+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;
 }
 
 /**
@@ -571,7 +579,7 @@ export declare type Extension = ((instance: OverlayInstance) => void) | CaliperP
  * @param extensions - An array of functions or plugin objects to install immediately.
  * @returns The initialized Caliper OverlayInstance.
  */
-export declare function init(configuration?: OverlayConfig, extensions?: Array<Extension>): OverlayInstance;
+export declare function init(configuration?: CaliperConfig, extensions?: Array<Extension>): OverlayInstance;
 
 declare type MeasurementResult = Remap<MeasurementResult_2, {
     primary: DOMRect;
@@ -746,19 +754,6 @@ declare interface MeasurementSystem {
 
 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;
-}
-
 /**
  * Handle to a running Caliper overlay.
  */
@@ -775,12 +770,12 @@ export declare interface OverlayInstance {
     /**
      * Synchronously returns the internal systems if they are initialized.
      */
-    getSystems: () => CaliperCoreSystems | null;
+    getSystems: () => Systems | 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>;
+    waitForSystems: () => Promise<Systems>;
     /**
      * Registers a plugin with this instance.
      */
@@ -949,6 +944,11 @@ declare interface SelectionSystem {
     updateRect: (rect: DOMRect) => void;
 }
 
+export declare interface Systems {
+    measurementSystem: MeasurementSystem;
+    selectionSystem: SelectionSystem;
+}
+
 export declare interface ThemeConfig {
     primary?: string;
     secondary?: string;

package/dist/preset.js

@@ -1,6 +1,6 @@
-import { createOverlay } from './chunk-XYBNY4BT.js';
-export { caliperProps } from './chunk-XYBNY4BT.js';
-export { CaliperAgentStateSchema, CaliperBridge } from './chunk-ACV6FK43.js';
+import { createOverlay } from './chunk-YLE25XII.js';
+export { caliperProps } from './chunk-YLE25XII.js';
+export { CaliperAgentStateSchema, CaliperBridge } from './chunk-PRUCSUJA.js';
 
 /**
  * @name @oyerinde/caliper

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.2.0",
-  "timestamp": "2026-02-12T22:43:35.307Z"
+  "version": "0.2.2",
+  "timestamp": "2026-03-06T19:06:43.224Z"
 }