@jay-framework/a11y-validator 0.22.0 → 0.22.2

package/dist/index.js

@@ -208,6 +208,7 @@ const validate = (ctx) => {
       }
     }
   });
+  checkDuplicateAdjacentText(ctx.body, findings);
   if (ctx.head) {
     const viewport = ctx.head.meta.find((m) => m.name?.toLowerCase() === "viewport");
     if (viewport) {
@@ -268,6 +269,35 @@ function collectLabelForIds(el, ids) {
       collectLabelForIds(child, ids);
   }
 }
+function getVisibleText(el) {
+  if (el.getAttribute?.("aria-hidden") === "true")
+    return "";
+  return (el.textContent ?? "").trim().replace(/\s+/g, " ");
+}
+function checkDuplicateAdjacentText(root, findings) {
+  function walk(el) {
+    const children = (el.childNodes ?? []).filter((n) => n.nodeType === 1);
+    for (let i = 0; i < children.length - 1; i++) {
+      const current = children[i];
+      const next = children[i + 1];
+      const currentText = getVisibleText(current);
+      const nextText = getVisibleText(next);
+      if (currentText && nextText && currentText === nextText && current.getAttribute?.("aria-hidden") !== "true" && next.getAttribute?.("aria-hidden") !== "true") {
+        const tag = next.rawTagName?.toLowerCase() || "element";
+        findings.push({
+          severity: "warning",
+          message: `Adjacent <${current.rawTagName?.toLowerCase()}> and <${tag}> have identical text "${currentText.slice(0, 40)}${currentText.length > 40 ? "..." : ""}" — screen readers will announce it twice`,
+          suggestion: 'Add aria-hidden="true" to the decorative duplicate. If both are meaningful, differentiate their text content.',
+          element: `<${tag}>`
+        });
+      }
+    }
+    for (const child of children) {
+      walk(child);
+    }
+  }
+  walk(root);
+}
 export {
   validate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/a11y-validator",
-  "version": "0.22.0",
+  "version": "0.22.2",
   "type": "module",
   "description": "Accessibility validation plugin for Jay Framework — checks jay-html templates for WCAG best practices",
   "license": "Apache-2.0",
@@ -24,11 +24,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@jay-framework/compiler-shared": "^0.22.0"
+    "@jay-framework/compiler-shared": "^0.22.2"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.22.0",
-    "@jay-framework/jay-stack-cli": "^0.22.0",
+    "@jay-framework/dev-environment": "^0.22.2",
+    "@jay-framework/jay-stack-cli": "^0.22.2",
     "@types/node": "^22.15.21",
     "node-html-parser": "^6.1.0",
     "rimraf": "^5.0.5",