runner library

Supported application-facing deterministic scenario runner API.

Classes

CucumberExpression
A compiled Cucumber Expression. It deliberately keeps the feature text plain: placeholders are automation glue, not feature metadata.
EvidenceEnvelope
EvidenceRecord
The one current semantic evidence record.
EvidenceWriter
ExecutionResult
ExecutionResultWriter
FlutterDriverFactory<W extends ScenarioWorld>
Flutter projects implement this in a project-owned testWidgets entrypoint so the runner never creates a second Flutter test world.
HttpDriverFactory<W extends ScenarioWorld>
HTTP projects implement this with their logical endpoint registry and fixture lifecycle. The runner only depends on the world contract.
MapScenarioWorld
ResolvedScenarioContract
The parsed Gherkin nodes matched by a generated scenario contract.
ScenarioExampleCase
One executable instance of a Gherkin scenario.
ScenarioExecutor<W extends ScenarioWorld>
ScenarioResult
ScenarioWorld
StepDataTable
A Gherkin step data table.
StepDefinition<W extends ScenarioWorld>
StepDocString
A Gherkin step doc string.
StepMatch<W extends ScenarioWorld>
StepParameterType<T>
A typed transformation used by generated Gherkin step support.
StepParameterTypeRegistry
Registry for Cucumber-style parameter transformations.
StepRegistry<W extends ScenarioWorld>
StepResult
SuiteEvidenceEmitter
Emits deterministic passed suite evidence for non-Gherkin test bodies.
SuiteResult
Raw result produced by an ordinary test adapter. It is deliberately not an EvidenceRecord: only the CLI may bind a result to current workspace digests and publish semantic evidence.
TargetDriverFactory<W extends ScenarioWorld>
ZukeFeatureLoader
Resolves a feature from a Zuke workspace without project-specific current-working-directory fallbacks in every test entrypoint.

Enums

ScenarioStatus
StepStatus
StepTier
Resolution order is semantic, not an accidental priority convention. Project steps can refine vendor vocabulary, but cannot shadow generated feature steps; ambiguity remains an error within the selected tier.
SuiteStatus

Functions

buildStepRegistry<W extends ScenarioWorld>(Iterable<StepDefinition<W>> definitions) → StepRegistry<W>
Builds a registry from an expression-friendly iterable of definitions.
matchScenarioContracts<T extends ZukeScenarioContract>(Iterable<T> contracts, ZukeScenarioPattern pattern) → List<T>
Selects contracts in declaration order, requiring at least one match.
resolveScenarioContract(ParsedFeature feature, ZukeScenarioContract contract) → ResolvedScenarioContract
Resolves contract against feature and rejects any generated-contract drift before a scenario can emit evidence.
resolveScenarioContracts<T extends ZukeScenarioContract>(ParsedFeature feature, Iterable<T> contracts, ZukeScenarioPattern pattern) → List<ResolvedScenarioContract>
Matches and resolves generated contracts before a harness registers tests.
scenarioExampleCaseAt(GherkinScenario scenario, {required int examplesIndex, required int rowIndex}) → ScenarioExampleCase
Resolves one executable case and validates its indexes.
scenarioExampleCases(GherkinScenario scenario) → Iterable<ScenarioExampleCase>
Enumerates every executable case for scenario in source order.
scenarioFilterFromEnvironment(Map<String, String> environment) → Set<String>
Parses the runner's stable scenario-ID allow-list.
shouldRunScenario(String scenarioId, Set<String> selectedScenarioIds) → bool
Returns whether scenarioId is selected, treating an empty filter as all.

Typedefs

StepAction<W extends ScenarioWorld> = FutureOr<void> Function(W world, GherkinStep step, Map<String, String> arguments)
TransformedStepAction<W extends ScenarioWorld> = FutureOr<void> Function(W world, GherkinStep step, List<Object?> values)
Callback used by generated Cucumber Expression support. Values have already passed through their registered parameter transformers.