@plan2net/typo3-playwright-toolkit 0.1.0

package/dist/http/record-edit.js

@@ -0,0 +1,86 @@
+import { getToolkitConfig } from '../config.js';
+import { toolkitHeaders } from '../contract.js';
+/** Relative to the backend entry point, which a project may have moved. */
+export const RECORD_EDIT_ROUTE = '/record/edit';
+/**
+ * The route the backend's own edit form posts to, so a TYPO3 release that changes
+ * it, its request-token rules or its field names fails the suite rather than
+ * passing quietly.
+ */
+export async function saveRecord(poster, context, record) {
+    if (!context.routeToken) {
+        throw new Error('[typo3-playwright-toolkit] No route token for record_edit. The backend refuses a POST ' +
+            'without one and answers with a redirect to the login form. The session endpoint ' +
+            'returns it — use a page from the toolkit fixtures.');
+    }
+    const action = record.identifier.startsWith('NEW') ? 'new' : 'edit';
+    const url = `${context.baseUrl}${context.backendPath}${RECORD_EDIT_ROUTE}` +
+        `?edit%5B${record.table}%5D%5B${record.target}%5D=${action}` +
+        `&token=${encodeURIComponent(context.routeToken)}`;
+    const response = await poster.post(url, {
+        headers: toolkitHeaders(getToolkitConfig(), context.testId),
+        multipart: formFields(record.data),
+        // The new uid only exists in the redirect; following it loses it.
+        maxRedirects: 0,
+    });
+    const location = redirectTarget(response);
+    if (undefined === location) {
+        throw new Error(`[typo3-playwright-toolkit] ${record.table} did not save (status ${response.status()}). ` +
+            `The backend answers a rejected save with a page, not a redirect: ` +
+            `${(await response.text()).slice(0, 300)}`);
+    }
+    const uid = uidFrom(location, record.table);
+    if (undefined === uid) {
+        throw new Error(`[typo3-playwright-toolkit] The save of ${record.table} redirected to no uid — ` +
+            `a rejected request-token or session redirects to the login form. Location: ${location}`);
+    }
+    return uid;
+}
+/** `data[table][identifier][field]`, the names FormEngine gives its inputs. */
+function formFields(data) {
+    const fields = {};
+    for (const [table, rows] of Object.entries(data)) {
+        for (const [identifier, row] of Object.entries(rows)) {
+            for (const [column, value] of Object.entries(row)) {
+                if (undefined === value || null === value) {
+                    continue;
+                }
+                fields[`data[${table}][${identifier}][${column}]`] = formValue(value);
+            }
+        }
+    }
+    fields.doSave = '1';
+    // Save without closing: that is what makes the controller redirect back to
+    // the record it wrote, naming its uid.
+    fields._savedok = '1';
+    return fields;
+}
+function formValue(value) {
+    if ('string' === typeof value) {
+        return value;
+    }
+    if ('number' === typeof value) {
+        return String(value);
+    }
+    if ('boolean' === typeof value) {
+        return value ? '1' : '0';
+    }
+    return JSON.stringify(value) ?? '';
+}
+function redirectTarget(response) {
+    if (response.status() < 300 || response.status() >= 400) {
+        return undefined;
+    }
+    const headers = response.headers();
+    return headers.location ?? headers.Location;
+}
+/** `edit[tt_content][42]=edit`, in whatever encoding the header carries. */
+function uidFrom(location, table) {
+    const match = decodeURIComponent(location).match(new RegExp(`edit\\[${table}\\]\\[(\\d+)\\]`));
+    if (null === match) {
+        return undefined;
+    }
+    const uid = Number(match[1]);
+    return Number.isInteger(uid) && uid > 0 ? uid : undefined;
+}
+//# sourceMappingURL=record-edit.js.map

package/dist/http/record-edit.js.map

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

package/dist/http/toolkit-request.d.ts

@@ -0,0 +1,8 @@
+import type { APIRequestContext } from '@playwright/test';
+import type { ToolkitConfig } from '../config.js';
+/**
+ * Playwright does not route an APIRequestContext, so the test ID has to be put on
+ * here instead. No secret: it stays explicit, on the two requests that need it.
+ */
+export declare function toolkitRequest(request: APIRequestContext, config: ToolkitConfig, testId: string): APIRequestContext;
+//# sourceMappingURL=toolkit-request.d.ts.map

package/dist/http/toolkit-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit-request.d.ts","sourceRoot":"","sources":["../../src/http/toolkit-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAKjD;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACf,iBAAiB,CA6CnB"}

package/dist/http/toolkit-request.js

@@ -0,0 +1,45 @@
+import { SECRET_HEADER } from './api-secret.js';
+import { TEST_ID_HEADER, browserHeaders } from '../contract.js';
+const TOOLKIT_HEADERS = [TEST_ID_HEADER.toLowerCase(), SECRET_HEADER.toLowerCase()];
+const SENDING_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'fetch'];
+/**
+ * Playwright does not route an APIRequestContext, so the test ID has to be put on
+ * here instead. No secret: it stays explicit, on the two requests that need it.
+ */
+export function toolkitRequest(request, config, testId) {
+    const site = new URL(config.testingURL).origin;
+    const onSite = (target) => {
+        const url = 'string' === typeof target ? target : String(target?.url?.() ?? '');
+        if (!/^[a-z][a-z0-9+.-]*:/i.test(url)) {
+            return true;
+        }
+        try {
+            return new URL(url).origin === site;
+        }
+        catch {
+            return false;
+        }
+    };
+    const headersFor = (target, given = {}) => {
+        if (onSite(target)) {
+            return testId ? { ...given, ...browserHeaders(testId) } : { ...given };
+        }
+        return Object.fromEntries(Object.entries(given).filter(([name]) => !TOOLKIT_HEADERS.includes(name.toLowerCase())));
+    };
+    return new Proxy(request, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            if ('function' !== typeof value) {
+                return value;
+            }
+            if ('string' !== typeof property || !SENDING_METHODS.includes(property)) {
+                return value.bind(target);
+            }
+            return (url, options = {}) => value.call(target, url, {
+                ...options,
+                headers: headersFor(url, options.headers),
+            });
+        },
+    });
+}
+//# sourceMappingURL=toolkit-request.js.map

package/dist/http/toolkit-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit-request.js","sourceRoot":"","sources":["../../src/http/toolkit-request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/D,MAAM,eAAe,GAAG,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAA;AACnF,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAElF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC1B,OAA0B,EAC1B,MAAqB,EACrB,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAA;IAE9C,MAAM,MAAM,GAAG,CAAC,MAAe,EAAW,EAAE;QACxC,MAAM,GAAG,GAAG,QAAQ,KAAK,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAE,MAAiC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAE3G,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAA;QACf,CAAC;QAED,IAAI,CAAC;YACD,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAA;QAChB,CAAC;IACL,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,MAAe,EAAE,QAAgC,EAAE,EAA0B,EAAE;QAC/F,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAA;QAC1E,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CACrB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAC1F,CAAA;IACL,CAAC,CAAA;IAED,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACtB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC1B,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAE9D,IAAI,UAAU,KAAK,OAAO,KAAK,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAA;YAChB,CAAC;YACD,IAAI,QAAQ,KAAK,OAAO,QAAQ,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtE,OAAQ,KAAyC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClE,CAAC;YAED,OAAO,CAAC,GAAY,EAAE,UAAgD,EAAE,EAAE,EAAE,CACvE,KAAyC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;gBACzD,GAAG,OAAO;gBACV,OAAO,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;aAC5C,CAAC,CAAA;QACV,CAAC;KACJ,CAAC,CAAA;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { defineScenario, type ScenarioBuilders, type ScenarioFixtures, type SetupTools, } from './scenario.js';
+export { expect } from '@playwright/test';
+export { defineToolkitConfig, getToolkitConfig, type ToolkitConfig, type ToolkitConfigInput, type ToolkitPaths, type ToolkitScreenshotConfig, type ContentTypeConstructor, } from './config.js';
+export { defineBasePlaywrightConfig } from './playwright/base-config.js';
+export { ContentBuilder } from './builders/content-builder.js';
+export { PageBuilder } from './builders/page-builder.js';
+export { CoreContent, HeaderContent, TextContent, TextmediaContent, TextpicContent, ImageContent, BulletsContent, TableContent, UploadsContent, HtmlContent, DividerContent, ShortcutContent, MenuContent, type ContentTypeMap, type CoreContentTypeMap, } from './builders/core-content.js';
+export type { RecordDataMap } from './http/record-edit.js';
+export { newRecordIdentifier } from './builders/identifier.js';
+export { takeScreenshot, waitForAnimations } from './checks/screenshot.js';
+export { runAccessibilityScan, scanAccessibility, DEFAULT_SCAN_TAGS, type AccessibilityScanOptions, } from './checks/accessibility.js';
+export { CspVerifier, type CspMode, type CspViolation } from './checks/csp.js';
+export { TEST_ID_HEADER, TEST_ID_PATTERN } from './contract.js';
+export { RUN_ID_ENV, RUN_ID_PATTERN } from './state/run-id.js';
+export type { CropConfig } from './types/common.js';
+export type { ContentFields, ContentBuilderInterface } from './types/content-builder.js';
+export type { PageWithTestId, ContextWithTestId } from './types/playwright-extensions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC9B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,kBAAkB,GAC1B,MAAM,4BAA4B,CAAA;AACnC,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,wBAAwB,GAChC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACxF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { defineScenario, } from './scenario.js';
+export { expect } from '@playwright/test';
+export { defineToolkitConfig, getToolkitConfig, } from './config.js';
+export { defineBasePlaywrightConfig } from './playwright/base-config.js';
+export { ContentBuilder } from './builders/content-builder.js';
+export { PageBuilder } from './builders/page-builder.js';
+export { CoreContent, HeaderContent, TextContent, TextmediaContent, TextpicContent, ImageContent, BulletsContent, TableContent, UploadsContent, HtmlContent, DividerContent, ShortcutContent, MenuContent, } from './builders/core-content.js';
+export { newRecordIdentifier } from './builders/identifier.js';
+export { takeScreenshot, waitForAnimations } from './checks/screenshot.js';
+export { runAccessibilityScan, scanAccessibility, DEFAULT_SCAN_TAGS, } from './checks/accessibility.js';
+export { CspVerifier } from './checks/csp.js';
+export { TEST_ID_HEADER, TEST_ID_PATTERN } from './contract.js';
+export { RUN_ID_ENV, RUN_ID_PATTERN } from './state/run-id.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,GAIjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,GAMnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,GAGd,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAEpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAmC,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/inspect/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/inspect/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/inspect/cli.ts"],"names":[],"mappings":""}

package/dist/inspect/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import * as fs from 'fs';
+import * as path from 'path';
+import { findStateDir, inspectLinks } from './links.js';
+import { INSPECT_TOKEN_LIFETIME_MS } from './token.js';
+function readSecret(stateDir) {
+    const fromEnvironment = process.env.PLAYWRIGHT_TOOLKIT_SECRET?.trim();
+    if (fromEnvironment) {
+        return fromEnvironment;
+    }
+    // The state directory sits in the project root, next to var/.
+    const file = path.join(path.dirname(stateDir), 'var/playwright/api-secret');
+    return fs.existsSync(file) ? fs.readFileSync(file, 'utf-8').trim() : '';
+}
+const stateDir = findStateDir(process.cwd());
+if (undefined === stateDir) {
+    console.error('No .test-state directory found. Run the tests once first.');
+    process.exit(1);
+}
+const secret = readSecret(stateDir);
+if ('' === secret) {
+    console.error('No API secret found. Run "ddev playwright-prepare" first.');
+    process.exit(1);
+}
+const links = inspectLinks(stateDir, secret);
+if (0 === links.length) {
+    console.error('No test databases recorded. They are removed when a run passes.');
+    process.exit(1);
+}
+const filter = process.argv[2];
+const shown = undefined === filter ? links : links.filter((link) => link.name.includes(filter));
+console.log(`Links log you into the backend and expire in ${INSPECT_TOKEN_LIFETIME_MS / 60_000} minutes.\n`);
+for (const link of shown) {
+    console.log(`${link.name}\n  db${link.testId}\n  ${link.url}\n`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/inspect/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/inspect/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAA;AAEtD,SAAS,UAAU,CAAC,QAAgB;IAChC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,CAAA;IACrE,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,eAAe,CAAA;IAC1B,CAAC;IAED,8DAA8D;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC,CAAA;IAE3E,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC3E,CAAC;AAED,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AAC5C,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;AACnC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AAC5C,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAA;IAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAC9B,MAAM,KAAK,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;AAE/F,OAAO,CAAC,GAAG,CACP,gDAAgD,yBAAyB,GAAG,MAAM,aAAa,CAClG,CAAA;AACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;AACpE,CAAC"}

package/dist/inspect/links.d.ts

@@ -0,0 +1,10 @@
+export interface InspectLink {
+    runId: string;
+    key: string;
+    name: string;
+    testId: string;
+    url: string;
+}
+export declare function findStateDir(from: string): string | undefined;
+export declare function inspectLinks(stateDir: string, secret: string, now?: number): InspectLink[];
+//# sourceMappingURL=links.d.ts.map

package/dist/inspect/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/inspect/links.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB7D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,WAAW,EAAE,CAqBtG"}

package/dist/inspect/links.js

@@ -0,0 +1,51 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { readAttemptsFrom } from '../state/attempt-registry.js';
+import { listRunIds, runLastActiveMs, runsRoot } from '../state/run-namespace.js';
+import { inspectUrl } from './token.js';
+export function findStateDir(from) {
+    let directory = path.resolve(from);
+    for (;;) {
+        const candidate = path.join(directory, '.test-state');
+        // The API secret is read from the parent of whatever matches here, so a
+        // directory without runs/ resolves it against the wrong root.
+        if (fs.existsSync(path.join(candidate, 'runs'))) {
+            return candidate;
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory) {
+            return undefined;
+        }
+        directory = parent;
+    }
+}
+export function inspectLinks(stateDir, secret, now = Date.now()) {
+    const runs = listRunIds(stateDir)
+        .map((runId) => ({ runId, runDir: path.join(runsRoot(stateDir), runId) }))
+        .sort((a, b) => runLastActiveMs(b.runDir) - runLastActiveMs(a.runDir));
+    return runs.flatMap(({ runId, runDir }) => {
+        const testingURL = readTestingUrl(path.join(runDir, 'meta.json'));
+        if (undefined === testingURL) {
+            return [];
+        }
+        return readAttemptsFrom(path.join(runDir, 'attempts.jsonl'))
+            .filter((attempt) => 'preflight' !== attempt.key)
+            .map((attempt) => ({
+            runId,
+            key: attempt.key,
+            name: attempt.name ?? attempt.key,
+            testId: attempt.testId,
+            url: inspectUrl(testingURL, secret, attempt.testId, now),
+        }));
+    });
+}
+function readTestingUrl(metaFile) {
+    try {
+        const meta = JSON.parse(fs.readFileSync(metaFile, 'utf-8'));
+        return 'string' === typeof meta.testingURL ? meta.testingURL : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=links.js.map

package/dist/inspect/links.js.map

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

package/dist/inspect/token.d.ts

@@ -0,0 +1,5 @@
+/** Long enough to pick a link from the list, short enough that a pasted one dies. */
+export declare const INSPECT_TOKEN_LIFETIME_MS = 900000;
+export declare function mintInspectToken(secret: string, testId: string, expiresAt: number): string;
+export declare function inspectUrl(testingURL: string, secret: string, testId: string, now: number): string;
+//# sourceMappingURL=token.d.ts.map

package/dist/inspect/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/inspect/token.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,SAAU,CAAA;AAEhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQlG"}

package/dist/inspect/token.js

@@ -0,0 +1,15 @@
+import { createHmac } from 'node:crypto';
+const PURPOSE = 'inspect';
+/** Long enough to pick a link from the list, short enough that a pasted one dies. */
+export const INSPECT_TOKEN_LIFETIME_MS = 900_000;
+export function mintInspectToken(secret, testId, expiresAt) {
+    const signature = createHmac('sha256', secret).update(`${PURPOSE}:${testId}:${expiresAt}`).digest('hex');
+    return `${expiresAt}.${signature}`;
+}
+export function inspectUrl(testingURL, secret, testId, now) {
+    const expiresAt = Math.floor((now + INSPECT_TOKEN_LIFETIME_MS) / 1000);
+    return (`${testingURL}/typo3/test-api/inspect` +
+        `?id=${encodeURIComponent(testId)}` +
+        `&t=${encodeURIComponent(mintInspectToken(secret, testId, expiresAt))}`);
+}
+//# sourceMappingURL=token.js.map

package/dist/inspect/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/inspect/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,OAAO,GAAG,SAAS,CAAA;AAEzB,qFAAqF;AACrF,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAA;AAEhD,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAc,EAAE,SAAiB;IAC9E,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAExG,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,MAAc,EAAE,MAAc,EAAE,GAAW;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,yBAAyB,CAAC,GAAG,IAAI,CAAC,CAAA;IAEtE,OAAO,CACH,GAAG,UAAU,yBAAyB;QACtC,OAAO,kBAAkB,CAAC,MAAM,CAAC,EAAE;QACnC,MAAM,kBAAkB,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAC1E,CAAA;AACL,CAAC"}

package/dist/playwright/base-config.d.ts

@@ -0,0 +1,4 @@
+import { type PlaywrightTestConfig } from '@playwright/test';
+import type { ToolkitConfig } from '../config.js';
+export declare function defineBasePlaywrightConfig(toolkitConfig: ToolkitConfig, overrides?: PlaywrightTestConfig): PlaywrightTestConfig;
+//# sourceMappingURL=base-config.d.ts.map

package/dist/playwright/base-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-config.d.ts","sourceRoot":"","sources":["../../src/playwright/base-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAKjD,wBAAgB,0BAA0B,CACtC,aAAa,EAAE,aAAa,EAC5B,SAAS,GAAE,oBAAyB,GACrC,oBAAoB,CA+BtB"}

package/dist/playwright/base-config.js

@@ -0,0 +1,34 @@
+import { defineConfig } from '@playwright/test';
+const GLOBAL_SETUP = '@plan2net/typo3-playwright-toolkit/global-setup';
+const GLOBAL_TEARDOWN = '@plan2net/typo3-playwright-toolkit/global-teardown';
+export function defineBasePlaywrightConfig(toolkitConfig, overrides = {}) {
+    const threshold = toolkitConfig.screenshot?.threshold ?? 0.2;
+    const maxDiffPixelRatio = toolkitConfig.screenshot?.maxDiffPixelRatio ?? 0.005;
+    const { use, expect, ...rest } = overrides;
+    return defineConfig({
+        globalSetup: GLOBAL_SETUP,
+        globalTeardown: GLOBAL_TEARDOWN,
+        fullyParallel: true,
+        forbidOnly: !!process.env.CI,
+        workers: 2,
+        ...rest,
+        // Merged key by key, not spread wholesale: Playwright reads `use` and
+        // `expect` as whole objects, so overriding one key would drop the base URL,
+        // tracing or the screenshot tolerances along with it.
+        expect: {
+            timeout: 5000,
+            ...expect,
+            toHaveScreenshot: { maxDiffPixelRatio, threshold, ...expect?.toHaveScreenshot },
+            toMatchSnapshot: { maxDiffPixelRatio, threshold, ...expect?.toMatchSnapshot },
+        },
+        use: {
+            baseURL: toolkitConfig.testingURL,
+            ignoreHTTPSErrors: true,
+            // Serves past context.route, so its requests would carry no test ID.
+            serviceWorkers: 'block',
+            trace: process.env.CI ? 'retain-on-failure' : 'on-first-retry',
+            ...use,
+        },
+    });
+}
+//# sourceMappingURL=base-config.js.map

package/dist/playwright/base-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-config.js","sourceRoot":"","sources":["../../src/playwright/base-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA6B,MAAM,kBAAkB,CAAA;AAG1E,MAAM,YAAY,GAAG,iDAAiD,CAAA;AACtE,MAAM,eAAe,GAAG,oDAAoD,CAAA;AAE5E,MAAM,UAAU,0BAA0B,CACtC,aAA4B,EAC5B,YAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,SAAS,IAAI,GAAG,CAAA;IAC5D,MAAM,iBAAiB,GAAG,aAAa,CAAC,UAAU,EAAE,iBAAiB,IAAI,KAAK,CAAA;IAE9E,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAA;IAE1C,OAAO,YAAY,CAAC;QAChB,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,eAAe;QAC/B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC5B,OAAO,EAAE,CAAC;QACV,GAAG,IAAI;QACP,sEAAsE;QACtE,4EAA4E;QAC5E,sDAAsD;QACtD,MAAM,EAAE;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,MAAM;YACT,gBAAgB,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,gBAAgB,EAAE;YAC/E,eAAe,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE;SAChF;QACD,GAAG,EAAE;YACD,OAAO,EAAE,aAAa,CAAC,UAAU;YACjC,iBAAiB,EAAE,IAAI;YACvB,qEAAqE;YACrE,cAAc,EAAE,OAAgB;YAChC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAE,mBAA6B,CAAC,CAAC,CAAE,gBAA0B;YACpF,GAAG,GAAG;SACT;KACJ,CAAC,CAAA;AACN,CAAC"}

package/dist/playwright/index.d.ts

@@ -0,0 +1,3 @@
+export { defineBasePlaywrightConfig } from './base-config.js';
+export { defineToolkitConfig, type ToolkitConfig } from '../config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/playwright/index.js

@@ -0,0 +1,3 @@
+export { defineBasePlaywrightConfig } from './base-config.js';
+export { defineToolkitConfig } from '../config.js';
+//# sourceMappingURL=index.js.map

package/dist/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playwright/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAA"}

package/dist/scenario.d.ts

@@ -0,0 +1,46 @@
+import { type APIRequestContext, type Browser, type Page } from '@playwright/test';
+import { type ToolkitConfig } from './config.js';
+import { ContentBuilder } from './builders/content-builder.js';
+import { PageBuilder } from './builders/page-builder.js';
+export interface ScenarioBuilders {
+    page(): PageBuilder;
+    content(): ContentBuilder;
+}
+export interface SetupTools {
+    testId: string;
+    attempt: number;
+    signal: AbortSignal;
+    page: Page;
+    request: APIRequestContext;
+    builders: ScenarioBuilders;
+}
+export interface ScenarioFixtures<S> {
+    state: S;
+    testId: string;
+}
+interface ResolvedScenario<S> {
+    data: S;
+    testId: string;
+}
+/**
+ * What the backend shows beside the site name, so whoever opens an inspect link
+ * can tell which scenario they are looking at. The scenario key cannot do that
+ * job: it is a sanitised path with a hash on the end.
+ */
+export declare function scenarioName(file: string): string;
+export declare function openAuthenticatedPage(browser: Browser, config: ToolkitConfig, testId: string, name?: string): Promise<{
+    page: Page;
+    routeToken: string;
+    backendPath: string;
+    close: () => Promise<void>;
+}>;
+/**
+ * One test file is one scenario: the first test that needs state runs the setup,
+ * the rest wait for it or are skipped if it failed.
+ */
+export declare function defineScenario<S = Record<string, never>>(setup?: (tools: SetupTools) => Promise<S>): import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & ScenarioFixtures<S> & {
+    resolvedScenario: ResolvedScenario<S>;
+    automaticAccessibilityScan: void;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export {};
+//# sourceMappingURL=scenario.d.ts.map

package/dist/scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../src/scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAiB,MAAM,kBAAkB,CAAA;AAE/G,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAKlE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAOxD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,IAAI,WAAW,CAAA;IACnB,OAAO,IAAI,cAAc,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,iBAAiB,CAAA;IAC1B,QAAQ,EAAE,gBAAgB,CAAA;CAC7B;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,gBAAgB,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAA;IACP,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAsB,qBAAqB,CACvC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,SAAK,GACV,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAgD9F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC;sBAEjD,gBAAgB,CAAC,CAAC,CAAC;gCAA8B,IAAI;yGAkFtG"}

package/dist/scenario.js

@@ -0,0 +1,139 @@
+import { test as base } from '@playwright/test';
+import { toolkitHeaders } from './contract.js';
+import { getToolkitConfig } from './config.js';
+import { ensureState } from './state/ensure-state.js';
+import { applyScenarioOutcome, recordTestFailure } from './state/scenario-outcome.js';
+import { sanitizeScenarioKey } from './state/run-namespace.js';
+import { DEFAULT_BACKEND_PATH } from './builders/request-context.js';
+import { ContentBuilder } from './builders/content-builder.js';
+import { PageBuilder } from './builders/page-builder.js';
+import { applyToolkitHeaders } from './http/off-site-headers.js';
+import { prepareScenarioContext } from './http/prepare-context.js';
+import { toolkitRequest } from './http/toolkit-request.js';
+import { runAccessibilityScan, shouldScanAutomatically } from './checks/accessibility.js';
+/**
+ * What the backend shows beside the site name, so whoever opens an inspect link
+ * can tell which scenario they are looking at. The scenario key cannot do that
+ * job: it is a sanitised path with a hash on the end.
+ */
+export function scenarioName(file) {
+    const fileName = file.split('/').pop() ?? file;
+    const stripped = fileName.replace(/\.(spec|test)\.[cm]?[jt]sx?$/i, '');
+    return '' === stripped ? fileName : stripped;
+}
+export async function openAuthenticatedPage(browser, config, testId, name = '') {
+    const headers = toolkitHeaders(config, testId);
+    const context = await browser.newContext({ ignoreHTTPSErrors: true });
+    // The close handle is only returned on success, so a failure closes its own context.
+    try {
+        await applyToolkitHeaders(context, config, testId);
+        context.testId = testId;
+        const page = await context.newPage();
+        page.testId = testId;
+        const response = await page.request.post(`${config.testingURL}/typo3/test-api/session`, {
+            headers,
+            data: { name },
+        });
+        if (!response.ok()) {
+            throw new Error(`[setup] Session creation failed (${response.status()}): ${await response.text()}`);
+        }
+        const session = (await response.json());
+        await context.addCookies([
+            {
+                name: session.cookieName,
+                value: session.cookieValue,
+                domain: new URL(config.testingURL).hostname,
+                path: '/',
+                httpOnly: true,
+                sameSite: 'Strict',
+            },
+        ]);
+        return {
+            page,
+            routeToken: session.tokens?.record_edit ?? '',
+            backendPath: session.backendPath ?? DEFAULT_BACKEND_PATH,
+            close: () => context.close(),
+        };
+    }
+    catch (error) {
+        await context.close();
+        throw error;
+    }
+}
+/**
+ * One test file is one scenario: the first test that needs state runs the setup,
+ * the rest wait for it or are skipped if it failed.
+ */
+export function defineScenario(setup) {
+    return base.extend({
+        resolvedScenario: async ({ browser }, use, testInfo) => {
+            const config = getToolkitConfig();
+            const key = sanitizeScenarioKey(testInfo.file);
+            const name = scenarioName(testInfo.file);
+            const outcome = await ensureState(config, {
+                key,
+                name,
+                triggerId: testInfo.testId,
+                setup: async ({ testId, attempt, signal }) => {
+                    if (!setup) {
+                        return {};
+                    }
+                    const label = attempt > 1 ? `${name} #${attempt}` : name;
+                    const session = await openAuthenticatedPage(browser, config, testId, label);
+                    const builderContext = {
+                        testId,
+                        baseUrl: config.testingURL,
+                        backendPath: session.backendPath,
+                        routeToken: session.routeToken,
+                    };
+                    try {
+                        return await setup({
+                            testId,
+                            attempt,
+                            signal,
+                            page: session.page,
+                            request: toolkitRequest(session.page.request, config, testId),
+                            builders: {
+                                page: () => new PageBuilder(session.page, builderContext),
+                                content: () => new ContentBuilder(session.page, builderContext),
+                            },
+                        });
+                    }
+                    finally {
+                        await session.close();
+                    }
+                },
+            });
+            const data = applyScenarioOutcome(outcome, (reason) => testInfo.skip(true, reason));
+            await use({ data, testId: outcome.status === 'ready' ? outcome.testId : '' });
+            if (testInfo.status !== testInfo.expectedStatus) {
+                recordTestFailure(config, key, testInfo.error?.message ?? `test ${testInfo.status}`);
+            }
+        },
+        state: async ({ resolvedScenario }, use) => {
+            await use(resolvedScenario.data);
+        },
+        testId: async ({ resolvedScenario }, use) => {
+            await use(resolvedScenario.testId);
+        },
+        context: async ({ context, testId }, use) => {
+            await prepareScenarioContext(context, getToolkitConfig(), testId);
+            await use(context);
+        },
+        request: async ({ request, testId }, use) => {
+            await use(toolkitRequest(request, getToolkitConfig(), testId));
+        },
+        automaticAccessibilityScan: [
+            async ({ page }, use, testInfo) => {
+                await use();
+                const config = getToolkitConfig();
+                const navigated = page.url().startsWith('http');
+                if (shouldScanAutomatically({ status: testInfo.status ?? '', navigated }, config.accessibility)) {
+                    await runAccessibilityScan(page);
+                }
+            },
+            { auto: true },
+        ],
+    });
+}
+//# sourceMappingURL=scenario.js.map