@setsquare/review-sdk 0.0.1

package/dist/screens.d.ts

@@ -0,0 +1,98 @@
+import type { TestOutcome } from './envelope.js';
+import { type ShotGroup } from './shots.js';
+/**
+ * The visual contact sheet: every capture a run produced, under the name of the
+ * test that produced it, on one scrollable page.
+ *
+ * The problem it solves is narrow and real. Playwright takes the screenshots
+ * already, but reading them means opening its report and clicking into each test
+ * in turn — so nobody scans them, and a change that visibly broke a page passes
+ * review because all the assertions still held. A QA or a developer wants one
+ * page they can scroll in thirty seconds. That is all this is.
+ *
+ * What it is NOT, said plainly and said in the page itself: a verdict. Setsquare
+ * compares nothing — no baselines, no history, no "changed since last week",
+ * which is the platform's job and deliberately not the local tool's. Where a
+ * comparison appears here, Playwright's `toHaveScreenshot()` made it and we
+ * found the expected/actual/diff trio it attached. Everything else is a picture
+ * with a caption, offered to a person who can judge it.
+ *
+ * Rendered from data with no clock and no filesystem reads, so two renders of
+ * one run are byte-identical; the same fragment is embedded in the accessibility
+ * report and served standalone, so the two can never drift apart.
+ */
+export interface ScreenRow {
+    testId: string;
+    title: string;
+    project?: string | undefined;
+    /** The run-group lane this test came from, when the run was merged. */
+    lane?: string | undefined;
+    status: TestOutcome['status'];
+    retry: number;
+    groups: ShotGroup[];
+}
+/**
+ * Which tests appear, and in what order.
+ *
+ * Ordered by how likely the reader is to care, not alphabetically: comparisons
+ * Playwright flagged come first, then tests that failed or timed out, then
+ * everything else in the order it ran. A contact sheet is scanned from the top
+ * and abandoned somewhere in the middle, so what goes at the top decides
+ * whether it did any good.
+ *
+ * Tests with no captures are omitted entirely rather than listed empty — the
+ * page's own header says how many tests had nothing, which is the honest place
+ * for that number.
+ */
+export declare function screenRows(outcomes: readonly TestOutcome[]): ScreenRow[];
+/**
+ * A path to a file on disk, as an `src` a browser opening the report from disk
+ * can follow.
+ *
+ * Relative, always: the reports are meant to be zipped, attached to a ticket and
+ * opened somewhere else, and an absolute `/Users/someone/...` would break the
+ * moment it left the machine that wrote it. Encoded per segment because a spec
+ * title becomes a directory name, and test titles contain spaces, brackets and
+ * occasionally a `#` — which would otherwise truncate the URL at the fragment.
+ */
+export declare function shotSrc(runDir: string, path: string): string;
+export interface ScreensInput {
+    rows: ScreenRow[];
+    /** Directory the HTML lands in. Every `src` is computed relative to it. */
+    runDir: string;
+    /** How many of the run's tests produced no capture at all. */
+    testsWithoutShots: number;
+    generatedAt: string;
+    branch: string;
+    commit: string;
+    /** Anything the sheet could not show, named rather than omitted. */
+    notes?: string[];
+}
+/**
+ * The styles the section needs, exported because the section has two homes.
+ *
+ * The contact sheet is both a standalone page and a section of the
+ * accessibility report, and a copied rule block is a rule block that drifts —
+ * so both documents include this string instead of describing the same layout
+ * twice.
+ */
+export declare const SCREENS_CSS = "\n  .shot-test { border: 1px solid var(--line); border-radius: 8px; padding: .75rem 1rem; margin: 1rem 0; }\n  .shot-test > h3 { font-size: 1rem; margin: 0 0 .1rem; overflow-wrap: anywhere; }\n  .shot-meta { color: var(--muted); font-size: .875rem; margin: 0 0 .75rem; }\n  .shot-strip { display: flex; flex-wrap: wrap; gap: 1rem; margin: 0; padding: 0; }\n  .shot-strip.compare { border: 1px dashed var(--line); border-radius: 8px; padding: .75rem; }\n  .shot { margin: 0; flex: 1 1 22rem; min-width: 0; }\n  .shot img {\n    display: block; width: 100%; height: auto; border: 1px solid var(--line);\n    border-radius: 4px; background: var(--code-bg);\n    /*\n     * Capped so one full-page capture of a long page cannot push every other\n     * test off the screen. It scales rather than crops, because a visual\n     * review tool that hides part of the picture is worse than none. The image\n     * links to itself for a full-size look.\n     */\n    max-height: 28rem; object-fit: contain; object-position: top;\n  }\n  .shot figcaption { font-size: .8125rem; color: var(--muted); margin-top: .35rem; overflow-wrap: anywhere; }\n  .shot figcaption .role { color: var(--fg); font-weight: 600; }\n  .compare-label { font-size: .8125rem; font-weight: 600; margin: 0 0 .5rem; }\n";
+/**
+ * The section, embeddable in any document that includes `SCREENS_CSS`.
+ *
+ * Takes its heading level as given: `h2` for the section, `h3` per test, which
+ * is correct both standalone and inside the accessibility report. A section that
+ * chose its own levels would break the heading order of one of its two homes.
+ */
+export declare function renderScreensSection(input: ScreensInput): string;
+/**
+ * The standalone page.
+ *
+ * Its own file rather than only a section of the accessibility report, because
+ * the audiences are different: this one is opened by whoever is about to say
+ * "looks fine to me", and it should not arrive wrapped in a WCAG conformance
+ * document. Same palette, same section, no JavaScript, no external requests —
+ * the images are the only thing it loads, and they are local files.
+ */
+export declare function renderScreensPage(input: ScreensInput): string;
+//# sourceMappingURL=screens.d.ts.map

package/dist/screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../src/screens.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAyB,KAAK,SAAS,EAAiB,MAAM,YAAY,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAwBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,EAAE,CA8BxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,uwCAqBvB,CAAC;AA2GF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAuChE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAwD7D"}

package/dist/screens.js

@@ -0,0 +1,301 @@
+import { relative, sep } from 'node:path';
+import { BRAND_CSS, MASTHEAD_CSS, masthead } from './brand.js';
+import { esc } from './escape.js';
+import { humanInstant, shortCommit } from './human.js';
+import { groupShots } from './shots.js';
+const ROLE_LABEL = {
+    expected: 'Expected (committed baseline)',
+    previous: 'Previous attempt',
+    actual: 'Actual (this run)',
+    diff: 'Difference',
+    shot: 'Capture',
+};
+const STATUS_WORD = {
+    passed: 'passed',
+    failed: 'failed',
+    timedOut: 'timed out',
+    skipped: 'skipped',
+};
+const STATUS_CLASS = {
+    passed: 'ok',
+    failed: 'bad',
+    timedOut: 'bad',
+    skipped: 'muted',
+};
+/**
+ * Which tests appear, and in what order.
+ *
+ * Ordered by how likely the reader is to care, not alphabetically: comparisons
+ * Playwright flagged come first, then tests that failed or timed out, then
+ * everything else in the order it ran. A contact sheet is scanned from the top
+ * and abandoned somewhere in the middle, so what goes at the top decides
+ * whether it did any good.
+ *
+ * Tests with no captures are omitted entirely rather than listed empty — the
+ * page's own header says how many tests had nothing, which is the honest place
+ * for that number.
+ */
+export function screenRows(outcomes) {
+    const rows = [];
+    for (const outcome of outcomes) {
+        const shots = outcome.shots ?? [];
+        if (shots.length === 0)
+            continue;
+        rows.push({
+            testId: outcome.testId,
+            title: outcome.title,
+            ...(outcome.project ? { project: outcome.project } : {}),
+            ...(outcome.lane ? { lane: outcome.lane } : {}),
+            status: outcome.status,
+            retry: outcome.retry,
+            groups: groupShots(shots),
+        });
+    }
+    const rank = (row) => {
+        if (row.groups.some((group) => group.comparison))
+            return 0;
+        if (row.status === 'failed' || row.status === 'timedOut')
+            return 1;
+        return 2;
+    };
+    // A stable sort by rank only: within a bucket the run's own order survives,
+    // which for a walkthrough is the order the flow happened in.
+    return rows
+        .map((row, index) => ({ row, index }))
+        .sort((a, b) => rank(a.row) - rank(b.row) || a.index - b.index)
+        .map((entry) => entry.row);
+}
+/**
+ * A path to a file on disk, as an `src` a browser opening the report from disk
+ * can follow.
+ *
+ * Relative, always: the reports are meant to be zipped, attached to a ticket and
+ * opened somewhere else, and an absolute `/Users/someone/...` would break the
+ * moment it left the machine that wrote it. Encoded per segment because a spec
+ * title becomes a directory name, and test titles contain spaces, brackets and
+ * occasionally a `#` — which would otherwise truncate the URL at the fragment.
+ */
+export function shotSrc(runDir, path) {
+    return relative(runDir, path)
+        .split(sep)
+        .map((segment) => (segment === '..' ? segment : encodeURIComponent(segment)))
+        .join('/');
+}
+/**
+ * The styles the section needs, exported because the section has two homes.
+ *
+ * The contact sheet is both a standalone page and a section of the
+ * accessibility report, and a copied rule block is a rule block that drifts —
+ * so both documents include this string instead of describing the same layout
+ * twice.
+ */
+export const SCREENS_CSS = `
+  .shot-test { border: 1px solid var(--line); border-radius: 8px; padding: .75rem 1rem; margin: 1rem 0; }
+  .shot-test > h3 { font-size: 1rem; margin: 0 0 .1rem; overflow-wrap: anywhere; }
+  .shot-meta { color: var(--muted); font-size: .875rem; margin: 0 0 .75rem; }
+  .shot-strip { display: flex; flex-wrap: wrap; gap: 1rem; margin: 0; padding: 0; }
+  .shot-strip.compare { border: 1px dashed var(--line); border-radius: 8px; padding: .75rem; }
+  .shot { margin: 0; flex: 1 1 22rem; min-width: 0; }
+  .shot img {
+    display: block; width: 100%; height: auto; border: 1px solid var(--line);
+    border-radius: 4px; background: var(--code-bg);
+    /*
+     * Capped so one full-page capture of a long page cannot push every other
+     * test off the screen. It scales rather than crops, because a visual
+     * review tool that hides part of the picture is worse than none. The image
+     * links to itself for a full-size look.
+     */
+    max-height: 28rem; object-fit: contain; object-position: top;
+  }
+  .shot figcaption { font-size: .8125rem; color: var(--muted); margin-top: .35rem; overflow-wrap: anywhere; }
+  .shot figcaption .role { color: var(--fg); font-weight: 600; }
+  .compare-label { font-size: .8125rem; font-weight: 600; margin: 0 0 .5rem; }
+`;
+function shotFigure(runDir, shot, testTitle, labelled) {
+    const src = shotSrc(runDir, shot.path);
+    /*
+     * Alt text names the capture; it does not describe it, because nothing here
+     * knows what is in the pixels and inventing a description would be worse than
+     * having none. The caption carries the file name and the link, so the two are
+     * not the same sentence read twice.
+     */
+    const alt = `Screenshot ${shot.name} from the test “${testTitle}”. This report cannot describe what the image shows.`;
+    const role = labelled ? `<span class="role">${esc(ROLE_LABEL[shot.role])}</span> — ` : '';
+    return `<figure class="shot">
+            <a href="${esc(src)}"><img src="${esc(src)}" alt="${esc(alt)}" loading="lazy"></a>
+            <figcaption>${role}${esc(shot.name)}</figcaption>
+          </figure>`;
+}
+/**
+ * A comparison, boxed and captioned so the three images read as one statement.
+ *
+ * Its own block, always: a diff sitting loose in a strip of unrelated captures
+ * is a diff nobody realises is a diff.
+ */
+function comparisonBlock(runDir, group, testTitle) {
+    const figures = group.shots
+        .map((shot) => shotFigure(runDir, shot, testTitle, true))
+        .join('\n            ');
+    return `<div>
+          <p class="compare-label">Playwright compared <code>${esc(group.base)}</code> against its committed baseline.</p>
+          <div class="shot-strip compare">
+            ${figures}
+          </div>
+        </div>`;
+}
+/**
+ * Consecutive standalone captures share one strip.
+ *
+ * They are the steps of a flow, and the whole value of the sheet is seeing them
+ * beside each other — a strip per capture would stack them vertically and turn a
+ * walkthrough back into the scrolling exercise this page exists to replace.
+ * A comparison interrupts the strip, because it is a different kind of claim.
+ */
+function stripBlock(runDir, groups, testTitle) {
+    const figures = groups
+        .flatMap((group) => group.shots.map((shot) => shotFigure(runDir, shot, testTitle, false)))
+        .join('\n          ');
+    return `<div class="shot-strip">\n          ${figures}\n        </div>`;
+}
+function rowBlock(runDir, row) {
+    const meta = [
+        `<span class="${STATUS_CLASS[row.status]}">${STATUS_WORD[row.status]}</span>`,
+        ...(row.retry > 0 ? [`retry ${row.retry}`] : []),
+        ...(row.project ? [esc(row.project)] : []),
+        ...(row.lane ? [`lane ${esc(row.lane)}`] : []),
+    ].join(' · ');
+    /*
+     * Runs of standalone captures collapse into one strip; each comparison stands
+     * alone. Built as a fold rather than a map because the unit of layout is a run
+     * of groups, not a group.
+     */
+    const blocks = [];
+    let pending = [];
+    const flush = () => {
+        if (pending.length > 0)
+            blocks.push(stripBlock(runDir, pending, row.title));
+        pending = [];
+    };
+    for (const group of row.groups) {
+        if (group.comparison) {
+            flush();
+            blocks.push(comparisonBlock(runDir, group, row.title));
+        }
+        else {
+            pending.push(group);
+        }
+    }
+    flush();
+    return `      <article class="shot-test">
+        <h3>${esc(row.title)}</h3>
+        <p class="shot-meta">${meta}<br>${esc(row.testId)}</p>
+        ${blocks.join('\n        ')}
+      </article>`;
+}
+/** How to get captures, for a run that produced none. Shown, never assumed known. */
+const HOW_TO_CAPTURE = `<p>Nothing to show: this run produced no screenshots. Setsquare never takes them —
+    it indexes the ones Playwright already wrote. Three ways to give it something to index:</p>
+    <ul>
+      <li><code>use: { screenshot: 'on' }</code> in your Playwright config. One capture per test, and no
+      other change to your suite.</li>
+      <li><code>await expect(page).toHaveScreenshot()</code>. Playwright compares against a committed
+      baseline, and this page puts expected, actual and difference side by side.</li>
+      <li>Attach your own at the moments that matter, with
+      <code>testInfo.attach(name, { path })</code> — which turns this page into a step-by-step
+      walkthrough of the flow. The README has the four-line helper.</li>
+    </ul>
+    <p class="muted">An attachment given a <code>body</code> rather than a <code>path</code> stays in
+    Playwright's memory and never reaches disk, so this sheet cannot link to it.</p>`;
+/**
+ * The section, embeddable in any document that includes `SCREENS_CSS`.
+ *
+ * Takes its heading level as given: `h2` for the section, `h3` per test, which
+ * is correct both standalone and inside the accessibility report. A section that
+ * chose its own levels would break the heading order of one of its two homes.
+ */
+export function renderScreensSection(input) {
+    const shots = input.rows.reduce((total, row) => total + row.groups.reduce((n, group) => n + group.shots.length, 0), 0);
+    const comparisons = input.rows.reduce((total, row) => total + row.groups.filter((group) => group.comparison).length, 0);
+    const notes = (input.notes ?? []).filter((note) => note.length > 0);
+    const header = input.rows.length === 0
+        ? HOW_TO_CAPTURE
+        : `<p>${shots} capture${shots === 1 ? '' : 's'} from ${input.rows.length} test${input.rows.length === 1 ? '' : 's'}${input.testsWithoutShots > 0
+            ? `; ${input.testsWithoutShots} test${input.testsWithoutShots === 1 ? '' : 's'} in this run produced none`
+            : ''}. ${comparisons > 0
+            ? `${comparisons} of them ${comparisons === 1 ? 'is a comparison' : 'are comparisons'} Playwright made against a committed baseline.`
+            : 'None of them is a comparison — Playwright had no committed baseline to check against.'}</p>
+    <p class="muted">Setsquare compares nothing and stores no baseline. This page shows you what the
+    run saw so a person can spot what automation cannot: nothing here is a pass or a failure.</p>`;
+    const noteBlock = notes.length > 0
+        ? `\n    <ul class="muted">\n      ${notes.map((note) => `<li>${esc(note)}</li>`).join('\n      ')}\n    </ul>`
+        : '';
+    return `  <section aria-labelledby="h-screens">
+    <h2 id="h-screens">Screens <span class="muted">(what the run saw)</span></h2>
+    ${header}${noteBlock}
+${input.rows.map((row) => rowBlock(input.runDir, row)).join('\n')}
+  </section>`;
+}
+/**
+ * The standalone page.
+ *
+ * Its own file rather than only a section of the accessibility report, because
+ * the audiences are different: this one is opened by whoever is about to say
+ * "looks fine to me", and it should not arrive wrapped in a WCAG conformance
+ * document. Same palette, same section, no JavaScript, no external requests —
+ * the images are the only thing it loads, and they are local files.
+ */
+export function renderScreensPage(input) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>Setsquare — screens, ${esc(humanInstant(input.generatedAt))}</title>
+<style>
+${BRAND_CSS}
+  /*
+   * The page's own names, mapped onto brand roles. Mapping rather than renaming
+   * every rule below keeps the diff to this block, and keeps one place to look
+   * when a role changes.
+   */
+  :root {
+    --bg: var(--ss-surface); --fg: var(--ss-ink); --muted: var(--ss-ink-muted);
+    --line: var(--ss-border); --code-bg: var(--ss-surface-raised);
+    --bad-fg: var(--ss-danger); --good-fg: var(--ss-success);
+  }
+${MASTHEAD_CSS}
+  * { box-sizing: border-box; }
+  body {
+    margin: 0 auto; padding: 2rem 1.5rem 4rem; max-width: 78rem;
+    background: var(--bg); color: var(--fg);
+    font: 16px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif;
+  }
+  h1 { font-size: 1.6rem; margin: 0 0 .25rem; }
+  h2 { font-size: 1.2rem; margin: 2rem 0 .75rem; }
+  a { color: inherit; }
+  :focus-visible { outline: 3px solid var(--fg); outline-offset: 2px; }
+  code { background: var(--code-bg); padding: .1em .35em; border-radius: 4px; font-size: .875em; overflow-wrap: anywhere; }
+  .muted { color: var(--muted); }
+  .ok { color: var(--good-fg); }
+  .bad { color: var(--bad-fg); font-weight: 600; }
+  footer { margin-top: 3rem; padding-top: 1rem; border-top: 1px solid var(--line); color: var(--muted); font-size: .875rem; }
+${SCREENS_CSS}
+</style>
+</head>
+<body>
+${masthead('Setsquare — screens', `<time datetime="${esc(input.generatedAt)}">${esc(humanInstant(input.generatedAt))}</time>` +
+        ` · ${esc(input.branch)} @ ${esc(shortCommit(input.commit))}`)}
+<main>
+${renderScreensSection(input)}
+</main>
+<footer>
+  <p>Every image on this page was written by Playwright, and is linked where it lies. Setsquare took
+  no screenshot, wrote no image, and copied nothing — which is why no unmasked capture can reach your
+  disk through it, and why it cannot tell you whether any of this changed.</p>
+</footer>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=screens.js.map

package/dist/screens.js.map

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

package/dist/settle.d.ts

@@ -0,0 +1,65 @@
+/**
+ * "Settled navigation" — the definition auto-scan fires on.
+ *
+ * This is the riskiest heuristic in the SDK, and the failure it guards against is
+ * not a crash. It is a **confident false pass**: scan a page before its content
+ * arrives, find nothing, and report conformance nobody verified. An evidence
+ * product can survive missing a finding; it cannot survive inventing a clean one.
+ *
+ * The reference implementation's own Playwright config warns about exactly this
+ * ("an uncompiled route renders a shell that passes every rule") and pays for a
+ * whole warmup project to avoid it. Our fixture site reproduces it deliberately:
+ * `/slow` renders a perfectly conformant shell and injects two violations a
+ * second later.
+ *
+ * A page is settled when ALL of these hold:
+ *
+ *   1. `document.readyState === 'complete'`
+ *   2. the URL has not changed for `quietMs`
+ *   3. no DOM mutations for `quietMs`
+ *
+ * with a hard ceiling of `settleTimeoutMs`. **On the ceiling we scan anyway and
+ * say so** (`settleTimedOut`), rather than skipping: a page that never goes quiet
+ * — a spinner, a poller, a carousel — is extremely common, and silently declining
+ * to scan it would produce exactly the "no findings" that looks like "no
+ * problems".
+ *
+ * Every scan carries its settle diagnostics, so a suspicious result is
+ * identifiable in the evidence rather than silently trusted.
+ */
+/** Name of the page-side callback the SDK exposes. Namespaced; documented pollution. */
+export declare const MUTATION_TOTAL = "__setsquareMutationTotal";
+export declare const SETTLE_BINDING = "__setsquareSettle";
+export interface SettleSignal {
+    url: string;
+    /** Why the scan is firing now — a quiet page, or the ceiling running out. */
+    reason: 'quiet' | 'ceiling' | 'teardown';
+    /** How the URL was reached. A pushState route change is not a navigation. */
+    via?: 'load' | 'route-change';
+    /** Milliseconds from the navigation to this signal. */
+    sinceNavMs: number;
+    /** DOM mutations counted since the navigation. Cheap signal of how busy the page was. */
+    mutations: number;
+    /** True when the ceiling fired rather than the page going quiet. */
+    settleTimedOut: boolean;
+}
+export interface SettleConfig {
+    quietMs: number;
+    settleTimeoutMs: number;
+}
+export declare const DEFAULT_SETTLE: SettleConfig;
+/**
+ * The in-page detector.
+ *
+ * Written as a string rather than a function because `addInitScript` serialises
+ * it into a context that has none of this module's scope, and because the config
+ * values are interpolated at install time — there is no channel to pass arguments
+ * to an init script that runs before every navigation.
+ *
+ * Deliberately defensive throughout: this runs inside a customer's page, before
+ * their own scripts, on every navigation. It must never throw, never retain
+ * anything large, and never be observable in a way that changes their app's
+ * behaviour.
+ */
+export declare function settleScript(config: SettleConfig): string;
+//# sourceMappingURL=settle.d.ts.map

package/dist/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,wFAAwF;AACxF,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACzC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC9B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,YAoB5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA8FzD"}

package/dist/settle.js

@@ -0,0 +1,162 @@
+/**
+ * "Settled navigation" — the definition auto-scan fires on.
+ *
+ * This is the riskiest heuristic in the SDK, and the failure it guards against is
+ * not a crash. It is a **confident false pass**: scan a page before its content
+ * arrives, find nothing, and report conformance nobody verified. An evidence
+ * product can survive missing a finding; it cannot survive inventing a clean one.
+ *
+ * The reference implementation's own Playwright config warns about exactly this
+ * ("an uncompiled route renders a shell that passes every rule") and pays for a
+ * whole warmup project to avoid it. Our fixture site reproduces it deliberately:
+ * `/slow` renders a perfectly conformant shell and injects two violations a
+ * second later.
+ *
+ * A page is settled when ALL of these hold:
+ *
+ *   1. `document.readyState === 'complete'`
+ *   2. the URL has not changed for `quietMs`
+ *   3. no DOM mutations for `quietMs`
+ *
+ * with a hard ceiling of `settleTimeoutMs`. **On the ceiling we scan anyway and
+ * say so** (`settleTimedOut`), rather than skipping: a page that never goes quiet
+ * — a spinner, a poller, a carousel — is extremely common, and silently declining
+ * to scan it would produce exactly the "no findings" that looks like "no
+ * problems".
+ *
+ * Every scan carries its settle diagnostics, so a suspicious result is
+ * identifiable in the evidence rather than silently trusted.
+ */
+/** Name of the page-side callback the SDK exposes. Namespaced; documented pollution. */
+export const MUTATION_TOTAL = '__setsquareMutationTotal';
+export const SETTLE_BINDING = '__setsquareSettle';
+export const DEFAULT_SETTLE = {
+    /*
+     * 500ms rather than something snappier.
+     *
+     * A shorter window lands inside the gap between a shell rendering and its
+     * content arriving, which is precisely the trap. Measured against the fixture
+     * site's `/slow` route, which injects its violations after 1000ms: at 250ms the
+     * scanner reports a clean page, at 500ms plus the ceiling it does not.
+     */
+    quietMs: 500,
+    /*
+     * 5s, and it is a scan trigger rather than a give-up.
+     *
+     * Long enough for a slow route to finish, short enough that a permanently
+     * animating page does not stall the suite. The reference implementation allows
+     * 120s for a cold navigation, so this ceiling will fire there — which is the
+     * correct outcome: scan what is on screen, and record that the page never went
+     * quiet.
+     */
+    settleTimeoutMs: 5000,
+};
+/**
+ * The in-page detector.
+ *
+ * Written as a string rather than a function because `addInitScript` serialises
+ * it into a context that has none of this module's scope, and because the config
+ * values are interpolated at install time — there is no channel to pass arguments
+ * to an init script that runs before every navigation.
+ *
+ * Deliberately defensive throughout: this runs inside a customer's page, before
+ * their own scripts, on every navigation. It must never throw, never retain
+ * anything large, and never be observable in a way that changes their app's
+ * behaviour.
+ */
+export function settleScript(config) {
+    return `
+(() => {
+  if (window.__setsquareSettleInstalled) return;
+  Object.defineProperty(window, '__setsquareSettleInstalled', {
+    value: true, enumerable: false, configurable: true,
+  });
+
+  const QUIET = ${config.quietMs};
+  const CEILING = ${config.settleTimeoutMs};
+
+  let quietTimer;
+  let ceilingTimer;
+  let navigatedAt = Date.now();
+  let mutations = 0;
+  let fired = false;
+  // Monotonic across the document lifetime, NOT reset per navigation: the
+  // teardown sweep uses it to decide whether a page changed after being scanned.
+  window.__setsquareMutationTotal = 0;
+  let via = 'load';
+
+  const report = (reason) => {
+    if (fired) return;
+    fired = true;
+    clearTimeout(quietTimer);
+    clearTimeout(ceilingTimer);
+
+    try {
+      // The binding is installed by the SDK. If it is missing — a page that
+      // reloaded before installation completed — there is nothing to do and
+      // certainly nothing worth throwing over.
+      if (typeof window.${SETTLE_BINDING} === 'function') {
+        window.${SETTLE_BINDING}({
+          url: location.href,
+          reason,
+          via,
+          sinceNavMs: Date.now() - navigatedAt,
+          mutations,
+          settleTimedOut: reason === 'ceiling',
+        });
+      }
+    } catch {}
+  };
+
+  const scheduleQuiet = () => {
+    clearTimeout(quietTimer);
+    quietTimer = setTimeout(() => {
+      // readyState is checked HERE rather than as a precondition, so a page that
+      // goes quiet while still loading keeps waiting instead of being scanned
+      // half-built.
+      if (document.readyState === 'complete') report('quiet');
+      else scheduleQuiet();
+    }, QUIET);
+  };
+
+  const restart = (kind) => {
+    via = kind;
+    fired = false;
+    navigatedAt = Date.now();
+    mutations = 0;
+    clearTimeout(ceilingTimer);
+    ceilingTimer = setTimeout(() => report('ceiling'), CEILING);
+    scheduleQuiet();
+  };
+
+  try {
+    // Observing \`document\` rather than \`document.documentElement\`: an init
+    // script runs before the element exists, and a subtree observer on the
+    // document sees everything anyway.
+    new MutationObserver((records) => {
+      mutations += records.length;
+      window.__setsquareMutationTotal += records.length;
+      // Any mutation restarts the quiet window. This is what makes the scanner
+      // wait for late content instead of auditing a shell.
+      scheduleQuiet();
+    }).observe(document, {
+      subtree: true, childList: true, attributes: true, characterData: true,
+    });
+  } catch {}
+
+  for (const method of ['pushState', 'replaceState']) {
+    const original = history[method];
+    history[method] = function (...args) {
+      const result = original.apply(this, args);
+      try { restart('route-change'); } catch {}
+      return result;
+    };
+  }
+
+  window.addEventListener('popstate', () => { try { restart('route-change'); } catch {} });
+
+  restart('load');
+})();
+`;
+}
+//# sourceMappingURL=settle.js.map

package/dist/settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.js","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAqBlD,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C;;;;;;;OAOG;IACH,OAAO,EAAE,GAAG;IACZ;;;;;;;;OAQG;IACH,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO;;;;;;;kBAOS,MAAM,CAAC,OAAO;oBACZ,MAAM,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;;;0BAsBhB,cAAc;iBACvB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D9B,CAAC;AACF,CAAC"}