@setsquare/review-sdk 0.0.1

package/dist/insights.js

@@ -0,0 +1,483 @@
+import { axisVariance, documentConsistency, gridCoverage, sharedSelectorCandidates, } from '@setsquare/schema/conformance';
+const plural = (count, one, many) => (count === 1 ? one : many);
+/** Engine per test, so a count is never presented as spanning engines. */
+function engines(envelope) {
+    return new Map(envelope.results.map((result) => [result.testId, result.engine]));
+}
+/**
+ * What the pages did while the tests were passing.
+ *
+ * The headline of the whole feature, and the reason it leads with the phrase it
+ * does: a 500 on a background request fails no assertion, appears in no
+ * Playwright artefact, and until now appeared nowhere at all.
+ *
+ * Counts are reported PER SURFACE and tagged with their engine, never summed into
+ * a run total. The cross-engine lane measured why: on one page Chromium and WebKit
+ * report 123 console errors and Firefox 121, because the first two also log a
+ * failed-resource error. A total spanning engines would be a number that describes
+ * no browser.
+ */
+export function runtimeInsight(envelope) {
+    const engineOf = engines(envelope);
+    const surfaces = [];
+    let listened = 0;
+    for (const scan of envelope.scans) {
+        const runtime = scan.runtime;
+        if (!runtime)
+            continue;
+        listened += 1;
+        const counts = runtime.counts;
+        const consoleErrors = counts['console-error'] ?? 0;
+        const pageErrors = counts['page-error'] ?? 0;
+        const failedRequests = counts['request-failed'] ?? 0;
+        const serverErrors = counts['response-5xx'] ?? 0;
+        const clientErrors = counts['response-4xx'] ?? 0;
+        if (consoleErrors + pageErrors + failedRequests + serverErrors + clientErrors === 0) {
+            continue;
+        }
+        const engine = engineOf.get(scan.testId);
+        surfaces.push({
+            surface: scan.context.surface,
+            ...(engine ? { engine } : {}),
+            consoleErrors,
+            pageErrors,
+            failedRequests,
+            serverErrors,
+            clientErrors,
+            omitted: runtime.omitted,
+            // Severity-ordered, not first-seen. The accumulator keeps exemplars in
+            // arrival order, and on a chatty page that buries the 500 under three
+            // console warnings — burying the one thing this block exists to surface.
+            exemplars: [...runtime.exemplars]
+                .sort((a, b) => severity(b.kind) - severity(a.kind))
+                .slice(0, 3)
+                .map(describeEvent),
+        });
+    }
+    // Nothing was ever observed: the run predates the capability, or no page was
+    // scanned. Silence, not a clean bill of health.
+    if (listened === 0)
+        return undefined;
+    const notes = [];
+    if (surfaces.length === 0) {
+        /*
+         * The honest positive. Worth saying precisely because it is the one case where
+         * a zero MEANS something: `observed` was populated, so we listened.
+         */
+        return {
+            heading: 'Page runtime',
+            figures: [
+                {
+                    value: 0,
+                    label: `${plural(listened, 'surface', 'surfaces')} logged errors — ${listened} listened to`,
+                    notes: [
+                        'No console errors, uncaught exceptions, failed requests or 4xx/5xx responses ' +
+                            'were seen on any scanned surface.',
+                    ],
+                },
+            ],
+            notes: [],
+        };
+    }
+    surfaces.sort((a, b) => b.serverErrors - a.serverErrors ||
+        b.pageErrors - a.pageErrors ||
+        b.consoleErrors - a.consoleErrors ||
+        a.surface.localeCompare(b.surface));
+    const serverTotal = surfaces.reduce((total, row) => total + row.serverErrors, 0);
+    if (serverTotal > 0) {
+        notes.push(`Across this run, ${serverTotal} server ${plural(serverTotal, 'error', 'errors')} (5xx) ${plural(serverTotal, 'was', 'were')} returned to a page while the tests ` +
+            'were passing. Nothing asserted on them, so they failed nothing.');
+    }
+    notes.push('Counts are per surface and per engine. Engines disagree about what reaches the ' +
+        'console for the same page, so these are not comparable across engines and are ' +
+        'deliberately not totalled.');
+    return {
+        heading: 'Page runtime',
+        figures: surfaces.map((row) => ({
+            value: row.consoleErrors +
+                row.pageErrors +
+                row.serverErrors +
+                row.clientErrors +
+                row.failedRequests,
+            label: `${row.surface}${row.engine ? ` · ${row.engine}` : ''}`,
+            notes: [describeCounts(row), ...row.exemplars].filter((note) => note.length > 0),
+        })),
+        notes,
+    };
+}
+/** How loudly an event should speak for its surface. */
+const SEVERITY = {
+    'response-5xx': 5,
+    'page-error': 4,
+    'response-4xx': 3,
+    'request-failed': 2,
+    'console-error': 1,
+    'console-warning': 0,
+};
+const severity = (kind) => SEVERITY[kind] ?? 0;
+function describeCounts(row) {
+    const parts = [];
+    if (row.serverErrors > 0)
+        parts.push(`${row.serverErrors} × 5xx`);
+    if (row.clientErrors > 0)
+        parts.push(`${row.clientErrors} × 4xx`);
+    if (row.pageErrors > 0) {
+        parts.push(`${row.pageErrors} uncaught ${plural(row.pageErrors, 'error', 'errors')}`);
+    }
+    if (row.consoleErrors > 0)
+        parts.push(`${row.consoleErrors} console errors`);
+    if (row.failedRequests > 0)
+        parts.push(`${row.failedRequests} failed requests`);
+    if (row.omitted > 0)
+        parts.push(`${row.omitted} beyond the cap, not counted`);
+    return parts.join(', ');
+}
+function describeEvent(event) {
+    if (event.status !== undefined && event.urlPattern !== undefined) {
+        return `${event.status} ${event.urlPattern}`;
+    }
+    if (event.message !== undefined)
+        return event.message;
+    return event.urlPattern ?? event.kind;
+}
+/* -------------------------------------------------------------------------- *
+ * The unscannable ledger
+ * -------------------------------------------------------------------------- */
+const REASON_WORDS = {
+    'settle-timed-out-empty': 'the test moved on before the page settled',
+    'nav-aborted': 'the page navigated away before the scan ran',
+    'scan-timed-out': 'the scan ran out of its time budget',
+    'scan-failed': 'the scan could not run',
+    'scan-cap-reached': 'the per-page scan ceiling was reached',
+    'page-closed': 'the page was closed first',
+    'autoscan-disabled': 'automatic scanning was off',
+    'not-in-changed-set': 'changed-only mode skipped it',
+    unknown: 'the reason could not be determined',
+};
+/**
+ * Surfaces this run reached and could not check.
+ *
+ * §2 of the gap analysis asks for exactly this and says why: "3 surfaces could not
+ * be checked" deserves to be a figure in the gutter, not a sentence in a
+ * paragraph. Before the ledger it was prose, readable by a person paying
+ * attention and countable by nothing.
+ *
+ * The phrase is "could not be checked", never "failed" — nothing is known about
+ * those surfaces in either direction, which is the whole point.
+ */
+export function unscannableInsight(envelope) {
+    const rows = envelope.unscanned;
+    // Absent means the envelope predates the ledger, NEVER that nothing was missed.
+    // Silence is the only honest rendering of "we do not know".
+    if (!rows || rows.length === 0)
+        return undefined;
+    const patterns = new Set(rows.map((row) => row.urlPattern));
+    const occurrences = rows.reduce((total, row) => total + row.count, 0);
+    const byReason = new Map();
+    for (const row of rows) {
+        byReason.set(row.reason, (byReason.get(row.reason) ?? 0) + row.count);
+    }
+    return {
+        heading: 'Could not be checked',
+        figures: [
+            {
+                value: patterns.size,
+                label: `${plural(patterns.size, 'surface', 'surfaces')} the run reached and could not scan`,
+                notes: [`${occurrences} ${plural(occurrences, 'occurrence', 'occurrences')} in total.`],
+            },
+            ...[...byReason.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .map(([reason, count]) => ({
+                value: count,
+                label: REASON_WORDS[reason] ?? reason,
+            })),
+        ],
+        notes: [
+            'These surfaces have no evidence in this run — which is different from being ' +
+                'clean. Any coverage figure above is computed over what was scanned, so treat ' +
+                'it as a floor.',
+        ],
+    };
+}
+/* -------------------------------------------------------------------------- *
+ * Coverage on the real grid
+ * -------------------------------------------------------------------------- */
+const AXIS_WORDS = {
+    surface: 'surfaces',
+    theme: 'themes',
+    persona: 'personas',
+    state: 'states',
+};
+/**
+ * Which axes this run's evidence actually spans.
+ *
+ * The product's unit is surface × theme × persona × state, and coverage was only
+ * ever reported per route. Two rules hold this block honest:
+ *
+ *   - **No percentage from `combinations`.** It is a combinatorial product over
+ *     values that happened to appear and counts cells that cannot exist (an
+ *     admin-only persona on a public page). The GAP is a real signal; the ratio
+ *     is not a coverage figure.
+ *   - **`declared` is the only real denominator**, and it comes from the
+ *     customer's own config. When it is absent the line is suppressed entirely
+ *     rather than falling back to "N of N", which would report perfect coverage
+ *     of whatever happened to run.
+ */
+export function coverageInsight(envelope, declared, unmeasuredAxes) {
+    if (envelope.scans.length === 0)
+        return undefined;
+    const grid = gridCoverage(envelope, declared);
+    const figures = [];
+    figures.push({
+        value: grid.cellsWithEvidence,
+        label: 'distinct surface × theme × persona × state cells have evidence',
+        notes: grid.combinations > grid.cellsWithEvidence
+            ? [
+                `The observed values combine ${grid.combinations} ways. That is not a target: ` +
+                    'many combinations cannot exist, so this is a shape, never a percentage.',
+            ]
+            : [],
+    });
+    for (const axis of grid.axes) {
+        if (axis.axis === 'surface')
+            continue;
+        // Only where the customer's config gave us a real denominator.
+        if (axis.declared === undefined || axis.declared.length === 0)
+            continue;
+        figures.push({
+            value: `${axis.observed.length} of ${axis.declared.length}`,
+            label: `${AXIS_WORDS[axis.axis]} configured have evidence`,
+            notes: axis.missing.length > 0 ? [`No evidence for: ${axis.missing.join(', ')}.`] : [],
+        });
+    }
+    const notes = [];
+    const undeclared = grid.axes.filter((axis) => axis.axis !== 'surface' && (axis.declared === undefined || axis.declared.length === 0));
+    if (undeclared.length > 0) {
+        notes.push(`Nothing in the config names the ${undeclared
+            .map((axis) => AXIS_WORDS[axis.axis])
+            .join(', ')} this suite has, so there is no denominator to compare against — ` +
+            'only what was observed.');
+    }
+    if (unmeasuredAxes !== undefined && unmeasuredAxes.length > 0) {
+        notes.push(`No project sets ${unmeasuredAxes.join(', ')}, so ${plural(unmeasuredAxes.length, 'that axis is', 'those axes are')} unmeasured in this run.`);
+    }
+    return { heading: 'Coverage', figures, notes };
+}
+/* -------------------------------------------------------------------------- *
+ * Cross-surface reasoning
+ * -------------------------------------------------------------------------- */
+/**
+ * Findings that exist only because one run holds many surfaces.
+ *
+ * No per-page tool can express any of these, which is the point. All three are
+ * carefully worded as evidence rather than conclusions:
+ *
+ *   - variance is a ROOT-CAUSE POINTER ("fails in dark, passes in light" names a
+ *     token, not a component)
+ *   - a shared selector shape is a CANDIDATE, never "one fix" — that is a fix
+ *     claim and sits on the paid side of the free-layer boundary (D10)
+ *   - document consistency shows its `unknown` bucket, because a surface we never
+ *     probed is not a surface missing a skip link
+ */
+export function crossSurfaceInsight(envelope) {
+    const figures = [];
+    const notes = [];
+    for (const axis of ['theme', 'persona', 'state']) {
+        const rows = axisVariance(envelope, axis);
+        // Empty means either one value on that axis, or no disagreement. Both render
+        // as silence: "no theme-specific failures" is a claim a one-theme run cannot
+        // support.
+        for (const row of rows.slice(0, 3)) {
+            figures.push({
+                value: row.failingValues.length,
+                label: `${row.ruleId} fails on ${row.surface} in ${row.failingValues.join(', ')}`,
+                notes: [
+                    `Passes there in ${row.passingValues.join(', ')} — so the difference is the ${axis}.`,
+                ],
+            });
+        }
+    }
+    const shared = sharedSelectorCandidates(envelope).filter((row) => row.surfaces.length >= 2);
+    for (const row of shared.slice(0, 3)) {
+        figures.push({
+            value: row.surfaces.length,
+            label: `surfaces share the selector shape ${row.shape} for ${row.ruleId}`,
+        });
+    }
+    if (shared.length > 0) {
+        // Said ONCE, as a block note. Repeating it under every row turned the caveat
+        // into wallpaper, which is how a caveat stops being read.
+        notes.push(`A shared selector shape is a candidate for one shared component, not a ` +
+            `conclusion — two unrelated components can carry the same shape` +
+            (shared.length > 3 ? `. ${shared.length - 3} more not shown` : '') +
+            '.');
+    }
+    const documents = documentConsistency(envelope);
+    if (documents.duplicateTitles.length > 0) {
+        // One row for all of them: three consecutive rows reading "2 surfaces share
+        // one page title" says the same sentence three times and buries which
+        // surfaces, which is the only part that helps.
+        figures.push({
+            value: documents.duplicateTitles.length,
+            label: `${plural(documents.duplicateTitles.length, 'group of surfaces shares', 'groups of surfaces share')} a page title`,
+            notes: [
+                ...documents.duplicateTitles.slice(0, 4).map((duplicate) => duplicate.surfaces.join(', ')),
+                'Each title is fine on its own page; repeated across surfaces it is 2.4.2.',
+            ],
+        });
+    }
+    if (documents.langValues.length > 1) {
+        figures.push({
+            value: documents.langValues.length,
+            label: 'different lang values across surfaces',
+            notes: documents.langValues.map((row) => `${row.value}: ${row.surfaces.slice(0, 6).join(', ')}`),
+        });
+    }
+    if (documents.skipLinkAbsent.length > 0 && documents.skipLinkPresent.length > 0) {
+        /*
+         * Both counts, plainly. An earlier wording said "N surfaces have no skip link
+         * where others do", which reads as an anomaly — and on the fixture suite the
+         * "anomaly" was 14 of 16 surfaces. Inconsistency is the finding here; which
+         * side is the majority is the reader's to judge.
+         */
+        const present = documents.skipLinkPresent.length;
+        const absent = documents.skipLinkAbsent.length;
+        figures.push({
+            value: `${present}/${present + absent}`,
+            label: 'surfaces have a skip link — the rest do not',
+            notes: [
+                `Present on ${documents.skipLinkPresent.slice(0, 6).join(', ')}. ` +
+                    `Absent on ${documents.skipLinkAbsent.slice(0, 6).join(', ')}` +
+                    (absent > 6 ? ` and ${absent - 6} more` : '') +
+                    '.',
+            ],
+        });
+    }
+    /*
+     * The unknown bucket qualifies a COMPARISON, so it is only said when there is a
+     * comparison to qualify.
+     *
+     * Emitted unconditionally, it produced a section on an ordinary run whose entire
+     * content was "1 surface was not probed for these" — announcing our own gap to a
+     * reader who had been shown no cross-surface finding at all. A caveat with
+     * nothing to caveat is noise, and noise is how the real caveats stop being read.
+     */
+    if (documents.unknown.length > 0 && figures.length > 0) {
+        notes.push(`${documents.unknown.length} ${plural(documents.unknown.length, 'surface was', 'surfaces were')} not probed for these, so ${plural(documents.unknown.length, 'it is', 'they are')} absent from the comparison rather than counted against it.`);
+    }
+    // No figures means no cross-surface finding, and this section exists for nothing
+    // else. Silence rather than a heading over an empty list.
+    if (figures.length === 0)
+        return undefined;
+    return { heading: 'Across surfaces', figures, notes };
+}
+/* -------------------------------------------------------------------------- *
+ * Where the suite's time went, and what we cost
+ * -------------------------------------------------------------------------- */
+/**
+ * Suite mechanics: the tail, the steps, the workers, and our own overhead.
+ *
+ * **The overhead wording is the sharpest hazard in this file.** These are summed
+ * per-scan durations across workers, and scanning runs concurrently with the
+ * customer's own tests — so on the SDK's own grouped fixture run the total spent
+ * (28.7s) EXCEEDS the wall clock (27.9s). Rendered as a percentage that is
+ * gibberish; rendered as a delta it is a lie. The gap analysis's own example
+ * phrasing, "scan cost: 1.8s of 8.5s", implies exactly the subtraction that does
+ * not hold.
+ *
+ * So: time SPENT, never time ADDED, no percentage, no delta, and a pointer at
+ * `SETSQUARE_DISABLED=1`, which is the only way to actually measure the
+ * difference.
+ */
+export function suiteTimingInsight(suite, overhead) {
+    if (!suite && !overhead)
+        return undefined;
+    const figures = [];
+    const notes = [];
+    const slowest = suite?.slowestTests?.[0];
+    if (slowest) {
+        figures.push({
+            value: `${(slowest.durationMs / 1000).toFixed(1)}s`,
+            label: 'slowest test',
+            // In the notes rather than the label: a figure LABEL sits on one line beside
+            // the gutter and does not wrap, and a full titlePath routinely runs past any
+            // terminal. Notes wrap, so the whole id survives.
+            notes: [slowest.testId],
+        });
+    }
+    const step = suite?.slowestSteps?.[0];
+    if (step) {
+        figures.push({
+            value: `${(step.durationMs / 1000).toFixed(1)}s`,
+            label: `slowest step${step.category ? ` (${step.category})` : ''}`,
+            notes: [step.title],
+        });
+    }
+    const workers = suite?.workers;
+    /*
+     * Imbalance only when the run could actually be imbalanced.
+     *
+     * Playwright recycles worker PROCESSES — one per project, another after a
+     * failure — so a strictly serial suite still reports several worker indices.
+     * The first version of this line reported a six-second "imbalance" on a
+     * `workers: 1` run, which is the shape of the projects and not a finding.
+     */
+    if (workers && workers.configured !== undefined && workers.configured > 1) {
+        figures.push({
+            value: `${(workers.tailMs / 1000).toFixed(1)}s`,
+            label: 'busiest worker above the median',
+            notes: [
+                `${workers.configured} workers configured, ${workers.workers} processes used. ` +
+                    `Busiest ${(workers.busiestMs / 1000).toFixed(1)}s, quietest ` +
+                    `${(workers.idlestMs / 1000).toFixed(1)}s. A long tail means one worker holds ` +
+                    'the run open while the others are done.',
+            ],
+        });
+    }
+    if (overhead) {
+        figures.push({
+            value: `${(overhead.scanMs / 1000).toFixed(1)}s`,
+            label: `spent inside Setsquare across ${overhead.scans} ${plural(overhead.scans, 'scan', 'scans')}`,
+            notes: [`${(overhead.axeMs / 1000).toFixed(1)}s of that was axe itself.`],
+        });
+        notes.push(`Time spent, not time added: scans run alongside your tests and these are summed ` +
+            `across workers, so this is not ${(overhead.runDurationMs / 1000).toFixed(1)}s of ` +
+            'wall clock minus anything. To measure what we actually cost, run once with ' +
+            'SETSQUARE_DISABLED=1 and compare.');
+    }
+    if (figures.length === 0)
+        return undefined;
+    return { heading: 'Suite timing', figures, notes };
+}
+/**
+ * Which tests were flaky, on which attempt, and how they failed.
+ *
+ * The summary already said "2 flaky". It never said which, and all of it was in
+ * the data already — that is the whole complaint in §2. Returned as notes for the
+ * Playwright block rather than a section of its own, because it belongs beside the
+ * count it explains.
+ */
+export function flakeNotes(suite) {
+    const flaky = suite?.flaky ?? [];
+    if (flaky.length === 0)
+        return [];
+    return flaky.slice(0, 5).map((test) => {
+        const how = test.failure?.step
+            ? ` — first failed at ${test.failure.step}`
+            : test.failure?.errorClass
+                ? ` — first failed with ${test.failure.errorClass}`
+                : '';
+        return `${test.testId}: passed on attempt ${test.passedOnRetry + 1}${how}.`;
+    });
+}
+/** Every block, in the order the renderers present them. */
+export function insightBlocks(envelope, options = {}) {
+    return [
+        runtimeInsight(envelope),
+        unscannableInsight(envelope),
+        crossSurfaceInsight(envelope),
+        coverageInsight(envelope, options.declaredAxes, options.unmeasuredAxes),
+        suiteTimingInsight(options.suite, options.overhead),
+    ].filter((block) => block !== undefined);
+}
+//# sourceMappingURL=insights.js.map

package/dist/insights.js.map

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

package/dist/install.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedSetsquareOptions } from './options.js';
+export interface InstallResult {
+    installed: boolean;
+    /** Present when installation was skipped. Written into the run's warnings. */
+    reason?: string;
+}
+export declare function installFixture(options: ResolvedSetsquareOptions): InstallResult;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AA2D7D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,wBAAwB,GAAG,aAAa,CAwC/E"}

package/dist/install.js

@@ -0,0 +1,114 @@
+import { test as playwrightTest } from '@playwright/test';
+import { createContextFixture } from './fixture.js';
+/**
+ * Install the capture fixture into the customer's suite without touching a
+ * single test file.
+ *
+ * ---------------------------------------------------------------------------
+ * READ THIS BEFORE CHANGING ANYTHING HERE. It is the one place in the SDK that
+ * depends on Playwright internals, and it is a deliberate, contained trade.
+ * ---------------------------------------------------------------------------
+ *
+ * The problem. Fixtures in Playwright come from the `test` object a spec
+ * imports. Customers import `test` from `@playwright/test`, so the only
+ * supported ways to add a fixture are to make them change every spec's import,
+ * or to hand them a `mergeTests()` call — both of which are test edits, and
+ * "zero test rewrites" is the product's headline claim, not a nicety.
+ *
+ * The mechanism. `playwright/test` exports the `test` object itself, a
+ * per-process singleton whose implementation hangs off an own symbol and holds a
+ * plain `fixtures` array. Playwright loads the config file in EVERY worker
+ * process, so `withSetsquare()` — which runs during config load — executes in each
+ * worker before any spec is imported. Appending to that array at that moment
+ * adds our fixture to the base `test` and to everything later derived from it.
+ *
+ * Why an OVERRIDE of `context` and not an `auto` fixture. This matters more than
+ * it looks. An auto fixture that depends on `page` or `context` forces a browser
+ * launch for every test, including ones that never wanted a browser: measured on
+ * the fixture suite, a pure-arithmetic test went from 2ms to 185ms. On a real
+ * suite with hundreds of non-browser tests that is minutes per run, added
+ * silently, and blamed on the customer's own suite. An override instantiates
+ * only when something actually asks for a context, so a test that wants no
+ * browser still gets none. `fixtures/specs/nopage/pure.spec.ts` is the permanent
+ * regression test for it.
+ *
+ * The risk, stated plainly. This is not public API and a Playwright release can
+ * change it. Three things contain that:
+ *   1. Everything below is defensive. A shape we do not recognise means we
+ *      install nothing and say so — never a thrown error, because the SDK must
+ *      never be the reason a customer's build fails.
+ *   2. Degrading is visible, not silent. "No evidence" and "no problems" must
+ *      never look the same.
+ *   3. The compatibility matrix (P1-6.3) runs the suite across the supported
+ *      Playwright range, so a break surfaces in OUR CI rather than in theirs.
+ */
+/**
+ * Process-wide guard, keyed on a registered symbol.
+ *
+ * `Symbol.for` rather than a module-level boolean because a package can be
+ * loaded more than once in one process — ESM and CJS resolutions, or two
+ * versions in a monorepo — and each copy would carry its own module state.
+ * Installing twice would attach two fixtures and duplicate every record, which
+ * presents as inflated counts rather than as an error.
+ */
+const INSTALLED = Symbol.for('setsquare.playwright.installed');
+/**
+ * Find Playwright's internal test-type implementation by shape rather than by
+ * name.
+ *
+ * The symbol is module-local to Playwright and has no stable description, so it
+ * cannot be looked up directly. Scanning own symbols for the object carrying a
+ * `fixtures` array is both what is actually available and, usefully, a check on
+ * the assumption: if the shape ever changes, this returns undefined and we
+ * degrade, rather than mutating something that merely happens to be there.
+ */
+function findTestTypeImpl(test) {
+    if (typeof test !== 'function' && typeof test !== 'object')
+        return undefined;
+    for (const symbol of Object.getOwnPropertySymbols(test)) {
+        const candidate = test[symbol];
+        if (candidate &&
+            typeof candidate === 'object' &&
+            Array.isArray(candidate.fixtures)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function installFixture(options) {
+    const globals = globalThis;
+    if (globals[INSTALLED])
+        return { installed: true };
+    try {
+        const impl = findTestTypeImpl(playwrightTest);
+        if (!impl) {
+            return {
+                installed: false,
+                reason: 'Setsquare could not attach to @playwright/test: its internal fixture ' +
+                    'registry was not in the expected shape. Scans will not run. This is ' +
+                    'usually a Playwright version outside the supported range.',
+            };
+        }
+        impl.fixtures.push({
+            // An OVERRIDE of the built-in `context`, not an auto fixture. See above —
+            // the difference is a browser launch per test that does not want one.
+            fixtures: { context: createContextFixture(options) },
+            // Playwright records where a fixture was declared and shows it in error
+            // messages. Naming ourselves honestly here means a fixture problem points
+            // at us instead of at a confusing internal frame.
+            location: { file: 'node_modules/@setsquare/review-sdk', line: 1, column: 1 },
+        });
+        globals[INSTALLED] = true;
+        return { installed: true };
+    }
+    catch (error) {
+        // Deliberately swallowed. An SDK that throws during config load takes the
+        // whole suite with it, which is the one outcome we have promised can never
+        // happen.
+        return {
+            installed: false,
+            reason: `Setsquare could not install its capture fixture: ${error instanceof Error ? error.message : String(error)}. Scans will not run; your tests are unaffected.`,
+        };
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAW/D;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE7E,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC,IAAc,CAAC,EAAE,CAAC;QAClE,MAAM,SAAS,GAAI,IAAgC,CAAC,MAAM,CAAC,CAAC;QAC5D,IACE,SAAS;YACT,OAAO,SAAS,KAAK,QAAQ;YAC7B,KAAK,CAAC,OAAO,CAAE,SAA0B,CAAC,QAAQ,CAAC,EACnD,CAAC;YACD,OAAO,SAAyB,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAiC;IAC9D,MAAM,OAAO,GAAG,UAAqC,CAAC;IACtD,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAE9C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,MAAM,EACJ,uEAAuE;oBACvE,sEAAsE;oBACtE,2DAA2D;aAC9D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,0EAA0E;YAC1E,sEAAsE;YACtE,QAAQ,EAAE,EAAE,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE;YACpD,wEAAwE;YACxE,0EAA0E;YAC1E,kDAAkD;YAClD,QAAQ,EAAE,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;SAC7E,CAAC,CAAC;QAEH,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,2EAA2E;QAC3E,UAAU;QACV,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,oDACN,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,kDAAkD;SACnD,CAAC;IACJ,CAAC;AACH,CAAC"}