flowspec 0.1.0

package/dist/init.js

@@ -0,0 +1,173 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * Default content for flowspec.config.yaml
+ */
+export const DEFAULT_CONFIG_CONTENT = `baseUrl: http://localhost:3000
+timeout: 10000
+specsDir: specs/
+`;
+/**
+ * Default content for example flow file
+ */
+export const DEFAULT_EXAMPLE_FLOW_CONTENT = `name: example-flow
+description: Example flow - customize this for your app
+steps:
+  - visit: /
+expect:
+  - visible: Welcome
+`;
+/**
+ * Default content for Claude settings to protect specs
+ */
+export const DEFAULT_CLAUDE_SETTINGS_CONTENT = `{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": { "tool": ["Edit", "Write"], "path": "specs/**/*.flow.yaml" },
+      "command": "echo '❌ Flow specs are immutable. Fix the implementation, not the spec.' && exit 1"
+    }]
+  }
+}
+`;
+/**
+ * Safely create a directory if it doesn't exist
+ */
+function ensureDirectory(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Create a file if it doesn't exist
+ * @returns Result indicating whether file was created or skipped
+ */
+function createFileIfNotExists(filePath, content) {
+    const result = {
+        path: filePath,
+        created: false,
+        skipped: false,
+    };
+    try {
+        if (existsSync(filePath)) {
+            result.skipped = true;
+            return result;
+        }
+        // Ensure parent directory exists
+        const parentDir = dirname(filePath);
+        ensureDirectory(parentDir);
+        writeFileSync(filePath, content, "utf-8");
+        result.created = true;
+    }
+    catch (error) {
+        result.error =
+            error instanceof Error ? error.message : "Unknown error occurred";
+    }
+    return result;
+}
+/**
+ * Update package.json with test:e2e script if it exists
+ * @returns Result indicating whether package.json was updated
+ */
+function updatePackageJson(projectDir) {
+    const packageJsonPath = join(projectDir, "package.json");
+    const result = {
+        path: packageJsonPath,
+        created: false,
+        skipped: false,
+    };
+    try {
+        if (!existsSync(packageJsonPath)) {
+            result.skipped = true;
+            return result;
+        }
+        const content = readFileSync(packageJsonPath, "utf-8");
+        const pkg = JSON.parse(content);
+        // Ensure scripts object exists
+        if (!pkg.scripts || typeof pkg.scripts !== "object") {
+            pkg.scripts = {};
+        }
+        const scripts = pkg.scripts;
+        // Check if test:e2e already exists
+        if (scripts["test:e2e"]) {
+            result.skipped = true;
+            return result;
+        }
+        // Add the test:e2e script
+        scripts["test:e2e"] = "flowspec run";
+        // Write back with proper formatting
+        writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
+        result.created = true;
+    }
+    catch (error) {
+        result.error =
+            error instanceof Error ? error.message : "Unknown error occurred";
+    }
+    return result;
+}
+/**
+ * Initialize FlowSpec in a project directory
+ * Creates configuration files and example flow
+ *
+ * @param projectDir - Directory to initialize (defaults to cwd)
+ * @returns Result with details about each file created
+ */
+export function initProject(projectDir = process.cwd()) {
+    const files = [];
+    // 1. Create flowspec.config.yaml
+    const configResult = createFileIfNotExists(join(projectDir, "flowspec.config.yaml"), DEFAULT_CONFIG_CONTENT);
+    files.push(configResult);
+    // 2. Create specs/example.flow.yaml
+    const exampleFlowResult = createFileIfNotExists(join(projectDir, "specs", "example.flow.yaml"), DEFAULT_EXAMPLE_FLOW_CONTENT);
+    files.push(exampleFlowResult);
+    // 3. Create .claude/settings.local.json
+    const claudeSettingsResult = createFileIfNotExists(join(projectDir, ".claude", "settings.local.json"), DEFAULT_CLAUDE_SETTINGS_CONTENT);
+    files.push(claudeSettingsResult);
+    // 4. Update package.json if it exists
+    const packageJsonResult = updatePackageJson(projectDir);
+    files.push(packageJsonResult);
+    // Determine overall success
+    const success = files.every((f) => !f.error);
+    return { files, success };
+}
+/**
+ * Format the init result for console output
+ */
+export function formatInitResult(result) {
+    const lines = [];
+    for (const file of result.files) {
+        const relativePath = file.path.includes("/")
+            ? file.path.split("/").slice(-2).join("/")
+            : file.path;
+        // Get just the filename or last path component
+        const displayPath = file.path.endsWith("package.json")
+            ? "Added test:e2e script to package.json"
+            : relativePath;
+        if (file.error) {
+            lines.push(`✗ Failed to create ${displayPath}: ${file.error}`);
+        }
+        else if (file.skipped) {
+            if (file.path.endsWith("package.json")) {
+                // Don't show anything for skipped package.json (either doesn't exist or already has script)
+                continue;
+            }
+            lines.push(`· Skipped ${displayPath} (already exists)`);
+        }
+        else if (file.created) {
+            if (file.path.endsWith("package.json")) {
+                lines.push(`✓ ${displayPath}`);
+            }
+            else {
+                lines.push(`✓ Created ${displayPath}`);
+            }
+        }
+    }
+    if (result.success) {
+        lines.push("");
+        lines.push("FlowSpec initialized! Next steps:");
+        lines.push("  1. Edit specs/example.flow.yaml for your app");
+        lines.push("  2. Start your app on http://localhost:3000");
+        lines.push("  3. Run: flowspec run");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAoB1C;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;CAGrC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;CAM3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;CAQ9C,CAAC;AAEF;;GAEG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,QAAgB,EAChB,OAAe;IAEf,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,iCAAiC;QACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,eAAe,CAAC,SAAS,CAAC,CAAC;QAE3B,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK;YACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,UAAkB;IAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACzD,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAE3D,+BAA+B;QAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpD,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiC,CAAC;QAEtD,mCAAmC;QACnC,IAAI,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,0BAA0B;QAC1B,OAAO,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC;QAErC,oCAAoC;QACpC,aAAa,CACX,eAAe,EACf,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACnC,OAAO,CACR,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK;YACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,aAAqB,OAAO,CAAC,GAAG,EAAE;IAC5D,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,iCAAiC;IACjC,MAAM,YAAY,GAAG,qBAAqB,CACxC,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,EACxC,sBAAsB,CACvB,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAEzB,oCAAoC;IACpC,MAAM,iBAAiB,GAAG,qBAAqB,CAC7C,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAC9C,4BAA4B,CAC7B,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,wCAAwC;IACxC,MAAM,oBAAoB,GAAG,qBAAqB,CAChD,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,qBAAqB,CAAC,EAClD,+BAA+B,CAChC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAEjC,sCAAsC;IACtC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE9B,4BAA4B;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAEd,+CAA+C;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YACpD,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,WAAW,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,4FAA4F;gBAC5F,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,mBAAmB,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,16 @@
+import { type FlowSpec } from "./types";
+/**
+ * Parse a YAML string into a FlowSpec object
+ * @param yamlContent - The YAML string to parse
+ * @returns The parsed FlowSpec
+ * @throws Error if YAML is invalid or doesn't match FlowSpec schema
+ */
+export declare function parseFlowSpec(yamlContent: string): FlowSpec;
+/**
+ * Read and parse a YAML flow file
+ * @param filePath - Path to the YAML file
+ * @returns The parsed FlowSpec
+ * @throws Error if file not found, YAML is invalid, or doesn't match FlowSpec schema
+ */
+export declare function parseFlowFile(filePath: string): FlowSpec;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,QAAQ,EAAkB,MAAM,SAAS,CAAC;AAaxD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAqB3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAaxD"}

package/dist/parser.js

@@ -0,0 +1,56 @@
+import { readFileSync } from "node:fs";
+import yaml from "js-yaml";
+import { FlowSpecSchema } from "./types";
+/**
+ * Format a Zod validation error into a human-readable message
+ */
+function formatZodError(error) {
+    const issues = error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "root";
+        return `${path}: ${issue.message}`;
+    });
+    return `Schema validation failed: ${issues.join("; ")}`;
+}
+/**
+ * Parse a YAML string into a FlowSpec object
+ * @param yamlContent - The YAML string to parse
+ * @returns The parsed FlowSpec
+ * @throws Error if YAML is invalid or doesn't match FlowSpec schema
+ */
+export function parseFlowSpec(yamlContent) {
+    let parsed;
+    try {
+        parsed = yaml.load(yamlContent);
+    }
+    catch (error) {
+        if (error instanceof yaml.YAMLException) {
+            throw new Error(`Invalid YAML syntax at line ${error.mark?.line ?? "unknown"}, column ${error.mark?.column ?? "unknown"}: ${error.reason}`);
+        }
+        throw error;
+    }
+    const result = FlowSpecSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(formatZodError(result.error));
+    }
+    return result.data;
+}
+/**
+ * Read and parse a YAML flow file
+ * @param filePath - Path to the YAML file
+ * @returns The parsed FlowSpec
+ * @throws Error if file not found, YAML is invalid, or doesn't match FlowSpec schema
+ */
+export function parseFlowFile(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        throw error;
+    }
+    return parseFlowSpec(content);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAiB,cAAc,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,SAAS,cAAc,CAAC,KAAe;IACrC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACnE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO,6BAA6B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,YAAY,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,EAAE,CAC3H,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,OAAe,CAAC;IAEpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,22 @@
+import type { FlowError, FlowResult } from "./types";
+/**
+ * Format a FlowError into a human-readable string
+ * @param error - The FlowError to format
+ * @returns Formatted error message
+ */
+export declare function formatError(error: FlowError): string;
+/**
+ * Format a single FlowResult for terminal output
+ * Shows checkmark and duration for success, X with error details for failure
+ * @param result - The FlowResult to format
+ * @returns Formatted result string with ANSI colors
+ */
+export declare function formatResult(result: FlowResult): string;
+/**
+ * Format multiple FlowResults into a summary line
+ * Shows total, passed, and failed counts
+ * @param results - Array of FlowResults to summarize
+ * @returns Formatted summary string
+ */
+export declare function formatSummary(results: FlowResult[]): string;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AAqCjE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAUpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAoBvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAQ3D"}

package/dist/reporter.js

@@ -0,0 +1,80 @@
+// ANSI color codes
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const RESET = "\x1b[0m";
+/**
+ * Format duration for display
+ * Uses seconds for durations >= 1000ms, otherwise milliseconds
+ */
+function formatDuration(ms) {
+    if (ms >= 1000) {
+        return `${ms / 1000}s`;
+    }
+    return `${ms}ms`;
+}
+/**
+ * Format a StepAction into a human-readable string
+ */
+function formatAction(action) {
+    if ("visit" in action) {
+        return `visit "${action.visit}"`;
+    }
+    if ("click" in action) {
+        return `click "${action.click}"`;
+    }
+    if ("fill" in action) {
+        return "fill";
+    }
+    if ("select" in action) {
+        return "select";
+    }
+    return "unknown action";
+}
+/**
+ * Format a FlowError into a human-readable string
+ * @param error - The FlowError to format
+ * @returns Formatted error message
+ */
+export function formatError(error) {
+    const parts = [];
+    if (error.step !== undefined && error.action) {
+        parts.push(`Step ${error.step}: ${formatAction(error.action)}`);
+    }
+    parts.push(`Error: ${error.message}`);
+    return parts.join("\n  ");
+}
+/**
+ * Format a single FlowResult for terminal output
+ * Shows checkmark and duration for success, X with error details for failure
+ * @param result - The FlowResult to format
+ * @returns Formatted result string with ANSI colors
+ */
+export function formatResult(result) {
+    const duration = formatDuration(result.duration);
+    if (result.success) {
+        return `${GREEN}✓ ${result.flowName} (${duration})${RESET}`;
+    }
+    const lines = [];
+    lines.push(`${RED}✗ ${result.flowName} (${duration})${RESET}`);
+    if (result.error) {
+        if (result.error.step !== undefined && result.error.action) {
+            lines.push(`  Step ${result.error.step}: ${formatAction(result.error.action)}`);
+        }
+        lines.push(`  Error: ${result.error.message}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format multiple FlowResults into a summary line
+ * Shows total, passed, and failed counts
+ * @param results - Array of FlowResults to summarize
+ * @returns Formatted summary string
+ */
+export function formatSummary(results) {
+    const total = results.length;
+    const passed = results.filter((r) => r.success).length;
+    const failed = total - passed;
+    const flowWord = total === 1 ? "flow" : "flows";
+    return `${total} ${flowWord}: ${passed} passed, ${failed} failed`;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,24 @@
+import type { FlowResult, FlowSpec } from "./types";
+/**
+ * Options for flow execution
+ */
+export interface RunnerOptions {
+    baseUrl?: string;
+    timeout?: number;
+}
+/**
+ * Default timeout for assertion retries (in milliseconds)
+ */
+export declare const DEFAULT_TIMEOUT = 5000;
+/**
+ * Interval between retry attempts (in milliseconds)
+ */
+export declare const POLL_INTERVAL = 250;
+/**
+ * Execute a flow specification and return the result
+ * @param flow - The FlowSpec to execute
+ * @param options - Optional runner configuration
+ * @returns Promise resolving to the FlowResult
+ */
+export declare function runFlow(flow: FlowSpec, options?: RunnerOptions): Promise<FlowResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,QAAQ,EAGT,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,aAAa,MAAM,CAAC;AA4bjC;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,UAAU,CAAC,CAuDrB"}