pour-engine 1.23.0 → 1.24.0

package/config/project.config.js

@@ -6,6 +6,6 @@
 export default {
   engine: {
     name: 'pour engine',
-    version: '1.23.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pour-engine",
-  "version": "1.23.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",