@visulima/dev-toolbar 1.0.0-alpha.12 → 1.0.0-alpha.14

package/dist/vite-plugin.d.ts

@@ -1,149 +1,158 @@
-import type { Plugin } from "vite";
-import type { DevToolbarApp, ServerFunctions } from "./types/index.d.ts";
-import type { InjectSourceIgnore } from "./vite/inject-source.d.ts";
+import { Plugin } from 'vite';
+import { D as DevToolbarApp, S as ServerFunctions } from "./packem_shared/app.d-SmKEDxsI.js";
+import "./packem_shared/global-api.d-BLfn-OUA.js";
+import '@babel/generator';
+import 'preact';
+interface InjectSourceIgnore {
+  /** Component names or patterns to skip. */
+  components?: (RegExp | string)[];
+  /** File paths or patterns to skip. */
+  files?: (RegExp | string)[];
+}
 /**
- * Dev toolbar plugin options
- */
-export interface DevToolbarOptions {
-    /**
-     * append an import to the module id ending with `appendTo` instead of adding a script into body
-     * useful for projects that do not use html file as an entry
-     *
-     * WARNING: only set this if you know exactly what it does.
-     * @default Empty string (disabled).
-     */
-    appendTo?: string | RegExp;
-    /**
-     * Built-in apps to enable. All apps are disabled by default — only
-     * `viteConfig`, `settings`, and the "more" drawer are shown out of the box.
-     * Explicitly set an app to `true` to enable it.
-     * @example { inspector: true, seo: true }
-     */
-    apps?: {
-        [key: string]: boolean | undefined;
-        a11y?: boolean;
-        annotations?: boolean;
-        assets?: boolean;
-        inspector?: boolean;
-        moduleGraph?: boolean;
-        performance?: boolean;
-        seo?: boolean;
-        settings?: boolean;
-        tailwind?: boolean;
-        timeline?: boolean;
-        viteConfig?: boolean;
-    };
-    /**
-     * Whether clicking outside the DevTools panel closes it.
-     * @default true
-     */
-    closeOnOutsideClick?: boolean;
-    /**
-     * Custom apps to register
-     */
-    customApps?: DevToolbarApp[];
-    /**
-     * Whether toolbar is visible by default
-     */
-    defaultVisible?: boolean;
-    /**
-     * The editor to open when clicking "Open in editor" in the inspector.
-     * Accepts any value supported by `launch-editor` — an editor name/alias
-     * (e.g. `"code"`, `"webstorm"`, `"vim"`, `"atom"`) or the full path to
-     * the editor executable.
-     *
-     * If omitted, `launch-editor` auto-detects the editor from the `EDITOR`
-     * / `VISUAL` environment variables or from the currently running IDE
-     * process detected on the OS process list.
-     * @example "webstorm"
-     * @example "code"
-     */
-    editor?: string;
-    /**
-     * Initial panel height as a percentage of the viewport height (20–95).
-     * @default 60
-     */
-    height?: number;
-    /**
-     * Inject `data-vdt-source="<file>:<line>:<col>"` attributes into every JSX
-     * opening element during development. This lets the inspector jump directly
-     * to the source file when an element is clicked.
-     *
-     * Only active when `mode === 'development'`. Set `enabled: false` to opt out.
-     * Use `ignore.files` / `ignore.components` to exclude specific paths or
-     * component names (strings are treated as glob patterns).
-     * @default { enabled: true }
-     */
-    injectSource?: {
-        enabled?: boolean;
-        ignore?: InjectSourceIgnore;
-    };
-    /**
-     * Keyboard shortcut bindings.
-     * These are project-level defaults; users can still override them via the
-     * Settings app (stored in localStorage).
-     */
-    keybindings?: {
-        /** Close active app / panel. \@default "Escape" */
-        close?: string;
-        /** Toggle the DevTools panel open/closed. \@default "Alt+Shift+D" */
-        toggle?: string;
-    };
-    /**
-     * Auto-hide the toolbar pill after this many milliseconds of inactivity.
-     * Set to -1 to never auto-hide.
-     * @default 5000
-     */
-    minimizePanelInactive?: number;
-    /**
-     * Toolbar placement (coarse shorthand — sets the edge and rough horizontal
-     * alignment of the toolbar pill).
-     * @default "bottom-center"
-     */
-    placement?: "bottom-left" | "bottom-center" | "bottom-right";
-    /**
-     * Which edge of the viewport the toolbar pill is anchored to.
-     * Takes precedence over the edge implied by `placement`.
-     * @default "bottom"
-     */
-    position?: "bottom" | "left" | "right" | "top";
-    /**
-     * Reduce motion for accessibility (disables all CSS animations).
-     * @default false
-     */
-    reduceMotion?: boolean;
-    /**
-     * Strip all \@visulima/dev-toolbar imports and virtual modules when building
-     * for production (i.e. when `command !== 'serve'` or `mode === 'production'`).
-     * This guarantees the toolbar never ends up in a production bundle even if the
-     * user accidentally imports our package in application code.
-     * @default true
-     */
-    removeDevtoolsOnBuild?: boolean;
-    /**
-     * Only activate the toolbar when the URL contains a specific query parameter.
-     * Useful for staging/production environments where you want opt-in debugging.
-     * @example requireUrlFlag: true, urlFlagName: 'debug' → toolbar only shows when URL has ?debug=true
-     * @default false
-     */
-    requireUrlFlag?: boolean;
-    /**
-     * Custom server RPC functions
-     */
-    serverFunctions?: Partial<ServerFunctions>;
-    /**
-     * The URL query parameter name used when requireUrlFlag is true.
-     * @default 'devtools'
-     */
-    urlFlagName?: string;
-    /**
-     * Initial panel width as a percentage of the viewport width (20–95).
-     * Applies when position is "left" or "right".
-     * @default 80
-     */
-    width?: number;
+* Dev toolbar plugin options
+*/
+interface DevToolbarOptions {
+  /**
+  * append an import to the module id ending with `appendTo` instead of adding a script into body
+  * useful for projects that do not use html file as an entry
+  *
+  * WARNING: only set this if you know exactly what it does.
+  * @default Empty string (disabled).
+  */
+  appendTo?: string | RegExp;
+  /**
+  * Built-in apps to enable. All apps are disabled by default — only
+  * `viteConfig`, `settings`, and the "more" drawer are shown out of the box.
+  * Explicitly set an app to `true` to enable it.
+  * @example { inspector: true, seo: true }
+  */
+  apps?: {
+    [key: string]: boolean | undefined;
+    a11y?: boolean;
+    annotations?: boolean;
+    assets?: boolean;
+    inspector?: boolean;
+    moduleGraph?: boolean;
+    performance?: boolean;
+    seo?: boolean;
+    settings?: boolean;
+    tailwind?: boolean;
+    timeline?: boolean;
+    viteConfig?: boolean;
+  };
+  /**
+  * Whether clicking outside the DevTools panel closes it.
+  * @default true
+  */
+  closeOnOutsideClick?: boolean;
+  /**
+  * Custom apps to register
+  */
+  customApps?: DevToolbarApp[];
+  /**
+  * Whether toolbar is visible by default
+  */
+  defaultVisible?: boolean;
+  /**
+  * The editor to open when clicking "Open in editor" in the inspector.
+  * Accepts any value supported by `launch-editor` — an editor name/alias
+  * (e.g. `"code"`, `"webstorm"`, `"vim"`, `"atom"`) or the full path to
+  * the editor executable.
+  *
+  * If omitted, `launch-editor` auto-detects the editor from the `EDITOR`
+  * / `VISUAL` environment variables or from the currently running IDE
+  * process detected on the OS process list.
+  * @example "webstorm"
+  * @example "code"
+  */
+  editor?: string;
+  /**
+  * Initial panel height as a percentage of the viewport height (20–95).
+  * @default 60
+  */
+  height?: number;
+  /**
+  * Inject `data-vdt-source="&lt;file>:&lt;line>:&lt;col>"` attributes into every JSX
+  * opening element during development. This lets the inspector jump directly
+  * to the source file when an element is clicked.
+  *
+  * Only active when `mode === 'development'`. Set `enabled: false` to opt out.
+  * Use `ignore.files` / `ignore.components` to exclude specific paths or
+  * component names (strings are treated as glob patterns).
+  * @default { enabled: true }
+  */
+  injectSource?: {
+    enabled?: boolean;
+    ignore?: InjectSourceIgnore;
+  };
+  /**
+  * Keyboard shortcut bindings.
+  * These are project-level defaults; users can still override them via the
+  * Settings app (stored in localStorage).
+  */
+  keybindings?: {
+    /** Close active app / panel. \@default "Escape" */
+    close?: string;
+    /** Toggle the DevTools panel open/closed. \@default "Alt+Shift+D" */
+    toggle?: string;
+  };
+  /**
+  * Auto-hide the toolbar pill after this many milliseconds of inactivity.
+  * Set to -1 to never auto-hide.
+  * @default 5000
+  */
+  minimizePanelInactive?: number;
+  /**
+  * Toolbar placement (coarse shorthand — sets the edge and rough horizontal
+  * alignment of the toolbar pill).
+  * @default "bottom-center"
+  */
+  placement?: "bottom-left" | "bottom-center" | "bottom-right";
+  /**
+  * Which edge of the viewport the toolbar pill is anchored to.
+  * Takes precedence over the edge implied by `placement`.
+  * @default "bottom"
+  */
+  position?: "bottom" | "left" | "right" | "top";
+  /**
+  * Reduce motion for accessibility (disables all CSS animations).
+  * @default false
+  */
+  reduceMotion?: boolean;
+  /**
+  * Strip all \@visulima/dev-toolbar imports and virtual modules when building
+  * for production (i.e. when `command !== 'serve'` or `mode === 'production'`).
+  * This guarantees the toolbar never ends up in a production bundle even if the
+  * user accidentally imports our package in application code.
+  * @default true
+  */
+  removeDevtoolsOnBuild?: boolean;
+  /**
+  * Only activate the toolbar when the URL contains a specific query parameter.
+  * Useful for staging/production environments where you want opt-in debugging.
+  * @example requireUrlFlag: true, urlFlagName: 'debug' → toolbar only shows when URL has ?debug=true
+  * @default false
+  */
+  requireUrlFlag?: boolean;
+  /**
+  * Custom server RPC functions
+  */
+  serverFunctions?: Partial<ServerFunctions>;
+  /**
+  * The URL query parameter name used when requireUrlFlag is true.
+  * @default 'devtools'
+  */
+  urlFlagName?: string;
+  /**
+  * Initial panel width as a percentage of the viewport width (20–95).
+  * Applies when position is "left" or "right".
+  * @default 80
+  */
+  width?: number;
 }
 /**
- * Returns the Vite plugin array for the dev toolbar.
- */
-export declare const devToolbar: (options?: DevToolbarOptions) => Plugin[];
+* Returns the Vite plugin array for the dev toolbar.
+*/
+declare const devToolbar: (options?: DevToolbarOptions) => Plugin[];
+export { DevToolbarOptions, devToolbar };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@visulima/dev-toolbar",
-  "version": "1.0.0-alpha.12",
+  "version": "1.0.0-alpha.14",
   "description": "Devtools is a set of tools for building advanced devtools for your application",
   "keywords": [
-    "visulima",
-    "dev-toolbar"
+    "dev-toolbar",
+    "visulima"
   ],
   "homepage": "https://visulima.com/packages/dev-toolbar",
   "bugs": {
@@ -122,7 +122,7 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "axe-core": "4.11.3",
+    "axe-core": "4.11.4",
     "vite": "^6 || ^7 || ^8",
     "zod": "^3.0.0"
   },

package/dist/apps/a11y/a11y-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const A11yApp: (_props: AppComponentProps) => ComponentChildren;
-export default A11yApp;

package/dist/apps/a11y/a11y-store.d.ts

@@ -1,42 +0,0 @@
-type Severity = "critical" | "minor" | "moderate" | "serious";
-type Standard = "best-practice" | "wcag21aa" | "wcag22aa" | "wcag2a";
-interface A11yNode {
-    html: string;
-    selector: string;
-}
-interface A11yIssue {
-    helpUrl: string;
-    id: string;
-    impact: Severity;
-    message: string;
-    nodes: A11yNode[];
-    wcagTags: string[];
-}
-interface A11yStoreState {
-    isScanning: boolean;
-    issues: A11yIssue[];
-    lastScan: string | undefined;
-    scanError: string | undefined;
-    showOverlays: boolean;
-    standard: Standard;
-}
-declare const SEVERITY_ORDER: Severity[];
-type Listener = () => void;
-declare class A11yStore {
-    private listeners;
-    private state;
-    constructor();
-    clearHighlights(): void;
-    getState(): Readonly<A11yStoreState>;
-    highlightIssue(issue: A11yIssue): void;
-    scan(disabledRules?: string[]): Promise<void>;
-    setShowOverlays(show: boolean): void;
-    setStandard(standard: Standard): void;
-    subscribe(listener: Listener): () => void;
-    private notify;
-    private persist;
-    private update;
-}
-declare const a11yStore: A11yStore;
-export type { A11yIssue, A11yNode, A11yStoreState, Severity, Standard };
-export { a11yStore, SEVERITY_ORDER };

package/dist/apps/a11y/a11y-tooltip.d.ts

@@ -1,10 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppTooltipProps } from "../../types/app.d.ts";
-/**
- * Hover tooltip for the Accessibility app button.
- * Shows a summary of scan results and quick action buttons.
- * @param _props Tooltip props (unused; reads from a11yStore directly)
- * @returns Rendered tooltip component
- */
-declare const A11yTooltip: (_props: AppTooltipProps) => ComponentChildren;
-export default A11yTooltip;

package/dist/apps/annotations/annotations-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const AnnotationsApp: ({ helpers }: AppComponentProps) => ComponentChildren;
-export default AnnotationsApp;

package/dist/apps/assets/assets-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const AssetsApp: ({ helpers }: AppComponentProps) => ComponentChildren;
-export default AssetsApp;

package/dist/apps/inspector/a11y-capture.d.ts

@@ -1,12 +0,0 @@
-interface A11yInfo {
-    ariaAttributes: Record<string, string>;
-    focusable: boolean;
-    role: string | null;
-    tabindex: number | null;
-}
-/** Collect accessibility-relevant attributes from an element. */
-declare const captureA11yInfo: (element: Element) => A11yInfo;
-/** Format A11yInfo as a plain-text summary for clipboard. */
-declare const formatA11yText: (info: A11yInfo) => string;
-export { captureA11yInfo, formatA11yText };
-export type { A11yInfo };

package/dist/apps/inspector/annotation-overlay.d.ts

@@ -1,55 +0,0 @@
-/**
- * Annotation overlay — renders annotation markers on the page canvas,
- * provides inline annotation form, detail popup, edit mode, screenshot capture,
- * freeze mode, markdown export, and SPA navigation persistence.
- *
- * All DOM elements are injected into document.body (outside Shadow DOM)
- * to match the inspector's rendering approach.
- */
-import type { Annotation, BoundingBox } from "../../types/annotations.d.ts";
-/**
- * Returns true when the Annotations panel app is registered in the toolbar.
- */
-export declare const isAnnotationsAppEnabled: () => boolean;
-/**
- * Convert viewport click coords to page-absolute coords for storage.
- * x = percentage of viewport width, y = absolute page Y (scrollY + clientY).
- * For fixed elements, y stays as viewport-relative (no scrollY offset).
- */
-export declare const toPageCoords: (clientX: number, clientY: number, fixed?: boolean) => {
-    x: number;
-    y: number;
-};
-/** Load annotations from server and render markers. */
-export declare const loadAndShowMarkers: () => Promise<void>;
-/** Remove all annotation markers and detach listeners. */
-export declare const removeAllMarkers: () => void;
-/** Close all annotation popups (form, detail) and area outline, but keep markers. */
-export declare const closeAnnotationPopups: () => void;
-/** Whether the annotation form popup is currently open. */
-export declare const isAnnotationFormOpen: () => boolean;
-/** Shake the annotation form to draw attention. */
-export declare const shakeAnnotationForm: () => void;
-/**
- * Show annotation form popup. Captures selectedText, nearbyText, framework context,
- * and generates a smart CSS selector.
- */
-export declare const showAnnotationForm: (element: Element, rect: DOMRect, source: string | undefined, editAnnotation?: Annotation, clickPoint?: {
-    x: number;
-    y: number;
-}) => void;
-/**
- * Show annotation form for a multi-select (drag) region.
- * Creates a single annotation covering multiple elements.
- */
-export declare const showMultiSelectForm: (elements: Element[], selectionRect: DOMRect, boundingBoxes: BoundingBox[]) => void;
-/**
- * Show annotation form for an empty area selection (no elements found in drag region).
- * Like agentation: creates an "Area selection" annotation with the region as bounding box.
- * Shows a green dashed outline around the selected region.
- */
-export declare const showAreaSelectionForm: (selectionRect: DOMRect) => void;
-export declare const attachMarkdownShortcut: () => void;
-export declare const detachMarkdownShortcut: () => void;
-/** Check if a target is over an annotation overlay element. */
-export declare const isOverAnnotationOverlay: (target: Element | undefined) => boolean;

package/dist/apps/inspector/annotation-settings.d.ts

@@ -1,33 +0,0 @@
-/**
- * Annotation-specific settings — output detail level, marker appearance,
- * interaction behavior. Persisted in localStorage.
- */
-export type OutputDetailLevel = "compact" | "detailed" | "forensic" | "standard";
-export type MarkerClickBehavior = "delete" | "detail" | "edit";
-export interface MarkerColor {
-    /** Solid background for the marker */
-    bg: string;
-    /** Slightly darker ring / shadow tint */
-    border: string;
-    /** Text color inside the marker (white or dark for contrast) */
-    fg: string;
-    /** Translucent version for hover highlight overlay on elements */
-    highlightBg: string;
-    label: string;
-    name: string;
-}
-export declare const MARKER_COLORS: MarkerColor[];
-export interface AnnotationSettings {
-    /** Block clicks on interactive elements (buttons, links, inputs) while active */
-    blockInteractions: boolean;
-    /** What happens when you click a marker */
-    markerClickBehavior: MarkerClickBehavior;
-    /** Marker color name (from MARKER_COLORS) */
-    markerColorName: string;
-    /** Output detail level for markdown export */
-    outputDetail: OutputDetailLevel;
-}
-export declare const DEFAULT_SETTINGS: AnnotationSettings;
-export declare const loadSettings: () => AnnotationSettings;
-export declare const saveSettings: (settings: AnnotationSettings) => void;
-export declare const getMarkerColor: (settings?: AnnotationSettings) => MarkerColor;

package/dist/apps/inspector/element-utils.d.ts

@@ -1,115 +0,0 @@
-/**
- * Element utility functions for annotation — shadow DOM piercing, CSS selector
- * generation, smart naming, text extraction, a11y capture, computed styles,
- * framework detection, screenshot, freeze, markdown export.
- */
-import type { AccessibilityInfo, BoundingBox, FrameworkContext } from "../../types/annotations.d.ts";
-export declare const deepElementFromPoint: (x: number, y: number) => Element | null;
-/**
- * Get the viewport-relative bounding rect for an element, accounting for
- * it potentially being inside nested iframes.
- */
-export declare const getViewportRect: (element: Element) => DOMRect;
-/**
- * Pierce mode: Cmd+hover to find the actual element underneath invisible
- * overlays, animation wrappers, and empty container divs.
- *
- * Two-pass approach:
- *   1. Find elements with direct text content (skips empty wrappers)
- *   2. If no text found, return the smallest visible element (catches
- *      visual-only elements like timeline bars, chart segments, swatches)
- */
-export declare const pierceElementFromPoint: (x: number, y: number) => Element | null;
-export declare const getParentElement: (element: Element) => Element | null;
-/**
- * Check if element or any ancestor has fixed or sticky positioning.
- */
-export declare const isElementFixed: (element: Element) => boolean;
-/**
- * Generate a human-readable element label like agentation:
- * button "Submit", link to /page, image "alt text", input[type=email]
- */
-export declare const getElementLabel: (element: Element) => string;
-/**
- * Generate a unique CSS selector for an element.
- * Strategy: ID → unique class combo → nth-of-type fallback.
- */
-export declare const generateSelector: (element: Element) => string;
-/**
- * Clean CSS classes by stripping module hash suffixes.
- */
-export declare const cleanCssClasses: (classes: DOMTokenList) => string;
-/**
- * Build full DOM ancestry path (body > main > article > section > p).
- * Marks shadow DOM boundary crossings with ⟨shadow⟩.
- */
-export declare const getFullDomPath: (element: Element) => string;
-/**
- * Get sibling elements as context (up to 5 siblings).
- */
-export declare const getNearbyElements: (element: Element) => string;
-/**
- * Extract nearby text content from an element (up to maxLength chars).
- */
-export declare const getNearbyText: (element: Element, maxLength?: number) => string;
-/**
- * Capture currently selected text (up to maxLength chars).
- */
-export declare const getSelectedText: (maxLength?: number) => string;
-/**
- * Capture accessibility attributes from an element.
- */
-export declare const captureAccessibility: (element: Element) => AccessibilityInfo;
-/**
- * Capture key computed styles for forensic context.
- */
-export declare const captureComputedStyles: (element: Element) => string;
-/**
- * Detect framework component for an element.
- */
-export declare const detectFrameworkComponent: (element: Element) => FrameworkContext | undefined;
-/**
- * Capture a screenshot of an element's bounding area.
- *
- * Uses the Screen Capture API (getDisplayMedia) to capture a frame from the
- * screen, then crops to the element's bounding rect. This is the most reliable
- * approach — works with external CSS, images, shadow DOM, and canvas content.
- *
- * Falls back to null if the user denies permission or the API is unavailable.
- */
-export declare const captureElementScreenshot: (element: Element) => Promise<string | null>;
-/**
- * Get all elements within a rectangular region.
- * Searches across shadow DOM and same-origin iframes.
- */
-export declare const getElementsInRect: (rect: DOMRect) => Element[];
-/**
- * Get bounding boxes from a list of elements (iframe-aware).
- */
-export declare const getElementBoundingBoxes: (elements: Element[]) => BoundingBox[];
-/**
- * Output detail levels:
- * - compact: "Element: comment (re: "selected text...")"
- * - standard: Element + location + component + feedback
- * - detailed: + classes, position, context text
- * - forensic: + full DOM path, styles, accessibility, nearby elements
- */
-export declare const annotationsToMarkdown: (annotations: {
-    accessibility?: AccessibilityInfo;
-    comment: string;
-    computedStyles?: string;
-    cssClasses?: string;
-    elementLabel?: string;
-    elementPath?: string;
-    elementTag: string;
-    frameworkContext?: FrameworkContext;
-    fullPath?: string;
-    intent: string;
-    nearbyElements?: string;
-    nearbyText?: string;
-    selectedText?: string;
-    severity: string;
-    source?: string;
-    status: string;
-    url: string;
-}[], detail?: "compact" | "detailed" | "forensic" | "standard") => string;

package/dist/apps/inspector/freeze-animations.d.ts

@@ -1,22 +0,0 @@
-/**
- * Freeze Animations — comprehensive animation/timer freeze system.
- *
- * Monkey-patches setTimeout, setInterval, and requestAnimationFrame so that
- * callbacks are silently queued while frozen. Also injects CSS to pause
- * CSS animations/transitions, pauses WAAPI animations, and pauses videos.
- *
- * Patches are installed as a side effect of importing this module.
- * Toolbar/popup code must import `originalSetTimeout` to bypass the patch.
- *
- * Based on agentation's freeze-animations.ts pattern.
- */
-/** Original (unpatched) setTimeout — use for toolbar/popup animations */
-export declare const originalSetTimeout: typeof setTimeout;
-/** Whether animations are currently frozen */
-export declare const isFrozen: () => boolean;
-/** Freeze all animations, timers, and videos */
-export declare const freezeAll: () => void;
-/** Unfreeze — resume everything and replay queued callbacks */
-export declare const unfreezeAll: () => void;
-/** Toggle freeze state */
-export declare const toggleFreeze: () => boolean;

package/dist/apps/inspector/inspector-app.d.ts

@@ -1,14 +0,0 @@
-/**
- * Start element inspection mode.
- * Attaches crosshair cursor, hover highlight overlay, and a floating badge.
- * Inspection stays active after each click so the user can inspect multiple
- * elements without re-activating. Only stops on explicit cancel (Escape,
- * badge Cancel button) or via {@link stopGlobalInspection}.
- * Survives component unmounts — state lives at module level.
- * @param onCancel Called when the user cancels via badge button or Escape.
- */
-export declare const startGlobalInspection: (onCancel: () => void) => void;
-/**
- * Cancel any in-progress inspection and clean up all DOM side-effects.
- */
-export declare const stopGlobalInspection: () => void;