pour-engine 1.22.0 → 1.24.0

package/config/project.config.js

@@ -6,6 +6,6 @@
 export default {
   engine: {
     name: 'pour engine',
-    version: '1.22.0',
+    version: '1.24.0',
   },
 };

package/engine/lib/accessible-name.js

@@ -143,7 +143,18 @@ function textFromNodes(nodes, includeHidden) {
       continue;
     }
     if (tag === 'img' || tag === 'area') {
-      text += ` ${node.getAttribute('alt') ?? ''} `;
+      // HTML-AAM order for an image's own name: aria-label → alt → title.
+      // A PRESENT-but-empty alt marks the image decorative and contributes
+      // nothing — title must not resurrect it. Only when alt is ABSENT do
+      // the fallbacks apply (a title-only <img> inside a link names the
+      // link; Chromium exposes exactly this, measured on a live site where
+      // the walk's old alt-or-nothing shortcut called a named link nameless).
+      const imgAria = node.getAttribute('aria-label')?.trim();
+      if (imgAria) { text += ` ${imgAria} `; continue; }
+      const alt = node.getAttribute('alt');
+      if (alt !== null) { text += ` ${alt} `; continue; }
+      const imgTitle = node.getAttribute('title')?.trim();
+      if (imgTitle) text += ` ${imgTitle} `;
       continue;
     }
     const ariaLabel = node.getAttribute('aria-label')?.trim();

package/engine/rules/wcag/1.2.2-media-captions.js

@@ -16,6 +16,24 @@ export default {
     if (element.querySelector('track[kind="captions" i], track[kind="subtitles" i], track:not([kind])')) {
       return { status: 'pass' };
     }
+    // A video with no media resource at all presents nothing — there is no
+    // audio content to caption (lazy players before their source is set).
+    if (!element.currentSrc && !element.getAttribute('src') && !element.querySelector('source')) {
+      return { status: 'pass' };
+    }
+    // The decorative no-audio-path signature — the same boundary
+    // video-loop-motion draws for 2.2.2: muted, autoplaying, no controls.
+    // With no controls there is no user path to unmute, so whatever audio
+    // the file may carry is never presented to anyone; audio that cannot be
+    // presented is not audio content under 1.2.2, and asking a human to
+    // verify captions for it is noise (measured on the benchmark corpus:
+    // our own site's aria-hidden hero loops, ffprobe-confirmed to carry no
+    // audio stream, plus the same family on four news/university homes).
+    // Properties, not attributes: script-muted heroes count too. A muted
+    // video WITH controls keeps its review — one click unmutes it.
+    if (element.muted && element.autoplay && !element.controls) {
+      return { status: 'pass' };
+    }
     // Captions may be burned in or provided by the player — a human must check.
     return {
       status: 'incomplete',

package/engine/rules/wcag/1.3.1-aria-required-parent.js

@@ -38,7 +38,19 @@ export default {
         ?? IMPLICIT_CONTAINER[owner.tagName.toLowerCase()]);
       if (ownerRole && containers.includes(ownerRole)) return { status: 'pass' };
     }
-    for (let parent = element.parentElement; parent; parent = parent.parentElement) {
+    // FLAT-TREE ancestry, not light-DOM ancestry: assistive technology sees
+    // the composed tree, so a slotted role="listitem" whose role="list"
+    // container lives inside the host component's shadow root IS inside a
+    // list (Adobe Spectrum's sidenav is exactly this — a light-DOM walk was
+    // 11 false asserts on one page). An element assigned to a slot continues
+    // through the slot's shadow-side ancestors; an element at a shadow root's
+    // top continues through the host.
+    const flatParent = (node) => node.assignedSlot
+      ?? node.parentElement
+      ?? (node.getRootNode() instanceof ShadowRoot ? node.getRootNode().host : null);
+    for (let parent = flatParent(element); parent; parent = flatParent(parent)) {
+      // A <slot> is rendering plumbing with no tree presence of its own.
+      if (parent.tagName === 'SLOT' && !parent.hasAttribute('role')) continue;
       const parentRole =
         parent.getAttribute('role')?.trim().split(/\s+/)[0]?.toLowerCase() ??
         IMPLICIT_CONTAINER[parent.tagName.toLowerCase()];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pour-engine",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Accessibility (WCAG 2.2) audit engine written from the W3C specifications — runs entirely in the browser, no dependencies.",
   "type": "module",
   "main": "engine/index.js",