@serenity-js/cucumber 3.39.0 → 3.40.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.40.0](https://github.com/serenity-js/serenity-js/compare/v3.39.0...v3.40.0) (2026-02-04)
+
+
+### Bug Fixes
+
+* **deps:** update @cucumber/messages to 32.0.1 ([b308f3a](https://github.com/serenity-js/serenity-js/commit/b308f3abb1e7874f9d7aa21a61b3a2b7fe16d3ce))
+
+
+
+
+
 # [3.39.0](https://github.com/serenity-js/serenity-js/compare/v3.38.0...v3.39.0) (2026-01-30)
 
 **Note:** Version bump only for package @serenity-js/cucumber

package/lib/listeners/legacy/gherkin/GherkinParserAdapter.d.ts

@@ -0,0 +1,31 @@
+import type { GherkinDocument } from './nodes';
+/**
+ * Adapts the new @cucumber/gherkin Parser to produce output compatible with the old gherkin 5.x format.
+ *
+ * @private
+ */
+export declare class GherkinParserAdapter {
+    private readonly parser;
+    constructor();
+    parse(featureContent: string): GherkinDocument;
+    private adaptDocument;
+    private adaptFeature;
+    private adaptChild;
+    private adaptBackground;
+    private adaptScenario;
+    private adaptScenarioOutline;
+    private adaptStep;
+    private adaptDataTable;
+    private adaptDocString;
+    private adaptExamples;
+    private adaptTableRow;
+    private adaptTag;
+    private adaptComment;
+    /**
+     * Trims the description and returns it, or undefined if the description is empty.
+     * The old gherkin 5.x parser returned undefined for empty descriptions, which the mapper
+     * then passes directly to constructors using `description && new Description(description)`.
+     */
+    private trimDescription;
+}
+//# sourceMappingURL=GherkinParserAdapter.d.ts.map

package/lib/listeners/legacy/gherkin/GherkinParserAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GherkinParserAdapter.d.ts","sourceRoot":"","sources":["../../../../src/listeners/legacy/gherkin/GherkinParserAdapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgE,eAAe,EAAsE,MAAM,SAAS,CAAC;AAEjL;;;;GAIG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;;IAS1D,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe;IAK9C,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAK1B"}

package/lib/listeners/legacy/gherkin/GherkinParserAdapter.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GherkinParserAdapter = void 0;
+const gherkin_1 = require("@cucumber/gherkin");
+const messages_1 = require("@cucumber/messages");
+/**
+ * Adapts the new @cucumber/gherkin Parser to produce output compatible with the old gherkin 5.x format.
+ *
+ * @private
+ */
+class GherkinParserAdapter {
+    parser;
+    constructor() {
+        const createUuid = messages_1.IdGenerator.uuid();
+        const builder = new gherkin_1.AstBuilder(createUuid);
+        const matcher = new gherkin_1.GherkinClassicTokenMatcher();
+        this.parser = new gherkin_1.Parser(builder, matcher);
+    }
+    parse(featureContent) {
+        const newDoc = this.parser.parse(featureContent);
+        return this.adaptDocument(newDoc);
+    }
+    adaptDocument(doc) {
+        return {
+            type: 'GherkinDocument',
+            feature: doc.feature ? this.adaptFeature(doc.feature) : undefined,
+            comments: (doc.comments || []).map(c => this.adaptComment(c)),
+        };
+    }
+    adaptFeature(feature) {
+        return {
+            type: 'Feature',
+            location: feature.location,
+            tags: feature.tags.map(t => this.adaptTag(t)),
+            language: feature.language,
+            keyword: feature.keyword,
+            name: feature.name,
+            description: this.trimDescription(feature.description),
+            children: feature.children.map(child => this.adaptChild(child)),
+        };
+    }
+    adaptChild(child) {
+        if (child.background) {
+            return this.adaptBackground(child.background);
+        }
+        if (child.scenario) {
+            // Check if it's a Scenario Outline by looking at the keyword or examples
+            if (child.scenario.keyword === 'Scenario Outline' || child.scenario.keyword === 'Scenario Template' || child.scenario.examples.length > 0) {
+                return this.adaptScenarioOutline(child.scenario);
+            }
+            return this.adaptScenario(child.scenario);
+        }
+        // Rule children are not supported in the legacy format
+        throw new Error('Unsupported feature child type');
+    }
+    adaptBackground(bg) {
+        return {
+            type: 'Background',
+            location: bg.location,
+            tags: [],
+            keyword: bg.keyword,
+            name: bg.name,
+            description: this.trimDescription(bg.description),
+            steps: bg.steps.map(s => this.adaptStep(s)),
+        };
+    }
+    adaptScenario(scenario) {
+        return {
+            type: 'Scenario',
+            location: scenario.location,
+            tags: scenario.tags.map(t => this.adaptTag(t)),
+            keyword: scenario.keyword,
+            name: scenario.name,
+            description: this.trimDescription(scenario.description),
+            steps: scenario.steps.map(s => this.adaptStep(s)),
+        };
+    }
+    adaptScenarioOutline(scenario) {
+        return {
+            type: 'ScenarioOutline',
+            location: scenario.location,
+            tags: scenario.tags.map(t => this.adaptTag(t)),
+            keyword: scenario.keyword,
+            name: scenario.name,
+            description: this.trimDescription(scenario.description),
+            steps: scenario.steps.map(s => this.adaptStep(s)),
+            examples: scenario.examples.map(e => this.adaptExamples(e)),
+        };
+    }
+    adaptStep(step) {
+        const result = {
+            type: 'Step',
+            location: step.location,
+            keyword: step.keyword,
+            text: step.text,
+        };
+        if (step.dataTable) {
+            result.argument = this.adaptDataTable(step.dataTable);
+        }
+        else if (step.docString) {
+            result.argument = this.adaptDocString(step.docString);
+        }
+        return result;
+    }
+    adaptDataTable(dataTable) {
+        return {
+            type: 'DataTable',
+            location: dataTable.location,
+            rows: dataTable.rows.map(r => this.adaptTableRow(r)),
+        };
+    }
+    adaptDocString(docString) {
+        return {
+            type: 'DocString',
+            location: docString.location,
+            content: docString.content,
+        };
+    }
+    adaptExamples(examples) {
+        return {
+            type: 'Examples',
+            location: examples.location,
+            tags: examples.tags.map(t => this.adaptTag(t)),
+            keyword: examples.keyword,
+            name: examples.name,
+            description: this.trimDescription(examples.description),
+            tableHeader: this.adaptTableRow(examples.tableHeader),
+            tableBody: examples.tableBody.map(r => this.adaptTableRow(r)),
+        };
+    }
+    adaptTableRow(row) {
+        return {
+            type: 'TableRow',
+            location: row.location,
+            cells: row.cells.map(c => ({
+                type: 'TableCell',
+                location: c.location,
+                value: c.value,
+            })),
+        };
+    }
+    adaptTag(tag) {
+        return {
+            type: 'Tag',
+            location: tag.location,
+            name: tag.name,
+        };
+    }
+    adaptComment(comment) {
+        return {
+            type: 'Comment',
+            location: comment.location,
+            text: comment.text,
+        };
+    }
+    /**
+     * Trims the description and returns it, or undefined if the description is empty.
+     * The old gherkin 5.x parser returned undefined for empty descriptions, which the mapper
+     * then passes directly to constructors using `description && new Description(description)`.
+     */
+    trimDescription(description) {
+        const trimmed = description?.trim();
+        // Return undefined for empty descriptions to match old gherkin 5.x behavior
+        return trimmed || undefined;
+    }
+}
+exports.GherkinParserAdapter = GherkinParserAdapter;
+//# sourceMappingURL=GherkinParserAdapter.js.map

package/lib/listeners/legacy/gherkin/GherkinParserAdapter.js.map

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

package/lib/listeners/legacy/gherkin/index.d.ts

@@ -1,3 +1,4 @@
 export * from './feature-files';
+export * from './GherkinParserAdapter';
 export * from './model';
 //# sourceMappingURL=index.d.ts.map

package/lib/listeners/legacy/gherkin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/listeners/legacy/gherkin/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/listeners/legacy/gherkin/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC"}

package/lib/listeners/legacy/gherkin/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./feature-files"), exports);
+__exportStar(require("./GherkinParserAdapter"), exports);
 __exportStar(require("./model"), exports);
 //# sourceMappingURL=index.js.map

package/lib/listeners/legacy/gherkin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/listeners/legacy/gherkin/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/listeners/legacy/gherkin/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,yDAAuC;AACvC,0CAAwB"}

package/lib/listeners/legacy/gherkin/nodes/DataTable.d.ts

@@ -4,7 +4,7 @@ import type { TableRow } from './TableRow';
  * @private
  */
 export interface DataTable extends StepArgument {
-    type: 'DocString';
+    type: 'DataTable';
     rows: TableRow[];
 }
 //# sourceMappingURL=DataTable.d.ts.map

package/lib/listeners/legacy/gherkin/nodes/Feature.d.ts

@@ -10,7 +10,7 @@ export interface Feature extends ASTNode {
     language: string;
     keyword: string;
     name: string;
-    description: string;
+    description?: string;
     children: ScenarioDefinition[];
 }
 //# sourceMappingURL=Feature.d.ts.map

package/lib/listeners/legacy/gherkin/nodes/Feature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Feature.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/Feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAClC"}
+{"version":3,"file":"Feature.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/Feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAClC"}

package/lib/listeners/legacy/gherkin/nodes/Location.d.ts

@@ -3,6 +3,6 @@
  */
 export interface Location {
     line: number;
-    column: number;
+    column?: number;
 }
 //# sourceMappingURL=Location.d.ts.map

package/lib/listeners/legacy/gherkin/nodes/Location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Location.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/Location.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"Location.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/Location.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/lib/listeners/legacy/gherkin/nodes/ScenarioDefinition.d.ts

@@ -9,7 +9,7 @@ export interface ScenarioDefinition extends ASTNode {
     tags: Tag[];
     keyword: string;
     name: string;
-    description: string;
+    description?: string;
     steps: Step[];
 }
 //# sourceMappingURL=ScenarioDefinition.d.ts.map

package/lib/listeners/legacy/gherkin/nodes/ScenarioDefinition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScenarioDefinition.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/ScenarioDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IAC/C,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,iBAAiB,CAAC;IACpD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;CACjB"}
+{"version":3,"file":"ScenarioDefinition.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/ScenarioDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IAC/C,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,iBAAiB,CAAC;IACpD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;CACjB"}

package/lib/listeners/legacy/gherkin/nodes/index.d.ts

@@ -2,6 +2,7 @@ export * from './Background';
 export * from './Comment';
 export * from './DataTable';
 export * from './DocString';
+export * from './Examples';
 export * from './Feature';
 export * from './GherkinDocument';
 export * from './Location';

package/lib/listeners/legacy/gherkin/nodes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC"}

package/lib/listeners/legacy/gherkin/nodes/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./Background"), exports);
 __exportStar(require("./Comment"), exports);
 __exportStar(require("./DataTable"), exports);
 __exportStar(require("./DocString"), exports);
+__exportStar(require("./Examples"), exports);
 __exportStar(require("./Feature"), exports);
 __exportStar(require("./GherkinDocument"), exports);
 __exportStar(require("./Location"), exports);

package/lib/listeners/legacy/gherkin/nodes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,8CAA4B;AAC5B,8CAA4B;AAC5B,4CAA0B;AAC1B,oDAAkC;AAClC,6CAA2B;AAC3B,6CAA2B;AAC3B,uDAAqC;AACrC,oDAAkC;AAClC,yCAAuB;AACvB,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAC3B,wCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/listeners/legacy/gherkin/nodes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,8CAA4B;AAC5B,8CAA4B;AAC5B,6CAA2B;AAC3B,4CAA0B;AAC1B,oDAAkC;AAClC,6CAA2B;AAC3B,6CAA2B;AAC3B,uDAAqC;AACrC,oDAAkC;AAClC,yCAAuB;AACvB,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAC3B,wCAAsB"}

package/lib/listeners/legacy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/listeners/legacy/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAQ,MAAM,0BAA0B,CAAC;AAOnE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,GAAG,GAAG,CA8BlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/listeners/legacy/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAQ,MAAM,0BAA0B,CAAC;AAMnE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,GAAG,GAAG,CA8BlF"}

package/lib/listeners/legacy/index.js

@@ -4,7 +4,6 @@ exports.createListener = createListener;
 const core_1 = require("@serenity-js/core");
 const gherkin_1 = require("./gherkin");
 const notifier_1 = require("./notifier");
-const Gherkin = require("gherkin");
 /**
  * Creates a listener for Cucumber.js 0.x-6.x
  *
@@ -14,7 +13,7 @@ const Gherkin = require("gherkin");
 function createListener(serenity, moduleLoader) {
     const version = moduleLoader.versionOf('cucumber');
     try {
-        const cucumber = moduleLoader.require('cucumber'), notifier = new notifier_1.Notifier(serenity), mapper = new gherkin_1.FeatureFileMapper(), resultMapper = new notifier_1.ResultMapper(serenity), cache = new gherkin_1.Cache(), loader = new gherkin_1.FeatureFileLoader(new gherkin_1.FeatureFileParser(new Gherkin.Parser()), mapper, cache);
+        const cucumber = moduleLoader.require('cucumber'), notifier = new notifier_1.Notifier(serenity), mapper = new gherkin_1.FeatureFileMapper(), resultMapper = new notifier_1.ResultMapper(serenity), cache = new gherkin_1.Cache(), loader = new gherkin_1.FeatureFileLoader(new gherkin_1.FeatureFileParser(new gherkin_1.GherkinParserAdapter()), mapper, cache);
         return require(`./cucumber-${version.major()}`)({
             serenity,
             notifier,

package/lib/listeners/legacy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/listeners/legacy/index.ts"],"names":[],"mappings":";;AAeA,wCA8BC;AA5CD,4CAAuD;AAIvD,uCAA2F;AAC3F,yCAAoD;AACpD,mCAAoC;AAEpC;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAkB,EAAE,YAA0B;IAEzE,MAAM,OAAO,GAAI,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,CAAC;QACD,MACI,QAAQ,GAAU,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,EAClD,QAAQ,GAAW,IAAI,mBAAQ,CAAC,QAAQ,CAAC,EACzC,MAAM,GAAY,IAAI,2BAAiB,EAAE,EACzC,YAAY,GAAM,IAAI,uBAAY,CAAC,QAAQ,CAAC,EAC5C,KAAK,GAAa,IAAI,eAAK,EAAwB,EACnD,MAAM,GAAY,IAAI,2BAAiB,CACnC,IAAI,2BAAiB,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,EAC3C,MAAM,EACN,KAAK,CACR,CAAC;QAEN,OAAO,OAAO,CAAC,cAAe,OAAO,CAAC,KAAK,EAAG,EAAE,CAAC,CAAC;YAC9C,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,YAAY;YACZ,KAAK;YACL,MAAM;YACN,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,yBAAkB,CAAC,oBAAqB,OAAO,CAAC,QAAQ,EAAG,uBAAuB,EAAE,KAAK,CAAC,CAAC;IACzG,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/listeners/legacy/index.ts"],"names":[],"mappings":";;AAcA,wCA8BC;AA3CD,4CAAuD;AAIvD,uCAAiH;AACjH,yCAAoD;AAEpD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAkB,EAAE,YAA0B;IAEzE,MAAM,OAAO,GAAI,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,CAAC;QACD,MACI,QAAQ,GAAU,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,EAClD,QAAQ,GAAW,IAAI,mBAAQ,CAAC,QAAQ,CAAC,EACzC,MAAM,GAAY,IAAI,2BAAiB,EAAE,EACzC,YAAY,GAAM,IAAI,uBAAY,CAAC,QAAQ,CAAC,EAC5C,KAAK,GAAa,IAAI,eAAK,EAAwB,EACnD,MAAM,GAAY,IAAI,2BAAiB,CACnC,IAAI,2BAAiB,CAAC,IAAI,8BAAoB,EAAE,CAAC,EACjD,MAAM,EACN,KAAK,CACR,CAAC;QAEN,OAAO,OAAO,CAAC,cAAe,OAAO,CAAC,KAAK,EAAG,EAAE,CAAC,CAAC;YAC9C,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,YAAY;YACZ,KAAK;YACL,MAAM;YACN,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,yBAAkB,CAAC,oBAAqB,OAAO,CAAC,QAAQ,EAAG,uBAAuB,EAAE,KAAK,CAAC,CAAC;IACzG,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/cucumber",
-  "version": "3.39.0",
+  "version": "3.40.0",
   "description": "Serenity/JS test runner adapter for seamless integration with any version of Cucumber.js, facilitating BDD-style test automation and leveraging Serenity/JS reporting capabilities",
   "author": {
     "name": "Jan Molak",
@@ -50,10 +50,10 @@
     "node": "^20 || ^22 || ^24"
   },
   "dependencies": {
-    "@cucumber/messages": "26.0.1",
-    "@serenity-js/core": "3.39.0",
+    "@cucumber/gherkin": "38.0.0",
+    "@cucumber/messages": "32.0.1",
+    "@serenity-js/core": "3.40.0",
     "cli-table3": "0.6.5",
-    "gherkin": "5.1.0",
     "tiny-types": "1.24.3"
   },
   "peerDependencies": {
@@ -79,5 +79,5 @@
     "ts-node": "10.9.2",
     "typescript": "5.9.3"
   },
-  "gitHead": "253c63474dd24f3850a0f34b6d5f42559049a25c"
+  "gitHead": "185b8435cf6e87b8a54f10944da3e652227ecb6e"
 }

package/src/listeners/legacy/gherkin/GherkinParserAdapter.ts

@@ -0,0 +1,184 @@
+import { AstBuilder, GherkinClassicTokenMatcher, Parser } from '@cucumber/gherkin';
+import type * as messages from '@cucumber/messages';
+import { IdGenerator } from '@cucumber/messages';
+
+import type { Background, Comment, DataTable, DocString, Examples, Feature, GherkinDocument, Scenario, ScenarioDefinition, ScenarioOutline, Step, TableRow, Tag } from './nodes';
+
+/**
+ * Adapts the new @cucumber/gherkin Parser to produce output compatible with the old gherkin 5.x format.
+ *
+ * @private
+ */
+export class GherkinParserAdapter {
+    private readonly parser: Parser<messages.GherkinDocument>;
+
+    constructor() {
+        const createUuid = IdGenerator.uuid();
+        const builder = new AstBuilder(createUuid);
+        const matcher = new GherkinClassicTokenMatcher();
+        this.parser = new Parser(builder, matcher);
+    }
+
+    parse(featureContent: string): GherkinDocument {
+        const newDoc = this.parser.parse(featureContent);
+        return this.adaptDocument(newDoc);
+    }
+
+    private adaptDocument(doc: messages.GherkinDocument): GherkinDocument {
+        return {
+            type: 'GherkinDocument',
+            feature: doc.feature ? this.adaptFeature(doc.feature) : undefined,
+            comments: (doc.comments || []).map(c => this.adaptComment(c)),
+        };
+    }
+
+    private adaptFeature(feature: messages.Feature): Feature {
+        return {
+            type: 'Feature',
+            location: feature.location,
+            tags: feature.tags.map(t => this.adaptTag(t)),
+            language: feature.language,
+            keyword: feature.keyword,
+            name: feature.name,
+            description: this.trimDescription(feature.description),
+            children: feature.children.map(child => this.adaptChild(child)),
+        };
+    }
+
+    private adaptChild(child: messages.FeatureChild): ScenarioDefinition {
+        if (child.background) {
+            return this.adaptBackground(child.background);
+        }
+        if (child.scenario) {
+            // Check if it's a Scenario Outline by looking at the keyword or examples
+            if (child.scenario.keyword === 'Scenario Outline' || child.scenario.keyword === 'Scenario Template' || child.scenario.examples.length > 0) {
+                return this.adaptScenarioOutline(child.scenario);
+            }
+            return this.adaptScenario(child.scenario);
+        }
+        // Rule children are not supported in the legacy format
+        throw new Error('Unsupported feature child type');
+    }
+
+    private adaptBackground(bg: messages.Background): Background {
+        return {
+            type: 'Background',
+            location: bg.location,
+            tags: [],
+            keyword: bg.keyword,
+            name: bg.name,
+            description: this.trimDescription(bg.description),
+            steps: bg.steps.map(s => this.adaptStep(s)),
+        };
+    }
+
+    private adaptScenario(scenario: messages.Scenario): Scenario {
+        return {
+            type: 'Scenario',
+            location: scenario.location,
+            tags: scenario.tags.map(t => this.adaptTag(t)),
+            keyword: scenario.keyword,
+            name: scenario.name,
+            description: this.trimDescription(scenario.description),
+            steps: scenario.steps.map(s => this.adaptStep(s)),
+        };
+    }
+
+    private adaptScenarioOutline(scenario: messages.Scenario): ScenarioOutline {
+        return {
+            type: 'ScenarioOutline',
+            location: scenario.location,
+            tags: scenario.tags.map(t => this.adaptTag(t)),
+            keyword: scenario.keyword,
+            name: scenario.name,
+            description: this.trimDescription(scenario.description),
+            steps: scenario.steps.map(s => this.adaptStep(s)),
+            examples: scenario.examples.map(e => this.adaptExamples(e)),
+        };
+    }
+
+    private adaptStep(step: messages.Step): Step {
+        const result: Step = {
+            type: 'Step',
+            location: step.location,
+            keyword: step.keyword,
+            text: step.text,
+        };
+
+        if (step.dataTable) {
+            result.argument = this.adaptDataTable(step.dataTable);
+        } else if (step.docString) {
+            result.argument = this.adaptDocString(step.docString);
+        }
+
+        return result;
+    }
+
+    private adaptDataTable(dataTable: messages.DataTable): DataTable {
+        return {
+            type: 'DataTable',
+            location: dataTable.location,
+            rows: dataTable.rows.map(r => this.adaptTableRow(r)),
+        };
+    }
+
+    private adaptDocString(docString: messages.DocString): DocString {
+        return {
+            type: 'DocString',
+            location: docString.location,
+            content: docString.content,
+        };
+    }
+
+    private adaptExamples(examples: messages.Examples): Examples {
+        return {
+            type: 'Examples',
+            location: examples.location,
+            tags: examples.tags.map(t => this.adaptTag(t)),
+            keyword: examples.keyword,
+            name: examples.name,
+            description: this.trimDescription(examples.description),
+            tableHeader: this.adaptTableRow(examples.tableHeader),
+            tableBody: examples.tableBody.map(r => this.adaptTableRow(r)),
+        };
+    }
+
+    private adaptTableRow(row: messages.TableRow): TableRow {
+        return {
+            type: 'TableRow',
+            location: row.location,
+            cells: row.cells.map(c => ({
+                type: 'TableCell',
+                location: c.location,
+                value: c.value,
+            })),
+        };
+    }
+
+    private adaptTag(tag: messages.Tag): Tag {
+        return {
+            type: 'Tag',
+            location: tag.location,
+            name: tag.name,
+        };
+    }
+
+    private adaptComment(comment: messages.Comment): Comment {
+        return {
+            type: 'Comment',
+            location: comment.location,
+            text: comment.text,
+        };
+    }
+
+    /**
+     * Trims the description and returns it, or undefined if the description is empty.
+     * The old gherkin 5.x parser returned undefined for empty descriptions, which the mapper
+     * then passes directly to constructors using `description && new Description(description)`.
+     */
+    private trimDescription(description: string | undefined): string | undefined {
+        const trimmed = description?.trim();
+        // Return undefined for empty descriptions to match old gherkin 5.x behavior
+        return trimmed || undefined;
+    }
+}

package/src/listeners/legacy/gherkin/index.ts

@@ -1,2 +1,3 @@
 export * from './feature-files';
+export * from './GherkinParserAdapter';
 export * from './model';

package/src/listeners/legacy/gherkin/nodes/DataTable.ts

@@ -5,6 +5,6 @@ import type { TableRow } from './TableRow';
  * @private
  */
 export interface DataTable extends StepArgument {
-    type: 'DocString';
+    type: 'DataTable';
     rows: TableRow[];
 }

package/src/listeners/legacy/gherkin/nodes/Feature.ts

@@ -11,6 +11,6 @@ export interface Feature extends ASTNode {
     language: string;
     keyword: string;
     name: string;
-    description: string;
+    description?: string;
     children: ScenarioDefinition[];
 }

package/src/listeners/legacy/gherkin/nodes/Location.ts

@@ -3,5 +3,5 @@
  */
 export interface Location {
     line: number;
-    column: number;
+    column?: number;
 }

package/src/listeners/legacy/gherkin/nodes/ScenarioDefinition.ts

@@ -10,6 +10,6 @@ export interface ScenarioDefinition extends ASTNode {
     tags: Tag[];
     keyword: string;
     name: string;
-    description: string;
+    description?: string;
     steps: Step[];
 }

package/src/listeners/legacy/gherkin/nodes/index.ts

@@ -2,6 +2,7 @@ export * from './Background';
 export * from './Comment';
 export * from './DataTable';
 export * from './DocString';
+export * from './Examples';
 export * from './Feature';
 export * from './GherkinDocument';
 export * from './Location';

package/src/listeners/legacy/index.ts

@@ -3,9 +3,8 @@ import { ConfigurationError } from '@serenity-js/core';
 import type { ModuleLoader, Path } from '@serenity-js/core/lib/io';
 
 import type { FeatureFileMap} from './gherkin';
-import { Cache, FeatureFileLoader, FeatureFileMapper, FeatureFileParser } from './gherkin';
+import { Cache, FeatureFileLoader, FeatureFileMapper, FeatureFileParser, GherkinParserAdapter } from './gherkin';
 import { Notifier, ResultMapper } from './notifier';
-import Gherkin = require('gherkin');
 
 /**
  * Creates a listener for Cucumber.js 0.x-6.x
@@ -25,7 +24,7 @@ export function createListener(serenity: Serenity, moduleLoader: ModuleLoader):
             resultMapper    = new ResultMapper(serenity),
             cache           = new Cache<Path, FeatureFileMap>(),
             loader          = new FeatureFileLoader(
-                new FeatureFileParser(new Gherkin.Parser()),
+                new FeatureFileParser(new GherkinParserAdapter()),
                 mapper,
                 cache,
             );