@oddsquad/vite-plugin-lit 0.2.3 → 0.3.0

package/lib/plugin.js

@@ -3,35 +3,32 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: BSD-3-Clause
  */
-import { existsSync } from 'node:fs';
-import { resolve as resolvePath, sep } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadEnv } from 'vite';
+import {existsSync} from 'node:fs';
+import {resolve as resolvePath, sep} from 'node:path';
+import {fileURLToPath} from 'node:url';
+import {loadEnv} from 'vite';
 import MagicString from 'magic-string';
-import { injectSourceMeta } from './source-meta.js';
-import { INSTALL_ID, VIRTUAL_PREFIX, transformLitModule } from './transform.js';
-import { WRAP_TABLE } from './wrap-table.js';
-import { litTimelinePlugin } from './timeline-plugin.js';
-const CSS_SHEET_BUILD_MODES = [
-    'auto',
-    'url',
-    'inline',
-    'inline-raw',
-];
+import {isTrustedRequest} from './http.js';
+import {injectSourceMeta} from './source-meta.js';
+import {INSTALL_ID, VIRTUAL_PREFIX, transformLitModule} from './transform.js';
+import {WRAP_TABLE} from './wrap-table.js';
+import {createLitDevframePlugin} from './devframe/vite.js';
+import {PACKAGE_VERSION} from './devframe/paths.js';
+const CSS_SHEET_BUILD_MODES = ['auto', 'url', 'inline', 'inline-raw'];
 /** Env var prefix consumed at config time. */
 const ENV_PREFIX = 'LIT_PLUGIN';
 /** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */
-const envBool = (v) => v === 'true' || v === '1'
+const envBool = (v) =>
+  v === 'true' || v === '1'
     ? true
     : v === 'false' || v === '0'
-        ? false
-        : undefined;
+      ? false
+      : undefined;
 /** Parse a numeric env string; `undefined` when unset/non-numeric. */
 const envNum = (v) => {
-    if (v === undefined || v === '')
-        return undefined;
-    const n = Number(v);
-    return Number.isNaN(n) ? undefined : n;
+  if (v === undefined || v === '') return undefined;
+  const n = Number(v);
+  return Number.isNaN(n) ? undefined : n;
 };
 /**
  * Parse a string against a closed set of values; `undefined` (with a warning)
@@ -39,60 +36,73 @@ const envNum = (v) => {
  * instead of silently disabling a feature.
  */
 const envEnum = (v, allowed, source) => {
-    if (v === undefined || v === '')
-        return undefined;
-    if (allowed.includes(v))
-        return v;
-    console.warn(`[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +
-        allowed.map((a) => JSON.stringify(a)).join(', '));
-    return undefined;
+  if (v === undefined || v === '') return undefined;
+  if (allowed.includes(v)) return v;
+  console.warn(
+    `[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +
+      allowed.map((a) => JSON.stringify(a)).join(', ')
+  );
+  return undefined;
 };
 /**
  * Merge explicit options over env vars over defaults (in that precedence) into
  * the flat shape the plugin hooks consume.
  */
 export const resolveOptions = (options, env) => {
-    const hmr = options.hmr;
-    const hmrObj = typeof hmr === 'object' ? hmr : undefined;
-    const hmrEnabled = (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??
-        envBool(env[`${ENV_PREFIX}_HMR`]) ??
-        true;
-    const reconnect = hmrObj?.reconnect ?? envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]) ?? false;
-    const onIncompatible = hmrObj?.onIncompatible ??
-        env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`] ??
-        'reload';
-    const ind = hmrObj?.indicator;
-    const indObj = typeof ind === 'object' ? ind : undefined;
-    const indEnabled = (typeof ind === 'boolean' ? ind : indObj?.enabled) ??
-        envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]) ??
-        true;
-    const indCount = indObj?.count ?? envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]) ?? false;
-    // The indicator is meaningless without HMR, so it follows the master toggle.
-    const indicator = hmrEnabled && indEnabled ? { count: indCount } : false;
-    const so = options.sourceOverlay;
-    const soExplicit = typeof so === 'boolean' ? so : so === undefined ? undefined : true;
-    const soEnabled = soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;
-    let sourceOverlay = false;
-    if (soEnabled) {
-        const base = typeof so === 'object' ? { ...so } : {};
-        base.key ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;
-        base.editor ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`] || undefined;
-        base.throttleMs ??= envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);
-        sourceOverlay = base;
-    }
-    const timeline = options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;
-    const cssSheetBuild = envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??
-        envEnum(env[`${ENV_PREFIX}_CSS_SHEET_BUILD`], CSS_SHEET_BUILD_MODES, `${ENV_PREFIX}_CSS_SHEET_BUILD`) ??
-        'auto';
-    return {
-        hmrEnabled,
-        reconnect,
-        onIncompatible,
-        indicator,
-        sourceOverlay,
-        timeline,
-        cssSheetBuild,
-    };
+  const hmr = options.hmr;
+  const hmrObj = typeof hmr === 'object' ? hmr : undefined;
+  const hmrEnabled =
+    (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??
+    envBool(env[`${ENV_PREFIX}_HMR`]) ??
+    true;
+  const reconnect =
+    hmrObj?.reconnect ?? envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]) ?? false;
+  const onIncompatible =
+    hmrObj?.onIncompatible ??
+    env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`] ??
+    'reload';
+  const ind = hmrObj?.indicator;
+  const indObj = typeof ind === 'object' ? ind : undefined;
+  const indEnabled =
+    (typeof ind === 'boolean' ? ind : indObj?.enabled) ??
+    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]) ??
+    true;
+  const indCount =
+    indObj?.count ?? envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]) ?? false;
+  // The indicator is meaningless without HMR, so it follows the master toggle.
+  const indicator = hmrEnabled && indEnabled ? {count: indCount} : false;
+  const so = options.sourceOverlay;
+  const soExplicit =
+    typeof so === 'boolean' ? so : so === undefined ? undefined : true;
+  const soEnabled =
+    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;
+  let sourceOverlay = false;
+  if (soEnabled) {
+    const base = typeof so === 'object' ? {...so} : {};
+    base.key ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;
+    base.editor ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`] || undefined;
+    base.throttleMs ??= envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);
+    sourceOverlay = base;
+  }
+  const timeline =
+    options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;
+  const cssSheetBuild =
+    envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??
+    envEnum(
+      env[`${ENV_PREFIX}_CSS_SHEET_BUILD`],
+      CSS_SHEET_BUILD_MODES,
+      `${ENV_PREFIX}_CSS_SHEET_BUILD`
+    ) ??
+    'auto';
+  return {
+    hmrEnabled,
+    reconnect,
+    onIncompatible,
+    indicator,
+    sourceOverlay,
+    timeline,
+    cssSheetBuild,
+  };
 };
 /**
  * Flattens resolved options into the JSON-serializable shape the panel's
@@ -101,24 +111,25 @@ export const resolveOptions = (options, env) => {
  * are applied here so the panel shows the effective values the runtime uses.
  */
 const toFeatureSettings = (r) => {
-    const so = r.sourceOverlay;
-    const editor = so === false ? undefined : so.editor;
-    return {
-        hmr: {
-            enabled: r.hmrEnabled,
-            reconnect: r.reconnect,
-            onIncompatible: r.onIncompatible,
-            indicatorEnabled: r.indicator !== false,
-            indicatorCount: r.indicator !== false && r.indicator.count,
-        },
-        sourceOverlay: {
-            enabled: so !== false,
-            key: (so === false ? undefined : so.key) ?? 's',
-            editor: typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',
-            throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,
-        },
-        timeline: r.timeline,
-    };
+  const so = r.sourceOverlay;
+  const editor = so === false ? undefined : so.editor;
+  return {
+    hmr: {
+      enabled: r.hmrEnabled,
+      reconnect: r.reconnect,
+      onIncompatible: r.onIncompatible,
+      indicatorEnabled: r.indicator !== false,
+      indicatorCount: r.indicator !== false && r.indicator.count,
+    },
+    sourceOverlay: {
+      enabled: so !== false,
+      key: (so === false ? undefined : so.key) ?? 's',
+      editor:
+        typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',
+      throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,
+    },
+    timeline: r.timeline,
+  };
 };
 /**
  * Resolves a runtime module to an absolute fs path (served via `/@fs/`), so
@@ -126,100 +137,96 @@ const toFeatureSettings = (r) => {
  * the `.ts` source when running un-built (e.g. under vitest).
  */
 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, '/');
-        }
+  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}`);
+  }
+  throw new Error(`[lit-plugin] runtime module not found: ${name}`);
 };
 const JS_FILE_RE = /\.[cm]?[jt]sx?$/;
 const OPEN_IN_EDITOR_PATH = '/__lit-open-in-editor';
-/** Reject requests whose `Origin` is a different host than the dev server, so
- *  a page the developer happens to visit can't drive these local-only
- *  endpoints. Same-origin requests (no `Origin`, or matching `Host`) pass. */
-const isSameOrigin = (headers) => {
-    const { origin, host } = headers;
-    if (origin === undefined || origin === 'null')
-        return true;
-    try {
-        return new URL(origin).host === host;
+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;
     }
-    catch {
-        return false;
+    if (req.method !== undefined && req.method !== 'GET') {
+      res.statusCode = 405;
+      res.end('method not allowed');
+      return;
     }
-};
-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 (!isSameOrigin(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);
-    };
+    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);
+  };
 };
 /**
  * `import href from './x.css?hmr-url'` — `?url` semantics with working HMR.
@@ -265,83 +272,139 @@ const CSS_VIRTUAL_SUFFIX = '.js';
  * default.
  */
 export const litCssQueries = (getCssSheetBuild = () => 'auto') => {
-    let isBuild = false;
-    let isLib = false;
-    return {
-        name: 'lit-css-query',
-        // Vite's core resolver claims `./x.css?hmr-url` for the CSS pipeline
-        // before normal plugins get a look, so resolve ahead of it.
-        enforce: 'pre',
-        configResolved(config) {
-            isBuild = config.command === 'build';
-            isLib = config.build.lib !== false && config.build.lib !== undefined;
-        },
-        async resolveId(id, importer) {
-            const prefix = CSS_URL_QUERY_RE.test(id)
-                ? CSS_URL_VIRTUAL_PREFIX
-                : CSS_SHEET_QUERY_RE.test(id)
-                    ? CSS_SHEET_VIRTUAL_PREFIX
-                    : null;
-            if (prefix === null) {
-                return null;
-            }
-            const file = id.slice(0, id.indexOf('?'));
-            const resolved = await this.resolve(file, importer);
-            if (resolved === null) {
-                return null;
-            }
-            return prefix + resolved.id + CSS_VIRTUAL_SUFFIX;
-        },
-        load(id) {
-            const helperPath = resolveRuntimeModule('css');
-            if (id.startsWith(CSS_URL_VIRTUAL_PREFIX)) {
-                const file = id.slice(CSS_URL_VIRTUAL_PREFIX.length, -CSS_VIRTUAL_SUFFIX.length);
-                return {
-                    code: `import url from ${JSON.stringify(`${file}?url`)};\n` +
-                        `import {devCacheBust} from ${JSON.stringify(helperPath)};\n` +
-                        `export default devCacheBust(url);\n`,
-                    moduleType: 'js',
-                };
-            }
-            if (id.startsWith(CSS_SHEET_VIRTUAL_PREFIX)) {
-                const file = id.slice(CSS_SHEET_VIRTUAL_PREFIX.length, -CSS_VIRTUAL_SUFFIX.length);
-                const mode = getCssSheetBuild();
-                const inlineQuery = !isBuild || mode === 'url' || (mode === 'auto' && !isLib)
-                    ? null
-                    : mode === 'inline-raw'
-                        ? '?raw'
-                        : '?inline';
-                if (inlineQuery !== null) {
-                    // Build only, so no `import.meta.hot` block. The sheet is still
-                    // constructed once per virtual module, so adopters share it exactly
-                    // as they do in the fetch-backed form.
-                    return {
-                        code: `import css from ${JSON.stringify(`${file}${inlineQuery}`)};\n` +
-                            `const sheet = new CSSStyleSheet();\n` +
-                            `sheet.replaceSync(css);\n` +
-                            `export default sheet;\n`,
-                        moduleType: 'js',
-                    };
-                }
-                // The accept specifier must be byte-identical to the import above —
-                // Vite resolves accepted HMR deps by static analysis. Generating both
-                // here is exactly what frees the caller from writing it. The swap is
-                // self-accepted at this boundary, so it never propagates to adopters.
-                const urlSpecifier = JSON.stringify(`${file}?url`);
-                return {
-                    code: `import url from ${urlSpecifier};\n` +
-                        `import {urlSheet} from ${JSON.stringify(helperPath)};\n` +
-                        `const {sheet, onHotUpdate} = urlSheet(url);\n` +
-                        `export default sheet;\n` +
-                        `if (import.meta.hot) {\n` +
-                        `  import.meta.hot.accept(${urlSpecifier}, onHotUpdate);\n` +
-                        `}\n`,
-                    moduleType: 'js',
-                };
-            }
-            return null;
-        },
-    };
+  let isBuild = false;
+  let isLib = false;
+  return {
+    name: 'lit-css-query',
+    // Vite's core resolver claims `./x.css?hmr-url` for the CSS pipeline
+    // before normal plugins get a look, so resolve ahead of it.
+    enforce: 'pre',
+    configResolved(config) {
+      isBuild = config.command === 'build';
+      isLib = config.build.lib !== false && config.build.lib !== undefined;
+    },
+    async resolveId(id, importer) {
+      const prefix = CSS_URL_QUERY_RE.test(id)
+        ? CSS_URL_VIRTUAL_PREFIX
+        : CSS_SHEET_QUERY_RE.test(id)
+          ? CSS_SHEET_VIRTUAL_PREFIX
+          : null;
+      if (prefix === null) {
+        return null;
+      }
+      const file = id.slice(0, id.indexOf('?'));
+      const resolved = await this.resolve(file, importer);
+      if (resolved === null) {
+        return null;
+      }
+      return prefix + resolved.id + CSS_VIRTUAL_SUFFIX;
+    },
+    load(id) {
+      const helperPath = resolveRuntimeModule('css');
+      if (id.startsWith(CSS_URL_VIRTUAL_PREFIX)) {
+        const file = id.slice(
+          CSS_URL_VIRTUAL_PREFIX.length,
+          -CSS_VIRTUAL_SUFFIX.length
+        );
+        return {
+          code:
+            `import url from ${JSON.stringify(`${file}?url`)};\n` +
+            `import {devCacheBust} from ${JSON.stringify(helperPath)};\n` +
+            `export default devCacheBust(url);\n`,
+          moduleType: 'js',
+        };
+      }
+      if (id.startsWith(CSS_SHEET_VIRTUAL_PREFIX)) {
+        const file = id.slice(
+          CSS_SHEET_VIRTUAL_PREFIX.length,
+          -CSS_VIRTUAL_SUFFIX.length
+        );
+        const mode = getCssSheetBuild();
+        const inlineQuery =
+          !isBuild || mode === 'url' || (mode === 'auto' && !isLib)
+            ? null
+            : mode === 'inline-raw'
+              ? '?raw'
+              : '?inline';
+        if (inlineQuery !== null) {
+          // Build only, so no `import.meta.hot` block. The sheet is still
+          // constructed once per virtual module, so adopters share it exactly
+          // as they do in the fetch-backed form.
+          return {
+            code:
+              `import css from ${JSON.stringify(`${file}${inlineQuery}`)};\n` +
+              `const sheet = new CSSStyleSheet();\n` +
+              `sheet.replaceSync(css);\n` +
+              `export default sheet;\n`,
+            moduleType: 'js',
+          };
+        }
+        // The accept specifier must be byte-identical to the import above —
+        // Vite resolves accepted HMR deps by static analysis. Generating both
+        // here is exactly what frees the caller from writing it. The swap is
+        // self-accepted at this boundary, so it never propagates to adopters.
+        const urlSpecifier = JSON.stringify(`${file}?url`);
+        return {
+          code:
+            `import url from ${urlSpecifier};\n` +
+            `import {urlSheet} from ${JSON.stringify(helperPath)};\n` +
+            `const {sheet, onHotUpdate} = urlSheet(url);\n` +
+            `export default sheet;\n` +
+            `if (import.meta.hot) {\n` +
+            `  import.meta.hot.accept(${urlSpecifier}, onHotUpdate);\n` +
+            `}\n`,
+          moduleType: 'js',
+        };
+      }
+      return null;
+    },
+  };
+};
+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',
+      };
+    },
+  };
 };
 /**
  * A `css` tagged template literal with no interpolations and no escape
@@ -358,333 +421,336 @@ const CSS_LITERAL_RE = /(?<![\w$.])css`((?:[^`\\$]|\$(?!\{))*)`/g;
  * treatment (targets, drafts, …) as `.css` files. Applies in dev and build.
  */
 const litCssLiterals = () => {
-    let lightningcss = null;
-    let options;
-    let minify = false;
-    return {
-        name: 'lit-css-literals',
-        async configResolved(config) {
-            if (config.css.transformer !== 'lightningcss') {
-                return;
-            }
-            // The transformer setting guarantees the dependency: Vite itself
-            // can't process .css files without it.
-            lightningcss = await import('lightningcss');
-            // cssModules makes no sense for a literal; everything else carries
-            // over.
-            const { cssModules: _cssModules, ...rest } = config.css.lightningcss ?? {};
-            options = rest;
-            minify = config.command === 'build';
-        },
-        transform(code, id) {
-            if (lightningcss === null) {
-                return null;
-            }
-            if (id.startsWith('\0') || id.includes('/node_modules/')) {
-                return null;
-            }
-            const [file] = id.split('?', 2);
-            if (!JS_FILE_RE.test(file) || !code.includes('css`')) {
-                return null;
-            }
-            const ms = new MagicString(code);
-            let changed = false;
-            for (const m of code.matchAll(CSS_LITERAL_RE)) {
-                const literal = m[1];
-                if (literal.trim() === '') {
-                    continue;
-                }
-                let out;
-                try {
-                    const result = lightningcss.transform({
-                        ...options,
-                        filename: file,
-                        code: Buffer.from(literal),
-                        minify,
-                    });
-                    out = Buffer.from(result.code).toString();
-                }
-                catch (e) {
-                    this.warn(`[lit-plugin] skipping css literal Lightning CSS couldn't parse: ${e.message}`);
-                    continue;
-                }
-                // Re-escape for the template literal the output goes back into.
-                out = out.replace(/[\\`$]/g, '\\$&');
-                if (out !== literal) {
-                    const start = m.index + 'css`'.length;
-                    ms.overwrite(start, start + literal.length, out);
-                    changed = true;
-                }
-            }
-            if (!changed) {
-                return null;
-            }
-            return { code: ms.toString(), map: ms.generateMap({ hires: true }) };
-        },
-    };
+  let lightningcss = null;
+  let options;
+  let minify = false;
+  return {
+    name: 'lit-css-literals',
+    async configResolved(config) {
+      if (config.css.transformer !== 'lightningcss') {
+        return;
+      }
+      // The transformer setting guarantees the dependency: Vite itself
+      // can't process .css files without it.
+      lightningcss = await import('lightningcss');
+      // cssModules makes no sense for a literal; everything else carries
+      // over.
+      const {cssModules: _cssModules, ...rest} = config.css.lightningcss ?? {};
+      options = rest;
+      minify = config.command === 'build';
+    },
+    transform(code, id) {
+      if (lightningcss === null) {
+        return null;
+      }
+      if (id.startsWith('\0') || id.includes('/node_modules/')) {
+        return null;
+      }
+      const [file] = id.split('?', 2);
+      if (!JS_FILE_RE.test(file) || !code.includes('css`')) {
+        return null;
+      }
+      const ms = new MagicString(code);
+      let changed = false;
+      for (const m of code.matchAll(CSS_LITERAL_RE)) {
+        const literal = m[1];
+        if (literal.trim() === '') {
+          continue;
+        }
+        let out;
+        try {
+          const result = lightningcss.transform({
+            ...options,
+            filename: file,
+            code: Buffer.from(literal),
+            minify,
+          });
+          out = Buffer.from(result.code).toString();
+        } catch (e) {
+          this.warn(
+            `[lit-plugin] skipping css literal Lightning CSS couldn't parse: ${e.message}`
+          );
+          continue;
+        }
+        // Re-escape for the template literal the output goes back into.
+        out = out.replace(/[\\`$]/g, '\\$&');
+        if (out !== literal) {
+          const start = m.index + 'css`'.length;
+          ms.overwrite(start, start + literal.length, out);
+          changed = true;
+        }
+      }
+      if (!changed) {
+        return null;
+      }
+      return {code: ms.toString(), map: ms.generateMap({hires: true})};
+    },
+  };
 };
 /**
  * Vite plugin set providing HMR, CSS helpers, and Lightning CSS processing
  * for Lit projects.
  */
 export const litPlugin = (options = {}) => {
-    // Resolved from explicit options first, env vars second, defaults last. The
-    // `lit-plugin-options` `config` hook below re-resolves with the loaded env
-    // once Vite hands us the mode; this initial pass covers code paths that run
-    // before (or without) it.
-    let resolved = resolveOptions(options, {});
-    let root = '';
-    // Env resolution lives in its own always-applied plugin: `?css-sheet` is a
-    // build-time feature too, and the HMR plugin (`apply: 'serve'`) never gets a
-    // `config` hook under `vite build`. `enforce: 'pre'` and first position put
-    // it ahead of every other hook that reads `resolved`.
-    const optionsPlugin = {
-        name: 'lit-plugin-options',
-        enforce: 'pre',
-        config(viteConfig, { mode }) {
-            // `loadEnv` reads `.env*` files from the env dir (root by default) and
-            // merges in matching `process.env` keys, filtered to the `LIT_PLUGIN`
-            // prefix. Explicit options still win (handled in resolveOptions).
-            const envDir = viteConfig.envDir
-                ? resolvePath(viteConfig.envDir)
-                : viteConfig.root
-                    ? resolvePath(viteConfig.root)
-                    : process.cwd();
-            resolved = resolveOptions(options, loadEnv(mode, envDir, ENV_PREFIX));
-        },
-    };
-    const sourceOverlayPlugin = {
-        name: 'lit-source-overlay',
-        apply: 'serve',
-        // Run before Vite's esbuild TS transform so source-meta line numbers are
-        // measured against the author's raw source (and the `@customElement … class`
-        // forms are still intact), not against transpiled output.
-        enforce: 'pre',
-        configResolved(config) {
-            root = config.root;
+  // Resolved from explicit options first, env vars second, defaults last. The
+  // `lit-plugin-options` `config` hook below re-resolves with the loaded env
+  // once Vite hands us the mode; this initial pass covers code paths that run
+  // before (or without) it.
+  let resolved = resolveOptions(options, {});
+  let root = '';
+  // Env resolution lives in its own always-applied plugin: `?css-sheet` is a
+  // build-time feature too, and the HMR plugin (`apply: 'serve'`) never gets a
+  // `config` hook under `vite build`. `enforce: 'pre'` and first position put
+  // it ahead of every other hook that reads `resolved`.
+  const optionsPlugin = {
+    name: 'lit-plugin-options',
+    enforce: 'pre',
+    config(viteConfig, {mode}) {
+      // `loadEnv` reads `.env*` files from the env dir (root by default) and
+      // merges in matching `process.env` keys, filtered to the `LIT_PLUGIN`
+      // prefix. Explicit options still win (handled in resolveOptions).
+      const envDir = viteConfig.envDir
+        ? resolvePath(viteConfig.envDir)
+        : viteConfig.root
+          ? resolvePath(viteConfig.root)
+          : process.cwd();
+      resolved = resolveOptions(options, loadEnv(mode, envDir, ENV_PREFIX));
+    },
+  };
+  const sourceOverlayPlugin = {
+    name: 'lit-source-overlay',
+    apply: 'serve',
+    // Run before Vite's esbuild TS transform so source-meta line numbers are
+    // measured against the author's raw source (and the `@customElement … class`
+    // forms are still intact), not against transpiled output.
+    enforce: 'pre',
+    configResolved(config) {
+      root = config.root;
+    },
+    resolveId(id) {
+      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {
+        return resolveRuntimeModule('source-overlay');
+      }
+      return null;
+    },
+    configureServer(server) {
+      if (!resolved.sourceOverlay) return;
+      // Allow opens from everything vite itself is willing to serve
+      // (`server.fs.allow` defaults to the workspace root), not just
+      // `config.root` — in monorepos, component sources regularly live in
+      // sibling packages outside the served app's root.
+      const fsAllow = server.config.server.fs?.allow ?? [];
+      server.middlewares.use(
+        OPEN_IN_EDITOR_PATH,
+        createOpenInEditorMiddleware([root, ...fsAllow])
+      );
+    },
+    transform(code, id, transformOptions) {
+      if (!resolved.sourceOverlay) return null;
+      if (transformOptions?.ssr) return null;
+      if (
+        id.startsWith('\0') ||
+        id.includes('__x00__') ||
+        id.includes('lit-plugin:') ||
+        id.includes('/node_modules/')
+      ) {
+        return null;
+      }
+      const [file] = id.split('?', 2);
+      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {
+        return null;
+      }
+      if (!code.includes('customElement') && !code.includes('customElements')) {
+        return null;
+      }
+      const ms = new MagicString(code);
+      const relativeFile = file.startsWith(root + '/')
+        ? file.slice(root.length + 1)
+        : file;
+      if (!injectSourceMeta(code, relativeFile, ms)) {
+        return null;
+      }
+      return {code: ms.toString(), map: ms.generateMap({hires: true})};
+    },
+    transformIndexHtml() {
+      if (!resolved.sourceOverlay) return;
+      const overlayUrl = `/@fs/${resolveRuntimeModule('source-overlay')}`;
+      const {
+        exclude: _exclude,
+        onSelect: _onSelect,
+        ...overlayInit
+      } = resolved.sourceOverlay;
+      const initConfig = {
+        ...overlayInit,
+        openInEditorPath: OPEN_IN_EDITOR_PATH,
+      };
+      return [
+        {
+          tag: 'script',
+          attrs: {type: 'module'},
+          children: `import {initSourceOverlay} from ${JSON.stringify(overlayUrl)};\ninitSourceOverlay(${JSON.stringify(initConfig)});\n`,
+          injectTo: 'body',
         },
-        resolveId(id) {
-            if (id === '@lit-labs/vite-plugin-lit/source-overlay.js') {
-                return resolveRuntimeModule('source-overlay');
-            }
-            return null;
-        },
-        configureServer(server) {
-            if (!resolved.sourceOverlay)
-                return;
-            // Allow opens from everything vite itself is willing to serve
-            // (`server.fs.allow` defaults to the workspace root), not just
-            // `config.root` — in monorepos, component sources regularly live in
-            // sibling packages outside the served app's root.
-            const fsAllow = server.config.server.fs?.allow ?? [];
-            server.middlewares.use(OPEN_IN_EDITOR_PATH, createOpenInEditorMiddleware([root, ...fsAllow]));
-        },
-        transform(code, id, transformOptions) {
-            if (!resolved.sourceOverlay)
-                return null;
-            if (transformOptions?.ssr)
-                return null;
-            if (id.startsWith('\0') ||
-                id.includes('__x00__') ||
-                id.includes('lit-plugin:') ||
-                id.includes('/node_modules/')) {
-                return null;
-            }
-            const [file] = id.split('?', 2);
-            if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {
-                return null;
-            }
-            if (!code.includes('customElement') && !code.includes('customElements')) {
-                return null;
-            }
-            const ms = new MagicString(code);
-            const relativeFile = file.startsWith(root + '/')
-                ? file.slice(root.length + 1)
-                : file;
-            if (!injectSourceMeta(code, relativeFile, ms)) {
-                return null;
-            }
-            return { code: ms.toString(), map: ms.generateMap({ hires: true }) };
-        },
-        transformIndexHtml() {
-            if (!resolved.sourceOverlay)
-                return;
-            const overlayUrl = `/@fs/${resolveRuntimeModule('source-overlay')}`;
-            const { exclude: _exclude, onSelect: _onSelect, ...overlayInit } = resolved.sourceOverlay;
-            const initConfig = {
-                ...overlayInit,
-                openInEditorPath: OPEN_IN_EDITOR_PATH,
-            };
-            return [
-                {
-                    tag: 'script',
-                    attrs: { type: 'module' },
-                    children: `import {initSourceOverlay} from ${JSON.stringify(overlayUrl)};\ninitSourceOverlay(${JSON.stringify(initConfig)});\n`,
-                    injectTo: 'body',
-                },
-            ];
-        },
-    };
-    const hmr = {
-        name: 'lit-plugin',
-        apply: 'serve',
-        config: () => {
-            // Options are already resolved against the loaded env by
-            // `lit-plugin-options`, which runs first.
-            if (!resolved.hmrEnabled) {
-                return;
-            }
-            // The injected runtime imports are invisible to the dep scanner. The
-            // lit family stays prebundle-eligible on purpose: the wrapper modules'
-            // bare imports then resolve to the same URL every other importer gets —
-            // single lit instance, single template cache.
-            return { optimizeDeps: { exclude: ['@lit-labs/vite-plugin-lit'] } };
-        },
-        resolveId(id) {
-            // Public timeline API virtual module.
-            if (id === 'virtual:lit-plugin/timeline') {
-                return '\0virtual:lit-plugin/timeline';
-            }
-            // Resolve the browser CSS helpers and indicator runtime to the copy
-            // shipped next to this plugin, so they work even when the package
-            // isn't reachable through node resolution from the served root (and
-            // stay out of prebundling).
-            if (id === '@lit-labs/vite-plugin-lit/css.js') {
-                return resolveRuntimeModule('css');
-            }
-            if (id === '@lit-labs/vite-plugin-lit/indicator.js') {
-                return resolveRuntimeModule('indicator');
-            }
-            if (id === '@lit-labs/vite-plugin-lit/source-overlay.js') {
-                return resolveRuntimeModule('source-overlay');
-            }
-            if (resolved.hmrEnabled && id.startsWith(VIRTUAL_PREFIX)) {
-                return id;
-            }
-            return null;
-        },
-        load(id) {
-            // Public timeline API — re-export the runtime module when timeline is
-            // enabled, otherwise a no-op stub so imports don't throw in prod builds.
-            if (id === '\0virtual:lit-plugin/timeline') {
-                if (!resolved.timeline) {
-                    return {
-                        code: 'export const addTimelineEvent = () => {};\n' +
-                            'export const addTimelineLayer = () => {};\n',
-                        moduleType: 'js',
-                    };
-                }
-                const apiPath = resolveRuntimeModule('timeline/public-api');
-                return {
-                    code: `export * from ${JSON.stringify(apiPath)};\n`,
-                    moduleType: 'js',
-                };
-            }
-            if (!resolved.hmrEnabled || !id.startsWith(VIRTUAL_PREFIX)) {
-                return null;
-            }
-            if (id === INSTALL_ID) {
-                const patchPath = resolveRuntimeModule('patch');
-                const runtimeOptions = {
-                    reconnect: resolved.reconnect,
-                    onIncompatible: resolved.onIncompatible,
-                };
-                return {
-                    code: `import {install} from ${JSON.stringify(patchPath)};\n` +
-                        `install(${JSON.stringify(runtimeOptions)});\n`,
-                    moduleType: 'js',
-                };
-            }
-            const spec = id.slice(VIRTUAL_PREFIX.length);
-            const wrappedTags = WRAP_TABLE.get(spec);
-            if (wrappedTags === undefined) {
-                return null;
-            }
-            const internPath = resolveRuntimeModule('intern');
-            // Browser-native ESM: explicit local exports shadow `export *` names
-            // (spec-guaranteed), so everything except the wrapped tags passes
-            // through unchanged.
-            const lines = [
-                `import * as __lit from ${JSON.stringify(spec)};`,
-                `import {wrapTag} from ${JSON.stringify(internPath)};`,
-                `export * from ${JSON.stringify(spec)};`,
-            ];
-            for (const { exportName, ns } of wrappedTags) {
-                lines.push(`export const ${exportName} = wrapTag(__lit.${exportName}, ${JSON.stringify(ns)});`);
-            }
-            return { code: lines.join('\n') + '\n', moduleType: 'js' };
-        },
-        async transform(code, id, transformOptions) {
-            if (!resolved.hmrEnabled) {
-                return null;
-            }
-            if (transformOptions?.ssr) {
-                return null;
-            }
-            if (id.startsWith('\0') || id.includes('/node_modules/')) {
-                return null;
-            }
-            const [file] = id.split('?', 2);
-            // Allow inline scripts extracted from HTML (`?html-proxy`).
-            if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {
-                return null;
-            }
-            return transformLitModule(code);
-        },
-        transformIndexHtml() {
-            const tags = [];
-            const indicator = resolved.indicator;
-            if (indicator) {
-                const indicatorUrl = `/@fs/` + resolveRuntimeModule('indicator');
-                tags.push({
-                    tag: 'script',
-                    attrs: { type: 'module', src: indicatorUrl },
-                    injectTo: 'body',
-                }, {
-                    tag: 'lit-devtools-hmr-indicator',
-                    attrs: indicator.count ? { count: '' } : undefined,
-                    children: '',
-                    injectTo: 'body',
-                });
-            }
-            if (resolved.timeline) {
-                const installUrl = `/@fs/` + resolveRuntimeModule('timeline/install');
-                tags.push({
-                    tag: 'script',
-                    attrs: { type: 'module', src: installUrl },
-                    injectTo: 'body',
-                });
-                // Components inspector runtime — answers the panel's tree/details
-                // requests. Paired with the timeline panel, which hosts its tab.
-                const inspectorUrl = `/@fs/` + resolveRuntimeModule('inspector/install');
-                tags.push({
-                    tag: 'script',
-                    attrs: { type: 'module', src: inspectorUrl },
-                    injectTo: 'body',
-                });
-            }
-            return tags.length > 0 ? tags : undefined;
-        },
-    };
-    // The source-overlay plugin is always present; its hooks no-op when the
-    // feature is disabled (which env may decide), so inclusion can't be gated
-    // on the synchronously-known options here.
-    const plugins = [
-        optionsPlugin,
-        // Getter, not a snapshot: `resolved` is re-resolved against the loaded env
-        // in `optionsPlugin`'s `config` hook, which runs after this array is built.
-        litCssQueries(() => resolved.cssSheetBuild),
-        litCssLiterals(),
-        sourceOverlayPlugin,
-        hmr,
-    ];
-    if (resolved.timeline) {
-        // Pass a getter, not a snapshot: `resolved` is re-resolved against the
-        // loaded env in the `config` hook, which runs after this plugin array is
-        // built. The settings endpoint reads it per-request, by which point env is
-        // applied.
-        plugins.push(litTimelinePlugin(() => toFeatureSettings(resolved)));
-    }
-    return plugins;
+      ];
+    },
+  };
+  const hmr = {
+    name: 'lit-plugin',
+    apply: 'serve',
+    config: () => {
+      // Options are already resolved against the loaded env by
+      // `lit-plugin-options`, which runs first.
+      if (!resolved.hmrEnabled) {
+        return;
+      }
+      // The injected runtime imports are invisible to the dep scanner. The
+      // lit family stays prebundle-eligible on purpose: the wrapper modules'
+      // bare imports then resolve to the same URL every other importer gets —
+      // single lit instance, single template cache.
+      return {optimizeDeps: {exclude: ['@oddsquad/vite-plugin-lit']}};
+    },
+    resolveId(id) {
+      // Resolve the browser CSS helpers and indicator runtime to the copy
+      // shipped next to this plugin, so they work even when the package
+      // isn't reachable through node resolution from the served root (and
+      // stay out of prebundling).
+      //
+      // These bare specifiers must match the package name in package.json —
+      // consumers import them by name (see README "Stylesheets"), and Vite
+      // only consults this hook for the exact string. A rename that misses
+      // them turns the fallback into silently dead code.
+      if (id === '@oddsquad/vite-plugin-lit/css.js') {
+        return resolveRuntimeModule('css');
+      }
+      if (id === '@oddsquad/vite-plugin-lit/indicator.js') {
+        return resolveRuntimeModule('indicator');
+      }
+      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {
+        return resolveRuntimeModule('source-overlay');
+      }
+      if (resolved.hmrEnabled && id.startsWith(VIRTUAL_PREFIX)) {
+        return id;
+      }
+      return null;
+    },
+    load(id) {
+      if (!resolved.hmrEnabled || !id.startsWith(VIRTUAL_PREFIX)) {
+        return null;
+      }
+      if (id === INSTALL_ID) {
+        const patchPath = resolveRuntimeModule('patch');
+        const runtimeOptions = {
+          reconnect: resolved.reconnect,
+          onIncompatible: resolved.onIncompatible,
+        };
+        return {
+          code:
+            `import {install} from ${JSON.stringify(patchPath)};\n` +
+            `install(${JSON.stringify(runtimeOptions)});\n`,
+          moduleType: 'js',
+        };
+      }
+      const spec = id.slice(VIRTUAL_PREFIX.length);
+      const wrappedTags = WRAP_TABLE.get(spec);
+      if (wrappedTags === undefined) {
+        return null;
+      }
+      const internPath = resolveRuntimeModule('intern');
+      // Browser-native ESM: explicit local exports shadow `export *` names
+      // (spec-guaranteed), so everything except the wrapped tags passes
+      // through unchanged.
+      const lines = [
+        `import * as __lit from ${JSON.stringify(spec)};`,
+        `import {wrapTag} from ${JSON.stringify(internPath)};`,
+        `export * from ${JSON.stringify(spec)};`,
+      ];
+      for (const {exportName, ns} of wrappedTags) {
+        lines.push(
+          `export const ${exportName} = wrapTag(__lit.${exportName}, ${JSON.stringify(ns)});`
+        );
+      }
+      return {code: lines.join('\n') + '\n', moduleType: 'js'};
+    },
+    async transform(code, id, transformOptions) {
+      if (!resolved.hmrEnabled) {
+        return null;
+      }
+      if (transformOptions?.ssr) {
+        return null;
+      }
+      if (id.startsWith('\0') || id.includes('/node_modules/')) {
+        return null;
+      }
+      const [file] = id.split('?', 2);
+      // Allow inline scripts extracted from HTML (`?html-proxy`).
+      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {
+        return null;
+      }
+      return transformLitModule(code);
+    },
+    transformIndexHtml() {
+      const tags = [];
+      const indicator = resolved.indicator;
+      if (indicator) {
+        const indicatorUrl = `/@fs/` + resolveRuntimeModule('indicator');
+        tags.push(
+          {
+            tag: 'script',
+            attrs: {type: 'module', src: indicatorUrl},
+            injectTo: 'body',
+          },
+          {
+            tag: 'lit-devtools-hmr-indicator',
+            attrs: indicator.count ? {count: ''} : undefined,
+            children: '',
+            injectTo: 'body',
+          }
+        );
+      }
+      if (resolved.timeline) {
+        const installUrl = `/@fs/` + resolveRuntimeModule('timeline/install');
+        tags.push({
+          tag: 'script',
+          attrs: {type: 'module', src: installUrl},
+          injectTo: 'body',
+        });
+        // Components inspector runtime — answers the panel's tree/details
+        // requests. Paired with the timeline panel, which hosts its tab.
+        const inspectorUrl =
+          `/@fs/` + resolveRuntimeModule('inspector/install');
+        tags.push({
+          tag: 'script',
+          attrs: {type: 'module', src: inspectorUrl},
+          injectTo: 'body',
+        });
+      }
+      return tags.length > 0 ? tags : undefined;
+    },
+  };
+  // The source-overlay plugin is always present; its hooks no-op when the
+  // feature is disabled (which env may decide), so inclusion can't be gated
+  // on the synchronously-known options here.
+  const plugins = [
+    optionsPlugin,
+    // Getter, not a snapshot: `resolved` is re-resolved against the loaded env
+    // in `optionsPlugin`'s `config` hook, which runs after this array is built.
+    litCssQueries(() => resolved.cssSheetBuild),
+    litTimelineVirtual(() => resolved.timeline),
+    litCssLiterals(),
+    sourceOverlayPlugin,
+    hmr,
+  ];
+  if (resolved.timeline) {
+    // `features` is a getter, not a snapshot: `resolved` is re-resolved
+    // against the loaded env in `optionsPlugin`'s `config` hook, which runs
+    // after this array is built.
+    plugins.push(
+      createLitDevframePlugin({
+        version: PACKAGE_VERSION,
+        features: () => toFeatureSettings(resolved),
+      })
+    );
+  }
+  return plugins;
 };
-//# sourceMappingURL=plugin.js.map
+//# sourceMappingURL=plugin.js.map