@ploaness/config 1.12.0 → 1.13.0

package/dist/playwright.js

@@ -3,16 +3,17 @@
 //
 // Everything here is policy rather than preference. `forbidOnly` is the end-to-end analogue of the
 // focused-test ban ploaness already enforces for Vitest: a left-behind `test.only` would otherwise turn
-// a local extended run into one green test. A single worker is not a performance choice either - every spec shares
-// one dev server that compiles routes on demand, and parallel workers starve the heavier specs against
-// it. The project-specific inputs are the origin and any server its own specs need started beside the
+// a local browser-level run into one green test. The project's own specs run on one worker, because they
+// may share database state and one server; the managed sweep's tests each load their pages fresh and
+// judge each one alone, so they spread over parallel workers without any verdict depending on it. The
+// project-specific inputs are the origin and any server its own specs need started beside the
 // application, both declared under the `ploaness` key of its package.json rather than by editing this
 // file. Neither reaches a rule: they say where the application answers and what else has to be running,
 // and every threshold, ban and pinned spec above is the same whatever they say.
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { defineConfig, devices } from '@playwright/test';
-import { browserServerEndpoint, canReuseBrowserServer, portOf, runEnvironmentFiles, shellArgument, VERIFICATION_ENVIRONMENT_VARIABLE, } from '@ploaness/governance';
+import { BROWSER_ENDPOINT_ENVIRONMENT_VARIABLE, BROWSER_TUNNEL_ENVIRONMENT_VARIABLE, browserServerEndpoint, CLOCK_ENVIRONMENT_VARIABLE, canReuseBrowserServer, coversEveryEngine, DEVICE_SCALE_FACTOR, portOf, REAL_CLOCK, runEnvironmentFiles, SWEEP_WORKERS, shellArgument, VERIFICATION_ENVIRONMENT_VARIABLE, } from '@ploaness/governance';
 import { loadProductionEnvironment } from './production-environment.js';
 import { projectSettings } from './project-settings.js';
 // Read before anything else, because a spec module is what needs it. Playwright evaluates this config
@@ -23,6 +24,12 @@ import { projectSettings } from './project-settings.js';
 // variables; the specs and the application do. A `globalSetup` hook would not serve, because it runs
 // in a process of its own and its environment never reaches a worker.
 const isVerification = process.env[VERIFICATION_ENVIRONMENT_VARIABLE] !== undefined;
+// The verification clock reaches the runner and every server through `NODE_OPTIONS`, but Playwright
+// starts its test workers without it, so a spec computing "today" would disagree with the application
+// it drives. The config is evaluated in every worker, which makes it the place to load the clock.
+if (process.env[CLOCK_ENVIRONMENT_VARIABLE] !== undefined) {
+    await import('./clock-preload.js');
+}
 if (isVerification) {
     loadProductionEnvironment(process.cwd());
 }
@@ -31,7 +38,17 @@ else {
         process.loadEnvFile(file);
     }
 }
-const isContinuousIntegration = Boolean(process.env['CI']);
+// Playwright starts each web server detached, in a process group of its own, and stops it when the run
+// is interrupted - but it treats only SIGINT as an interruption. A run ended by SIGTERM or SIGHUP, as a
+// cancelled CI job or a closed terminal ends it, left every server running on the port the next run
+// needs. Both are raised again as SIGINT, once, so the runner stops the run and its servers itself; a
+// second signal keeps its default. A test worker ignores SIGINT and is ended by its runner, so there the
+// forwarded signal changes nothing.
+for (const signal of ['SIGTERM', 'SIGHUP']) {
+    process.once(signal, () => {
+        process.kill(process.pid, 'SIGINT');
+    });
+}
 const isReuseExistingServer = canReuseBrowserServer(process.env);
 const productionLauncher = fileURLToPath(new URL('production-server.js', import.meta.url));
 // The web server is `next dev`, which compiles a route on its first request. The first hit to the heavy
@@ -39,7 +56,6 @@ const productionLauncher = fileURLToPath(new URL('production-server.js', import.
 // compilation headroom instead of leaning on a retry to mask it.
 const TEST_TIMEOUT_MS = 90_000;
 const SERVER_TIMEOUT_MS = 180_000;
-const CI_RETRIES = 2;
 // Structural rather than Playwright's own `PlaywrightTestConfig`, for the reason `vitest.ts` records:
 // the harness owns the config and the consumer owns the runner, so an emitted declaration should not
 // make the runner's types a condition of reading this entry point.
@@ -50,6 +66,40 @@ const CI_RETRIES = 2;
 // rather than setting PORT to the string "undefined".
 const withPort = (base, port) => (port === undefined ? base : { ...base, PORT: port });
 const declaredPort = portOf(projectSettings.serverUrl);
+// Under verification the browsers are the pinned ones the CLI started in the Playwright image, so the
+// same tree measures the same pixels on every machine. The application stays on the host: the remote
+// browser reaches its loopback origins through the client, so cookies, headers and the production
+// server are exactly what they are without the container. The remote browser reaches those origins
+// directly where the container shares the host's network, and through the client's tunnel otherwise.
+// Outside verification the host's Chromium runs.
+const browserEndpoint = process.env[BROWSER_ENDPOINT_ENVIRONMENT_VARIABLE];
+const remote = browserEndpoint === undefined
+    ? {}
+    : {
+        connectOptions: {
+            wsEndpoint: browserEndpoint,
+            ...(process.env[BROWSER_TUNNEL_ENVIRONMENT_VARIABLE] !== undefined && { exposeNetwork: '<loopback>' }),
+        },
+    };
+// The sweep alone runs in the other engines; a project's own specs describe its behaviour once. A
+// `delta` run's change scope keeps the sweep in Chromium.
+const SWEEP_SPEC = /a11y\.e2e\.spec\.ts$/u;
+const chromiumDevice = {
+    ...devices['Desktop Chrome'],
+    deviceScaleFactor: DEVICE_SCALE_FACTOR,
+    ...(browserEndpoint === undefined && { channel: 'chromium' }),
+};
+// The sweep's projects, which select its tests by tag. Discovery runs once, in Chromium, and every
+// pass depends on it; the summary is its teardown, so it runs after every pass of every engine has
+// finished, whatever their outcome.
+const SWEEP_DISCOVERY = 'sweep-discovery';
+const SWEEP_SUMMARY = 'sweep-summary';
+// The application's clock, shifted by the preload in every server this config starts. The CLI sets the
+// variable for a verification run; a project that declared the real clock gets none.
+const clockOptions = isVerification && projectSettings.clock !== REAL_CLOCK
+    ? ` --import=${new URL('clock-preload.js', import.meta.url).href}`
+    : '';
+const clockEnvironment = clockOptions === '' ? {} : { [CLOCK_ENVIRONMENT_VARIABLE]: projectSettings.clock };
 // Next's environment loader marks the process once it has loaded the environment files, and skips
 // loading in any process that inherits the mark. A verification run loads this package's files above,
 // and Playwright starts every server on top of the runner's own environment, so without clearing the
@@ -60,17 +110,65 @@ const declared = defineConfig({
     testDir: './tests/e2e',
     timeout: TEST_TIMEOUT_MS,
     forbidOnly: true,
-    retries: isContinuousIntegration ? CI_RETRIES : 0,
-    workers: 1,
+    // Never retried: a retry that passes hides a verdict that is not reproducible, which is a defect of
+    // its own. Determinism is established by the fixed clock, motion, locale, timezone and pixel ratio
+    // below, and by the settle and stability checks every scan makes.
+    retries: 0,
+    workers: SWEEP_WORKERS,
     // `open: 'never'` because the gate runs this non-interactively: a reporter that launches a browser
     // on failure would hang the run rather than report it.
     reporter: [['list'], ['html', { open: 'never' }]],
     use: {
         baseURL: projectSettings.serverUrl,
-        trace: 'on-first-retry',
+        trace: 'retain-on-failure',
         screenshot: 'only-on-failure',
+        reducedMotion: 'reduce',
+        locale: 'en-US',
+        timezoneId: 'UTC',
+        colorScheme: 'light',
+        deviceScaleFactor: DEVICE_SCALE_FACTOR,
+        serviceWorkers: 'block',
+        ...remote,
     },
-    projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'], channel: 'chromium' } }],
+    projects: [
+        { name: 'chromium', testIgnore: SWEEP_SPEC, workers: 1, use: chromiumDevice },
+        {
+            name: SWEEP_DISCOVERY,
+            testMatch: SWEEP_SPEC,
+            grep: /@ploaness-discovery/u,
+            teardown: SWEEP_SUMMARY,
+            use: chromiumDevice,
+        },
+        {
+            name: 'sweep-chromium',
+            testMatch: SWEEP_SPEC,
+            grep: /@ploaness-chromium/u,
+            dependencies: [SWEEP_DISCOVERY],
+            fullyParallel: true,
+            use: chromiumDevice,
+        },
+        ...(coversEveryEngine(process.env)
+            ? [
+                {
+                    name: 'sweep-firefox',
+                    testMatch: SWEEP_SPEC,
+                    grep: /@ploaness-engine/u,
+                    dependencies: [SWEEP_DISCOVERY],
+                    fullyParallel: true,
+                    use: { ...devices['Desktop Firefox'], deviceScaleFactor: DEVICE_SCALE_FACTOR },
+                },
+                {
+                    name: 'sweep-webkit',
+                    testMatch: SWEEP_SPEC,
+                    grep: /@ploaness-engine/u,
+                    dependencies: [SWEEP_DISCOVERY],
+                    fullyParallel: true,
+                    use: { ...devices['Desktop Safari'], deviceScaleFactor: DEVICE_SCALE_FACTOR },
+                },
+            ]
+            : []),
+        { name: SWEEP_SUMMARY, testMatch: SWEEP_SPEC, grep: /@ploaness-summary/u, use: chromiumDevice },
+    ],
     // Auxiliary servers first, then the application under test. Playwright awaits each entry in this
     // list before starting the next, so the order is the difference between a run and a deadlock: a
     // frontend that renders from a headless CMS cannot answer its own origin until that CMS answers, and
@@ -99,7 +197,11 @@ const declared = defineConfig({
             // is long.
             timeout: SERVER_TIMEOUT_MS,
             ...(server.cwd !== undefined && { cwd: server.cwd }),
-            env: withPort({ NODE_OPTIONS: '--no-deprecation', [NEXT_PROCESSED_ENVIRONMENT_MARK]: '' }, portOf(server.url)),
+            env: withPort({
+                NODE_OPTIONS: `--no-deprecation${clockOptions}`,
+                [NEXT_PROCESSED_ENVIRONMENT_MARK]: '',
+                ...clockEnvironment,
+            }, portOf(server.url)),
         })),
         {
             // Invoked as a bare binary rather than through a package script, because a nested package manager
@@ -115,7 +217,8 @@ const declared = defineConfig({
             // exists to describe a non-default port made the run hang instead of work.
             env: withPort({
                 NEXT_TELEMETRY_DISABLED: '1',
-                NODE_OPTIONS: '--no-deprecation',
+                NODE_OPTIONS: `--no-deprecation${clockOptions}`,
+                ...clockEnvironment,
                 ...(isVerification && {
                     NODE_ENV: 'production',
                     HOSTNAME: browserServerEndpoint(projectSettings.serverUrl).host,

package/dist/playwright.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,99 @@
+import { AxeBuilder } from '@axe-core/playwright';
+import { type Page } from '@playwright/test';
+import { type BrowserFinding, type DeclaredExemption, type FindingPlace, type FindingViewport, type JudgedPage, type LayoutSnapshot, type UsedExemption } from '@ploaness/governance';
+/** Every rule the resting scan applies to elements, for judging which exemptions are stale. */
+export declare const RESTING_RULES: readonly string[];
+/** What scanning one place yields. */
+export interface PlaceScan extends JudgedPage {
+    /** The measurement the findings were judged on, for the outline a failure screenshot draws. */
+    readonly snapshot: LayoutSnapshot | undefined;
+}
+/** The engine a page runs in. */
+export declare const engineOf: (page: Page) => string;
+/** The route path or story a page shows, as a finding names it. */
+export declare const locationOf: (page: Page) => string;
+/**
+ * Settle the page, and report a page that did not settle.
+ * @param page the page.
+ * @param place where it is.
+ * @returns a finding, or nothing when the page settled.
+ */
+export declare const settleFindings: (page: Page, place: FindingPlace) => Promise<readonly BrowserFinding[]>;
+/**
+ * Measure a settled page twice, and judge it by the resting rules: L1 to L4, T4, T6 and M1 to M4.
+ *
+ * Geometry that differs between the two measurements is a finding of its own, and the page is then
+ * judged on neither: every other verdict on a page that moves is a coin toss.
+ * @param page the settled page.
+ * @param place where it is.
+ * @returns the findings, the exemptions used and declared, and the measurement.
+ */
+export declare const judgeRestingPlace: (page: Page, place: FindingPlace) => Promise<PlaceScan>;
+/**
+ * The axe scan of a page as findings, one per violating element.
+ * @param page the settled page.
+ * @param place where it is.
+ * @param build narrows the builder, for a scan of one rule or one element.
+ * @returns the findings.
+ */
+export declare const axeFindings: (page: Page, place: FindingPlace, build?: (builder: AxeBuilder) => AxeBuilder) => Promise<readonly BrowserFinding[]>;
+/** The most requests a page retains for `requests()`; a full log may have lost earlier ones. */
+export declare const RETAINED_REQUESTS: number;
+/** What the browser reported while a page was at one place. */
+export interface HealthReading {
+    readonly findings: readonly BrowserFinding[];
+    /** Whether the request log was full, so earlier requests of the navigation may be missing. */
+    readonly isRequestLogFull: boolean;
+}
+/**
+ * The page errors, console errors and failed requests since the page's last navigation, after which the
+ * stored console and error logs are cleared so the next place starts empty.
+ * @param page the page.
+ * @param place where it is.
+ * @param origins the origins the network guard allows.
+ * @returns the findings, and whether the request log may have lost requests.
+ */
+export declare const healthFindings: (page: Page, place: FindingPlace, origins: readonly string[]) => Promise<HealthReading>;
+/** The findings of every place one page was scanned at, with the exemptions they used and declared. */
+export interface PageScan {
+    readonly findings: readonly BrowserFinding[];
+    readonly used: readonly UsedExemption[];
+    readonly declared: readonly DeclaredExemption[];
+}
+/**
+ * Whether a viewport is one the axe scans and the text-stress passes run at.
+ * @param viewport the viewport.
+ * @returns true for the phone and desktop viewports.
+ */
+export declare const isStressViewport: (viewport: FindingViewport) => boolean;
+/**
+ * Scan a page in place at every required viewport, then restore its viewport.
+ *
+ * What a project's own specification calls on a state the sweep cannot reach. The page is resized
+ * rather than reloaded, so the state the specification drove it into is what is judged. On a Payload
+ * admin view only the view's own content is judged, never Payload's navigation, header or frame.
+ * @param page the page, on the route and in the state to judge.
+ * @param shouldRunAxe whether to run axe as well, at the phone and desktop viewports.
+ * @returns every finding, stale exemptions included.
+ */
+export declare const scanPageInPlace: (page: Page, shouldRunAxe: boolean) => Promise<readonly BrowserFinding[]>;
+/**
+ * Measure the page as it stands at every required viewport, and report what is wrong with its layout,
+ * text and media.
+ *
+ * The page is resized in place rather than reloaded, so whatever state a spec drove it into - a
+ * signed-in view, an open dialog - is what gets measured. Its viewport is restored afterwards.
+ * @param page the page to measure, already on the route and in the state to judge.
+ * @returns one line per defect, empty when there is none.
+ */
+export declare const layoutDefectsOf: (page: Page) => Promise<readonly string[]>;
+/**
+ * Fail the calling test when the page has a layout, text or media defect at any required viewport.
+ *
+ * Call it in a project's own specification for a page the sweep cannot reach - one behind a sign-in,
+ * or one whose address exists only once a record does - after driving the page into the state to judge.
+ * @param page the page to measure.
+ * @returns nothing; it fails the test with one line per defect.
+ */
+export declare const expectNoLayoutDefects: (page: Page) => Promise<void>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAA+B,KAAK,IAAI,EAAgB,MAAM,kBAAkB,CAAA;AACvF,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,iBAAiB,EAGtB,KAAK,YAAY,EACjB,KAAK,eAAe,EAapB,KAAK,UAAU,EAGf,KAAK,cAAc,EAQnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAA;AAwB7B,+FAA+F;AAC/F,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAgD,CAAA;AAE3F,sCAAsC;AACtC,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;CAC9C;AAED,iCAAiC;AACjC,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,MAAsE,CAAA;AAE5G,mEAAmE;AACnE,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,MAAsC,CAAA;AAQ9E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,IAAI,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAGvG,CAAA;AAcD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAU,MAAM,IAAI,EAAE,OAAO,YAAY,KAAG,OAAO,CAAC,SAAS,CAyB1F,CAAA;AAqED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,IAAI,EACV,OAAO,YAAY,EACnB,QAAO,CAAC,OAAO,EAAE,UAAU,KAAK,UAAyD,KACxF,OAAO,CAAC,SAAS,cAAc,EAAE,CA4BnC,CAAA;AAsBD,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,EAAE,MAAY,CAAA;AAE5C,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,8FAA8F;IAC9F,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,IAAI,EACV,OAAO,YAAY,EACnB,SAAS,SAAS,MAAM,EAAE,KACzB,OAAO,CAAC,aAAa,CA2BvB,CAAA;AAED,uGAAuG;AACvG,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,eAAe,KAAG,OAG1D,CAAA;AASH;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM,IAAI,EAAE,cAAc,OAAO,KAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAO1G,CAAA;AAyCD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAG3E,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAU,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAEpE,CAAA"}

package/dist/scanner.js

@@ -0,0 +1,278 @@
+// The one scanner every browser check runs: the managed sweep's passes, and the helpers a project's own
+// specifications call for a state the sweep cannot reach. A page judged through either is judged by the
+// same rules, so a story, a signed-in view and a crawled route cannot disagree about what a defect is.
+//
+// Every verdict is a governance function over measured values. This module measures, and collects what
+// the browser reports, and nothing else.
+import { AxeBuilder } from '@axe-core/playwright';
+import { expect } from '@playwright/test';
+import { axeRulesExcludedAt, consolePageError, distinctFindings, FAILED_REQUEST_RULE, FOCUS_GUARD_RULE, FONT_LOAD_RULE, findDefiniteIncomplete, findingAt, findingLine, findUnloadedFonts, instability, isAllowedRequest, isArray, isFailedStatus, isFocusGuard, judgeLayout, LAYOUT_RULES, PAGE_ERROR_RULE, PAGE_NOT_STABLE_RULE, RESTING_ELEMENT_RULES, reportedText, restingCandidates, STRESS_VIEWPORTS, staleExemptions, } from '@ploaness/governance';
+import { LAYOUT_SCAN_VIEWPORTS, measurePage } from './layout.js';
+import { hasMarkedPayloadView, unmarkPayloadView, VIEW_ROOT_SELECTOR } from './payload-view.js';
+import { projectSettings } from './project-settings.js';
+import { settleForScan } from './settle.js';
+/** Every rule the resting scan applies to elements, for judging which exemptions are stale. */
+export const RESTING_RULES = [...LAYOUT_RULES, ...RESTING_ELEMENT_RULES];
+/** The engine a page runs in. */
+export const engineOf = (page) => page.context().browser()?.browserType().name() ?? 'chromium';
+/** The route path or story a page shows, as a finding names it. */
+export const locationOf = (page) => new URL(page.url()).pathname;
+const SETTLE_MESSAGES = {
+    ceiling: 'the page kept changing until the settle ceiling; nothing measured on it can be trusted',
+    busy: 'a visible aria-busy="true" region never cleared',
+    interrupted: 'the page navigated or closed while it was settling',
+};
+/**
+ * Settle the page, and report a page that did not settle.
+ * @param page the page.
+ * @param place where it is.
+ * @returns a finding, or nothing when the page settled.
+ */
+export const settleFindings = async (page, place) => {
+    const outcome = await settleForScan(page);
+    return outcome === 'settled' ? [] : [findingAt(place, PAGE_NOT_STABLE_RULE, SETTLE_MESSAGES[outcome])];
+};
+// Two measurements inside one frame read the same layout whatever the page is doing, so the second is
+// taken two animation frames after the first: a page that moves between frames shows it.
+const nextFramesInPage = async () => {
+    const frame = async () => {
+        await new Promise((resolve) => {
+            requestAnimationFrame(resolve);
+        });
+    };
+    await frame();
+    await frame();
+};
+/**
+ * Measure a settled page twice, and judge it by the resting rules: L1 to L4, T4, T6 and M1 to M4.
+ *
+ * Geometry that differs between the two measurements is a finding of its own, and the page is then
+ * judged on neither: every other verdict on a page that moves is a coin toss.
+ * @param page the settled page.
+ * @param place where it is.
+ * @returns the findings, the exemptions used and declared, and the measurement.
+ */
+export const judgeRestingPlace = async (page, place) => {
+    const first = await measurePage(page, place.location);
+    await page.evaluate(nextFramesInPage);
+    const second = await measurePage(page, place.location);
+    const moved = instability(first, second);
+    if (moved !== undefined) {
+        return {
+            findings: [findingAt(place, PAGE_NOT_STABLE_RULE, moved)],
+            used: [],
+            declared: [],
+            snapshot: second,
+        };
+    }
+    const judged = judgeLayout(second, place, {
+        minimumGap: projectSettings.layoutMinimumGap,
+        extra: restingCandidates(second),
+    });
+    return {
+        ...judged,
+        findings: [
+            ...judged.findings,
+            ...findUnloadedFonts(second).map((message) => findingAt(place, FONT_LOAD_RULE, message)),
+        ],
+        snapshot: second,
+    };
+};
+// A second copy of axe in the page - a Storybook accessibility addon checking what it rendered - shares
+// axe's one-run-at-a-time lock, so a scan started while that copy runs is refused rather than queued.
+const AXE_BUSY = 'Axe is already running';
+const AXE_BUSY_RETRIES = 20;
+const AXE_BUSY_WAIT_MS = 250;
+const analyzed = async (page, builder, retries) => {
+    try {
+        return await builder.analyze();
+    }
+    catch (error) {
+        if (retries <= 0 || !(error instanceof Error && error.message.includes(AXE_BUSY))) {
+            throw error;
+        }
+        await page.waitForTimeout(AXE_BUSY_WAIT_MS);
+        return await analyzed(page, builder, retries - 1);
+    }
+};
+const axeTarget = (target) => (isArray(target) ? target.map(String).join(' ') : String(target));
+// Focus each element of the reported subtree that Tab can reach, and read where focus rests once the
+// page's own focus handlers have run, which a focus guard does synchronously. The focus the page had
+// is given back after each one.
+const focusArrivalsInPage = (selector) => {
+    const subtree = document.querySelector(selector);
+    if (subtree === null) {
+        return [];
+    }
+    const previous = document.activeElement;
+    return [subtree, ...Array.from(subtree.querySelectorAll('*'))]
+        .filter((element) => element.tabIndex >= 0 && !element.hasAttribute('disabled'))
+        .map((element) => {
+        element.focus({ preventScroll: true });
+        const active = document.activeElement;
+        const arrival = {
+            staysInSubtree: active !== null && subtree.contains(active),
+            restsOnBody: active === null || active === document.body,
+            restsHidden: active?.closest('[aria-hidden="true"]') !== null,
+        };
+        previous?.focus({ preventScroll: true });
+        return arrival;
+    });
+};
+// A subtree named by more than one selector lies inside a frame or a shadow root the probe cannot
+// address from the document, so it stays reported.
+const isFocusGuardAt = async (page, target) => isArray(target) &&
+    target.length === 1 &&
+    typeof target[0] === 'string' &&
+    isFocusGuard(await page.evaluate(focusArrivalsInPage, target[0]));
+const reportedNodes = async (page, violation) => {
+    if (violation.id !== FOCUS_GUARD_RULE) {
+        return violation.nodes;
+    }
+    const guards = await Promise.all(violation.nodes.map(async (node) => await isFocusGuardAt(page, node.target)));
+    return violation.nodes.filter((_node, index) => guards[index] !== true);
+};
+/**
+ * The axe scan of a page as findings, one per violating element.
+ * @param page the settled page.
+ * @param place where it is.
+ * @param build narrows the builder, for a scan of one rule or one element.
+ * @returns the findings.
+ */
+export const axeFindings = async (page, place, build = (builder) => builder) => {
+    const excluded = axeRulesExcludedAt(place.location);
+    const builder = build(new AxeBuilder({ page }));
+    const results = await analyzed(page, excluded.length === 0 ? builder : builder.disableRules([...excluded]), AXE_BUSY_RETRIES);
+    const reported = await Promise.all(results.violations.map(async (violation) => await reportedNodes(page, violation)));
+    return [
+        ...results.violations.flatMap((violation, index) => (reported[index] ?? []).map((node) => findingAt(place, `axe:${violation.id}`, `${violation.help}: ${axeTarget(node.target)} - ${reportedText(node.failureSummary ?? '')}`))),
+        ...findDefiniteIncomplete(results.incomplete).map((message) => findingAt(place, 'axe:incomplete', message)),
+    ];
+};
+// A request cancelled because the page moved on is not a failure of the page.
+const CANCELLED = /ERR_ABORTED|NS_BINDING_ABORTED|cancelled/iu;
+const requestFinding = (place, request, origins) => {
+    const url = request.url();
+    if (!isAllowedRequest(url, origins)) {
+        return [findingAt(place, FAILED_REQUEST_RULE, `${request.method()} ${url} was blocked by the network guard`)];
+    }
+    const failure = request.failure();
+    if (failure !== null) {
+        return CANCELLED.test(failure.errorText)
+            ? []
+            : [findingAt(place, FAILED_REQUEST_RULE, `${request.method()} ${url} failed: ${failure.errorText}`)];
+    }
+    const status = request.existingResponse()?.status();
+    return status !== undefined && isFailedStatus(status)
+        ? [findingAt(place, FAILED_REQUEST_RULE, `${request.method()} ${url} answered ${String(status)}`)]
+        : [];
+};
+/** The most requests a page retains for `requests()`; a full log may have lost earlier ones. */
+export const RETAINED_REQUESTS = 100;
+/**
+ * The page errors, console errors and failed requests since the page's last navigation, after which the
+ * stored console and error logs are cleared so the next place starts empty.
+ * @param page the page.
+ * @param place where it is.
+ * @param origins the origins the network guard allows.
+ * @returns the findings, and whether the request log may have lost requests.
+ */
+export const healthFindings = async (page, place, origins) => {
+    const errors = await page.pageErrors();
+    const logged = await page.consoleMessages();
+    const messages = logged.map((message) => ({ type: message.type(), text: message.text() }));
+    const requests = await page.requests();
+    const lastNavigation = requests.findLastIndex((request) => request.isNavigationRequest() && request.frame() === page.mainFrame());
+    await page.clearPageErrors();
+    await page.clearConsoleMessages();
+    return {
+        findings: distinctFindings([
+            ...errors.map((error) => findingAt(place, PAGE_ERROR_RULE, `uncaught ${reportedText(String(error))}`)),
+            ...messages.flatMap((entry) => {
+                const message = consolePageError(entry);
+                return message === undefined ? [] : [findingAt(place, PAGE_ERROR_RULE, reportedText(message))];
+            }),
+            ...requests
+                .slice(Math.max(0, lastNavigation))
+                .flatMap((request) => requestFinding(place, request, origins)),
+        ]),
+        isRequestLogFull: requests.length >= RETAINED_REQUESTS && lastNavigation <= 0,
+    };
+};
+/**
+ * Whether a viewport is one the axe scans and the text-stress passes run at.
+ * @param viewport the viewport.
+ * @returns true for the phone and desktop viewports.
+ */
+export const isStressViewport = (viewport) => STRESS_VIEWPORTS.some((stress) => stress.width === viewport.width && stress.height === viewport.height);
+const placeOf = (page, viewport, state) => ({
+    location: locationOf(page),
+    state,
+    engine: engineOf(page),
+    viewport,
+});
+/**
+ * Scan a page in place at every required viewport, then restore its viewport.
+ *
+ * What a project's own specification calls on a state the sweep cannot reach. The page is resized
+ * rather than reloaded, so the state the specification drove it into is what is judged. On a Payload
+ * admin view only the view's own content is judged, never Payload's navigation, header or frame.
+ * @param page the page, on the route and in the state to judge.
+ * @param shouldRunAxe whether to run axe as well, at the phone and desktop viewports.
+ * @returns every finding, stale exemptions included.
+ */
+export const scanPageInPlace = async (page, shouldRunAxe) => {
+    const isView = await hasMarkedPayloadView(page);
+    try {
+        return await scanMarkedPage(page, shouldRunAxe, isView);
+    }
+    finally {
+        await unmarkPayloadView(page);
+    }
+};
+const scanMarkedPage = async (page, shouldRunAxe, isView) => {
+    const original = page.viewportSize();
+    const scans = await LAYOUT_SCAN_VIEWPORTS.reduce(async (earlier, viewport) => {
+        const done = await earlier;
+        await page.setViewportSize(viewport);
+        const place = placeOf(page, viewport, 'resting');
+        const unsettled = await settleFindings(page, place);
+        const judged = await judgeRestingPlace(page, place);
+        const axe = shouldRunAxe && isStressViewport(viewport)
+            ? await axeFindings(page, place, (builder) => (isView ? builder.include(VIEW_ROOT_SELECTOR) : builder))
+            : [];
+        return [...done, { ...judged, findings: [...unsettled, ...judged.findings, ...axe] }];
+    }, Promise.resolve([]));
+    if (original !== null) {
+        await page.setViewportSize(original);
+    }
+    return distinctFindings([
+        ...scans.flatMap((scan) => scan.findings),
+        ...staleExemptions(scans.flatMap((scan) => scan.declared), scans.flatMap((scan) => scan.used), RESTING_RULES, engineOf(page)),
+    ]);
+};
+/**
+ * Measure the page as it stands at every required viewport, and report what is wrong with its layout,
+ * text and media.
+ *
+ * The page is resized in place rather than reloaded, so whatever state a spec drove it into - a
+ * signed-in view, an open dialog - is what gets measured. Its viewport is restored afterwards.
+ * @param page the page to measure, already on the route and in the state to judge.
+ * @returns one line per defect, empty when there is none.
+ */
+export const layoutDefectsOf = async (page) => {
+    const findings = await scanPageInPlace(page, false);
+    return findings.map((finding) => findingLine(finding));
+};
+/**
+ * Fail the calling test when the page has a layout, text or media defect at any required viewport.
+ *
+ * Call it in a project's own specification for a page the sweep cannot reach - one behind a sign-in,
+ * or one whose address exists only once a record does - after driving the page into the state to judge.
+ * @param page the page to measure.
+ * @returns nothing; it fails the test with one line per defect.
+ */
+export const expectNoLayoutDefects = async (page) => {
+    expect(await layoutDefectsOf(page), `layout defects on ${locationOf(page)}`).toEqual([]);
+};
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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