pour-engine 1.37.0 → 1.37.1

package/config/project.config.js

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

package/engine/COVERAGE.md

@@ -111,7 +111,7 @@ meaning that only a person can settle, even where a rule decides most real pages
 
 | SC | Name | Level | Coverage | Rules |
 |---|---|---|---|---|
-| 4.1.2 | [Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) | A | Partially automated | input-image-alt, form-label, link-name, aria-allowed-attr, aria-attr-valid, aria-field-name, aria-hidden-focus, aria-label-misuse, aria-valid-refs, button-name, composite-widget-name, dialog-name, frame-title, label-for-valid, nested-interactive, role-required-aria, summary-name, valid-role, invoker-target |
+| 4.1.2 | [Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) | A | Partially automated | input-image-alt, form-label, link-name, aria-allowed-attr, aria-attr-valid, aria-field-name, aria-hidden-focus, aria-label-misuse, aria-valid-refs, button-name, composite-widget-name, dialog-name, frame-title, invoker-target, label-for-valid, nested-interactive, role-required-aria, summary-name, valid-role |
 | 4.1.3 | [Status Messages](https://www.w3.org/WAI/WCAG22/Understanding/status-messages.html) | AA | Manual review | — |
 
 **Totals:** 39 partially automated · 47 manual — with 88 rules.

package/engine/README.md

@@ -112,7 +112,7 @@ Nothing in the spec is silently skipped — that claim is the product.
 
 ## Honest current state
 
-74 rules, hardened on real sites and the `testbeds/` pages. Audits walk into
+88 rules, hardened on real sites and the `testbeds/` pages. Audits walk into
 open shadow roots (targets come back as `host >>> inner` selector chains);
 iframe traversal is the host's job, and the extension does it. Known gaps:
 the full accname spec (ours is a close approximation) and the language

package/engine/lib/contrast.js

@@ -1040,7 +1040,7 @@ export function viewportVeil(doc) {
 /** Parse a computed text-shadow list into layers. Computed style serializes
  *  the colour first ("rgb(0, 0, 0) 1px 0px 2px") with px lengths; author-ish
  *  orderings are tolerated. */
-export function parseTextShadows(cssText) {
+function parseTextShadows(cssText) {
   if (!cssText || cssText === 'none') return [];
   const layers = [];
   for (const part of cssText.split(/,(?![^(]*\))/)) {
@@ -1116,7 +1116,7 @@ export function textShadowNegligible(cssText, fontSize) {
  * uncertain path keeps the FULL box, erring toward review, never past a
  * real overlap. Returns null when the clip leaves nothing paintable.
  */
-export function paintableRect(element, rect) {
+function paintableRect(element, rect) {
   let { left, top, right, bottom } = rect;
   let mode = getComputedStyle(element).position;
   for (let a = element.parentElement; a; a = a.parentElement) {
@@ -1333,7 +1333,7 @@ export function imageLuminanceRange(url, overlays = [], grid = null) {
  * cover/contain hands sizing to an intrinsic this function does not have, or
  * when its position is not a plain length or percentage.
  */
-export function backgroundImagePaintRects(element) {
+function backgroundImagePaintRects(element) {
   const style = getComputedStyle(element);
   const images = splitLayers(style.backgroundImage);
   if (!images.length) return [];
@@ -1492,29 +1492,6 @@ export function rangeWithBackdrop(range, under, overlays = []) {
   };
 }
 
-/**
- * Luminance range of a CSS gradient, from its colour stops. Interpolated
- * colours stay close enough to their stops' luminances to bracket.
- */
-export function gradientLuminanceRange(backgroundImageCss, overlays = []) {
-  const stops = (backgroundImageCss.match(/rgba?\([^)]+\)/g) ?? []).map(parseColor).filter(Boolean);
-  if (!stops.length || stops.some((c) => c.a < 1)) return null; // translucent stops reveal what's beneath
-  const composited = stops.map((stop) => (overlays.length ? applyOverlays(stop, overlays) : stop));
-  const lums = composited.map(luminance);
-  const min = Math.min(...lums);
-  const max = Math.max(...lums);
-  // The COLOURS at the extremes, not just their luminances: translucent text
-  // takes its presented colour from the pixels beneath, so bracketing that
-  // blend needs the actual rgb to composite against, and luminance alone
-  // cannot be un-gamma'd back into one.
-  return {
-    min,
-    max,
-    minColor: composited[lums.indexOf(min)],
-    maxColor: composited[lums.indexOf(max)],
-  };
-}
-
 /** The layers of a computed background-image list, split on top-level
  *  commas only: commas inside url() and gradient() belong to the layer. */
 export function splitBackgroundLayers(backgroundImageCss) {

package/engine/lib/dom.js

@@ -1,5 +1,11 @@
 // DOM helpers shared by all rules.
 
+/** Elements that never reach the accessibility tree, so they cannot break
+ *  the structure of a list or a description list. STYLE belongs with them:
+ *  CSS-in-JS libraries inject <style> right beside the markup, and it was
+ *  being counted as a stray child that broke the list. */
+export const NEVER_RENDERED = new Set(['SCRIPT', 'TEMPLATE', 'STYLE', 'LINK', 'META']);
+
 /**
  * The audit context plus every OPEN shadow root beneath it, hosts before
  * their shadow trees. Collected once per audit so each rule can query every

package/engine/lib/roles.js

@@ -24,6 +24,12 @@ export const GLOBAL_ARIA = new Set([
   'live', 'owns', 'relevant', 'roledescription', 'braillelabel', 'brailleroledescription',
 ]);
 
+/** The eight landmark roles (ARIA 1.2, Landmark Roles). Shared by the
+ *  landmark rules, the landmark lens and the screen reader's rotor. */
+export const LANDMARK_ROLES = new Set([
+  'banner', 'complementary', 'contentinfo', 'form', 'main', 'navigation', 'region', 'search',
+]);
+
 /** Attributes each role supports IN ADDITION to the globals.
  *
  *  Includes the four attributes ARIA 1.2 removed from the GLOBAL set

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

@@ -3,11 +3,7 @@
 // page outline. Complementary joins via the aside demotion semantics in
 // lib/roles.js: only an aside that actually reaches the accessibility tree
 // as complementary owes top-levelness.
-import { implicitRole } from '../../lib/roles.js';
-
-const LANDMARK_ROLES = new Set([
-  'main', 'navigation', 'banner', 'contentinfo', 'complementary', 'region', 'search', 'form',
-]);
+import { implicitRole, LANDMARK_ROLES } from '../../lib/roles.js';
 
 /** HTML-AAM (form, section): "If a form has no accessible name, do not
  *  expose the element as a landmark", and a section is a region only with

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

@@ -1,18 +1,15 @@
 // ARIA APG landmark pattern: same-type landmarks need distinguishing
 // labels, and banner / contentinfo / main must be unique per page outright
 // (two "banners" are ambiguous however well they're labelled).
-import { implicitRole } from '../../lib/roles.js';
+import { implicitRole, LANDMARK_ROLES } from '../../lib/roles.js';
 import { labelledByName } from '../../lib/accessible-name.js';
 
 const SINGLETON = new Set(['banner', 'contentinfo', 'main']);
 
-// ARIA 1.2, Landmark Roles: the eight roles that are landmarks. An explicit
+// Only the eight ARIA landmark roles (lib/roles.js) count. An explicit
 // non-landmark role on a landmark element (<nav role="menubar">) makes it a
 // widget, not a landmark, so it has nothing to be distinguished from
 // (2026-08-25 overnight audit).
-const LANDMARK_ROLES = new Set([
-  'banner', 'complementary', 'contentinfo', 'form', 'main', 'navigation', 'region', 'search',
-]);
 
 /** Landmark role of the element in the accessibility tree — explicit role
  *  first, else the implicit role (which handles header/footer demotion

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

@@ -1,13 +1,12 @@
 // WCAG SC 1.3.1 Info and Relationships (Level A)
+import { NEVER_RENDERED } from '../../lib/dom.js';
+
 const ALLOWED = new Set(['DT', 'DD', 'DIV']);
-// Nothing here reaches the accessibility tree, so none of it can corrupt
-// the term/description pairing: the same set list-structure keeps, for the
-// same reason (CSS-in-JS injects <style> right beside the markup). HTML's
-// content model does exclude style from dl, but validity is not the
-// criterion; 1.3.1 is about relationships assistive technology can
-// determine, and every dt/dd pair stays intact around an element that has
-// no tree presence (2026-08-25 overnight audit).
-const NEVER_RENDERED = new Set(['SCRIPT', 'TEMPLATE', 'STYLE', 'LINK', 'META']);
+// NEVER_RENDERED cannot corrupt the term/description pairing: HTML's content
+// model does exclude style from dl, but validity is not the criterion;
+// 1.3.1 is about relationships assistive technology can determine, and
+// every dt/dd pair stays intact around an element that has no tree
+// presence (2026-08-25 overnight audit).
 
 export default {
   id: 'definition-list',

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

@@ -1,9 +1,6 @@
 // WCAG SC 1.3.1 Info and Relationships (Level A)
-// Nothing here reaches the accessibility tree, so none of it can corrupt a
-// list's structure. STYLE belongs with them: CSS-in-JS libraries inject
-// <style> right where the markup sits, and it was being counted as a stray
-// child that broke the list.
-const NEVER_RENDERED = new Set(['SCRIPT', 'TEMPLATE', 'STYLE', 'LINK', 'META']);
+import { NEVER_RENDERED } from '../../lib/dom.js';
+
 const ITEM_ROLES = ['listitem', 'presentation', 'none'];
 
 export default {

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

@@ -1,6 +1,6 @@
 // WCAG SC 2.4.1 Bypass Blocks (Level A)
 import { collectRoots, isEmbeddedDocument } from '../../lib/dom.js';
-import { effectiveRole } from '../../lib/roles.js';
+import { effectiveRole, LANDMARK_ROLES } from '../../lib/roles.js';
 
 // ARIA11 lists the landmark roles: banner, complementary, contentinfo,
 // form, main, navigation, region, search. Judged by EFFECTIVE role, not tag
@@ -10,7 +10,6 @@ import { effectiveRole } from '../../lib/roles.js';
 // and missed the second. region and form are landmarks only when named
 // (ARIA 1.2 requires an accessible name for region; HTML-AAM maps form to
 // the form landmark only with one), so the name is checked here.
-const LANDMARK_ROLES = new Set(['banner', 'complementary', 'contentinfo', 'form', 'main', 'navigation', 'region', 'search']);
 const NAMED_ONLY = new Set(['form', 'region']);
 const LANDMARK_CANDIDATES = 'main, header, footer, nav, aside, section, form, [role]';
 const hasName = (el) => Boolean(

package/package.json

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