@oddsquad/vite-plugin-lit 0.3.0 → 0.5.0

package/lib/plugins/open-in-editor.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import {existsSync} from 'node:fs';
+import {resolve as resolvePath, sep} from 'node:path';
+import {toLaunchEditor} from '../devframe/launch-editor.js';
+import {isTrustedRequest} from '../http.js';
+export const OPEN_IN_EDITOR_PATH = '/__lit-open-in-editor';
+export const createOpenInEditorMiddleware = (allowedRoots) => {
+  // First entry is the primary root: relative `file` params resolve against
+  // it. Every entry grants open access to files beneath it.
+  const roots = allowedRoots.map((r) => resolvePath(r));
+  return (req, res, next) => {
+    if (req.url === undefined) {
+      next();
+      return;
+    }
+    if (req.method !== undefined && req.method !== 'GET') {
+      res.statusCode = 405;
+      res.end('method not allowed');
+      return;
+    }
+    if (!isTrustedRequest(req.headers ?? {})) {
+      res.statusCode = 403;
+      res.end('forbidden');
+      return;
+    }
+    const query = req.url.includes('?')
+      ? req.url.slice(req.url.indexOf('?') + 1)
+      : '';
+    const params = new URLSearchParams(query);
+    const file = params.get('file');
+    if (file === null) {
+      res.statusCode = 400;
+      res.end('missing file parameter');
+      return;
+    }
+    // Confine the open to the allowed roots: resolve the requested path and
+    // reject anything that escapes all of them (path traversal, absolute
+    // paths to arbitrary files). `launch-editor` spawns the user's editor on
+    // this path, so an unvalidated `file` is a local-file-open /
+    // arg-injection vector.
+    const resolved = resolvePath(roots[0] ?? process.cwd(), file);
+    const allowed = roots.some(
+      (root) => resolved === root || resolved.startsWith(root + sep)
+    );
+    if (!allowed) {
+      res.statusCode = 403;
+      res.end('file outside allowed roots');
+      return;
+    }
+    if (!existsSync(resolved)) {
+      res.statusCode = 404;
+      res.end('file not found');
+      return;
+    }
+    // Coerce to integers so a crafted `line`/`column` can't smuggle extra
+    // shell-visible content through the `file:line:column` ref.
+    const line = String(
+      Math.max(1, Number.parseInt(params.get('line') ?? '1', 10) || 1)
+    );
+    const column = String(
+      Math.max(1, Number.parseInt(params.get('column') ?? '1', 10) || 1)
+    );
+    // The overlay names the editor it is using (the panel's override, else the
+    // configured one). Only keys `toLaunchEditor` knows become a command;
+    // anything else, or nothing, leaves `launch-editor` to auto-detect.
+    const editor = toLaunchEditor(params.get('editor') ?? undefined);
+    const fileRef = `${resolved}:${line}:${column}`;
+    import('launch-editor')
+      .then((mod) => {
+        const launch = mod.default ?? mod;
+        // `launch-editor` invokes the callback only on failure — synchronously
+        // when it can't guess an editor, later if the spawn errors. Reply `ok`
+        // right after launching; the guard keeps a sync failure's 500 first
+        // and drops a late async failure (the response is long gone).
+        let finished = false;
+        const finish = (statusCode, msg) => {
+          if (finished) return;
+          finished = true;
+          res.statusCode = statusCode;
+          res.end(msg);
+        };
+        launch(fileRef, editor, (_fileName, errorMessage) => {
+          if (errorMessage !== null) {
+            finish(500, errorMessage);
+          }
+        });
+        finish(200, 'ok');
+      })
+      .catch(next);
+  };
+};
+//# sourceMappingURL=open-in-editor.js.map

package/lib/plugins/open-in-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-editor.js","sourceRoot":"","sources":["../../src/lib/plugins/open-in-editor.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 {existsSync} from 'node:fs';\nimport {resolve as resolvePath, sep} from 'node:path';\nimport {toLaunchEditor} from '../devframe/launch-editor.js';\nimport {isTrustedRequest, type TrustHeaders} from '../http.js';\n\nexport const OPEN_IN_EDITOR_PATH = '/__lit-open-in-editor';\n\nexport const createOpenInEditorMiddleware = (\n  allowedRoots: readonly string[]\n) => {\n  // First entry is the primary root: relative `file` params resolve against\n  // it. Every entry grants open access to files beneath it.\n  const roots = allowedRoots.map((r) => resolvePath(r));\n  return (\n    req: {url?: string; method?: string; headers?: TrustHeaders},\n    res: {statusCode: number; end: (msg: string) => void},\n    next: (err?: unknown) => void\n  ) => {\n    if (req.url === undefined) {\n      next();\n      return;\n    }\n    if (req.method !== undefined && req.method !== 'GET') {\n      res.statusCode = 405;\n      res.end('method not allowed');\n      return;\n    }\n    if (!isTrustedRequest(req.headers ?? {})) {\n      res.statusCode = 403;\n      res.end('forbidden');\n      return;\n    }\n    const query = req.url.includes('?')\n      ? req.url.slice(req.url.indexOf('?') + 1)\n      : '';\n    const params = new URLSearchParams(query);\n    const file = params.get('file');\n    if (file === null) {\n      res.statusCode = 400;\n      res.end('missing file parameter');\n      return;\n    }\n    // Confine the open to the allowed roots: resolve the requested path and\n    // reject anything that escapes all of them (path traversal, absolute\n    // paths to arbitrary files). `launch-editor` spawns the user's editor on\n    // this path, so an unvalidated `file` is a local-file-open /\n    // arg-injection vector.\n    const resolved = resolvePath(roots[0] ?? process.cwd(), file);\n    const allowed = roots.some(\n      (root) => resolved === root || resolved.startsWith(root + sep)\n    );\n    if (!allowed) {\n      res.statusCode = 403;\n      res.end('file outside allowed roots');\n      return;\n    }\n    if (!existsSync(resolved)) {\n      res.statusCode = 404;\n      res.end('file not found');\n      return;\n    }\n    // Coerce to integers so a crafted `line`/`column` can't smuggle extra\n    // shell-visible content through the `file:line:column` ref.\n    const line = String(\n      Math.max(1, Number.parseInt(params.get('line') ?? '1', 10) || 1)\n    );\n    const column = String(\n      Math.max(1, Number.parseInt(params.get('column') ?? '1', 10) || 1)\n    );\n    // The overlay names the editor it is using (the panel's override, else the\n    // configured one). Only keys `toLaunchEditor` knows become a command;\n    // anything else, or nothing, leaves `launch-editor` to auto-detect.\n    const editor = toLaunchEditor(params.get('editor') ?? undefined);\n    const fileRef = `${resolved}:${line}:${column}`;\n    import('launch-editor')\n      .then(\n        (mod: {\n          default?: (\n            file: string,\n            editor: string | undefined,\n            cb: (fileName: string, errorMessage: string | null) => void\n          ) => void;\n        }) => {\n          const launch = (mod.default ?? mod) as (\n            file: string,\n            editor: string | undefined,\n            cb: (fileName: string, errorMessage: string | null) => void\n          ) => void;\n          // `launch-editor` invokes the callback only on failure — synchronously\n          // when it can't guess an editor, later if the spawn errors. Reply `ok`\n          // right after launching; the guard keeps a sync failure's 500 first\n          // and drops a late async failure (the response is long gone).\n          let finished = false;\n          const finish = (statusCode: number, msg: string) => {\n            if (finished) return;\n            finished = true;\n            res.statusCode = statusCode;\n            res.end(msg);\n          };\n          launch(\n            fileRef,\n            editor,\n            (_fileName: string, errorMessage: string | null) => {\n              if (errorMessage !== null) {\n                finish(500, errorMessage);\n              }\n            }\n          );\n          finish(200, 'ok');\n        }\n      )\n      .catch(next);\n  };\n};\n"]}

package/lib/plugins/shared.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Resolves a runtime module to an absolute fs path (served via `/@fs/`), so
+ * the plugin works from any served root. Falls back from the built `.js` to
+ * the `.ts` source when running un-built (e.g. under vitest).
+ */
+export declare const resolveRuntimeModule: (name: string) => string;
+export declare const JS_FILE_RE: RegExp;
+//# sourceMappingURL=shared.d.ts.map

package/lib/plugins/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/lib/plugins/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,SAAU,MAAM,KAAG,MAQnD,CAAC;AAEF,eAAO,MAAM,UAAU,QAAoB,CAAC"}

package/lib/plugins/shared.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import {existsSync} from 'node:fs';
+import {fileURLToPath} from 'node:url';
+/**
+ * Resolves a runtime module to an absolute fs path (served via `/@fs/`), so
+ * the plugin works from any served root. Falls back from the built `.js` to
+ * the `.ts` source when running un-built (e.g. under vitest).
+ */
+export const resolveRuntimeModule = (name) => {
+  for (const ext of ['js', 'ts']) {
+    const url = new URL(`../runtime/${name}.${ext}`, import.meta.url);
+    if (existsSync(url)) {
+      return fileURLToPath(url).replace(/\\/g, '/');
+    }
+  }
+  throw new Error(`[lit-plugin] runtime module not found: ${name}`);
+};
+export const JS_FILE_RE = /\.[cm]?[jt]sx?$/;
+//# sourceMappingURL=shared.js.map

package/lib/plugins/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/lib/plugins/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AACnC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAU,EAAE;IAC3D,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAU,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,IAAI,IAAI,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport {existsSync} from 'node:fs';\nimport {fileURLToPath} from 'node:url';\n\n/**\n * Resolves a runtime module to an absolute fs path (served via `/@fs/`), so\n * the plugin works from any served root. Falls back from the built `.js` to\n * the `.ts` source when running un-built (e.g. under vitest).\n */\nexport const resolveRuntimeModule = (name: string): string => {\n  for (const ext of ['js', 'ts'] as const) {\n    const url = new URL(`../runtime/${name}.${ext}`, import.meta.url);\n    if (existsSync(url)) {\n      return fileURLToPath(url).replace(/\\\\/g, '/');\n    }\n  }\n  throw new Error(`[lit-plugin] runtime module not found: ${name}`);\n};\n\nexport const JS_FILE_RE = /\\.[cm]?[jt]sx?$/;\n"]}

package/lib/plugins/timeline-virtual.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { Plugin } from 'vite';
+/**
+ * The public timeline API virtual module, served in dev and build alike:
+ * app code importing it must keep building under `vite build`, where the HMR
+ * plugin doesn't apply. While these hooks lived on that serve-only plugin,
+ * nothing claimed the specifier during a build and the bundler failed to
+ * resolve it.
+ *
+ * `getTimeline` is a getter, not a value: `litPlugin()` re-resolves its
+ * options against the loaded env in a `config` hook, which runs after the
+ * plugin array is built.
+ */
+export declare const litTimelineVirtual: (getTimeline?: () => boolean) => Plugin;
+//# sourceMappingURL=timeline-virtual.d.ts.map

package/lib/plugins/timeline-virtual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-virtual.d.ts","sourceRoot":"","sources":["../../src/lib/plugins/timeline-virtual.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,MAAM,CAAC;AASjC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,iBAChB,MAAM,OAAO,KACzB,MA6BF,CAAC"}

package/lib/plugins/timeline-virtual.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import {resolveRuntimeModule} from './shared.js';
+const TIMELINE_VIRTUAL_ID = 'virtual:lit-plugin/timeline';
+const TIMELINE_RESOLVED_ID = '\0virtual:lit-plugin/timeline';
+const TIMELINE_STUB =
+  'export const addTimelineEvent = () => {};\n' +
+  'export const addTimelineLayer = () => {};\n';
+/**
+ * The public timeline API virtual module, served in dev and build alike:
+ * app code importing it must keep building under `vite build`, where the HMR
+ * plugin doesn't apply. While these hooks lived on that serve-only plugin,
+ * nothing claimed the specifier during a build and the bundler failed to
+ * resolve it.
+ *
+ * `getTimeline` is a getter, not a value: `litPlugin()` re-resolves its
+ * options against the loaded env in a `config` hook, which runs after the
+ * plugin array is built.
+ */
+export const litTimelineVirtual = (getTimeline = () => false) => {
+  let isBuild = false;
+  return {
+    name: 'lit-timeline-virtual',
+    configResolved(config) {
+      isBuild = config.command === 'build';
+    },
+    resolveId(id) {
+      return id === TIMELINE_VIRTUAL_ID ? TIMELINE_RESOLVED_ID : null;
+    },
+    load(id) {
+      if (id !== TIMELINE_RESOLVED_ID) {
+        return null;
+      }
+      // Under build the stub is unconditional, even with `timeline: true`.
+      // The runtime delivers only over `import.meta.hot`, so in a production
+      // bundle it is a queue that never drains; the stub keeps the transport
+      // out of the bundle and makes the documented "no-op in production"
+      // behavior true.
+      if (isBuild || !getTimeline()) {
+        return {code: TIMELINE_STUB, moduleType: 'js'};
+      }
+      const apiPath = resolveRuntimeModule('timeline/public-api');
+      return {
+        code: `export * from ${JSON.stringify(apiPath)};\n`,
+        moduleType: 'js',
+      };
+    },
+  };
+};
+//# sourceMappingURL=timeline-virtual.js.map

package/lib/plugins/timeline-virtual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-virtual.js","sourceRoot":"","sources":["../../src/lib/plugins/timeline-virtual.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAC,oBAAoB,EAAC,MAAM,aAAa,CAAC;AAEjD,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AAC1D,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAC7D,MAAM,aAAa,GACjB,6CAA6C;IAC7C,6CAA6C,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,WAAW,GAAkB,GAAG,EAAE,CAAC,KAAK,EAChC,EAAE;IACV,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,cAAc,CAAC,MAAM;YACnB,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC;QACvC,CAAC;QACD,SAAS,CAAC,EAAE;YACV,OAAO,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,KAAK,oBAAoB,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,qEAAqE;YACrE,uEAAuE;YACvE,uEAAuE;YACvE,mEAAmE;YACnE,iBAAiB;YACjB,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC9B,OAAO,EAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAC,CAAC;YACjD,CAAC;YACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;YAC5D,OAAO;gBACL,IAAI,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK;gBACnD,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {Plugin} from 'vite';\nimport {resolveRuntimeModule} from './shared.js';\n\nconst TIMELINE_VIRTUAL_ID = 'virtual:lit-plugin/timeline';\nconst TIMELINE_RESOLVED_ID = '\\0virtual:lit-plugin/timeline';\nconst TIMELINE_STUB =\n  'export const addTimelineEvent = () => {};\\n' +\n  'export const addTimelineLayer = () => {};\\n';\n\n/**\n * The public timeline API virtual module, served in dev and build alike:\n * app code importing it must keep building under `vite build`, where the HMR\n * plugin doesn't apply. While these hooks lived on that serve-only plugin,\n * nothing claimed the specifier during a build and the bundler failed to\n * resolve it.\n *\n * `getTimeline` is a getter, not a value: `litPlugin()` re-resolves its\n * options against the loaded env in a `config` hook, which runs after the\n * plugin array is built.\n */\nexport const litTimelineVirtual = (\n  getTimeline: () => boolean = () => false\n): Plugin => {\n  let isBuild = false;\n  return {\n    name: 'lit-timeline-virtual',\n    configResolved(config) {\n      isBuild = config.command === 'build';\n    },\n    resolveId(id) {\n      return id === TIMELINE_VIRTUAL_ID ? TIMELINE_RESOLVED_ID : null;\n    },\n    load(id) {\n      if (id !== TIMELINE_RESOLVED_ID) {\n        return null;\n      }\n      // Under build the stub is unconditional, even with `timeline: true`.\n      // The runtime delivers only over `import.meta.hot`, so in a production\n      // bundle it is a queue that never drains; the stub keeps the transport\n      // out of the bundle and makes the documented \"no-op in production\"\n      // behavior true.\n      if (isBuild || !getTimeline()) {\n        return {code: TIMELINE_STUB, moduleType: 'js'};\n      }\n      const apiPath = resolveRuntimeModule('timeline/public-api');\n      return {\n        code: `export * from ${JSON.stringify(apiPath)};\\n`,\n        moduleType: 'js',\n      };\n    },\n  };\n};\n"]}

package/lib/runtime/css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAE1C,CAAC;AAqBF;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,QA2BtC,CAAC"}
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAE1C,CAAC;AAqBF;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,QAkCtC,CAAC"}

package/lib/runtime/css.js

@@ -97,13 +97,20 @@ export const urlSheet = (url) => {
   const update = (next) => {
     const token = ++latest;
     return fetch(devDirect(next))
-      .then((r) => r.text())
+      .then((r) => {
+        // A 404 still has a body (Vite's fallback page); don't adopt it as css.
+        if (!r.ok) throw new Error(`HTTP ${r.status}`);
+        return r.text();
+      })
       .then((css) => {
         if (token === latest) {
           sheet.replaceSync(css);
         }
       })
-      .catch(() => {});
+      .catch((err) => {
+        // Keep the last good sheet; just say why this update didn't land.
+        console.warn(`[lit-plugin] urlSheet: failed to load ${next}:`, err);
+      });
   };
   void update(url);
   return {

package/lib/runtime/css.js.map

@@ -1 +1 @@
-{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,GAAY,EAAE,CACzB,OAAO,IAAgC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAClD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE;IACxC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AACxD,CAAC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAY,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC7C,MAAM,KAAK,GAAG,EAAE,MAAM,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACrB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrB,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Browser helpers for referencing CSS files from shadow roots via Vite's\n * `?url` imports.\n *\n * A `?url` import yields a real stylesheet URL — the dev server serves the\n * file as CSS, and `vite build` emits it as a hashed `.css` asset. That\n * makes it the right base for `<link>` hrefs and `@import url()`s inside\n * shadow roots. The one gap is dev HMR: the imported URL string is identical\n * across module re-executions, so the browser would keep the stale\n * stylesheet. These helpers close that gap.\n *\n * This module is dependency-free and must stay safe to load in any\n * environment.\n */\n\n/**\n * Vite's dev flag. Accessed as a direct member expression (`import.meta.env.DEV`)\n * so the bundler can statically replace it per key. Aliasing the whole object\n * (`const env = import.meta.env`) instead defeats that replacement and makes\n * Vite inline the ENTIRE serialized `import.meta.env` — every env var — into the\n * consumer bundle. Optional chaining keeps this safe where `import.meta.env` is\n * absent (non-Vite runtimes).\n */\nconst isDev = (): boolean =>\n  (import.meta as {env?: {DEV?: boolean}}).env?.DEV === true;\n\n/**\n * Appends a cache-busting query to a `?url`-imported CSS file URL in dev.\n *\n * Call this at *module scope* (not in `render()`, where every render would\n * refetch): each HMR re-execution then yields a fresh href and the browser\n * refetches the changed stylesheet.\n *\n * In production builds the URL is a content-hashed asset, so the input is\n * returned unchanged.\n *\n * @example\n * ```ts\n * import cssUrl from './my-element.css?url';\n * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';\n *\n * const href = devCacheBust(cssUrl); // module scope\n * html`<link rel=\"stylesheet\" href=\"${href}\" />`;\n * ```\n */\nexport const devCacheBust = (url: string): string => {\n  return isDev() ? `${url}?t=${Date.now()}` : url;\n};\n\n/**\n * In dev, turns a `?url`-imported CSS path into one that fetches the\n * *compiled CSS bytes* (`text/css`). Vite serves a `?url` CSS path as a JS\n * module (`__vite__updateStyle(…)`), so a plain `fetch().text()` returns\n * JavaScript; the `direct` query makes it return the stylesheet instead,\n * pipeline-processed the same way the build asset is. In production the URL\n * is already a real `.css` asset, so it's returned unchanged.\n *\n * Joined with `?` or `&` depending on whether the URL already carries a query\n * (a freshly started dev server yields a bare path; after an HMR cache-bust\n * it carries `?t=…`).\n */\nconst devDirect = (url: string): string => {\n  if (!isDev()) {\n    return url;\n  }\n  return `${url}${url.includes('?') ? '&' : '?'}direct`;\n};\n\n/**\n * A shared `CSSStyleSheet` backed by a `?url` CSS asset, plus the callback to\n * hot-swap it in place. Returned by {@link urlSheet}.\n */\nexport interface UrlSheet {\n  /**\n   * The constructed stylesheet. Adopt it from any number of components\n   * (`static styles = [sheet]`); an edit to the source CSS re-fetches and\n   * `replaceSync()`s it, updating every shadow root that adopted it without\n   * re-rendering a component or reloading the page.\n   *\n   * It is empty until the first fetch resolves, so expect a brief flash of\n   * unstyled content on initial load — the cost of keeping the CSS as a real\n   * asset rather than inlining it into the JS bundle.\n   */\n  sheet: CSSStyleSheet;\n  /**\n   * Vite HMR accept callback for the `?url` dependency. Wire it up with the\n   * *same literal specifier* you imported — Vite resolves accepted deps by\n   * static analysis, so the string has to appear in your module:\n   *\n   * ```ts\n   * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n   * ```\n   *\n   * Typed to match Vite's accept callback (`ModuleNamespace | undefined`) so\n   * it drops straight in; the new module's `default` export is the updated\n   * `?url` string.\n   */\n  onHotUpdate: (mod: Record<string, unknown> | undefined) => void;\n}\n\n/**\n * Builds a {@link UrlSheet} from a `?url`-imported CSS asset: a single\n * constructed `CSSStyleSheet`, shareable across shadow roots via\n * `adoptedStyleSheets`, that hot-swaps in place on edits — no component\n * re-render, no full-page reload.\n *\n * `?url` keeps the stylesheet as a standalone, pipeline-processed `.css` file\n * in the build output (unlike `?inline`/`?raw`, which inline it into the JS\n * chunk). The file is read into the sheet at runtime via `fetch()`, with the\n * dev/build path difference handled internally.\n *\n * @example\n * ```ts\n * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';\n * import sheetUrl from './utils.css?url';\n *\n * const {sheet, onHotUpdate} = urlSheet(sheetUrl);\n * export default sheet; // `static styles = [sheet]` in components\n *\n * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n * ```\n */\nexport const urlSheet = (url: string): UrlSheet => {\n  const sheet = new CSSStyleSheet();\n  // Guards against out-of-order fetch resolution: two rapid edits fire\n  // overlapping fetches, and a slower earlier one must not land after (and\n  // clobber) a newer one. Only the most recently issued request applies.\n  let latest = 0;\n  const update = (next: string): Promise<void> => {\n    const token = ++latest;\n    return fetch(devDirect(next))\n      .then((r) => r.text())\n      .then((css) => {\n        if (token === latest) {\n          sheet.replaceSync(css);\n        }\n      })\n      .catch(() => {});\n  };\n  void update(url);\n  return {\n    sheet,\n    onHotUpdate: (mod) => {\n      const next = mod?.['default'];\n      if (typeof next === 'string') {\n        void update(next);\n      }\n    },\n  };\n};\n"]}
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,GAAY,EAAE,CACzB,OAAO,IAAgC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAClD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE;IACxC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AACxD,CAAC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAY,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC7C,MAAM,KAAK,GAAG,EAAE,MAAM,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,wEAAwE;YACxE,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,kEAAkE;YAClE,OAAO,CAAC,IAAI,CAAC,yCAAyC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Browser helpers for referencing CSS files from shadow roots via Vite's\n * `?url` imports.\n *\n * A `?url` import yields a real stylesheet URL — the dev server serves the\n * file as CSS, and `vite build` emits it as a hashed `.css` asset. That\n * makes it the right base for `<link>` hrefs and `@import url()`s inside\n * shadow roots. The one gap is dev HMR: the imported URL string is identical\n * across module re-executions, so the browser would keep the stale\n * stylesheet. These helpers close that gap.\n *\n * This module is dependency-free and must stay safe to load in any\n * environment.\n */\n\n/**\n * Vite's dev flag. Accessed as a direct member expression (`import.meta.env.DEV`)\n * so the bundler can statically replace it per key. Aliasing the whole object\n * (`const env = import.meta.env`) instead defeats that replacement and makes\n * Vite inline the ENTIRE serialized `import.meta.env` — every env var — into the\n * consumer bundle. Optional chaining keeps this safe where `import.meta.env` is\n * absent (non-Vite runtimes).\n */\nconst isDev = (): boolean =>\n  (import.meta as {env?: {DEV?: boolean}}).env?.DEV === true;\n\n/**\n * Appends a cache-busting query to a `?url`-imported CSS file URL in dev.\n *\n * Call this at *module scope* (not in `render()`, where every render would\n * refetch): each HMR re-execution then yields a fresh href and the browser\n * refetches the changed stylesheet.\n *\n * In production builds the URL is a content-hashed asset, so the input is\n * returned unchanged.\n *\n * @example\n * ```ts\n * import cssUrl from './my-element.css?url';\n * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';\n *\n * const href = devCacheBust(cssUrl); // module scope\n * html`<link rel=\"stylesheet\" href=\"${href}\" />`;\n * ```\n */\nexport const devCacheBust = (url: string): string => {\n  return isDev() ? `${url}?t=${Date.now()}` : url;\n};\n\n/**\n * In dev, turns a `?url`-imported CSS path into one that fetches the\n * *compiled CSS bytes* (`text/css`). Vite serves a `?url` CSS path as a JS\n * module (`__vite__updateStyle(…)`), so a plain `fetch().text()` returns\n * JavaScript; the `direct` query makes it return the stylesheet instead,\n * pipeline-processed the same way the build asset is. In production the URL\n * is already a real `.css` asset, so it's returned unchanged.\n *\n * Joined with `?` or `&` depending on whether the URL already carries a query\n * (a freshly started dev server yields a bare path; after an HMR cache-bust\n * it carries `?t=…`).\n */\nconst devDirect = (url: string): string => {\n  if (!isDev()) {\n    return url;\n  }\n  return `${url}${url.includes('?') ? '&' : '?'}direct`;\n};\n\n/**\n * A shared `CSSStyleSheet` backed by a `?url` CSS asset, plus the callback to\n * hot-swap it in place. Returned by {@link urlSheet}.\n */\nexport interface UrlSheet {\n  /**\n   * The constructed stylesheet. Adopt it from any number of components\n   * (`static styles = [sheet]`); an edit to the source CSS re-fetches and\n   * `replaceSync()`s it, updating every shadow root that adopted it without\n   * re-rendering a component or reloading the page.\n   *\n   * It is empty until the first fetch resolves, so expect a brief flash of\n   * unstyled content on initial load — the cost of keeping the CSS as a real\n   * asset rather than inlining it into the JS bundle.\n   */\n  sheet: CSSStyleSheet;\n  /**\n   * Vite HMR accept callback for the `?url` dependency. Wire it up with the\n   * *same literal specifier* you imported — Vite resolves accepted deps by\n   * static analysis, so the string has to appear in your module:\n   *\n   * ```ts\n   * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n   * ```\n   *\n   * Typed to match Vite's accept callback (`ModuleNamespace | undefined`) so\n   * it drops straight in; the new module's `default` export is the updated\n   * `?url` string.\n   */\n  onHotUpdate: (mod: Record<string, unknown> | undefined) => void;\n}\n\n/**\n * Builds a {@link UrlSheet} from a `?url`-imported CSS asset: a single\n * constructed `CSSStyleSheet`, shareable across shadow roots via\n * `adoptedStyleSheets`, that hot-swaps in place on edits — no component\n * re-render, no full-page reload.\n *\n * `?url` keeps the stylesheet as a standalone, pipeline-processed `.css` file\n * in the build output (unlike `?inline`/`?raw`, which inline it into the JS\n * chunk). The file is read into the sheet at runtime via `fetch()`, with the\n * dev/build path difference handled internally.\n *\n * @example\n * ```ts\n * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';\n * import sheetUrl from './utils.css?url';\n *\n * const {sheet, onHotUpdate} = urlSheet(sheetUrl);\n * export default sheet; // `static styles = [sheet]` in components\n *\n * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n * ```\n */\nexport const urlSheet = (url: string): UrlSheet => {\n  const sheet = new CSSStyleSheet();\n  // Guards against out-of-order fetch resolution: two rapid edits fire\n  // overlapping fetches, and a slower earlier one must not land after (and\n  // clobber) a newer one. Only the most recently issued request applies.\n  let latest = 0;\n  const update = (next: string): Promise<void> => {\n    const token = ++latest;\n    return fetch(devDirect(next))\n      .then((r) => {\n        // A 404 still has a body (Vite's fallback page); don't adopt it as css.\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        return r.text();\n      })\n      .then((css) => {\n        if (token === latest) {\n          sheet.replaceSync(css);\n        }\n      })\n      .catch((err: unknown) => {\n        // Keep the last good sheet; just say why this update didn't land.\n        console.warn(`[lit-plugin] urlSheet: failed to load ${next}:`, err);\n      });\n  };\n  void update(url);\n  return {\n    sheet,\n    onHotUpdate: (mod) => {\n      const next = mod?.['default'];\n      if (typeof next === 'string') {\n        void update(next);\n      }\n    },\n  };\n};\n"]}

package/lib/runtime/indicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"indicator.js","sourceRoot":"","sources":["../../src/lib/runtime/indicator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Custom element for the HMR update indicator.\n * Injected by the Vite plugin as an external module so that\n * `import.meta.hot` is available.\n */\n\nimport {FONT_MONO_VAR} from './fonts.js';\nimport {FLAME_ICON} from '../icons.js';\nimport {subscribeOverride} from './overrides.js';\nimport {observeEdgeInsets} from './edge-panel.js';\nimport {injectTokens} from '../tokens.js';\n\n/** One entry of a Vite `vite:afterUpdate` payload. */\ninterface ViteUpdate {\n  type?: string;\n  path?: string;\n  acceptedPath?: string;\n}\n\n/**\n * True when an HMR batch is purely a stylesheet swap — every update is either\n * a `css-update` or a `js-update` whose accepted module is a `.css` source\n * (the shared-sheet queries `?css-sheet`/`?raw`/`?url` all accept a `.css`\n * path). Such a batch restyles adopted sheets in place with no re-render.\n *\n * Heuristic: keyed on the accepted path ending in `.css`. Robust for this\n * plugin's own queries; a user hand-wiring `import.meta.hot.accept` on a raw\n * `.css` would also read as a style swap, which is the intended grouping. An\n * empty/missing payload can't be classified, so it counts as a re-render\n * rather than being silently dropped.\n */\nfunction isStyleSwap(data: unknown): boolean {\n  const updates = (data as {updates?: ViteUpdate[]} | undefined)?.updates;\n  if (!Array.isArray(updates) || updates.length === 0) return false;\n  return updates.every((u) => {\n    if (u.type === 'css-update') return true;\n    if (u.type === 'js-update') {\n      return (u.acceptedPath ?? u.path ?? '').split('?')[0].endsWith('.css');\n    }\n    return false;\n  });\n}\n\nclass LitDevtoolsIndicator extends HTMLElement {\n  #initialized = false;\n  #count = 0;\n  #container: HTMLElement;\n  #countEl: HTMLElement | null = null;\n\n  constructor() {\n    super();\n    const root = this.attachShadow({mode: 'closed'});\n    // `--idle-op` is the at-rest opacity: 0 (invisible until a pulse) without a\n    // count, .5 (count stays legible) with one. The count display and idle\n    // opacity are both driven by the `.with-count` class so the panel can\n    // toggle the count on/off live (see #setCount).\n    root.innerHTML = `\n      <style>\n        @keyframes pulse{0%{opacity:var(--idle-op,0)}15%{opacity:1}80%{opacity:1}100%{opacity:var(--idle-op,0)}}\n        :host{\n          position:fixed;inset:0;display:grid;\n          z-index:2147483647;pointer-events:none;\n          /* Base padding plus the inset the Vite DevTools edge panel occupies\n             on each edge (set from JS), so the indicator never sits on it. */\n          padding:\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-top,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-right,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-bottom,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-left,0px))\n        }\n        #container{\n          place-self:var(--lit-devtools-hmr-indicator-align,end end);\n          display:flex;align-items:stretch;\n          background:var(--lit-devtools-surface-elevated);color:var(--lit-devtools-text-strong);\n          backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);\n          border-radius:var(--lit-devtools-radius-md);\n          font:12px/1 ${FONT_MONO_VAR};font-variant-numeric:tabular-nums;\n          overflow:hidden;opacity:var(--idle-op,0)\n        }\n        #container.with-count{--idle-op:.5}\n        #container.active{animation:pulse 2.5s ease-out forwards}\n        #icon{display:flex;align-items:center;justify-content:center;padding:0 10px}\n        #icon svg{width:16px;height:16px;display:block;fill:currentColor}\n        #indicator{\n          display:flex;align-items:center;gap:6px;\n          padding:7px 12px;\n          border-left:1px solid var(--lit-devtools-border-subtle)\n        }\n        .dot{width:8px;height:8px;border-radius:50%;background:var(--lit-devtools-success);flex-shrink:0}\n        /* Style-only swaps (shared adopted stylesheet hot-swap, no re-render)\n           pulse in the calmer info color and don't bump the count. */\n        #container.style-swap .dot{background:var(--lit-devtools-info)}\n        .count{display:none}\n        #container.with-count .count{display:inline}\n      </style>\n      <div id=\"container\"><span id=\"icon\">${FLAME_ICON}</span><span id=\"indicator\"><span class=\"dot\"></span><span class=\"count\">0</span></span></div>\n    `;\n    this.#container = root.getElementById('container')!;\n    this.#countEl = root.querySelector('.count');\n    this.#setCount(this.hasAttribute('count'));\n  }\n\n  /** Show/hide the cumulative update count (and the at-rest opacity). */\n  #setCount(enabled: boolean) {\n    this.#container.classList.toggle('with-count', enabled);\n  }\n\n  connectedCallback() {\n    if (this.#initialized) return;\n    this.#initialized = true;\n    injectTokens();\n    const hot = (\n      import.meta as {\n        hot?: {on: (event: string, cb: (data?: unknown) => void) => void};\n      }\n    ).hot;\n    hot?.on('vite:afterUpdate', (data) => {\n      // Count only updates that actually re-render/re-execute a component;\n      // a pure shared-stylesheet swap (?css-sheet / ?raw / ?url adopted sheet)\n      // restyles in place without re-rendering, so it pulses but doesn't count.\n      const styleSwap = isStyleSwap(data);\n      if (!styleSwap && this.#countEl !== null) {\n        this.#countEl.textContent = String(++this.#count);\n      }\n      this.#container.classList.toggle('style-swap', styleSwap);\n      this.#container.classList.remove('active');\n      void this.#container.offsetWidth;\n      this.#container.classList.add('active');\n    });\n    // Let the DevTools panel hide/show the indicator and its count live (and\n    // across reloads).\n    subscribeOverride(hot, (o) => {\n      if (o.hmrIndicatorVisible !== undefined) {\n        this.style.display = o.hmrIndicatorVisible ? '' : 'none';\n      }\n      if (o.hmrIndicatorCount !== undefined) {\n        this.#setCount(o.hmrIndicatorCount);\n      }\n    });\n    // Stay clear of the Vite DevTools edge panel.\n    observeEdgeInsets((insets) => {\n      this.style.setProperty('--edge-top', `${insets.top}px`);\n      this.style.setProperty('--edge-right', `${insets.right}px`);\n      this.style.setProperty('--edge-bottom', `${insets.bottom}px`);\n      this.style.setProperty('--edge-left', `${insets.left}px`);\n    });\n  }\n}\n\ncustomElements.define('lit-devtools-hmr-indicator', LitDevtoolsIndicator);\n"]}
+{"version":3,"file":"indicator.js","sourceRoot":"","sources":["../../src/lib/runtime/indicator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Custom element for the HMR update indicator.\n * Injected by the Vite plugin as an external module so that\n * `import.meta.hot` is available.\n */\n\nimport {FONT_MONO_VAR} from './fonts.js';\nimport {FLAME_ICON} from '../icons.js';\nimport {subscribeOverride} from './overrides.js';\nimport type {ViteHotLike} from './page-channel.js';\nimport {observeEdgeInsets} from './edge-panel.js';\nimport {injectTokens} from '../tokens.js';\n\n/** One entry of a Vite `vite:afterUpdate` payload. */\ninterface ViteUpdate {\n  type?: string;\n  path?: string;\n  acceptedPath?: string;\n}\n\n/**\n * True when an HMR batch is purely a stylesheet swap — every update is either\n * a `css-update` or a `js-update` whose accepted module is a `.css` source\n * (the shared-sheet queries `?css-sheet`/`?raw`/`?url` all accept a `.css`\n * path). Such a batch restyles adopted sheets in place with no re-render.\n *\n * Heuristic: keyed on the accepted path ending in `.css`. Robust for this\n * plugin's own queries; a user hand-wiring `import.meta.hot.accept` on a raw\n * `.css` would also read as a style swap, which is the intended grouping. An\n * empty/missing payload can't be classified, so it counts as a re-render\n * rather than being silently dropped.\n */\nfunction isStyleSwap(data: unknown): boolean {\n  const updates = (data as {updates?: ViteUpdate[]} | undefined)?.updates;\n  if (!Array.isArray(updates) || updates.length === 0) return false;\n  return updates.every((u) => {\n    if (u.type === 'css-update') return true;\n    if (u.type === 'js-update') {\n      return (u.acceptedPath ?? u.path ?? '').split('?')[0].endsWith('.css');\n    }\n    return false;\n  });\n}\n\nclass LitDevtoolsIndicator extends HTMLElement {\n  #initialized = false;\n  #count = 0;\n  #container: HTMLElement;\n  #countEl: HTMLElement | null = null;\n\n  constructor() {\n    super();\n    const root = this.attachShadow({mode: 'closed'});\n    // `--idle-op` is the at-rest opacity: 0 (invisible until a pulse) without a\n    // count, .5 (count stays legible) with one. The count display and idle\n    // opacity are both driven by the `.with-count` class so the panel can\n    // toggle the count on/off live (see #setCount).\n    root.innerHTML = `\n      <style>\n        @keyframes pulse{0%{opacity:var(--idle-op,0)}15%{opacity:1}80%{opacity:1}100%{opacity:var(--idle-op,0)}}\n        :host{\n          position:fixed;inset:0;display:grid;\n          z-index:2147483647;pointer-events:none;\n          /* Base padding plus the inset the Vite DevTools edge panel occupies\n             on each edge (set from JS), so the indicator never sits on it. */\n          padding:\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-top,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-right,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-bottom,0px))\n            calc(var(--lit-devtools-hmr-indicator-padding,16px) + var(--edge-left,0px))\n        }\n        #container{\n          place-self:var(--lit-devtools-hmr-indicator-align,end end);\n          display:flex;align-items:stretch;\n          background:var(--lit-devtools-surface-elevated);color:var(--lit-devtools-text-strong);\n          backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);\n          border-radius:var(--lit-devtools-radius-md);\n          font:12px/1 ${FONT_MONO_VAR};font-variant-numeric:tabular-nums;\n          overflow:hidden;opacity:var(--idle-op,0)\n        }\n        #container.with-count{--idle-op:.5}\n        #container.active{animation:pulse 2.5s ease-out forwards}\n        #icon{display:flex;align-items:center;justify-content:center;padding:0 10px}\n        #icon svg{width:16px;height:16px;display:block;fill:currentColor}\n        #indicator{\n          display:flex;align-items:center;gap:6px;\n          padding:7px 12px;\n          border-left:1px solid var(--lit-devtools-border-subtle)\n        }\n        .dot{width:8px;height:8px;border-radius:50%;background:var(--lit-devtools-success);flex-shrink:0}\n        /* Style-only swaps (shared adopted stylesheet hot-swap, no re-render)\n           pulse in the calmer info color and don't bump the count. */\n        #container.style-swap .dot{background:var(--lit-devtools-info)}\n        .count{display:none}\n        #container.with-count .count{display:inline}\n      </style>\n      <div id=\"container\"><span id=\"icon\">${FLAME_ICON}</span><span id=\"indicator\"><span class=\"dot\"></span><span class=\"count\">0</span></span></div>\n    `;\n    this.#container = root.getElementById('container')!;\n    this.#countEl = root.querySelector('.count');\n    this.#setCount(this.hasAttribute('count'));\n  }\n\n  /** Show/hide the cumulative update count (and the at-rest opacity). */\n  #setCount(enabled: boolean) {\n    this.#container.classList.toggle('with-count', enabled);\n  }\n\n  connectedCallback() {\n    if (this.#initialized) return;\n    this.#initialized = true;\n    injectTokens();\n    const hot = (import.meta as {hot?: ViteHotLike}).hot;\n    hot?.on('vite:afterUpdate', (data) => {\n      // Count only updates that actually re-render/re-execute a component;\n      // a pure shared-stylesheet swap (?css-sheet / ?raw / ?url adopted sheet)\n      // restyles in place without re-rendering, so it pulses but doesn't count.\n      const styleSwap = isStyleSwap(data);\n      if (!styleSwap && this.#countEl !== null) {\n        this.#countEl.textContent = String(++this.#count);\n      }\n      this.#container.classList.toggle('style-swap', styleSwap);\n      this.#container.classList.remove('active');\n      void this.#container.offsetWidth;\n      this.#container.classList.add('active');\n    });\n    // Let the DevTools panel hide/show the indicator and its count live (and\n    // across reloads).\n    subscribeOverride(hot, (o) => {\n      if (o.hmrIndicatorVisible !== undefined) {\n        this.style.display = o.hmrIndicatorVisible ? '' : 'none';\n      }\n      if (o.hmrIndicatorCount !== undefined) {\n        this.#setCount(o.hmrIndicatorCount);\n      }\n    });\n    // Stay clear of the Vite DevTools edge panel.\n    observeEdgeInsets((insets) => {\n      this.style.setProperty('--edge-top', `${insets.top}px`);\n      this.style.setProperty('--edge-right', `${insets.right}px`);\n      this.style.setProperty('--edge-bottom', `${insets.bottom}px`);\n      this.style.setProperty('--edge-left', `${insets.left}px`);\n    });\n  }\n}\n\ncustomElements.define('lit-devtools-hmr-indicator', LitDevtoolsIndicator);\n"]}

package/lib/runtime/inspector/install.js

@@ -13,6 +13,7 @@
  */
 import {createPageScriptChannel} from 'devframe/in-page-channel';
 import {elementById} from '../timeline/identity.js';
+import {pageChannel} from '../page-channel.js';
 import {buildTree, collectDetails} from './collect.js';
 import {clearHighlight, highlightById} from './highlight.js';
 import {LIT_IN_PAGE_CHANNEL} from '../../../types/in-page.js';
@@ -21,6 +22,7 @@ import {
   INSPECT_DATA_CHANNEL,
 } from '../../../types/inspector.js';
 const hot = import.meta.hot;
+if (hot !== undefined) pageChannel.useViteHot(hot);
 // The direct panel channel, outside the `hot` gate on purpose: it is the one
 // part of the inspector that does not need a dev server, which is what lets
 // the hover outline keep working in a static snapshot of the panel. Answering
@@ -40,7 +42,7 @@ if (typeof window !== 'undefined') {
 if (hot !== undefined && typeof window !== 'undefined') {
   const send = (msg) => {
     try {
-      hot.send(INSPECT_DATA_CHANNEL, msg);
+      pageChannel.send(INSPECT_DATA_CHANNEL, msg);
     } catch {
       // HMR channel temporarily unavailable; the panel can re-request.
     }
@@ -94,23 +96,33 @@ if (hot !== undefined && typeof window !== 'undefined') {
   // fresh tree when the component hierarchy actually changes. Off by default.
   // childList-only (no attributes), so cosmetic changes — including our own
   // highlight box toggling — don't churn; identical rebuilds are also deduped.
+  // Batches that only move text or comment nodes (most Lit re-renders) are
+  // dropped before the debounce, and only added subtrees are walked for new
+  // shadow roots, so a busy page no longer costs a full-page walk per batch.
   // -------------------------------------------------------------------------
   let observer = null;
   let observeTimer;
   let lastTreeJson = '';
+  // Added elements whose subtrees still need their shadow roots observed.
+  let pendingRoots = [];
+  /** Observe every shadow root at or under `root` (and `root`'s subtree). */
+  const observeShadowRoots = (obs, root) => {
+    if (root instanceof Element && root.shadowRoot !== null) {
+      obs.observe(root.shadowRoot, {childList: true, subtree: true});
+      observeShadowRoots(obs, root.shadowRoot);
+    }
+    for (const el of root.querySelectorAll('*')) {
+      if (el.shadowRoot !== null) {
+        obs.observe(el.shadowRoot, {childList: true, subtree: true});
+        observeShadowRoots(obs, el.shadowRoot);
+      }
+    }
+  };
   /** Re-attach the observer to the body and every shadow root in the page. */
   const syncObserverTargets = (obs) => {
     obs.disconnect();
     obs.observe(document.body, {childList: true, subtree: true});
-    const walk = (root) => {
-      for (const el of root.querySelectorAll('*')) {
-        if (el.shadowRoot !== null) {
-          obs.observe(el.shadowRoot, {childList: true, subtree: true});
-          walk(el.shadowRoot);
-        }
-      }
-    };
-    walk(document);
+    observeShadowRoots(obs, document);
   };
   const pushTreeIfChanged = () => {
     const roots = buildTree();
@@ -119,11 +131,50 @@ if (hot !== undefined && typeof window !== 'undefined') {
     lastTreeJson = json;
     send({type: 'tree', roots});
   };
-  const onMutation = () => {
+  /** Whether a subtree holds anything the tree (or observer) cares about. */
+  const mayHoldComponents = (node) => {
+    if (!(node instanceof Element)) return false;
+    const matters = (el) =>
+      el.localName.includes('-') || el.shadowRoot !== null;
+    if (matters(node)) return true;
+    for (const el of node.querySelectorAll('*')) if (matters(el)) return true;
+    return false;
+  };
+  const onMutation = (records) => {
+    // The tree only has custom elements in it, so a batch that adds or
+    // removes none (text, comments, plain markup) can't change it.
+    let relevant = false;
+    for (const record of records) {
+      for (const node of record.addedNodes) {
+        if (mayHoldComponents(node)) {
+          pendingRoots.push(node);
+          relevant = true;
+        }
+      }
+      if (!relevant) {
+        for (const node of record.removedNodes) {
+          if (mayHoldComponents(node)) {
+            relevant = true;
+            break;
+          }
+        }
+      }
+    }
+    if (!relevant) return;
     if (observeTimer !== undefined) clearTimeout(observeTimer);
     observeTimer = setTimeout(() => {
       observeTimer = undefined;
-      if (observer !== null) syncObserverTargets(observer);
+      // Walk added subtrees now rather than on arrival: a custom element
+      // attaches its shadow root when it upgrades, which can be after insert.
+      // Removed roots need no bookkeeping; a detached shadow root just stops
+      // producing records.
+      const roots = pendingRoots;
+      pendingRoots = [];
+      if (observer !== null) {
+        for (const root of roots) {
+          if (root.isConnected) observeShadowRoots(observer, root);
+        }
+      }
       pushTreeIfChanged();
     }, 100);
   };
@@ -136,6 +187,7 @@ if (hot !== undefined && typeof window !== 'undefined') {
     } else if (observer !== null) {
       observer.disconnect();
       observer = null;
+      pendingRoots = [];
       if (observeTimer !== undefined) {
         clearTimeout(observeTimer);
         observeTimer = undefined;
@@ -166,7 +218,7 @@ if (hot !== undefined && typeof window !== 'undefined') {
   // -------------------------------------------------------------------------
   // Command dispatch
   // -------------------------------------------------------------------------
-  hot.on(INSPECT_CMD_CHANNEL, (data) => {
+  pageChannel.on(INSPECT_CMD_CHANNEL, (data) => {
     const cmd = data;
     switch (cmd.type) {
       case 'tree': {

package/lib/runtime/inspector/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/lib/runtime/inspector/install.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Components inspector runtime.\n *\n * Injected into the host page (alongside the timeline runtime) when the\n * DevTools panel is enabled. Answers the panel's tree/details requests over the\n * Vite HMR channel, keeps a watched element's details fresh as it updates, and\n * outlines elements the panel hovers in its tree.\n */\n\nimport {createPageScriptChannel} from 'devframe/in-page-channel';\nimport {elementById} from '../timeline/identity.js';\nimport {buildTree, collectDetails} from './collect.js';\nimport {clearHighlight, highlightById} from './highlight.js';\nimport {\n  LIT_IN_PAGE_CHANNEL,\n  type LitInPageProtocol,\n} from '../../../types/in-page.js';\nimport {\n  INSPECT_CMD_CHANNEL,\n  INSPECT_DATA_CHANNEL,\n  type InspectorCommand,\n  type InspectorMessage,\n} from '../../../types/inspector.js';\n\ntype ViteHot = {\n  send: (event: string, data: unknown) => void;\n  on: (event: string, handler: (data: unknown) => void) => void;\n};\n\nconst hot = (import.meta as {hot?: ViteHot}).hot;\n\n// The direct panel channel, outside the `hot` gate on purpose: it is the one\n// part of the inspector that does not need a dev server, which is what lets\n// the hover outline keep working in a static snapshot of the panel. Answering\n// handshakes costs nothing until a panel actually sends one.\nif (typeof window !== 'undefined') {\n  const channel = createPageScriptChannel<LitInPageProtocol>({\n    name: LIT_IN_PAGE_CHANNEL,\n    functions: {},\n    events: {\n      highlight: {handler: (id) => highlightById(id)},\n    },\n  });\n  // A panel that goes away mid-hover never gets to send its `highlight(null)`,\n  // and an outline left painted over the app is worse than a missing one.\n  channel.events.on('panel:disconnected', () => clearHighlight());\n}\n\nif (hot !== undefined && typeof window !== 'undefined') {\n  const send = (msg: InspectorMessage): void => {\n    try {\n      hot.send(INSPECT_DATA_CHANNEL, msg);\n    } catch {\n      // HMR channel temporarily unavailable; the panel can re-request.\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Live-watch: re-push details whenever the watched element finishes updating.\n  // We wrap the instance's `updated` (not the prototype) so the hook is scoped\n  // to one element and trivially removable, and it works without the timeline's\n  // recording gate.\n  // -------------------------------------------------------------------------\n\n  type Updatable = Element & {\n    updated?: (changed: unknown) => void;\n  };\n  // Hold the watched element via a WeakRef so an active watch doesn't keep a\n  // removed element alive: the override and `restore` only reach `el` through\n  // the ref, leaving the DOM as its sole strong root.\n  let watched: {ref: WeakRef<Updatable>; restore: () => void} | null = null;\n\n  const unwatch = (): void => {\n    watched?.restore();\n    watched = null;\n  };\n\n  const watch = (id: number): void => {\n    unwatch();\n    const el = elementById(id) as Updatable | undefined;\n    if (el === undefined) {\n      send({type: 'gone', id});\n      return;\n    }\n    const hadOwn = Object.prototype.hasOwnProperty.call(el, 'updated');\n    // Only an *own* `updated` is stable across an HMR hot patch. A prototype\n    // implementation is replaced in place on every patch (`syncOwnMembers` in\n    // ../patch.ts), so caching it here would pin the watched instance to the\n    // pre-edit code for the life of the watch — resolve it through the\n    // prototype chain on each call instead. Our wrapper is an own property, so\n    // the lookup skips it and cannot recurse.\n    const ownPrev = hadOwn ? el.updated : undefined;\n    const ref = new WeakRef(el);\n    el.updated = function (this: Updatable, changed: unknown) {\n      const current =\n        ownPrev ?? (Object.getPrototypeOf(this) as Updatable | null)?.updated;\n      current?.call(this, changed);\n      const cur = ref.deref();\n      if (cur !== undefined) {\n        send({type: 'details', details: collectDetails(cur)});\n      }\n    };\n    watched = {\n      ref,\n      restore: () => {\n        const cur = ref.deref();\n        if (cur === undefined) return;\n        if (hadOwn) cur.updated = ownPrev;\n        else delete cur.updated;\n      },\n    };\n    // Push an immediate snapshot so the panel doesn't wait for the next update.\n    send({type: 'details', details: collectDetails(el)});\n  };\n\n  // -------------------------------------------------------------------------\n  // Opt-in live tree: watch the DOM (light + every shadow root) and push a\n  // fresh tree when the component hierarchy actually changes. Off by default.\n  // childList-only (no attributes), so cosmetic changes — including our own\n  // highlight box toggling — don't churn; identical rebuilds are also deduped.\n  // -------------------------------------------------------------------------\n\n  let observer: MutationObserver | null = null;\n  let observeTimer: ReturnType<typeof setTimeout> | undefined;\n  let lastTreeJson = '';\n\n  /** Re-attach the observer to the body and every shadow root in the page. */\n  const syncObserverTargets = (obs: MutationObserver): void => {\n    obs.disconnect();\n    obs.observe(document.body, {childList: true, subtree: true});\n    const walk = (root: ParentNode): void => {\n      for (const el of root.querySelectorAll('*')) {\n        if (el.shadowRoot !== null) {\n          obs.observe(el.shadowRoot, {childList: true, subtree: true});\n          walk(el.shadowRoot);\n        }\n      }\n    };\n    walk(document);\n  };\n\n  const pushTreeIfChanged = (): void => {\n    const roots = buildTree();\n    const json = JSON.stringify(roots);\n    if (json === lastTreeJson) return;\n    lastTreeJson = json;\n    send({type: 'tree', roots});\n  };\n\n  const onMutation = (): void => {\n    if (observeTimer !== undefined) clearTimeout(observeTimer);\n    observeTimer = setTimeout(() => {\n      observeTimer = undefined;\n      if (observer !== null) syncObserverTargets(observer);\n      pushTreeIfChanged();\n    }, 100);\n  };\n\n  const setObserving = (enabled: boolean): void => {\n    if (enabled) {\n      if (observer === null) observer = new MutationObserver(onMutation);\n      lastTreeJson = '';\n      syncObserverTargets(observer);\n      pushTreeIfChanged();\n    } else if (observer !== null) {\n      observer.disconnect();\n      observer = null;\n      if (observeTimer !== undefined) {\n        clearTimeout(observeTimer);\n        observeTimer = undefined;\n      }\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // SPA navigation: a route change swaps the component tree without any HMR\n  // or panel event, so the snapshot went stale until a manual refresh. Push a\n  // deduped tree after each navigation — twice, since routes typically\n  // lazy-load and render async. Redundant while the live observer watches.\n  // -------------------------------------------------------------------------\n\n  const onNavigation = (): void => {\n    if (observer !== null) return;\n    for (const delay of [150, 1000]) {\n      setTimeout(pushTreeIfChanged, delay);\n    }\n  };\n  window.addEventListener('popstate', onNavigation);\n  window.addEventListener('hashchange', onNavigation);\n  for (const method of ['pushState', 'replaceState'] as const) {\n    const original = history[method].bind(history);\n    history[method] = (...args: Parameters<History['pushState']>) => {\n      original(...args);\n      onNavigation();\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Command dispatch\n  // -------------------------------------------------------------------------\n\n  hot.on(INSPECT_CMD_CHANNEL, (data) => {\n    const cmd = data as InspectorCommand;\n    switch (cmd.type) {\n      case 'tree': {\n        const roots = buildTree();\n        lastTreeJson = JSON.stringify(roots);\n        send({type: 'tree', roots});\n        break;\n      }\n      case 'details': {\n        const el = elementById(cmd.id);\n        if (el !== undefined) {\n          send({type: 'details', details: collectDetails(el)});\n        } else {\n          send({type: 'gone', id: cmd.id});\n        }\n        break;\n      }\n      case 'watch':\n        if (cmd.id === null) unwatch();\n        else watch(cmd.id);\n        break;\n      case 'highlight':\n        // Fallback path. A panel that handshaked over the in-page channel\n        // emits there instead and never reaches this.\n        highlightById(cmd.id);\n        break;\n      case 'observe':\n        setObserving(cmd.enabled);\n        break;\n    }\n  });\n\n  // Announce readiness so a panel that loaded first re-requests the tree.\n  send({type: 'ready'});\n}\n"]}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/lib/runtime/inspector/install.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Components inspector runtime.\n *\n * Injected into the host page (alongside the timeline runtime) when the\n * DevTools panel is enabled. Answers the panel's tree/details requests over the\n * Vite HMR channel, keeps a watched element's details fresh as it updates, and\n * outlines elements the panel hovers in its tree.\n */\n\nimport {createPageScriptChannel} from 'devframe/in-page-channel';\nimport {elementById} from '../timeline/identity.js';\nimport {pageChannel} from '../page-channel.js';\nimport type {ViteHotLike} from '../page-channel.js';\nimport {buildTree, collectDetails} from './collect.js';\nimport {clearHighlight, highlightById} from './highlight.js';\nimport {\n  LIT_IN_PAGE_CHANNEL,\n  type LitInPageProtocol,\n} from '../../../types/in-page.js';\nimport {\n  INSPECT_CMD_CHANNEL,\n  INSPECT_DATA_CHANNEL,\n  type InspectorCommand,\n  type InspectorMessage,\n} from '../../../types/inspector.js';\n\nconst hot = (import.meta as {hot?: ViteHotLike}).hot;\nif (hot !== undefined) pageChannel.useViteHot(hot);\n\n// The direct panel channel, outside the `hot` gate on purpose: it is the one\n// part of the inspector that does not need a dev server, which is what lets\n// the hover outline keep working in a static snapshot of the panel. Answering\n// handshakes costs nothing until a panel actually sends one.\nif (typeof window !== 'undefined') {\n  const channel = createPageScriptChannel<LitInPageProtocol>({\n    name: LIT_IN_PAGE_CHANNEL,\n    functions: {},\n    events: {\n      highlight: {handler: (id) => highlightById(id)},\n    },\n  });\n  // A panel that goes away mid-hover never gets to send its `highlight(null)`,\n  // and an outline left painted over the app is worse than a missing one.\n  channel.events.on('panel:disconnected', () => clearHighlight());\n}\n\nif (hot !== undefined && typeof window !== 'undefined') {\n  const send = (msg: InspectorMessage): void => {\n    try {\n      pageChannel.send(INSPECT_DATA_CHANNEL, msg);\n    } catch {\n      // HMR channel temporarily unavailable; the panel can re-request.\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Live-watch: re-push details whenever the watched element finishes updating.\n  // We wrap the instance's `updated` (not the prototype) so the hook is scoped\n  // to one element and trivially removable, and it works without the timeline's\n  // recording gate.\n  // -------------------------------------------------------------------------\n\n  type Updatable = Element & {\n    updated?: (changed: unknown) => void;\n  };\n  // Hold the watched element via a WeakRef so an active watch doesn't keep a\n  // removed element alive: the override and `restore` only reach `el` through\n  // the ref, leaving the DOM as its sole strong root.\n  let watched: {ref: WeakRef<Updatable>; restore: () => void} | null = null;\n\n  const unwatch = (): void => {\n    watched?.restore();\n    watched = null;\n  };\n\n  const watch = (id: number): void => {\n    unwatch();\n    const el = elementById(id) as Updatable | undefined;\n    if (el === undefined) {\n      send({type: 'gone', id});\n      return;\n    }\n    const hadOwn = Object.prototype.hasOwnProperty.call(el, 'updated');\n    // Only an *own* `updated` is stable across an HMR hot patch. A prototype\n    // implementation is replaced in place on every patch (`syncOwnMembers` in\n    // ../patch.ts), so caching it here would pin the watched instance to the\n    // pre-edit code for the life of the watch — resolve it through the\n    // prototype chain on each call instead. Our wrapper is an own property, so\n    // the lookup skips it and cannot recurse.\n    const ownPrev = hadOwn ? el.updated : undefined;\n    const ref = new WeakRef(el);\n    el.updated = function (this: Updatable, changed: unknown) {\n      const current =\n        ownPrev ?? (Object.getPrototypeOf(this) as Updatable | null)?.updated;\n      current?.call(this, changed);\n      const cur = ref.deref();\n      if (cur !== undefined) {\n        send({type: 'details', details: collectDetails(cur)});\n      }\n    };\n    watched = {\n      ref,\n      restore: () => {\n        const cur = ref.deref();\n        if (cur === undefined) return;\n        if (hadOwn) cur.updated = ownPrev;\n        else delete cur.updated;\n      },\n    };\n    // Push an immediate snapshot so the panel doesn't wait for the next update.\n    send({type: 'details', details: collectDetails(el)});\n  };\n\n  // -------------------------------------------------------------------------\n  // Opt-in live tree: watch the DOM (light + every shadow root) and push a\n  // fresh tree when the component hierarchy actually changes. Off by default.\n  // childList-only (no attributes), so cosmetic changes — including our own\n  // highlight box toggling — don't churn; identical rebuilds are also deduped.\n  // Batches that only move text or comment nodes (most Lit re-renders) are\n  // dropped before the debounce, and only added subtrees are walked for new\n  // shadow roots, so a busy page no longer costs a full-page walk per batch.\n  // -------------------------------------------------------------------------\n\n  let observer: MutationObserver | null = null;\n  let observeTimer: ReturnType<typeof setTimeout> | undefined;\n  let lastTreeJson = '';\n  // Added elements whose subtrees still need their shadow roots observed.\n  let pendingRoots: Element[] = [];\n\n  /** Observe every shadow root at or under `root` (and `root`'s subtree). */\n  const observeShadowRoots = (\n    obs: MutationObserver,\n    root: ParentNode\n  ): void => {\n    if (root instanceof Element && root.shadowRoot !== null) {\n      obs.observe(root.shadowRoot, {childList: true, subtree: true});\n      observeShadowRoots(obs, root.shadowRoot);\n    }\n    for (const el of root.querySelectorAll('*')) {\n      if (el.shadowRoot !== null) {\n        obs.observe(el.shadowRoot, {childList: true, subtree: true});\n        observeShadowRoots(obs, el.shadowRoot);\n      }\n    }\n  };\n\n  /** Re-attach the observer to the body and every shadow root in the page. */\n  const syncObserverTargets = (obs: MutationObserver): void => {\n    obs.disconnect();\n    obs.observe(document.body, {childList: true, subtree: true});\n    observeShadowRoots(obs, document);\n  };\n\n  const pushTreeIfChanged = (): void => {\n    const roots = buildTree();\n    const json = JSON.stringify(roots);\n    if (json === lastTreeJson) return;\n    lastTreeJson = json;\n    send({type: 'tree', roots});\n  };\n\n  /** Whether a subtree holds anything the tree (or observer) cares about. */\n  const mayHoldComponents = (node: Node): node is Element => {\n    if (!(node instanceof Element)) return false;\n    const matters = (el: Element): boolean =>\n      el.localName.includes('-') || el.shadowRoot !== null;\n    if (matters(node)) return true;\n    for (const el of node.querySelectorAll('*')) if (matters(el)) return true;\n    return false;\n  };\n\n  const onMutation = (records: MutationRecord[]): void => {\n    // The tree only has custom elements in it, so a batch that adds or\n    // removes none (text, comments, plain markup) can't change it.\n    let relevant = false;\n    for (const record of records) {\n      for (const node of record.addedNodes) {\n        if (mayHoldComponents(node)) {\n          pendingRoots.push(node);\n          relevant = true;\n        }\n      }\n      if (!relevant) {\n        for (const node of record.removedNodes) {\n          if (mayHoldComponents(node)) {\n            relevant = true;\n            break;\n          }\n        }\n      }\n    }\n    if (!relevant) return;\n    if (observeTimer !== undefined) clearTimeout(observeTimer);\n    observeTimer = setTimeout(() => {\n      observeTimer = undefined;\n      // Walk added subtrees now rather than on arrival: a custom element\n      // attaches its shadow root when it upgrades, which can be after insert.\n      // Removed roots need no bookkeeping; a detached shadow root just stops\n      // producing records.\n      const roots = pendingRoots;\n      pendingRoots = [];\n      if (observer !== null) {\n        for (const root of roots) {\n          if (root.isConnected) observeShadowRoots(observer, root);\n        }\n      }\n      pushTreeIfChanged();\n    }, 100);\n  };\n\n  const setObserving = (enabled: boolean): void => {\n    if (enabled) {\n      if (observer === null) observer = new MutationObserver(onMutation);\n      lastTreeJson = '';\n      syncObserverTargets(observer);\n      pushTreeIfChanged();\n    } else if (observer !== null) {\n      observer.disconnect();\n      observer = null;\n      pendingRoots = [];\n      if (observeTimer !== undefined) {\n        clearTimeout(observeTimer);\n        observeTimer = undefined;\n      }\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // SPA navigation: a route change swaps the component tree without any HMR\n  // or panel event, so the snapshot went stale until a manual refresh. Push a\n  // deduped tree after each navigation — twice, since routes typically\n  // lazy-load and render async. Redundant while the live observer watches.\n  // -------------------------------------------------------------------------\n\n  const onNavigation = (): void => {\n    if (observer !== null) return;\n    for (const delay of [150, 1000]) {\n      setTimeout(pushTreeIfChanged, delay);\n    }\n  };\n  window.addEventListener('popstate', onNavigation);\n  window.addEventListener('hashchange', onNavigation);\n  for (const method of ['pushState', 'replaceState'] as const) {\n    const original = history[method].bind(history);\n    history[method] = (...args: Parameters<History['pushState']>) => {\n      original(...args);\n      onNavigation();\n    };\n  }\n\n  // -------------------------------------------------------------------------\n  // Command dispatch\n  // -------------------------------------------------------------------------\n\n  pageChannel.on(INSPECT_CMD_CHANNEL, (data) => {\n    const cmd = data as InspectorCommand;\n    switch (cmd.type) {\n      case 'tree': {\n        const roots = buildTree();\n        lastTreeJson = JSON.stringify(roots);\n        send({type: 'tree', roots});\n        break;\n      }\n      case 'details': {\n        const el = elementById(cmd.id);\n        if (el !== undefined) {\n          send({type: 'details', details: collectDetails(el)});\n        } else {\n          send({type: 'gone', id: cmd.id});\n        }\n        break;\n      }\n      case 'watch':\n        if (cmd.id === null) unwatch();\n        else watch(cmd.id);\n        break;\n      case 'highlight':\n        // Fallback path. A panel that handshaked over the in-page channel\n        // emits there instead and never reaches this.\n        highlightById(cmd.id);\n        break;\n      case 'observe':\n        setObserving(cmd.enabled);\n        break;\n    }\n  });\n\n  // Announce readiness so a panel that loaded first re-requests the tree.\n  send({type: 'ready'});\n}\n"]}

package/lib/runtime/inspector/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime/inspector/serialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,gEAAgE;AAChE,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG,MAWxC,CAAC;AA2FF,oEAAoE;AACpE,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,MAM1C,CAAC"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime/inspector/serialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,gEAAgE;AAChE,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG,MAaxC,CAAC;AAiGF,oEAAoE;AACpE,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,MAM1C,CAAC"}