@systemfsoftware/storybook-gherkin 3.0.6 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @systemfsoftware/storybook-gherkin
 
+## 4.0.0
+
+### Major Changes
+
+- `feature` now requires its options argument, and it can be called data-last as `feature(options)(meta)`. `capture`, and the step helpers that took their subject first, gain the same data-last form. Write `feature(meta)` as `feature(meta, {})`.
+
+## 3.0.7
+
+### Patch Changes
+
+- Unconstrained type holes are defaulted type parameters (`<A = unknown>`) instead of a type argument `unknown`. Calls that omit those arguments are unchanged.
+
 ## 3.0.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -9,6 +9,12 @@ import { YieldableError } from 'effect/Cause';
 
 export declare const And: StepCtor;
 
+declare type AnyConstraintDecoder$1<A = unknown> = Schema.ConstraintDecoder<A>;
+
+declare type AnyConstraintDecoder<A = unknown> = Schema.ConstraintDecoder<A>;
+
+declare type AnyValue<V = unknown> = V;
+
 export declare class BackgroundNotGiven extends BackgroundNotGiven_base {}
 
 declare const BackgroundNotGiven_base: Schema.Class<BackgroundNotGiven, Schema.TaggedStruct<"BackgroundNotGiven", {
@@ -24,18 +30,26 @@ export declare type CapsOf<THoles extends readonly Hole[]> = THoles extends read
 
 export declare interface Capture<Name extends string = string, _A = unknown> extends CaptureTag {
     readonly name: Name;
-    readonly schema: Schema.ConstraintDecoder<unknown> | undefined;
+    readonly schema: AnyConstraintDecoder$1 | undefined;
     readonly default: string | undefined;
 }
 
-export declare function capture<Name extends string, A>(name: Name, options: {
-    readonly schema: Schema.Codec<A, string>;
-    readonly default?: string;
-}): Capture<Name, A>;
-
-export declare function capture<Name extends string>(name: Name, options?: {
-    readonly default?: string;
-}): Capture<Name, string>;
+export declare const capture: {
+    <Name extends string, A>(options: {
+        readonly schema: Schema.Codec<A, string>;
+        readonly default?: string;
+    }): (name: Name) => Capture<Name, A>;
+    <Name extends string>(options?: {
+        readonly default?: string;
+    }): (name: Name) => Capture<Name, string>;
+    <Name extends string, A>(name: Name, options: {
+        readonly schema: Schema.Codec<A, string>;
+        readonly default?: string;
+    }): Capture<Name, A>;
+    <Name extends string>(name: Name, options?: {
+        readonly default?: string;
+    }): Capture<Name, string>;
+};
 
 export declare class CaptureDecodeFailed extends CaptureDecodeFailed_base {}
 
@@ -49,7 +63,7 @@ declare const CaptureDecodeFailed_base: Schema.Class<CaptureDecodeFailed, Schema
 export declare interface CaptureModel {
     readonly name: string;
     /** Service-free decode view — the v4 counterpart of the removed no-context alias. */
-    readonly schema: Schema.ConstraintDecoder<unknown> | undefined;
+    readonly schema: AnyConstraintDecoder | undefined;
     readonly default: string | undefined;
 }
 
@@ -101,7 +115,10 @@ export declare interface Feature<M, TArgs = unknown> {
  * context interpreting each scenario's composed step program exactly once,
  * at the play edge.
  */
-export declare const feature: <M>(meta: M, options?: FeatureOptions) => Feature<M>;
+export declare const feature: {
+    <M>(options: FeatureOptions): (meta: M) => Feature<M>;
+    <M>(meta: M, options: FeatureOptions): Feature<M>;
+};
 
 export declare interface FeatureOptions {
     /**
@@ -173,17 +190,17 @@ export declare interface PlayContext<TArgs = unknown> {
     readonly step: StepFn;
     readonly userEvent: UserEventObject;
     readonly args: TArgs;
-    readonly globals: Record<string, unknown>;
-    readonly parameters: Record<string, unknown>;
-    readonly loaded: Record<string, unknown>;
+    readonly globals: Record<string, AnyValue>;
+    readonly parameters: Record<string, AnyValue>;
+    readonly loaded: Record<string, AnyValue>;
     readonly abortSignal: AbortSignal;
     readonly reporting: ReportingAPI;
 }
 
-declare interface Report_2 {
+declare interface Report_2<Result = unknown> {
     readonly type: string;
     readonly version?: number;
-    readonly result: unknown;
+    readonly result: Result;
     readonly status: 'failed' | 'passed' | 'warning';
 }
 export { Report_2 as Report }
@@ -247,9 +264,9 @@ export declare interface StepContext<TArgs = unknown> {
     readonly userEvent: UserEventObject;
     readonly step: StepFn;
     readonly args: TArgs;
-    readonly globals: Record<string, unknown>;
-    readonly parameters: Record<string, unknown>;
-    readonly loaded: Record<string, unknown>;
+    readonly globals: Record<string, AnyValue>;
+    readonly parameters: Record<string, AnyValue>;
+    readonly loaded: Record<string, AnyValue>;
     readonly canvasElement: HTMLElement;
     /**
      * Fires on story teardown (remount, navigation, HMR). Since the 2026-08-09

package/dist/index.mjs

@@ -1,8 +1,9 @@
+import { dual } from "effect/Function";
 import { Array as Array$1, Cause, Context, Deferred, Effect, Exit, Fiber, Match, Schema } from "effect";
 import { screen } from "storybook/test";
 //#region src/Capture.ts
 const CaptureTag = { _tag: "Capture" };
-function capture(name, options) {
+function captureImpl(name, options) {
 	const resolved = options ?? {};
 	return {
 		...CaptureTag,
@@ -11,6 +12,7 @@ function capture(name, options) {
 		default: resolved.default
 	};
 }
+const capture = dual((args) => typeof args[0] === "string", captureImpl);
 //#endregion
 //#region src/Errors.schema.ts
 const ConcreteKeywordSchema = Schema.Literals([
@@ -83,7 +85,8 @@ const holeText = (cap, values) => {
 	if (fromValues !== void 0) return fromValues;
 	return firstString(cap.default, `{${cap.name}}`);
 };
-const renderStepText = (step, values) => joinStep(step, (cap) => holeText(cap, values));
+const renderStepTextImpl = (step, values) => joinStep(step, (cap) => holeText(cap, values));
+const renderStepText = dual(2, renderStepTextImpl);
 const resolveKeyword = (keyword, previous) => Match.value(keyword).pipe(Match.when("Given", () => "Given"), Match.when("When", () => "When"), Match.when("Then", () => "Then"), Match.when("And", () => previous), Match.when("But", () => previous), Match.when("Star", () => previous), Match.exhaustive);
 const resolveKeywords = (steps) => {
 	return Array$1.mapAccum(steps, "Given", (previous, s) => {
@@ -466,13 +469,14 @@ const contextOf = (options) => {
 	if (options.context === void 0) return Context.empty();
 	return options.context;
 };
+const featureImpl = (meta, options) => makeFeature(meta, contextOf(options));
 /**
 * Declare a feature: a story set whose scenarios execute as CSF `play`
 * functions. `options.context` (default `Context.empty()`) is the Effect
 * context interpreting each scenario's composed step program exactly once,
 * at the play edge.
 */
-const feature = (meta, options = {}) => makeFeature(meta, contextOf(options));
+const feature = dual(2, featureImpl);
 const Steps = (...steps) => [...steps];
 const From = (story) => {
 	const play = story.play;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@systemfsoftware/storybook-gherkin",
   "license": "Apache-2.0",
-  "version": "3.0.6",
+  "version": "4.0.0",
   "author": "Ryan Lee <drdgvhbh@gmail.com>",
   "repository": {
     "type": "git",
@@ -47,6 +47,9 @@
     "@storybook/addon-vitest": "^10.6.0",
     "@storybook/react-vite": "^10.6.0",
     "@systemfsoftware/arethetypeswrong-cli": "^4.2.0",
+    "@systemfsoftware/oxlint-config-recommended": "^2.0.0",
+    "@systemfsoftware/tsconfig": "^2.0.0",
+    "@systemfsoftware/tsdown-config": "^0.1.0",
     "@types/node": "^26",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
@@ -62,11 +65,7 @@
     "tsdown": "^0.23.0",
     "typescript": "^7",
     "vite": "^8",
-    "vitest": "^5",
-    "@systemfsoftware/all": "^2.1.2",
-    "@systemfsoftware/oxlint-config": "^0.1.0",
-    "@systemfsoftware/tsdown-config": "^0.1.0",
-    "@systemfsoftware/tsconfig": "^1.3.6"
+    "vitest": "^5"
   },
   "publishConfig": {
     "provenance": true
@@ -74,9 +73,9 @@
   "scripts": {
     "clean": "rimraf dist",
     "build": "tsdown -l warn && pnpm dts:check && pnpm api:check",
-    "typecheck": "tsc --noEmit --incremental",
+    "typecheck": "tsc -b",
     "lint": "f=${OXLINT_FORMAT:-${AGENT:+agent}}; oxlint . --config oxlint.config.ts --format=${f:-default}",
-    "lint:tsgo": "effect-tsgo diagnostics --project tsconfig.json --format ${TSGO_FORMAT:-text}",
+    "lint:tsgo": "effect-tsgo diagnostics --project tsconfig.app.json --format ${TSGO_FORMAT:-text} && effect-tsgo diagnostics --project tsconfig.test.json --format ${TSGO_FORMAT:-text}",
     "attw": "attw --pack .",
     "dts:check": "node scripts/check-dts.mjs",
     "storybook": "storybook dev -p 6006 --no-open",