@speqkit/plugin-playwright 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 speqkit contributors
+
+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/README.md

@@ -0,0 +1,101 @@
+# @speqkit/plugin-playwright
+
+Browser steps, scoped `browser` / `context` / `page` resources, and screenshots
+attached as artifacts.
+
+```yaml
+# .speq/speq.yaml
+plugins: [yaml, http, cli, playwright]
+
+playwright:
+  browser: chromium      # chromium | firefox | webkit
+  headless: true
+  baseUrl: https://example.com
+  viewport: { width: 1280, height: 720 }
+```
+
+```yaml
+name: the browser reaches the page
+
+steps:
+  - id: home
+    type: browser.open
+    url: /
+
+  - id: shot
+    type: browser.screenshot
+    name: home.png
+    fullPage: true
+
+assert:
+  - type: title_is
+    expected: Example Domain
+  - type: visible
+    selector: h1
+```
+
+Playwright itself is an **optional peer dependency**, imported the moment a
+browser is first needed. A repository that only runs HTTP smoke checks never
+downloads a browser because this package exists.
+
+```bash
+pnpm add -D playwright && pnpm exec playwright install chromium
+```
+
+## Steps and assertions
+
+| Step | Input | Result |
+| --- | --- | --- |
+| `browser.open` | `url`, `waitUntil?` | `url`, `title`, `status` |
+| `browser.click` | `selector`, `timeout?` | `selector`, `url` |
+| `browser.fill` | `selector`, `value` | `selector`, `value` |
+| `browser.press` | `selector`, `key` | `selector`, `key` |
+| `browser.wait_for` | `selector`, `state?` | `selector` |
+| `browser.text` | `selector` | `text` — readable later as `${id.text}` |
+| `browser.screenshot` | `name?`, `fullPage?` | attaches a PNG |
+
+Assertions: `visible`, `text_contains`, `title_is`, `url_contains`.
+
+## Resources
+
+| Name | Scope | Lifetime |
+| --- | --- | --- |
+| `browser` | `run` | one process for the entire run |
+| `browser.context` | `test` | fresh cookies and storage per test |
+| `page` | `test` | closed when the test ends, pass or fail |
+
+Nothing here manages that lifetime. The plugin *declares* it and the kernel
+acquires lazily, caches per scope and tears down in reverse order — which is
+also why a suite that crashes does not leave browsers running.
+
+## Why this plugin exists
+
+It is the second half of the architecture gate. `@speqkit/plugin-loop` proved
+control flow can live outside the kernel; this one exercises the two parts of
+the spine the loop never touched.
+
+**Scoped resources — passed, no kernel change.** Three scopes, a resource
+depending on a resource, config reaching `setup`, reverse teardown, and an
+assertion reaching for `page` without a step in front of it. All of it was
+already expressible through the published API.
+
+**Binary artifacts — the kernel had to keep a promise it had already made.**
+`ExecContext.attach` was on the contract from day one, but the body went
+nowhere: the event carried a byte count and the bytes were dropped. There was
+nothing to fix in the plugin. What changed is that `path` was added to the
+`artifact.attached` event and the kernel now writes the file — an added field,
+a minor, and `attach(name, body, contentType)` is byte-for-byte the same call.
+
+**Suite scope was declared and never opened.** `ResourceScope` published three
+scopes and the runner opened two, so a `suite` resource failed with "scope is
+not open here". Fixed in the runner; no API change.
+
+## What this plugin still cannot do
+
+**Screenshot on failure.** The obvious feature, and it is not implementable
+from here. A `test:after` hook receives a `HookPayload` with no status on it
+and no way to attach anything, so the plugin cannot see that a test failed or
+hand back the picture proving it. That is a genuine gap in the spine, and the
+fix is a design decision rather than a workaround: either `HookPayload` carries
+the outcome and an attach, or failure capture becomes a step-level concern with
+a `try/catch` step type. It is recorded here instead of being smuggled in.

package/dist/driver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Playwright's surface, described structurally rather than imported.
+ *
+ * The plugin must type-check and install in a repository that has no browsers
+ * anywhere near it — a Go service that only runs HTTP smoke checks should not
+ * pull down 300MB because this package exists in the registry. So `playwright`
+ * is an optional peer dependency, loaded at the moment a browser is first
+ * needed, and the types below are the only coupling at build time.
+ */
+export type BrowserName = 'chromium' | 'firefox' | 'webkit';
+export interface Page {
+    goto(url: string, options?: Record<string, unknown>): Promise<{
+        status(): number;
+    } | null>;
+    title(): Promise<string>;
+    url(): string;
+    click(selector: string, options?: Record<string, unknown>): Promise<void>;
+    fill(selector: string, value: string, options?: Record<string, unknown>): Promise<void>;
+    press(selector: string, key: string, options?: Record<string, unknown>): Promise<void>;
+    textContent(selector: string, options?: Record<string, unknown>): Promise<string | null>;
+    waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;
+    isVisible(selector: string, options?: Record<string, unknown>): Promise<boolean>;
+    screenshot(options?: Record<string, unknown>): Promise<Uint8Array>;
+    close(): Promise<void>;
+}
+export interface BrowserContext {
+    newPage(): Promise<Page>;
+    close(): Promise<void>;
+}
+export interface Browser {
+    newContext(options?: Record<string, unknown>): Promise<BrowserContext>;
+    close(): Promise<void>;
+}
+export interface BrowserType {
+    launch(options?: Record<string, unknown>): Promise<Browser>;
+}
+export declare function loadBrowserType(name: BrowserName): Promise<BrowserType>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,IAAI;IACnB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC1F,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,GAAG,IAAI,MAAM,CAAA;IACb,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACxF,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChF,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AAMD,wBAAsB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB7E"}

package/dist/driver.js

@@ -0,0 +1,29 @@
+/**
+ * Playwright's surface, described structurally rather than imported.
+ *
+ * The plugin must type-check and install in a repository that has no browsers
+ * anywhere near it — a Go service that only runs HTTP smoke checks should not
+ * pull down 300MB because this package exists in the registry. So `playwright`
+ * is an optional peer dependency, loaded at the moment a browser is first
+ * needed, and the types below are the only coupling at build time.
+ */
+const INSTALL_HINT = "@speqkit/plugin-playwright needs the 'playwright' package, which it does not bundle.\n" +
+    '  pnpm add -D playwright && pnpm exec playwright install chromium';
+export async function loadBrowserType(name) {
+    // An indirect specifier on purpose: the module is resolved at run time by
+    // the host project, not at build time by this package.
+    const specifier = 'playwright';
+    let mod;
+    try {
+        mod = (await import(specifier));
+    }
+    catch (err) {
+        throw new Error(`${INSTALL_HINT}\n  (import failed: ${err instanceof Error ? err.message : String(err)})`);
+    }
+    const type = mod[name];
+    if (!type?.launch) {
+        throw new Error(`playwright exposes no browser named '${name}'; expected chromium, firefox or webkit`);
+    }
+    return type;
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgCH,MAAM,YAAY,GAChB,wFAAwF;IACxF,mEAAmE,CAAA;AAErE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAiB;IACrD,0EAA0E;IAC1E,uDAAuD;IACvD,MAAM,SAAS,GAAG,YAAY,CAAA;IAC9B,IAAI,GAA4B,CAAA;IAChC,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAA4B,CAAA;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5G,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAA4B,CAAA;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,yCAAyC,CAAC,CAAA;IACxG,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The second half of the architecture gate.
+ *
+ * `@speqkit/plugin-loop` proved control flow can live outside the kernel. This
+ * one exercises the two parts of the spine it never touched:
+ *
+ *   - scoped resources — a browser that outlives the run, a page that dies
+ *     with the test, torn down in reverse order whatever happens;
+ *   - binary artifacts — a PNG handed to `ctx.attach` and reachable from any
+ *     reporter, including ones that do not exist yet.
+ *
+ * Same rule as the loop plugin: written against the published API only. What
+ * it could not do without a kernel change is recorded in the README rather
+ * than worked around here.
+ */
+declare const _default: import("@speqkit/plugin-api").PluginSpec;
+export default _default;
+//# 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":"AAYA;;;;;;;;;;;;;;GAcG;;AACH,wBA2PE"}

package/dist/index.js

@@ -0,0 +1,241 @@
+import { definePlugin } from '@speqkit/plugin-api';
+import { loadBrowserType } from './driver.js';
+/**
+ * The second half of the architecture gate.
+ *
+ * `@speqkit/plugin-loop` proved control flow can live outside the kernel. This
+ * one exercises the two parts of the spine it never touched:
+ *
+ *   - scoped resources — a browser that outlives the run, a page that dies
+ *     with the test, torn down in reverse order whatever happens;
+ *   - binary artifacts — a PNG handed to `ctx.attach` and reachable from any
+ *     reporter, including ones that do not exist yet.
+ *
+ * Same rule as the loop plugin: written against the published API only. What
+ * it could not do without a kernel change is recorded in the README rather
+ * than worked around here.
+ */
+export default definePlugin({
+    name: '@speqkit/plugin-playwright',
+    configSchema: {
+        type: 'object',
+        properties: {
+            browser: { type: 'string' },
+            headless: { type: 'boolean' },
+            slowMo: { type: 'number' },
+            baseUrl: { type: 'string' },
+            viewport: { type: 'object' },
+            timeoutMs: { type: 'number' }
+        }
+    },
+    setup(ctx) {
+        /* ---------------------------------------------------------------- */
+        /* Resources. Three scopes, three lifetimes, declared not managed.   */
+        /* ---------------------------------------------------------------- */
+        // One browser process for the whole run. Launching it per test is the
+        // single most common reason a UI suite takes twenty minutes.
+        ctx.defineResource('browser', {
+            scope: 'run',
+            async setup(res) {
+                const config = res.config();
+                const type = await loadBrowserType(config.browser ?? 'chromium');
+                return type.launch({
+                    headless: config.headless ?? true,
+                    ...(config.slowMo ? { slowMo: config.slowMo } : {})
+                });
+            },
+            teardown: (browser) => browser.close()
+        });
+        // A fresh context per test is what isolation actually means here:
+        // cookies, storage and permissions start empty every time, and nothing
+        // a test does can leak into the next one.
+        ctx.defineResource('browser.context', {
+            scope: 'test',
+            async setup(res) {
+                const config = res.config();
+                const browser = await res.resource('browser');
+                return browser.newContext({
+                    ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+                    ...(config.viewport ? { viewport: config.viewport } : {})
+                });
+            },
+            teardown: (context) => context.close()
+        });
+        ctx.defineResource('page', {
+            scope: 'test',
+            async setup(res) {
+                const context = await res.resource('browser.context');
+                return context.newPage();
+            },
+            teardown: (page) => page.close()
+        });
+        /* ---------------------------------------------------------------- */
+        /* Steps                                                             */
+        /* ---------------------------------------------------------------- */
+        const selectorSchema = {
+            type: 'object',
+            properties: { selector: { type: 'string' }, timeout: { type: 'number' } },
+            required: ['selector'],
+            additionalProperties: false
+        };
+        ctx.defineStepType('browser.open', {
+            schema: {
+                type: 'object',
+                properties: { url: { type: 'string' }, waitUntil: { type: 'string' } },
+                required: ['url'],
+                additionalProperties: false
+            },
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                const response = await page.goto(String(input.url), {
+                    ...(input.waitUntil ? { waitUntil: input.waitUntil } : {})
+                });
+                return { url: page.url(), title: await page.title(), status: response?.status() ?? null };
+            }
+        });
+        ctx.defineStepType('browser.click', {
+            schema: selectorSchema,
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                await page.click(String(input.selector), timeoutOf(exec.config(), input));
+                return { selector: input.selector, url: page.url() };
+            }
+        });
+        ctx.defineStepType('browser.fill', {
+            schema: {
+                type: 'object',
+                properties: { selector: { type: 'string' }, value: {}, timeout: { type: 'number' } },
+                required: ['selector', 'value'],
+                additionalProperties: false
+            },
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                await page.fill(String(input.selector), String(input.value), timeoutOf(exec.config(), input));
+                return { selector: input.selector, value: input.value };
+            }
+        });
+        ctx.defineStepType('browser.press', {
+            schema: {
+                type: 'object',
+                properties: { selector: { type: 'string' }, key: { type: 'string' }, timeout: { type: 'number' } },
+                required: ['selector', 'key'],
+                additionalProperties: false
+            },
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                await page.press(String(input.selector), String(input.key), timeoutOf(exec.config(), input));
+                return { selector: input.selector, key: input.key };
+            }
+        });
+        ctx.defineStepType('browser.wait_for', {
+            schema: {
+                type: 'object',
+                properties: { selector: { type: 'string' }, state: { type: 'string' }, timeout: { type: 'number' } },
+                required: ['selector'],
+                additionalProperties: false
+            },
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                await page.waitForSelector(String(input.selector), {
+                    ...timeoutOf(exec.config(), input),
+                    ...(input.state ? { state: input.state } : {})
+                });
+                return { selector: input.selector };
+            }
+        });
+        // Reads the page into the variable namespace, so `${title.text}` is
+        // available to every later step exactly like an HTTP body would be.
+        ctx.defineStepType('browser.text', {
+            schema: selectorSchema,
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                const text = await page.textContent(String(input.selector), timeoutOf(exec.config(), input));
+                return { selector: input.selector, text: text ?? '' };
+            }
+        });
+        // The artifact half of the gate: bytes go to `attach` and the kernel is
+        // responsible for them from there. This plugin never learns where they
+        // are written, and no reporter has to be taught about screenshots.
+        ctx.defineStepType('browser.screenshot', {
+            schema: {
+                type: 'object',
+                properties: { name: { type: 'string' }, selector: { type: 'string' }, fullPage: { type: 'boolean' } },
+                additionalProperties: false
+            },
+            async execute(exec, input) {
+                const page = await exec.resource('page');
+                const name = String(input.name ?? 'screenshot.png');
+                const bytes = await page.screenshot({ fullPage: input.fullPage === true });
+                exec.attach(name.endsWith('.png') ? name : `${name}.png`, bytes, 'image/png');
+                return { name, bytes: bytes.byteLength, url: page.url() };
+            }
+        });
+        /* ---------------------------------------------------------------- */
+        /* Assertions                                                        */
+        /* ---------------------------------------------------------------- */
+        // An assertion may reach for a resource too, so `visible` does not need
+        // a step in front of it just to have something to look at.
+        ctx.defineAssertion('visible', {
+            schema: {
+                type: 'object',
+                properties: { selector: { type: 'string' } },
+                required: ['selector'],
+                additionalProperties: false
+            },
+            async evaluate(assert, input) {
+                const page = await assert.resource('page');
+                const selector = String(input.selector);
+                const visible = await page.isVisible(selector);
+                return outcome(visible, `${selector} is not visible`, `${selector} is visible`, true, visible);
+            }
+        });
+        ctx.defineAssertion('text_contains', {
+            schema: {
+                type: 'object',
+                properties: { expected: { type: 'string' } },
+                required: ['expected'],
+                additionalProperties: false
+            },
+            evaluate(assert, input) {
+                const actual = String(assert.last?.text ?? '');
+                const needle = String(input.expected);
+                return outcome(actual.includes(needle), `expected text to contain ${JSON.stringify(needle)}, got ${JSON.stringify(actual.slice(0, 200))}`, `text contains ${JSON.stringify(needle)}`, needle, actual);
+            }
+        });
+        ctx.defineAssertion('title_is', {
+            schema: {
+                type: 'object',
+                properties: { expected: { type: 'string' } },
+                required: ['expected'],
+                additionalProperties: false
+            },
+            async evaluate(assert, input) {
+                const page = await assert.resource('page');
+                const actual = await page.title();
+                return outcome(actual === input.expected, `expected title ${JSON.stringify(input.expected)}, got ${JSON.stringify(actual)}`, `title is ${JSON.stringify(actual)}`, input.expected, actual);
+            }
+        });
+        ctx.defineAssertion('url_contains', {
+            schema: {
+                type: 'object',
+                properties: { expected: { type: 'string' } },
+                required: ['expected'],
+                additionalProperties: false
+            },
+            async evaluate(assert, input) {
+                const page = await assert.resource('page');
+                const actual = page.url();
+                const needle = String(input.expected);
+                return outcome(actual.includes(needle), `expected url to contain ${JSON.stringify(needle)}, got ${JSON.stringify(actual)}`, `url is ${actual}`, needle, actual);
+            }
+        });
+    }
+});
+function timeoutOf(config, input) {
+    const timeout = typeof input.timeout === 'number' ? input.timeout : config.timeoutMs;
+    return timeout === undefined ? {} : { timeout };
+}
+function outcome(passed, whenFailed, whenPassed, expected, actual) {
+    return { passed, message: passed ? whenPassed : whenFailed, expected, actual };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@speqkit/plugin-playwright",
+  "version": "0.1.0",
+  "description": "Browser steps, scoped browser/context/page resources and screenshot artifacts.",
+  "license": "MIT",
+  "author": "Stepan Kaziatko",
+  "homepage": "https://github.com/speqkit/speqkit#readme",
+  "bugs": "https://github.com/speqkit/speqkit/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/speqkit/speqkit.git",
+    "directory": "packages/plugin-playwright"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "speqkit-plugin"
+  ],
+  "peerDependencies": {
+    "playwright": ">=1.40",
+    "@speqkit/plugin-api": "^0.4.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@speqkit/plugin-api": "0.4.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/driver.ts

@@ -0,0 +1,61 @@
+/**
+ * Playwright's surface, described structurally rather than imported.
+ *
+ * The plugin must type-check and install in a repository that has no browsers
+ * anywhere near it — a Go service that only runs HTTP smoke checks should not
+ * pull down 300MB because this package exists in the registry. So `playwright`
+ * is an optional peer dependency, loaded at the moment a browser is first
+ * needed, and the types below are the only coupling at build time.
+ */
+
+export type BrowserName = 'chromium' | 'firefox' | 'webkit'
+
+export interface Page {
+  goto(url: string, options?: Record<string, unknown>): Promise<{ status(): number } | null>
+  title(): Promise<string>
+  url(): string
+  click(selector: string, options?: Record<string, unknown>): Promise<void>
+  fill(selector: string, value: string, options?: Record<string, unknown>): Promise<void>
+  press(selector: string, key: string, options?: Record<string, unknown>): Promise<void>
+  textContent(selector: string, options?: Record<string, unknown>): Promise<string | null>
+  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>
+  isVisible(selector: string, options?: Record<string, unknown>): Promise<boolean>
+  screenshot(options?: Record<string, unknown>): Promise<Uint8Array>
+  close(): Promise<void>
+}
+
+export interface BrowserContext {
+  newPage(): Promise<Page>
+  close(): Promise<void>
+}
+
+export interface Browser {
+  newContext(options?: Record<string, unknown>): Promise<BrowserContext>
+  close(): Promise<void>
+}
+
+export interface BrowserType {
+  launch(options?: Record<string, unknown>): Promise<Browser>
+}
+
+const INSTALL_HINT =
+  "@speqkit/plugin-playwright needs the 'playwright' package, which it does not bundle.\n" +
+  '  pnpm add -D playwright && pnpm exec playwright install chromium'
+
+export async function loadBrowserType(name: BrowserName): Promise<BrowserType> {
+  // An indirect specifier on purpose: the module is resolved at run time by
+  // the host project, not at build time by this package.
+  const specifier = 'playwright'
+  let mod: Record<string, unknown>
+  try {
+    mod = (await import(specifier)) as Record<string, unknown>
+  } catch (err) {
+    throw new Error(`${INSTALL_HINT}\n  (import failed: ${err instanceof Error ? err.message : String(err)})`)
+  }
+
+  const type = mod[name] as BrowserType | undefined
+  if (!type?.launch) {
+    throw new Error(`playwright exposes no browser named '${name}'; expected chromium, firefox or webkit`)
+  }
+  return type
+}

package/src/index.ts

@@ -0,0 +1,290 @@
+import { definePlugin, type AssertOutcome, type InputSchema } from '@speqkit/plugin-api'
+import { loadBrowserType, type Browser, type BrowserContext, type BrowserName, type Page } from './driver.js'
+
+interface PlaywrightConfig {
+  browser?: BrowserName
+  headless?: boolean
+  slowMo?: number
+  baseUrl?: string
+  viewport?: { width: number; height: number }
+  timeoutMs?: number
+}
+
+/**
+ * The second half of the architecture gate.
+ *
+ * `@speqkit/plugin-loop` proved control flow can live outside the kernel. This
+ * one exercises the two parts of the spine it never touched:
+ *
+ *   - scoped resources — a browser that outlives the run, a page that dies
+ *     with the test, torn down in reverse order whatever happens;
+ *   - binary artifacts — a PNG handed to `ctx.attach` and reachable from any
+ *     reporter, including ones that do not exist yet.
+ *
+ * Same rule as the loop plugin: written against the published API only. What
+ * it could not do without a kernel change is recorded in the README rather
+ * than worked around here.
+ */
+export default definePlugin({
+  name: '@speqkit/plugin-playwright',
+  configSchema: {
+    type: 'object',
+    properties: {
+      browser: { type: 'string' },
+      headless: { type: 'boolean' },
+      slowMo: { type: 'number' },
+      baseUrl: { type: 'string' },
+      viewport: { type: 'object' },
+      timeoutMs: { type: 'number' }
+    }
+  },
+
+  setup(ctx) {
+    /* ---------------------------------------------------------------- */
+    /* Resources. Three scopes, three lifetimes, declared not managed.   */
+    /* ---------------------------------------------------------------- */
+
+    // One browser process for the whole run. Launching it per test is the
+    // single most common reason a UI suite takes twenty minutes.
+    ctx.defineResource<Browser>('browser', {
+      scope: 'run',
+      async setup(res) {
+        const config = res.config<PlaywrightConfig>()
+        const type = await loadBrowserType(config.browser ?? 'chromium')
+        return type.launch({
+          headless: config.headless ?? true,
+          ...(config.slowMo ? { slowMo: config.slowMo } : {})
+        })
+      },
+      teardown: (browser) => browser.close()
+    })
+
+    // A fresh context per test is what isolation actually means here:
+    // cookies, storage and permissions start empty every time, and nothing
+    // a test does can leak into the next one.
+    ctx.defineResource<BrowserContext>('browser.context', {
+      scope: 'test',
+      async setup(res) {
+        const config = res.config<PlaywrightConfig>()
+        const browser = await res.resource<Browser>('browser')
+        return browser.newContext({
+          ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+          ...(config.viewport ? { viewport: config.viewport } : {})
+        })
+      },
+      teardown: (context) => context.close()
+    })
+
+    ctx.defineResource<Page>('page', {
+      scope: 'test',
+      async setup(res) {
+        const context = await res.resource<BrowserContext>('browser.context')
+        return context.newPage()
+      },
+      teardown: (page) => page.close()
+    })
+
+    /* ---------------------------------------------------------------- */
+    /* Steps                                                             */
+    /* ---------------------------------------------------------------- */
+
+    const selectorSchema: InputSchema = {
+      type: 'object',
+      properties: { selector: { type: 'string' }, timeout: { type: 'number' } },
+      required: ['selector'],
+      additionalProperties: false
+    }
+
+    ctx.defineStepType('browser.open', {
+      schema: {
+        type: 'object',
+        properties: { url: { type: 'string' }, waitUntil: { type: 'string' } },
+        required: ['url'],
+        additionalProperties: false
+      },
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        const response = await page.goto(String(input.url), {
+          ...(input.waitUntil ? { waitUntil: input.waitUntil } : {})
+        })
+        return { url: page.url(), title: await page.title(), status: response?.status() ?? null }
+      }
+    })
+
+    ctx.defineStepType('browser.click', {
+      schema: selectorSchema,
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        await page.click(String(input.selector), timeoutOf(exec.config<PlaywrightConfig>(), input))
+        return { selector: input.selector, url: page.url() }
+      }
+    })
+
+    ctx.defineStepType('browser.fill', {
+      schema: {
+        type: 'object',
+        properties: { selector: { type: 'string' }, value: {}, timeout: { type: 'number' } },
+        required: ['selector', 'value'],
+        additionalProperties: false
+      },
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        await page.fill(String(input.selector), String(input.value), timeoutOf(exec.config<PlaywrightConfig>(), input))
+        return { selector: input.selector, value: input.value }
+      }
+    })
+
+    ctx.defineStepType('browser.press', {
+      schema: {
+        type: 'object',
+        properties: { selector: { type: 'string' }, key: { type: 'string' }, timeout: { type: 'number' } },
+        required: ['selector', 'key'],
+        additionalProperties: false
+      },
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        await page.press(String(input.selector), String(input.key), timeoutOf(exec.config<PlaywrightConfig>(), input))
+        return { selector: input.selector, key: input.key }
+      }
+    })
+
+    ctx.defineStepType('browser.wait_for', {
+      schema: {
+        type: 'object',
+        properties: { selector: { type: 'string' }, state: { type: 'string' }, timeout: { type: 'number' } },
+        required: ['selector'],
+        additionalProperties: false
+      },
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        await page.waitForSelector(String(input.selector), {
+          ...timeoutOf(exec.config<PlaywrightConfig>(), input),
+          ...(input.state ? { state: input.state } : {})
+        })
+        return { selector: input.selector }
+      }
+    })
+
+    // Reads the page into the variable namespace, so `${title.text}` is
+    // available to every later step exactly like an HTTP body would be.
+    ctx.defineStepType('browser.text', {
+      schema: selectorSchema,
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        const text = await page.textContent(String(input.selector), timeoutOf(exec.config<PlaywrightConfig>(), input))
+        return { selector: input.selector, text: text ?? '' }
+      }
+    })
+
+    // The artifact half of the gate: bytes go to `attach` and the kernel is
+    // responsible for them from there. This plugin never learns where they
+    // are written, and no reporter has to be taught about screenshots.
+    ctx.defineStepType('browser.screenshot', {
+      schema: {
+        type: 'object',
+        properties: { name: { type: 'string' }, selector: { type: 'string' }, fullPage: { type: 'boolean' } },
+        additionalProperties: false
+      },
+      async execute(exec, input) {
+        const page = await exec.resource<Page>('page')
+        const name = String(input.name ?? 'screenshot.png')
+        const bytes = await page.screenshot({ fullPage: input.fullPage === true })
+        exec.attach(name.endsWith('.png') ? name : `${name}.png`, bytes, 'image/png')
+        return { name, bytes: bytes.byteLength, url: page.url() }
+      }
+    })
+
+    /* ---------------------------------------------------------------- */
+    /* Assertions                                                        */
+    /* ---------------------------------------------------------------- */
+
+    // An assertion may reach for a resource too, so `visible` does not need
+    // a step in front of it just to have something to look at.
+    ctx.defineAssertion('visible', {
+      schema: {
+        type: 'object',
+        properties: { selector: { type: 'string' } },
+        required: ['selector'],
+        additionalProperties: false
+      },
+      async evaluate(assert, input) {
+        const page = await assert.resource<Page>('page')
+        const selector = String(input.selector)
+        const visible = await page.isVisible(selector)
+        return outcome(visible, `${selector} is not visible`, `${selector} is visible`, true, visible)
+      }
+    })
+
+    ctx.defineAssertion('text_contains', {
+      schema: {
+        type: 'object',
+        properties: { expected: { type: 'string' } },
+        required: ['expected'],
+        additionalProperties: false
+      },
+      evaluate(assert, input) {
+        const actual = String(assert.last?.text ?? '')
+        const needle = String(input.expected)
+        return outcome(
+          actual.includes(needle),
+          `expected text to contain ${JSON.stringify(needle)}, got ${JSON.stringify(actual.slice(0, 200))}`,
+          `text contains ${JSON.stringify(needle)}`,
+          needle,
+          actual
+        )
+      }
+    })
+
+    ctx.defineAssertion('title_is', {
+      schema: {
+        type: 'object',
+        properties: { expected: { type: 'string' } },
+        required: ['expected'],
+        additionalProperties: false
+      },
+      async evaluate(assert, input) {
+        const page = await assert.resource<Page>('page')
+        const actual = await page.title()
+        return outcome(
+          actual === input.expected,
+          `expected title ${JSON.stringify(input.expected)}, got ${JSON.stringify(actual)}`,
+          `title is ${JSON.stringify(actual)}`,
+          input.expected,
+          actual
+        )
+      }
+    })
+
+    ctx.defineAssertion('url_contains', {
+      schema: {
+        type: 'object',
+        properties: { expected: { type: 'string' } },
+        required: ['expected'],
+        additionalProperties: false
+      },
+      async evaluate(assert, input) {
+        const page = await assert.resource<Page>('page')
+        const actual = page.url()
+        const needle = String(input.expected)
+        return outcome(
+          actual.includes(needle),
+          `expected url to contain ${JSON.stringify(needle)}, got ${JSON.stringify(actual)}`,
+          `url is ${actual}`,
+          needle,
+          actual
+        )
+      }
+    })
+  }
+})
+
+function timeoutOf(config: PlaywrightConfig, input: Record<string, unknown>): { timeout?: number } {
+  const timeout = typeof input.timeout === 'number' ? input.timeout : config.timeoutMs
+  return timeout === undefined ? {} : { timeout }
+}
+
+function outcome(
+  passed: boolean, whenFailed: string, whenPassed: string, expected?: unknown, actual?: unknown
+): AssertOutcome {
+  return { passed, message: passed ? whenPassed : whenFailed, expected, actual }
+}