@immense/vue-pom-generator 1.0.59 → 1.0.61

package/dist/index.cjs

@@ -260,6 +260,7 @@ function resolveGenerationSupportOptions(options) {
     nameCollisionBehavior: options.nameCollisionBehavior ?? "error",
     existingIdBehavior: options.existingIdBehavior ?? "error",
     testIdAttribute: (options.testIdAttribute ?? "data-testid").trim() || "data-testid",
+    accessibilityAudit: options.accessibilityAudit ?? false,
     routerAwarePoms: options.routerAwarePoms ?? false,
     routerEntry: options.routerEntry,
     routerType: options.routerType ?? "vue-router",
@@ -599,6 +600,75 @@ function uniquePomStringPatterns(primary, alternates) {
   }
   return out;
 }
+function splitDiscoverabilityWords(value) {
+  const normalized = value.replace(/ByKey/g, "").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[._-]+/g, " ").trim();
+  if (!normalized) {
+    return [];
+  }
+  return normalized.split(/\s+/).map((word) => word.toLowerCase()).filter(Boolean);
+}
+function joinDiscoverabilityWords(words) {
+  return words.join(" ").replace(/\s+/g, " ").trim();
+}
+function toSentenceCase(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function stripComponentKindSuffix(componentName) {
+  for (const suffix of ["Page", "Component", "Layout"]) {
+    if (componentName.endsWith(suffix) && componentName.length > suffix.length) {
+      return componentName.slice(0, -suffix.length);
+    }
+  }
+  return componentName;
+}
+function removeLeadingWords(words, prefixWords) {
+  if (!prefixWords.length || words.length < prefixWords.length) {
+    return [...words];
+  }
+  for (let i = 0; i < prefixWords.length; i++) {
+    if (words[i] !== prefixWords[i]) {
+      return [...words];
+    }
+  }
+  return words.slice(prefixWords.length);
+}
+function removeTrailingRoleWord(words, roleWord) {
+  if (!words.length || words[words.length - 1] !== roleWord) {
+    return [...words];
+  }
+  return words.slice(0, -1);
+}
+function humanizePomMethodName(methodName) {
+  return joinDiscoverabilityWords(splitDiscoverabilityWords(methodName));
+}
+function stripPomActionPrefix(actionName) {
+  for (const prefix of ["click", "select", "type", "goTo"]) {
+    if (actionName.startsWith(prefix) && actionName.length > prefix.length) {
+      return actionName.slice(prefix.length);
+    }
+  }
+  return actionName;
+}
+function normalizePomRoleLabel(nativeRole) {
+  if (nativeRole === "vselect") {
+    return "select";
+  }
+  return nativeRole || "element";
+}
+function buildPomLocatorDescription(args) {
+  const componentWords = splitDiscoverabilityWords(args.componentName ? stripComponentKindSuffix(args.componentName) : "");
+  const roleWord = normalizePomRoleLabel(args.nativeRole).toLowerCase();
+  const semanticWords = removeLeadingWords(
+    removeTrailingRoleWord(splitDiscoverabilityWords(args.methodName), roleWord),
+    componentWords
+  );
+  const phrase = joinDiscoverabilityWords([
+    ...componentWords,
+    ...semanticWords,
+    roleWord
+  ]);
+  return toSentenceCase(phrase || "Generated element");
+}
 function upperFirst$1(value) {
   if (!value) {
     return value;
@@ -615,7 +685,7 @@ function createInlineParameter(name, options = {}) {
     initializer: options.initializer
   };
 }
-function removeByKeySegment(value) {
+function removeByKeySegment$1(value) {
   const idx = value.lastIndexOf("ByKey");
   if (idx < 0) {
     return value;
@@ -630,9 +700,14 @@ function createAsyncMethod(name, parameters, statements) {
     statements
   });
 }
-function generateClickMethod(methodName, selector, alternateSelectors, parameters) {
+function generateClickMethod(componentName, methodName, selector, alternateSelectors, parameters) {
   const name = `click${methodName}`;
   const noWaitName = `${name}NoWait`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole: "button"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   const hasSelectorVariables = hasPomPatternVariables(selector);
   const baseParameters = createParameters(selectorParams);
@@ -655,7 +730,7 @@ function generateClickMethod(methodName, selector, alternateSelectors, parameter
         writer.writeLine(`const candidates = [${candidatesExpr}] as const;`);
         writer.writeLine("let lastError: unknown;");
         writer.write("for (const testId of candidates) ").block(() => {
-          writer.writeLine("const locator = this.locatorByTestId(testId);");
+          writer.writeLine(`const locator = this.locatorByTestId(testId, ${locatorDescription});`);
           writer.write("try ").block(() => {
             writer.write("if (await locator.count()) ").block(() => {
               writer.writeLine("await this.clickLocator(locator, annotationText, wait);");
@@ -689,7 +764,7 @@ function generateClickMethod(methodName, selector, alternateSelectors, parameter
           createInlineParameter("annotationText", { type: "string", initializer: '""' })
         ],
         (writer) => {
-          writer.writeLine(`await this.clickByTestId(${primaryTestIdExpr}, annotationText, wait);`);
+          writer.writeLine(`await this.clickByTestId(${primaryTestIdExpr}, annotationText, wait, ${locatorDescription});`);
         }
       ),
       createAsyncMethod(
@@ -709,7 +784,7 @@ function generateClickMethod(methodName, selector, alternateSelectors, parameter
         createInlineParameter("annotationText", { type: "string", initializer: '""' })
       ],
       (writer) => {
-        writer.writeLine(`await this.clickByTestId(${primaryTestIdExpr}, annotationText, wait);`);
+        writer.writeLine(`await this.clickByTestId(${primaryTestIdExpr}, annotationText, wait, ${locatorDescription});`);
       }
     ),
     createAsyncMethod(
@@ -721,55 +796,76 @@ function generateClickMethod(methodName, selector, alternateSelectors, parameter
     )
   ];
 }
-function generateRadioMethod(methodName, selector, parameters) {
+function generateRadioMethod(componentName, methodName, selector, parameters) {
   const name = `select${methodName}`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole: "radio"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   const methodParameters = createParameters(selectorParams);
   const testIdExpr = toTypeScriptPomPatternExpression(selector);
   return [
     createAsyncMethod(name, methodParameters, (writer) => {
-      writer.writeLine(`await this.clickByTestId(${testIdExpr}, annotationText);`);
+      writer.writeLine(`await this.clickByTestId(${testIdExpr}, annotationText, true, ${locatorDescription});`);
     })
   ];
 }
-function generateSelectMethod(methodName, selector, parameters) {
+function generateSelectMethod(componentName, methodName, selector, parameters) {
   const name = `select${methodName}`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole: "select"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
-  const selectorExpr = `this.selectorForTestId(${toTypeScriptPomPatternExpression(selector)})`;
+  const testIdExpr = toTypeScriptPomPatternExpression(selector);
   return [
     createAsyncMethod(
       name,
       createParameters(selectorParams),
       (writer) => {
-        writer.writeLine(`const selector = ${selectorExpr};`);
-        writer.writeLine("await this.animateCursorToElement(selector, false, 500, annotationText);");
-        writer.writeLine("await this.page.selectOption(selector, value);");
+        writer.writeLine(`const testId = ${testIdExpr};`);
+        writer.writeLine(`const locator = this.locatorByTestId(testId, ${locatorDescription});`);
+        writer.writeLine("await this.animateCursorToElement(locator, false, 500, annotationText);");
+        writer.writeLine("await locator.selectOption(value);");
       }
     )
   ];
 }
-function generateVSelectMethod(methodName, selector, parameters) {
+function generateVSelectMethod(componentName, methodName, selector, parameters) {
   const name = `select${methodName}`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole: "vselect"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   return [
     createAsyncMethod(
       name,
       createParameters(selectorParams),
       (writer) => {
-        writer.writeLine(`await this.selectVSelectByTestId(${toTypeScriptPomPatternExpression(selector)}, value, timeOut, annotationText);`);
+        writer.writeLine(`await this.selectVSelectByTestId(${toTypeScriptPomPatternExpression(selector)}, value, timeOut, annotationText, ${locatorDescription});`);
       }
     )
   ];
 }
-function generateTypeMethod(methodName, selector, parameters) {
+function generateTypeMethod(componentName, methodName, selector, parameters) {
   const name = `type${methodName}`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole: "input"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   return [
     createAsyncMethod(
       name,
       createParameters(selectorParams),
       (writer) => {
-        writer.writeLine(`await this.fillInputByTestId(${toTypeScriptPomPatternExpression(selector)}, text, annotationText);`);
+        writer.writeLine(`await this.fillInputByTestId(${toTypeScriptPomPatternExpression(selector)}, text, annotationText, ${locatorDescription});`);
       }
     )
   ];
@@ -784,22 +880,27 @@ function isAllDigits(value) {
   }
   return true;
 }
-function generateGetElementByDataTestId(methodName, nativeRole, selector, alternateSelectors, getterNameOverride, parameters) {
+function generateGetElementByDataTestId(componentName, methodName, nativeRole, selector, alternateSelectors, getterNameOverride, parameters) {
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName,
+    nativeRole
+  }));
   const roleSuffix = upperFirst$1(nativeRole || "Element");
   const baseName = upperFirst$1(methodName);
   const numericSuffix = baseName.startsWith(roleSuffix) ? baseName.slice(roleSuffix.length) : "";
-  const hasRoleSuffix = baseName.endsWith(roleSuffix) || baseName.startsWith(roleSuffix) && isAllDigits(numericSuffix);
-  const propertyName = hasRoleSuffix ? `${baseName}` : `${baseName}${roleSuffix}`;
+  const hasRoleSuffix2 = baseName.endsWith(roleSuffix) || baseName.startsWith(roleSuffix) && isAllDigits(numericSuffix);
+  const propertyName = hasRoleSuffix2 ? `${baseName}` : `${baseName}${roleSuffix}`;
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   const indexedVariable = getIndexedPomPatternVariable(selector);
   if (indexedVariable) {
     const keyType = getPomParameter(selectorParams, indexedVariable)?.typeExpression || "string";
-    const keyedPropertyName = getterNameOverride ?? removeByKeySegment(propertyName);
+    const keyedPropertyName = getterNameOverride ?? removeByKeySegment$1(propertyName);
     return [
       createClassGetter({
         name: keyedPropertyName,
         statements: [
-          `return this.keyedLocators((${indexedVariable}: ${keyType}) => this.locatorByTestId(${toTypeScriptPomPatternExpression(selector)}));`
+          `return this.keyedLocators((${indexedVariable}: ${keyType}) => this.locatorByTestId(${toTypeScriptPomPatternExpression(selector)}, ${locatorDescription}));`
         ]
       })
     ];
@@ -812,20 +913,25 @@ function generateGetElementByDataTestId(methodName, nativeRole, selector, altern
     return [
       createClassGetter({
         name: finalPropertyName,
-        statements: [`return ${locatorExpr};`]
+        statements: [`return this.describeLocator(${locatorExpr}, ${locatorDescription});`]
       })
     ];
   }
   return [
     createClassGetter({
       name: finalPropertyName,
-      statements: [`return this.locatorByTestId(${toTypeScriptPomPatternExpression(selector)});`]
+      statements: [`return this.locatorByTestId(${toTypeScriptPomPatternExpression(selector)}, ${locatorDescription});`]
     })
   ];
 }
 function generateNavigationMethod(args) {
-  const { targetPageObjectModelClass: target, baseMethodName, selector, alternateSelectors, parameters } = args;
+  const { componentName, targetPageObjectModelClass: target, baseMethodName, selector, alternateSelectors, parameters } = args;
   const methodName = baseMethodName ? `goTo${upperFirst$1(baseMethodName)}` : `goTo${target.endsWith("Page") ? target.slice(0, -"Page".length) : target}`;
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName: baseMethodName,
+    nativeRole: "button"
+  }));
   const selectorParams = orderPomPatternParameters(parameters, [selector]);
   const methodParameters = createParameters(selectorParams);
   const alternates = uniquePomStringPatterns(selector, alternateSelectors).slice(1);
@@ -841,7 +947,7 @@ function generateNavigationMethod(args) {
             writer.writeLine(`const candidates = [${candidatesExpr}] as const;`);
             writer.writeLine("let lastError: unknown;");
             writer.write("for (const testId of candidates) ").block(() => {
-              writer.writeLine("const locator = this.locatorByTestId(testId);");
+              writer.writeLine(`const locator = this.locatorByTestId(testId, ${locatorDescription});`);
               writer.write("try ").block(() => {
                 writer.write("if (await locator.count()) ").block(() => {
                   writer.writeLine("await this.clickLocator(locator);");
@@ -866,7 +972,8 @@ function generateNavigationMethod(args) {
       returnType: `Fluent<${target}>`,
       statements: (writer) => {
         writer.write("return this.fluent(async () => ").block(() => {
-          writer.writeLine(`await this.clickByTestId(${toTypeScriptPomPatternExpression(selector)});`);
+          writer.writeLine(`const locator = this.locatorByTestId(${toTypeScriptPomPatternExpression(selector)}, ${locatorDescription});`);
+          writer.writeLine("await this.clickLocator(locator);");
           writer.writeLine(`return new ${target}(this.page);`);
         });
         writer.writeLine(");");
@@ -874,9 +981,10 @@ function generateNavigationMethod(args) {
     })
   ];
 }
-function generateViewObjectModelMembers(targetPageObjectModelClass, methodName, nativeRole, selector, alternateSelectors, getterNameOverride, parameters) {
+function generateViewObjectModelMembers(componentName, targetPageObjectModelClass, methodName, nativeRole, selector, alternateSelectors, getterNameOverride, parameters) {
   const baseMethodName = nativeRole === "radio" ? methodName || "Radio" : methodName;
   const members = generateGetElementByDataTestId(
+    componentName,
     baseMethodName,
     nativeRole,
     selector,
@@ -888,6 +996,7 @@ function generateViewObjectModelMembers(targetPageObjectModelClass, methodName,
     return [
       ...members,
       ...generateNavigationMethod({
+        componentName,
         targetPageObjectModelClass,
         baseMethodName,
         selector,
@@ -897,18 +1006,18 @@ function generateViewObjectModelMembers(targetPageObjectModelClass, methodName,
     ];
   }
   if (nativeRole === "select") {
-    return [...members, ...generateSelectMethod(baseMethodName, selector, parameters)];
+    return [...members, ...generateSelectMethod(componentName, baseMethodName, selector, parameters)];
   }
   if (nativeRole === "vselect") {
-    return [...members, ...generateVSelectMethod(baseMethodName, selector, parameters)];
+    return [...members, ...generateVSelectMethod(componentName, baseMethodName, selector, parameters)];
   }
   if (nativeRole === "input") {
-    return [...members, ...generateTypeMethod(baseMethodName, selector, parameters)];
+    return [...members, ...generateTypeMethod(componentName, baseMethodName, selector, parameters)];
   }
   if (nativeRole === "radio") {
-    return [...members, ...generateRadioMethod(baseMethodName || "Radio", selector, parameters)];
+    return [...members, ...generateRadioMethod(componentName, baseMethodName || "Radio", selector, parameters)];
   }
-  return [...members, ...generateClickMethod(baseMethodName, selector, alternateSelectors, parameters)];
+  return [...members, ...generateClickMethod(componentName, baseMethodName, selector, alternateSelectors, parameters)];
 }
 function isSimpleExpressionNode(value) {
   return value !== null && "type" in value && value.type === compilerCore.NodeTypes.SIMPLE_EXPRESSION;
@@ -2788,7 +2897,7 @@ Fix: either (1) include ${bestKeyPreservePlaceholder} in your :${attrLabel} temp
     }
     return value.slice(0, idx) + value.slice(idx + "ByKey".length);
   };
-  const hasRoleSuffix = (baseName, roleSuffix) => {
+  const hasRoleSuffix2 = (baseName, roleSuffix) => {
     if (baseName.endsWith(roleSuffix)) {
       return true;
     }
@@ -2798,13 +2907,13 @@ Fix: either (1) include ${bestKeyPreservePlaceholder} in your :${attrLabel} temp
   const getPrimaryGetterName = (primaryMethodName) => {
     const roleSuffix = upperFirst(normalizedRole || "Element");
     const baseName = upperFirst(primaryMethodName);
-    const propertyName = hasRoleSuffix(baseName, roleSuffix) ? baseName : `${baseName}${roleSuffix}`;
+    const propertyName = hasRoleSuffix2(baseName, roleSuffix) ? baseName : `${baseName}${roleSuffix}`;
     return selectorIsParameterized ? removeByKeySegment2(propertyName) : propertyName;
   };
   const getPrimaryGetterNameCandidates = (primaryMethodName) => {
     const roleSuffix = upperFirst(normalizedRole || "Element");
     const baseName = upperFirst(primaryMethodName);
-    const propertyName = hasRoleSuffix(baseName, roleSuffix) ? baseName : `${baseName}${roleSuffix}`;
+    const propertyName = hasRoleSuffix2(baseName, roleSuffix) ? baseName : `${baseName}${roleSuffix}`;
     if (!selectorIsParameterized) {
       return { primary: propertyName };
     }
@@ -2931,7 +3040,7 @@ Fix: either (1) include ${bestKeyPreservePlaceholder} in your :${attrLabel} temp
       if (conflicts && nameCollisionBehavior === "error") {
         const roleSuffix = upperFirst(normalizedRole || "Element");
         const baseNameUpper = upperFirst(baseWithSuffix);
-        if (!hasRoleSuffix(baseNameUpper, roleSuffix)) {
+        if (!hasRoleSuffix2(baseNameUpper, roleSuffix)) {
           const baseWithRoleSuffix = `${baseWithSuffix}${roleSuffix}`;
           const candidateWithRoleSuffix = selectorIsParameterized ? `${baseWithRoleSuffix}ByKey` : baseWithRoleSuffix;
           const actionNameWithRoleSuffix = getPrimaryActionMethodName(candidateWithRoleSuffix);
@@ -4483,7 +4592,7 @@ function generateGoToSelfMethod(componentName) {
 function getSelectorPatterns(selector) {
   return selector.kind === "testId" ? [selector.testId] : [selector.rootTestId, selector.label];
 }
-function generateExtraClickMethodMembers(spec) {
+function generateExtraClickMethodMembers(spec, componentName) {
   if (spec.kind !== "click") {
     return [];
   }
@@ -4498,16 +4607,13 @@ function generateExtraClickMethodMembers(spec) {
   const hasWait = signatureSpecs.some((param) => param.name === "wait");
   const annotationArg = hasAnnotationText ? "annotationText" : '""';
   const waitArg = hasWait ? "wait" : "true";
+  const locatorDescription = JSON.stringify(buildPomLocatorDescription({
+    componentName,
+    methodName: stripPomActionPrefix(spec.name),
+    nativeRole: "button"
+  }));
   if (spec.selector.kind === "testId") {
     const testIdBinding = bindTypeScriptPomPattern(spec.selector.testId, "testId");
-    const clickArgs = [];
-    clickArgs.push(testIdBinding.expression);
-    if (hasAnnotationText || hasWait) {
-      clickArgs.push(annotationArg);
-    }
-    if (hasWait) {
-      clickArgs.push(waitArg);
-    }
     return [
       createClassMethod({
         name: spec.name,
@@ -4520,7 +4626,7 @@ function generateExtraClickMethodMembers(spec) {
           for (const statement of testIdBinding.setupStatements) {
             writer.writeLine(statement);
           }
-          writer.writeLine(`await this.clickByTestId(${clickArgs.join(", ")});`);
+          writer.writeLine(`await this.clickByTestId(${testIdBinding.expression}, ${annotationArg}, ${waitArg}, ${locatorDescription});`);
         }
       })
     ];
@@ -4542,16 +4648,17 @@ function generateExtraClickMethodMembers(spec) {
         for (const statement of labelBinding.setupStatements) {
           writer.writeLine(statement);
         }
-        writer.writeLine(`await this.clickWithinTestIdByLabel(${rootBinding.expression}, ${labelBinding.expression}, ${annotationArg}, ${waitArg});`);
+        writer.writeLine(`await this.clickWithinTestIdByLabel(${rootBinding.expression}, ${labelBinding.expression}, ${annotationArg}, ${waitArg}, { description: ${locatorDescription} });`);
       }
     })
   ];
 }
-function generateMethodMembersFromPom(primary, targetPageObjectModelClass) {
+function generateMethodMembersFromPom(componentName, primary, targetPageObjectModelClass) {
   if (primary.emitPrimary === false) {
     return [];
   }
   return generateViewObjectModelMembers(
+    componentName,
     targetPageObjectModelClass,
     primary.methodName,
     primary.nativeRole,
@@ -4561,7 +4668,7 @@ function generateMethodMembersFromPom(primary, targetPageObjectModelClass) {
     primary.parameters
   );
 }
-function generateMethodsContentForDependencies(dependencies) {
+function generateMethodsContentForDependencies(componentName, dependencies) {
   const entries = Array.from(dependencies.dataTestIdSet ?? []);
   const primarySpecsAll = entries.map((e) => ({ pom: e.pom, target: e.targetPageObjectModelClass })).filter((x) => !!x.pom).sort((a, b) => a.pom.methodName.localeCompare(b.pom.methodName));
   const seenPrimaryKeys = /* @__PURE__ */ new Set();
@@ -4586,10 +4693,10 @@ function generateMethodsContentForDependencies(dependencies) {
   const extras = (dependencies.pomExtraMethods ?? []).slice().sort((a, b) => a.name.localeCompare(b.name));
   const members = [];
   for (const { pom, target } of primarySpecs) {
-    members.push(...generateMethodMembersFromPom(pom, target));
+    members.push(...generateMethodMembersFromPom(componentName, pom, target));
   }
   for (const extra of extras) {
-    members.push(...generateExtraClickMethodMembers(extra));
+    members.push(...generateExtraClickMethodMembers(extra, componentName));
   }
   return members;
 }
@@ -5443,7 +5550,7 @@ function prepareViewObjectModelClass(componentName, dependencies, componentHiera
     members.push(...generateRouteProperty(routeMeta));
     members.push(...generateGoToSelfMethod(className));
   }
-  members.push(...generateMethodsContentForDependencies(dependencies));
+  members.push(...generateMethodsContentForDependencies(componentName, dependencies));
   return {
     className,
     componentRefsForInstances,
@@ -8108,8 +8215,174 @@ function createDevProcessorPlugin(options) {
     }
   };
 }
-function generateTestIdsModule(componentTestIds) {
-  const manifestEntries = Array.from(componentTestIds.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+function supportsInlineTextAccessibleName(role) {
+  return role === "button" || role === "radio";
+}
+function buildAccessibilityAudit(metadata, inferredRole) {
+  if (!metadata || !inferredRole) {
+    return void 0;
+  }
+  const role = normalizePomRoleLabel(inferredRole).toLowerCase();
+  const dynamicProps = new Set(metadata.dynamicProps ?? []);
+  const hasDynamicAccessibleNameSignal = dynamicProps.has("aria-label") || dynamicProps.has("title") || !!metadata.hasDynamicText;
+  let accessibleNameSource;
+  const reasons = [];
+  if (metadata.staticAriaLabel) {
+    accessibleNameSource = "aria-label";
+  } else if (supportsInlineTextAccessibleName(role) && metadata.staticTextContent) {
+    accessibleNameSource = "text";
+  } else if (metadata.staticTitle) {
+    accessibleNameSource = "title";
+  } else if (hasDynamicAccessibleNameSignal) {
+    accessibleNameSource = "dynamic";
+  } else if (role === "input" || role === "select") {
+    accessibleNameSource = "unknown";
+    reasons.push("No inline accessible-name signal was found; the element may rely on external markup such as a separate <label>.");
+  } else {
+    accessibleNameSource = "missing";
+    reasons.push("No compile-time accessible-name signal was found.");
+  }
+  return {
+    needsReview: accessibleNameSource === "unknown" || accessibleNameSource === "missing",
+    accessibleNameSource,
+    reasons,
+    ...metadata.staticAriaLabel ? { staticAriaLabel: metadata.staticAriaLabel } : {},
+    ...metadata.staticRole ? { staticRole: metadata.staticRole } : {},
+    ...metadata.staticTitle ? { staticTitle: metadata.staticTitle } : {},
+    ...metadata.staticTextContent ? { staticTextContent: metadata.staticTextContent } : {}
+  };
+}
+function collectAccessibilityReviewWarnings(manifest) {
+  const warnings = [];
+  for (const [componentName, component] of Object.entries(manifest)) {
+    for (const entry of component.entries) {
+      if (!entry.accessibility?.needsReview) {
+        continue;
+      }
+      const entryLabel = entry.generatedPropertyName ?? entry.testId;
+      const reasonText = entry.accessibility.reasons.join(" ");
+      warnings.push(
+        `[vue-pom-generator] Accessibility review suggested for ${componentName}.${entryLabel} (role=${entry.inferredRole ?? "unknown"}, testId=${JSON.stringify(entry.testId)}): ${reasonText}`
+      );
+    }
+  }
+  return warnings;
+}
+function removeByKeySegment(value) {
+  const idx = value.indexOf("ByKey");
+  if (idx < 0) {
+    return value;
+  }
+  return value.slice(0, idx) + value.slice(idx + "ByKey".length);
+}
+function hasRoleSuffix(baseName, roleSuffix) {
+  if (baseName.endsWith(roleSuffix)) {
+    return true;
+  }
+  const re = new RegExp(`^${roleSuffix}\\d+$`);
+  return re.test(baseName);
+}
+function getGeneratedPropertyName(pom) {
+  if (pom.getterNameOverride) {
+    return pom.getterNameOverride;
+  }
+  const roleSuffix = upperFirst(pom.nativeRole || "Element");
+  const baseName = upperFirst(pom.methodName);
+  const propertyName = hasRoleSuffix(baseName, roleSuffix) ? baseName : `${baseName}${roleSuffix}`;
+  return pom.selector.patternKind === "parameterized" ? removeByKeySegment(propertyName) : propertyName;
+}
+function getGeneratedActionName(entry, pom) {
+  const methodNameUpper = upperFirst(pom.methodName);
+  const radioMethodNameUpper = upperFirst(pom.methodName || "Radio");
+  const isNavigation = !!entry.targetPageObjectModelClass;
+  if (isNavigation) {
+    return `goTo${methodNameUpper}`;
+  }
+  switch (pom.nativeRole) {
+    case "input":
+      return `type${methodNameUpper}`;
+    case "select":
+    case "vselect":
+      return `select${methodNameUpper}`;
+    case "radio":
+      return `select${radioMethodNameUpper}`;
+    default:
+      return `click${methodNameUpper}`;
+  }
+}
+function matchesPrimarySelector(extraMethod, pom) {
+  if (extraMethod.selector.kind !== "testId") {
+    return false;
+  }
+  return extraMethod.selector.testId.formatted === pom.selector.formatted && extraMethod.selector.testId.patternKind === pom.selector.patternKind;
+}
+function getManifestEntry(componentName, entry, componentMetadata, extraMethods) {
+  const testId = entry.selectorValue.formatted;
+  const metadata = componentMetadata?.get(testId);
+  const pom = entry.pom;
+  const generatedActionName = pom ? getGeneratedActionName(entry, pom) : null;
+  const extraActionNames = pom ? extraMethods.filter((extraMethod) => matchesPrimarySelector(extraMethod, pom)).map((extraMethod) => extraMethod.name).sort((a, b) => a.localeCompare(b)) : [];
+  const generatedActionNames = Array.from(/* @__PURE__ */ new Set([
+    ...generatedActionName ? [generatedActionName] : [],
+    ...extraActionNames.filter((name) => name !== generatedActionName)
+  ]));
+  const accessibility = buildAccessibilityAudit(metadata, pom?.nativeRole ?? null);
+  return {
+    testId,
+    selectorPatternKind: entry.selectorValue.patternKind,
+    semanticName: metadata?.semanticName ?? (pom ? humanizePomMethodName(pom.methodName) : testId),
+    locatorDescription: pom ? buildPomLocatorDescription({
+      componentName,
+      methodName: pom.methodName,
+      nativeRole: pom.nativeRole
+    }) : componentName,
+    inferredRole: pom?.nativeRole ?? null,
+    ...accessibility ? { accessibility } : {},
+    generatedPropertyName: pom ? getGeneratedPropertyName(pom) : null,
+    generatedActionName,
+    generatedActionNames,
+    emitPrimary: pom?.emitPrimary !== false,
+    ...entry.targetPageObjectModelClass ? { targetPageObjectModelClass: entry.targetPageObjectModelClass } : {},
+    ...metadata?.tag ? { sourceTag: metadata.tag } : {},
+    ...metadata ? { sourceTagType: metadata.tagType } : {},
+    ...metadata?.patchFlag !== void 0 ? { patchFlag: metadata.patchFlag } : {},
+    ...metadata?.dynamicProps?.length ? { dynamicProps: metadata.dynamicProps } : {},
+    ...metadata?.hasClickHandler !== void 0 ? { hasClickHandler: metadata.hasClickHandler } : {},
+    ...metadata?.hasDynamicClass !== void 0 ? { hasDynamicClass: metadata.hasDynamicClass } : {},
+    ...metadata?.hasDynamicStyle !== void 0 ? { hasDynamicStyle: metadata.hasDynamicStyle } : {},
+    ...metadata?.hasDynamicText !== void 0 ? { hasDynamicText: metadata.hasDynamicText } : {}
+  };
+}
+function buildPomManifest(componentHierarchyMap, elementMetadata) {
+  const manifestEntries = Array.from(componentHierarchyMap.entries()).sort((a, b) => a[0].localeCompare(b[0])).map(([componentName, dependencies]) => {
+    const entries = Array.from(dependencies.dataTestIdSet).sort((a, b) => a.selectorValue.formatted.localeCompare(b.selectorValue.formatted)).map((entry) => getManifestEntry(componentName, entry, elementMetadata.get(componentName), dependencies.pomExtraMethods ?? []));
+    if (!entries.length) {
+      return null;
+    }
+    return [componentName, {
+      componentName,
+      className: componentName,
+      sourceFile: dependencies.filePath,
+      kind: dependencies.isView ? "view" : "component",
+      testIds: Array.from(new Set(entries.map((entry) => entry.testId))),
+      entries
+    }];
+  }).filter((entry) => entry !== null);
+  return Object.fromEntries(manifestEntries);
+}
+function buildTestIdManifest(pomManifest) {
+  return Object.fromEntries(
+    Object.entries(pomManifest).map(([componentName, component]) => [componentName, Array.from(new Set(component.testIds)).sort((a, b) => a.localeCompare(b))])
+  );
+}
+function writeConstJson(value) {
+  return (writer) => {
+    writer.write(`${JSON.stringify(value, null, 2)} as const`);
+  };
+}
+function generateTestIdsModule(componentHierarchyMap, elementMetadata) {
+  const pomManifest = buildPomManifest(componentHierarchyMap, elementMetadata);
+  const testIdManifest = buildTestIdManifest(pomManifest);
   return renderSourceFile("virtual-testids.ts", (sourceFile) => {
     sourceFile.addStatements("// Virtual module: test id manifest");
     sourceFile.addVariableStatement({
@@ -8117,16 +8390,15 @@ function generateTestIdsModule(componentTestIds) {
       isExported: true,
       declarations: [{
         name: "testIdManifest",
-        initializer: (writer) => {
-          writer.write("{").newLine();
-          writer.indent(() => {
-            manifestEntries.forEach(([componentName, testIds], index) => {
-              const suffix = index === manifestEntries.length - 1 ? "" : ",";
-              writer.writeLine(`${JSON.stringify(componentName)}: ${JSON.stringify(Array.from(testIds).sort())}${suffix}`);
-            });
-          });
-          writer.write("} as const");
-        }
+        initializer: writeConstJson(testIdManifest)
+      }]
+    });
+    sourceFile.addVariableStatement({
+      declarationKind: tsMorph.VariableDeclarationKind.Const,
+      isExported: true,
+      declarations: [{
+        name: "pomManifest",
+        initializer: writeConstJson(pomManifest)
       }]
     });
     sourceFile.addTypeAlias({
@@ -8139,27 +8411,67 @@ function generateTestIdsModule(componentTestIds) {
       name: "ComponentName",
       type: "keyof TestIdManifest"
     });
+    sourceFile.addTypeAlias({
+      isExported: true,
+      name: "PomManifest",
+      type: "typeof pomManifest"
+    });
+    sourceFile.addTypeAlias({
+      isExported: true,
+      name: "PomManifestComponentName",
+      type: "keyof PomManifest"
+    });
   });
 }
-const VIRTUAL_ID = "virtual:testids";
-const RESOLVED_ID = `\0${VIRTUAL_ID}`;
-function createTestIdsVirtualModulesPlugin(componentTestIds) {
+function generatePomManifestModule(componentHierarchyMap, elementMetadata) {
+  const pomManifest = buildPomManifest(componentHierarchyMap, elementMetadata);
+  return renderSourceFile("virtual-pom-manifest.ts", (sourceFile) => {
+    sourceFile.addStatements("// Virtual module: richer POM discoverability manifest");
+    sourceFile.addVariableStatement({
+      declarationKind: tsMorph.VariableDeclarationKind.Const,
+      isExported: true,
+      declarations: [{
+        name: "pomManifest",
+        initializer: writeConstJson(pomManifest)
+      }]
+    });
+    sourceFile.addTypeAlias({
+      isExported: true,
+      name: "PomManifest",
+      type: "typeof pomManifest"
+    });
+    sourceFile.addTypeAlias({
+      isExported: true,
+      name: "PomManifestComponentName",
+      type: "keyof PomManifest"
+    });
+  });
+}
+const TEST_IDS_VIRTUAL_ID = "virtual:testids";
+const TEST_IDS_RESOLVED_ID = `\0${TEST_IDS_VIRTUAL_ID}`;
+const POM_MANIFEST_VIRTUAL_ID = "virtual:pom-manifest";
+const POM_MANIFEST_RESOLVED_ID = `\0${POM_MANIFEST_VIRTUAL_ID}`;
+function createTestIdsVirtualModulesPlugin(componentHierarchyMap, elementMetadata) {
   return {
     name: "vue-pom-generator:virtual-testids",
     resolveId(id) {
-      if (id === VIRTUAL_ID)
-        return RESOLVED_ID;
+      if (id === TEST_IDS_VIRTUAL_ID)
+        return TEST_IDS_RESOLVED_ID;
+      if (id === POM_MANIFEST_VIRTUAL_ID)
+        return POM_MANIFEST_RESOLVED_ID;
     },
     load(id) {
-      if (id === RESOLVED_ID)
-        return generateTestIdsModule(componentTestIds);
+      if (id === TEST_IDS_RESOLVED_ID)
+        return generateTestIdsModule(componentHierarchyMap, elementMetadata);
+      if (id === POM_MANIFEST_RESOLVED_ID)
+        return generatePomManifestModule(componentHierarchyMap, elementMetadata);
     }
   };
 }
 function createSupportPlugins(options) {
   const {
-    componentTestIds,
     componentHierarchyMap,
+    elementMetadata,
     vueFilesPathMap,
     nativeWrappers,
     excludedComponents,
@@ -8245,7 +8557,7 @@ function createSupportPlugins(options) {
     getResolvedRouterEntry: resolveRouterEntry2,
     loggerRef
   });
-  const virtualModules = createTestIdsVirtualModulesPlugin(componentTestIds);
+  const virtualModules = createTestIdsVirtualModulesPlugin(componentHierarchyMap, elementMetadata);
   return [tsProcessor, devProcessor, virtualModules];
 }
 function findDataTestIdProp(element, attributeName = "data-testid") {
@@ -8301,6 +8613,33 @@ function parseDynamicProps(dynamicProps) {
   }
   return void 0;
 }
+function findStaticAttributeValue(element, attributeName) {
+  const attribute = element.props.find(
+    (prop) => prop.type === compilerCore.NodeTypes.ATTRIBUTE && prop.name === attributeName
+  );
+  const value = attribute?.value?.content?.trim();
+  return value ? value : void 0;
+}
+function collectStaticTextContent(children) {
+  const parts = [];
+  const visit = (nodes) => {
+    for (const node of nodes) {
+      if (node.type === compilerCore.NodeTypes.TEXT) {
+        const text2 = node.content.replace(/\s+/g, " ").trim();
+        if (text2) {
+          parts.push(text2);
+        }
+        continue;
+      }
+      if (node.type === compilerCore.NodeTypes.ELEMENT) {
+        visit(node.children);
+      }
+    }
+  };
+  visit(children);
+  const text = parts.join(" ").replace(/\s+/g, " ").trim();
+  return text || void 0;
+}
 function tryCreateElementMetadata(args) {
   const { element, semanticNameMap } = args;
   const testIdAttribute = (args.testIdAttribute ?? "data-testid").trim() || "data-testid";
@@ -8324,13 +8663,9 @@ function tryCreateElementMetadata(args) {
       dynamicPropsList = [content];
     }
   }
-  const semanticName = semanticNameMap.get(testId);
-  if (!semanticName) {
-    return null;
-  }
   const metadata = {
     testId,
-    semanticName,
+    semanticName: semanticNameMap.get(testId),
     tag: element.tag,
     tagType: element.tagType,
     patchFlag,
@@ -8339,7 +8674,11 @@ function tryCreateElementMetadata(args) {
     hasClickHandler: patchFlag ? Boolean(patchFlag & 32) : void 0,
     hasDynamicClass: patchFlag ? Boolean(patchFlag & 2) : void 0,
     hasDynamicStyle: patchFlag ? Boolean(patchFlag & 4) : void 0,
-    hasDynamicText: patchFlag ? Boolean(patchFlag & 1) : void 0
+    hasDynamicText: patchFlag ? Boolean(patchFlag & 1) : void 0,
+    staticAriaLabel: findStaticAttributeValue(element, "aria-label"),
+    staticRole: findStaticAttributeValue(element, "role"),
+    staticTitle: findStaticAttributeValue(element, "title"),
+    staticTextContent: collectStaticTextContent(element.children)
   };
   return metadata;
 }
@@ -8391,6 +8730,7 @@ function extractMetadataAfterTransform(ast, componentName, elementMetadata, sema
   if (componentMetadata.size > 0) {
     elementMetadata.set(componentName, componentMetadata);
   }
+  return componentMetadata;
 }
 function createVuePluginWithTestIds(options) {
   const {
@@ -8405,11 +8745,13 @@ function createVuePluginWithTestIds(options) {
     excludedComponents,
     getViewsDirAbs,
     testIdAttribute,
+    accessibilityAudit,
     loggerRef,
     getSourceDirs,
     getWrapperSearchRoots,
     getProjectRoot
   } = options;
+  const lastAccessibilityWarningSignatureByComponent = /* @__PURE__ */ new Map();
   const getComponentNameFromPath = (filename) => {
     return resolveComponentNameFromPath({
       filename,
@@ -8482,13 +8824,37 @@ function createVuePluginWithTestIds(options) {
             )
           );
           return () => {
-            extractMetadataAfterTransform(
+            const componentMetadata = extractMetadataAfterTransform(
               node,
               componentName,
               elementMetadata,
               semanticNameMap,
               testIdAttribute
             );
+            if (!accessibilityAudit) {
+              return;
+            }
+            const dependencies = componentHierarchyMap.get(componentName);
+            if (!dependencies || componentMetadata.size === 0) {
+              return;
+            }
+            const manifest = buildPomManifest(
+              /* @__PURE__ */ new Map([[componentName, dependencies]]),
+              /* @__PURE__ */ new Map([[componentName, componentMetadata]])
+            );
+            const warnings = collectAccessibilityReviewWarnings(manifest);
+            const signature = warnings.join("\n");
+            if (!signature) {
+              lastAccessibilityWarningSignatureByComponent.delete(componentName);
+              return;
+            }
+            if (lastAccessibilityWarningSignatureByComponent.get(componentName) === signature) {
+              return;
+            }
+            lastAccessibilityWarningSignatureByComponent.set(componentName, signature);
+            for (const warning of warnings) {
+              loggerRef.current.warn(warning);
+            }
           };
         }
         let transform = perFileTransform.get(componentName);
@@ -8735,7 +9101,6 @@ 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(),
@@ -8854,6 +9219,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     nameCollisionBehavior: generationOptions?.nameCollisionBehavior,
     existingIdBehavior: resolvedInjectionOptions.existingIdBehavior,
     testIdAttribute,
+    accessibilityAudit: generationOptions?.accessibilityAudit,
     routerAwarePoms: typeof routerEntry === "string" && routerEntry.trim().length > 0 || routerType === "nuxt",
     routerEntry,
     routerType,
@@ -8934,7 +9300,7 @@ function createVuePomGeneratorPlugins(options = {}) {
   };
   const getViewsDirAbs = () => resolveFromProjectRoot(projectRootRef.current, getViewsDir());
   const getWrapperSearchRootsAbs = () => getWrapperSearchRoots().map((root) => resolveFromProjectRoot(projectRootRef.current, root));
-  const { componentTestIds, elementMetadata, semanticNameMap, componentHierarchyMap, vueFilesPathMap } = sharedState;
+  const { elementMetadata, semanticNameMap, componentHierarchyMap, vueFilesPathMap } = sharedState;
   const { metadataCollectorPlugin, internalVuePlugin, templateCompilerOptions } = createVuePluginWithTestIds({
     vueOptions,
     existingIdBehavior: resolvedGenerationOptions.existingIdBehavior,
@@ -8947,6 +9313,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     excludedComponents,
     getViewsDirAbs,
     testIdAttribute,
+    accessibilityAudit: resolvedGenerationOptions.accessibilityAudit,
     loggerRef,
     getSourceDirs,
     getWrapperSearchRoots: getWrapperSearchRootsAbs,
@@ -8954,8 +9321,8 @@ function createVuePomGeneratorPlugins(options = {}) {
   });
   templateCompilerOptionsForResolvedPlugin = templateCompilerOptions;
   const supportPlugins = createSupportPlugins({
-    componentTestIds,
     componentHierarchyMap,
+    elementMetadata,
     vueFilesPathMap,
     nativeWrappers,
     excludedComponents,
@@ -8982,7 +9349,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     ...supportPlugins
   ];
   if (!generationEnabled) {
-    const virtualModules = createTestIdsVirtualModulesPlugin(componentTestIds);
+    const virtualModules = createTestIdsVirtualModulesPlugin(componentHierarchyMap, elementMetadata);
     return [
       configPlugin,
       metadataCollectorPlugin,