@tyndall/test-playwright 0.0.1

package/README.md

@@ -0,0 +1,30 @@
+# @tyndall/test-playwright
+
+## Overview
+Scenario-driven Playwright testing package for end-to-end validation and report generation.
+
+## Responsibilities
+- Load and validate scenario definitions
+- Execute scenario steps against running apps
+- Produce console, json, and html reports with extension hooks
+- Guard app launch ports to avoid attaching scenarios to stale pre-existing servers
+- Stabilize async UI assertions through polling-based selector expectation checks
+
+## Public API Highlights
+- ScenarioLoader and ScenarioValidator
+- PlaywrightRunner and StepExecutor
+- Reporter interfaces
+
+## Development
+- Build: bun run --filter @tyndall/test-playwright build
+- Test (from workspace root): bun test
+
+## Documentation
+- Package specification: [spec.md](./spec.md)
+- Package architecture: [architecture.md](./architecture.md)
+- Package changes: [CHANGELOG.md](./CHANGELOG.md)
+
+## Maintenance Rules
+- Keep this document aligned with implemented package behavior.
+- Update spec.md and architecture.md whenever package contracts or design boundaries change.
+- Record user-visible package changes in CHANGELOG.md.

package/dist/app/AppInstance.d.ts

@@ -0,0 +1,24 @@
+import type { ChildProcess } from "node:child_process";
+import type { ScenarioMode } from "../types/scenario.js";
+export interface AppOutput {
+    stdout: string[];
+    stderr: string[];
+}
+export interface AppInstanceOptions {
+    mode: ScenarioMode;
+    baseUrl: string;
+    process: ChildProcess;
+    output: AppOutput;
+    ready: Promise<void>;
+}
+export declare class AppInstance {
+    readonly mode: ScenarioMode;
+    readonly baseUrl: string;
+    readonly process: ChildProcess;
+    readonly output: AppOutput;
+    private readonly readyPromise;
+    constructor(options: AppInstanceOptions);
+    waitReady(): Promise<void>;
+    dispose(gracefulTimeoutMs?: number): Promise<void>;
+}
+//# sourceMappingURL=AppInstance.d.ts.map

package/dist/app/AppInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppInstance.d.ts","sourceRoot":"","sources":["../../src/app/AppInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,OAAO,EAAE,kBAAkB;IAQjC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,OAAO,CAAC,iBAAiB,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBvD"}

package/dist/app/AppInstance.js

@@ -0,0 +1,30 @@
+export class AppInstance {
+    constructor(options) {
+        this.mode = options.mode;
+        this.baseUrl = options.baseUrl;
+        this.process = options.process;
+        this.output = options.output;
+        this.readyPromise = options.ready;
+    }
+    async waitReady() {
+        await this.readyPromise;
+    }
+    async dispose(gracefulTimeoutMs = 5000) {
+        if (this.process.killed) {
+            return;
+        }
+        this.process.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                if (!this.process.killed) {
+                    this.process.kill("SIGKILL");
+                }
+                resolve();
+            }, gracefulTimeoutMs);
+            this.process.once("exit", () => {
+                clearTimeout(timeout);
+                resolve();
+            });
+        });
+    }
+}

package/dist/app/AppLauncher.d.ts

@@ -0,0 +1,32 @@
+import { AppInstance } from "./AppInstance.js";
+import type { ScenarioMode } from "../types/scenario.js";
+import { LaunchError } from "../errors.js";
+export interface AppLaunchOptions {
+    mode: ScenarioMode;
+    cwd: string;
+    host?: string;
+    port?: number;
+    outDir?: string;
+    env?: Record<string, string>;
+    command?: string[];
+    readyPath?: string;
+    timeoutMs?: number;
+}
+export interface AppLaunchCommand {
+    command: string;
+    args: string[];
+}
+export declare class AppLaunchError extends LaunchError {
+    constructor(message: string);
+}
+export declare class AppLauncher {
+    launch(options: AppLaunchOptions): Promise<AppInstance>;
+    buildCommand(options: AppLaunchOptions, host: string, port: number): AppLaunchCommand;
+    private runBuild;
+    private spawnProcess;
+    private waitForReady;
+    private formatOutput;
+    private ensurePortAvailable;
+    private isTcpPortOpen;
+}
+//# sourceMappingURL=AppLauncher.d.ts.map

package/dist/app/AppLauncher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppLauncher.d.ts","sourceRoot":"","sources":["../../src/app/AppLauncher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAMD,qBAAa,WAAW;IAChB,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B7D,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB;YAyBvE,QAAQ;IAoBtB,OAAO,CAAC,YAAY;YAsBN,YAAY;IAsB1B,OAAO,CAAC,YAAY;YAQN,mBAAmB;YASnB,aAAa;CA8B5B"}

package/dist/app/AppLauncher.js

@@ -0,0 +1,147 @@
+import { spawn } from "node:child_process";
+import { setTimeout as delay } from "node:timers/promises";
+import { Socket } from "node:net";
+import { AppInstance } from "./AppInstance.js";
+import { LaunchError } from "../errors.js";
+export class AppLaunchError extends LaunchError {
+    constructor(message) {
+        super(message);
+        this.name = "AppLaunchError";
+    }
+}
+const DEFAULT_HOST = "localhost";
+const DEFAULT_PORT = 3000;
+const DEFAULT_TIMEOUT_MS = 15000;
+export class AppLauncher {
+    async launch(options) {
+        const host = options.host ?? DEFAULT_HOST;
+        const port = options.port ?? DEFAULT_PORT;
+        const baseUrl = `http://${host}:${port}`;
+        const readyPath = options.readyPath ?? "/";
+        const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (options.mode === "ssg") {
+            await this.runBuild(options);
+        }
+        await this.ensurePortAvailable(host, port);
+        const command = this.buildCommand(options, host, port);
+        const output = { stdout: [], stderr: [] };
+        const child = this.spawnProcess(command, options.cwd, options.env, output);
+        const ready = this.waitForReady(`${baseUrl}${readyPath}`, timeoutMs);
+        return new AppInstance({
+            mode: options.mode,
+            baseUrl,
+            process: child,
+            output,
+            ready,
+        });
+    }
+    buildCommand(options, host, port) {
+        const base = options.command ?? ["cloud-front"];
+        const [command, ...baseArgs] = base;
+        if (options.mode === "dev") {
+            return {
+                command,
+                args: [...baseArgs, "dev", "--host", host, "--port", String(port)],
+            };
+        }
+        if (options.mode === "ssg") {
+            const outDir = options.outDir ?? "dist";
+            return {
+                command,
+                args: [...baseArgs, "preview", "--host", host, "--port", String(port), "--outDir", outDir],
+            };
+        }
+        return {
+            command,
+            args: [...baseArgs, "start", "--host", host, "--port", String(port)],
+        };
+    }
+    async runBuild(options) {
+        const base = options.command ?? ["cloud-front"];
+        const [command, ...baseArgs] = base;
+        const outDir = options.outDir ?? "dist";
+        const buildArgs = [...baseArgs, "build", "--mode", "ssg", "--outDir", outDir];
+        const output = { stdout: [], stderr: [] };
+        const child = this.spawnProcess({ command, args: buildArgs }, options.cwd, options.env, output);
+        const exitCode = await new Promise((resolve) => {
+            child.once("exit", (code) => resolve(code));
+        });
+        if (exitCode !== 0) {
+            throw new AppLaunchError(`cloud-front build failed with exit code ${exitCode}. ${this.formatOutput(output)}`);
+        }
+    }
+    spawnProcess(command, cwd, env, output) {
+        const child = spawn(command.command, command.args, {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        child.stdout?.on("data", (chunk) => {
+            output.stdout.push(chunk.toString());
+        });
+        child.stderr?.on("data", (chunk) => {
+            output.stderr.push(chunk.toString());
+        });
+        return child;
+    }
+    async waitForReady(url, timeoutMs) {
+        const started = Date.now();
+        while (Date.now() - started < timeoutMs) {
+            try {
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), 1000);
+                const response = await fetch(url, { signal: controller.signal });
+                clearTimeout(timeout);
+                if (response.ok) {
+                    return;
+                }
+            }
+            catch {
+                // keep retrying until timeout
+            }
+            await delay(200);
+        }
+        throw new AppLaunchError(`App did not become ready within ${timeoutMs}ms: ${url}`);
+    }
+    formatOutput(output) {
+        const stdout = output.stdout.join("").trim();
+        const stderr = output.stderr.join("").trim();
+        return [stdout && `stdout: ${stdout}`, stderr && `stderr: ${stderr}`]
+            .filter(Boolean)
+            .join(" | ");
+    }
+    async ensurePortAvailable(host, port) {
+        const isOpen = await this.isTcpPortOpen(host, port);
+        if (isOpen) {
+            throw new AppLaunchError(`Port ${port} on host "${host}" is already in use. Stop the existing server or provide a different port.`);
+        }
+    }
+    async isTcpPortOpen(host, port) {
+        return new Promise((resolve) => {
+            const socket = new Socket();
+            let settled = false;
+            const finalize = (value) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                socket.destroy();
+                resolve(value);
+            };
+            socket.setTimeout(400);
+            socket.once("connect", () => finalize(true));
+            socket.once("timeout", () => finalize(false));
+            socket.once("error", (error) => {
+                if (error.code === "ECONNREFUSED" ||
+                    error.code === "EHOSTUNREACH" ||
+                    error.code === "ENOTFOUND" ||
+                    error.code === "EAI_AGAIN") {
+                    finalize(false);
+                    return;
+                }
+                finalize(true);
+            });
+            socket.connect(port, host);
+        });
+    }
+}

package/dist/dynamic/ManifestObserver.d.ts

@@ -0,0 +1,24 @@
+import type { Page } from "playwright";
+import type { DynamicManifestExpectation } from "../types/scenario.js";
+export interface ManifestObservation {
+    url: string;
+    status: number;
+    mode?: "meta" | "program";
+    pageId?: string;
+    version?: string;
+}
+export interface ManifestObserverOptions {
+    endpoints?: RegExp[];
+}
+export declare class ManifestObserver {
+    private readonly endpoints;
+    private readonly observations;
+    constructor(options?: ManifestObserverOptions);
+    attach(page: Page): void;
+    getObservations(): ManifestObservation[];
+    reset(): void;
+    assert(expectation: DynamicManifestExpectation): void;
+    private matches;
+    private handleResponse;
+}
+//# sourceMappingURL=ManifestObserver.d.ts.map

package/dist/dynamic/ManifestObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestObserver.d.ts","sourceRoot":"","sources":["../../src/dynamic/ManifestObserver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE9C,OAAO,GAAE,uBAA4B;IAIjD,MAAM,CAAC,IAAI,EAAE,IAAI;IAMjB,eAAe;IAIf,KAAK;IAIL,MAAM,CAAC,WAAW,EAAE,0BAA0B;IAW9C,OAAO,CAAC,OAAO;YAaD,cAAc;CAqC7B"}

package/dist/dynamic/ManifestObserver.js

@@ -0,0 +1,71 @@
+const DEFAULT_ENDPOINTS = [/\/api\/pages\/resolve/, /\/api\/pages\//];
+export class ManifestObserver {
+    constructor(options = {}) {
+        this.observations = [];
+        this.endpoints = options.endpoints ?? DEFAULT_ENDPOINTS;
+    }
+    attach(page) {
+        page.on("response", (response) => {
+            void this.handleResponse(response);
+        });
+    }
+    getObservations() {
+        return [...this.observations];
+    }
+    reset() {
+        this.observations.length = 0;
+    }
+    assert(expectation) {
+        const match = this.observations.find((entry) => this.matches(entry, expectation));
+        if (!match) {
+            throw new Error(`Dynamic manifest expectation not met (mode=${expectation.mode ?? "any"}, pageId=${expectation.pageId ?? "any"})`);
+        }
+    }
+    matches(entry, expectation) {
+        if (expectation.mode && entry.mode !== expectation.mode) {
+            return false;
+        }
+        if (expectation.pageId && entry.pageId !== expectation.pageId) {
+            return false;
+        }
+        if (expectation.version && entry.version !== expectation.version) {
+            return false;
+        }
+        return true;
+    }
+    async handleResponse(response) {
+        const url = response.url();
+        if (!this.endpoints.some((pattern) => pattern.test(url))) {
+            return;
+        }
+        const observation = {
+            url,
+            status: response.status(),
+        };
+        try {
+            const payload = await response.json();
+            if (payload && typeof payload === "object") {
+                const data = payload;
+                if (typeof data.mode === "string") {
+                    observation.mode = data.mode;
+                }
+                if (!observation.mode && data.definition && typeof data.definition === "object") {
+                    const def = data.definition;
+                    if (typeof def.kind === "string") {
+                        observation.mode = def.kind;
+                    }
+                }
+                if (typeof data.pageId === "string") {
+                    observation.pageId = data.pageId;
+                }
+                if (typeof data.version === "string") {
+                    observation.version = data.version;
+                }
+            }
+        }
+        catch {
+            // ignore json parsing failures; we still capture url/status
+        }
+        this.observations.push(observation);
+    }
+}

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+export interface HyperTestErrorOptions {
+    cause?: unknown;
+}
+export declare class HyperTestError extends Error {
+    constructor(message: string, options?: HyperTestErrorOptions);
+}
+export declare class SchemaError extends HyperTestError {
+}
+export declare class LaunchError extends HyperTestError {
+}
+export declare class BrowserError extends HyperTestError {
+}
+export declare class AssertionError extends HyperTestError {
+}
+export declare class TimeoutError extends HyperTestError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B;CAOjE;AAED,qBAAa,WAAY,SAAQ,cAAc;CAAG;AAClD,qBAAa,WAAY,SAAQ,cAAc;CAAG;AAClD,qBAAa,YAAa,SAAQ,cAAc;CAAG;AACnD,qBAAa,cAAe,SAAQ,cAAc;CAAG;AACrD,qBAAa,YAAa,SAAQ,cAAc;CAAG"}

package/dist/errors.js

@@ -0,0 +1,19 @@
+export class HyperTestError extends Error {
+    constructor(message, options = {}) {
+        super(message);
+        this.name = new.target.name;
+        if (options.cause !== undefined) {
+            this.cause = options.cause;
+        }
+    }
+}
+export class SchemaError extends HyperTestError {
+}
+export class LaunchError extends HyperTestError {
+}
+export class BrowserError extends HyperTestError {
+}
+export class AssertionError extends HyperTestError {
+}
+export class TimeoutError extends HyperTestError {
+}

package/dist/extensibility/EnvironmentScriptProvider.d.ts

@@ -0,0 +1,21 @@
+export interface EnvironmentScriptDefinition {
+    path: string;
+}
+export interface EnvironmentScriptProvider {
+    getEnvironmentScript(): Promise<EnvironmentScriptDefinition | null>;
+}
+export interface EnvironmentScriptConfig {
+    testing?: {
+        e2e?: {
+            environmentScript?: string;
+        };
+    };
+}
+export declare class ConfigEnvironmentScriptProvider implements EnvironmentScriptProvider {
+    private readonly config;
+    private readonly projectRoot;
+    constructor(config: EnvironmentScriptConfig, projectRoot: string);
+    static fromProjectRoot(projectRoot: string): Promise<ConfigEnvironmentScriptProvider>;
+    getEnvironmentScript(): Promise<EnvironmentScriptDefinition | null>;
+}
+//# sourceMappingURL=EnvironmentScriptProvider.d.ts.map

package/dist/extensibility/EnvironmentScriptProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentScriptProvider.d.ts","sourceRoot":"","sources":["../../src/extensibility/EnvironmentScriptProvider.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,IAAI,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE;YACJ,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,CAAC;CACH;AAED,qBAAa,+BAAgC,YAAW,yBAAyB;IAC/E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM;WAKnD,eAAe,CAAC,WAAW,EAAE,MAAM;IAK1C,oBAAoB,IAAI,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;CAQ1E"}

package/dist/extensibility/EnvironmentScriptProvider.js

@@ -0,0 +1,20 @@
+import { resolve } from "node:path";
+import { loadConfig } from "@tyndall/core";
+export class ConfigEnvironmentScriptProvider {
+    constructor(config, projectRoot) {
+        this.config = config;
+        this.projectRoot = projectRoot;
+    }
+    static async fromProjectRoot(projectRoot) {
+        const config = await loadConfig(projectRoot);
+        return new ConfigEnvironmentScriptProvider(config, projectRoot);
+    }
+    async getEnvironmentScript() {
+        const script = this.config.testing?.e2e?.environmentScript;
+        if (!script) {
+            return null;
+        }
+        // Resolve relative paths from the project root to keep tests deterministic.
+        return { path: resolve(this.projectRoot, script) };
+    }
+}

package/dist/extensibility/ExpectRegistry.d.ts

@@ -0,0 +1,11 @@
+import type { StepContext } from "../steps/types.js";
+export type ExpectHandler = (value: unknown, context: StepContext) => Promise<void>;
+export declare class ExpectRegistry {
+    private readonly handlers;
+    register(name: string, handler: ExpectHandler): void;
+    get(name: string): ExpectHandler | undefined;
+    list(): Map<string, ExpectHandler>;
+}
+export declare const defaultExpectRegistry: ExpectRegistry;
+export declare const registerExpectation: (name: string, handler: ExpectHandler) => void;
+//# sourceMappingURL=ExpectRegistry.d.ts.map

package/dist/extensibility/ExpectRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpectRegistry.d.ts","sourceRoot":"","sources":["../../src/extensibility/ExpectRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;IAI7C,GAAG,CAAC,IAAI,EAAE,MAAM;IAIhB,IAAI;CAGL;AAED,eAAO,MAAM,qBAAqB,gBAAuB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,EAAE,SAAS,aAAa,SAEvE,CAAC"}

package/dist/extensibility/ExpectRegistry.js

@@ -0,0 +1,18 @@
+export class ExpectRegistry {
+    constructor() {
+        this.handlers = new Map();
+    }
+    register(name, handler) {
+        this.handlers.set(name, handler);
+    }
+    get(name) {
+        return this.handlers.get(name);
+    }
+    list() {
+        return new Map(this.handlers);
+    }
+}
+export const defaultExpectRegistry = new ExpectRegistry();
+export const registerExpectation = (name, handler) => {
+    defaultExpectRegistry.register(name, handler);
+};

package/dist/extensibility/StepRegistry.d.ts

@@ -0,0 +1,14 @@
+import type { Step } from "../types/scenario.js";
+import type { StepContext } from "../steps/types.js";
+export type StepHandler = (step: Step, context: StepContext) => Promise<void>;
+export declare class StepRegistry {
+    private readonly handlers;
+    constructor(initial?: Record<string, StepHandler>);
+    register(name: string, handler: StepHandler): void;
+    get(name: string): StepHandler | undefined;
+    list(): Map<string, StepHandler>;
+}
+export declare const createStepRegistry: () => StepRegistry;
+export declare const defaultStepRegistry: StepRegistry;
+export declare const registerStep: (name: string, handler: StepHandler) => void;
+//# sourceMappingURL=StepRegistry.d.ts.map

package/dist/extensibility/StepRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepRegistry.d.ts","sourceRoot":"","sources":["../../src/extensibility/StepRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAE/C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM;IAMrD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAI3C,GAAG,CAAC,IAAI,EAAE,MAAM;IAIhB,IAAI;CAGL;AAED,eAAO,MAAM,kBAAkB,oBAM9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,cAAuB,CAAC;AAExD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,SAAS,WAAW,SAE9D,CAAC"}

package/dist/extensibility/StepRegistry.js

@@ -0,0 +1,29 @@
+import { defaultStepHandlers } from "../steps/index.js";
+export class StepRegistry {
+    constructor(initial = {}) {
+        this.handlers = new Map();
+        for (const [name, handler] of Object.entries(initial)) {
+            this.handlers.set(name, handler);
+        }
+    }
+    register(name, handler) {
+        this.handlers.set(name, handler);
+    }
+    get(name) {
+        return this.handlers.get(name);
+    }
+    list() {
+        return new Map(this.handlers);
+    }
+}
+export const createStepRegistry = () => {
+    const registry = new StepRegistry();
+    for (const [name, handler] of Object.entries(defaultStepHandlers)) {
+        registry.register(name, handler);
+    }
+    return registry;
+};
+export const defaultStepRegistry = createStepRegistry();
+export const registerStep = (name, handler) => {
+    defaultStepRegistry.register(name, handler);
+};

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { ScenarioLoader } from "./scenario/ScenarioLoader.js";
+export { ScenarioValidator, ScenarioValidationError } from "./scenario/ScenarioValidator.js";
+export { AppLauncher, AppLaunchError } from "./app/AppLauncher.js";
+export { AppInstance } from "./app/AppInstance.js";
+export { PlaywrightRunner } from "./runner/PlaywrightRunner.js";
+export { StepExecutor } from "./runner/StepExecutor.js";
+export { ManifestObserver } from "./dynamic/ManifestObserver.js";
+export { ConfigEnvironmentScriptProvider, } from "./extensibility/EnvironmentScriptProvider.js";
+export { defaultStepRegistry, StepRegistry, registerStep, } from "./extensibility/StepRegistry.js";
+export { defaultExpectRegistry, ExpectRegistry, registerExpectation, } from "./extensibility/ExpectRegistry.js";
+export { ResultCollector } from "./reporter/ResultCollector.js";
+export { ConsoleReporter } from "./reporter/ConsoleReporter.js";
+export { JsonReporter } from "./reporter/JsonReporter.js";
+export { HtmlReporter } from "./reporter/HtmlReporter.js";
+export type { Reporter } from "./reporter/Reporter.js";
+export type { EnvironmentScriptDefinition, EnvironmentScriptConfig, EnvironmentScriptProvider, } from "./extensibility/EnvironmentScriptProvider.js";
+export type { ScenarioMode, ScenarioSetup, ScenarioCase, ScenarioDocument, Step, ExpectSpec, DynamicManifestExpectation, NetworkExpectation, } from "./types/scenario.js";
+export type { StepResult, ScenarioResult, AggregatedResult } from "./types/result.js";
+export type { StepContext } from "./steps/index.js";
+export { HyperTestError, SchemaError, LaunchError, BrowserError, AssertionError, TimeoutError, } from "./errors.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,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,+BAA+B,GAChC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtF,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { ScenarioLoader } from "./scenario/ScenarioLoader.js";
+export { ScenarioValidator, ScenarioValidationError } from "./scenario/ScenarioValidator.js";
+export { AppLauncher, AppLaunchError } from "./app/AppLauncher.js";
+export { AppInstance } from "./app/AppInstance.js";
+export { PlaywrightRunner } from "./runner/PlaywrightRunner.js";
+export { StepExecutor } from "./runner/StepExecutor.js";
+export { ManifestObserver } from "./dynamic/ManifestObserver.js";
+export { ConfigEnvironmentScriptProvider, } from "./extensibility/EnvironmentScriptProvider.js";
+export { defaultStepRegistry, StepRegistry, registerStep, } from "./extensibility/StepRegistry.js";
+export { defaultExpectRegistry, ExpectRegistry, registerExpectation, } from "./extensibility/ExpectRegistry.js";
+export { ResultCollector } from "./reporter/ResultCollector.js";
+export { ConsoleReporter } from "./reporter/ConsoleReporter.js";
+export { JsonReporter } from "./reporter/JsonReporter.js";
+export { HtmlReporter } from "./reporter/HtmlReporter.js";
+export { HyperTestError, SchemaError, LaunchError, BrowserError, AssertionError, TimeoutError, } from "./errors.js";

package/dist/reporter/ConsoleReporter.d.ts

@@ -0,0 +1,6 @@
+import type { AggregatedResult } from "../types/result.js";
+import type { Reporter } from "./Reporter.js";
+export declare class ConsoleReporter implements Reporter {
+    report(result: AggregatedResult): Promise<void>;
+}
+//# sourceMappingURL=ConsoleReporter.d.ts.map

package/dist/reporter/ConsoleReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleReporter.d.ts","sourceRoot":"","sources":["../../src/reporter/ConsoleReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,eAAgB,YAAW,QAAQ;IACxC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAatD"}

package/dist/reporter/ConsoleReporter.js

@@ -0,0 +1,13 @@
+export class ConsoleReporter {
+    async report(result) {
+        const lines = [
+            `E2E Report: ${result.name}`,
+            `Status: ${result.status}`,
+            `Scenarios: ${result.scenarios.length}`,
+        ];
+        for (const scenario of result.scenarios) {
+            lines.push(`- ${scenario.scenario.id}: ${scenario.status}`);
+        }
+        console.log(lines.join("\n"));
+    }
+}

package/dist/reporter/HtmlReporter.d.ts

@@ -0,0 +1,11 @@
+import type { AggregatedResult } from "../types/result.js";
+import type { Reporter } from "./Reporter.js";
+export interface HtmlReporterOptions {
+    outputPath?: string;
+}
+export declare class HtmlReporter implements Reporter {
+    private readonly outputPath;
+    constructor(options?: HtmlReporterOptions);
+    report(result: AggregatedResult): Promise<void>;
+}
+//# sourceMappingURL=HtmlReporter.d.ts.map

package/dist/reporter/HtmlReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlReporter.d.ts","sourceRoot":"","sources":["../../src/reporter/HtmlReporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,GAAE,mBAAwB;IAIvC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAgCtD"}