@kraken-e2e/gherkin 0.1.0

package/dist/compiler.d.ts

@@ -0,0 +1,32 @@
+import type { ScenarioPlan } from '@kraken-e2e/core';
+import type { StepRegistry } from './registry.js';
+export interface FeatureSource {
+    readonly uri: string;
+    readonly content: string;
+}
+export interface ActorDeclaration {
+    readonly id: string;
+    readonly platform: string;
+    readonly config?: Readonly<Record<string, unknown>>;
+}
+export interface Diagnostic {
+    readonly severity: 'error' | 'warning';
+    readonly code: 'STEP_UNMATCHED' | 'STEP_AMBIGUOUS' | 'UNKNOWN_ACTOR' | 'DEADLOCK' | 'UNJOINED_TASK' | 'UNKNOWN_TASK' | 'PARSE_ERROR';
+    readonly message: string;
+    readonly uri: string;
+    readonly scenario?: string;
+}
+export interface CompileResult {
+    readonly plans: readonly ScenarioPlan[];
+    readonly diagnostics: readonly Diagnostic[];
+    get ok(): boolean;
+}
+export interface CompileOptions {
+    readonly sources: readonly FeatureSource[];
+    readonly registry: StepRegistry;
+    readonly actors: readonly ActorDeclaration[];
+    /** @cucumber/tag-expressions filter, e.g. '@smoke and not @wip'. */
+    readonly tagFilter?: string;
+}
+export declare function compileFeatures(options: CompileOptions): CompileResult;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAY,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAG/E,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EACT,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,UAAU,GACV,eAAe,GACf,cAAc,GACd,aAAa,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,IAAI,EAAE,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA8CtE"}

package/dist/compiler.js

@@ -0,0 +1,252 @@
+/**
+ * The scenario compiler + dry-run analyzer (ADR-0004 D2/D3): official Gherkin
+ * parser → pickles → screenplay ScenarioPlan chains, with EVERY static check
+ * running before any session boots. `kraken run` refuses to start on errors;
+ * --dry-run stops after this pass.
+ */
+import { AstBuilder, compile as compilePickles, GherkinClassicTokenMatcher, Parser, } from '@cucumber/gherkin';
+import { IdGenerator } from '@cucumber/messages';
+import parseTagExpression from '@cucumber/tag-expressions';
+import { levenshtein } from './levenshtein.js';
+function didYouMean(name, candidates) {
+    const closest = [...candidates]
+        .map((candidate) => ({ candidate, distance: levenshtein(name, candidate) }))
+        .sort((a, b) => a.distance - b.distance)[0];
+    return closest && closest.distance <= 2 ? ` Did you mean "${closest.candidate}"?` : '';
+}
+/** Resolves publishes metadata ('$1' → the step's 1st handler argument). */
+function resolvePublishes(match) {
+    return (match.definition.options.publishes ?? []).map((entry) => {
+        const ref = /^\$(\d+)$/.exec(entry);
+        if (!ref)
+            return entry;
+        const index = Number(ref[1]) - 1;
+        return String(match.args[index] ?? '');
+    });
+}
+export function compileFeatures(options) {
+    const diagnostics = [];
+    const plans = [];
+    const declaredActors = new Map(options.actors.map((actor) => [actor.id, actor]));
+    const tagFilter = options.tagFilter ? parseTagExpression(options.tagFilter) : undefined;
+    for (const source of options.sources) {
+        const newId = IdGenerator.incrementing();
+        let pickles;
+        try {
+            const parser = new Parser(new AstBuilder(newId), new GherkinClassicTokenMatcher());
+            const document = parser.parse(source.content);
+            pickles = compilePickles(document, source.uri, newId);
+        }
+        catch (cause) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'PARSE_ERROR',
+                message: cause instanceof Error ? cause.message : String(cause),
+                uri: source.uri,
+            });
+            continue;
+        }
+        let occurrence = 0;
+        for (const pickle of pickles) {
+            occurrence += 1;
+            if (tagFilter && !tagFilter.evaluate(pickle.tags.map((tag) => tag.name)))
+                continue;
+            const plan = compilePickle(pickle, source.uri, occurrence, options, declaredActors, diagnostics);
+            if (plan)
+                plans.push(plan);
+        }
+    }
+    return {
+        plans,
+        diagnostics,
+        get ok() {
+            return diagnostics.every((diagnostic) => diagnostic.severity !== 'error');
+        },
+    };
+}
+function compilePickle(pickle, uri, occurrence, options, declaredActors, diagnostics) {
+    const nodes = [];
+    const referencedActors = new Set();
+    /** Static choreography facts for the analyzer. */
+    const facts = [];
+    let broken = false;
+    pickle.steps.forEach((step, index) => {
+        let match;
+        try {
+            match = options.registry.match(step.text);
+        }
+        catch (error) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'STEP_AMBIGUOUS',
+                message: error instanceof Error ? error.message : String(error),
+                uri,
+                scenario: pickle.name,
+            });
+            broken = true;
+            return;
+        }
+        if (!match) {
+            const closest = [...options.registry.definitions]
+                .map((definition) => ({
+                source: definition.expressionSource,
+                distance: levenshtein(step.text, definition.expressionSource),
+            }))
+                .sort((a, b) => a.distance - b.distance)[0];
+            diagnostics.push({
+                severity: 'error',
+                code: 'STEP_UNMATCHED',
+                message: `No step definition matches "${step.text}".` +
+                    (closest ? ` Closest expression: "${closest.source}".` : '') +
+                    ` ${options.registry.definitions.length} definitions are registered.`,
+                uri,
+                scenario: pickle.name,
+            });
+            broken = true;
+            return;
+        }
+        if (!declaredActors.has(match.actorName)) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'UNKNOWN_ACTOR',
+                message: `Step "${step.text}" is addressed to undeclared actor "${match.actorName}".` +
+                    didYouMean(match.actorName, [...declaredActors.keys()]) +
+                    ` Declared actors: ${[...declaredActors.keys()].join(', ')}.`,
+                uri,
+                scenario: pickle.name,
+            });
+            broken = true;
+            return;
+        }
+        referencedActors.add(match.actorName);
+        const { definition, args, actorName } = match;
+        const previous = nodes.at(-1);
+        const base = {
+            // Run-unique (pickle ids reset per feature file): future TUI/GUI key by stepId.
+            id: `${uri}#${occurrence}-step-${index + 1}`,
+            actorId: actorName,
+            title: step.text,
+            dependsOn: previous ? [previous.id] : [],
+        };
+        if (definition.kind === 'detach') {
+            // The LAST STRING argument is the handle (documented convention) —
+            // a trailing {duration}/{int} must not shadow it.
+            const handle = [...args].reverse().find((arg) => typeof arg === 'string');
+            if (handle === undefined) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNKNOWN_TASK',
+                    message: `Detached step "${step.text}" has no string argument to use as its task handle.`,
+                    uri,
+                    scenario: pickle.name,
+                });
+                broken = true;
+                return;
+            }
+            nodes.push({
+                ...base,
+                kind: 'detach',
+                taskHandle: handle,
+                run: (ctx) => definition.handler(ctx, ...args),
+            });
+            facts.push({ kind: 'detach', publishes: resolvePublishes(match), detachHandle: handle });
+        }
+        else if (definition.kind === 'join') {
+            const handle = String(args[0] ?? '');
+            const timeoutMs = Number(args[1] ?? 30_000);
+            nodes.push({
+                ...base,
+                kind: 'join',
+                taskHandle: handle,
+                joinTimeoutMs: timeoutMs,
+                run: async () => { },
+            });
+            facts.push({ kind: 'join', publishes: [], joinHandle: handle });
+        }
+        else {
+            nodes.push({
+                ...base,
+                kind: 'step',
+                run: (ctx) => definition.handler(ctx, ...args),
+            });
+            facts.push({
+                kind: definition.kind,
+                publishes: resolvePublishes(match),
+                ...(definition.kind === 'wait-signal' ? { waitsFor: String(args[0] ?? '') } : {}),
+            });
+        }
+    });
+    if (broken)
+        return undefined;
+    // ── Static analysis (the dry-run analyzer — ADR-0004 D3) ──
+    const detached = new Set();
+    for (const [index, fact] of facts.entries()) {
+        if (fact.detachHandle) {
+            if (detached.has(fact.detachHandle)) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNKNOWN_TASK',
+                    message: `"${nodes[index]?.title}" reuses background-task handle "${fact.detachHandle}" — handles must be unique within a scenario.`,
+                    uri,
+                    scenario: pickle.name,
+                });
+            }
+            detached.add(fact.detachHandle);
+        }
+        if (fact.joinHandle && !detached.has(fact.joinHandle)) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'UNKNOWN_TASK',
+                message: `"${nodes[index]?.title}" joins background task "${fact.joinHandle}" but no earlier step started it.`,
+                uri,
+                scenario: pickle.name,
+            });
+        }
+        if (fact.waitsFor !== undefined) {
+            // Under total order, a main-cursor wait with no earlier declared producer
+            // is a GUARANTEED deadlock — rejected statically (ADR-0001 §5.9).
+            const producers = facts
+                .slice(0, index)
+                .some((earlier) => earlier.publishes.includes(fact.waitsFor));
+            if (!producers) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'DEADLOCK',
+                    message: `"${nodes[index]?.title}" waits for signal "${fact.waitsFor}", but no earlier step ` +
+                        `or background task declares publishing it (via the publishes: option). Under ` +
+                        `screenplay order this wait can never be satisfied.`,
+                    uri,
+                    scenario: pickle.name,
+                });
+            }
+        }
+    }
+    const joined = new Set(facts.flatMap((fact) => (fact.joinHandle ? [fact.joinHandle] : [])));
+    for (const handle of detached) {
+        if (!joined.has(handle)) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'UNJOINED_TASK',
+                message: `Background task "${handle}" is started but never joined. Every detached task must be ` +
+                    `joined before the scenario ends (leak detection — ADR-0001 §5.9).`,
+                uri,
+                scenario: pickle.name,
+            });
+        }
+    }
+    const hasErrors = diagnostics.some((diagnostic) => diagnostic.severity === 'error' && diagnostic.scenario === pickle.name);
+    if (hasErrors)
+        return undefined;
+    const actors = [...referencedActors].map((id) => {
+        const declaration = declaredActors.get(id);
+        return { id, platform: declaration.platform, config: declaration.config ?? {} };
+    });
+    return {
+        scenarioId: `${uri}#${occurrence}`,
+        name: pickle.name,
+        featureUri: uri,
+        actors,
+        nodes,
+    };
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @kraken-e2e/gherkin — the BDD front-end (ADR-0001 §5.8/§5.9, ADR-0004).
+ *
+ * Parses features with the OFFICIAL Gherkin stack (@cucumber/gherkin 41 →
+ * pickles), matches steps with @cucumber/cucumber-expressions, and compiles
+ * screenplay-ordered ScenarioPlans executed by @kraken-e2e/core. The cucumber-js
+ * RUNNER is deliberately not used: its one-World/sequential model cannot
+ * express Kraken's per-actor execution (ADR-0001 D3 — read §5.8 before
+ * attempting to "just use cucumber-js").
+ */
+export { type ActorDeclaration, type CompileOptions, type CompileResult, compileFeatures, type Diagnostic, type FeatureSource, } from './compiler.js';
+export { ACTOR_REGEXP, createParameterTypeRegistry, DURATION_REGEXP, parseDuration, } from './parameter-types.js';
+export { createStepRegistry, isStepRegistry, type KrakenStepApi, registerBuiltInSteps, type StepDefinition, type StepKind, type StepMatch, type StepOptions, StepRegistry, } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,aAAa,EAClB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @kraken-e2e/gherkin — the BDD front-end (ADR-0001 §5.8/§5.9, ADR-0004).
+ *
+ * Parses features with the OFFICIAL Gherkin stack (@cucumber/gherkin 41 →
+ * pickles), matches steps with @cucumber/cucumber-expressions, and compiles
+ * screenplay-ordered ScenarioPlans executed by @kraken-e2e/core. The cucumber-js
+ * RUNNER is deliberately not used: its one-World/sequential model cannot
+ * express Kraken's per-actor execution (ADR-0001 D3 — read §5.8 before
+ * attempting to "just use cucumber-js").
+ */
+export { compileFeatures, } from './compiler.js';
+export { ACTOR_REGEXP, createParameterTypeRegistry, DURATION_REGEXP, parseDuration, } from './parameter-types.js';
+export { createStepRegistry, isStepRegistry, registerBuiltInSteps, StepRegistry, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,eAAe,GAGhB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,cAAc,EAEd,oBAAoB,EAKpB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/levenshtein.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Local copy (also in @kraken-e2e/signaling): gherkin depends only on
+ * contracts+core (ADR-0001 §5.3), and 20 lines don't justify a new edge.
+ */
+export declare function levenshtein(a: string, b: string): number;
+//# sourceMappingURL=levenshtein.d.ts.map

package/dist/levenshtein.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.d.ts","sourceRoot":"","sources":["../src/levenshtein.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBxD"}

package/dist/levenshtein.js

@@ -0,0 +1,23 @@
+/**
+ * Local copy (also in @kraken-e2e/signaling): gherkin depends only on
+ * contracts+core (ADR-0001 §5.3), and 20 lines don't justify a new edge.
+ */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const distance = Array.from({ length: rows * cols }, () => 0);
+    for (let i = 0; i < rows; i += 1)
+        distance[i * cols] = i;
+    for (let j = 0; j < cols; j += 1)
+        distance[j] = j;
+    for (let i = 1; i < rows; i += 1) {
+        for (let j = 1; j < cols; j += 1) {
+            const substitutionCost = a[i - 1] === b[j - 1] ? 0 : 1;
+            distance[i * cols + j] = Math.min((distance[(i - 1) * cols + j] ?? 0) + 1, (distance[i * cols + (j - 1)] ?? 0) + 1, (distance[(i - 1) * cols + (j - 1)] ?? 0) + substitutionCost);
+        }
+    }
+    return distance[rows * cols - 1] ?? 0;
+}
+//# sourceMappingURL=levenshtein.js.map

package/dist/levenshtein.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"levenshtein.js","sourceRoot":"","sources":["../src/levenshtein.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,MAAM,QAAQ,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,gBAAgB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAC/B,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACvC,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACvC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,gBAAgB,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/parameter-types.d.ts

@@ -0,0 +1,18 @@
+import { ParameterTypeRegistry } from '@cucumber/cucumber-expressions';
+/** Parses '10s' / '500ms' / '2m' into milliseconds ({duration} — ADR-0004 D1). */
+export declare function parseDuration(text: string): number;
+/**
+ * The registry with Kraken's built-in parameter types:
+ * - {actor}: a bare name (alice) or a quoted alias ("the moderator"); validated
+ *   against the closed actor set at COMPILE time (did-you-mean), not here.
+ * - {duration}: '10s' / '500ms' / '2m' → milliseconds.
+ *
+ * NOTE for editor autocomplete (LSP spike, ADR-0004 appendix B): the VS Code
+ * Cucumber extension cannot see these (they live in node_modules), so
+ * `kraken init` scaffolds cucumber.parameterTypes in .vscode/settings.json
+ * with regexps kept byte-identical to the ones below.
+ */
+export declare const ACTOR_REGEXP: RegExp;
+export declare const DURATION_REGEXP: RegExp;
+export declare function createParameterTypeRegistry(): ParameterTypeRegistry;
+//# sourceMappingURL=parameter-types.d.ts.map

package/dist/parameter-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-types.d.ts","sourceRoot":"","sources":["../src/parameter-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEtF,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,QAAmC,CAAC;AAC7D,eAAO,MAAM,eAAe,QAA4B,CAAC;AAEzD,wBAAgB,2BAA2B,IAAI,qBAAqB,CAgBnE"}

package/dist/parameter-types.js

@@ -0,0 +1,35 @@
+import { ParameterType, ParameterTypeRegistry } from '@cucumber/cucumber-expressions';
+/** Parses '10s' / '500ms' / '2m' into milliseconds ({duration} — ADR-0004 D1). */
+export function parseDuration(text) {
+    const match = /^(\d+(?:\.\d+)?)(ms|s|m)$/.exec(text);
+    if (!match) {
+        throw new Error(`Invalid duration "${text}" — use e.g. "500ms", "10s", "2m".`);
+    }
+    const value = Number(match[1]);
+    const unit = match[2];
+    const ms = unit === 'ms' ? value : unit === 's' ? value * 1_000 : value * 60_000;
+    if (ms <= 0) {
+        throw new Error(`Duration "${text}" must be positive.`);
+    }
+    return ms;
+}
+/**
+ * The registry with Kraken's built-in parameter types:
+ * - {actor}: a bare name (alice) or a quoted alias ("the moderator"); validated
+ *   against the closed actor set at COMPILE time (did-you-mean), not here.
+ * - {duration}: '10s' / '500ms' / '2m' → milliseconds.
+ *
+ * NOTE for editor autocomplete (LSP spike, ADR-0004 appendix B): the VS Code
+ * Cucumber extension cannot see these (they live in node_modules), so
+ * `kraken init` scaffolds cucumber.parameterTypes in .vscode/settings.json
+ * with regexps kept byte-identical to the ones below.
+ */
+export const ACTOR_REGEXP = /[a-zA-Z][a-zA-Z0-9_-]*|"[^"]+"/;
+export const DURATION_REGEXP = /\d+(?:\.\d+)?(?:ms|s|m)/;
+export function createParameterTypeRegistry() {
+    const registry = new ParameterTypeRegistry();
+    registry.defineParameterType(new ParameterType('actor', ACTOR_REGEXP, String, (value) => value.replace(/^"|"$/g, ''), false, false));
+    registry.defineParameterType(new ParameterType('duration', DURATION_REGEXP, Number, parseDuration, false, false));
+    return registry;
+}
+//# sourceMappingURL=parameter-types.js.map

package/dist/parameter-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-types.js","sourceRoot":"","sources":["../src/parameter-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEtF,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,oCAAoC,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC;IACjF,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,qBAAqB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAEzD,MAAM,UAAU,2BAA2B;IACzC,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,CAC1B,IAAI,aAAa,CACf,OAAO,EACP,YAAY,EACZ,MAAM,EACN,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAC9C,KAAK,EACL,KAAK,CACN,CACF,CAAC;IACF,QAAQ,CAAC,mBAAmB,CAC1B,IAAI,aAAa,CAAS,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,CAC5F,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,84 @@
+import { CucumberExpression } from '@cucumber/cucumber-expressions';
+import type { StepRunContext } from '@kraken-e2e/core';
+/** How a matched definition behaves in the compiled plan (ADR-0004 D2/D4). */
+export type StepKind = 'step' | 'detach' | 'join' | 'wait-signal';
+export interface StepOptions {
+    /**
+     * Signal names this step's handler publishes — the dry-run analyzer's
+     * reachability facts (ADR-0004 D3). '$N' references the Nth handler
+     * argument (1-based, actor excluded), e.g. publishes: ['$1'].
+     */
+    readonly publishes?: readonly string[];
+    /**
+     * The step starts a background task: its handler runs detached and MUST be
+     * joined before the scenario ends. The LAST string argument is the task
+     * handle (documented convention — ADR-0004 D4).
+     */
+    readonly detached?: boolean;
+    /** Documentation marker: this Then-step is a polling assertion. */
+    readonly polls?: boolean;
+}
+export interface StepDefinition {
+    readonly expressionSource: string;
+    readonly expression: CucumberExpression;
+    readonly options: StepOptions;
+    readonly kind: StepKind;
+    readonly handler: (ctx: StepRunContext, ...args: never[]) => Promise<void>;
+    /** Ordinal of the FIRST {actor} parameter among all parameters (the addressee). */
+    readonly actorParameterIndex: number;
+}
+export interface StepMatch {
+    readonly definition: StepDefinition;
+    /** The addressed actor's name, unquoted. */
+    readonly actorName: string;
+    /** Handler arguments (actor excluded), transformed by their parameter types. */
+    readonly args: readonly unknown[];
+}
+type StepFn = (expression: string, optionsOrHandler: StepOptions | ((ctx: StepRunContext, ...args: never[]) => Promise<void>), maybeHandler?: (ctx: StepRunContext, ...args: never[]) => Promise<void>) => void;
+export interface KrakenStepApi {
+    readonly Given: StepFn;
+    readonly When: StepFn;
+    readonly Then: StepFn;
+    readonly defineParameterType: (options: {
+        name: string;
+        regexp: RegExp;
+        transformer?: (...groups: string[]) => unknown;
+    }) => void;
+    readonly registry: StepRegistry;
+}
+/** Survives duplicate copies of this package in one process (jiti + node_modules). */
+export declare const STEP_REGISTRY_BRAND: unique symbol;
+export declare function isStepRegistry(value: unknown): value is StepRegistry;
+export declare class StepRegistry {
+    #private;
+    readonly [STEP_REGISTRY_BRAND]: true;
+    constructor();
+    define(expressionSource: string, options: StepOptions, handler: (ctx: StepRunContext, ...args: never[]) => Promise<void>, kind?: StepKind): void;
+    defineParameterType(options: {
+        name: string;
+        regexp: RegExp;
+        transformer?: (...groups: string[]) => unknown;
+    }): void;
+    get definitions(): readonly StepDefinition[];
+    /**
+     * Matches a pickle step's text. Zero matches → undefined (the compiler turns
+     * it into a STEP_UNMATCHED diagnostic); more than one → STEP_AMBIGUOUS error.
+     */
+    match(text: string): StepMatch | undefined;
+}
+/**
+ * The step-authoring API (ADR-0004 D1). Instance-based — no import-order
+ * magic; destructure so call sites are bare identifiers, which is exactly what
+ * the Cucumber VS Code extension's tree-sitter queries recognize (appendix B):
+ *
+ *   export const { Given, When, Then } = createStepRegistry();
+ */
+export declare function createStepRegistry(): KrakenStepApi;
+/**
+ * Built-in choreography vocabulary (ADR-0004 D4) — deliberately minimal:
+ * signal waiting (v2 continuity) and background-task joining. App-domain
+ * steps belong to the USER's project, never here.
+ */
+export declare function registerBuiltInSteps(registry: StepRegistry): void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}