@oddsquad/vite-plugin-lit 0.0.3 → 0.1.0

package/lib/runtime/source-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-meta.d.ts","sourceRoot":"","sources":["../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,eAAe,eAAiD,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,gCAAgC,GAAG,wBAAwB,GAAG;IACxE,CAAC,eAAe,CAAC,CAAC,EAAE,aAAa,CAAC;CACnC,CAAC"}

package/lib/runtime/source-meta.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/** Runtime accessor for injected component source metadata. */
+export const SOURCE_META_KEY = Symbol.for('@lit-labs/vite-plugin-lit#source');
+//# sourceMappingURL=source-meta.js.map

package/lib/runtime/source-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-meta.js","sourceRoot":"","sources":["../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/** Runtime accessor for injected component source metadata. */\nexport const SOURCE_META_KEY = Symbol.for('@lit-labs/vite-plugin-lit#source');\n\nexport interface LitSourceMeta {\n  filePath: string;\n  lineNumber: number;\n  componentName?: string;\n}\n\nexport type CustomElementConstructorWithMeta = CustomElementConstructor & {\n  [SOURCE_META_KEY]?: LitSourceMeta;\n};\n"]}

package/lib/runtime/source-overlay/editors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { EditorConfig } from '../../types.js';
+export declare const BUILTIN_EDITORS: Record<string, EditorConfig>;
+export declare const resolveEditor: (editor: EditorConfig | string | undefined) => EditorConfig;
+//# sourceMappingURL=editors.d.ts.map

package/lib/runtime/source-overlay/editors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editors.d.ts","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/editors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAIjD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAsBxD,CAAC;AAIF,eAAO,MAAM,aAAa,GACxB,QAAQ,YAAY,GAAG,MAAM,GAAG,SAAS,KACxC,YAMF,CAAC"}

package/lib/runtime/source-overlay/editors.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+// Keep the keys/labels in sync with SOURCE_OVERLAY_EDITORS in
+// src/types/timeline.ts (the panel's editor-selection options).
+export const BUILTIN_EDITORS = {
+    vscode: {
+        name: 'VS Code',
+        url: (path, line) => `vscode://file/${path}:${line}`,
+    },
+    cursor: {
+        name: 'Cursor',
+        url: (path, line) => `cursor://file/${path}:${line}`,
+    },
+    zed: {
+        name: 'Zed',
+        url: (path, line) => `zed://file/${path}:${line}`,
+    },
+    idea: {
+        name: 'IntelliJ',
+        url: (path, line) => `idea://open?file=${encodeURIComponent(path)}&line=${line}`,
+    },
+    windsurf: {
+        name: 'Windsurf',
+        url: (path, line) => `windsurf://file/${path}:${line}`,
+    },
+};
+// Resolve an editor option to a config: a builtin name, a custom config, or the
+// VS Code default (also used as the fallback for an unknown name).
+export const resolveEditor = (editor) => {
+    if (editor === undefined)
+        return BUILTIN_EDITORS.vscode;
+    if (typeof editor === 'string') {
+        return BUILTIN_EDITORS[editor] ?? BUILTIN_EDITORS.vscode;
+    }
+    return editor;
+};
+//# sourceMappingURL=editors.js.map

package/lib/runtime/source-overlay/editors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editors.js","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/editors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,8DAA8D;AAC9D,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,MAAM,EAAE;QACN,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,IAAI,IAAI,IAAI,EAAE;KACrD;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,IAAI,IAAI,IAAI,EAAE;KACrD;IACD,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,IAAI,IAAI,IAAI,EAAE;KAClD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAClB,oBAAoB,kBAAkB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE;KAC9D;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,IAAI,IAAI,IAAI,EAAE;KACvD;CACF,CAAC;AAEF,gFAAgF;AAChF,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAyC,EAC3B,EAAE;IAChB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC,MAAM,CAAC;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {EditorConfig} from '../../types.js';\n\n// Keep the keys/labels in sync with SOURCE_OVERLAY_EDITORS in\n// src/types/timeline.ts (the panel's editor-selection options).\nexport const BUILTIN_EDITORS: Record<string, EditorConfig> = {\n  vscode: {\n    name: 'VS Code',\n    url: (path, line) => `vscode://file/${path}:${line}`,\n  },\n  cursor: {\n    name: 'Cursor',\n    url: (path, line) => `cursor://file/${path}:${line}`,\n  },\n  zed: {\n    name: 'Zed',\n    url: (path, line) => `zed://file/${path}:${line}`,\n  },\n  idea: {\n    name: 'IntelliJ',\n    url: (path, line) =>\n      `idea://open?file=${encodeURIComponent(path)}&line=${line}`,\n  },\n  windsurf: {\n    name: 'Windsurf',\n    url: (path, line) => `windsurf://file/${path}:${line}`,\n  },\n};\n\n// Resolve an editor option to a config: a builtin name, a custom config, or the\n// VS Code default (also used as the fallback for an unknown name).\nexport const resolveEditor = (\n  editor: EditorConfig | string | undefined\n): EditorConfig => {\n  if (editor === undefined) return BUILTIN_EDITORS.vscode;\n  if (typeof editor === 'string') {\n    return BUILTIN_EDITORS[editor] ?? BUILTIN_EDITORS.vscode;\n  }\n  return editor;\n};\n"]}

package/lib/runtime/source-overlay/mask-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export declare const buildSpotlightClipPath: (l: number, t: number, w: number, h: number, r: number) => string;
+//# sourceMappingURL=mask-path.d.ts.map

package/lib/runtime/source-overlay/mask-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-path.d.ts","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/mask-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,sBAAsB,GACjC,GAAG,MAAM,EACT,GAAG,MAAM,EACT,GAAG,MAAM,EACT,GAAG,MAAM,EACT,GAAG,MAAM,KACR,MAeF,CAAC"}

package/lib/runtime/source-overlay/mask-path.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+// Build an SVG clip-path that fills the viewport except a rounded-rect hole at
+// (l, t, w, h) with corner radius r — the spotlight cut-out for the highlight.
+// Outer rect (clockwise) + inner rounded rect (counterclockwise) combine under
+// the nonzero fill rule to punch the hole.
+export const buildSpotlightClipPath = (l, t, w, h, r) => {
+    r = Math.min(r, w / 2, h / 2);
+    const outer = `M 0 0 H 9999 V 9999 H 0 Z`;
+    const inner = [
+        `M ${l + r} ${t}`,
+        `Q ${l} ${t} ${l} ${t + r}`,
+        `L ${l} ${t + h - r}`,
+        `Q ${l} ${t + h} ${l + r} ${t + h}`,
+        `L ${l + w - r} ${t + h}`,
+        `Q ${l + w} ${t + h} ${l + w} ${t + h - r}`,
+        `L ${l + w} ${t + r}`,
+        `Q ${l + w} ${t} ${l + w - r} ${t}`,
+        `Z`,
+    ].join(' ');
+    return `path('${outer} ${inner}')`;
+};
+//# sourceMappingURL=mask-path.js.map

package/lib/runtime/source-overlay/mask-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-path.js","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/mask-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,CAAS,EACT,CAAS,EACT,CAAS,EACT,CAAS,EACT,CAAS,EACD,EAAE;IACV,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,2BAA2B,CAAC;IAC1C,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACnC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACzB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC3C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACrB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACnC,GAAG;KACJ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,SAAS,KAAK,IAAI,KAAK,IAAI,CAAC;AACrC,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n// Build an SVG clip-path that fills the viewport except a rounded-rect hole at\n// (l, t, w, h) with corner radius r — the spotlight cut-out for the highlight.\n// Outer rect (clockwise) + inner rounded rect (counterclockwise) combine under\n// the nonzero fill rule to punch the hole.\nexport const buildSpotlightClipPath = (\n  l: number,\n  t: number,\n  w: number,\n  h: number,\n  r: number\n): string => {\n  r = Math.min(r, w / 2, h / 2);\n  const outer = `M 0 0 H 9999 V 9999 H 0 Z`;\n  const inner = [\n    `M ${l + r} ${t}`,\n    `Q ${l} ${t} ${l} ${t + r}`,\n    `L ${l} ${t + h - r}`,\n    `Q ${l} ${t + h} ${l + r} ${t + h}`,\n    `L ${l + w - r} ${t + h}`,\n    `Q ${l + w} ${t + h} ${l + w} ${t + h - r}`,\n    `L ${l + w} ${t + r}`,\n    `Q ${l + w} ${t} ${l + w - r} ${t}`,\n    `Z`,\n  ].join(' ');\n  return `path('${outer} ${inner}')`;\n};\n"]}

package/lib/runtime/source-overlay/overlay-element.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { ElementInfo, EditorConfig } from '../../types.js';
+export interface SourceOverlayInitOptions {
+    key?: string;
+    editor?: EditorConfig | string;
+    workspaceRoot?: string;
+    throttleMs?: number;
+    exclude?: (el: Element) => boolean;
+    onSelect?: (info: ElementInfo) => void;
+    openInEditorPath?: string;
+}
+export declare const initSourceOverlay: (initOptions?: SourceOverlayInitOptions) => void;
+export declare const toggleSourceOverlay: () => void;
+//# sourceMappingURL=overlay-element.d.ts.map

package/lib/runtime/source-overlay/overlay-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-element.d.ts","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/overlay-element.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAmB9D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA0XD,eAAO,MAAM,iBAAiB,GAC5B,cAAa,wBAA6B,SAM3C,CAAC;AAEF,eAAO,MAAM,mBAAmB,YAK/B,CAAC"}

package/lib/runtime/source-overlay/overlay-element.js

@@ -0,0 +1,381 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import { BUILTIN_EDITORS, resolveEditor } from './editors.js';
+import { defaultResolver, findSourceAtPoint, findSourceHost, } from './source-host.js';
+import { buildSpotlightClipPath } from './mask-path.js';
+import { OVERLAY_HTML } from './template.js';
+import { observeEdgeInsets } from '../edge-panel.js';
+import { subscribeOverride } from '../overrides.js';
+import { injectTokens } from '../../tokens.js';
+import { idOf } from '../timeline/identity.js';
+import { INSPECT_OVERLAY_TOGGLE_CHANNEL, INSPECT_DATA_CHANNEL, } from '../../../types/inspector.js';
+class LitSourceOverlay extends HTMLElement {
+    #active = false;
+    #hot;
+    #options = {};
+    #editor = BUILTIN_EDITORS.vscode;
+    #resolver = defaultResolver;
+    #dialog;
+    #mask;
+    #highlight;
+    #tooltip;
+    #tag;
+    #path;
+    #info = null;
+    #targetEl = null;
+    #throttleTimer;
+    #scrollTimer;
+    #resizeObserver;
+    #cursorStyle = null;
+    // Whether the Vite HMR WebSocket is currently connected. Used to suppress the
+    // editor-URL-scheme fallback once the dev server is gone — otherwise a failed
+    // open-in-editor fetch would navigate the tab to `vscode://…`.
+    #connected = true;
+    #lastMouseX = 0;
+    #lastMouseY = 0;
+    #edgeDispose;
+    #overrideSubscribed = false;
+    constructor() {
+        super();
+        const root = this.attachShadow({ mode: 'closed' });
+        root.innerHTML = OVERLAY_HTML;
+        this.#dialog = root.getElementById('overlay');
+        this.#mask = root.getElementById('mask');
+        this.#highlight = root.getElementById('highlight');
+        this.#tooltip = root.getElementById('tooltip');
+        this.#tag = root.getElementById('tag');
+        this.#path = root.getElementById('path');
+        root.getElementById('open').addEventListener('click', (e) => {
+            e.stopPropagation();
+            if (this.#info !== null)
+                this.#select(this.#info, true);
+        });
+        root.getElementById('copy').addEventListener('click', (e) => {
+            e.stopPropagation();
+            if (this.#info === null)
+                return;
+            const text = `${this.#normalizePath(this.#info.source.filePath)}:${this.#info.source.lineNumber}`;
+            navigator.clipboard?.writeText(text);
+        });
+        this.#dialog.addEventListener('cancel', (e) => e.preventDefault());
+    }
+    connectedCallback() {
+        injectTokens();
+        document.addEventListener('mousemove', this.#onTrackMouse, true);
+        document.addEventListener('keydown', this.#onKeyDown, true);
+        const hot = import.meta.hot;
+        this.#hot = hot;
+        hot?.on('vite:beforeFullReload', () => this.deactivate());
+        hot?.on('vite:ws:disconnect', () => (this.#connected = false));
+        hot?.on('vite:ws:connect', () => (this.#connected = true));
+        // Toggle from the Vite DevTools command/shortcut (handler runs server-side).
+        hot?.on(INSPECT_OVERLAY_TOGGLE_CHANNEL, () => this.toggle());
+        // Keep the (bottom-fixed) tooltip clear of the Vite DevTools edge panel.
+        this.#edgeDispose = observeEdgeInsets((insets) => {
+            this.style.setProperty('--edge-bottom', `${insets.bottom}px`);
+        });
+        // Apply the panel's editor override live (and on load). Merge so other
+        // configured options (key, throttle, …) survive.
+        if (!this.#overrideSubscribed) {
+            this.#overrideSubscribed = true;
+            subscribeOverride(hot, (o) => {
+                if (o.sourceOverlayEditor !== undefined) {
+                    this.#options = { ...this.#options, editor: o.sourceOverlayEditor };
+                    this.#editor = resolveEditor(o.sourceOverlayEditor);
+                }
+            });
+        }
+    }
+    disconnectedCallback() {
+        document.removeEventListener('mousemove', this.#onTrackMouse, true);
+        document.removeEventListener('keydown', this.#onKeyDown, true);
+        this.deactivate();
+        this.#edgeDispose?.();
+        this.#edgeDispose = undefined;
+    }
+    configure(options) {
+        this.#options = options;
+        this.#editor = resolveEditor(options.editor);
+    }
+    activate() {
+        if (this.#active)
+            return;
+        this.#active = true;
+        this.#dialog.showModal();
+        this.#mask.style.background = 'rgba(0,0,0,0.35)';
+        // The overlay is pointer-events:none, so the cursor reflects the hovered
+        // page element. Force a crosshair while inspecting. The closed shadow DOM
+        // tooltip is unaffected, so its buttons keep their own pointer cursor.
+        if (this.#cursorStyle === null) {
+            this.#cursorStyle = document.createElement('style');
+            this.#cursorStyle.textContent = '*{cursor:crosshair !important}';
+        }
+        document.head.append(this.#cursorStyle);
+        document.addEventListener('mousemove', this.#onMouseMove, true);
+        document.addEventListener('click', this.#onClick, true);
+        window.addEventListener('scroll', this.#onScrollOrResize, { passive: true });
+        window.addEventListener('resize', this.#onScrollOrResize, { passive: true });
+        this.#resolveAt(this.#lastMouseX, this.#lastMouseY);
+    }
+    deactivate() {
+        if (!this.#active)
+            return;
+        this.#active = false;
+        this.#dialog.close();
+        this.#mask.style.background = 'rgba(0,0,0,0)';
+        this.#cursorStyle?.remove();
+        document.removeEventListener('mousemove', this.#onMouseMove, true);
+        document.removeEventListener('click', this.#onClick, true);
+        window.removeEventListener('scroll', this.#onScrollOrResize);
+        window.removeEventListener('resize', this.#onScrollOrResize);
+        if (this.#throttleTimer !== undefined) {
+            clearTimeout(this.#throttleTimer);
+            this.#throttleTimer = undefined;
+        }
+        if (this.#scrollTimer !== undefined) {
+            clearTimeout(this.#scrollTimer);
+            this.#scrollTimer = undefined;
+        }
+        this.#clearTarget();
+    }
+    toggle() {
+        if (this.#active)
+            this.deactivate();
+        else
+            this.activate();
+    }
+    #normalizePath(filePath) {
+        const root = this.#options.workspaceRoot;
+        if (root !== undefined && filePath.startsWith(root)) {
+            const rest = filePath.slice(root.length);
+            return rest.startsWith('/') ? rest.slice(1) : rest;
+        }
+        return filePath;
+    }
+    async #openInEditor(filePath, lineNumber) {
+        const path = this.#normalizePath(filePath);
+        const endpoint = this.#options.openInEditorPath ?? '/__lit-open-in-editor';
+        try {
+            const params = new URLSearchParams({
+                file: path,
+                line: String(lineNumber),
+            });
+            const res = await fetch(`${endpoint}?${params.toString()}`);
+            if (res.ok)
+                return;
+        }
+        catch {
+            // Fall back to editor URL schemes (e.g. StackBlitz previews).
+        }
+        // Skip the URL-scheme fallback when the dev server is gone: a fetch failure
+        // there means "server quit", not "no endpoint", and navigating the tab to
+        // `vscode://…` on shutdown is jarring and unwanted.
+        if (!this.#connected)
+            return;
+        window.open(this.#editor.url(path, lineNumber), '_self');
+    }
+    #updateHighlightRect() {
+        if (this.#targetEl === null)
+            return;
+        const rect = this.#targetEl.getBoundingClientRect();
+        const raw = getComputedStyle(this)
+            .getPropertyValue('--lit-devtools-radius')
+            .trim();
+        const r = parseFloat(raw) || 6;
+        this.#highlight.style.left = `${rect.left - r}px`;
+        this.#highlight.style.top = `${rect.top - r}px`;
+        this.#highlight.style.width = `${rect.width + 2 * r}px`;
+        this.#highlight.style.height = `${rect.height + 2 * r}px`;
+        this.#mask.style.clipPath = buildSpotlightClipPath(rect.left - r, rect.top - r, rect.width + 2 * r, rect.height + 2 * r, r);
+    }
+    #showTooltip() {
+        if (this.#info === null)
+            return;
+        this.#tag.textContent = `<${this.#info.tagName}>`;
+        this.#path.textContent = `${this.#normalizePath(this.#info.source.filePath)}:${this.#info.source.lineNumber}`;
+        this.#tooltip.style.display = 'flex';
+    }
+    #clearTarget() {
+        this.#targetEl = null;
+        this.#info = null;
+        this.#highlight.style.left = '0';
+        this.#highlight.style.top = '0';
+        this.#highlight.style.width = '0';
+        this.#highlight.style.height = '0';
+        this.#mask.style.clipPath = 'none';
+        this.#tooltip.style.display = 'none';
+        if (this.#resizeObserver !== undefined) {
+            this.#resizeObserver.disconnect();
+            this.#resizeObserver = undefined;
+        }
+    }
+    #shouldSkip(el) {
+        if (el === this.#dialog || this.#dialog.contains(el))
+            return true;
+        if (el.tagName === 'IFRAME')
+            return true;
+        // Never target devtools' own injected elements (indicator, overlay).
+        const tag = el.tagName.toLowerCase();
+        if (tag === 'lit-source-overlay' || tag.startsWith('lit-devtools-')) {
+            return true;
+        }
+        const exclude = this.#options.exclude;
+        return exclude !== undefined && exclude(el);
+    }
+    async #resolveAt(x, y) {
+        this.#lastMouseX = x;
+        this.#lastMouseY = y;
+        const el = findSourceAtPoint(x, y, this.#dialog);
+        if (el === null || this.#shouldSkip(el)) {
+            this.#clearTarget();
+            return;
+        }
+        const host = findSourceHost(el);
+        if (host === null) {
+            this.#clearTarget();
+            return;
+        }
+        if (host === this.#targetEl && this.#info !== null) {
+            this.#updateHighlightRect();
+            return;
+        }
+        this.#targetEl = host;
+        if (this.#resizeObserver === undefined) {
+            this.#resizeObserver = new ResizeObserver(() => this.#updateHighlightRect());
+        }
+        else {
+            this.#resizeObserver.disconnect();
+        }
+        this.#resizeObserver.observe(host);
+        const resolved = await this.#resolver.resolveElementInfo(el);
+        if (resolved === null) {
+            this.#clearTarget();
+            return;
+        }
+        this.#info = resolved;
+        this.#updateHighlightRect();
+        this.#showTooltip();
+    }
+    #onTrackMouse = (event) => {
+        this.#lastMouseX = event.clientX;
+        this.#lastMouseY = event.clientY;
+    };
+    #onKeyDown = (event) => {
+        if ((event.metaKey || event.ctrlKey) && event.shiftKey && !event.altKey) {
+            const pressed = event.key.toLowerCase();
+            const hotkey = (this.#options.key ?? 'e').toLowerCase();
+            if (pressed === hotkey) {
+                event.preventDefault();
+                this.toggle();
+            }
+        }
+        if (this.#active && event.key === 'Escape') {
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    };
+    #onMouseMove = (event) => {
+        if (!this.#active)
+            return;
+        // Keep the current selection while hovering the tooltip so its buttons stay
+        // clickable — the tooltip isn't a source element, so re-resolving here would
+        // clear the target and hide the panel out from under the pointer.
+        if (this.#pointInTooltip(event.clientX, event.clientY))
+            return;
+        const throttleMs = this.#options.throttleMs ?? 50;
+        if (this.#throttleTimer !== undefined)
+            return;
+        this.#throttleTimer = setTimeout(() => {
+            this.#throttleTimer = undefined;
+            // Resolve against the latest pointer position (kept current by
+            // #onTrackMouse), not the coords captured when this timer was scheduled
+            // ~throttleMs ago — otherwise the highlight lags the cursor during
+            // continuous movement.
+            const x = this.#lastMouseX;
+            const y = this.#lastMouseY;
+            if (this.#pointInTooltip(x, y))
+                return;
+            this.#resolveAt(x, y);
+        }, throttleMs);
+    };
+    #select(info, openInEditor = false) {
+        const target = this.#targetEl;
+        // Cancel the whole selection mode on any deliberate pick, before acting —
+        // the editor may open via a URL scheme that doesn't navigate this tab away,
+        // so we can't rely on the open outcome to dismiss the inspector.
+        this.deactivate();
+        this.#options.onSelect?.(info);
+        if (openInEditor) {
+            this.#openInEditor(info.source.filePath, info.source.lineNumber);
+            return;
+        }
+        // Report the picked element to the DevTools panel, which selects it in the
+        // Components tree. Identity matches the inspector runtime via idOf().
+        if (target !== null) {
+            this.#hot?.send(INSPECT_DATA_CHANNEL, { type: 'pick', id: idOf(target) });
+            this.#openDevtoolsPanel();
+        }
+    }
+    /**
+     * Bring the Lit DevTools dock entry to the front so a pick is visible even
+     * when the panel was closed. The panel mirrors this from its own
+     * `inspector-activate` handler, but only once its iframe is mounted — and the
+     * @vitejs/devtools shell does not mount that iframe until the entry has been
+     * opened at least once. This overlay always runs on the page, so calling
+     * `switchEntry` here covers the cold-start case where no panel exists yet to
+     * receive the `pick` message.
+     */
+    #openDevtoolsPanel() {
+        try {
+            const ctx = window.__VITE_DEVTOOLS_CLIENT_CONTEXT__;
+            ctx?.docks?.switchEntry?.('lit-devtools');
+        }
+        catch {
+            // Not running inside the DevTools shell — ignore.
+        }
+    }
+    #pointInTooltip(x, y) {
+        if (this.#tooltip.style.display === 'none')
+            return false;
+        const r = this.#tooltip.getBoundingClientRect();
+        return x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;
+    }
+    #onClick = (event) => {
+        if (!this.#active || this.#info === null)
+            return;
+        // Clicks on the tooltip panel are handled by its own buttons (open/copy).
+        // The overlay's shadow root is closed, so we detect this by hit-rect rather
+        // than inspecting the event path, and let the event reach those buttons.
+        if (this.#pointInTooltip(event.clientX, event.clientY))
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        this.#select(this.#info, event.metaKey || event.ctrlKey);
+    };
+    #onScrollOrResize = () => {
+        if (this.#scrollTimer !== undefined)
+            clearTimeout(this.#scrollTimer);
+        this.#scrollTimer = setTimeout(() => {
+            this.#scrollTimer = undefined;
+            if (this.#targetEl !== null) {
+                this.#updateHighlightRect();
+            }
+        }, 50);
+    };
+}
+customElements.define('lit-source-overlay', LitSourceOverlay);
+export const initSourceOverlay = (initOptions = {}) => {
+    if (typeof window === 'undefined')
+        return;
+    const el = document.createElement('lit-source-overlay');
+    el.configure(initOptions);
+    document.body.append(el);
+};
+export const toggleSourceOverlay = () => {
+    const el = document.querySelector('lit-source-overlay');
+    el?.toggle();
+};
+//# sourceMappingURL=overlay-element.js.map

package/lib/runtime/source-overlay/overlay-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-element.js","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/overlay-element.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {ElementInfo, EditorConfig} from '../../types.js';\nimport {BUILTIN_EDITORS, resolveEditor} from './editors.js';\nimport {\n  defaultResolver,\n  findSourceAtPoint,\n  findSourceHost,\n  type ElementResolver,\n} from './source-host.js';\nimport {buildSpotlightClipPath} from './mask-path.js';\nimport {OVERLAY_HTML} from './template.js';\nimport {observeEdgeInsets} from '../edge-panel.js';\nimport {subscribeOverride} from '../overrides.js';\nimport {injectTokens} from '../../tokens.js';\nimport {idOf} from '../timeline/identity.js';\nimport {\n  INSPECT_OVERLAY_TOGGLE_CHANNEL,\n  INSPECT_DATA_CHANNEL,\n} from '../../../types/inspector.js';\n\nexport interface SourceOverlayInitOptions {\n  key?: string;\n  editor?: EditorConfig | string;\n  workspaceRoot?: string;\n  throttleMs?: number;\n  exclude?: (el: Element) => boolean;\n  onSelect?: (info: ElementInfo) => void;\n  openInEditorPath?: string;\n}\n\nclass LitSourceOverlay extends HTMLElement {\n  #active = false;\n  #hot: {send: (event: string, data: unknown) => void} | undefined;\n  #options: SourceOverlayInitOptions = {};\n  #editor: EditorConfig = BUILTIN_EDITORS.vscode;\n  #resolver: ElementResolver = defaultResolver;\n  #dialog: HTMLDialogElement;\n  #mask: HTMLElement;\n  #highlight: HTMLElement;\n  #tooltip: HTMLElement;\n  #tag: HTMLElement;\n  #path: HTMLElement;\n  #info: ElementInfo | null = null;\n  #targetEl: Element | null = null;\n  #throttleTimer: ReturnType<typeof setTimeout> | undefined;\n  #scrollTimer: ReturnType<typeof setTimeout> | undefined;\n  #resizeObserver: ResizeObserver | undefined;\n  #cursorStyle: HTMLStyleElement | null = null;\n  // Whether the Vite HMR WebSocket is currently connected. Used to suppress the\n  // editor-URL-scheme fallback once the dev server is gone — otherwise a failed\n  // open-in-editor fetch would navigate the tab to `vscode://…`.\n  #connected = true;\n  #lastMouseX = 0;\n  #lastMouseY = 0;\n  #edgeDispose: (() => void) | undefined;\n  #overrideSubscribed = false;\n\n  constructor() {\n    super();\n    const root = this.attachShadow({mode: 'closed'});\n    root.innerHTML = OVERLAY_HTML;\n    this.#dialog = root.getElementById('overlay') as HTMLDialogElement;\n    this.#mask = root.getElementById('mask')!;\n    this.#highlight = root.getElementById('highlight')!;\n    this.#tooltip = root.getElementById('tooltip')!;\n    this.#tag = root.getElementById('tag')!;\n    this.#path = root.getElementById('path')!;\n    root.getElementById('open')!.addEventListener('click', (e) => {\n      e.stopPropagation();\n      if (this.#info !== null) this.#select(this.#info, true);\n    });\n    root.getElementById('copy')!.addEventListener('click', (e) => {\n      e.stopPropagation();\n      if (this.#info === null) return;\n      const text = `${this.#normalizePath(this.#info.source.filePath)}:${this.#info.source.lineNumber}`;\n      navigator.clipboard?.writeText(text);\n    });\n    this.#dialog.addEventListener('cancel', (e) => e.preventDefault());\n  }\n\n  connectedCallback() {\n    injectTokens();\n    document.addEventListener('mousemove', this.#onTrackMouse, true);\n    document.addEventListener('keydown', this.#onKeyDown, true);\n    const hot = (\n      import.meta as {\n        hot?: {\n          on: (event: string, cb: (data?: unknown) => void) => void;\n          send: (event: string, data: unknown) => void;\n        };\n      }\n    ).hot;\n    this.#hot = hot;\n    hot?.on('vite:beforeFullReload', () => this.deactivate());\n    hot?.on('vite:ws:disconnect', () => (this.#connected = false));\n    hot?.on('vite:ws:connect', () => (this.#connected = true));\n    // Toggle from the Vite DevTools command/shortcut (handler runs server-side).\n    hot?.on(INSPECT_OVERLAY_TOGGLE_CHANNEL, () => this.toggle());\n    // Keep the (bottom-fixed) tooltip clear of the Vite DevTools edge panel.\n    this.#edgeDispose = observeEdgeInsets((insets) => {\n      this.style.setProperty('--edge-bottom', `${insets.bottom}px`);\n    });\n    // Apply the panel's editor override live (and on load). Merge so other\n    // configured options (key, throttle, …) survive.\n    if (!this.#overrideSubscribed) {\n      this.#overrideSubscribed = true;\n      subscribeOverride(hot, (o) => {\n        if (o.sourceOverlayEditor !== undefined) {\n          this.#options = {...this.#options, editor: o.sourceOverlayEditor};\n          this.#editor = resolveEditor(o.sourceOverlayEditor);\n        }\n      });\n    }\n  }\n\n  disconnectedCallback() {\n    document.removeEventListener('mousemove', this.#onTrackMouse, true);\n    document.removeEventListener('keydown', this.#onKeyDown, true);\n    this.deactivate();\n    this.#edgeDispose?.();\n    this.#edgeDispose = undefined;\n  }\n\n  configure(options: SourceOverlayInitOptions) {\n    this.#options = options;\n    this.#editor = resolveEditor(options.editor);\n  }\n\n  activate() {\n    if (this.#active) return;\n    this.#active = true;\n    this.#dialog.showModal();\n    this.#mask.style.background = 'rgba(0,0,0,0.35)';\n    // The overlay is pointer-events:none, so the cursor reflects the hovered\n    // page element. Force a crosshair while inspecting. The closed shadow DOM\n    // tooltip is unaffected, so its buttons keep their own pointer cursor.\n    if (this.#cursorStyle === null) {\n      this.#cursorStyle = document.createElement('style');\n      this.#cursorStyle.textContent = '*{cursor:crosshair !important}';\n    }\n    document.head.append(this.#cursorStyle);\n    document.addEventListener('mousemove', this.#onMouseMove, true);\n    document.addEventListener('click', this.#onClick, true);\n    window.addEventListener('scroll', this.#onScrollOrResize, {passive: true});\n    window.addEventListener('resize', this.#onScrollOrResize, {passive: true});\n    this.#resolveAt(this.#lastMouseX, this.#lastMouseY);\n  }\n\n  deactivate() {\n    if (!this.#active) return;\n    this.#active = false;\n    this.#dialog.close();\n    this.#mask.style.background = 'rgba(0,0,0,0)';\n    this.#cursorStyle?.remove();\n    document.removeEventListener('mousemove', this.#onMouseMove, true);\n    document.removeEventListener('click', this.#onClick, true);\n    window.removeEventListener('scroll', this.#onScrollOrResize);\n    window.removeEventListener('resize', this.#onScrollOrResize);\n    if (this.#throttleTimer !== undefined) {\n      clearTimeout(this.#throttleTimer);\n      this.#throttleTimer = undefined;\n    }\n    if (this.#scrollTimer !== undefined) {\n      clearTimeout(this.#scrollTimer);\n      this.#scrollTimer = undefined;\n    }\n    this.#clearTarget();\n  }\n\n  toggle() {\n    if (this.#active) this.deactivate();\n    else this.activate();\n  }\n\n  #normalizePath(filePath: string): string {\n    const root = this.#options.workspaceRoot;\n    if (root !== undefined && filePath.startsWith(root)) {\n      const rest = filePath.slice(root.length);\n      return rest.startsWith('/') ? rest.slice(1) : rest;\n    }\n    return filePath;\n  }\n\n  async #openInEditor(filePath: string, lineNumber: number) {\n    const path = this.#normalizePath(filePath);\n    const endpoint = this.#options.openInEditorPath ?? '/__lit-open-in-editor';\n    try {\n      const params = new URLSearchParams({\n        file: path,\n        line: String(lineNumber),\n      });\n      const res = await fetch(`${endpoint}?${params.toString()}`);\n      if (res.ok) return;\n    } catch {\n      // Fall back to editor URL schemes (e.g. StackBlitz previews).\n    }\n    // Skip the URL-scheme fallback when the dev server is gone: a fetch failure\n    // there means \"server quit\", not \"no endpoint\", and navigating the tab to\n    // `vscode://…` on shutdown is jarring and unwanted.\n    if (!this.#connected) return;\n    window.open(this.#editor.url(path, lineNumber), '_self');\n  }\n\n  #updateHighlightRect() {\n    if (this.#targetEl === null) return;\n    const rect = this.#targetEl.getBoundingClientRect();\n    const raw = getComputedStyle(this)\n      .getPropertyValue('--lit-devtools-radius')\n      .trim();\n    const r = parseFloat(raw) || 6;\n    this.#highlight.style.left = `${rect.left - r}px`;\n    this.#highlight.style.top = `${rect.top - r}px`;\n    this.#highlight.style.width = `${rect.width + 2 * r}px`;\n    this.#highlight.style.height = `${rect.height + 2 * r}px`;\n    this.#mask.style.clipPath = buildSpotlightClipPath(\n      rect.left - r,\n      rect.top - r,\n      rect.width + 2 * r,\n      rect.height + 2 * r,\n      r\n    );\n  }\n\n  #showTooltip() {\n    if (this.#info === null) return;\n    this.#tag.textContent = `<${this.#info.tagName}>`;\n    this.#path.textContent = `${this.#normalizePath(this.#info.source.filePath)}:${this.#info.source.lineNumber}`;\n    this.#tooltip.style.display = 'flex';\n  }\n\n  #clearTarget() {\n    this.#targetEl = null;\n    this.#info = null;\n    this.#highlight.style.left = '0';\n    this.#highlight.style.top = '0';\n    this.#highlight.style.width = '0';\n    this.#highlight.style.height = '0';\n    this.#mask.style.clipPath = 'none';\n    this.#tooltip.style.display = 'none';\n    if (this.#resizeObserver !== undefined) {\n      this.#resizeObserver.disconnect();\n      this.#resizeObserver = undefined;\n    }\n  }\n\n  #shouldSkip(el: Element): boolean {\n    if (el === this.#dialog || this.#dialog.contains(el)) return true;\n    if (el.tagName === 'IFRAME') return true;\n    // Never target devtools' own injected elements (indicator, overlay).\n    const tag = el.tagName.toLowerCase();\n    if (tag === 'lit-source-overlay' || tag.startsWith('lit-devtools-')) {\n      return true;\n    }\n    const exclude = this.#options.exclude;\n    return exclude !== undefined && exclude(el);\n  }\n\n  async #resolveAt(x: number, y: number) {\n    this.#lastMouseX = x;\n    this.#lastMouseY = y;\n    const el = findSourceAtPoint(x, y, this.#dialog);\n    if (el === null || this.#shouldSkip(el)) {\n      this.#clearTarget();\n      return;\n    }\n    const host = findSourceHost(el);\n    if (host === null) {\n      this.#clearTarget();\n      return;\n    }\n    if (host === this.#targetEl && this.#info !== null) {\n      this.#updateHighlightRect();\n      return;\n    }\n    this.#targetEl = host;\n    if (this.#resizeObserver === undefined) {\n      this.#resizeObserver = new ResizeObserver(() =>\n        this.#updateHighlightRect()\n      );\n    } else {\n      this.#resizeObserver.disconnect();\n    }\n    this.#resizeObserver.observe(host);\n    const resolved = await this.#resolver.resolveElementInfo(el);\n    if (resolved === null) {\n      this.#clearTarget();\n      return;\n    }\n    this.#info = resolved;\n    this.#updateHighlightRect();\n    this.#showTooltip();\n  }\n\n  #onTrackMouse = (event: MouseEvent) => {\n    this.#lastMouseX = event.clientX;\n    this.#lastMouseY = event.clientY;\n  };\n\n  #onKeyDown = (event: KeyboardEvent) => {\n    if ((event.metaKey || event.ctrlKey) && event.shiftKey && !event.altKey) {\n      const pressed = event.key.toLowerCase();\n      const hotkey = (this.#options.key ?? 'e').toLowerCase();\n      if (pressed === hotkey) {\n        event.preventDefault();\n        this.toggle();\n      }\n    }\n    if (this.#active && event.key === 'Escape') {\n      event.preventDefault();\n      event.stopPropagation();\n    }\n  };\n\n  #onMouseMove = (event: MouseEvent) => {\n    if (!this.#active) return;\n    // Keep the current selection while hovering the tooltip so its buttons stay\n    // clickable — the tooltip isn't a source element, so re-resolving here would\n    // clear the target and hide the panel out from under the pointer.\n    if (this.#pointInTooltip(event.clientX, event.clientY)) return;\n    const throttleMs = this.#options.throttleMs ?? 50;\n    if (this.#throttleTimer !== undefined) return;\n    this.#throttleTimer = setTimeout(() => {\n      this.#throttleTimer = undefined;\n      // Resolve against the latest pointer position (kept current by\n      // #onTrackMouse), not the coords captured when this timer was scheduled\n      // ~throttleMs ago — otherwise the highlight lags the cursor during\n      // continuous movement.\n      const x = this.#lastMouseX;\n      const y = this.#lastMouseY;\n      if (this.#pointInTooltip(x, y)) return;\n      this.#resolveAt(x, y);\n    }, throttleMs);\n  };\n\n  #select(info: ElementInfo, openInEditor = false) {\n    const target = this.#targetEl;\n    // Cancel the whole selection mode on any deliberate pick, before acting —\n    // the editor may open via a URL scheme that doesn't navigate this tab away,\n    // so we can't rely on the open outcome to dismiss the inspector.\n    this.deactivate();\n    this.#options.onSelect?.(info);\n    if (openInEditor) {\n      this.#openInEditor(info.source.filePath, info.source.lineNumber);\n      return;\n    }\n    // Report the picked element to the DevTools panel, which selects it in the\n    // Components tree. Identity matches the inspector runtime via idOf().\n    if (target !== null) {\n      this.#hot?.send(INSPECT_DATA_CHANNEL, {type: 'pick', id: idOf(target)});\n      this.#openDevtoolsPanel();\n    }\n  }\n\n  /**\n   * Bring the Lit DevTools dock entry to the front so a pick is visible even\n   * when the panel was closed. The panel mirrors this from its own\n   * `inspector-activate` handler, but only once its iframe is mounted — and the\n   * @vitejs/devtools shell does not mount that iframe until the entry has been\n   * opened at least once. This overlay always runs on the page, so calling\n   * `switchEntry` here covers the cold-start case where no panel exists yet to\n   * receive the `pick` message.\n   */\n  #openDevtoolsPanel() {\n    try {\n      const ctx = (\n        window as unknown as Record<\n          string,\n          undefined | {docks?: {switchEntry?: (id: string) => Promise<boolean>}}\n        >\n      ).__VITE_DEVTOOLS_CLIENT_CONTEXT__;\n      ctx?.docks?.switchEntry?.('lit-devtools');\n    } catch {\n      // Not running inside the DevTools shell — ignore.\n    }\n  }\n\n  #pointInTooltip(x: number, y: number): boolean {\n    if (this.#tooltip.style.display === 'none') return false;\n    const r = this.#tooltip.getBoundingClientRect();\n    return x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;\n  }\n\n  #onClick = (event: MouseEvent) => {\n    if (!this.#active || this.#info === null) return;\n    // Clicks on the tooltip panel are handled by its own buttons (open/copy).\n    // The overlay's shadow root is closed, so we detect this by hit-rect rather\n    // than inspecting the event path, and let the event reach those buttons.\n    if (this.#pointInTooltip(event.clientX, event.clientY)) return;\n    event.preventDefault();\n    event.stopPropagation();\n    this.#select(this.#info, event.metaKey || event.ctrlKey);\n  };\n\n  #onScrollOrResize = () => {\n    if (this.#scrollTimer !== undefined) clearTimeout(this.#scrollTimer);\n    this.#scrollTimer = setTimeout(() => {\n      this.#scrollTimer = undefined;\n      if (this.#targetEl !== null) {\n        this.#updateHighlightRect();\n      }\n    }, 50);\n  };\n}\n\ncustomElements.define('lit-source-overlay', LitSourceOverlay);\n\nexport const initSourceOverlay = (\n  initOptions: SourceOverlayInitOptions = {}\n) => {\n  if (typeof window === 'undefined') return;\n  const el = document.createElement('lit-source-overlay') as LitSourceOverlay;\n  el.configure(initOptions);\n  document.body.append(el);\n};\n\nexport const toggleSourceOverlay = () => {\n  const el = document.querySelector(\n    'lit-source-overlay'\n  ) as LitSourceOverlay | null;\n  el?.toggle();\n};\n"]}

package/lib/runtime/source-overlay/source-host.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { ElementInfo } from '../../types.js';
+export interface ElementResolver {
+    resolveElementInfo(el: Element): Promise<ElementInfo | null>;
+}
+export declare const findSourceHost: (el: Element) => Element | null;
+export declare const deepElementFromPoint: (x: number, y: number) => Element | null;
+export declare const findSourceAtPoint: (x: number, y: number, dialog?: HTMLDialogElement | null) => Element | null;
+export declare const defaultResolver: ElementResolver;
+//# sourceMappingURL=source-host.d.ts.map

package/lib/runtime/source-overlay/source-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-host.d.ts","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/source-overlay/source-host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC9D;AAID,eAAO,MAAM,cAAc,GAAI,IAAI,OAAO,KAAG,OAAO,GAAG,IAiBtD,CAAC;AAKF,eAAO,MAAM,oBAAoB,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAAO,GAAG,IAUrE,CAAC;AAIF,eAAO,MAAM,iBAAiB,GAC5B,GAAG,MAAM,EACT,GAAG,MAAM,EACT,SAAQ,iBAAiB,GAAG,IAAW,KACtC,OAAO,GAAG,IA+BZ,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAkB7B,CAAC"}