pour-engine 1.29.0 → 1.30.0

package/README.md

@@ -21,10 +21,6 @@ can verify are returned as a `manualReview` checklist instead of being
 silently skipped, and findings the engine can't judge conclusively land in
 `incomplete` rather than being guessed at.
 
-An experimental WCAG 3.0 draft mode (`engine/wcag30-draft.js`) reframes
-results against the draft's guidelines — clearly stamped as a draft, because
-no tool can honestly claim conformance to an unfinished standard.
-
 ## Getting started
 
 ```sh
@@ -39,7 +35,6 @@ const results = await run(document, {
   // optional: filter rules by tag. Tags are cumulative — WCAG 2.2 AA means
   // every A/AA rule from 2.0 through 2.2. Omit to run everything.
   tags: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22a', 'wcag22aa'],
-  // standard: 'wcag30-draft', // optional: experimental WCAG 3.0 draft mode
 });
 
 console.log(results.violations, results.passes, results.incomplete);
@@ -89,7 +84,7 @@ static HTML strings. For Node-based testing, drive it through a real browser
   (`1.1.1-image-alt.js`), plus the catalog index.
 - `engine/lib/` — shared helpers: DOM traversal, accessible-name
   computation, contrast math, role model.
-- `engine/wcag22.js`, `engine/wcag30-draft.js` — the WCAG catalogs.
+- `engine/wcag22.js` — the WCAG catalog.
 - `config/project.config.js` — package-local stand-in for the pour
   monorepo's project config (engine name + version only).
 

package/config/project.config.js

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

package/engine/index.js

@@ -4,7 +4,6 @@
 import config from '../config/project.config.js';
 import rules from './rules/index.js';
 import wcagCatalog from './wcag22.js';
-import wcag30Draft from './wcag30-draft.js';
 import { isVisible, isRendered, cssPath, htmlSnippet, ownText, collectRoots } from './lib/dom.js';
 import { accessibleName } from './lib/accessible-name.js';
 import { resetAuditCaches } from './lib/contrast.js';
@@ -79,16 +78,11 @@ function toResultNode(element, outcome) {
 /**
  * Run the audit.
  * @param {Document|Element} context - what to scan
- * @param {{ tags?: string[], exclude?: string, standard?: string, signal?: AbortSignal }} options -
+ * @param {{ tags?: string[], exclude?: string, signal?: AbortSignal }} options -
  *   rule selection by tag (wcag2a…wcag22aa, best-practice), empty selects
  *   every rule; exclude is a CSS selector — elements matching it, or inside
  *   a match (including across shadow boundaries), are left out of every
- *   rule; standard 'wcag30-draft' reframes the report against the WCAG 3.0
- *   Working Draft (results.standard is stamped draft, the manual checklist
- *   becomes the draft guidelines, and each rule result carries the draft
- *   guideline it maps to) — the rules themselves stay WCAG 2.x, which is
- *   the only honest claim a tool can make about a draft;
- *   signal aborts the run between rules (throws AbortError)
+ *   rule; signal aborts the run between rules (throws AbortError)
  * @param {(progress: object) => void} [onProgress] - called before each rule
  *   starts ({rule, running}), during a rule at each renderer yield with a
  *   fractional done (completed rules + this rule's evaluated-element share,
@@ -97,17 +91,15 @@ function toResultNode(element, outcome) {
  */
 export async function run(context = document, options = {}, onProgress) {
   const auditStarted = performance.now();
-  const draft30 = options.standard === 'wcag30-draft';
   const results = {
     testEngine: { name, version },
     timestamp: new Date().toISOString(),
     url: context.location?.href ?? context.ownerDocument?.location?.href ?? '',
-    standard: draft30 ? wcag30Draft.draftInfo : null,
     violations: [],
     passes: [],
     incomplete: [],
     inapplicable: [],
-    manualReview: draft30 ? wcag30Draft.manualReviewChecklist() : manualReviewCriteria(options.tags),
+    manualReview: manualReviewCriteria(options.tags),
     ruleTimings: [],
   };
 
@@ -223,17 +215,15 @@ export async function run(context = document, options = {}, onProgress) {
 
     const ruleResult = {
       id: rule.id,
+      // Human display name ("Form field labels"); the id stays the
+      // machine handle everywhere (selectors, exports, docs anchors).
+      name: rule.name ?? rule.id,
       impact: rule.impact,
       tags: rule.tags,
       help: rule.help,
       description: rule.help,
       helpUrl: rule.helpUrl,
     };
-    if (draft30) {
-      // Which draft guideline this 2.x rule speaks to (null for rules with
-      // no draft counterpart, e.g. best-practice extras).
-      ruleResult.wcag30 = wcag30Draft.guidelineForTags(rule.tags);
-    }
     if (!elements.length) results.inapplicable.push({ ...ruleResult, nodes: [] });
     if (buckets.fail.length) results.violations.push({ ...ruleResult, nodes: buckets.fail });
     if (buckets.incomplete.length) results.incomplete.push({ ...ruleResult, nodes: buckets.incomplete });
@@ -252,6 +242,15 @@ export async function run(context = document, options = {}, onProgress) {
       ms,
       counts: { ...liveCounts },
       typeCounts: { ...liveTypeCounts },
+      // The completed rule's actual findings, so a UI can BUILD its list
+      // as rules finish rather than delivering everything at the end.
+      // Present only when the rule found something.
+      ...(buckets.fail.length || buckets.incomplete.length ? {
+        findings: {
+          ...(buckets.fail.length ? { violation: { ...ruleResult, nodes: buckets.fail } } : {}),
+          ...(buckets.incomplete.length ? { incomplete: { ...ruleResult, nodes: buckets.incomplete } } : {}),
+        },
+      } : {}),
     });
   }
 

package/engine/rules/best-practice/accesskeys.js

@@ -1,5 +1,6 @@
 export default {
   id: 'accesskeys',
+  name: 'Duplicate access keys',
   impact: 'serious',
   tags: ['best-practice'],
   help: 'The same accesskey must not be assigned twice',

package/engine/rules/best-practice/button-type.js

@@ -1,5 +1,6 @@
 export default {
   id: 'button-type',
+  name: 'Button types in forms',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'Buttons inside forms should declare their type',

package/engine/rules/best-practice/empty-heading.js

@@ -1,5 +1,6 @@
 export default {
   id: 'empty-heading',
+  name: 'Empty headings',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'Headings must contain text',

package/engine/rules/best-practice/fieldset-legend.js

@@ -3,6 +3,7 @@
 import { labelledByName } from '../../lib/accessible-name.js';
 export default {
   id: 'fieldset-legend',
+  name: 'Grouped field labels',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'Radio and checkbox groups should be grouped with a label',

package/engine/rules/best-practice/heading-order.js

@@ -5,6 +5,7 @@ const level = (el) =>
 
 export default {
   id: 'heading-order',
+  name: 'Heading order',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'Headings should step down one level at a time',

package/engine/rules/best-practice/landmark-one-main.js

@@ -1,5 +1,6 @@
 export default {
   id: 'landmark-one-main',
+  name: 'One main landmark',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'The page should have exactly one main landmark',

package/engine/rules/best-practice/landmark-top-level.js

@@ -22,6 +22,7 @@ function landmarkAncestor(element) {
 
 export default {
   id: 'landmark-top-level',
+  name: 'Top-level landmarks',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'banner, main and contentinfo landmarks must be top level',

package/engine/rules/best-practice/landmark-unique.js

@@ -22,6 +22,7 @@ const landmarkName = (element) =>
 
 export default {
   id: 'landmark-unique',
+  name: 'Distinguishable landmarks',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'Landmarks of the same type need distinguishing labels',

package/engine/rules/best-practice/multiple-labels.js

@@ -5,6 +5,7 @@
 // pair usually reads better as label + aria-describedby.
 export default {
   id: 'multiple-labels',
+  name: 'Multiple labels',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'Form fields should not have multiple labels',

package/engine/rules/best-practice/new-window-link.js

@@ -4,6 +4,7 @@ const MENTIONS_NEW_WINDOW = /new (window|tab)|opens? in/i;
 
 export default {
   id: 'new-window-link',
+  name: 'New-window warnings',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'Links opening a new window should say so',

package/engine/rules/best-practice/no-autofocus.js

@@ -1,5 +1,6 @@
 export default {
   id: 'no-autofocus',
+  name: 'Autofocus on load',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'autofocus disorients assistive-technology users',

package/engine/rules/best-practice/page-heading-one.js

@@ -1,5 +1,6 @@
 export default {
   id: 'page-heading-one',
+  name: 'Leading page heading',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'Every page should start its outline with an <h1>',

package/engine/rules/best-practice/positive-tabindex.js

@@ -1,5 +1,6 @@
 export default {
   id: 'positive-tabindex',
+  name: 'Positive tabindex',
   impact: 'serious',
   tags: ['best-practice'],
   help: 'Positive tabindex values disrupt the natural focus order',

package/engine/rules/best-practice/redundant-alt-phrase.js

@@ -5,6 +5,7 @@ const REDUNDANT_PHRASE = /^(image|picture|graphic|icon)\b( of\b)?/i;
 
 export default {
   id: 'redundant-alt-phrase',
+  name: 'Redundant alt phrasing',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'alt text should not start with "image of" or similar',

package/engine/rules/best-practice/redundant-aria-label.js

@@ -11,6 +11,7 @@ const NAME_FROM_CONTENT = new Set(['button', 'link', 'menuitem', 'menuitemcheckb
 
 export default {
   id: 'redundant-aria-label',
+  name: 'Redundant aria-label',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'aria-label should not repeat the visible text',

package/engine/rules/best-practice/redundant-aria.js

@@ -10,6 +10,7 @@ const NATIVE_PAIRS = [
 
 export default {
   id: 'redundant-aria',
+  name: 'Redundant ARIA attributes',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'aria attributes should not duplicate native HTML attributes',

package/engine/rules/best-practice/redundant-image-alt.js

@@ -1,5 +1,6 @@
 export default {
   id: 'redundant-image-alt',
+  name: 'Redundant image alt',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'Image alt should not repeat adjacent link or button text',

package/engine/rules/best-practice/redundant-role.js

@@ -28,6 +28,7 @@ function implicitRole(element) {
 
 export default {
   id: 'redundant-role',
+  name: 'Redundant roles',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'role attributes should not repeat the element’s built-in role',

package/engine/rules/best-practice/redundant-tabindex.js

@@ -1,5 +1,6 @@
 export default {
   id: 'redundant-tabindex',
+  name: 'Redundant tabindex',
   impact: 'minor',
   tags: ['best-practice'],
   help: 'tabindex="0" is unnecessary on natively focusable elements',

package/engine/rules/best-practice/region.js

@@ -6,6 +6,7 @@ const LANDMARK =
 
 export default {
   id: 'region',
+  name: 'Content outside landmarks',
   impact: 'moderate',
   tags: ['best-practice'],
   help: 'All readable content belongs inside a landmark region',

package/engine/rules/wcag/1.1.1-area-alt.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.1.1 Non-text Content (Level A) · SC 2.4.4 Link Purpose (In Context) (Level A)
 export default {
   id: 'area-alt',
+  name: 'Image map alt text',
   impact: 'critical',
   tags: ['wcag2a', 'wcag111', 'wcag244'],
   help: 'Image map areas must have alternative text',

package/engine/rules/wcag/1.1.1-canvas-alt.js

@@ -15,6 +15,7 @@
 // matters.
 export default {
   id: 'canvas-alt',
+  name: 'Canvas accessible name',
   impact: 'moderate',
   tags: ['wcag2a', 'wcag111'],
   help: 'Meaningful <canvas> graphics need an accessible name or fallback',

package/engine/rules/wcag/1.1.1-embed-alt.js

@@ -11,6 +11,7 @@
 // is, but no criterion provably fails.
 export default {
   id: 'embed-alt',
+  name: 'Embed accessible name',
   impact: 'serious',
   tags: ['wcag2a', 'wcag111'],
   help: '<embed> needs an accessible name',

package/engine/rules/wcag/1.1.1-image-alt.js

@@ -10,6 +10,7 @@ const GENERIC_ALT = /^(image|img|photo|photograph|picture|graphic|icon|untitled|
 
 export default {
   id: 'image-alt',
+  name: 'Image alt text',
   impact: 'critical',
   tags: ['wcag2a', 'wcag111'],
   help: 'Every <img> needs a text alternative',

package/engine/rules/wcag/1.1.1-input-image-alt.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.1.1 Non-text Content (Level A) · SC 4.1.2 Name, Role, Value (Level A)
 export default {
   id: 'input-image-alt',
+  name: 'Image button alt text',
   impact: 'critical',
   tags: ['wcag2a', 'wcag111', 'wcag412'],
   help: 'Image inputs need alt text describing their action',

package/engine/rules/wcag/1.1.1-object-alt.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.1.1 Non-text Content (Level A)
 export default {
   id: 'object-alt',
+  name: 'Object alt text',
   impact: 'serious',
   tags: ['wcag2a', 'wcag111'],
   help: '<object> embeds must have a text alternative',

package/engine/rules/wcag/1.1.1-svg-img-alt.js

@@ -3,6 +3,7 @@ import { labelledByName } from '../../lib/accessible-name.js';
 
 export default {
   id: 'svg-img-alt',
+  name: 'SVG accessible name',
   impact: 'serious',
   tags: ['wcag2a', 'wcag111'],
   help: 'Inline SVG and role="img" graphics need an accessible name',

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

@@ -1,6 +1,7 @@
 // WCAG SC 1.2.2 Captions (Prerecorded) (Level A)
 export default {
   id: 'media-captions',
+  name: 'Video captions',
   impact: 'critical',
   tags: ['wcag2a', 'wcag122'],
   help: 'Video content must have captions',
@@ -21,17 +22,23 @@ export default {
     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
+    // The decorative no-audio-path signature: muted with 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).
+    // HOW playback starts is deliberately not part of the signature: an
+    // earlier autoplay condition missed the two other members of the same
+    // family, measured on our own site — a crossfade B-roll take that only
+    // ever plays via script (no autoplay attribute, so the review fired
+    // exactly when the script had wired its src), and heroes whose
+    // autoplay attribute a reduced-motion handler removes. Muteness and
+    // controls decide whether audio can reach anyone; autoplay never did.
     // 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) {
+    if (element.muted && !element.controls) {
       return { status: 'pass' };
     }
     // Captions may be burned in or provided by the player — a human must check.

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

@@ -47,6 +47,7 @@ function candidateDescendants(element) {
 
 export default {
   id: 'aria-required-children',
+  name: 'Required ARIA children',
   impact: 'critical',
   tags: ['wcag2a', 'wcag131'],
   help: 'Composite ARIA roles must contain their required children',

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

@@ -20,6 +20,7 @@ const IMPLICIT_CONTAINER = { ul: 'list', ol: 'list', menu: 'list', table: 'table
 
 export default {
   id: 'aria-required-parent',
+  name: 'Required ARIA parent',
   impact: 'critical',
   tags: ['wcag2a', 'wcag131'],
   help: 'ARIA child roles must be inside their required container role',

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

@@ -3,6 +3,7 @@ const ALLOWED = new Set(['DT', 'DD', 'DIV', 'SCRIPT', 'TEMPLATE']);
 
 export default {
   id: 'definition-list',
+  name: 'Definition list structure',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: '<dl> must be structured as term/description pairs',

package/engine/rules/wcag/1.3.1-dlitem-parent.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.3.1 Info and Relationships (Level A)
 export default {
   id: 'dlitem-parent',
+  name: 'Definition item placement',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: '<dt> and <dd> must be inside a <dl>',

package/engine/rules/wcag/1.3.1-form-label.js

@@ -6,6 +6,7 @@ import { labelledByName } from '../../lib/accessible-name.js';
 
 export default {
   id: 'form-label',
+  name: 'Form field labels',
   impact: 'critical',
   tags: ['wcag2a', 'wcag131', 'wcag332', 'wcag412'],
   help: 'Every form field needs a label',

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

@@ -8,6 +8,7 @@ const ITEM_ROLES = ['listitem', 'presentation', 'none'];
 
 export default {
   id: 'list-structure',
+  name: 'List structure',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: 'Lists must only contain list items',

package/engine/rules/wcag/1.3.1-listitem-parent.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.3.1 Info and Relationships (Level A)
 export default {
   id: 'listitem-parent',
+  name: 'List item placement',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: '<li> must be inside a list',

package/engine/rules/wcag/1.3.1-p-as-heading.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.3.1 Info and Relationships (Level A)
 export default {
   id: 'p-as-heading',
+  name: 'Styled text as heading',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: 'Bold paragraphs should not stand in for headings',

package/engine/rules/wcag/1.3.1-table-headers.js

@@ -9,6 +9,7 @@
 // better than false positives on real pages.
 export default {
   id: 'table-headers',
+  name: 'Table header associations',
   impact: 'serious',
   tags: ['wcag2a', 'wcag131'],
   help: 'Data tables must have properly associated header cells',

package/engine/rules/wcag/1.3.4-orientation.js

@@ -46,6 +46,7 @@ function scanRules(rules, insideOrientation, findings) {
 
 export default {
   id: 'orientation-lock',
+  name: 'Orientation lock',
   impact: 'serious',
   tags: ['wcag21aa', 'wcag134'],
   help: 'Content must work in both portrait and landscape',

package/engine/rules/wcag/1.3.5-autocomplete-valid.js

@@ -16,6 +16,7 @@ const TOKENS = new Set([
 
 export default {
   id: 'autocomplete-valid',
+  name: 'Autocomplete tokens',
   impact: 'serious',
   tags: ['wcag21aa', 'wcag135'],
   help: 'autocomplete attributes must use valid tokens',

package/engine/rules/wcag/1.4.1-link-in-text-block.js

@@ -3,6 +3,7 @@ import { parseColor, contrastRatio } from '../../lib/contrast.js';
 
 export default {
   id: 'link-in-text-block',
+  name: 'Link distinction in text',
   impact: 'serious',
   tags: ['wcag2a', 'wcag141'],
   help: 'Links inside text must be distinguishable by more than colour',

package/engine/rules/wcag/1.4.10-reflow.js

@@ -6,6 +6,7 @@
 // and images are exempt content the geometry can't distinguish.
 export default {
   id: 'reflow',
+  name: 'Content reflow',
   impact: 'moderate',
   tags: ['wcag21aa', 'wcag1410'],
   help: 'Content should reflow to one-dimensional scrolling',

package/engine/rules/wcag/1.4.11-non-text-contrast.js

@@ -10,6 +10,7 @@ import { parseColor, contrastRatio, composite, effectiveBackground, showRatio }
 
 export default {
   id: 'non-text-contrast',
+  name: 'Control & icon contrast',
   impact: 'serious',
   tags: ['wcag21aa', 'wcag1411'],
   help: 'Form fields and icons need a 3:1 visible boundary',

package/engine/rules/wcag/1.4.12-text-spacing.js

@@ -16,6 +16,7 @@ const clipped = (element) =>
 
 export default {
   id: 'text-spacing',
+  name: 'Text spacing overrides',
   impact: 'serious',
   tags: ['wcag21aa', 'wcag1412'],
   help: 'Text must survive user spacing overrides without being cut off',

package/engine/rules/wcag/1.4.2-audio-control.js

@@ -1,6 +1,7 @@
 // WCAG SC 1.4.2 Audio Control (Level A)
 export default {
   id: 'audio-control',
+  name: 'Auto-playing audio control',
   impact: 'critical',
   tags: ['wcag2a', 'wcag142'],
   help: 'Auto-playing audio must be stoppable or muted',

package/engine/rules/wcag/1.4.3-color-contrast.js

@@ -916,6 +916,7 @@ export function createContrastRule({ id, tags, help, helpUrl, thresholds }) {
 
 export default createContrastRule({
   id: 'color-contrast',
+  name: 'Text contrast',
   tags: ['wcag2aa', 'wcag143'],
   help: 'Text must have sufficient contrast against its background',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html',

package/engine/rules/wcag/1.4.3-control-contrast.js

@@ -9,6 +9,7 @@ import {
 
 export default {
   id: 'control-contrast',
+  name: 'Form control contrast',
   impact: 'serious',
   tags: ['wcag2aa', 'wcag143'],
   help: 'Text inside form controls must have sufficient contrast',

package/engine/rules/wcag/1.4.4-meta-viewport.js

@@ -3,6 +3,7 @@ import { isEmbeddedDocument } from '../../lib/dom.js';
 
 export default {
   id: 'meta-viewport',
+  name: 'Viewport zoom lock',
   impact: 'critical',
   tags: ['wcag2aa', 'wcag144'],
   help: 'The viewport must let users zoom to at least 200%',

package/engine/rules/wcag/1.4.6-contrast-enhanced.js

@@ -4,6 +4,7 @@ import { createContrastRule } from './1.4.3-color-contrast.js';
 
 export default createContrastRule({
   id: 'color-contrast-enhanced',
+  name: 'Enhanced text contrast',
   tags: ['wcag2aaa', 'wcag146'],
   help: 'Text must have enhanced contrast against its background (AAA)',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/contrast-enhanced.html',

package/engine/rules/wcag/2.1.1-scrollable-region-focusable.js

@@ -43,6 +43,7 @@ function hasTabbableContent(node) {
 
 export default {
   id: 'scrollable-region-focusable',
+  name: 'Keyboard-reachable scroll areas',
   impact: 'serious',
   tags: ['wcag2a', 'wcag211', 'wcag213'], // 2.1.3 is 2.1.1's AAA twin — same check satisfies both
   help: 'Scrollable regions must be reachable by keyboard',

package/engine/rules/wcag/2.2.1-meta-refresh.js

@@ -1,6 +1,7 @@
 // WCAG SC 2.2.1 Timing Adjustable (Level A)
 export default {
   id: 'meta-refresh',
+  name: 'Timed page refresh',
   impact: 'critical',
   tags: ['wcag2a', 'wcag221'],
   help: 'The page must not use a timed refresh',

package/engine/rules/wcag/2.2.2-pause-stop-hide.js

@@ -79,6 +79,7 @@ function endlesslyMoving(doc) {
 
 export default {
   id: 'pause-stop-hide',
+  name: 'Pausable moving content',
   impact: 'serious',
   tags: ['wcag2a', 'wcag222'],
   help: 'Moving content must be pausable',

package/engine/rules/wcag/2.2.2-video-loop-motion.js

@@ -15,6 +15,7 @@
 // abstaining, not clearing.
 export default {
   id: 'video-loop-motion',
+  name: 'Looping video control',
   impact: 'serious',
   tags: ['wcag2a', 'wcag222'],
   help: 'Looping autoplay video must be pausable',

package/engine/rules/wcag/2.4.1-bypass-blocks.js

@@ -3,6 +3,7 @@ import { collectRoots, isEmbeddedDocument } from '../../lib/dom.js';
 
 export default {
   id: 'bypass-blocks',
+  name: 'Skip to content',
   impact: 'serious',
   tags: ['wcag2a', 'wcag241'],
   help: 'The page must offer a way to skip repeated blocks',

package/engine/rules/wcag/2.4.11-focus-not-obscured.js

@@ -31,6 +31,7 @@ function edgeReserved(doc, edge, needed) {
 
 export default {
   id: 'focus-not-obscured',
+  name: 'Unobscured focus',
   impact: 'serious',
   tags: ['wcag22aa', 'wcag2411'],
   help: 'Focused elements must not be fully hidden behind overlays',

package/engine/rules/wcag/2.4.2-document-title.js

@@ -32,6 +32,7 @@ const UNDESCRIPTIVE = new Set([
 
 export default {
   id: 'document-title',
+  name: 'Page title',
   impact: 'serious',
   tags: ['wcag2a', 'wcag242'],
   help: 'The page must have a title that describes its topic or purpose',

package/engine/rules/wcag/2.4.3-visual-order-divergence.js

@@ -48,6 +48,7 @@ function visualSequence(entries, rightToLeft) {
 
 export default {
   id: 'visual-order-divergence',
+  name: 'Focus order vs visual order',
   impact: 'moderate',
   tags: ['wcag2a', 'wcag243'],
   help: 'CSS reordering should not make Tab jump against the visual order',

package/engine/rules/wcag/2.4.4-link-name.js

@@ -1,6 +1,7 @@
 // WCAG SC 2.4.4 Link Purpose (In Context) (Level A) · SC 4.1.2 Name, Role, Value (Level A)
 export default {
   id: 'link-name',
+  name: 'Link names',
   impact: 'serious',
   tags: ['wcag2a', 'wcag244', 'wcag412'],
   help: 'Links must have an accessible name',

package/engine/rules/wcag/2.4.4-link-text-generic.js

@@ -78,6 +78,7 @@ export function createLinkPurposeRule({ id, impact, tags, help, helpUrl, verdict
 
 export default createLinkPurposeRule({
   id: 'link-text-generic',
+  name: 'Generic link text',
   impact: 'moderate',
   tags: ['wcag2a', 'wcag244'],
   help: 'Link text should describe where the link goes',

package/engine/rules/wcag/2.4.7-focus-visible.js

@@ -52,6 +52,7 @@ function focusSuppressors(doc) {
 
 export default {
   id: 'focus-visible',
+  name: 'Visible focus',
   impact: 'serious',
   tags: ['wcag2aa', 'wcag247'],
   help: 'Keyboard focus must remain visible',

package/engine/rules/wcag/2.4.9-link-text-generic-only.js

@@ -14,6 +14,7 @@ import { createLinkPurposeRule } from './2.4.4-link-text-generic.js';
 
 export default createLinkPurposeRule({
   id: 'link-text-generic-only',
+  name: 'Self-sufficient link text',
   impact: 'moderate',
   tags: ['wcag2aaa', 'wcag249'],
   help: 'Link text alone must identify where the link goes (AAA)',

package/engine/rules/wcag/2.5.3-label-in-name.js

@@ -71,6 +71,7 @@ function visibleText(nodes) {
 
 export default {
   id: 'label-in-name',
+  name: 'Label in accessible name',
   impact: 'serious',
   tags: ['wcag21a', 'wcag253'],
   help: 'The visible label must be part of the accessible name',

package/engine/rules/wcag/2.5.5-target-size-enhanced.js

@@ -6,6 +6,7 @@ import { createTargetSizeRule } from './2.5.8-target-size.js';
 
 export default createTargetSizeRule({
   id: 'target-size-enhanced',
+  name: 'Enhanced target size',
   tags: ['wcag2aaa', 'wcag255'],
   help: 'Interactive targets must be at least 44×44 pixels (AAA)',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/target-size-enhanced.html',

package/engine/rules/wcag/2.5.8-target-size.js

@@ -467,6 +467,7 @@ export function createTargetSizeRule({ id, tags, help, helpUrl, min, spacingExce
 
 export default createTargetSizeRule({
   id: 'target-size',
+  name: 'Target size',
   tags: ['wcag22aa', 'wcag258'],
   help: 'Interactive targets must be at least 24×24 pixels',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html',

package/engine/rules/wcag/3.1.1-html-lang.js

@@ -12,6 +12,7 @@ const LANG_PATTERN = /^([a-zA-Z]{2,3}(-[a-zA-Z0-9]{1,8})*|[xXiI](-[a-zA-Z0-9]{1,
 
 export default {
   id: 'html-lang',
+  name: 'Page language',
   impact: 'serious',
   tags: ['wcag2a', 'wcag311'],
   help: 'The <html> element must declare a valid language',

package/engine/rules/wcag/3.1.2-valid-lang-parts.js

@@ -6,6 +6,7 @@ const LANG_PATTERN = /^([a-zA-Z]{2,3}(-[a-zA-Z0-9]{1,8})*|[xXiI](-[a-zA-Z0-9]{1,
 
 export default {
   id: 'valid-lang-parts',
+  name: 'Part language tags',
   impact: 'serious',
   tags: ['wcag2aa', 'wcag312'],
   help: 'lang attributes on page parts must be valid',

package/engine/rules/wcag/3.2.2-on-input-navigation.js

@@ -20,6 +20,7 @@ const NAVIGATES = /\blocation\s*(=|\.\s*(href|assign|replace|reload))|\.(submit|
 
 export default {
   id: 'on-input-navigation',
+  name: 'Unexpected context change',
   impact: 'serious',
   tags: ['wcag2a', 'wcag322', 'wcag321'],
   help: 'Changing or focusing a control must not unexpectedly change context',

package/engine/rules/wcag/3.3.1-error-message-linkage.js

@@ -25,6 +25,7 @@
 // value except false/undefined — "spelling" and "grammar" count.
 export default {
   id: 'error-message-linkage',
+  name: 'Error message linkage',
   impact: 'serious',
   tags: ['wcag2a', 'wcag331'],
   help: 'Fields marked invalid need their error described in text',

package/engine/rules/wcag/3.3.8-auth-field-obstruction.js

@@ -13,6 +13,7 @@
 // case worth asserting.
 export default {
   id: 'auth-field-obstruction',
+  name: 'Accessible login fields',
   impact: 'serious',
   tags: ['wcag22aa', 'wcag338'],
   help: 'Login fields must not block paste or password managers',

package/engine/rules/wcag/4.1.2-aria-allowed-attr.js

@@ -39,6 +39,7 @@ const HANDLED_ELSEWHERE = new Set(['label', 'labelledby']);
 
 export default {
   id: 'aria-allowed-attr',
+  name: 'Allowed ARIA attributes',
   impact: 'moderate',
   tags: ['wcag2a', 'wcag412'],
   help: 'ARIA attributes must be supported by the element’s role',

package/engine/rules/wcag/4.1.2-aria-attr-valid.js

@@ -24,6 +24,7 @@ const ENUMS = {
 
 export default {
   id: 'aria-attr-valid',
+  name: 'Valid ARIA values',
   impact: 'critical',
   tags: ['wcag2a', 'wcag412'],
   help: 'aria attributes must exist and have valid values',

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

@@ -23,6 +23,7 @@ function authorName(element) {
 
 export default {
   id: 'aria-field-name',
+  name: 'ARIA field names',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'ARIA fields and value widgets must have an accessible name',

package/engine/rules/wcag/4.1.2-aria-hidden-focus.js

@@ -6,6 +6,7 @@ const FOCUSABLE = 'a[href], area[href], button, input, select, textarea, summary
 
 export default {
   id: 'aria-hidden-focus',
+  name: 'Focusable hidden content',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Nothing focusable may sit inside aria-hidden="true"',

package/engine/rules/wcag/4.1.2-aria-label-misuse.js

@@ -42,6 +42,7 @@ const NAME_FROM_CONTENT = 'a[href], button, summary, h1, h2, h3, h4, h5, h6, th,
 
 export default {
   id: 'aria-label-misuse',
+  name: 'aria-label placement',
   impact: 'moderate',
   tags: ['wcag2a', 'wcag412'],
   help: 'aria-label on a plain container is prohibited by ARIA, so its announcement is not guaranteed',

package/engine/rules/wcag/4.1.2-aria-valid-refs.js

@@ -107,6 +107,7 @@ function outcome({ missing, ambiguous }, probed, element, accessibleName) {
 
 export default {
   id: 'aria-valid-refs',
+  name: 'ARIA id references',
   // Moderate, not critical: with 4.1.1 Parsing retired in WCAG 2.2 these
   // are 4.1.2 name/state defects, and aria-controls in particular has weak
   // assistive-technology support — real, but rarely blocking.

package/engine/rules/wcag/4.1.2-button-name.js

@@ -1,6 +1,7 @@
 // WCAG SC 4.1.2 Name, Role, Value (Level A)
 export default {
   id: 'button-name',
+  name: 'Button names',
   impact: 'critical',
   tags: ['wcag2a', 'wcag412'],
   help: 'Buttons must have an accessible name',

package/engine/rules/wcag/4.1.2-composite-widget-name.js

@@ -10,6 +10,7 @@
 // where the binary, assertable failure lives.
 export default {
   id: 'composite-widget-name',
+  name: 'Widget item names',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Tabs, menu items, options and tree items need an accessible name',

package/engine/rules/wcag/4.1.2-dialog-name.js

@@ -8,6 +8,7 @@ import { labelledByName } from '../../lib/accessible-name.js';
 
 export default {
   id: 'dialog-name',
+  name: 'Dialog names',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Dialogs must have an accessible name',

package/engine/rules/wcag/4.1.2-frame-title.js

@@ -1,6 +1,7 @@
 // WCAG SC 4.1.2 Name, Role, Value (Level A)
 export default {
   id: 'frame-title',
+  name: 'Frame titles',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Frames must have a title describing their content',

package/engine/rules/wcag/4.1.2-label-for-valid.js

@@ -3,6 +3,7 @@ const LABELABLE = 'input, select, textarea, button, meter, output, progress';
 
 export default {
   id: 'label-for-valid',
+  name: 'Label target references',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'label[for] must reference a form control that exists',

package/engine/rules/wcag/4.1.2-nested-interactive.js

@@ -8,6 +8,7 @@ const INTERACTIVE =
 
 export default {
   id: 'nested-interactive',
+  name: 'Nested controls',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'A control must not contain another control',

package/engine/rules/wcag/4.1.2-role-required-aria.js

@@ -11,6 +11,7 @@ const REQUIRED = {
 
 export default {
   id: 'role-required-aria',
+  name: 'Required role states',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Some roles require a state attribute to work',

package/engine/rules/wcag/4.1.2-summary-name.js

@@ -11,6 +11,7 @@
 // label ("Details").
 export default {
   id: 'summary-name',
+  name: 'Disclosure names',
   impact: 'serious',
   tags: ['wcag2a', 'wcag412'],
   help: 'Disclosure controls (<summary>) need an accessible name',

package/engine/rules/wcag/4.1.2-valid-role.js

@@ -24,6 +24,7 @@ const VALID_ROLES = new Set([
 
 export default {
   id: 'valid-role',
+  name: 'Valid roles',
   impact: 'critical',
   tags: ['wcag2a', 'wcag412'],
   help: 'role attributes must use valid ARIA roles',

package/package.json

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

package/engine/wcag30-draft.js

@@ -1,149 +0,0 @@
-// The WCAG 3.0 guideline catalog — derived from the W3C Working DRAFT of
-// 3 March 2026 (https://www.w3.org/TR/wcag-3.0/). WCAG 3.0 is a work in
-// progress: the W3C says it "may be updated, replaced, or obsoleted" and it
-// is not appropriate for conformance claims. Everything this module exports
-// is therefore marked draft, and every UI that shows it must say so.
-//
-// The draft has no A/AA/AAA levels and no success criteria; it organizes
-// outcome-style guidelines (with core/supplemental requirements below them)
-// under twelve functional groups. Our automated rules are written against
-// WCAG 2.x; `scToGuideline` maps each 2.x criterion we automate to the
-// draft guideline that covers the same user need, judged by reading both
-// specs side by side. Revisit the mapping with every new draft.
-
-export const draftInfo = {
-  id: 'wcag30-draft',
-  name: 'WCAG 3.0',
-  status: 'W3C Working Draft',
-  dated: '2026-03-03',
-  draft: true,
-  url: 'https://www.w3.org/TR/wcag-3.0/',
-  note: 'A draft under active development: findings are WCAG 2.x rule results mapped to draft guidelines. Not suitable for conformance claims.',
-};
-
-const g = (num, name, group, anchor) => ({
-  num,
-  name,
-  group,
-  url: `https://www.w3.org/TR/wcag-3.0/#${anchor}`,
-});
-
-// All 44 guidelines of the 2026-03-03 draft, in document order.
-export const guidelines = [
-  // 2.1 Images and media
-  g('2.1.1', 'Image alternatives', 'Images and media', 'image-alternatives'),
-  g('2.1.2', 'Media alternatives', 'Images and media', 'media-alternatives'),
-  g('2.1.3', 'Non-text alternatives', 'Images and media', 'non-text-alternatives'),
-  g('2.1.4', 'Captions', 'Images and media', 'captions'),
-  g('2.1.5', 'Audio descriptions', 'Images and media', 'audio-descriptions'),
-  g('2.1.6', 'Figure captions', 'Images and media', 'figure-captions'),
-  g('2.1.7', 'Single sense', 'Images and media', 'single-sense'),
-  // 2.2 Text and wording
-  g('2.2.1', 'Text appearance', 'Text and wording', 'text-appearance'),
-  g('2.2.2', 'Text-to-speech', 'Text and wording', 'text-to-speech'),
-  g('2.2.3', 'Clear language', 'Text and wording', 'clear-language'),
-  // 2.3 Interactive components
-  g('2.3.1', 'Keyboard focus appearance', 'Interactive components', 'keyboard-focus-appearance'),
-  g('2.3.2', 'Pointer focus appearance', 'Interactive components', 'pointer-focus-appearance'),
-  g('2.3.3', 'Navigating content', 'Interactive components', 'navigating-content'),
-  g('2.3.4', 'Expected behavior', 'Interactive components', 'expected-behavior'),
-  g('2.3.5', 'Control information', 'Interactive components', 'control-information'),
-  // 2.4 Input / operation
-  g('2.4.1', 'Keyboard interface input', 'Input and operation', 'keyboard-interface-input'),
-  g('2.4.2', 'Physical or cognitive effort when using keyboard', 'Input and operation', 'physical-or-cognitive-effort-when-using-keyboard'),
-  g('2.4.3', 'Pointer input', 'Input and operation', 'pointer-input'),
-  g('2.4.4', 'Speech and voice input', 'Input and operation', 'speech-and-voice-input'),
-  g('2.4.5', 'Input operation', 'Input and operation', 'input-operation-0'),
-  g('2.4.6', 'Authentication', 'Input and operation', 'authentication'),
-  // 2.5 Error handling
-  g('2.5.1', 'Correct errors', 'Error handling', 'correct-errors'),
-  g('2.5.2', 'Prevent errors', 'Error handling', 'prevent-errors'),
-  // 2.6 Animation and movement
-  g('2.6.1', 'Avoid physical harm', 'Animation and movement', 'avoid-physical-harm'),
-  // 2.7 Layout
-  g('2.7.1', 'Recognizable layouts', 'Layout', 'recognizable-layouts'),
-  g('2.7.2', 'User orientation', 'Layout', 'user-orientation'),
-  g('2.7.3', 'Structure', 'Layout', 'structure'),
-  g('2.7.4', 'No obstruction', 'Layout', 'no-obstruction'),
-  // 2.8 Consistency across views
-  g('2.8.1', 'Consistency', 'Consistency across views', 'consistency'),
-  // 2.9 Process and task completion
-  g('2.9.1', 'Avoid exclusionary cognitive tasks', 'Process and task completion', 'avoid-exclusionary-cognitive-tasks'),
-  g('2.9.2', 'Adequate time', 'Process and task completion', 'adequate-time'),
-  g('2.9.3', 'Avoid deception', 'Process and task completion', 'avoid-deception'),
-  g('2.9.4', 'Retain information', 'Process and task completion', 'retain-information'),
-  g('2.9.5', 'Complete tasks', 'Process and task completion', 'complete-tasks'),
-  g('2.9.6', 'Unnecessary steps', 'Process and task completion', 'unnecessary-steps'),
-  // 2.10 Policy and protection
-  g('2.10.1', 'Risk', 'Policy and protection', 'risk'),
-  g('2.10.2', 'Algorithms', 'Policy and protection', 'algorithms'),
-  // 2.11 Help and feedback
-  g('2.11.1', 'Help available', 'Help and feedback', 'help-available'),
-  g('2.11.2', 'Feedback', 'Help and feedback', 'feedback'),
-  // 2.12 User control
-  g('2.12.1', 'Assistive technology control', 'User control', 'assistive-technology-control'),
-  g('2.12.2', 'Control text', 'User control', 'control-text'),
-  g('2.12.3', 'Adjustable viewport', 'User control', 'adjustable-viewport'),
-  g('2.12.4', 'Media control', 'User control', 'media-control'),
-  g('2.12.5', 'Content changes', 'User control', 'content-changes'),
-];
-
-// WCAG 2.x criterion (as tagged on rules: wcag111 = SC 1.1.1) → the draft
-// guideline covering the same user need. Only criteria with automated rules
-// appear; the judgment is ours, made by reading both documents.
-export const scToGuideline = {
-  111: '2.1.1',  // Non-text Content → Image alternatives
-  122: '2.1.4',  // Captions (Prerecorded) → Captions
-  131: '2.7.3',  // Info and Relationships → Structure
-  135: '2.4.5',  // Identify Input Purpose → Input operation
-  141: '2.2.1',  // Use of Color (links in text) → Text appearance
-  142: '2.12.4', // Audio Control → Media control
-  143: '2.2.1',  // Contrast (Minimum) → Text appearance
-  144: '2.12.3', // Resize Text (viewport zoom) → Adjustable viewport
-  146: '2.2.1',  // Contrast (Enhanced) → Text appearance
-  211: '2.4.1',  // Keyboard → Keyboard interface input
-  221: '2.9.2',  // Timing Adjustable → Adequate time
-  222: '2.12.4', // Pause, Stop, Hide → Media control
-  241: '2.3.3',  // Bypass Blocks → Navigating content
-  242: '2.7.2',  // Page Titled → User orientation
-  244: '2.3.5',  // Link Purpose (In Context) → Control information
-  255: '2.4.3',  // Target Size (Enhanced) → Pointer input
-  258: '2.4.3',  // Target Size (Minimum) → Pointer input
-  311: '2.2.2',  // Language of Page → Text-to-speech
-  312: '2.2.2',  // Language of Parts → Text-to-speech
-  332: '2.3.5',  // Labels or Instructions → Control information
-  412: '2.12.1', // Name, Role, Value → Assistive technology control
-};
-
-const guidelineByNum = new Map(guidelines.map((entry) => [entry.num, entry]));
-const partlyAutomated = new Set(Object.values(scToGuideline));
-
-/** The draft guideline (num/name/group/url) a rule's wcagNNN tag maps to. */
-export function guidelineForTags(tags) {
-  for (const tag of tags ?? []) {
-    const sc = tag.match(/^wcag(\d{3,4})$/)?.[1];
-    if (sc && scToGuideline[sc]) return guidelineByNum.get(scToGuideline[sc]);
-  }
-  return null;
-}
-
-/**
- * The whole draft as a review checklist. Every guideline is listed — the
- * draft is too young for any of it to be silently skipped — shaped like the
- * 2.2 manual-review entries so existing UIs render it unchanged: `level` has
- * no meaning in the draft (no conformance levels yet) and `principle`
- * carries the draft's functional group.
- */
-export function manualReviewChecklist() {
-  return guidelines.map(({ num, name, group, url }) => ({
-    num,
-    name,
-    level: 'draft',
-    principle: group,
-    url,
-    automation: partlyAutomated.has(num) ? 'partial' : 'manual',
-    draft: true,
-  }));
-}
-
-export default { draftInfo, guidelines, scToGuideline, guidelineForTags, manualReviewChecklist };