@emseepea/testing 0.13.1 → 0.14.1

package/README.md

@@ -250,6 +250,45 @@ responses, cancellation, and teardown. It does not prove behavior in ChatGPT,
 Claude, or another exact host. Qualify each supported host separately through
 its real public journey before making a host-specific production claim.
 
+## Run a Compiled MCP App in a Browser
+
+Use `createMcpAppDevelopmentHost` from `@emseepea/testing/browser` in a local
+development page. The host creates an iframe, loads the compiled widget, and
+uses the same protocol engine as `createMcpAppHostSimulator`.
+
+```js
+import { createMcpAppDevelopmentHost } from "@emseepea/testing/browser";
+
+const host = createMcpAppDevelopmentHost({
+  container: document.querySelector("#preview"),
+  entryPoint: "../dist/order-result.js",
+  rootElementId: "order-result-root",
+  fixtures: {
+    ready: { orderId: "example-123", status: "ready" },
+    delayed: { orderId: "example-456", status: "delayed" },
+  },
+  hostContext: { theme: "light", platform: "web" },
+});
+```
+
+The first fixture is the default. These URL parameters override it for a local
+browser run:
+
+- `fixture=delayed` selects a named fixture.
+- `theme=dark` selects the initial light or dark host theme.
+- `width=288` constrains the iframe from 200 to 2,000 pixels.
+- `motion=reduce` makes the iframe match `prefers-reduced-motion`.
+- `message=reject` rejects `ui/message`; the default succeeds.
+
+Use `deliverFixture()`, `changeHostContext()`, and `setContainerWidth()` for
+changes without reloading. `messageRequests()` exposes captured action text.
+Call `destroy()` when the preview is no longer needed.
+
+Keep fixtures, widget styles, screenshot policy, and assertions in the
+application. This development host proves only the browser lifecycle that you
+run. It does not establish compatibility with ChatGPT, Claude, or another
+public host. Qualify each supported host through its real public journey.
+
 ## Diagnose Failures
 
 The evidence file contains readable test prompts, assistant responses,

package/dist/browser.d.ts

@@ -0,0 +1,26 @@
+import type { McpAppHostContext } from "@emseepea/server/ui";
+import { type McpAppMessageRequest } from "./mcp-app-host.js";
+export interface McpAppDevelopmentHostOptions {
+    readonly container: HTMLElement;
+    readonly entryPoint: string | URL;
+    readonly fixtures: Readonly<Record<string, unknown>>;
+    readonly rootElementId: string;
+    readonly hostContext?: McpAppHostContext;
+    readonly messageResponse?: "succeed" | "reject";
+    readonly reducedMotion?: boolean;
+    readonly searchParams?: URLSearchParams;
+    readonly title?: string;
+    readonly width?: number;
+}
+export interface McpAppDevelopmentHost {
+    readonly iframe: HTMLIFrameElement;
+    initialized(): boolean;
+    messageRequests(): readonly McpAppMessageRequest[];
+    deliverFixture(name: string): void;
+    changeHostContext(context: Partial<McpAppHostContext>): void;
+    setContainerWidth(width?: number): void;
+    destroy(): void;
+}
+/** Run a compiled MCP App in a small, framework-neutral browser host. */
+export declare function createMcpAppDevelopmentHost(options: McpAppDevelopmentHostOptions): McpAppDevelopmentHost;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAAC;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC7D,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CA2EvB"}

package/dist/browser.js

@@ -0,0 +1,113 @@
+import { createMcpAppHostProtocol, } from "./mcp-app-host.js";
+/** Run a compiled MCP App in a small, framework-neutral browser host. */
+export function createMcpAppDevelopmentHost(options) {
+    if (!options.container || typeof options.container.append !== "function") {
+        throw new TypeError("container must be an HTML element");
+    }
+    if (!/^[A-Za-z][A-Za-z0-9_.:-]*$/.test(options.rootElementId)) {
+        throw new TypeError("rootElementId must be a valid non-empty HTML ID");
+    }
+    const fixtureNames = Object.keys(options.fixtures);
+    if (fixtureNames.length === 0)
+        throw new TypeError("fixtures must contain at least one fixture");
+    const params = options.searchParams ?? new URLSearchParams(location.search);
+    const fixtureName = params.get("fixture") ?? fixtureNames[0];
+    fixture(options.fixtures, fixtureName);
+    const requestedTheme = params.get("theme");
+    const theme = requestedTheme === "light" || requestedTheme === "dark"
+        ? requestedTheme
+        : options.hostContext?.theme;
+    const messageResponse = params.get("message") === "reject" ? "reject" : options.messageResponse ?? "succeed";
+    const reducedMotion = params.get("motion") === "reduce" || options.reducedMotion === true;
+    const width = params.has("width") ? checkedWidth(params.get("width")) : checkedWidth(options.width);
+    const iframe = document.createElement("iframe");
+    iframe.title = options.title ?? "MCP App preview";
+    options.container.append(iframe);
+    setWidth(iframe, width);
+    const child = iframe.contentWindow;
+    const childDocument = iframe.contentDocument;
+    if (!child || !childDocument)
+        throw new Error("The development host could not create its preview frame.");
+    const protocol = createMcpAppHostProtocol({
+        hostContext: { ...options.hostContext, ...(theme ? { theme } : {}) },
+    }, (message) => child.postMessage(message, "*"));
+    const receive = (event) => {
+        if (event.source !== child)
+            return;
+        const wasInitialized = protocol.initialized();
+        const requestCount = protocol.messageRequests().length;
+        protocol.receive(event.data);
+        if (!wasInitialized && protocol.initialized()) {
+            protocol.deliverToolResult(fixture(options.fixtures, fixtureName));
+        }
+        for (const request of protocol.messageRequests().slice(requestCount)) {
+            if (messageResponse === "reject")
+                request.reject();
+            else
+                request.succeed();
+        }
+    };
+    window.addEventListener("message", receive);
+    childDocument.open();
+    childDocument.write("<!doctype html><html><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"></head><body></body></html>");
+    childDocument.close();
+    childDocument.title = options.title ?? "MCP App preview";
+    childDocument.documentElement.lang = document.documentElement.lang || "en";
+    if (reducedMotion)
+        installReducedMotion(child);
+    const root = childDocument.createElement("div");
+    root.id = options.rootElementId;
+    childDocument.body.append(root);
+    const script = childDocument.createElement("script");
+    script.src = new URL(options.entryPoint, location.href).href;
+    childDocument.body.append(script);
+    return {
+        iframe,
+        initialized: protocol.initialized,
+        messageRequests: protocol.messageRequests,
+        deliverFixture: (name) => protocol.deliverToolResult(fixture(options.fixtures, name)),
+        changeHostContext: protocol.changeHostContext,
+        setContainerWidth: (nextWidth) => setWidth(iframe, checkedWidth(nextWidth)),
+        destroy: () => {
+            window.removeEventListener("message", receive);
+            iframe.remove();
+        },
+    };
+}
+function fixture(fixtures, name) {
+    if (!Object.prototype.hasOwnProperty.call(fixtures, name)) {
+        throw new TypeError(`Unknown fixture: ${name}`);
+    }
+    return fixtures[name];
+}
+function checkedWidth(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const width = typeof value === "string" && /^\d+$/.test(value) ? Number(value) : value;
+    if (!Number.isSafeInteger(width) || Number(width) < 200 || Number(width) > 2_000) {
+        throw new TypeError("width must be an integer from 200 to 2000");
+    }
+    return Number(width);
+}
+function setWidth(iframe, width) {
+    iframe.style.width = width === undefined ? "" : `${width}px`;
+}
+function installReducedMotion(target) {
+    const nativeMatchMedia = target.matchMedia.bind(target);
+    Object.defineProperty(target, "matchMedia", {
+        configurable: true,
+        value: (query) => /prefers-reduced-motion\s*:\s*reduce/.test(query)
+            ? {
+                matches: true,
+                media: query,
+                onchange: null,
+                addListener() { },
+                removeListener() { },
+                addEventListener() { },
+                removeEventListener() { },
+                dispatchEvent: () => true,
+            }
+            : nativeMatchMedia(query),
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/mcp-app-host.d.ts

@@ -22,6 +22,17 @@ export interface McpAppHostSimulator {
     /** Deliver an arbitrary message from a different source for trust-boundary tests. */
     dispatchUntrusted(message: unknown): void;
 }
+export interface McpAppHostProtocol {
+    initialized(): boolean;
+    messageRequests(): readonly McpAppMessageRequest[];
+    deliverToolResult(structuredContent: unknown): void;
+    changeHostContext(context: Partial<McpAppHostContext>): void;
+    cancel(reason?: string): void;
+    teardown(reason?: string): Promise<void>;
+    receive(message: unknown): void;
+}
 /** Deterministic, framework-neutral simulation of the MCP Apps browser host lifecycle. */
 export declare function createMcpAppHostSimulator(options?: McpAppHostSimulatorOptions): McpAppHostSimulator;
+/** @internal Shared protocol engine for deterministic and browser hosts. */
+export declare function createMcpAppHostProtocol(options: McpAppHostSimulatorOptions, send: (message: unknown) => void): McpAppHostProtocol;
 //# sourceMappingURL=mcp-app-host.d.ts.map

package/dist/mcp-app-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-app-host.d.ts","sourceRoot":"","sources":["../src/mcp-app-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAAC;IACnD,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C;AAOD,0FAA0F;AAC1F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAgHrB"}
+{"version":3,"file":"mcp-app-host.d.ts","sourceRoot":"","sources":["../src/mcp-app-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAAC;IACnD,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,IAAI,OAAO,CAAC;IACvB,eAAe,IAAI,SAAS,oBAAoB,EAAE,CAAC;IACnD,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAOD,0FAA0F;AAC1F,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAoCrB;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,0BAA0B,EACnC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAC/B,kBAAkB,CA4FpB"}

package/dist/mcp-app-host.js

@@ -1,63 +1,9 @@
 /** Deterministic, framework-neutral simulation of the MCP Apps browser host lifecycle. */
 export function createMcpAppHostSimulator(options = {}) {
     const events = new EventTarget();
-    const requests = [];
-    const responses = new Map();
-    let initialized = false;
-    let sequence = 0;
     const parent = {
         postMessage(message) {
-            if (!record(message) || message.jsonrpc !== "2.0")
-                return;
-            if ((typeof message.id === "string" || typeof message.id === "number") &&
-                (record(message.result) || record(message.error))) {
-                responses.set(message.id, {
-                    ...(message.result !== undefined ? { result: message.result } : {}),
-                    ...(message.error !== undefined ? { error: message.error } : {}),
-                });
-                return;
-            }
-            if (message.method === "ui/initialize" &&
-                (typeof message.id === "string" || typeof message.id === "number")) {
-                dispatch({
-                    jsonrpc: "2.0",
-                    id: message.id,
-                    result: {
-                        protocolVersion: "2026-01-26",
-                        hostInfo: { name: "emseepea-test-host", version: "0.0.0" },
-                        hostCapabilities: {},
-                        hostContext: options.hostContext ?? {},
-                    },
-                }, parent);
-                return;
-            }
-            if (message.method === "ui/notifications/initialized") {
-                initialized = true;
-                return;
-            }
-            if (message.method !== "ui/message" ||
-                (typeof message.id !== "string" && typeof message.id !== "number") ||
-                !record(message.params) || message.params.role !== "user" ||
-                !Array.isArray(message.params.content) || message.params.content.length !== 1 ||
-                !record(message.params.content[0]) || message.params.content[0].type !== "text" ||
-                typeof message.params.content[0].text !== "string")
-                return;
-            const id = message.id;
-            let settled = false;
-            const answer = (response) => {
-                if (settled)
-                    throw new Error("The ui/message request has already been answered.");
-                settled = true;
-                dispatch({ jsonrpc: "2.0", id, ...response }, parent);
-            };
-            requests.push(Object.freeze({
-                id,
-                text: message.params.content[0].text,
-                succeed: () => answer({ result: {} }),
-                reject: (reason = "The test host rejected the message.") => answer({
-                    error: { code: -32_000, message: reason },
-                }),
-            }));
+            protocol.receive(message);
         },
     };
     const untrusted = {};
@@ -74,21 +20,92 @@ export function createMcpAppHostSimulator(options = {}) {
         });
         events.dispatchEvent(event);
     }
+    const protocol = createMcpAppHostProtocol(options, (message) => dispatch(message));
     return {
         channel,
+        initialized: protocol.initialized,
+        messageRequests: protocol.messageRequests,
+        deliverToolResult: protocol.deliverToolResult,
+        changeHostContext: protocol.changeHostContext,
+        cancel: protocol.cancel,
+        teardown: protocol.teardown,
+        dispatch: (message) => dispatch(message),
+        dispatchUntrusted: (message) => dispatch(message, untrusted),
+    };
+}
+/** @internal Shared protocol engine for deterministic and browser hosts. */
+export function createMcpAppHostProtocol(options, send) {
+    const requests = [];
+    const responses = new Map();
+    let initialized = false;
+    let sequence = 0;
+    const receive = (message) => {
+        if (!record(message) || message.jsonrpc !== "2.0")
+            return;
+        if ((typeof message.id === "string" || typeof message.id === "number") &&
+            (record(message.result) || record(message.error))) {
+            responses.set(message.id, {
+                ...(message.result !== undefined ? { result: message.result } : {}),
+                ...(message.error !== undefined ? { error: message.error } : {}),
+            });
+            return;
+        }
+        if (message.method === "ui/initialize" &&
+            (typeof message.id === "string" || typeof message.id === "number")) {
+            send({
+                jsonrpc: "2.0",
+                id: message.id,
+                result: {
+                    protocolVersion: "2026-01-26",
+                    hostInfo: { name: "emseepea-test-host", version: "0.0.0" },
+                    hostCapabilities: {},
+                    hostContext: options.hostContext ?? {},
+                },
+            });
+            return;
+        }
+        if (message.method === "ui/notifications/initialized") {
+            initialized = true;
+            return;
+        }
+        if (message.method !== "ui/message" ||
+            (typeof message.id !== "string" && typeof message.id !== "number") ||
+            !record(message.params) || message.params.role !== "user" ||
+            !Array.isArray(message.params.content) || message.params.content.length !== 1 ||
+            !record(message.params.content[0]) || message.params.content[0].type !== "text" ||
+            typeof message.params.content[0].text !== "string")
+            return;
+        const id = message.id;
+        let settled = false;
+        const answer = (response) => {
+            if (settled)
+                throw new Error("The ui/message request has already been answered.");
+            settled = true;
+            send({ jsonrpc: "2.0", id, ...response });
+        };
+        requests.push(Object.freeze({
+            id,
+            text: message.params.content[0].text,
+            succeed: () => answer({ result: {} }),
+            reject: (reason = "The test host rejected the message.") => answer({
+                error: { code: -32_000, message: reason },
+            }),
+        }));
+    };
+    return {
         initialized: () => initialized,
         messageRequests: () => Object.freeze([...requests]),
-        deliverToolResult: (structuredContent) => dispatch({
+        deliverToolResult: (structuredContent) => send({
             jsonrpc: "2.0",
             method: "ui/notifications/tool-result",
             params: { structuredContent },
         }),
-        changeHostContext: (context) => dispatch({
+        changeHostContext: (context) => send({
             jsonrpc: "2.0",
             method: "ui/notifications/host-context-changed",
             params: context,
         }),
-        cancel: (reason) => dispatch({
+        cancel: (reason) => send({
             jsonrpc: "2.0",
             method: "ui/notifications/tool-cancelled",
             ...(reason === undefined ? {} : { params: { reason } }),
@@ -96,7 +113,7 @@ export function createMcpAppHostSimulator(options = {}) {
         teardown: async (reason) => {
             const id = `emseepea-host-teardown-${++sequence}`;
             responses.delete(id);
-            dispatch({
+            send({
                 jsonrpc: "2.0",
                 id,
                 method: "ui/resource-teardown",
@@ -109,8 +126,7 @@ export function createMcpAppHostSimulator(options = {}) {
             if (response.error !== undefined)
                 throw new Error("The app rejected resource teardown.");
         },
-        dispatch: (message) => dispatch(message),
-        dispatchUntrusted: (message) => dispatch(message, untrusted),
+        receive,
     };
 }
 function record(value) {

package/dist/mcp-app-host.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emseepea/testing",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "MCP integration and semantic testing helpers",
   "license": "MIT",
   "repository": {
@@ -20,6 +20,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
     "./semantic": {
       "types": "./semantic/test.d.mts",
       "import": "./semantic/test.mjs"
@@ -41,9 +45,12 @@
     "test:built": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "@emseepea/server": "0.13.0",
+    "@emseepea/server": "0.14.0",
     "@modelcontextprotocol/client": "2.0.0"
   },
+  "devDependencies": {
+    "playwright": "1.62.1"
+  },
   "engines": {
     "node": ">=22"
   }