@oddsquad/vite-plugin-lit 0.2.3 → 0.4.0

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

@@ -0,0 +1,91 @@
+/**
+ * @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 {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)
+    );
+    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, (_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 {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    const fileRef = `${resolved}:${line}:${column}`;\n    import('launch-editor')\n      .then(\n        (mod: {\n          default?: (\n            file: string,\n            cb: (fileName: string, errorMessage: string | null) => void\n          ) => void;\n        }) => {\n          const launch = (mod.default ?? mod) as (\n            file: string,\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(fileRef, (_fileName: string, errorMessage: string | null) => {\n            if (errorMessage !== null) {\n              finish(500, errorMessage);\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

@@ -16,7 +16,7 @@
  * @example
  * ```ts
  * import cssUrl from './my-element.css?url';
- * import {devCacheBust} from '@lit-labs/vite-plugin-lit/css.js';
+ * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';
  *
  * const href = devCacheBust(cssUrl); // module scope
  * html`<link rel="stylesheet" href="${href}" />`;
@@ -67,7 +67,7 @@ export interface UrlSheet {
  *
  * @example
  * ```ts
- * import {urlSheet} from '@lit-labs/vite-plugin-lit/css.js';
+ * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';
  * import sheetUrl from './utils.css?url';
  *
  * const {sheet, onHotUpdate} = urlSheet(sheetUrl);

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

@@ -1 +1 @@
-{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../../packages/labs/vite-plugin-lit/src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,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,GAAI,KAAK,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

@@ -39,14 +39,14 @@ const isDev = () => import.meta.env?.DEV === true;
  * @example
  * ```ts
  * import cssUrl from './my-element.css?url';
- * import {devCacheBust} from '@lit-labs/vite-plugin-lit/css.js';
+ * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';
  *
  * const href = devCacheBust(cssUrl); // module scope
  * html`<link rel="stylesheet" href="${href}" />`;
  * ```
  */
 export const devCacheBust = (url) => {
-    return isDev() ? `${url}?t=${Date.now()}` : url;
+  return isDev() ? `${url}?t=${Date.now()}` : url;
 };
 /**
  * In dev, turns a `?url`-imported CSS path into one that fetches the
@@ -61,10 +61,10 @@ export const devCacheBust = (url) => {
  * it carries `?t=…`).
  */
 const devDirect = (url) => {
-    if (!isDev()) {
-        return url;
-    }
-    return `${url}${url.includes('?') ? '&' : '?'}direct`;
+  if (!isDev()) {
+    return url;
+  }
+  return `${url}${url.includes('?') ? '&' : '?'}direct`;
 };
 /**
  * Builds a {@link UrlSheet} from a `?url`-imported CSS asset: a single
@@ -79,7 +79,7 @@ const devDirect = (url) => {
  *
  * @example
  * ```ts
- * import {urlSheet} from '@lit-labs/vite-plugin-lit/css.js';
+ * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';
  * import sheetUrl from './utils.css?url';
  *
  * const {sheet, onHotUpdate} = urlSheet(sheetUrl);
@@ -89,31 +89,38 @@ const devDirect = (url) => {
  * ```
  */
 export const urlSheet = (url) => {
-    const sheet = new CSSStyleSheet();
-    // Guards against out-of-order fetch resolution: two rapid edits fire
-    // overlapping fetches, and a slower earlier one must not land after (and
-    // clobber) a newer one. Only the most recently issued request applies.
-    let latest = 0;
-    const update = (next) => {
-        const token = ++latest;
-        return fetch(devDirect(next))
-            .then((r) => r.text())
-            .then((css) => {
-            if (token === latest) {
-                sheet.replaceSync(css);
-            }
-        })
-            .catch(() => { });
-    };
-    update(url);
-    return {
-        sheet,
-        onHotUpdate: (mod) => {
-            const next = mod?.['default'];
-            if (typeof next === 'string') {
-                update(next);
-            }
-        },
-    };
+  const sheet = new CSSStyleSheet();
+  // Guards against out-of-order fetch resolution: two rapid edits fire
+  // overlapping fetches, and a slower earlier one must not land after (and
+  // clobber) a newer one. Only the most recently issued request applies.
+  let latest = 0;
+  const update = (next) => {
+    const token = ++latest;
+    return fetch(devDirect(next))
+      .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((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 {
+    sheet,
+    onHotUpdate: (mod) => {
+      const next = mod?.['default'];
+      if (typeof next === 'string') {
+        void update(next);
+      }
+    },
+  };
 };
-//# sourceMappingURL=css.js.map
+//# sourceMappingURL=css.js.map

package/lib/runtime/css.js.map

@@ -1 +1 @@
-{"version":3,"file":"css.js","sourceRoot":"","sources":["../../../../packages/labs/vite-plugin-lit/src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,GAAY,EAAE,CACzB,MAAM,CAAC,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,MAAM,CAAC,GAAG,CAAC,CAAC;IACZ,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,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,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 '@lit-labs/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 '@lit-labs/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  update(url);\n  return {\n    sheet,\n    onHotUpdate: (mod) => {\n      const next = mod?.['default'];\n      if (typeof next === 'string') {\n        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/edge-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-panel.d.ts","sourceRoot":"","sources":["../../../../packages/labs/vite-plugin-lit/src/lib/runtime/edge-panel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KACrC,CAAC,MAAM,IAAI,CA+Db,CAAC"}
+{"version":3,"file":"edge-panel.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/edge-panel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAClB,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KACrC,CAAC,MAAM,IAAI,CA+Db,CAAC"}

package/lib/runtime/edge-panel.js

@@ -19,11 +19,11 @@ const PANEL_ID = 'vite-devtools-edge-panel';
 const GAP = 12;
 /** Tolerance (px) for treating the panel as touching a viewport edge. */
 const EDGE = 2;
-const ZERO = { top: 0, right: 0, bottom: 0, left: 0 };
+const ZERO = {top: 0, right: 0, bottom: 0, left: 0};
 const findPanel = () => {
-    const host = document.querySelector(HOST_TAG);
-    const root = host?.shadowRoot;
-    return root?.getElementById(PANEL_ID) ?? null;
+  const host = document.querySelector(HOST_TAG);
+  const root = host?.shadowRoot;
+  return root?.getElementById(PANEL_ID) ?? null;
 };
 /**
  * Inset (px + gap) the docked panel occupies, on the single edge it's docked
@@ -33,34 +33,27 @@ const findPanel = () => {
  * wrongly flag a full-width bottom panel as also docked left and right.)
  */
 const computeInsets = () => {
-    const panel = findPanel();
-    if (panel === null)
-        return ZERO;
-    const r = panel.getBoundingClientRect();
-    if (r.width === 0 || r.height === 0)
-        return ZERO;
-    // Use the layout viewport (excludes scrollbars) — a fixed `right:0`/`bottom:0`
-    // panel aligns to clientWidth/Height, not innerWidth/Height, so comparing
-    // against the latter would miss a full-width panel whenever a scrollbar is
-    // present.
-    const vw = document.documentElement.clientWidth;
-    const vh = document.documentElement.clientHeight;
-    const spansWidth = r.left <= EDGE && r.right >= vw - EDGE;
-    const spansHeight = r.top <= EDGE && r.bottom >= vh - EDGE;
-    const insets = { ...ZERO };
-    if (spansWidth && !spansHeight) {
-        if (r.top <= EDGE)
-            insets.top = r.bottom + GAP;
-        else if (r.bottom >= vh - EDGE)
-            insets.bottom = vh - r.top + GAP;
-    }
-    else if (spansHeight && !spansWidth) {
-        if (r.left <= EDGE)
-            insets.left = r.right + GAP;
-        else if (r.right >= vw - EDGE)
-            insets.right = vw - r.left + GAP;
-    }
-    return insets;
+  const panel = findPanel();
+  if (panel === null) return ZERO;
+  const r = panel.getBoundingClientRect();
+  if (r.width === 0 || r.height === 0) return ZERO;
+  // Use the layout viewport (excludes scrollbars) — a fixed `right:0`/`bottom:0`
+  // panel aligns to clientWidth/Height, not innerWidth/Height, so comparing
+  // against the latter would miss a full-width panel whenever a scrollbar is
+  // present.
+  const vw = document.documentElement.clientWidth;
+  const vh = document.documentElement.clientHeight;
+  const spansWidth = r.left <= EDGE && r.right >= vw - EDGE;
+  const spansHeight = r.top <= EDGE && r.bottom >= vh - EDGE;
+  const insets = {...ZERO};
+  if (spansWidth && !spansHeight) {
+    if (r.top <= EDGE) insets.top = r.bottom + GAP;
+    else if (r.bottom >= vh - EDGE) insets.bottom = vh - r.top + GAP;
+  } else if (spansHeight && !spansWidth) {
+    if (r.left <= EDGE) insets.left = r.right + GAP;
+    else if (r.right >= vw - EDGE) insets.right = vw - r.left + GAP;
+  }
+  return insets;
 };
 /**
  * Calls `onChange` with the current insets and again whenever they change — the
@@ -68,63 +61,61 @@ const computeInsets = () => {
  * mounting after us. Returns a disposer.
  */
 export const observeEdgeInsets = (onChange) => {
-    let raf = 0;
-    let last = '';
-    let observedPanel = null;
-    let observingRoot = false;
-    const emit = () => {
-        raf = 0;
-        const insets = computeInsets();
-        const key = `${insets.top}|${insets.right}|${insets.bottom}|${insets.left}`;
-        if (key !== last) {
-            last = key;
-            onChange(insets);
-        }
-    };
-    const schedule = () => {
-        if (raf === 0)
-            raf = requestAnimationFrame(emit);
-    };
-    const ro = new ResizeObserver(schedule);
-    // Re-attach on any devtools DOM change (panel mounting, docking to a new edge)
-    // then recompute; cheap thanks to the rAF + diff above.
-    const mo = new MutationObserver(() => attach());
-    const attach = () => {
-        const host = document.querySelector(HOST_TAG);
-        const root = host?.shadowRoot;
-        if (root && !observingRoot) {
-            observingRoot = true;
-            mo.observe(root, {
-                childList: true,
-                subtree: true,
-                attributes: true,
-                attributeFilter: ['style', 'class'],
-            });
-        }
-        const panel = findPanel();
-        if (panel !== null && panel !== observedPanel) {
-            observedPanel = panel;
-            ro.observe(panel);
-        }
-        schedule();
-    };
-    // The devtools host mounts asynchronously; poll until it's present, then let
-    // the observers drive updates.
-    let tries = 0;
-    const poll = () => {
-        attach();
-        if (!observingRoot && tries++ < 60) {
-            setTimeout(poll, 250);
-        }
-    };
-    poll();
-    window.addEventListener('resize', schedule);
-    return () => {
-        window.removeEventListener('resize', schedule);
-        ro.disconnect();
-        mo.disconnect();
-        if (raf !== 0)
-            cancelAnimationFrame(raf);
-    };
+  let raf = 0;
+  let last = '';
+  let observedPanel = null;
+  let observingRoot = false;
+  const emit = () => {
+    raf = 0;
+    const insets = computeInsets();
+    const key = `${insets.top}|${insets.right}|${insets.bottom}|${insets.left}`;
+    if (key !== last) {
+      last = key;
+      onChange(insets);
+    }
+  };
+  const schedule = () => {
+    if (raf === 0) raf = requestAnimationFrame(emit);
+  };
+  const ro = new ResizeObserver(schedule);
+  // Re-attach on any devtools DOM change (panel mounting, docking to a new edge)
+  // then recompute; cheap thanks to the rAF + diff above.
+  const mo = new MutationObserver(() => attach());
+  const attach = () => {
+    const host = document.querySelector(HOST_TAG);
+    const root = host?.shadowRoot;
+    if (root && !observingRoot) {
+      observingRoot = true;
+      mo.observe(root, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ['style', 'class'],
+      });
+    }
+    const panel = findPanel();
+    if (panel !== null && panel !== observedPanel) {
+      observedPanel = panel;
+      ro.observe(panel);
+    }
+    schedule();
+  };
+  // The devtools host mounts asynchronously; poll until it's present, then let
+  // the observers drive updates.
+  let tries = 0;
+  const poll = () => {
+    attach();
+    if (!observingRoot && tries++ < 60) {
+      setTimeout(poll, 250);
+    }
+  };
+  poll();
+  window.addEventListener('resize', schedule);
+  return () => {
+    window.removeEventListener('resize', schedule);
+    ro.disconnect();
+    mo.disconnect();
+    if (raf !== 0) cancelAnimationFrame(raf);
+  };
 };
-//# sourceMappingURL=edge-panel.js.map
+//# sourceMappingURL=edge-panel.js.map