@accesslint/core 0.8.4 → 0.8.7

package/dist/index.js

@@ -1,4 +1,4 @@
-const j = [
+const W = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
@@ -133,7 +133,7 @@ function $e(e) {
       return null;
   }
 }
-function W(e) {
+function j(e) {
   var n;
   const a = K.get(e);
   if (a !== void 0) return a;
@@ -1184,7 +1184,7 @@ function Ae(e) {
   return a.length > 0 ? a.join(`
 `) : void 0;
 }
-const jt = {
+const Wt = {
   id: "text-alternatives/img-alt",
   category: "text-alternatives",
   actRuleIds: ["23a2a8"],
@@ -1229,7 +1229,7 @@ const jt = {
     return a;
   }
 };
-function Wt(e) {
+function jt(e) {
   var i;
   const a = De(e);
   if (a) return a;
@@ -1250,7 +1250,7 @@ const Ut = {
     const a = [], t = 'svg[role="img"], [role="graphics-document"], [role="graphics-symbol"]';
     for (const i of e.querySelectorAll(t)) {
       if (h(i)) continue;
-      if (!Wt(i)) {
+      if (!jt(i)) {
         const o = i.getAttribute("role");
         a.push({
           ruleId: "text-alternatives/svg-img-alt",
@@ -1321,7 +1321,7 @@ const Ut = {
     }
     return a;
   }
-}, Bt = ["image", "picture", "photo", "graphic", "icon", "img"], _t = {
+}, Bt = /^(image|picture|photo|graphic|icon|img)(\s+of\b|\s*[:\u2013\u2014-]|\s*$)/i, _t = {
   id: "text-alternatives/image-alt-words",
   category: "text-alternatives",
   wcag: ["1.1.1"],
@@ -1329,23 +1329,26 @@ const Ut = {
   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.",
+  description: "Image alt text should not start with words like 'image of', 'photo of', or 'picture of' — 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) {
     const a = [];
     for (const t of e.querySelectorAll("img[alt]")) {
-      const i = t.getAttribute("alt").toLowerCase();
+      const i = t.getAttribute("alt").trim();
       if (!i) continue;
-      const n = Bt.filter((o) => i.split(/\s+/).includes(o));
-      n.length > 0 && a.push({
-        ruleId: "text-alternatives/image-alt-words",
-        selector: p(t),
-        html: m(t),
-        impact: "minor",
-        message: `Alt text "${t.getAttribute("alt")}" contains redundant word(s): ${n.join(", ")}.`,
-        context: `Current alt: "${t.getAttribute("alt")}", redundant word(s): ${n.join(", ")}`,
-        fix: { type: "suggest", suggestion: "Remove the redundant word(s) from the alt text; screen readers already announce the element as an image" }
-      });
+      const n = i.match(Bt);
+      if (n) {
+        const o = n[1].toLowerCase();
+        a.push({
+          ruleId: "text-alternatives/image-alt-words",
+          selector: p(t),
+          html: m(t),
+          impact: "minor",
+          message: `Alt text "${i}" starts with redundant prefix "${o}".`,
+          context: `Current alt: "${i}", redundant prefix: "${o}"`,
+          fix: { type: "suggest", suggestion: "Remove the redundant prefix from the alt text; screen readers already announce the element as an image" }
+        });
+      }
     }
     return a;
   }
@@ -1816,10 +1819,10 @@ function ra(e, a, t) {
 const sa = {
   id: "adaptable/list-children",
   selector: "ul, ol",
-  check: { type: "child-invalid", allowedChildren: ["li", "script", "template"], allowedChildRoles: ["listitem"] },
+  check: { type: "child-invalid", allowedChildren: ["li", "script", "template", "style"], allowedChildRoles: ["listitem"] },
   impact: "serious",
   message: "List contains non-<li> child <{{tag}}>.",
-  description: "<ul> and <ol> must only contain <li>, <script>, or <template> as direct children.",
+  description: "<ul> and <ol> must only contain <li>, <script>, <template>, or <style> as direct children.",
   wcag: ["1.3.1"],
   level: "A",
   fixability: "contextual",
@@ -1876,16 +1879,16 @@ const sa = {
 }, ua = {
   id: "adaptable/definition-list",
   selector: "dl",
-  check: { type: "child-invalid", allowedChildren: ["dt", "dd", "div", "script", "template"] },
+  check: { type: "child-invalid", allowedChildren: ["dt", "dd", "div", "script", "template", "style"] },
   impact: "serious",
   message: "<dl> contains invalid child <{{tag}}>.",
-  description: "<dl> elements must only contain <dt>, <dd>, <div>, <script>, or <template>.",
+  description: "<dl> elements must only contain <dt>, <dd>, <div>, <script>, <template>, or <style>.",
   wcag: ["1.3.1"],
   level: "A",
   fixability: "contextual",
   guidance: "Definition lists have strict content requirements. Only <dt> (terms), <dd> (definitions), and <div> (for grouping dt/dd pairs) are valid children. Other elements break the list structure for screen readers. Move invalid elements outside the <dl>, or if they represent a term change to <dt>, if a definition change to <dd>. Styling wrappers should be replaced with <div> elements containing <dt>/<dd> pairs."
 }, ma = N(ua);
-function je(e, a) {
+function We(e, a) {
   switch (a.toLowerCase()) {
     case "deg":
       return e;
@@ -1907,7 +1910,7 @@ function pa(e) {
     /rotate[Z]?\(\s*(-?[\d.]+)(deg|rad|turn|grad)\s*\)/i
   );
   if (a) {
-    const n = je(parseFloat(a[1]), a[2]);
+    const n = We(parseFloat(a[1]), a[2]);
     if (B(n)) return !0;
   }
   const t = e.match(
@@ -1929,7 +1932,7 @@ function pa(e) {
 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]);
+  const t = We(parseFloat(a[1]), a[2]);
   return B(t);
 }
 const ha = {
@@ -2007,14 +2010,14 @@ function fa(e, a) {
   for (const s of e.querySelectorAll("*")) {
     if (h(s)) continue;
     o = !0;
-    const l = W(s);
+    const l = j(s);
     l && n.add(l);
   }
   for (const s of t) {
     const l = i.getElementById(s);
     if (l && !h(l)) {
       o = !0;
-      const d = W(l);
+      const d = j(l);
       d && n.add(d);
     }
   }
@@ -2091,7 +2094,7 @@ const va = {
       const o = Se[n];
       let r = i.parentElement, s = !1;
       for (; r && r !== e.documentElement; ) {
-        const l = W(r);
+        const l = j(r);
         if (l && o.includes(l)) {
           s = !0;
           break;
@@ -2340,7 +2343,7 @@ const ka = {
 function ce(e) {
   return e.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
 }
-function We(e, a) {
+function je(e, a) {
   const t = e.getAttribute("style");
   if (!t) return null;
   const i = new RegExp(
@@ -2446,7 +2449,7 @@ function Be(e, a, t, i) {
   const n = [];
   for (const o of e.querySelectorAll("[style]")) {
     if (h(o) || !Oe(o) || Ve(o) || !de(o, t)) continue;
-    const r = We(o, t);
+    const r = je(o, t);
     if (!r) continue;
     let s = !1;
     if (r.em !== null ? s = r.em < i : r.px !== null && (s = Ue(o, t, r.px, i)), s) {
@@ -2503,7 +2506,7 @@ const Ra = {
         const o = parseFloat(w(t).lineHeight);
         if (o > 0 && t.scrollHeight <= o * 1.5) continue;
       }
-      const i = We(t, "line-height");
+      const i = je(t, "line-height");
       if (!i) continue;
       let n = !1;
       if (i.em !== null ? n = i.em < 1.5 : i.px !== null && (n = Ue(t, "line-height", i.px, 1.5)), n) {
@@ -2668,10 +2671,10 @@ function za(e) {
   }
   return !1;
 }
-function ja(e) {
+function Wa(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 Wa(e, a) {
+function ja(e, a) {
   if (e.tagName !== "LABEL") return !1;
   const t = e, i = t.htmlFor;
   if (i) {
@@ -2787,7 +2790,7 @@ function _e(e, a, t) {
     const l = s.parentElement;
     if (!l || r.has(l) || (r.add(l), Da.has(l.tagName))) continue;
     const d = l.tagName;
-    if (d === "BODY" || d === "HTML" || Ua(l) || ja(l) || Wa(l, e) || Va(l) || za(l)) continue;
+    if (d === "BODY" || d === "HTML" || Ua(l) || Wa(l) || ja(l, e) || Va(l) || za(l)) continue;
     const c = w(l);
     if (parseFloat(c.opacity) === 0) continue;
     const u = Mt(l);
@@ -3065,7 +3068,7 @@ const di = {
       } else
         continue;
       const u = i.getAttribute("tabindex");
-      u !== null && u !== "-1" || i.querySelector(j) || a.push({
+      u !== null && u !== "-1" || i.querySelector(W) || a.push({
         ruleId: "keyboard-accessible/scrollable-region",
         selector: p(i),
         html: m(i),
@@ -3118,7 +3121,7 @@ const di = {
   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(j)) {
+    for (const t of e.querySelectorAll(W)) {
       if (h(t) || !(t instanceof HTMLElement)) continue;
       const i = t.getAttribute("style") || "";
       if (/outline\s*:\s*(none|0)\s*(;|$|!)/i.test(i)) {
@@ -3759,15 +3762,15 @@ const Ei = {
     }
     return [];
   }
-}, ji = new Set(
+}, Wi = 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(" ")
-), Wi = new Set(
+), ji = 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(" ")
 ), 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 ? !Wi.has(a) : !1;
+  return a.length === 2 ? Wi.has(a) : a.length === 3 ? !ji.has(a) : !1;
 }
 function Ce(e) {
   var i;
@@ -4703,7 +4706,7 @@ Referenced by: ${d}` : ""}`,
     }
     for (const o of t) {
       if (h(o)) continue;
-      const r = W(o);
+      const r = j(o);
       if (!r) continue;
       const s = In[r];
       if (s)
@@ -4953,8 +4956,8 @@ const $n = {
     const a = [];
     for (const t of e.querySelectorAll('[aria-hidden="true"]')) {
       if (t === e.body) continue;
-      const i = [...t.querySelectorAll(j)];
-      t.matches(j) && i.push(t);
+      const i = [...t.querySelectorAll(W)];
+      t.matches(W) && i.push(t);
       for (const n of i)
         if (n instanceof HTMLElement) {
           const o = n.getAttribute("tabindex");
@@ -5077,7 +5080,7 @@ const Fn = {
   "spinbutton",
   "switch",
   "tab"
-]), jn = {
+]), Wn = {
   id: "aria/presentational-children-focusable",
   category: "aria",
   actRuleIds: ["307n5z"],
@@ -5090,9 +5093,9 @@ const Fn = {
     const a = [];
     for (const t of e.querySelectorAll("*")) {
       if (h(t)) continue;
-      const i = W(t);
+      const i = j(t);
       if (!(!i || !zn.has(i))) {
-        for (const n of t.querySelectorAll(j))
+        for (const n of t.querySelectorAll(W))
           if (n !== t && !n.disabled && n.getAttribute("tabindex") !== "-1") {
             a.push({
               ruleId: "aria/presentational-children-focusable",
@@ -5109,7 +5112,7 @@ const Fn = {
   }
 }, Ze = [
   // Text Alternatives
-  jt,
+  Wt,
   Ut,
   Ot,
   Vt,
@@ -5212,7 +5215,7 @@ const Fn = {
   $n,
   Hn,
   Fn,
-  jn
+  Wn
 ];
 let me = [], et = /* @__PURE__ */ new Set(), tt = !1, at = !1, T, z;
 function Bn(e) {
@@ -5288,11 +5291,11 @@ function Yn(e, a) {
     n.has(l) || s.push(d);
   return { added: o, fixed: s, unchanged: r };
 }
-const Wn = new Map(Ze.map((e) => [e.id, e]));
+const jn = new Map(Ze.map((e) => [e.id, e]));
 function Xn(e) {
   if (T)
     return pe().find((i) => i.id === e);
-  const a = Wn.get(e);
+  const a = jn.get(e);
   return a || me.find((t) => t.id === e);
 }
 const Jn = {
@@ -5309,7 +5312,7 @@ const Jn = {
   "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.' } },
-  "text-alternatives/image-alt-words": { 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'.", messages: { 'Alt text "{0}" contains redundant word(s): {1}.': 'Alt text "{0}" contains redundant word(s): {1}.' } },
+  "text-alternatives/image-alt-words": { description: "Image alt text should not start with words like 'image of', 'photo of', or 'picture of' — 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'.", messages: { 'Alt text "{0}" contains redundant word(s): {1}.': 'Alt text "{0}" contains redundant word(s): {1}.' } },
   "text-alternatives/area-alt": { description: "Image map <area> elements must have alternative text.", guidance: "Each clickable region in an image map needs alternative text so screen reader users know what the region represents. Add an alt attribute to every <area> element describing its purpose. For complex image maps, consider using alternative approaches like SVG with embedded links, or a list of text links.", messages: { "Image map <area> element is missing alternative text.": "Image map <area> element is missing alternative text." } },
   "text-alternatives/object-alt": { 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.", messages: { "<object> element is missing alternative text. Add aria-label, aria-labelledby, or a title attribute.": "<object> element is missing alternative text. Add aria-label, aria-labelledby, or a title attribute." } },
   "text-alternatives/role-img-alt": { 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.", messages: { "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." } },
@@ -5338,10 +5341,10 @@ const Jn = {
   "landmarks/complementary-is-top-level": { description: "Aside (complementary) landmark should be top-level or directly inside main.", guidance: "The complementary landmark (aside) should be top-level or a direct child of main. Nesting aside deep within other landmarks reduces its discoverability for screen reader users navigating by landmarks.", messages: { "Complementary landmark should be top-level.": "Complementary landmark should be top-level." } },
   "landmarks/landmark-unique": { description: "Landmarks should have unique labels when there are multiple of the same type.", guidance: "When a page has multiple landmarks of the same type (e.g., multiple nav elements), each should have a unique accessible name via aria-label or aria-labelledby. This helps screen reader users distinguish between them (e.g., 'Main navigation' vs 'Footer navigation').", messages: { 'Multiple {0} landmarks have the same label "{1}".': 'Multiple {0} landmarks have the same label "{1}".', "Multiple {0} landmarks have no label. Add unique aria-label attributes.": "Multiple {0} landmarks have no label. Add unique aria-label attributes." } },
   "landmarks/region": { description: "All page content should be contained within landmarks.", guidance: "Screen reader users navigate pages by landmarks. Content outside landmarks is harder to find and understand. Wrap all visible content in appropriate landmarks: <header>, <nav>, <main>, <aside>, <footer>, or <section> with a label. Skip links may exist outside landmarks.", messages: { "Content is not contained within a landmark region.": "Content is not contained within a landmark region." } },
-  "adaptable/list-children": { description: "<ul> and <ol> must only contain <li>, <script>, or <template> as direct children.", guidance: "Screen readers announce list structure ('list with 5 items') based on proper markup. Placing non-<li> elements directly inside <ul> or <ol> breaks this structure. Wrap content in <li> elements, or if you need wrapper divs for styling, apply styles to <li> elements directly and remove the wrapper (e.g., change <ul><div>item</div></ul> to <ul><li>item</li></ul>).", messages: { "List contains non-<li> child <{0}>.": "List contains non-<li> child <{0}>." } },
+  "adaptable/list-children": { description: "<ul> and <ol> must only contain <li>, <script>, <template>, or <style> as direct children.", guidance: "Screen readers announce list structure ('list with 5 items') based on proper markup. Placing non-<li> elements directly inside <ul> or <ol> breaks this structure. Wrap content in <li> elements, or if you need wrapper divs for styling, apply styles to <li> elements directly and remove the wrapper (e.g., change <ul><div>item</div></ul> to <ul><li>item</li></ul>).", messages: { "List contains non-<li> child <{0}>.": "List contains non-<li> child <{0}>." } },
   "adaptable/listitem-parent": { description: "<li> elements must be contained in a <ul>, <ol>, or <menu>.", guidance: "List items (<li>) only have semantic meaning inside a list container (<ul>, <ol>, or <menu>). Without a list parent, screen readers will not announce 'list with N items' or allow users to skip between items using list navigation shortcuts. Wrap <li> elements in the appropriate list container — <ul> for unordered lists, <ol> for ordered/numbered lists.", messages: { "<li> is not contained in a <ul>, <ol>, or <menu>.": "<li> is not contained in a <ul>, <ol>, or <menu>." } },
   "adaptable/dl-children": { description: "<dt> and <dd> elements must be contained in a <dl>.", guidance: "Definition terms (<dt>) and definitions (<dd>) only have semantic meaning inside a definition list (<dl>). Outside of <dl>, they're treated as generic text. Wrap related <dt> and <dd> pairs in a <dl> element to convey the term/definition relationship to assistive technologies.", messages: { "<{0}> is not contained in a <dl>.": "<{0}> is not contained in a <dl>." } },
-  "adaptable/definition-list": { description: "<dl> elements must only contain <dt>, <dd>, <div>, <script>, or <template>.", guidance: "Definition lists have strict content requirements. Only <dt> (terms), <dd> (definitions), and <div> (for grouping dt/dd pairs) are valid children. Other elements break the list structure for screen readers. Move invalid elements outside the <dl>, or if they represent a term change to <dt>, if a definition change to <dd>. Styling wrappers should be replaced with <div> elements containing <dt>/<dd> pairs.", messages: { "<dl> contains invalid child <{0}>.": "<dl> contains invalid child <{0}>." } },
+  "adaptable/definition-list": { description: "<dl> elements must only contain <dt>, <dd>, <div>, <script>, <template>, or <style>.", guidance: "Definition lists have strict content requirements. Only <dt> (terms), <dd> (definitions), and <div> (for grouping dt/dd pairs) are valid children. Other elements break the list structure for screen readers. Move invalid elements outside the <dl>, or if they represent a term change to <dt>, if a definition change to <dd>. Styling wrappers should be replaced with <div> elements containing <dt>/<dd> pairs.", messages: { "<dl> contains invalid child <{0}>.": "<dl> contains invalid child <{0}>." } },
   "aria/aria-roles": { description: "ARIA role values must be valid.", guidance: "Invalid role values are ignored by assistive technologies, meaning the element will not have the intended semantics. Check the spelling and use only roles defined in the WAI-ARIA specification. Common roles include: button, link, navigation, main, dialog, alert, tab, tabpanel, menu, menuitem.", messages: { 'Invalid ARIA role "{0}".': 'Invalid ARIA role "{0}".' } },
   "aria/aria-valid-attr": { description: "ARIA attributes must be valid (correctly spelled).", guidance: "Misspelled ARIA attributes are ignored by assistive technologies. Check the spelling against the WAI-ARIA specification. Common mistakes: aria-labeledby (should be aria-labelledby), aria-role (should be role), aria-description (valid in ARIA 1.3+).", messages: { 'Invalid ARIA attribute "{0}".': 'Invalid ARIA attribute "{0}".' } },
   "aria/aria-valid-attr-value": { description: "ARIA attributes must have valid values.", guidance: "Each ARIA attribute accepts specific value types. Boolean attributes (aria-hidden, aria-disabled) accept only 'true' or 'false'. Tristate attributes (aria-checked, aria-pressed) also accept 'mixed'. Token attributes (aria-live, aria-autocomplete) accept predefined values. ID reference attributes (aria-labelledby, aria-describedby) must reference existing element IDs.", messages: { '{0} must be "true" or "false", got "{1}".': '{0} must be "true" or "false", got "{1}".', '{0} must be "true", "false", or "mixed", got "{1}".': '{0} must be "true", "false", or "mixed", got "{1}".', '{0} must be an integer, got "{1}".': '{0} must be an integer, got "{1}".', '{0} must be a number, got "{1}".': '{0} must be a number, got "{1}".', 'Invalid value "{0}" for {1}.': 'Invalid value "{0}" for {1}.' } },
@@ -5403,7 +5406,7 @@ const Jn = {
   "text-alternatives/svg-img-alt": { description: "Los elementos SVG con rol img, graphics-document o graphics-symbol deben tener un nombre accesible mediante un elemento <title>, aria-label o aria-labelledby.", guidance: "Los SVG en línea con role='img' necesitan nombres accesibles. Agregue un elemento <title> como primer hijo del SVG (los lectores de pantalla lo anunciarán), o use aria-label en el elemento SVG. Para SVGs complejos, use aria-labelledby haciendo referencia tanto a un elemento <title> como a un elemento <desc>. Los SVGs decorativos deben usar aria-hidden='true' en su lugar.", messages: { "{0} with role='{1}' has no accessible name.": "{0} con role='{1}' no tiene nombre accesible." } },
   "text-alternatives/input-image-alt": { description: 'Las entradas de imagen (<input type="image">) deben tener texto alternativo mediante alt, aria-label o aria-labelledby. El texto debe describir la acción del botón, no la imagen.', guidance: "Los botones de imagen (<input type='image'>) deben tener texto alternativo mediante alt, aria-label o aria-labelledby. El texto debe describir la acción del botón, no la imagen.", messages: { "Image input missing alt text.": "A la entrada de imagen le falta texto alt." } },
   "text-alternatives/image-redundant-alt": { description: "El texto alternativo de la imagen no debe duplicar el texto del enlace o botón adyacente. Cuando el texto alt repite el texto circundante, los usuarios de lectores de pantalla escuchan la misma información dos veces.", guidance: "Cuando una imagen está dentro de un enlace o botón que también tiene texto, haga que el texto alt sea complementario en lugar de idéntico. Si la imagen es puramente decorativa en ese contexto, use alt='' para evitar la repetición.", messages: { 'Alt text "{0}" duplicates surrounding {1} text.': 'El texto alt "{0}" duplica el texto del {1} circundante.' } },
-  "text-alternatives/image-alt-words": { description: "El texto alternativo de la imagen no debe contener palabras como 'imagen', 'foto' o 'fotografía': los lectores de pantalla ya anuncian el tipo de elemento.", guidance: "Los lectores de pantalla ya anuncian 'imagen' o 'gráfico' antes de leer el texto alt, por lo que frases como 'imagen de', 'foto de' o 'fotografía de' son redundantes. Elimine estas palabras y describa lo que muestra la imagen. Por ejemplo, cambie 'imagen de un perro' a 'golden retriever jugando a buscar'.", messages: { 'Alt text "{0}" contains redundant word(s): {1}.': 'El texto alt "{0}" contiene palabra(s) redundante(s): {1}.' } },
+  "text-alternatives/image-alt-words": { description: "El texto alternativo de la imagen no debe comenzar con palabras como 'imagen de', 'foto de' o 'fotografía de': los lectores de pantalla ya anuncian el tipo de elemento.", guidance: "Los lectores de pantalla ya anuncian 'imagen' o 'gráfico' antes de leer el texto alt, por lo que frases como 'imagen de', 'foto de' o 'fotografía de' son redundantes. Elimine estas palabras y describa lo que muestra la imagen. Por ejemplo, cambie 'imagen de un perro' a 'golden retriever jugando a buscar'.", messages: { 'Alt text "{0}" contains redundant word(s): {1}.': 'El texto alt "{0}" contiene palabra(s) redundante(s): {1}.' } },
   "text-alternatives/area-alt": { description: "Los elementos <area> del mapa de imagen deben tener texto alternativo.", guidance: "Cada región clicable en un mapa de imagen necesita texto alternativo para que los usuarios de lectores de pantalla sepan qué representa la región. Agregue un atributo alt a cada elemento <area> describiendo su propósito. Para mapas de imagen complejos, considere usar enfoques alternativos como SVG con enlaces incrustados, o una lista de enlaces de texto.", messages: { "Image map <area> element is missing alternative text.": "Al elemento <area> del mapa de imagen le falta texto alternativo." } },
   "text-alternatives/object-alt": { description: "Los elementos <object> deben tener texto alternativo.", guidance: "Los elementos object incrustan contenido externo que puede no ser accesible para todos los usuarios. Proporcione texto alternativo mediante aria-label, aria-labelledby o un atributo title. El contenido de respaldo dentro de <object> solo se muestra cuando el objeto no se carga y no sirve como nombre accesible.", messages: { "<object> element is missing alternative text. Add aria-label, aria-labelledby, or a title attribute.": "Al elemento <object> le falta texto alternativo. Agregue aria-label, aria-labelledby o un atributo title." } },
   "text-alternatives/role-img-alt": { description: "Los elementos con role='img' deben tener un nombre accesible.", guidance: "Cuando asigna role='img' a un elemento (como un div que contiene fuentes de iconos o fondos CSS), debe proporcionar un nombre accesible mediante aria-label o aria-labelledby. Sin esto, los usuarios de lectores de pantalla no tienen forma de entender lo que representa la imagen. Si la imagen es decorativa, use role='presentation' o role='none' en su lugar.", messages: { "Element with role='img' has no accessible name. Add aria-label or aria-labelledby.": "El elemento con role='img' no tiene nombre accesible. Agregue aria-label o aria-labelledby." } },
@@ -5432,10 +5435,10 @@ const Jn = {
   "landmarks/complementary-is-top-level": { description: "El landmark aside (complementary) debe ser de nivel superior o estar directamente dentro de main.", guidance: "El landmark complementary (aside) debe ser de nivel superior o un hijo directo de main. Anidar aside profundamente dentro de otros landmarks reduce su descubrimiento para los usuarios de lectores de pantalla que navegan por landmarks.", messages: { "Complementary landmark should be top-level.": "El landmark complementary debe ser de nivel superior." } },
   "landmarks/landmark-unique": { description: "Los landmarks deben tener etiquetas únicas cuando hay múltiples del mismo tipo.", guidance: "Cuando una página tiene múltiples landmarks del mismo tipo (por ejemplo, múltiples elementos nav), cada uno debe tener un nombre accesible único mediante aria-label o aria-labelledby. Esto ayuda a los usuarios de lectores de pantalla a distinguirlos (por ejemplo, 'Navegación principal' vs 'Navegación del pie de página').", messages: { 'Multiple {0} landmarks have the same label "{1}".': 'Múltiples landmarks {0} tienen la misma etiqueta "{1}".', "Multiple {0} landmarks have no label. Add unique aria-label attributes.": "Múltiples landmarks {0} no tienen etiqueta. Agregue atributos aria-label únicos." } },
   "landmarks/region": { description: "Todo el contenido de la página debe estar contenido dentro de landmarks.", guidance: "Los usuarios de lectores de pantalla navegan las páginas por landmarks. El contenido fuera de los landmarks es más difícil de encontrar y comprender. Envuelva todo el contenido visible en landmarks apropiados: <header>, <nav>, <main>, <aside>, <footer>, o <section> con una etiqueta. Los enlaces de salto pueden existir fuera de los landmarks.", messages: { "Content is not contained within a landmark region.": "El contenido no está contenido dentro de una región landmark." } },
-  "adaptable/list-children": { description: "<ul> y <ol> solo deben contener <li>, <script> o <template> como hijos directos.", guidance: "Los lectores de pantalla anuncian la estructura de la lista ('lista con 5 elementos') basándose en el marcado correcto. Colocar elementos que no son <li> directamente dentro de <ul> u <ol> rompe esta estructura. Envuelva el contenido en elementos <li>, o si necesita divs envolventes para el estilo, aplique los estilos a los elementos <li> directamente y elimine el envoltorio (por ejemplo, cambie <ul><div>item</div></ul> a <ul><li>item</li></ul>).", messages: { "List contains non-<li> child <{0}>.": "La lista contiene un hijo no <li>: <{0}>." } },
+  "adaptable/list-children": { description: "<ul> y <ol> solo deben contener <li>, <script>, <template> o <style> como hijos directos.", guidance: "Los lectores de pantalla anuncian la estructura de la lista ('lista con 5 elementos') basándose en el marcado correcto. Colocar elementos que no son <li> directamente dentro de <ul> u <ol> rompe esta estructura. Envuelva el contenido en elementos <li>, o si necesita divs envolventes para el estilo, aplique los estilos a los elementos <li> directamente y elimine el envoltorio (por ejemplo, cambie <ul><div>item</div></ul> a <ul><li>item</li></ul>).", messages: { "List contains non-<li> child <{0}>.": "La lista contiene un hijo no <li>: <{0}>." } },
   "adaptable/listitem-parent": { description: "Los elementos <li> deben estar contenidos en un <ul>, <ol> o <menu>.", guidance: "Los elementos de lista (<li>) solo tienen significado semántico dentro de un contenedor de lista (<ul>, <ol> o <menu>). Fuera de estos contenedores, las tecnologías de asistencia no pueden transmitir la relación de lista. Envuelva los elementos <li> en el contenedor de lista apropiado.", messages: { "<li> is not contained in a <ul>, <ol>, or <menu>.": "<li> no está contenido en un <ul>, <ol> o <menu>." } },
   "adaptable/dl-children": { description: "Los elementos <dt> y <dd> deben estar contenidos en un <dl>.", guidance: "Los términos de definición (<dt>) y las definiciones (<dd>) solo tienen significado semántico dentro de una lista de definiciones (<dl>). Fuera de <dl>, se tratan como texto genérico. Envuelva los pares relacionados de <dt> y <dd> en un elemento <dl> para transmitir la relación término/definición a las tecnologías de asistencia.", messages: { "<{0}> is not contained in a <dl>.": "<{0}> no está contenido en un <dl>." } },
-  "adaptable/definition-list": { description: "Los elementos <dl> solo deben contener <dt>, <dd>, <div>, <script> o <template>.", guidance: "Las listas de definiciones tienen requisitos estrictos de contenido. Solo <dt> (términos), <dd> (definiciones) y <div> (para agrupar pares dt/dd) son hijos válidos. Otros elementos rompen la estructura de la lista para los lectores de pantalla. Mueva los elementos inválidos fuera del <dl>, o si representan un término cámbielos a <dt>, si son una definición cámbielos a <dd>. Los envoltorios de estilo deben reemplazarse con elementos <div> que contengan pares <dt>/<dd>.", messages: { "<dl> contains invalid child <{0}>.": "<dl> contiene un hijo inválido <{0}>." } },
+  "adaptable/definition-list": { description: "Los elementos <dl> solo deben contener <dt>, <dd>, <div>, <script>, <template> o <style>.", guidance: "Las listas de definiciones tienen requisitos estrictos de contenido. Solo <dt> (términos), <dd> (definiciones) y <div> (para agrupar pares dt/dd) son hijos válidos. Otros elementos rompen la estructura de la lista para los lectores de pantalla. Mueva los elementos inválidos fuera del <dl>, o si representan un término cámbielos a <dt>, si son una definición cámbielos a <dd>. Los envoltorios de estilo deben reemplazarse con elementos <div> que contengan pares <dt>/<dd>.", messages: { "<dl> contains invalid child <{0}>.": "<dl> contiene un hijo inválido <{0}>." } },
   "aria/aria-roles": { description: "Los valores de rol ARIA deben ser válidos.", guidance: "Los valores de rol inválidos son ignorados por las tecnologías de asistencia, lo que significa que el elemento no tendrá la semántica prevista. Verifique la ortografía y use solo roles definidos en la especificación WAI-ARIA. Los roles comunes incluyen: button, link, navigation, main, dialog, alert, tab, tabpanel, menu, menuitem.", messages: { 'Invalid ARIA role "{0}".': 'Rol ARIA inválido "{0}".' } },
   "aria/aria-valid-attr": { description: "Los atributos ARIA deben ser válidos (correctamente escritos).", guidance: "Los atributos ARIA mal escritos son ignorados por las tecnologías de asistencia. Verifique la ortografía contra la especificación WAI-ARIA. Errores comunes: aria-labeledby (debe ser aria-labelledby), aria-role (debe ser role), aria-description (válido en ARIA 1.3+).", messages: { 'Invalid ARIA attribute "{0}".': 'Atributo ARIA inválido "{0}".' } },
   "aria/aria-valid-attr-value": { description: "Los atributos ARIA deben tener valores válidos.", guidance: "Cada atributo ARIA acepta tipos de valores específicos. Los atributos booleanos (aria-hidden, aria-disabled) aceptan solo 'true' o 'false'. Los atributos triestado (aria-checked, aria-pressed) también aceptan 'mixed'. Los atributos de token (aria-live, aria-autocomplete) aceptan valores predefinidos. Los atributos de referencia de ID (aria-labelledby, aria-describedby) deben referenciar IDs de elementos existentes.", messages: { '{0} must be "true" or "false", got "{1}".': '{0} debe ser "true" o "false", se obtuvo "{1}".', '{0} must be "true", "false", or "mixed", got "{1}".': '{0} debe ser "true", "false" o "mixed", se obtuvo "{1}".', '{0} must be an integer, got "{1}".': '{0} debe ser un entero, se obtuvo "{1}".', '{0} must be a number, got "{1}".': '{0} debe ser un número, se obtuvo "{1}".', 'Invalid value "{0}" for {1}.': 'Valor inválido "{0}" para {1}.' } },
@@ -5497,7 +5500,7 @@ export {
   x as getAccessibleName,
   k as getAccessibleTextContent,
   pe as getActiveRules,
-  W as getComputedRole,
+  j as getComputedRole,
   m as getHtmlSnippet,
   $e as getImplicitRole,
   Xn as getRuleById,

package/dist/rules/text-alternatives/image-alt-words.d.ts

@@ -1,9 +1,9 @@
 import type { Rule } from "../types";
 /**
- * Checks if alt text contains self-referential words like "image" or "photo".
- * Screen readers already announce "image"/"graphic" before alt text, so these
- * words are redundant.  Separate from image-redundant-alt because axe-core
- * does not have an equivalent check.
+ * Checks if alt text starts with a self-referential prefix like "image of"
+ * or "photo:". Screen readers already announce "image"/"graphic" before alt
+ * text, so these prefixes are redundant.  Separate from image-redundant-alt
+ * because axe-core does not have an equivalent check.
  */
 export declare const imageAltWords: Rule;
 //# sourceMappingURL=image-alt-words.d.ts.map

package/dist/rules/text-alternatives/image-alt-words.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-alt-words.d.ts","sourceRoot":"","sources":["../../../src/rules/text-alternatives/image-alt-words.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAKrC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,IAiC3B,CAAC"}
+{"version":3,"file":"image-alt-words.d.ts","sourceRoot":"","sources":["../../../src/rules/text-alternatives/image-alt-words.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAerC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,IAkC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accesslint/core",
-  "version": "0.8.4",
+  "version": "0.8.7",
   "description": "Pure accessibility rule engine — WCAG audit with zero browser dependencies",
   "type": "module",
   "main": "./dist/index.cjs",