@restormel/testing-browser-playwright 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Allotment Technology Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @restormel/testing-browser-playwright — Playwright-backed browser adapter for Restormel / Testing (MVP).
+ */
+export declare const testingBrowserPlaywrightPackage: "@restormel/testing-browser-playwright";
+export { createPlaywrightTestingSession, PlaywrightTestingSession } from "./playwright-session.js";
+export { resolveLocator } from "./locator.js";
+export { browserTracesToCoreEvents } from "./trace-bridge.js";
+export type { BrowserConsoleLine, BrowserNetworkLine, BrowserSessionTraceEntry, PlaywrightTestingSessionOptions, TestingBrowserSession, TestingLocator, } from "./types.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;;GAEG;AACH,eAAO,MAAM,+BAA+B,EAAG,uCAAgD,CAAC;AAEhG,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @restormel/testing-browser-playwright — Playwright-backed browser adapter for Restormel / Testing (MVP).
+ */
+export const testingBrowserPlaywrightPackage = "@restormel/testing-browser-playwright";
+export { createPlaywrightTestingSession, PlaywrightTestingSession } from "./playwright-session.js";
+export { resolveLocator } from "./locator.js";
+export { browserTracesToCoreEvents } from "./trace-bridge.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;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,uCAAgD,CAAC;AAEhG,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/locator.d.ts

@@ -0,0 +1,4 @@
+import type { Page } from "playwright";
+import type { TestingLocator } from "./types.js";
+export declare function resolveLocator(page: Page, loc: TestingLocator): import("playwright").Locator;
+//# sourceMappingURL=locator.d.ts.map

package/dist/locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../src/locator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,gCAM7D"}

package/dist/locator.js

@@ -0,0 +1,8 @@
+export function resolveLocator(page, loc) {
+    if (loc.kind === "css") {
+        return page.locator(loc.selector);
+    }
+    const { role, name } = loc;
+    return name === undefined ? page.getByRole(role) : page.getByRole(role, { name });
+}
+//# sourceMappingURL=locator.js.map

package/dist/locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../src/locator.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,GAAmB;IAC5D,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IAC3B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/playwright-session.d.ts

@@ -0,0 +1,42 @@
+import type { ArtifactRef } from "@restormel/testing-core";
+import { type Page } from "playwright";
+import type { BrowserConsoleLine, BrowserNetworkLine, BrowserSessionTraceEntry, PlaywrightTestingSessionOptions, TestingBrowserSession, TestingLocator } from "./types.js";
+export declare class PlaywrightTestingSession implements TestingBrowserSession {
+    readonly page: Page;
+    private readonly browser;
+    private readonly context;
+    private readonly defaultTimeoutMs;
+    private readonly consoleLines;
+    private readonly networkLines;
+    private readonly traceBuffer;
+    private disposed;
+    private constructor();
+    static create(options?: PlaywrightTestingSessionOptions): Promise<PlaywrightTestingSession>;
+    private pushTrace;
+    navigate(url: string, options?: {
+        timeoutMs?: number;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle";
+    }): Promise<void>;
+    click(locator: TestingLocator, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    fill(locator: TestingLocator, value: string, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    waitForLoad(state?: "load" | "domcontentloaded" | "networkidle"): Promise<void>;
+    waitForVisible(locator: TestingLocator, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    getVisibleText(locator: TestingLocator): Promise<string>;
+    screenshot(path: string): Promise<ArtifactRef>;
+    getConsoleSnapshot(): readonly BrowserConsoleLine[];
+    getNetworkSnapshot(): readonly BrowserNetworkLine[];
+    drainTraceEntries(): BrowserSessionTraceEntry[];
+    dispose(): Promise<void>;
+    private assertAlive;
+}
+/**
+ * Launch Chromium and return a narrow testing session (one page).
+ */
+export declare function createPlaywrightTestingSession(options?: PlaywrightTestingSessionOptions): Promise<TestingBrowserSession>;
+//# sourceMappingURL=playwright-session.d.ts.map

package/dist/playwright-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-session.d.ts","sourceRoot":"","sources":["../src/playwright-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAA+C,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AAepB,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAE9D,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;WAOM,MAAM,CAAC,OAAO,GAAE,+BAAoC,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgDrG,OAAO,CAAC,SAAS;IASX,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAA;KAAE,GACxF,OAAO,CAAC,IAAI,CAAC;IAUV,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/E,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7F,WAAW,CAAC,KAAK,GAAE,MAAM,GAAG,kBAAkB,GAAG,aAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvF,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOpD,kBAAkB,IAAI,SAAS,kBAAkB,EAAE;IAInD,kBAAkB,IAAI,SAAS,kBAAkB,EAAE;IAInD,iBAAiB,IAAI,wBAAwB,EAAE;IAMzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,OAAO,CAAC,WAAW;CAKpB;AAUD;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,qBAAqB,CAAC,CAEhC"}

package/dist/playwright-session.js

@@ -0,0 +1,175 @@
+import { chromium } from "playwright";
+import { resolveLocator } from "./locator.js";
+const MAX_CONSOLE = 200;
+const MAX_NETWORK = 120;
+const MAX_TEXT_SNIPPET = 2000;
+function nowIso() {
+    return new Date().toISOString();
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max)}…`;
+}
+export class PlaywrightTestingSession {
+    page;
+    browser;
+    context;
+    defaultTimeoutMs;
+    consoleLines = [];
+    networkLines = [];
+    traceBuffer = [];
+    disposed = false;
+    constructor(browser, context, page, defaultTimeoutMs) {
+        this.browser = browser;
+        this.context = context;
+        this.page = page;
+        this.defaultTimeoutMs = defaultTimeoutMs;
+    }
+    static async create(options = {}) {
+        const defaultTimeoutMs = options.timeoutMs ?? 30_000;
+        const browser = await chromium.launch({
+            headless: options.headless ?? true,
+        });
+        const context = await browser.newContext({
+            viewport: options.viewport ?? { width: 1280, height: 720 },
+            ...(options.storageState !== undefined && options.storageState.length > 0
+                ? { storageState: options.storageState }
+                : {}),
+        });
+        const page = await context.newPage();
+        page.setDefaultTimeout(defaultTimeoutMs);
+        page.setDefaultNavigationTimeout(defaultTimeoutMs);
+        const session = new PlaywrightTestingSession(browser, context, page, defaultTimeoutMs);
+        page.on("console", (msg) => {
+            if (session.consoleLines.length >= MAX_CONSOLE) {
+                session.consoleLines.shift();
+            }
+            session.consoleLines.push({
+                type: msg.type(),
+                text: truncate(msg.text(), MAX_TEXT_SNIPPET),
+            });
+        });
+        page.on("requestfinished", async (req) => {
+            if (session.networkLines.length >= MAX_NETWORK) {
+                session.networkLines.shift();
+            }
+            let status = 0;
+            try {
+                const res = await req.response();
+                status = res?.status() ?? 0;
+            }
+            catch {
+                status = 0;
+            }
+            session.networkLines.push({
+                url: truncate(req.url(), 500),
+                method: req.method(),
+                status,
+            });
+        });
+        return session;
+    }
+    pushTrace(kind, summary, metadata) {
+        this.traceBuffer.push({
+            timestamp: nowIso(),
+            kind,
+            summary,
+            metadata,
+        });
+    }
+    async navigate(url, options) {
+        this.assertAlive();
+        const waitUntil = options?.waitUntil ?? "load";
+        await this.page.goto(url, {
+            timeout: options?.timeoutMs ?? this.defaultTimeoutMs,
+            waitUntil,
+        });
+        this.pushTrace("navigation", `navigate ${truncate(url, 300)}`, { waitUntil });
+    }
+    async click(locator, options) {
+        this.assertAlive();
+        const loc = resolveLocator(this.page, locator);
+        const desc = locatorSummary(locator);
+        await loc.click({ timeout: options?.timeoutMs ?? this.defaultTimeoutMs });
+        this.pushTrace("action", `click ${desc}`);
+    }
+    async fill(locator, value, options) {
+        this.assertAlive();
+        const loc = resolveLocator(this.page, locator);
+        const desc = locatorSummary(locator);
+        await loc.fill(value, { timeout: options?.timeoutMs ?? this.defaultTimeoutMs });
+        this.pushTrace("action", `fill ${desc}`, { valueLength: value.length });
+    }
+    async waitForLoad(state = "load") {
+        this.assertAlive();
+        await this.page.waitForLoadState(state);
+        this.pushTrace("action", `waitForLoadState ${state}`);
+    }
+    async waitForVisible(locator, options) {
+        this.assertAlive();
+        const loc = resolveLocator(this.page, locator);
+        await loc.waitFor({ state: "visible", timeout: options?.timeoutMs ?? this.defaultTimeoutMs });
+        this.pushTrace("action", `wait visible ${locatorSummary(locator)}`);
+    }
+    async getVisibleText(locator) {
+        this.assertAlive();
+        const loc = resolveLocator(this.page, locator);
+        const text = await loc.innerText();
+        this.pushTrace("observation", `text ${locatorSummary(locator)}`, { length: text.length });
+        return text;
+    }
+    async screenshot(path) {
+        this.assertAlive();
+        await this.page.screenshot({ path, type: "png", fullPage: false });
+        this.pushTrace("observation", `screenshot ${path}`, { path });
+        return { kind: "screenshot", path, mimeType: "image/png" };
+    }
+    getConsoleSnapshot() {
+        return [...this.consoleLines];
+    }
+    getNetworkSnapshot() {
+        return [...this.networkLines];
+    }
+    drainTraceEntries() {
+        const out = [...this.traceBuffer];
+        this.traceBuffer.length = 0;
+        return out;
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        try {
+            await this.context.close();
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            await this.browser.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    assertAlive() {
+        if (this.disposed) {
+            throw new Error("PlaywrightTestingSession is disposed");
+        }
+    }
+}
+function locatorSummary(loc) {
+    if (loc.kind === "css") {
+        return `css:${truncate(loc.selector, 120)}`;
+    }
+    const name = loc.name === undefined ? "" : typeof loc.name === "string" ? ` "${truncate(loc.name, 80)}"` : " /RegExp/";
+    return `role:${loc.role}${name}`;
+}
+/**
+ * Launch Chromium and return a narrow testing session (one page).
+ */
+export async function createPlaywrightTestingSession(options) {
+    return PlaywrightTestingSession.create(options);
+}
+//# sourceMappingURL=playwright-session.js.map

package/dist/playwright-session.js.map

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

package/dist/trace-bridge.d.ts

@@ -0,0 +1,9 @@
+import type { TraceEvent } from "@restormel/testing-core";
+import type { BrowserSessionTraceEntry } from "./types.js";
+/** Map browser adapter trace lines into core `TraceEvent` records for run reports. */
+export declare function browserTracesToCoreEvents(entries: readonly BrowserSessionTraceEntry[], ctx: {
+    runId: string;
+    goalId: string;
+    startingStepIndex: number;
+}): TraceEvent[];
+//# sourceMappingURL=trace-bridge.d.ts.map

package/dist/trace-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-bridge.d.ts","sourceRoot":"","sources":["../src/trace-bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,sFAAsF;AACtF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,wBAAwB,EAAE,EAC5C,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAChE,UAAU,EAAE,CAWd"}

package/dist/trace-bridge.js

@@ -0,0 +1,15 @@
+import { randomUUID } from "node:crypto";
+/** Map browser adapter trace lines into core `TraceEvent` records for run reports. */
+export function browserTracesToCoreEvents(entries, ctx) {
+    return entries.map((e, i) => ({
+        id: randomUUID(),
+        runId: ctx.runId,
+        goalId: ctx.goalId,
+        stepIndex: ctx.startingStepIndex + i,
+        kind: e.kind,
+        timestamp: e.timestamp,
+        summary: e.summary,
+        metadata: e.metadata,
+    }));
+}
+//# sourceMappingURL=trace-bridge.js.map

package/dist/trace-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-bridge.js","sourceRoot":"","sources":["../src/trace-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,sFAAsF;AACtF,MAAM,UAAU,yBAAyB,CACvC,OAA4C,EAC5C,GAAiE;IAEjE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,EAAE,EAAE,UAAU,EAAE;QAChB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,iBAAiB,GAAG,CAAC;QACpC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+import type { ArtifactRef, TraceEventKind } from "@restormel/testing-core";
+/**
+ * Narrow locators for deterministic tests — not a general Playwright selector DSL.
+ */
+export type TestingLocator = {
+    kind: "css";
+    selector: string;
+} | {
+    kind: "role";
+    role: "button" | "link" | "textbox" | "heading" | "main" | "navigation" | "checkbox" | "radio";
+    name?: string | RegExp;
+};
+export interface BrowserConsoleLine {
+    type: string;
+    text: string;
+}
+export interface BrowserNetworkLine {
+    url: string;
+    method: string;
+    status: number;
+}
+/**
+ * Action-level trace lines for the runner to merge into {@link TraceEvent} (ids/runId/goalId/stepIndex added upstream).
+ */
+export interface BrowserSessionTraceEntry {
+    timestamp: string;
+    kind: TraceEventKind;
+    summary: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PlaywrightTestingSessionOptions {
+    headless?: boolean;
+    /** Default navigation / action timeout (ms). */
+    timeoutMs?: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Path to Playwright `storageState` JSON (saved cookies/localStorage). */
+    storageState?: string;
+}
+/**
+ * Minimal browser surface for Restormel / Testing runners (single page, one context).
+ */
+export interface TestingBrowserSession {
+    readonly page: import("playwright").Page;
+    navigate(url: string, options?: {
+        timeoutMs?: number;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle";
+    }): Promise<void>;
+    click(locator: TestingLocator, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    fill(locator: TestingLocator, value: string, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    waitForLoad(state?: "load" | "domcontentloaded" | "networkidle"): Promise<void>;
+    waitForVisible(locator: TestingLocator, options?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+    getVisibleText(locator: TestingLocator): Promise<string>;
+    /**
+     * Writes PNG to `path` (caller chooses artefact directory). Returns a core {@link ArtifactRef}.
+     */
+    screenshot(path: string): Promise<ArtifactRef>;
+    /** Bounded snapshot (oldest dropped). */
+    getConsoleSnapshot(): readonly BrowserConsoleLine[];
+    /** Bounded snapshot of finished requests (URL, method, status). */
+    getNetworkSnapshot(): readonly BrowserNetworkLine[];
+    /** Drain accumulated trace entries since last drain (or since start if never drained). */
+    drainTraceEntries(): BrowserSessionTraceEntry[];
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjC;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;IAC/F,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,EAAE,IAAI,CAAC;IAEzC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhI,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhF,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/C,yCAAyC;IACzC,kBAAkB,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAEpD,mEAAmE;IACnE,kBAAkB,IAAI,SAAS,kBAAkB,EAAE,CAAC;IAEpD,0FAA0F;IAC1F,iBAAiB,IAAI,wBAAwB,EAAE,CAAC;IAEhD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@restormel/testing-browser-playwright",
+  "version": "0.1.0",
+  "description": "Narrow Playwright session API for Restormel / Testing (launch, navigate, act, observe, artefacts).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Allotment-Technology-Ltd/restormel-testing.git",
+    "directory": "packages/browser-playwright"
+  },
+  "bugs": {
+    "url": "https://github.com/Allotment-Technology-Ltd/restormel-testing/issues"
+  },
+  "homepage": "https://github.com/Allotment-Technology-Ltd/restormel-testing/tree/main/packages/browser-playwright#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "playwright": "^1.49.0",
+    "@restormel/testing-core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.json",
+    "typecheck": "tsc -b tsconfig.json"
+  }
+}