runtime library

Supported application-facing optional runtime events and flags 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.
ImplementsRequirement
Associates a declaration with one or more governed backend requirements.
MapScenarioWorld
PresentsRequirement
Associates a declaration with one or more requirements presented in a UI.
ProvidesControl
Declares a runtime provider for one or more governed controls.
ResolvedScenarioContract
The parsed Gherkin nodes matched by a generated scenario contract.
RuleId
A canonical governed requirement identifier.
ScenarioExampleCase
One executable instance of a Gherkin scenario.
ScenarioExecutor<W extends ScenarioWorld>
ScenarioId
A stable governed scenario identifier.
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>
VerifiesRequirement
Associates a test declaration with requirement and evidence identifiers.
ZukeBinding
Associates a UI declaration with a generated Zuke binding identifier.
ZukeBindingDescriptor
Generated binding metadata consumed by target-specific runners.
ZukeEvent
Immutable runtime event emitted by a scenario.
ZukeEventBus
In-memory event bus for one test execution.
ZukeFeatureFlags
Mutable feature-flag view used by a scenario runtime.
ZukeFeatureLoader
Resolves a feature from a Zuke workspace without project-specific current-working-directory fallbacks in every test entrypoint.
ZukeScenarioContract
A generated, stable reference to one governed Gherkin scenario.
ZukeScenarioPattern
Matches generated scenario contracts without repeating raw IDs.

Enums

BindingInstanceCardinality
Runtime multiplicity of widgets represented by one logical UI binding.
ControlProviderKind
Roles that a control provider can play in an application topology.
EnforcementLayer
Application layer at which a control is enforced.
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

Extension Types

ControlId
A canonical governed control identifier.

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.