@gooddata/sdk-e2e-utils 11.61.0-alpha.1 → 11.61.0-alpha.2

package/esm/create-test/feature-hub/mock.d.ts

@@ -1,5 +1,5 @@
-import type { PlaywrightTest } from "../playwright/playwright-types.js";
+import type { PlaywrightTestInstance } from "../playwright/playwright-types.js";
 import type { IFeatureHubEnvironment } from "./types.js";
 /** FeatureHub mock — each test gets a fresh page, so route dies with it. */
-export declare function registerFeatureHubMock(testInstance: PlaywrightTest, featureHubResponse: IFeatureHubEnvironment[]): void;
+export declare function registerFeatureHubMock(testInstance: PlaywrightTestInstance, featureHubResponse: IFeatureHubEnvironment[]): void;
 //# sourceMappingURL=mock.d.ts.map

package/esm/create-test/feature-hub/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/create-test/feature-hub/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,cAAc,EAC5B,kBAAkB,EAAE,sBAAsB,EAAE,GAC7C,IAAI,CAYN"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/create-test/feature-hub/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,sBAAsB,EACpC,kBAAkB,EAAE,sBAAsB,EAAE,GAC7C,IAAI,CAYN"}

package/esm/create-test/goodmock/snapshot/sanitize-organization.d.ts

@@ -0,0 +1,12 @@
+import { type IGoodmockMapping } from "../types.js";
+export declare const DEFAULT_TEMPLATE_ORGANIZATION = "automation";
+/**
+ * Replace every ephemeral organization name (`ephemeral-{templateOrganization}-{hex}`) with the
+ * bare template organization name, so re-recording against a freshly created org does not churn
+ * the organization id, name, or `/entities/admin/organizations/...` paths in the saved mappings.
+ *
+ * The hex suffix is exactly 8 lowercase hex characters; the lookahead makes sure a longer hex run
+ * is not partially consumed.
+ */
+export declare function sanitizeOrganization(mappings: IGoodmockMapping[], templateOrganization?: string): IGoodmockMapping[];
+//# sourceMappingURL=sanitize-organization.d.ts.map

package/esm/create-test/goodmock/snapshot/sanitize-organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-organization.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/sanitize-organization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAM1D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,oBAAoB,GAAE,MAAsC,GAC7D,gBAAgB,EAAE,CAmBpB"}

package/esm/create-test/goodmock/snapshot/sanitize-organization.js

@@ -0,0 +1,28 @@
+// (C) 2026 GoodData Corporation
+export const DEFAULT_TEMPLATE_ORGANIZATION = "automation";
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Replace every ephemeral organization name (`ephemeral-{templateOrganization}-{hex}`) with the
+ * bare template organization name, so re-recording against a freshly created org does not churn
+ * the organization id, name, or `/entities/admin/organizations/...` paths in the saved mappings.
+ *
+ * The hex suffix is exactly 8 lowercase hex characters; the lookahead makes sure a longer hex run
+ * is not partially consumed.
+ */
+export function sanitizeOrganization(mappings, templateOrganization = DEFAULT_TEMPLATE_ORGANIZATION) {
+    const template = escapeRegExp(templateOrganization);
+    const ephemeralOrganizationPattern = new RegExp(`ephemeral-${template}-[0-9a-f]{8}(?![0-9a-f])`, "g");
+    const dataString = JSON.stringify({ mappings });
+    const matches = dataString.match(ephemeralOrganizationPattern);
+    if (!matches) {
+        return mappings;
+    }
+    const sanitizedDataString = dataString.replace(ephemeralOrganizationPattern, templateOrganization);
+    const sanitizedData = JSON.parse(sanitizedDataString);
+    const distinctOrganizations = [...new Set(matches)].join(", ");
+    // oxlint-disable-next-line eslint-js/no-console
+    console.log(`Sanitized organization in mappings (${distinctOrganizations} -> ${templateOrganization})`);
+    return sanitizedData.mappings;
+}

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.d.ts

@@ -5,6 +5,12 @@ import { type IGoodmockMapping, type ILeakPattern, type ISecretMapping, type IWo
 export interface ISnapshotAndSaveRecordingOptions {
     /** Source/target workspace ID rewrite(s) applied before mappings are saved. */
     workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
+    /**
+     * Template organization name. Every ephemeral organization name in the saved mappings
+     * (`ephemeral-{templateOrganization}-{hex}`) is replaced with this bare name so re-recording
+     * against a fresh ephemeral org does not churn the recordings. Defaults to "automation".
+     */
+    templateOrganization?: string;
     /**
      * Real backend URL (e.g. "https://example.gooddata.com"). When provided together with
      * baseUrl, all occurrences are replaced in the saved mappings so that recorded responses

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-and-save-recording.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/snapshot-and-save-recording.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAC3B,MAAM,aAAa,CAAC;AASrB;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAClE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,CAAC;CAC3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAoDf"}
+{"version":3,"file":"snapshot-and-save-recording.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/snapshot-and-save-recording.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAC3B,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAClE;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,CAAC;CAC3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CA6Df"}

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.js

@@ -5,6 +5,7 @@ import { assertNoLeakPatterns } from "./assert-no-leak-patterns.js";
 import { assertNoSecretLeaks } from "./assert-no-secret-leaks.js";
 import { replaceSecrets } from "./replace-secrets.js";
 import { sanitizeCredentials } from "./sanitize-credentials.js";
+import { DEFAULT_TEMPLATE_ORGANIZATION, sanitizeOrganization } from "./sanitize-organization.js";
 import { sanitizeWorkspaceIds } from "./sanitize-workspace-ids.js";
 import { snapshotParams } from "./snapshot-param.js";
 /**
@@ -21,7 +22,7 @@ import { snapshotParams } from "./snapshot-param.js";
  * @param options - See {@link ISnapshotAndSaveRecordingOptions}.
  */
 export async function snapshotAndSaveRecording(host, mappingFilePath, options = {}) {
-    const { workspaceIdMappings, backendHost, baseUrl, secretMappings, leakPatterns, sanitizeMappings } = options;
+    const { workspaceIdMappings, templateOrganization = DEFAULT_TEMPLATE_ORGANIZATION, backendHost, baseUrl, secretMappings, leakPatterns, sanitizeMappings, } = options;
     // Snapshot everything with scenarios enabled. goodmock only emits a scenario
     // chain when a given request produced *different* responses across the
     // recording; identical repeats collapse to a single mapping. This captures
@@ -49,7 +50,8 @@ export async function snapshotAndSaveRecording(host, mappingFilePath, options =
     // Consumer-supplied redaction for secrets this module has no knowledge of (e.g. an LLM
     // provider's API key echoed back on a settings entity).
     const sanitizedByCaller = sanitizeMappings ? sanitizeMappings(mappings) : mappings;
-    const sanitizedMappings = sanitizeWorkspaceIds(sanitizedByCaller, workspaceIdMappings);
+    const sanitizedWorkspaceIds = sanitizeWorkspaceIds(sanitizedByCaller, workspaceIdMappings);
+    const sanitizedMappings = sanitizeOrganization(sanitizedWorkspaceIds, templateOrganization);
     let output = JSON.stringify({ mappings: sanitizedMappings }, null, 4) + "\n";
     if (backendHost && baseUrl) {
         output = output.replaceAll(backendHost, baseUrl);

package/esm/create-test/playwright/factory.d.ts

@@ -1,7 +1,8 @@
-import type { ICreateTestOptions, Test } from "./types.js";
+import type { PlaywrightBaseTestArgs, PlaywrightBaseWorkerArgs } from "./playwright-types.js";
+import type { ICreateTestOptions, Test, TestConditionsValueConstraint } from "./types.js";
 /**
  * @internal
  * @param options -
  */
-export declare function createTest<T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<T, W>): Test;
+export declare function createTest<TestConditionsValue extends TestConditionsValueConstraint = never, T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<TestConditionsValue, T, W>): Test<TestConditionsValue, PlaywrightBaseTestArgs & T, PlaywrightBaseWorkerArgs & W>;
 //# sourceMappingURL=factory.d.ts.map

package/esm/create-test/playwright/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/factory.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAER,kBAAkB,EAElB,IAAI,EAGP,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CA8GxG"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/factory.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACR,sBAAsB,EACtB,wBAAwB,EAE3B,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,KAAK,EAER,kBAAkB,EAElB,IAAI,EACJ,6BAA6B,EAGhC,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,UAAU,CACtB,mBAAmB,SAAS,6BAA6B,GAAG,KAAK,EACjE,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EAEjB,OAAO,EAAE,kBAAkB,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC,GACvD,IAAI,CAAC,mBAAmB,EAAE,sBAAsB,GAAG,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,CAsMrF"}

package/esm/create-test/playwright/factory.js

@@ -1,68 +1,124 @@
 // (C) 2026 GoodData Corporation
 // oxlint-disable typescript-eslint/no-empty-object-type
+import { basename } from "path";
 import { test } from "@playwright/test";
 import { registerFeatureHubMock } from "../feature-hub/mock.js";
 import { registerGoodmockHooks } from "../goodmock/playwright.js";
 import { getCallerLocation, getPlaywrightInternals, } from "./playwright-internals.js";
+import { assertRequiredConditions, assertValidConditions, combineConditions, shouldRunTest, } from "./test-conditions.js";
 import { toPlaywrightDetails } from "./to-playwright-details.js";
-import { withDescribeDetails } from "./with-describe-details.js";
+import { withDescribeDetails, withTestDetails } from "./with-describe-details.js";
 /**
  * @internal
  * @param options -
  */
 export function createTest(options) {
-    // Tracks whether we're inside a topLevelDescribe during synchronous registration.
-    let insideTopLevelDescribe = false;
+    // Tracks whether we're inside the outermost describe of a spec file during synchronous registration.
+    let insideRootDescribe = false;
     // Stacks track workspace settings / additionalWindowProperties hierarchy during
     // synchronous describe registration. Each level merges on top of the parent's.
     // The beforeEach at each level captures the fully-merged snapshot, so the
     // innermost beforeEach (which runs last) wins.
     const settingsStack = [];
     const awpStack = [];
-    const testInstance = options.fixtures ? test.extend(options.fixtures) : test;
+    // Combined test conditions and titles of the enclosing describes, during synchronous registration.
+    // Describes only feed these; each test decides for itself whether it runs (a describe whose own
+    // conditions are false may still contain tests whose combined conditions are true).
+    const { testConditions } = options;
+    const conditionsStack = [];
+    const titleStack = [];
+    const withDescribeScope = (title, details, body) => {
+        conditionsStack.push(combineConditions(testConditions, conditionsStack[conditionsStack.length - 1], details.conditions));
+        titleStack.push(title);
+        try {
+            body();
+        }
+        finally {
+            titleStack.pop();
+            conditionsStack.pop();
+        }
+    };
+    // Same type `test.extend<T, W>()` returns. Without fixtures, T and W (inferred from `options.fixtures`)
+    // add nothing, so the base `test` already is that type.
+    const testInstance = options.fixtures
+        ? test.extend(options.fixtures)
+        : test;
     const internals = getPlaywrightInternals(testInstance);
+    // specName -> spec file it was derived from. Playwright loads each file once per process, so the
+    // same file again means a second outermost describe in it, and another file means a duplicate specName.
+    const specNameFiles = new Map();
     const makeDescribe = (type, name) => {
-        return (title, details, callback) => {
-            if (!insideTopLevelDescribe) {
-                throw new Error(`${name}("${title}") must be nested inside a test.topLevelDescribe() block.`);
+        const describeFunction = (title, details, callback) => {
+            const location = getCallerLocation(describeFunction);
+            assertValidConditions(details.conditions, `${name}("${title}")`);
+            const pwDetails = toPlaywrightDetails(details);
+            if (insideRootDescribe) {
+                internals.describe(type, location, title, pwDetails, () => withDescribeScope(title, details, () => withDescribeDetails(testInstance, settingsStack, awpStack, details, callback)));
+                return;
             }
-            internals.describe(type, getCallerLocation(), title, toPlaywrightDetails(details), () => withDescribeDetails(testInstance, settingsStack, awpStack, details, callback));
-        };
-    };
-    // Spec files that already have a topLevelDescribe. Playwright loads each file once per process,
-    // so a second registration from the same file means a second topLevelDescribe in that file.
-    const filesWithTopLevelDescribe = new Set();
-    const makeTopLevelDescribe = (type) => {
-        return (suiteName, specName, details, fn) => {
-            const location = getCallerLocation();
-            if (filesWithTopLevelDescribe.has(location.file)) {
-                throw new Error(`test.topLevelDescribe("${suiteName}"): only one test.topLevelDescribe() is allowed per file (${location.file}).`);
+            // Outermost describe of the spec file: it also sets up the spec.
+            // "some-file-name.spec.ts" -> "some-file-name"
+            const specName = basename(location.file).replace(/\.(spec|test)\.[cm]?[jt]sx?$/, "");
+            const existingFile = specNameFiles.get(specName);
+            if (existingFile === location.file) {
+                throw new Error(`${name}("${title}"): only one outermost test.describe() is allowed per file (${location.file}).`);
+            }
+            if (existingFile !== undefined) {
+                throw new Error(`${name}("${title}"): duplicate specName "${specName}" in ${location.file} and ${existingFile}. Spec file names must be unique.`);
             }
-            filesWithTopLevelDescribe.add(location.file);
-            const suite = () => {
+            specNameFiles.set(specName, location.file);
+            internals.describe(type, location, title, pwDetails, () => {
                 registerFeatureHubMock(testInstance, options.featureHubResponse);
                 if (options.goodmock) {
                     registerGoodmockHooks(testInstance, options.goodmock, specName);
                 }
                 // Workspace settings + additional window properties — merge with parent
-                // stack and inject beforeEach. Wraps fn() so nested describes inherit.
-                insideTopLevelDescribe = true;
-                withDescribeDetails(testInstance, settingsStack, awpStack, details, fn);
-                insideTopLevelDescribe = false;
-            };
-            const pwDetails = toPlaywrightDetails(details);
-            internals.describe(type, location, suiteName, pwDetails, suite);
+                // stack and inject beforeEach. Wraps the callback so nested describes inherit.
+                insideRootDescribe = true;
+                try {
+                    withDescribeScope(title, details, () => withDescribeDetails(testInstance, settingsStack, awpStack, details, callback));
+                }
+                finally {
+                    // Reset even if the body throws, so the next spec file starts outside again.
+                    insideRootDescribe = false;
+                }
+            });
         };
+        return describeFunction;
     };
     const makeTest = (name, register) => {
-        return (...args) => {
+        const testFunction = (...args) => {
+            const location = getCallerLocation(testFunction);
+            const [title, detailsOrBody, bodyArg] = args;
             // Only the `(title, ...)` forms register a test; the title-less forms
             // (`test.skip()`, `test.skip(condition)`, ...) are used inside tests and describes.
-            if (typeof args[0] === "string" && !insideTopLevelDescribe) {
-                throw new Error(`${name}("${args[0]}") must be nested inside a test.topLevelDescribe() block.`);
+            if (typeof title !== "string") {
+                register(location, ...args);
+                return;
+            }
+            if (!insideRootDescribe) {
+                throw new Error(`${name}("${title}") must be nested inside a test.describe() block.`);
             }
-            register(getCallerLocation(), ...args);
+            const details = typeof detailsOrBody === "function"
+                ? undefined
+                : detailsOrBody;
+            const body = typeof detailsOrBody === "function" ? detailsOrBody : bodyArg;
+            assertValidConditions(details?.conditions, `${name}("${title}")`);
+            const conditions = combineConditions(testConditions, conditionsStack[conditionsStack.length - 1], details?.conditions);
+            assertRequiredConditions(testConditions, conditions, `${name}("${title}")`, location.file);
+            if (!shouldRunTest(testConditions, conditions, location.file, [...titleStack, title])) {
+                // Conditions not met: register as skipped, whatever the variant (`only`, `fail`, ...).
+                internals.modifier("skip", location, title, details ? toPlaywrightDetails(details) : {}, body);
+                return;
+            }
+            if (!details) {
+                register(location, title, body);
+                return;
+            }
+            withTestDetails(testInstance, settingsStack, awpStack, location, title, details);
+            register(location, title, toPlaywrightDetails(details), body);
         };
+        return testFunction;
     };
     return Object.assign(makeTest("test", (location, ...args) => internals.createTest("default", location, ...args)), testInstance, {
         only: makeTest("test.only", (location, ...args) => internals.createTest("only", location, ...args)),
@@ -71,15 +127,17 @@ export function createTest(options) {
         fail: Object.assign(makeTest("test.fail", (location, ...args) => internals.modifier("fail", location, ...args)), testInstance.fail, {
             only: makeTest("test.fail.only", (location, ...args) => internals.createTest("fail.only", location, ...args)),
         }),
-        /** Build the overridden `test.describe` (with its `.skip`, `.only`, `.fixme`) for a single `createTest` instance. */
-        describe: Object.assign(makeDescribe("default", "describe"), testInstance.describe, {
-            only: makeDescribe("only", "describe.only"),
-            fixme: makeDescribe("fixme", "describe.fixme"),
-            skip: makeDescribe("skip", "describe.skip"),
-        }),
-        /** Build `test.topLevelDescribe` (with its `.skip`) for a single `createTest` instance. */
-        topLevelDescribe: Object.assign(makeTopLevelDescribe("default"), {
-            skip: makeTopLevelDescribe("skip"),
+        /** Build the overridden `test.describe` (with its variants) for a single `createTest` instance. */
+        describe: Object.assign(makeDescribe("default", "test.describe"), testInstance.describe, {
+            only: makeDescribe("only", "test.describe.only"),
+            fixme: makeDescribe("fixme", "test.describe.fixme"),
+            skip: makeDescribe("skip", "test.describe.skip"),
+            serial: Object.assign(makeDescribe("serial", "test.describe.serial"), {
+                only: makeDescribe("serial.only", "test.describe.serial.only"),
+            }),
+            parallel: Object.assign(makeDescribe("parallel", "test.describe.parallel"), {
+                only: makeDescribe("parallel.only", "test.describe.parallel.only"),
+            }),
         }),
     });
 }

package/esm/create-test/playwright/playwright-internals.d.ts

@@ -1,4 +1,4 @@
-import type { PlaywrightTest } from "./playwright-types.js";
+import type { PlaywrightTestInstance } from "./playwright-types.js";
 /**
  * Source location Playwright records for tests, describes and modifiers.
  */
@@ -21,13 +21,18 @@ export interface IPlaywrightInternals {
 /**
  * Get the private `TestTypeImpl` behind a Playwright `test` function.
  */
-export declare function getPlaywrightInternals(testInstance: PlaywrightTest): IPlaywrightInternals;
+export declare function getPlaywrightInternals(testInstance: PlaywrightTestInstance): IPlaywrightInternals;
 /**
- * Location of the first stack frame outside this package, i.e. the spec file (or consumer helper)
- * that called our wrapper. Same frame Playwright's public API would have recorded.
+ * Location of whoever called `wrapper` (the spec file, or a consumer helper): the same frame
+ * Playwright's public API would have recorded.
+ *
+ * Frames are cut by function identity (`Error.captureStackTrace` omits `wrapper` and everything above it),
+ * not by file path, so this keeps working when consumers bundle this package into their own chunks.
  *
  * Playwright installs source-map-support while loading test files, so the stack already shows
  * the original TypeScript file and line.
+ *
+ * @param wrapper - our public function the spec called (`test`, `test.describe`, ...); must be on the stack
  */
-export declare function getCallerLocation(): IPlaywrightLocation;
+export declare function getCallerLocation(wrapper: (...args: never[]) => unknown): IPlaywrightLocation;
 //# sourceMappingURL=playwright-internals.d.ts.map

package/esm/create-test/playwright/playwright-internals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-internals.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-internals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAU5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAC5B,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,GACb,UAAU,GACV,eAAe,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACjC,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACpG,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChG,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACnG;AAoBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,cAAc,GAAG,oBAAoB,CAkBzF;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAkBvD"}
+{"version":3,"file":"playwright-internals.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-internals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAUpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAC5B,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,GACb,UAAU,GACV,eAAe,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACjC,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACpG,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChG,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACnG;AAoBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,sBAAsB,GAAG,oBAAoB,CAkBjG;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,mBAAmB,CAmB7F"}

package/esm/create-test/playwright/playwright-internals.js

@@ -27,27 +27,31 @@ export function getPlaywrightInternals(testInstance) {
         describe: (type, location, ...args) => impl._describe(type, location, ...args),
     };
 }
-// This package's code: compiled (`esm/`) and, when source-mapped, original (`src/`). Frames from here are our own wrappers.
-const OWN_CODE_DIRS = ["../../../esm/", "../../../src/"].map((dir) => fileURLToPath(new URL(dir, import.meta.url)));
 // Matches the location at the end of a stack line: "at fn (/path/file.ts:12:3)", "at /path/file.ts:12:3",
 // "at fn (file:///path/file.ts:12:3)".
 const STACK_FRAME_LOCATION = /\(?((?:file:\/\/)?[^\s()]+):(\d+):(\d+)\)?$/;
 /**
- * Location of the first stack frame outside this package, i.e. the spec file (or consumer helper)
- * that called our wrapper. Same frame Playwright's public API would have recorded.
+ * Location of whoever called `wrapper` (the spec file, or a consumer helper): the same frame
+ * Playwright's public API would have recorded.
+ *
+ * Frames are cut by function identity (`Error.captureStackTrace` omits `wrapper` and everything above it),
+ * not by file path, so this keeps working when consumers bundle this package into their own chunks.
  *
  * Playwright installs source-map-support while loading test files, so the stack already shows
  * the original TypeScript file and line.
+ *
+ * @param wrapper - our public function the spec called (`test`, `test.describe`, ...); must be on the stack
  */
-export function getCallerLocation() {
-    const stack = new Error().stack ?? "";
-    for (const stackLine of stack.split("\n").slice(1)) {
+export function getCallerLocation(wrapper) {
+    const target = {};
+    Error.captureStackTrace(target, wrapper);
+    for (const stackLine of (target.stack ?? "").split("\n").slice(1)) {
         const match = STACK_FRAME_LOCATION.exec(stackLine.trim());
         if (!match) {
             continue;
         }
         const file = match[1].startsWith("file://") ? fileURLToPath(match[1]) : match[1];
-        if (OWN_CODE_DIRS.some((dir) => file.startsWith(dir)) || file.startsWith("node:")) {
+        if (file.startsWith("node:")) {
             continue;
         }
         return { file, line: Number(match[2]), column: Number(match[3]) };

package/esm/create-test/playwright/playwright-types.d.ts

@@ -1,4 +1,4 @@
-import type { PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, test } from "@playwright/test";
+import type { PlaywrightTestArgs, PlaywrightTestOptions, TestType as PlaywrightTestType, PlaywrightWorkerArgs, PlaywrightWorkerOptions, TestInfo } from "@playwright/test";
 /**
  * @internal
  */
@@ -10,17 +10,25 @@ export type PlaywrightBaseWorkerArgs = PlaywrightWorkerArgs & PlaywrightWorkerOp
 /**
  * @internal
  */
-export type PlaywrightTest = typeof test;
+export type { PlaywrightTestType };
 /**
  * @internal
  */
-export type PlaywrightDescribeConfigure = typeof test.describe.configure;
+export type PlaywrightTestInstance = PlaywrightTestType<PlaywrightTestArgs & PlaywrightTestOptions, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;
 /**
  * @internal
  */
-export type PlaywrightDescribeSerial = typeof test.describe.serial;
+export type PlaywrightDescribeConfigure = PlaywrightTestInstance["describe"]["configure"];
 /**
  * @internal
+ * Body of a test: `(fixtures, testInfo) => ...`. Mirrors Playwright's internal `TestBody<TestArgs>`,
+ * which `@playwright/test` doesn't export.
  */
-export type PlaywrightDescribeParallel = typeof test.describe.parallel;
+export type PlaywrightTestBody<TestArgs> = (args: TestArgs, testInfo: TestInfo) => Promise<unknown> | unknown;
+/**
+ * @internal
+ * Condition callback of `test.skip(callback, description?)` and friends. Mirrors Playwright's internal
+ * `ConditionBody<TestArgs>`, which `@playwright/test` doesn't export.
+ */
+export type PlaywrightConditionBody<TestArgs> = (args: TestArgs) => boolean;
 //# sourceMappingURL=playwright-types.d.ts.map

package/esm/create-test/playwright/playwright-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,IAAI,EACP,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC"}
+{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,QAAQ,IAAI,kBAAkB,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACX,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAEtF;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACnD,kBAAkB,GAAG,qBAAqB,EAC1C,oBAAoB,GAAG,uBAAuB,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;AAE1F;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9G;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC"}

package/esm/create-test/playwright/test-conditions.d.ts

@@ -0,0 +1,25 @@
+import type { ITestConditions, TestConditionsValueConstraint } from "./types.js";
+/** Combine a describe's or test's own conditions with the inherited ones (`child` replaces `parent` by default). */
+export declare function combineConditions<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, parent: TestConditionsValue | undefined, child: TestConditionsValue | undefined): TestConditionsValue | undefined;
+/**
+ * Throw if `conditions` is set (not `undefined`) but empty or of a type that isn't allowed. Empty values
+ * shouldn't be set at all. `0` is a valid number; objects other than plain objects, arrays, `Map` and
+ * `Set` (class instances, `Date`, ...) aren't checked for emptiness.
+ *
+ * @param conditions - the value from `details.conditions`
+ * @param where - call description used in the error message, e.g. `test.describe("title")`
+ */
+export declare function assertValidConditions(conditions: unknown, where: string): void;
+/**
+ * Throw if `testConditions.required` is set and a test ends up without conditions, neither its own
+ * nor inherited from an enclosing describe.
+ *
+ * @param where - call description used in the error message, e.g. `test("title")`
+ */
+export declare function assertRequiredConditions<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, conditions: TestConditionsValue | undefined, where: string, file: string): void;
+/**
+ * Whether a test runs. Without conditions anywhere in its chain (or without `testConditions`
+ * configured), the predicate isn't called and the test runs.
+ */
+export declare function shouldRunTest<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, conditions: TestConditionsValue | undefined, file: string, titlePath: string[]): boolean;
+//# sourceMappingURL=test-conditions.d.ts.map

package/esm/create-test/playwright/test-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-conditions.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/test-conditions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEjF,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,mBAAmB,SAAS,6BAA6B,EACvF,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACvC,mBAAmB,GAAG,SAAS,CAKjC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS9E;AAgCD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,mBAAmB,SAAS,6BAA6B,EAC9F,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACb,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,mBAAmB,SAAS,6BAA6B,EACnF,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GACpB,OAAO,CAKT"}

package/esm/create-test/playwright/test-conditions.js

@@ -0,0 +1,76 @@
+// (C) 2026 GoodData Corporation
+/** Combine a describe's or test's own conditions with the inherited ones (`child` replaces `parent` by default). */
+export function combineConditions(testConditions, parent, child) {
+    if (child === undefined) {
+        return parent;
+    }
+    return testConditions?.merge ? testConditions.merge(parent, child) : child;
+}
+/**
+ * Throw if `conditions` is set (not `undefined`) but empty or of a type that isn't allowed. Empty values
+ * shouldn't be set at all. `0` is a valid number; objects other than plain objects, arrays, `Map` and
+ * `Set` (class instances, `Date`, ...) aren't checked for emptiness.
+ *
+ * @param conditions - the value from `details.conditions`
+ * @param where - call description used in the error message, e.g. `test.describe("title")`
+ */
+export function assertValidConditions(conditions, where) {
+    if (conditions === undefined) {
+        return;
+    }
+    const problem = getConditionsProblem(conditions);
+    if (problem) {
+        throw new Error(`${where}: \`conditions\` ${problem}. Leave \`conditions\` out instead.`);
+    }
+}
+function getConditionsProblem(conditions) {
+    // `null` and `boolean` are already rejected by the types; this catches values cast past them.
+    if (conditions === null) {
+        return "is null";
+    }
+    if (typeof conditions === "boolean") {
+        return "is a boolean, which isn't an allowed conditions value";
+    }
+    if (typeof conditions === "string") {
+        return conditions === "" ? "is set but empty (empty string)" : undefined;
+    }
+    if (typeof conditions === "number") {
+        return Number.isNaN(conditions) ? "is set but not a number (NaN)" : undefined;
+    }
+    if (Array.isArray(conditions)) {
+        return conditions.length === 0 ? "is set but empty (empty array)" : undefined;
+    }
+    if (conditions instanceof Map || conditions instanceof Set) {
+        return conditions.size === 0 ? `is set but empty (empty ${conditions.constructor.name})` : undefined;
+    }
+    if (typeof conditions === "object") {
+        const prototype = Object.getPrototypeOf(conditions);
+        const isPlainObject = prototype === Object.prototype || prototype === null;
+        return isPlainObject && Object.keys(conditions).length === 0
+            ? "is set but empty (object without keys)"
+            : undefined;
+    }
+    return undefined;
+}
+/**
+ * Throw if `testConditions.required` is set and a test ends up without conditions, neither its own
+ * nor inherited from an enclosing describe.
+ *
+ * @param where - call description used in the error message, e.g. `test("title")`
+ */
+export function assertRequiredConditions(testConditions, conditions, where, file) {
+    if (testConditions?.required && conditions === undefined) {
+        throw new Error(`${where}: \`testConditions.required\` is set, but neither this test nor any enclosing ` +
+            `test.describe() sets \`conditions\` (${file}).`);
+    }
+}
+/**
+ * Whether a test runs. Without conditions anywhere in its chain (or without `testConditions`
+ * configured), the predicate isn't called and the test runs.
+ */
+export function shouldRunTest(testConditions, conditions, file, titlePath) {
+    if (!testConditions || conditions === undefined) {
+        return true;
+    }
+    return testConditions.shouldRun(conditions, { file, titlePath });
+}

package/esm/create-test/playwright/to-playwright-details.d.ts

@@ -1,5 +1,5 @@
 import type { TestDetails } from "@playwright/test";
-import type { ITestDetails } from "./types.js";
+import type { ITestDetails, TestConditionsValueConstraint } from "./types.js";
 /** Strip custom fields before passing details to Playwright. */
-export declare function toPlaywrightDetails(details: ITestDetails): TestDetails;
+export declare function toPlaywrightDetails(details: ITestDetails<TestConditionsValueConstraint>): TestDetails;
 //# sourceMappingURL=to-playwright-details.d.ts.map

package/esm/create-test/playwright/to-playwright-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-playwright-details.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/to-playwright-details.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,CAItE"}
+{"version":3,"file":"to-playwright-details.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/to-playwright-details.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE9E,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,6BAA6B,CAAC,GAAG,WAAW,CAIrG"}

package/esm/create-test/playwright/to-playwright-details.js

@@ -2,6 +2,6 @@
 /** Strip custom fields before passing details to Playwright. */
 export function toPlaywrightDetails(details) {
     // oxlint-disable-next-line @typescript-eslint/no-unused-vars
-    const { workspaceSettings: _ws, additionalWindowProperties: _awp, ...rest } = details;
+    const { workspaceSettings: _ws, additionalWindowProperties: _awp, conditions: _c, ...rest } = details;
     return Object.keys(rest).length > 0 ? rest : {};
 }

package/esm/create-test/playwright/types.d.ts

@@ -1,55 +1,97 @@
 import type { Fixtures, TestDetails } from "@playwright/test";
 import type { IFeatureHubEnvironment } from "../feature-hub/types.js";
 import type { IGoodmockOptions } from "../goodmock/types.js";
-import type { PlaywrightDescribeConfigure, PlaywrightDescribeParallel, PlaywrightDescribeSerial, PlaywrightTest } from "./playwright-types.js";
+import type { PlaywrightConditionBody, PlaywrightDescribeConfigure, PlaywrightTestBody, PlaywrightTestType } from "./playwright-types.js";
 /**
  * @internal
  */
 export type Callback = () => void;
 /**
  * @internal
- * Call signatures of the overridden `test.describe`, `test.describe.only`, `test.describe.skip` and `test.describe.fixme`.
+ * Call signatures of the overridden `test.describe` and its variants (`.only`, `.skip`, `.fixme`, `.serial`, `.parallel`, ...).
+ * The outermost describe of a spec file also sets up the spec (FeatureHub mock, goodmock hooks).
  */
-export interface IDescribeFunction {
-    (title: string, details: ITestDetails, callback: Callback): void;
+export interface IDescribeFunction<TestConditionsValue extends TestConditionsValueConstraint = never> {
+    (title: string, details: ITestDetails<TestConditionsValue>, callback: Callback): void;
 }
 /**
  * @internal
+ * `test.describe.serial` / `test.describe.parallel`, with their `.only`.
  */
-export interface IDescribe extends IDescribeFunction {
-    skip: IDescribeFunction;
-    only: IDescribeFunction;
+export interface IDescribeModeFunction<TestConditionsValue extends TestConditionsValueConstraint = never> extends IDescribeFunction<TestConditionsValue> {
+    only: IDescribeFunction<TestConditionsValue>;
+}
+/**
+ * @internal
+ */
+export interface IDescribe<TestConditionsValue extends TestConditionsValueConstraint = never> extends IDescribeFunction<TestConditionsValue> {
+    skip: IDescribeFunction<TestConditionsValue>;
+    only: IDescribeFunction<TestConditionsValue>;
     configure: PlaywrightDescribeConfigure;
-    fixme: IDescribeFunction;
-    serial: PlaywrightDescribeSerial;
-    parallel: PlaywrightDescribeParallel;
+    fixme: IDescribeFunction<TestConditionsValue>;
+    serial: IDescribeModeFunction<TestConditionsValue>;
+    parallel: IDescribeModeFunction<TestConditionsValue>;
 }
 /**
  * @internal
- * Call signatures of the overridden `test.describe` and `test.describe.skip`.
+ * Allowed types for the consumer's conditions value: objects (including arrays), strings and numbers.
+ * Not `boolean`, `null` or `undefined` (nor unions containing them). Only the top level is restricted,
+ * an object may contain booleans. Without conditions configured, the conditions type is `never`.
+ */
+export type TestConditionsValueConstraint = object | string | number;
+/**
+ * @internal
+ * Context passed to {@link ITestConditions.shouldRun}, for the test being registered.
  */
-export interface ITopLevelDescribeFunction {
-    (suiteName: string, specName: string, details: ITestDetails, fn: Callback): void;
+export interface ITestConditionsContext {
+    /** Absolute path of the spec file. */
+    file: string;
+    /** Titles of the enclosing describes, outermost first, followed by the test's own title. */
+    titlePath: string[];
 }
 /**
  * @internal
+ * Consumer-defined conditions deciding which tests run. `TestConditionsValue` is the consumer's own type (e.g. a list
+ * of products). Describes and tests set it via `details.conditions`; nested values are combined with
+ * {@link ITestConditions.merge}. Each test is evaluated once, while tests are being registered.
  */
-export interface ITopLevelDescribe extends ITopLevelDescribeFunction {
-    skip: ITopLevelDescribeFunction;
+export interface ITestConditions<TestConditionsValue extends TestConditionsValueConstraint> {
+    /**
+     * Whether a test with these (already combined) conditions runs. When `false`, the test is registered
+     * as skipped. Not called when neither the test nor any enclosing describe sets conditions.
+     *
+     * Called while tests are being registered, in every Playwright process: it must be synchronous and
+     * return the same answer every time (env vars and config are fine; async or runtime state are not).
+     */
+    shouldRun: (conditions: TestConditionsValue, context: ITestConditionsContext) => boolean;
+    /**
+     * Combine a describe's or test's conditions with those inherited from its enclosing describes.
+     * Defaults to `child` replacing `parent`.
+     */
+    merge?: (parent: TestConditionsValue | undefined, child: TestConditionsValue) => TestConditionsValue;
+    /**
+     * When `true`, every test must end up with conditions: set on the test itself or inherited from an
+     * enclosing describe. Registering a test without any throws. Defaults to `false`.
+     */
+    required?: boolean;
 }
 /**
  * @internal
  */
-export interface ICustomCreateTestOptions {
+export interface ICustomCreateTestOptions<TestConditionsValue extends TestConditionsValueConstraint = never> {
     featureHubResponse: IFeatureHubEnvironment[];
     goodmock?: IGoodmockOptions;
+    testConditions?: ITestConditions<TestConditionsValue>;
 }
 /**
  * @internal
+ * `testConditions` is required when the conditions type `TestConditionsValue` is given (or inferred from it).
  */
-export interface ICreateTestOptions<T extends {} = {}, W extends {} = {}> extends ICustomCreateTestOptions {
+export type ICreateTestOptions<TestConditionsValue extends TestConditionsValueConstraint = never, T extends {} = {}, W extends {} = {}> = ICustomCreateTestOptions<TestConditionsValue> & {
     fixtures?: Fixtures<T, W>;
-}
+} & ([TestConditionsValue] extends [never] ? {} : {
+    testConditions: ITestConditions<TestConditionsValue>;
+});
 /**
  * @internal
  */
@@ -61,31 +103,46 @@ export type WindowProperties = Record<string, unknown>;
 /**
  * @internal
  */
-export interface ITestDetails extends TestDetails {
+export interface ITestDetails<TestConditionsValue extends TestConditionsValueConstraint = never> extends TestDetails {
     workspaceSettings?: WorkspaceSettings;
     additionalWindowProperties?: WindowProperties;
+    /** See {@link ITestConditions}. */
+    conditions?: TestConditionsValue;
 }
 /**
  * @internal
- * Keep only the call signatures of an overloaded function type (Playwright's `test` has exactly two).
+ * Call signatures that register a test: `test`, `test.only`, `test.fail.only`.
+ * Same as Playwright's, except `details` also accepts `workspaceSettings` / `additionalWindowProperties` / `conditions`.
  */
-export type CallSignatures<F> = F extends {
-    (...args: infer A1): infer R1;
-    (...args: infer A2): infer R2;
-} ? {
-    (...args: A1): R1;
-    (...args: A2): R2;
-} : never;
+export interface ITestFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> {
+    (title: string, body: PlaywrightTestBody<TestArgs & WorkerArgs>): void;
+    (title: string, details: ITestDetails<TestConditionsValue>, body: PlaywrightTestBody<TestArgs & WorkerArgs>): void;
+}
 /**
  * @internal
- * Like `T & U`, but properties in `U` replace those in `T` instead of merging, and `T` stays callable.
+ * `test.skip` / `test.fixme`: register a skipped test (title forms), or mark the current test or describe.
  */
-export type Override<T, U> = CallSignatures<T> & Omit<T, keyof U> & U;
+export interface ITestModifierFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> extends ITestFunction<TestConditionsValue, TestArgs, WorkerArgs> {
+    (): void;
+    (condition: boolean, description?: string): void;
+    (callback: PlaywrightConditionBody<TestArgs & WorkerArgs>, description?: string): void;
+}
+/**
+ * @internal
+ * `test.fail`, with its `.only`.
+ */
+export interface ITestFailFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> extends ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs> {
+    only: ITestFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+}
 /**
  * @internal
+ * Playwright's `TestType<TestArgs, WorkerArgs>`, with our `test` / `only` / `skip` / `fixme` / `fail` / `describe`.
  */
-export type Test = Override<PlaywrightTest, {
-    topLevelDescribe: ITopLevelDescribe;
-    describe: IDescribe;
-}>;
+export type Test<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> = ITestFunction<TestConditionsValue, TestArgs, WorkerArgs> & Omit<PlaywrightTestType<TestArgs, WorkerArgs>, "only" | "skip" | "fixme" | "fail" | "describe"> & {
+    only: ITestFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    skip: ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    fixme: ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    fail: ITestFailFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    describe: IDescribe<TestConditionsValue>;
+};
 //# sourceMappingURL=types.d.ts.map

package/esm/create-test/playwright/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EACR,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,cAAc,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAChD,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,2BAA2B,CAAC;IACvC,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,wBAAwB,CAAC;IACjC,QAAQ,EAAE,0BAA0B,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAAC;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,yBAAyB;IAChE,IAAI,EAAE,yBAAyB,CAAC;CAOnC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;IAC7C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,wBAAwB;IACtG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC7C,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,0BAA0B,CAAC,EAAE,gBAAgB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAAC,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;CAAE,GACpG;IAAE,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC;IAAC,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAA;CAAE,GACxC,KAAK,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,CACvB,cAAc,EACd;IACI,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,QAAQ,EAAE,SAAS,CAAC;CACvB,CACJ,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/types.ts"],"names":[],"mappings":"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"}

package/esm/create-test/playwright/with-describe-details.d.ts

@@ -1,5 +1,12 @@
-import type { PlaywrightTest } from "./playwright-types.js";
-import type { Callback, ITestDetails, WindowProperties, WorkspaceSettings } from "./types.js";
+import type { IPlaywrightLocation } from "./playwright-internals.js";
+import type { PlaywrightTestInstance } from "./playwright-types.js";
+import type { Callback, ITestDetails, TestConditionsValueConstraint, WindowProperties, WorkspaceSettings } from "./types.js";
 /** Push merged settings/awp onto stacks, register a single beforeEach, call fn, pop. */
-export declare function withDescribeDetails(testInstance: PlaywrightTest, settingsStack: WorkspaceSettings[], awpStack: WindowProperties[], details: ITestDetails | undefined, fn: Callback): void;
+export declare function withDescribeDetails(testInstance: PlaywrightTestInstance, settingsStack: WorkspaceSettings[], awpStack: WindowProperties[], details: ITestDetails<TestConditionsValueConstraint> | undefined, fn: Callback): void;
+/**
+ * Register a single test's own settings/awp, merged on top of the enclosing describes'.
+ * The beforeEach is registered next to the test, after the enclosing describes' injection hooks,
+ * so it runs last and its values win.
+ */
+export declare function withTestDetails(testInstance: PlaywrightTestInstance, settingsStack: WorkspaceSettings[], awpStack: WindowProperties[], location: IPlaywrightLocation, title: string, details: ITestDetails<TestConditionsValueConstraint> | undefined): void;
 //# sourceMappingURL=with-describe-details.d.ts.map

package/esm/create-test/playwright/with-describe-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-describe-details.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/with-describe-details.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM9F,wFAAwF;AACxF,wBAAgB,mBAAmB,CAC/B,YAAY,EAAE,cAAc,EAC5B,aAAa,EAAE,iBAAiB,EAAE,EAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,EAAE,EAAE,QAAQ,QAmBf"}
+{"version":3,"file":"with-describe-details.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/with-describe-details.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EACR,QAAQ,EACR,YAAY,EACZ,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACpB,MAAM,YAAY,CAAC;AAMpB,wFAAwF;AACxF,wBAAgB,mBAAmB,CAC/B,YAAY,EAAE,sBAAsB,EACpC,aAAa,EAAE,iBAAiB,EAAE,EAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,EAAE,YAAY,CAAC,6BAA6B,CAAC,GAAG,SAAS,EAChE,EAAE,EAAE,QAAQ,QAsBf;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,YAAY,EAAE,sBAAsB,EACpC,aAAa,EAAE,iBAAiB,EAAE,EAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,CAAC,6BAA6B,CAAC,GAAG,SAAS,GACjE,IAAI,CAsBN"}

package/esm/create-test/playwright/with-describe-details.js

@@ -17,23 +17,56 @@ export function withDescribeDetails(testInstance, settingsStack, awpStack, detai
     if (awp)
         awpStack.push(mergedAwp);
     injectWindowProperties(testInstance, mergedSettings, mergedAwp);
-    fn();
-    if (awp)
-        awpStack.pop();
-    if (ws)
-        settingsStack.pop();
+    try {
+        fn();
+    }
+    finally {
+        // Pop even if the body throws, so later describes don't inherit this level's entries.
+        if (awp)
+            awpStack.pop();
+        if (ws)
+            settingsStack.pop();
+    }
+}
+/**
+ * Register a single test's own settings/awp, merged on top of the enclosing describes'.
+ * The beforeEach is registered next to the test, after the enclosing describes' injection hooks,
+ * so it runs last and its values win.
+ */
+export function withTestDetails(testInstance, settingsStack, awpStack, location, title, details) {
+    const ws = details?.workspaceSettings;
+    const awp = details?.additionalWindowProperties;
+    if (!ws && !awp) {
+        return;
+    }
+    const mergedSettings = ws ? { ...peekOrEmpty(settingsStack), ...ws } : peekOrEmpty(settingsStack);
+    const mergedAwp = awp ? { ...peekOrEmpty(awpStack), ...awp } : peekOrEmpty(awpStack);
+    testInstance.beforeEach(async ({ page }, testInfo) => {
+        // A beforeEach applies to every test in its describe; only act for this test. Title is part
+        // of the match because tests generated in a loop share one location.
+        if (testInfo.title !== title ||
+            testInfo.file !== location.file ||
+            testInfo.line !== location.line ||
+            testInfo.column !== location.column) {
+            return;
+        }
+        await addWindowPropertiesInitScript(page, mergedSettings, mergedAwp);
+    });
 }
 /** Inject workspace settings and additional window properties via a single addInitScript. */
 function injectWindowProperties(testInst, settings, awp) {
     testInst.beforeEach(async ({ page }) => {
-        await page.addInitScript((args) => {
-            const w = window;
-            if (Object.keys(args.s).length > 0) {
-                w["customWorkspaceSettings"] = args.s;
-            }
-            for (const [key, value] of Object.entries(args.a)) {
-                w[key] = value;
-            }
-        }, { s: settings, a: awp });
+        await addWindowPropertiesInitScript(page, settings, awp);
     });
 }
+async function addWindowPropertiesInitScript(page, settings, awp) {
+    await page.addInitScript((args) => {
+        const w = window;
+        if (Object.keys(args.s).length > 0) {
+            w["customWorkspaceSettings"] = args.s;
+        }
+        for (const [key, value] of Object.entries(args.a)) {
+            w[key] = value;
+        }
+    }, { s: settings, a: awp });
+}

package/esm/index.d.ts

@@ -7,7 +7,7 @@ export { goodmockMode, GoodmockMode } from "./create-test/goodmock/mode.js";
 export { snapshotAndSaveRecording, type ISnapshotAndSaveRecordingOptions, } from "./create-test/goodmock/snapshot/snapshot-and-save-recording.js";
 export { createTest } from "./create-test/playwright/factory.js";
 export type { Fixtures } from "./create-test/playwright/fixtures.js";
-export type { PlaywrightBaseTestArgs, PlaywrightBaseWorkerArgs, PlaywrightDescribeConfigure, PlaywrightDescribeParallel, PlaywrightDescribeSerial, PlaywrightTest, } from "./create-test/playwright/playwright-types.js";
-export type { CallSignatures, Callback, ICreateTestOptions, ICustomCreateTestOptions, IDescribe, IDescribeFunction, ITestDetails, ITopLevelDescribe, ITopLevelDescribeFunction, Override, Test, WindowProperties, WorkspaceSettings, } from "./create-test/playwright/types.js";
+export type { PlaywrightBaseTestArgs, PlaywrightBaseWorkerArgs, PlaywrightDescribeConfigure, PlaywrightConditionBody, PlaywrightTestBody, PlaywrightTestType, PlaywrightTestInstance, } from "./create-test/playwright/playwright-types.js";
+export type { Callback, ICreateTestOptions, ICustomCreateTestOptions, IDescribe, IDescribeFunction, IDescribeModeFunction, ITestConditions, ITestConditionsContext, ITestDetails, ITestFailFunction, ITestFunction, ITestModifierFunction, Test, TestConditionsValueConstraint, WindowProperties, WorkspaceSettings, } from "./create-test/playwright/types.js";
 export { clickByBoundingBox, hoverByBoundingBox } from "./helpers/mouse-actions.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EACH,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGrG,YAAY,EACR,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,gBAAgB,GACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACH,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EACH,wBAAwB,EACxB,KAAK,gCAAgC,GACxC,MAAM,gEAAgE,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,cAAc,GACjB,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACR,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,yBAAyB,EACzB,QAAQ,EACR,IAAI,EACJ,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EACH,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGrG,YAAY,EACR,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,gBAAgB,GACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACH,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EACH,wBAAwB,EACxB,KAAK,gCAAgC,GACxC,MAAM,gEAAgE,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACzB,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACR,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,IAAI,EACJ,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/esm/sdk-e2e-utils.d.ts

@@ -4,11 +4,12 @@ import { Locator } from '@playwright/test';
 import { Page } from '@playwright/test';
 import type { PlaywrightTestArgs } from '@playwright/test';
 import type { PlaywrightTestOptions } from '@playwright/test';
+import type { TestType as PlaywrightTestType } from '@playwright/test';
 import type { PlaywrightWorkerArgs } from '@playwright/test';
 import type { PlaywrightWorkerOptions } from '@playwright/test';
 import { Route } from '@playwright/test';
-import type { test } from '@playwright/test';
 import type { TestDetails } from '@playwright/test';
+import type { TestInfo } from '@playwright/test';
 
 /**
  * @internal
@@ -40,18 +41,6 @@ export declare const BACKEND_HOST: string;
  */
 export declare type Callback = () => void;
 
-/**
- * @internal
- * Keep only the call signatures of an overloaded function type (Playwright's `test` has exactly two).
- */
-export declare type CallSignatures<F> = F extends {
-    (...args: infer A1): infer R1;
-    (...args: infer A2): infer R2;
-} ? {
-    (...args: A1): R1;
-    (...args: A2): R2;
-} : never;
-
 /**
  * @internal
  * Click at the center of the bounding box of the given locator.
@@ -68,7 +57,7 @@ export declare function clickByBoundingBox(page: Page, locator: Locator, options
  * @internal
  * @param options -
  */
-export declare function createTest<T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<T, W>): Test;
+export declare function createTest<TestConditionsValue extends TestConditionsValueConstraint = never, T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<TestConditionsValue, T, W>): Test<TestConditionsValue, PlaywrightBaseTestArgs & T, PlaywrightBaseWorkerArgs & W>;
 
 /**
  * @internal
@@ -126,37 +115,50 @@ export declare function hoverByBoundingBox(page: Page, locator: Locator, options
 
 /**
  * @internal
+ * `testConditions` is required when the conditions type `TestConditionsValue` is given (or inferred from it).
  */
-export declare interface ICreateTestOptions<T extends {} = {}, W extends {} = {}> extends ICustomCreateTestOptions {
+export declare type ICreateTestOptions<TestConditionsValue extends TestConditionsValueConstraint = never, T extends {} = {}, W extends {} = {}> = ICustomCreateTestOptions<TestConditionsValue> & {
     fixtures?: Fixtures_2<T, W>;
-}
+} & ([TestConditionsValue] extends [never] ? {} : {
+    testConditions: ITestConditions<TestConditionsValue>;
+});
 
 /**
  * @internal
  */
-export declare interface ICustomCreateTestOptions {
+export declare interface ICustomCreateTestOptions<TestConditionsValue extends TestConditionsValueConstraint = never> {
     featureHubResponse: IFeatureHubEnvironment[];
     goodmock?: IGoodmockOptions;
+    testConditions?: ITestConditions<TestConditionsValue>;
 }
 
 /**
  * @internal
  */
-export declare interface IDescribe extends IDescribeFunction {
-    skip: IDescribeFunction;
-    only: IDescribeFunction;
+export declare interface IDescribe<TestConditionsValue extends TestConditionsValueConstraint = never> extends IDescribeFunction<TestConditionsValue> {
+    skip: IDescribeFunction<TestConditionsValue>;
+    only: IDescribeFunction<TestConditionsValue>;
     configure: PlaywrightDescribeConfigure;
-    fixme: IDescribeFunction;
-    serial: PlaywrightDescribeSerial;
-    parallel: PlaywrightDescribeParallel;
+    fixme: IDescribeFunction<TestConditionsValue>;
+    serial: IDescribeModeFunction<TestConditionsValue>;
+    parallel: IDescribeModeFunction<TestConditionsValue>;
 }
 
 /**
  * @internal
- * Call signatures of the overridden `test.describe`, `test.describe.only`, `test.describe.skip` and `test.describe.fixme`.
+ * Call signatures of the overridden `test.describe` and its variants (`.only`, `.skip`, `.fixme`, `.serial`, `.parallel`, ...).
+ * The outermost describe of a spec file also sets up the spec (FeatureHub mock, goodmock hooks).
  */
-export declare interface IDescribeFunction {
-    (title: string, details: ITestDetails, callback: Callback): void;
+export declare interface IDescribeFunction<TestConditionsValue extends TestConditionsValueConstraint = never> {
+    (title: string, details: ITestDetails<TestConditionsValue>, callback: Callback): void;
+}
+
+/**
+ * @internal
+ * `test.describe.serial` / `test.describe.parallel`, with their `.only`.
+ */
+export declare interface IDescribeModeFunction<TestConditionsValue extends TestConditionsValueConstraint = never> extends IDescribeFunction<TestConditionsValue> {
+    only: IDescribeFunction<TestConditionsValue>;
 }
 
 /**
@@ -249,6 +251,12 @@ export declare interface ISecretMapping {
 export declare interface ISnapshotAndSaveRecordingOptions {
     /** Source/target workspace ID rewrite(s) applied before mappings are saved. */
     workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
+    /**
+     * Template organization name. Every ephemeral organization name in the saved mappings
+     * (`ephemeral-{templateOrganization}-{hex}`) is replaced with this bare name so re-recording
+     * against a fresh ephemeral org does not churn the recordings. Defaults to "automation".
+     */
+    templateOrganization?: string;
     /**
      * Real backend URL (e.g. "https://example.gooddata.com"). When provided together with
      * baseUrl, all occurrences are replaced in the saved mappings so that recorded responses
@@ -280,25 +288,78 @@ export declare interface ISnapshotAndSaveRecordingOptions {
 
 /**
  * @internal
+ * Consumer-defined conditions deciding which tests run. `TestConditionsValue` is the consumer's own type (e.g. a list
+ * of products). Describes and tests set it via `details.conditions`; nested values are combined with
+ * {@link ITestConditions.merge}. Each test is evaluated once, while tests are being registered.
  */
-export declare interface ITestDetails extends TestDetails {
+export declare interface ITestConditions<TestConditionsValue extends TestConditionsValueConstraint> {
+    /**
+     * Whether a test with these (already combined) conditions runs. When `false`, the test is registered
+     * as skipped. Not called when neither the test nor any enclosing describe sets conditions.
+     *
+     * Called while tests are being registered, in every Playwright process: it must be synchronous and
+     * return the same answer every time (env vars and config are fine; async or runtime state are not).
+     */
+    shouldRun: (conditions: TestConditionsValue, context: ITestConditionsContext) => boolean;
+    /**
+     * Combine a describe's or test's conditions with those inherited from its enclosing describes.
+     * Defaults to `child` replacing `parent`.
+     */
+    merge?: (parent: TestConditionsValue | undefined, child: TestConditionsValue) => TestConditionsValue;
+    /**
+     * When `true`, every test must end up with conditions: set on the test itself or inherited from an
+     * enclosing describe. Registering a test without any throws. Defaults to `false`.
+     */
+    required?: boolean;
+}
+
+/**
+ * @internal
+ * Context passed to {@link ITestConditions.shouldRun}, for the test being registered.
+ */
+export declare interface ITestConditionsContext {
+    /** Absolute path of the spec file. */
+    file: string;
+    /** Titles of the enclosing describes, outermost first, followed by the test's own title. */
+    titlePath: string[];
+}
+
+/**
+ * @internal
+ */
+export declare interface ITestDetails<TestConditionsValue extends TestConditionsValueConstraint = never> extends TestDetails {
     workspaceSettings?: WorkspaceSettings;
     additionalWindowProperties?: WindowProperties;
+    /** See {@link ITestConditions}. */
+    conditions?: TestConditionsValue;
+}
+
+/**
+ * @internal
+ * `test.fail`, with its `.only`.
+ */
+export declare interface ITestFailFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> extends ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs> {
+    only: ITestFunction<TestConditionsValue, TestArgs, WorkerArgs>;
 }
 
 /**
  * @internal
+ * Call signatures that register a test: `test`, `test.only`, `test.fail.only`.
+ * Same as Playwright's, except `details` also accepts `workspaceSettings` / `additionalWindowProperties` / `conditions`.
  */
-export declare interface ITopLevelDescribe extends ITopLevelDescribeFunction {
-    skip: ITopLevelDescribeFunction;
+export declare interface ITestFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> {
+    (title: string, body: PlaywrightTestBody<TestArgs & WorkerArgs>): void;
+    (title: string, details: ITestDetails<TestConditionsValue>, body: PlaywrightTestBody<TestArgs & WorkerArgs>): void;
 }
 
 /**
  * @internal
- * Call signatures of the overridden `test.describe` and `test.describe.skip`.
+ * `test.skip` / `test.fixme`: register a skipped test (title forms), or mark the current test or describe.
  */
-export declare interface ITopLevelDescribeFunction {
-    (suiteName: string, specName: string, details: ITestDetails, fn: Callback): void;
+export declare interface ITestModifierFunction<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> extends ITestFunction<TestConditionsValue, TestArgs, WorkerArgs> {
+    (): void;
+    (condition: boolean, description?: string): void;
+    (callback: PlaywrightConditionBody<TestArgs & WorkerArgs>, description?: string): void;
 }
 
 /**
@@ -325,12 +386,6 @@ export declare function loadMappings(host: string, mappingFilePath: string): Pro
  */
 export declare function mockLogRequests(host: string): Promise<void>;
 
-/**
- * @internal
- * Like `T & U`, but properties in `U` replace those in `T` instead of merging, and `T` stays callable.
- */
-export declare type Override<T, U> = CallSignatures<T> & Omit<T, keyof U> & U;
-
 /**
  * @internal
  */
@@ -343,24 +398,29 @@ export declare type PlaywrightBaseWorkerArgs = PlaywrightWorkerArgs & Playwright
 
 /**
  * @internal
+ * Condition callback of `test.skip(callback, description?)` and friends. Mirrors Playwright's internal
+ * `ConditionBody<TestArgs>`, which `@playwright/test` doesn't export.
  */
-export declare type PlaywrightDescribeConfigure = typeof test.describe.configure;
+export declare type PlaywrightConditionBody<TestArgs> = (args: TestArgs) => boolean;
 
 /**
  * @internal
  */
-export declare type PlaywrightDescribeParallel = typeof test.describe.parallel;
+export declare type PlaywrightDescribeConfigure = PlaywrightTestInstance["describe"]["configure"];
 
 /**
  * @internal
+ * Body of a test: `(fixtures, testInfo) => ...`. Mirrors Playwright's internal `TestBody<TestArgs>`,
+ * which `@playwright/test` doesn't export.
  */
-export declare type PlaywrightDescribeSerial = typeof test.describe.serial;
+export declare type PlaywrightTestBody<TestArgs> = (args: TestArgs, testInfo: TestInfo) => Promise<unknown> | unknown;
 
 /**
  * @internal
  */
-declare type PlaywrightTest_2 = typeof test;
-export { PlaywrightTest_2 as PlaywrightTest }
+export declare type PlaywrightTestInstance = PlaywrightTestType<PlaywrightTestArgs & PlaywrightTestOptions, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;
+
+export { PlaywrightTestType }
 
 /**
  * @internal
@@ -401,11 +461,23 @@ export declare function startRecording(host: string, backendHost: string): Promi
 
 /**
  * @internal
+ * Playwright's `TestType<TestArgs, WorkerArgs>`, with our `test` / `only` / `skip` / `fixme` / `fail` / `describe`.
+ */
+export declare type Test<TestConditionsValue extends TestConditionsValueConstraint, TestArgs extends {}, WorkerArgs extends {}> = ITestFunction<TestConditionsValue, TestArgs, WorkerArgs> & Omit<PlaywrightTestType<TestArgs, WorkerArgs>, "only" | "skip" | "fixme" | "fail" | "describe"> & {
+    only: ITestFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    skip: ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    fixme: ITestModifierFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    fail: ITestFailFunction<TestConditionsValue, TestArgs, WorkerArgs>;
+    describe: IDescribe<TestConditionsValue>;
+};
+
+/**
+ * @internal
+ * Allowed types for the consumer's conditions value: objects (including arrays), strings and numbers.
+ * Not `boolean`, `null` or `undefined` (nor unions containing them). Only the top level is restricted,
+ * an object may contain booleans. Without conditions configured, the conditions type is `never`.
  */
-export declare type Test = Override<PlaywrightTest_2, {
-    topLevelDescribe: ITopLevelDescribe;
-    describe: IDescribe;
-}>;
+export declare type TestConditionsValueConstraint = object | string | number;
 
 /**
  * @internal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-e2e-utils",
-  "version": "11.61.0-alpha.1",
+  "version": "11.61.0-alpha.2",
   "description": "GoodData utility functions for Playwright E2E tests",
   "license": "MIT",
   "author": "GoodData",
@@ -49,8 +49,8 @@
     "oxlint-plugin-eslint": "1.82.0",
     "oxlint-tsgolint": "7.0.2001",
     "typescript": "7.0.2",
-    "@gooddata/eslint-config": "11.61.0-alpha.1",
-    "@gooddata/oxlint-config": "11.61.0-alpha.1"
+    "@gooddata/eslint-config": "11.61.0-alpha.2",
+    "@gooddata/oxlint-config": "11.61.0-alpha.2"
   },
   "scripts": {
     "_phase:build": "npm run build",