pour-engine 1.16.0 → 1.17.0

package/config/project.config.js

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

package/engine/rules/wcag/1.3.1-list-structure.js

@@ -52,7 +52,28 @@ export default {
       return !hasStrayText && effectiveChildren(child).every(isValidChild);
     };
     const invalid = effectiveChildren(element).filter((child) => !isValidChild(child));
-    if (!invalid.length) return { status: 'pass' };
+    if (!invalid.length) {
+      // Every rendered item neutralised: role="none" on each <li> strips
+      // its listitem semantics while the <ul> keeps announcing "list" —
+      // Chromium exposes the list role over the none children (measured
+      // 2026-08-09), so readers hear a list that owns zero items around
+      // content they can plainly see. That is the same broken announcement
+      // as <ul><div>, reached via a different door. A PARTIAL
+      // neutralisation stays valid: hiding a decorative separator item
+      // from the count is what role="none" on an <li> is for.
+      const renderedItems = effectiveChildren(element).filter((child) =>
+        child.tagName === 'LI' && (!isRendered || isRendered(child)));
+      const neutralised = renderedItems.filter((child) =>
+        ['presentation', 'none'].includes(child.getAttribute('role') ?? ''));
+      if (renderedItems.length && neutralised.length === renderedItems.length) {
+        return {
+          status: 'fail',
+          message: `Every item in this list carries role="${neutralised[0].getAttribute('role')}", so the list announces itself with zero items while ${renderedItems.length} are visible — screen readers lose the count and the positions.`,
+          fix: 'Remove the role from the <li> elements, or neutralise the whole structure by putting role="presentation" (or the intended widget role) on the list element itself.',
+        };
+      }
+      return { status: 'pass' };
+    }
     const tags = [...new Set(invalid.map((child) => {
       const role = child.getAttribute('role');
       return `<${child.tagName.toLowerCase()}${role ? ` role="${role}"` : ''}>`;

package/engine/rules/wcag/4.1.2-aria-field-name.js

@@ -7,7 +7,11 @@
 // naming counts. Toggle roles (checkbox/radio/switch) DO name from content.
 import { labelledByName } from '../../lib/accessible-name.js';
 
-const AUTHOR_ONLY = ['textbox', 'searchbox', 'combobox', 'listbox', 'spinbutton', 'slider'];
+// progressbar and meter belong here too: ARIA 1.2 marks both roles
+// "Accessible Name Required: True", they never name from content, and a
+// nameless one announces a bare value — "25%, progress bar" — of nothing
+// in particular (found live: unlabelled ant-progress widgets).
+const AUTHOR_ONLY = ['textbox', 'searchbox', 'combobox', 'listbox', 'spinbutton', 'slider', 'progressbar', 'meter'];
 const FROM_CONTENT = ['checkbox', 'radio', 'switch'];
 
 function authorName(element) {
@@ -21,7 +25,7 @@ export default {
   id: 'aria-field-name',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
-  help: 'ARIA form fields must have an accessible name',
+  help: 'ARIA fields and value widgets must have an accessible name',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html',
   selector: [...AUTHOR_ONLY, ...FROM_CONTENT]
     .map((role) => `[role="${role}"]:not(input):not(select):not(textarea)`)
@@ -42,7 +46,7 @@ export default {
     }
     return {
       status: 'fail',
-      message: `This role="${role}" field has no accessible name — screen readers announce the role with no idea what it's for.${
+      message: `This role="${role}" control has no accessible name — screen readers announce the role and value with no idea what it's for.${
         AUTHOR_ONLY.includes(role) ? ' (Content inside it does not count as a name for this role.)' : ''}`,
       fix: 'Add aria-label="…" or aria-labelledby pointing at its visible label.',
     };

package/package.json

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