@ploaness/governance 1.5.0 → 1.7.0

package/dist/layout-defects.js

@@ -0,0 +1,114 @@
+// 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 { 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 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 carrying the reason for that exemption. */
+export const LAYOUT_REASON_ATTRIBUTE = 'data-ploaness-layout-reason';
+const PAIR_SEPARATOR = '  <->  ';
+const where = (snapshot) => `${snapshot.route} @${String(snapshot.viewportWidth)}px`;
+const boxLine = (snapshot, 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}`;
+};
+const textLine = (snapshot, finding) => `${where(snapshot)}: overlapping text: ${finding.first.label}${PAIR_SEPARATOR}${finding.second.label}`;
+const clipLine = (snapshot, 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}`;
+};
+const overflowLines = (snapshot) => {
+    if (snapshot.scrollWidth <= snapshot.viewportWidth) {
+        return [];
+    }
+    const prefix = `${where(snapshot)}: 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}`);
+};
+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),
+];
+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}`);
+};
+/**
+ * Every layout defect on one page, across the viewports it was measured at.
+ * @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.
+ * @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),
+    ]),
+];
+/**
+ * The viewports a scan must run at: the harness's own, then any a project adds.
+ * @param declared the viewports a project declared.
+ * @returns the required viewports first, each width once.
+ */
+export const layoutViewportsWith = (declared) => [...LAYOUT_VIEWPORTS, ...declared].filter((viewport, index, all) => all.findIndex((other) => other.width === viewport.width && other.height === viewport.height) === index);
+//# sourceMappingURL=layout-defects.js.map

package/dist/layout-defects.js.map

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

package/dist/layout-snapshot.d.ts

@@ -0,0 +1,152 @@
+/** A box in document coordinates, rounded to whole CSS pixels. */
+export interface LayoutRect {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+/** One side of an element's computed border. */
+export interface LayoutBorder {
+    readonly width: number;
+    readonly style: string;
+    readonly color: string;
+}
+/** The four computed borders, keyed by the side they draw. */
+export interface LayoutBorders {
+    readonly top: LayoutBorder;
+    readonly right: LayoutBorder;
+    readonly bottom: LayoutBorder;
+    readonly left: LayoutBorder;
+}
+/** The side of a box that faces a neighbour. */
+export type LayoutSide = keyof LayoutBorders;
+/** What the page reports about one element. */
+export interface LayoutNode {
+    /** Document order, starting at `<body>`. */
+    readonly index: number;
+    /** The index of the parent element, or -1 for `<body>`. */
+    readonly parent: number;
+    /** A short selector with the element's own text, enough to find it. */
+    readonly label: string;
+    /** The element lowercase tag name. */
+    readonly tag: string;
+    /** One rect per box fragment: an inline element wrapped over two lines reports two. */
+    readonly rects: readonly LayoutRect[];
+    /** The rects of the element's own non-blank text nodes, not of its descendants'. */
+    readonly textRects: readonly LayoutRect[];
+    /** The computed `line-height` in CSS pixels, or 0 for `normal`. */
+    readonly lineHeight: number;
+    /** The element's whole text, trimmed. Reported only where a clip could hide part of it. */
+    readonly text: string;
+    readonly display: string;
+    readonly visibility: string;
+    readonly position: string;
+    readonly backgroundColor: string;
+    readonly backgroundImage: string;
+    readonly boxShadow: string;
+    readonly borders: LayoutBorders;
+    /** Whether the element itself carries `aria-hidden="true"`. */
+    readonly isAriaHidden: boolean;
+    /** Whether a `clip` or `clip-path` is set, which is how a visually hidden element is drawn. */
+    readonly isClipped: boolean;
+    readonly overflowX: string;
+    readonly overflowY: string;
+    readonly textOverflow: string;
+    readonly lineClamp: string;
+    readonly scrollWidth: number;
+    readonly clientWidth: number;
+    readonly scrollHeight: number;
+    readonly clientHeight: number;
+    readonly title: string;
+    readonly ariaLabel: string;
+    /** The value of `data-ploaness-layout`, or undefined when the attribute is absent. */
+    readonly exemption: string | undefined;
+    /** The value of `data-ploaness-layout-reason`, trimmed. */
+    readonly exemptionReason: string;
+}
+/** One page measured at one viewport. */
+export interface LayoutSnapshot {
+    readonly route: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    /** The document's scroll width. */
+    readonly scrollWidth: number;
+    /** The computed background of `<html>`, which is what `<body>` sits on. */
+    readonly rootBackground: string;
+    readonly nodes: readonly LayoutNode[];
+}
+/** The only exemption value: an edge shared on purpose, such as a tab joined to its panel. */
+export declare const ATTACHED_EXEMPTION: string;
+/**
+ * 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;
+/**
+ * The background an element sits on: the nearest ancestor that paints one, or the page canvas.
+ * @param snapshot the measured page.
+ * @param node the element whose surroundings are wanted.
+ * @returns a computed colour string.
+ */
+export declare const surroundingBackground: (snapshot: LayoutSnapshot, node: LayoutNode) => string;
+/**
+ * Whether an element paints a background that stands out from what it sits on.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true for an image or gradient, and for a visible colour unlike the surrounding one.
+ */
+export declare const hasPaintedBackground: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
+/**
+ * Whether one side of an element draws a border.
+ * @param node the element.
+ * @param side the side asked about.
+ * @returns true when the side has width, a drawn style, and a visible colour.
+ */
+export declare const hasBorderOn: (node: LayoutNode, side: LayoutSide) => boolean;
+/**
+ * Whether an element paints anything of its own: a background, a border, or a shadow.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns false for a wrapper a reader cannot see.
+ */
+export declare const hasPaintedBox: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
+/**
+ * Whether an element or one of its ancestors is hidden from assistive technology.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside an `aria-hidden` subtree.
+ */
+export declare const isInAriaHidden: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
+/**
+ * Whether an element or one of its ancestors is clipped away, as a visually hidden element is.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside a clipped subtree.
+ */
+export declare const isInClip: (snapshot: LayoutSnapshot, node: LayoutNode) => boolean;
+/**
+ * Whether `ancestor` contains `node`.
+ * @param snapshot the measured page.
+ * @param ancestor the possible ancestor.
+ * @param node the possible descendant.
+ * @returns true when `ancestor` is a strict ancestor of `node`.
+ */
+export declare const isAncestorOf: (snapshot: LayoutSnapshot, ancestor: LayoutNode, node: LayoutNode) => boolean;
+/**
+ * Whether a rect has area once rounded.
+ * @param rect the rect.
+ * @returns false for a rect with no width or no height.
+ */
+export declare const hasArea: (rect: LayoutRect) => boolean;
+/**
+ * Where an element sits in its document: each ancestor's tag and position among its siblings.
+ *
+ * The same element measured at two viewports of one page has the same key, which is how an exemption
+ * is judged across both rather than at each alone.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns a path such as `body/main:0/div:2`.
+ */
+export declare const keyOf: (snapshot: LayoutSnapshot, node: LayoutNode) => string;
+//# sourceMappingURL=layout-snapshot.d.ts.map

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

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

package/dist/layout-snapshot.js

@@ -0,0 +1,127 @@
+// The plain shape a browser reports about one rendered page, and the painting facts derived from it.
+//
+// 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. */
+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)';
+const NO_BORDER_STYLES = new Set(['none', 'hidden']);
+// Computed colours arrive as `rgb(r, g, b)`, `rgba(r, g, b, a)`, or a slash form such as
+// `color(srgb r g b / a)`. Only the alpha matters here: whether the colour draws anything at all.
+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];
+/**
+ * Whether a computed colour draws anything.
+ * @param color a computed colour string.
+ * @returns false for `transparent` and any colour whose alpha is zero.
+ */
+export const isVisibleColor = (color) => {
+    const trimmed = color.trim();
+    if (trimmed === 'transparent' || trimmed === '') {
+        return false;
+    }
+    const alpha = alphaText(trimmed);
+    return alpha === undefined || Number(alpha.replace(PERCENT, '')) > 0;
+};
+/**
+ * The background an element sits on: the nearest ancestor that paints one, or the page canvas.
+ * @param snapshot the measured page.
+ * @param node the element whose surroundings are wanted.
+ * @returns a computed colour string.
+ */
+export const surroundingBackground = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    if (parent === undefined) {
+        return isVisibleColor(snapshot.rootBackground) ? snapshot.rootBackground : CANVAS_BACKGROUND;
+    }
+    return isVisibleColor(parent.backgroundColor) ? parent.backgroundColor : surroundingBackground(snapshot, parent);
+};
+/**
+ * Whether an element paints a background that stands out from what it sits on.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true for an image or gradient, and for a visible colour unlike the surrounding one.
+ */
+export const hasPaintedBackground = (snapshot, node) => node.backgroundImage !== 'none' ||
+    (isVisibleColor(node.backgroundColor) && node.backgroundColor !== surroundingBackground(snapshot, node));
+/**
+ * Whether one side of an element draws a border.
+ * @param node the element.
+ * @param side the side asked about.
+ * @returns true when the side has width, a drawn style, and a visible colour.
+ */
+export const hasBorderOn = (node, side) => {
+    const border = node.borders[side];
+    return border.width > 0 && !NO_BORDER_STYLES.has(border.style) && isVisibleColor(border.color);
+};
+const SIDES = ['top', 'right', 'bottom', 'left'];
+/**
+ * Whether an element paints anything of its own: a background, a border, or a shadow.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns false for a wrapper a reader cannot see.
+ */
+export const hasPaintedBox = (snapshot, node) => hasPaintedBackground(snapshot, node) ||
+    node.boxShadow !== 'none' ||
+    SIDES.some((side) => hasBorderOn(node, side));
+/**
+ * Whether an element or one of its ancestors is hidden from assistive technology.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside an `aria-hidden` subtree.
+ */
+export const isInAriaHidden = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return node.isAriaHidden || (parent !== undefined && isInAriaHidden(snapshot, parent));
+};
+/**
+ * Whether an element or one of its ancestors is clipped away, as a visually hidden element is.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns true inside a clipped subtree.
+ */
+export const isInClip = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return node.isClipped || (parent !== undefined && isInClip(snapshot, parent));
+};
+/**
+ * Whether `ancestor` contains `node`.
+ * @param snapshot the measured page.
+ * @param ancestor the possible ancestor.
+ * @param node the possible descendant.
+ * @returns true when `ancestor` is a strict ancestor of `node`.
+ */
+export const isAncestorOf = (snapshot, ancestor, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return parent !== undefined && (parent === ancestor || isAncestorOf(snapshot, ancestor, parent));
+};
+/**
+ * Whether a rect has area once rounded.
+ * @param rect the rect.
+ * @returns false for a rect with no width or no height.
+ */
+export const hasArea = (rect) => rect.right > rect.left && rect.bottom > rect.top;
+/**
+ * Where an element sits in its document: each ancestor's tag and position among its siblings.
+ *
+ * The same element measured at two viewports of one page has the same key, which is how an exemption
+ * is judged across both rather than at each alone.
+ * @param snapshot the measured page.
+ * @param node the element.
+ * @returns a path such as `body/main:0/div:2`.
+ */
+export const keyOf = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    if (parent === undefined) {
+        return node.tag;
+    }
+    const position = snapshot.nodes
+        .filter((sibling) => sibling.parent === parent.index)
+        .indexOf(node);
+    return `${keyOf(snapshot, parent)}/${node.tag}:${String(position)}`;
+};
+//# sourceMappingURL=layout-snapshot.js.map

package/dist/layout-snapshot.js.map

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

package/dist/layout-text.d.ts

@@ -0,0 +1,42 @@
+import { type LayoutNode, type LayoutSnapshot } 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.
+ */
+export declare const TEXT_OVERLAP_TOLERANCE: number;
+/** Two elements whose own text overlaps. */
+export interface TextFinding {
+    readonly first: LayoutNode;
+    readonly second: LayoutNode;
+}
+/**
+ * Every pair of unrelated elements whose own text overlaps.
+ * @param snapshot the measured page.
+ * @returns one finding per pair, in document order.
+ */
+export declare const findOverlappingText: (snapshot: LayoutSnapshot) => readonly TextFinding[];
+/** An element whose own box cuts off part of its text. */
+export interface ClipFinding {
+    readonly node: LayoutNode;
+    /** True when the element declares truncation but names its full text nowhere a reader can reach. */
+    readonly isUnnamedTruncation: boolean;
+}
+/**
+ * Every element whose own text its box cuts off.
+ *
+ * Truncation declared with an ellipsis or a line clamp is intentional when the full text is in the
+ * element's `title` or `aria-label`; declared without either, it is reported as unnamed.
+ * @param snapshot the measured page.
+ * @returns one finding per clipping element.
+ */
+export declare const findClippedText: (snapshot: LayoutSnapshot) => readonly ClipFinding[];
+/**
+ * The outermost elements that make the page wider than its viewport.
+ *
+ * An element is reported when it reaches past the viewport and its parent does not, so a wide table is
+ * named once rather than with every cell inside it. A fixed element is ignored: it never widens a page.
+ * @param snapshot the measured page.
+ * @returns the culprits, or an empty list when the page fits or no element can be blamed.
+ */
+export declare const findOverflowingElements: (snapshot: LayoutSnapshot) => readonly LayoutNode[];
+//# sourceMappingURL=layout-text.d.ts.map

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

@@ -0,0 +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"}

package/dist/layout-text.js

@@ -0,0 +1,97 @@
+// 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';
+/**
+ * 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.
+ */
+export const TEXT_OVERLAP_TOLERANCE = 1;
+const HIDDEN_VISIBILITY = new Set(['hidden', 'collapse']);
+// Form controls keep their value in a text node or render it themselves; neither is page text a
+// reader sees laid out by the page.
+const CONTROL_TAGS = new Set(['textarea', 'select', 'option']);
+const CLIPPING_OVERFLOW = new Set(['hidden', 'clip']);
+// A visually hidden element draws a 1px box and clips its text away on purpose.
+const HIDDEN_BOX_LIMIT = 1;
+const isReadableText = (snapshot, node) => node.textRects.some((rect) => hasArea(rect)) &&
+    !CONTROL_TAGS.has(node.tag) &&
+    !HIDDEN_VISIBILITY.has(node.visibility) &&
+    !isInAriaHidden(snapshot, node) &&
+    !isInClip(snapshot, node);
+// A text rect spans the font's whole content area, its ascent and descent. A line box is `line-height`
+// tall and centred on that area, so under a tight line height the content area overhangs it: two lines
+// stacked with `line-height: 1` intersect as content areas while their glyphs never meet. The line box
+// is what layout places, so it is what is compared. A line height of 0 is `normal`, which never
+// shrinks the area.
+// The leading is split evenly between the space above the content area and the space below it.
+const LEADING_SIDES = 2;
+const lineBoxOf = (rect, lineHeight) => {
+    const height = rect.bottom - rect.top;
+    if (lineHeight <= 0 || lineHeight >= height) {
+        return rect;
+    }
+    const inset = (height - lineHeight) / LEADING_SIDES;
+    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)));
+/**
+ * Every pair of unrelated elements whose own text overlaps.
+ * @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));
+    return readable.flatMap((first, index) => readable
+        .slice(index + 1)
+        .filter((second) => !(isAncestorOf(snapshot, first, second) || isAncestorOf(snapshot, second, first)) &&
+        hasCollidingText(first, second))
+        .map((second) => ({ first, second })));
+};
+const hasHiddenOverflowX = (node) => CLIPPING_OVERFLOW.has(node.overflowX) && node.scrollWidth > node.clientWidth;
+const hasHiddenOverflowY = (node) => CLIPPING_OVERFLOW.has(node.overflowY) && node.scrollHeight > node.clientHeight;
+const isVisuallyHiddenBox = (node) => node.clientWidth <= HIDDEN_BOX_LIMIT || node.clientHeight <= HIDDEN_BOX_LIMIT;
+const declaresTruncation = (node) => node.textOverflow === 'ellipsis' || (node.lineClamp !== 'none' && node.lineClamp !== '');
+const hasFullTextName = (node) => node.text.length > 0 && [node.title, node.ariaLabel].some((name) => name.includes(node.text));
+/**
+ * Every element whose own text its box cuts off.
+ *
+ * Truncation declared with an ellipsis or a line clamp is intentional when the full text is in the
+ * element's `title` or `aria-label`; declared without either, it is reported as unnamed.
+ * @param snapshot the measured page.
+ * @returns one finding per clipping element.
+ */
+export const findClippedText = (snapshot) => snapshot.nodes
+    .filter((node) => isReadableText(snapshot, node) &&
+    !isVisuallyHiddenBox(node) &&
+    (hasHiddenOverflowX(node) || hasHiddenOverflowY(node)))
+    .flatMap((node) => {
+    if (!declaresTruncation(node)) {
+        return [{ node, isUnnamedTruncation: false }];
+    }
+    return hasFullTextName(node) ? [] : [{ node, isUnnamedTruncation: true }];
+});
+const rightEdge = (node) => Math.max(...node.rects.filter((rect) => hasArea(rect)).map((rect) => rect.right));
+const isWiderThan = (node, width) => node.rects.some((rect) => hasArea(rect)) && rightEdge(node) > width;
+// A scroll container keeps what overflows it inside itself, so nothing beneath it widens the page.
+const isContained = (snapshot, node) => {
+    const parent = snapshot.nodes[node.parent];
+    return parent !== undefined && (parent.overflowX !== 'visible' || isContained(snapshot, parent));
+};
+/**
+ * The outermost elements that make the page wider than its viewport.
+ *
+ * An element is reported when it reaches past the viewport and its parent does not, so a wide table is
+ * named once rather than with every cell inside it. A fixed element is ignored: it never widens a page.
+ * @param snapshot the measured page.
+ * @returns the culprits, or an empty list when the page fits or no element can be blamed.
+ */
+export const findOverflowingElements = (snapshot) => snapshot.nodes.filter((node) => {
+    const parent = snapshot.nodes[node.parent];
+    return (node.position !== 'fixed' &&
+        isWiderThan(node, snapshot.viewportWidth) &&
+        !isContained(snapshot, node) &&
+        (parent === undefined || !isWiderThan(parent, snapshot.viewportWidth)));
+});
+//# sourceMappingURL=layout-text.js.map

package/dist/layout-text.js.map

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

package/dist/license-allowlist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"license-allowlist.d.ts","sourceRoot":"","sources":["../src/license-allowlist.ts"],"names":[],"mappings":"AAsKA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,OAUrD,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAGD,eAAO,MAAM,qBAAqB,GAChC,UAAU,SAAS,eAAe,EAAE,KACnC,SAAS,eAAe,EACmE,CAAA"}
+{"version":3,"file":"license-allowlist.d.ts","sourceRoot":"","sources":["../src/license-allowlist.ts"],"names":[],"mappings":"AAmKA;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,MAAM,KAAG,OAQrD,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAGD,eAAO,MAAM,qBAAqB,GAAI,UAAU,SAAS,eAAe,EAAE,KAAG,SAAS,eAAe,EACP,CAAA"}

package/dist/license-allowlist.js

@@ -147,9 +147,7 @@ export const isLicenseAllowed = (expression) => {
         return alternatives.some((part) => isLicenseAllowed(part));
     }
     const conjuncts = splitOutside(clean, AND);
-    return conjuncts.length > 1
-        ? conjuncts.every((part) => isLicenseAllowed(part))
-        : isAllowedId(clean);
+    return conjuncts.length > 1 ? conjuncts.every((part) => isLicenseAllowed(part)) : isAllowedId(clean);
 };
 // Return the packages whose license is not permitted by policy; an empty array means a clean tree.
 export const findLicenseViolations = (packages) => packages.filter((package_) => !isLicenseAllowed(package_.license));

package/dist/license-allowlist.js.map

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

package/dist/network-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-policy.d.ts","sourceRoot":"","sources":["../src/network-policy.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,eAAO,MAAM,YAAY,EAAE,MAAmE,CAAA;AAE9F,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;AAEnE,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,2GAA2G;AAC3G,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAe7C,CAAA;AA6CD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,CAAC,CAAC,KACnF,WAAW,CAAC,MAAM,CASlB,CAAA;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,GAAG,SAAS,EACxB,OAAO,WAAW,CAAC,MAAM,CAAC,KACzB,OAMF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAMnD,CAAA;AAuBD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,eAAe,SAAS,OAAO,EAAE,KAAG,cAcxE,CAAA;AAUD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,cAAc,EACvB,OAAO,WAAW,CAAC,MAAM,CAAC,KACzB,MAAM,GAAG,SAKX,CAAA"}
+{"version":3,"file":"network-policy.d.ts","sourceRoot":"","sources":["../src/network-policy.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,eAAO,MAAM,YAAY,EAAE,MAAmE,CAAA;AAE9F,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;AAEnE,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,2GAA2G;AAC3G,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAe7C,CAAA;AAmCD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,CAAC,CAAC,KACnF,WAAW,CAAC,MAAM,CAOlB,CAAA;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAG,OAMzF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAMnD,CAAA;AAuBD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,eAAe,SAAS,OAAO,EAAE,KAAG,cAcxE,CAAA;AASD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,cAAc,EAAE,OAAO,WAAW,CAAC,MAAM,CAAC,KAAG,MAAM,GAAG,SAKhG,CAAA"}