@oddsquad/vite-plugin-lit 0.4.0 → 0.6.0

package/lib/options.js

@@ -3,6 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: BSD-3-Clause
  */
+import {BUILTIN_EDITORS} from './runtime/source-overlay/editors.js';
 const CSS_SHEET_BUILD_MODES = ['auto', 'url', 'inline', 'inline-raw'];
 /** Env var prefix consumed at config time. */
 export const ENV_PREFIX = 'LIT_PLUGIN';
@@ -34,6 +35,19 @@ const envEnum = (v, allowed, source) => {
   );
   return undefined;
 };
+/** Keys a `LIT_PLUGIN_SOURCE_OVERLAY_EDITOR` value may name. */
+const EDITOR_KEYS = Object.keys(BUILTIN_EDITORS);
+/** Which layer supplied a value: the first of option, env that is defined. */
+const sourceOf = (option, env) =>
+  option !== undefined ? 'option' : env !== undefined ? 'env' : 'default';
+/**
+ * Take the first defined of an explicit option and an env value, else the
+ * default, and record which layer won.
+ */
+const pick = (option, env, fallback) => ({
+  value: option ?? env ?? fallback,
+  source: sourceOf(option, env),
+});
 /**
  * Merge explicit options over env vars over defaults (in that precedence) into
  * the flat shape the plugin hooks consume.
@@ -45,26 +59,41 @@ export const resolveOptions = (options, env) => {
     (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 ??
+  const reconnect = pick(
+    hmrObj?.reconnect,
+    envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]),
+    false
+  );
+  const onIncompatible = pick(
+    hmrObj?.onIncompatible,
     envEnum(
       env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`],
       ON_INCOMPATIBLE_MODES,
       `${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`
-    ) ??
-    'reload';
+    ),
+    '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;
+  const indEnabled = pick(
+    typeof ind === 'boolean' ? ind : indObj?.enabled,
+    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]),
+    true
+  );
+  const indCount = pick(
+    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 indicator =
+    hmrEnabled && indEnabled.value ? {count: indCount.value} : false;
+  const sources = {
+    hmrReconnect: reconnect.source,
+    hmrOnIncompatible: onIncompatible.source,
+    hmrIndicatorVisible: indEnabled.source,
+    hmrIndicatorCount: indCount.source,
+  };
   const so = options.sourceOverlay;
   const soExplicit =
     typeof so === 'boolean' ? so : so === undefined ? undefined : true;
@@ -73,9 +102,25 @@ export const resolveOptions = (options, env) => {
   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`]);
+    // Defaults for these are applied later (toFeatureSettings / the runtime),
+    // so only option-vs-env is decided here; neither set means 'default'.
+    const envKey = env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;
+    const envThrottle = envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);
+    // Only read (and warn about) the env editor when no option supplies one.
+    const envEditor =
+      base.editor === undefined
+        ? envEnum(
+            env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`],
+            EDITOR_KEYS,
+            `${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`
+          )
+        : undefined;
+    sources.sourceOverlayKey = sourceOf(base.key, envKey);
+    sources.sourceOverlayEditor = sourceOf(base.editor, envEditor);
+    sources.sourceOverlayThrottleMs = sourceOf(base.throttleMs, envThrottle);
+    base.key ??= envKey;
+    base.editor ??= envEditor;
+    base.throttleMs ??= envThrottle;
     sourceOverlay = base;
   }
   const timeline =
@@ -90,12 +135,13 @@ export const resolveOptions = (options, env) => {
     'auto';
   return {
     hmrEnabled,
-    reconnect,
-    onIncompatible,
+    reconnect: reconnect.value,
+    onIncompatible: onIncompatible.value,
     indicator,
     sourceOverlay,
     timeline,
     cssSheetBuild,
+    sources,
   };
 };
 /**
@@ -123,6 +169,7 @@ export const toFeatureSettings = (r) => {
       throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,
     },
     timeline: r.timeline,
+    sources: {...r.sources},
   };
 };
 //# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/lib/options.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {SourceOverlayOptions} from './types.js';\nimport type {FeatureSettings} from '../types/timeline.js';\n\n/**\n * On-page HMR feedback: a small pulsing indicator in the corner of the host\n * page that briefly animates on each HMR update, for at-a-glance feedback\n * without watching the console.\n */\nexport interface HmrIndicatorOptions {\n  /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */\n  enabled?: boolean;\n\n  /**\n   * Show a cumulative update count next to the dot (idle opacity 0.5 instead\n   * of fully transparent). Defaults to `false`.\n   */\n  count?: boolean;\n}\n\n/**\n * HMR for Lit component classes and its on-page feedback.\n */\nexport interface HmrOptions {\n  /**\n   * Enable in-place HMR for Lit component classes. When `false`, the plugin\n   * skips all HMR transforms and runtime injection. Defaults to `true`.\n   */\n  enabled?: boolean;\n\n  /**\n   * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances\n   * after a hot patch. Interning makes this mostly unnecessary, so it's\n   * opt-in. Defaults to `false`.\n   */\n  reconnect?: boolean;\n\n  /**\n   * What to do when a component can't be hot-patched in place (e.g.\n   * standard `accessor` decorators). Defaults to `'reload'`.\n   */\n  onIncompatible?: 'reload' | 'warn';\n\n  /**\n   * The on-page update indicator. `true` enables it without a count; an\n   * object configures it. Forced off when HMR itself is disabled. Defaults\n   * to enabled (without a count).\n   */\n  indicator?: boolean | HmrIndicatorOptions;\n}\n\n/**\n * What a `?css-sheet` import compiles to under `vite build`.\n *\n * - `'url'`: fetch-backed sheet over the emitted `.css` asset.\n * - `'inline'`: css text embedded in the JS chunk, processed by the css\n *   pipeline (`?inline`).\n * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n *   (`?raw`).\n * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.\n */\nexport type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';\n\nconst CSS_SHEET_BUILD_MODES: readonly CssSheetBuild[] = [\n  'auto',\n  'url',\n  'inline',\n  'inline-raw',\n];\n\n/**\n * Options for the Lit Vite plugin.\n *\n * Every option also resolves from environment variables (and `.env` files)\n * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options\n * passed here take precedence over env vars, which take precedence over the\n * built-in defaults.\n */\nexport interface LitPluginOptions {\n  /**\n   * HMR for Lit components and its on-page feedback. `true`/`false` toggles\n   * the whole feature (patching and indicator); an object configures it.\n   * Defaults to enabled.\n   */\n  hmr?: boolean | HmrOptions;\n\n  /**\n   * Dev-only click-to-open-in-IDE inspector for Lit custom elements.\n   * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.\n   */\n  sourceOverlay?: boolean | SourceOverlayOptions;\n\n  /**\n   * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream\n   * for Lit lifecycle, render, mouse, and keyboard events.\n   *\n   * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`\n   * Vite plugin (`DevTools()`) to be active. Defaults to `false` while\n   * experimental.\n   *\n   * `true` enables all built-in layers with defaults.\n   */\n  timeline?: boolean;\n\n  /**\n   * What a `?css-sheet` import compiles to under `vite build`.\n   * - `'url'`:        fetch-backed sheet over the emitted `.css` asset\n   * - `'inline'`:     css text embedded in the JS chunk, processed by the css\n   *                   pipeline (`?inline`)\n   * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n   *                   (`?raw`)\n   * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise\n   *\n   * Dev is always the fetch-backed HMR form regardless of this setting.\n   * Defaults to `'auto'`.\n   */\n  cssSheetBuild?: CssSheetBuild;\n}\n\n/** Plugin options after merging explicit options, env vars, and defaults. */\nexport interface ResolvedOptions {\n  hmrEnabled: boolean;\n  reconnect: boolean;\n  onIncompatible: 'reload' | 'warn';\n  indicator: false | {count: boolean};\n  sourceOverlay: false | SourceOverlayOptions;\n  timeline: boolean;\n  cssSheetBuild: CssSheetBuild;\n}\n\n/** Env var prefix consumed at config time. */\nexport const ENV_PREFIX = 'LIT_PLUGIN';\n\nconst ON_INCOMPATIBLE_MODES: readonly ('reload' | 'warn')[] = [\n  'reload',\n  'warn',\n];\n\n/** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */\nconst envBool = (v: string | undefined): boolean | undefined =>\n  v === 'true' || v === '1'\n    ? true\n    : v === 'false' || v === '0'\n      ? false\n      : undefined;\n\n/** Parse a numeric env string; `undefined` when unset/non-numeric. */\nconst envNum = (v: string | undefined): number | undefined => {\n  if (v === undefined || v === '') return undefined;\n  const n = Number(v);\n  return Number.isNaN(n) ? undefined : n;\n};\n\n/**\n * Parse a string against a closed set of values; `undefined` (with a warning)\n * when set to something outside it, so a typo falls back to the default\n * instead of silently disabling a feature.\n */\nconst envEnum = <T extends string>(\n  v: string | undefined,\n  allowed: readonly T[],\n  source: string\n): T | undefined => {\n  if (v === undefined || v === '') return undefined;\n  if ((allowed as readonly string[]).includes(v)) return v as T;\n  console.warn(\n    `[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +\n      allowed.map((a) => JSON.stringify(a)).join(', ')\n  );\n  return undefined;\n};\n\n/**\n * Merge explicit options over env vars over defaults (in that precedence) into\n * the flat shape the plugin hooks consume.\n */\nexport const resolveOptions = (\n  options: LitPluginOptions,\n  env: Record<string, string>\n): ResolvedOptions => {\n  const hmr = options.hmr;\n  const hmrObj = typeof hmr === 'object' ? hmr : undefined;\n  const hmrEnabled =\n    (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??\n    envBool(env[`${ENV_PREFIX}_HMR`]) ??\n    true;\n  const reconnect =\n    hmrObj?.reconnect ?? envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]) ?? false;\n  const onIncompatible =\n    hmrObj?.onIncompatible ??\n    envEnum(\n      env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`],\n      ON_INCOMPATIBLE_MODES,\n      `${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`\n    ) ??\n    'reload';\n\n  const ind = hmrObj?.indicator;\n  const indObj = typeof ind === 'object' ? ind : undefined;\n  const indEnabled =\n    (typeof ind === 'boolean' ? ind : indObj?.enabled) ??\n    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]) ??\n    true;\n  const indCount =\n    indObj?.count ?? envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]) ?? false;\n  // The indicator is meaningless without HMR, so it follows the master toggle.\n  const indicator = hmrEnabled && indEnabled ? {count: indCount} : false;\n\n  const so = options.sourceOverlay;\n  const soExplicit =\n    typeof so === 'boolean' ? so : so === undefined ? undefined : true;\n  const soEnabled =\n    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;\n  let sourceOverlay: false | SourceOverlayOptions = false;\n  if (soEnabled) {\n    const base: SourceOverlayOptions = typeof so === 'object' ? {...so} : {};\n    base.key ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;\n    base.editor ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`] || undefined;\n    base.throttleMs ??= envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);\n    sourceOverlay = base;\n  }\n\n  const timeline =\n    options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;\n\n  const cssSheetBuild =\n    envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??\n    envEnum(\n      env[`${ENV_PREFIX}_CSS_SHEET_BUILD`],\n      CSS_SHEET_BUILD_MODES,\n      `${ENV_PREFIX}_CSS_SHEET_BUILD`\n    ) ??\n    'auto';\n\n  return {\n    hmrEnabled,\n    reconnect,\n    onIncompatible,\n    indicator,\n    sourceOverlay,\n    timeline,\n    cssSheetBuild,\n  };\n};\n\n/**\n * Flattens resolved options into the JSON-serializable shape the panel's\n * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;\n * a custom editor object reported as `\"custom\"`). Default key/editor/throttle\n * are applied here so the panel shows the effective values the runtime uses.\n */\nexport const toFeatureSettings = (r: ResolvedOptions): FeatureSettings => {\n  const so = r.sourceOverlay;\n  const editor = so === false ? undefined : so.editor;\n  return {\n    hmr: {\n      enabled: r.hmrEnabled,\n      reconnect: r.reconnect,\n      onIncompatible: r.onIncompatible,\n      indicatorEnabled: r.indicator !== false,\n      indicatorCount: r.indicator !== false && r.indicator.count,\n    },\n    sourceOverlay: {\n      enabled: so !== false,\n      key: (so === false ? undefined : so.key) ?? 's',\n      editor:\n        typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',\n      throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,\n    },\n    timeline: r.timeline,\n  };\n};\n"]}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/lib/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAC,eAAe,EAAC,MAAM,qCAAqC,CAAC;AA6DpE,MAAM,qBAAqB,GAA6B;IACtD,MAAM;IACN,KAAK;IACL,QAAQ;IACR,YAAY;CACb,CAAC;AAmEF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEvC,MAAM,qBAAqB,GAAmC;IAC5D,QAAQ;IACR,MAAM;CACP,CAAC;AAEF,2EAA2E;AAC3E,MAAM,OAAO,GAAG,CAAC,CAAqB,EAAuB,EAAE,CAC7D,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG;IACvB,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,GAAG;QAC1B,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AAElB,sEAAsE;AACtE,MAAM,MAAM,GAAG,CAAC,CAAqB,EAAsB,EAAE;IAC3D,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,GAAG,CACd,CAAqB,EACrB,OAAqB,EACrB,MAAc,EACC,EAAE;IACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAClD,IAAK,OAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAM,CAAC;IAC9D,OAAO,CAAC,IAAI,CACV,yBAAyB,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB;QACtE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACnD,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,GAAsB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,CAAC,MAAe,EAAE,GAAY,EAAiB,EAAE,CAChE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAE1E;;;GAGG;AACH,MAAM,IAAI,GAAG,CACX,MAAqB,EACrB,GAAkB,EAClB,QAAW,EACwB,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,QAAQ;IAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;CAC9B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAyB,EACzB,GAA2B,EACV,EAAE;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,UAAU,GACd,CAAC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC;IACP,MAAM,SAAS,GAAG,IAAI,CACpB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,gBAAgB,CAAC,CAAC,EAC3C,KAAK,CACN,CAAC;IACF,MAAM,cAAc,GAAG,IAAI,CACzB,MAAM,EAAE,cAAc,EACtB,OAAO,CACL,GAAG,CAAC,GAAG,UAAU,sBAAsB,CAAC,EACxC,qBAAqB,EACrB,GAAG,UAAU,sBAAsB,CACpC,EACD,QAAQ,CACT,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,EAAE,SAAS,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CACrB,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAChD,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,gBAAgB,CAAC,CAAC,EAC3C,IAAI,CACL,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CACnB,MAAM,EAAE,KAAK,EACb,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,sBAAsB,CAAC,CAAC,EACjD,KAAK,CACN,CAAC;IACF,6EAA6E;IAC7E,MAAM,SAAS,GACb,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEnE,MAAM,OAAO,GAAmB;QAC9B,YAAY,EAAE,SAAS,CAAC,MAAM;QAC9B,iBAAiB,EAAE,cAAc,CAAC,MAAM;QACxC,mBAAmB,EAAE,UAAU,CAAC,MAAM;QACtC,iBAAiB,EAAE,QAAQ,CAAC,MAAM;KACnC,CAAC;IAEF,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IACjC,MAAM,UAAU,GACd,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,MAAM,SAAS,GACb,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,iBAAiB,CAAC,CAAC,IAAI,KAAK,CAAC;IACtE,IAAI,aAAa,GAAiC,KAAK,CAAC;IACxD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAyB,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,UAAU,qBAAqB,CAAC,IAAI,SAAS,CAAC;QACpE,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,6BAA6B,CAAC,CAAC,CAAC;QAC5E,yEAAyE;QACzE,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,KAAK,SAAS;YACvB,CAAC,CAAC,OAAO,CACL,GAAG,CAAC,GAAG,UAAU,wBAAwB,CAAC,EAC1C,WAAW,EACX,GAAG,UAAU,wBAAwB,CACtC;YACH,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,CAAC,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,CAAC,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/D,OAAO,CAAC,uBAAuB,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC;QACpB,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAC1B,IAAI,CAAC,UAAU,KAAK,WAAW,CAAC;QAChC,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC;IAEtE,MAAM,aAAa,GACjB,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,qBAAqB,EAAE,eAAe,CAAC;QACtE,OAAO,CACL,GAAG,CAAC,GAAG,UAAU,kBAAkB,CAAC,EACpC,qBAAqB,EACrB,GAAG,UAAU,kBAAkB,CAChC;QACD,MAAM,CAAC;IAET,OAAO;QACL,UAAU;QACV,SAAS,EAAE,SAAS,CAAC,KAAK;QAC1B,cAAc,EAAE,cAAc,CAAC,KAAK;QACpC,SAAS;QACT,aAAa;QACb,QAAQ;QACR,aAAa;QACb,OAAO;KACR,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAkB,EAAmB,EAAE;IACvE,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;IAC3B,MAAM,MAAM,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;IACpD,OAAO;QACL,GAAG,EAAE;YACH,OAAO,EAAE,CAAC,CAAC,UAAU;YACrB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,gBAAgB,EAAE,CAAC,CAAC,SAAS,KAAK,KAAK;YACvC,cAAc,EAAE,CAAC,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK;SAC3D;QACD,aAAa,EAAE;YACb,OAAO,EAAE,EAAE,KAAK,KAAK;YACrB,GAAG,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG;YAC/C,MAAM,EACJ,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YACpE,UAAU,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE;SAC7D;QACD,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,EAAC,GAAG,CAAC,CAAC,OAAO,EAAC;KACxB,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {SourceOverlayOptions} from './types.js';\nimport type {\n  FeatureSettings,\n  SettingSource,\n  SettingSources,\n} from '../types/timeline.js';\nimport {BUILTIN_EDITORS} from './runtime/source-overlay/editors.js';\n\n/**\n * On-page HMR feedback: a small pulsing indicator in the corner of the host\n * page that briefly animates on each HMR update, for at-a-glance feedback\n * without watching the console.\n */\nexport interface HmrIndicatorOptions {\n  /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */\n  enabled?: boolean;\n\n  /**\n   * Show a cumulative update count next to the dot (idle opacity 0.5 instead\n   * of fully transparent). Defaults to `false`.\n   */\n  count?: boolean;\n}\n\n/**\n * HMR for Lit component classes and its on-page feedback.\n */\nexport interface HmrOptions {\n  /**\n   * Enable in-place HMR for Lit component classes. When `false`, the plugin\n   * skips all HMR transforms and runtime injection. Defaults to `true`.\n   */\n  enabled?: boolean;\n\n  /**\n   * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances\n   * after a hot patch. Interning makes this mostly unnecessary, so it's\n   * opt-in. Defaults to `false`.\n   */\n  reconnect?: boolean;\n\n  /**\n   * What to do when a component can't be hot-patched in place (e.g.\n   * standard `accessor` decorators). Defaults to `'reload'`.\n   */\n  onIncompatible?: 'reload' | 'warn';\n\n  /**\n   * The on-page update indicator. `true` enables it without a count; an\n   * object configures it. Forced off when HMR itself is disabled. Defaults\n   * to enabled (without a count).\n   */\n  indicator?: boolean | HmrIndicatorOptions;\n}\n\n/**\n * What a `?css-sheet` import compiles to under `vite build`.\n *\n * - `'url'`: fetch-backed sheet over the emitted `.css` asset.\n * - `'inline'`: css text embedded in the JS chunk, processed by the css\n *   pipeline (`?inline`).\n * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n *   (`?raw`).\n * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.\n */\nexport type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';\n\nconst CSS_SHEET_BUILD_MODES: readonly CssSheetBuild[] = [\n  'auto',\n  'url',\n  'inline',\n  'inline-raw',\n];\n\n/**\n * Options for the Lit Vite plugin.\n *\n * Every option also resolves from environment variables (and `.env` files)\n * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options\n * passed here take precedence over env vars, which take precedence over the\n * built-in defaults.\n */\nexport interface LitPluginOptions {\n  /**\n   * HMR for Lit components and its on-page feedback. `true`/`false` toggles\n   * the whole feature (patching and indicator); an object configures it.\n   * Defaults to enabled.\n   */\n  hmr?: boolean | HmrOptions;\n\n  /**\n   * Dev-only click-to-open-in-IDE inspector for Lit custom elements.\n   * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.\n   */\n  sourceOverlay?: boolean | SourceOverlayOptions;\n\n  /**\n   * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream\n   * for Lit lifecycle, render, mouse, and keyboard events.\n   *\n   * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`\n   * Vite plugin (`DevTools()`) to be active. Defaults to `false` while\n   * experimental.\n   *\n   * `true` enables all built-in layers with defaults.\n   */\n  timeline?: boolean;\n\n  /**\n   * What a `?css-sheet` import compiles to under `vite build`.\n   * - `'url'`:        fetch-backed sheet over the emitted `.css` asset\n   * - `'inline'`:     css text embedded in the JS chunk, processed by the css\n   *                   pipeline (`?inline`)\n   * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n   *                   (`?raw`)\n   * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise\n   *\n   * Dev is always the fetch-backed HMR form regardless of this setting.\n   * Defaults to `'auto'`.\n   */\n  cssSheetBuild?: CssSheetBuild;\n}\n\n/** Plugin options after merging explicit options, env vars, and defaults. */\nexport interface ResolvedOptions {\n  hmrEnabled: boolean;\n  reconnect: boolean;\n  onIncompatible: 'reload' | 'warn';\n  indicator: false | {count: boolean};\n  sourceOverlay: false | SourceOverlayOptions;\n  timeline: boolean;\n  cssSheetBuild: CssSheetBuild;\n  /**\n   * Which layer each panel-visible setting came from. Source-overlay keys are\n   * present only when the overlay is enabled.\n   */\n  sources: SettingSources;\n}\n\n/** Env var prefix consumed at config time. */\nexport const ENV_PREFIX = 'LIT_PLUGIN';\n\nconst ON_INCOMPATIBLE_MODES: readonly ('reload' | 'warn')[] = [\n  'reload',\n  'warn',\n];\n\n/** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */\nconst envBool = (v: string | undefined): boolean | undefined =>\n  v === 'true' || v === '1'\n    ? true\n    : v === 'false' || v === '0'\n      ? false\n      : undefined;\n\n/** Parse a numeric env string; `undefined` when unset/non-numeric. */\nconst envNum = (v: string | undefined): number | undefined => {\n  if (v === undefined || v === '') return undefined;\n  const n = Number(v);\n  return Number.isNaN(n) ? undefined : n;\n};\n\n/**\n * Parse a string against a closed set of values; `undefined` (with a warning)\n * when set to something outside it, so a typo falls back to the default\n * instead of silently disabling a feature.\n */\nconst envEnum = <T extends string>(\n  v: string | undefined,\n  allowed: readonly T[],\n  source: string\n): T | undefined => {\n  if (v === undefined || v === '') return undefined;\n  if ((allowed as readonly string[]).includes(v)) return v as T;\n  console.warn(\n    `[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +\n      allowed.map((a) => JSON.stringify(a)).join(', ')\n  );\n  return undefined;\n};\n\n/** Keys a `LIT_PLUGIN_SOURCE_OVERLAY_EDITOR` value may name. */\nconst EDITOR_KEYS: readonly string[] = Object.keys(BUILTIN_EDITORS);\n\n/** Which layer supplied a value: the first of option, env that is defined. */\nconst sourceOf = (option: unknown, env: unknown): SettingSource =>\n  option !== undefined ? 'option' : env !== undefined ? 'env' : 'default';\n\n/**\n * Take the first defined of an explicit option and an env value, else the\n * default, and record which layer won.\n */\nconst pick = <T>(\n  option: T | undefined,\n  env: T | undefined,\n  fallback: T\n): {value: T; source: SettingSource} => ({\n  value: option ?? env ?? fallback,\n  source: sourceOf(option, env),\n});\n\n/**\n * Merge explicit options over env vars over defaults (in that precedence) into\n * the flat shape the plugin hooks consume.\n */\nexport const resolveOptions = (\n  options: LitPluginOptions,\n  env: Record<string, string>\n): ResolvedOptions => {\n  const hmr = options.hmr;\n  const hmrObj = typeof hmr === 'object' ? hmr : undefined;\n  const hmrEnabled =\n    (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??\n    envBool(env[`${ENV_PREFIX}_HMR`]) ??\n    true;\n  const reconnect = pick(\n    hmrObj?.reconnect,\n    envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]),\n    false\n  );\n  const onIncompatible = pick<'reload' | 'warn'>(\n    hmrObj?.onIncompatible,\n    envEnum(\n      env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`],\n      ON_INCOMPATIBLE_MODES,\n      `${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`\n    ),\n    'reload'\n  );\n\n  const ind = hmrObj?.indicator;\n  const indObj = typeof ind === 'object' ? ind : undefined;\n  const indEnabled = pick(\n    typeof ind === 'boolean' ? ind : indObj?.enabled,\n    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]),\n    true\n  );\n  const indCount = pick(\n    indObj?.count,\n    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]),\n    false\n  );\n  // The indicator is meaningless without HMR, so it follows the master toggle.\n  const indicator =\n    hmrEnabled && indEnabled.value ? {count: indCount.value} : false;\n\n  const sources: SettingSources = {\n    hmrReconnect: reconnect.source,\n    hmrOnIncompatible: onIncompatible.source,\n    hmrIndicatorVisible: indEnabled.source,\n    hmrIndicatorCount: indCount.source,\n  };\n\n  const so = options.sourceOverlay;\n  const soExplicit =\n    typeof so === 'boolean' ? so : so === undefined ? undefined : true;\n  const soEnabled =\n    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;\n  let sourceOverlay: false | SourceOverlayOptions = false;\n  if (soEnabled) {\n    const base: SourceOverlayOptions = typeof so === 'object' ? {...so} : {};\n    // Defaults for these are applied later (toFeatureSettings / the runtime),\n    // so only option-vs-env is decided here; neither set means 'default'.\n    const envKey = env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;\n    const envThrottle = envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);\n    // Only read (and warn about) the env editor when no option supplies one.\n    const envEditor =\n      base.editor === undefined\n        ? envEnum(\n            env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`],\n            EDITOR_KEYS,\n            `${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`\n          )\n        : undefined;\n    sources.sourceOverlayKey = sourceOf(base.key, envKey);\n    sources.sourceOverlayEditor = sourceOf(base.editor, envEditor);\n    sources.sourceOverlayThrottleMs = sourceOf(base.throttleMs, envThrottle);\n    base.key ??= envKey;\n    base.editor ??= envEditor;\n    base.throttleMs ??= envThrottle;\n    sourceOverlay = base;\n  }\n\n  const timeline =\n    options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;\n\n  const cssSheetBuild =\n    envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??\n    envEnum(\n      env[`${ENV_PREFIX}_CSS_SHEET_BUILD`],\n      CSS_SHEET_BUILD_MODES,\n      `${ENV_PREFIX}_CSS_SHEET_BUILD`\n    ) ??\n    'auto';\n\n  return {\n    hmrEnabled,\n    reconnect: reconnect.value,\n    onIncompatible: onIncompatible.value,\n    indicator,\n    sourceOverlay,\n    timeline,\n    cssSheetBuild,\n    sources,\n  };\n};\n\n/**\n * Flattens resolved options into the JSON-serializable shape the panel's\n * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;\n * a custom editor object reported as `\"custom\"`). Default key/editor/throttle\n * are applied here so the panel shows the effective values the runtime uses.\n */\nexport const toFeatureSettings = (r: ResolvedOptions): FeatureSettings => {\n  const so = r.sourceOverlay;\n  const editor = so === false ? undefined : so.editor;\n  return {\n    hmr: {\n      enabled: r.hmrEnabled,\n      reconnect: r.reconnect,\n      onIncompatible: r.onIncompatible,\n      indicatorEnabled: r.indicator !== false,\n      indicatorCount: r.indicator !== false && r.indicator.count,\n    },\n    sourceOverlay: {\n      enabled: so !== false,\n      key: (so === false ? undefined : so.key) ?? 's',\n      editor:\n        typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',\n      throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,\n    },\n    timeline: r.timeline,\n    sources: {...r.sources},\n  };\n};\n"]}

package/lib/override-baselines.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { OverrideBaselines } from '../types/timeline.js';
+/**
+ * Whether the config value an override was made against has since changed.
+ *
+ * `recorded` is `undefined` for a legacy override that predates baseline
+ * tracking, which never counts as a change (no false positives). Values are
+ * compared structurally. The source-overlay editor reports `'custom'` for an
+ * `EditorConfig` object, which can't be compared meaningfully, so any side
+ * being `'custom'` skips the check.
+ */
+export declare const baselineChanged: (key: keyof OverrideBaselines, recorded: unknown, current: unknown) => boolean;
+//# sourceMappingURL=override-baselines.d.ts.map

package/lib/override-baselines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-baselines.d.ts","sourceRoot":"","sources":["../src/lib/override-baselines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,QACrB,MAAM,iBAAiB,YAClB,OAAO,WACR,OAAO,KACf,OASF,CAAC"}

package/lib/override-baselines.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Whether the config value an override was made against has since changed.
+ *
+ * `recorded` is `undefined` for a legacy override that predates baseline
+ * tracking, which never counts as a change (no false positives). Values are
+ * compared structurally. The source-overlay editor reports `'custom'` for an
+ * `EditorConfig` object, which can't be compared meaningfully, so any side
+ * being `'custom'` skips the check.
+ */
+export const baselineChanged = (key, recorded, current) => {
+  if (recorded === undefined || current === undefined) return false;
+  if (
+    key === 'sourceOverlayEditor' &&
+    (recorded === 'custom' || current === 'custom')
+  ) {
+    return false;
+  }
+  return JSON.stringify(recorded) !== JSON.stringify(current);
+};
+//# sourceMappingURL=override-baselines.js.map

package/lib/override-baselines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"override-baselines.js","sourceRoot":"","sources":["../src/lib/override-baselines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAA4B,EAC5B,QAAiB,EACjB,OAAgB,EACP,EAAE;IACX,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAClE,IACE,GAAG,KAAK,qBAAqB;QAC7B,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,CAAC,EAC/C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {OverrideBaselines} from '../types/timeline.js';\n\n/**\n * Whether the config value an override was made against has since changed.\n *\n * `recorded` is `undefined` for a legacy override that predates baseline\n * tracking, which never counts as a change (no false positives). Values are\n * compared structurally. The source-overlay editor reports `'custom'` for an\n * `EditorConfig` object, which can't be compared meaningfully, so any side\n * being `'custom'` skips the check.\n */\nexport const baselineChanged = (\n  key: keyof OverrideBaselines,\n  recorded: unknown,\n  current: unknown\n): boolean => {\n  if (recorded === undefined || current === undefined) return false;\n  if (\n    key === 'sourceOverlayEditor' &&\n    (recorded === 'custom' || current === 'custom')\n  ) {\n    return false;\n  }\n  return JSON.stringify(recorded) !== JSON.stringify(current);\n};\n"]}

package/lib/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/lib/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAU,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AAO1C,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAC,4BAA4B,EAAC,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAa,gBAAgB,KAAQ,MAAM,EA+QhE,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/lib/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAU,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AAO1C,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAC,4BAA4B,EAAC,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAa,gBAAgB,KAAQ,MAAM,EAuRhE,CAAC"}

package/lib/plugin.js

@@ -285,6 +285,14 @@ export const litPlugin = (options = {}) => {
       createLitDevframePlugin({
         version: PACKAGE_VERSION,
         features: () => toFeatureSettings(resolved),
+        // Only a named editor counts: `toFeatureSettings` reports `vscode`
+        // for "never chose", which must not turn into a forced `code`.
+        configuredEditor: () => {
+          const so = resolved.sourceOverlay;
+          return so !== false && typeof so.editor === 'string'
+            ? so.editor
+            : undefined;
+        },
       })
     );
   }

package/lib/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/lib/plugin.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 {resolve as resolvePath} from 'node:path';\nimport {loadEnv, type Plugin} from 'vite';\nimport MagicString from 'magic-string';\nimport {injectSourceMeta} from './source-meta.js';\nimport {INSTALL_ID, VIRTUAL_PREFIX, transformLitModule} from './transform.js';\nimport {WRAP_TABLE} from './wrap-table.js';\nimport {createLitDevframePlugin} from './devframe/vite.js';\nimport {PACKAGE_VERSION} from './devframe/paths.js';\nimport {\n  ENV_PREFIX,\n  type LitPluginOptions,\n  type ResolvedOptions,\n  resolveOptions,\n  toFeatureSettings,\n} from './options.js';\nimport {\n  OPEN_IN_EDITOR_PATH,\n  createOpenInEditorMiddleware,\n} from './plugins/open-in-editor.js';\nimport {litCssQueries} from './plugins/css-queries.js';\nimport {litTimelineVirtual} from './plugins/timeline-virtual.js';\nimport {litCssLiterals} from './plugins/css-literals.js';\nimport {resolveRuntimeModule, JS_FILE_RE} from './plugins/shared.js';\n\nexport {createOpenInEditorMiddleware} from './plugins/open-in-editor.js';\nexport {litCssQueries} from './plugins/css-queries.js';\nexport {litTimelineVirtual} from './plugins/timeline-virtual.js';\nexport type {\n  HmrIndicatorOptions,\n  HmrOptions,\n  CssSheetBuild,\n  LitPluginOptions,\n  ResolvedOptions,\n} from './options.js';\nexport {resolveOptions} from './options.js';\n\n/**\n * Vite plugin set providing HMR, CSS helpers, and Lightning CSS processing\n * for Lit projects.\n */\nexport const litPlugin = (options: LitPluginOptions = {}): Plugin[] => {\n  // Resolved from explicit options first, env vars second, defaults last. The\n  // `lit-plugin-options` `config` hook below re-resolves with the loaded env\n  // once Vite hands us the mode; this initial pass covers code paths that run\n  // before (or without) it.\n  let resolved: ResolvedOptions = resolveOptions(options, {});\n  let root = '';\n  // Env resolution lives in its own always-applied plugin: `?css-sheet` is a\n  // build-time feature too, and the HMR plugin (`apply: 'serve'`) never gets a\n  // `config` hook under `vite build`. `enforce: 'pre'` and first position put\n  // it ahead of every other hook that reads `resolved`.\n  const optionsPlugin: Plugin = {\n    name: 'lit-plugin-options',\n    enforce: 'pre',\n    config(viteConfig, {mode}) {\n      // `loadEnv` reads `.env*` files from the env dir (root by default) and\n      // merges in matching `process.env` keys, filtered to the `LIT_PLUGIN`\n      // prefix. Explicit options still win (handled in resolveOptions).\n      const envDir = viteConfig.envDir\n        ? resolvePath(viteConfig.envDir)\n        : viteConfig.root\n          ? resolvePath(viteConfig.root)\n          : process.cwd();\n      resolved = resolveOptions(options, loadEnv(mode, envDir, ENV_PREFIX));\n    },\n  };\n  const sourceOverlayPlugin: Plugin = {\n    name: 'lit-source-overlay',\n    apply: 'serve',\n    // Run before Vite's esbuild TS transform so source-meta line numbers are\n    // measured against the author's raw source (and the `@customElement … class`\n    // forms are still intact), not against transpiled output.\n    enforce: 'pre',\n    configResolved(config) {\n      root = config.root;\n    },\n    resolveId(id) {\n      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {\n        return resolveRuntimeModule('source-overlay');\n      }\n      return null;\n    },\n    configureServer(server) {\n      if (!resolved.sourceOverlay) return;\n      // Allow opens from everything vite itself is willing to serve\n      // (`server.fs.allow` defaults to the workspace root), not just\n      // `config.root` — in monorepos, component sources regularly live in\n      // sibling packages outside the served app's root.\n      const fsAllow = server.config.server.fs?.allow ?? [];\n      server.middlewares.use(\n        OPEN_IN_EDITOR_PATH,\n        createOpenInEditorMiddleware([root, ...fsAllow])\n      );\n    },\n    transform(code, id, transformOptions) {\n      if (!resolved.sourceOverlay) return null;\n      if (transformOptions?.ssr) return null;\n      if (\n        id.startsWith('\\0') ||\n        id.includes('__x00__') ||\n        id.includes('lit-plugin:') ||\n        id.includes('/node_modules/')\n      ) {\n        return null;\n      }\n      const [file] = id.split('?', 2);\n      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {\n        return null;\n      }\n      if (!code.includes('customElement') && !code.includes('customElements')) {\n        return null;\n      }\n      const ms = new MagicString(code);\n      const relativeFile = file.startsWith(root + '/')\n        ? file.slice(root.length + 1)\n        : file;\n      if (!injectSourceMeta(code, relativeFile, ms)) {\n        return null;\n      }\n      return {code: ms.toString(), map: ms.generateMap({hires: true})};\n    },\n    transformIndexHtml() {\n      if (!resolved.sourceOverlay) return;\n      const overlayUrl = `/@fs/${resolveRuntimeModule('source-overlay')}`;\n      const {\n        exclude: _exclude,\n        onSelect: _onSelect,\n        ...overlayInit\n      } = resolved.sourceOverlay;\n      const initConfig = {\n        ...overlayInit,\n        openInEditorPath: OPEN_IN_EDITOR_PATH,\n      };\n      return [\n        {\n          tag: 'script',\n          attrs: {type: 'module'},\n          children: `import {initSourceOverlay} from ${JSON.stringify(overlayUrl)};\\ninitSourceOverlay(${JSON.stringify(initConfig)});\\n`,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n  const hmr: Plugin = {\n    name: 'lit-plugin',\n    apply: 'serve',\n    config: () => {\n      // Options are already resolved against the loaded env by\n      // `lit-plugin-options`, which runs first.\n      if (!resolved.hmrEnabled) {\n        return;\n      }\n      // The injected runtime imports are invisible to the dep scanner. The\n      // lit family stays prebundle-eligible on purpose: the wrapper modules'\n      // bare imports then resolve to the same URL every other importer gets —\n      // single lit instance, single template cache.\n      return {optimizeDeps: {exclude: ['@oddsquad/vite-plugin-lit']}};\n    },\n    resolveId(id) {\n      // Resolve the browser CSS helpers and indicator runtime to the copy\n      // shipped next to this plugin, so they work even when the package\n      // isn't reachable through node resolution from the served root (and\n      // stay out of prebundling).\n      //\n      // These bare specifiers must match the package name in package.json —\n      // consumers import them by name (see README \"Stylesheets\"), and Vite\n      // only consults this hook for the exact string. A rename that misses\n      // them turns the fallback into silently dead code.\n      if (id === '@oddsquad/vite-plugin-lit/css.js') {\n        return resolveRuntimeModule('css');\n      }\n      if (id === '@oddsquad/vite-plugin-lit/indicator.js') {\n        return resolveRuntimeModule('indicator');\n      }\n      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {\n        return resolveRuntimeModule('source-overlay');\n      }\n      if (resolved.hmrEnabled && id.startsWith(VIRTUAL_PREFIX)) {\n        return id;\n      }\n      return null;\n    },\n    load(id) {\n      if (!resolved.hmrEnabled || !id.startsWith(VIRTUAL_PREFIX)) {\n        return null;\n      }\n      if (id === INSTALL_ID) {\n        const patchPath = resolveRuntimeModule('patch');\n        const runtimeOptions = {\n          reconnect: resolved.reconnect,\n          onIncompatible: resolved.onIncompatible,\n        };\n        return {\n          code:\n            `import {install} from ${JSON.stringify(patchPath)};\\n` +\n            `install(${JSON.stringify(runtimeOptions)});\\n`,\n          moduleType: 'js',\n        };\n      }\n      const spec = id.slice(VIRTUAL_PREFIX.length);\n      const wrappedTags = WRAP_TABLE.get(spec);\n      if (wrappedTags === undefined) {\n        return null;\n      }\n      const internPath = resolveRuntimeModule('intern');\n      // Browser-native ESM: explicit local exports shadow `export *` names\n      // (spec-guaranteed), so everything except the wrapped tags passes\n      // through unchanged.\n      const lines = [\n        `import * as __lit from ${JSON.stringify(spec)};`,\n        `import {wrapTag} from ${JSON.stringify(internPath)};`,\n        `export * from ${JSON.stringify(spec)};`,\n      ];\n      for (const {exportName, ns} of wrappedTags) {\n        lines.push(\n          `export const ${exportName} = wrapTag(__lit.${exportName}, ${JSON.stringify(\n            ns\n          )});`\n        );\n      }\n      return {code: lines.join('\\n') + '\\n', moduleType: 'js'};\n    },\n    async transform(code, id, transformOptions) {\n      if (!resolved.hmrEnabled) {\n        return null;\n      }\n      if (transformOptions?.ssr) {\n        return null;\n      }\n      if (id.startsWith('\\0') || id.includes('/node_modules/')) {\n        return null;\n      }\n      const [file] = id.split('?', 2);\n      // Allow inline scripts extracted from HTML (`?html-proxy`).\n      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {\n        return null;\n      }\n      return transformLitModule(code);\n    },\n    transformIndexHtml() {\n      const tags: {\n        tag: string;\n        attrs?: Record<string, string | undefined | boolean>;\n        children?: string;\n        injectTo: 'body';\n      }[] = [];\n\n      const indicator = resolved.indicator;\n      if (indicator) {\n        const indicatorUrl = `/@fs/` + resolveRuntimeModule('indicator');\n        tags.push(\n          {\n            tag: 'script',\n            attrs: {type: 'module', src: indicatorUrl},\n            injectTo: 'body',\n          },\n          {\n            tag: 'lit-devtools-hmr-indicator',\n            attrs: indicator.count ? {count: ''} : undefined,\n            children: '',\n            injectTo: 'body',\n          }\n        );\n      }\n\n      if (resolved.timeline) {\n        const installUrl = `/@fs/` + resolveRuntimeModule('timeline/install');\n        tags.push({\n          tag: 'script',\n          attrs: {type: 'module', src: installUrl},\n          injectTo: 'body',\n        });\n        // Components inspector runtime — answers the panel's tree/details\n        // requests. Paired with the timeline panel, which hosts its tab.\n        const inspectorUrl =\n          `/@fs/` + resolveRuntimeModule('inspector/install');\n        tags.push({\n          tag: 'script',\n          attrs: {type: 'module', src: inspectorUrl},\n          injectTo: 'body',\n        });\n      }\n\n      return tags.length > 0 ? tags : undefined;\n    },\n  };\n  // The source-overlay plugin is always present; its hooks no-op when the\n  // feature is disabled (which env may decide), so inclusion can't be gated\n  // on the synchronously-known options here.\n  const plugins: Plugin[] = [\n    optionsPlugin,\n    // Getter, not a snapshot: `resolved` is re-resolved against the loaded env\n    // in `optionsPlugin`'s `config` hook, which runs after this array is built.\n    litCssQueries(() => resolved.cssSheetBuild),\n    litTimelineVirtual(() => resolved.timeline),\n    litCssLiterals(),\n    sourceOverlayPlugin,\n    hmr,\n  ];\n  if (resolved.timeline) {\n    // `features` is a getter, not a snapshot: `resolved` is re-resolved\n    // against the loaded env in `optionsPlugin`'s `config` hook, which runs\n    // after this array is built.\n    plugins.push(\n      createLitDevframePlugin({\n        version: PACKAGE_VERSION,\n        features: () => toFeatureSettings(resolved),\n      })\n    );\n  }\n  return plugins;\n};\n"]}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/lib/plugin.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 {resolve as resolvePath} from 'node:path';\nimport {loadEnv, type Plugin} from 'vite';\nimport MagicString from 'magic-string';\nimport {injectSourceMeta} from './source-meta.js';\nimport {INSTALL_ID, VIRTUAL_PREFIX, transformLitModule} from './transform.js';\nimport {WRAP_TABLE} from './wrap-table.js';\nimport {createLitDevframePlugin} from './devframe/vite.js';\nimport {PACKAGE_VERSION} from './devframe/paths.js';\nimport {\n  ENV_PREFIX,\n  type LitPluginOptions,\n  type ResolvedOptions,\n  resolveOptions,\n  toFeatureSettings,\n} from './options.js';\nimport {\n  OPEN_IN_EDITOR_PATH,\n  createOpenInEditorMiddleware,\n} from './plugins/open-in-editor.js';\nimport {litCssQueries} from './plugins/css-queries.js';\nimport {litTimelineVirtual} from './plugins/timeline-virtual.js';\nimport {litCssLiterals} from './plugins/css-literals.js';\nimport {resolveRuntimeModule, JS_FILE_RE} from './plugins/shared.js';\n\nexport {createOpenInEditorMiddleware} from './plugins/open-in-editor.js';\nexport {litCssQueries} from './plugins/css-queries.js';\nexport {litTimelineVirtual} from './plugins/timeline-virtual.js';\nexport type {\n  HmrIndicatorOptions,\n  HmrOptions,\n  CssSheetBuild,\n  LitPluginOptions,\n  ResolvedOptions,\n} from './options.js';\nexport {resolveOptions} from './options.js';\n\n/**\n * Vite plugin set providing HMR, CSS helpers, and Lightning CSS processing\n * for Lit projects.\n */\nexport const litPlugin = (options: LitPluginOptions = {}): Plugin[] => {\n  // Resolved from explicit options first, env vars second, defaults last. The\n  // `lit-plugin-options` `config` hook below re-resolves with the loaded env\n  // once Vite hands us the mode; this initial pass covers code paths that run\n  // before (or without) it.\n  let resolved: ResolvedOptions = resolveOptions(options, {});\n  let root = '';\n  // Env resolution lives in its own always-applied plugin: `?css-sheet` is a\n  // build-time feature too, and the HMR plugin (`apply: 'serve'`) never gets a\n  // `config` hook under `vite build`. `enforce: 'pre'` and first position put\n  // it ahead of every other hook that reads `resolved`.\n  const optionsPlugin: Plugin = {\n    name: 'lit-plugin-options',\n    enforce: 'pre',\n    config(viteConfig, {mode}) {\n      // `loadEnv` reads `.env*` files from the env dir (root by default) and\n      // merges in matching `process.env` keys, filtered to the `LIT_PLUGIN`\n      // prefix. Explicit options still win (handled in resolveOptions).\n      const envDir = viteConfig.envDir\n        ? resolvePath(viteConfig.envDir)\n        : viteConfig.root\n          ? resolvePath(viteConfig.root)\n          : process.cwd();\n      resolved = resolveOptions(options, loadEnv(mode, envDir, ENV_PREFIX));\n    },\n  };\n  const sourceOverlayPlugin: Plugin = {\n    name: 'lit-source-overlay',\n    apply: 'serve',\n    // Run before Vite's esbuild TS transform so source-meta line numbers are\n    // measured against the author's raw source (and the `@customElement … class`\n    // forms are still intact), not against transpiled output.\n    enforce: 'pre',\n    configResolved(config) {\n      root = config.root;\n    },\n    resolveId(id) {\n      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {\n        return resolveRuntimeModule('source-overlay');\n      }\n      return null;\n    },\n    configureServer(server) {\n      if (!resolved.sourceOverlay) return;\n      // Allow opens from everything vite itself is willing to serve\n      // (`server.fs.allow` defaults to the workspace root), not just\n      // `config.root` — in monorepos, component sources regularly live in\n      // sibling packages outside the served app's root.\n      const fsAllow = server.config.server.fs?.allow ?? [];\n      server.middlewares.use(\n        OPEN_IN_EDITOR_PATH,\n        createOpenInEditorMiddleware([root, ...fsAllow])\n      );\n    },\n    transform(code, id, transformOptions) {\n      if (!resolved.sourceOverlay) return null;\n      if (transformOptions?.ssr) return null;\n      if (\n        id.startsWith('\\0') ||\n        id.includes('__x00__') ||\n        id.includes('lit-plugin:') ||\n        id.includes('/node_modules/')\n      ) {\n        return null;\n      }\n      const [file] = id.split('?', 2);\n      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {\n        return null;\n      }\n      if (!code.includes('customElement') && !code.includes('customElements')) {\n        return null;\n      }\n      const ms = new MagicString(code);\n      const relativeFile = file.startsWith(root + '/')\n        ? file.slice(root.length + 1)\n        : file;\n      if (!injectSourceMeta(code, relativeFile, ms)) {\n        return null;\n      }\n      return {code: ms.toString(), map: ms.generateMap({hires: true})};\n    },\n    transformIndexHtml() {\n      if (!resolved.sourceOverlay) return;\n      const overlayUrl = `/@fs/${resolveRuntimeModule('source-overlay')}`;\n      const {\n        exclude: _exclude,\n        onSelect: _onSelect,\n        ...overlayInit\n      } = resolved.sourceOverlay;\n      const initConfig = {\n        ...overlayInit,\n        openInEditorPath: OPEN_IN_EDITOR_PATH,\n      };\n      return [\n        {\n          tag: 'script',\n          attrs: {type: 'module'},\n          children: `import {initSourceOverlay} from ${JSON.stringify(overlayUrl)};\\ninitSourceOverlay(${JSON.stringify(initConfig)});\\n`,\n          injectTo: 'body',\n        },\n      ];\n    },\n  };\n  const hmr: Plugin = {\n    name: 'lit-plugin',\n    apply: 'serve',\n    config: () => {\n      // Options are already resolved against the loaded env by\n      // `lit-plugin-options`, which runs first.\n      if (!resolved.hmrEnabled) {\n        return;\n      }\n      // The injected runtime imports are invisible to the dep scanner. The\n      // lit family stays prebundle-eligible on purpose: the wrapper modules'\n      // bare imports then resolve to the same URL every other importer gets —\n      // single lit instance, single template cache.\n      return {optimizeDeps: {exclude: ['@oddsquad/vite-plugin-lit']}};\n    },\n    resolveId(id) {\n      // Resolve the browser CSS helpers and indicator runtime to the copy\n      // shipped next to this plugin, so they work even when the package\n      // isn't reachable through node resolution from the served root (and\n      // stay out of prebundling).\n      //\n      // These bare specifiers must match the package name in package.json —\n      // consumers import them by name (see README \"Stylesheets\"), and Vite\n      // only consults this hook for the exact string. A rename that misses\n      // them turns the fallback into silently dead code.\n      if (id === '@oddsquad/vite-plugin-lit/css.js') {\n        return resolveRuntimeModule('css');\n      }\n      if (id === '@oddsquad/vite-plugin-lit/indicator.js') {\n        return resolveRuntimeModule('indicator');\n      }\n      if (id === '@oddsquad/vite-plugin-lit/source-overlay.js') {\n        return resolveRuntimeModule('source-overlay');\n      }\n      if (resolved.hmrEnabled && id.startsWith(VIRTUAL_PREFIX)) {\n        return id;\n      }\n      return null;\n    },\n    load(id) {\n      if (!resolved.hmrEnabled || !id.startsWith(VIRTUAL_PREFIX)) {\n        return null;\n      }\n      if (id === INSTALL_ID) {\n        const patchPath = resolveRuntimeModule('patch');\n        const runtimeOptions = {\n          reconnect: resolved.reconnect,\n          onIncompatible: resolved.onIncompatible,\n        };\n        return {\n          code:\n            `import {install} from ${JSON.stringify(patchPath)};\\n` +\n            `install(${JSON.stringify(runtimeOptions)});\\n`,\n          moduleType: 'js',\n        };\n      }\n      const spec = id.slice(VIRTUAL_PREFIX.length);\n      const wrappedTags = WRAP_TABLE.get(spec);\n      if (wrappedTags === undefined) {\n        return null;\n      }\n      const internPath = resolveRuntimeModule('intern');\n      // Browser-native ESM: explicit local exports shadow `export *` names\n      // (spec-guaranteed), so everything except the wrapped tags passes\n      // through unchanged.\n      const lines = [\n        `import * as __lit from ${JSON.stringify(spec)};`,\n        `import {wrapTag} from ${JSON.stringify(internPath)};`,\n        `export * from ${JSON.stringify(spec)};`,\n      ];\n      for (const {exportName, ns} of wrappedTags) {\n        lines.push(\n          `export const ${exportName} = wrapTag(__lit.${exportName}, ${JSON.stringify(\n            ns\n          )});`\n        );\n      }\n      return {code: lines.join('\\n') + '\\n', moduleType: 'js'};\n    },\n    async transform(code, id, transformOptions) {\n      if (!resolved.hmrEnabled) {\n        return null;\n      }\n      if (transformOptions?.ssr) {\n        return null;\n      }\n      if (id.startsWith('\\0') || id.includes('/node_modules/')) {\n        return null;\n      }\n      const [file] = id.split('?', 2);\n      // Allow inline scripts extracted from HTML (`?html-proxy`).\n      if (!JS_FILE_RE.test(file) && !id.includes('?html-proxy')) {\n        return null;\n      }\n      return transformLitModule(code);\n    },\n    transformIndexHtml() {\n      const tags: {\n        tag: string;\n        attrs?: Record<string, string | undefined | boolean>;\n        children?: string;\n        injectTo: 'body';\n      }[] = [];\n\n      const indicator = resolved.indicator;\n      if (indicator) {\n        const indicatorUrl = `/@fs/` + resolveRuntimeModule('indicator');\n        tags.push(\n          {\n            tag: 'script',\n            attrs: {type: 'module', src: indicatorUrl},\n            injectTo: 'body',\n          },\n          {\n            tag: 'lit-devtools-hmr-indicator',\n            attrs: indicator.count ? {count: ''} : undefined,\n            children: '',\n            injectTo: 'body',\n          }\n        );\n      }\n\n      if (resolved.timeline) {\n        const installUrl = `/@fs/` + resolveRuntimeModule('timeline/install');\n        tags.push({\n          tag: 'script',\n          attrs: {type: 'module', src: installUrl},\n          injectTo: 'body',\n        });\n        // Components inspector runtime — answers the panel's tree/details\n        // requests. Paired with the timeline panel, which hosts its tab.\n        const inspectorUrl =\n          `/@fs/` + resolveRuntimeModule('inspector/install');\n        tags.push({\n          tag: 'script',\n          attrs: {type: 'module', src: inspectorUrl},\n          injectTo: 'body',\n        });\n      }\n\n      return tags.length > 0 ? tags : undefined;\n    },\n  };\n  // The source-overlay plugin is always present; its hooks no-op when the\n  // feature is disabled (which env may decide), so inclusion can't be gated\n  // on the synchronously-known options here.\n  const plugins: Plugin[] = [\n    optionsPlugin,\n    // Getter, not a snapshot: `resolved` is re-resolved against the loaded env\n    // in `optionsPlugin`'s `config` hook, which runs after this array is built.\n    litCssQueries(() => resolved.cssSheetBuild),\n    litTimelineVirtual(() => resolved.timeline),\n    litCssLiterals(),\n    sourceOverlayPlugin,\n    hmr,\n  ];\n  if (resolved.timeline) {\n    // `features` is a getter, not a snapshot: `resolved` is re-resolved\n    // against the loaded env in `optionsPlugin`'s `config` hook, which runs\n    // after this array is built.\n    plugins.push(\n      createLitDevframePlugin({\n        version: PACKAGE_VERSION,\n        features: () => toFeatureSettings(resolved),\n        // Only a named editor counts: `toFeatureSettings` reports `vscode`\n        // for \"never chose\", which must not turn into a forced `code`.\n        configuredEditor: () => {\n          const so = resolved.sourceOverlay;\n          return so !== false && typeof so.editor === 'string'\n            ? so.editor\n            : undefined;\n        },\n      })\n    );\n  }\n  return plugins;\n};\n"]}

package/lib/plugins/open-in-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-in-editor.d.ts","sourceRoot":"","sources":["../../src/lib/plugins/open-in-editor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAmB,KAAK,YAAY,EAAC,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,eAAO,MAAM,4BAA4B,iBACzB,SAAS,MAAM,EAAE,WAMxB;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAC,OACvD;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAC,QAC/C,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,SAuFhC,CAAC"}
+{"version":3,"file":"open-in-editor.d.ts","sourceRoot":"","sources":["../../src/lib/plugins/open-in-editor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAmB,KAAK,YAAY,EAAC,MAAM,YAAY,CAAC;AAE/D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,eAAO,MAAM,4BAA4B,iBACzB,SAAS,MAAM,EAAE,WAMxB;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAC,OACvD;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAC,QAC/C,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,SAiGhC,CAAC"}

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

@@ -5,6 +5,7 @@
  */
 import {existsSync} from 'node:fs';
 import {resolve as resolvePath, sep} from 'node:path';
+import {toLaunchEditor} from '../devframe/launch-editor.js';
 import {isTrustedRequest} from '../http.js';
 export const OPEN_IN_EDITOR_PATH = '/__lit-open-in-editor';
 export const createOpenInEditorMiddleware = (allowedRoots) => {
@@ -63,6 +64,10 @@ export const createOpenInEditorMiddleware = (allowedRoots) => {
     const column = String(
       Math.max(1, Number.parseInt(params.get('column') ?? '1', 10) || 1)
     );
+    // The overlay names the editor it is using (the panel's override, else the
+    // configured one). Only keys `toLaunchEditor` knows become a command;
+    // anything else, or nothing, leaves `launch-editor` to auto-detect.
+    const editor = toLaunchEditor(params.get('editor') ?? undefined);
     const fileRef = `${resolved}:${line}:${column}`;
     import('launch-editor')
       .then((mod) => {
@@ -78,7 +83,7 @@ export const createOpenInEditorMiddleware = (allowedRoots) => {
           res.statusCode = statusCode;
           res.end(msg);
         };
-        launch(fileRef, (_fileName, errorMessage) => {
+        launch(fileRef, editor, (_fileName, errorMessage) => {
           if (errorMessage !== null) {
             finish(500, errorMessage);
           }

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

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

package/lib/runtime/indicator.js.map

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

package/lib/runtime/inspector/install.js

@@ -13,6 +13,7 @@
  */
 import {createPageScriptChannel} from 'devframe/in-page-channel';
 import {elementById} from '../timeline/identity.js';
+import {pageChannel} from '../page-channel.js';
 import {buildTree, collectDetails} from './collect.js';
 import {clearHighlight, highlightById} from './highlight.js';
 import {LIT_IN_PAGE_CHANNEL} from '../../../types/in-page.js';
@@ -21,6 +22,7 @@ import {
   INSPECT_DATA_CHANNEL,
 } from '../../../types/inspector.js';
 const hot = import.meta.hot;
+if (hot !== undefined) pageChannel.useViteHot(hot);
 // The direct panel channel, outside the `hot` gate on purpose: it is the one
 // part of the inspector that does not need a dev server, which is what lets
 // the hover outline keep working in a static snapshot of the panel. Answering
@@ -40,7 +42,7 @@ if (typeof window !== 'undefined') {
 if (hot !== undefined && typeof window !== 'undefined') {
   const send = (msg) => {
     try {
-      hot.send(INSPECT_DATA_CHANNEL, msg);
+      pageChannel.send(INSPECT_DATA_CHANNEL, msg);
     } catch {
       // HMR channel temporarily unavailable; the panel can re-request.
     }
@@ -216,7 +218,7 @@ if (hot !== undefined && typeof window !== 'undefined') {
   // -------------------------------------------------------------------------
   // Command dispatch
   // -------------------------------------------------------------------------
-  hot.on(INSPECT_CMD_CHANNEL, (data) => {
+  pageChannel.on(INSPECT_CMD_CHANNEL, (data) => {
     const cmd = data;
     switch (cmd.type) {
       case 'tree': {