@ploaness/governance 1.12.0 → 1.13.0

package/dist/layout-defects.js

@@ -1,110 +1,128 @@
-// The layout sweep's verdict on one page, measured at every viewport the harness requires.
-//
-// Each defect is one line naming the route, the viewport, the rule, and the elements, so a failure says
-// where to look without a screenshot. Exemptions are judged across all the viewports of a page at once:
-// an edge attached at a phone width and apart at a desktop one is the ordinary shape of a responsive
-// layout, so an exemption is stale only when it excuses nothing at any of them.
+import { applyExemptions, declaredExemptions, EXEMPTION_ATTRIBUTE, EXEMPTION_REASON_ATTRIBUTE, malformedExemptions, staleExemptions, } from './browser-exemptions.js';
+import { findingAt, findingLine } from './browser-findings.js';
+import { BASELINE_VIEWPORTS } from './browser-viewports.js';
 import { findTouchingBoxes } from './layout-boxes.js';
 import { ATTACHED_EXEMPTION, keyOf } from './layout-snapshot.js';
 import { findClippedText, findOverflowingElements, findOverlappingText, } from './layout-text.js';
-/** The viewports the harness requires: a phone and a desktop. A project may add more, never remove. */
-export const LAYOUT_VIEWPORTS = [
-    { width: 390, height: 844 },
-    { width: 1280, height: 800 },
-];
+/** The viewports the harness requires. A project may add more, never remove any. */
+export const LAYOUT_VIEWPORTS = BASELINE_VIEWPORTS;
 /** The smallest gap, in CSS pixels, between a boxed element and its sibling. A project may raise it. */
 export const LAYOUT_MINIMUM_GAP = 4;
-/** The attribute a project writes on an element whose edge is shared on purpose. */
-export const LAYOUT_EXEMPTION_ATTRIBUTE = 'data-ploaness-layout';
+/** The attribute a project writes on an element exempt from a rule. */
+export const LAYOUT_EXEMPTION_ATTRIBUTE = EXEMPTION_ATTRIBUTE;
 /** The attribute carrying the reason for that exemption. */
-export const LAYOUT_REASON_ATTRIBUTE = 'data-ploaness-layout-reason';
+export const LAYOUT_REASON_ATTRIBUTE = EXEMPTION_REASON_ATTRIBUTE;
+/** The geometry rules the width sweep and the text-stress passes apply: L1 to L3. */
+export const REFLOW_RULES = ['overflow', 'text-overlap', 'clipped-text'];
+/** Every geometry rule of the layout scan: L1 to L4. */
+export const LAYOUT_RULES = [...REFLOW_RULES, ATTACHED_EXEMPTION];
 const PAIR_SEPARATOR = '  <->  ';
-const where = (snapshot) => `${snapshot.route} @${String(snapshot.viewportWidth)}px`;
-const boxLine = (snapshot, finding) => {
+const boxMessage = (finding) => {
     const kind = finding.isOverlap
         ? 'overlapping boxes'
         : `touching boxes (gap ${String(Math.max(0, finding.gap))}px)`;
-    return `${where(snapshot)}: ${kind}: ${finding.first.label}${PAIR_SEPARATOR}${finding.second.label}`;
+    return `${kind}: ${finding.first.label}${PAIR_SEPARATOR}${finding.second.label}`;
 };
-const textLine = (snapshot, finding) => `${where(snapshot)}: overlapping text: ${finding.first.label}${PAIR_SEPARATOR}${finding.second.label}`;
-const clipLine = (snapshot, finding) => {
+const clipMessage = (finding) => {
     const node = finding.node;
     const kind = finding.isUnnamedTruncation
         ? 'truncated text without its full text in title or aria-label'
         : `clipped text (content ${String(node.scrollWidth)}x${String(node.scrollHeight)}px in a ` +
             `${String(node.clientWidth)}x${String(node.clientHeight)}px box)`;
-    return `${where(snapshot)}: ${kind}: ${node.label}`;
+    return `${kind}: ${node.label}`;
 };
-const overflowLines = (snapshot) => {
+const overflowCandidates = (snapshot) => {
     if (snapshot.scrollWidth <= snapshot.viewportWidth) {
         return [];
     }
-    const prefix = `${where(snapshot)}: horizontal overflow (page ${String(snapshot.scrollWidth)}px wide ` +
+    const prefix = `horizontal overflow (page ${String(snapshot.scrollWidth)}px wide ` +
         `in a ${String(snapshot.viewportWidth)}px viewport)`;
     const culprits = findOverflowingElements(snapshot);
     return culprits.length === 0
-        ? [`${prefix}: document`]
-        : culprits.map((node) => `${prefix}: ${node.label}`);
+        ? [{ rule: 'overflow', subjects: [], message: `${prefix}: document` }]
+        : culprits.map((node) => ({
+            rule: 'overflow',
+            subjects: [node],
+            message: `${prefix}: ${node.label}`,
+        }));
 };
-const isExempted = (finding) => finding.exemptedBy.length > 0;
-const snapshotLines = (snapshot, minimumGap) => [
-    ...findTouchingBoxes(snapshot, minimumGap)
-        .filter((finding) => !isExempted(finding))
-        .map((finding) => boxLine(snapshot, finding)),
-    ...findOverlappingText(snapshot).map((finding) => textLine(snapshot, finding)),
-    ...findClippedText(snapshot).map((finding) => clipLine(snapshot, finding)),
-    ...overflowLines(snapshot),
+/**
+ * The reflow rules' candidates on one measured page, before exemptions: L1 to L3.
+ * @param snapshot the measured page.
+ * @returns one candidate per defect.
+ */
+export const reflowCandidates = (snapshot) => [
+    ...findOverlappingText(snapshot).map((finding) => ({
+        rule: 'text-overlap',
+        subjects: [finding.first, finding.second],
+        message: `overlapping text: ${finding.first.label}${PAIR_SEPARATOR}${finding.second.label}`,
+    })),
+    ...findClippedText(snapshot).map((finding) => ({
+        rule: 'clipped-text',
+        subjects: [finding.node],
+        message: clipMessage(finding),
+    })),
+    ...overflowCandidates(snapshot),
 ];
-const exemptionLines = (snapshot) => snapshot.nodes.flatMap((node) => {
-    if (node.exemption === undefined) {
-        return [];
-    }
-    if (node.exemption !== ATTACHED_EXEMPTION) {
-        return [
-            `${where(snapshot)}: unknown layout exemption ${LAYOUT_EXEMPTION_ATTRIBUTE}=` +
-                `"${node.exemption}" on ${node.label}; the only value is "${ATTACHED_EXEMPTION}"`,
-        ];
-    }
-    return node.exemptionReason.length === 0
-        ? [
-            `${where(snapshot)}: layout exemption without a reason on ${node.label}; ` +
-                `state it in ${LAYOUT_REASON_ATTRIBUTE}`,
-        ]
-        : [];
-});
-const usedExemptionKeys = (snapshots, minimumGap) => new Set(snapshots.flatMap((snapshot) => findTouchingBoxes(snapshot, minimumGap).flatMap((finding) => finding.exemptedBy.map((node) => keyOf(snapshot, node)))));
-const attachedExemptions = (snapshots) => {
-    const all = snapshots.flatMap((snapshot) => snapshot.nodes
-        .filter((node) => node.exemption === ATTACHED_EXEMPTION)
-        .map((node) => ({ key: keyOf(snapshot, node), label: node.label })));
-    return all.filter((exemption, index) => all.findIndex((other) => other.key === exemption.key) === index);
-};
-const staleLines = (snapshots, minimumGap) => {
-    const used = usedExemptionKeys(snapshots, minimumGap);
-    const widths = snapshots
-        .map((snapshot) => `${String(snapshot.viewportWidth)}px`)
-        .join(', ');
-    const route = snapshots[0]?.route ?? '';
-    return attachedExemptions(snapshots)
-        .filter((exemption) => !used.has(exemption.key))
-        .map((exemption) => `${route}: stale layout exemption on ${exemption.label}: it excuses no touching or ` +
-        `overlapping box at ${widths}; remove ${LAYOUT_EXEMPTION_ATTRIBUTE}`);
+/**
+ * Judge one measured page by the geometry rules, with exemptions applied.
+ *
+ * Touching boxes are excused only by an exemption on one of the two boxes. Every other rule is excused
+ * by an exemption on the element it judges or on an ancestor of it.
+ * @param snapshot the measured page.
+ * @param place where it was measured.
+ * @param judgement the gap and rules to judge it by, and the candidates of further rules.
+ * @param judgement.minimumGap the smallest gap, in CSS pixels, between a boxed element and its sibling.
+ * @param judgement.extra candidates of further rules measured on the same page.
+ * @param judgement.rules the geometry rules to apply.
+ * @returns the findings, the exemptions used, and the exemptions declared.
+ */
+export const judgeLayout = (snapshot, place, { minimumGap, extra = [], rules = LAYOUT_RULES }) => {
+    const boxes = rules.includes(ATTACHED_EXEMPTION) ? findTouchingBoxes(snapshot, minimumGap) : [];
+    const candidates = [
+        ...reflowCandidates(snapshot).filter((candidate) => rules.includes(candidate.rule)),
+        ...extra,
+    ];
+    const judged = applyExemptions(snapshot, place, candidates);
+    return {
+        findings: [
+            ...boxes
+                .filter((finding) => finding.exemptedBy.length === 0)
+                .map((finding) => findingAt(place, ATTACHED_EXEMPTION, boxMessage(finding), [finding.first.index, finding.second.index])),
+            ...judged.findings,
+            ...malformedExemptions(snapshot, place),
+        ],
+        used: [
+            ...boxes.flatMap((finding) => finding.exemptedBy.map((node) => ({
+                location: place.location,
+                key: keyOf(snapshot, node),
+                rule: ATTACHED_EXEMPTION,
+            }))),
+            ...judged.used,
+        ],
+        declared: declaredExemptions(snapshot, place.location),
+    };
 };
 /**
- * Every layout defect on one page, across the viewports it was measured at.
+ * Every layout defect on one page, across the viewports it was measured at, as report lines.
  * @param snapshots the same page measured at each required viewport.
  * @param minimumGap the smallest gap, in CSS pixels, between a boxed element and its sibling.
+ * @param engine the engine it was measured in.
+ * @param state the state it was measured in.
  * @returns one line per defect, without duplicates, in the order the viewports were measured.
  */
-export const findLayoutDefects = (snapshots, minimumGap) => [
-    ...new Set([
-        ...snapshots.flatMap((snapshot) => [
-            ...snapshotLines(snapshot, minimumGap),
-            ...exemptionLines(snapshot),
-        ]),
-        ...staleLines(snapshots, minimumGap),
-    ]),
-];
+export const findLayoutDefects = (snapshots, minimumGap, engine = 'chromium', state = 'resting') => {
+    const judged = snapshots.map((snapshot) => judgeLayout(snapshot, {
+        location: snapshot.route,
+        state,
+        engine,
+        viewport: { width: snapshot.viewportWidth, height: snapshot.viewportHeight },
+    }, { minimumGap }));
+    const stale = staleExemptions(judged.flatMap((page) => page.declared), judged.flatMap((page) => page.used), LAYOUT_RULES, engine);
+    return [
+        ...new Set([...judged.flatMap((page) => page.findings), ...stale].map((finding) => findingLine(finding))),
+    ];
+};
 /**
  * The viewports a scan must run at: the harness's own, then any a project adds.
  * @param declared the viewports a project declared.

package/dist/layout-defects.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-defects.js","sourceRoot":"","sources":["../src/layout-defects.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"layout-defects.js","sourceRoot":"","sources":["../src/layout-defects.ts"],"names":[],"mappings":"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"}

package/dist/layout-snapshot.d.ts

@@ -41,6 +41,12 @@ export interface LayoutNode {
     readonly display: string;
     readonly visibility: string;
     readonly position: string;
+    /** The computed `z-index`: `auto` or an integer. */
+    readonly zIndex: string;
+    /** The computed `transform`: `none` or a `matrix()` or `matrix3d()`. */
+    readonly transform: string;
+    /** The computed `rotate` property, which `transform` does not include: `none` or an angle. */
+    readonly rotate: string;
     readonly backgroundColor: string;
     readonly backgroundImage: string;
     readonly boxShadow: string;
@@ -59,10 +65,40 @@ export interface LayoutNode {
     readonly clientHeight: number;
     readonly title: string;
     readonly ariaLabel: string;
-    /** The value of `data-ploaness-layout`, or undefined when the attribute is absent. */
+    /** The value of `data-ploaness-layout`: the rule names it exempts, or undefined when it is absent. */
     readonly exemption: string | undefined;
     /** The value of `data-ploaness-layout-reason`, trimmed. */
     readonly exemptionReason: string;
+    /** The computed `font-size` in CSS pixels. */
+    readonly fontSize: number;
+    /** The computed `font-family` stack. */
+    readonly fontFamily: string;
+    /** What a replaced element reports about its content, or undefined for any other element. */
+    readonly media: MediaFacts | undefined;
+}
+/** What an image, video, frame or embed reports about the content it shows. */
+export interface MediaFacts {
+    /** Whether an image has finished loading; always true for an element that is not an image. */
+    readonly isComplete: boolean;
+    /** Whether the source is a vector image, which has no fixed resolution to judge. */
+    readonly isVector: boolean;
+    /** The pixel size of the loaded source file, unscaled by a `srcset` density; 0 when it has none. */
+    readonly naturalWidth: number;
+    readonly naturalHeight: number;
+    /** The content box, inside padding and border. */
+    readonly contentWidth: number;
+    readonly contentHeight: number;
+    readonly objectFit: string;
+    /** The box the same element takes with no source loaded: the space it reserves before loading. */
+    readonly reservedWidth: number;
+    readonly reservedHeight: number;
+}
+/** One `@font-face` the document declares, and how far it got. */
+export interface FontFaceFacts {
+    readonly family: string;
+    readonly status: string;
+    readonly weight: string;
+    readonly style: string;
 }
 /** One page measured at one viewport. */
 export interface LayoutSnapshot {
@@ -74,15 +110,29 @@ export interface LayoutSnapshot {
     /** The computed background of `<html>`, which is what `<body>` sits on. */
     readonly rootBackground: string;
     readonly nodes: readonly LayoutNode[];
+    /** Every `@font-face` the document declares. */
+    readonly fontFaces: readonly FontFaceFacts[];
 }
-/** The only exemption value: an edge shared on purpose, such as a tab joined to its panel. */
+/** The touching-boxes rule's name, which exempts an edge shared on purpose, such as a tab joined to its panel. */
 export declare const ATTACHED_EXEMPTION: string;
+/**
+ * Whether a computed colour hides what lies beneath it.
+ * @param color a computed colour string.
+ * @returns true for a colour with no alpha or a full one.
+ */
+export declare const isOpaqueColor: (color: string) => boolean;
 /**
  * Whether a computed colour draws anything.
  * @param color a computed colour string.
  * @returns false for `transparent` and any colour whose alpha is zero.
  */
 export declare const isVisibleColor: (color: string) => boolean;
+/**
+ * Whether an element's own background hides what lies beneath its box.
+ * @param node the element.
+ * @returns true for an opaque background colour, or a gradient of opaque stops only.
+ */
+export declare const isOpaqueBackground: (node: LayoutNode) => boolean;
 /**
  * The background an element sits on: the nearest ancestor that paints one, or the page canvas.
  * @param snapshot the measured page.
@@ -125,6 +175,14 @@ export declare const isInAriaHidden: (snapshot: LayoutSnapshot, node: LayoutNode
  * @returns true inside a clipped subtree.
  */
 export declare const isInClip: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
+/**
+ * Whether an element or an ancestor is rotated or skewed. Its bounding rectangles are then the upright
+ * boxes around a turned shape, larger than what it paints, so no gap or overlap measured on them is real.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside a turned subtree.
+ */
+export declare const isInTurn: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
 /**
  * Whether `ancestor` contains `node`.
  * @param snapshot the measured page.

package/dist/layout-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-snapshot.d.ts","sourceRoot":"","sources":["../src/layout-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"layout-snapshot.d.ts","sourceRoot":"","sources":["../src/layout-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/layout-snapshot.js

@@ -3,7 +3,7 @@
 // The layout sweep measures inside the page and judges here. Everything a rule needs crosses the
 // boundary as data - whole CSS pixels and computed style strings - so the rules run without a browser
 // and a spec can state a defect as the numbers that make it one.
-/** The only exemption value: an edge shared on purpose, such as a tab joined to its panel. */
+/** The touching-boxes rule's name, which exempts an edge shared on purpose, such as a tab joined to its panel. */
 export const ATTACHED_EXEMPTION = 'attached';
 // The canvas a page is drawn on when neither `<html>` nor any ancestor paints a background.
 const CANVAS_BACKGROUND = 'rgb(255, 255, 255)';
@@ -14,6 +14,16 @@ const COMMA_ALPHA = /^rgba\([^,]+,[^,]+,[^,]+,\s*([\d.]+)\)$/u;
 const SLASH_ALPHA = /\/\s*([\d.]+%?)\s*\)$/u;
 const PERCENT = '%';
 const alphaText = (color) => COMMA_ALPHA.exec(color)?.[1] ?? SLASH_ALPHA.exec(color)?.[1];
+const FULL_ALPHAS = new Set(['1', `100${PERCENT}`]);
+/**
+ * Whether a computed colour hides what lies beneath it.
+ * @param color a computed colour string.
+ * @returns true for a colour with no alpha or a full one.
+ */
+export const isOpaqueColor = (color) => {
+    const alpha = alphaText(color.trim());
+    return isVisibleColor(color) && (alpha === undefined || FULL_ALPHAS.has(alpha));
+};
 /**
  * Whether a computed colour draws anything.
  * @param color a computed colour string.
@@ -27,6 +37,24 @@ export const isVisibleColor = (color) => {
     const alpha = alphaText(trimmed);
     return alpha === undefined || Number(alpha.replace(PERCENT, '')) > 0;
 };
+// A computed gradient spells each colour stop as a colour function. An image, a keyword left in the
+// value, or a stop of partial alpha may let what lies beneath show through, so only a gradient whose
+// every stop is an opaque colour function hides it.
+const COLOR_FUNCTION = /(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\([^()]*\)/gu;
+const UNKNOWN_PAINT = /url\(|transparent|currentcolor/u;
+const isOpaqueGradient = (image) => {
+    const stops = image.match(COLOR_FUNCTION) ?? [];
+    return (image.includes('gradient(') &&
+        !UNKNOWN_PAINT.test(image) &&
+        stops.length > 0 &&
+        stops.every((stop) => isOpaqueColor(stop)));
+};
+/**
+ * Whether an element's own background hides what lies beneath its box.
+ * @param node the element.
+ * @returns true for an opaque background colour, or a gradient of opaque stops only.
+ */
+export const isOpaqueBackground = (node) => isOpaqueColor(node.backgroundColor) || isOpaqueGradient(node.backgroundImage);
 /**
  * The background an element sits on: the nearest ancestor that paints one, or the page canvas.
  * @param snapshot the measured page.
@@ -88,6 +116,42 @@ export const isInClip = (snapshot, node) => {
     const parent = snapshot.nodes[node.parent];
     return node.isClipped || (parent !== undefined && isInClip(snapshot, parent));
 };
+// A matrix turns a box when it moves either axis toward the other: `b` and `c` of `matrix(a, b, c, d, e,
+// f)`, and the six off-diagonal terms of the column-major `matrix3d`. What is left is scaling and
+// translation, under which a bounding rectangle is still the painted box.
+const MATRIX = /^matrix(3d)?\((.*)\)$/u;
+const TURN_EPSILON = 1e-6;
+const turnTermsOf = (terms, isSpatial) => {
+    const [, m12, m13, , m21, , m23, , m31, m32] = terms;
+    return isSpatial ? [m12, m13, m21, m23, m31, m32] : [m12, m13];
+};
+const isTurnedTransform = (transform) => {
+    const match = MATRIX.exec(transform.trim());
+    if (match === null) {
+        return false;
+    }
+    const terms = (match[2] ?? '').split(',').map(Number);
+    return turnTermsOf(terms, match[1] !== undefined).some((term) => Math.abs(term ?? 0) > TURN_EPSILON);
+};
+// The angle is the last word of the computed value, after any axis: `3deg`, `x 10deg`, `0 0 1 3deg`.
+const ANGLE_UNIT = /(?:deg|g?rad|turn)$/u;
+const isTurnedRotate = (rotate) => {
+    const angle = Number((rotate.trim().split(/\s+/u).at(-1) ?? '').replace(ANGLE_UNIT, ''));
+    return Number.isFinite(angle) && angle !== 0;
+};
+/**
+ * Whether an element or an ancestor is rotated or skewed. Its bounding rectangles are then the upright
+ * boxes around a turned shape, larger than what it paints, so no gap or overlap measured on them is real.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside a turned subtree.
+ */
+export const isInTurn = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return (isTurnedTransform(node.transform) ||
+        isTurnedRotate(node.rotate) ||
+        (parent !== undefined && isInTurn(snapshot, parent)));
+};
 /**
  * Whether `ancestor` contains `node`.
  * @param snapshot the measured page.

package/dist/layout-snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout-snapshot.js","sourceRoot":"","sources":["../src/layout-snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"layout-snapshot.js","sourceRoot":"","sources":["../src/layout-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/layout-text.d.ts

@@ -10,7 +10,10 @@ export interface TextFinding {
     readonly second: LayoutNode;
 }
 /**
- * Every pair of unrelated elements whose own text overlaps.
+ * Every pair of unrelated elements whose visible text overlaps.
+ *
+ * Text inside a rotated or skewed subtree is not compared: its rects are the upright boxes around the
+ * turned lines, which meet where the glyphs do not.
  * @param snapshot the measured page.
  * @returns one finding per pair, in document order.
  */

package/dist/layout-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-text.d.ts","sourceRoot":"","sources":["../src/layout-text.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAU,CAAA;AAiD/C,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,cAAc,KAAG,SAAS,WAAW,EAclF,CAAA;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,oGAAoG;IACpG,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;CACtC;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,cAAc,KAAG,SAAS,WAAW,EAazE,CAAA;AAgBN;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,cAAc,KAAG,SAAS,UAAU,EASlF,CAAA"}
+{"version":3,"file":"layout-text.d.ts","sourceRoot":"","sources":["../src/layout-text.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,UAAU,EAEf,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAU,CAAA;AAwH/C,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,cAAc,KAAG,SAAS,WAAW,EAclF,CAAA;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,oGAAoG;IACpG,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;CACtC;AAiBD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,cAAc,KAAG,SAAS,WAAW,EAazE,CAAA;AAgBN;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,cAAc,KAAG,SAAS,UAAU,EASlF,CAAA"}

package/dist/layout-text.js

@@ -1,5 +1,6 @@
 // Text that overlaps other text, text cut off by its own box, and a page wider than its viewport.
-import { hasArea, isAncestorOf, isInAriaHidden, isInClip, } from './layout-snapshot.js';
+import { intersectionOf, outerBoxOf, visibleRectsOf } from './layout-clip.js';
+import { hasArea, isAncestorOf, isInAriaHidden, isInClip, isInTurn, isOpaqueBackground, } from './layout-snapshot.js';
 /**
  * How far two text rects may intersect, in CSS pixels, before they overlap. Glyph boxes of adjacent
  * lines share a pixel row after rounding, which is a rounding artefact rather than a collision.
@@ -33,20 +34,68 @@ const lineBoxOf = (rect, lineHeight) => {
     return { ...rect, top: Math.round(rect.top + inset), bottom: Math.round(rect.bottom - inset) };
 };
 const lineBoxesOf = (node) => node.textRects.map((rect) => lineBoxOf(rect, node.lineHeight));
-const isIntersecting = (first, second) => Math.min(first.right, second.right) - Math.max(first.left, second.left) > TEXT_OVERLAP_TOLERANCE &&
-    Math.min(first.bottom, second.bottom) - Math.max(first.top, second.top) > TEXT_OVERLAP_TOLERANCE;
-const hasCollidingText = (first, second) => lineBoxesOf(first).some((left) => lineBoxesOf(second).some((right) => isIntersecting(left, right)));
+const isIntersecting = (first, second) => {
+    const shared = intersectionOf(first, second);
+    return shared.right - shared.left > TEXT_OVERLAP_TOLERANCE && shared.bottom - shared.top > TEXT_OVERLAP_TOLERANCE;
+};
+const STATIC = 'static';
+// What of an element's text a reader can see: each line box, cut by every ancestor that clips it.
+const visibleLineBoxesOf = (snapshot, node) => visibleRectsOf(snapshot, node, lineBoxesOf(node));
+const ancestorsOf = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return parent === undefined ? [] : [parent, ...ancestorsOf(snapshot, parent)];
+};
+const isSelfOrAncestorOf = (snapshot, candidate, node) => candidate === node || isAncestorOf(snapshot, candidate, node);
+const stackLevelOf = (node) => (node.zIndex === 'auto' ? 0 : Number(node.zIndex) || 0);
+const nearestPositioned = (snapshot, node, other) => [node, ...ancestorsOf(snapshot, node)].find((candidate) => candidate.position !== STATIC && !isSelfOrAncestorOf(snapshot, candidate, other));
+const coversRegion = (outer, inner) => outer.left <= inner.left && outer.top <= inner.top && outer.right >= inner.right && outer.bottom >= inner.bottom;
+// Whether `cover` paints an opaque background over all of `region` without containing `under`.
+const isOpaqueOver = (snapshot, cover, under, region) => {
+    const box = outerBoxOf(cover);
+    return (box !== undefined &&
+        isOpaqueBackground(cover) &&
+        coversRegion(box, region) &&
+        !isSelfOrAncestorOf(snapshot, cover, under));
+};
+// Whether the positioned layer `cover` is painted in is painted after `under`'s text.
+const isPaintedAfter = (snapshot, cover, under) => {
+    const layer = nearestPositioned(snapshot, cover, under);
+    if (layer === undefined) {
+        return false;
+    }
+    const beneath = nearestPositioned(snapshot, under, cover);
+    if (beneath === undefined) {
+        return stackLevelOf(layer) >= 0;
+    }
+    return (stackLevelOf(layer) > stackLevelOf(beneath) ||
+        (stackLevelOf(layer) === stackLevelOf(beneath) && layer.index > beneath.index));
+};
+// Whether `under`'s text at `region` is painted beneath an opaque background of `over` or of one of its
+// ancestors, such as an open menu panel laid over the page. In one stacking context every in-flow
+// background is painted before any text, so only a positioned layer covers text: it is painted after
+// the in-flow content beside it, and after another positioned layer of no higher `z-index` before it in
+// the document.
+const isCoveredBy = (snapshot, under, over, region) => [over, ...ancestorsOf(snapshot, over)].some((cover) => isOpaqueOver(snapshot, cover, under, region) && isPaintedAfter(snapshot, cover, under));
+const hasCollidingText = (snapshot, first, second) => visibleLineBoxesOf(snapshot, first).some((left) => visibleLineBoxesOf(snapshot, second).some((right) => {
+    const region = intersectionOf(left, right);
+    return (isIntersecting(left, right) &&
+        !isCoveredBy(snapshot, first, second, region) &&
+        !isCoveredBy(snapshot, second, first, region));
+}));
 /**
- * Every pair of unrelated elements whose own text overlaps.
+ * Every pair of unrelated elements whose visible text overlaps.
+ *
+ * Text inside a rotated or skewed subtree is not compared: its rects are the upright boxes around the
+ * turned lines, which meet where the glyphs do not.
  * @param snapshot the measured page.
  * @returns one finding per pair, in document order.
  */
 export const findOverlappingText = (snapshot) => {
-    const readable = snapshot.nodes.filter((node) => isReadableText(snapshot, node));
+    const readable = snapshot.nodes.filter((node) => isReadableText(snapshot, node) && !isInTurn(snapshot, node));
     return readable.flatMap((first, index) => readable
         .slice(index + 1)
         .filter((second) => !(isAncestorOf(snapshot, first, second) || isAncestorOf(snapshot, second, first)) &&
-        hasCollidingText(first, second))
+        hasCollidingText(snapshot, first, second))
         .map((second) => ({ first, second })));
 };
 const hasHiddenOverflowX = (node) => CLIPPING_OVERFLOW.has(node.overflowX) && node.scrollWidth > node.clientWidth;