pour-engine 1.28.0 → 1.30.0

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

@@ -6,8 +6,108 @@ const REF_ATTRIBUTES = [
   'aria-activedescendant', 'aria-owns', 'aria-errormessage', 'aria-details',
 ];
 
+// Deferred-tooltip pattern: libraries (Deque's own docs component included)
+// write aria-describedby="tooltip7" at rest and only CREATE #tooltip7 when
+// the trigger is hovered or focused — which is exactly when a screen reader
+// announces the description, so the pattern works. Only DESCRIPTIVE refs
+// get this benefit of the doubt: a NAME that exists only on hover is broken
+// for rotor navigation even when the deferral works, so aria-labelledby
+// (and the rest) keep failing at rest.
+const PROBEABLE = new Set(['aria-describedby', 'aria-details']);
+// A handful of probes covers any real page; a template bug that dangles
+// fifty refs is broken enough that the un-probed remainder failing as
+// before is the right answer.
+const PROBE_BUDGET = 8;
+const PROBE_WAIT_MS = 250;
+
+/** Fire the events a tooltip library listens for, wait for it to react,
+ *  check whether the ids materialised, then put the page back. */
+async function probeDeferred(element, ids) {
+  const over = ['pointerover', 'mouseover', 'mouseenter'];
+  const out = ['pointerout', 'mouseout', 'mouseleave'];
+  for (const type of over) element.dispatchEvent(new MouseEvent(type, { bubbles: type !== 'mouseenter' }));
+  element.dispatchEvent(new FocusEvent('focusin', { bubbles: true }));
+  try { element.focus?.({ preventScroll: true }); } catch { /* non-focusable */ }
+  await new Promise((resolve) => setTimeout(resolve, PROBE_WAIT_MS));
+  const root = element.getRootNode();
+  const appeared = ids.every((id) => root.getElementById?.(id));
+  // Restore: the audit must leave the page as it found it, and later rules
+  // must not meet a tooltip that only exists because we hovered.
+  for (const type of out) element.dispatchEvent(new MouseEvent(type, { bubbles: type !== 'mouseleave' }));
+  element.dispatchEvent(new FocusEvent('focusout', { bubbles: true }));
+  try { element.blur?.(); } catch { /* ignore */ }
+  await new Promise((resolve) => setTimeout(resolve, 50));
+  return appeared;
+}
+
+function inspect(element) {
+  // ARIA id references cannot cross shadow boundaries: they resolve only
+  // within the element's own root (document or shadow tree).
+  const root = element.getRootNode();
+  // Collapsed-disclosure pattern: a trigger with aria-expanded="false"
+  // whose aria-controls panel doesn't exist YET (rendered on expand) is
+  // ubiquitous and harmless while collapsed — name computation doesn't
+  // touch aria-controls, so nothing resolves wrongly today.
+  const collapsed = element.getAttribute('aria-expanded') === 'false';
+  const missing = [];
+  const ambiguous = [];
+  for (const attr of REF_ATTRIBUTES) {
+    for (const id of (element.getAttribute(attr) ?? '').split(/\s+/).filter(Boolean)) {
+      if (!root.getElementById?.(id)) {
+        if (attr === 'aria-controls' && collapsed) continue;
+        missing.push({ attr, id });
+        continue;
+      }
+      const count = root.querySelectorAll(`[id="${CSS.escape(id)}"]`).length;
+      if (count > 1) {
+        ambiguous.push(`${attr}="${id}" — ${count} elements share this id; the reference binds to the FIRST one in the DOM`);
+      }
+    }
+  }
+  return { missing, ambiguous };
+}
+
+function outcome({ missing, ambiguous }, probed, element, accessibleName) {
+  if (missing.length) {
+    // A dangling ref is skipped by the accname computation, so the HARM
+    // depends on what remains. A labelledby that dangles while the element
+    // still names itself (contents, aria-label) is inert clutter — real,
+    // fragile, validator-flagged, but announced correctly today. The same
+    // dangle on an otherwise nameless element is the 4.1.2 failure proper:
+    // names are consumed at REST (element lists, rotor), so the finding
+    // says which of the two this is instead of one blanket accusation.
+    const restingName = (accessibleName?.(element) ?? '').trim();
+    const detail = missing
+      .map(({ attr, id }) => {
+        if (attr === 'aria-labelledby') {
+          return restingName
+            ? `aria-labelledby="${id}" points to nothing — the reference is ignored and this element's name ("${restingName.slice(0, 40)}") currently comes from elsewhere; announced correctly today, but the dead reference is fragile`
+            : `aria-labelledby="${id}" points to nothing and leaves this element without an accessible name`;
+        }
+        return `${attr}="${id}" points to nothing — assistive technology silently ignores it`;
+      })
+      .join('; ');
+    return {
+      status: 'fail',
+      message: `Broken ARIA references: ${detail}.${probed ? ' Probed with focus and hover in case the target is created on demand — it never appeared.' : ''}`,
+      fix: 'Correct or remove the reference, or give the target element that id.',
+    };
+  }
+  if (ambiguous.length) {
+    // Duplicate ids resolve deterministically to the first copy — often
+    // the right one (desktop/mobile double-renders). Real, but a human
+    // must judge whether the first copy is the wrong copy.
+    return {
+      status: 'incomplete',
+      message: `Ambiguous ARIA references: ${ambiguous.join('; ')}. If the first copy in the DOM is the intended target, this works today — but it's fragile.`,
+    };
+  }
+  return { status: 'pass' };
+}
+
 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.
@@ -16,46 +116,26 @@ export default {
   help: 'ARIA id references must point to elements that exist',
   helpUrl: 'https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html',
   selector: REF_ATTRIBUTES.map((attr) => `[${attr}]`).join(', '),
-  evaluate(element) {
-    // ARIA id references cannot cross shadow boundaries: they resolve only
-    // within the element's own root (document or shadow tree).
-    const root = element.getRootNode();
-    // Collapsed-disclosure pattern: a trigger with aria-expanded="false"
-    // whose aria-controls panel doesn't exist YET (rendered on expand) is
-    // ubiquitous and harmless while collapsed — name computation doesn't
-    // touch aria-controls, so nothing resolves wrongly today.
-    const collapsed = element.getAttribute('aria-expanded') === 'false';
-    const missing = [];
-    const ambiguous = [];
-    for (const attr of REF_ATTRIBUTES) {
-      for (const id of (element.getAttribute(attr) ?? '').split(/\s+/).filter(Boolean)) {
-        if (!root.getElementById?.(id)) {
-          if (attr === 'aria-controls' && collapsed) continue;
-          missing.push(`${attr}="${id}" points to nothing — assistive technology silently ignores it`);
+  async evaluateAll(elements, { accessibleName } = {}) {
+    let budget = PROBE_BUDGET;
+    const outcomes = new Array(elements.length);
+    for (let i = 0; i < elements.length; i++) {
+      const element = elements[i];
+      const found = inspect(element);
+      const deferredOnly = found.missing.length > 0
+        && found.missing.every(({ attr }) => PROBEABLE.has(attr));
+      if (deferredOnly && budget > 0) {
+        budget--;
+        if (await probeDeferred(element, found.missing.map(({ id }) => id))) {
+          // The description materialises exactly when it would be announced.
+          outcomes[i] = { status: 'pass' };
           continue;
         }
-        const count = root.querySelectorAll(`[id="${CSS.escape(id)}"]`).length;
-        if (count > 1) {
-          ambiguous.push(`${attr}="${id}" — ${count} elements share this id; the reference binds to the FIRST one in the DOM`);
-        }
+        outcomes[i] = outcome(found, true, element, accessibleName);
+        continue;
       }
+      outcomes[i] = outcome(found, false, element, accessibleName);
     }
-    if (missing.length) {
-      return {
-        status: 'fail',
-        message: `Broken ARIA references: ${missing.join('; ')}.`,
-        fix: 'Correct or remove the reference, or give the target element that id.',
-      };
-    }
-    if (ambiguous.length) {
-      // Duplicate ids resolve deterministically to the first copy — often
-      // the right one (desktop/mobile double-renders). Real, but a human
-      // must judge whether the first copy is the wrong copy.
-      return {
-        status: 'incomplete',
-        message: `Ambiguous ARIA references: ${ambiguous.join('; ')}. If the first copy in the DOM is the intended target, this works today — but it's fragile.`,
-      };
-    }
-    return { status: 'pass' };
+    return outcomes;
   },
 };

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.28.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 };