@oddsquad/vite-plugin-lit 0.3.0 → 0.5.0

package/lib/options.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { SourceOverlayOptions } from './types.js';
+import type { FeatureSettings, SettingSources } from '../types/timeline.js';
+/**
+ * On-page HMR feedback: a small pulsing indicator in the corner of the host
+ * page that briefly animates on each HMR update, for at-a-glance feedback
+ * without watching the console.
+ */
+export interface HmrIndicatorOptions {
+    /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */
+    enabled?: boolean;
+    /**
+     * Show a cumulative update count next to the dot (idle opacity 0.5 instead
+     * of fully transparent). Defaults to `false`.
+     */
+    count?: boolean;
+}
+/**
+ * HMR for Lit component classes and its on-page feedback.
+ */
+export interface HmrOptions {
+    /**
+     * Enable in-place HMR for Lit component classes. When `false`, the plugin
+     * skips all HMR transforms and runtime injection. Defaults to `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances
+     * after a hot patch. Interning makes this mostly unnecessary, so it's
+     * opt-in. Defaults to `false`.
+     */
+    reconnect?: boolean;
+    /**
+     * What to do when a component can't be hot-patched in place (e.g.
+     * standard `accessor` decorators). Defaults to `'reload'`.
+     */
+    onIncompatible?: 'reload' | 'warn';
+    /**
+     * The on-page update indicator. `true` enables it without a count; an
+     * object configures it. Forced off when HMR itself is disabled. Defaults
+     * to enabled (without a count).
+     */
+    indicator?: boolean | HmrIndicatorOptions;
+}
+/**
+ * What a `?css-sheet` import compiles to under `vite build`.
+ *
+ * - `'url'`: fetch-backed sheet over the emitted `.css` asset.
+ * - `'inline'`: css text embedded in the JS chunk, processed by the css
+ *   pipeline (`?inline`).
+ * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
+ *   (`?raw`).
+ * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.
+ */
+export type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';
+/**
+ * Options for the Lit Vite plugin.
+ *
+ * Every option also resolves from environment variables (and `.env` files)
+ * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options
+ * passed here take precedence over env vars, which take precedence over the
+ * built-in defaults.
+ */
+export interface LitPluginOptions {
+    /**
+     * HMR for Lit components and its on-page feedback. `true`/`false` toggles
+     * the whole feature (patching and indicator); an object configures it.
+     * Defaults to enabled.
+     */
+    hmr?: boolean | HmrOptions;
+    /**
+     * Dev-only click-to-open-in-IDE inspector for Lit custom elements.
+     * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.
+     */
+    sourceOverlay?: boolean | SourceOverlayOptions;
+    /**
+     * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream
+     * for Lit lifecycle, render, mouse, and keyboard events.
+     *
+     * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`
+     * Vite plugin (`DevTools()`) to be active. Defaults to `false` while
+     * experimental.
+     *
+     * `true` enables all built-in layers with defaults.
+     */
+    timeline?: boolean;
+    /**
+     * What a `?css-sheet` import compiles to under `vite build`.
+     * - `'url'`:        fetch-backed sheet over the emitted `.css` asset
+     * - `'inline'`:     css text embedded in the JS chunk, processed by the css
+     *                   pipeline (`?inline`)
+     * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
+     *                   (`?raw`)
+     * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise
+     *
+     * Dev is always the fetch-backed HMR form regardless of this setting.
+     * Defaults to `'auto'`.
+     */
+    cssSheetBuild?: CssSheetBuild;
+}
+/** Plugin options after merging explicit options, env vars, and defaults. */
+export interface ResolvedOptions {
+    hmrEnabled: boolean;
+    reconnect: boolean;
+    onIncompatible: 'reload' | 'warn';
+    indicator: false | {
+        count: boolean;
+    };
+    sourceOverlay: false | SourceOverlayOptions;
+    timeline: boolean;
+    cssSheetBuild: CssSheetBuild;
+    /**
+     * Which layer each panel-visible setting came from. Source-overlay keys are
+     * present only when the overlay is enabled.
+     */
+    sources: SettingSources;
+}
+/** Env var prefix consumed at config time. */
+export declare const ENV_PREFIX = "LIT_PLUGIN";
+/**
+ * Merge explicit options over env vars over defaults (in that precedence) into
+ * the flat shape the plugin hooks consume.
+ */
+export declare const resolveOptions: (options: LitPluginOptions, env: Record<string, string>) => ResolvedOptions;
+/**
+ * Flattens resolved options into the JSON-serializable shape the panel's
+ * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;
+ * a custom editor object reported as `"custom"`). Default key/editor/throttle
+ * are applied here so the panel shows the effective values the runtime uses.
+ */
+export declare const toFeatureSettings: (r: ResolvedOptions) => FeatureSettings;
+//# sourceMappingURL=options.d.ts.map

package/lib/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/lib/options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAG9B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AASrE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAE/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,KAAK,GAAG;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC;IACpC,aAAa,EAAE,KAAK,GAAG,oBAAoB,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,8CAA8C;AAC9C,eAAO,MAAM,UAAU,eAAe,CAAC;AA6DvC;;;GAGG;AACH,eAAO,MAAM,cAAc,YAChB,gBAAgB,OACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1B,eAiGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,MAAO,eAAe,KAAG,eAqBtD,CAAC"}

package/lib/options.js

@@ -0,0 +1,175 @@
+/**
+ * @license
+ * 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';
+const ON_INCOMPATIBLE_MODES = ['reload', 'warn'];
+/** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */
+const envBool = (v) =>
+  v === 'true' || v === '1'
+    ? true
+    : v === 'false' || v === '0'
+      ? 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;
+};
+/**
+ * Parse a string against a closed set of values; `undefined` (with a warning)
+ * when set to something outside it, so a typo falls back to the default
+ * 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;
+};
+/** 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.
+ */
+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 = 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'
+  );
+  const ind = hmrObj?.indicator;
+  const indObj = typeof ind === 'object' ? ind : undefined;
+  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.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;
+  const soEnabled =
+    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;
+  let sourceOverlay = false;
+  if (soEnabled) {
+    const base = typeof so === 'object' ? {...so} : {};
+    // 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 =
+    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: reconnect.value,
+    onIncompatible: onIncompatible.value,
+    indicator,
+    sourceOverlay,
+    timeline,
+    cssSheetBuild,
+    sources,
+  };
+};
+/**
+ * Flattens resolved options into the JSON-serializable shape the panel's
+ * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;
+ * a custom editor object reported as `"custom"`). Default key/editor/throttle
+ * are applied here so the panel shows the effective values the runtime uses.
+ */
+export 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,
+    sources: {...r.sources},
+  };
+};
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +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 {\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

@@ -4,154 +4,12 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 import { type Plugin } from 'vite';
-import { type TrustHeaders } from './http.js';
-import type { SourceOverlayOptions } from './types.js';
-/**
- * On-page HMR feedback: a small pulsing indicator in the corner of the host
- * page that briefly animates on each HMR update, for at-a-glance feedback
- * without watching the console.
- */
-export interface HmrIndicatorOptions {
-    /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */
-    enabled?: boolean;
-    /**
-     * Show a cumulative update count next to the dot (idle opacity 0.5 instead
-     * of fully transparent). Defaults to `false`.
-     */
-    count?: boolean;
-}
-/**
- * HMR for Lit component classes and its on-page feedback.
- */
-export interface HmrOptions {
-    /**
-     * Enable in-place HMR for Lit component classes. When `false`, the plugin
-     * skips all HMR transforms and runtime injection. Defaults to `true`.
-     */
-    enabled?: boolean;
-    /**
-     * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances
-     * after a hot patch. Interning makes this mostly unnecessary, so it's
-     * opt-in. Defaults to `false`.
-     */
-    reconnect?: boolean;
-    /**
-     * What to do when a component can't be hot-patched in place (e.g.
-     * standard `accessor` decorators). Defaults to `'reload'`.
-     */
-    onIncompatible?: 'reload' | 'warn';
-    /**
-     * The on-page update indicator. `true` enables it without a count; an
-     * object configures it. Forced off when HMR itself is disabled. Defaults
-     * to enabled (without a count).
-     */
-    indicator?: boolean | HmrIndicatorOptions;
-}
-/**
- * What a `?css-sheet` import compiles to under `vite build`.
- *
- * - `'url'`: fetch-backed sheet over the emitted `.css` asset.
- * - `'inline'`: css text embedded in the JS chunk, processed by the css
- *   pipeline (`?inline`).
- * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
- *   (`?raw`).
- * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.
- */
-export type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';
-/**
- * Options for the Lit Vite plugin.
- *
- * Every option also resolves from environment variables (and `.env` files)
- * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options
- * passed here take precedence over env vars, which take precedence over the
- * built-in defaults.
- */
-export interface LitPluginOptions {
-    /**
-     * HMR for Lit components and its on-page feedback. `true`/`false` toggles
-     * the whole feature (patching and indicator); an object configures it.
-     * Defaults to enabled.
-     */
-    hmr?: boolean | HmrOptions;
-    /**
-     * Dev-only click-to-open-in-IDE inspector for Lit custom elements.
-     * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.
-     */
-    sourceOverlay?: boolean | SourceOverlayOptions;
-    /**
-     * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream
-     * for Lit lifecycle, render, mouse, and keyboard events.
-     *
-     * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`
-     * Vite plugin (`DevTools()`) to be active. Defaults to `false` while
-     * experimental.
-     *
-     * `true` enables all built-in layers with defaults.
-     */
-    timeline?: boolean;
-    /**
-     * What a `?css-sheet` import compiles to under `vite build`.
-     * - `'url'`:        fetch-backed sheet over the emitted `.css` asset
-     * - `'inline'`:     css text embedded in the JS chunk, processed by the css
-     *                   pipeline (`?inline`)
-     * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
-     *                   (`?raw`)
-     * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise
-     *
-     * Dev is always the fetch-backed HMR form regardless of this setting.
-     * Defaults to `'auto'`.
-     */
-    cssSheetBuild?: CssSheetBuild;
-}
-/** Plugin options after merging explicit options, env vars, and defaults. */
-export interface ResolvedOptions {
-    hmrEnabled: boolean;
-    reconnect: boolean;
-    onIncompatible: 'reload' | 'warn';
-    indicator: false | {
-        count: boolean;
-    };
-    sourceOverlay: false | SourceOverlayOptions;
-    timeline: boolean;
-    cssSheetBuild: CssSheetBuild;
-}
-/**
- * Merge explicit options over env vars over defaults (in that precedence) into
- * the flat shape the plugin hooks consume.
- */
-export declare const resolveOptions: (options: LitPluginOptions, env: Record<string, string>) => ResolvedOptions;
-export declare const createOpenInEditorMiddleware: (allowedRoots: readonly string[]) => (req: {
-    url?: string;
-    method?: string;
-    headers?: TrustHeaders;
-}, res: {
-    statusCode: number;
-    end: (msg: string) => void;
-}, next: (err?: unknown) => void) => void;
-/**
- * Import-query support, served in dev and build alike (source code using
- * `?hmr-url`/`?css-sheet` must keep working under `vite build`, where the HMR
- * plugin doesn't apply). Exported for the baseline e2e run, which needs the
- * queries working without the HMR plugin.
- *
- * `getCssSheetBuild` 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. Standalone (no getter) it behaves like the `'auto'`
- * default.
- */
-export declare const litCssQueries: (getCssSheetBuild?: () => CssSheetBuild) => Plugin;
-/**
- * The public timeline API virtual module, served in dev and build alike:
- * app code importing it must keep building under `vite build`, where the HMR
- * plugin doesn't apply. While these hooks lived on that serve-only plugin,
- * nothing claimed the specifier during a build and the bundler failed to
- * resolve it.
- *
- * `getTimeline` is a getter, not a value: `litPlugin()` re-resolves its
- * options against the loaded env in a `config` hook, which runs after the
- * plugin array is built.
- */
-export declare const litTimelineVirtual: (getTimeline?: () => boolean) => Plugin;
+import { type LitPluginOptions } from './options.js';
+export { createOpenInEditorMiddleware } from './plugins/open-in-editor.js';
+export { litCssQueries } from './plugins/css-queries.js';
+export { litTimelineVirtual } from './plugins/timeline-virtual.js';
+export type { HmrIndicatorOptions, HmrOptions, CssSheetBuild, LitPluginOptions, ResolvedOptions, } from './options.js';
+export { resolveOptions } from './options.js';
 /**
  * Vite plugin set providing HMR, CSS helpers, and Lightning CSS processing
  * for Lit projects.

package/lib/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/lib/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAA2B,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AAE3D,OAAO,EAAmB,KAAK,YAAY,EAAC,MAAM,WAAW,CAAC;AAG9D,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,YAAY,CAAC;AAMrD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AASrE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAE/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,KAAK,GAAG;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC;IACpC,aAAa,EAAE,KAAK,GAAG,oBAAoB,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAuCD;;;GAGG;AACH,eAAO,MAAM,cAAc,YAChB,gBAAgB,OACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1B,eA4DF,CAAC;AAiDF,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;AAoCF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,sBACN,MAAM,aAAa,KACpC,MAwFF,CAAC;AAQF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,iBAChB,MAAM,OAAO,KACzB,MA6BF,CAAC;AAuFF;;;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"}