@molecule/app-e2e-fixtures-default 1.0.0 → 1.0.2

package/dist/console-guard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The console-error guard fixture: every test subscribes to the page's
+ * `pageerror` and `console.error` events and fails at teardown if any were
+ * seen. It works over both bonds — the preview client forwards console output
+ * and errors, so the guard sees the same events a real browser emits.
+ *
+ * @module
+ */
+import type { PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, TestType } from '@playwright/test';
+type BaseTest = TestType<PlaywrightTestArgs & PlaywrightTestOptions, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;
+/** One captured browser error. */
+export interface ConsoleErrorEntry {
+    type: 'pageerror' | 'console.error';
+    text: string;
+    location?: string;
+}
+/**
+ * Substrings that are always ignored — browser noise that doesn't reflect app
+ * bugs.
+ */
+export declare const ALWAYS_IGNORE: readonly RegExp[];
+/** The fixture object `withConsoleGuard` adds to a test. */
+export interface ConsoleGuardFixtures {
+    consoleGuard: void;
+}
+/**
+ * Extend a Playwright `test` with the auto-attached console-error guard.
+ *
+ * To intentionally let a known error through (rare — almost always a smell
+ * that should be fixed in the app), use
+ * `test.info().annotations.push({ type: 'allow-console-error', description: 'why' })`
+ * inside the test body BEFORE the error fires. The `description` is matched
+ * against the error text as a regular expression; if it is not a valid regex
+ * it is matched as a plain substring instead. An annotation with no
+ * description allows every error — always provide one.
+ */
+export declare const withConsoleGuard: (base: BaseTest) => TestType<PlaywrightTestArgs & PlaywrightTestOptions & ConsoleGuardFixtures, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;
+export {};
+//# sourceMappingURL=console-guard.d.ts.map

package/dist/console-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-guard.d.ts","sourceRoot":"","sources":["../src/console-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACT,MAAM,kBAAkB,CAAA;AAEzB,KAAK,QAAQ,GAAG,QAAQ,CACtB,kBAAkB,GAAG,qBAAqB,EAC1C,oBAAoB,GAAG,uBAAuB,CAC/C,CAAA;AAED,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EA6B1C,CAAA;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,IAAI,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,QAAQ,KACb,QAAQ,CACT,kBAAkB,GAAG,qBAAqB,GAAG,oBAAoB,EACjE,oBAAoB,GAAG,uBAAuB,CAiE5C,CAAA"}

package/dist/console-guard.js

@@ -0,0 +1,117 @@
+/**
+ * The console-error guard fixture: every test subscribes to the page's
+ * `pageerror` and `console.error` events and fails at teardown if any were
+ * seen. It works over both bonds — the preview client forwards console output
+ * and errors, so the guard sees the same events a real browser emits.
+ *
+ * @module
+ */
+/**
+ * Substrings that are always ignored — browser noise that doesn't reflect app
+ * bugs.
+ */
+export const ALWAYS_IGNORE = [
+    // Vite HMR dev-only websocket reconnect warnings — happen on the
+    // test runner's first poll before vite is fully booted; harmless.
+    /\[vite\].*connecting/i,
+    /\[vite\].*server connection lost/i,
+    // Service worker registration failures in headless Chrome — VitePWA
+    // tries to register at /sw.js but our smoke build emits to /workbox-*
+    // and Playwright fixtures the user-agent. Cosmetic.
+    /service worker.*404/i,
+    // Chrome DevTools' own probe for source maps on third-party CDN bundles
+    // we don't ship maps for (Stripe, Google Maps, etc). Two bugs fixed here,
+    // both verified against a headless Chromium probe + the real reported
+    // message text (not guessed): (1) the verb was wrong — real Chrome output
+    // is "DevTools failed to load SourceMap: Could not load content for
+    // <url>: ...", not "failed to fetch source map", so the old pattern never
+    // matched real Chrome text at all; (2) the host check (`.cdn.`) doesn't
+    // match real vendor hosts (js.stripe.com, maps.googleapis.com contain no
+    // '.cdn.' substring). Now matches any `https://`-hosted source map
+    // (third-party CDN bundles are always TLS; the app's own dev/preview
+    // server is plain `http://localhost`, so same-origin source-map issues
+    // are never accidentally silenced by this pattern).
+    // NOTE (verified, not assumed): a probe with a broken `sourceMappingURL`
+    // produced ZERO console messages via `page.on('console')` under plain
+    // Playwright automation (with and without tracing) — Chrome only fetches
+    // source maps when a DevTools Sources panel is actually attached, which a
+    // headless Playwright run never does. So this entry currently matches
+    // nothing observed in practice; it is defense-in-depth against a future
+    // Chrome/Playwright behavior change, not an active filter today.
+    /devtools failed to load source ?map.*https:\/\//i,
+];
+/**
+ * Extend a Playwright `test` with the auto-attached console-error guard.
+ *
+ * To intentionally let a known error through (rare — almost always a smell
+ * that should be fixed in the app), use
+ * `test.info().annotations.push({ type: 'allow-console-error', description: 'why' })`
+ * inside the test body BEFORE the error fires. The `description` is matched
+ * against the error text as a regular expression; if it is not a valid regex
+ * it is matched as a plain substring instead. An annotation with no
+ * description allows every error — always provide one.
+ */
+export const withConsoleGuard = (base) => base.extend({
+    consoleGuard: [
+        async ({ page }, use, testInfo) => {
+            const buffer = [];
+            const matchesAllowed = (text, description) => {
+                if (description === undefined)
+                    return true; // no description = allow everything
+                try {
+                    return new RegExp(description).test(text);
+                }
+                catch (_error) {
+                    // Not a valid regex: the annotation holds literal error text — match it as a substring.
+                    return text.includes(description);
+                }
+            };
+            const shouldIgnore = (text) => {
+                if (ALWAYS_IGNORE.some((re) => re.test(text)))
+                    return true;
+                return testInfo.annotations
+                    .filter((a) => a.type === 'allow-console-error')
+                    .some((a) => matchesAllowed(text, a.description));
+            };
+            const onPageError = (err) => {
+                const text = err.message || String(err);
+                if (shouldIgnore(text))
+                    return;
+                buffer.push({ type: 'pageerror', text });
+            };
+            const onConsole = (msg) => {
+                if (msg.type() !== 'error')
+                    return;
+                const text = msg.text();
+                if (shouldIgnore(text))
+                    return;
+                const loc = msg.location();
+                buffer.push({
+                    type: 'console.error',
+                    text,
+                    location: loc?.url ? `${loc.url}:${loc.lineNumber}` : undefined,
+                });
+            };
+            page.on('pageerror', onPageError);
+            page.on('console', onConsole);
+            try {
+                await use();
+            }
+            finally {
+                page.off('pageerror', onPageError);
+                page.off('console', onConsole);
+            }
+            if (buffer.length > 0) {
+                const lines = buffer
+                    .map((e) => `  - [${e.type}] ${e.text}${e.location ? `  (${e.location})` : ''}`)
+                    .join('\n');
+                throw new Error(`Browser console error(s) during test (${buffer.length}):\n${lines}\n\n` +
+                    `If this error is genuinely expected, add\n` +
+                    `  test.info().annotations.push({ type: 'allow-console-error', description: '<regex>' })\n` +
+                    `to the test body BEFORE the error fires.`);
+            }
+        },
+        { auto: true },
+    ],
+});
+//# sourceMappingURL=console-guard.js.map

package/dist/console-guard.js.map

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

package/dist/expect.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `expect` that routes locators and pages built by {@link createEvaluatePage}
+ * to polling matchers of their own, and everything else — values, real
+ * Playwright locators — to Playwright's `expect` untouched.
+ *
+ * @module
+ */
+import { expect as playwrightExpect } from '@playwright/test';
+type AnyExpect = typeof playwrightExpect;
+/**
+ * Playwright's `expect`, plus polling matchers for pages and locators built
+ * over the preview. `expect(value)`, `expect.soft`, `expect.poll`,
+ * `expect.configure` and the asymmetric matchers behave exactly as in
+ * Playwright.
+ */
+export declare const expect: AnyExpect;
+export {};
+//# sourceMappingURL=expect.d.ts.map

package/dist/expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../src/expect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,gBAAgB,EAA0B,MAAM,kBAAkB,CAAA;AAqWrF,KAAK,SAAS,GAAG,OAAO,gBAAgB,CAAA;AAuCxC;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,SAAsC,CAAA"}

package/dist/expect.js

@@ -0,0 +1,233 @@
+/**
+ * `expect` that routes locators and pages built by {@link createEvaluatePage}
+ * to polling matchers of their own, and everything else — values, real
+ * Playwright locators — to Playwright's `expect` untouched.
+ *
+ * @module
+ */
+import { expect as playwrightExpect, test as playwrightTest } from '@playwright/test';
+import { E2EStrictModeError } from '@molecule/app-e2e';
+import { isE2ELocator, isE2EPage, textMatch, textMatchFull, } from './page.js';
+const DEFAULT_TIMEOUT = 5_000;
+const pretty = (value) => typeof value === 'string' ? JSON.stringify(value) : (JSON.stringify(value) ?? String(value));
+const expectationText = (expected) => {
+    if (expected instanceof RegExp)
+        return String(expected);
+    if (Array.isArray(expected))
+        return JSON.stringify(expected.map((e) => (e instanceof RegExp ? String(e) : e)));
+    return pretty(expected);
+};
+const failure = (subject, matcher, describeSubject, expected, received, timeout, negate, message) => {
+    const lines = [
+        `${message ?? `expect(${subject}).${negate ? 'not.' : ''}${matcher}() failed`}`,
+        '',
+        `${subject === 'page' ? 'Page' : 'Locator'}: ${describeSubject}`,
+        `Expected: ${negate ? 'not ' : ''}${expected}`,
+        `Received: ${pretty(received)}`,
+        `Timeout: ${timeout}ms`,
+    ];
+    const err = new Error(lines.join('\n'));
+    err.name = 'Error';
+    return err;
+};
+const record = (soft, err) => {
+    if (!soft)
+        throw err;
+    let info;
+    try {
+        info = playwrightTest.info();
+    }
+    catch (_error) {
+        info = null;
+    }
+    if (info && typeof info._failWithError === 'function')
+        info._failWithError(err);
+    else
+        throw err;
+};
+const toMatchArg = (expected, full, opts) => Array.isArray(expected)
+    ? expected.map((e) => (full ? textMatchFull(e, opts) : textMatch(e, opts)))
+    : full
+        ? textMatchFull(expected, opts)
+        : textMatch(expected, opts);
+const locatorMatchers = (locator, defaults, negate = false) => {
+    const run = async (matcher, args, expected, opts) => {
+        const timeout = opts?.timeout ?? defaults.timeout ?? DEFAULT_TIMEOUT;
+        const deadline = Date.now() + timeout;
+        let last;
+        let delay = 100;
+        for (;;) {
+            const res = await locator.probe(matcher, args);
+            if (res.strict) {
+                record(!!defaults.soft, new E2EStrictModeError(locator.describe(), Number(res.count)));
+                return;
+            }
+            if (res.error) {
+                record(!!defaults.soft, new Error(`expect(locator).${matcher}(): ${String(res.error)}`));
+                return;
+            }
+            last = res.received;
+            if (Boolean(res.pass) !== negate)
+                return;
+            if (Date.now() > deadline) {
+                record(!!defaults.soft, failure('locator', matcher, locator.describe(), expected, last, timeout, negate, defaults.message));
+                return;
+            }
+            await new Promise((r) => setTimeout(r, delay));
+            delay = Math.min(delay * 2, 500);
+        }
+    };
+    const timeoutOf = (opts) => opts && typeof opts.timeout === 'number' ? { timeout: opts.timeout } : undefined;
+    const matchers = {
+        toBeVisible: (opts) => run('toBeVisible', {}, 'visible', timeoutOf(opts)),
+        toBeHidden: (opts) => run('toBeHidden', {}, 'hidden', timeoutOf(opts)),
+        toBeAttached: (opts) => run('toBeAttached', {}, 'attached', timeoutOf(opts)),
+        toHaveCount: (n, opts) => run('toHaveCount', { n }, String(n), timeoutOf(opts)),
+        toHaveText: (expected, opts) => run('toHaveText', {
+            expected: toMatchArg(expected, true, {
+                ignoreCase: opts?.ignoreCase,
+            }),
+            useInnerText: opts?.useInnerText,
+        }, expectationText(expected), timeoutOf(opts)),
+        toContainText: (expected, opts) => run('toContainText', {
+            expected: toMatchArg(expected, false, {
+                ignoreCase: opts?.ignoreCase,
+            }),
+            useInnerText: opts?.useInnerText,
+        }, `containing ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveAttribute: (name, expected, opts) => {
+            const valueGiven = expected !== undefined && !(typeof expected === 'object' && !(expected instanceof RegExp));
+            const options = (valueGiven ? opts : expected) ?? {};
+            return run('toHaveAttribute', {
+                name,
+                expected: valueGiven
+                    ? textMatchFull(expected, {
+                        ignoreCase: options.ignoreCase,
+                    })
+                    : undefined,
+            }, valueGiven ? `${name}=${expectationText(expected)}` : `attribute ${name}`, timeoutOf(options));
+        },
+        toHaveClass: (expected, opts) => run('toHaveClass', { expected: toMatchArg(expected, true) }, `class ${expectationText(expected)}`, timeoutOf(opts)),
+        toContainClass: (expected, opts) => run('toContainClass', { expected }, `classes ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveCSS: (name, expected, opts) => run('toHaveCSS', { name, expected: textMatchFull(expected) }, `${name}: ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveValue: (expected, opts) => run('toHaveValue', { expected: textMatchFull(expected) }, `value ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveValues: (expected, opts) => run('toHaveValues', { expected: toMatchArg(expected, true) }, `values ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveId: (expected, opts) => run('toHaveId', { expected: textMatchFull(expected) }, `id ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveJSProperty: (name, expected, opts) => run('toHaveJSProperty', { name, expected }, `${name} = ${expectationText(expected)}`, timeoutOf(opts)),
+        toBeChecked: (opts) => run('toBeChecked', { checked: opts?.checked }, opts?.checked === false ? 'unchecked' : 'checked', timeoutOf(opts)),
+        toBeEnabled: (opts) => run('toBeEnabled', {}, 'enabled', timeoutOf(opts)),
+        toBeDisabled: (opts) => run('toBeDisabled', {}, 'disabled', timeoutOf(opts)),
+        toBeEditable: (opts) => run('toBeEditable', {}, 'editable', timeoutOf(opts)),
+        toBeEmpty: (opts) => run('toBeEmpty', {}, 'empty', timeoutOf(opts)),
+        toBeFocused: (opts) => run('toBeFocused', {}, 'focused', timeoutOf(opts)),
+        toBeInViewport: (opts) => run('toBeInViewport', { ratio: opts?.ratio }, 'in viewport', timeoutOf(opts)),
+        toHaveAccessibleName: (expected, opts) => run('toHaveAccessibleName', {
+            expected: textMatchFull(expected, {
+                ignoreCase: opts?.ignoreCase,
+            }),
+        }, `accessible name ${expectationText(expected)}`, timeoutOf(opts)),
+        toHaveRole: (expected, opts) => run('toHaveRole', { expected }, `role ${expectationText(expected)}`, timeoutOf(opts)),
+    };
+    if (!negate)
+        matchers.not = locatorMatchers(locator, defaults, true);
+    return new Proxy(matchers, {
+        get(target, prop) {
+            if (typeof prop === 'symbol' || prop in target)
+                return target[prop];
+            if (prop === 'then')
+                return undefined;
+            return () => {
+                throw new Error(`expect(locator).${String(prop)}() is not supported by the e2e core over the preview. Supported: ${Object.keys(matchers)
+                    .filter((k) => k !== 'not')
+                    .join(', ')}. For anything else read the value (textContent, boundingBox, evaluate) and assert on it.`);
+            };
+        },
+    });
+};
+const pageMatchers = (page, defaults, negate = false) => {
+    const poll = async (matcher, expected, describe, read, test, opts) => {
+        const timeout = opts?.timeout ?? defaults.timeout ?? DEFAULT_TIMEOUT;
+        const deadline = Date.now() + timeout;
+        let last;
+        for (;;) {
+            last = await read();
+            if (test(last) !== negate)
+                return;
+            if (Date.now() > deadline) {
+                record(!!defaults.soft, failure('page', matcher, describe, expectationText(expected), last, timeout, negate, defaults.message));
+                return;
+            }
+            await new Promise((r) => setTimeout(r, 100));
+        }
+    };
+    const matchers = {
+        toHaveTitle: (expected, opts) => poll('toHaveTitle', expected, page.url(), () => page.title(), (t) => expected instanceof RegExp
+            ? expected.test(t)
+            : t.replace(/\s+/g, ' ').trim() === expected.replace(/\s+/g, ' ').trim(), opts),
+        toHaveURL: (expected, opts) => poll('toHaveURL', expected, page.url(), async () => String((await page.rt('info', [])).url ?? page.url()), (current) => {
+            if (expected instanceof RegExp)
+                return expected.test(current);
+            if (/^[a-z]+:/i.test(expected))
+                return (current === expected || current.replace(/\/$/, '') === expected.replace(/\/$/, ''));
+            const u = new URL(current);
+            const path = u.pathname + u.search + u.hash;
+            return (path === expected ||
+                u.pathname === expected ||
+                u.pathname.replace(/\/$/, '') === expected.replace(/\/$/, ''));
+        }, opts),
+    };
+    if (!negate)
+        matchers.not = pageMatchers(page, defaults, true);
+    return new Proxy(matchers, {
+        get(target, prop) {
+            if (typeof prop === 'symbol' || prop in target)
+                return target[prop];
+            if (prop === 'then')
+                return undefined;
+            return () => {
+                throw new Error(`expect(page).${String(prop)}() is not supported over the preview. Supported: toHaveTitle, toHaveURL. Screenshots need a real browser; assert layout with locator.boundingBox() and page.evaluate().`);
+            };
+        },
+    });
+};
+const wrap = (base, defaults) => new Proxy(base, {
+    apply(target, thisArg, args) {
+        const [actual, messageOrOptions] = args;
+        const message = typeof messageOrOptions === 'string'
+            ? messageOrOptions
+            : messageOrOptions?.message;
+        if (isE2ELocator(actual))
+            return locatorMatchers(actual, { ...defaults, message: message ?? defaults.message });
+        if (isE2EPage(actual))
+            return pageMatchers(actual, { ...defaults, message: message ?? defaults.message });
+        return Reflect.apply(target, thisArg, args);
+    },
+    get(target, prop, receiver) {
+        if (prop === 'soft') {
+            const soft = Reflect.get(target, prop, receiver);
+            return (actual, messageOrOptions) => {
+                const message = typeof messageOrOptions === 'string'
+                    ? messageOrOptions
+                    : messageOrOptions?.message;
+                if (isE2ELocator(actual))
+                    return locatorMatchers(actual, { ...defaults, soft: true, message });
+                if (isE2EPage(actual))
+                    return pageMatchers(actual, { ...defaults, soft: true, message });
+                return soft(actual, messageOrOptions);
+            };
+        }
+        if (prop === 'configure') {
+            const configure = Reflect.get(target, prop, receiver);
+            return (opts) => wrap(configure(opts), { ...defaults, ...opts });
+        }
+        return Reflect.get(target, prop, receiver);
+    },
+});
+/**
+ * Playwright's `expect`, plus polling matchers for pages and locators built
+ * over the preview. `expect(value)`, `expect.soft`, `expect.poll`,
+ * `expect.configure` and the asymmetric matchers behave exactly as in
+ * Playwright.
+ */
+export const expect = wrap(playwrightExpect, {});
+//# sourceMappingURL=expect.js.map

package/dist/expect.js.map

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

package/dist/index.d.ts

@@ -1,67 +1,114 @@
 /**
- * Shared Playwright `test` + `expect` with auto-attached browser
- * console-error / pageerror guard.
+ * The `@playwright/test` drop-in for molecule apps: Playwright's `test`,
+ * `expect` and `page`, with the browser supplied by the bonded e2e provider
+ * and a console-error guard on every test.
  *
- * Every fleet app's e2e specs import `test` and `expect` from this
- * module (re-exported through their per-app `_helpers.ts`) instead of
- * `@playwright/test` directly. The custom `test` includes a
- * `consoleGuard` fixture with `{ auto: true }`, so every test
- * automatically subscribes to the browser's `pageerror` event and
- * `console.error` messages, then asserts the buffer is empty at test
- * teardown.
+ * Import `test` and `expect` from here instead of `@playwright/test` and
+ * write ordinary Playwright specs. Which browser runs them is the e2e bond
+ * (`@molecule/app-e2e`):
  *
- * This catches the failure mode where React (or any other client-side
- * module) throws on mount but the spec only asserts against
- * `page.request.get/post`, leaving the test green while the rendered
- * page is blank. A single quill-delta ESM/CJS interop error sat for
- * four days like this before we noticed — the replay videos were
- * 17 KB of nothing and the JSON reported PASS.
+ * - **`@molecule/app-e2e-preview`** drives the LIVE PREVIEW the molecule.dev
+ *   IDE is already showing — the page the person is looking at, in their own
+ *   browser — over a WebSocket through the dev server. No browser binary in
+ *   the sandbox, nothing to download. This is what a molecule sandbox uses.
+ * - **`@molecule/app-e2e-playwright`** launches real Playwright browsers. This
+ *   is what your own machine and CI use.
  *
- * To intentionally let a known error through (rare — almost always a
- * smell that should be fixed in the app), use
- * `test.info().annotations.push({ type: 'allow-console-error', description: 'why' })`
- * inside the test body BEFORE the error fires. The `description` is
- * matched against the error text as a regular expression; if it is not
- * a valid regex it is matched as a plain substring instead (so literal
- * error text with `[`/`(` can be pasted verbatim). An annotation with
- * no description allows every error — always provide one.
+ * The same spec file runs unchanged in both. The provider is picked by
+ * `resolveE2EProviderName()`: `MOL_E2E_PROVIDER` when set, otherwise `preview`
+ * inside a molecule sandbox (the `/etc/mol/app-root` marker exists) and
+ * `playwright` everywhere else. The scaffolded `e2e/bonds.ts` bonds the
+ * matching provider (and `test` bonds it by name as a fallback); `test` reads
+ * the same answer to decide whether to launch a browser.
  *
- * A small, fixed set of browser-noise patterns are ALWAYS ignored regardless
- * of `allow-console-error` (Vite HMR reconnect chatter, service-worker 404s
- * in headless Chrome, and a real Chrome DevTools "failed to load SourceMap"
- * message for any `https://`-hosted bundle — e.g. Stripe/Google Maps CDN
- * scripts shipped without source maps). That last pattern is verified
- * against the actual Chrome message text and constrained to `https://` so it
- * can never silence a genuinely broken source map in the app's OWN bundle
- * (served over plain `http://localhost` in dev/preview).
+ * Every test also carries the console-error guard: the page's `pageerror`
+ * and `console.error` events fail the test at teardown, so a spec that only
+ * asserts on `page.request` cannot stay green while the rendered page is
+ * blank. Allow a known error with
+ * `test.info().annotations.push({ type: 'allow-console-error', description: '<regex>' })`.
  *
  * @example
  * ```ts
- * // In fleet apps, the per-app `./_helpers.ts` re-exports these:
- * import { test, expect } from '@molecule/app-e2e-fixtures-default'
+ * // e2e/bonds.ts — scaffolded; wires the provider for THIS environment
+ * import { resolveE2EProviderName, setProvider } from '@molecule/app-e2e'
+ * import { provider as playwright } from '@molecule/app-e2e-playwright'
+ * import { provider as preview } from '@molecule/app-e2e-preview'
  *
- * test('login lands on dashboard', async ({ page }) => {
- *   await page.goto('/login')
- *   await page.getByLabel(/email/i).fill('user@example.com')
- *   // ...
+ * setProvider(resolveE2EProviderName() === 'preview' ? preview : playwright)
+ *
+ * // e2e/post.spec.ts — an ordinary Playwright spec
+ * import { expect, test } from '@molecule/app-e2e-fixtures-default'
+ *
+ * import './bonds.js'
+ *
+ * test('the phone layout keeps the prose large', async ({ page }) => {
+ *   await page.setViewportSize({ width: 390, height: 844 })
+ *   await page.goto('/blog/hello/')
+ *   const prose = page.locator('article p').first()
+ *   const size = await prose.evaluate((el) => parseFloat(getComputedStyle(el).fontSize))
+ *   expect(size).toBeGreaterThanOrEqual(18)
+ *   await expect(page.getByRole('switch', { name: /summar/i })).toBeVisible()
  * })
  * ```
  *
+ * @remarks
+ * - **What works over the preview** (the `@molecule/app-e2e-preview` bond):
+ *   `page.goto/reload/goBack/goForward/url/title/content`,
+ *   `page.evaluate/$eval/$$eval`, `page.locator` and every `getBy*` (role
+ *   with name/level/checked/pressed/expanded/selected, text, label,
+ *   placeholder, title, alt text, test id), `first/last/nth/filter/count/all`,
+ *   `click/dblclick/hover/tap/fill/clear/type/press/check/uncheck/setChecked/
+ *   selectOption/focus/blur/dispatchEvent/scrollIntoViewIfNeeded`,
+ *   `textContent/innerText/innerHTML/inputValue/getAttribute/isVisible/isHidden/
+ *   isEnabled/isDisabled/isEditable/isChecked/boundingBox/evaluate/evaluateAll/
+ *   waitFor`, `page.setViewportSize/viewportSize`, `page.mouse.*`,
+ *   `page.keyboard.*`, `page.request.get/post/put/patch/delete/fetch` (runs
+ *   `fetch` inside the page, cookies included), `waitForSelector/waitForURL/
+ *   waitForFunction/waitForLoadState/waitForTimeout`, `page.on('console' |
+ *   'pageerror' | 'dialog' | 'close')`, and `expect(locator)` with
+ *   `toBeVisible/toBeHidden/toBeAttached/toHaveCount/toHaveText/toContainText/
+ *   toHaveAttribute/toHaveClass/toContainClass/toHaveCSS/toHaveValue/toHaveId/
+ *   toBeChecked/toBeEnabled/toBeDisabled/toBeEditable/toBeEmpty/toBeFocused/
+ *   toBeInViewport/toHaveAccessibleName/toHaveRole` (+ `.not`, `expect.soft`,
+ *   `expect.configure`), `expect(page).toHaveTitle/toHaveURL`.
+ * - **The escape hatch is `page.evaluate()`.** Anything the list above does
+ *   not cover — a computed style, a scroll position, `matchMedia`, a
+ *   `fetch` — is one `evaluate` away; the function runs inside the real page
+ *   and returns JSON.
+ * - **Not available over the preview**, and the method THROWS naming the
+ *   alternative: screenshots and `toHaveScreenshot` (assert layout with
+ *   `boundingBox()` and computed styles instead), `page.route/waitForResponse/
+ *   waitForRequest` (read the response with `page.request` or `fetch` in
+ *   `evaluate`), element handles (`$`, `$$`, `elementHandle` — use locators),
+ *   `setInputFiles`, `dragTo`, iframes inside the preview, `emulateMedia`,
+ *   `addInitScript/exposeFunction`, `context.cookies/storageState` (read
+ *   `document.cookie`/`localStorage` in `evaluate`). The playwright bond
+ *   supports all of them.
+ * - **Viewport.** `page.setViewportSize` asks the IDE to resize the preview
+ *   frame and throws if the host did not (a preview opened in a plain tab
+ *   keeps the tab's width). Test phone layouts at 390×844 this way.
+ * - **Events.** `page.on('response')`/`'request'` never fire over the preview
+ *   (a one-time warning says so); `'console'` and `'pageerror'` do, so the
+ *   console-error guard works there too.
+ * - **The person's browser is the renderer.** If every tab showing the
+ *   preview is closed or asleep, actions wait for a page to reconnect and
+ *   then time out with a message saying so. Keep the IDE tab open (the IDE
+ *   holds a screen wake lock while a build runs) or open the preview URL in
+ *   any other tab — any connected viewer will do.
+ * - `createEvaluatePage()` is how a bond that can only run code inside a page
+ *   (an `E2ETransport`) gets the whole Playwright-shaped page; the preview
+ *   bond uses it, and so can any future one.
+ * - `@playwright/test` is a peer dependency: it supplies the runner
+ *   (`npx playwright test`), `expect` for plain values, and the `Page` types.
+ *   It never downloads browsers on install; only the playwright bond needs
+ *   `npx playwright install`.
+ *
  * @module
  */
-import { expect } from '@playwright/test';
-interface ConsoleErrorEntry {
-    type: 'pageerror' | 'console.error';
-    text: string;
-    location?: string;
-}
-/**
- * Custom Playwright `test` with an auto-attached browser console-error
- * guard. Drop-in replacement for `import { test } from '@playwright/test'`.
- */
-export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
-    consoleGuard: void;
-}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
-export { expect };
-export type { ConsoleErrorEntry };
+export * from './console-guard.js';
+export * from './expect.js';
+export * from './page.js';
+export * from './playwright.js';
+export * from './runtime.js';
+export * from './test.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAuB,MAAM,EAAgB,MAAM,kBAAkB,CAAA;AAE5E,UAAU,iBAAiB;IACzB,IAAI,EAAE,WAAW,GAAG,eAAe,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAkCD;;;GAGG;AACH,eAAO,MAAM,IAAI;kBAA+B,IAAI;wGAkElD,CAAA;AAEF,OAAO,EAAE,MAAM,EAAE,CAAA;AACjB,YAAY,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0GG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}