@haibun/core 3.9.0 → 4.0.0-alpha.1

package/build/lib/step-dispatch.d.ts

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { AStepper } from './astepper.js';
+import type { TWorld, TStepperStep } from './defs.js';
+import { type StepDescriptor } from './stepper-registry.js';
+/** Clean result type for transport consumers (SSE, MCP). Hides haibun internals. */
+export type StepHandlerResult = {
+    ok: true;
+    products: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * A registered step tool — the unit of dispatch for any transport (MCP, SSE, etc.).
+ */
+export type StepTool = {
+    name: string;
+    description: string;
+    inputSchema: StepToolInputSchema;
+    /** Zod schemas for each input parameter, keyed by parameter name. Used for runtime validation. */
+    paramSchemas: Map<string, z.ZodType>;
+    /** JSON Schema describing the products this step returns. Built from outputSchema on step definition. */
+    outputSchema?: Record<string, unknown>;
+    stepperName: string;
+    stepName: string;
+    handler: (input: Record<string, unknown>) => Promise<StepHandlerResult>;
+};
+export type StepToolInputSchema = {
+    type: 'object';
+    properties?: Record<string, {
+        type?: string;
+        description?: string;
+        [key: string]: unknown;
+    }>;
+    required?: string[];
+    [key: string]: unknown;
+};
+/**
+ * Build a registry of step tools from the given steppers.
+ * Each key is `${stepperName}-${stepName}` (e.g. `MuskegStepper-getTypes`).
+ * Steps with `expose: false` are excluded.
+ *
+ * Used by MCP, SSE, and any future transport.
+ */
+export declare function buildStepRegistry(steppers: AStepper[], world: TWorld): Map<string, StepTool>;
+/**
+ * Validate input against a step tool's Zod schemas.
+ * Returns validated (parsed) input on success, throws with descriptive errors on failure.
+ */
+export declare function validateToolInput(tool: StepTool, input: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Generate the canonical RPC method name for a step.
+ * Used by both server (registry keys) and client (typed imports).
+ *
+ * Accepts either a stepper class/instance or a stepper name string.
+ */
+export declare function stepMethodName(stepperOrName: string | AStepper | {
+    name: string;
+}, stepName: string): string;
+/**
+ * Create a handler that calls the step action directly with validated input.
+ * RPC transports validate input via validateToolInput() then call this handler.
+ * The action receives typed values directly — no string round-tripping through
+ * mapInputToStepValues/resolveVariable. A minimal featureStep is provided for provenance.
+ */
+export declare function createStepHandler(stepperName: string, stepName: string, stepDef: TStepperStep): (input: Record<string, unknown>) => Promise<StepHandlerResult>;
+/** Incoming JSON-RPC 2.0 request from client (POST /rpc/:method). */
+export declare const RpcRequestSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodString;
+    method: z.ZodString;
+    params: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TRpcRequest = z.infer<typeof RpcRequestSchema>;
+/** Outgoing JSON-RPC 2.0 response to client. */
+export declare const RpcResponseSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TRpcResponse = z.infer<typeof RpcResponseSchema>;
+/** Outgoing JSON-RPC 2.0 stream chunk to client. */
+export declare const RpcStreamSchema: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodString;
+    stream: z.ZodLiteral<true>;
+    data: z.ZodUnknown;
+}, z.core.$strip>;
+export type TRpcStream = z.infer<typeof RpcStreamSchema>;
+/**
+ * Parse and validate an incoming RPC request.
+ * Returns the parsed request or null if the message is not an RPC request.
+ */
+export declare function parseRpcRequest(raw: unknown): TRpcRequest | null;
+export type StepDiscovery = {
+    registry: Map<string, StepTool>;
+    metadata: StepDescriptor[];
+};
+/**
+ * Build a step registry and enrich metadata with input/output schemas.
+ * Single entry point for both SSE and MCP transports.
+ */
+export declare function discoverSteps(steppers: AStepper[], world: TWorld): StepDiscovery;
+//# sourceMappingURL=step-dispatch.d.ts.map

package/build/lib/step-dispatch.d.ts.map

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

package/build/lib/step-dispatch.js

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+import { namedInterpolation, mapInputToStepValues } from './namedVars.js';
+import { constructorName } from './util/index.js';
+import { DOMAIN_STRING, normalizeDomainKey } from './domain-types.js';
+import { StepperRegistry } from './stepper-registry.js';
+/**
+ * Build a registry of step tools from the given steppers.
+ * Each key is `${stepperName}-${stepName}` (e.g. `MuskegStepper-getTypes`).
+ * Steps with `expose: false` are excluded.
+ *
+ * Used by MCP, SSE, and any future transport.
+ */
+export function buildStepRegistry(steppers, world) {
+    const registry = new Map();
+    for (const stepper of steppers) {
+        const stepperName = constructorName(stepper);
+        for (const [stepName, stepDef] of Object.entries(stepper.steps)) {
+            if (stepDef.expose === false)
+                continue;
+            const { inputSchema, paramSchemas } = buildInputSchema(stepDef, world);
+            const name = stepMethodName(stepperName, stepName);
+            let outputSchema;
+            if (stepDef.outputSchema) {
+                try {
+                    outputSchema = z.toJSONSchema(stepDef.outputSchema);
+                }
+                catch { /* skip if schema can't be converted */ }
+            }
+            registry.set(name, {
+                name,
+                description: stepDef.gwta || stepName,
+                inputSchema,
+                paramSchemas,
+                outputSchema,
+                stepperName,
+                stepName,
+                handler: createStepHandler(stepperName, stepName, stepDef),
+            });
+        }
+    }
+    return registry;
+}
+/**
+ * Validate input against a step tool's Zod schemas.
+ * Returns validated (parsed) input on success, throws with descriptive errors on failure.
+ */
+export function validateToolInput(tool, input) {
+    const validated = { ...input };
+    const errors = [];
+    const required = tool.inputSchema.required || [];
+    for (const key of required) {
+        if (!(key in input) || input[key] === undefined) {
+            errors.push(`"${key}": required`);
+        }
+    }
+    for (const [key, value] of Object.entries(input)) {
+        const schema = tool.paramSchemas.get(key);
+        if (schema) {
+            const result = schema.safeParse(value);
+            if (result.success) {
+                validated[key] = result.data;
+            }
+            else {
+                const issues = result.error.issues.map(i => i.path.length ? `${i.path.join('.')}: ${i.message}` : i.message).join('; ');
+                errors.push(`"${key}": ${issues}`);
+            }
+        }
+    }
+    if (errors.length) {
+        throw new Error(`${tool.name} validation failed: ${errors.join(', ')}`);
+    }
+    return validated;
+}
+/**
+ * Generate the canonical RPC method name for a step.
+ * Used by both server (registry keys) and client (typed imports).
+ *
+ * Accepts either a stepper class/instance or a stepper name string.
+ */
+export function stepMethodName(stepperOrName, stepName) {
+    const name = typeof stepperOrName === 'string'
+        ? stepperOrName
+        : ('steps' in stepperOrName ? constructorName(stepperOrName) : stepperOrName.name);
+    return `${name}-${stepName}`;
+}
+/**
+ * Create a handler that calls the step action directly with validated input.
+ * RPC transports validate input via validateToolInput() then call this handler.
+ * The action receives typed values directly — no string round-tripping through
+ * mapInputToStepValues/resolveVariable. A minimal featureStep is provided for provenance.
+ */
+export function createStepHandler(stepperName, stepName, stepDef) {
+    return async (input) => {
+        const featureStep = {
+            in: stepDef.gwta || '',
+            action: {
+                stepperName,
+                actionName: stepName,
+                step: stepDef,
+                stepValuesMap: mapInputToStepValues(input, stepDef.gwta || ''),
+            },
+            seqPath: [0],
+            source: { path: 'step-dispatch' },
+        };
+        try {
+            const actionResult = await stepDef.action(input, featureStep);
+            if (actionResult.ok) {
+                const products = 'products' in actionResult ? actionResult.products : {};
+                return { ok: true, products: products || {} };
+            }
+            return { ok: false, error: actionResult.message || 'Step failed' };
+        }
+        catch (caught) {
+            const err = caught instanceof Error ? caught : new Error(String(caught));
+            return { ok: false, error: `${stepperName}-${stepName}: ${err.message}` };
+        }
+    };
+}
+/**
+ * Build a JSON Schema and Zod param schemas for a step's input parameters.
+ * Uses z.toJSONSchema() to convert Zod domain schemas into full JSON Schema
+ * (enums, object structures, descriptions, etc.) for MCP and SSE consumers.
+ * Returns both the JSON Schema (for documentation/discovery) and the Zod schemas (for runtime validation).
+ */
+function buildInputSchema(stepDef, world) {
+    const properties = {};
+    const required = [];
+    const paramSchemas = new Map();
+    if (stepDef.gwta) {
+        const { stepValuesMap } = namedInterpolation(stepDef.gwta);
+        if (stepValuesMap) {
+            for (const v of Object.values(stepValuesMap)) {
+                const rawDomain = v.domain || DOMAIN_STRING;
+                const parts = rawDomain.split(' | ').sort();
+                const domainKey = normalizeDomainKey(parts.join(' | '));
+                const domain = world.domains?.[domainKey];
+                if (domain?.schema) {
+                    paramSchemas.set(v.term, domain.schema);
+                    try {
+                        const jsonSchema = z.toJSONSchema(domain.schema);
+                        const prop = { ...jsonSchema };
+                        if (domain.description && !prop.description) {
+                            prop.description = domain.description;
+                        }
+                        properties[v.term] = prop;
+                    }
+                    catch {
+                        properties[v.term] = { type: 'string', description: domain.description };
+                    }
+                }
+                else {
+                    properties[v.term] = { type: 'string' };
+                }
+                required.push(v.term);
+            }
+        }
+    }
+    return { inputSchema: { type: 'object', properties, required }, paramSchemas };
+}
+// --- RPC Message Schemas ---
+/** Incoming JSON-RPC 2.0 request from client (POST /rpc/:method). */
+export const RpcRequestSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.string(),
+    method: z.string(),
+    params: z.record(z.string(), z.unknown()).optional().default({}),
+    stream: z.boolean().optional(),
+});
+/** Outgoing JSON-RPC 2.0 response to client. */
+export const RpcResponseSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.string(),
+    result: z.unknown().optional(),
+    error: z.string().optional(),
+});
+/** Outgoing JSON-RPC 2.0 stream chunk to client. */
+export const RpcStreamSchema = z.object({
+    jsonrpc: z.literal('2.0'),
+    id: z.string(),
+    stream: z.literal(true),
+    data: z.unknown(),
+});
+/**
+ * Parse and validate an incoming RPC request.
+ * Returns the parsed request or null if the message is not an RPC request.
+ */
+export function parseRpcRequest(raw) {
+    const result = RpcRequestSchema.safeParse(raw);
+    return result.success ? result.data : null;
+}
+/**
+ * Build a step registry and enrich metadata with input/output schemas.
+ * Single entry point for both SSE and MCP transports.
+ */
+export function discoverSteps(steppers, world) {
+    const registry = buildStepRegistry(steppers, world);
+    const metadata = StepperRegistry.getMetadata(steppers);
+    for (const meta of metadata) {
+        const tool = registry.get(meta.method);
+        if (tool) {
+            meta.inputSchema = tool.inputSchema;
+            meta.outputSchema = tool.outputSchema;
+        }
+    }
+    return { registry, metadata };
+}
+//# sourceMappingURL=step-dispatch.js.map

package/build/lib/step-dispatch.js.map

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

package/build/lib/step-helpers.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { TActionResult, TStepArgs } from '../schema/protocol.js';
+import type { TFeatureStep } from './defs.js';
+/**
+ * Wrap a step action with a products schema.
+ * The fn returns raw products data; withProducts wraps it in actionOK.
+ * The schema is attached to the returned action for buildStepRegistry to read.
+ */
+export declare function withProducts<T extends z.ZodType<Record<string, unknown>>>(schema: T, fn: (args: TStepArgs, featureStep?: TFeatureStep) => Promise<z.infer<T>> | z.infer<T>): (args: TStepArgs, featureStep?: TFeatureStep) => Promise<TActionResult>;
+//# sourceMappingURL=step-helpers.d.ts.map

package/build/lib/step-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/step-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxE,MAAM,EAAE,CAAC,EACT,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAEzD,SAAS,gBAAgB,YAAY,KAAG,OAAO,CAAC,aAAa,CAAC,CAO1F"}

package/build/lib/step-helpers.js

@@ -0,0 +1,16 @@
+import { actionOK } from './util/index.js';
+/**
+ * Wrap a step action with a products schema.
+ * The fn returns raw products data; withProducts wraps it in actionOK.
+ * The schema is attached to the returned action for buildStepRegistry to read.
+ */
+export function withProducts(schema, fn) {
+    const action = async (args, featureStep) => {
+        const products = await fn(args, featureStep);
+        return actionOK({ products });
+    };
+    // biome-ignore lint/suspicious/noExplicitAny: attaching schema metadata for buildStepRegistry
+    action.__productsSchema = schema;
+    return action;
+}
+//# sourceMappingURL=step-helpers.js.map

package/build/lib/step-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-helpers.js","sourceRoot":"","sources":["../../src/lib/step-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC3B,MAAS,EACT,EAAqF;IAErF,MAAM,MAAM,GAAG,KAAK,EAAE,IAAe,EAAE,WAA0B,EAA0B,EAAE;QAC5F,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,8FAA8F;IAC7F,MAAc,CAAC,gBAAgB,GAAG,MAAM,CAAC;IAC1C,OAAO,MAAM,CAAC;AACf,CAAC"}

package/build/lib/step-validation.d.ts

@@ -0,0 +1,26 @@
+import { AStepper } from './astepper.js';
+import type { TStepAction, TFeatures } from './defs.js';
+import { type StepDescriptor } from './stepper-registry.js';
+/**
+ * Result of validating a step text against registered steppers.
+ */
+export type StepValidationResult = {
+    valid: true;
+    action: TStepAction;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Validate a step text against the registered steppers.
+ * Returns the matched action if valid, or an error message if not.
+ *
+ * Shared by LSP (diagnostics), SSE (step mode validation), and any future consumer.
+ */
+export declare function validateStep(text: string, steppers: AStepper[], backgrounds?: TFeatures): StepValidationResult;
+/**
+ * Get metadata for all exposed steps across all steppers.
+ * Used for autocomplete in LSP, SSE step mode, and MCP tool discovery.
+ */
+export declare function getStepDescriptors(steppers: AStepper[]): StepDescriptor[];
+//# sourceMappingURL=step-validation.d.ts.map

package/build/lib/step-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-validation.d.ts","sourceRoot":"","sources":["../../src/lib/step-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACpB,GAAG;IACH,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,WAAW,CAAC,EAAE,SAAS,GAAG,oBAAoB,CAQ9G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAEzE"}

package/build/lib/step-validation.js

@@ -0,0 +1,26 @@
+import { Resolver } from '../phases/Resolver.js';
+import { StepperRegistry } from './stepper-registry.js';
+/**
+ * Validate a step text against the registered steppers.
+ * Returns the matched action if valid, or an error message if not.
+ *
+ * Shared by LSP (diagnostics), SSE (step mode validation), and any future consumer.
+ */
+export function validateStep(text, steppers, backgrounds) {
+    const resolver = new Resolver(steppers, backgrounds || []);
+    try {
+        const action = resolver.findSingleStepAction(text);
+        return { valid: true, action };
+    }
+    catch (e) {
+        return { valid: false, error: e instanceof Error ? e.message : String(e) };
+    }
+}
+/**
+ * Get metadata for all exposed steps across all steppers.
+ * Used for autocomplete in LSP, SSE step mode, and MCP tool discovery.
+ */
+export function getStepDescriptors(steppers) {
+    return StepperRegistry.getMetadata(steppers);
+}
+//# sourceMappingURL=step-validation.js.map

package/build/lib/step-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-validation.js","sourceRoot":"","sources":["../../src/lib/step-validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAa7E;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAoB,EAAE,WAAuB;IACvF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAoB;IACtD,OAAO,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/build/lib/stepper-registry.d.ts

@@ -3,11 +3,14 @@ import { AStepper } from './astepper.js';
  * Metadata for a single step, extracted from a stepper definition.
  * Used by both LSP (for autocomplete/hover) and MCP (for tool registration).
  */
-export interface StepMetadata {
+export interface StepDescriptor {
     stepperName: string;
     stepName: string;
+    method: string;
     pattern: string;
     params: Record<string, 'string' | 'number'>;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
 }
 /**
  * Central registry for extracting step metadata from steppers.
@@ -18,7 +21,7 @@ export declare class StepperRegistry {
      * Extract metadata from all steps in the provided steppers.
      * Filters out steps marked with `expose: false`.
      */
-    static getMetadata(steppers: AStepper[]): StepMetadata[];
+    static getMetadata(steppers: AStepper[]): StepDescriptor[];
     /**
      * Convert a gwta pattern to an LSP snippet format.
      * Transforms `{varName}` to `${1:varName}` for tab-stop support.

package/build/lib/stepper-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepper-registry.d.ts","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE;IAuBxD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIjD"}
+{"version":3,"file":"stepper-registry.d.ts","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAwB1D;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAIjD"}

package/build/lib/stepper-registry.js

@@ -26,7 +26,8 @@ export class StepperRegistry {
                         }
                     }
                 }
-                return { stepperName, stepName, pattern, params };
+                const method = `${stepperName}-${stepName}`;
+                return { stepperName, stepName, method, pattern, params };
             });
         });
     }

package/build/lib/stepper-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepper-registry.js","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAapD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAoB;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC3B,MAAM,MAAM,GAAwC,EAAE,CAAC;gBACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,QAAQ,CAAC;gBAEvF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,aAAa,EAAE,CAAC;wBAClB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;4BAC7C,kEAAkE;4BAClE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;wBAC/D,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACpD,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAe;QACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;CACF"}
+{"version":3,"file":"stepper-registry.js","sourceRoot":"","sources":["../../src/lib/stepper-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAgBpD;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAoB;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAChC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC3B,MAAM,MAAM,GAAwC,EAAE,CAAC;gBACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,QAAQ,CAAC;gBAEvF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3D,IAAI,aAAa,EAAE,CAAC;wBAClB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;4BAC7C,kEAAkE;4BAClE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;wBAC/D,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC;gBAC5C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC5D,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAe;QACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;CACF"}

package/build/lib/test/EventCollectorStepper.d.ts

@@ -1,5 +1,5 @@
-import { AStepper, IHasCycles } from '../astepper.js';
-import { TWorld, IStepperCycles } from '../defs.js';
+import { AStepper } from '../astepper.js';
+import { TWorld } from '../defs.js';
 import { THaibunEvent } from '../../schema/protocol.js';
 /**
  * EventCollectorStepper - Collects events for test inspection.
@@ -12,10 +12,10 @@ import { THaibunEvent } from '../../schema/protocol.js';
  * const stepEvents = collector.getStepEvents();
  * ```
  */
-export declare class EventCollectorStepper extends AStepper implements IHasCycles {
+export declare class EventCollectorStepper extends AStepper {
     description: string;
     private events;
-    cycles: IStepperCycles;
+    private subscriberCallback?;
     setWorld(world: TWorld, steppers: AStepper[]): Promise<void>;
     steps: {};
     /** Get all collected events */
@@ -26,6 +26,8 @@ export declare class EventCollectorStepper extends AStepper implements IHasCycle
     findEvents(predicate: (e: THaibunEvent) => boolean): THaibunEvent[];
     /** Clear collected events */
     clear(): void;
+    /** Unsubscribe from event logger */
+    close(): void;
 }
 export default EventCollectorStepper;
 //# sourceMappingURL=EventCollectorStepper.d.ts.map

package/build/lib/test/EventCollectorStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventCollectorStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,QAAS,YAAW,UAAU;IACvE,WAAW,SAAyC;IAEpD,OAAO,CAAC,MAAM,CAAsB;IAEpC,MAAM,EAAE,cAAc,CAYpB;IAEF,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D,KAAK,KAAM;IAEX,+BAA+B;IAC/B,SAAS,IAAI,YAAY,EAAE;IAI3B,qCAAqC;IACrC,aAAa,IAAI,YAAY,EAAE;IAI/B,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,EAAE;IAInE,6BAA6B;IAC7B,KAAK,IAAI,IAAI;CAGd;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"EventCollectorStepper.d.ts","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,WAAW,SAAyC;IAEpD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAErD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,KAAK,KAAM;IAEX,+BAA+B;IAC/B,SAAS,IAAI,YAAY,EAAE;IAI3B,qCAAqC;IACrC,aAAa,IAAI,YAAY,EAAE;IAI/B,sCAAsC;IACtC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,EAAE;IAInE,6BAA6B;IAC7B,KAAK,IAAI,IAAI;IAIb,oCAAoC;IACpC,KAAK,IAAI,IAAI;CAMd;AAED,eAAe,qBAAqB,CAAC"}

package/build/lib/test/EventCollectorStepper.js

@@ -13,28 +13,13 @@ import { AStepper } from '../astepper.js';
 export class EventCollectorStepper extends AStepper {
     description = 'Collects events for test inspection';
     events = [];
-    cycles = {
-        startScenario: () => {
-            // Hook into world event logger to collect events
-            if (this.world?.eventLogger) {
-                const originalCallback = this.world.eventLogger.stepperCallback;
-                this.world.eventLogger.setStepperCallback?.((event) => {
-                    this.events.push(event);
-                    originalCallback?.(event);
-                });
-            }
-            return Promise.resolve();
-        }
-    };
-    setWorld(world, steppers) {
-        this.world = world;
-        // Hook into world event logger immediately
-        if (world.eventLogger?.setStepperCallback) {
-            world.eventLogger.setStepperCallback((event) => {
-                this.events.push(event);
-            });
-        }
-        return Promise.resolve();
+    subscriberCallback;
+    async setWorld(world, steppers) {
+        await super.setWorld(world, steppers);
+        this.subscriberCallback = (event) => {
+            this.events.push(event);
+        };
+        world.eventLogger.subscribe(this.subscriberCallback);
     }
     steps = {};
     /** Get all collected events */
@@ -53,6 +38,13 @@ export class EventCollectorStepper extends AStepper {
     clear() {
         this.events = [];
     }
+    /** Unsubscribe from event logger */
+    close() {
+        if (this.subscriberCallback && this.world?.eventLogger) {
+            this.world.eventLogger.unsubscribe(this.subscriberCallback);
+            this.subscriberCallback = undefined;
+        }
+    }
 }
 export default EventCollectorStepper;
 //# sourceMappingURL=EventCollectorStepper.js.map

package/build/lib/test/EventCollectorStepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"EventCollectorStepper.js","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAItD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,WAAW,GAAG,qCAAqC,CAAC;IAE5C,MAAM,GAAmB,EAAE,CAAC;IAEpC,MAAM,GAAmB;QACvB,aAAa,EAAE,GAAG,EAAE;YAClB,iDAAiD;YACjD,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;gBAC5B,MAAM,gBAAgB,GAAI,IAAI,CAAC,KAAK,CAAC,WAA+D,CAAC,eAAe,CAAC;gBACrH,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC,KAAmB,EAAE,EAAE;oBAClE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACxB,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC;IAEF,QAAQ,CAAC,KAAa,EAAE,QAAoB;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,2CAA2C;QAC3C,IAAI,KAAK,CAAC,WAAW,EAAE,kBAAkB,EAAE,CAAC;YAC1C,KAAK,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,KAAmB,EAAE,EAAE;gBAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,GAAG,EAAE,CAAC;IAEX,+BAA+B;IAC/B,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,qCAAqC;IACrC,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,SAAuC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"EventCollectorStepper.js","sourceRoot":"","sources":["../../../src/lib/test/EventCollectorStepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IACjD,WAAW,GAAG,qCAAqC,CAAC;IAE5C,MAAM,GAAmB,EAAE,CAAC;IAC5B,kBAAkB,CAAiC;IAE3D,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,QAAoB;QAChD,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAmB,EAAE,EAAE;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC;QACF,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,GAAG,EAAE,CAAC;IAEX,+BAA+B;IAC/B,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,qCAAqC;IACrC,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,SAAuC;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,6BAA6B;IAC7B,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,oCAAoC;IACpC,KAAK;QACH,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YACvD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC5D,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACtC,CAAC;IACH,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/build/lib/test/TestStepsWithOptions.d.ts

@@ -1,4 +1,5 @@
 import { AStepper } from '../astepper.js';
+import { z } from 'zod';
 export declare const TestStepsWithOptions: {
     new (): {
         options: {
@@ -12,7 +13,10 @@ export declare const TestStepsWithOptions: {
         steps: {
             test: {
                 exact: string;
-                action: () => Promise<import("../../schema/protocol.js").TOKActionResult>;
+                outputSchema: z.ZodObject<{
+                    summary: z.ZodString;
+                }, z.core.$strip>;
+                action: () => Promise<import("../../schema/protocol.js").TActionOKWithProducts>;
             };
         };
         description?: string;

package/build/lib/test/TestStepsWithOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestStepsWithOptions.d.ts","sourceRoot":"","sources":["../../../src/lib/test/TestStepsWithOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;CAgBhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"TestStepsWithOptions.d.ts","sourceRoot":"","sources":["../../../src/lib/test/TestStepsWithOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;CAiBhC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/build/lib/test/TestStepsWithOptions.js

@@ -1,5 +1,6 @@
 import { AStepper } from '../astepper.js';
-import { actionOK, getStepperOption } from '../util/index.js';
+import { actionOKWithProducts, getStepperOption } from '../util/index.js';
+import { z } from 'zod';
 export const TestStepsWithOptions = class TestStepsWithOptions extends AStepper {
     options = {
         EXISTS: {
@@ -10,9 +11,10 @@ export const TestStepsWithOptions = class TestStepsWithOptions extends AStepper
     steps = {
         test: {
             exact: 'have a stepper option',
+            outputSchema: z.object({ summary: z.string() }),
             action: () => {
                 const _res = getStepperOption(this, 'EXISTS', this.getWorld().moduleOptions);
-                return Promise.resolve(actionOK({ topics: { summary: 'options' } }));
+                return Promise.resolve(actionOKWithProducts({ summary: 'options' }));
             },
         },
     };

package/build/lib/test/TestStepsWithOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestStepsWithOptions.js","sourceRoot":"","sources":["../../../src/lib/test/TestStepsWithOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,oBAAqB,SAAQ,QAAQ;IAC9E,OAAO,GAAG;QACT,MAAM,EAAE;YACP,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;SAC7B;KACD,CAAC;IACF,KAAK,GAAG;QACP,IAAI,EAAE;YACL,KAAK,EAAE,uBAAuB;YAC9B,MAAM,EAAE,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAC;gBAC7E,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;SACD;KACD,CAAC;CACF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"TestStepsWithOptions.js","sourceRoot":"","sources":["../../../src/lib/test/TestStepsWithOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,oBAAqB,SAAQ,QAAQ;IAC9E,OAAO,GAAG;QACT,MAAM,EAAE;YACP,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;SAC7B;KACD,CAAC;IACF,KAAK,GAAG;QACP,IAAI,EAAE;YACL,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAC;gBAC7E,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;SACD;KACD,CAAC;CACF,CAAC;AAEF,eAAe,oBAAoB,CAAC"}