@qavajs/playwright-runner-adapter 2.4.0 → 2.5.0

package/adapter/js/gherkin.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectPositions = collectPositions;
+exports.resolveLocation = resolveLocation;
+exports.callAt = callAt;
+exports.stepTitle = stepTitle;
+exports.toPickleArgument = toPickleArgument;
+exports.buildSnippet = buildSnippet;
+exports.formatLocation = formatLocation;
+exports.featureTitle = featureTitle;
+const node_vm_1 = require("node:vm");
+const cucumber_1 = require("@cucumber/cucumber");
+const PREVIEW_LENGTH = 50;
+/**
+ * Map ast node ids (scenarios, steps, example rows, rules) of a gherkin document to their positions
+ */
+function collectPositions(gherkinDocument) {
+    const positions = new Map();
+    const addSteps = (steps) => {
+        for (const step of steps)
+            positions.set(step.id, step.location);
+    };
+    const addScenario = (scenario) => {
+        positions.set(scenario.id, scenario.location);
+        addSteps(scenario.steps);
+        for (const examples of scenario.examples) {
+            for (const row of examples.tableBody)
+                positions.set(row.id, row.location);
+        }
+    };
+    for (const child of gherkinDocument.feature?.children ?? []) {
+        if (child.background)
+            addSteps(child.background.steps);
+        if (child.scenario)
+            addScenario(child.scenario);
+        if (child.rule) {
+            for (const ruleChild of child.rule.children) {
+                if (ruleChild.background)
+                    addSteps(ruleChild.background.steps);
+                if (ruleChild.scenario)
+                    addScenario(ruleChild.scenario);
+            }
+        }
+    }
+    return positions;
+}
+/**
+ * Resolve location of a pickle or pickle step.
+ * The last ast node id is used, so scenario outline examples point to their example row.
+ */
+function resolveLocation(positions, file, astNodeIds) {
+    for (let i = astNodeIds.length - 1; i >= 0; i--) {
+        const position = positions.get(astNodeIds[i]);
+        if (position)
+            return { file, line: position.line, column: position.column ?? 1 };
+    }
+    return undefined;
+}
+/**
+ * Call function so that the immediate caller frame reports the given source location.
+ * Playwright takes test and describe locations from the caller frame,
+ * so this makes reports, `--list` and IDE integrations point to the feature file instead of the adapter.
+ */
+function callAt(location, fn, args) {
+    if (!location)
+        return fn(...args);
+    const code = '(function (fn, args) { return fn(...args); })';
+    const callColumn = code.indexOf('fn(...args)');
+    const caller = (0, node_vm_1.runInThisContext)(code, {
+        filename: location.file,
+        lineOffset: location.line - 1,
+        columnOffset: location.column - 1 - callColumn
+    });
+    return caller(fn, args);
+}
+function preview(text) {
+    const singleLine = text.replace(/\s*\n\s*/g, ' ↵ ').replace(/\s+/g, ' ').trim();
+    return singleLine.length > PREVIEW_LENGTH
+        ? `${singleLine.slice(0, PREVIEW_LENGTH - 1)}…`
+        : singleLine;
+}
+/**
+ * Build step title for reports including short preview of doc string or data table argument
+ */
+function stepTitle(pickleStep) {
+    const argument = pickleStep.argument;
+    if (argument?.docString) {
+        return `${pickleStep.text} [MultiLine: ${preview(argument.docString.content)}]`;
+    }
+    if (argument?.dataTable) {
+        const rows = argument.dataTable.rows
+            .map(row => `| ${row.cells.map(cell => cell.value).join(' | ')} |`)
+            .join(' ');
+        return `${pickleStep.text} [DataTable: ${preview(rows)}]`;
+    }
+    return pickleStep.text;
+}
+function isTable(value) {
+    return Array.isArray(value) && value.every(row => Array.isArray(row));
+}
+/**
+ * Convert value passed to executeStep into a pickle step argument.
+ * Strings become doc strings, `string[][]` and DataTable instances become data tables.
+ */
+function toPickleArgument(value) {
+    if (typeof value === 'string') {
+        return { argument: { docString: { content: value } } };
+    }
+    const rows = value instanceof cucumber_1.DataTable ? value.raw() : isTable(value) ? value : undefined;
+    if (rows) {
+        return {
+            argument: {
+                dataTable: {
+                    rows: rows.map(row => ({ cells: row.map(cell => ({ value: String(cell) })) }))
+                }
+            }
+        };
+    }
+    return { extra: value };
+}
+const KEYWORD_TYPES = {
+    Context: 'precondition',
+    Action: 'event',
+    Outcome: 'outcome'
+};
+/**
+ * Build cucumber-style snippet for undefined step
+ */
+function buildSnippet(supportCodeLibrary, pickleStep) {
+    try {
+        const { default: SnippetBuilder } = require('@cucumber/cucumber/lib/formatter/step_definition_snippet_builder/index');
+        const { default: SnippetSyntax } = require('@cucumber/cucumber/lib/formatter/step_definition_snippet_builder/javascript_snippet_syntax');
+        const builder = new SnippetBuilder({
+            snippetSyntax: new SnippetSyntax('async-await'),
+            parameterTypeRegistry: supportCodeLibrary.parameterTypeRegistry
+        });
+        return builder.build({
+            keywordType: KEYWORD_TYPES[pickleStep.type ?? ''] ?? 'precondition',
+            pickleStep
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatLocation(location) {
+    return location ? `${location.file}:${location.line}` : '';
+}
+/**
+ * Feature title used for describe block; falls back to file path for unnamed features
+ */
+function featureTitle(name, uri) {
+    return name?.trim() ? name : uri;
+}

package/adapter/js/index.d.ts

@@ -4,3 +4,4 @@ export * from './Template';
 export * from '@cucumber/cucumber';
 export * from './cucumberAdapter';
 export * from './testDetails';
+export * from './withWorld';

package/adapter/js/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./Template"), exports);
 __exportStar(require("@cucumber/cucumber"), exports);
 __exportStar(require("./cucumberAdapter"), exports);
 __exportStar(require("./testDetails"), exports);
+__exportStar(require("./withWorld"), exports);

package/adapter/js/loader.d.ts

@@ -1,6 +1,14 @@
 import type { CucumberAdapterConfig, Feature, SupportCodeLibrary } from './types';
+/**
+ * Find files matching glob patterns; returns unique absolute paths in stable (sorted) order
+ */
+export declare function findFiles(patterns: string[]): string[];
 export declare function loadFeatures(globPattern: string[]): Feature[];
-export declare function loadStepDefinitions(globPattern: string[]): SupportCodeLibrary;
+/**
+ * Require modules by name or path resolved from the current working directory (e.g. `ts-node/register`)
+ */
+export declare function loadModules(modules: string[]): void;
+export declare function loadStepDefinitions(globPattern: string[], requireModules?: string[]): SupportCodeLibrary;
 export declare function load(config: CucumberAdapterConfig): {
     features: Feature[];
     supportCodeLibrary: SupportCodeLibrary;

package/adapter/js/loader.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFiles = findFiles;
 exports.loadFeatures = loadFeatures;
+exports.loadModules = loadModules;
 exports.loadStepDefinitions = loadStepDefinitions;
 exports.load = load;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const node_module_1 = require("node:module");
 const node_crypto_1 = require("node:crypto");
 const gherkin_1 = require("@cucumber/gherkin");
 const cucumber_1 = require("@cucumber/cucumber");
-const glob_1 = require("glob");
 const PlaywrightWorld_1 = require("./PlaywrightWorld");
 const uuidFn = () => (0, node_crypto_1.randomUUID)();
 const builder = new gherkin_1.AstBuilder(uuidFn);
@@ -28,35 +30,53 @@ function duplicates(tests) {
         return item;
     });
 }
+/**
+ * Find files matching glob patterns; returns unique absolute paths in stable (sorted) order
+ */
+function findFiles(patterns) {
+    if (patterns.length === 0)
+        return [];
+    const files = (0, node_fs_1.globSync)(patterns).map(file => (0, node_path_1.resolve)(file));
+    return [...new Set(files)].sort();
+}
 function loadFeatures(globPattern) {
-    const files = (0, glob_1.globSync)(globPattern);
-    return files.map(file => {
-        const filePath = (0, node_path_1.resolve)(file);
+    const files = findFiles(globPattern);
+    return files.map(filePath => {
         const gherkinDocument = parser.parse((0, node_fs_1.readFileSync)(filePath, 'utf-8'));
         return {
             feature: gherkinDocument.feature?.name,
             uri: filePath,
             gherkinDocument,
-            tests: duplicates((0, gherkin_1.compile)(gherkinDocument, file, uuidFn))
+            tests: duplicates((0, gherkin_1.compile)(gherkinDocument, (0, node_path_1.relative)(process.cwd(), filePath), uuidFn))
         };
     });
 }
-function loadStepDefinitions(globPattern) {
+/**
+ * Require modules by name or path resolved from the current working directory (e.g. `ts-node/register`)
+ */
+function loadModules(modules) {
+    const cwdRequire = (0, node_module_1.createRequire)((0, node_path_1.join)(process.cwd(), 'index.js'));
+    for (const name of modules) {
+        cwdRequire(name);
+    }
+}
+function loadStepDefinitions(globPattern, requireModules = []) {
     cucumber_1.supportCodeLibraryBuilder.reset(process.cwd(), uuidFn);
+    // cucumber defaults to 5000ms; apply a default timeout only when set explicitly with setDefaultTimeout
+    cucumber_1.supportCodeLibraryBuilder.defaultTimeout = undefined;
     cucumber_1.supportCodeLibraryBuilder.methods.setWorldConstructor(PlaywrightWorld_1.PlaywrightWorld);
-    const files = (0, glob_1.globSync)(globPattern);
-    for (const file of files) {
-        const filePath = (0, node_path_1.resolve)(file);
+    loadModules(requireModules);
+    for (const filePath of findFiles(globPattern)) {
         require(filePath);
     }
     return cucumber_1.supportCodeLibraryBuilder.finalize();
 }
 function load(config) {
-    const features = loadFeatures(config.paths);
-    const supportCodeLibrary = loadStepDefinitions([
-        ...(config.requireModules ?? []),
-        ...(config.require ?? []),
-        ...(config.import ?? [])
-    ]);
+    const envPaths = process.env.CUCUMBER_PATHS
+        ?.split(',')
+        .map(path => path.trim())
+        .filter(Boolean);
+    const features = loadFeatures(envPaths?.length ? envPaths : config.paths);
+    const supportCodeLibrary = loadStepDefinitions([...(config.require ?? []), ...(config.import ?? [])], config.requireModules ?? []);
     return { features, supportCodeLibrary };
 }

package/adapter/js/testDetails.d.ts

@@ -4,7 +4,16 @@ export interface ResolvedTestDetails {
     tag: string[];
     annotation: TestDetailsAnnotation[];
     lock: string[];
+    /** test timeout in milliseconds from `@timeout(ms)` tag (the last one wins) */
+    timeout?: number;
 }
+/**
+ * Resolve retries from `@retries(n)` feature tag.
+ * Playwright configures retries per describe block, so the tag is only supported on Feature.
+ */
+export declare function resolveRetries(featureTags: readonly {
+    name: string;
+}[]): number | undefined;
 /**
  * Translate gherkin tags of a pickle into playwright test details.
  *
@@ -12,6 +21,7 @@ export interface ResolvedTestDetails {
  * - `@lock(name)` → `lock: 'name'`; `@lock(-exclusive-)` → built-in exclusive lock
  * - `@annotation(type,description)` → `annotation: { type, description }`
  * - `@skip()` / `@fixme()` / `@fail()` / `@slow()` → playwright modifier with optional description, e.g. `@fixme(JIRA-1)`
+ * - `@timeout(ms)` → test timeout; `@retries(n)` → consumed here, applied per feature (see `resolveRetries`)
  *
  * Note: gherkin tags may not contain whitespace, so write `@annotation(issue,JIRA-1)` without spaces.
  */

package/adapter/js/testDetails.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRetries = resolveRetries;
 exports.resolveTestDetails = resolveTestDetails;
 const LOCK_TAG = /^@lock\(([^)]+)\)$/;
 const ANNOTATION_TAG = /^@annotation\(([^,)]+)(?:,(.*))?\)$/;
@@ -8,6 +9,21 @@ const ANNOTATION_TAG = /^@annotation\(([^,)]+)(?:,(.*))?\)$/;
  * (skip/fixme before fixtures are set up, fail/slow at test start).
  */
 const MODIFIER_TAG = /^@(skip|fixme|fail|slow)\((.*)\)$/;
+const TIMEOUT_TAG = /^@timeout\((\d+)\)$/;
+const RETRIES_TAG = /^@retries\((\d+)\)$/;
+/**
+ * Resolve retries from `@retries(n)` feature tag.
+ * Playwright configures retries per describe block, so the tag is only supported on Feature.
+ */
+function resolveRetries(featureTags) {
+    let retries;
+    for (const { name } of featureTags) {
+        const match = RETRIES_TAG.exec(name);
+        if (match)
+            retries = Number(match[1]);
+    }
+    return retries;
+}
 function unique(items) {
     return [...new Set(items)];
 }
@@ -22,6 +38,7 @@ function createAnnotation(type, description) {
  * - `@lock(name)` → `lock: 'name'`; `@lock(-exclusive-)` → built-in exclusive lock
  * - `@annotation(type,description)` → `annotation: { type, description }`
  * - `@skip()` / `@fixme()` / `@fail()` / `@slow()` → playwright modifier with optional description, e.g. `@fixme(JIRA-1)`
+ * - `@timeout(ms)` → test timeout; `@retries(n)` → consumed here, applied per feature (see `resolveRetries`)
  *
  * Note: gherkin tags may not contain whitespace, so write `@annotation(issue,JIRA-1)` without spaces.
  */
@@ -29,12 +46,21 @@ function resolveTestDetails(pickle) {
     const tag = [];
     const extraAnnotation = [];
     const lock = [];
+    let timeout;
     for (const name of unique(pickle.tags.map(item => item.name))) {
         const lockMatch = LOCK_TAG.exec(name);
         if (lockMatch) {
             lock.push(lockMatch[1].trim());
             continue;
         }
+        const timeoutMatch = TIMEOUT_TAG.exec(name);
+        if (timeoutMatch) {
+            timeout = Number(timeoutMatch[1]);
+            continue;
+        }
+        if (RETRIES_TAG.test(name)) {
+            continue;
+        }
         const annotationMatch = ANNOTATION_TAG.exec(name) ?? MODIFIER_TAG.exec(name);
         if (annotationMatch) {
             extraAnnotation.push(createAnnotation(annotationMatch[1].trim(), annotationMatch[2]));
@@ -48,5 +74,5 @@ function resolveTestDetails(pickle) {
         { type: 'tags', description: JSON.stringify(tag) },
         ...extraAnnotation
     ];
-    return { tag, annotation, lock: unique(lock) };
+    return { tag, annotation, lock: unique(lock), ...(timeout === undefined ? {} : { timeout }) };
 }

package/adapter/js/timeout.d.ts

@@ -0,0 +1,17 @@
+interface DefinitionWithTimeout {
+    options?: {
+        timeout?: number;
+    };
+}
+/**
+ * Resolve timeout of a step or hook definition:
+ * `{ timeout }` option of the definition, otherwise value set by `setDefaultTimeout`.
+ * Returns `undefined` when no timeout applies (not set, or disabled with `-1`/`0`);
+ * the Playwright test timeout still applies in that case.
+ */
+export declare function resolveTimeout(definition: DefinitionWithTimeout, defaultTimeout?: number): number | undefined;
+/**
+ * Run definition code, failing with `message` if it does not complete within `timeout` milliseconds
+ */
+export declare function runWithTimeout<T>(code: () => T | Promise<T>, timeout: number | undefined, message: string): Promise<T>;
+export {};

package/adapter/js/timeout.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTimeout = resolveTimeout;
+exports.runWithTimeout = runWithTimeout;
+const cucumber_1 = require("@cucumber/cucumber");
+/**
+ * Resolve timeout of a step or hook definition:
+ * `{ timeout }` option of the definition, otherwise value set by `setDefaultTimeout`.
+ * Returns `undefined` when no timeout applies (not set, or disabled with `-1`/`0`);
+ * the Playwright test timeout still applies in that case.
+ */
+function resolveTimeout(definition, defaultTimeout) {
+    const timeout = definition.options?.timeout ?? defaultTimeout;
+    return timeout === undefined || timeout <= 0 ? undefined : timeout;
+}
+/**
+ * Run definition code, failing with `message` if it does not complete within `timeout` milliseconds
+ */
+function runWithTimeout(code, timeout, message) {
+    const promise = Promise.resolve().then(code);
+    if (timeout === undefined)
+        return promise;
+    return (0, cucumber_1.wrapPromiseWithTimeout)(promise, timeout, message.replace('{timeout}', String(timeout)));
+}

package/adapter/js/types.d.ts

@@ -1,18 +1,37 @@
 import type { GherkinDocument, Pickle } from '@cucumber/messages';
 import type { TestType } from '@playwright/test';
+import type { Readable } from 'node:stream';
 export interface CucumberAdapterConfig {
+    /** Glob patterns for feature files. Can be overridden with `CUCUMBER_PATHS` env variable (comma separated). */
     paths: string[];
+    /** Glob patterns for step definition files */
     require?: string[];
+    /** Module names or paths (resolved from cwd) required before step definitions, e.g. `ts-node/register` */
     requireModules?: string[];
+    /** Glob patterns for step definition files */
     import?: string[];
+    /** Parameters available in world as `this.parameters` */
+    worldParameters?: unknown;
+    /** Cucumber tag expression to select scenarios. Combined with `CUCUMBER_TAGS` env variable using `and`. */
+    tags?: string;
+    /** Fail scenarios with pending steps (default `true`). When `false` such scenarios are marked as fixme. */
+    strict?: boolean;
+    /**
+     * Location reported for steps: `'definition'` (default) points to the step definition code,
+     * `'feature'` points to the step line in the feature file
+     */
+    stepLocation?: 'definition' | 'feature';
     [key: string]: unknown;
 }
+export interface AttachOptions {
+    fileName?: string;
+    mediaType?: string;
+}
+export type AttachData = string | Buffer | Readable;
+export type AttachFn = (data: AttachData, mediaTypeOrOptions?: string | AttachOptions) => Promise<void>;
 export interface WorldOptions {
     log?: (data: unknown) => void;
-    attach?: (data: unknown, details?: {
-        fileName?: string;
-        mediaType?: string;
-    }) => Promise<void>;
+    attach?: AttachFn;
     parameters?: unknown;
     supportCodeLibrary?: SupportCodeLibrary;
     config?: CucumberAdapterConfig;
@@ -21,13 +40,20 @@ export interface HookDefinition {
     uri?: string;
     line: number;
     name?: string;
-    code: (this: unknown, ...args: unknown[]) => Promise<void> | void;
+    options?: {
+        timeout?: number;
+    };
+    code: (this: unknown, ...args: unknown[]) => unknown;
     appliesToTestCase(testCase: Pickle): boolean;
 }
 export interface StepDefinitionMatch {
     uri?: string;
     line: number;
-    code: (this: unknown, ...args: unknown[]) => Promise<void> | void;
+    pattern?: string | RegExp;
+    options?: {
+        timeout?: number;
+    };
+    code: (this: unknown, ...args: unknown[]) => unknown;
     matchesStepName(text: string): boolean;
     getInvocationParameters(options: {
         step: {
@@ -52,6 +78,9 @@ export interface WorldBase {
 export interface SupportCodeLibrary {
     World: new (options: WorldOptions) => WorldBase;
     stepDefinitions: StepDefinitionMatch[];
+    parameterTypeRegistry: unknown;
+    /** set only when `setDefaultTimeout` is called */
+    defaultTimeout?: number;
     beforeTestRunHookDefinitions: HookDefinition[];
     afterTestRunHookDefinitions: HookDefinition[];
     beforeTestCaseHookDefinitions: HookDefinition[];

package/adapter/js/withWorld.d.ts

@@ -0,0 +1,43 @@
+import { type ITestCaseHookParameter, type ITestStepHookParameter } from '@cucumber/cucumber';
+type StepPattern = string | RegExp;
+type StepFunction<World> = (this: World, ...args: any[]) => unknown;
+type HookFunction<World, Parameter> = (this: World, parameter: Parameter) => unknown;
+export interface StepOptions {
+    timeout?: number;
+    wrapperOptions?: unknown;
+}
+export interface HookOptions {
+    name?: string;
+    tags?: string;
+    timeout?: number;
+}
+export interface DefineStep<World> {
+    (pattern: StepPattern, code: StepFunction<World>): void;
+    (pattern: StepPattern, options: StepOptions, code: StepFunction<World>): void;
+}
+export interface DefineHook<World, Parameter> {
+    (code: HookFunction<World, Parameter>): void;
+    (tags: string, code: HookFunction<World, Parameter>): void;
+    (options: HookOptions, code: HookFunction<World, Parameter>): void;
+}
+export interface TypedSupportCode<World> {
+    Given: DefineStep<World>;
+    When: DefineStep<World>;
+    Then: DefineStep<World>;
+    defineStep: DefineStep<World>;
+    Before: DefineHook<World, ITestCaseHookParameter>;
+    After: DefineHook<World, ITestCaseHookParameter>;
+    BeforeStep: DefineHook<World, ITestStepHookParameter>;
+    AfterStep: DefineHook<World, ITestStepHookParameter>;
+}
+/**
+ * Get step and hook definition functions with `this` typed as the given world,
+ * so step definitions don't need `this: MyWorld` annotation
+ * @example
+ * const { Given, When, Before } = withWorld<MyWorld>();
+ * When('I open {string}', async function (url: string) {
+ *     await this.page.goto(url); // `this` is MyWorld
+ * });
+ */
+export declare function withWorld<World>(): TypedSupportCode<World>;
+export {};

package/adapter/js/withWorld.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withWorld = withWorld;
+const cucumber_1 = require("@cucumber/cucumber");
+/**
+ * Get step and hook definition functions with `this` typed as the given world,
+ * so step definitions don't need `this: MyWorld` annotation
+ * @example
+ * const { Given, When, Before } = withWorld<MyWorld>();
+ * When('I open {string}', async function (url: string) {
+ *     await this.page.goto(url); // `this` is MyWorld
+ * });
+ */
+function withWorld() {
+    return { Given: cucumber_1.Given, When: cucumber_1.When, Then: cucumber_1.Then, defineStep: cucumber_1.defineStep, Before: cucumber_1.Before, After: cucumber_1.After, BeforeStep: cucumber_1.BeforeStep, AfterStep: cucumber_1.AfterStep };
+}

package/adapter/loader.d.ts

@@ -1,6 +1,14 @@
 import type { CucumberAdapterConfig, Feature, SupportCodeLibrary } from './types';
+/**
+ * Find files matching glob patterns; returns unique absolute paths in stable (sorted) order
+ */
+export declare function findFiles(patterns: string[]): string[];
 export declare function loadFeatures(globPattern: string[]): Feature[];
-export declare function loadStepDefinitions(globPattern: string[]): SupportCodeLibrary;
+/**
+ * Require modules by name or path resolved from the current working directory (e.g. `ts-node/register`)
+ */
+export declare function loadModules(modules: string[]): void;
+export declare function loadStepDefinitions(globPattern: string[], requireModules?: string[]): SupportCodeLibrary;
 export declare function load(config: CucumberAdapterConfig): {
     features: Feature[];
     supportCodeLibrary: SupportCodeLibrary;

package/adapter/loader.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFiles = findFiles;
 exports.loadFeatures = loadFeatures;
+exports.loadModules = loadModules;
 exports.loadStepDefinitions = loadStepDefinitions;
 exports.load = load;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const node_module_1 = require("node:module");
 const node_crypto_1 = require("node:crypto");
 const gherkin_1 = require("@cucumber/gherkin");
 const cucumber_1 = require("@cucumber/cucumber");
-const glob_1 = require("glob");
 const PlaywrightWorld_1 = require("./PlaywrightWorld");
 const uuidFn = () => (0, node_crypto_1.randomUUID)();
 const builder = new gherkin_1.AstBuilder(uuidFn);
@@ -28,36 +30,54 @@ function duplicates(tests) {
         return item;
     });
 }
+/**
+ * Find files matching glob patterns; returns unique absolute paths in stable (sorted) order
+ */
+function findFiles(patterns) {
+    if (patterns.length === 0)
+        return [];
+    const files = (0, node_fs_1.globSync)(patterns).map(file => (0, node_path_1.resolve)(file));
+    return [...new Set(files)].sort();
+}
 function loadFeatures(globPattern) {
-    const files = (0, glob_1.globSync)(globPattern);
-    return files.map(file => {
-        const filePath = (0, node_path_1.resolve)(file);
+    const files = findFiles(globPattern);
+    return files.map(filePath => {
         const gherkinDocument = parser.parse((0, node_fs_1.readFileSync)(filePath, 'utf-8'));
         return {
             feature: gherkinDocument.feature?.name,
             uri: filePath,
             gherkinDocument,
-            tests: duplicates((0, gherkin_1.compile)(gherkinDocument, file, uuidFn))
+            tests: duplicates((0, gherkin_1.compile)(gherkinDocument, (0, node_path_1.relative)(process.cwd(), filePath), uuidFn))
         };
     });
 }
-function loadStepDefinitions(globPattern) {
+/**
+ * Require modules by name or path resolved from the current working directory (e.g. `ts-node/register`)
+ */
+function loadModules(modules) {
+    const cwdRequire = (0, node_module_1.createRequire)((0, node_path_1.join)(process.cwd(), 'index.js'));
+    for (const name of modules) {
+        cwdRequire(name);
+    }
+}
+function loadStepDefinitions(globPattern, requireModules = []) {
     cucumber_1.supportCodeLibraryBuilder.reset(process.cwd(), uuidFn);
+    // cucumber defaults to 5000ms; apply a default timeout only when set explicitly with setDefaultTimeout
+    cucumber_1.supportCodeLibraryBuilder.defaultTimeout = undefined;
     cucumber_1.supportCodeLibraryBuilder.methods.setWorldConstructor(PlaywrightWorld_1.PlaywrightWorld);
-    const files = (0, glob_1.globSync)(globPattern);
-    for (const file of files) {
-        const filePath = (0, node_path_1.resolve)(file);
+    loadModules(requireModules);
+    for (const filePath of findFiles(globPattern)) {
         require(filePath);
     }
     return cucumber_1.supportCodeLibraryBuilder.finalize();
 }
 function load(config) {
-    const features = loadFeatures(config.paths);
-    const supportCodeLibrary = loadStepDefinitions([
-        ...(config.requireModules ?? []),
-        ...(config.require ?? []),
-        ...(config.import ?? [])
-    ]);
+    const envPaths = process.env.CUCUMBER_PATHS
+        ?.split(',')
+        .map(path => path.trim())
+        .filter(Boolean);
+    const features = loadFeatures(envPaths?.length ? envPaths : config.paths);
+    const supportCodeLibrary = loadStepDefinitions([...(config.require ?? []), ...(config.import ?? [])], config.requireModules ?? []);
     return { features, supportCodeLibrary };
 }
 //# sourceMappingURL=loader.js.map

package/adapter/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":";;;;;AAAA,qCAAuC;AACvC,yCAAoC;AACpC,6CAAyC;AACzC,+CAA4F;AAC5F,iDAA+D;AAE/D,+BAAgC;AAChC,uDAAoD;AAGpD,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAA,wBAAU,GAAE,CAAC;AAClC,MAAM,OAAO,GAAG,IAAI,oBAAU,CAAC,MAAM,CAAC,CAAC;AACvC,MAAM,OAAO,GAAG,IAAI,oCAA0B,EAAE,CAAC;AACjD,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAE3C,SAAS,UAAU,CAAC,KAAwB;IACxC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,sBAA6B,WAAqB;IAC9C,MAAM,KAAK,GAAG,IAAA,eAAQ,EAAC,WAAW,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACpB,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACtE,OAAO;YACH,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI;YACtC,GAAG,EAAE,QAAQ;YACb,eAAe;YACf,KAAK,EAAE,UAAU,CAAC,IAAA,iBAAO,EAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SAC5D,CAAA;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED,6BAAoC,WAAqB;IACrD,oCAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACvD,oCAAyB,CAAC,OAAO,CAAC,mBAAmB,CAAC,iCAAe,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,IAAA,eAAQ,EAAC,WAAW,CAAC,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,oCAAyB,CAAC,QAAQ,EAAmC,CAAC;AACjF,CAAC;AAED,cAAqB,MAA6B;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;QAC3C,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;KAC3B,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;AAC3C,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}