agent-web-interface 4.0.0

package/dist/src/state/health.types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Health Types
+ *
+ * Types for tracking CDP session health, snapshot capture health,
+ * and runtime health information in tool responses.
+ *
+ * These types enable:
+ * - Specific failure classification (not just success/failure)
+ * - Degraded state detection (connected but CDP dead)
+ * - Recovery telemetry in responses
+ */
+/**
+ * Snapshot health codes - specific reasons for snapshot failures.
+ * More granular than boolean valid/invalid.
+ */
+export type SnapshotHealthCode = 'HEALTHY' | 'PENDING_DOM' | 'AX_EMPTY' | 'DOM_EMPTY' | 'CDP_SESSION_DEAD' | 'UNKNOWN';
+/**
+ * CDP session health status.
+ * Tracks whether the CDP session is operational and if recovery occurred.
+ */
+export interface CdpHealth {
+    /** Whether CDP session is operational */
+    ok: boolean;
+    /** Whether recovery was attempted and succeeded */
+    recovered?: boolean;
+    /** Recovery method used if recovery occurred */
+    recovery_method?: 'rebind';
+    /** Error message if not ok */
+    error?: string;
+}
+/**
+ * Detailed CDP health diagnostics from PuppeteerCdpClient.
+ */
+export interface CdpHealthDiagnostics {
+    /** Whether session is active */
+    active: boolean;
+    /** Last error message if any */
+    lastError?: string;
+    /** Timestamp of last error */
+    lastErrorTime?: Date;
+}
+/**
+ * Snapshot capture health status.
+ * Tracks whether snapshot is usable and recovery details.
+ */
+export interface SnapshotCaptureHealth {
+    /** Whether snapshot is usable */
+    ok: boolean;
+    /** Whether recovery was attempted */
+    recovered?: boolean;
+    /** Health code explaining status */
+    code: SnapshotHealthCode;
+    /** Number of capture attempts */
+    attempts?: number;
+    /** Human-readable message */
+    message?: string;
+}
+/**
+ * Runtime health info included in tool responses.
+ * This is additive - existing tool responses continue to work.
+ */
+export interface RuntimeHealth {
+    /** CDP session health */
+    cdp: CdpHealth;
+    /** Snapshot capture health */
+    snapshot: SnapshotCaptureHealth;
+}
+/**
+ * Connection health for session-level status.
+ *
+ * Goes beyond binary connected/not-connected:
+ * - 'healthy': Browser connected, all CDP sessions operational
+ * - 'degraded': Browser connected, but some CDP sessions dead (recoverable)
+ * - 'failed': Browser disconnected
+ */
+export type ConnectionHealth = 'healthy' | 'degraded' | 'failed';
+/**
+ * Create a healthy runtime health status.
+ */
+export declare function createHealthyRuntime(): RuntimeHealth;
+/**
+ * Create a runtime health status with CDP recovery.
+ */
+export declare function createRecoveredCdpRuntime(snapshotCode: SnapshotHealthCode): RuntimeHealth;
+/**
+ * Create a runtime health status for snapshot failure.
+ */
+export declare function createSnapshotFailureRuntime(code: SnapshotHealthCode, message?: string, attempts?: number): RuntimeHealth;
+/**
+ * Create a runtime health status for CDP failure (not recoverable).
+ */
+export declare function createCdpFailureRuntime(error: string): RuntimeHealth;
+//# sourceMappingURL=health.types.d.ts.map

package/dist/src/state/health.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.types.d.ts","sourceRoot":"","sources":["../../../src/state/health.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,aAAa,GACb,UAAU,GACV,WAAW,GACX,kBAAkB,GAClB,SAAS,CAAC;AAMd;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAMjE;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAKpD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,kBAAkB,GAAG,aAAa,CAKzF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,EACxB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,CAUf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAKpE"}

package/dist/src/state/health.types.js

@@ -0,0 +1,56 @@
+/**
+ * Health Types
+ *
+ * Types for tracking CDP session health, snapshot capture health,
+ * and runtime health information in tool responses.
+ *
+ * These types enable:
+ * - Specific failure classification (not just success/failure)
+ * - Degraded state detection (connected but CDP dead)
+ * - Recovery telemetry in responses
+ */
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Create a healthy runtime health status.
+ */
+export function createHealthyRuntime() {
+    return {
+        cdp: { ok: true },
+        snapshot: { ok: true, code: 'HEALTHY' },
+    };
+}
+/**
+ * Create a runtime health status with CDP recovery.
+ */
+export function createRecoveredCdpRuntime(snapshotCode) {
+    return {
+        cdp: { ok: true, recovered: true, recovery_method: 'rebind' },
+        snapshot: { ok: snapshotCode === 'HEALTHY', code: snapshotCode },
+    };
+}
+/**
+ * Create a runtime health status for snapshot failure.
+ */
+export function createSnapshotFailureRuntime(code, message, attempts) {
+    return {
+        cdp: { ok: true },
+        snapshot: {
+            ok: false,
+            code,
+            message,
+            attempts,
+        },
+    };
+}
+/**
+ * Create a runtime health status for CDP failure (not recoverable).
+ */
+export function createCdpFailureRuntime(error) {
+    return {
+        cdp: { ok: false, error },
+        snapshot: { ok: false, code: 'CDP_SESSION_DEAD' },
+    };
+}
+//# sourceMappingURL=health.types.js.map

package/dist/src/state/health.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.types.js","sourceRoot":"","sources":["../../../src/state/health.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmGH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;QACjB,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAAgC;IACxE,OAAO;QACL,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE;QAC7D,QAAQ,EAAE,EAAE,EAAE,EAAE,YAAY,KAAK,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE;KACjE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAwB,EACxB,OAAgB,EAChB,QAAiB;IAEjB,OAAO;QACL,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;QACjB,QAAQ,EAAE;YACR,EAAE,EAAE,KAAK;YACT,IAAI;YACJ,OAAO;YACP,QAAQ;SACT;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO;QACL,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;QACzB,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE;KAClD,CAAC;AACJ,CAAC"}

package/dist/src/state/layer-detector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Layer Detector
+ *
+ * Detect UI layers (modal > popover > drawer > main) to scope actionables correctly.
+ * Only return actionables from the active (topmost) layer.
+ */
+import type { BaseSnapshot } from '../snapshot/snapshot.types.js';
+import type { LayerDetectionResult } from './types.js';
+/**
+ * Detect layers in the snapshot.
+ * Returns stack of layers with active (topmost) layer.
+ *
+ * Detection priority order:
+ * 1. Modal - role="dialog" + aria-modal="true", <dialog open>, high z-index + backdrop
+ * 2. Drawer - role="complementary" + edge-positioned + high z-index
+ * 3. Popover - role="menu", role="listbox" + z-index > 100
+ * 4. Main - Always present as base layer
+ *
+ * @param snapshot - Compiled snapshot
+ * @returns Layer detection result
+ */
+export declare function detectLayers(snapshot: BaseSnapshot): LayerDetectionResult;
+//# sourceMappingURL=layer-detector.d.ts.map

package/dist/src/state/layer-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-detector.d.ts","sourceRoot":"","sources":["../../../src/state/layer-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAOlF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,oBAAoB,CAuDzE"}

package/dist/src/state/layer-detector.js

@@ -0,0 +1,368 @@
+/**
+ * Layer Detector
+ *
+ * Detect UI layers (modal > popover > drawer > main) to scope actionables correctly.
+ * Only return actionables from the active (topmost) layer.
+ */
+import { computeEid } from './element-identity.js';
+// ============================================================================
+// Layer Detection
+// ============================================================================
+/**
+ * Detect layers in the snapshot.
+ * Returns stack of layers with active (topmost) layer.
+ *
+ * Detection priority order:
+ * 1. Modal - role="dialog" + aria-modal="true", <dialog open>, high z-index + backdrop
+ * 2. Drawer - role="complementary" + edge-positioned + high z-index
+ * 3. Popover - role="menu", role="listbox" + z-index > 100
+ * 4. Main - Always present as base layer
+ *
+ * @param snapshot - Compiled snapshot
+ * @returns Layer detection result
+ */
+export function detectLayers(snapshot) {
+    const candidates = [];
+    // Scan nodes for layer patterns
+    for (const node of snapshot.nodes) {
+        // Modal detection (highest priority)
+        const modalMatch = detectModal(node);
+        if (modalMatch) {
+            candidates.push(modalMatch);
+            continue;
+        }
+        // Drawer detection
+        const drawerMatch = detectDrawer(node);
+        if (drawerMatch) {
+            candidates.push(drawerMatch);
+            continue;
+        }
+        // Popover detection
+        const popoverMatch = detectPopover(node);
+        if (popoverMatch) {
+            candidates.push(popoverMatch);
+        }
+    }
+    // Sort by z-index (highest first), filter low confidence
+    candidates.sort((a, b) => (b.zIndex ?? 0) - (a.zIndex ?? 0));
+    const layers = candidates.filter((c) => c.confidence > 0.6);
+    // Build stack: main is always present
+    const stack = [{ type: 'main', isModal: false }];
+    // Add detected layers
+    for (const layer of layers) {
+        stack.push({
+            type: layer.type,
+            rootEid: layer.rootEid,
+            zIndex: layer.zIndex,
+            isModal: layer.isModal,
+        });
+    }
+    // Determine active layer (topmost)
+    const active = stack[stack.length - 1].type;
+    // Find focused element
+    const focusEid = detectFocusedElement(snapshot);
+    return {
+        stack,
+        active,
+        focusEid,
+        pointerLock: false, // TODO: detect from page
+    };
+}
+// ============================================================================
+// Modal Detection
+// ============================================================================
+/**
+ * Detect if node is a modal layer.
+ *
+ * Patterns:
+ * - role="dialog" or role="alertdialog" + aria-modal="true"
+ * - <dialog open>
+ * - High z-index (>1000) with dialog role
+ * - React/Vue portal containers with modal content
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+function detectModal(node) {
+    const attrs = node.attributes;
+    const role = node.attributes?.role;
+    // Pattern 1: role="dialog" or role="alertdialog" + aria-modal="true"
+    if ((role === 'dialog' || role === 'alertdialog') && attrs?.['aria-modal'] === 'true') {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 1.0,
+        };
+    }
+    // Pattern 2: <dialog> element with open attribute
+    if (node.kind === 'dialog' && attrs?.open === true) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.95,
+        };
+    }
+    // Pattern 3: alertdialog without aria-modal (still modal by nature)
+    if (role === 'alertdialog') {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.9,
+        };
+    }
+    // Pattern 4: High z-index dialog (>1000)
+    if (role === 'dialog' && (node.layout.zIndex ?? 0) > 1000) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.8,
+        };
+    }
+    // Pattern 5: Portal container detection (React/Vue/Angular)
+    // Common portal container patterns
+    if (isPortalContainer(node, attrs)) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.75,
+        };
+    }
+    return null;
+}
+/**
+ * Check if node is a portal container (React/Vue/Angular patterns).
+ *
+ * @param node - Node to check
+ * @param attrs - Node attributes
+ * @returns True if portal container
+ */
+function isPortalContainer(node, attrs) {
+    const zIndex = node.layout.zIndex ?? 0;
+    // Must have high z-index
+    if (zIndex < 100) {
+        return false;
+    }
+    // Check for common portal container attributes/classes
+    const className = attrs?.class ?? attrs?.className;
+    if (typeof className === 'string') {
+        const portalPatterns = [
+            'modal',
+            'dialog',
+            'overlay',
+            'portal',
+            'ReactModal',
+            'MuiModal',
+            'chakra-modal',
+            'ant-modal',
+            'el-dialog', // Element UI
+            'v-dialog', // Vuetify
+        ];
+        const lowerClassName = className.toLowerCase();
+        if (portalPatterns.some((p) => lowerClassName.includes(p.toLowerCase()))) {
+            return true;
+        }
+    }
+    // Check for data attributes indicating portal
+    const dataPortal = attrs?.['data-portal'];
+    const dataOverlay = attrs?.['data-overlay'];
+    const dataModal = attrs?.['data-modal'];
+    if (dataPortal === true || dataOverlay === true || dataModal === true) {
+        return true;
+    }
+    // Check for aria-hidden siblings pattern (portal often has aria-hidden on root)
+    // This is detected by high z-index + covering most of viewport
+    const bbox = node.layout.bbox;
+    if (bbox && zIndex > 500) {
+        // If element covers significant viewport area with high z-index
+        if (bbox.w > 200 && bbox.h > 200) {
+            return true;
+        }
+    }
+    return false;
+}
+// ============================================================================
+// Drawer Detection
+// ============================================================================
+/**
+ * Detect if node is a drawer layer.
+ *
+ * Patterns:
+ * - role="complementary" or role="navigation" + edge-positioned + high z-index
+ * - Slide-in panel patterns from UI libraries
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+function detectDrawer(node) {
+    const role = node.attributes?.role;
+    const zIndex = node.layout.zIndex ?? 0;
+    const attrs = node.attributes;
+    // Must have moderate z-index for overlay drawer
+    if (zIndex <= 50) {
+        return null;
+    }
+    // Pattern 1: Complementary role with high z-index
+    if (role === 'complementary' && zIndex > 100) {
+        return {
+            type: 'drawer',
+            rootEid: computeEid(node, 'drawer'),
+            zIndex,
+            isModal: false,
+            confidence: 0.7,
+        };
+    }
+    // Pattern 2: Navigation role with high z-index + edge position
+    if (role === 'navigation' && zIndex > 100) {
+        const bbox = node.layout.bbox;
+        if (bbox && isEdgePositioned(bbox)) {
+            return {
+                type: 'drawer',
+                rootEid: computeEid(node, 'drawer'),
+                zIndex,
+                isModal: false,
+                confidence: 0.75,
+            };
+        }
+    }
+    // Pattern 3: Common drawer class patterns
+    const className = attrs?.class ?? attrs?.className;
+    if (typeof className === 'string' && zIndex > 50) {
+        const drawerPatterns = [
+            'drawer',
+            'sidebar',
+            'side-nav',
+            'sidenav',
+            'offcanvas',
+            'slide-in',
+            'MuiDrawer',
+            'ant-drawer',
+            'el-drawer',
+            'v-navigation-drawer',
+        ];
+        const lowerClassName = className.toLowerCase();
+        if (drawerPatterns.some((p) => lowerClassName.includes(p.toLowerCase()))) {
+            return {
+                type: 'drawer',
+                rootEid: computeEid(node, 'drawer'),
+                zIndex,
+                isModal: false,
+                confidence: 0.7,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Check if bounding box is edge-positioned (left or right edge).
+ *
+ * @param bbox - Bounding box {x, y, w, h}
+ * @returns True if positioned at edge
+ */
+function isEdgePositioned(bbox) {
+    // Left edge: x near 0
+    if (bbox.x < 10) {
+        return true;
+    }
+    // Right edge: x + width near typical viewport widths
+    // This is a heuristic - ideally we'd have viewport width
+    const rightEdge = bbox.x + bbox.w;
+    if (rightEdge > 1200 && bbox.x > 800) {
+        return true;
+    }
+    return false;
+}
+// ============================================================================
+// Popover Detection
+// ============================================================================
+/**
+ * Detect if node is a popover layer.
+ *
+ * Patterns:
+ * - role="menu", "listbox", "tooltip", "dialog" (non-modal) + z-index > 100
+ * - Dropdown/popup class patterns
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+function detectPopover(node) {
+    const role = node.attributes?.role;
+    const zIndex = node.layout.zIndex ?? 0;
+    const attrs = node.attributes;
+    if (zIndex <= 100) {
+        return null;
+    }
+    // Pattern 1: Standard popover roles
+    const popoverRoles = ['menu', 'listbox', 'tooltip', 'tree'];
+    if (role && popoverRoles.includes(role)) {
+        return {
+            type: 'popover',
+            rootEid: computeEid(node, 'popover'),
+            zIndex,
+            isModal: false,
+            confidence: 0.8,
+        };
+    }
+    // Pattern 2: Non-modal dialog (popup)
+    if (role === 'dialog' && attrs?.['aria-modal'] !== 'true') {
+        return {
+            type: 'popover',
+            rootEid: computeEid(node, 'popover'),
+            zIndex,
+            isModal: false,
+            confidence: 0.6,
+        };
+    }
+    // Pattern 3: Common popover/dropdown class patterns
+    const className = attrs?.class ?? attrs?.className;
+    if (typeof className === 'string') {
+        const popoverPatterns = [
+            'dropdown',
+            'popover',
+            'popup',
+            'tooltip',
+            'menu',
+            'autocomplete',
+            'suggestions',
+            'MuiPopover',
+            'MuiMenu',
+            'ant-dropdown',
+            'el-dropdown',
+            'el-popover',
+        ];
+        const lowerClassName = className.toLowerCase();
+        if (popoverPatterns.some((p) => lowerClassName.includes(p.toLowerCase()))) {
+            return {
+                type: 'popover',
+                rootEid: computeEid(node, 'popover'),
+                zIndex,
+                isModal: false,
+                confidence: 0.65,
+            };
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Focused Element Detection
+// ============================================================================
+/**
+ * Find currently focused element in snapshot.
+ *
+ * @param snapshot - Compiled snapshot
+ * @returns EID of focused element or undefined
+ */
+function detectFocusedElement(snapshot) {
+    const focusedNode = snapshot.nodes.find((n) => n.state?.focused);
+    return focusedNode ? computeEid(focusedNode) : undefined;
+}
+//# sourceMappingURL=layer-detector.js.map

package/dist/src/state/layer-detector.js.map

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

package/dist/src/state/locator-generator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Locator Generator
+ *
+ * Generate stable locators for actionable elements.
+ * Preference order: AX (accessibility tree) > CSS > XPath (avoid)
+ *
+ * Locators are layer-scoped when in modal/drawer/popover layers.
+ */
+import type { ReadableNode } from '../snapshot/snapshot.types.js';
+import type { LocatorInfo } from './types.js';
+/**
+ * Generate locator information for a node.
+ * Always includes preferred AX locator, optionally includes CSS fallback.
+ * Locators are scoped to the active layer when not in main.
+ *
+ * @param node - Node to generate locator for
+ * @param layer - Active layer for scoping (optional)
+ * @returns Locator information
+ */
+export declare function generateLocator(node: ReadableNode, layer?: string): LocatorInfo;
+//# sourceMappingURL=locator-generator.d.ts.map

package/dist/src/state/locator-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator.d.ts","sourceRoot":"","sources":["../../../src/state/locator-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA+B9C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAmB/E"}