@g_package/jest-cucumber-fusion 2.0.0 → 3.0.0

package/test/specs/features/scenario-outlines.feature

@@ -1,88 +0,0 @@
-Feature: Online sales
-
-    Scenario Outline: Selling an <Item>
-        Given I have a(n) <Item>
-        When I sell the <Item>
-        Then I should get $<Amount>
-
-        Examples:
-
-        | Item                                           | Amount |
-        | Autographed Neil deGrasse Tyson book           | 100    |
-        | Rick Astley t-shirt                            | 22     |
-        | An idea to replace EVERYTHING with blockchains | 0      |
-
-
-    Scenario Outline: Selling all of one
-        Given I want to sell all my <Item>
-        When I sell all my <Item> at the price of $<Amount> CAD
-        Then I should still get $<Amount>
-
-        Examples:
-
-            | Item                                           | Amount |
-            | Autographed Neil deGrasse Tyson book           | 100    |
-            | Rick Astley t-shirt                            | 22     |
-            | An idea to replace EVERYTHING with blockchains | 0      |
-
-
-    Scenario: Selling a thing
-        Given I have an Item named '<ThatCouldLookLikeAnOutlineVariable>'
-        When I sell <ThatCouldLookLikeAnOutlineVariable With Spaces in it>
-        Then I get $<Amount>
-
-
-    Scenario Outline: Additional regexp in outline line
-        Given I want to sell all my <Item>
-        When I sell all my <Item> at the price of $100 CAD
-        Then I should still get $<Amount>
-
-        Examples:
-            | Item                                           | Amount |
-            | Autographed Neil deGrasse Tyson book           | 100    |
-            | Rick Astley t-shirt                            | 100    |
-
-
-    Scenario Outline: Additional regexp in outline line with non-string variables for <Item>
-        Given I want to sell all my <Item>
-        When I sell all my <Item> with a starting price of $<StartingPrice> at the rebate price of $100
-        Then I should still get $<Amount>
-
-        Examples:
-            | Item                                           | StartingPrice    | Amount    |
-            | Autographed Neil deGrasse Tyson book           | 100              | 100       |
-            | Rick Astley t-shirt                            | 22               | 100       |
-#
-#
-    Scenario Outline: Additional regexp in outline line with non-string variables and static one in the middle for <Item>
-        Given I want to sell all my <Item>
-        When I sell all my <Item> with a starting price of $100 at the rebate price of $<RebatePrice>
-        Then I should still get $<Amount>
-
-        Examples:
-            | Item                                           | RebatePrice      | Amount    |
-            | Autographed Neil deGrasse Tyson book           | 20               | 20        |
-            | Rick Astley t-shirt                            | 50               | 50        |
-
-
-    Scenario Outline: Additional regepx in outline line with non-string variable at the end for <Item>
-        Given I want to sell all my <Item>
-        When I sell all my <Item> with a starting price of $100 at the rebate price of $<RebatePrice>
-        Then the 1st item 1st price has a price amount of <Amount> which is a 'Number'
-
-        Examples:
-            | Item                                           | RebatePrice      | Amount    |
-            | Autographed Neil deGrasse Tyson book           | 20               | 20        |
-            | Rick Astley t-shirt                            | 50               | 50        |
-# Ability: this ones are not currently possible
-##
-#    Scenario Outline: Additional mix regexp and non-regexp in outline line with non-string variables and static one in the middle for <Item>
-#        Given I want to sell all my <Item>
-#        When I sell all my <Item> with a starting price <Description> price of <RebatePrice>$ <Currency> which is nice
-#        Then I should still get $<Amount>
-#
-#        Examples:
-#            | Item                                           | Description                  | RebatePrice   | Amount | Currency         |
-#            | Autographed Neil deGrasse Tyson book           | of $100 at the fantastic     | 20            | 20     | USD              |
-#            | Rick Astley t-shirt                            | of $100 at the fantastic     | 50            | 50     | CAD              |
-#            | Rick Astley t-shirt                            | of $100 at the rebate        | 50            | 50     | CAD              |

package/test/specs/features/step-definitions/ambiguous-step-shadowing.steps.js

@@ -1,92 +0,0 @@
-/**
- * Regression test — H1: regex first-match shadowing.
- * RCA: docs/feature/review-hardening/discuss/rca.md (H1, HIGH — only silent-wrong-result bug).
- *
- * findMatchingStep (src/index.js:168-188) uses Object.keys(...).find(...) → the FIRST
- * registered definition that matches a step wins. Register a broad regex before a specific
- * one for the same keyword and the broad (wrong) handler is bound silently with the wrong
- * captured args; jest-cucumber's re-validation is still satisfied, so the scenario passes.
- * jest-cucumber's own automatic binding raises an ambiguity error here — this wrapper
- * suppresses it.
- *
- * LOCKED FIX CONTRACT (DELIVER implements; this test asserts it): when MORE THAN ONE step
- * definition matches a step, Fusion must THROW an ambiguity error (naming the step text /
- * competing matchers) rather than silently taking the first.
- *
- * MECHANISM / caveat: the wrapper's step matching (findMatchingStep) runs inside the scenario
- * callback that Fusion hands to jest-cucumber's defineFeature — it is NOT reachable
- * synchronously through Fusion's return value, and an ambiguous feature can never resolve to
- * a green jest-cucumber scenario (post-fix it throws by design). So we drive the REAL wrapper
- * (Fusion + real src/index.js) and substitute ONLY the external collaborator jest-cucumber
- * (the non-deterministic test-runner port) with a double that captures the scenario callback,
- * then invoke that callback synchronously and assert it throws. This is the "drive the SUT
- * through its public surface, fake only external ports" mandate applied to this JS wrapper.
- *
- * CURRENT STATUS: RED — findMatchingStep does not throw on ambiguity, so the captured callback
- * completes without error and toThrow fails ("received function did not throw").
- */
-
-const mockState = { capturedCallback: null, feature: null };
-
-jest.mock("jest-cucumber", () => ({
-  loadFeature: jest.fn(() => mockState.feature),
-  defineFeature: jest.fn((feature, callback) => {
-    mockState.capturedCallback = callback;
-  }),
-}));
-
-const { Given, Fusion } = require("../../../../src");
-
-// Broad definition registered FIRST — this is the one that shadows.
-Given(/^I have (.*)$/, () => {});
-// Specific definition registered SECOND — the handler the author actually intends.
-Given(/^I have (\d+) apples$/, () => {});
-
-describe("H1 — ambiguous step definitions", () => {
-  test("a step matching two definitions is rejected as ambiguous, not silently shadowed", () => {
-    // The feature file is never read (loadFeature is faked); this is the parsed shape the
-    // wrapper consumes. The step "I have 3 apples" matches BOTH definitions above.
-    mockState.feature = {
-      title: "Ambiguous step matching",
-      scenarios: [
-        {
-          title: "counting apples",
-          steps: [
-            {
-              keyword: "given",
-              stepText: "I have 3 apples",
-              stepArgument: undefined,
-            },
-          ],
-        },
-      ],
-      scenarioOutlines: [],
-    };
-
-    // Drive the real wrapper; the faked jest-cucumber captures the scenario callback.
-    Fusion("../ambiguous-step-shadowing.feature");
-
-    const runScenarioMatching = () => {
-      // capturedCallback = (testFn) =>
-      //   matchJestTestSuiteWithCucumberFeature(registry, scenarios, testFn, ...)
-      // (hooks are wired once per feature by registerHooks, outside this call: M6)
-      mockState.capturedCallback((_title, scenarioBody) => {
-        // scenarioBody performs the wrapper's step matching (findMatchingStep) synchronously.
-        scenarioBody({
-          given: () => {},
-          when: () => {},
-          then: () => {},
-          and: () => {},
-          but: () => {},
-        });
-      });
-    };
-
-    // Locked contract: ambiguity must throw. Pre-fix this does NOT throw (silent first-match).
-    // Match the full contract signature (not a loose /ambig/i) so an incidental "ambiguous"
-    // in some unrelated error can't satisfy the assertion.
-    expect(runScenarioMatching).toThrow(
-      /Ambiguous step definition.*matches \d+ step definitions/i
-    );
-  });
-});

package/test/specs/features/step-definitions/basic-scenarios.steps.js

@@ -1,62 +0,0 @@
-const { Given, When, Then, And, But, Fusion } = require("../../../../src");
-
-const { Rocket } = require("../../../src/rocket");
-
-let rocket;
-let rocketOnTheLaunchpad;
-
-const observableRocketState = () => ({
-  isInSpace: rocket.isInSpace,
-  boostersLanded: rocket.boostersLanded,
-});
-
-Given("I am Elon Musk attempting to launch a rocket into space", () => {
-  rocket = new Rocket();
-  // Remember how the rocket sat on the pad, so a later step can prove it moved
-  rocketOnTheLaunchpad = observableRocketState();
-});
-
-When("I launch the rocket", () => {
-  rocket.launch();
-});
-
-When("I launch the '<rocket>'", () => {
-  rocket.launch();
-});
-
-When(/^I launch my personal rocket named '(.*)'$/, (nameRocket) => {
-  expect(nameRocket).toBe("<space poney==>");
-  rocket.launch();
-});
-
-Then("the rocket should end up in space", () => {
-  expect(rocket.isInSpace).toBe(true);
-});
-
-/// Complex Regex :  at position (\[(?: *\d+(?: |, |,)*)+\]) with no value
-And(
-  /^my position in 2D space is (\[(?: *\d+(?: |, |,)*)+\])$/,
-  (arrayPosition) => {
-    const isAnArray = JSON.parse(arrayPosition);
-    expect(isAnArray).toBeInstanceOf(Array);
-  }
-);
-
-And(/^the booster\(s\) should land back on the launch pad$/, () => {
-  expect(rocket.boostersLanded).toBe(true);
-});
-
-But("nobody should doubt me ever again", () => {
-  // The doubt is that the rocket never really flew. It sat on the pad — grounded,
-  // boosters intact — and it is now in space with its boosters recovered.
-  expect(rocketOnTheLaunchpad).toEqual({
-    isInSpace: false,
-    boostersLanded: true,
-  });
-  expect(observableRocketState()).toEqual({
-    isInSpace: true,
-    boostersLanded: true,
-  });
-});
-
-Fusion("../basic-scenarios.feature");

package/test/specs/features/step-definitions/fuzz-properties.steps.js

@@ -1,170 +0,0 @@
-// Property-based fuzz of the public surface. Each sampled case writes its own feature
-// file, registers its own steps and calls Fusion(); since M3 every Fusion() starts from
-// an empty registry, so one module can host many generated features.
-//
-// The seed is fixed so a failure reproduces: it appears in every feature title.
-// Widen locally with FUZZ_SEED=<n> FUZZ_RUNS=<n> npx jest fuzz-properties.
-// Sensitivity was proven against the published 1.0.0: P5 reproduces the L4 crash and
-// P4 fails every case on the L3 dropped docstring.
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const fc = require("fast-check");
-
-const { Given, When, Then, Fusion } = require("../../../../src");
-
-const SEED = Number(process.env.FUZZ_SEED || 20261002);
-const RUNS = Number(process.env.FUZZ_RUNS || 40);
-
-const featureDir = fs.mkdtempSync(path.join(os.tmpdir(), "fusion-fuzz-"));
-let featureCount = 0;
-const writeFeature = (body) => {
-  featureCount += 1;
-  const featurePath = path.join(featureDir, `case-${featureCount}.feature`);
-  fs.writeFileSync(featurePath, body);
-  return featurePath;
-};
-afterAll(() => {
-  fs.rmSync(featureDir, { recursive: true, force: true });
-});
-
-const sample = (arbitrary) =>
-  fc.sample(arbitrary, { seed: SEED, numRuns: RUNS });
-const title = (property, caseIndex) =>
-  `fuzz ${property} case ${caseIndex} (seed ${SEED})`;
-
-// Words that are safe inside Gherkin step text: no structural characters
-// (| # " < > @ :) and no leading or trailing whitespace.
-const word = fc.stringMatching(/^[A-Za-z0-9][A-Za-z0-9_\-.,'!?]{0,11}$/);
-const sentence = fc
-  .array(word, { minLength: 1, maxLength: 6 })
-  .map((words) => words.join(" "));
-
-// P1: a string matcher binds arbitrary step text, and the step runs exactly once.
-sample(sentence).forEach((stepText, caseIndex) => {
-  let calls = 0;
-  Given(`p1 ${stepText}`, () => {
-    calls += 1;
-  });
-  Then("p1 it ran once", () => {
-    expect(calls).toBe(1);
-  });
-
-  Fusion(
-    writeFeature(
-      `Feature: ${title("P1", caseIndex)}\n` +
-        `  Scenario: string matcher\n` +
-        `    Given p1 ${stepText}\n` +
-        `    Then p1 it ran once\n`
-    )
-  );
-});
-
-// P2: regex captures arrive exactly as written, in order.
-sample(fc.tuple(word, fc.nat({ max: 1e6 }), word)).forEach(
-  ([first, number, last], caseIndex) => {
-    When(/^p2 take "(.*)" then (\d+) then "(.*)"$/, (a, n, b) => {
-      expect([a, n, b]).toEqual([first, String(number), last]);
-    });
-
-    Fusion(
-      writeFeature(
-        `Feature: ${title("P2", caseIndex)}\n` +
-          `  Scenario: regex captures\n` +
-          `    When p2 take "${first}" then ${number} then "${last}"\n`
-      )
-    );
-  }
-);
-
-// P3: every outline row hands its own values to the step, in table order.
-sample(
-  fc.array(fc.tuple(word, fc.nat({ max: 9999 })), {
-    minLength: 1,
-    maxLength: 5,
-  })
-).forEach((rows, caseIndex) => {
-  const seenRows = [];
-  Given(/^p3 row "(.*)" (\d+)$/, (name, number) => {
-    seenRows.push([name, number]);
-  });
-  Then("p3 the row was delivered", () => {
-    const [name, number] = rows[seenRows.length - 1];
-    expect(seenRows[seenRows.length - 1]).toEqual([name, String(number)]);
-  });
-
-  const examples = rows
-    .map(([name, number]) => `      | ${name} | ${number} |`)
-    .join("\n");
-  Fusion(
-    writeFeature(
-      `Feature: ${title("P3", caseIndex)}\n` +
-        `  Scenario Outline: outline row <name>\n` +
-        `    Given p3 row "<name>" <num>\n` +
-        `    Then p3 the row was delivered\n\n` +
-        `    Examples:\n` +
-        `      | name | num |\n` +
-        `${examples}\n`
-    )
-  );
-});
-
-// P4: a non-empty, multi-line docstring arrives byte for byte. (An EMPTY docstring
-// inside an outline is the known upstream defect L5, so it is not generated.)
-const docLine = fc
-  .stringMatching(/^[A-Za-z0-9 _\-.,'!?|#<>@:"]{0,30}$/)
-  .filter(
-    (line) =>
-      line.trim() === line &&
-      !line.startsWith('"""') &&
-      !line.startsWith("#") &&
-      !line.startsWith("@")
-  );
-sample(
-  fc
-    .array(docLine, { minLength: 1, maxLength: 5 })
-    .filter((lines) => lines.join("").length > 0)
-).forEach((lines, caseIndex) => {
-  When(/^p4 I read the doc$/, (docString) => {
-    expect(docString).toBe(lines.join("\n"));
-  });
-
-  const docBody = lines.map((line) => `      ${line}`).join("\n");
-  Fusion(
-    writeFeature(
-      `Feature: ${title("P4", caseIndex)}\n` +
-        `  Scenario: docstring\n` +
-        `    When p4 I read the doc\n` +
-        `      """\n${docBody}\n      """\n`
-    )
-  );
-});
-
-// P5: a regex matcher with escaped parentheses binds in a plain scenario AND an outline
-// (the L4 crash shape).
-sample(fc.stringMatching(/^[a-z][a-zA-Z0-9]{0,10}$/)).forEach(
-  (functionName, caseIndex) => {
-    const calls = [];
-    Given(/^p5 call (\w+\(\))$/, (call) => {
-      calls.push(call);
-    });
-    Then("p5 the call was bound", () => {
-      expect(calls[calls.length - 1]).toBe(`${functionName}()`);
-    });
-
-    Fusion(
-      writeFeature(
-        `Feature: ${title("P5", caseIndex)}\n` +
-          `  Scenario: plain\n` +
-          `    Given p5 call ${functionName}()\n` +
-          `    Then p5 the call was bound\n\n` +
-          `  Scenario Outline: outline\n` +
-          `    Given p5 call <f>\n` +
-          `    Then p5 the call was bound\n\n` +
-          `    Examples:\n` +
-          `      | f |\n` +
-          `      | ${functionName}() |\n`
-      )
-    );
-  }
-);

package/test/specs/features/step-definitions/hook-error.steps.js

@@ -1,59 +0,0 @@
-/**
- * Regression test — T1: negative/sad-path coverage, item 4 (hook error).
- * RCA: docs/feature/review-hardening/discuss/rca.md (T1, MED).
- *
- * A Before/After hook that throws must surface (fail loudly), not be swallowed. The wrapper
- * routes hooks into jest by calling the global beforeEach/afterEach with the registered hook
- * (src/index.js:122-133). This characterization pins CURRENT behaviour: a throwing Before hook
- * IS wired into jest's per-test setup (so jest will report the failure), rather than dropped.
- *
- * MECHANISM: drive the REAL wrapper (Fusion + real src/index.js); fake ONLY the external
- * jest-cucumber (capture its callback), and spy on the global beforeEach so the hook wiring is
- * captured without registering a real, throwing hook that would poison the suite.
- *
- * CURRENT STATUS: GREEN (guard/characterization) — the wrapper already wires throwing hooks
- * into beforeEach. This test exists so that regression to silent-swallow is caught.
- */
-
-const mockState = { capturedCallback: null, feature: null };
-
-jest.mock("jest-cucumber", () => ({
-  loadFeature: jest.fn(() => mockState.feature),
-  defineFeature: jest.fn((feature, callback) => {
-    mockState.capturedCallback = callback;
-  }),
-}));
-
-const { Before, Given, Fusion } = require("../../../../src");
-
-Before(() => {
-  throw new Error("hook failure — Before threw");
-});
-Given(/^some precondition$/, () => {});
-
-describe("T1.4 — hook errors surface", () => {
-  test("a throwing Before hook is wired into jest's beforeEach, not swallowed", () => {
-    mockState.feature = {
-      title: "Hook wiring",
-      scenarios: [{ title: "any scenario", steps: [] }],
-      scenarioOutlines: [],
-    };
-
-    Fusion("hook-error.feature");
-
-    const beforeEachSpy = jest
-      .spyOn(global, "beforeEach")
-      .mockImplementation(() => {});
-    try {
-      // Exercise the wrapper's suite wiring; the scenario body is irrelevant here.
-      mockState.capturedCallback(() => {});
-
-      // The wrapper must have handed the throwing hook to jest's beforeEach.
-      expect(beforeEachSpy).toHaveBeenCalledTimes(1);
-      const wiredHook = beforeEachSpy.mock.calls[0][0];
-      expect(() => wiredHook()).toThrow("hook failure — Before threw");
-    } finally {
-      beforeEachSpy.mockRestore();
-    }
-  });
-});