@oddsquad/vite-plugin-lit 0.2.3 → 0.4.0

package/lib/source-meta.js

@@ -11,7 +11,8 @@ export const SOURCE_META_KEY = '@lit-labs/vite-plugin-lit#source';
  */
 export const SOURCE_META_SYM = `Symbol.for('${SOURCE_META_KEY}')`;
 /** 1-based line number for an index in source text. */
-export const lineNumberAt = (code, index) => code.slice(0, index).split('\n').length;
+export const lineNumberAt = (code, index) =>
+  code.slice(0, index).split('\n').length;
 /**
  * Finds the index after the closing `}` of a class body starting at
  * `classStart`. Skips braces inside strings, comments, regex literals, and
@@ -19,176 +20,189 @@ export const lineNumberAt = (code, index) => code.slice(0, index).split('\n').le
  * templates (Lit's `html\`…\`` inside `.map()` etc.) recurse arbitrarily.
  */
 const findClassBodyEnd = (code, classStart) => {
-    const open = code.indexOf('{', classStart);
-    if (open === -1)
-        return -1;
-    // Brace depth of the code scope currently being scanned. Entering a `${…}`
-    // interpolation pushes the enclosing scope's depth and restarts at 1 (the
-    // `${` counts as the open brace); balancing it pops back into the template.
-    let depth = 1;
-    const interpolationStack = [];
-    let inTemplate = false;
-    let i = open + 1;
-    while (i < code.length) {
-        const ch = code[i];
-        if (inTemplate) {
-            if (ch === '\\') {
-                i += 2;
-                continue;
-            }
-            if (ch === '`') {
-                inTemplate = false;
-                i++;
-                continue;
-            }
-            if (ch === '$' && code[i + 1] === '{') {
-                interpolationStack.push(depth);
-                depth = 1;
-                inTemplate = false;
-                i += 2;
-                continue;
-            }
-            i++;
-            continue;
-        }
-        if (ch === '"' || ch === "'") {
-            const quote = ch;
-            i++;
-            while (i < code.length && code[i] !== quote) {
-                if (code[i] === '\\')
-                    i++;
-                i++;
-            }
-            i++;
-            continue;
-        }
-        if (ch === '`') {
-            inTemplate = true;
-            i++;
-            continue;
-        }
-        if (ch === '/') {
-            const next = code[i + 1];
-            if (next === '/') {
-                i = code.indexOf('\n', i);
-                if (i === -1)
-                    return -1;
-                continue;
-            }
-            if (next === '*') {
-                i = code.indexOf('*/', i + 2);
-                if (i === -1)
-                    return -1;
-                i += 2;
-                continue;
-            }
-            // Regex literal vs division: scan back over whitespace to the last
-            // significant char — a regex can only follow an operator, opening
-            // punctuation, or a keyword like `return`. `a / b` has an identifier
-            // there, so it's division and scans on as plain code.
-            let j = i - 1;
-            while (j >= 0 && /\s/.test(code[j]))
-                j--;
-            const prev = j >= 0 ? code[j] : '';
-            const regexPossible = j < 0 ||
-                /[=:(,+\-!&|?{}[;]/.test(prev) ||
-                /(?:^|[^\w$])(?:return|typeof|case|instanceof|in|of|new|delete|void|throw|do|else|yield|await)$/.test(code.slice(Math.max(0, j - 11), j + 1));
-            if (regexPossible) {
-                let k = i + 1;
-                let inCharClass = false;
-                while (k < code.length &&
-                    code[k] !== '\n' &&
-                    (inCharClass || code[k] !== '/')) {
-                    if (code[k] === '\\')
-                        k++;
-                    else if (code[k] === '[')
-                        inCharClass = true;
-                    else if (code[k] === ']')
-                        inCharClass = false;
-                    k++;
-                }
-                if (code[k] === '/') {
-                    i = k + 1;
-                    continue;
-                }
-                // No closing `/` before the line ends — not a regex after all.
-            }
+  const open = code.indexOf('{', classStart);
+  if (open === -1) return -1;
+  // Brace depth of the code scope currently being scanned. Entering a `${…}`
+  // interpolation pushes the enclosing scope's depth and restarts at 1 (the
+  // `${` counts as the open brace); balancing it pops back into the template.
+  let depth = 1;
+  const interpolationStack = [];
+  let inTemplate = false;
+  let i = open + 1;
+  while (i < code.length) {
+    const ch = code[i];
+    if (inTemplate) {
+      if (ch === '\\') {
+        i += 2;
+        continue;
+      }
+      if (ch === '`') {
+        inTemplate = false;
+        i++;
+        continue;
+      }
+      if (ch === '$' && code[i + 1] === '{') {
+        interpolationStack.push(depth);
+        depth = 1;
+        inTemplate = false;
+        i += 2;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      const quote = ch;
+      i++;
+      while (i < code.length && code[i] !== quote) {
+        if (code[i] === '\\') i++;
+        i++;
+      }
+      i++;
+      continue;
+    }
+    if (ch === '`') {
+      inTemplate = true;
+      i++;
+      continue;
+    }
+    if (ch === '/') {
+      const next = code[i + 1];
+      if (next === '/') {
+        i = code.indexOf('\n', i);
+        if (i === -1) return -1;
+        continue;
+      }
+      if (next === '*') {
+        i = code.indexOf('*/', i + 2);
+        if (i === -1) return -1;
+        i += 2;
+        continue;
+      }
+      // Regex literal vs division: scan back over whitespace to the last
+      // significant char — a regex can only follow an operator, opening
+      // punctuation, or a keyword like `return`. `a / b` has an identifier
+      // there, so it's division and scans on as plain code.
+      let j = i - 1;
+      while (j >= 0 && /\s/.test(code[j])) j--;
+      const prev = j >= 0 ? code[j] : '';
+      const regexPossible =
+        j < 0 ||
+        /[=:(,+\-!&|?{}[;]/.test(prev) ||
+        /(?:^|[^\w$])(?:return|typeof|case|instanceof|in|of|new|delete|void|throw|do|else|yield|await)$/.test(
+          code.slice(Math.max(0, j - 11), j + 1)
+        );
+      if (regexPossible) {
+        let k = i + 1;
+        let inCharClass = false;
+        while (
+          k < code.length &&
+          code[k] !== '\n' &&
+          (inCharClass || code[k] !== '/')
+        ) {
+          if (code[k] === '\\') k++;
+          else if (code[k] === '[') inCharClass = true;
+          else if (code[k] === ']') inCharClass = false;
+          k++;
         }
-        if (ch === '{') {
-            depth++;
+        if (code[k] === '/') {
+          i = k + 1;
+          continue;
         }
-        else if (ch === '}') {
-            depth--;
-            if (depth === 0) {
-                const enclosing = interpolationStack.pop();
-                if (enclosing === undefined) {
-                    return i + 1;
-                }
-                depth = enclosing;
-                inTemplate = true;
-            }
+        // No closing `/` before the line ends — not a regex after all.
+      }
+    }
+    if (ch === '{') {
+      depth++;
+    } else if (ch === '}') {
+      depth--;
+      if (depth === 0) {
+        const enclosing = interpolationStack.pop();
+        if (enclosing === undefined) {
+          return i + 1;
         }
-        i++;
+        depth = enclosing;
+        inTemplate = true;
+      }
     }
-    return -1;
+    i++;
+  }
+  return -1;
 };
-const makeAssignment = (className, filePath, lineNumber) => `${className}[${SOURCE_META_SYM}]={filePath:${JSON.stringify(filePath)},lineNumber:${lineNumber},componentName:${JSON.stringify(className)}};`;
-/** True when `className` is declared as a class/let/const in module code. */
-const isClassDeclaredInModule = (code, className) => new RegExp(`^\\s*(?:export\\s+)?(?:class|let|const|var)\\s+${className}\\b`, 'm').test(code);
+const makeAssignment = (className, filePath, lineNumber) =>
+  `${className}[${SOURCE_META_SYM}]={filePath:${JSON.stringify(filePath)},lineNumber:${lineNumber},componentName:${JSON.stringify(className)}};`;
+/**
+ * True when `className` is declared at module top level (column 0). Nested
+ * declarations are skipped deliberately: the metadata assignment for this path
+ * is appended at the end of the module, where a function/block-scoped binding
+ * would not be in scope (a `ReferenceError` at module evaluation).
+ */
+const isClassDeclaredInModule = (code, className) =>
+  new RegExp(
+    `^(?:export\\s+)?(?:class|let|const|var)\\s+${className}\\b`,
+    'm'
+  ).test(code);
+/** True when `index` starts a line (module top level in emitted output). */
+const isAtLineStart = (code, index) => index === 0 || code[index - 1] === '\n';
 /**
  * Injects component source metadata onto custom element class constructors.
  * Returns whether any injection was made.
  */
 export const injectSourceMeta = (code, filePath, ms) => {
-    if (code.includes(SOURCE_META_SYM)) {
-        return false;
-    }
-    let changed = false;
-    const injected = new Set();
-    const injectAtClassEnd = (className, matchIndex, match) => {
-        if (injected.has(className))
-            return;
-        const classOffset = match.indexOf('class');
-        if (classOffset === -1)
-            return;
-        const classStart = matchIndex + classOffset;
-        const end = findClassBodyEnd(code, classStart);
-        if (end === -1)
-            return;
-        // Report the match start (the `@customElement` decorator) rather than the
-        // `class` keyword, so the overlay points at the top of the component.
-        const line = lineNumberAt(code, matchIndex);
-        ms.append('\n' + makeAssignment(className, filePath, line));
-        injected.add(className);
-        changed = true;
-    };
-    // @customElement(...) class Foo (any whitespace between them)
-    for (const m of code.matchAll(/@customElement\s*\([^)]*\)\s+(?:export\s+)?class\s+(\w+)/g)) {
-        injectAtClassEnd(m[1], m.index, m[0]);
-    }
-    // customElements.define('tag', ClassName)
-    for (const m of code.matchAll(/customElements\.define\s*\(\s*['"][^'"]+['"]\s*,\s*(\w+)/g)) {
-        const className = m[1];
-        if (injected.has(className) || !isClassDeclaredInModule(code, className)) {
-            continue;
-        }
-        const line = lineNumberAt(code, m.index);
-        ms.append('\n' + makeAssignment(className, filePath, line));
-        injected.add(className);
-        changed = true;
-    }
-    // TypeScript experimental-decorators / esbuild output
-    // e.g. `Foo = __decorateClass([customElement(...)], Foo)`
-    //       `Foo = _decorate([customElement(...)], Foo)`
-    for (const m of code.matchAll(/(\w+)\s*=\s*__decorate\w*\(\s*\[[\s\S]*?customElement\s*\([^)]*\)[\s\S]*?\],\s*\1\)/g)) {
-        const className = m[1];
-        if (injected.has(className))
-            continue;
-        const line = lineNumberAt(code, m.index);
-        ms.append('\n' + makeAssignment(className, filePath, line));
-        injected.add(className);
-        changed = true;
+  if (code.includes(SOURCE_META_SYM)) {
+    return false;
+  }
+  let changed = false;
+  const injected = new Set();
+  const injectAtClassEnd = (className, matchIndex, match) => {
+    if (injected.has(className)) return;
+    const classOffset = match.indexOf('class');
+    if (classOffset === -1) return;
+    const classStart = matchIndex + classOffset;
+    const end = findClassBodyEnd(code, classStart);
+    if (end === -1) return;
+    // Report the match start (the `@customElement` decorator) rather than the
+    // `class` keyword, so the overlay points at the top of the component.
+    const line = lineNumberAt(code, matchIndex);
+    // Insert right after the class body so the assignment lives in the same
+    // scope as the declaration — appending at module end breaks for a class
+    // declared inside a function or block.
+    ms.appendLeft(end, '\n' + makeAssignment(className, filePath, line));
+    injected.add(className);
+    changed = true;
+  };
+  // @customElement(...) class Foo (any whitespace between them)
+  for (const m of code.matchAll(
+    /@customElement\s*\([^)]*\)\s+(?:export\s+)?class\s+(\w+)/g
+  )) {
+    injectAtClassEnd(m[1], m.index, m[0]);
+  }
+  // customElements.define('tag', ClassName)
+  for (const m of code.matchAll(
+    /customElements\.define\s*\(\s*['"][^'"]+['"]\s*,\s*(\w+)/g
+  )) {
+    const className = m[1];
+    if (injected.has(className) || !isClassDeclaredInModule(code, className)) {
+      continue;
     }
-    return changed;
+    const line = lineNumberAt(code, m.index);
+    ms.append('\n' + makeAssignment(className, filePath, line));
+    injected.add(className);
+    changed = true;
+  }
+  // TypeScript experimental-decorators / esbuild output
+  // e.g. `Foo = __decorateClass([customElement(...)], Foo)`
+  //       `Foo = _decorate([customElement(...)], Foo)`
+  for (const m of code.matchAll(
+    /(\w+)\s*=\s*__decorate\w*\(\s*\[[\s\S]*?customElement\s*\([^)]*\)[\s\S]*?\],\s*\1\)/g
+  )) {
+    const className = m[1];
+    if (injected.has(className) || !isAtLineStart(code, m.index)) continue;
+    const line = lineNumberAt(code, m.index);
+    ms.append('\n' + makeAssignment(className, filePath, line));
+    injected.add(className);
+    changed = true;
+  }
+  return changed;
 };
-//# sourceMappingURL=source-meta.js.map
+//# sourceMappingURL=source-meta.js.map

package/lib/source-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-meta.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/lib/source-meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type MagicString from 'magic-string';\n\n/** Stable key shared between transform output and runtime resolution. */\nexport const SOURCE_META_KEY = '@lit-labs/vite-plugin-lit#source';\n\n/**\n * The expression string used in generated code to reference the shared\n * symbol at runtime.\n */\nexport const SOURCE_META_SYM = `Symbol.for('${SOURCE_META_KEY}')`;\n\nexport interface InjectedSourceMeta {\n  filePath: string;\n  lineNumber: number;\n  componentName?: string;\n}\n\n/** 1-based line number for an index in source text. */\nexport const lineNumberAt = (code: string, index: number): number =>\n  code.slice(0, index).split('\\n').length;\n\n/**\n * Finds the index after the closing `}` of a class body starting at\n * `classStart`. Skips braces inside strings, comments, regex literals, and\n * template literals — including code in `${…}` interpolations, where nested\n * templates (Lit's `html\\`…\\`` inside `.map()` etc.) recurse arbitrarily.\n */\nconst findClassBodyEnd = (code: string, classStart: number): number => {\n  const open = code.indexOf('{', classStart);\n  if (open === -1) return -1;\n  // Brace depth of the code scope currently being scanned. Entering a `${…}`\n  // interpolation pushes the enclosing scope's depth and restarts at 1 (the\n  // `${` counts as the open brace); balancing it pops back into the template.\n  let depth = 1;\n  const interpolationStack: number[] = [];\n  let inTemplate = false;\n  let i = open + 1;\n  while (i < code.length) {\n    const ch = code[i];\n    if (inTemplate) {\n      if (ch === '\\\\') {\n        i += 2;\n        continue;\n      }\n      if (ch === '`') {\n        inTemplate = false;\n        i++;\n        continue;\n      }\n      if (ch === '$' && code[i + 1] === '{') {\n        interpolationStack.push(depth);\n        depth = 1;\n        inTemplate = false;\n        i += 2;\n        continue;\n      }\n      i++;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\") {\n      const quote = ch;\n      i++;\n      while (i < code.length && code[i] !== quote) {\n        if (code[i] === '\\\\') i++;\n        i++;\n      }\n      i++;\n      continue;\n    }\n    if (ch === '`') {\n      inTemplate = true;\n      i++;\n      continue;\n    }\n    if (ch === '/') {\n      const next = code[i + 1];\n      if (next === '/') {\n        i = code.indexOf('\\n', i);\n        if (i === -1) return -1;\n        continue;\n      }\n      if (next === '*') {\n        i = code.indexOf('*/', i + 2);\n        if (i === -1) return -1;\n        i += 2;\n        continue;\n      }\n      // Regex literal vs division: scan back over whitespace to the last\n      // significant char — a regex can only follow an operator, opening\n      // punctuation, or a keyword like `return`. `a / b` has an identifier\n      // there, so it's division and scans on as plain code.\n      let j = i - 1;\n      while (j >= 0 && /\\s/.test(code[j])) j--;\n      const prev = j >= 0 ? code[j] : '';\n      const regexPossible =\n        j < 0 ||\n        /[=:(,+\\-!&|?{}[;]/.test(prev) ||\n        /(?:^|[^\\w$])(?:return|typeof|case|instanceof|in|of|new|delete|void|throw|do|else|yield|await)$/.test(\n          code.slice(Math.max(0, j - 11), j + 1)\n        );\n      if (regexPossible) {\n        let k = i + 1;\n        let inCharClass = false;\n        while (\n          k < code.length &&\n          code[k] !== '\\n' &&\n          (inCharClass || code[k] !== '/')\n        ) {\n          if (code[k] === '\\\\') k++;\n          else if (code[k] === '[') inCharClass = true;\n          else if (code[k] === ']') inCharClass = false;\n          k++;\n        }\n        if (code[k] === '/') {\n          i = k + 1;\n          continue;\n        }\n        // No closing `/` before the line ends — not a regex after all.\n      }\n    }\n    if (ch === '{') {\n      depth++;\n    } else if (ch === '}') {\n      depth--;\n      if (depth === 0) {\n        const enclosing = interpolationStack.pop();\n        if (enclosing === undefined) {\n          return i + 1;\n        }\n        depth = enclosing;\n        inTemplate = true;\n      }\n    }\n    i++;\n  }\n  return -1;\n};\n\nconst makeAssignment = (\n  className: string,\n  filePath: string,\n  lineNumber: number\n) =>\n  `${className}[${SOURCE_META_SYM}]={filePath:${JSON.stringify(filePath)},lineNumber:${lineNumber},componentName:${JSON.stringify(className)}};`;\n\n/** True when `className` is declared as a class/let/const in module code. */\nconst isClassDeclaredInModule = (code: string, className: string): boolean =>\n  new RegExp(\n    `^\\\\s*(?:export\\\\s+)?(?:class|let|const|var)\\\\s+${className}\\\\b`,\n    'm'\n  ).test(code);\n\n/**\n * Injects component source metadata onto custom element class constructors.\n * Returns whether any injection was made.\n */\nexport const injectSourceMeta = (\n  code: string,\n  filePath: string,\n  ms: MagicString\n): boolean => {\n  if (code.includes(SOURCE_META_SYM)) {\n    return false;\n  }\n  let changed = false;\n  const injected = new Set<string>();\n\n  const injectAtClassEnd = (\n    className: string,\n    matchIndex: number,\n    match: string\n  ) => {\n    if (injected.has(className)) return;\n    const classOffset = match.indexOf('class');\n    if (classOffset === -1) return;\n    const classStart = matchIndex + classOffset;\n    const end = findClassBodyEnd(code, classStart);\n    if (end === -1) return;\n    // Report the match start (the `@customElement` decorator) rather than the\n    // `class` keyword, so the overlay points at the top of the component.\n    const line = lineNumberAt(code, matchIndex);\n    ms.append('\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  };\n\n  // @customElement(...) class Foo (any whitespace between them)\n  for (const m of code.matchAll(\n    /@customElement\\s*\\([^)]*\\)\\s+(?:export\\s+)?class\\s+(\\w+)/g\n  )) {\n    injectAtClassEnd(m[1], m.index, m[0]);\n  }\n\n  // customElements.define('tag', ClassName)\n  for (const m of code.matchAll(\n    /customElements\\.define\\s*\\(\\s*['\"][^'\"]+['\"]\\s*,\\s*(\\w+)/g\n  )) {\n    const className = m[1];\n    if (injected.has(className) || !isClassDeclaredInModule(code, className)) {\n      continue;\n    }\n    const line = lineNumberAt(code, m.index);\n    ms.append('\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  }\n\n  // TypeScript experimental-decorators / esbuild output\n  // e.g. `Foo = __decorateClass([customElement(...)], Foo)`\n  //       `Foo = _decorate([customElement(...)], Foo)`\n  for (const m of code.matchAll(\n    /(\\w+)\\s*=\\s*__decorate\\w*\\(\\s*\\[[\\s\\S]*?customElement\\s*\\([^)]*\\)[\\s\\S]*?\\],\\s*\\1\\)/g\n  )) {\n    const className = m[1];\n    if (injected.has(className)) continue;\n    const line = lineNumberAt(code, m.index);\n    ms.append('\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  }\n\n  return changed;\n};\n"]}
+{"version":3,"file":"source-meta.js","sourceRoot":"","sources":["../src/lib/source-meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type MagicString from 'magic-string';\n\n/** Stable key shared between transform output and runtime resolution. */\nexport const SOURCE_META_KEY = '@lit-labs/vite-plugin-lit#source';\n\n/**\n * The expression string used in generated code to reference the shared\n * symbol at runtime.\n */\nexport const SOURCE_META_SYM = `Symbol.for('${SOURCE_META_KEY}')`;\n\nexport interface InjectedSourceMeta {\n  filePath: string;\n  lineNumber: number;\n  componentName?: string;\n}\n\n/** 1-based line number for an index in source text. */\nexport const lineNumberAt = (code: string, index: number): number =>\n  code.slice(0, index).split('\\n').length;\n\n/**\n * Finds the index after the closing `}` of a class body starting at\n * `classStart`. Skips braces inside strings, comments, regex literals, and\n * template literals — including code in `${…}` interpolations, where nested\n * templates (Lit's `html\\`…\\`` inside `.map()` etc.) recurse arbitrarily.\n */\nconst findClassBodyEnd = (code: string, classStart: number): number => {\n  const open = code.indexOf('{', classStart);\n  if (open === -1) return -1;\n  // Brace depth of the code scope currently being scanned. Entering a `${…}`\n  // interpolation pushes the enclosing scope's depth and restarts at 1 (the\n  // `${` counts as the open brace); balancing it pops back into the template.\n  let depth = 1;\n  const interpolationStack: number[] = [];\n  let inTemplate = false;\n  let i = open + 1;\n  while (i < code.length) {\n    const ch = code[i];\n    if (inTemplate) {\n      if (ch === '\\\\') {\n        i += 2;\n        continue;\n      }\n      if (ch === '`') {\n        inTemplate = false;\n        i++;\n        continue;\n      }\n      if (ch === '$' && code[i + 1] === '{') {\n        interpolationStack.push(depth);\n        depth = 1;\n        inTemplate = false;\n        i += 2;\n        continue;\n      }\n      i++;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\") {\n      const quote = ch;\n      i++;\n      while (i < code.length && code[i] !== quote) {\n        if (code[i] === '\\\\') i++;\n        i++;\n      }\n      i++;\n      continue;\n    }\n    if (ch === '`') {\n      inTemplate = true;\n      i++;\n      continue;\n    }\n    if (ch === '/') {\n      const next = code[i + 1];\n      if (next === '/') {\n        i = code.indexOf('\\n', i);\n        if (i === -1) return -1;\n        continue;\n      }\n      if (next === '*') {\n        i = code.indexOf('*/', i + 2);\n        if (i === -1) return -1;\n        i += 2;\n        continue;\n      }\n      // Regex literal vs division: scan back over whitespace to the last\n      // significant char — a regex can only follow an operator, opening\n      // punctuation, or a keyword like `return`. `a / b` has an identifier\n      // there, so it's division and scans on as plain code.\n      let j = i - 1;\n      while (j >= 0 && /\\s/.test(code[j])) j--;\n      const prev = j >= 0 ? code[j] : '';\n      const regexPossible =\n        j < 0 ||\n        /[=:(,+\\-!&|?{}[;]/.test(prev) ||\n        /(?:^|[^\\w$])(?:return|typeof|case|instanceof|in|of|new|delete|void|throw|do|else|yield|await)$/.test(\n          code.slice(Math.max(0, j - 11), j + 1)\n        );\n      if (regexPossible) {\n        let k = i + 1;\n        let inCharClass = false;\n        while (\n          k < code.length &&\n          code[k] !== '\\n' &&\n          (inCharClass || code[k] !== '/')\n        ) {\n          if (code[k] === '\\\\') k++;\n          else if (code[k] === '[') inCharClass = true;\n          else if (code[k] === ']') inCharClass = false;\n          k++;\n        }\n        if (code[k] === '/') {\n          i = k + 1;\n          continue;\n        }\n        // No closing `/` before the line ends — not a regex after all.\n      }\n    }\n    if (ch === '{') {\n      depth++;\n    } else if (ch === '}') {\n      depth--;\n      if (depth === 0) {\n        const enclosing = interpolationStack.pop();\n        if (enclosing === undefined) {\n          return i + 1;\n        }\n        depth = enclosing;\n        inTemplate = true;\n      }\n    }\n    i++;\n  }\n  return -1;\n};\n\nconst makeAssignment = (\n  className: string,\n  filePath: string,\n  lineNumber: number\n) =>\n  `${className}[${SOURCE_META_SYM}]={filePath:${JSON.stringify(filePath)},lineNumber:${lineNumber},componentName:${JSON.stringify(className)}};`;\n\n/**\n * True when `className` is declared at module top level (column 0). Nested\n * declarations are skipped deliberately: the metadata assignment for this path\n * is appended at the end of the module, where a function/block-scoped binding\n * would not be in scope (a `ReferenceError` at module evaluation).\n */\nconst isClassDeclaredInModule = (code: string, className: string): boolean =>\n  new RegExp(\n    `^(?:export\\\\s+)?(?:class|let|const|var)\\\\s+${className}\\\\b`,\n    'm'\n  ).test(code);\n\n/** True when `index` starts a line (module top level in emitted output). */\nconst isAtLineStart = (code: string, index: number): boolean =>\n  index === 0 || code[index - 1] === '\\n';\n\n/**\n * Injects component source metadata onto custom element class constructors.\n * Returns whether any injection was made.\n */\nexport const injectSourceMeta = (\n  code: string,\n  filePath: string,\n  ms: MagicString\n): boolean => {\n  if (code.includes(SOURCE_META_SYM)) {\n    return false;\n  }\n  let changed = false;\n  const injected = new Set<string>();\n\n  const injectAtClassEnd = (\n    className: string,\n    matchIndex: number,\n    match: string\n  ) => {\n    if (injected.has(className)) return;\n    const classOffset = match.indexOf('class');\n    if (classOffset === -1) return;\n    const classStart = matchIndex + classOffset;\n    const end = findClassBodyEnd(code, classStart);\n    if (end === -1) return;\n    // Report the match start (the `@customElement` decorator) rather than the\n    // `class` keyword, so the overlay points at the top of the component.\n    const line = lineNumberAt(code, matchIndex);\n    // Insert right after the class body so the assignment lives in the same\n    // scope as the declaration — appending at module end breaks for a class\n    // declared inside a function or block.\n    ms.appendLeft(end, '\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  };\n\n  // @customElement(...) class Foo (any whitespace between them)\n  for (const m of code.matchAll(\n    /@customElement\\s*\\([^)]*\\)\\s+(?:export\\s+)?class\\s+(\\w+)/g\n  )) {\n    injectAtClassEnd(m[1], m.index, m[0]);\n  }\n\n  // customElements.define('tag', ClassName)\n  for (const m of code.matchAll(\n    /customElements\\.define\\s*\\(\\s*['\"][^'\"]+['\"]\\s*,\\s*(\\w+)/g\n  )) {\n    const className = m[1];\n    if (injected.has(className) || !isClassDeclaredInModule(code, className)) {\n      continue;\n    }\n    const line = lineNumberAt(code, m.index);\n    ms.append('\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  }\n\n  // TypeScript experimental-decorators / esbuild output\n  // e.g. `Foo = __decorateClass([customElement(...)], Foo)`\n  //       `Foo = _decorate([customElement(...)], Foo)`\n  for (const m of code.matchAll(\n    /(\\w+)\\s*=\\s*__decorate\\w*\\(\\s*\\[[\\s\\S]*?customElement\\s*\\([^)]*\\)[\\s\\S]*?\\],\\s*\\1\\)/g\n  )) {\n    const className = m[1];\n    if (injected.has(className) || !isAtLineStart(code, m.index)) continue;\n    const line = lineNumberAt(code, m.index);\n    ms.append('\\n' + makeAssignment(className, filePath, line));\n    injected.add(className);\n    changed = true;\n  }\n\n  return changed;\n};\n"]}

package/lib/timeline/derive.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Derivation over recorded timeline events.
+ *
+ * The capture layers emit one event per phase boundary, which is the right
+ * wire format and the wrong thing to read: a single update tick of one
+ * component is five to ten rows whose durations the reader has to subtract by
+ * hand. Everything needed to do better is already on the events — `groupId`
+ * pairs a start with its end, `data.changed` names the reactive properties
+ * that caused the update — so this module turns a flat event list into the
+ * three shapes the panel and agents actually ask for:
+ *
+ * - {@link TimelineSpan} — a start/end pair collapsed into one entry with a
+ *   duration ("`update` took 1.8ms").
+ * - {@link UpdateCycle} — one component's whole update tick, with the changed
+ *   property keys that triggered it ("`<hmr-counter>` updated because
+ *   `count` changed").
+ * - {@link ComponentRollup} — per-component totals over a recording ("this
+ *   component updated 340 times for 120ms").
+ *
+ * Pure and dependency-free by design: it imports only the shared event types,
+ * so the panel derives client-side over its 5000-event buffer and
+ * `devframe/definition.ts` — which must stay framework-neutral — can derive
+ * server-side over the ring buffer for the agent-facing summary.
+ */
+import type { TimelineEvent } from '../../types/timeline.js';
+/**
+ * A start/end pair collapsed into one entry, or a point event that never had
+ * an end to begin with.
+ */
+export interface TimelineSpan {
+    layerId: string;
+    /**
+     * Stable across re-derivation of the same events, which a Lit `repeat()`
+     * key and a selection comparison both need — the span objects themselves
+     * are rebuilt whenever the event buffer changes.
+     */
+    key: string;
+    /** The event title with its `:start` / `:end` suffix removed. */
+    name: string;
+    /** Pairing id as emitted; `undefined` for point events. */
+    groupId?: number | string;
+    start: number;
+    /** Absent while the span is still open, or if its end was never recorded. */
+    end?: number;
+    /** `end - start`. Absent for open spans and for point events. */
+    duration?: number;
+    /** Reactive property keys that caused this update, where the phase has them. */
+    changed?: string[];
+    subtitle?: string;
+    logType?: TimelineEvent['logType'];
+    meta?: TimelineEvent['meta'];
+    /** The events this span was built from, for the detail pane. */
+    events: TimelineEvent[];
+}
+/** One component's complete update tick. */
+export interface UpdateCycle {
+    /** The `${elementId}:${tick}` groupId the phases share. */
+    key: string;
+    elementId: number;
+    tagName: string;
+    source?: {
+        file: string;
+        line: number;
+    };
+    start: number;
+    /** The `performUpdate` span's duration — see {@link toUpdateCycles}. */
+    duration?: number;
+    /** Union of the changed reactive property keys across the tick's phases. */
+    changed: string[];
+    phases: TimelineSpan[];
+    /** The input event this update followed, if any. See {@link attributeInput}. */
+    cause?: {
+        layerId: string;
+        type: string;
+        detail?: string;
+        time: number;
+    };
+}
+/** Per-component totals over a set of update cycles. */
+export interface ComponentRollup {
+    tagName: string;
+    /** Every instance of this component that updated, in first-seen order. */
+    elementIds: number[];
+    updates: number;
+    /** Summed `performUpdate` durations; excludes cycles with no measured end. */
+    totalMs: number;
+    maxMs: number;
+    /** Changed-key frequency across the cycles, most frequent first. */
+    reasons: Array<{
+        key: string;
+        count: number;
+    }>;
+    source?: {
+        file: string;
+        line: number;
+    };
+}
+/**
+ * Collapses `:start` / `:end` event pairs into spans, passing anything else
+ * through as a point span.
+ *
+ * Pairing is keyed on **layer + groupId + phase name**, never on `groupId`
+ * alone: a whole update tick shares one groupId (`runtime/timeline/
+ * lifecycle.ts` builds it as `${elementId}:${tick}`), so matching on the id
+ * would marry `willUpdate:start` to `performUpdate:end`. Each phase occurs at
+ * most once per tick, which makes the triple unique.
+ *
+ * Unmatched halves survive rather than disappear — the buffer is a bounded
+ * ring, so its oldest end and its newest start routinely have no partner, and
+ * an update that is still running has a genuinely open span.
+ */
+export declare const toSpans: (events: readonly TimelineEvent[]) => TimelineSpan[];
+/**
+ * Groups lifecycle spans into update ticks.
+ *
+ * `duration` is taken from the `performUpdate` span alone, never from a sum of
+ * the phases: `willUpdate` / `update` / `updated` all run *inside*
+ * `performUpdate`, so summing counts the same milliseconds several times over.
+ *
+ * `changed` is the union across the tick's phases because only the phases that
+ * receive a `PropertyValues` argument carry it — `performUpdate` takes none,
+ * so the bracketing span is always silent about the reason.
+ */
+export declare const toUpdateCycles: (spans: readonly TimelineSpan[]) => UpdateCycle[];
+/**
+ * Totals update cycles per component tag.
+ *
+ * Grouped by tag rather than by instance because the question this answers is
+ * "which *component* re-renders too much" — a list of 200 rows each updating
+ * twice is one component's problem, not 200. The instance ids are kept so the
+ * caller can still drill in.
+ */
+export declare const rollup: (cycles: readonly UpdateCycle[]) => ComponentRollup[];
+/**
+ * Attributes each update cycle to the input event that preceded it, within
+ * `windowMs`.
+ *
+ * This is what the mouse and keyboard layers are for. On their own they
+ * duplicate what the browser's own event log already shows; joined to the
+ * updates they precede they answer the question the raw layers only imply —
+ * an update with a cause is an interaction, and an update without one is a
+ * timer, a signal, or a stray `requestUpdate()`.
+ *
+ * Returns a new array; cycles with no cause are returned as-is.
+ */
+export declare const attributeInput: (cycles: readonly UpdateCycle[], events: readonly TimelineEvent[], windowMs?: number) => UpdateCycle[];
+//# sourceMappingURL=derive.d.ts.map

package/lib/timeline/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/lib/timeline/derive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAc3D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gFAAgF;IAChF,KAAK,CAAC,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;CACxE;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC;CACvC;AAwBD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,WAAY,SAAS,aAAa,EAAE,KAAG,YAAY,EA0DtE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,UAClB,SAAS,YAAY,EAAE,KAC7B,WAAW,EAuCb,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,WAAY,SAAS,WAAW,EAAE,KAAG,eAAe,EAoDtE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,WACjB,SAAS,WAAW,EAAE,UACtB,SAAS,aAAa,EAAE,wBAE/B,WAAW,EA4Bb,CAAC"}