@oddsquad/vite-plugin-lit 0.6.0 → 0.7.0

package/lib/plugin.js.map

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

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

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

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

@@ -3,8 +3,8 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: BSD-3-Clause
  */
-import {existsSync} from 'node:fs';
-import {resolve as resolvePath, sep} from 'node:path';
+import {resolve as resolvePath} from 'node:path';
+import {confineToRoots} from '../confine.js';
 import {toLaunchEditor} from '../devframe/launch-editor.js';
 import {isTrustedRequest} from '../http.js';
 export const OPEN_IN_EDITOR_PATH = '/__lit-open-in-editor';
@@ -37,25 +37,17 @@ export const createOpenInEditorMiddleware = (allowedRoots) => {
       res.end('missing file parameter');
       return;
     }
-    // Confine the open to the allowed roots: resolve the requested path and
-    // reject anything that escapes all of them (path traversal, absolute
-    // paths to arbitrary files). `launch-editor` spawns the user's editor on
-    // this path, so an unvalidated `file` is a local-file-open /
-    // arg-injection vector.
-    const resolved = resolvePath(roots[0] ?? process.cwd(), file);
-    const allowed = roots.some(
-      (root) => resolved === root || resolved.startsWith(root + sep)
-    );
-    if (!allowed) {
-      res.statusCode = 403;
-      res.end('file outside allowed roots');
-      return;
-    }
-    if (!existsSync(resolved)) {
-      res.statusCode = 404;
-      res.end('file not found');
+    // Confine the open to the allowed roots: `launch-editor` spawns the
+    // user's editor on this path, so an unvalidated `file` is a
+    // local-file-open / arg-injection vector.
+    const confined = confineToRoots(roots, file);
+    if ('failure' in confined) {
+      const outside = confined.failure === 'outside';
+      res.statusCode = outside ? 403 : 404;
+      res.end(outside ? 'file outside allowed roots' : 'file not found');
       return;
     }
+    const resolved = confined.path;
     // Coerce to integers so a crafted `line`/`column` can't smuggle extra
     // shell-visible content through the `file:line:column` ref.
     const line = String(

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

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

package/lib/plugins/private-fields.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import type { Plugin } from 'vite';
+import MagicString from 'magic-string';
+/**
+ * Rewrites native `#private` class members into computed keys backed by
+ * `Symbol.for(...)`. The key is stable across re-evaluations of the module,
+ * so instances built by an earlier evaluation of a class and methods copied
+ * from a later one agree on where private state lives. That is what lets HMR
+ * patch a class in place. Returns `null` when there is nothing to rewrite or
+ * the module can't be handled safely.
+ */
+export declare const rewritePrivateNames: (code: string, id: string) => {
+    code: string;
+    map: ReturnType<MagicString['generateMap']>;
+} | null;
+/**
+ * Dev-only transform that swaps native `#private` class members for stable
+ * symbol keys so HMR's in-place class patching keeps working. See
+ * {@link rewritePrivateNames}. `enabled` is read lazily because options are
+ * re-resolved against the loaded env after the plugin array is built.
+ */
+export declare const litPrivateFields: (enabled: () => boolean) => Plugin;
+//# sourceMappingURL=private-fields.d.ts.map

package/lib/plugins/private-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-fields.d.ts","sourceRoot":"","sources":["../../src/lib/plugins/private-fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,MAAM,CAAC;AAEjC,OAAO,WAAW,MAAM,cAAc,CAAC;AAwCvC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,MACR,MAAM,KACT;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAA;CAAC,GAAG,IA4NhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,YAAa,MAAM,OAAO,KAAG,MAgBxD,CAAC"}

package/lib/plugins/private-fields.js

@@ -0,0 +1,259 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+import {parseAst} from 'vite';
+import MagicString from 'magic-string';
+import {JS_FILE_RE} from './shared.js';
+const PRIVATE_KEY_HOLDERS = new Set([
+  'PropertyDefinition',
+  'MethodDefinition',
+  'AccessorProperty',
+]);
+const isNode = (v) =>
+  v !== null && typeof v === 'object' && typeof v.type === 'string';
+/** Private names declared directly in a class body. */
+const declaredNames = (cls) => {
+  const body = cls.body;
+  const out = [];
+  for (const member of body?.body ?? []) {
+    if (
+      PRIVATE_KEY_HOLDERS.has(member.type) &&
+      isNode(member.key) &&
+      member.key.type === 'PrivateIdentifier'
+    ) {
+      out.push(member);
+    }
+  }
+  return out;
+};
+/**
+ * Rewrites native `#private` class members into computed keys backed by
+ * `Symbol.for(...)`. The key is stable across re-evaluations of the module,
+ * so instances built by an earlier evaluation of a class and methods copied
+ * from a later one agree on where private state lives. That is what lets HMR
+ * patch a class in place. Returns `null` when there is nothing to rewrite or
+ * the module can't be handled safely.
+ */
+export const rewritePrivateNames = (code, id) => {
+  if (!code.includes('#')) {
+    return null;
+  }
+  const [file] = id.split('?', 1);
+  let ast;
+  try {
+    ast = parseAst(code, {sourceType: 'module'}, file);
+  } catch {
+    return null;
+  }
+  let prefix = '__litPriv';
+  while (code.includes(prefix)) {
+    prefix += '_';
+  }
+  const magic = new MagicString(code);
+  const decls = [];
+  const classKeyCounts = new Map();
+  let symbolCount = 0;
+  let failed = false;
+  const symbolFor = (scope, name) => scope.names.get(name);
+  const resolve = (stack, name) => {
+    for (let i = stack.length - 1; i >= 0; i--) {
+      const sym = symbolFor(stack[i], name);
+      if (sym !== undefined) {
+        return sym;
+      }
+    }
+    failed = true;
+    return '';
+  };
+  const classKeyOf = (cls, hint) => {
+    const cid = cls.id;
+    const base = cid?.name ?? hint ?? 'anonymous';
+    const n = classKeyCounts.get(base) ?? 0;
+    classKeyCounts.set(base, n + 1);
+    return n === 0 ? base : `${base}~${n}`;
+  };
+  const rewriteMemberAccess = (node, sym) => {
+    const prop = node.property;
+    // Find the `.` / `?.` token before the property; the object's own end
+    // can't be used because a parenthesised object ends before its `)`.
+    let i = prop.start - 1;
+    while (i >= 0 && /\s/.test(code[i])) {
+      i--;
+    }
+    if (code[i] !== '.') {
+      failed = true;
+      return;
+    }
+    const optional = code[i - 1] === '?';
+    const from = optional ? i - 1 : i;
+    magic.overwrite(from, prop.end, `${optional ? '?.' : ''}[${sym}]`);
+  };
+  const visit = (node, stack, hint) => {
+    if (failed || node === null || typeof node !== 'object') {
+      return;
+    }
+    if (Array.isArray(node)) {
+      for (const item of node) {
+        visit(item, stack, hint);
+      }
+      return;
+    }
+    if (!isNode(node)) {
+      return;
+    }
+    if (node.type === 'ClassDeclaration' || node.type === 'ClassExpression') {
+      const members = declaredNames(node);
+      const heritage = node.superClass;
+      // Decorators are outside the class body's private-name scope.
+      visit(node.decorators, stack, undefined);
+      visit(heritage, stack, undefined);
+      if (members.length === 0) {
+        visit(node.body, stack, undefined);
+        return;
+      }
+      const classKey = classKeyOf(node, hint);
+      const scope = {names: new Map()};
+      for (const member of members) {
+        const name = member.key.name;
+        if (!scope.names.has(name)) {
+          const ident = `${prefix}${symbolCount++}`;
+          scope.names.set(name, ident);
+          decls.push(
+            `const ${ident} = Symbol.for(${JSON.stringify(`@oddsquad/vite-plugin-lit#private:${file}:${classKey}#${name}`)});`
+          );
+        }
+        if (member.decorators?.length) {
+          // A decorator directly before a computed key would parse as an
+          // index access on the decorator expression.
+          failed = true;
+          return;
+        }
+        const key = member.key;
+        const sym = scope.names.get(name);
+        // A computed key at the start of a member can continue the previous
+        // member's initializer when that one relied on ASI (`a = 1` + newline
+        // + `#b`), so lead with an explicit terminator.
+        let lead = '';
+        if (member.start === key.start) {
+          let j = key.start - 1;
+          while (j >= 0 && /\s/.test(code[j])) {
+            j--;
+          }
+          if (code[j] !== '{' && code[j] !== ';') {
+            lead = ';';
+          }
+        }
+        magic.overwrite(key.start, key.end, `${lead}[${sym}]`);
+      }
+      // Members: keys of non-private members and all values live in scope.
+      const inner = [...stack, scope];
+      const body = node.body;
+      for (const member of body.body ?? []) {
+        for (const k in member) {
+          if (k === 'parent' || (k === 'key' && isPrivateKey(member))) {
+            continue;
+          }
+          visit(member[k], inner, undefined);
+        }
+      }
+      return;
+    }
+    if (node.type === 'MemberExpression' && isNode(node.property)) {
+      if (node.property.type === 'PrivateIdentifier') {
+        const sym = resolve(stack, node.property.name);
+        if (failed) {
+          return;
+        }
+        rewriteMemberAccess(node, sym);
+        visit(node.object, stack, undefined);
+        return;
+      }
+    }
+    if (
+      node.type === 'BinaryExpression' &&
+      isNode(node.left) &&
+      node.left.type === 'PrivateIdentifier'
+    ) {
+      const sym = resolve(stack, node.left.name);
+      if (failed) {
+        return;
+      }
+      magic.overwrite(node.left.start, node.left.end, sym);
+      visit(node.right, stack, undefined);
+      return;
+    }
+    let childHint;
+    for (const key in node) {
+      if (key === 'parent') {
+        continue;
+      }
+      switch (node.type) {
+        case 'VariableDeclarator':
+          childHint =
+            key === 'init' && isNode(node.id) && node.id.type === 'Identifier'
+              ? node.id.name
+              : undefined;
+          break;
+        case 'AssignmentExpression':
+          childHint =
+            key === 'right' &&
+            isNode(node.left) &&
+            node.left.type === 'Identifier'
+              ? node.left.name
+              : undefined;
+          break;
+        case 'ExportDefaultDeclaration':
+          childHint = 'default';
+          break;
+        default:
+          childHint = undefined;
+      }
+      visit(node[key], stack, childHint);
+    }
+  };
+  const isPrivateKey = (member) =>
+    PRIVATE_KEY_HOLDERS.has(member.type) &&
+    isNode(member.key) &&
+    member.key.type === 'PrivateIdentifier';
+  visit(ast, [], undefined);
+  if (failed || decls.length === 0) {
+    return null;
+  }
+  const header = `${decls.join('')}\n`;
+  if (code.startsWith('#!')) {
+    const nl = code.indexOf('\n');
+    if (nl === -1) {
+      return null;
+    }
+    magic.appendLeft(nl + 1, header);
+  } else {
+    magic.prepend(header);
+  }
+  return {code: magic.toString(), map: magic.generateMap({hires: 'boundary'})};
+};
+/**
+ * Dev-only transform that swaps native `#private` class members for stable
+ * symbol keys so HMR's in-place class patching keeps working. See
+ * {@link rewritePrivateNames}. `enabled` is read lazily because options are
+ * re-resolved against the loaded env after the plugin array is built.
+ */
+export const litPrivateFields = (enabled) => ({
+  name: 'lit-private-fields',
+  apply: 'serve',
+  transform(code, id, options) {
+    if (options?.ssr || !enabled()) {
+      return null;
+    }
+    if (id.startsWith('\0') || id.includes('/node_modules/')) {
+      return null;
+    }
+    const [file, query] = id.split('?', 2);
+    if (!JS_FILE_RE.test(file) && !query?.includes('html-proxy')) {
+      return null;
+    }
+    return rewritePrivateNames(code, id);
+  },
+});
+//# sourceMappingURL=private-fields.js.map

package/lib/plugins/private-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-fields.js","sourceRoot":"","sources":["../../src/lib/plugins/private-fields.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 {Plugin} from 'vite';\nimport {parseAst} from 'vite';\nimport MagicString from 'magic-string';\nimport {JS_FILE_RE} from './shared.js';\n\ntype Node = Record<string, unknown> & {\n  type: string;\n  start: number;\n  end: number;\n};\n\n/** One class body that declares at least one private name. */\ninterface ClassScope {\n  /** Private name (without `#`) to the identifier of its symbol constant. */\n  names: Map<string, string>;\n}\n\nconst PRIVATE_KEY_HOLDERS = new Set([\n  'PropertyDefinition',\n  'MethodDefinition',\n  'AccessorProperty',\n]);\n\nconst isNode = (v: unknown): v is Node =>\n  v !== null && typeof v === 'object' && typeof (v as Node).type === 'string';\n\n/** Private names declared directly in a class body. */\nconst declaredNames = (cls: Node): Node[] => {\n  const body = cls.body as {body?: Node[]} | undefined;\n  const out: Node[] = [];\n  for (const member of body?.body ?? []) {\n    if (\n      PRIVATE_KEY_HOLDERS.has(member.type) &&\n      isNode(member.key) &&\n      member.key.type === 'PrivateIdentifier'\n    ) {\n      out.push(member);\n    }\n  }\n  return out;\n};\n\n/**\n * Rewrites native `#private` class members into computed keys backed by\n * `Symbol.for(...)`. The key is stable across re-evaluations of the module,\n * so instances built by an earlier evaluation of a class and methods copied\n * from a later one agree on where private state lives. That is what lets HMR\n * patch a class in place. Returns `null` when there is nothing to rewrite or\n * the module can't be handled safely.\n */\nexport const rewritePrivateNames = (\n  code: string,\n  id: string\n): {code: string; map: ReturnType<MagicString['generateMap']>} | null => {\n  if (!code.includes('#')) {\n    return null;\n  }\n  const [file] = id.split('?', 1);\n  let ast: Node;\n  try {\n    ast = parseAst(code, {sourceType: 'module'}, file) as unknown as Node;\n  } catch {\n    return null;\n  }\n\n  let prefix = '__litPriv';\n  while (code.includes(prefix)) {\n    prefix += '_';\n  }\n\n  const magic = new MagicString(code);\n  const decls: string[] = [];\n  const classKeyCounts = new Map<string, number>();\n  let symbolCount = 0;\n  let failed = false;\n\n  const symbolFor = (scope: ClassScope, name: string): string | undefined =>\n    scope.names.get(name);\n\n  const resolve = (stack: ClassScope[], name: string): string => {\n    for (let i = stack.length - 1; i >= 0; i--) {\n      const sym = symbolFor(stack[i], name);\n      if (sym !== undefined) {\n        return sym;\n      }\n    }\n    failed = true;\n    return '';\n  };\n\n  const classKeyOf = (cls: Node, hint: string | undefined): string => {\n    const cid = cls.id as {name?: string} | null | undefined;\n    const base = cid?.name ?? hint ?? 'anonymous';\n    const n = classKeyCounts.get(base) ?? 0;\n    classKeyCounts.set(base, n + 1);\n    return n === 0 ? base : `${base}~${n}`;\n  };\n\n  const rewriteMemberAccess = (node: Node, sym: string): void => {\n    const prop = node.property as Node;\n    // Find the `.` / `?.` token before the property; the object's own end\n    // can't be used because a parenthesised object ends before its `)`.\n    let i = prop.start - 1;\n    while (i >= 0 && /\\s/.test(code[i])) {\n      i--;\n    }\n    if (code[i] !== '.') {\n      failed = true;\n      return;\n    }\n    const optional = code[i - 1] === '?';\n    const from = optional ? i - 1 : i;\n    magic.overwrite(from, prop.end, `${optional ? '?.' : ''}[${sym}]`);\n  };\n\n  const visit = (\n    node: unknown,\n    stack: ClassScope[],\n    hint: string | undefined\n  ): void => {\n    if (failed || node === null || typeof node !== 'object') {\n      return;\n    }\n    if (Array.isArray(node)) {\n      for (const item of node) {\n        visit(item, stack, hint);\n      }\n      return;\n    }\n    if (!isNode(node)) {\n      return;\n    }\n\n    if (node.type === 'ClassDeclaration' || node.type === 'ClassExpression') {\n      const members = declaredNames(node);\n      const heritage = node.superClass;\n      // Decorators are outside the class body's private-name scope.\n      visit(node.decorators, stack, undefined);\n      visit(heritage, stack, undefined);\n      if (members.length === 0) {\n        visit(node.body, stack, undefined);\n        return;\n      }\n      const classKey = classKeyOf(node, hint);\n      const scope: ClassScope = {names: new Map()};\n      for (const member of members) {\n        const name = (member.key as unknown as {name: string}).name;\n        if (!scope.names.has(name)) {\n          const ident = `${prefix}${symbolCount++}`;\n          scope.names.set(name, ident);\n          decls.push(\n            `const ${ident} = Symbol.for(${JSON.stringify(\n              `@oddsquad/vite-plugin-lit#private:${file}:${classKey}#${name}`\n            )});`\n          );\n        }\n        if ((member.decorators as unknown[] | undefined)?.length) {\n          // A decorator directly before a computed key would parse as an\n          // index access on the decorator expression.\n          failed = true;\n          return;\n        }\n        const key = member.key as Node;\n        const sym = scope.names.get(name)!;\n        // A computed key at the start of a member can continue the previous\n        // member's initializer when that one relied on ASI (`a = 1` + newline\n        // + `#b`), so lead with an explicit terminator.\n        let lead = '';\n        if (member.start === key.start) {\n          let j = key.start - 1;\n          while (j >= 0 && /\\s/.test(code[j])) {\n            j--;\n          }\n          if (code[j] !== '{' && code[j] !== ';') {\n            lead = ';';\n          }\n        }\n        magic.overwrite(key.start, key.end, `${lead}[${sym}]`);\n      }\n      // Members: keys of non-private members and all values live in scope.\n      const inner = [...stack, scope];\n      const body = node.body as Node;\n      for (const member of (body.body as Node[]) ?? []) {\n        for (const k in member) {\n          if (k === 'parent' || (k === 'key' && isPrivateKey(member))) {\n            continue;\n          }\n          visit(member[k], inner, undefined);\n        }\n      }\n      return;\n    }\n\n    if (node.type === 'MemberExpression' && isNode(node.property)) {\n      if (node.property.type === 'PrivateIdentifier') {\n        const sym = resolve(\n          stack,\n          (node.property as unknown as {name: string}).name\n        );\n        if (failed) {\n          return;\n        }\n        rewriteMemberAccess(node, sym);\n        visit(node.object, stack, undefined);\n        return;\n      }\n    }\n\n    if (\n      node.type === 'BinaryExpression' &&\n      isNode(node.left) &&\n      node.left.type === 'PrivateIdentifier'\n    ) {\n      const sym = resolve(stack, (node.left as unknown as {name: string}).name);\n      if (failed) {\n        return;\n      }\n      magic.overwrite(node.left.start, node.left.end, sym);\n      visit(node.right, stack, undefined);\n      return;\n    }\n\n    let childHint: string | undefined;\n    for (const key in node) {\n      if (key === 'parent') {\n        continue;\n      }\n      switch (node.type) {\n        case 'VariableDeclarator':\n          childHint =\n            key === 'init' && isNode(node.id) && node.id.type === 'Identifier'\n              ? (node.id as unknown as {name: string}).name\n              : undefined;\n          break;\n        case 'AssignmentExpression':\n          childHint =\n            key === 'right' &&\n            isNode(node.left) &&\n            node.left.type === 'Identifier'\n              ? (node.left as unknown as {name: string}).name\n              : undefined;\n          break;\n        case 'ExportDefaultDeclaration':\n          childHint = 'default';\n          break;\n        default:\n          childHint = undefined;\n      }\n      visit(node[key], stack, childHint);\n    }\n  };\n\n  const isPrivateKey = (member: Node): boolean =>\n    PRIVATE_KEY_HOLDERS.has(member.type) &&\n    isNode(member.key) &&\n    member.key.type === 'PrivateIdentifier';\n\n  visit(ast, [], undefined);\n  if (failed || decls.length === 0) {\n    return null;\n  }\n\n  const header = `${decls.join('')}\\n`;\n  if (code.startsWith('#!')) {\n    const nl = code.indexOf('\\n');\n    if (nl === -1) {\n      return null;\n    }\n    magic.appendLeft(nl + 1, header);\n  } else {\n    magic.prepend(header);\n  }\n  return {code: magic.toString(), map: magic.generateMap({hires: 'boundary'})};\n};\n\n/**\n * Dev-only transform that swaps native `#private` class members for stable\n * symbol keys so HMR's in-place class patching keeps working. See\n * {@link rewritePrivateNames}. `enabled` is read lazily because options are\n * re-resolved against the loaded env after the plugin array is built.\n */\nexport const litPrivateFields = (enabled: () => boolean): Plugin => ({\n  name: 'lit-private-fields',\n  apply: 'serve',\n  transform(code, id, options) {\n    if (options?.ssr || !enabled()) {\n      return null;\n    }\n    if (id.startsWith('\\0') || id.includes('/node_modules/')) {\n      return null;\n    }\n    const [file, query] = id.split('?', 2);\n    if (!JS_FILE_RE.test(file) && !query?.includes('html-proxy')) {\n      return null;\n    }\n    return rewritePrivateNames(code, id);\n  },\n});\n"]}

package/lib/runtime/child-state.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Carries child element state across a template re-instantiation.
+ *
+ * When a hot patch changes a template's text, lit-html sees a new template,
+ * clones fresh DOM and swaps it in: every custom element inside the edited
+ * template is re-created and starts from its defaults. For a short window
+ * after a hot patch this module pairs each element dropped from a root with
+ * the next freshly created element of the same tag connected in that root
+ * (FIFO, i.e. document order), then either copies the old element's state
+ * onto the new one (`'transfer'`) or, where the new element carries no
+ * bindings, puts the old element back in its place (`'reuse'`).
+ *
+ * Dependency-free and duck-typed like `patch.ts`. The lit-html internals it
+ * reads (`_$litPart$`, `_$committedValue`, `_$template`, `_$parts`,
+ * `_$startNode`, `_$endNode`) are looked up by their development names first
+ * and then by the stable minified names lit's prod build gives them
+ * (`_$AH`, `_$AD`, `_$AV`, `_$AA`, `_$AB`). Every access is guarded; when the
+ * part tree can't be read, transfer skips only attribute-driven keys and
+ * reuse falls back to transfer.
+ */
+export type ChildStateMode = 'reset' | 'transfer' | 'reuse';
+/** `Symbol.for` description prefix of the dev-only `#private` rewrite. */
+export declare const PRIVATE_KEY_PREFIX = "@oddsquad/vite-plugin-lit#private:";
+/** Hard cap on how long a transfer window stays open. */
+export declare const WINDOW_CAP_MS = 1000;
+/** Duck-typed lit-html part. */
+export interface PartLike {
+    type: number;
+    element?: unknown;
+    name?: unknown;
+}
+/** Duck-typed element the window works with. */
+export type ElementLike = HTMLElement & {
+    renderRoot?: unknown;
+    hasUpdated?: boolean;
+    updateComplete?: unknown;
+};
+/**
+ * Every lit-html part rendered into the tree `el` lives in: the parts of each
+ * render container (`_$litPart$`) among `el`'s ancestors up to its root.
+ * `undefined` when `el` isn't in a tree or the walk hits a surprise.
+ */
+export declare const partsAround: (el: Node) => PartLike[] | undefined;
+/**
+ * Reactive property keys the new element already got from its template:
+ * keys whose attribute is present on it (static attributes), plus, when the
+ * part tree could be read, keys bound by a property, boolean or attribute
+ * part targeting it.
+ */
+export declare const templateDrivenKeys: (el: ElementLike, parts: readonly PartLike[] | undefined) => Set<PropertyKey>;
+/** Own symbol keys of `el` minted by the dev-only `#private` rewrite. */
+export declare const privateKeys: (el: object) => symbol[];
+/**
+ * Copies `from`'s state onto `to`: reactive properties not driven by `to`'s
+ * template, and the `#private` members the dev rewrite turned into
+ * `Symbol.for` keys. Nothing else — Lit's own bookkeeping lives in string
+ * keys and must stay per-instance.
+ */
+export declare const transferState: (from: ElementLike, to: ElementLike, parts: readonly PartLike[] | undefined) => void;
+/**
+ * Whether `el` (and its light DOM) carries no bindings, so another element
+ * can take its place without lit-html noticing: no part targets it or an
+ * element inside it, no child part's markers or parent lie inside it, and
+ * nothing rendered into it as a container. `false` when `parts` is unknown.
+ */
+export declare const isReuseSafe: (el: ElementLike, parts: readonly PartLike[] | undefined) => boolean;
+/**
+ * Puts `old` back where `fresh` is: `old` takes `fresh`'s attributes and
+ * light-DOM children, then replaces it. `old` keeps its identity, state,
+ * shadow DOM and controllers, and reconnects.
+ */
+export declare const swapBack: (old: ElementLike, fresh: ElementLike) => void;
+export interface ChildStateOptions {
+    /** Read at every `open()`. */
+    mode: () => ChildStateMode;
+    /** Hard cap on a window's lifetime. Defaults to {@link WINDOW_CAP_MS}. */
+    capMs?: number;
+}
+export interface ChildState {
+    /**
+     * From the instrumented `connectedCallback`, before the original runs.
+     * `fresh` is whether the element has never been connected before.
+     */
+    connected(el: ElementLike, fresh: boolean): void;
+    /** From the instrumented `disconnectedCallback`. */
+    disconnected(el: ElementLike): void;
+    /** A hot patch is about to re-render instances: open (or extend) a window. */
+    open(): void;
+    /** Keep the window open until these instances' updates complete. */
+    watch(els: Iterable<ElementLike>): void;
+    /** Whether a window is currently open. */
+    readonly active: boolean;
+}
+export declare const createChildState: (options: ChildStateOptions) => ChildState;
+//# sourceMappingURL=child-state.d.ts.map

package/lib/runtime/child-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-state.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/child-state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,uCAAuC,CAAC;AAEvE,yDAAyD;AACzD,eAAO,MAAM,aAAa,OAAO,CAAC;AAelC,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAuDF;;;;GAIG;AACH,eAAO,MAAM,WAAW,OAAQ,IAAI,KAAG,QAAQ,EAAE,GAAG,SAkBnD,CAAC;AAiCF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,OACzB,WAAW,SACR,SAAS,QAAQ,EAAE,GAAG,SAAS,KACrC,GAAG,CAAC,WAAW,CAyBjB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,WAAW,OAAQ,MAAM,KAAG,MAAM,EAG5C,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,aAAa,SAClB,WAAW,MACb,WAAW,SACR,SAAS,QAAQ,EAAE,GAAG,SAAS,KACrC,IA6BF,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,OAClB,WAAW,SACR,SAAS,QAAQ,EAAE,GAAG,SAAS,KACrC,OA6BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAS,WAAW,SAAS,WAAW,KAAG,IAa/D,CAAC;AAwBF,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,cAAc,CAAC;IAC3B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,oDAAoD;IACpD,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,8EAA8E;IAC9E,IAAI,IAAI,IAAI,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,YAAa,iBAAiB,KAAG,UA6M7D,CAAC"}