@accesslint/core 0.8.1 → 0.8.3

package/dist/index.js

@@ -1,4 +1,4 @@
-const z = [
+const j = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
@@ -133,22 +133,22 @@ function $e(e) {
       return null;
   }
 }
-function j(e) {
+function W(e) {
   var n;
   const a = K.get(e);
   if (a !== void 0) return a;
   const i = ((n = e.getAttribute("role")) == null ? void 0 : n.trim().toLowerCase()) || null || $e(e);
   return K.set(e, i), i;
 }
-let J = /* @__PURE__ */ new WeakMap();
+let Q = /* @__PURE__ */ new WeakMap();
 function st() {
-  J = /* @__PURE__ */ new WeakMap();
+  Q = /* @__PURE__ */ new WeakMap();
 }
-function x(e) {
-  const a = J.get(e);
+function w(e) {
+  const a = Q.get(e);
   if (a !== void 0) return a;
   const t = lt(e);
-  return J.set(e, t), t;
+  return Q.set(e, t), t;
 }
 function lt(e) {
   var r, o, s, l, d;
@@ -310,25 +310,25 @@ const ut = /* @__PURE__ */ new Set([
   "aria-relevant",
   "aria-roledescription"
 ]);
-function q(e) {
+function E(e) {
   let a = e;
   for (; a; ) {
-    if (De(a)) return !0;
+    if (He(a)) return !0;
     a = a.parentElement;
   }
   return !1;
 }
-let Q = /* @__PURE__ */ new WeakMap();
+let Z = /* @__PURE__ */ new WeakMap();
 function mt() {
-  Q = /* @__PURE__ */ new WeakMap();
+  Z = /* @__PURE__ */ new WeakMap();
 }
 function h(e) {
-  const a = Q.get(e);
+  const a = Z.get(e);
   if (a !== void 0) return a;
   let t;
-  return e.getAttribute("aria-hidden") === "true" || e instanceof HTMLElement && (e.hidden || e.style.display === "none") ? t = !0 : e.parentElement ? t = h(e.parentElement) : t = !1, Q.set(e, t), t;
+  return e.getAttribute("aria-hidden") === "true" || e instanceof HTMLElement && (e.hidden || e.style.display === "none") ? t = !0 : e.parentElement ? t = h(e.parentElement) : t = !1, Z.set(e, t), t;
 }
-function De(e) {
+function He(e) {
   if (e.getAttribute("aria-hidden") === "true" || e instanceof HTMLElement && e.hidden) return !0;
   if (typeof getComputedStyle == "function") {
     const a = getComputedStyle(e);
@@ -345,7 +345,7 @@ function k(e) {
       a += s.textContent ?? "";
     else if (s.nodeType === 1) {
       const l = s;
-      if (!De(l)) {
+      if (!He(l)) {
         const d = (t = l.tagName) == null ? void 0 : t.toLowerCase();
         if (d === "img" || d === "area") {
           const c = l.getAttribute("aria-labelledby");
@@ -373,7 +373,7 @@ function k(e) {
     }
   return a;
 }
-function Z(e) {
+function ee(e) {
   let a = "";
   for (const t of e.childNodes)
     if (t.nodeType === 3)
@@ -383,11 +383,11 @@ function Z(e) {
       if (n === "style" || n === "script" || n === "svg" || i.getAttribute("aria-hidden") === "true" || i instanceof HTMLElement && i.style.display === "none") continue;
       const r = i.getAttribute("role");
       if (r === "img" || r === "presentation" || r === "none") continue;
-      a += Z(i);
+      a += ee(i);
     }
   return a;
 }
-function Pe(e) {
+function De(e) {
   let a = e;
   for (; a; ) {
     if (a instanceof HTMLElement && a.style.visibility === "hidden") return !0;
@@ -395,7 +395,7 @@ function Pe(e) {
   }
   return !1;
 }
-function Fe(e) {
+function Pe(e) {
   var n, r;
   const a = e.getAttribute("aria-labelledby");
   if (a) {
@@ -413,9 +413,9 @@ function Fe(e) {
 function se(e) {
   return e.getRootNode() instanceof ShadowRoot;
 }
-let ee = /* @__PURE__ */ new WeakMap();
+let te = /* @__PURE__ */ new WeakMap();
 function pt() {
-  ee = /* @__PURE__ */ new WeakMap();
+  te = /* @__PURE__ */ new WeakMap();
 }
 function bt(e) {
   return e.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
@@ -447,7 +447,7 @@ function gt(e) {
   }
   return a;
 }
-function G(e) {
+function Y(e) {
   if (e.id) return `#${CSS.escape(e.id)}`;
   const a = e.getRootNode(), t = a instanceof ShadowRoot ? null : a.documentElement;
   if (e === t) return e.tagName.toLowerCase();
@@ -472,28 +472,28 @@ function G(e) {
 }
 function p(e) {
   var r;
-  const a = ee.get(e);
+  const a = te.get(e);
   if (a !== void 0) return a;
   const t = [];
   let i = e;
   for (; i; ) {
     const o = i.getRootNode();
     if (o instanceof ShadowRoot)
-      t.unshift({ selector: G(i), delimiter: " >>> " }), i = o.host;
+      t.unshift({ selector: Y(i), delimiter: " >>> " }), i = o.host;
     else {
       const s = (r = o.defaultView) == null ? void 0 : r.frameElement;
       if (s)
-        t.unshift({ selector: G(i), delimiter: " >>>iframe> " }), i = s;
+        t.unshift({ selector: Y(i), delimiter: " >>>iframe> " }), i = s;
       else {
-        t.unshift({ selector: G(i), delimiter: "" });
+        t.unshift({ selector: Y(i), delimiter: "" });
         break;
       }
     }
   }
   const n = t.map((o, s) => (s === 0 ? "" : o.delimiter) + o.selector).join("");
-  return ee.set(e, n), n;
+  return te.set(e, n), n;
 }
-function Un(e) {
+function Wn(e) {
   const a = [], t = [];
   let i = e;
   for (; i; ) {
@@ -609,7 +609,7 @@ const ft = /* @__PURE__ */ new Set([
   "aria-valuemax",
   "aria-valuemin",
   "aria-valuenow"
-]), Y = {
+]), X = {
   "aria-autocomplete": /* @__PURE__ */ new Set(["inline", "list", "both", "none"]),
   "aria-expanded": /* @__PURE__ */ new Set(["true", "false", "undefined"]),
   "aria-current": /* @__PURE__ */ new Set(["page", "step", "location", "date", "time", "true", "false"]),
@@ -781,10 +781,10 @@ function le(e) {
               fix: { type: "suggest", suggestion: `Set ${c.name} to a valid number value` }
             });
           }
-        } else if (Y[c.name]) {
+        } else if (X[c.name]) {
           const b = u.split(/\s+/);
           for (const g of b)
-            if (!Y[c.name].has(g)) {
+            if (!X[c.name].has(g)) {
               const f = d();
               t.push({
                 ruleId: "aria/aria-valid-attr-value",
@@ -792,7 +792,7 @@ function le(e) {
                 html: f.html,
                 impact: "critical",
                 message: `Invalid value "${u}" for ${c.name}.`,
-                fix: { type: "suggest", suggestion: `Set ${c.name} to one of: ${[...Y[c.name]].join(", ")}` }
+                fix: { type: "suggest", suggestion: `Set ${c.name} to one of: ${[...X[c.name]].join(", ")}` }
               });
               break;
             }
@@ -818,14 +818,14 @@ function le(e) {
         if (fe.has(c)) {
           const g = r.hasAttribute("aria-label"), f = r.hasAttribute("aria-labelledby");
           if (g || f) {
-            const v = d(), w = g ? "aria-label" : "aria-labelledby";
+            const v = d(), y = g ? "aria-label" : "aria-labelledby";
             i.push({
               ruleId: "aria/aria-prohibited-attr",
               selector: v.selector,
               html: v.html,
               impact: "serious",
               message: `aria-label and aria-labelledby are prohibited on role "${c}".`,
-              fix: { type: "remove-attribute", attribute: w }
+              fix: { type: "remove-attribute", attribute: y }
             });
           }
         }
@@ -851,13 +851,13 @@ function le(e) {
   }
   return P = new WeakRef(e), F = { validAttr: a, validAttrValue: t, prohibitedAttr: i }, F;
 }
-let te = /* @__PURE__ */ new WeakMap(), ae = /* @__PURE__ */ new WeakMap(), ie = /* @__PURE__ */ new WeakMap();
+let ae = /* @__PURE__ */ new WeakMap(), ie = /* @__PURE__ */ new WeakMap(), ne = /* @__PURE__ */ new WeakMap();
 function kt() {
-  te = /* @__PURE__ */ new WeakMap(), ae = /* @__PURE__ */ new WeakMap(), ie = /* @__PURE__ */ new WeakMap();
+  ae = /* @__PURE__ */ new WeakMap(), ie = /* @__PURE__ */ new WeakMap(), ne = /* @__PURE__ */ new WeakMap();
 }
-function y(e) {
-  let a = te.get(e);
-  return a || (a = getComputedStyle(e), te.set(e, a), a);
+function x(e) {
+  let a = ae.get(e);
+  return a || (a = getComputedStyle(e), ae.set(e, a), a);
 }
 function I(e, a, t) {
   const [i, n, r] = [e, a, t].map((o) => {
@@ -927,12 +927,12 @@ function R(e, a, t) {
   ];
 }
 function ye(e) {
-  const a = ae.get(e);
+  const a = ie.get(e);
   if (a !== void 0) return a;
   const t = St(e);
-  return ae.set(e, t), t;
+  return ie.set(e, t), t;
 }
-function X(e, a) {
+function J(e, a) {
   let t = a;
   for (let i = e.length - 1; i >= 0; i--)
     t = R(e[i].color, t, e[i].alpha);
@@ -942,13 +942,13 @@ function St(e) {
   const a = [];
   let t = e;
   for (; t; ) {
-    const n = y(t), r = n.backgroundImage;
+    const n = x(t), r = n.backgroundImage;
     if (r && r !== "none" && r !== "initial") {
       const d = n.backgroundColor;
       if (d && d !== "transparent" && d !== "rgba(0, 0, 0, 0)" && d !== "rgba(0 0 0 / 0)") {
         const c = C(d);
         if (c)
-          return a.length > 0 ? X(a, c) : c;
+          return a.length > 0 ? J(a, c) : c;
       }
       return null;
     }
@@ -968,13 +968,13 @@ function St(e) {
       continue;
     }
     if (s >= 1)
-      return a.length > 0 ? X(a, l) : l;
+      return a.length > 0 ? J(a, l) : l;
     a.push({ color: l, alpha: s }), t = t.parentElement;
   }
   const i = [255, 255, 255];
-  return a.length > 0 ? X(a, i) : i;
+  return a.length > 0 ? J(a, i) : i;
 }
-function He(e) {
+function Fe(e) {
   const a = [];
   let t = 0, i = 0;
   for (let n = 0; n < e.length; n++)
@@ -989,7 +989,7 @@ function It(e, a = [255, 255, 255]) {
   let r = 1, o = n + 1;
   for (; o < e.length && r > 0; o++)
     e[o] === "(" ? r++ : e[o] === ")" && r--;
-  const s = e.slice(n + 1, o - 1), l = He(s);
+  const s = e.slice(n + 1, o - 1), l = Fe(s);
   for (const d of l) {
     const c = d.trim();
     if (/^(to\s|[\d.]+deg|[\d.]+turn|[\d.]+rad)/i.test(c)) continue;
@@ -1002,29 +1002,29 @@ function It(e, a = [255, 255, 255]) {
   }
   return t;
 }
-const qt = /* @__PURE__ */ new Set(["IMG", "PICTURE", "VIDEO", "SVG"]);
-function Lt(e) {
-  const a = ie.get(e);
+const Et = /* @__PURE__ */ new Set(["IMG", "PICTURE", "VIDEO", "SVG"]);
+function qt(e) {
+  const a = ne.get(e);
   if (a !== void 0) return a;
   const t = Rt(e);
-  return ie.set(e, t), t;
+  return ne.set(e, t), t;
 }
-function Et(e) {
-  return qt.has(e.tagName) ? !0 : !!e.querySelector("img, picture, video, svg");
+function Lt(e) {
+  return Et.has(e.tagName) ? !0 : !!e.querySelector("img, picture, video, svg");
 }
 function Rt(e) {
   let a = e, t = !1;
   for (; a; ) {
-    const i = y(a).position;
+    const i = x(a).position;
     if ((i === "absolute" || i === "fixed") && (t = !0), a !== e && i !== "static") {
       for (const n of a.children) {
         if (n === e || n.contains(e)) continue;
-        if (Et(n)) {
+        if (Lt(n)) {
           if (t) return !0;
-          const o = y(n).position;
+          const o = x(n).position;
           if (o === "absolute" || o === "fixed") return !0;
         }
-        const r = y(n);
+        const r = x(n);
         if (r.position === "absolute" || r.position === "fixed") {
           const o = r.backgroundImage;
           if (o && o !== "none" && o !== "initial") return !0;
@@ -1041,11 +1041,11 @@ function Ct(e) {
   return e.endsWith("pt") ? a * (4 / 3) : a;
 }
 function xe(e) {
-  const a = y(e), t = Ct(a.fontSize), i = parseInt(a.fontWeight) || (a.fontWeight === "bold" ? 700 : 400);
+  const a = x(e), t = Ct(a.fontSize), i = parseInt(a.fontWeight) || (a.fontWeight === "bold" ? 700 : 400);
   return t >= 23.5 || t >= 18.5 && i >= 700;
 }
 function Tt(e) {
-  const a = He(e), t = [];
+  const a = Fe(e), t = [];
   for (const i of a) {
     const n = i.trim();
     if (!n) continue;
@@ -1059,7 +1059,7 @@ function Tt(e) {
 function we(e) {
   return e === "transparent" || e === "rgba(0, 0, 0, 0)" || e === "rgba(0 0 0 / 0)";
 }
-function ne([e, a, t]) {
+function _([e, a, t]) {
   return "#" + [e, a, t].map((i) => i.toString(16).padStart(2, "0")).join("");
 }
 function Nt(e, a, t) {
@@ -1074,7 +1074,7 @@ function Nt(e, a, t) {
 function Mt(e) {
   let a = 1, t = e;
   for (; t; ) {
-    const i = y(t), n = parseFloat(i.opacity);
+    const i = x(t), n = parseFloat(i.opacity);
     isNaN(n) || (a *= n), t = t.parentElement;
   }
   return a;
@@ -1097,18 +1097,18 @@ function $t(e) {
         }
       } catch {
       }
-    const i = y(a).backgroundColor;
+    const i = x(a).backgroundColor;
     if (i && !we(i) && U(i) >= 1) break;
     a = a.parentElement;
   }
   return !1;
 }
-const B = /* @__PURE__ */ new Map();
-function Wn(e, a) {
-  B.set(e, a), re.delete(e);
+const G = /* @__PURE__ */ new Map();
+function Un(e, a) {
+  G.set(e, a), re.delete(e);
 }
-function Dt(e, a) {
-  const t = B.get(a);
+function Ht(e, a) {
+  const t = G.get(a);
   return t ? e.map((i) => {
     const n = t[i.id];
     return n ? {
@@ -1119,20 +1119,20 @@ function Dt(e, a) {
   }) : e;
 }
 const re = /* @__PURE__ */ new Map();
-function Pt(e) {
+function Dt(e) {
   return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function Ft(e) {
+function Pt(e) {
   const a = e.split(/\{(\d+)\}/);
   let t = "^";
   for (let i = 0; i < a.length; i++)
-    i % 2 === 0 ? t += Pt(a[i]) : t += "(.+?)";
+    i % 2 === 0 ? t += Dt(a[i]) : t += "(.+?)";
   return t += "$", new RegExp(t);
 }
-function Ht(e, a) {
+function Ft(e, a) {
   let t = re.get(e);
   if (t || (t = /* @__PURE__ */ new Map(), re.set(e, t)), t.has(a)) return t.get(a);
-  const i = B.get(e);
+  const i = G.get(e);
   if (!i) return;
   const n = i[a];
   if (!(n != null && n.messages))
@@ -1140,13 +1140,13 @@ function Ht(e, a) {
   const r = [];
   for (const [o, s] of Object.entries(n.messages))
     r.push({
-      regex: Ft(o),
+      regex: Pt(o),
       translated: s
     });
   return t.set(a, r), r;
 }
 function zt(e, a, t) {
-  const i = Ht(t, e);
+  const i = Ft(t, e);
   if (!i) return a;
   for (const { regex: n, translated: r } of i) {
     const o = a.match(n);
@@ -1159,7 +1159,7 @@ function zt(e, a, t) {
   return a;
 }
 function ze(e, a) {
-  return B.has(a) ? e.map((t) => {
+  return G.has(a) ? e.map((t) => {
     const i = zt(t.ruleId, t.message, a);
     return i === t.message ? t : { ...t, message: i };
   }) : e;
@@ -1191,12 +1191,13 @@ const jt = {
   wcag: ["1.1.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the image to describe its visual content for alt text.",
   description: `Images must have alternate text. Add an alt attribute to <img> elements. Decorative images may use an empty alt attribute (alt=""), role='none', or role='presentation'.`,
-  guidance: "Every image needs an alt attribute. For informative images, describe the content or function concisely. For decorative images (backgrounds, spacers, purely visual flourishes), use alt='' to hide them from screen readers. Never omit alt entirely—screen readers may read the filename instead.",
+  guidance: "Every image needs an alt attribute. For informative images, describe the content or function concisely. For decorative images (backgrounds, spacers, purely visual flourishes), use alt='' to hide them from screen readers. Never omit alt entirely—screen readers may read the filename instead. When an image is inside a link or button that already has text, use alt='' if the image is decorative in that context, or write alt text that complements (not duplicates) the existing text.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("img")) {
-      if (h(t) || Pe(t)) continue;
+      if (h(t) || De(t)) continue;
       const i = t.getAttribute("role");
       if (i === "presentation" || i === "none") {
         const r = t.getAttribute("tabindex");
@@ -1215,7 +1216,7 @@ const jt = {
         });
         continue;
       }
-      !t.hasAttribute("alt") && !x(t) && a.push({
+      !t.hasAttribute("alt") && !w(t) && a.push({
         ruleId: "text-alternatives/img-alt",
         selector: p(t),
         html: m(t),
@@ -1228,27 +1229,28 @@ const jt = {
     return a;
   }
 };
-function Ut(e) {
+function Wt(e) {
   var i;
-  const a = Fe(e);
+  const a = Pe(e);
   if (a) return a;
   const t = e.querySelector("title");
   return (i = t == null ? void 0 : t.textContent) != null && i.trim() ? t.textContent.trim() : "";
 }
-const Wt = {
+const Ut = {
   id: "text-alternatives/svg-img-alt",
   category: "text-alternatives",
   actRuleIds: ["7d6734"],
   wcag: ["1.1.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the SVG to understand its content, then add a title element or aria-label.",
   description: "SVG elements with an img, graphics-document, or graphics-symbol role must have an accessible name via a <title> element, aria-label, or aria-labelledby.",
   guidance: "Inline SVGs with role='img' need accessible names. Add a <title> element as the first child of the SVG (screen readers will announce it), or use aria-label on the SVG element. For complex SVGs, use aria-labelledby referencing both a <title> and <desc> element. Decorative SVGs should use aria-hidden='true' instead.",
   run(e) {
     const a = [], t = 'svg[role="img"], [role="graphics-document"], [role="graphics-symbol"]';
     for (const i of e.querySelectorAll(t)) {
       if (h(i)) continue;
-      if (!Ut(i)) {
+      if (!Wt(i)) {
         const r = i.getAttribute("role");
         a.push({
           ruleId: "text-alternatives/svg-img-alt",
@@ -1269,12 +1271,13 @@ const Wt = {
   wcag: ["1.1.1", "4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the image button to see its icon, then set alt to describe the action (e.g., 'Search', 'Submit').",
   description: 'Image inputs (<input type="image">) must have alternate text describing the button action.',
   guidance: "Image buttons (<input type='image'>) act as submit buttons with a custom image. Add alt text via alt, aria-label, or aria-labelledby that describes the action (e.g. alt='Search' or alt='Submit order'), not the image itself. Without it, screen readers announce only 'image' or the filename, giving no clue what the button does.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll('input[type="image"]'))
-      h(t) || x(t) || a.push({
+      h(t) || w(t) || a.push({
         ruleId: "text-alternatives/input-image-alt",
         selector: p(t),
         html: m(t),
@@ -1325,6 +1328,7 @@ const Wt = {
   level: "A",
   tags: ["best-practice"],
   fixability: "contextual",
+  browserHint: "Screenshot the image to verify the alt text accurately describes it without filler words like 'image of'.",
   description: "Image alt text should not contain words like 'image', 'photo', or 'picture' — screen readers already announce the element type.",
   guidance: "Screen readers already announce 'image' or 'graphic' before reading alt text, so phrases like 'image of', 'photo of', or 'picture of' are redundant. Remove these words and describe what the image shows. For example, change 'image of a dog' to 'golden retriever playing fetch'.",
   run(e) {
@@ -1357,7 +1361,7 @@ const Wt = {
     const a = [];
     for (const t of e.querySelectorAll("area[href]")) {
       if (h(t)) continue;
-      x(t) || a.push({
+      w(t) || a.push({
         ruleId: "text-alternatives/area-alt",
         selector: p(t),
         html: m(t),
@@ -1375,13 +1379,14 @@ const Wt = {
   wcag: ["1.1.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the embedded object to see its content, then add aria-label or title describing it.",
   description: "<object> elements must have alternative text.",
   guidance: "Object elements embed external content that may not be accessible to all users. Provide alternative text via aria-label, aria-labelledby, or a title attribute. The fallback content inside <object> is only shown when the object fails to load and does not serve as an accessible name.",
   run(e) {
     var t;
     const a = [];
     for (const i of e.querySelectorAll("object")) {
-      if (h(i) || Pe(i) || i.getAttribute("role") === "presentation" || i.getAttribute("role") === "none" || Fe(i)) continue;
+      if (h(i) || De(i) || i.getAttribute("role") === "presentation" || i.getAttribute("role") === "none" || Pe(i)) continue;
       const n = i.getAttribute("data") || "";
       if (!((i.getAttribute("type") || "").startsWith("image/") || /\.(png|jpg|jpeg|gif|svg|webp|bmp|ico)$/i.test(n))) {
         const s = i.querySelector("img[alt]");
@@ -1405,13 +1410,14 @@ const Wt = {
   wcag: ["1.1.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the element to see its visual appearance, then provide an aria-label describing what it represents.",
   description: "Elements with role='img' must have an accessible name.",
   guidance: "When you assign role='img' to an element (like a div containing icon fonts or CSS backgrounds), you must provide an accessible name via aria-label or aria-labelledby. Without this, screen reader users have no way to understand what the image represents. If the image is decorative, use role='presentation' or role='none' instead.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll('[role="img"]')) {
       if (h(t) || t.tagName.toLowerCase() === "svg" || t.tagName.toLowerCase() === "img") continue;
-      x(t) || a.push({
+      w(t) || a.push({
         ruleId: "text-alternatives/role-img-alt",
         selector: p(t),
         html: m(t),
@@ -1422,19 +1428,20 @@ const Wt = {
     }
     return a;
   }
-}, Kt = {
+}, Jt = {
   id: "time-based-media/video-captions",
   category: "time-based-media",
   actRuleIds: ["eac66b"],
   wcag: ["1.2.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the video element to see its poster or content for context when writing captions.",
   description: "Video elements must have captions via <track kind='captions'> or <track kind='subtitles'>.",
   guidance: "Captions provide text alternatives for audio content in videos, benefiting deaf users and those who cannot hear audio. Add a <track> element with kind='captions' pointing to a WebVTT caption file. Captions should include both dialogue and important sound effects.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("video")) {
-      if (h(t) || q(t) || t.hasAttribute("muted") || t.hasAttribute("autoplay")) continue;
+      if (h(t) || E(t) || t.hasAttribute("muted") || t.hasAttribute("autoplay")) continue;
       t.querySelector('track[kind="captions"], track[kind="subtitles"]') || a.push({
         ruleId: "time-based-media/video-captions",
         selector: p(t),
@@ -1445,19 +1452,20 @@ const Wt = {
     }
     return a;
   }
-}, Jt = {
+}, Kt = {
   id: "time-based-media/audio-transcript",
   category: "time-based-media",
   actRuleIds: ["e7aa44"],
   wcag: ["1.2.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Inspect the page around the audio element for existing transcript links or associated text content.",
   description: "Audio elements should have a text alternative or transcript.",
   guidance: "Audio-only content like podcasts or recordings needs a text alternative for deaf users. Provide a transcript either on the same page or linked nearby. The transcript should include all spoken content and descriptions of relevant sounds.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("audio")) {
-      if (h(t) || q(t) || t.querySelector('track[kind="captions"], track[kind="descriptions"]') || t.hasAttribute("aria-describedby")) continue;
+      if (h(t) || E(t) || t.querySelector('track[kind="captions"], track[kind="descriptions"]') || t.hasAttribute("aria-describedby")) continue;
       const n = t.parentElement;
       n && n.querySelector('a[href*="transcript"], a[href*="text"]') || a.push({
         ruleId: "time-based-media/audio-transcript",
@@ -1556,7 +1564,7 @@ const na = {
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("[autocomplete]")) {
-      if (h(t) || q(t) || t.disabled || t.getAttribute("aria-disabled") === "true") continue;
+      if (h(t) || E(t) || t.disabled || t.getAttribute("aria-disabled") === "true") continue;
       const i = t.getAttribute("autocomplete").trim();
       i && (ia(i) || a.push({
         ruleId: "adaptable/autocomplete-valid",
@@ -1620,7 +1628,7 @@ function ra(e) {
       return `Unknown check type: ${String(e.type)}`;
   }
 }
-function E(e, a, t) {
+function L(e, a, t) {
   let i = e;
   if (i.includes("{{tag}}") && (i = i.replace(/\{\{tag\}\}/g, a.tagName.toLowerCase())), i.includes("{{value}}")) {
     let n = "";
@@ -1638,6 +1646,7 @@ function N(e) {
     level: e.level,
     tags: e.tags,
     fixability: e.fixability,
+    browserHint: e.browserHint,
     description: e.description,
     guidance: e.guidance,
     run(t) {
@@ -1651,7 +1660,7 @@ function N(e) {
               selector: p(o),
               html: m(o),
               impact: e.impact,
-              message: E(e.message, o, e.check),
+              message: L(e.message, o, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: o
             });
@@ -1667,7 +1676,7 @@ function N(e) {
               selector: p(d),
               html: m(d),
               impact: e.impact,
-              message: E(e.message, d, e.check),
+              message: L(e.message, d, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: d
             });
@@ -1682,7 +1691,7 @@ function N(e) {
               selector: p(s),
               html: m(s),
               impact: e.impact,
-              message: E(e.message, s, e.check),
+              message: L(e.message, s, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: s
             });
@@ -1706,7 +1715,7 @@ function N(e) {
               selector: p(u),
               html: m(u),
               impact: e.impact,
-              message: E(e.message, u, e.check),
+              message: L(e.message, u, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: u
             }) : !d && g && i.push({
@@ -1714,7 +1723,7 @@ function N(e) {
               selector: p(u),
               html: m(u),
               impact: e.impact,
-              message: E(e.message, u, e.check),
+              message: L(e.message, u, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: u
             });
@@ -1729,7 +1738,7 @@ function N(e) {
               selector: p(s),
               html: m(s),
               impact: e.impact,
-              message: E(e.message, s, e.check),
+              message: L(e.message, s, e.check),
               ...e.fix ? { fix: e.fix } : {},
               element: s
             });
@@ -1771,7 +1780,7 @@ function N(e) {
                     selector: p(b),
                     html: m(b),
                     impact: e.impact,
-                    message: E(e.message, b, e.check),
+                    message: L(e.message, b, e.check),
                     ...e.fix ? { fix: e.fix } : {},
                     element: b
                   });
@@ -1890,7 +1899,7 @@ function je(e, a) {
       return NaN;
   }
 }
-function V(e) {
+function B(e) {
   return isNaN(e) ? !1 : (e = (e % 360 + 360) % 360, e >= 85 && e <= 95 || e >= 265 && e <= 275);
 }
 function pa(e) {
@@ -1899,21 +1908,21 @@ function pa(e) {
   );
   if (a) {
     const n = je(parseFloat(a[1]), a[2]);
-    if (V(n)) return !0;
+    if (B(n)) return !0;
   }
   const t = e.match(
     /matrix\(\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)/i
   );
   if (t) {
     const n = parseFloat(t[1]), r = parseFloat(t[2]), o = Math.atan2(r, n) * (180 / Math.PI);
-    if (V(o)) return !0;
+    if (B(o)) return !0;
   }
   const i = e.match(
     /matrix3d\(\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)\s*,\s*(-?[\d.e]+)/i
   );
   if (i) {
     const n = parseFloat(i[1]), r = parseFloat(i[2]), o = Math.atan2(r, n) * (180 / Math.PI);
-    if (V(o)) return !0;
+    if (B(o)) return !0;
   }
   return !1;
 }
@@ -1921,7 +1930,7 @@ function ba(e) {
   const a = e.match(/(-?[\d.]+)(deg|rad|turn|grad)/i);
   if (!a) return !1;
   const t = je(parseFloat(a[1]), a[2]);
-  return V(t);
+  return B(t);
 }
 const ha = {
   id: "adaptable/orientation-lock",
@@ -1998,14 +2007,14 @@ function fa(e, a) {
   for (const s of e.querySelectorAll("*")) {
     if (h(s)) continue;
     r = !0;
-    const l = j(s);
+    const l = W(s);
     l && n.add(l);
   }
   for (const s of t) {
     const l = i.getElementById(s);
     if (l && !h(l)) {
       r = !0;
-      const d = j(l);
+      const d = W(l);
       d && n.add(d);
     }
   }
@@ -2082,7 +2091,7 @@ const va = {
       const r = Se[n];
       let o = i.parentElement, s = !1;
       for (; o && o !== e.documentElement; ) {
-        const l = j(o);
+        const l = W(o);
         if (l && r.includes(l)) {
           s = !0;
           break;
@@ -2188,6 +2197,7 @@ const ka = {
   wcag: ["1.3.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the table to understand its visual layout, then add scope or headers attributes to associate data cells with headers.",
   description: "Data cells in tables larger than 3x3 should have associated headers.",
   guidance: "In complex tables, screen reader users need header associations to understand data cells. Use th elements with scope attribute, or the headers attribute on td elements. For simple tables (≤3x3), this is less critical as context is usually clear.",
   run(e) {
@@ -2214,9 +2224,9 @@ const ka = {
         let g = !1;
         const f = i.querySelector("thead"), v = (f == null ? void 0 : f.querySelector("tr")) ?? i.querySelector("tbody > tr, tr");
         if (v)
-          for (const w of v.querySelectorAll("th, td")) {
-            const A = Ie(w), S = parseInt(w.getAttribute("colspan") || "1", 10);
-            if (w.tagName.toLowerCase() === "th" && b >= A && b < A + S) {
+          for (const y of v.querySelectorAll("th, td")) {
+            const A = Ie(y), S = parseInt(y.getAttribute("colspan") || "1", 10);
+            if (y.tagName.toLowerCase() === "th" && b >= A && b < A + S) {
               g = !0;
               break;
             }
@@ -2266,6 +2276,7 @@ const ka = {
   level: "A",
   tags: ["best-practice"],
   fixability: "contextual",
+  browserHint: "Screenshot the table to see which header cells are visually empty, then add text content or aria-label.",
   description: "Table header cells should have visible text.",
   guidance: "Empty table headers provide no information to screen reader users. Either add descriptive text to the header, or if the header is intentionally empty (like a corner cell), consider using a td element instead or adding a visually hidden label.",
   run(e) {
@@ -2273,7 +2284,7 @@ const ka = {
     for (const t of e.querySelectorAll("th")) {
       if (h(t)) continue;
       const i = t.closest("table");
-      (i == null ? void 0 : i.getAttribute("role")) === "presentation" || (i == null ? void 0 : i.getAttribute("role")) === "none" || x(t) || a.push({
+      (i == null ? void 0 : i.getAttribute("role")) === "presentation" || (i == null ? void 0 : i.getAttribute("role")) === "none" || w(t) || a.push({
         ruleId: "adaptable/empty-table-header",
         selector: p(t),
         html: m(t),
@@ -2283,7 +2294,7 @@ const ka = {
     }
     return a;
   }
-}, qa = {
+}, Ea = {
   id: "distinguishable/meta-viewport",
   category: "distinguishable",
   actRuleIds: ["b4f0c3"],
@@ -2291,6 +2302,7 @@ const ka = {
   level: "AA",
   tags: ["page-level"],
   fixability: "mechanical",
+  browserHint: "After fixing the viewport meta tag, resize the viewport to 320px wide and screenshot to verify content remains readable and usable.",
   description: "Viewport meta tag must not disable user scaling.",
   guidance: "Users with low vision need to zoom content up to 200% or more. Setting user-scalable=no or maximum-scale=1 prevents zooming and fails WCAG. Remove these restrictions. If your layout breaks at high zoom, fix the responsive design rather than preventing zoom.",
   run(e) {
@@ -2328,7 +2340,7 @@ const ka = {
 function ce(e) {
   return e.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
 }
-function Ue(e, a) {
+function We(e, a) {
   const t = e.getAttribute("style");
   if (!t) return null;
   const i = new RegExp(
@@ -2375,7 +2387,7 @@ function Ue(e, a) {
   }
   return null;
 }
-function We(e, a, t, i) {
+function Ue(e, a, t, i) {
   function n(r) {
     var o;
     if (r !== e) {
@@ -2387,7 +2399,7 @@ function We(e, a, t, i) {
     }
     for (const s of r.childNodes)
       if (s.nodeType === 3 && ((o = s.textContent) != null && o.trim())) {
-        const l = parseFloat(y(r).fontSize);
+        const l = parseFloat(x(r).fontSize);
         if (l > 0 && t / l < i) return !0;
         break;
       }
@@ -2397,7 +2409,7 @@ function We(e, a, t, i) {
   }
   return n(e);
 }
-function La(e) {
+function qa(e) {
   var a;
   for (const t of e.childNodes)
     if (t.nodeType === 3 && ((a = t.textContent) != null && a.trim()))
@@ -2419,7 +2431,7 @@ function Ve(e) {
   return !1;
 }
 function de(e, a) {
-  if (La(e)) return !0;
+  if (qa(e)) return !0;
   for (const t of e.children) {
     const i = t.getAttribute("style") || "";
     if (!new RegExp(
@@ -2434,10 +2446,10 @@ function Be(e, a, t, i) {
   const n = [];
   for (const r of e.querySelectorAll("[style]")) {
     if (h(r) || !Oe(r) || Ve(r) || !de(r, t)) continue;
-    const o = Ue(r, t);
+    const o = We(r, t);
     if (!o) continue;
     let s = !1;
-    if (o.em !== null ? s = o.em < i : o.px !== null && (s = We(r, t, o.px, i)), s) {
+    if (o.em !== null ? s = o.em < i : o.px !== null && (s = Ue(r, t, o.px, i)), s) {
       const l = o.em !== null ? `${o.em}${t === "line-height" ? "" : "em"}` : `${o.px}px`;
       n.push({
         ruleId: a,
@@ -2450,10 +2462,10 @@ function Be(e, a, t, i) {
   }
   return n;
 }
-function Ea(e) {
+function La(e) {
   let a = e, t = !1;
   for (; a; ) {
-    const i = y(a);
+    const i = x(a);
     parseFloat(i.width) > 500 && (t = !0), (i.whiteSpace === "nowrap" || i.whiteSpace === "pre") && (t = !0);
     const r = i.overflowX, o = i.overflowY;
     if ((r === "scroll" || r === "auto") && o !== "scroll" && o !== "auto")
@@ -2486,15 +2498,15 @@ const Ra = {
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("[style]")) {
-      if (h(t) || !Oe(t) || Ve(t) || !de(t, "line-height") || Ea(t)) continue;
+      if (h(t) || !Oe(t) || Ve(t) || !de(t, "line-height") || La(t)) continue;
       if (t instanceof HTMLElement && t.scrollHeight > 0) {
-        const r = parseFloat(y(t).lineHeight);
+        const r = parseFloat(x(t).lineHeight);
         if (r > 0 && t.scrollHeight <= r * 1.5) continue;
       }
-      const i = Ue(t, "line-height");
+      const i = We(t, "line-height");
       if (!i) continue;
       let n = !1;
-      if (i.em !== null ? n = i.em < 1.5 : i.px !== null && (n = We(t, "line-height", i.px, 1.5)), n) {
+      if (i.em !== null ? n = i.em < 1.5 : i.px !== null && (n = Ue(t, "line-height", i.px, 1.5)), n) {
         const r = i.em !== null ? `${i.em}` : `${i.px}px`;
         a.push({
           ruleId: "distinguishable/line-height",
@@ -2535,7 +2547,7 @@ const Ra = {
 ]);
 function $a(e) {
   let a = e.parentElement;
-  for (; a && !Na.has(y(a).display); )
+  for (; a && !Na.has(x(a).display); )
     a = a.parentElement;
   if (!a) return null;
   const t = a.ownerDocument.createTreeWalker(a, NodeFilter.SHOW_TEXT);
@@ -2550,49 +2562,50 @@ function $a(e) {
       }
       s = s.parentElement;
     }
-    l || (i += r.data, !n && r.parentElement && (n = C(y(r.parentElement).color)));
+    l || (i += r.data, !n && r.parentElement && (n = C(x(r.parentElement).color)));
   }
   const o = i.match(new RegExp("\\p{L}{3,}", "gu"));
   return !n || !o || o.length < 2 ? null : { block: a, textColor: n };
 }
-function qe(e, a) {
+function Ee(e, a) {
   const t = e.textDecorationLine || e.textDecoration || "";
   return (t.includes("underline") || t.includes("line-through")) && t !== a;
 }
-function O(e) {
+function V(e) {
   return e === "bold" ? 700 : e === "normal" ? 400 : parseInt(e) || 400;
 }
-function Da(e) {
+function Ha(e) {
   const a = e.ownerDocument.createTreeWalker(e, NodeFilter.SHOW_TEXT);
   let t;
   for (; t = a.nextNode(); )
     if (t.data.trim()) return !1;
   return !0;
 }
-const Pa = {
+const Da = {
   id: "distinguishable/link-in-text-block",
   category: "distinguishable",
   wcag: ["1.4.1"],
   level: "A",
   fixability: "visual",
+  browserHint: "Screenshot the text block to see how the link blends with surrounding text, then verify your fix (e.g., underline or border) makes the link visually distinct.",
   description: "Links within text blocks must be distinguishable by more than color alone.",
   guidance: "Users who cannot perceive color differences need other visual cues to identify links. Links in text should have underlines or other non-color indicators. If using color alone, ensure 3:1 contrast with surrounding text AND provide additional indication on focus/hover.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("a[href]")) {
-      if (h(t) || !k(t).trim() || Da(t) || t.closest('nav, header, footer, aside, [role="navigation"], [role="banner"], [role="contentinfo"], [role="complementary"]')) continue;
-      const i = y(t);
+      if (h(t) || !k(t).trim() || Ha(t) || t.closest('nav, header, footer, aside, [role="navigation"], [role="banner"], [role="contentinfo"], [role="complementary"]')) continue;
+      const i = x(t);
       if (!Ma.has(i.display || "inline")) continue;
       const n = $a(t);
       if (!n) continue;
-      const r = y(n.block), o = r.textDecorationLine || r.textDecoration || "";
-      if (qe(i, o) || (parseFloat(i.borderBottomWidth) || 0) > 0 && i.borderBottomStyle !== "none" && i.borderBottomStyle !== "hidden" || Math.abs(O(i.fontWeight) - O(r.fontWeight)) >= 300 || i.fontStyle !== r.fontStyle) continue;
+      const r = x(n.block), o = r.textDecorationLine || r.textDecoration || "";
+      if (Ee(i, o) || (parseFloat(i.borderBottomWidth) || 0) > 0 && i.borderBottomStyle !== "none" && i.borderBottomStyle !== "hidden" || Math.abs(V(i.fontWeight) - V(r.fontWeight)) >= 300 || i.fontStyle !== r.fontStyle) continue;
       const l = parseFloat(i.fontSize) || 16, d = parseFloat(r.fontSize) || 16;
       if (d > 0 && l / d >= 1.2) continue;
       let c = !1;
-      for (const w of t.querySelectorAll("*")) {
-        const A = y(w);
-        if (qe(A, o) || Math.abs(O(A.fontWeight) - O(r.fontWeight)) >= 300) {
+      for (const y of t.querySelectorAll("*")) {
+        const A = x(y);
+        if (Ee(A, o) || Math.abs(V(A.fontWeight) - V(r.fontWeight)) >= 300) {
           c = !0;
           break;
         }
@@ -2602,19 +2615,20 @@ const Pa = {
       if (!u) continue;
       const b = I(...u), g = I(...n.textColor), f = $(b, g);
       if (f < 1.1 || f >= 3) continue;
-      const v = (w) => "#" + w.map((A) => A.toString(16).padStart(2, "0")).join("");
+      const v = (y) => "#" + y.map((A) => A.toString(16).padStart(2, "0")).join("");
       a.push({
         ruleId: "distinguishable/link-in-text-block",
         selector: p(t),
         html: m(t),
         impact: "serious",
         message: "Link in text block is not visually distinguishable from surrounding text. Add a non-color visual indicator such as an underline or border.",
-        context: `link color: ${v(u)} rgb(${u.join(", ")}), surrounding text: ${v(n.textColor)} rgb(${n.textColor.join(", ")}), ratio: ${f.toFixed(2)}:1`
+        context: `link color: ${v(u)} rgb(${u.join(", ")}), surrounding text: ${v(n.textColor)} rgb(${n.textColor.join(", ")}), ratio: ${f.toFixed(2)}:1`,
+        fix: { type: "suggest", suggestion: "Add text-decoration: underline to the link, or add a visible border-bottom. If relying on color contrast alone, ensure at least 3:1 ratio between the link color and surrounding text color." }
       });
     }
     return a;
   }
-}, Fa = /* @__PURE__ */ new Set([
+}, Pa = /* @__PURE__ */ new Set([
   "SCRIPT",
   "STYLE",
   "NOSCRIPT",
@@ -2630,7 +2644,7 @@ const Pa = {
   "BR",
   "HR"
 ]);
-function Ha(e) {
+function Fa(e) {
   const a = e.clip;
   if (a && a.startsWith("rect(")) {
     const i = a.match(/[\d.]+/g);
@@ -2648,8 +2662,8 @@ function za(e) {
   if (h(e)) return !0;
   let a = e;
   for (; a; ) {
-    const t = y(a);
-    if (t.display === "none" || t.visibility === "hidden" || Ha(t)) return !0;
+    const t = x(a);
+    if (t.display === "none" || t.visibility === "hidden" || Fa(t)) return !0;
     a = a.parentElement;
   }
   return !1;
@@ -2657,7 +2671,7 @@ function za(e) {
 function ja(e) {
   return e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e instanceof HTMLSelectElement || e instanceof HTMLButtonElement ? e.disabled : !!(e.closest("fieldset[disabled]") || e.getAttribute("aria-disabled") === "true");
 }
-function Ua(e, a) {
+function Wa(e, a) {
   if (e.tagName !== "LABEL") return !1;
   const t = e, i = t.htmlFor;
   if (i) {
@@ -2669,7 +2683,7 @@ function Ua(e, a) {
   const r = t.id;
   return !!(r && a.querySelector(`[aria-labelledby~="${r}"][aria-disabled="true"]`));
 }
-function Wa(e) {
+function Ua(e) {
   return e.closest("select") !== null;
 }
 function Oa(e) {
@@ -2694,10 +2708,10 @@ function _a(e) {
   const a = parseFloat(e);
   return isNaN(a) ? NaN : e.trim().endsWith("%") ? a / 100 : a;
 }
-const Le = /([a-z-]+)\(([^)]*)\)/g;
-function Ee(e) {
+const qe = /([a-z-]+)\(([^)]*)\)/g;
+function Le(e) {
   let a, t = !1;
-  for (Le.lastIndex = 0; a = Le.exec(e); ) {
+  for (qe.lastIndex = 0; a = qe.exec(e); ) {
     t = !0;
     const i = Ba[a[1]];
     if (i === void 0 || _a(a[2]) !== i) return !1;
@@ -2707,12 +2721,12 @@ function Ee(e) {
 function Ga(e) {
   let a = e;
   for (; a; ) {
-    const t = y(a), i = t.filter;
-    if (i && i !== "none" && i !== "initial" && !Ee(i)) return !0;
+    const t = x(a), i = t.filter;
+    if (i && i !== "none" && i !== "initial" && !Le(i)) return !0;
     const n = t.mixBlendMode;
     if (n && n !== "normal" && n !== "initial") return !0;
     const r = t.backdropFilter;
-    if (r && r !== "none" && r !== "initial" && !Ee(r)) return !0;
+    if (r && r !== "none" && r !== "initial" && !Le(r)) return !0;
     a = a.parentElement;
   }
   return !1;
@@ -2720,7 +2734,7 @@ function Ga(e) {
 function Ya(e) {
   let a = e;
   for (; a; ) {
-    const t = y(a), i = t.backgroundImage;
+    const t = x(a), i = t.backgroundImage;
     if (i && i !== "none" && i !== "initial")
       return i.includes("gradient(") ? { bgImage: i, gradientEl: a } : null;
     const n = t.backgroundColor;
@@ -2743,11 +2757,11 @@ function Xa(e, a, t, i, n, r, o, s, l) {
   for (const f of d) {
     let v = a;
     t < 1 && (v = R(a, f, t)), i < 1 && (v = R(v, f, i));
-    const w = $(
+    const y = $(
       I(v[0], v[1], v[2]),
       I(f[0], f[1], f[2])
     );
-    w > c && (c = w, u = f);
+    y > c && (c = y, u = f);
   }
   if (c >= n) return null;
   let b = a;
@@ -2759,7 +2773,8 @@ function Xa(e, a, t, i, n, r, o, s, l) {
     html: m(e),
     impact: "serious",
     message: `Insufficient${o === "AAA" ? " enhanced" : ""} color contrast ratio of ${g}:1 (required ${n}:1).`,
-    context: `foreground: ${ne(b)} rgb(${b.join(", ")}), background: gradient, ratio: ${g}:1, required: ${n}:1`
+    context: `foreground: ${_(b)} rgb(${b.join(", ")}), background: gradient, ratio: ${g}:1, required: ${n}:1`,
+    fix: { type: "suggest", suggestion: `Change the text color or gradient background so the contrast ratio meets ${n}:1. The current foreground is ${_(b)}.` }
   };
 }
 function _e(e, a, t) {
@@ -2770,10 +2785,10 @@ function _e(e, a, t) {
   for (; s = r.nextNode(); ) {
     if (!s.textContent || !s.textContent.trim() || Oa(s.textContent)) continue;
     const l = s.parentElement;
-    if (!l || o.has(l) || (o.add(l), Fa.has(l.tagName))) continue;
+    if (!l || o.has(l) || (o.add(l), Pa.has(l.tagName))) continue;
     const d = l.tagName;
-    if (d === "BODY" || d === "HTML" || Wa(l) || ja(l) || Ua(l, e) || Va(l) || za(l)) continue;
-    const c = y(l);
+    if (d === "BODY" || d === "HTML" || Ua(l) || ja(l) || Wa(l, e) || Va(l) || za(l)) continue;
+    const c = x(l);
     if (parseFloat(c.opacity) === 0) continue;
     const u = Mt(l);
     if (u < 0.1) continue;
@@ -2783,46 +2798,47 @@ function _e(e, a, t) {
     const f = C(c.color);
     if (!f) continue;
     const v = U(c.color);
-    if (v === 0 || Lt(l)) continue;
-    const w = t === "AAA" ? xe(l) ? 4.5 : 7 : xe(l) ? 3 : 4.5;
+    if (v === 0 || qt(l)) continue;
+    const y = t === "AAA" ? xe(l) ? 4.5 : 7 : xe(l) ? 3 : 4.5;
     let A = ye(l);
     if (!A) {
       if (g) continue;
-      const L = Ya(l);
-      if (L) {
-        const _ = L.gradientEl.parentElement ? ye(L.gradientEl.parentElement) : null, W = Xa(
+      const q = Ya(l);
+      if (q) {
+        const O = q.gradientEl.parentElement ? ye(q.gradientEl.parentElement) : null, H = Xa(
           l,
           f,
           v,
           u,
-          w,
+          y,
           a,
           t,
-          L.bgImage,
-          _ ?? [255, 255, 255]
+          q.bgImage,
+          O ?? [255, 255, 255]
         );
-        W && i.push(W);
+        H && i.push(H);
       }
       continue;
     }
     let S = f;
     v < 1 && (S = R(f, A, v)), u < 1 && (S = R(S, A, u));
     const nt = I(S[0], S[1], S[2]), rt = I(A[0], A[1], A[2]), be = g ? Nt(S, A, g) : $(nt, rt);
-    if (be < w) {
-      const L = Math.round(be * 100) / 100, _ = ne(S), W = ne(A);
+    if (be < y) {
+      const q = Math.round(be * 100) / 100, O = _(S), H = _(A);
       i.push({
         ruleId: a,
         selector: p(l),
         html: m(l),
         impact: "serious",
-        message: `Insufficient${t === "AAA" ? " enhanced" : ""} color contrast ratio of ${L}:1 (required ${w}:1).`,
-        context: `foreground: ${_} rgb(${S.join(", ")}), background: ${W} rgb(${A.join(", ")}), ratio: ${L}:1, required: ${w}:1`
+        message: `Insufficient${t === "AAA" ? " enhanced" : ""} color contrast ratio of ${q}:1 (required ${y}:1).`,
+        context: `foreground: ${O} rgb(${S.join(", ")}), background: ${H} rgb(${A.join(", ")}), ratio: ${q}:1, required: ${y}:1`,
+        fix: { type: "suggest", suggestion: `Change the text color or background color so the contrast ratio meets ${y}:1. Current foreground is ${O}, background is ${H}.` }
       });
     }
   }
   return i;
 }
-const Ka = {
+const Ja = {
   id: "distinguishable/color-contrast",
   category: "distinguishable",
   actRuleIds: ["afw4f7"],
@@ -2830,11 +2846,12 @@ const Ka = {
   level: "AA",
   fixability: "visual",
   description: "Text elements must have sufficient color contrast against the background.",
+  browserHint: "Violation context includes computed colors and ratio. After changing colors, use JavaScript to read getComputedStyle() on the element and recalculate the contrast ratio. Screenshot the element to verify the fix looks correct in context.",
   guidance: "WCAG SC 1.4.3 requires a contrast ratio of at least 4.5:1 for normal text and 3:1 for large text (>=24px or >=18.66px bold). Increase the contrast by darkening the text or lightening the background, or vice versa.",
   run(e) {
     return _e(e, "distinguishable/color-contrast", "AA");
   }
-}, Ja = {
+}, Ka = {
   id: "distinguishable/color-contrast-enhanced",
   category: "distinguishable",
   actRuleIds: ["09o5cg"],
@@ -2842,6 +2859,7 @@ const Ka = {
   level: "AAA",
   fixability: "visual",
   description: "Text elements must have enhanced color contrast against the background (WCAG AAA).",
+  browserHint: "Violation context includes computed colors and ratio. After changing colors, use JavaScript to read getComputedStyle() on the element and recalculate the contrast ratio. Screenshot the element to verify the fix looks correct in context.",
   guidance: "WCAG SC 1.4.6 (AAA) requires a contrast ratio of at least 7:1 for normal text and 4.5:1 for large text (>=24px or >=18.66px bold). Higher contrast benefits users with low vision, aging eyes, or poor screen conditions. Increase the contrast by darkening the text or lightening the background, or vice versa.",
   run(e) {
     return _e(e, "distinguishable/color-contrast-enhanced", "AAA");
@@ -3025,6 +3043,7 @@ const di = {
   wcag: ["2.1.1"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Tab to the scrollable region and verify keyboard scrolling works with arrow keys.",
   description: "Scrollable regions must be keyboard accessible.",
   guidance: "Content that scrolls must be accessible to keyboard users. If a region has overflow:scroll or overflow:auto and contains scrollable content, it needs either tabindex='0' to be focusable, or it must contain focusable elements. Without this, keyboard users cannot scroll the content.",
   run(e) {
@@ -3036,17 +3055,17 @@ const di = {
       if (n === "body" || n === "html") continue;
       const r = i.getAttribute("role");
       if (r === "presentation" || r === "none" || r === "listbox" || r === "menu" || r === "tree" || r === "tabpanel") continue;
-      const o = y(i), s = o.overflowX, l = o.overflowY;
+      const o = x(i), s = o.overflowX, l = o.overflowY;
       if (!(s === "scroll" || s === "auto" || l === "scroll" || l === "auto")) continue;
       if (i.scrollHeight > 0 || i.clientHeight > 0) {
         const g = i.scrollHeight - i.clientHeight, f = i.scrollWidth - i.clientWidth;
         if (g <= 0 && f <= 0 || g < 14 && f < 14 || i.clientWidth < 64 && i.clientHeight < 64) continue;
-        const v = ((t = i.textContent) == null ? void 0 : t.trim().length) ?? 0, w = i.querySelector("img, svg, video, canvas, picture") !== null;
-        if (v === 0 && !w) continue;
+        const v = ((t = i.textContent) == null ? void 0 : t.trim().length) ?? 0, y = i.querySelector("img, svg, video, canvas, picture") !== null;
+        if (v === 0 && !y) continue;
       } else
         continue;
       const u = i.getAttribute("tabindex");
-      u !== null && u !== "-1" || i.querySelector(z) || a.push({
+      u !== null && u !== "-1" || i.querySelector(j) || a.push({
         ruleId: "keyboard-accessible/scrollable-region",
         selector: p(i),
         html: m(i),
@@ -3094,11 +3113,12 @@ const di = {
   wcag: ["2.4.7"],
   level: "AA",
   fixability: "visual",
+  browserHint: "Tab to the element and screenshot to verify a visible focus indicator appears. Check that the indicator has sufficient contrast against the background.",
   description: "Elements in sequential focus order must have a visible focus indicator.",
   guidance: "Keyboard users need to see which element has focus. Do not remove the default focus outline (outline: none) without providing an alternative visible indicator. Use :focus-visible or :focus styles to ensure focus is always perceivable.",
   run(e) {
     const a = [];
-    for (const t of e.querySelectorAll(z)) {
+    for (const t of e.querySelectorAll(j)) {
       if (h(t) || !(t instanceof HTMLElement)) continue;
       const i = t.getAttribute("style") || "";
       if (/outline\s*:\s*(none|0)\s*(;|$|!)/i.test(i)) {
@@ -3128,7 +3148,7 @@ function Ye(e) {
   return { seconds: t, hasValidUrl: i };
 }
 const Xe = 'article, aside, main, nav, section, [role="article"], [role="complementary"], [role="main"], [role="navigation"], [role="region"]', Re = 'main, [role="main"], header, [role="banner"], footer, [role="contentinfo"], nav, [role="navigation"], aside, [role="complementary"], section[aria-label], section[aria-labelledby], [role="region"][aria-label], [role="region"][aria-labelledby], form[aria-label], form[aria-labelledby], [role="form"][aria-label], [role="form"][aria-labelledby], [role="search"]';
-function Ke(e) {
+function Je(e) {
   return {
     id: e.id,
     category: e.id.split("/")[0],
@@ -3351,10 +3371,10 @@ const bi = {
   run(e) {
     var o, s, l;
     const a = e.querySelector("h1");
-    if (a && x(a)) return [];
+    if (a && w(a)) return [];
     const t = e.querySelectorAll('[role="heading"][aria-level="1"]');
     for (const d of t)
-      if (x(d)) return [];
+      if (w(d)) return [];
     const i = [], n = (s = (o = e.querySelector("title")) == null ? void 0 : o.textContent) == null ? void 0 : s.trim();
     n && i.push(`Page title: "${n}"`);
     const r = e.querySelector("main");
@@ -3378,6 +3398,7 @@ const bi = {
   level: "A",
   tags: ["best-practice"],
   fixability: "contextual",
+  browserHint: "Screenshot the page to see the visual hierarchy, then take an accessibility tree snapshot to map heading levels to visual sections.",
   description: "Heading levels should increase by one; skipping levels (e.g. h2 to h4) makes navigation harder.",
   guidance: "Screen reader users navigate by headings to understand page structure. Skipping levels (h2 to h4) suggests missing content and creates confusion. Start with h1 for the page title, then use h2 for main sections, h3 for subsections, etc. You can go back up (h3 to h2) when starting a new section.",
   run(e) {
@@ -3406,13 +3427,14 @@ const bi = {
   level: "A",
   tags: ["best-practice"],
   fixability: "contextual",
+  browserHint: "Screenshot the heading area to verify it's visually empty, then add meaningful text or remove the heading element.",
   description: "Headings must have discernible text.",
   guidance: "Screen reader users navigate pages by headings, so empty headings create confusing navigation points. Ensure all headings contain visible text or accessible names. If a heading is used purely for visual styling, use CSS instead of heading elements.",
   run(e) {
     var i;
     const a = [], t = e.querySelectorAll('h1, h2, h3, h4, h5, h6, [role="heading"]');
     for (const n of t)
-      if (!h(n) && !x(n)) {
+      if (!h(n) && !w(n)) {
         let r;
         const o = n.nextElementSibling;
         if (o) {
@@ -3437,7 +3459,8 @@ const bi = {
   wcag: ["1.3.1"],
   level: "A",
   tags: ["best-practice"],
-  fixability: "visual",
+  fixability: "contextual",
+  browserHint: "Screenshot the page to verify the paragraph visually functions as a heading and choose the correct heading level.",
   description: "Paragraphs should not be styled to look like headings.",
   guidance: "When paragraphs are styled with bold, large fonts to look like headings, screen reader users miss the semantic structure. Use proper heading elements (h1-h6) instead of styled paragraphs. If you need specific styling, apply CSS to the heading elements while maintaining proper heading hierarchy.",
   run(e) {
@@ -3453,14 +3476,15 @@ const bi = {
           selector: p(n),
           html: m(n),
           impact: "serious",
-          message: "Paragraph appears to be styled as a heading. Use an h1-h6 element instead."
+          message: "Paragraph appears to be styled as a heading. Use an h1-h6 element instead.",
+          fix: { type: "suggest", suggestion: "Replace the <p> element with the appropriate heading level (h1-h6) based on the document outline. Preserve the text content and move any inline styles to a CSS class on the new heading element." }
         });
       }
     }
     return a;
   }
 };
-function qi(e) {
+function Ei(e) {
   var n, r;
   const a = [], t = e.getAttribute("href");
   t && a.push(`href: ${t}`);
@@ -3477,32 +3501,33 @@ function qi(e) {
   return a.length > 0 ? a.join(`
 `) : void 0;
 }
-const Li = {
+const qi = {
   id: "navigable/link-name",
   category: "navigable",
   actRuleIds: ["c487ae"],
   wcag: ["2.4.4", "4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the link in context to understand its destination, then write descriptive link text.",
   description: "Links must have discernible text via content, aria-label, or aria-labelledby.",
   guidance: "Screen reader users need to know where a link goes. Add descriptive text content, aria-label, or use aria-labelledby. For image links, ensure the image has alt text describing the link destination. Avoid generic text like 'click here' or 'read more'—link text should make sense out of context.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll('a[href], area[href], [role="link"]')) {
-      if (h(t) || q(t) || t.getRootNode() instanceof ShadowRoot) continue;
-      x(t) || a.push({
+      if (h(t) || E(t) || t.getRootNode() instanceof ShadowRoot) continue;
+      w(t) || a.push({
         ruleId: "navigable/link-name",
         selector: p(t),
         html: m(t),
         impact: "serious",
         message: "Link has no discernible text.",
-        context: qi(t),
+        context: Ei(t),
         fix: { type: "add-text-content" }
       });
     }
     return a;
   }
-}, Ei = {
+}, Li = {
   id: "navigable/skip-link",
   category: "navigable",
   wcag: ["2.4.1"],
@@ -3575,19 +3600,19 @@ const Li = {
   description: "Page should not have more than one main landmark.",
   guidance: "Only one main landmark should exist per page. The main landmark identifies the primary content area. If you have multiple content sections, use <section> with appropriate headings instead of multiple main elements.",
   filterTopLevel: !1
-}), Mi = Ke({
+}), Mi = Je({
   id: "landmarks/banner-is-top-level",
   selector: '[role="banner"]',
   landmarkName: "Banner",
   description: "Banner landmark should not be nested within another landmark.",
   guidance: "The banner landmark should be a top-level landmark, not nested inside article, aside, main, nav, or section. If a header is inside these elements, it automatically becomes a generic header rather than a banner. Remove explicit role='banner' from nested headers or restructure the page."
-}), $i = Ke({
+}), $i = Je({
   id: "landmarks/contentinfo-is-top-level",
   selector: '[role="contentinfo"]',
   landmarkName: "Contentinfo",
   description: "Contentinfo landmark should not be nested within another landmark.",
   guidance: "The contentinfo landmark should be a top-level landmark. A footer inside article, aside, main, nav, or section becomes a scoped footer, not a contentinfo landmark. Remove explicit role='contentinfo' from nested footers or move the footer outside sectioning elements."
-}), Di = {
+}), Hi = {
   id: "landmarks/main-is-top-level",
   category: "landmarks",
   wcag: [],
@@ -3610,7 +3635,7 @@ const Li = {
     }
     return a;
   }
-}, Pi = {
+}, Di = {
   id: "landmarks/complementary-is-top-level",
   category: "landmarks",
   wcag: [],
@@ -3633,7 +3658,7 @@ const Li = {
     }
     return a;
   }
-}, Fi = {
+}, Pi = {
   id: "landmarks/landmark-unique",
   category: "landmarks",
   wcag: [],
@@ -3654,7 +3679,7 @@ const Li = {
       if (r.length <= 1) continue;
       const o = /* @__PURE__ */ new Map();
       for (const s of r) {
-        const l = x(s).toLowerCase() || "", d = o.get(l) || [];
+        const l = w(s).toLowerCase() || "", d = o.get(l) || [];
         d.push(s), o.set(l, d);
       }
       for (const [s, l] of o)
@@ -3670,7 +3695,7 @@ const Li = {
     }
     return a;
   }
-}, Hi = {
+}, Fi = {
   id: "landmarks/region",
   category: "landmarks",
   wcag: [],
@@ -3736,13 +3761,13 @@ const Li = {
   }
 }, ji = new Set(
   "aa ab ae af ak am an ar as av ay az ba be bg bh bi bm bn bo br bs ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za zh zu".split(" ")
-), Ui = new Set(
+), Wi = new Set(
   "aar abk afr aka amh ara arg asm ava ave aym aze bak bam bel ben bih bis bod bos bre bul cat ces cha che chu chv cor cos cre cym dan deu div dzo ell eng epo est eus ewe fao fas fij fin fra fry ful gla gle glg glv grn guj hat hau hbs heb her hin hmo hrv hun hye ibo iii iku ile ina ind ipk isl ita jav jpn kal kan kas kat kau kaz khm kik kin kir kom kon kor kua kur lao lat lav lim lin lit ltz lub lug mah mal mar mkd mlg mlt mon mri msa mya nau nav nbl nde ndo nep nld nno nob nor nya oci oji ori orm oss pan pli pol por pus que roh ron run rus sag san sin slk slv sme smo sna snd som sot spa sqi srd srp ssw sun swa swe tah tam tat tel tgk tgl tha tir ton tsn tso tuk tur twi uig ukr urd uzb ven vie vol wln wol xho yid yor zha zho zul".split(" ")
-), Wi = /^[a-z]{2,8}(-[a-z0-9]{1,8})*$/i;
-function Je(e) {
-  if (!Wi.test(e)) return !1;
+), Ui = /^[a-z]{2,8}(-[a-z0-9]{1,8})*$/i;
+function Ke(e) {
+  if (!Ui.test(e)) return !1;
   const a = e.split("-")[0].toLowerCase();
-  return a.length === 2 ? ji.has(a) : a.length === 3 ? !Ui.has(a) : !1;
+  return a.length === 2 ? ji.has(a) : a.length === 3 ? !Wi.has(a) : !1;
 }
 function Ce(e) {
   var i;
@@ -3789,7 +3814,7 @@ const Oi = {
   run(e) {
     var t;
     const a = (t = e.documentElement.getAttribute("lang")) == null ? void 0 : t.trim();
-    return a && !Je(a) ? [{
+    return a && !Ke(a) ? [{
       ruleId: "readable/html-lang-valid",
       selector: "html",
       html: m(e.documentElement),
@@ -3822,7 +3847,7 @@ const Oi = {
         });
         continue;
       }
-      n && Ce(t) && (Je(n) || a.push({
+      n && Ce(t) && (Ke(n) || a.push({
         ruleId: "readable/valid-lang",
         selector: p(t),
         html: m(t),
@@ -3865,13 +3890,14 @@ const Oi = {
   wcag: ["4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the iframe to see what content it displays, then add a title describing its purpose.",
   description: "Frames must have an accessible name.",
   guidance: "Screen readers announce frame titles when users navigate frames. Add a title attribute to <iframe> and <frame> elements that describes the frame's purpose (e.g., <iframe title='Video player'>). Avoid generic titles like 'frame' or 'iframe'. If the frame is decorative, use aria-hidden='true'.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll("iframe, frame")) {
       if (h(t) || Ge(t)) continue;
-      if (!x(t)) {
+      if (!w(t)) {
         const n = t.getAttribute("src");
         a.push({
           ruleId: "labels-and-names/frame-title",
@@ -3941,7 +3967,7 @@ function Xi(e) {
   }
   return "";
 }
-const Ki = [
+const Ji = [
   '[role="checkbox"]',
   '[role="combobox"]',
   '[role="listbox"]',
@@ -3953,7 +3979,7 @@ const Ki = [
   '[role="spinbutton"]',
   '[role="switch"]',
   '[role="textbox"]'
-].join(", "), Ji = /* @__PURE__ */ new Set([
+].join(", "), Ki = /* @__PURE__ */ new Set([
   "checkbox",
   "menuitemcheckbox",
   "menuitemradio",
@@ -3970,8 +3996,8 @@ const Ki = [
 function Zi(e) {
   var o, s, l, d;
   const a = (o = e.getAttribute("role")) == null ? void 0 : o.trim().toLowerCase();
-  if (a && Ji.has(a) || (e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement) && !(a && Qi.has(a)))
-    return x(e);
+  if (a && Ki.has(a) || (e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement) && !(a && Qi.has(a)))
+    return w(e);
   const i = e.getAttribute("aria-labelledby");
   if (i) {
     const c = i.split(/\s+/).map((u) => {
@@ -4001,13 +4027,14 @@ const en = {
   wcag: ["4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the form to see visual label placement relative to the input, then associate them with a label element or aria-labelledby.",
   description: "Form elements must have labels. Use <label>, aria-label, or aria-labelledby.",
   guidance: "Every form input needs an accessible label so users understand what information to enter. Use a <label> element with a for attribute matching the input's id, wrap the input in a <label>, or use aria-label/aria-labelledby for custom components. Placeholders are not sufficient as labels since they disappear when typing. Labels should describe the information requested, not the field type (e.g., 'Email address', 'Search', 'Phone number').",
   run(e) {
     var i;
-    const a = [], t = e.querySelectorAll(`${Qe}, ${Ki}`);
+    const a = [], t = e.querySelectorAll(`${Qe}, ${Ji}`);
     for (const n of t) {
-      if (h(n) || q(n)) continue;
+      if (h(n) || E(n)) continue;
       const r = (i = n.getAttribute("role")) == null ? void 0 : i.trim().toLowerCase();
       if (r === "presentation" || r === "none") continue;
       if (!Zi(n)) {
@@ -4071,6 +4098,7 @@ const en = {
   wcag: ["4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the button to see its visual purpose, then set value or aria-label to describe the action.",
   description: "Input buttons must have discernible text via value, aria-label, or aria-labelledby.",
   guidance: "Input buttons (<input type='submit'>, type='button', type='reset'>) need accessible names so users know what action the button performs. Add a value attribute with descriptive text (e.g., value='Submit Form'), or use aria-label if the value must differ from the accessible name.",
   run(e) {
@@ -4079,9 +4107,9 @@ const en = {
     for (const n of e.querySelectorAll(
       'input[type="submit"], input[type="button"], input[type="reset"]'
     )) {
-      if (h(n) || q(n)) continue;
+      if (h(n) || E(n)) continue;
       const r = (t = n.getAttribute("value")) == null ? void 0 : t.trim(), o = (i = n.getAttribute("type")) == null ? void 0 : i.toLowerCase(), s = (o === "submit" || o === "reset") && !n.hasAttribute("value");
-      !r && !s && !x(n) && a.push({
+      !r && !s && !w(n) && a.push({
         ruleId: "labels-and-names/input-button-name",
         selector: p(n),
         html: m(n),
@@ -4110,16 +4138,17 @@ const nn = {
   level: "A",
   tags: ["best-practice"],
   fixability: "contextual",
+  browserHint: "Screenshot the control to see its visible label, then ensure aria-label starts with that visible text.",
   description: "Interactive elements with visible text must have accessible names that contain that text.",
   guidance: "For voice control users who activate controls by speaking their visible label, the accessible name must include the visible text. If aria-label is 'Submit form' but the button shows 'Send', voice users saying 'click Send' won't activate it. Ensure aria-label/aria-labelledby contains or matches the visible text.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll('button, [role="button"], a[href], input[type="submit"], input[type="button"]')) {
       if (h(t)) continue;
-      const i = x(t);
+      const i = w(t);
       if (!i) continue;
       let n = "";
-      t instanceof HTMLInputElement ? n = t.value || "" : n = Z(t);
+      t instanceof HTMLInputElement ? n = t.value || "" : n = ee(t);
       const r = n.trim();
       if (!r || r.length <= 2) continue;
       const o = t.hasAttribute("aria-label"), s = t.hasAttribute("aria-labelledby");
@@ -4134,13 +4163,13 @@ const nn = {
     }
     for (const t of e.querySelectorAll("input, select, textarea")) {
       if (h(t) || t instanceof HTMLInputElement && ["hidden", "submit", "button", "image"].includes(t.type)) continue;
-      const i = x(t);
+      const i = w(t);
       if (!i || !t.hasAttribute("aria-label")) continue;
       const r = t.id;
       let o = "";
       if (r) {
         const s = e.querySelector(`label[for="${CSS.escape(r)}"]`);
-        s && (o = Z(s));
+        s && (o = ee(s));
       }
       o.trim() && (Ne(i, o) || a.push({
         ruleId: "labels-and-names/label-content-mismatch",
@@ -4192,10 +4221,10 @@ const nn = {
     var t;
     const a = [];
     for (const i of e.querySelectorAll('[role="button"], [role="link"], [role="menuitem"]')) {
-      if (h(i) || q(i) || se(i)) continue;
+      if (h(i) || E(i) || se(i)) continue;
       const n = i.getAttribute("role");
       if ((i.tagName.toLowerCase() === "button" || i.tagName.toLowerCase() === "a") && n !== "menuitem") continue;
-      if (!x(i)) {
+      if (!w(i)) {
         const o = i.querySelector("img[alt]");
         if ((t = o == null ? void 0 : o.getAttribute("alt")) != null && t.trim()) continue;
         a.push({
@@ -4225,13 +4254,13 @@ function M(e) {
       var i;
       const t = [];
       for (const n of a.querySelectorAll(e.selector)) {
-        if (h(n) || e.checkComputedHidden && q(n) || e.checkShadowDOM && se(n)) continue;
+        if (h(n) || e.checkComputedHidden && E(n) || e.checkShadowDOM && se(n)) continue;
         if (e.roleSet) {
           const o = (i = n.getAttribute("role")) == null ? void 0 : i.trim().toLowerCase();
           if (!o || !e.roleSet.has(o)) continue;
         }
         if (e.skipNative && n.matches(e.skipNative)) continue;
-        x(n) || t.push({
+        w(n) || t.push({
           ruleId: e.id,
           selector: p(n),
           html: m(n),
@@ -4331,15 +4360,16 @@ const hn = {
   wcag: ["4.1.2"],
   level: "A",
   fixability: "contextual",
+  browserHint: "Screenshot the button to identify its icon or visual label, then add a matching aria-label.",
   description: "Buttons must have discernible text.",
   guidance: "Screen reader users need to know what a button does. Add visible text content, aria-label, or aria-labelledby. For icon buttons, use aria-label describing the action (e.g., aria-label='Close'). If the button contains an image, ensure the image has alt text describing the button's action.",
   run(e) {
     const a = [];
     for (const t of e.querySelectorAll('button, [role="button"]')) {
-      if (h(t) || q(t)) continue;
+      if (h(t) || E(t)) continue;
       const i = t.getAttribute("role");
       if ((i === "none" || i === "presentation") && !(t.matches('button:not([disabled]), [tabindex]:not([tabindex="-1"])') || t.tagName.toLowerCase() === "button" && !t.disabled) || se(t)) continue;
-      x(t) || a.push({
+      w(t) || a.push({
         ruleId: "labels-and-names/button-name",
         selector: p(t),
         html: m(t),
@@ -4364,7 +4394,7 @@ const hn = {
     const a = [];
     for (const t of e.querySelectorAll("details > summary:first-of-type")) {
       if (h(t)) continue;
-      x(t) || a.push({
+      w(t) || a.push({
         ruleId: "labels-and-names/summary-name",
         selector: p(t),
         html: m(t),
@@ -4612,30 +4642,45 @@ Referenced by: ${d}` : ""}`,
   description: "ARIA attributes must be allowed for the element's role.",
   guidance: "Each ARIA role supports specific attributes. Using unsupported attributes creates confusion for assistive technologies. Check the ARIA specification for which attributes are valid for each role, or remove the attribute if it's not needed.",
   run(e) {
-    const a = [];
-    for (const t of e.querySelectorAll("[role], [aria-*]")) {
-      if (h(t)) continue;
-      const i = j(t);
-      if (!i) continue;
-      const n = Sn[i];
-      if (n)
-        for (const r of t.attributes) {
-          if (!r.name.startsWith("aria-") || ut.has(r.name) || n.has(r.name)) continue;
-          const o = n.size > 0 ? [...n].join(", ") : "none (only global ARIA attributes)";
+    const a = [], t = new Set(e.querySelectorAll("[role]")), i = e.createTreeWalker(
+      e.body || e.documentElement,
+      1
+      /* NodeFilter.SHOW_ELEMENT */
+    );
+    let n = i.currentNode;
+    for (; n; ) {
+      if (n instanceof Element) {
+        for (const r of n.attributes)
+          if (r.name.startsWith("aria-")) {
+            t.add(n);
+            break;
+          }
+      }
+      n = i.nextNode();
+    }
+    for (const r of t) {
+      if (h(r)) continue;
+      const o = W(r);
+      if (!o) continue;
+      const s = Sn[o];
+      if (s)
+        for (const l of r.attributes) {
+          if (!l.name.startsWith("aria-") || ut.has(l.name) || s.has(l.name)) continue;
+          const d = s.size > 0 ? [...s].join(", ") : "none (only global ARIA attributes)";
           a.push({
             ruleId: "aria/aria-allowed-attr",
-            selector: p(t),
-            html: m(t),
+            selector: p(r),
+            html: m(r),
             impact: "critical",
-            message: `ARIA attribute "${r.name}" is not allowed on role "${i}".`,
-            context: `Attribute: ${r.name}="${r.value}", role: ${i}, allowed role-specific attributes: ${o}`,
-            fix: { type: "remove-attribute", attribute: r.name }
+            message: `ARIA attribute "${l.name}" is not allowed on role "${o}".`,
+            context: `Attribute: ${l.name}="${l.value}", role: ${o}, allowed role-specific attributes: ${d}`,
+            fix: { type: "remove-attribute", attribute: l.name }
           });
         }
     }
     return a;
   }
-}, qn = /* @__PURE__ */ new Set([
+}, En = /* @__PURE__ */ new Set([
   "base",
   "col",
   "colgroup",
@@ -4757,10 +4802,10 @@ Referenced by: ${d}` : ""}`,
   video: /* @__PURE__ */ new Set(["application"]),
   wbr: /* @__PURE__ */ new Set(["none", "presentation"])
 };
-function Ln(e) {
+function qn(e) {
   var t;
   const a = e.tagName.toLowerCase();
-  if (qn.has(a))
+  if (En.has(a))
     return "none";
   if (a === "a" && e.hasAttribute("href"))
     return D["a[href]"];
@@ -4772,7 +4817,7 @@ function Ln(e) {
   }
   return D[a] || "any";
 }
-const En = {
+const Ln = {
   id: "aria/aria-allowed-role",
   category: "aria",
   wcag: ["4.1.2"],
@@ -4789,7 +4834,7 @@ const En = {
       if (!n) continue;
       const r = $e(i);
       if (r && n === r) continue;
-      const o = Ln(i);
+      const o = qn(i);
       o === "none" ? a.push({
         ruleId: "aria/aria-allowed-role",
         selector: p(i),
@@ -4864,8 +4909,8 @@ const Mn = {
     const a = [];
     for (const t of e.querySelectorAll('[aria-hidden="true"]')) {
       if (t === e.body) continue;
-      const i = [...t.querySelectorAll(z)];
-      t.matches(z) && i.push(t);
+      const i = [...t.querySelectorAll(j)];
+      t.matches(j) && i.push(t);
       for (const n of i)
         if (n instanceof HTMLElement) {
           const r = n.getAttribute("tabindex");
@@ -4901,14 +4946,14 @@ const Mn = {
   run(e) {
     return le(e).prohibitedAttr;
   }
-}, Dn = [
+}, Hn = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
   "select:not([disabled])",
   "textarea:not([disabled])",
   '[tabindex]:not([tabindex="-1"])'
-].join(", "), Pn = [
+].join(", "), Dn = [
   "aria-atomic",
   "aria-busy",
   "aria-controls",
@@ -4925,15 +4970,15 @@ const Mn = {
 ];
 function Me(e) {
   const a = [];
-  e.matches(Dn) && a.push("element is focusable");
-  for (const t of Pn)
+  e.matches(Hn) && a.push("element is focusable");
+  for (const t of Dn)
     if (e.hasAttribute(t)) {
       a.push(`has ${t}`);
       break;
     }
   return (e.hasAttribute("aria-label") || e.hasAttribute("aria-labelledby")) && a.push("has accessible name"), a;
 }
-const Fn = {
+const Pn = {
   id: "aria/presentation-role-conflict",
   category: "aria",
   actRuleIds: ["46ca7f"],
@@ -4970,7 +5015,7 @@ const Fn = {
     }
     return a;
   }
-}, Hn = /* @__PURE__ */ new Set([
+}, Fn = /* @__PURE__ */ new Set([
   "button",
   "checkbox",
   "img",
@@ -5001,9 +5046,9 @@ const Fn = {
     const a = [];
     for (const t of e.querySelectorAll("*")) {
       if (h(t)) continue;
-      const i = j(t);
-      if (!(!i || !Hn.has(i))) {
-        for (const n of t.querySelectorAll(z))
+      const i = W(t);
+      if (!(!i || !Fn.has(i))) {
+        for (const n of t.querySelectorAll(j))
           if (n !== t && !n.disabled) {
             a.push({
               ruleId: "aria/presentational-children-focusable",
@@ -5021,7 +5066,7 @@ const Fn = {
 }, Ze = [
   // Text Alternatives
   jt,
-  Wt,
+  Ut,
   Ot,
   Vt,
   _t,
@@ -5029,8 +5074,8 @@ const Fn = {
   Yt,
   Xt,
   // Time-based Media
-  Kt,
   Jt,
+  Kt,
   // Adaptable
   na,
   la,
@@ -5046,13 +5091,13 @@ const Fn = {
   Sa,
   Ia,
   // Distinguishable
-  qa,
+  Ea,
   Ra,
   Ca,
   Ta,
-  Pa,
-  Ka,
+  Da,
   Ja,
+  Ka,
   // Keyboard Accessible
   Za,
   ti,
@@ -5073,8 +5118,8 @@ const Fn = {
   ki,
   Si,
   Ii,
+  qi,
   Li,
-  Ei,
   // Landmarks
   Ri,
   Ci,
@@ -5082,10 +5127,10 @@ const Fn = {
   Ni,
   Mi,
   $i,
+  Hi,
   Di,
   Pi,
   Fi,
-  Hi,
   // Readable
   zi,
   Oi,
@@ -5116,43 +5161,48 @@ const Fn = {
   wn,
   kn,
   In,
-  En,
+  Ln,
   Cn,
   Mn,
   $n,
-  Fn,
+  Pn,
   zn
 ];
-let me = [], et = /* @__PURE__ */ new Set(), tt = !1, at = !1, T, H;
+let me = [], et = /* @__PURE__ */ new Set(), tt = !1, at = !1, T, z;
 function Vn(e) {
-  e.additionalRules && (me = e.additionalRules), e.disabledRules && (et = new Set(e.disabledRules)), "includeAAA" in e && (tt = !!e.includeAAA), "componentMode" in e && (at = !!e.componentMode), "locale" in e && (T = e.locale || void 0), H = void 0;
+  e.additionalRules && (me = e.additionalRules), e.disabledRules && (et = new Set(e.disabledRules)), "includeAAA" in e && (tt = !!e.includeAAA), "componentMode" in e && (at = !!e.componentMode), "locale" in e && (T = e.locale || void 0), z = void 0;
 }
 function pe() {
-  if (H) return H;
+  if (z) return z;
   const a = Ze.filter((t) => {
     var i;
     return !(et.has(t.id) || t.level === "AAA" && !tt || at && ((i = t.tags) != null && i.includes("page-level")));
   }).concat(me);
-  return T ? (H = Dt(a, T), H) : a;
+  return T ? (z = Ht(a, T), z) : a;
 }
 function Bn(e) {
   it();
-  const a = pe(), t = T, i = [];
-  let n = 0;
+  const a = pe(), t = T, i = [], n = [];
+  let r = 0;
   return {
-    processChunk(r) {
-      const o = performance.now();
-      for (; n < a.length; ) {
+    processChunk(o) {
+      const s = performance.now();
+      for (; r < a.length; ) {
+        const l = a[r];
         try {
-          i.push(...a[n].run(e));
-        } catch {
+          i.push(...l.run(e));
+        } catch (d) {
+          n.push({ ruleId: l.id, error: d instanceof Error ? d.message : String(d) });
         }
-        if (n++, performance.now() - o >= r) break;
+        if (r++, performance.now() - s >= o) break;
       }
-      return n < a.length;
+      return r < a.length;
     },
     getViolations() {
       return t ? ze(i, t) : i;
+    },
+    getSkippedRules() {
+      return n;
     }
   };
 }
@@ -5160,19 +5210,21 @@ function it() {
   mt(), ot(), st(), kt(), At(), pt();
 }
 function _n(e) {
-  var i;
+  var n;
   it();
-  const a = pe(), t = [];
-  for (const n of a)
+  const a = pe(), t = [], i = [];
+  for (const r of a)
     try {
-      t.push(...n.run(e));
-    } catch {
+      t.push(...r.run(e));
+    } catch (o) {
+      i.push({ ruleId: r.id, error: o instanceof Error ? o.message : String(o) });
     }
   return {
-    url: ((i = e.location) == null ? void 0 : i.href) ?? "",
+    url: ((n = e.location) == null ? void 0 : n.href) ?? "",
     timestamp: Date.now(),
     violations: T ? ze(t, T) : t,
-    ruleCount: a.length
+    ruleCount: a.length,
+    skippedRules: i
   };
 }
 function Gn(e, a) {
@@ -5207,7 +5259,7 @@ const Xn = {
   "enough-time/meta-refresh": { description: "Meta refresh must not redirect or refresh automatically.", guidance: "Automatic page refreshes or redirects can disorient users, especially those using screen readers or with cognitive disabilities. They may lose their place or not have time to read content. If a redirect is needed, use a server-side redirect (HTTP 301/302) instead. For timed refreshes, provide user controls.", messages: { "Page redirects after {0} seconds without warning. Use server-side redirect.": "Page redirects after {0} seconds without warning. Use server-side redirect.", "Page auto-refreshes after {0} seconds. Provide user control over refresh.": "Page auto-refreshes after {0} seconds. Provide user control over refresh." } },
   "enough-time/blink": { description: "The <blink> element must not be used.", guidance: "Blinking content can cause seizures in users with photosensitive epilepsy and is distracting for users with attention disorders. The <blink> element is deprecated and should never be used. If you need to draw attention to content, use less intrusive methods like color, borders, or icons.", messages: { "The <blink> element causes accessibility issues. Remove it entirely.": "The <blink> element causes accessibility issues. Remove it entirely." } },
   "enough-time/marquee": { description: "The <marquee> element must not be used.", guidance: "Scrolling or moving content is difficult for many users to read, especially those with cognitive or visual disabilities. The <marquee> element is deprecated. Replace scrolling text with static content. If content must scroll, provide pause/stop controls and ensure it stops after 5 seconds.", messages: { "The <marquee> element causes accessibility issues. Replace with static content.": "The <marquee> element causes accessibility issues. Replace with static content." } },
-  "text-alternatives/img-alt": { description: `Images must have alternate text. Add an alt attribute to <img> elements. Decorative images may use an empty alt attribute (alt=""), role='none', or role='presentation'.`, guidance: "Every image needs an alt attribute. For informative images, describe the content or function concisely. For decorative images (backgrounds, spacers, purely visual flourishes), use alt='' to hide them from screen readers. Never omit alt entirely—screen readers may read the filename instead.", messages: { 'Image has whitespace-only alt text. Use alt="" for decorative images or provide descriptive text.': 'Image has whitespace-only alt text. Use alt="" for decorative images or provide descriptive text.', "Image element missing alt attribute.": "Image element missing alt attribute.", 'Element with role="img" has no accessible name. Add aria-label or aria-labelledby.': 'Element with role="img" has no accessible name. Add aria-label or aria-labelledby.' } },
+  "text-alternatives/img-alt": { description: `Images must have alternate text. Add an alt attribute to <img> elements. Decorative images may use an empty alt attribute (alt=""), role='none', or role='presentation'.`, guidance: "Every image needs an alt attribute. For informative images, describe the content or function concisely. For decorative images (backgrounds, spacers, purely visual flourishes), use alt='' to hide them from screen readers. Never omit alt entirely—screen readers may read the filename instead. When an image is inside a link or button that already has text, use alt='' if the image is decorative in that context, or write alt text that complements (not duplicates) the existing text.", messages: { 'Image has whitespace-only alt text. Use alt="" for decorative images or provide descriptive text.': 'Image has whitespace-only alt text. Use alt="" for decorative images or provide descriptive text.', "Image element missing alt attribute.": "Image element missing alt attribute.", 'Element with role="img" has no accessible name. Add aria-label or aria-labelledby.': 'Element with role="img" has no accessible name. Add aria-label or aria-labelledby.' } },
   "text-alternatives/svg-img-alt": { description: "SVG elements with an img, graphics-document, or graphics-symbol role must have an accessible name via a <title> element, aria-label, or aria-labelledby.", guidance: "Inline SVGs with role='img' need accessible names. Add a <title> element as the first child of the SVG (screen readers will announce it), or use aria-label on the SVG element. For complex SVGs, use aria-labelledby referencing both a <title> and <desc> element. Decorative SVGs should use aria-hidden='true' instead.", messages: { "{0} with role='{1}' has no accessible name.": "{0} with role='{1}' has no accessible name." } },
   "text-alternatives/input-image-alt": { description: 'Image inputs (<input type="image">) must have alternate text describing the button action.', guidance: "Image buttons (<input type='image'>) act as submit buttons with a custom image. Add alt text via alt, aria-label, or aria-labelledby that describes the action (e.g. alt='Search' or alt='Submit order'), not the image itself. Without it, screen readers announce only 'image' or the filename, giving no clue what the button does.", messages: { "Image input missing alt text.": "Image input missing alt text." } },
   "text-alternatives/image-redundant-alt": { description: "Image alt text should not duplicate adjacent link or button text. When alt text repeats surrounding text, screen reader users hear the same information twice.", guidance: "When an image is inside a link or button that also has text, make the alt text complementary rather than identical. If the image is purely decorative in that context, use alt='' to avoid repetition.", messages: { 'Alt text "{0}" duplicates surrounding {1} text.': 'Alt text "{0}" duplicates surrounding {1} text.' } },
@@ -5290,7 +5342,7 @@ const Xn = {
   "adaptable/orientation-lock": { description: "Page orientation must not be restricted using CSS transforms.", guidance: "Users with motor disabilities may mount their device in a fixed orientation. Using CSS transforms with @media (orientation: portrait/landscape) to rotate content 90° effectively locks the page to one orientation. Remove the orientation-dependent transform and use responsive design instead.", messages: { "CSS locks page orientation via @media (orientation: {0}) with a 90° transform.": "CSS locks page orientation via @media (orientation: {0}) with a 90° transform." } },
   "aria/presentational-children-focusable": { description: "Elements with a role that makes children presentational must not contain focusable content.", guidance: "Roles like button, checkbox, img, tab, and others make their children presentational — hidden from assistive technologies. If those children are focusable, keyboard users can reach elements that screen reader users cannot perceive. Move focusable content outside the parent or remove the focusability.", messages: { 'Focusable element inside a "{0}" role whose children are presentational.': 'Focusable element inside a "{0}" role whose children are presentational.' } },
   "keyboard-accessible/focus-visible": { description: "Elements in sequential focus order must have a visible focus indicator.", guidance: "Keyboard users need to see which element has focus. Do not remove the default focus outline (outline: none) without providing an alternative visible indicator. Use :focus-visible or :focus styles to ensure focus is always perceivable.", messages: { "Focusable element has outline removed without a visible focus alternative.": "Focusable element has outline removed without a visible focus alternative." } }
-}, Kn = {
+}, Jn = {
   "navigable/document-title": { description: "Los documentos deben tener un elemento <title> para proporcionar a los usuarios una vista general del contenido.", guidance: "Los usuarios de lectores de pantalla dependen de los títulos de página para identificar y navegar entre pestañas/ventanas. Agregue un elemento <title> descriptivo en <head> que resuma el propósito de la página. Mantenga los títulos únicos en todo el sitio, colocando el contenido específico antes del nombre del sitio (por ejemplo, 'Contáctenos - Acme Corp').", messages: { "Document <title> element is empty.": "El elemento <title> del documento está vacío.", "Document is missing a <title> element.": "Al documento le falta un elemento <title>." } },
   "navigable/bypass": { description: "La página debe tener un mecanismo para omitir bloques de contenido repetidos.", guidance: 'Los usuarios de teclado deben poder omitir contenido repetitivo como la navegación. Proporcione un enlace de salto en la parte superior de la página que enlace al contenido principal (por ejemplo, <a href="#main">Saltar al contenido principal</a>), o use un landmark <main>. Los lectores de pantalla pueden saltar directamente a los landmarks, por lo que un elemento <main> correctamente marcado satisface este requisito.', messages: { "Page has no mechanism to bypass repeated content. Add a <main> landmark or skip link.": "La página no tiene un mecanismo para omitir contenido repetido. Agregue un landmark <main> o un enlace de salto." } },
   "navigable/page-has-heading-one": { description: "La página debe contener un encabezado de nivel uno.", guidance: "Un encabezado de nivel uno (<h1> o role='heading' con aria-level='1') ayuda a los usuarios a comprender el tema de la página y proporciona un punto de referencia para la navegación con lector de pantalla. Cada página debe tener exactamente un h1 que describa el contenido principal, típicamente coincidiendo o similar al título de la página.", messages: { "Page does not contain a level-one heading.": "La página no contiene un encabezado de nivel uno." } },
@@ -5394,10 +5446,10 @@ export {
   Vn as configureRules,
   Bn as createChunkedAudit,
   Gn as diffAudit,
-  x as getAccessibleName,
+  w as getAccessibleName,
   k as getAccessibleTextContent,
   pe as getActiveRules,
-  j as getComputedRole,
+  W as getComputedRole,
   m as getHtmlSnippet,
   $e as getImplicitRole,
   Yn as getRuleById,
@@ -5405,9 +5457,9 @@ export {
   h as isAriaHidden,
   dt as isValidRole,
   Xn as localeEn,
-  Kn as localeEs,
-  Un as querySelectorShadowAware,
-  Wn as registerLocale,
+  Jn as localeEs,
+  Wn as querySelectorShadowAware,
+  Un as registerLocale,
   Ze as rules,
   _n as runAudit,
   ze as translateViolations,