@immense/vue-pom-generator 1.0.36 → 1.0.37

package/README.md

@@ -147,13 +147,35 @@ export default defineConfig(() => {
 
 Notes:
 
-- `vuePomGenerator(...)` already wires `@vitejs/plugin-vue` internally for non-Nuxt apps.
-- Do not pass `vue()` into `createVuePomGeneratorPlugins(...)`; pass Vue options via `vueOptions`.
+- `vuePomGenerator(...)` wires `@vitejs/plugin-vue` internally by default for standard Vue apps.
+- Do not pass `vue()` into `createVuePomGeneratorPlugins(...)`; pass Vue plugin options via `vueOptions`.
+- When the app should own `vue()` explicitly, set `vuePluginOwnership: "external"` and add `vue()` separately in your Vite config.
 
 - **Injection is enabled by plugin inclusion** (there is no longer an `injection.enabled` flag).
 - **Generation is enabled by default** and can be disabled via `generation: false`.
 - **Router-aware POM helpers are enabled** when `generation.router.entry` is provided (the generator will introspect your router).
 
+### External Vue plugin ownership
+
+If your app should own the core Vue Vite plugin explicitly, add `vue()` yourself and let this package patch the resolved plugin:
+
+```ts
+import vue from "@vitejs/plugin-vue";
+import { defineConfig } from "vite";
+import { defineVuePomGeneratorConfig, vuePomGenerator } from "@immense/vue-pom-generator";
+
+const pomConfig = defineVuePomGeneratorConfig({
+  vuePluginOwnership: "external",
+});
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    ...vuePomGenerator(pomConfig),
+  ],
+});
+```
+
 ### `generation.router`
 
 Controls router introspection for `:to` analysis and navigation helper generation.
@@ -204,7 +226,9 @@ When you want CI/builds to fail on explicit test ids, pair `existingIdBehavior:
 
 ### ESLint cleanup rule: remove existing test-id attributes
 
-Use the `remove-existing-test-id-attributes` rule to strip explicit test-id attributes from `.vue` files before or while enforcing `existingIdBehavior: "error"`.
+Use the `remove-existing-test-id-attributes` rule to strip explicit test-id usage from `.vue` files before or while enforcing `existingIdBehavior: "error"`.
+
+The fixer handles both template attributes like `data-testid="save-button"` and object-literal keys such as `inputAttr: { 'data-testid': 'save-button' }` inside Vue SFC expressions/scripts.
 
 Add this to your ESLint flat-config file, typically `eslint.config.ts` (or `eslint.config.js` / `eslint.config.mjs` at the project root):
 

package/RELEASE_NOTES.md

@@ -1,33 +1,44 @@
-● ## v1.0.36
+● # Release Notes: v1.0.37
 
-  ### Highlights
+  ## Highlights
 
-  - Fixed handler collision suffixes to prevent naming conflicts in strict error mode
-  - Improved handler suffix derivation by skipping unstable leading arguments
-  - Enhanced detection of constant-like member expressions for more stable naming
-  - Added comprehensive test coverage for collision avoidance scenarios
+  - Added support for external Vue plugin ownership, enabling better plugin architecture
+  extensibility
+  - Stabilized generator plugin refactor with improved plugin handling and configuration
+  - Enhanced build plugin with expanded functionality (72+ lines added)
+  - Refactored test suite with improved coverage and organization
+  - Added automated PR release-notes preview comments to development workflow
 
-  ### Changes
+  ## Changes
 
-  **Bug Fixes**
-  - Fixed handler collision suffixes when generating test IDs and POM methods (#27dc566)
-  - Skip unstable leading arguments when deriving handler suffixes from function arguments
-  - Check up to 4 arguments (previously 2) to find stable literal/constant values
-  - Validate constant-like root identifiers (e.g., `RebootPreference.Suppress`) before using
-  member expression names
+  ### Plugin System
+  - Added external Vue plugin ownership support for more flexible plugin architecture
+  - Refactored `create-vue-pom-generator-plugins.ts` with 134 lines of improvements
+  - Enhanced `build-plugin.ts` with additional capabilities and refinements
+  - Simplified `dev-plugin.ts` by removing ~34 lines of redundant code
+  - Updated plugin types with new interfaces and type definitions
 
-  **Testing**
-  - Added test for strict-mode collision avoidance with later stable args
-  - Added utility test coverage for `getRootIdentifierFromMemberChain` function
-  - New test validates `clickRunDeploymentActionAssign` method generation without conflicts
+  ### Documentation
+  - Expanded README.md with 30+ lines of additional documentation
 
-  ### Pull Requests Included
+  ### Testing
+  - Restructured `options.test.ts` with 163 lines of changes for better test coverage and clarity
 
-  - [#1](https://github.com/immense/vue-pom-generator/pull/1) - Add PR release-notes preview
-  comments (merged 2026-02-02, not in v1.0.36 window)
+  ### Code Quality
+  - Improved class generation logic
+  - Refined Vue plugin integration points
 
-  ### Testing
+  ## Breaking Changes
+
+  None identified.
+
+  ## Pull Requests Included
+
+  - [#1](https://github.com/immense/vue-pom-generator/pull/1) Add PR release-notes preview
+  comments (@dkattan)
+
+  ## Testing
 
-  Added 44 lines of test coverage across `transform.test.ts` and `utils-coverage.test.ts` to
-  validate collision handling improvements.
+  Test suite refactored and expanded in `tests/options.test.ts` with improved organization and
+  coverage.
 

package/class-generation/index.ts

@@ -233,7 +233,6 @@ function generateExtraClickMethodContent(spec: PomExtraClickMethodSpec): string
   if (labelNeedsTemplate) {
     lines.push(`        const label = ${labelExpr};`);
   }
-
   const rootArg = rootNeedsTemplate ? "rootTestId" : rootExpr;
   const labelArg = labelNeedsTemplate ? "label" : labelExpr;
   lines.push(`        await this.clickWithinTestIdByLabel(${rootArg}, ${labelArg}, ${annotationArg}, ${waitArg});`);
@@ -1896,8 +1895,9 @@ function getWidgetInstancesForView(
       continue;
     }
 
-    if (!availableClassIdentifiers.has(className))
+    if (!availableClassIdentifiers.has(className)) {
       continue;
+    }
 
     // Prefer stripping the view prefix (e.g. PreferencesPage-) for cleaner member names.
     const viewPrefix = `${componentName}-`;

package/dist/class-generation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../class-generation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAoE,MAAM,UAAU,CAAC;AAQpH,OAAO,EAAE,oCAAoC,EAAE,CAAC;AA8ChD,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwPD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,oCAAoC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEzD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,wBAAwB,EAAE,MAAM,EAAE,CAAC;QAEnC;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;KAC5C,CAAC,CAAC;IAEH,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IAEvC,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAEnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAwCD,wBAAsB,aAAa,CACjC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC1D,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,oBAAyB,iBAkFnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../class-generation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAoE,MAAM,UAAU,CAAC;AAQpH,OAAO,EAAE,oCAAoC,EAAE,CAAC;AA8ChD,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuPD,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE1D;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,oCAAoC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAEzD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,wBAAwB,EAAE,MAAM,EAAE,CAAC;QAEnC;;;WAGG;QACH,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;KAC5C,CAAC,CAAC;IAEH,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;IAEvC,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,6EAA6E;IAC7E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,UAAU,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAEnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAwCD,wBAAsB,aAAa,CACjC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAC1D,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,iBAAiB,EAAE,MAAM,EACzB,OAAO,GAAE,oBAAyB,iBAkFnC"}

package/dist/index.cjs

@@ -4525,8 +4525,9 @@ function getWidgetInstancesForView(componentName, dataTestIdSet, availableClassI
     } else {
       continue;
     }
-    if (!availableClassIdentifiers.has(className))
+    if (!availableClassIdentifiers.has(className)) {
       continue;
+    }
     const viewPrefix = `${componentName}-`;
     const descriptorRaw = stem.startsWith(viewPrefix) ? stem.slice(viewPrefix.length) : stem;
     const descriptorPascal = toPascalCaseLocal(descriptorRaw);
@@ -4595,32 +4596,31 @@ function getConstructor(childrenComponent, componentHierarchyMap, attachmentsFor
   return `${content}
 `;
 }
-function getGenerationMetrics(componentHierarchyMap) {
-  let selectorCount = 0;
-  let generatedMethodCount = 0;
-  for (const deps of componentHierarchyMap.values()) {
-    selectorCount += deps.dataTestIdSet?.size ?? 0;
-    generatedMethodCount += deps.generatedMethods?.size ?? 0;
+function summarizeHierarchyMap(componentHierarchyMap) {
+  let interactiveComponentCount = 0;
+  let dataTestIdCount = 0;
+  for (const dependencies of componentHierarchyMap.values()) {
+    const selectorCount = dependencies.dataTestIdSet?.size ?? 0;
+    if (selectorCount > 0) {
+      interactiveComponentCount += 1;
+      dataTestIdCount += selectorCount;
+    }
   }
   return {
     entryCount: componentHierarchyMap.size,
-    selectorCount,
-    generatedMethodCount
+    interactiveComponentCount,
+    dataTestIdCount
   };
 }
-function isLessRich(current, previous) {
-  if (current.entryCount !== previous.entryCount) {
-    return current.entryCount < previous.entryCount;
+function isLessRich(candidate, previous) {
+  if (candidate.dataTestIdCount !== previous.dataTestIdCount) {
+    return candidate.dataTestIdCount < previous.dataTestIdCount;
   }
-  if (current.selectorCount !== previous.selectorCount) {
-    return current.selectorCount < previous.selectorCount;
+  if (candidate.interactiveComponentCount !== previous.interactiveComponentCount) {
+    return candidate.interactiveComponentCount < previous.interactiveComponentCount;
   }
-  return current.generatedMethodCount < previous.generatedMethodCount;
-}
-function getGenerationMetricsKey(projectRoot, outDir) {
-  return path.resolve(projectRoot, outDir ?? "./pom");
+  return candidate.entryCount < previous.entryCount;
 }
-const buildGenerationMetricsByOutputKey = /* @__PURE__ */ new Map();
 function createBuildProcessorPlugin(options) {
   const {
     componentHierarchyMap,
@@ -4645,6 +4645,11 @@ function createBuildProcessorPlugin(options) {
     routerModuleShims,
     loggerRef
   } = options;
+  let lastGeneratedMetrics = {
+    entryCount: 0,
+    interactiveComponentCount: 0,
+    dataTestIdCount: 0
+  };
   return {
     name: "vue-pom-generator-build",
     // This plugin exists to generate code on build output; it is not needed during dev-server HMR.
@@ -4697,17 +4702,18 @@ function createBuildProcessorPlugin(options) {
       }
       this.addWatchFile(pointerPath);
     },
-    buildEnd() {
-      const metrics = getGenerationMetrics(componentHierarchyMap);
-      if (metrics.entryCount <= 0 || metrics.selectorCount <= 0) {
+    async buildEnd(error) {
+      if (error) {
         return;
       }
-      const generationMetricsKey = getGenerationMetricsKey(projectRootRef.current, outDir);
-      const previousMetrics = buildGenerationMetricsByOutputKey.get(generationMetricsKey);
-      if (previousMetrics && isLessRich(metrics, previousMetrics)) {
+      const metrics = summarizeHierarchyMap(componentHierarchyMap);
+      if (metrics.dataTestIdCount <= 0) {
         return;
       }
-      generateFiles(componentHierarchyMap, vueFilesPathMap, normalizedBasePagePath, {
+      if (isLessRich(metrics, lastGeneratedMetrics)) {
+        return;
+      }
+      await generateFiles(componentHierarchyMap, vueFilesPathMap, normalizedBasePagePath, {
         outDir,
         emitLanguages,
         csharp,
@@ -4724,8 +4730,8 @@ function createBuildProcessorPlugin(options) {
         viewsDir,
         scanDirs
       });
-      buildGenerationMetricsByOutputKey.set(generationMetricsKey, metrics);
-      loggerRef.current.info(`generated POMs (${metrics.entryCount} entries, ${metrics.selectorCount} selectors)`);
+      lastGeneratedMetrics = metrics;
+      loggerRef.current.info(`generated POMs (${metrics.entryCount} entries, ${metrics.interactiveComponentCount} interactive components, ${metrics.dataTestIdCount} selectors)`);
     },
     closeBundle() {
       loggerRef.current.info("build complete");
@@ -5814,7 +5820,6 @@ Fix: remove the explicit ${attrLabel}, or change existingIdBehavior to "overwrit
     }
   };
 }
-const devStartupMetricsByOutputKey = /* @__PURE__ */ new Map();
 function createDevProcessorPlugin(options) {
   const {
     nativeWrappers,
@@ -5980,11 +5985,7 @@ function createDevProcessorPlugin(options) {
                 nativeWrappers,
                 excludedComponents,
                 getViewsDirAbs(),
-                {
-                  existingIdBehavior: "preserve",
-                  testIdAttribute,
-                  wrapperSearchRoots: getWrapperSearchRoots()
-                }
+                { existingIdBehavior: "preserve", testIdAttribute, wrapperSearchRoots: getWrapperSearchRoots() }
               )
             ]
           });
@@ -6016,21 +6017,6 @@ function createDevProcessorPlugin(options) {
         logInfo(`initial compile: ${compiledCount}/${totalVueFiles} files in ${formatMs(t1 - t0)} (components=${snapshotHierarchy.size})`);
       };
       const generateAggregatedFromSnapshot = (reason) => {
-        const metrics = getGenerationMetrics(snapshotHierarchy);
-        if (metrics.entryCount <= 0 || metrics.selectorCount <= 0) {
-          logInfo(`generate(${reason}): skipped empty snapshot (components=${metrics.entryCount}, selectors=${metrics.selectorCount})`);
-          return;
-        }
-        const generationMetricsKey = getGenerationMetricsKey(projectRootRef.current, outDir);
-        if (reason === "startup") {
-          const previousMetrics = devStartupMetricsByOutputKey.get(generationMetricsKey);
-          if (previousMetrics && isLessRich(metrics, previousMetrics)) {
-            logInfo(
-              `generate(${reason}): skipped smaller snapshot (components=${metrics.entryCount}, selectors=${metrics.selectorCount})`
-            );
-            return;
-          }
-        }
         const t0 = node_perf_hooks.performance.now();
         generateFiles(snapshotHierarchy, snapshotVuePathMap, normalizedBasePagePath, {
           outDir,
@@ -6045,15 +6031,10 @@ function createDevProcessorPlugin(options) {
           testIdAttribute,
           vueRouterFluentChaining: routerAwarePoms,
           routerEntry: resolvedRouterEntry,
-          routerType,
-          viewsDir,
-          scanDirs
+          routerType
         });
-        if (reason === "startup") {
-          devStartupMetricsByOutputKey.set(generationMetricsKey, metrics);
-        }
         const t1 = node_perf_hooks.performance.now();
-        logInfo(`generate(${reason}): components=${metrics.entryCount} selectors=${metrics.selectorCount} in ${formatMs(t1 - t0)}`);
+        logInfo(`generate(${reason}): components=${snapshotHierarchy.size} in ${formatMs(t1 - t0)}`);
       };
       const initialBuildPromise = (async () => {
         const t0 = node_perf_hooks.performance.now();
@@ -6300,6 +6281,7 @@ function createSupportPlugins(options) {
     basePageClassPath,
     outDir,
     emitLanguages,
+    csharp,
     generateFixtures,
     customPomAttachments,
     customPomDir,
@@ -6664,7 +6646,7 @@ function createVuePluginWithTestIds(options) {
       };
     }
   };
-  return { metadataCollectorPlugin, internalVuePlugin, nuxtVueBridgePlugin };
+  return { metadataCollectorPlugin, internalVuePlugin, nuxtVueBridgePlugin, templateCompilerOptions };
 }
 function assertNonEmptyString(value, name) {
   if (!value || !value.trim()) {
@@ -6709,6 +6691,58 @@ function assertRouterModuleShims(value, name) {
 function resolveFromProjectRoot(projectRoot, maybePath) {
   return path.isAbsolute(maybePath) ? maybePath : path.resolve(projectRoot, maybePath);
 }
+const sharedGeneratorStateRegistry = /* @__PURE__ */ new Map();
+function toArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function getSharedGeneratorState(key) {
+  let state = sharedGeneratorStateRegistry.get(key);
+  if (!state) {
+    state = {
+      componentTestIds: /* @__PURE__ */ new Map(),
+      elementMetadata: /* @__PURE__ */ new Map(),
+      semanticNameMap: /* @__PURE__ */ new Map(),
+      componentHierarchyMap: /* @__PURE__ */ new Map(),
+      vueFilesPathMap: /* @__PURE__ */ new Map()
+    };
+    sharedGeneratorStateRegistry.set(key, state);
+  }
+  return state;
+}
+function applyTemplateCompilerOptionsToResolvedVuePlugin(config, templateCompilerOptions, mode) {
+  const viteVuePlugin = (config.plugins ?? []).find((plugin) => plugin.name === "vite:vue");
+  if (!viteVuePlugin?.api) {
+    if (mode === "external") {
+      throw new Error(
+        '[vue-pom-generator] vuePluginOwnership="external" requires the resolved Vite Vue plugin, but none was found. Add vue() to your Vite plugins before spreading createVuePomGeneratorPlugins(...).'
+      );
+    }
+    throw new Error("[vue-pom-generator] Nuxt mode requires the resolved Vite Vue plugin, but none was found.");
+  }
+  const currentOptions = viteVuePlugin.api.options ?? {};
+  const currentTemplate = currentOptions.template ?? {};
+  const currentCompilerOptions = currentTemplate.compilerOptions ?? {};
+  const mergedNodeTransforms = [
+    ...toArray(currentCompilerOptions.nodeTransforms),
+    ...toArray(templateCompilerOptions.nodeTransforms)
+  ];
+  const mergedExpressionPlugins = Array.from(/* @__PURE__ */ new Set([
+    ...toArray(currentCompilerOptions.expressionPlugins),
+    ...toArray(templateCompilerOptions.expressionPlugins)
+  ]));
+  viteVuePlugin.api.options = {
+    ...currentOptions,
+    template: {
+      ...currentTemplate,
+      compilerOptions: {
+        ...currentCompilerOptions,
+        ...templateCompilerOptions,
+        ...mergedExpressionPlugins.length > 0 ? { expressionPlugins: mergedExpressionPlugins } : {},
+        nodeTransforms: mergedNodeTransforms
+      }
+    }
+  };
+}
 function assertNotVitePluginInstance(options) {
   const candidate = options;
   const pluginLikeKeys = [
@@ -6727,7 +6761,7 @@ function assertNotVitePluginInstance(options) {
     return;
   }
   throw new TypeError(
-    `[vue-pom-generator] Invalid options: received an object that looks like a Vite plugin (found key: "${pluginLikeKey}"). Do not pass vue() into createVuePomGeneratorPlugins(...). Pass Vue plugin options via { vueOptions: { ... } } instead.`
+    `[vue-pom-generator] Invalid options: received an object that looks like a Vite plugin (found key: "${pluginLikeKey}"). Do not pass vue() into createVuePomGeneratorPlugins(...). Pass Vue plugin options via { vueOptions: { ... } } instead, or add vue() separately in Vite and use { vuePluginOwnership: "external" }.`
   );
 }
 function createVuePomGeneratorPlugins(options = {}) {
@@ -6751,6 +6785,12 @@ function createVuePomGeneratorPlugins(options = {}) {
   const routerEntry = generationOptions?.router?.entry;
   const routerType = generationOptions?.router?.type ?? "vue-router";
   const routerModuleShims = generationOptions?.router?.moduleShims;
+  const isNuxt = routerType === "nuxt";
+  if (isNuxt && options.vuePluginOwnership === "internal") {
+    throw new Error('[vue-pom-generator] Nuxt projects must use the resolved app-owned vite:vue plugin. Omit vuePluginOwnership or set it to "external".');
+  }
+  const vuePluginOwnership = isNuxt ? "external" : options.vuePluginOwnership ?? "internal";
+  const usesExternalVuePlugin = vuePluginOwnership === "external";
   const csharp = generationOptions?.csharp;
   const generateFixtures = generationOptions?.playwright?.fixtures;
   const customPoms = generationOptions?.playwright?.customPoms;
@@ -6759,6 +6799,17 @@ function createVuePomGeneratorPlugins(options = {}) {
   const resolvedCustomPomImportAliases = customPoms?.importAliases;
   const resolvedCustomPomImportCollisionBehavior = customPoms?.importNameCollisionBehavior ?? "error";
   const basePageClassPathOverride = generationOptions?.basePageClassPath;
+  const sharedStateKey = JSON.stringify({
+    cwd: process.cwd(),
+    viewsDir,
+    scanDirs,
+    wrapperSearchRoots,
+    outDir,
+    testIdAttribute,
+    routerType,
+    vuePluginOwnership
+  });
+  const sharedState = getSharedGeneratorState(sharedStateKey);
   const projectRootRef = { current: process.cwd() };
   const loggerRef = {
     current: createLogger({ verbosity })
@@ -6779,18 +6830,17 @@ function createVuePomGeneratorPlugins(options = {}) {
           assertNonEmptyString(routerEntry, "[vue-pom-generator] generation.router.entry");
         }
       }
+      if (usesExternalVuePlugin) {
+        applyTemplateCompilerOptionsToResolvedVuePlugin(config, templateCompilerOptions, isNuxt ? "nuxt" : vuePluginOwnership);
+      }
       loggerRef.current.info(`projectRoot=${projectRootRef.current}`);
       loggerRef.current.info(`Active plugins: ${config.plugins.map((p) => p.name).filter((n) => n.includes("vue-pom")).join(", ")}`);
     }
   };
   const getViewsDirAbs = () => resolveFromProjectRoot(projectRootRef.current, viewsDir);
   const getWrapperSearchRootsAbs = () => wrapperSearchRoots.map((root) => resolveFromProjectRoot(projectRootRef.current, root));
-  const componentTestIds = /* @__PURE__ */ new Map();
-  const elementMetadata = /* @__PURE__ */ new Map();
-  const semanticNameMap = /* @__PURE__ */ new Map();
-  const componentHierarchyMap = /* @__PURE__ */ new Map();
-  const vueFilesPathMap = /* @__PURE__ */ new Map();
-  const { metadataCollectorPlugin, internalVuePlugin, nuxtVueBridgePlugin } = createVuePluginWithTestIds({
+  const { componentTestIds, elementMetadata, semanticNameMap, componentHierarchyMap, vueFilesPathMap } = sharedState;
+  const { metadataCollectorPlugin, internalVuePlugin, templateCompilerOptions } = createVuePluginWithTestIds({
     vueOptions,
     existingIdBehavior,
     nameCollisionBehavior,
@@ -6834,14 +6884,15 @@ function createVuePomGeneratorPlugins(options = {}) {
     routerType,
     routerModuleShims
   });
-  const isNuxt = routerType === "nuxt";
   if (isNuxt) {
     loggerRef.current.info("Nuxt environment detected. Skipping internal @vitejs/plugin-vue to avoid conflicts.");
+  } else if (usesExternalVuePlugin) {
+    loggerRef.current.info('vuePluginOwnership="external" enabled. Patching the resolved vite:vue plugin instead of creating an internal one.');
   }
   const resultPlugins = [
     configPlugin,
     metadataCollectorPlugin,
-    ...isNuxt ? [nuxtVueBridgePlugin] : [internalVuePlugin],
+    ...usesExternalVuePlugin ? [] : [internalVuePlugin],
     ...supportPlugins
   ];
   if (!generationEnabled) {
@@ -6849,7 +6900,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     return [
       configPlugin,
       metadataCollectorPlugin,
-      ...isNuxt ? [nuxtVueBridgePlugin] : [internalVuePlugin],
+      ...usesExternalVuePlugin ? [] : [internalVuePlugin],
       virtualModules
     ];
   }