racejar 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.0.3](https://github.com/portabletext/editor/compare/racejar-v1.0.2...racejar-v1.0.3) (2024-12-01)
+
+
+### Bug Fixes
+
+* fix type error when defining inline steps without using generics ([d371044](https://github.com/portabletext/editor/commit/d371044dae46e87188bfc52cbadd8708748bb0ce))
+
+## [1.0.2](https://github.com/portabletext/editor/compare/racejar-v1.0.1...racejar-v1.0.2) (2024-11-29)
+
+
+### Bug Fixes
+
+* allow synchronous step callbacks ([a8b1848](https://github.com/portabletext/editor/commit/a8b18489a5beaa1bd013d4753361357d53f44650))
+* make parameter types optional ([3f35c97](https://github.com/portabletext/editor/commit/3f35c97cc2fcb7790f2edcd733132cefc35ae17d))
+
 ## [1.0.1](https://github.com/portabletext/editor/compare/racejar-v1.0.0...racejar-v1.0.1) (2024-11-26)
 
 

package/README.md

@@ -106,7 +106,44 @@ import {createParameterType} from 'racejar'
 const parameterTypes = [createParameterType(/* ... */)]
 ```
 
-## Example Usage
+## Basic Example
+
+```ts
+import {Given, Then, When} from 'racejar'
+import {Feature} from 'racejar/vitest'
+import {expect} from 'vitest'
+
+function greet(name: string) {
+  return `Hello, ${name}!`
+}
+
+type Context = {
+  person: string
+  greeting: string
+}
+
+Feature({
+  featureText: `
+    Feature: Greeting
+      Scenario: Greeting a person
+        Given the person "Herman"
+        When greeting the person
+        Then the greeting is "Hello, Herman!"`,
+  stepDefinitions: [
+    Given('the person {string}', (context: Context, person: string) => {
+      context.person = person
+    }),
+    When('greeting the person', (context: Context) => {
+      context.greeting = greet(context.person)
+    }),
+    Then('the greeting is {string}', (context: Context, greeting: string) => {
+      expect(context.greeting).toBe(greeting)
+    }),
+  ],
+})
+```
+
+## Advanced Example
 
 The following example is taken from the [`editor`](/packages/editor/) package in this repository. For a full example of how to use `racejar`, head over to [/packages/editor/gherkin-tests/](/packages/editor/gherkin-tests/). The package uses `racejar` to run a [Playwright](https://playwright.dev/) E2E test suite powered by [Vitest Browser Mode](https://vitest.dev/guide/browser/).
 

package/example/hello-herman.test.ts

@@ -0,0 +1,32 @@
+import {expect} from 'vitest'
+import {Given, Then, When} from '../src/step-definitions'
+import {Feature} from '../src/vitest'
+
+function greet(name: string) {
+  return `Hello, ${name}!`
+}
+
+type Context = {
+  person: string
+  greeting: string
+}
+
+Feature({
+  featureText: `
+    Feature: Greeting
+      Scenario: Greeting a person
+        Given the person "Herman"
+        When greeting the person
+        Then the greeting is "Hello, Herman!"`,
+  stepDefinitions: [
+    Given('the person {string}', (context: Context, person: string) => {
+      context.person = person
+    }),
+    When('greeting the person', (context: Context) => {
+      context.greeting = greet(context.person)
+    }),
+    Then('the greeting is {string}', (context: Context, greeting: string) => {
+      expect(context.greeting).toBe(greeting)
+    }),
+  ],
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "racejar",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A testing framework agnostic Gherkin driver",
   "keywords": [
     "cucumber",
@@ -40,8 +40,8 @@
     "@cucumber/gherkin": "^30.0.4",
     "@cucumber/messages": "^27.0.2",
     "@jest/globals": "^29.7.0",
-    "@sanity/pkg-utils": "^6.11.12",
-    "typescript": "5.6.3",
+    "@sanity/pkg-utils": "^6.11.13",
+    "typescript": "5.7.2",
     "vitest": "^2.1.5"
   },
   "peerDependencies": {
@@ -51,6 +51,8 @@
   "scripts": {
     "check:lint": "biome lint .",
     "check:types": "tsc",
-    "lint:fix": "biome lint --write ."
+    "lint:fix": "biome lint --write .",
+    "test": "vitest --run",
+    "test:watch": "vitest"
   }
 }

package/src/compile-feature.ts

@@ -5,10 +5,7 @@ import {
 } from '@cucumber/cucumber-expressions'
 import * as Gherkin from '@cucumber/gherkin'
 import * as Messages from '@cucumber/messages'
-import type {
-  StepDefinition,
-  StepDefinitionCallbackParameters,
-} from './step-definitions'
+import type {StepDefinition} from './step-definitions'
 
 /**
  * @public
@@ -19,7 +16,7 @@ export type CompiledFeature = {
   scenarios: Array<{
     name: string
     tag?: 'only' | 'skip'
-    steps: Array<() => Promise<void>>
+    steps: Array<() => Promise<void> | void>
   }>
 }
 
@@ -33,7 +30,7 @@ export function compileFeature<TContext extends Record<string, any> = object>({
 }: {
   featureText: string
   stepDefinitions: Array<StepDefinition<TContext, any, any, any>>
-  parameterTypes: Array<ParameterType<unknown>>
+  parameterTypes?: Array<ParameterType<unknown>>
 }): CompiledFeature {
   const uuidFn = Messages.IdGenerator.uuid()
   const builder = new Gherkin.AstBuilder(uuidFn)
@@ -48,9 +45,11 @@ export function compileFeature<TContext extends Record<string, any> = object>({
   )
 
   const parameterTypeRegistry = new ParameterTypeRegistry()
-  parameterTypes.forEach((parameterType) =>
-    parameterTypeRegistry.defineParameterType(parameterType),
-  )
+  if (parameterTypes) {
+    parameterTypes.forEach((parameterType) =>
+      parameterTypeRegistry.defineParameterType(parameterType),
+    )
+  }
 
   if (!gherkinDocument.feature) {
     throw new Error('No feature found')
@@ -114,11 +113,9 @@ export function compileFeature<TContext extends Record<string, any> = object>({
         throw new Error(`Multiple implementations found for step: ${step.text}`)
       }
 
-      const args = matchingStep.args.map((arg) =>
-        arg.getValue(matchingStep),
-      ) as StepDefinitionCallbackParameters<any, any, any>
+      const args = matchingStep.args.map((arg) => arg.getValue(matchingStep))
 
-      return () => matchingStep.callback(context, ...args)
+      return () => matchingStep.callback(context, args[0], args[1], args[2])
     })
 
     return {

package/src/jest/jest-gherkin-driver.ts

@@ -13,7 +13,7 @@ export function Feature<TContext extends Record<string, any> = object>({
 }: {
   featureText: string
   stepDefinitions: Array<StepDefinition<TContext, any, any, any>>
-  parameterTypes: Array<ParameterType<unknown>>
+  parameterTypes?: Array<ParameterType<unknown>>
 }) {
   const feature = compileFeature({
     featureText,

package/src/step-definitions.ts

@@ -1,30 +1,27 @@
 /**
  * @public
  */
-export type StepDefinitionCallbackParameters<
+export type StepDefinitionCallback<
+  TContext extends Record<string, any> = object,
   TParamA = undefined,
   TParamB = undefined,
   TParamC = undefined,
 > = TParamA extends undefined
-  ? []
+  ? (context: TContext) => Promise<void> | void
   : TParamB extends undefined
-    ? [TParamA]
+    ? (context: TContext, paramA: TParamA) => Promise<void> | void
     : TParamC extends undefined
-      ? [TParamA, TParamB]
-      : [TParamA, TParamB, TParamC]
-
-/**
- * @public
- */
-export type StepDefinitionCallback<
-  TContext extends Record<string, any> = object,
-  TParamA = undefined,
-  TParamB = undefined,
-  TParamC = undefined,
-> = (
-  context: TContext,
-  ...args: StepDefinitionCallbackParameters<TParamA, TParamB, TParamC>
-) => Promise<void>
+      ? (
+          context: TContext,
+          paramA: TParamA,
+          paramB: TParamB,
+        ) => Promise<void> | void
+      : (
+          context: TContext,
+          paramA: TParamA,
+          paramB: TParamB,
+          paramC: TParamC,
+        ) => Promise<void> | void
 
 /**
  * @public

package/src/vitest/vitest-gherkin-driver.ts

@@ -13,7 +13,7 @@ export function Feature<TContext extends Record<string, any> = object>({
 }: {
   featureText: string
   stepDefinitions: Array<StepDefinition<TContext, any, any, any>>
-  parameterTypes: Array<ParameterType<unknown>>
+  parameterTypes?: Array<ParameterType<unknown>>
 }) {
   const feature = compileFeature({
     featureText,

package/vitest.workspace.ts

@@ -0,0 +1,17 @@
+/// <reference types="vitest" />
+import {defineWorkspace} from 'vitest/config'
+
+export default defineWorkspace([
+  {
+    plugins: [],
+    test: {
+      name: 'unit',
+    },
+  },
+  {
+    plugins: [],
+    test: {
+      name: 'chromium',
+    },
+  },
+])