@immense/vue-pom-generator 1.0.46 → 1.0.47

package/dist/index.mjs

@@ -5396,6 +5396,7 @@ function createTestIdTransform(componentName, componentHierarchyMap, nativeWrapp
   const existingIdBehavior = options.existingIdBehavior ?? "preserve";
   const testIdAttribute = (options.testIdAttribute || "data-testid").trim() || "data-testid";
   const nameCollisionBehavior = options.nameCollisionBehavior ?? "suffix";
+  const missingSemanticNameBehavior = options.missingSemanticNameBehavior ?? "ignore";
   const warn = options.warn;
   const vueFilesPathMap = options.vueFilesPathMap;
   const wrapperSearchRoots = options.wrapperSearchRoots ?? [];
@@ -5661,6 +5662,22 @@ function createTestIdTransform(componentName, componentHierarchyMap, nativeWrapp
       });
     };
     const { nativeWrappersValue, optionDataTestIdPrefixValue, semanticNameHint } = getNativeWrapperTransformInfo(element, componentName, nativeWrappers);
+    const handlerDirective = element.props.find((p) => {
+      return p.type === NodeTypes.DIRECTIVE && p.name === "bind" && p.arg?.type === NodeTypes.SIMPLE_EXPRESSION && p.arg.content === "handler" && !!p.exp;
+    }) ?? null;
+    const handlerInfo = handlerDirective ? nodeHandlerAttributeInfo(element) : null;
+    if (missingSemanticNameBehavior === "error" && nativeWrappers[element.tag]?.role === "button" && handlerDirective && !handlerInfo) {
+      const loc = element.loc?.start;
+      const locationHint = loc ? `${loc.line}:${loc.column}` : "unknown";
+      const handlerSource = (handlerDirective.exp?.loc?.source ?? "").trim() || "<unknown>";
+      throw new Error(
+        `[vue-pom-generator] Could not derive a semantic POM action name for button-like wrapper in ${componentName} (${context.filename ?? "unknown"}:${locationHint}).
+Element: <${element.tag}>
+Handler: ${handlerSource}
+
+Fix: move complex inline logic into a named function (for example, const onAction = () => ...; then bind :handler="onAction"), or simplify the handler to a direct identifier/call the generator can name. You can also set errorBehavior = "ignore" to keep generic fallback behavior.`
+      );
+    }
     if (nativeWrappersValue) {
       if (optionDataTestIdPrefixValue) {
         const existing = existingIdBehavior === "preserve" ? tryGetExistingElementDataTestId(element, testIdAttribute) : null;
@@ -5770,7 +5787,6 @@ Fix: remove the explicit ${attrLabel}, or change existingIdBehavior to "overwrit
       });
       return;
     }
-    const handlerInfo = nodeHandlerAttributeInfo(element);
     if (handlerInfo) {
       const testId = getHandlerAttributeValueDataTestId(handlerInfo.semanticNameHint);
       applyResolvedDataTestIdForElement({
@@ -5879,6 +5895,7 @@ function createBuildProcessorPlugin(options) {
     customPomImportNameCollisionBehavior,
     testIdAttribute,
     nameCollisionBehavior,
+    missingSemanticNameBehavior,
     existingIdBehavior,
     nativeWrappers,
     excludedComponents,
@@ -5989,6 +6006,7 @@ function createBuildProcessorPlugin(options) {
                   existingIdBehavior: existingIdBehavior ?? "preserve",
                   testIdAttribute,
                   nameCollisionBehavior,
+                  missingSemanticNameBehavior,
                   warn: (message) => loggerRef.current.warn(message),
                   vueFilesPathMap,
                   wrapperSearchRoots: getWrapperSearchRoots()
@@ -6113,6 +6131,7 @@ function createDevProcessorPlugin(options) {
     customPomImportAliases,
     customPomImportNameCollisionBehavior,
     nameCollisionBehavior = "suffix",
+    missingSemanticNameBehavior,
     existingIdBehavior,
     testIdAttribute,
     routerAwarePoms,
@@ -6277,6 +6296,7 @@ function createDevProcessorPlugin(options) {
               {
                 existingIdBehavior: existingIdBehavior ?? "preserve",
                 nameCollisionBehavior,
+                missingSemanticNameBehavior,
                 testIdAttribute,
                 warn: (message) => loggerRef.current.warn(message),
                 vueFilesPathMap: targetVuePathMap,
@@ -6517,6 +6537,7 @@ function createSupportPlugins(options) {
     scanDirs,
     getWrapperSearchRoots,
     nameCollisionBehavior = "suffix",
+    missingSemanticNameBehavior,
     existingIdBehavior,
     outDir,
     emitLanguages,
@@ -6572,6 +6593,7 @@ function createSupportPlugins(options) {
     customPomImportNameCollisionBehavior,
     testIdAttribute,
     nameCollisionBehavior,
+    missingSemanticNameBehavior,
     existingIdBehavior,
     nativeWrappers,
     excludedComponents,
@@ -6600,6 +6622,7 @@ function createSupportPlugins(options) {
     customPomImportAliases,
     customPomImportNameCollisionBehavior,
     nameCollisionBehavior,
+    missingSemanticNameBehavior,
     existingIdBehavior,
     testIdAttribute,
     routerAwarePoms,
@@ -6974,6 +6997,41 @@ function assertNonEmptyStringArray(value, name) {
     assertNonEmptyString(entry, `${name}[${index}]`);
   }
 }
+function assertOneOf(value, allowed, name) {
+  if (!value)
+    return;
+  if (allowed.includes(value)) {
+    return;
+  }
+  throw new TypeError(`${name} must be one of: ${allowed.join(", ")}.`);
+}
+function assertErrorBehavior(value, name) {
+  if (!value) {
+    return;
+  }
+  if (value === "ignore" || value === "error") {
+    return;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError(`${name} must be "ignore", "error", or an object.`);
+  }
+  const supportedKeys = /* @__PURE__ */ new Set(["missingSemanticNameBehavior"]);
+  for (const key of Object.keys(value)) {
+    if (!supportedKeys.has(key)) {
+      throw new TypeError(`${name} contains unsupported key "${key}".`);
+    }
+  }
+  assertOneOf(value.missingSemanticNameBehavior, ["ignore", "error"], `${name}.missingSemanticNameBehavior`);
+}
+function resolveMissingSemanticNameBehavior(value) {
+  if (!value) {
+    return "ignore";
+  }
+  if (value === "ignore" || value === "error") {
+    return value;
+  }
+  return value.missingSemanticNameBehavior ?? "ignore";
+}
 function assertRouterModuleShims(value, name) {
   if (!value)
     return;
@@ -7106,6 +7164,8 @@ function createVuePomGeneratorPlugins(options = {}) {
   const vuePluginOwnership = isNuxt ? "external" : options.vuePluginOwnership ?? "internal";
   const usesExternalVuePlugin = vuePluginOwnership === "external";
   const csharp = generationOptions?.csharp;
+  const errorBehavior = options.errorBehavior;
+  const missingSemanticNameBehavior = resolveMissingSemanticNameBehavior(errorBehavior);
   const generateFixtures = generationOptions?.playwright?.fixtures;
   const customPoms = generationOptions?.playwright?.customPoms;
   const resolvedCustomPomAttachments = customPoms?.attachments ?? [];
@@ -7137,6 +7197,7 @@ function createVuePomGeneratorPlugins(options = {}) {
       assertNonEmptyString(testIdAttribute, "[vue-pom-generator] injection.attribute");
       assertNonEmptyString(viewsDir, "[vue-pom-generator] injection.viewsDir");
       assertNonEmptyStringArray(wrapperSearchRoots, "[vue-pom-generator] injection.wrapperSearchRoots");
+      assertErrorBehavior(errorBehavior, "[vue-pom-generator] errorBehavior");
       if (generationEnabled) {
         assertNonEmptyString(outDir, "[vue-pom-generator] generation.outDir");
         assertRouterModuleShims(routerModuleShims, "[vue-pom-generator] generation.router.moduleShims");
@@ -7148,7 +7209,7 @@ function createVuePomGeneratorPlugins(options = {}) {
         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(", ")}`);
+      loggerRef.current.info(`Active plugins: ${(config.plugins ?? []).map((p) => p.name).filter((n) => n.includes("vue-pom")).join(", ")}`);
     }
   };
   const getViewsDirAbs = () => resolveFromProjectRoot(projectRootRef.current, viewsDir);
@@ -7182,6 +7243,7 @@ function createVuePomGeneratorPlugins(options = {}) {
     scanDirs,
     getWrapperSearchRoots: getWrapperSearchRootsAbs,
     nameCollisionBehavior,
+    missingSemanticNameBehavior,
     existingIdBehavior,
     outDir,
     emitLanguages,