@ploaness/config 1.12.0 → 1.14.0

package/dist/settle.d.ts

@@ -1,14 +1,16 @@
 import type { Page } from '@playwright/test';
+/** How a settle ended. */
+export type SettleOutcome = 'settled' | 'ceiling' | 'busy' | 'interrupted';
 /**
  * Wait for a page to finish rendering, before anything measures it.
  *
  * Call it after a navigation, and after a state change a scan is about to judge. A still document
- * costs two animation frames; one that is animating costs however long its animations have left; a
- * document that never stops changing costs the budget and no more, so a page nobody can settle slows
- * the sweep rather than hanging it. A visible `aria-busy="true"` region is waited for until it clears,
- * on a longer ceiling of its own, and the page is then settled again.
+ * costs two animation frames; one that is animating costs however long its animations have left. A
+ * visible `aria-busy="true"` region is waited for until it clears, on a longer ceiling of its own, and
+ * the page is then settled again.
  * @param page the page about to be scanned, left on whatever route it holds.
- * @returns nothing. It resolves whether the page settled or the budget ran out.
+ * @returns `settled`, or what stopped it: the ceiling, a region that stayed busy, or a navigation that
+ * destroyed the page while it waited. The sweep reports every outcome but `settled` as a finding.
  */
-export declare const settleForScan: (page: Page) => Promise<void>;
+export declare const settleForScan: (page: Page) => Promise<SettleOutcome>;
 //# sourceMappingURL=settle.d.ts.map

package/dist/settle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AA6L5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAc5D,CAAA"}
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAuN5C,0BAA0B;AAC1B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,aAAa,CAgBrE,CAAA"}

package/dist/settle.js

@@ -44,12 +44,19 @@
 // It is also unusable here in particular: the sweep runs against `next dev`, whose every page holds a
 // hot-reload socket open, so no page it ever visits goes idle.
 //
+// WHY IMAGES ARE PART OF IT. A rule that judges an image reads its natural size and whether it loaded,
+// and a lazy image below the fold has not started loading when the page settles. Every lazy image is
+// therefore asked to load now, and every image's decode is awaited. A decode that fails is swallowed
+// here: the image rule reports the broken image, with its element named.
+//
 // WHY THE CEILING IS A TIMER. `requestAnimationFrame` does not fire in a page the browser has
 // backgrounded, so a frame-counted ceiling is not a ceiling. A throttled background timer still fires.
 // The race is inside the page for the same reason the hit-target probe does its work in one
 // `evaluate`: a Node-side race would leave the in-page promise pending against a context the next
 // navigation destroys.
-const SETTLE_BUDGET_MS = 1000;
+// Reaching it is a finding rather than a timeout the scan proceeds past: a page that has not settled
+// gives every verdict measured on it the standing of a coin toss.
+const SETTLE_BUDGET_MS = 10_000;
 // WHY A BUSY REGION IS WAITED FOR, AND ON A CEILING OF ITS OWN. `aria-busy="true"` is a page saying
 // in so many words that a region is still being filled, and a framework's loading fallback says it:
 // Next streams a route's content into a hidden container and React reveals it in place of the busy
@@ -66,7 +73,7 @@ const BUSY_BUDGET_MS = 30_000;
 // own source text, so a reference to anything at module scope here would be a ReferenceError in the
 // page rather than a compile error in this file - the one mistake this shape cannot be checked for.
 // It is also why the animation wait below is written inline rather than as a helper of its own.
-const settleInPage = async (budgetMs) => {
+const isSettledInPage = async (budgetMs) => {
     const quietFrames = 2;
     // Recursive rather than a loop over a counter, because there is no mutable binding to count with:
     // this repository bans `let` and in-place mutation in its own source as well as in a consumer's. Each
@@ -79,101 +86,107 @@ const settleInPage = async (budgetMs) => {
             });
         });
         const current = document.querySelectorAll('*').length;
-        if (current !== previous) {
-            await stable(current, quietFrames);
-            return;
-        }
-        if (remaining > 1) {
-            await stable(current, remaining - 1);
+        // A change restarts the count of quiet frames; a quiet frame spends one of them.
+        const left = current === previous ? remaining - 1 : quietFrames;
+        if (left > 0) {
+            await stable(current, left);
         }
     };
-    const settled = async () => {
+    const hasSettled = async () => {
         // The optional call covers a document carrying no font set at all, which must skip the wait
         // rather than fail the settle.
         await document.fonts?.ready;
+        // Settled rather than all fulfilled: a broken image is the image rule's finding, reported with its
+        // element.
+        await Promise.allSettled(Array.from(document.images, async (image) => {
+            if (image.loading === 'lazy') {
+                image.setAttribute('loading', 'eager');
+            }
+            await image.decode();
+        }));
         // The element count FIRST, and this order is the whole of it. An animation does not exist until
         // something creates it, and on a hydrating page that something is the mount: measured before the
         // framework has mounted, `getAnimations` answers an honest empty list, and a settle that believed
         // it would scan the very frame the animation is about to start from. Waiting for the tree to stop
         // changing is waiting for the mount, which is what puts the animations on the page to be found.
         await stable(document.querySelectorAll('*').length, quietFrames);
-        await Promise.all((document.getAnimations?.() ?? [])
+        // Settled rather than all fulfilled: a cancelled animation rejects rather than resolving. The
+        // cancellation is a state change like any other and the count below is what notices it.
+        await Promise.allSettled((document.getAnimations?.() ?? [])
             .filter((animation) => animation.playState === 'running' &&
             animation.effect !== null &&
             Number.isFinite(animation.effect.getComputedTiming().iterations))
-            .map(async (animation) => {
-            try {
-                await animation.finished;
-            }
-            catch {
-                // A cancelled animation rejects rather than resolving. The cancellation is a state change
-                // like any other and the count below is what notices it.
-            }
-        }));
+            .map(async (animation) => await animation.finished));
         // And again afterwards, because an animation that ends by revealing a panel adds elements as it
         // finishes. This pass costs two frames on a page where nothing moved.
         await stable(document.querySelectorAll('*').length, quietFrames);
+        return true;
     };
-    const deadline = async () => {
+    const isSettledByDeadline = async () => {
         await new Promise((resolve) => {
             setTimeout(() => {
                 resolve();
             }, budgetMs);
         });
+        return false;
     };
-    await Promise.race([settled(), deadline()]);
+    return await Promise.race([hasSettled(), isSettledByDeadline()]);
 };
 // Self-contained for the same reason as the settle above. Frame by frame, like the count, so a region
 // revealed between two checks is seen on the next. Answers whether anything was busy at all, so a page
 // that never was is not settled a second time.
-const wasBusyInPage = async (budgetMs) => {
+const busyInPage = async (budgetMs) => {
     const busySelector = '[aria-busy="true"]';
     const isBusy = () => Array.from(document.querySelectorAll(busySelector)).some((element) => element.checkVisibility());
     const wasBusy = isBusy();
-    const revealed = async () => {
+    const hasCleared = async () => {
         if (!isBusy()) {
-            return;
+            return true;
         }
         await new Promise((resolve) => {
             requestAnimationFrame(() => {
                 resolve();
             });
         });
-        await revealed();
+        return await hasCleared();
     };
-    await Promise.race([
-        revealed(),
+    const isRevealed = await Promise.race([
+        hasCleared(),
         new Promise((resolve) => {
-            setTimeout(resolve, budgetMs);
+            setTimeout(() => {
+                resolve(false);
+            }, budgetMs);
         }),
     ]);
-    return wasBusy;
+    return { wasBusy, isRevealed };
 };
 /**
  * Wait for a page to finish rendering, before anything measures it.
  *
  * Call it after a navigation, and after a state change a scan is about to judge. A still document
- * costs two animation frames; one that is animating costs however long its animations have left; a
- * document that never stops changing costs the budget and no more, so a page nobody can settle slows
- * the sweep rather than hanging it. A visible `aria-busy="true"` region is waited for until it clears,
- * on a longer ceiling of its own, and the page is then settled again.
+ * costs two animation frames; one that is animating costs however long its animations have left. A
+ * visible `aria-busy="true"` region is waited for until it clears, on a longer ceiling of its own, and
+ * the page is then settled again.
  * @param page the page about to be scanned, left on whatever route it holds.
- * @returns nothing. It resolves whether the page settled or the budget ran out.
+ * @returns `settled`, or what stopped it: the ceiling, a region that stayed busy, or a navigation that
+ * destroyed the page while it waited. The sweep reports every outcome but `settled` as a finding.
  */
 export const settleForScan = async (page) => {
     try {
-        await page.evaluate(settleInPage, SETTLE_BUDGET_MS);
-        // Revealing the content changes the tree, so a page that was busy is settled once more after it.
-        if (await page.evaluate(wasBusyInPage, BUSY_BUDGET_MS)) {
-            await page.evaluate(settleInPage, SETTLE_BUDGET_MS);
+        if (!(await page.evaluate(isSettledInPage, SETTLE_BUDGET_MS))) {
+            return 'ceiling';
+        }
+        const busy = await page.evaluate(busyInPage, BUSY_BUDGET_MS);
+        if (!busy.isRevealed) {
+            return 'busy';
         }
+        // Revealing the content changes the tree, so a page that was busy is settled once more after it.
+        return !busy.wasBusy || (await page.evaluate(isSettledInPage, SETTLE_BUDGET_MS)) ? 'settled' : 'ceiling';
     }
     catch {
         // A route that redirects on mount destroys the execution context while this is in flight, and a
-        // closed page cannot be asked anything. Neither is an accessibility finding, and neither should end
-        // a sweep: the scan that follows then runs on whatever the page holds, which is what every call
-        // site did before this function existed. A page that is genuinely broken still fails at `analyze`,
-        // with an axe result to read rather than a protocol error naming no route.
+        // closed page cannot be asked anything. The caller decides what that means for its scan.
+        return 'interrupted';
     }
 };
 //# sourceMappingURL=settle.js.map

package/dist/settle.js.map

@@ -1 +1 @@
-{"version":3,"file":"settle.js","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,oGAAoG;AACpG,oGAAoG;AACpG,uEAAuE;AACvE,EAAE;AACF,qGAAqG;AACrG,oGAAoG;AACpG,oGAAoG;AACpG,qGAAqG;AACrG,uGAAuG;AACvG,gGAAgG;AAChG,wDAAwD;AACxD,sGAAsG;AACtG,sGAAsG;AACtG,kGAAkG;AAClG,0BAA0B;AAC1B,EAAE;AACF,uGAAuG;AACvG,mGAAmG;AACnG,gGAAgG;AAChG,mGAAmG;AACnG,qGAAqG;AACrG,sGAAsG;AACtG,uGAAuG;AACvG,8FAA8F;AAC9F,EAAE;AACF,mGAAmG;AACnG,uGAAuG;AACvG,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,+FAA+F;AAC/F,EAAE;AACF,qGAAqG;AACrG,mGAAmG;AACnG,yFAAyF;AACzF,EAAE;AACF,mGAAmG;AACnG,uGAAuG;AACvG,gEAAgE;AAChE,EAAE;AACF,mGAAmG;AACnG,qGAAqG;AACrG,sGAAsG;AACtG,+DAA+D;AAC/D,EAAE;AACF,8FAA8F;AAC9F,uGAAuG;AACvG,4FAA4F;AAC5F,kGAAkG;AAClG,uBAAuB;AACvB,MAAM,gBAAgB,GAAW,IAAI,CAAA;AAErC,oGAAoG;AACpG,oGAAoG;AACpG,mGAAmG;AACnG,sGAAsG;AACtG,oGAAoG;AACpG,wGAAwG;AACxG,gGAAgG;AAChG,uGAAuG;AACvG,oGAAoG;AACpG,sGAAsG;AACtG,4EAA4E;AAC5E,MAAM,cAAc,GAAW,MAAM,CAAA;AA2BrC,sGAAsG;AACtG,oGAAoG;AACpG,oGAAoG;AACpG,gGAAgG;AAChG,MAAM,YAAY,GAAG,KAAK,EAAE,QAAgB,EAAiB,EAAE;IAC7D,MAAM,WAAW,GAAW,CAAC,CAAA;IAC7B,kGAAkG;IAClG,sGAAsG;IACtG,mGAAmG;IACnG,+FAA+F;IAC/F,MAAM,MAAM,GAAG,KAAK,EAAE,QAAgB,EAAE,SAAiB,EAAiB,EAAE;QAC1E,MAAM,IAAI,OAAO,CAAO,CAAC,OAAmB,EAAQ,EAAE;YACpD,qBAAqB,CAAC,GAAS,EAAE;gBAC/B,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,MAAM,OAAO,GAAW,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;QAC7D,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YAClC,OAAM;QACR,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,CAAC,CAAC,CAAA;QACtC,CAAC;IACH,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,4FAA4F;QAC5F,+BAA+B;QAC/B,MAAM,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;QAC3B,gGAAgG;QAChG,iGAAiG;QACjG,kGAAkG;QAClG,kGAAkG;QAClG,gGAAgG;QAChG,MAAM,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QAChE,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC;aAC/B,MAAM,CACL,CAAC,SAAwB,EAAW,EAAE,CACpC,SAAS,CAAC,SAAS,KAAK,SAAS;YACjC,SAAS,CAAC,MAAM,KAAK,IAAI;YACzB,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,UAAU,CAAC,CACnE;aACA,GAAG,CAAC,KAAK,EAAE,SAAwB,EAAiB,EAAE;YACrD,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,QAAQ,CAAA;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,0FAA0F;gBAC1F,yDAAyD;YAC3D,CAAC;QACH,CAAC,CAAC,CACL,CAAA;QACD,gGAAgG;QAChG,sEAAsE;QACtE,MAAM,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAClE,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAmB,EAAQ,EAAE;YACpD,UAAU,CAAC,GAAS,EAAE;gBACpB,OAAO,EAAE,CAAA;YACX,CAAC,EAAE,QAAQ,CAAC,CAAA;QACd,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;AAC7C,CAAC,CAAA;AAED,sGAAsG;AACtG,uGAAuG;AACvG,+CAA+C;AAC/C,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE;IACjE,MAAM,YAAY,GAAW,oBAAoB,CAAA;IACjD,MAAM,MAAM,GAAG,GAAY,EAAE,CAC3B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAoB,EAAW,EAAE,CACzF,OAAO,CAAC,eAAe,EAAE,CAC1B,CAAA;IACH,MAAM,OAAO,GAAY,MAAM,EAAE,CAAA;IACjC,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAmB,EAAQ,EAAE;YACpD,qBAAqB,CAAC,GAAS,EAAE;gBAC/B,OAAO,EAAE,CAAA;YACX,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,MAAM,QAAQ,EAAE,CAAA;IAClB,CAAC,CAAA;IACD,MAAM,OAAO,CAAC,IAAI,CAAC;QACjB,QAAQ,EAAE;QACV,IAAI,OAAO,CAAO,CAAC,OAAmB,EAAQ,EAAE;YAC9C,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC/B,CAAC,CAAC;KACH,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,IAAU,EAAiB,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAA;QACnD,iGAAiG;QACjG,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gGAAgG;QAChG,oGAAoG;QACpG,gGAAgG;QAChG,mGAAmG;QACnG,2EAA2E;IAC7E,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"settle.js","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"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"}

package/dist/sweep-disclosures.d.ts

@@ -0,0 +1,10 @@
+import { type Page } from '@playwright/test';
+import { type Shard } from './sweep-shared.js';
+/**
+ * Open every disclosure on one shard of the locations, judge what it reveals, and judge how it answers
+ * the keyboard.
+ * @param page the test's page.
+ * @param shard the part of the pass this test visits.
+ */
+export declare const expectDisclosureStates: (page: Page, shard: Shard) => Promise<void>;
+//# sourceMappingURL=sweep-disclosures.d.ts.map

package/dist/sweep-disclosures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-disclosures.d.ts","sourceRoot":"","sources":["../src/sweep-disclosures.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,IAAI,EAAQ,MAAM,kBAAkB,CAAA;AAaxE,OAAO,EAoBL,KAAK,KAAK,EAMX,MAAM,mBAAmB,CAAA;AAiN1B;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM,IAAI,EAAE,OAAO,KAAK,KAAG,OAAO,CAAC,IAAI,CAoBnF,CAAA"}

package/dist/sweep-disclosures.js

@@ -0,0 +1,179 @@
+// The sweep's disclosure pass: every disclosure opened, what it reveals judged, and how it answers the
+// keyboard.
+import { errors, test } from '@playwright/test';
+import { disclosureDefects, drivenViewports, findingAt, } from '@ploaness/governance';
+import { targetFacts } from './layout.js';
+import { axeFindings, judgeRestingPlace, settleFindings } from './scanner.js';
+import { settleForScan } from './settle.js';
+import { carried } from './sweep-interaction.js';
+import { armBudget, DISCLOSURE_ATTRIBUTE, EMPTY_VISIT, finishPass, healthOf, isChromium, itemLabel, loadLocation, locationOfItem, merged, placeAt, preparePage, RESTING_JUDGED, readDiscovery, shardLocations, visitAll, } from './sweep-shared.js';
+const DISCLOSURES = '[aria-expanded="false"], [aria-haspopup]:not([aria-haspopup="false"]), details:not([open]) > summary';
+// Mark the disclosures it is safe to open: visible, outside forms unless declared `type="button"`, and
+// never a link that navigates. Answers how many were marked.
+const markDisclosuresInPage = ([selector, attribute]) => {
+    const safe = Array.from(document.querySelectorAll(selector)).filter((element) => {
+        const tag = element.tagName.toLowerCase();
+        const href = element.getAttribute('href');
+        const isNavigating = tag === 'a' && href !== null && !href.startsWith('#');
+        const isSubmitting = element.closest('form') !== null && !(tag === 'button' && element.getAttribute('type') === 'button');
+        return element.checkVisibility() && !isNavigating && !isSubmitting;
+    });
+    for (const [index, element] of safe.entries()) {
+        element.setAttribute(attribute, String(index));
+    }
+    return safe.length;
+};
+const disclosureFactsInPage = (selector) => {
+    const control = document.querySelector(selector);
+    const modal = document.querySelector('dialog:modal, [role="dialog"][aria-modal="true"], [role="alertdialog"][aria-modal="true"]');
+    const isModalOpen = modal?.checkVisibility() === true;
+    const active = document.activeElement;
+    const attributeOf = (name) => control?.getAttribute(name) ?? null;
+    const containsFocus = (container) => container !== null && active !== null && (container === active || container.contains(active));
+    return {
+        url: location.href,
+        history: history.length,
+        expanded: attributeOf('aria-expanded'),
+        isPopup: (attributeOf('aria-haspopup') ?? 'false') !== 'false',
+        isModalOpen,
+        isFocusInModal: isModalOpen && containsFocus(modal),
+        isFocusOnControl: containsFocus(control),
+    };
+};
+const MAX_TRAP_STEPS = 30;
+// Whether the control a disclosure opened from holds focus again, and nothing it opened is still open.
+const isClosedToControlInPage = (selector) => {
+    const control = document.querySelector(selector);
+    const active = document.activeElement;
+    const modal = document.querySelector('dialog:modal, [role="dialog"][aria-modal="true"], [role="alertdialog"][aria-modal="true"]');
+    return (control !== null &&
+        active !== null &&
+        (control === active || control.contains(active)) &&
+        control.getAttribute('aria-expanded') !== 'true' &&
+        modal?.checkVisibility() !== true);
+};
+// How long a disclosure may take to close and hand focus back after Escape. Libraries such as Radix
+// close in the key's own task and move focus once their exit has rendered, a tick or a frame later.
+const FOCUS_RETURN_MS = 1000;
+const closedAfterEscape = async (page, selector, isDismissible) => {
+    if (!isDismissible) {
+        return await page.evaluate(disclosureFactsInPage, selector);
+    }
+    try {
+        await page.waitForFunction(isClosedToControlInPage, selector, { timeout: FOCUS_RETURN_MS });
+    }
+    catch (error) {
+        // Not closed back to its control in time: the facts read next say which half failed.
+        if (!(error instanceof errors.TimeoutError)) {
+            throw error;
+        }
+    }
+    return await page.evaluate(disclosureFactsInPage, selector);
+};
+const isTrapped = async (page, selector, remaining) => {
+    if (remaining <= 0) {
+        return true;
+    }
+    await page.keyboard.press('Tab');
+    const facts = await page.evaluate(disclosureFactsInPage, selector);
+    return facts.isFocusInModal && (await isTrapped(page, selector, remaining - 1));
+};
+const labelOfDisclosure = (facts) => facts?.label ?? 'a disclosure';
+// Escape for a popup or a modal dialog, then the keyboard judgement, then a click to close whatever the
+// keyboard did not, so the next disclosure starts from a closed page.
+const dismissDisclosure = async (disclosure) => {
+    const { page, selector, control, before, opened, place, facts } = disclosure;
+    const isFocusTrapped = opened.isModalOpen && (await isTrapped(page, selector, MAX_TRAP_STEPS));
+    const isDismissible = before.isPopup || opened.isModalOpen;
+    if (isDismissible) {
+        await page.keyboard.press('Escape');
+    }
+    const closed = await closedAfterEscape(page, selector, isDismissible);
+    const isClosedOnEscape = isDismissible && !closed.isModalOpen && closed.expanded !== 'true';
+    if (!isClosedOnEscape && (await control.isVisible())) {
+        await control.click();
+    }
+    await settleForScan(page);
+    return disclosureDefects({
+        isPopup: before.isPopup,
+        closedOnEscape: isClosedOnEscape,
+        focusReturned: closed.isFocusOnControl,
+        isModal: opened.isModalOpen,
+        focusTrapped: isFocusTrapped,
+    }).map((defect) => carried(findingAt(place, 'disclosure-keyboard', `${labelOfDisclosure(facts)}: ${defect}`), facts));
+};
+const judgeOpened = async (page, place) => {
+    const unsettled = await settleFindings(page, place);
+    const judged = await judgeRestingPlace(page, place);
+    const axe = await axeFindings(page, place);
+    return { ...judged, findings: [...unsettled, ...judged.findings, ...axe], notes: [] };
+};
+const driveDisclosure = async (page, item, index) => {
+    const selector = `[${DISCLOSURE_ATTRIBUTE}="${String(index)}"]`;
+    const control = page.locator(selector);
+    if (!(await control.isVisible())) {
+        return { visit: EMPTY_VISIT, isAborted: false };
+    }
+    const before = await page.evaluate(disclosureFactsInPage, selector);
+    const facts = await targetFacts(page, selector);
+    await control.click();
+    const opened = await page.evaluate(disclosureFactsInPage, selector);
+    if (opened.url !== before.url || opened.history !== before.history) {
+        return {
+            visit: {
+                ...EMPTY_VISIT,
+                notes: [
+                    `${item.location.location}: opening ${labelOfDisclosure(facts)} changed the URL, so the disclosures ` +
+                        'after it went unchecked',
+                ],
+            },
+            isAborted: true,
+        };
+    }
+    const place = placeAt(page, item.location, item.viewport, `disclosure ${labelOfDisclosure(facts)}`);
+    const revealed = await judgeOpened(page, place);
+    const keyboard = await dismissDisclosure({ page, selector, control, before, opened, place, facts });
+    return { visit: merged([revealed, ...keyboard]), isAborted: false };
+};
+const driveDisclosures = async (page, item, index, count) => {
+    if (index >= count) {
+        return [];
+    }
+    const driven = await driveDisclosure(page, item, index);
+    return driven.isAborted ? [driven.visit] : [driven.visit, ...(await driveDisclosures(page, item, index + 1, count))];
+};
+const disclosureVisit = async (page, item) => {
+    const place = placeAt(page, item.location, item.viewport, 'resting');
+    const loaded = await loadLocation(page, item.location, item.viewport, place);
+    await settleForScan(page);
+    const count = await page.evaluate(markDisclosuresInPage, [DISCLOSURES, DISCLOSURE_ATTRIBUTE]);
+    const driven = await driveDisclosures(page, item, 0, count);
+    return merged([{ ...EMPTY_VISIT, findings: loaded }, ...driven, await healthOf(page, place)]);
+};
+const DISCLOSURE_RULES = [...RESTING_JUDGED, 'disclosure-keyboard'];
+/**
+ * Open every disclosure on one shard of the locations, judge what it reveals, and judge how it answers
+ * the keyboard.
+ * @param page the test's page.
+ * @param shard the part of the pass this test visits.
+ */
+export const expectDisclosureStates = async (page, shard) => {
+    test.info().skip(!isChromium(page), 'the disclosure pass runs in Chromium');
+    const discovery = readDiscovery(test.info());
+    const items = discovery.locations.flatMap((location) => drivenViewports(location.isStory).map((viewport) => ({ location, viewport })));
+    const budget = armBudget(page, 'disclosures', shard, items.length);
+    await preparePage(page);
+    const { visits, taken } = await visitAll(items, {
+        budget,
+        labelOf: itemLabel,
+        visit: async (item) => await disclosureVisit(page, item),
+    });
+    finishPass(page, {
+        budget,
+        pass: 'disclosures',
+        visits,
+        judgedRules: DISCLOSURE_RULES,
+        locations: shardLocations(taken, locationOfItem),
+    });
+};
+//# sourceMappingURL=sweep-disclosures.js.map

package/dist/sweep-disclosures.js.map

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

package/dist/sweep-discovery.d.ts

@@ -0,0 +1,15 @@
+import { type Page } from '@playwright/test';
+/**
+ * Discover every page the sweep scans, and record it with whatever made the discovery incomplete.
+ *
+ * Routes come from a link crawl from `/`, every same-origin `hreflang` alternate, and `sitemap.xml`;
+ * stories from each auxiliary server that answers `/index.json`; breakpoints and colour schemes from
+ * each page's stylesheets. A crawled internal link that does not answer is a broken link. Under a
+ * `delta` run's change scope the crawl still reaches and checks every route, and the passes are handed
+ * only the routes and stories the change reaches, each with the reason it is swept. Every pass depends
+ * on this test, so it fails only when it could not write its record; the summary judges the findings
+ * and problems it recorded.
+ * @param page the test's page.
+ */
+export declare const expectDiscoveredSite: (page: Page) => Promise<void>;
+//# sourceMappingURL=sweep-discovery.d.ts.map

package/dist/sweep-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-discovery.d.ts","sourceRoot":"","sources":["../src/sweep-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,IAAI,EAAuB,MAAM,kBAAkB,CAAA;AAoc3F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAgDnE,CAAA"}