@oddsquad/vite-plugin-lit 0.2.3 → 0.4.0

package/lib/wrap-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-table.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/lib/wrap-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAQD,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAehE,CAAC"}
+{"version":3,"file":"wrap-table.d.ts","sourceRoot":"","sources":["../src/lib/wrap-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAQD,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAehE,CAAC"}

package/lib/wrap-table.js

@@ -3,22 +3,24 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: BSD-3-Clause
  */
-const tags = (...names) => names.map((exportName) => ({ exportName, ns: exportName }));
-const staticTags = (...names) => names.map((exportName) => ({ exportName, ns: `static-${exportName}` }));
+const tags = (...names) =>
+  names.map((exportName) => ({exportName, ns: exportName}));
+const staticTags = (...names) =>
+  names.map((exportName) => ({exportName, ns: `static-${exportName}`}));
 export const WRAP_TABLE = new Map([
-    ['lit', tags('html', 'svg', 'mathml', 'css')],
-    ['lit/html.js', tags('html', 'svg', 'mathml')],
-    ['lit/static-html.js', staticTags('html', 'svg', 'mathml')],
-    ['lit-html', tags('html', 'svg', 'mathml')],
-    ['lit-html/static.js', staticTags('html', 'svg', 'mathml')],
-    ['lit-element', tags('html', 'svg', 'mathml', 'css')],
-    ['lit-element/lit-element.js', tags('html', 'svg', 'mathml', 'css')],
-    ['@lit/reactive-element', tags('css')],
-    ['@lit/reactive-element/css-tag.js', tags('css')],
-    // The signals tags wrap the user's values but pass the strings array
-    // straight through to lit-html's core tags, so they intern in the same
-    // namespaces as plain html/svg (content-equal templates share a cache
-    // entry either way).
-    ['@lit-labs/signals', tags('html', 'svg')],
+  ['lit', tags('html', 'svg', 'mathml', 'css')],
+  ['lit/html.js', tags('html', 'svg', 'mathml')],
+  ['lit/static-html.js', staticTags('html', 'svg', 'mathml')],
+  ['lit-html', tags('html', 'svg', 'mathml')],
+  ['lit-html/static.js', staticTags('html', 'svg', 'mathml')],
+  ['lit-element', tags('html', 'svg', 'mathml', 'css')],
+  ['lit-element/lit-element.js', tags('html', 'svg', 'mathml', 'css')],
+  ['@lit/reactive-element', tags('css')],
+  ['@lit/reactive-element/css-tag.js', tags('css')],
+  // The signals tags wrap the user's values but pass the strings array
+  // straight through to lit-html's core tags, so they intern in the same
+  // namespaces as plain html/svg (content-equal templates share a cache
+  // entry either way).
+  ['@lit-labs/signals', tags('html', 'svg')],
 ]);
-//# sourceMappingURL=wrap-table.js.map
+//# sourceMappingURL=wrap-table.js.map

package/lib/wrap-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-table.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/lib/wrap-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,MAAM,IAAI,GAAG,CAAC,GAAG,KAAsC,EAAgB,EAAE,CACvE,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,UAAU,EAAE,EAAE,EAAE,UAAU,EAAC,CAAC,CAAC,CAAC;AAE5D,MAAM,UAAU,GAAG,CAAC,GAAG,KAAsC,EAAgB,EAAE,CAC7E,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,UAAU,EAAE,EAAE,EAAE,UAAU,UAAU,EAAE,EAAC,CAAC,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,UAAU,GAA+C,IAAI,GAAG,CAAC;IAC5E,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC,oBAAoB,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC,oBAAoB,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,4BAA4B,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,kCAAkC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,qBAAqB;IACrB,CAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC3C,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The exact wrap surface: which template-tag exports of which lit-family\n * module specifiers get interned, and in which namespace.\n *\n * Namespaces are per tag *type*, not per module — `html` from `'lit'` and\n * from `'lit-html'` feed the same lit-html template cache, so they must\n * share canonical arrays. But content-equal `html` and `svg` templates must\n * never share one (a shared Template would parse SVG as HTML), and the\n * static-html tags pass zero-statics calls straight through to lit-html, so\n * they get their own namespaces too.\n *\n * Specifiers must be valid export-map subpaths (e.g. `lit/index.js` and\n * `lit-html/lit-html.js` are not, and are deliberately absent).\n */\n\nexport interface WrappedTag {\n  readonly exportName: 'html' | 'svg' | 'mathml' | 'css';\n  readonly ns: string;\n}\n\nconst tags = (...names: Array<WrappedTag['exportName']>): WrappedTag[] =>\n  names.map((exportName) => ({exportName, ns: exportName}));\n\nconst staticTags = (...names: Array<WrappedTag['exportName']>): WrappedTag[] =>\n  names.map((exportName) => ({exportName, ns: `static-${exportName}`}));\n\nexport const WRAP_TABLE: ReadonlyMap<string, readonly WrappedTag[]> = new Map([\n  ['lit', tags('html', 'svg', 'mathml', 'css')],\n  ['lit/html.js', tags('html', 'svg', 'mathml')],\n  ['lit/static-html.js', staticTags('html', 'svg', 'mathml')],\n  ['lit-html', tags('html', 'svg', 'mathml')],\n  ['lit-html/static.js', staticTags('html', 'svg', 'mathml')],\n  ['lit-element', tags('html', 'svg', 'mathml', 'css')],\n  ['lit-element/lit-element.js', tags('html', 'svg', 'mathml', 'css')],\n  ['@lit/reactive-element', tags('css')],\n  ['@lit/reactive-element/css-tag.js', tags('css')],\n  // The signals tags wrap the user's values but pass the strings array\n  // straight through to lit-html's core tags, so they intern in the same\n  // namespaces as plain html/svg (content-equal templates share a cache\n  // entry either way).\n  ['@lit-labs/signals', tags('html', 'svg')],\n]);\n"]}
+{"version":3,"file":"wrap-table.js","sourceRoot":"","sources":["../src/lib/wrap-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,MAAM,IAAI,GAAG,CAAC,GAAG,KAAsC,EAAgB,EAAE,CACvE,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,UAAU,EAAE,EAAE,EAAE,UAAU,EAAC,CAAC,CAAC,CAAC;AAE5D,MAAM,UAAU,GAAG,CAAC,GAAG,KAAsC,EAAgB,EAAE,CAC7E,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,UAAU,EAAE,EAAE,EAAE,UAAU,UAAU,EAAE,EAAC,CAAC,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,UAAU,GAA+C,IAAI,GAAG,CAAC;IAC5E,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC,oBAAoB,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC,oBAAoB,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,4BAA4B,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,kCAAkC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,qBAAqB;IACrB,CAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC3C,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The exact wrap surface: which template-tag exports of which lit-family\n * module specifiers get interned, and in which namespace.\n *\n * Namespaces are per tag *type*, not per module — `html` from `'lit'` and\n * from `'lit-html'` feed the same lit-html template cache, so they must\n * share canonical arrays. But content-equal `html` and `svg` templates must\n * never share one (a shared Template would parse SVG as HTML), and the\n * static-html tags pass zero-statics calls straight through to lit-html, so\n * they get their own namespaces too.\n *\n * Specifiers must be valid export-map subpaths (e.g. `lit/index.js` and\n * `lit-html/lit-html.js` are not, and are deliberately absent).\n */\n\nexport interface WrappedTag {\n  readonly exportName: 'html' | 'svg' | 'mathml' | 'css';\n  readonly ns: string;\n}\n\nconst tags = (...names: Array<WrappedTag['exportName']>): WrappedTag[] =>\n  names.map((exportName) => ({exportName, ns: exportName}));\n\nconst staticTags = (...names: Array<WrappedTag['exportName']>): WrappedTag[] =>\n  names.map((exportName) => ({exportName, ns: `static-${exportName}`}));\n\nexport const WRAP_TABLE: ReadonlyMap<string, readonly WrappedTag[]> = new Map([\n  ['lit', tags('html', 'svg', 'mathml', 'css')],\n  ['lit/html.js', tags('html', 'svg', 'mathml')],\n  ['lit/static-html.js', staticTags('html', 'svg', 'mathml')],\n  ['lit-html', tags('html', 'svg', 'mathml')],\n  ['lit-html/static.js', staticTags('html', 'svg', 'mathml')],\n  ['lit-element', tags('html', 'svg', 'mathml', 'css')],\n  ['lit-element/lit-element.js', tags('html', 'svg', 'mathml', 'css')],\n  ['@lit/reactive-element', tags('css')],\n  ['@lit/reactive-element/css-tag.js', tags('css')],\n  // The signals tags wrap the user's values but pass the strings array\n  // straight through to lit-html's core tags, so they intern in the same\n  // namespaces as plain html/svg (content-equal templates share a cache\n  // entry either way).\n  ['@lit-labs/signals', tags('html', 'svg')],\n]);\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddsquad/vite-plugin-lit",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "description": "Vite plugin providing true HMR for Lit components, plus CSS helpers and a DevTools panel",
   "license": "BSD-3-Clause",
   "author": "Oddsquad (based on @lit-labs/vite-hmr by Google LLC)",
@@ -8,11 +8,17 @@
   "main": "index.js",
   "module": "index.js",
   "files": [
+    "/CHANGELOG.md",
     "/lib/",
+    "/dist/client/",
     "/types/",
-    "/panel/",
-    "/index.{d.ts,d.ts.map,js,js.map}"
+    "/index.{d.ts,d.ts.map,js,js.map}",
+    "/client.d.ts",
+    "/bin.mjs"
   ],
+  "bin": {
+    "lit-devtools": "./bin.mjs"
+  },
   "exports": {
     ".": {
       "types": "./index.d.ts",
@@ -21,34 +27,95 @@
     "./css.js": {
       "types": "./lib/runtime/css.d.ts",
       "default": "./lib/runtime/css.js"
+    },
+    "./client": {
+      "types": "./client.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsc && node scripts/copy-panel-html.mjs",
-    "prepublishOnly": "npm run build"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oddcelot/vite-plugin-lit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/oddcelot/vite-plugin-lit/issues"
   },
   "dependencies": {
-    "es-module-lexer": "^1.5.4",
-    "launch-editor": "^2.10.0",
-    "magic-string": "^0.30.11"
+    "devframe": "1.0.0",
+    "es-module-lexer": "^3.0.2",
+    "launch-editor": "^2.14.1",
+    "magic-string": "^1.4.1"
   },
   "peerDependencies": {
+    "@devframes/agentic": "1.0.0",
+    "@vitejs/devtools-kit": "^0.7.5",
+    "cac": "^7.0.0",
     "lightningcss": "^1.30.0",
     "lit": "^3.0.0",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
+    "@devframes/agentic": {
+      "optional": true
+    },
+    "@vitejs/devtools-kit": {
+      "optional": true
+    },
+    "cac": {
+      "optional": true
+    },
     "lightningcss": {
       "optional": true
     }
   },
   "devDependencies": {
-    "typescript": "^5.7.0"
+    "@devframes/agentic": "1.0.0",
+    "@devframes/service-open": "1.0.0",
+    "@lit-labs/signals": "^0.3.0",
+    "@lit-labs/virtualizer": "^2.1.1",
+    "@lit/context": "^1.1.6",
+    "@lit/task": "^1.0.3",
+    "@types/node": "^26.6.1",
+    "@vitejs/devtools-kit": "0.7.5",
+    "cac": "7.0.0",
+    "git-cliff": "^2.13.1",
+    "lightningcss": "^1.33.0",
+    "lit": "^3.3.3",
+    "playwright-core": "^1.63.0",
+    "typescript": "^7.0.2",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.2",
+    "vite-plus": "0.3.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": ">=26"
+    },
+    "packageManager": {
+      "name": "pnpm",
+      "version": ">=12"
+    }
   },
   "publishConfig": {
     "access": "public"
   },
-  "engines": {
-    "node": ">=20"
+  "scripts": {
+    "build": "tsc --pretty && pnpm run build:panel && node scripts/format-build-output.mjs",
+    "build:lit-canary": "node scripts/build-lit-canary.mjs",
+    "dev": "pnpm run build && vp dev playground",
+    "test": "pnpm run test:unit && pnpm run test:e2e",
+    "test:unit": "node scripts/check-client-types.mjs && vp test run --project unit",
+    "test:e2e": "pnpm run build && vp test run --project e2e",
+    "changelog": "git-cliff --unreleased",
+    "bench": "node bench/run.mjs",
+    "bench:serve": "node bench/run.mjs --serve",
+    "docs:dev": "pnpm --filter ./docs dev",
+    "docs:build": "pnpm --filter ./docs build",
+    "docs:shots": "pnpm run build && node scripts/docs-shots.mjs",
+    "format": "vp fmt \"**/*.{cjs,html,js,json,md,mdx,ts,yaml}\"",
+    "format:check": "vp fmt \"**/*.{cjs,html,js,json,md,mdx,ts,yaml}\" --check",
+    "build:panel": "vp build src/panel"
   }
-}
+}

package/types/hmr-incompatibility.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared types and channel constant for HMR-incompatibility reporting.
+ *
+ * When the browser runtime can't hot-patch a component in place it logs one
+ * line to the console and, by default, full-reloads the page — which clears
+ * the console before anyone reads it. These types carry the same reason, in
+ * structured form, from the page runtime to the node side over the HMR
+ * {@link HMR_INCOMPATIBLE_CHANNEL}, where it is cached so the DevTools panel
+ * and an agent-facing query RPC can both read it back after the reload.
+ *
+ * The three reasons mirror the "Cannot be patched in place" cases documented
+ * in `docs/src/content/docs/reference/limitations.mdx`; adding a fourth means
+ * extending {@link HmrIncompatibilityReason} and {@link describeHmrReason}
+ * together, plus the docs page.
+ */
+/** Why a component couldn't be hot-patched in place, or a related silent case. */
+export type HmrIncompatibilityReason = {
+    code: 'accessor-decorators';
+} | {
+    code: 'patch-failed';
+    detail: string;
+} | {
+    code: 'observed-attributes-changed';
+};
+/**
+ * One HMR-incompatibility notice from the page runtime. `action` reflects
+ * what actually happened for *this* event, not just the configured default:
+ * 'reload' / 'warn' come from `hmr.onIncompatible`; 'none' is the
+ * `observed-attributes-changed` case, which never reloads regardless of that
+ * setting (the patch already succeeded).
+ */
+export interface HmrIncompatibilityEvent {
+    tagName: string;
+    /** `Date.now()` in the browser — there is no shared clock with the timeline's `performance.now()`. */
+    time: number;
+    reason: HmrIncompatibilityReason;
+    action: 'reload' | 'warn' | 'none';
+}
+/** HMR channel the page runtime uses to report an {@link HmrIncompatibilityEvent}. */
+export declare const HMR_INCOMPATIBLE_CHANNEL = "lit:hmr:incompatible";
+/**
+ * How many events the node-side cache keeps, and the panel mirrors. A dev
+ * session with many failing edits must not grow either without bound; the
+ * newest are the ones worth keeping.
+ */
+export declare const MAX_HMR_INCOMPATIBILITIES = 50;
+/**
+ * Human-readable text for a reason, shared by the browser console message in
+ * `src/lib/runtime/patch.ts` and the DevTools panel's banner so the two can't
+ * drift apart. The wording of the first two cases is asserted verbatim by
+ * `src/test/unit/patch_test.ts` — it is part of the console output contract.
+ */
+export declare const describeHmrReason: (reason: HmrIncompatibilityReason) => string;
+//# sourceMappingURL=hmr-incompatibility.d.ts.map

package/types/hmr-incompatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-incompatibility.d.ts","sourceRoot":"","sources":["../src/types/hmr-incompatibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,kFAAkF;AAClF,MAAM,MAAM,wBAAwB,GAChC;IAAC,IAAI,EAAE,qBAAqB,CAAA;CAAC,GAC7B;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GACtC;IAAC,IAAI,EAAE,6BAA6B,CAAA;CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,sGAAsG;IACtG,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,WAAY,wBAAwB,KAAG,MASpE,CAAC"}

package/types/hmr-incompatibility.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/** HMR channel the page runtime uses to report an {@link HmrIncompatibilityEvent}. */
+export const HMR_INCOMPATIBLE_CHANNEL = 'lit:hmr:incompatible';
+/**
+ * How many events the node-side cache keeps, and the panel mirrors. A dev
+ * session with many failing edits must not grow either without bound; the
+ * newest are the ones worth keeping.
+ */
+export const MAX_HMR_INCOMPATIBILITIES = 50;
+/**
+ * Human-readable text for a reason, shared by the browser console message in
+ * `src/lib/runtime/patch.ts` and the DevTools panel's banner so the two can't
+ * drift apart. The wording of the first two cases is asserted verbatim by
+ * `src/test/unit/patch_test.ts` — it is part of the console output contract.
+ */
+export const describeHmrReason = (reason) => {
+    switch (reason.code) {
+        case 'accessor-decorators':
+            return 'standard accessor decorators';
+        case 'patch-failed':
+            return `patching failed: ${reason.detail}`;
+        case 'observed-attributes-changed':
+            return "observedAttributes changed; the platform registry can't pick this up";
+    }
+};
+//# sourceMappingURL=hmr-incompatibility.js.map

package/types/hmr-incompatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-incompatibility.js","sourceRoot":"","sources":["../src/types/hmr-incompatibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuCH,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAgC,EAAU,EAAE;IAC5E,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,qBAAqB;YACxB,OAAO,8BAA8B,CAAC;QACxC,KAAK,cAAc;YACjB,OAAO,oBAAoB,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7C,KAAK,6BAA6B;YAChC,OAAO,sEAAsE,CAAC;IAClF,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared types and channel constant for HMR-incompatibility reporting.\n *\n * When the browser runtime can't hot-patch a component in place it logs one\n * line to the console and, by default, full-reloads the page — which clears\n * the console before anyone reads it. These types carry the same reason, in\n * structured form, from the page runtime to the node side over the HMR\n * {@link HMR_INCOMPATIBLE_CHANNEL}, where it is cached so the DevTools panel\n * and an agent-facing query RPC can both read it back after the reload.\n *\n * The three reasons mirror the \"Cannot be patched in place\" cases documented\n * in `docs/src/content/docs/reference/limitations.mdx`; adding a fourth means\n * extending {@link HmrIncompatibilityReason} and {@link describeHmrReason}\n * together, plus the docs page.\n */\n\n/** Why a component couldn't be hot-patched in place, or a related silent case. */\nexport type HmrIncompatibilityReason =\n  | {code: 'accessor-decorators'}\n  | {code: 'patch-failed'; detail: string}\n  | {code: 'observed-attributes-changed'};\n\n/**\n * One HMR-incompatibility notice from the page runtime. `action` reflects\n * what actually happened for *this* event, not just the configured default:\n * 'reload' / 'warn' come from `hmr.onIncompatible`; 'none' is the\n * `observed-attributes-changed` case, which never reloads regardless of that\n * setting (the patch already succeeded).\n */\nexport interface HmrIncompatibilityEvent {\n  tagName: string;\n  /** `Date.now()` in the browser — there is no shared clock with the timeline's `performance.now()`. */\n  time: number;\n  reason: HmrIncompatibilityReason;\n  action: 'reload' | 'warn' | 'none';\n}\n\n/** HMR channel the page runtime uses to report an {@link HmrIncompatibilityEvent}. */\nexport const HMR_INCOMPATIBLE_CHANNEL = 'lit:hmr:incompatible';\n\n/**\n * How many events the node-side cache keeps, and the panel mirrors. A dev\n * session with many failing edits must not grow either without bound; the\n * newest are the ones worth keeping.\n */\nexport const MAX_HMR_INCOMPATIBILITIES = 50;\n\n/**\n * Human-readable text for a reason, shared by the browser console message in\n * `src/lib/runtime/patch.ts` and the DevTools panel's banner so the two can't\n * drift apart. The wording of the first two cases is asserted verbatim by\n * `src/test/unit/patch_test.ts` — it is part of the console output contract.\n */\nexport const describeHmrReason = (reason: HmrIncompatibilityReason): string => {\n  switch (reason.code) {\n    case 'accessor-decorators':\n      return 'standard accessor decorators';\n    case 'patch-failed':\n      return `patching failed: ${reason.detail}`;\n    case 'observed-attributes-changed':\n      return \"observedAttributes changed; the platform registry can't pick this up\";\n  }\n};\n"]}

package/types/in-page.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * The direct page ↔ panel channel, for interactions that never need the node
+ * side.
+ *
+ * Everything else the Components tab does goes panel → node → page over RPC
+ * and Vite's HMR channel, and should keep going that way: the node side caches
+ * the tree and the last details so a panel that connects late has something to
+ * render, and so the MCP tools can answer without a panel open. None of that
+ * is true of the hover outline — it is pure page-local drawing, it is issued
+ * on every `mouseenter` in the tree, and nothing but the page itself ever
+ * wants to know about it.
+ *
+ * Devframe's in-page channel connects a page script to a panel iframe over a
+ * `MessageChannel` with no server in the path (same-origin, handshake by
+ * posting to the ancestor chain). Two consequences:
+ *
+ *  - The outline stops paying a full round trip through node on every pointer
+ *    move.
+ *  - It keeps working where there is no node side at all, which is what a
+ *    static snapshot of the panel needs to be more than a screenshot.
+ *
+ * The channel is best-effort by construction. A panel opened as its own tab
+ * has no ancestor page script to handshake with, so both sides must treat
+ * "not connected" as normal and fall back to the RPC path.
+ */
+/** Channel name, shared by both endpoints. */
+export declare const LIT_IN_PAGE_CHANNEL = "lit:in-page";
+/**
+ * Contract for {@link LIT_IN_PAGE_CHANNEL}.
+ *
+ * `highlight` is an event, not a query: the panel does not want an answer, and
+ * a fire-and-forget emit is what keeps a hover cheap. `id` is the same stable
+ * numeric element id used everywhere else (the timeline's `idOf()` WeakMap),
+ * so a tree node, a details payload, and an outline all agree on identity.
+ * `null` clears the outline.
+ */
+export interface LitInPageProtocol {
+    events: {
+        pageScript: {
+            highlight: (id: number | null) => void;
+        };
+    };
+}
+//# sourceMappingURL=in-page.d.ts.map

package/types/in-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page.d.ts","sourceRoot":"","sources":["../src/types/in-page.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,UAAU,EAAE;YACV,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;SACxC,CAAC;KACH,CAAC;CACH"}

package/types/in-page.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * The direct page ↔ panel channel, for interactions that never need the node
+ * side.
+ *
+ * Everything else the Components tab does goes panel → node → page over RPC
+ * and Vite's HMR channel, and should keep going that way: the node side caches
+ * the tree and the last details so a panel that connects late has something to
+ * render, and so the MCP tools can answer without a panel open. None of that
+ * is true of the hover outline — it is pure page-local drawing, it is issued
+ * on every `mouseenter` in the tree, and nothing but the page itself ever
+ * wants to know about it.
+ *
+ * Devframe's in-page channel connects a page script to a panel iframe over a
+ * `MessageChannel` with no server in the path (same-origin, handshake by
+ * posting to the ancestor chain). Two consequences:
+ *
+ *  - The outline stops paying a full round trip through node on every pointer
+ *    move.
+ *  - It keeps working where there is no node side at all, which is what a
+ *    static snapshot of the panel needs to be more than a screenshot.
+ *
+ * The channel is best-effort by construction. A panel opened as its own tab
+ * has no ancestor page script to handshake with, so both sides must treat
+ * "not connected" as normal and fall back to the RPC path.
+ */
+/** Channel name, shared by both endpoints. */
+export const LIT_IN_PAGE_CHANNEL = 'lit:in-page';
+//# sourceMappingURL=in-page.js.map

package/types/in-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page.js","sourceRoot":"","sources":["../src/types/in-page.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The direct page ↔ panel channel, for interactions that never need the node\n * side.\n *\n * Everything else the Components tab does goes panel → node → page over RPC\n * and Vite's HMR channel, and should keep going that way: the node side caches\n * the tree and the last details so a panel that connects late has something to\n * render, and so the MCP tools can answer without a panel open. None of that\n * is true of the hover outline — it is pure page-local drawing, it is issued\n * on every `mouseenter` in the tree, and nothing but the page itself ever\n * wants to know about it.\n *\n * Devframe's in-page channel connects a page script to a panel iframe over a\n * `MessageChannel` with no server in the path (same-origin, handshake by\n * posting to the ancestor chain). Two consequences:\n *\n *  - The outline stops paying a full round trip through node on every pointer\n *    move.\n *  - It keeps working where there is no node side at all, which is what a\n *    static snapshot of the panel needs to be more than a screenshot.\n *\n * The channel is best-effort by construction. A panel opened as its own tab\n * has no ancestor page script to handshake with, so both sides must treat\n * \"not connected\" as normal and fall back to the RPC path.\n */\n\n/** Channel name, shared by both endpoints. */\nexport const LIT_IN_PAGE_CHANNEL = 'lit:in-page';\n\n/**\n * Contract for {@link LIT_IN_PAGE_CHANNEL}.\n *\n * `highlight` is an event, not a query: the panel does not want an answer, and\n * a fire-and-forget emit is what keeps a hover cheap. `id` is the same stable\n * numeric element id used everywhere else (the timeline's `idOf()` WeakMap),\n * so a tree node, a details payload, and an outline all agree on identity.\n * `null` clears the outline.\n */\nexport interface LitInPageProtocol {\n  events: {\n    pageScript: {\n      highlight: (id: number | null) => void;\n    };\n  };\n}\n"]}

package/types/inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/inspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACjD,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,KAAK,EAAE;QACL,UAAU,EAAE,OAAO,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB;AAC1B,sEAAsE;AACpE;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,GACf;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,EAAE,CAAA;CAAC,GAC1C;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAC;AAC9C,sEAAsE;GACpE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC;AAC5B,uEAAuE;GACrE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC;AAE/B,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GACxB;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GACd;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC;AAC/B,uEAAuE;GACrE;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC;AACpC,wEAAwE;GACtE;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC;AACxC;;;;GAIG;GACD;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC;AACrC;;;;GAIG;GACD;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAEnB,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,6EAA6E;AAC7E,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAE5E,wEAAwE;AACxE,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,YAAY,CAAC"}
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/types/inspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACjD,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,KAAK,EAAE;QACL,UAAU,EAAE,OAAO,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;CACH;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB;AAC1B,sEAAsE;AACpE;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,GACf;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,EAAE,CAAA;CAAC,GAC1C;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAC;AAC9C,sEAAsE;GACpE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC;AAC5B,uEAAuE;GACrE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC;AAE/B,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GACxB;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GACd;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC;AAC/B,uEAAuE;GACrE;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC;AACpC,wEAAwE;GACtE;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAAC;AACxC;;;;GAIG;GACD;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC;AACrC;;;;GAIG;GACD;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAEnB,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,6EAA6E;AAC7E,eAAO,MAAM,8BAA8B,gCAAgC,CAAC;AAE5E,wEAAwE;AACxE,eAAO,MAAM,YAAY,4BAA4B,CAAC;AAEtD,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,YAAY,CAAC"}

package/types/inspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"inspector.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/inspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8FH,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAE5E,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAEtD,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared types and channel/path constants for the Components inspector.\n *\n * The inspector lets the DevTools panel show a hierarchical tree of the Lit\n * components on the page plus a detail view (reactive properties, internal\n * state, attributes, source) of a selected element. The panel can't touch the\n * page DOM directly (separate iframe document), so everything flows over the\n * existing transport: panel → server (POST {@link INSPECT_PATH}) → app runtime\n * (HMR {@link INSPECT_CMD_CHANNEL}); app → server (HMR\n * {@link INSPECT_DATA_CHANNEL}) → panel (SSE `event: {@link INSPECT_SSE_EVENT}`).\n *\n * Elements are referenced across the boundary by the stable numeric id from the\n * timeline's `idOf()` WeakMap, so a tree node, a details payload, and an\n * inspector pick all agree on identity.\n */\n\nexport interface ElementSource {\n  file: string;\n  line: number;\n}\n\n/** A node in the component render tree (one inspectable Lit element). */\nexport interface InspectorTreeNode {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  children: InspectorTreeNode[];\n}\n\n/** One reactive property (or internal `@state`) of an inspected element. */\nexport interface InspectorProp {\n  name: string;\n  /** Serialized, depth-limited preview of the current value. */\n  value: string;\n  /** A short type tag (`string`, `number`, `Array(3)`, `MyClass`, …). */\n  type: string;\n  /** The reflected attribute name, or `false` when `attribute: false`. */\n  attribute: string | false;\n  /** Whether the property reflects to its attribute. */\n  reflects: boolean;\n  /** Whether it's an internal `@state()` (no public attribute). */\n  state: boolean;\n}\n\n/** Full detail snapshot for a single inspected element. */\nexport interface InspectorDetails {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  attributes: Array<{name: string; value: string}>;\n  properties: InspectorProp[];\n  flags: {\n    hasUpdated: boolean;\n    isUpdatePending: boolean;\n    hasShadowRoot: boolean;\n  };\n}\n\n/** App runtime → panel messages, carried on SSE `event: inspect`. */\nexport type InspectorMessage =\n  /** The runtime came online; the panel should (re)request the tree. */\n  | {type: 'ready'}\n  | {type: 'tree'; roots: InspectorTreeNode[]}\n  | {type: 'details'; details: InspectorDetails}\n  /** The requested element id couldn't be resolved (removed / GC'd). */\n  | {type: 'gone'; id: number}\n  /** An inspect-mode overlay pick — select this element in the panel. */\n  | {type: 'pick'; id: number};\n\n/** Panel → app runtime commands, POSTed to {@link INSPECT_PATH}. */\nexport type InspectorCommand =\n  | {type: 'tree'}\n  | {type: 'details'; id: number}\n  /** Keep pushing fresh details for `id` as it updates; `null` stops. */\n  | {type: 'watch'; id: number | null}\n  /** Outline element `id` in the page on tree hover; `null` clears it. */\n  | {type: 'highlight'; id: number | null}\n  /**\n   * Opt-in live tree: when enabled, the runtime watches the DOM and pushes a\n   * fresh `tree` message whenever the component hierarchy changes. Off by\n   * default (the panel otherwise refreshes on demand / on pick).\n   */\n  | {type: 'observe'; enabled: boolean}\n  /**\n   * Start the overlay's inspect-mode picker (the panel's \"Pick\" button). Handled\n   * by the server (it broadcasts {@link INSPECT_OVERLAY_TOGGLE_CHANNEL}), not the\n   * app runtime, so it never reaches the runtime's command handler.\n   */\n  | {type: 'pick'};\n\n/** HMR channel the server uses to forward a panel command to the app runtime. */\nexport const INSPECT_CMD_CHANNEL = 'lit:inspect:cmd';\n\n/** HMR channel the app runtime uses to push an {@link InspectorMessage}. */\nexport const INSPECT_DATA_CHANNEL = 'lit:inspect:data';\n\n/** Vite HMR channel the DevTools \"inspect element\" command broadcasts on. */\nexport const INSPECT_OVERLAY_TOGGLE_CHANNEL = 'lit-devtools:toggle-inspect';\n\n/** POST endpoint the panel uses to send an {@link InspectorCommand}. */\nexport const INSPECT_PATH = '/__lit-devtools-inspect';\n\n/** Named SSE event the server relays {@link InspectorMessage}s to the panel on. */\nexport const INSPECT_SSE_EVENT = 'inspect';\n"]}
+{"version":3,"file":"inspector.js","sourceRoot":"","sources":["../src/types/inspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8FH,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAE5E,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAEtD,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared types and channel/path constants for the Components inspector.\n *\n * The inspector lets the DevTools panel show a hierarchical tree of the Lit\n * components on the page plus a detail view (reactive properties, internal\n * state, attributes, source) of a selected element. The panel can't touch the\n * page DOM directly (separate iframe document), so everything flows over the\n * existing transport: panel → server (POST {@link INSPECT_PATH}) → app runtime\n * (HMR {@link INSPECT_CMD_CHANNEL}); app → server (HMR\n * {@link INSPECT_DATA_CHANNEL}) → panel (SSE `event: {@link INSPECT_SSE_EVENT}`).\n *\n * Elements are referenced across the boundary by the stable numeric id from the\n * timeline's `idOf()` WeakMap, so a tree node, a details payload, and an\n * inspector pick all agree on identity.\n */\n\nexport interface ElementSource {\n  file: string;\n  line: number;\n}\n\n/** A node in the component render tree (one inspectable Lit element). */\nexport interface InspectorTreeNode {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  children: InspectorTreeNode[];\n}\n\n/** One reactive property (or internal `@state`) of an inspected element. */\nexport interface InspectorProp {\n  name: string;\n  /** Serialized, depth-limited preview of the current value. */\n  value: string;\n  /** A short type tag (`string`, `number`, `Array(3)`, `MyClass`, …). */\n  type: string;\n  /** The reflected attribute name, or `false` when `attribute: false`. */\n  attribute: string | false;\n  /** Whether the property reflects to its attribute. */\n  reflects: boolean;\n  /** Whether it's an internal `@state()` (no public attribute). */\n  state: boolean;\n}\n\n/** Full detail snapshot for a single inspected element. */\nexport interface InspectorDetails {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  attributes: Array<{name: string; value: string}>;\n  properties: InspectorProp[];\n  flags: {\n    hasUpdated: boolean;\n    isUpdatePending: boolean;\n    hasShadowRoot: boolean;\n  };\n}\n\n/** App runtime → panel messages, carried on SSE `event: inspect`. */\nexport type InspectorMessage =\n  /** The runtime came online; the panel should (re)request the tree. */\n  | {type: 'ready'}\n  | {type: 'tree'; roots: InspectorTreeNode[]}\n  | {type: 'details'; details: InspectorDetails}\n  /** The requested element id couldn't be resolved (removed / GC'd). */\n  | {type: 'gone'; id: number}\n  /** An inspect-mode overlay pick — select this element in the panel. */\n  | {type: 'pick'; id: number};\n\n/** Panel → app runtime commands, POSTed to {@link INSPECT_PATH}. */\nexport type InspectorCommand =\n  | {type: 'tree'}\n  | {type: 'details'; id: number}\n  /** Keep pushing fresh details for `id` as it updates; `null` stops. */\n  | {type: 'watch'; id: number | null}\n  /** Outline element `id` in the page on tree hover; `null` clears it. */\n  | {type: 'highlight'; id: number | null}\n  /**\n   * Opt-in live tree: when enabled, the runtime watches the DOM and pushes a\n   * fresh `tree` message whenever the component hierarchy changes. Off by\n   * default (the panel otherwise refreshes on demand / on pick).\n   */\n  | {type: 'observe'; enabled: boolean}\n  /**\n   * Start the overlay's inspect-mode picker (the panel's \"Pick\" button). Handled\n   * by the server (it broadcasts {@link INSPECT_OVERLAY_TOGGLE_CHANNEL}), not the\n   * app runtime, so it never reaches the runtime's command handler.\n   */\n  | {type: 'pick'};\n\n/** HMR channel the server uses to forward a panel command to the app runtime. */\nexport const INSPECT_CMD_CHANNEL = 'lit:inspect:cmd';\n\n/** HMR channel the app runtime uses to push an {@link InspectorMessage}. */\nexport const INSPECT_DATA_CHANNEL = 'lit:inspect:data';\n\n/** Vite HMR channel the DevTools \"inspect element\" command broadcasts on. */\nexport const INSPECT_OVERLAY_TOGGLE_CHANNEL = 'lit-devtools:toggle-inspect';\n\n/** POST endpoint the panel uses to send an {@link InspectorCommand}. */\nexport const INSPECT_PATH = '/__lit-devtools-inspect';\n\n/** Named SSE event the server relays {@link InspectorMessage}s to the panel on. */\nexport const INSPECT_SSE_EVENT = 'inspect';\n"]}

package/types/snapshot.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * A recorded DevTools session, frozen so someone else can open it.
+ *
+ * The point is not "a static copy of the panel". It is a bug report a
+ * maintainer can actually act on: the timeline of what happened, the component
+ * tree as it stood, the details of the components that were inspected, and any
+ * HMR incompatibilities that fired — opened in a browser with no checkout of
+ * the reporter's app and no reproduction steps.
+ *
+ * Everything here is already in the node side's hands during a live session
+ * (see `lib/devframe/definition.ts`, which caches exactly these four things),
+ * which is why capture needs no new transport: the dev server exports its own
+ * state.
+ */
+import type { HmrIncompatibilityEvent } from './hmr-incompatibility.js';
+import type { InspectorDetails, InspectorTreeNode } from './inspector.js';
+import type { TimelineEvent, TimelineLayer } from './timeline.js';
+/** Everything a frozen panel needs to render a past session. */
+export interface SessionSnapshot {
+    /** ISO timestamp of the export, shown by the frozen panel. */
+    capturedAt: string;
+    /** Plugin version the session was recorded on. */
+    version: string;
+    /** Custom layers registered by the app, so recorded events keep their labels. */
+    customLayers: TimelineLayer[];
+    /** The component tree as it stood at export time. */
+    roots: InspectorTreeNode[];
+    /**
+     * Details for every component whose details were fetched during the
+     * session. Only these ids can be baked — details are collected from live
+     * DOM, so a component nobody opened has none to freeze.
+     */
+    details: InspectorDetails[];
+    /** The recorded timeline, up to the node side's ring-buffer cap. */
+    events: TimelineEvent[];
+    /** HMR incompatibilities reported during the session. */
+    hmrIncompatibilities: HmrIncompatibilityEvent[];
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/types/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/types/snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAEhE,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,qDAAqD;IACrD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B;;;;OAIG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,oEAAoE;IACpE,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yDAAyD;IACzD,oBAAoB,EAAE,uBAAuB,EAAE,CAAC;CACjD"}

package/types/snapshot.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export {};
+//# sourceMappingURL=snapshot.js.map

package/types/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/types/snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * A recorded DevTools session, frozen so someone else can open it.\n *\n * The point is not \"a static copy of the panel\". It is a bug report a\n * maintainer can actually act on: the timeline of what happened, the component\n * tree as it stood, the details of the components that were inspected, and any\n * HMR incompatibilities that fired — opened in a browser with no checkout of\n * the reporter's app and no reproduction steps.\n *\n * Everything here is already in the node side's hands during a live session\n * (see `lib/devframe/definition.ts`, which caches exactly these four things),\n * which is why capture needs no new transport: the dev server exports its own\n * state.\n */\n\nimport type {HmrIncompatibilityEvent} from './hmr-incompatibility.js';\nimport type {InspectorDetails, InspectorTreeNode} from './inspector.js';\nimport type {TimelineEvent, TimelineLayer} from './timeline.js';\n\n/** Everything a frozen panel needs to render a past session. */\nexport interface SessionSnapshot {\n  /** ISO timestamp of the export, shown by the frozen panel. */\n  capturedAt: string;\n  /** Plugin version the session was recorded on. */\n  version: string;\n  /** Custom layers registered by the app, so recorded events keep their labels. */\n  customLayers: TimelineLayer[];\n  /** The component tree as it stood at export time. */\n  roots: InspectorTreeNode[];\n  /**\n   * Details for every component whose details were fetched during the\n   * session. Only these ids can be baked — details are collected from live\n   * DOM, so a component nobody opened has none to freeze.\n   */\n  details: InspectorDetails[];\n  /** The recorded timeline, up to the node side's ring-buffer cap. */\n  events: TimelineEvent[];\n  /** HMR incompatibilities reported during the session. */\n  hmrIncompatibilities: HmrIncompatibilityEvent[];\n}\n"]}

package/types/timeline.d.ts

@@ -10,7 +10,11 @@ export interface TimelineLayer {
 }
 export interface TimelineEvent<TData = unknown> {
     layerId: string;
-    /** `performance.now()` timestamp in the browser. */
+    /**
+     * Milliseconds since recording started, stamped in the browser page
+     * (`performance.now()` re-zeroed on each recording start; see
+     * `runtime/timeline/clock.ts`). Not comparable to any Node-side clock.
+     */
     time: number;
     data: TData;
     title?: string;
@@ -31,6 +35,13 @@ export interface TimelineLayersState {
     recordingState: boolean;
     litLifecycleEnabled: boolean;
     litRenderEnabled: boolean;
+    /**
+     * Per-part `lit-debug` events (`template updating`, `set part`, `commit
+     * *`, …) — one per binding on *every* render, so a ticking clock or
+     * animation floods the layer. Off by default; the `lit-render` layer's
+     * begin/end render pair already covers the common case.
+     */
+    litRenderVerboseEnabled: boolean;
     mouseEventEnabled: boolean;
     keyboardEventEnabled: boolean;
 }
@@ -77,6 +88,17 @@ export interface SettingsOverride {
     hmrIndicatorCount?: boolean;
     /** Built-in editor key for the source overlay's open-in-editor target. */
     sourceOverlayEditor?: string;
+    /**
+     * Flash a short outline over every Lit element that completes an update.
+     * Pure preference (no config-time baseline), so `undefined` reads as off.
+     */
+    flashUpdates?: boolean;
+    /**
+     * Colour the flash by how often the element updated in the last second,
+     * calm to hot, instead of one flat colour. Only meaningful with
+     * {@link SettingsOverride.flashUpdates}.
+     */
+    flashUpdatesRamp?: boolean;
 }
 /**
  * Built-in editors the source overlay can open files in. Keep in sync with

package/types/timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAKnD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAMlC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;QAClC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,oEAAoE;QACpE,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,6BAA6B,uCACJ,CAAC"}
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAMnD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAOlC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;QAClC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,oEAAoE;QACpE,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,6BAA6B,uCACJ,CAAC"}

package/types/timeline.js

@@ -6,6 +6,7 @@
 export const TIMELINE_LAYERS = [
     { id: 'lit-lifecycle', label: 'Lit Lifecycle', color: 0x4d63ff },
     { id: 'lit-render', label: 'Lit Render', color: 0x325cff },
+    { id: 'lit-render-verbose', label: 'Lit Render (verbose)', color: 0x99aeff },
     { id: 'mouse', label: 'Mouse', color: 0xa451af },
     { id: 'keyboard', label: 'Keyboard', color: 0x8151af },
 ];
@@ -13,6 +14,7 @@ export const DEFAULT_LAYERS_STATE = {
     recordingState: false,
     litLifecycleEnabled: true,
     litRenderEnabled: true,
+    litRenderVerboseEnabled: false,
     mouseEventEnabled: false,
     keyboardEventEnabled: false,
 };

package/types/timeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9D,EAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAC;IACxD,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9C,EAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAC;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AA8CF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAG9B;IACH,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAC;IACnC,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAC;IAClC,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAC;IAC5B,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAC;IAClC,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAC;CACvC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,oCAAoC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nexport interface TimelineLayer {\n  id: string;\n  label: string;\n  color: number; // 0xRRGGBB\n}\n\nexport interface TimelineEvent<TData = unknown> {\n  layerId: string;\n  /** `performance.now()` timestamp in the browser. */\n  time: number;\n  data: TData;\n  title?: string;\n  subtitle?: string;\n  /** Pairs a start event with its matching end event in the same update group. */\n  groupId?: number | string;\n  logType?: 'default' | 'warning' | 'error';\n  meta?: {\n    elementId?: number;\n    tagName?: string;\n    source?: {file: string; line: number};\n  };\n}\n\nexport interface TimelineLayersState {\n  recordingState: boolean;\n  litLifecycleEnabled: boolean;\n  litRenderEnabled: boolean;\n  mouseEventEnabled: boolean;\n  keyboardEventEnabled: boolean;\n}\n\nexport const TIMELINE_LAYERS: readonly TimelineLayer[] = [\n  {id: 'lit-lifecycle', label: 'Lit Lifecycle', color: 0x4d63ff},\n  {id: 'lit-render', label: 'Lit Render', color: 0x325cff},\n  {id: 'mouse', label: 'Mouse', color: 0xa451af},\n  {id: 'keyboard', label: 'Keyboard', color: 0x8151af},\n];\n\nexport const DEFAULT_LAYERS_STATE: TimelineLayersState = {\n  recordingState: false,\n  litLifecycleEnabled: true,\n  litRenderEnabled: true,\n  mouseEventEnabled: false,\n  keyboardEventEnabled: false,\n};\n\n/**\n * Snapshot of the plugin's resolved feature settings, surfaced in the panel's\n * Settings tab. The plugin produces this at config time (explicit options >\n * LIT_PLUGIN_* env > defaults) and serves it from the panel server. It's the\n * baseline the panel shows; some HMR settings can then be overridden live (see\n * {@link SettingsOverride}).\n */\nexport interface FeatureSettings {\n  hmr: {\n    enabled: boolean;\n    reconnect: boolean;\n    onIncompatible: 'reload' | 'warn';\n    indicatorEnabled: boolean;\n    indicatorCount: boolean;\n  };\n  sourceOverlay: {\n    enabled: boolean;\n    /** Hotkey letter combined with Ctrl+Shift to toggle the overlay. */\n    key: string;\n    editor: string;\n    throttleMs: number;\n  };\n  timeline: boolean;\n}\n\n/**\n * Runtime overrides the panel applies on top of the resolved env config, for\n * settings whose runtime is already injected (so they can change live). A\n * feature disabled at config time has no runtime, so it can't be enabled here\n * — only the behaviour of already-enabled features is overridable.\n *\n * Persisted under {@link SETTINGS_OVERRIDE_LS_KEY} (the panel and app share an\n * origin) so overrides survive reloads, and pushed live over\n * {@link SETTINGS_OVERRIDE_CHANNEL} via Vite HMR for immediate effect.\n */\nexport interface SettingsOverride {\n  hmrReconnect?: boolean;\n  hmrOnIncompatible?: 'reload' | 'warn';\n  hmrIndicatorVisible?: boolean;\n  hmrIndicatorCount?: boolean;\n  /** Built-in editor key for the source overlay's open-in-editor target. */\n  sourceOverlayEditor?: string;\n}\n\n/**\n * Built-in editors the source overlay can open files in. Keep in sync with\n * BUILTIN_EDITORS in lib/runtime/source-overlay/editors.ts.\n */\nexport const SOURCE_OVERLAY_EDITORS: ReadonlyArray<{\n  value: string;\n  label: string;\n}> = [\n  {value: 'vscode', label: 'VS Code'},\n  {value: 'cursor', label: 'Cursor'},\n  {value: 'zed', label: 'Zed'},\n  {value: 'idea', label: 'IntelliJ'},\n  {value: 'windsurf', label: 'Windsurf'},\n];\n\n/** localStorage key holding the {@link SettingsOverride}. */\nexport const SETTINGS_OVERRIDE_LS_KEY = 'lit-devtools-overrides';\n\n/** Vite HMR channel the server uses to push overrides to the app runtime. */\nexport const SETTINGS_OVERRIDE_CHANNEL = 'lit-devtools:settings-override';\n\n/**\n * Vite HMR channel the DevTools \"toggle source overlay\" command uses to tell\n * the app runtime to toggle the overlay (the command handler runs server-side).\n */\nexport const SOURCE_OVERLAY_TOGGLE_CHANNEL =\n  'lit-devtools:toggle-source-overlay';\n"]}
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9D,EAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAC;IACxD,EAAC,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC1E,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9C,EAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAC;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,KAAK;IAC9B,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AAyDF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAG9B;IACH,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAC;IACnC,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAC;IAClC,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAC;IAC5B,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAC;IAClC,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAC;CACvC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,oCAAoC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nexport interface TimelineLayer {\n  id: string;\n  label: string;\n  color: number; // 0xRRGGBB\n}\n\nexport interface TimelineEvent<TData = unknown> {\n  layerId: string;\n  /**\n   * Milliseconds since recording started, stamped in the browser page\n   * (`performance.now()` re-zeroed on each recording start; see\n   * `runtime/timeline/clock.ts`). Not comparable to any Node-side clock.\n   */\n  time: number;\n  data: TData;\n  title?: string;\n  subtitle?: string;\n  /** Pairs a start event with its matching end event in the same update group. */\n  groupId?: number | string;\n  logType?: 'default' | 'warning' | 'error';\n  meta?: {\n    elementId?: number;\n    tagName?: string;\n    source?: {file: string; line: number};\n  };\n}\n\nexport interface TimelineLayersState {\n  recordingState: boolean;\n  litLifecycleEnabled: boolean;\n  litRenderEnabled: boolean;\n  /**\n   * Per-part `lit-debug` events (`template updating`, `set part`, `commit\n   * *`, …) — one per binding on *every* render, so a ticking clock or\n   * animation floods the layer. Off by default; the `lit-render` layer's\n   * begin/end render pair already covers the common case.\n   */\n  litRenderVerboseEnabled: boolean;\n  mouseEventEnabled: boolean;\n  keyboardEventEnabled: boolean;\n}\n\nexport const TIMELINE_LAYERS: readonly TimelineLayer[] = [\n  {id: 'lit-lifecycle', label: 'Lit Lifecycle', color: 0x4d63ff},\n  {id: 'lit-render', label: 'Lit Render', color: 0x325cff},\n  {id: 'lit-render-verbose', label: 'Lit Render (verbose)', color: 0x99aeff},\n  {id: 'mouse', label: 'Mouse', color: 0xa451af},\n  {id: 'keyboard', label: 'Keyboard', color: 0x8151af},\n];\n\nexport const DEFAULT_LAYERS_STATE: TimelineLayersState = {\n  recordingState: false,\n  litLifecycleEnabled: true,\n  litRenderEnabled: true,\n  litRenderVerboseEnabled: false,\n  mouseEventEnabled: false,\n  keyboardEventEnabled: false,\n};\n\n/**\n * Snapshot of the plugin's resolved feature settings, surfaced in the panel's\n * Settings tab. The plugin produces this at config time (explicit options >\n * LIT_PLUGIN_* env > defaults) and serves it from the panel server. It's the\n * baseline the panel shows; some HMR settings can then be overridden live (see\n * {@link SettingsOverride}).\n */\nexport interface FeatureSettings {\n  hmr: {\n    enabled: boolean;\n    reconnect: boolean;\n    onIncompatible: 'reload' | 'warn';\n    indicatorEnabled: boolean;\n    indicatorCount: boolean;\n  };\n  sourceOverlay: {\n    enabled: boolean;\n    /** Hotkey letter combined with Ctrl+Shift to toggle the overlay. */\n    key: string;\n    editor: string;\n    throttleMs: number;\n  };\n  timeline: boolean;\n}\n\n/**\n * Runtime overrides the panel applies on top of the resolved env config, for\n * settings whose runtime is already injected (so they can change live). A\n * feature disabled at config time has no runtime, so it can't be enabled here\n * — only the behaviour of already-enabled features is overridable.\n *\n * Persisted under {@link SETTINGS_OVERRIDE_LS_KEY} (the panel and app share an\n * origin) so overrides survive reloads, and pushed live over\n * {@link SETTINGS_OVERRIDE_CHANNEL} via Vite HMR for immediate effect.\n */\nexport interface SettingsOverride {\n  hmrReconnect?: boolean;\n  hmrOnIncompatible?: 'reload' | 'warn';\n  hmrIndicatorVisible?: boolean;\n  hmrIndicatorCount?: boolean;\n  /** Built-in editor key for the source overlay's open-in-editor target. */\n  sourceOverlayEditor?: string;\n  /**\n   * Flash a short outline over every Lit element that completes an update.\n   * Pure preference (no config-time baseline), so `undefined` reads as off.\n   */\n  flashUpdates?: boolean;\n  /**\n   * Colour the flash by how often the element updated in the last second,\n   * calm to hot, instead of one flat colour. Only meaningful with\n   * {@link SettingsOverride.flashUpdates}.\n   */\n  flashUpdatesRamp?: boolean;\n}\n\n/**\n * Built-in editors the source overlay can open files in. Keep in sync with\n * BUILTIN_EDITORS in lib/runtime/source-overlay/editors.ts.\n */\nexport const SOURCE_OVERLAY_EDITORS: ReadonlyArray<{\n  value: string;\n  label: string;\n}> = [\n  {value: 'vscode', label: 'VS Code'},\n  {value: 'cursor', label: 'Cursor'},\n  {value: 'zed', label: 'Zed'},\n  {value: 'idea', label: 'IntelliJ'},\n  {value: 'windsurf', label: 'Windsurf'},\n];\n\n/** localStorage key holding the {@link SettingsOverride}. */\nexport const SETTINGS_OVERRIDE_LS_KEY = 'lit-devtools-overrides';\n\n/** Vite HMR channel the server uses to push overrides to the app runtime. */\nexport const SETTINGS_OVERRIDE_CHANNEL = 'lit-devtools:settings-override';\n\n/**\n * Vite HMR channel the DevTools \"toggle source overlay\" command uses to tell\n * the app runtime to toggle the overlay (the command handler runs server-side).\n */\nexport const SOURCE_OVERLAY_TOGGLE_CHANNEL =\n  'lit-devtools:toggle-source-overlay';\n"]}