@oddsquad/vite-plugin-lit 0.6.0 → 0.6.1

package/dist/client/index.html

@@ -32,7 +32,7 @@
       `prefers-color-scheme` @media owns it, following the host/OS; an explicit
       light/dark pins a `.color-scheme-*` class on :root.
     -->
-    <script type="module" crossorigin src="./assets/index-DVr5EnyB.js"></script>
+    <script type="module" crossorigin src="./assets/index-B2HYO7lk.js"></script>
   </head>
   <body>
     <lit-devtools-panel></lit-devtools-panel>

package/lib/confine.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/** Why {@link confineToRoots} refused a path. */
+export type ConfineFailure = 'outside' | 'missing';
+/**
+ * Resolve `file` against the first of `roots` and accept it only if it lands
+ * at or beneath one of them and exists. Every caller hands the result to
+ * `launch-editor`, which spawns the developer's editor on it, so this is the
+ * boundary that keeps a request from opening arbitrary files (absolute paths,
+ * `../` traversal, a sibling directory that merely shares a root's prefix, a
+ * symlink out of the tree).
+ * Without roots nothing is allowed.
+ */
+export declare const confineToRoots: (roots: readonly string[], file: string) => {
+    path: string;
+} | {
+    failure: ConfineFailure;
+};
+//# sourceMappingURL=confine.d.ts.map

package/lib/confine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confine.d.ts","sourceRoot":"","sources":["../src/lib/confine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,UAClB,SAAS,MAAM,EAAE,QAClB,MAAM,KACX;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG;IAAC,OAAO,EAAE,cAAc,CAAA;CAmB3C,CAAC"}

package/lib/confine.js

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import {existsSync, realpathSync} from 'node:fs';
+import {resolve as resolvePath, sep} from 'node:path';
+/**
+ * Resolve `file` against the first of `roots` and accept it only if it lands
+ * at or beneath one of them and exists. Every caller hands the result to
+ * `launch-editor`, which spawns the developer's editor on it, so this is the
+ * boundary that keeps a request from opening arbitrary files (absolute paths,
+ * `../` traversal, a sibling directory that merely shares a root's prefix, a
+ * symlink out of the tree).
+ * Without roots nothing is allowed.
+ */
+export const confineToRoots = (roots, file) => {
+  const resolvedRoots = roots.map((root) => resolvePath(root));
+  const primary = resolvedRoots[0];
+  if (primary === undefined) return {failure: 'outside'};
+  const path = resolvePath(primary, file);
+  if (!within(resolvedRoots, path)) return {failure: 'outside'};
+  if (!existsSync(path)) return {failure: 'missing'};
+  // Checked again on the real paths, so a symlink beneath a root can't point
+  // the editor outside every root. The caller still gets the path as asked:
+  // that's the one the developer recognises.
+  const realRoots = resolvedRoots.flatMap((root) => {
+    try {
+      return [realpathSync(root)];
+    } catch {
+      return [];
+    }
+  });
+  if (!within(realRoots, realpathSync(path))) return {failure: 'outside'};
+  return {path};
+};
+const within = (roots, path) =>
+  roots.some((root) => path === root || path.startsWith(root + sep));
+//# sourceMappingURL=confine.js.map

package/lib/confine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confine.js","sourceRoot":"","sources":["../src/lib/confine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AACjD,OAAO,EAAC,OAAO,IAAI,WAAW,EAAE,GAAG,EAAC,MAAM,WAAW,CAAC;AAKtD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAwB,EACxB,IAAY,EACgC,EAAE;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC;QAAE,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC;IACnD,2EAA2E;IAC3E,0EAA0E;IAC1E,2CAA2C;IAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAC,OAAO,EAAE,SAAS,EAAC,CAAC;IACxE,OAAO,EAAC,IAAI,EAAC,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,KAAwB,EAAE,IAAY,EAAW,EAAE,CACjE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport {existsSync, realpathSync} from 'node:fs';\nimport {resolve as resolvePath, sep} from 'node:path';\n\n/** Why {@link confineToRoots} refused a path. */\nexport type ConfineFailure = 'outside' | 'missing';\n\n/**\n * Resolve `file` against the first of `roots` and accept it only if it lands\n * at or beneath one of them and exists. Every caller hands the result to\n * `launch-editor`, which spawns the developer's editor on it, so this is the\n * boundary that keeps a request from opening arbitrary files (absolute paths,\n * `../` traversal, a sibling directory that merely shares a root's prefix, a\n * symlink out of the tree).\n * Without roots nothing is allowed.\n */\nexport const confineToRoots = (\n  roots: readonly string[],\n  file: string\n): {path: string} | {failure: ConfineFailure} => {\n  const resolvedRoots = roots.map((root) => resolvePath(root));\n  const primary = resolvedRoots[0];\n  if (primary === undefined) return {failure: 'outside'};\n  const path = resolvePath(primary, file);\n  if (!within(resolvedRoots, path)) return {failure: 'outside'};\n  if (!existsSync(path)) return {failure: 'missing'};\n  // Checked again on the real paths, so a symlink beneath a root can't point\n  // the editor outside every root. The caller still gets the path as asked:\n  // that's the one the developer recognises.\n  const realRoots = resolvedRoots.flatMap((root) => {\n    try {\n      return [realpathSync(root)];\n    } catch {\n      return [];\n    }\n  });\n  if (!within(realRoots, realpathSync(path))) return {failure: 'outside'};\n  return {path};\n};\n\nconst within = (roots: readonly string[], path: string): boolean =>\n  roots.some((root) => path === root || path.startsWith(root + sep));\n"]}

package/lib/devframe/definition.d.ts

@@ -22,10 +22,18 @@ export interface CreateLitDevframeOptions {
     /**
      * Absolute directory the injected `ElementSource.file` paths are relative
      * to (the Vite root). Read per call, since a host only knows it once its
-     * dev server is up. Without it `open-source` can only open paths that are
-     * already absolute.
+     * dev server is up. Also the first root `open-source` confines opens to;
+     * without it, relative paths resolve against the working directory.
      */
     sourceRoot?: () => string | undefined;
+    /**
+     * Further directories `open-source` may open files beneath, beyond
+     * `sourceRoot` (the Vite host passes `server.fs.allow`, where sibling
+     * packages of a monorepo live). Read per call. A path outside every root
+     * is refused; with neither this nor `sourceRoot`, the process's working
+     * directory is the only root.
+     */
+    allowedRoots?: () => readonly string[];
     /**
      * The editor key the developer named in config or env
      * (`sourceOverlay.editor`), or `undefined` when they never did. Read per

package/lib/devframe/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/definition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAC,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAWtE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AA6CjC,OAAO,EAAmB,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,kBAAkB,CA+jBpB"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/definition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAC,kBAAkB,EAAsB,MAAM,UAAU,CAAC;AAWtE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AA6CjC,OAAO,EAAmB,KAAK,cAAc,EAAC,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACtC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,kBAAkB,CAqlBpB"}

package/lib/devframe/definition.js

@@ -55,8 +55,15 @@ import {createNullSource} from './source.js';
  * server, a static build, or an MCP server.
  */
 export function createLitDevframe(options) {
-  const {source, version, features, replay, sourceRoot, configuredEditor} =
-    options;
+  const {
+    source,
+    version,
+    features,
+    replay,
+    sourceRoot,
+    allowedRoots,
+    configuredEditor,
+  } = options;
   return defineDevframe({
     id: LIT_DEVFRAME_ID,
     name: 'Lit',
@@ -534,12 +541,15 @@ export function createLitDevframe(options) {
           handler: async (args) => {
             const service = ctx.services.get('@devframes/service-open');
             if (service === undefined) return {opened: false};
-            const {isAbsolute, resolve} = await import('node:path');
-            const root = sourceRoot?.();
-            const path =
-              root !== undefined && !isAbsolute(args.file)
-                ? resolve(root, args.file)
-                : args.file;
+            // Confined like `/__lit-open-in-editor`: whatever can reach this
+            // RPC could otherwise have the editor open any file on disk.
+            const {confineToRoots} = await import('../confine.js');
+            const confined = confineToRoots(
+              [sourceRoot?.() ?? process.cwd(), ...(allowedRoots?.() ?? [])],
+              args.file
+            );
+            if ('failure' in confined) return {opened: false};
+            const {path} = confined;
             const override = await my.settings.global.get('override');
             await service.openInEditor({
               path,
@@ -563,6 +573,18 @@ export function createLitDevframe(options) {
             // loading in contexts with no filesystem, and the build adapter
             // it pulls in reaches straight for `node:fs`.
             const {buildSnapshot} = await import('../snapshot.js');
+            // `outDir` comes from the client and the build deletes it before
+            // writing, so it has to land strictly beneath the working
+            // directory -- never the directory itself, and never elsewhere
+            // on disk.
+            const {resolve, sep} = await import('node:path');
+            const cwd = process.cwd();
+            const outDir = resolve(cwd, args.outDir ?? 'lit-devtools-snapshot');
+            if (!outDir.startsWith(cwd + sep)) {
+              throw new Error(
+                `[lit-devtools] export-snapshot: outDir must be inside ${cwd}`
+              );
+            }
             return buildSnapshot(
               {
                 capturedAt: new Date().toISOString(),
@@ -574,7 +596,7 @@ export function createLitDevframe(options) {
                 hmrIncompatibilities: [...hmrIncompatibilities],
               },
               {
-                outDir: args.outDir ?? 'lit-devtools-snapshot',
+                outDir,
                 features: features ? features() : null,
                 clientAssets: options.clientAssets,
               }

package/lib/devframe/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/lib/devframe/definition.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,UAAU,CAAC;AAY3D,OAAO,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAC,yBAAyB,EAAC,MAAM,oCAAoC,CAAC;AAE7E,OAAO,EAAC,aAAa,EAAC,MAAM,WAAW,CAAC;AACxC,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAM1C,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,yBAAyB,EACzB,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAcrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,MAAM,EACN,OAAO,EACP,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAC,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAsClE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,MAAM,EAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAC,GACrE,OAAO,CAAC;IAEV,OAAO,cAAc,CAAC;QACpB,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,yDAAyD;QACtE,OAAO;QACP,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,6CAA6C;QACvD,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG;QAC9B,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,EAAC,QAAQ,EAAE,WAAW,EAAC;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,cAAc;QAEpD,wEAAwE;QACxE,yEAAyE;QACzE,uEAAuE;QACvE,GAAG,EAAE,MAAM;YACT,CAAC,CAAC;gBACE,QAAQ,EAAE;oBACR;wBACE,MAAM,EAAE,GAAG,eAAe,IAAI,qBAAqB,EAAE;wBACrD,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAC,CAAC,CAAC;qBAChD;iBACF;aACF;YACH,CAAC,CAAC,SAAS;QAEb,KAAK,CAAC,KAAK,CAAC,GAAwB;YAClC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAEtC,iEAAiE;YACjE,sEAAsE;YACtE,+DAA+D;YAC/D,mEAAmE;YACnE,uEAAuE;YACvE,uEAAuE;YACvE,gDAAgD;YAChD,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YAE/B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,WAAW,CACtC,iBAAiB,EACjB;gBACE,YAAY,EAAE,MAAM;oBAClB,CAAC,CAAC;wBACE,GAAG,qBAAqB;wBACxB,6DAA6D;wBAC7D,6DAA6D;wBAC7D,eAAe;wBACf,YAAY,EAAE,MAAM,CAAC,YAAY;qBAClC;oBACH,CAAC,CAAC,qBAAqB;aAC1B,CACF,CAAC;YAEF,uEAAuE;YACvE,qEAAqE;YACrE,sEAAsE;YACtE,IAAI,WAAW,GAAwB,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACtC,CAAC;YAEF,sEAAsE;YACtE,kEAAkE;YAClE,kEAAkE;YAClE,8CAA8C;YAC9C,MAAM,YAAY,GAAoB,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEvE,qEAAqE;YACrE,wEAAwE;YACxE,yEAAyE;YACzE,0EAA0E;YAC1E,sEAAsE;YACtE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,0DAA0D;YAC1D,kEAAkE;YAClE,8DAA8D;YAC9D,MAAM,oBAAoB,GAA8B,MAAM;gBAC5D,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,oBAAoB,CAAC;gBAClC,CAAC,CAAC,EAAE,CAAC;YAEP,qEAAqE;YACrE,gEAAgE;YAChE,8DAA8D;YAC9D,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBACvD,QAAQ,EACN,mEAAmE;gBACrE,KAAK,EAAE;oBACL,gBAAgB,EAAE;wBAChB,GAAG,EAAE,CAAC,CAAoB,EAAE,EAAE,CAC5B,IAAI,CAAC,CAAC,OAAO,sDAAsD;wBACrE,IAAI,EAAE,8FAA8F;qBACrG;oBACD,oBAAoB,EAAE;wBACpB,GAAG,EAAE,CAAC,CAAoC,EAAE,EAAE,CAC5C,IAAI,CAAC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,EAAE;wBACpD,IAAI,EAAE,8FAA8F;qBACrG;oBACD,qBAAqB,EAAE;wBACrB,GAAG,EAAE,CAAC,CAAoB,EAAE,EAAE,CAC5B,IAAI,CAAC,CAAC,OAAO,kDAAkD;wBACjE,IAAI,EAAE,8FAA8F;qBACrG;iBACF;aACF,CAAC,CAAC;YACH,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAEzC,iEAAiE;YACjE,kEAAkE;YAClE,0DAA0D;YAC1D,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACvB,qEAAqE;gBACrE,6DAA6D;gBAC7D,mEAAmE;gBACnE,sEAAsE;gBACtE,sEAAsE;gBACtE,6BAA6B;gBAC7B,MAAM,OAAO,GACX,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAkB,oBAAoB,CAAC,CAAC;gBACjE,oEAAoE;gBACpE,kEAAkE;gBAClE,qEAAqE;gBACrE,qEAAqE;gBACrE,gEAAgE;gBAChE,oEAAoE;gBACpE,kCAAkC;gBAClC,OAAO,CAAC,KAAK,CAAC,EAAC,EAAE,EAAE,kBAAkB,EAAC,CAAC,CAAC;gBACxC,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;oBAC/B,OAAO,CAAC,KAAK,CAAC,EAAC,EAAE,EAAE,kBAAkB,EAAC,CAAC,CAAC;gBAE1C,MAAM,CAAC,MAAM,CAAC;oBACZ,UAAU,CAAC,QAAQ;wBACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;4BAAE,OAAO;wBAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;4BACtC,GAAG,KAAK;4BACR,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,UAAU,IAAI,QAAQ,EAAE,EAAE;yBAC9C,CAAC,CAAC,CAAC;wBACJ,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;wBAC7B,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;wBAC7B,IAAI,YAAY,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;4BACpD,YAAY,CAAC,MAAM,CACjB,CAAC,EACD,YAAY,CAAC,MAAM,GAAG,yBAAyB,CAChD,CAAC;wBACJ,CAAC;oBACH,CAAC;oBACD,QAAQ,CAAC,KAAK;wBACZ,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;4BACvB,IACE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,EAChE,CAAC;gCACD,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;4BACjC,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC;oBACD,gBAAgB,CAAC,OAAO;wBACtB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BAC5B,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;wBAC9B,CAAC;6BAAM,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;4BACtC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;wBACzD,CAAC;6BAAM,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BACnC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACnC,CAAC;wBACD,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;4BACrB,MAAM,EAAE,GAAG,eAAe,IAAI,qBAAqB,EAAE;4BACrD,IAAI,EAAE,CAAC,OAAO,CAAC;4BACf,6DAA6D;4BAC7D,2DAA2D;4BAC3D,+CAA+C;4BAC/C,QAAQ,EAAE,IAAI;yBACf,CAAC,CAAC;oBACL,CAAC;oBACD,YAAY;wBACV,kEAAkE;wBAClE,mEAAmE;wBACnE,mEAAmE;wBACnE,oEAAoE;wBACpE,gCAAgC;wBAChC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;wBAExB,8DAA8D;wBAC9D,iEAAiE;wBACjE,cAAc;wBACd,MAAM,EAAC,MAAM,EAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;wBACjC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;wBACzB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;oBAC7C,CAAC;oBACD,eAAe,CAAC,KAAK;wBACnB,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACjC,IAAI,oBAAoB,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;4BAC5D,oBAAoB,CAAC,MAAM,CACzB,CAAC,EACD,oBAAoB,CAAC,MAAM,GAAG,yBAAyB,CACxD,CAAC;wBACJ,CAAC;wBACD,KAAK,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;4BACrB,MAAM,EAAE,GAAG,eAAe,IAAI,oBAAoB,EAAE;4BACpD,IAAI,EAAE,CAAC,KAAK,CAAC;4BACb,QAAQ,EAAE,IAAI;yBACf,CAAC,CAAC;wBAEH,qDAAqD;wBACrD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;4BAChD,cAAc,CAAC,gBAAgB,CAAC,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC;wBAC5D,CAAC;6BAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;4BAChD,cAAc,CAAC,oBAAoB,CAAC;gCAClC,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;6BAC5B,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,cAAc,CAAC,qBAAqB,CAAC,EAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC,CAAC,CAAC;wBACjE,CAAC;oBACH,CAAC;iBACF,CAAC,CAAC;gBAEH,+DAA+D;gBAC/D,iEAAiE;gBACjE,4DAA4D;gBAC5D,8DAA8D;gBAC9D,4CAA4C;gBAC5C,EAAE;gBACF,0DAA0D;gBAC1D,iEAAiE;gBACjE,wEAAwE;gBACxE,oEAAoE;gBACpE,sEAAsE;gBACtE,oEAAoE;gBACpE,gEAAgE;gBAChE,wEAAwE;gBACxE,IAAI,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;gBACzD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC9B,MAAM,EAAC,cAAc,EAAC,GAAG,KAAK,CAAC,MAAM,CAAC;oBACtC,IAAI,cAAc,IAAI,CAAC,YAAY,EAAE,CAAC;wBACpC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC1B,CAAC;oBACD,YAAY,GAAG,cAAc,CAAC;oBAC9B,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;oBACpC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,WAAW,EACT,oLAAoL;iBACvL;gBACD,OAAO,EAAE,KAAK,IAA+B,EAAE,CAAC,CAAC;oBAC/C,OAAO;oBACP,+DAA+D;oBAC/D,0CAA0C;oBAC1C,MAAM,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC;oBAC7D,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;oBACtC,MAAM,EAAE;wBACN,OAAO,EAAE,GAAG,eAAe,IAAI,oBAAoB,EAAE;wBACrD,EAAE,EAAE,kBAAkB;qBACvB;iBACF,CAAC;aACH,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,iEAAiE;gBACjE,kEAAkE;gBAClE,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,WAAW,EACT,0HAA0H;iBAC7H;gBACD,OAAO,EAAE,KAAK,IAAkC,EAAE,CAAC,WAAW;aAC/D,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,yBAAyB;gBAC/B,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,iEAAiE;gBACjE,kEAAkE;gBAClE,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,WAAW,EACT,2MAA2M;iBAC9M;gBACD,OAAO,EAAE,KAAK,IAAwC,EAAE,CACtD,oBAAoB;aACvB,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,KAAK,EAAE;oBACL,WAAW,EACT,6HAA6H;iBAChI;gBACD,OAAO,EAAE,KAAK,EACZ,IAA0B,EACQ,EAAE,CACpC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI;aACrC,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,iEAAiE;gBACjE,kEAAkE;gBAClE,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,WAAW,EACT,2XAA2X;iBAC9X;gBACD,kEAAkE;gBAClE,mEAAmE;gBACnE,kBAAkB;gBAClB,OAAO,EAAE,KAAK,EACZ,IAAI,GAAqB,EAAE,EACE,EAAE;oBAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;oBACxD,IAAI,QAAQ,GAAG,YAAY,CAAC;oBAC5B,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC/B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;oBAChE,CAAC;oBACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;wBACjC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC,SAAS,CAC5C,CAAC;oBACJ,CAAC;oBACD,iEAAiE;oBACjE,+DAA+D;oBAC/D,+DAA+D;oBAC/D,uCAAuC;oBACvC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC;wBAC3D,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;wBACrC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;oBACtD,CAAC;oBACD,gEAAgE;oBAChE,mEAAmE;oBACnE,gEAAgE;oBAChE,MAAM,KAAK,GAAG,MAAM;wBAClB,CAAC,CAAC,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,KAAK,IAAI,yBAAyB,EACvC,yBAAyB,CAC1B;wBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;oBACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;oBACtC,OAAO;wBACL,SAAS;wBACT,MAAM;wBACN,UAAU,EAAE,YAAY,CAAC,MAAM;wBAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;qBAC3C,CAAC;gBACJ,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,gEAAgE;gBAChE,+DAA+D;gBAC/D,iEAAiE;gBACjE,8DAA8D;gBAC9D,0DAA0D;gBAC1D,OAAO,EAAE,KAAK,IAA8B,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC;aACjE,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,OAAO;gBACb,gBAAgB,EAAE,IAAI;gBACtB,oEAAoE;gBACpE,+DAA+D;gBAC/D,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,WAAW,EACT,meAAme;iBACte;gBACD,kEAAkE;gBAClE,uDAAuD;gBACvD,OAAO,EAAE,KAAK,EACZ,IAAI,GAAsB,EAAE,EACE,EAAE;oBAChC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;oBACxD,IAAI,MAAM,GAA6B,YAAY,CAAC;oBACpD,iEAAiE;oBACjE,0DAA0D;oBAC1D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC1D,MAAM,MAAM,GACV,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;wBAC7D,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;oBACxD,CAAC;oBACD,IAAI,MAAM,GAAG,cAAc,CACzB,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC/B,MAAM,CACP,CAAC;oBACF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC/B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC5D,CAAC;oBACD,4DAA4D;oBAC5D,iEAAiE;oBACjE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;oBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;oBAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;oBACrC,OAAO;wBACL,SAAS;wBACT,UAAU;wBACV,MAAM,EAAE,OAAO;wBACf,UAAU,EAAE,YAAY,CAAC,MAAM;wBAC/B,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;qBAC1C,CAAC;gBACJ,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,OAAO,EAAE,KAAK,EAAE,OAAyB,EAAiB,EAAE;oBAC1D,6DAA6D;oBAC7D,8DAA8D;oBAC9D,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBAC5B,MAAM,CAAC,aAAa,EAAE,CAAC;wBACvB,OAAO;oBACT,CAAC;oBACD,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,gEAAgE;gBAChE,gEAAgE;gBAChE,gEAAgE;gBAChE,kEAAkE;gBAClE,mBAAmB;gBACnB,KAAK,EAAE;oBACL,WAAW,EACT,iMAAiM;iBACpM;gBACD,OAAO,EAAE,KAAK,EAAE,IAAsB,EAAiB,EAAE;oBACvD,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;wBACvB,KAAK,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;oBAC/C,CAAC,CAAC,CAAC;gBACL,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,OAAO,EAAE,KAAK,EAAE,IAAqB,EAAiB,EAAE;oBACtD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACvC,+DAA+D;oBAC/D,2BAA2B;oBAC3B,IAAI,CAAC,IAAI;wBAAE,OAAO;oBAClB,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;wBACvB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;oBACpC,CAAC,CAAC,CAAC;gBACL,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,yBAAyB;gBAC/B,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,OAAO,EAAE,KAAK,EAAE,QAA0B,EAAiB,EAAE;oBAC3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBACvC,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,gEAAgE;gBAChE,+DAA+D;gBAC/D,qDAAqD;gBACrD,kEAAkE;gBAClE,gEAAgE;gBAChE,+DAA+D;gBAC/D,qDAAqD;gBACrD,OAAO,EAAE,KAAK,EAAE,IAAoB,EAA6B,EAAE;oBACjE,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;oBAC5D,IAAI,OAAO,KAAK,SAAS;wBAAE,OAAO,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;oBAClD,MAAM,EAAC,UAAU,EAAE,OAAO,EAAC,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;oBACxD,MAAM,IAAI,GAAG,UAAU,EAAE,EAAE,CAAC;oBAC5B,MAAM,IAAI,GACR,IAAI,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC1C,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;wBAC1B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBAChB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBAC1D,MAAM,OAAO,CAAC,YAAY,CAAC;wBACzB,IAAI;wBACJ,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,mBAAmB,CAAC,gBAAgB,EAAE,EAAE,EAAE,QAAQ,CAAC;qBAC5D,CAAC,CAAC;oBACH,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,CAAC;gBACxB,CAAC;aACF,CAAC,CACH,CAAC;YAEF,EAAE,CAAC,GAAG,CAAC,QAAQ,CACb,iBAAiB,CAAC;gBAChB,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,QAAQ;gBACd,gBAAgB,EAAE,IAAI;gBACtB,oEAAoE;gBACpE,oEAAoE;gBACpE,8DAA8D;gBAC9D,OAAO,EAAE,KAAK,EACZ,IAAwB,EACO,EAAE;oBACjC,4DAA4D;oBAC5D,gEAAgE;oBAChE,8CAA8C;oBAC9C,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;oBACvD,OAAO,aAAa,CAClB;wBACE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACpC,OAAO;wBACP,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC;wBAC/C,KAAK,EAAE,WAAW;wBAClB,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;wBACpC,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC;wBACzB,oBAAoB,EAAE,CAAC,GAAG,oBAAoB,CAAC;qBAChD,EACD;wBACE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,uBAAuB;wBAC9C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;wBACtC,YAAY,EAAE,OAAO,CAAC,YAAY;qBACnC,CACF,CAAC;gBACJ,CAAC;aACF,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,eAAe,iBAAiB,CAAC;IAC/B,MAAM,EAAE,gBAAgB,EAAE;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The framework-neutral Lit devframe: RPC functions, shared state, and the\n * timeline stream. Talks to the page runtime only through the injected\n * {@link TimelineSource} port, so it runs unchanged under `createDevServer()`,\n * `createBuild()`, or an MCP server with no Vite in the loop. `vite.ts` wires\n * the real page-runtime bridge and mounts this via `createPluginFromDevframe`.\n *\n * @see plans/devframe-foundation.md\n */\n\nimport {defineDevframe, defineRpcFunction} from 'devframe';\n// Type-only: brings in the service's `declare module 'devframe'`\n// augmentation so `ctx.services.get()` types its API. Nothing is\n// imported at runtime, and the service is consumed, never installed\n// here -- a Vite hub already has it (see `panel/open-in-editor.ts`).\nimport type {} from '@devframes/service-open';\nimport type {DevframeDefinition, DevframeNodeContext} from 'devframe';\nimport type {\n  InspectorCommand,\n  InspectorDetails,\n  InspectorTreeNode,\n} from '../../types/inspector.js';\nimport {TIMELINE_LAYERS} from '../../types/timeline.js';\nimport {MAX_HMR_INCOMPATIBILITIES} from '../../types/hmr-incompatibility.js';\nimport type {HmrIncompatibilityEvent} from '../../types/hmr-incompatibility.js';\nimport {LIT_LOGO_ICON} from './icon.js';\nimport {PANEL_DIST_DIR} from './paths.js';\nimport type {\n  FeatureSettings,\n  SettingsOverride,\n  TimelineEvent,\n} from '../../types/timeline.js';\nimport {\n  DEFAULT_SESSION_STATE,\n  LAYER_FLAGS,\n  LIT_DEVFRAME_ID,\n  RECENT_EVENTS_BUFFER_SIZE,\n  RPC_COMPONENT_DETAILS,\n  RPC_GET_META,\n  RPC_HMR_INCOMPATIBILITIES,\n  RPC_HMR_INCOMPATIBLE,\n  RPC_INSPECT,\n  RPC_INSPECTOR_MESSAGE,\n  RPC_LIST_COMPONENTS,\n  RPC_RECENT_EVENTS,\n  RPC_TIMELINE_HISTORY,\n  RPC_SET_RECORDING,\n  RPC_EXPORT_SNAPSHOT,\n  RPC_OPEN_SOURCE,\n  RPC_SET_SETTINGS_OVERRIDE,\n  RPC_TOGGLE_LAYER,\n  RPC_UPDATE_SUMMARY,\n  SESSION_STATE_KEY,\n  TIMELINE_STREAM_ID,\n  TIMELINE_STREAM_NAME,\n  type ComponentDetailsArgs,\n  type LitGetMetaResult,\n  type RecentEventsArgs,\n  type RecentEventsResult,\n  type SessionState,\n  type ExportSnapshotArgs,\n  type ExportSnapshotResult,\n  type OpenSourceArgs,\n  type OpenSourceResult,\n  type SetRecordingArgs,\n  type ToggleLayerArgs,\n  type UpdateSummaryArgs,\n  type UpdateSummaryResult,\n} from './protocol.js';\nimport {\n  attributeInput,\n  rollup,\n  toSpans,\n  toUpdateCycles,\n} from '../timeline/derive.js';\nimport {resolveLaunchEditor} from './launch-editor.js';\nimport {createNullSource, type TimelineSource} from './source.js';\nimport type {SessionSnapshot} from '../../types/snapshot.js';\n\nexport interface CreateLitDevframeOptions {\n  /** Page-runtime bridge. Use {@link createNullSource} when no page is attached. */\n  source: TimelineSource;\n  /** Plugin version, surfaced by `get-meta` and the devframe's own `version`. */\n  version: string;\n  /** Resolved feature settings, surfaced by `get-meta`. */\n  features?: () => FeatureSettings | null;\n  /**\n   * Directory holding the built panel SPA. Defaults to the package's own\n   * `dist/client`; the dev-time panel build points it elsewhere.\n   */\n  clientAssets?: string;\n  /**\n   * Absolute directory the injected `ElementSource.file` paths are relative\n   * to (the Vite root). Read per call, since a host only knows it once its\n   * dev server is up. Without it `open-source` can only open paths that are\n   * already absolute.\n   */\n  sourceRoot?: () => string | undefined;\n  /**\n   * The editor key the developer named in config or env\n   * (`sourceOverlay.editor`), or `undefined` when they never did. Read per\n   * call. `open-source` maps it, or the panel's override of it, to a\n   * `launch-editor` command; without either the editor is auto-detected.\n   */\n  configuredEditor?: () => string | undefined;\n  /**\n   * Boot from a recorded session instead of a live one. Set only by the\n   * static-snapshot build (see `lib/snapshot.ts`): the caches below start\n   * populated, so the frozen panel has a timeline and a component tree to\n   * render with no page and no dev server behind it.\n   */\n  replay?: SessionSnapshot;\n}\n\n/**\n * Builds the Lit devframe definition. Framework-neutral: everything here\n * runs the same whether the host is Vite (`vite.ts`), a standalone dev\n * server, a static build, or an MCP server.\n */\nexport function createLitDevframe(\n  options: CreateLitDevframeOptions\n): DevframeDefinition {\n  const {source, version, features, replay, sourceRoot, configuredEditor} =\n    options;\n\n  return defineDevframe({\n    id: LIT_DEVFRAME_ID,\n    name: 'Lit',\n    description: 'Timeline recorder and component inspector for Lit apps.',\n    version,\n    packageName: '@oddsquad/vite-plugin-lit',\n    homepage: 'https://oddcelot.github.io/vite-plugin-lit/',\n    importMetaUrl: import.meta.url,\n    icon: LIT_LOGO_ICON,\n    dock: {category: 'framework'},\n    clientAssets: options.clientAssets ?? PANEL_DIST_DIR,\n\n    // `component-details` takes an id, so `snapshot: true` (which bakes the\n    // no-argument call) cannot express it. Bake one record per component the\n    // session actually opened -- the only ids that have details to freeze.\n    rpc: replay\n      ? {\n          snapshot: [\n            {\n              method: `${LIT_DEVFRAME_ID}:${RPC_COMPONENT_DETAILS}`,\n              inputs: replay.details.map((d) => [{id: d.id}]),\n            },\n          ],\n        }\n      : undefined,\n\n    async setup(ctx: DevframeNodeContext) {\n      const my = ctx.scope(LIT_DEVFRAME_ID);\n\n      // Bind the per-user settings store before any panel can connect.\n      // Both sides build it lazily on first access, but only this one backs\n      // it with a JSON file -- a client that asks first gets a plain\n      // in-memory shared state instead, so the panel's preferences would\n      // round-trip happily and then vanish on restart. The panel is the only\n      // thing that reads or writes these (see `panel/devtools-settings.ts`);\n      // this call exists purely to make them durable.\n      await my.settings.global.all();\n\n      const session = await my.rpc.sharedState<SessionState>(\n        SESSION_STATE_KEY,\n        {\n          initialValue: replay\n            ? {\n                ...DEFAULT_SESSION_STATE,\n                // Recorded events carry layer ids; without the custom layers\n                // that produced them the frozen panel would show a filter it\n                // cannot name.\n                customLayers: replay.customLayers,\n              }\n            : DEFAULT_SESSION_STATE,\n        }\n      );\n\n      // Latest inspector snapshot, cached so a panel that (re)connects after\n      // the runtime already answered can read it without round-tripping to\n      // the page again. Pre-filled when replaying: there is no page to ask.\n      let cachedRoots: InspectorTreeNode[] = replay ? [...replay.roots] : [];\n      const cachedDetails = new Map<number, InspectorDetails>(\n        replay?.details.map((d) => [d.id, d])\n      );\n\n      // Bounded history for the `recent-events` agent query and the panel's\n      // `timeline-history` seed. A plain array, not devframe's internal\n      // per-stream replay buffer, which devframe marks `@internal` (see\n      // plans/roadmap/02-agent-timeline-access.md).\n      const recentEvents: TimelineEvent[] = replay ? [...replay.events] : [];\n\n      // Event ids: `${epoch}-${seq}`. The epoch is the session start, so a\n      // restarted dev server can never reissue an id an older snapshot holds;\n      // the seq is monotonic across Clear. Stamped here, once, because this is\n      // the only place every consumer (stream, `recent-events`, export) shares.\n      // A replayed session never reaches `pushEvents`, so its ids are kept.\n      const eventEpoch = Date.now().toString(36);\n      let eventSeq = 0;\n\n      // Recent HMR-incompatibility notices, capped the same way\n      // `runtime/timeline/transport.ts` caps its pending queue — a long\n      // session with many failing edits must not grow this forever.\n      const hmrIncompatibilities: HmrIncompatibilityEvent[] = replay\n        ? [...replay.hmrIncompatibilities]\n        : [];\n\n      // Terminal echo for an audience that only sees dev-server stdout (an\n      // agent, or a CI log) and not the browser console or the panel.\n      // Fire-and-log only — the cache above is the read-back store.\n      const hmrDiagnostics = ctx.diagnostics.defineDiagnostics({\n        docsBase:\n          'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/',\n        codes: {\n          LIT_HMR_ACCESSOR: {\n            why: (p: {tagName: string}) =>\n              `<${p.tagName}> can't be hot-patched: standard accessor decorators`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n          LIT_HMR_PATCH_FAILED: {\n            why: (p: {tagName: string; detail: string}) =>\n              `<${p.tagName}> can't be hot-patched: ${p.detail}`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n          LIT_HMR_ATTRS_CHANGED: {\n            why: (p: {tagName: string}) =>\n              `<${p.tagName}> changed observedAttributes; reload recommended`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n        },\n      });\n      ctx.diagnostics.register(hmrDiagnostics);\n\n      // Streaming/source wiring only makes sense for a live session: a\n      // static build or MCP run has no page attached (its `source` is a\n      // `createNullSource()`), and `ctx.mode` is 'build' there.\n      if (ctx.mode === 'dev') {\n        // No `replayWindow`: a subscriber would be replayed the whole buffer\n        // in separate chunks, including batches from before the last\n        // recording started (a different clock) and ones the panel's Clear\n        // dropped, and the node has no way to forget them. A connecting panel\n        // is seeded from `timeline-history` instead, which is `recentEvents`,\n        // cleared on the same edges.\n        const channel =\n          my.rpc.streaming.create<TimelineEvent[]>(TIMELINE_STREAM_NAME);\n        // Started eagerly, not on the first event: `streaming:subscribe` is\n        // fire-and-forget on the wire, and a subscribe naming a stream id\n        // that does not exist yet is dropped with a DF0030 diagnostic rather\n        // than queued. The panel subscribes as soon as it connects, which is\n        // normally long before the first event, so the stream has to be\n        // there waiting. `??` covers a re-start if the transport aborted it\n        // after the last subscriber left.\n        channel.start({id: TIMELINE_STREAM_ID});\n        const ensureStream = () =>\n          channel.get(TIMELINE_STREAM_ID) ??\n          channel.start({id: TIMELINE_STREAM_ID});\n\n        source.attach({\n          pushEvents(incoming) {\n            if (incoming.length === 0) return;\n            const events = incoming.map((event) => ({\n              ...event,\n              id: event.id ?? `${eventEpoch}-${eventSeq++}`,\n            }));\n            ensureStream().write(events);\n            recentEvents.push(...events);\n            if (recentEvents.length > RECENT_EVENTS_BUFFER_SIZE) {\n              recentEvents.splice(\n                0,\n                recentEvents.length - RECENT_EVENTS_BUFFER_SIZE\n              );\n            }\n          },\n          addLayer(layer) {\n            session.mutate((state) => {\n              if (\n                !state.customLayers.some((existing) => existing.id === layer.id)\n              ) {\n                state.customLayers.push(layer);\n              }\n            });\n          },\n          inspectorMessage(message) {\n            if (message.type === 'tree') {\n              cachedRoots = message.roots;\n            } else if (message.type === 'details') {\n              cachedDetails.set(message.details.id, message.details);\n            } else if (message.type === 'gone') {\n              cachedDetails.delete(message.id);\n            }\n            void ctx.rpc.broadcast({\n              method: `${LIT_DEVFRAME_ID}:${RPC_INSPECTOR_MESSAGE}`,\n              args: [message],\n              // A page can be open with no panel docked; the runtime keeps\n              // answering either way, so a broadcast with no listener is\n              // normal rather than a missing-function error.\n              optional: true,\n            });\n          },\n          runtimeReady() {\n            // A new page means a new timeline clock: the runtime re-zeroes on\n            // the rising edge below, so events kept from the previous document\n            // would sit in the same buffer on a different time origin and make\n            // `recent-events`' `sinceMs` window meaningless. They also describe\n            // a page that no longer exists.\n            recentEvents.length = 0;\n\n            // Replay current state to a runtime that just booted from its\n            // defaults. Unconditional: `setRecording(false)` on a fresh page\n            // is a no-op.\n            const {layers} = session.value();\n            source.setLayers(layers);\n            source.setRecording(layers.recordingState);\n          },\n          hmrIncompatible(event) {\n            hmrIncompatibilities.push(event);\n            if (hmrIncompatibilities.length > MAX_HMR_INCOMPATIBILITIES) {\n              hmrIncompatibilities.splice(\n                0,\n                hmrIncompatibilities.length - MAX_HMR_INCOMPATIBILITIES\n              );\n            }\n            void ctx.rpc.broadcast({\n              method: `${LIT_DEVFRAME_ID}:${RPC_HMR_INCOMPATIBLE}`,\n              args: [event],\n              optional: true,\n            });\n\n            // Informational terminal echo, never a thrown error.\n            if (event.reason.code === 'accessor-decorators') {\n              hmrDiagnostics.LIT_HMR_ACCESSOR({tagName: event.tagName});\n            } else if (event.reason.code === 'patch-failed') {\n              hmrDiagnostics.LIT_HMR_PATCH_FAILED({\n                tagName: event.tagName,\n                detail: event.reason.detail,\n              });\n            } else {\n              hmrDiagnostics.LIT_HMR_ATTRS_CHANGED({tagName: event.tagName});\n            }\n          },\n        });\n\n        // Single push point for recording/layer changes: fires for the\n        // `set-recording` / `toggle-layer` actions below and for a panel\n        // mutating shared state directly through devframe's generic\n        // shared-state RPC. Immer only emits when the state reference\n        // changes, so a no-op mutate sends nothing.\n        //\n        // Clearing on the rising edge belongs here rather than in\n        // `set-recording` for the same reason: the runtime re-zeroes its\n        // timeline clock when recording turns on (`runtime/timeline/clock.ts`),\n        // so events kept from the previous recording sit in the buffer on a\n        // larger time origin than everything captured after them. A `sinceMs`\n        // window reads them as the future, and pairing a start with its end\n        // across the seam yields a negative duration. Same rationale as\n        // `runtimeReady()` above, one level finer: a new clock, not a new page.\n        let wasRecording = session.value().layers.recordingState;\n        session.on('updated', (state) => {\n          const {recordingState} = state.layers;\n          if (recordingState && !wasRecording) {\n            recentEvents.length = 0;\n          }\n          wasRecording = recordingState;\n          source.setRecording(recordingState);\n          source.setLayers(state.layers);\n        });\n      }\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_GET_META,\n          type: 'query',\n          jsonSerializable: true,\n          snapshot: true,\n          agent: {\n            description:\n              'Get the plugin version, active timeline layers, and resolved feature settings. Call once at the start of a session to learn what timeline layers exist before asking about events.',\n          },\n          handler: async (): Promise<LitGetMetaResult> => ({\n            version,\n            // `.value()` returns a deep-readonly snapshot; copy so callers\n            // get a plain, mutable `TimelineLayer[]`.\n            layers: [...TIMELINE_LAYERS, ...session.value().customLayers],\n            features: features ? features() : null,\n            stream: {\n              channel: `${LIT_DEVFRAME_ID}:${TIMELINE_STREAM_NAME}`,\n              id: TIMELINE_STREAM_ID,\n            },\n          }),\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_LIST_COMPONENTS,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'List the live Lit component tree of the inspected page. Call this before asking about a specific element to find its id.',\n          },\n          handler: async (): Promise<InspectorTreeNode[]> => cachedRoots,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_HMR_INCOMPATIBILITIES,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              \"List recent components the Lit plugin could not hot-patch in place, and why. Call this after an unexplained full-page reload during development, or when a component's state resets unexpectedly on edit.\",\n          },\n          handler: async (): Promise<HmrIncompatibilityEvent[]> =>\n            hmrIncompatibilities,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_COMPONENT_DETAILS,\n          type: 'query',\n          jsonSerializable: true,\n          agent: {\n            description:\n              'Get reactive properties, attributes, and internal state for one component by id. Call list-components first to find the id.',\n          },\n          handler: async (\n            args: ComponentDetailsArgs\n          ): Promise<InspectorDetails | null> =>\n            cachedDetails.get(args.id) ?? null,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_RECENT_EVENTS,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'Get recent timeline events (lifecycle, render, mouse, keyboard) to diagnose why a component re-rendered or updated. Call list-components first to find an element’s id, then filter by elementId to see just its events. Check the `recording` field in the response — if false, no events are being captured; ask the developer to enable Recording in the Timeline tab before retrying.',\n          },\n          // `args` is genuinely absent when an agent calls the tool with no\n          // filters — the most common call — so it must default, not just be\n          // typed optional.\n          handler: async (\n            args: RecentEventsArgs = {}\n          ): Promise<RecentEventsResult> => {\n            const recording = session.value().layers.recordingState;\n            let filtered = recentEvents;\n            if (args.layerId !== undefined) {\n              filtered = filtered.filter((e) => e.layerId === args.layerId);\n            }\n            if (args.elementId !== undefined) {\n              filtered = filtered.filter(\n                (e) => e.meta?.elementId === args.elementId\n              );\n            }\n            // Measured against the newest event in the whole buffer, not the\n            // newest *matching* one: an element that last rendered 10s ago\n            // must come back empty for `sinceMs: 1000`, not report its own\n            // stale events as if they were recent.\n            if (args.sinceMs !== undefined && recentEvents.length > 0) {\n              const newest = recentEvents[recentEvents.length - 1]!.time;\n              const cutoff = newest - args.sinceMs;\n              filtered = filtered.filter((e) => e.time >= cutoff);\n            }\n            // A frozen session's panel reads the baked no-argument call, so\n            // the agent-friendly 50/200 window would silently cut an export to\n            // its last 25 spans -- and a link to anything older would miss.\n            const limit = replay\n              ? Math.min(\n                  args.limit ?? RECENT_EVENTS_BUFFER_SIZE,\n                  RECENT_EVENTS_BUFFER_SIZE\n                )\n              : Math.min(args.limit ?? 50, 200);\n            const events = filtered.slice(-limit);\n            return {\n              recording,\n              events,\n              bufferSize: recentEvents.length,\n              truncated: events.length < filtered.length,\n            };\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_TIMELINE_HISTORY,\n          type: 'query',\n          jsonSerializable: true,\n          // Not agent-exposed (agents have `recent-events`) and not baked\n          // into a snapshot (a frozen panel reads `recent-events`, which\n          // answers a replayed session with its whole buffer). This is the\n          // live panel's seed: the stream carries nothing from before a\n          // panel subscribed, so a reloaded panel asks for it here.\n          handler: async (): Promise<TimelineEvent[]> => [...recentEvents],\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_UPDATE_SUMMARY,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and by\n          // export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'Explain component updates: which components re-rendered, how often, how long they took, and which reactive properties changed to cause each update. Prefer this over lit:recent-events for \"why did this re-render\" and \"what is re-rendering too much\" — it answers from the same recording without the caller having to pair start/end events itself. Filter to one component with tagName. Check the `recording` field — if false, no events are being captured; call lit:set-recording first.',\n          },\n          // `args` is genuinely absent when an agent calls the tool with no\n          // filters — the most common call — so it must default.\n          handler: async (\n            args: UpdateSummaryArgs = {}\n          ): Promise<UpdateSummaryResult> => {\n            const recording = session.value().layers.recordingState;\n            let events: readonly TimelineEvent[] = recentEvents;\n            // Same window semantics as `recent-events`: measured against the\n            // newest event in the whole buffer, not the newest match.\n            if (args.sinceMs !== undefined && recentEvents.length > 0) {\n              const cutoff =\n                recentEvents[recentEvents.length - 1]!.time - args.sinceMs;\n              events = recentEvents.filter((e) => e.time >= cutoff);\n            }\n            let cycles = attributeInput(\n              toUpdateCycles(toSpans(events)),\n              events\n            );\n            if (args.tagName !== undefined) {\n              cycles = cycles.filter((c) => c.tagName === args.tagName);\n            }\n            // Totals cover the whole window; only the per-cycle list is\n            // capped, so a limit never silently understates a hot component.\n            const components = rollup(cycles);\n            const limit = Math.min(args.limit ?? 50, 200);\n            const limited = cycles.slice(-limit);\n            return {\n              recording,\n              components,\n              cycles: limited,\n              bufferSize: recentEvents.length,\n              truncated: limited.length < cycles.length,\n            };\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_INSPECT,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (command: InspectorCommand): Promise<void> => {\n            // \"Pick\" starts the overlay's inspect picker, which the host\n            // toggles in the page rather than answering from the runtime.\n            if (command.type === 'pick') {\n              source.toggleOverlay();\n              return;\n            }\n            source.sendInspector(command);\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_SET_RECORDING,\n          type: 'action',\n          jsonSerializable: true,\n          // The one agent-exposed mutation. `recent-events` is a dead end\n          // when recording is off, so an agent that can read the timeline\n          // but never start it just hands the question back to the human.\n          // Deliberately still the *only* one: the picker and layer toggles\n          // stay panel-only.\n          agent: {\n            description:\n              'Start or stop timeline recording. This is a shared toggle: turning it on also affects the DevTools panel if a developer has it open. Call this if lit:recent-events reports `recording: false`.',\n          },\n          handler: async (args: SetRecordingArgs): Promise<void> => {\n            session.mutate((state) => {\n              state.layers.recordingState = args.recording;\n            });\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_TOGGLE_LAYER,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (args: ToggleLayerArgs): Promise<void> => {\n            const flag = LAYER_FLAGS[args.layerId];\n            // Custom layers have no capture flag to toggle — app code owns\n            // whether it emits at all.\n            if (!flag) return;\n            session.mutate((state) => {\n              state.layers[flag] = args.enabled;\n            });\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_SET_SETTINGS_OVERRIDE,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (override: SettingsOverride): Promise<void> => {\n            source.setSettingsOverride(override);\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_OPEN_SOURCE,\n          type: 'action',\n          jsonSerializable: true,\n          // Resolving here rather than in the panel is the whole point of\n          // the hop: `file` is relative to the Vite root, while the open\n          // service resolves relative paths against the host's\n          // `workspaceRoot` -- in a monorepo (or any setup where the served\n          // app isn't the workspace) those are different directories, and\n          // `launchEditor` silently does nothing for a path that doesn't\n          // exist. Not agent-exposed: it spawns a GUI process.\n          handler: async (args: OpenSourceArgs): Promise<OpenSourceResult> => {\n            const service = ctx.services.get('@devframes/service-open');\n            if (service === undefined) return {opened: false};\n            const {isAbsolute, resolve} = await import('node:path');\n            const root = sourceRoot?.();\n            const path =\n              root !== undefined && !isAbsolute(args.file)\n                ? resolve(root, args.file)\n                : args.file;\n            const override = await my.settings.global.get('override');\n            await service.openInEditor({\n              path,\n              line: args.line,\n              editor: resolveLaunchEditor(configuredEditor?.(), override),\n            });\n            return {opened: true};\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_EXPORT_SNAPSHOT,\n          type: 'action',\n          jsonSerializable: true,\n          // Not agent-exposed. It writes a directory to the developer's disk,\n          // which is not something a coding agent should be able to do behind\n          // their back -- same reasoning as the other mutating actions.\n          handler: async (\n            args: ExportSnapshotArgs\n          ): Promise<ExportSnapshotResult> => {\n            // Imported here, not at module scope: this file has to keep\n            // loading in contexts with no filesystem, and the build adapter\n            // it pulls in reaches straight for `node:fs`.\n            const {buildSnapshot} = await import('../snapshot.js');\n            return buildSnapshot(\n              {\n                capturedAt: new Date().toISOString(),\n                version,\n                customLayers: [...session.value().customLayers],\n                roots: cachedRoots,\n                details: [...cachedDetails.values()],\n                events: [...recentEvents],\n                hmrIncompatibilities: [...hmrIncompatibilities],\n              },\n              {\n                outDir: args.outDir ?? 'lit-devtools-snapshot',\n                features: features ? features() : null,\n                clientAssets: options.clientAssets,\n              }\n            );\n          },\n        })\n      );\n    },\n  });\n}\n\nexport default createLitDevframe({\n  source: createNullSource(),\n  version: '0.0.0',\n});\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/lib/devframe/definition.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The framework-neutral Lit devframe: RPC functions, shared state, and the\n * timeline stream. Talks to the page runtime only through the injected\n * {@link TimelineSource} port, so it runs unchanged under `createDevServer()`,\n * `createBuild()`, or an MCP server with no Vite in the loop. `vite.ts` wires\n * the real page-runtime bridge and mounts this via `createPluginFromDevframe`.\n *\n * @see plans/devframe-foundation.md\n */\n\nimport {defineDevframe, defineRpcFunction} from 'devframe';\n// Type-only: brings in the service's `declare module 'devframe'`\n// augmentation so `ctx.services.get()` types its API. Nothing is\n// imported at runtime, and the service is consumed, never installed\n// here -- a Vite hub already has it (see `panel/open-in-editor.ts`).\nimport type {} from '@devframes/service-open';\nimport type {DevframeDefinition, DevframeNodeContext} from 'devframe';\nimport type {\n  InspectorCommand,\n  InspectorDetails,\n  InspectorTreeNode,\n} from '../../types/inspector.js';\nimport {TIMELINE_LAYERS} from '../../types/timeline.js';\nimport {MAX_HMR_INCOMPATIBILITIES} from '../../types/hmr-incompatibility.js';\nimport type {HmrIncompatibilityEvent} from '../../types/hmr-incompatibility.js';\nimport {LIT_LOGO_ICON} from './icon.js';\nimport {PANEL_DIST_DIR} from './paths.js';\nimport type {\n  FeatureSettings,\n  SettingsOverride,\n  TimelineEvent,\n} from '../../types/timeline.js';\nimport {\n  DEFAULT_SESSION_STATE,\n  LAYER_FLAGS,\n  LIT_DEVFRAME_ID,\n  RECENT_EVENTS_BUFFER_SIZE,\n  RPC_COMPONENT_DETAILS,\n  RPC_GET_META,\n  RPC_HMR_INCOMPATIBILITIES,\n  RPC_HMR_INCOMPATIBLE,\n  RPC_INSPECT,\n  RPC_INSPECTOR_MESSAGE,\n  RPC_LIST_COMPONENTS,\n  RPC_RECENT_EVENTS,\n  RPC_TIMELINE_HISTORY,\n  RPC_SET_RECORDING,\n  RPC_EXPORT_SNAPSHOT,\n  RPC_OPEN_SOURCE,\n  RPC_SET_SETTINGS_OVERRIDE,\n  RPC_TOGGLE_LAYER,\n  RPC_UPDATE_SUMMARY,\n  SESSION_STATE_KEY,\n  TIMELINE_STREAM_ID,\n  TIMELINE_STREAM_NAME,\n  type ComponentDetailsArgs,\n  type LitGetMetaResult,\n  type RecentEventsArgs,\n  type RecentEventsResult,\n  type SessionState,\n  type ExportSnapshotArgs,\n  type ExportSnapshotResult,\n  type OpenSourceArgs,\n  type OpenSourceResult,\n  type SetRecordingArgs,\n  type ToggleLayerArgs,\n  type UpdateSummaryArgs,\n  type UpdateSummaryResult,\n} from './protocol.js';\nimport {\n  attributeInput,\n  rollup,\n  toSpans,\n  toUpdateCycles,\n} from '../timeline/derive.js';\nimport {resolveLaunchEditor} from './launch-editor.js';\nimport {createNullSource, type TimelineSource} from './source.js';\nimport type {SessionSnapshot} from '../../types/snapshot.js';\n\nexport interface CreateLitDevframeOptions {\n  /** Page-runtime bridge. Use {@link createNullSource} when no page is attached. */\n  source: TimelineSource;\n  /** Plugin version, surfaced by `get-meta` and the devframe's own `version`. */\n  version: string;\n  /** Resolved feature settings, surfaced by `get-meta`. */\n  features?: () => FeatureSettings | null;\n  /**\n   * Directory holding the built panel SPA. Defaults to the package's own\n   * `dist/client`; the dev-time panel build points it elsewhere.\n   */\n  clientAssets?: string;\n  /**\n   * Absolute directory the injected `ElementSource.file` paths are relative\n   * to (the Vite root). Read per call, since a host only knows it once its\n   * dev server is up. Also the first root `open-source` confines opens to;\n   * without it, relative paths resolve against the working directory.\n   */\n  sourceRoot?: () => string | undefined;\n  /**\n   * Further directories `open-source` may open files beneath, beyond\n   * `sourceRoot` (the Vite host passes `server.fs.allow`, where sibling\n   * packages of a monorepo live). Read per call. A path outside every root\n   * is refused; with neither this nor `sourceRoot`, the process's working\n   * directory is the only root.\n   */\n  allowedRoots?: () => readonly string[];\n  /**\n   * The editor key the developer named in config or env\n   * (`sourceOverlay.editor`), or `undefined` when they never did. Read per\n   * call. `open-source` maps it, or the panel's override of it, to a\n   * `launch-editor` command; without either the editor is auto-detected.\n   */\n  configuredEditor?: () => string | undefined;\n  /**\n   * Boot from a recorded session instead of a live one. Set only by the\n   * static-snapshot build (see `lib/snapshot.ts`): the caches below start\n   * populated, so the frozen panel has a timeline and a component tree to\n   * render with no page and no dev server behind it.\n   */\n  replay?: SessionSnapshot;\n}\n\n/**\n * Builds the Lit devframe definition. Framework-neutral: everything here\n * runs the same whether the host is Vite (`vite.ts`), a standalone dev\n * server, a static build, or an MCP server.\n */\nexport function createLitDevframe(\n  options: CreateLitDevframeOptions\n): DevframeDefinition {\n  const {\n    source,\n    version,\n    features,\n    replay,\n    sourceRoot,\n    allowedRoots,\n    configuredEditor,\n  } = options;\n\n  return defineDevframe({\n    id: LIT_DEVFRAME_ID,\n    name: 'Lit',\n    description: 'Timeline recorder and component inspector for Lit apps.',\n    version,\n    packageName: '@oddsquad/vite-plugin-lit',\n    homepage: 'https://oddcelot.github.io/vite-plugin-lit/',\n    importMetaUrl: import.meta.url,\n    icon: LIT_LOGO_ICON,\n    dock: {category: 'framework'},\n    clientAssets: options.clientAssets ?? PANEL_DIST_DIR,\n\n    // `component-details` takes an id, so `snapshot: true` (which bakes the\n    // no-argument call) cannot express it. Bake one record per component the\n    // session actually opened -- the only ids that have details to freeze.\n    rpc: replay\n      ? {\n          snapshot: [\n            {\n              method: `${LIT_DEVFRAME_ID}:${RPC_COMPONENT_DETAILS}`,\n              inputs: replay.details.map((d) => [{id: d.id}]),\n            },\n          ],\n        }\n      : undefined,\n\n    async setup(ctx: DevframeNodeContext) {\n      const my = ctx.scope(LIT_DEVFRAME_ID);\n\n      // Bind the per-user settings store before any panel can connect.\n      // Both sides build it lazily on first access, but only this one backs\n      // it with a JSON file -- a client that asks first gets a plain\n      // in-memory shared state instead, so the panel's preferences would\n      // round-trip happily and then vanish on restart. The panel is the only\n      // thing that reads or writes these (see `panel/devtools-settings.ts`);\n      // this call exists purely to make them durable.\n      await my.settings.global.all();\n\n      const session = await my.rpc.sharedState<SessionState>(\n        SESSION_STATE_KEY,\n        {\n          initialValue: replay\n            ? {\n                ...DEFAULT_SESSION_STATE,\n                // Recorded events carry layer ids; without the custom layers\n                // that produced them the frozen panel would show a filter it\n                // cannot name.\n                customLayers: replay.customLayers,\n              }\n            : DEFAULT_SESSION_STATE,\n        }\n      );\n\n      // Latest inspector snapshot, cached so a panel that (re)connects after\n      // the runtime already answered can read it without round-tripping to\n      // the page again. Pre-filled when replaying: there is no page to ask.\n      let cachedRoots: InspectorTreeNode[] = replay ? [...replay.roots] : [];\n      const cachedDetails = new Map<number, InspectorDetails>(\n        replay?.details.map((d) => [d.id, d])\n      );\n\n      // Bounded history for the `recent-events` agent query and the panel's\n      // `timeline-history` seed. A plain array, not devframe's internal\n      // per-stream replay buffer, which devframe marks `@internal` (see\n      // plans/roadmap/02-agent-timeline-access.md).\n      const recentEvents: TimelineEvent[] = replay ? [...replay.events] : [];\n\n      // Event ids: `${epoch}-${seq}`. The epoch is the session start, so a\n      // restarted dev server can never reissue an id an older snapshot holds;\n      // the seq is monotonic across Clear. Stamped here, once, because this is\n      // the only place every consumer (stream, `recent-events`, export) shares.\n      // A replayed session never reaches `pushEvents`, so its ids are kept.\n      const eventEpoch = Date.now().toString(36);\n      let eventSeq = 0;\n\n      // Recent HMR-incompatibility notices, capped the same way\n      // `runtime/timeline/transport.ts` caps its pending queue — a long\n      // session with many failing edits must not grow this forever.\n      const hmrIncompatibilities: HmrIncompatibilityEvent[] = replay\n        ? [...replay.hmrIncompatibilities]\n        : [];\n\n      // Terminal echo for an audience that only sees dev-server stdout (an\n      // agent, or a CI log) and not the browser console or the panel.\n      // Fire-and-log only — the cache above is the read-back store.\n      const hmrDiagnostics = ctx.diagnostics.defineDiagnostics({\n        docsBase:\n          'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/',\n        codes: {\n          LIT_HMR_ACCESSOR: {\n            why: (p: {tagName: string}) =>\n              `<${p.tagName}> can't be hot-patched: standard accessor decorators`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n          LIT_HMR_PATCH_FAILED: {\n            why: (p: {tagName: string; detail: string}) =>\n              `<${p.tagName}> can't be hot-patched: ${p.detail}`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n          LIT_HMR_ATTRS_CHANGED: {\n            why: (p: {tagName: string}) =>\n              `<${p.tagName}> changed observedAttributes; reload recommended`,\n            docs: 'https://oddcelot.github.io/vite-plugin-lit/reference/limitations/#cannot-be-patched-in-place',\n          },\n        },\n      });\n      ctx.diagnostics.register(hmrDiagnostics);\n\n      // Streaming/source wiring only makes sense for a live session: a\n      // static build or MCP run has no page attached (its `source` is a\n      // `createNullSource()`), and `ctx.mode` is 'build' there.\n      if (ctx.mode === 'dev') {\n        // No `replayWindow`: a subscriber would be replayed the whole buffer\n        // in separate chunks, including batches from before the last\n        // recording started (a different clock) and ones the panel's Clear\n        // dropped, and the node has no way to forget them. A connecting panel\n        // is seeded from `timeline-history` instead, which is `recentEvents`,\n        // cleared on the same edges.\n        const channel =\n          my.rpc.streaming.create<TimelineEvent[]>(TIMELINE_STREAM_NAME);\n        // Started eagerly, not on the first event: `streaming:subscribe` is\n        // fire-and-forget on the wire, and a subscribe naming a stream id\n        // that does not exist yet is dropped with a DF0030 diagnostic rather\n        // than queued. The panel subscribes as soon as it connects, which is\n        // normally long before the first event, so the stream has to be\n        // there waiting. `??` covers a re-start if the transport aborted it\n        // after the last subscriber left.\n        channel.start({id: TIMELINE_STREAM_ID});\n        const ensureStream = () =>\n          channel.get(TIMELINE_STREAM_ID) ??\n          channel.start({id: TIMELINE_STREAM_ID});\n\n        source.attach({\n          pushEvents(incoming) {\n            if (incoming.length === 0) return;\n            const events = incoming.map((event) => ({\n              ...event,\n              id: event.id ?? `${eventEpoch}-${eventSeq++}`,\n            }));\n            ensureStream().write(events);\n            recentEvents.push(...events);\n            if (recentEvents.length > RECENT_EVENTS_BUFFER_SIZE) {\n              recentEvents.splice(\n                0,\n                recentEvents.length - RECENT_EVENTS_BUFFER_SIZE\n              );\n            }\n          },\n          addLayer(layer) {\n            session.mutate((state) => {\n              if (\n                !state.customLayers.some((existing) => existing.id === layer.id)\n              ) {\n                state.customLayers.push(layer);\n              }\n            });\n          },\n          inspectorMessage(message) {\n            if (message.type === 'tree') {\n              cachedRoots = message.roots;\n            } else if (message.type === 'details') {\n              cachedDetails.set(message.details.id, message.details);\n            } else if (message.type === 'gone') {\n              cachedDetails.delete(message.id);\n            }\n            void ctx.rpc.broadcast({\n              method: `${LIT_DEVFRAME_ID}:${RPC_INSPECTOR_MESSAGE}`,\n              args: [message],\n              // A page can be open with no panel docked; the runtime keeps\n              // answering either way, so a broadcast with no listener is\n              // normal rather than a missing-function error.\n              optional: true,\n            });\n          },\n          runtimeReady() {\n            // A new page means a new timeline clock: the runtime re-zeroes on\n            // the rising edge below, so events kept from the previous document\n            // would sit in the same buffer on a different time origin and make\n            // `recent-events`' `sinceMs` window meaningless. They also describe\n            // a page that no longer exists.\n            recentEvents.length = 0;\n\n            // Replay current state to a runtime that just booted from its\n            // defaults. Unconditional: `setRecording(false)` on a fresh page\n            // is a no-op.\n            const {layers} = session.value();\n            source.setLayers(layers);\n            source.setRecording(layers.recordingState);\n          },\n          hmrIncompatible(event) {\n            hmrIncompatibilities.push(event);\n            if (hmrIncompatibilities.length > MAX_HMR_INCOMPATIBILITIES) {\n              hmrIncompatibilities.splice(\n                0,\n                hmrIncompatibilities.length - MAX_HMR_INCOMPATIBILITIES\n              );\n            }\n            void ctx.rpc.broadcast({\n              method: `${LIT_DEVFRAME_ID}:${RPC_HMR_INCOMPATIBLE}`,\n              args: [event],\n              optional: true,\n            });\n\n            // Informational terminal echo, never a thrown error.\n            if (event.reason.code === 'accessor-decorators') {\n              hmrDiagnostics.LIT_HMR_ACCESSOR({tagName: event.tagName});\n            } else if (event.reason.code === 'patch-failed') {\n              hmrDiagnostics.LIT_HMR_PATCH_FAILED({\n                tagName: event.tagName,\n                detail: event.reason.detail,\n              });\n            } else {\n              hmrDiagnostics.LIT_HMR_ATTRS_CHANGED({tagName: event.tagName});\n            }\n          },\n        });\n\n        // Single push point for recording/layer changes: fires for the\n        // `set-recording` / `toggle-layer` actions below and for a panel\n        // mutating shared state directly through devframe's generic\n        // shared-state RPC. Immer only emits when the state reference\n        // changes, so a no-op mutate sends nothing.\n        //\n        // Clearing on the rising edge belongs here rather than in\n        // `set-recording` for the same reason: the runtime re-zeroes its\n        // timeline clock when recording turns on (`runtime/timeline/clock.ts`),\n        // so events kept from the previous recording sit in the buffer on a\n        // larger time origin than everything captured after them. A `sinceMs`\n        // window reads them as the future, and pairing a start with its end\n        // across the seam yields a negative duration. Same rationale as\n        // `runtimeReady()` above, one level finer: a new clock, not a new page.\n        let wasRecording = session.value().layers.recordingState;\n        session.on('updated', (state) => {\n          const {recordingState} = state.layers;\n          if (recordingState && !wasRecording) {\n            recentEvents.length = 0;\n          }\n          wasRecording = recordingState;\n          source.setRecording(recordingState);\n          source.setLayers(state.layers);\n        });\n      }\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_GET_META,\n          type: 'query',\n          jsonSerializable: true,\n          snapshot: true,\n          agent: {\n            description:\n              'Get the plugin version, active timeline layers, and resolved feature settings. Call once at the start of a session to learn what timeline layers exist before asking about events.',\n          },\n          handler: async (): Promise<LitGetMetaResult> => ({\n            version,\n            // `.value()` returns a deep-readonly snapshot; copy so callers\n            // get a plain, mutable `TimelineLayer[]`.\n            layers: [...TIMELINE_LAYERS, ...session.value().customLayers],\n            features: features ? features() : null,\n            stream: {\n              channel: `${LIT_DEVFRAME_ID}:${TIMELINE_STREAM_NAME}`,\n              id: TIMELINE_STREAM_ID,\n            },\n          }),\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_LIST_COMPONENTS,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'List the live Lit component tree of the inspected page. Call this before asking about a specific element to find its id.',\n          },\n          handler: async (): Promise<InspectorTreeNode[]> => cachedRoots,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_HMR_INCOMPATIBILITIES,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              \"List recent components the Lit plugin could not hot-patch in place, and why. Call this after an unexplained full-page reload during development, or when a component's state resets unexpectedly on edit.\",\n          },\n          handler: async (): Promise<HmrIncompatibilityEvent[]> =>\n            hmrIncompatibilities,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_COMPONENT_DETAILS,\n          type: 'query',\n          jsonSerializable: true,\n          agent: {\n            description:\n              'Get reactive properties, attributes, and internal state for one component by id. Call list-components first to find the id.',\n          },\n          handler: async (\n            args: ComponentDetailsArgs\n          ): Promise<InspectorDetails | null> =>\n            cachedDetails.get(args.id) ?? null,\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_RECENT_EVENTS,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and\n          // by export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'Get recent timeline events (lifecycle, render, mouse, keyboard) to diagnose why a component re-rendered or updated. Call list-components first to find an element’s id, then filter by elementId to see just its events. Check the `recording` field in the response — if false, no events are being captured; ask the developer to enable Recording in the Timeline tab before retrying.',\n          },\n          // `args` is genuinely absent when an agent calls the tool with no\n          // filters — the most common call — so it must default, not just be\n          // typed optional.\n          handler: async (\n            args: RecentEventsArgs = {}\n          ): Promise<RecentEventsResult> => {\n            const recording = session.value().layers.recordingState;\n            let filtered = recentEvents;\n            if (args.layerId !== undefined) {\n              filtered = filtered.filter((e) => e.layerId === args.layerId);\n            }\n            if (args.elementId !== undefined) {\n              filtered = filtered.filter(\n                (e) => e.meta?.elementId === args.elementId\n              );\n            }\n            // Measured against the newest event in the whole buffer, not the\n            // newest *matching* one: an element that last rendered 10s ago\n            // must come back empty for `sinceMs: 1000`, not report its own\n            // stale events as if they were recent.\n            if (args.sinceMs !== undefined && recentEvents.length > 0) {\n              const newest = recentEvents[recentEvents.length - 1]!.time;\n              const cutoff = newest - args.sinceMs;\n              filtered = filtered.filter((e) => e.time >= cutoff);\n            }\n            // A frozen session's panel reads the baked no-argument call, so\n            // the agent-friendly 50/200 window would silently cut an export to\n            // its last 25 spans -- and a link to anything older would miss.\n            const limit = replay\n              ? Math.min(\n                  args.limit ?? RECENT_EVENTS_BUFFER_SIZE,\n                  RECENT_EVENTS_BUFFER_SIZE\n                )\n              : Math.min(args.limit ?? 50, 200);\n            const events = filtered.slice(-limit);\n            return {\n              recording,\n              events,\n              bufferSize: recentEvents.length,\n              truncated: events.length < filtered.length,\n            };\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_TIMELINE_HISTORY,\n          type: 'query',\n          jsonSerializable: true,\n          // Not agent-exposed (agents have `recent-events`) and not baked\n          // into a snapshot (a frozen panel reads `recent-events`, which\n          // answers a replayed session with its whole buffer). This is the\n          // live panel's seed: the stream carries nothing from before a\n          // panel subscribed, so a reloaded panel asks for it here.\n          handler: async (): Promise<TimelineEvent[]> => [...recentEvents],\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_UPDATE_SUMMARY,\n          type: 'query',\n          jsonSerializable: true,\n          // Baked into a static snapshot: takes no required arguments, and by\n          // export time its answer is exactly what the session recorded.\n          snapshot: true,\n          agent: {\n            description:\n              'Explain component updates: which components re-rendered, how often, how long they took, and which reactive properties changed to cause each update. Prefer this over lit:recent-events for \"why did this re-render\" and \"what is re-rendering too much\" — it answers from the same recording without the caller having to pair start/end events itself. Filter to one component with tagName. Check the `recording` field — if false, no events are being captured; call lit:set-recording first.',\n          },\n          // `args` is genuinely absent when an agent calls the tool with no\n          // filters — the most common call — so it must default.\n          handler: async (\n            args: UpdateSummaryArgs = {}\n          ): Promise<UpdateSummaryResult> => {\n            const recording = session.value().layers.recordingState;\n            let events: readonly TimelineEvent[] = recentEvents;\n            // Same window semantics as `recent-events`: measured against the\n            // newest event in the whole buffer, not the newest match.\n            if (args.sinceMs !== undefined && recentEvents.length > 0) {\n              const cutoff =\n                recentEvents[recentEvents.length - 1]!.time - args.sinceMs;\n              events = recentEvents.filter((e) => e.time >= cutoff);\n            }\n            let cycles = attributeInput(\n              toUpdateCycles(toSpans(events)),\n              events\n            );\n            if (args.tagName !== undefined) {\n              cycles = cycles.filter((c) => c.tagName === args.tagName);\n            }\n            // Totals cover the whole window; only the per-cycle list is\n            // capped, so a limit never silently understates a hot component.\n            const components = rollup(cycles);\n            const limit = Math.min(args.limit ?? 50, 200);\n            const limited = cycles.slice(-limit);\n            return {\n              recording,\n              components,\n              cycles: limited,\n              bufferSize: recentEvents.length,\n              truncated: limited.length < cycles.length,\n            };\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_INSPECT,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (command: InspectorCommand): Promise<void> => {\n            // \"Pick\" starts the overlay's inspect picker, which the host\n            // toggles in the page rather than answering from the runtime.\n            if (command.type === 'pick') {\n              source.toggleOverlay();\n              return;\n            }\n            source.sendInspector(command);\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_SET_RECORDING,\n          type: 'action',\n          jsonSerializable: true,\n          // The one agent-exposed mutation. `recent-events` is a dead end\n          // when recording is off, so an agent that can read the timeline\n          // but never start it just hands the question back to the human.\n          // Deliberately still the *only* one: the picker and layer toggles\n          // stay panel-only.\n          agent: {\n            description:\n              'Start or stop timeline recording. This is a shared toggle: turning it on also affects the DevTools panel if a developer has it open. Call this if lit:recent-events reports `recording: false`.',\n          },\n          handler: async (args: SetRecordingArgs): Promise<void> => {\n            session.mutate((state) => {\n              state.layers.recordingState = args.recording;\n            });\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_TOGGLE_LAYER,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (args: ToggleLayerArgs): Promise<void> => {\n            const flag = LAYER_FLAGS[args.layerId];\n            // Custom layers have no capture flag to toggle — app code owns\n            // whether it emits at all.\n            if (!flag) return;\n            session.mutate((state) => {\n              state.layers[flag] = args.enabled;\n            });\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_SET_SETTINGS_OVERRIDE,\n          type: 'action',\n          jsonSerializable: true,\n          handler: async (override: SettingsOverride): Promise<void> => {\n            source.setSettingsOverride(override);\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_OPEN_SOURCE,\n          type: 'action',\n          jsonSerializable: true,\n          // Resolving here rather than in the panel is the whole point of\n          // the hop: `file` is relative to the Vite root, while the open\n          // service resolves relative paths against the host's\n          // `workspaceRoot` -- in a monorepo (or any setup where the served\n          // app isn't the workspace) those are different directories, and\n          // `launchEditor` silently does nothing for a path that doesn't\n          // exist. Not agent-exposed: it spawns a GUI process.\n          handler: async (args: OpenSourceArgs): Promise<OpenSourceResult> => {\n            const service = ctx.services.get('@devframes/service-open');\n            if (service === undefined) return {opened: false};\n            // Confined like `/__lit-open-in-editor`: whatever can reach this\n            // RPC could otherwise have the editor open any file on disk.\n            const {confineToRoots} = await import('../confine.js');\n            const confined = confineToRoots(\n              [sourceRoot?.() ?? process.cwd(), ...(allowedRoots?.() ?? [])],\n              args.file\n            );\n            if ('failure' in confined) return {opened: false};\n            const {path} = confined;\n            const override = await my.settings.global.get('override');\n            await service.openInEditor({\n              path,\n              line: args.line,\n              editor: resolveLaunchEditor(configuredEditor?.(), override),\n            });\n            return {opened: true};\n          },\n        })\n      );\n\n      my.rpc.register(\n        defineRpcFunction({\n          name: RPC_EXPORT_SNAPSHOT,\n          type: 'action',\n          jsonSerializable: true,\n          // Not agent-exposed. It writes a directory to the developer's disk,\n          // which is not something a coding agent should be able to do behind\n          // their back -- same reasoning as the other mutating actions.\n          handler: async (\n            args: ExportSnapshotArgs\n          ): Promise<ExportSnapshotResult> => {\n            // Imported here, not at module scope: this file has to keep\n            // loading in contexts with no filesystem, and the build adapter\n            // it pulls in reaches straight for `node:fs`.\n            const {buildSnapshot} = await import('../snapshot.js');\n            // `outDir` comes from the client and the build deletes it before\n            // writing, so it has to land strictly beneath the working\n            // directory -- never the directory itself, and never elsewhere\n            // on disk.\n            const {resolve, sep} = await import('node:path');\n            const cwd = process.cwd();\n            const outDir = resolve(cwd, args.outDir ?? 'lit-devtools-snapshot');\n            if (!outDir.startsWith(cwd + sep)) {\n              throw new Error(\n                `[lit-devtools] export-snapshot: outDir must be inside ${cwd}`\n              );\n            }\n            return buildSnapshot(\n              {\n                capturedAt: new Date().toISOString(),\n                version,\n                customLayers: [...session.value().customLayers],\n                roots: cachedRoots,\n                details: [...cachedDetails.values()],\n                events: [...recentEvents],\n                hmrIncompatibilities: [...hmrIncompatibilities],\n              },\n              {\n                outDir,\n                features: features ? features() : null,\n                clientAssets: options.clientAssets,\n              }\n            );\n          },\n        })\n      );\n    },\n  });\n}\n\nexport default createLitDevframe({\n  source: createNullSource(),\n  version: '0.0.0',\n});\n"]}

package/lib/devframe/protocol.d.ts

@@ -65,7 +65,9 @@ export interface OpenSourceArgs {
 export interface OpenSourceResult {
     /**
      * False when no open service is installed on the host, which is the
-     * panel's cue to fall back to `/__lit-open-in-editor`.
+     * panel's cue to fall back to `/__lit-open-in-editor`. Also false when the
+     * file is missing or outside the allowed roots; the endpoint refuses those
+     * paths too.
      */
     opened: boolean;
 }
@@ -74,8 +76,10 @@ export declare const RPC_EXPORT_SNAPSHOT = "export-snapshot";
 /** Arguments for {@link RPC_EXPORT_SNAPSHOT}. */
 export interface ExportSnapshotArgs {
     /**
-     * Where to write. Relative paths resolve against the dev server's cwd.
-     * Defaults to `lit-devtools-snapshot`.
+     * Where to write. Relative paths resolve against the dev server's cwd,
+     * and the result has to stay beneath it. Defaults to
+     * `lit-devtools-snapshot`. An existing directory is only replaced when it
+     * holds an earlier snapshot.
      */
     outDir?: string;
 }

package/lib/devframe/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/protocol.ts"],"names":[],"mappings":"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"}

package/lib/devframe/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/lib/devframe/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAC,oBAAoB,EAAC,MAAM,yBAAyB,CAAC;AAkB7D,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,uDAAuD;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAqB7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAmBrD,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,sDAAsD;AACtD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAkB/C,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,MAAM,EAAE,oBAAoB;IAC5B,YAAY,EAAE,EAAE;CACjB,CAAC;AAiFF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB;IACE,eAAe,EAAE,qBAAqB;IACtC,YAAY,EAAE,kBAAkB;IAChC,oBAAoB,EAAE,yBAAyB;IAC/C,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,sBAAsB;CACjC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared wire contract between the Lit devframe's node-side definition\n * ({@link ../definition.ts}) and its panel: shared-state / streaming /\n * RPC-function names, their payload shapes, and the `devframe` registry\n * augmentations that type them end to end.\n *\n * @see plans/devframe-foundation.md\n */\n\nimport {DEFAULT_LAYERS_STATE} from '../../types/timeline.js';\nimport type {\n  FeatureSettings,\n  OverrideBaselines,\n  SettingsOverride,\n  TimelineEvent,\n  TimelineLayer,\n  TimelineLayersState,\n} from '../../types/timeline.js';\nimport type {\n  InspectorCommand,\n  InspectorDetails,\n  InspectorMessage,\n  InspectorTreeNode,\n} from '../../types/inspector.js';\nimport type {HmrIncompatibilityEvent} from '../../types/hmr-incompatibility.js';\nimport type {ComponentRollup, UpdateCycle} from '../timeline/derive.js';\n\n/** The devframe's scope id. RPC names become `lit:*`, MCP wire names `lit_*`. */\nexport const LIT_DEVFRAME_ID = 'lit';\n\n/** Shared-state key holding the {@link SessionState} snapshot. */\nexport const SESSION_STATE_KEY = 'session';\n\n/** Streaming channel name the timeline event batches are pushed on. */\nexport const TIMELINE_STREAM_NAME = 'timeline';\n\n/**\n * Id of the one long-lived timeline stream. Fixed rather than discovered:\n * there is exactly one page feed per dev session, so the panel can subscribe\n * without a round trip to look the id up. The node side re-`start()`s this id\n * if the transport dropped the stream after the last subscriber left.\n */\nexport const TIMELINE_STREAM_ID = 'live';\n\n/**\n * Cap on the node-side recent-events ring buffer. It is also the history a\n * (re)connecting panel is seeded with (see {@link RPC_TIMELINE_HISTORY}).\n */\nexport const RECENT_EVENTS_BUFFER_SIZE = 512;\n\n/** Bare (unscoped) name of the `get-meta` query. */\nexport const RPC_GET_META = 'get-meta';\n\n/** Bare name of the `list-components` query. */\nexport const RPC_LIST_COMPONENTS = 'list-components';\n\n/** Bare name of the `component-details` query. */\nexport const RPC_COMPONENT_DETAILS = 'component-details';\n\n/** Bare name of the `recent-events` query. */\nexport const RPC_RECENT_EVENTS = 'recent-events';\n\n/**\n * Bare name of the `timeline-history` query: the node's whole recent-events\n * buffer, oldest first, as `TimelineEvent[]`. What a live panel seeds itself\n * with on connect, since the stream only carries events from then on. Not\n * `recent-events`, whose live answer is filtered and capped for agents.\n */\nexport const RPC_TIMELINE_HISTORY = 'timeline-history';\n\n/** Bare name of the `update-summary` query. */\nexport const RPC_UPDATE_SUMMARY = 'update-summary';\n\n/** Bare name of the `inspect` action. */\nexport const RPC_INSPECT = 'inspect';\n\n/** Bare name of the `set-recording` action. */\nexport const RPC_SET_RECORDING = 'set-recording';\n\n/** Bare name of the `toggle-layer` action. */\nexport const RPC_TOGGLE_LAYER = 'toggle-layer';\n\n/** Bare name of the `set-settings-override` action. */\nexport const RPC_SET_SETTINGS_OVERRIDE = 'set-settings-override';\n\n/** Bare name of the `open-source` action. */\nexport const RPC_OPEN_SOURCE = 'open-source';\n\n/** Arguments for {@link RPC_OPEN_SOURCE}. */\nexport interface OpenSourceArgs {\n  /**\n   * The path as the panel has it: what the transform injected, so relative\n   * to the Vite root (or absolute, when the file lives outside it).\n   */\n  file: string;\n  line?: number;\n}\n\n/** What {@link RPC_OPEN_SOURCE} reports back. */\nexport interface OpenSourceResult {\n  /**\n   * False when no open service is installed on the host, which is the\n   * panel's cue to fall back to `/__lit-open-in-editor`.\n   */\n  opened: boolean;\n}\n\n/** Freeze the current session into a static panel directory. */\nexport const RPC_EXPORT_SNAPSHOT = 'export-snapshot';\n\n/** Arguments for {@link RPC_EXPORT_SNAPSHOT}. */\nexport interface ExportSnapshotArgs {\n  /**\n   * Where to write. Relative paths resolve against the dev server's cwd.\n   * Defaults to `lit-devtools-snapshot`.\n   */\n  outDir?: string;\n}\n\n/** What {@link RPC_EXPORT_SNAPSHOT} reports back, for the panel to display. */\nexport interface ExportSnapshotResult {\n  outDir: string;\n  events: number;\n  components: number;\n  details: number;\n}\n\n/** Bare name of the `inspector-message` client (node → panel) event. */\nexport const RPC_INSPECTOR_MESSAGE = 'inspector-message';\n\n/** Bare name of the `hmr-incompatibilities` query. */\nexport const RPC_HMR_INCOMPATIBILITIES = 'hmr-incompatibilities';\n\n/** Bare name of the `hmr-incompatible` client (node → panel) event. */\nexport const RPC_HMR_INCOMPATIBLE = 'hmr-incompatible';\n\n/**\n * Bare name of the page-to-server event. A page runtime that is not on a Vite\n * dev server's HMR socket sends every channel message it would have sent over\n * `import.meta.hot` as `page-send(channel, data)`.\n */\nexport const RPC_PAGE_SEND = 'page-send';\n\n/**\n * Bare name of the server-to-page client event, the reverse direction of\n * {@link RPC_PAGE_SEND}: `page-receive(channel, data)`. Broadcast to every\n * connected client and marked optional, since the panel does not register it.\n */\nexport const RPC_PAGE_RECEIVE = 'page-receive';\n\n/**\n * Recording/layers snapshot shared between every surface (panel, page\n * runtime, MCP). Survives reconnect; mutated either by the `set-recording` /\n * `toggle-layer` actions below or directly by a panel through the generic\n * shared-state RPC devframe provides.\n *\n * `layers.recordingState` is the single authority for \"is recording\" — the\n * runtime's own layer state carries it, so a separate flag here would be a\n * second copy to keep in sync.\n */\nexport interface SessionState {\n  layers: TimelineLayersState;\n  /** Layers announced at runtime by app code through `addTimelineLayer()`. */\n  customLayers: TimelineLayer[];\n}\n\nexport const DEFAULT_SESSION_STATE: SessionState = {\n  layers: DEFAULT_LAYERS_STATE,\n  customLayers: [],\n};\n\n/** Result of the `get-meta` query. */\nexport interface LitGetMetaResult {\n  version: string;\n  /** Built-in layers followed by any runtime-announced custom ones. */\n  layers: TimelineLayer[];\n  features: FeatureSettings | null;\n  /** Channel and id to pass to `rpc.streaming.subscribe()`. */\n  stream: {channel: string; id: string};\n}\n\n/** Argument of the `component-details` query. */\nexport interface ComponentDetailsArgs {\n  id: number;\n}\n\n/** Argument of the `recent-events` query. */\nexport interface RecentEventsArgs {\n  layerId?: string;\n  elementId?: number;\n  /**\n   * Only events from the last `sinceMs` milliseconds, measured against\n   * the newest event currently in the buffer — not wall-clock time.\n   * `TimelineEvent.time` is \"ms since recording started\" in the page\n   * (see `runtime/timeline/clock.ts`), which has no fixed relationship\n   * to this process's clock.\n   */\n  sinceMs?: number;\n  /** Default 50, hard ceiling 200 regardless of what's requested. */\n  limit?: number;\n}\n\n/** Result of the `recent-events` query. */\nexport interface RecentEventsResult {\n  /** Whether the timeline is currently recording. */\n  recording: boolean;\n  /** Most recent events matching the filters, oldest first. */\n  events: TimelineEvent[];\n  /** Total events currently held in the ring buffer, before filtering. */\n  bufferSize: number;\n  /** True if filtering matched more events than were returned. */\n  truncated: boolean;\n}\n\n/** Argument of the `update-summary` query. */\nexport interface UpdateSummaryArgs {\n  /** Restrict to one component, by tag name. */\n  tagName?: string;\n  /** Same window semantics as {@link RecentEventsArgs.sinceMs}. */\n  sinceMs?: number;\n  /** Cycles returned (the component totals always cover the whole window).\n   *  Default 50, hard ceiling 200. */\n  limit?: number;\n}\n\n/** Result of the `update-summary` query. */\nexport interface UpdateSummaryResult {\n  /** Whether the timeline is currently recording. */\n  recording: boolean;\n  /** Per-component totals over the window, slowest first. */\n  components: ComponentRollup[];\n  /** The most recent update cycles in the window, oldest first. */\n  cycles: UpdateCycle[];\n  /** Total events currently held in the ring buffer, before derivation. */\n  bufferSize: number;\n  /** True if more cycles were derived than were returned. */\n  truncated: boolean;\n}\n\n/** Argument of the `set-recording` action. */\nexport interface SetRecordingArgs {\n  recording: boolean;\n}\n\n/** Argument of the `toggle-layer` action. */\nexport interface ToggleLayerArgs {\n  layerId: string;\n  enabled: boolean;\n}\n\n/**\n * Maps a {@link TimelineLayer.id} to the {@link TimelineLayersState} flag\n * that gates it. Custom layers have no flag and are always on.\n */\nexport const LAYER_FLAGS: Readonly<Record<string, keyof TimelineLayersState>> =\n  {\n    'lit-lifecycle': 'litLifecycleEnabled',\n    'lit-render': 'litRenderEnabled',\n    'lit-render-verbose': 'litRenderVerboseEnabled',\n    mouse: 'mouseEventEnabled',\n    keyboard: 'keyboardEventEnabled',\n  };\n\n// Hand-typed rather than derived through `RpcDefinitionsToFunctionsWithNamespace`\n// (also exported by `devframe/rpc`): the definitions themselves live in\n// definition.ts next to their handlers, and hand-typing here avoids a\n// value-level dependency from this shared-contract module back onto it.\ndeclare module 'devframe' {\n  interface DevframeRpcServerFunctions {\n    'lit:get-meta': () => Promise<LitGetMetaResult>;\n    'lit:list-components': () => Promise<InspectorTreeNode[]>;\n    'lit:component-details': (\n      args: ComponentDetailsArgs\n    ) => Promise<InspectorDetails | null>;\n    'lit:recent-events': (\n      args?: RecentEventsArgs\n    ) => Promise<RecentEventsResult>;\n    'lit:timeline-history': () => Promise<TimelineEvent[]>;\n    'lit:update-summary': (\n      args?: UpdateSummaryArgs\n    ) => Promise<UpdateSummaryResult>;\n    'lit:inspect': (command: InspectorCommand) => Promise<void>;\n    'lit:set-recording': (args: SetRecordingArgs) => Promise<void>;\n    'lit:toggle-layer': (args: ToggleLayerArgs) => Promise<void>;\n    'lit:set-settings-override': (override: SettingsOverride) => Promise<void>;\n    'lit:open-source': (args: OpenSourceArgs) => Promise<OpenSourceResult>;\n    'lit:export-snapshot': (\n      args: ExportSnapshotArgs\n    ) => Promise<ExportSnapshotResult>;\n    'lit:hmr-incompatibilities': () => Promise<HmrIncompatibilityEvent[]>;\n    'lit:page-send': (channel: string, data?: unknown) => void;\n  }\n\n  interface DevframeRpcClientFunctions {\n    'lit:inspector-message': (message: InspectorMessage) => void;\n    'lit:hmr-incompatible': (event: HmrIncompatibilityEvent) => void;\n    'lit:page-receive': (channel: string, data?: unknown) => void;\n  }\n\n  interface DevframeSettingsRegistry {\n    lit: {\n      /** Panel chrome preference. Mirrors `COLOR_SCHEME_LS_KEY`. */\n      appearance?: 'auto' | 'dark' | 'light';\n      /**\n       * The Settings tab's live overrides, stored as one blob the way the\n       * panel already treats them. Mirrors `SETTINGS_OVERRIDE_LS_KEY`, which\n       * stays: the page runtime reads it synchronously at module-init time,\n       * long before any client exists, and every settings-store read is\n       * async by design.\n       */\n      override?: SettingsOverride;\n      /**\n       * The config value each overridden key was set against. A sibling of\n       * `override` so the runtime never sees it. Mirrors\n       * `OVERRIDE_BASELINES_LS_KEY`.\n       */\n      overrideBaselines?: OverrideBaselines;\n    };\n  }\n}\n"]}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/lib/devframe/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAC,oBAAoB,EAAC,MAAM,yBAAyB,CAAC;AAkB7D,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEjD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,uDAAuD;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAuB7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAqBrD,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,sDAAsD;AACtD,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEjE,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAkB/C,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,MAAM,EAAE,oBAAoB;IAC5B,YAAY,EAAE,EAAE;CACjB,CAAC;AAiFF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB;IACE,eAAe,EAAE,qBAAqB;IACtC,YAAY,EAAE,kBAAkB;IAChC,oBAAoB,EAAE,yBAAyB;IAC/C,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,sBAAsB;CACjC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared wire contract between the Lit devframe's node-side definition\n * ({@link ../definition.ts}) and its panel: shared-state / streaming /\n * RPC-function names, their payload shapes, and the `devframe` registry\n * augmentations that type them end to end.\n *\n * @see plans/devframe-foundation.md\n */\n\nimport {DEFAULT_LAYERS_STATE} from '../../types/timeline.js';\nimport type {\n  FeatureSettings,\n  OverrideBaselines,\n  SettingsOverride,\n  TimelineEvent,\n  TimelineLayer,\n  TimelineLayersState,\n} from '../../types/timeline.js';\nimport type {\n  InspectorCommand,\n  InspectorDetails,\n  InspectorMessage,\n  InspectorTreeNode,\n} from '../../types/inspector.js';\nimport type {HmrIncompatibilityEvent} from '../../types/hmr-incompatibility.js';\nimport type {ComponentRollup, UpdateCycle} from '../timeline/derive.js';\n\n/** The devframe's scope id. RPC names become `lit:*`, MCP wire names `lit_*`. */\nexport const LIT_DEVFRAME_ID = 'lit';\n\n/** Shared-state key holding the {@link SessionState} snapshot. */\nexport const SESSION_STATE_KEY = 'session';\n\n/** Streaming channel name the timeline event batches are pushed on. */\nexport const TIMELINE_STREAM_NAME = 'timeline';\n\n/**\n * Id of the one long-lived timeline stream. Fixed rather than discovered:\n * there is exactly one page feed per dev session, so the panel can subscribe\n * without a round trip to look the id up. The node side re-`start()`s this id\n * if the transport dropped the stream after the last subscriber left.\n */\nexport const TIMELINE_STREAM_ID = 'live';\n\n/**\n * Cap on the node-side recent-events ring buffer. It is also the history a\n * (re)connecting panel is seeded with (see {@link RPC_TIMELINE_HISTORY}).\n */\nexport const RECENT_EVENTS_BUFFER_SIZE = 512;\n\n/** Bare (unscoped) name of the `get-meta` query. */\nexport const RPC_GET_META = 'get-meta';\n\n/** Bare name of the `list-components` query. */\nexport const RPC_LIST_COMPONENTS = 'list-components';\n\n/** Bare name of the `component-details` query. */\nexport const RPC_COMPONENT_DETAILS = 'component-details';\n\n/** Bare name of the `recent-events` query. */\nexport const RPC_RECENT_EVENTS = 'recent-events';\n\n/**\n * Bare name of the `timeline-history` query: the node's whole recent-events\n * buffer, oldest first, as `TimelineEvent[]`. What a live panel seeds itself\n * with on connect, since the stream only carries events from then on. Not\n * `recent-events`, whose live answer is filtered and capped for agents.\n */\nexport const RPC_TIMELINE_HISTORY = 'timeline-history';\n\n/** Bare name of the `update-summary` query. */\nexport const RPC_UPDATE_SUMMARY = 'update-summary';\n\n/** Bare name of the `inspect` action. */\nexport const RPC_INSPECT = 'inspect';\n\n/** Bare name of the `set-recording` action. */\nexport const RPC_SET_RECORDING = 'set-recording';\n\n/** Bare name of the `toggle-layer` action. */\nexport const RPC_TOGGLE_LAYER = 'toggle-layer';\n\n/** Bare name of the `set-settings-override` action. */\nexport const RPC_SET_SETTINGS_OVERRIDE = 'set-settings-override';\n\n/** Bare name of the `open-source` action. */\nexport const RPC_OPEN_SOURCE = 'open-source';\n\n/** Arguments for {@link RPC_OPEN_SOURCE}. */\nexport interface OpenSourceArgs {\n  /**\n   * The path as the panel has it: what the transform injected, so relative\n   * to the Vite root (or absolute, when the file lives outside it).\n   */\n  file: string;\n  line?: number;\n}\n\n/** What {@link RPC_OPEN_SOURCE} reports back. */\nexport interface OpenSourceResult {\n  /**\n   * False when no open service is installed on the host, which is the\n   * panel's cue to fall back to `/__lit-open-in-editor`. Also false when the\n   * file is missing or outside the allowed roots; the endpoint refuses those\n   * paths too.\n   */\n  opened: boolean;\n}\n\n/** Freeze the current session into a static panel directory. */\nexport const RPC_EXPORT_SNAPSHOT = 'export-snapshot';\n\n/** Arguments for {@link RPC_EXPORT_SNAPSHOT}. */\nexport interface ExportSnapshotArgs {\n  /**\n   * Where to write. Relative paths resolve against the dev server's cwd,\n   * and the result has to stay beneath it. Defaults to\n   * `lit-devtools-snapshot`. An existing directory is only replaced when it\n   * holds an earlier snapshot.\n   */\n  outDir?: string;\n}\n\n/** What {@link RPC_EXPORT_SNAPSHOT} reports back, for the panel to display. */\nexport interface ExportSnapshotResult {\n  outDir: string;\n  events: number;\n  components: number;\n  details: number;\n}\n\n/** Bare name of the `inspector-message` client (node → panel) event. */\nexport const RPC_INSPECTOR_MESSAGE = 'inspector-message';\n\n/** Bare name of the `hmr-incompatibilities` query. */\nexport const RPC_HMR_INCOMPATIBILITIES = 'hmr-incompatibilities';\n\n/** Bare name of the `hmr-incompatible` client (node → panel) event. */\nexport const RPC_HMR_INCOMPATIBLE = 'hmr-incompatible';\n\n/**\n * Bare name of the page-to-server event. A page runtime that is not on a Vite\n * dev server's HMR socket sends every channel message it would have sent over\n * `import.meta.hot` as `page-send(channel, data)`.\n */\nexport const RPC_PAGE_SEND = 'page-send';\n\n/**\n * Bare name of the server-to-page client event, the reverse direction of\n * {@link RPC_PAGE_SEND}: `page-receive(channel, data)`. Broadcast to every\n * connected client and marked optional, since the panel does not register it.\n */\nexport const RPC_PAGE_RECEIVE = 'page-receive';\n\n/**\n * Recording/layers snapshot shared between every surface (panel, page\n * runtime, MCP). Survives reconnect; mutated either by the `set-recording` /\n * `toggle-layer` actions below or directly by a panel through the generic\n * shared-state RPC devframe provides.\n *\n * `layers.recordingState` is the single authority for \"is recording\" — the\n * runtime's own layer state carries it, so a separate flag here would be a\n * second copy to keep in sync.\n */\nexport interface SessionState {\n  layers: TimelineLayersState;\n  /** Layers announced at runtime by app code through `addTimelineLayer()`. */\n  customLayers: TimelineLayer[];\n}\n\nexport const DEFAULT_SESSION_STATE: SessionState = {\n  layers: DEFAULT_LAYERS_STATE,\n  customLayers: [],\n};\n\n/** Result of the `get-meta` query. */\nexport interface LitGetMetaResult {\n  version: string;\n  /** Built-in layers followed by any runtime-announced custom ones. */\n  layers: TimelineLayer[];\n  features: FeatureSettings | null;\n  /** Channel and id to pass to `rpc.streaming.subscribe()`. */\n  stream: {channel: string; id: string};\n}\n\n/** Argument of the `component-details` query. */\nexport interface ComponentDetailsArgs {\n  id: number;\n}\n\n/** Argument of the `recent-events` query. */\nexport interface RecentEventsArgs {\n  layerId?: string;\n  elementId?: number;\n  /**\n   * Only events from the last `sinceMs` milliseconds, measured against\n   * the newest event currently in the buffer — not wall-clock time.\n   * `TimelineEvent.time` is \"ms since recording started\" in the page\n   * (see `runtime/timeline/clock.ts`), which has no fixed relationship\n   * to this process's clock.\n   */\n  sinceMs?: number;\n  /** Default 50, hard ceiling 200 regardless of what's requested. */\n  limit?: number;\n}\n\n/** Result of the `recent-events` query. */\nexport interface RecentEventsResult {\n  /** Whether the timeline is currently recording. */\n  recording: boolean;\n  /** Most recent events matching the filters, oldest first. */\n  events: TimelineEvent[];\n  /** Total events currently held in the ring buffer, before filtering. */\n  bufferSize: number;\n  /** True if filtering matched more events than were returned. */\n  truncated: boolean;\n}\n\n/** Argument of the `update-summary` query. */\nexport interface UpdateSummaryArgs {\n  /** Restrict to one component, by tag name. */\n  tagName?: string;\n  /** Same window semantics as {@link RecentEventsArgs.sinceMs}. */\n  sinceMs?: number;\n  /** Cycles returned (the component totals always cover the whole window).\n   *  Default 50, hard ceiling 200. */\n  limit?: number;\n}\n\n/** Result of the `update-summary` query. */\nexport interface UpdateSummaryResult {\n  /** Whether the timeline is currently recording. */\n  recording: boolean;\n  /** Per-component totals over the window, slowest first. */\n  components: ComponentRollup[];\n  /** The most recent update cycles in the window, oldest first. */\n  cycles: UpdateCycle[];\n  /** Total events currently held in the ring buffer, before derivation. */\n  bufferSize: number;\n  /** True if more cycles were derived than were returned. */\n  truncated: boolean;\n}\n\n/** Argument of the `set-recording` action. */\nexport interface SetRecordingArgs {\n  recording: boolean;\n}\n\n/** Argument of the `toggle-layer` action. */\nexport interface ToggleLayerArgs {\n  layerId: string;\n  enabled: boolean;\n}\n\n/**\n * Maps a {@link TimelineLayer.id} to the {@link TimelineLayersState} flag\n * that gates it. Custom layers have no flag and are always on.\n */\nexport const LAYER_FLAGS: Readonly<Record<string, keyof TimelineLayersState>> =\n  {\n    'lit-lifecycle': 'litLifecycleEnabled',\n    'lit-render': 'litRenderEnabled',\n    'lit-render-verbose': 'litRenderVerboseEnabled',\n    mouse: 'mouseEventEnabled',\n    keyboard: 'keyboardEventEnabled',\n  };\n\n// Hand-typed rather than derived through `RpcDefinitionsToFunctionsWithNamespace`\n// (also exported by `devframe/rpc`): the definitions themselves live in\n// definition.ts next to their handlers, and hand-typing here avoids a\n// value-level dependency from this shared-contract module back onto it.\ndeclare module 'devframe' {\n  interface DevframeRpcServerFunctions {\n    'lit:get-meta': () => Promise<LitGetMetaResult>;\n    'lit:list-components': () => Promise<InspectorTreeNode[]>;\n    'lit:component-details': (\n      args: ComponentDetailsArgs\n    ) => Promise<InspectorDetails | null>;\n    'lit:recent-events': (\n      args?: RecentEventsArgs\n    ) => Promise<RecentEventsResult>;\n    'lit:timeline-history': () => Promise<TimelineEvent[]>;\n    'lit:update-summary': (\n      args?: UpdateSummaryArgs\n    ) => Promise<UpdateSummaryResult>;\n    'lit:inspect': (command: InspectorCommand) => Promise<void>;\n    'lit:set-recording': (args: SetRecordingArgs) => Promise<void>;\n    'lit:toggle-layer': (args: ToggleLayerArgs) => Promise<void>;\n    'lit:set-settings-override': (override: SettingsOverride) => Promise<void>;\n    'lit:open-source': (args: OpenSourceArgs) => Promise<OpenSourceResult>;\n    'lit:export-snapshot': (\n      args: ExportSnapshotArgs\n    ) => Promise<ExportSnapshotResult>;\n    'lit:hmr-incompatibilities': () => Promise<HmrIncompatibilityEvent[]>;\n    'lit:page-send': (channel: string, data?: unknown) => void;\n  }\n\n  interface DevframeRpcClientFunctions {\n    'lit:inspector-message': (message: InspectorMessage) => void;\n    'lit:hmr-incompatible': (event: HmrIncompatibilityEvent) => void;\n    'lit:page-receive': (channel: string, data?: unknown) => void;\n  }\n\n  interface DevframeSettingsRegistry {\n    lit: {\n      /** Panel chrome preference. Mirrors `COLOR_SCHEME_LS_KEY`. */\n      appearance?: 'auto' | 'dark' | 'light';\n      /**\n       * The Settings tab's live overrides, stored as one blob the way the\n       * panel already treats them. Mirrors `SETTINGS_OVERRIDE_LS_KEY`, which\n       * stays: the page runtime reads it synchronously at module-init time,\n       * long before any client exists, and every settings-store read is\n       * async by design.\n       */\n      override?: SettingsOverride;\n      /**\n       * The config value each overridden key was set against. A sibling of\n       * `override` so the runtime never sees it. Mirrors\n       * `OVERRIDE_BASELINES_LS_KEY`.\n       */\n      overrideBaselines?: OverrideBaselines;\n    };\n  }\n}\n"]}

package/lib/devframe/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/vite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/lib/devframe/vite.ts"],"names":[],"mappings":"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"}

package/lib/devframe/vite.js

@@ -231,6 +231,7 @@ export function createLitDevframePlugin(options) {
   // Only known once `setup()` has the dev server, which is after the
   // definition is built -- hence the getter.
   let viteRoot;
+  let fsAllow = [];
   const definition = createLitDevframe({
     source,
     version: options.version,
@@ -238,6 +239,7 @@ export function createLitDevframePlugin(options) {
     configuredEditor: options.configuredEditor,
     clientAssets: options.clientAssets,
     sourceRoot: () => viteRoot,
+    allowedRoots: () => fsAllow,
   });
   return {
     name: `devframe:${LIT_DEVFRAME_ID}`,
@@ -252,6 +254,7 @@ export function createLitDevframePlugin(options) {
         // available on the context by now.
         if (ctx.viteServer) source.bind(ctx.viteServer, ctx);
         viteRoot = ctx.viteServer?.config.root;
+        fsAllow = ctx.viteServer?.config.server.fs?.allow ?? [];
         await ctx.install(definition);
         // The overlay picker as a palette command with a managed shortcut.
         // Only meaningful when the source overlay is enabled, since that is