@storyshelf/runner-playwright 0.3.2 → 0.5.3

package/README.md

@@ -16,10 +16,20 @@ import { createPlaywrightCaptureRunner } from "@storyshelf/runner-playwright";
 const capture = createPlaywrightCaptureRunner();
 ```
 
-Supply it to `createShelfRouter({ capture, config: { scratchDir } })` — the router builds the orchestrator that loads the build, extracts the uploaded archive into `scratchDir`, discovers stories, calls `capture.render(...)`, and persists. `server` is the assembly point that hard-wires this renderer today (`storyshelf-server serve`, passing `--data-dir` as `scratchDir`). A future alternative (e.g. a remote runner offloading capture to a worker fleet) implements the same pure `CaptureRunner` interface from `@storyshelf/core/adapters/capture-runner` as its own package and is swapped in at the `serve` assembly site — the router, orchestrator, and pipeline never change.
+Supply it to `createShelfApp({ capture, config: { scratchDir } })` — the router builds the orchestrator that loads the build, extracts the uploaded archive into `scratchDir`, discovers stories, calls `capture.render(...)`, and persists. `server` is the assembly point that hard-wires this renderer today (`storyshelf-server serve`, passing `--data-dir` as `scratchDir`). A future alternative (e.g. a remote runner offloading capture to a worker fleet) implements the same pure `CaptureRunner` interface from `@storyshelf/core/adapters/capture-runner` as its own package and is swapped in at the `serve` assembly site — the router, orchestrator, and pipeline never change.
+
+## Browsers
+
+This package depends on `playwright-core` only — it never downloads browsers. Provision Chromium once per machine (pinned to the client version):
+
+```sh
+npx -y playwright@1.63.0 install chromium
+```
+
+The Fly image installs browsers at build time (`playwright install --with-deps chromium`); CI and local runs use the same command.
 
 ## How it fits
 
-Core's capture logic is browser-agnostic: the **orchestrator** (`@storyshelf/core/capture`) owns loading, extraction, discovery, and persistence, and delegates only the actual screenshotting to this package's `render(input) => RenderResult`. This package supplies the pure renderer and the ephemeral Storybook static server it needs. It is the only place that depends on `playwright`.
+Core's capture logic is browser-agnostic: the **orchestrator** (`@storyshelf/core/capture`) owns loading, extraction, discovery, and persistence, and delegates only the actual screenshotting to this package's `render(input) => RenderResult`. This package supplies the pure renderer and the ephemeral Storybook static server it needs. It is the only place that depends on `playwright-core` (never full `playwright` — browsers are provisioned separately, see above).
 
-See `docs/architecture.md` for the capture workflow and `docs/testing.md` for the gated browser integration suite.
+See `docs/architecture.md` for the capture workflow and `docs/testing.md` for the gated browser integration suite.

package/dist/a11y.mjs

@@ -0,0 +1,31 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/a11y.ts
+/** Run lightweight a11y checks inside the page context. */
+async function checkA11y(page) {
+	return await page.evaluate(inPageA11y);
+}
+/**
+* Runs inside the browser. Playwright/Puppeteer serialize only this function's source, so it must
+* not reference anything from this module (helpers, imports): split it up and the page throws
+* `ReferenceError`. `a11y.test.ts` evaluates it in a scope without module bindings to guard that.
+*/
+function inPageA11y() {
+	const doc = globalThis.document;
+	const violations = [];
+	const root = doc?.querySelector("#storybook-root");
+	if (!root) return violations;
+	for (const img of root.querySelectorAll("img:not([alt])")) violations.push(`img missing alt: ${img.outerHTML.slice(0, 120)}`);
+	for (const btn of root.querySelectorAll("button")) if (!(btn.hasAttribute("aria-label") || btn.hasAttribute("aria-labelledby") || (btn.textContent ?? "").trim() !== "")) violations.push(`button missing label: ${btn.outerHTML.slice(0, 120)}`);
+	for (const anchor of root.querySelectorAll("a")) if (!anchor.hasAttribute("href")) violations.push(`a missing href: ${anchor.outerHTML.slice(0, 120)}`);
+	for (const input of root.querySelectorAll("input, select, textarea")) {
+		const el = input;
+		if (!(el.type === "hidden" || el.hasAttribute("aria-label") || el.hasAttribute("aria-labelledby") || el.id === "" || Boolean(doc.querySelector(`label[for="${el.id}"]`)))) violations.push(`input missing label: ${el.outerHTML.slice(0, 120)}`);
+	}
+	return violations.slice(0, 10);
+}
+//#endregion
+export { checkA11y, inPageA11y };
+
+//# sourceMappingURL=a11y.mjs.map

package/dist/a11y.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.mjs","names":[],"sources":["../src/a11y.ts"],"sourcesContent":["/** Accessibility checks for captured pages. */\n\nimport type { Page } from \"playwright-core\";\n\n/** Run lightweight a11y checks inside the page context. */\nexport async function checkA11y(page: Page): Promise<string[]> {\n  return await page.evaluate(inPageA11y);\n}\n\n/**\n * Runs inside the browser. Playwright/Puppeteer serialize only this function's source, so it must\n * not reference anything from this module (helpers, imports): split it up and the page throws\n * `ReferenceError`. `a11y.test.ts` evaluates it in a scope without module bindings to guard that.\n */\n// oxlint-disable-next-line eslint/max-statements, eslint/max-lines-per-function, eslint/complexity -- must stay one self-contained function (see above)\nexport function inPageA11y(): string[] {\n  const doc = globalThis.document;\n  const violations: string[] = [];\n  const root = doc?.querySelector(\"#storybook-root\");\n  if (!root) return violations;\n  for (const img of root.querySelectorAll(\"img:not([alt])\")) {\n    violations.push(`img missing alt: ${img.outerHTML.slice(0, 120)}`);\n  }\n  for (const btn of root.querySelectorAll(\"button\")) {\n    const labelled =\n      btn.hasAttribute(\"aria-label\") ||\n      btn.hasAttribute(\"aria-labelledby\") ||\n      (btn.textContent ?? \"\").trim() !== \"\";\n    if (!labelled) violations.push(`button missing label: ${btn.outerHTML.slice(0, 120)}`);\n  }\n  for (const anchor of root.querySelectorAll(\"a\")) {\n    if (!anchor.hasAttribute(\"href\"))\n      violations.push(`a missing href: ${anchor.outerHTML.slice(0, 120)}`);\n  }\n  for (const input of root.querySelectorAll(\"input, select, textarea\")) {\n    const el = input as HTMLInputElement;\n    const labelled =\n      el.type === \"hidden\" ||\n      el.hasAttribute(\"aria-label\") ||\n      el.hasAttribute(\"aria-labelledby\") ||\n      el.id === \"\" ||\n      Boolean(doc.querySelector(`label[for=\"${el.id}\"]`));\n    if (!labelled) violations.push(`input missing label: ${el.outerHTML.slice(0, 120)}`);\n  }\n  return violations.slice(0, 10);\n}\n"],"mappings":";;;;;AAKA,eAAsB,UAAU,MAA+B;CAC7D,OAAO,MAAM,KAAK,SAAS,UAAU;AACvC;;;;;;AAQA,SAAgB,aAAuB;CACrC,MAAM,MAAM,WAAW;CACvB,MAAM,aAAuB,CAAC;CAC9B,MAAM,OAAO,KAAK,cAAc,iBAAiB;CACjD,IAAI,CAAC,MAAM,OAAO;CAClB,KAAK,MAAM,OAAO,KAAK,iBAAiB,gBAAgB,GACtD,WAAW,KAAK,oBAAoB,IAAI,UAAU,MAAM,GAAG,GAAG,GAAG;CAEnE,KAAK,MAAM,OAAO,KAAK,iBAAiB,QAAQ,GAK9C,IAAI,EAHF,IAAI,aAAa,YAAY,KAC7B,IAAI,aAAa,iBAAiB,MACjC,IAAI,eAAe,GAAA,CAAI,KAAK,MAAM,KACtB,WAAW,KAAK,yBAAyB,IAAI,UAAU,MAAM,GAAG,GAAG,GAAG;CAEvF,KAAK,MAAM,UAAU,KAAK,iBAAiB,GAAG,GAC5C,IAAI,CAAC,OAAO,aAAa,MAAM,GAC7B,WAAW,KAAK,mBAAmB,OAAO,UAAU,MAAM,GAAG,GAAG,GAAG;CAEvE,KAAK,MAAM,SAAS,KAAK,iBAAiB,yBAAyB,GAAG;EACpE,MAAM,KAAK;EAOX,IAAI,EALF,GAAG,SAAS,YACZ,GAAG,aAAa,YAAY,KAC5B,GAAG,aAAa,iBAAiB,KACjC,GAAG,OAAO,MACV,QAAQ,IAAI,cAAc,cAAc,GAAG,GAAG,GAAG,CAAC,IACrC,WAAW,KAAK,wBAAwB,GAAG,UAAU,MAAM,GAAG,GAAG,GAAG;CACrF;CACA,OAAO,WAAW,MAAM,GAAG,EAAE;AAC/B"}

package/dist/browser.mjs

@@ -0,0 +1,34 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/browser.ts
+/** Tracks in-flight renders so `cancel` can abort them. */
+const activeRuns = /* @__PURE__ */ new Map();
+/** Close a browser if present; `cancel` must never throw. */
+async function closeBrowser(browser) {
+	if (!browser) return;
+	await tryCloseBrowser(browser);
+}
+async function tryCloseBrowser(browser) {
+	try {
+		await browser.close();
+	} catch {}
+}
+/** Best-effort close for the render's `finally` block. */
+async function safeCloseBrowser(browser) {
+	await tryCloseBrowser(browser);
+}
+/** Best-effort close for the static server. */
+async function safeCloseServer(server) {
+	try {
+		await server.close();
+	} catch {}
+}
+/** Normalize any thrown value to a string. */
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+//#endregion
+export { activeRuns, closeBrowser, messageOf, safeCloseBrowser, safeCloseServer };
+
+//# sourceMappingURL=browser.mjs.map

package/dist/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.mjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/** Browser lifecycle and active-run tracking for Playwright. */\n\nimport type { Browser } from \"playwright-core\";\nimport type { ActiveRun } from \"./types.ts\";\n\n/** Tracks in-flight renders so `cancel` can abort them. */\nexport const activeRuns = new Map<string, ActiveRun>();\n\n/** Close a browser if present; `cancel` must never throw. */\nexport async function closeBrowser(browser: Browser | null): Promise<void> {\n  if (!browser) return;\n  await tryCloseBrowser(browser);\n}\n\nasync function tryCloseBrowser(browser: Browser): Promise<void> {\n  try {\n    await browser.close();\n  } catch {\n    // The run's own `finally` performs final cleanup; cancel must never throw.\n  }\n}\n\n/** Best-effort close for the render's `finally` block. */\nexport async function safeCloseBrowser(browser: Browser): Promise<void> {\n  await tryCloseBrowser(browser);\n}\n\n/** Best-effort close for the static server. */\nexport async function safeCloseServer(server: { close(): Promise<void> }): Promise<void> {\n  try {\n    await server.close();\n  } catch {\n    // Best-effort; teardown must never mask a render result.\n  }\n}\n\n/** Normalize any thrown value to a string. */\nexport function messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";;;;;AAMA,MAAa,6BAAa,IAAI,IAAuB;;AAGrD,eAAsB,aAAa,SAAwC;CACzE,IAAI,CAAC,SAAS;CACd,MAAM,gBAAgB,OAAO;AAC/B;AAEA,eAAe,gBAAgB,SAAiC;CAC9D,IAAI;EACF,MAAM,QAAQ,MAAM;CACtB,QAAQ,CAER;AACF;;AAGA,eAAsB,iBAAiB,SAAiC;CACtE,MAAM,gBAAgB,OAAO;AAC/B;;AAGA,eAAsB,gBAAgB,QAAmD;CACvF,IAAI;EACF,MAAM,OAAO,MAAM;CACrB,QAAQ,CAER;AACF;;AAGA,SAAgB,UAAU,OAAwB;CAChD,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D"}

package/dist/capture-runner.d.mts

@@ -1,10 +1,14 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { CaptureRunner } from "@storyshelf/core/adapter/capture-runner";
-import "@storyshelf/core/logger";
+import "./types.mjs";
+import "./runtime-params.mjs";
+import { BrowserName, CaptureRunner } from "@storyshelf/core/adapter/capture-runner";
 //#region src/capture-runner.d.ts
 /** Create a CaptureRunner that renders Storybook stories with Playwright. */
-declare function createPlaywrightCaptureRunner(): CaptureRunner;
+declare function createPlaywrightCaptureRunner(options?: {
+  browser?: BrowserName;
+  supportedBrowsers?: readonly BrowserName[];
+}): CaptureRunner;
 //#endregion
 export { createPlaywrightCaptureRunner };
 //# sourceMappingURL=capture-runner.d.mts.map

package/dist/capture-runner.mjs

@@ -1,20 +1,23 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { createStaticServer } from "./static-server.mjs";
-import { StorybookAdapter } from "@storyshelf/core/capture";
-import { chromium } from "playwright";
+import { activeRuns, closeBrowser } from "./browser.mjs";
+import "./runtime-params.mjs";
+import { renderAll } from "./pipeline.mjs";
+import { BROWSER_NAMES } from "@storyshelf/core/adapter/capture-runner";
 //#region src/capture-runner.ts
-const activeRuns = /* @__PURE__ */ new Map();
+/** Playwright capture runner — composition root (factory wiring). */
 /** Create a CaptureRunner that renders Storybook stories with Playwright. */
-function createPlaywrightCaptureRunner() {
+function createPlaywrightCaptureRunner(options = {}) {
+	const defaultBrowser = options.browser ?? "chromium";
 	return {
 		metadata: {
 			name: "Playwright",
 			version: globalThis.__PKG_VERSION__ ?? "0.0.0",
 			description: "Playwright capture runner",
 			kind: "playwright",
-			category: "capture-runner"
+			category: "capture-runner",
+			supportedBrowsers: options.supportedBrowsers ?? BROWSER_NAMES
 		},
 		async render(input) {
 			const active = {
@@ -23,7 +26,7 @@ function createPlaywrightCaptureRunner() {
 			};
 			activeRuns.set(input.buildId, active);
 			try {
-				return await renderAll(input, active);
+				return await renderAll(input, active, defaultBrowser);
 			} finally {
 				activeRuns.delete(input.buildId);
 			}
@@ -36,127 +39,6 @@ function createPlaywrightCaptureRunner() {
 		}
 	};
 }
-async function closeBrowser(browser) {
-	if (!browser) return;
-	try {
-		await browser.close();
-	} catch {}
-}
-async function renderAll(input, active) {
-	const server = await createStaticServer(input.storybookDir);
-	const browser = await chromium.launch();
-	active.browser = browser;
-	const ctx = {
-		browser,
-		adapter: new StorybookAdapter(),
-		baseUrl: server.url,
-		executePlay: input.executePlay,
-		playTimeoutMs: input.playTimeoutMs
-	};
-	const captures = [];
-	const failures = [];
-	try {
-		const tasks = input.viewports.flatMap((viewport) => input.stories.map(async (story) => {
-			if (active.cancelled) throw new Error("Capture cancelled");
-			try {
-				const screenshot = await captureScreenshot(ctx, story, viewport);
-				captures.push({
-					story,
-					viewportName: viewport.name,
-					screenshot
-				});
-			} catch (error) {
-				failures.push({
-					storyId: story.id,
-					viewportName: viewport.name,
-					error: messageOf(error)
-				});
-				input.logger?.error({
-					storyId: story.id,
-					viewport: viewport.name,
-					err: error
-				}, "render failed for story");
-			}
-		}));
-		await Promise.all(tasks);
-		return {
-			captures,
-			failures
-		};
-	} finally {
-		active.browser = null;
-		await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);
-	}
-}
-function messageOf(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-async function safeCloseBrowser(browser) {
-	try {
-		await browser.close();
-	} catch {}
-}
-async function safeCloseServer(server) {
-	try {
-		await server.close();
-	} catch {}
-}
-async function captureScreenshot(ctx, story, viewport) {
-	const page = await ctx.browser.newPage({ viewport: {
-		width: viewport.width,
-		height: viewport.height
-	} });
-	try {
-		await page.goto(ctx.adapter.buildUrl(ctx.baseUrl, story.id), { waitUntil: "networkidle" });
-		if (ctx.adapter.screenshotSelector) {
-			await page.waitForSelector(ctx.adapter.screenshotSelector, { state: "attached" });
-			const delay = story.parameters?.delay ?? 500;
-			await page.waitForTimeout(delay);
-			if (story.parameters?.pauseAnimationAtEnd) await page.evaluate(() => {
-				const doc = globalThis.document;
-				for (const anim of doc.getAnimations()) anim.pause();
-			});
-		}
-		if (ctx.executePlay) {
-			const timeout = ctx.playTimeoutMs ?? 1e4;
-			try {
-				await page.evaluate(async ({ storyId, timeoutMs }) => {
-					const preview = globalThis["__STORYBOOK_PREVIEW__"];
-					if (!preview) return;
-					let playError = null;
-					const handler = (err) => {
-						playError = err;
-					};
-					try {
-						preview.channel?.on("playFunctionThrewException", handler);
-					} catch {}
-					if (preview.executePlay) await Promise.race([preview.executePlay(storyId), new Promise((_, reject) => {
-						setTimeout(() => {
-							reject(/* @__PURE__ */ new Error(`play timeout after ${timeoutMs}ms`));
-						}, timeoutMs);
-					})]);
-					else if (preview.storyStore?.fromId) {
-						const loaded = preview.storyStore.fromId(storyId);
-						if (loaded?.play) await Promise.race([loaded.play({ canvasElement: globalThis.document.querySelector("#storybook-root") }), new Promise((_, reject) => {
-							setTimeout(() => {
-								reject(/* @__PURE__ */ new Error(`play timeout after ${timeoutMs}ms`));
-							}, timeoutMs);
-						})]);
-					}
-					if (playError) throw playError;
-				}, {
-					storyId: story.id,
-					timeoutMs: timeout
-				});
-			} catch (error) {
-				throw new Error(`play failed: ${messageOf(error)}`, { cause: error });
-			}
-		}
-		return await page.screenshot({ animations: story.parameters?.pauseAnimationAtEnd ? "allow" : "disabled" });
-	} finally {
-		await page.close();
-	}
-}
 //#endregion
 export { createPlaywrightCaptureRunner };
 

package/dist/capture-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capture-runner.mjs","names":["win"],"sources":["../src/capture-runner.ts"],"sourcesContent":["import type {\n  CaptureRunner,\n  RenderResult,\n  RenderedSnapshot,\n  StoryEntry,\n  StorySourceAdapter,\n  Viewport,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { StorybookAdapter } from \"@storyshelf/core/capture\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { chromium, type Browser } from \"playwright\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\nimport { createStaticServer } from \"./static-server.ts\";\n\ninterface ScreenshotContext {\n  browser: Browser;\n  adapter: StorySourceAdapter;\n  baseUrl: string;\n}\n\n/** A render that may currently be in flight, so that `cancel` can abort it. */\ninterface ActiveRun {\n  cancelled: boolean;\n  browser: Browser | null;\n}\n\nconst activeRuns = new Map<string, ActiveRun>();\n\n/** Input for a Playwright capture run over a built Storybook directory. */\nexport interface PlaywrightRenderInput {\n  buildId: string;\n  storybookDir: string;\n  stories: StoryEntry[];\n  viewports: Viewport[];\n  logger?: Logger;\n  executePlay?: boolean;\n  playTimeoutMs?: number;\n}\n\n/** Create a CaptureRunner that renders Storybook stories with Playwright. */\nexport function createPlaywrightCaptureRunner(): CaptureRunner {\n  return {\n    metadata: {\n      name: \"Playwright\",\n      version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n      description: \"Playwright capture runner\",\n      kind: \"playwright\",\n      category: \"capture-runner\",\n    },\n    async render(input: PlaywrightRenderInput) {\n      const active: ActiveRun = { cancelled: false, browser: null };\n      activeRuns.set(input.buildId, active);\n      try {\n        return await renderAll(input, active);\n      } finally {\n        activeRuns.delete(input.buildId);\n      }\n    },\n    async cancel(buildId) {\n      const active = activeRuns.get(buildId);\n      if (!active) {\n        return;\n      }\n      active.cancelled = true;\n      await closeBrowser(active.browser);\n    },\n  };\n}\n\nasync function closeBrowser(browser: Browser | null): Promise<void> {\n  if (!browser) {\n    return;\n  }\n  try {\n    await browser.close();\n  } catch {\n    // The run's own `finally` performs final cleanup; cancel must never throw.\n  }\n}\n\nasync function renderAll(input: PlaywrightRenderInput, active: ActiveRun): Promise<RenderResult> {\n  const server = await createStaticServer(input.storybookDir);\n  const browser = await chromium.launch();\n  active.browser = browser;\n  const adapter = new StorybookAdapter();\n  const ctx: ScreenshotContext & { executePlay?: boolean; playTimeoutMs?: number } = {\n    browser,\n    adapter,\n    baseUrl: server.url,\n    executePlay: input.executePlay,\n    playTimeoutMs: input.playTimeoutMs,\n  };\n  const captures: RenderedSnapshot[] = [];\n  const failures: RenderResult[\"failures\"] = [];\n  try {\n    const tasks = input.viewports.flatMap((viewport) =>\n      input.stories.map(async (story) => {\n        if (active.cancelled) {\n          throw new Error(\"Capture cancelled\");\n        }\n        try {\n          const screenshot = await captureScreenshot(ctx, story, viewport);\n          captures.push({ story, viewportName: viewport.name, screenshot });\n        } catch (error) {\n          failures.push({\n            storyId: story.id,\n            viewportName: viewport.name,\n            error: messageOf(error),\n          });\n          input.logger?.error(\n            { storyId: story.id, viewport: viewport.name, err: error },\n            \"render failed for story\",\n          );\n        }\n      }),\n    );\n    await Promise.all(tasks);\n    return { captures, failures };\n  } finally {\n    active.browser = null;\n    await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);\n  }\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nasync function safeCloseBrowser(browser: Browser): Promise<void> {\n  try {\n    await browser.close();\n  } catch {\n    // Already closed by `cancel`; the run must complete without throwing.\n  }\n}\n\nasync function safeCloseServer(server: { close(): Promise<void> }): Promise<void> {\n  try {\n    await server.close();\n  } catch {\n    // Best-effort; teardown must never mask a render result.\n  }\n}\n\nasync function captureScreenshot(\n  ctx: ScreenshotContext & { executePlay?: boolean; playTimeoutMs?: number },\n  story: StoryEntry,\n  viewport: Viewport,\n): Promise<Buffer> {\n  const page = await ctx.browser.newPage({\n    viewport: { width: viewport.width, height: viewport.height },\n  });\n  try {\n    await page.goto(ctx.adapter.buildUrl(ctx.baseUrl, story.id), { waitUntil: \"networkidle\" });\n    if (ctx.adapter.screenshotSelector) {\n      await page.waitForSelector(ctx.adapter.screenshotSelector, { state: \"attached\" });\n      const delay = story.parameters?.delay ?? 500;\n      await page.waitForTimeout(delay);\n      if (story.parameters?.pauseAnimationAtEnd) {\n        await page.evaluate(() => {\n          const doc = globalThis.document as unknown as {\n            getAnimations: () => { pause: () => void }[];\n          };\n          for (const anim of doc.getAnimations()) anim.pause();\n        });\n      }\n    }\n    if (ctx.executePlay) {\n      const timeout = ctx.playTimeoutMs ?? 10_000;\n      try {\n        await page.evaluate(\n          async ({ storyId, timeoutMs }: { storyId: string; timeoutMs: number }) => {\n            const win = globalThis as unknown as {\n              __STORYBOOK_PREVIEW__?: {\n                executePlay?: (id: string) => Promise<void>;\n                storyStore?: { fromId?: (id: string) => { play?: () => Promise<void> } };\n                channel?: { on: (e: string, cb: (err: unknown) => void) => void };\n              };\n            };\n            const preview = win[\"__STORYBOOK_PREVIEW__\"];\n            if (!preview) return;\n            // Try channel-based error capture for play failures\n            let playError: unknown = null;\n            const handler = (err: unknown): void => {\n              playError = err;\n            };\n            // Storybook channel emits playFunctionThrewException on failure\n            try {\n              preview.channel?.on(\"playFunctionThrewException\", handler);\n            } catch {\n              // Channel hookup is best-effort; play still runs without it.\n            }\n            // Try direct executePlay if available (custom StoryShelf preview addition)\n            if (preview.executePlay) {\n              await Promise.race([\n                preview.executePlay(storyId),\n                new Promise((_, reject) => {\n                  setTimeout(() => {\n                    reject(new Error(`play timeout after ${timeoutMs}ms`));\n                  }, timeoutMs);\n                }),\n              ]);\n            } else if (preview.storyStore?.fromId) {\n              const loaded = preview.storyStore.fromId(storyId) as unknown as {\n                play?: (ctx: unknown) => Promise<void>;\n              };\n              if (loaded?.play) {\n                await Promise.race([\n                  loaded.play({\n                    canvasElement: globalThis.document.querySelector(\"#storybook-root\"),\n                  }),\n                  new Promise((_, reject) => {\n                    setTimeout(() => {\n                      reject(new Error(`play timeout after ${timeoutMs}ms`));\n                    }, timeoutMs);\n                  }),\n                ]);\n              }\n            }\n            if (playError) throw playError;\n          },\n          { storyId: story.id, timeoutMs: timeout },\n        );\n      } catch (error) {\n        throw new Error(`play failed: ${messageOf(error)}`, { cause: error });\n      }\n    }\n    // Playwright page.screenshot supports animations: disabled to freeze CSS animations\n    return await page.screenshot({\n      animations: story.parameters?.pauseAnimationAtEnd ? \"allow\" : \"disabled\",\n    });\n  } finally {\n    await page.close();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"capture-runner.mjs","names":[],"sources":["../src/capture-runner.ts"],"sourcesContent":["/** Playwright capture runner — composition root (factory wiring). */\n\nimport {\n  BROWSER_NAMES,\n  type BrowserName,\n  type CaptureRunner,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { activeRuns, closeBrowser } from \"./browser.ts\";\nimport { renderAll } from \"./pipeline.ts\";\nimport type { ActiveRun, PlaywrightRenderInput } from \"./types.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Create a CaptureRunner that renders Storybook stories with Playwright. */\nexport function createPlaywrightCaptureRunner(\n  options: {\n    browser?: BrowserName;\n    supportedBrowsers?: readonly BrowserName[];\n  } = {},\n): CaptureRunner {\n  const defaultBrowser = options.browser ?? \"chromium\";\n  return {\n    metadata: {\n      name: \"Playwright\",\n      version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n      description: \"Playwright capture runner\",\n      kind: \"playwright\",\n      category: \"capture-runner\",\n      supportedBrowsers: options.supportedBrowsers ?? BROWSER_NAMES,\n    },\n    async render(input: PlaywrightRenderInput) {\n      const active: ActiveRun = { cancelled: false, browser: null };\n      activeRuns.set(input.buildId, active);\n      try {\n        return await renderAll(input, active, defaultBrowser);\n      } finally {\n        activeRuns.delete(input.buildId);\n      }\n    },\n    async cancel(buildId) {\n      const active = activeRuns.get(buildId);\n      if (!active) return;\n      active.cancelled = true;\n      await closeBrowser(active.browser);\n    },\n  };\n}\n\n// Re-exports for backward compatibility (tests import these from capture-runner).\nexport type { PlaywrightRenderInput, RuntimeParamsState } from \"./types.ts\";\nexport { createRuntimeParamsState, runtimeParametersForStory } from \"./runtime-params.ts\";\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,8BACd,UAGI,CAAC,GACU;CACf,MAAM,iBAAiB,QAAQ,WAAW;CAC1C,OAAO;EACL,UAAU;GACR,MAAM;GACN,SAAU,WAAuD,mBAAmB;GACpF,aAAa;GACb,MAAM;GACN,UAAU;GACV,mBAAmB,QAAQ,qBAAqB;EAClD;EACA,MAAM,OAAO,OAA8B;GACzC,MAAM,SAAoB;IAAE,WAAW;IAAO,SAAS;GAAK;GAC5D,WAAW,IAAI,MAAM,SAAS,MAAM;GACpC,IAAI;IACF,OAAO,MAAM,UAAU,OAAO,QAAQ,cAAc;GACtD,UAAU;IACR,WAAW,OAAO,MAAM,OAAO;GACjC;EACF;EACA,MAAM,OAAO,SAAS;GACpB,MAAM,SAAS,WAAW,IAAI,OAAO;GACrC,IAAI,CAAC,QAAQ;GACb,OAAO,YAAY;GACnB,MAAM,aAAa,OAAO,OAAO;EACnC;CACF;AACF"}

package/dist/pipeline.mjs

@@ -0,0 +1,100 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { messageOf, safeCloseBrowser, safeCloseServer } from "./browser.mjs";
+import { createRuntimeParamsState } from "./runtime-params.mjs";
+import { captureScreenshot } from "./screenshot.mjs";
+import { createStaticServer } from "./static-server.mjs";
+import { StorybookAdapter, resolveStoryViewports } from "@storyshelf/core/capture";
+import { chromium, firefox, webkit } from "playwright-core";
+//#region src/pipeline.ts
+/** Render all story/viewport combinations for a build. */
+async function renderAll(input, active, defaultBrowser) {
+	const server = await createStaticServer(input.storybookDir);
+	return await runWithBrowser(input, active, await launchBrowser(input.browser ?? defaultBrowser), server);
+}
+async function runWithBrowser(input, active, browser, server) {
+	active.browser = browser;
+	const ctx = buildContext(browser, server.url, input);
+	const captures = [];
+	const failures = [];
+	try {
+		await runAllCaptures(input, active, ctx, captures, failures);
+		return {
+			captures,
+			failures
+		};
+	} finally {
+		active.browser = null;
+		await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);
+	}
+}
+async function launchBrowser(name) {
+	if (name === "firefox") return await firefox.launch();
+	if (name === "webkit") return await webkit.launch();
+	return await chromium.launch();
+}
+function buildContext(browser, baseUrl, input) {
+	return {
+		browser,
+		adapter: input.adapter ?? new StorybookAdapter(),
+		baseUrl,
+		executePlay: input.executePlay,
+		playTimeoutMs: input.playTimeoutMs,
+		runA11y: input.runA11y,
+		runtimeParams: createRuntimeParamsState()
+	};
+}
+async function runAllCaptures(input, active, ctx, captures, failures) {
+	const tasks = input.stories.flatMap((story) => viewportsTasks(story, input, active, ctx, captures, failures));
+	await Promise.all(tasks);
+}
+function viewportsTasks(story, input, active, ctx, captures, failures) {
+	return resolveStoryViewports(story, input.viewports).map((viewport) => captureOne(input, active, ctx, story, viewport, captures, failures));
+}
+async function captureOne(input, active, ctx, story, viewport, captures, failures) {
+	if (active.cancelled) throw new Error("Capture cancelled");
+	try {
+		await pushCapture(ctx, story, viewport, captures, failures, input);
+	} catch (error) {
+		pushRenderFailure(failures, input, story.id, viewport.name, error);
+	}
+}
+async function pushCapture(ctx, story, viewport, captures, failures, input) {
+	const result = await captureScreenshot(ctx, story, viewport);
+	captures.push({
+		story: result.story,
+		viewportName: viewport.name,
+		viewport,
+		screenshot: result.screenshot
+	});
+	if (result.a11yViolations.length > 0) handleA11y(input, failures, story, viewport, result.a11yViolations);
+}
+function handleA11y(input, failures, story, viewport, violations) {
+	failures.push({
+		storyId: story.id,
+		viewportName: viewport.name,
+		error: `a11y: ${violations.join("; ")}`
+	});
+	input.logger?.warn({
+		storyId: story.id,
+		viewport: viewport.name,
+		violations
+	}, "a11y violations found");
+}
+function pushRenderFailure(failures, input, storyId, viewportName, error) {
+	failures.push({
+		storyId,
+		viewportName,
+		error: messageOf(error)
+	});
+	input.logger?.error({
+		storyId,
+		viewport: viewportName,
+		err: error
+	}, "render failed for story");
+}
+//#endregion
+export { renderAll };
+
+//# sourceMappingURL=pipeline.mjs.map

package/dist/pipeline.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.mjs","names":[],"sources":["../src/pipeline.ts"],"sourcesContent":["/** Render orchestration: static server, browser, and per-story captures. */\n\nimport type {\n  BrowserName,\n  RenderResult,\n  RenderedSnapshot,\n  StoryEntry,\n  Viewport,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { StorybookAdapter, resolveStoryViewports } from \"@storyshelf/core/capture\";\nimport type { Browser } from \"playwright-core\";\nimport { chromium, firefox, webkit } from \"playwright-core\";\nimport { messageOf, safeCloseBrowser, safeCloseServer } from \"./browser.ts\";\nimport { createRuntimeParamsState } from \"./runtime-params.ts\";\nimport { captureScreenshot } from \"./screenshot.ts\";\nimport { createStaticServer } from \"./static-server.ts\";\nimport type { ActiveRun, CaptureContext, PlaywrightRenderInput } from \"./types.ts\";\n\n/** Render all story/viewport combinations for a build. */\nexport async function renderAll(\n  input: PlaywrightRenderInput,\n  active: ActiveRun,\n  defaultBrowser: BrowserName,\n): Promise<RenderResult> {\n  const server = await createStaticServer(input.storybookDir);\n  const browser = await launchBrowser(input.browser ?? defaultBrowser);\n  return await runWithBrowser(input, active, browser, server);\n}\n\nasync function runWithBrowser(\n  input: PlaywrightRenderInput,\n  active: ActiveRun,\n  browser: Browser,\n  server: Awaited<ReturnType<typeof createStaticServer>>,\n): Promise<RenderResult> {\n  active.browser = browser;\n  const ctx = buildContext(browser, server.url, input);\n  const captures: RenderedSnapshot[] = [];\n  const failures: RenderResult[\"failures\"] = [];\n  try {\n    await runAllCaptures(input, active, ctx, captures, failures);\n    return { captures, failures };\n  } finally {\n    active.browser = null;\n    await Promise.all([safeCloseBrowser(browser), safeCloseServer(server)]);\n  }\n}\n\nasync function launchBrowser(name: BrowserName): Promise<Browser> {\n  if (name === \"firefox\") return await firefox.launch();\n  if (name === \"webkit\") return await webkit.launch();\n  return await chromium.launch();\n}\n\nfunction buildContext(\n  browser: Browser,\n  baseUrl: string,\n  input: PlaywrightRenderInput,\n): CaptureContext {\n  return {\n    browser,\n    adapter: input.adapter ?? new StorybookAdapter(),\n    baseUrl,\n    executePlay: input.executePlay,\n    playTimeoutMs: input.playTimeoutMs,\n    runA11y: input.runA11y,\n    runtimeParams: createRuntimeParamsState(),\n  };\n}\n\nasync function runAllCaptures(\n  input: PlaywrightRenderInput,\n  active: ActiveRun,\n  ctx: CaptureContext,\n  captures: RenderedSnapshot[],\n  failures: RenderResult[\"failures\"],\n): Promise<void> {\n  const tasks = input.stories.flatMap((story) =>\n    viewportsTasks(story, input, active, ctx, captures, failures),\n  );\n  await Promise.all(tasks);\n}\nfunction viewportsTasks(\n  story: StoryEntry,\n  input: PlaywrightRenderInput,\n  active: ActiveRun,\n  ctx: CaptureContext,\n  captures: RenderedSnapshot[],\n  failures: RenderResult[\"failures\"],\n): Promise<void>[] {\n  // oxlint-disable-next-line typescript/promise-function-async -- returns array of promises, not a single promise\n  return resolveStoryViewports(story, input.viewports).map((viewport) =>\n    captureOne(input, active, ctx, story, viewport, captures, failures),\n  );\n}\n\nasync function captureOne(\n  input: PlaywrightRenderInput,\n  active: ActiveRun,\n  ctx: CaptureContext,\n  story: StoryEntry,\n  viewport: Viewport,\n  captures: RenderedSnapshot[],\n  failures: RenderResult[\"failures\"],\n): Promise<void> {\n  if (active.cancelled) throw new Error(\"Capture cancelled\");\n  try {\n    await pushCapture(ctx, story, viewport, captures, failures, input);\n  } catch (error) {\n    pushRenderFailure(failures, input, story.id, viewport.name, error);\n  }\n}\n\nasync function pushCapture(\n  ctx: CaptureContext,\n  story: StoryEntry,\n  viewport: Viewport,\n  captures: RenderedSnapshot[],\n  failures: RenderResult[\"failures\"],\n  input: PlaywrightRenderInput,\n): Promise<void> {\n  const result = await captureScreenshot(ctx, story, viewport);\n  captures.push({\n    story: result.story,\n    viewportName: viewport.name,\n    viewport,\n    screenshot: result.screenshot,\n  });\n  if (result.a11yViolations.length > 0)\n    handleA11y(input, failures, story, viewport, result.a11yViolations);\n}\nfunction handleA11y(\n  input: PlaywrightRenderInput,\n  failures: RenderResult[\"failures\"],\n  story: StoryEntry,\n  viewport: Viewport,\n  violations: string[],\n): void {\n  failures.push({\n    storyId: story.id,\n    viewportName: viewport.name,\n    error: `a11y: ${violations.join(\"; \")}`,\n  });\n  input.logger?.warn(\n    { storyId: story.id, viewport: viewport.name, violations },\n    \"a11y violations found\",\n  );\n}\n\nfunction pushRenderFailure(\n  failures: RenderResult[\"failures\"],\n  input: PlaywrightRenderInput,\n  storyId: string,\n  viewportName: string,\n  error: unknown,\n): void {\n  failures.push({ storyId, viewportName, error: messageOf(error) });\n  input.logger?.error({ storyId, viewport: viewportName, err: error }, \"render failed for story\");\n}\n"],"mappings":";;;;;;;;;;;AAmBA,eAAsB,UACpB,OACA,QACA,gBACuB;CACvB,MAAM,SAAS,MAAM,mBAAmB,MAAM,YAAY;CAE1D,OAAO,MAAM,eAAe,OAAO,QAAQ,MADrB,cAAc,MAAM,WAAW,cAAc,GACf,MAAM;AAC5D;AAEA,eAAe,eACb,OACA,QACA,SACA,QACuB;CACvB,OAAO,UAAU;CACjB,MAAM,MAAM,aAAa,SAAS,OAAO,KAAK,KAAK;CACnD,MAAM,WAA+B,CAAC;CACtC,MAAM,WAAqC,CAAC;CAC5C,IAAI;EACF,MAAM,eAAe,OAAO,QAAQ,KAAK,UAAU,QAAQ;EAC3D,OAAO;GAAE;GAAU;EAAS;CAC9B,UAAU;EACR,OAAO,UAAU;EACjB,MAAM,QAAQ,IAAI,CAAC,iBAAiB,OAAO,GAAG,gBAAgB,MAAM,CAAC,CAAC;CACxE;AACF;AAEA,eAAe,cAAc,MAAqC;CAChE,IAAI,SAAS,WAAW,OAAO,MAAM,QAAQ,OAAO;CACpD,IAAI,SAAS,UAAU,OAAO,MAAM,OAAO,OAAO;CAClD,OAAO,MAAM,SAAS,OAAO;AAC/B;AAEA,SAAS,aACP,SACA,SACA,OACgB;CAChB,OAAO;EACL;EACA,SAAS,MAAM,WAAW,IAAI,iBAAiB;EAC/C;EACA,aAAa,MAAM;EACnB,eAAe,MAAM;EACrB,SAAS,MAAM;EACf,eAAe,yBAAyB;CAC1C;AACF;AAEA,eAAe,eACb,OACA,QACA,KACA,UACA,UACe;CACf,MAAM,QAAQ,MAAM,QAAQ,SAAS,UACnC,eAAe,OAAO,OAAO,QAAQ,KAAK,UAAU,QAAQ,CAC9D;CACA,MAAM,QAAQ,IAAI,KAAK;AACzB;AACA,SAAS,eACP,OACA,OACA,QACA,KACA,UACA,UACiB;CAEjB,OAAO,sBAAsB,OAAO,MAAM,SAAS,CAAC,CAAC,KAAK,aACxD,WAAW,OAAO,QAAQ,KAAK,OAAO,UAAU,UAAU,QAAQ,CACpE;AACF;AAEA,eAAe,WACb,OACA,QACA,KACA,OACA,UACA,UACA,UACe;CACf,IAAI,OAAO,WAAW,MAAM,IAAI,MAAM,mBAAmB;CACzD,IAAI;EACF,MAAM,YAAY,KAAK,OAAO,UAAU,UAAU,UAAU,KAAK;CACnE,SAAS,OAAO;EACd,kBAAkB,UAAU,OAAO,MAAM,IAAI,SAAS,MAAM,KAAK;CACnE;AACF;AAEA,eAAe,YACb,KACA,OACA,UACA,UACA,UACA,OACe;CACf,MAAM,SAAS,MAAM,kBAAkB,KAAK,OAAO,QAAQ;CAC3D,SAAS,KAAK;EACZ,OAAO,OAAO;EACd,cAAc,SAAS;EACvB;EACA,YAAY,OAAO;CACrB,CAAC;CACD,IAAI,OAAO,eAAe,SAAS,GACjC,WAAW,OAAO,UAAU,OAAO,UAAU,OAAO,cAAc;AACtE;AACA,SAAS,WACP,OACA,UACA,OACA,UACA,YACM;CACN,SAAS,KAAK;EACZ,SAAS,MAAM;EACf,cAAc,SAAS;EACvB,OAAO,SAAS,WAAW,KAAK,IAAI;CACtC,CAAC;CACD,MAAM,QAAQ,KACZ;EAAE,SAAS,MAAM;EAAI,UAAU,SAAS;EAAM;CAAW,GACzD,uBACF;AACF;AAEA,SAAS,kBACP,UACA,OACA,SACA,cACA,OACM;CACN,SAAS,KAAK;EAAE;EAAS;EAAc,OAAO,UAAU,KAAK;CAAE,CAAC;CAChE,MAAM,QAAQ,MAAM;EAAE;EAAS,UAAU;EAAc,KAAK;CAAM,GAAG,yBAAyB;AAChG"}

package/dist/play.mjs

@@ -0,0 +1,50 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { messageOf } from "./browser.mjs";
+//#region src/play.ts
+/** Execute the story's play function with a timeout race. */
+async function runPlay(page, storyId, timeoutMs) {
+	try {
+		await page.evaluate(inPagePlay, {
+			storyId,
+			timeoutMs
+		});
+	} catch (error) {
+		throw new Error(`play failed: ${messageOf(error)}`, { cause: error });
+	}
+}
+/**
+* Runs inside the browser. Playwright serializes only this function's source, so it must not
+* reference anything from this module (helpers, imports): split it up and the page throws
+* `ReferenceError`. `play.test.ts` evaluates it in a scope without module bindings to guard that.
+*/
+async function inPagePlay({ storyId, timeoutMs }) {
+	const preview = globalThis["__STORYBOOK_PREVIEW__"];
+	if (!preview) return;
+	let playError = null;
+	try {
+		preview.channel?.on("playFunctionThrewException", (err) => {
+			playError = err;
+		});
+	} catch {}
+	const canvasElement = globalThis.document?.querySelector("#storybook-root");
+	const work = preview.executePlay ? preview.executePlay(storyId) : preview.storyStore?.fromId?.(storyId)?.play?.({ canvasElement });
+	if (!work) return;
+	let timer;
+	const timeout = new Promise((_resolve, reject) => {
+		timer = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error(`play timeout after ${timeoutMs}ms`));
+		}, timeoutMs);
+	});
+	try {
+		await Promise.race([work, timeout]);
+	} finally {
+		clearTimeout(timer);
+	}
+	if (playError) throw playError;
+}
+//#endregion
+export { inPagePlay, runPlay };
+
+//# sourceMappingURL=play.mjs.map

package/dist/play.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"play.mjs","names":[],"sources":["../src/play.ts"],"sourcesContent":["/** Storybook `play` function execution inside the page. */\n\nimport type { Page } from \"playwright-core\";\nimport { messageOf } from \"./browser.ts\";\n\n/** Arguments serialized into the page for {@link inPagePlay}. */\nexport interface PlayArgs {\n  storyId: string;\n  timeoutMs: number;\n}\n\n/** Execute the story's play function with a timeout race. */\nexport async function runPlay(page: Page, storyId: string, timeoutMs: number): Promise<void> {\n  try {\n    await page.evaluate(inPagePlay, { storyId, timeoutMs });\n  } catch (error) {\n    throw new Error(`play failed: ${messageOf(error)}`, { cause: error });\n  }\n}\n\n/**\n * Runs inside the browser. Playwright serializes only this function's source, so it must not\n * reference anything from this module (helpers, imports): split it up and the page throws\n * `ReferenceError`. `play.test.ts` evaluates it in a scope without module bindings to guard that.\n */\n// oxlint-disable-next-line eslint/max-statements -- must stay one self-contained function (see above)\nexport async function inPagePlay({ storyId, timeoutMs }: PlayArgs): Promise<void> {\n  type Preview = {\n    executePlay?: (id: string) => Promise<void>;\n    storyStore?: { fromId?: (id: string) => { play?: (ctx: unknown) => Promise<void> } };\n    channel?: { on: (event: string, cb: (err: unknown) => void) => void };\n  };\n  const preview = (globalThis as unknown as Record<string, Preview | undefined>)[\n    \"__STORYBOOK_PREVIEW__\"\n  ];\n  if (!preview) return;\n  let playError: unknown = null;\n  try {\n    // Best-effort: play still runs without the channel hookup.\n    preview.channel?.on(\"playFunctionThrewException\", (err) => {\n      playError = err;\n    });\n  } catch {\n    // ignore\n  }\n  const canvasElement = globalThis.document?.querySelector(\"#storybook-root\");\n  const work = preview.executePlay\n    ? preview.executePlay(storyId)\n    : preview.storyStore?.fromId?.(storyId)?.play?.({ canvasElement });\n  if (!work) return;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<never>((_resolve, reject) => {\n    timer = setTimeout(() => {\n      reject(new Error(`play timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n  });\n  try {\n    await Promise.race([work, timeout]);\n  } finally {\n    clearTimeout(timer);\n  }\n  if (playError) throw playError;\n}\n"],"mappings":";;;;;;AAYA,eAAsB,QAAQ,MAAY,SAAiB,WAAkC;CAC3F,IAAI;EACF,MAAM,KAAK,SAAS,YAAY;GAAE;GAAS;EAAU,CAAC;CACxD,SAAS,OAAO;EACd,MAAM,IAAI,MAAM,gBAAgB,UAAU,KAAK,KAAK,EAAE,OAAO,MAAM,CAAC;CACtE;AACF;;;;;;AAQA,eAAsB,WAAW,EAAE,SAAS,aAAsC;CAMhF,MAAM,UAAW,WACf;CAEF,IAAI,CAAC,SAAS;CACd,IAAI,YAAqB;CACzB,IAAI;EAEF,QAAQ,SAAS,GAAG,+BAA+B,QAAQ;GACzD,YAAY;EACd,CAAC;CACH,QAAQ,CAER;CACA,MAAM,gBAAgB,WAAW,UAAU,cAAc,iBAAiB;CAC1E,MAAM,OAAO,QAAQ,cACjB,QAAQ,YAAY,OAAO,IAC3B,QAAQ,YAAY,SAAS,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC;CACnE,IAAI,CAAC,MAAM;CACX,IAAI;CACJ,MAAM,UAAU,IAAI,SAAgB,UAAU,WAAW;EACvD,QAAQ,iBAAiB;GACvB,uBAAO,IAAI,MAAM,sBAAsB,UAAU,GAAG,CAAC;EACvD,GAAG,SAAS;CACd,CAAC;CACD,IAAI;EACF,MAAM,QAAQ,KAAK,CAAC,MAAM,OAAO,CAAC;CACpC,UAAU;EACR,aAAa,KAAK;CACpB;CACA,IAAI,WAAW,MAAM;AACvB"}

package/dist/runtime-params.d.mts

@@ -0,0 +1,4 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import "./types.mjs";
+import "@storyshelf/core/capture";

package/dist/runtime-params.mjs

@@ -0,0 +1,60 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { mergeParameters } from "@storyshelf/core/capture";
+//#region src/runtime-params.ts
+/** Per-run runtime-parameter extraction cache (ADR 0017). */
+/** Create the per-run runtime-parameter cache shared across captures. */
+function createRuntimeParamsState() {
+	return {};
+}
+/**
+* Read story parameters from the running preview via
+* `__STORYBOOK_PREVIEW__.extract()`, once per run and lazily.
+*/
+async function runtimeParametersForStory(state, page, storyId) {
+	return (state.extractFailed ? void 0 : await extractedParametersMap(state, page))?.get(storyId);
+}
+async function extractedParametersMap(state, page) {
+	state.extractPromise ??= loadExtractedParametersMap(state, page);
+	return await state.extractPromise;
+}
+async function loadExtractedParametersMap(state, page) {
+	return buildParamsMap(state, await safeReadExtracted(state, page));
+}
+async function safeReadExtracted(state, page) {
+	try {
+		return await readExtractedParameters(page);
+	} catch {
+		state.extractFailed = true;
+		return null;
+	}
+}
+function buildParamsMap(state, raw) {
+	const out = /* @__PURE__ */ new Map();
+	if (raw) fillParamsMap(out, raw);
+	if (out.size === 0) state.extractFailed = true;
+	return out;
+}
+function fillParamsMap(out, raw) {
+	for (const [id, entry] of Object.entries(raw)) {
+		const merged = mergeParameters(entry);
+		if (merged) out.set(id, merged);
+	}
+}
+async function readExtractedParameters(page) {
+	const map = await page.evaluate(() => {
+		const preview = globalThis["__STORYBOOK_PREVIEW__"];
+		if (!preview || typeof preview.extract !== "function") return null;
+		const extracted = preview.extract();
+		return extracted && typeof extracted === "object" ? extracted : null;
+	});
+	return hasEntries(map) ? map : null;
+}
+function hasEntries(map) {
+	return Boolean(map && Object.keys(map).length > 0);
+}
+//#endregion
+export { createRuntimeParamsState, runtimeParametersForStory };
+
+//# sourceMappingURL=runtime-params.mjs.map

package/dist/runtime-params.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-params.mjs","names":["win"],"sources":["../src/runtime-params.ts"],"sourcesContent":["/** Per-run runtime-parameter extraction cache (ADR 0017). */\n\nimport { mergeParameters } from \"@storyshelf/core/capture\";\nimport type { StoryParameters } from \"@storyshelf/core/capture\";\nimport type { ExtractedEntry, RuntimeParamsPage, RuntimeParamsState } from \"./types.ts\";\n\n/** Create the per-run runtime-parameter cache shared across captures. */\nexport function createRuntimeParamsState(): RuntimeParamsState {\n  return {};\n}\n\n/**\n * Read story parameters from the running preview via\n * `__STORYBOOK_PREVIEW__.extract()`, once per run and lazily.\n */\nexport async function runtimeParametersForStory(\n  state: RuntimeParamsState,\n  page: RuntimeParamsPage,\n  storyId: string,\n): Promise<StoryParameters | undefined> {\n  const map = state.extractFailed ? undefined : await extractedParametersMap(state, page);\n  return map?.get(storyId);\n}\n\nasync function extractedParametersMap(\n  state: RuntimeParamsState,\n  page: RuntimeParamsPage,\n): Promise<Map<string, StoryParameters>> {\n  state.extractPromise ??= loadExtractedParametersMap(state, page);\n  return await state.extractPromise;\n}\n\nasync function loadExtractedParametersMap(\n  state: RuntimeParamsState,\n  page: RuntimeParamsPage,\n): Promise<Map<string, StoryParameters>> {\n  const raw = await safeReadExtracted(state, page);\n  return buildParamsMap(state, raw);\n}\n\nasync function safeReadExtracted(\n  state: RuntimeParamsState,\n  page: RuntimeParamsPage,\n): Promise<Record<string, ExtractedEntry> | null> {\n  try {\n    return await readExtractedParameters(page);\n  } catch {\n    state.extractFailed = true;\n    return null;\n  }\n}\n\nfunction buildParamsMap(\n  state: RuntimeParamsState,\n  raw: Record<string, ExtractedEntry> | null,\n): Map<string, StoryParameters> {\n  const out = new Map<string, StoryParameters>();\n  if (raw) fillParamsMap(out, raw);\n  if (out.size === 0) state.extractFailed = true;\n  return out;\n}\n\nfunction fillParamsMap(\n  out: Map<string, StoryParameters>,\n  raw: Record<string, ExtractedEntry>,\n): void {\n  for (const [id, entry] of Object.entries(raw)) {\n    const merged = mergeParameters(entry);\n    if (merged) out.set(id, merged);\n  }\n}\n\nasync function readExtractedParameters(\n  page: RuntimeParamsPage,\n): Promise<Record<string, ExtractedEntry> | null> {\n  const map = (await page.evaluate(() => {\n    const win = globalThis as unknown as {\n      __STORYBOOK_PREVIEW__?: { extract?: () => unknown };\n    };\n    // oxlint-disable-next-line typescript/dot-notation -- __STORYBOOK_PREVIEW__ is a Storybook global\n    const preview = win[\"__STORYBOOK_PREVIEW__\"];\n    if (!preview || typeof preview.extract !== \"function\") return null;\n    const extracted = preview.extract();\n    return extracted && typeof extracted === \"object\"\n      ? (extracted as Record<string, ExtractedEntry>)\n      : null;\n  })) as Record<string, ExtractedEntry> | null;\n  return hasEntries(map) ? map : null;\n}\n\nfunction hasEntries(map: Record<string, ExtractedEntry> | null): boolean {\n  return Boolean(map && Object.keys(map).length > 0);\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,2BAA+C;CAC7D,OAAO,CAAC;AACV;;;;;AAMA,eAAsB,0BACpB,OACA,MACA,SACsC;CAEtC,QADY,MAAM,gBAAgB,KAAA,IAAY,MAAM,uBAAuB,OAAO,IAAI,EAAA,EAC1E,IAAI,OAAO;AACzB;AAEA,eAAe,uBACb,OACA,MACuC;CACvC,MAAM,mBAAmB,2BAA2B,OAAO,IAAI;CAC/D,OAAO,MAAM,MAAM;AACrB;AAEA,eAAe,2BACb,OACA,MACuC;CAEvC,OAAO,eAAe,OAAO,MADX,kBAAkB,OAAO,IAAI,CACf;AAClC;AAEA,eAAe,kBACb,OACA,MACgD;CAChD,IAAI;EACF,OAAO,MAAM,wBAAwB,IAAI;CAC3C,QAAQ;EACN,MAAM,gBAAgB;EACtB,OAAO;CACT;AACF;AAEA,SAAS,eACP,OACA,KAC8B;CAC9B,MAAM,sBAAM,IAAI,IAA6B;CAC7C,IAAI,KAAK,cAAc,KAAK,GAAG;CAC/B,IAAI,IAAI,SAAS,GAAG,MAAM,gBAAgB;CAC1C,OAAO;AACT;AAEA,SAAS,cACP,KACA,KACM;CACN,KAAK,MAAM,CAAC,IAAI,UAAU,OAAO,QAAQ,GAAG,GAAG;EAC7C,MAAM,SAAS,gBAAgB,KAAK;EACpC,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM;CAChC;AACF;AAEA,eAAe,wBACb,MACgD;CAChD,MAAM,MAAO,MAAM,KAAK,eAAe;EAKrC,MAAM,UAAUA,WAAI;EACpB,IAAI,CAAC,WAAW,OAAO,QAAQ,YAAY,YAAY,OAAO;EAC9D,MAAM,YAAY,QAAQ,QAAQ;EAClC,OAAO,aAAa,OAAO,cAAc,WACpC,YACD;CACN,CAAC;CACD,OAAO,WAAW,GAAG,IAAI,MAAM;AACjC;AAEA,SAAS,WAAW,KAAqD;CACvE,OAAO,QAAQ,OAAO,OAAO,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC;AACnD"}

package/dist/screenshot.mjs

@@ -0,0 +1,113 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { runtimeParametersForStory } from "./runtime-params.mjs";
+import { checkA11y } from "./a11y.mjs";
+import { runPlay } from "./play.mjs";
+import { getScreenshotPlan } from "@storyshelf/core/capture";
+//#region src/screenshot.ts
+/** Capture a screenshot for one story/viewport, returning buffer + a11y violations. */
+async function captureScreenshot(ctx, inputStory, viewport) {
+	const page = await ctx.browser.newPage({ viewport: {
+		width: viewport.width,
+		height: viewport.height
+	} });
+	try {
+		return await runCapture(page, ctx, inputStory, viewport);
+	} finally {
+		await page.close();
+	}
+}
+async function runCapture(page, ctx, inputStory, viewport) {
+	const story = await navigateAndEnrich(ctx, page, inputStory);
+	await maybeWaitForSelector(ctx, page, story);
+	if (ctx.executePlay) await runPlay(page, story.id, ctx.playTimeoutMs ?? 1e4);
+	const a11yViolations = await getA11y(ctx, page);
+	await settlePage(page, story);
+	const plan = await resolvePlan(page, viewport, story);
+	if (plan.viewport.width !== viewport.width || plan.viewport.height !== viewport.height) await page.setViewportSize(plan.viewport);
+	return {
+		screenshot: await burstShots(page, plan, story),
+		a11yViolations,
+		story
+	};
+}
+async function navigateAndEnrich(ctx, page, story) {
+	await page.goto(ctx.adapter.buildUrl(ctx.baseUrl, story.id), { waitUntil: "networkidle" });
+	await ctx.adapter.waitForReady?.(page);
+	if (story.parameters) return story;
+	const rpPage = page;
+	const params = await runtimeParametersForStory(ctx.runtimeParams, rpPage, story.id);
+	return params ? {
+		...story,
+		parameters: params
+	} : story;
+}
+async function maybeWaitForSelector(ctx, page, story) {
+	if (!ctx.adapter.screenshotSelector) return;
+	await page.waitForSelector(ctx.adapter.screenshotSelector, { state: "attached" });
+	await page.waitForTimeout(story.parameters?.delay ?? 500);
+	if (story.parameters?.pauseAnimationAtEnd) await page.evaluate(() => {
+		const doc = globalThis.document;
+		for (const anim of doc.getAnimations()) anim.pause();
+	});
+}
+async function getA11y(ctx, page) {
+	if (!ctx.runA11y) return [];
+	try {
+		return await checkA11y(page);
+	} catch {
+		return [];
+	}
+}
+async function settlePage(page, story) {
+	const burst = story.parameters?.burst ?? 1;
+	if (story.parameters?.waitForFonts ?? burst > 1) try {
+		await page.evaluate(async () => {
+			await globalThis.document.fonts.ready;
+		});
+	} catch {}
+	try {
+		await page.evaluate(() => {
+			for (const vid of globalThis.document.querySelectorAll("video")) vid.pause();
+		});
+	} catch {}
+}
+async function resolvePlan(page, viewport, story) {
+	const box = await page.locator("#storybook-root").boundingBox().catch(() => null);
+	return getScreenshotPlan(viewport, box, {
+		autoCrop: story.parameters?.autoCrop,
+		whitespaceThreshold: story.parameters?.autoCropThreshold,
+		fullPageOnOverflow: story.parameters?.fullPageOnOverflow,
+		minWidth: story.parameters?.minWidth,
+		minHeight: story.parameters?.minHeight,
+		maxWidth: story.parameters?.maxWidth,
+		maxHeight: story.parameters?.maxHeight
+	});
+}
+async function burstShots(page, plan, story) {
+	const count = Math.max(1, Math.min(5, story.parameters?.burst ?? 1));
+	const shots = [];
+	for (let i = 0; i < count; i += 1) {
+		if (i > 0) await page.waitForTimeout(100);
+		shots.push(await shotOne(page, plan, story));
+	}
+	const preferred = shots[Math.floor(shots.length / 2)] ?? shots[0];
+	if (preferred) return preferred;
+	return await page.screenshot({
+		animations: story.parameters?.pauseAnimationAtEnd ? "allow" : "disabled",
+		...plan.fullPage ? { fullPage: true } : {},
+		...plan.clip ? { clip: plan.clip } : {}
+	});
+}
+async function shotOne(page, plan, story) {
+	return await page.screenshot({
+		animations: story.parameters?.pauseAnimationAtEnd ? "allow" : "disabled",
+		...plan.fullPage ? { fullPage: true } : {},
+		...plan.clip ? { clip: plan.clip } : {}
+	});
+}
+//#endregion
+export { captureScreenshot };
+
+//# sourceMappingURL=screenshot.mjs.map

package/dist/screenshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.mjs","names":[],"sources":["../src/screenshot.ts"],"sourcesContent":["/** Screenshot pipeline for a single story + viewport. */\n\nimport type { StoryEntry, Viewport } from \"@storyshelf/core/adapter/capture-runner\";\nimport { getScreenshotPlan } from \"@storyshelf/core/capture\";\nimport type { Page } from \"playwright-core\";\nimport { checkA11y } from \"./a11y.ts\";\nimport { runPlay } from \"./play.ts\";\nimport { runtimeParametersForStory } from \"./runtime-params.ts\";\nimport type { CaptureContext, RuntimeParamsPage } from \"./types.ts\";\n\n/** Capture a screenshot for one story/viewport, returning buffer + a11y violations. */\nexport async function captureScreenshot(\n  ctx: CaptureContext,\n  inputStory: StoryEntry,\n  viewport: Viewport,\n): Promise<{ screenshot: Buffer; a11yViolations: string[]; story: StoryEntry }> {\n  const page = await ctx.browser.newPage({\n    viewport: { width: viewport.width, height: viewport.height },\n  });\n  try {\n    return await runCapture(page, ctx, inputStory, viewport);\n  } finally {\n    await page.close();\n  }\n}\n\nasync function runCapture(\n  page: Page,\n  ctx: CaptureContext,\n  inputStory: StoryEntry,\n  viewport: Viewport,\n): Promise<{ screenshot: Buffer; a11yViolations: string[]; story: StoryEntry }> {\n  const story = await navigateAndEnrich(ctx, page, inputStory);\n  await maybeWaitForSelector(ctx, page, story);\n  if (ctx.executePlay) await runPlay(page, story.id, ctx.playTimeoutMs ?? 10_000);\n  const a11yViolations = await getA11y(ctx, page);\n  await settlePage(page, story);\n  const plan = await resolvePlan(page, viewport, story);\n  if (plan.viewport.width !== viewport.width || plan.viewport.height !== viewport.height)\n    await page.setViewportSize(plan.viewport);\n  const screenshot = await burstShots(page, plan, story);\n  return { screenshot, a11yViolations, story };\n}\n\nasync function navigateAndEnrich(\n  ctx: CaptureContext,\n  page: Page,\n  story: StoryEntry,\n): Promise<StoryEntry> {\n  await page.goto(ctx.adapter.buildUrl(ctx.baseUrl, story.id), { waitUntil: \"networkidle\" });\n  await ctx.adapter.waitForReady?.(page);\n  if (story.parameters) return story;\n  const rpPage = page as unknown as RuntimeParamsPage;\n  const params = await runtimeParametersForStory(ctx.runtimeParams, rpPage, story.id);\n  return params ? { ...story, parameters: params } : story;\n}\nasync function maybeWaitForSelector(\n  ctx: CaptureContext,\n  page: Page,\n  story: StoryEntry,\n): Promise<void> {\n  if (!ctx.adapter.screenshotSelector) return;\n  await page.waitForSelector(ctx.adapter.screenshotSelector, { state: \"attached\" });\n  await page.waitForTimeout(story.parameters?.delay ?? 500);\n  if (story.parameters?.pauseAnimationAtEnd) {\n    await page.evaluate(() => {\n      const doc = globalThis.document as unknown as {\n        getAnimations: () => { pause: () => void }[];\n      };\n      for (const anim of doc.getAnimations()) anim.pause();\n    });\n  }\n}\nasync function getA11y(ctx: CaptureContext, page: Page): Promise<string[]> {\n  if (!ctx.runA11y) return [];\n  try {\n    return await checkA11y(page);\n  } catch {\n    return [];\n  }\n}\nasync function settlePage(page: Page, story: StoryEntry): Promise<void> {\n  const burst = story.parameters?.burst ?? 1;\n  const waitFonts = story.parameters?.waitForFonts ?? burst > 1;\n  if (waitFonts) {\n    try {\n      await page.evaluate(async () => {\n        await (globalThis as unknown as { document: { fonts: { ready: Promise<void> } } }).document\n          .fonts.ready;\n      });\n    } catch {\n      // best-effort\n    }\n  }\n  try {\n    await page.evaluate(() => {\n      for (const vid of (globalThis as unknown as { document: Document }).document.querySelectorAll(\n        \"video\",\n      ))\n        // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- narrow to HTMLVideoElement\n        (vid as unknown as HTMLVideoElement).pause();\n    });\n  } catch {\n    // best-effort\n  }\n}\nasync function resolvePlan(\n  page: Page,\n  viewport: Viewport,\n  story: StoryEntry,\n): Promise<ReturnType<typeof getScreenshotPlan>> {\n  const box = await page\n    .locator(\"#storybook-root\")\n    .boundingBox()\n    .catch(() => null);\n  return getScreenshotPlan(viewport, box, {\n    autoCrop: story.parameters?.autoCrop,\n    whitespaceThreshold: story.parameters?.autoCropThreshold,\n    fullPageOnOverflow: story.parameters?.fullPageOnOverflow,\n    minWidth: story.parameters?.minWidth,\n    minHeight: story.parameters?.minHeight,\n    maxWidth: story.parameters?.maxWidth,\n    maxHeight: story.parameters?.maxHeight,\n  });\n}\nasync function burstShots(\n  page: Page,\n  plan: ReturnType<typeof getScreenshotPlan>,\n  story: StoryEntry,\n): Promise<Buffer> {\n  const count = Math.max(1, Math.min(5, story.parameters?.burst ?? 1));\n  const shots: Buffer[] = [];\n  for (let i = 0; i < count; i += 1) {\n    if (i > 0) {\n      // oxlint-disable-next-line eslint/no-await-in-loop -- sequential burst\n      await page.waitForTimeout(100);\n    }\n    // oxlint-disable-next-line eslint/no-await-in-loop -- sequential burst\n    shots.push(await shotOne(page, plan, story));\n  }\n  const preferred = shots[Math.floor(shots.length / 2)] ?? shots[0];\n  if (preferred) return preferred;\n  const fallback: unknown = await page.screenshot({\n    animations: story.parameters?.pauseAnimationAtEnd ? \"allow\" : \"disabled\",\n    ...(plan.fullPage ? { fullPage: true } : {}),\n    ...(plan.clip ? { clip: plan.clip } : {}),\n  });\n  // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- Buffer narrowing\n  return fallback as unknown as Buffer;\n}\nasync function shotOne(\n  page: Page,\n  plan: ReturnType<typeof getScreenshotPlan>,\n  story: StoryEntry,\n): Promise<Buffer> {\n  const shot: unknown = await page.screenshot({\n    animations: story.parameters?.pauseAnimationAtEnd ? \"allow\" : \"disabled\",\n    ...(plan.fullPage ? { fullPage: true } : {}),\n    ...(plan.clip ? { clip: plan.clip } : {}),\n  });\n  // oxlint-disable-next-line typescript/no-unnecessary-type-assertion -- Buffer narrowing\n  return shot as unknown as Buffer;\n}\n"],"mappings":"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"}

package/dist/static-server.mjs

@@ -1,26 +1,33 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { isPathSafe, mimeFor } from "@storyshelf/core/utils";
 import { createReadStream } from "node:fs";
 import { stat } from "node:fs/promises";
 import { createServer } from "node:http";
-import { extname, join, normalize, sep } from "node:path";
+import { join, normalize } from "node:path";
 //#region src/static-server.ts
-const MIME_TYPES = {
-	".css": "text/css; charset=utf-8",
-	".html": "text/html; charset=utf-8",
-	".ico": "image/x-icon",
-	".jpeg": "image/jpeg",
-	".jpg": "image/jpeg",
-	".js": "text/javascript; charset=utf-8",
-	".json": "application/json; charset=utf-8",
-	".map": "application/json; charset=utf-8",
-	".mjs": "text/javascript; charset=utf-8",
-	".png": "image/png",
-	".svg": "image/svg+xml"
-};
-function mimeFor(file) {
-	return MIME_TYPES[extname(file).toLowerCase()] ?? "application/octet-stream";
+/**
+* Serve a built Storybook directory over HTTP on 127.0.0.1 for capture.
+*
+* @param rootDir - Directory containing the built Storybook (`index.html` entry).
+* @returns The server URL and a `close` function to stop it.
+*/
+async function createStaticServer(rootDir) {
+	const root = normalize(rootDir);
+	const info = await stat(root).catch(() => null);
+	if (!info || !info.isDirectory()) throw new Error(`Storybook directory not found: ${rootDir}. Upload the built Storybook before capturing.`);
+	const server = createServer((req, res) => {
+		handleRequest(root, req.url ?? "/", res).catch(() => {
+			sendNotFound(res);
+		});
+	});
+	return {
+		url: `http://127.0.0.1:${await listen(server)}`,
+		close: async () => {
+			await closeServer(server);
+		}
+	};
 }
 function sendNotFound(res) {
 	res.writeHead(404, { "content-type": "text/plain" });
@@ -29,7 +36,7 @@ function sendNotFound(res) {
 async function resolveFile(root, urlPath) {
 	const clean = (urlPath.split("?")[0] ?? "/").replace(/^\/+/u, "");
 	const target = normalize(join(root, clean === "" ? "index.html" : clean));
-	if (target !== root && !target.startsWith(root + sep)) return null;
+	if (!isPathSafe(root, target)) return null;
 	const info = await stat(target).catch(() => null);
 	if (!info) return null;
 	if (info.isDirectory()) return resolveFile(root, `${clean}/index.html`);
@@ -61,28 +68,6 @@ async function closeServer(server) {
 		});
 	});
 }
-/**
-* Serve a built Storybook directory over HTTP on 127.0.0.1 for capture.
-*
-* @param rootDir - Directory containing the built Storybook (`index.html` entry).
-* @returns The server URL and a `close` function to stop it.
-*/
-async function createStaticServer(rootDir) {
-	const root = normalize(rootDir);
-	const info = await stat(root).catch(() => null);
-	if (!info || !info.isDirectory()) throw new Error(`Storybook directory not found: ${rootDir}. Upload the built Storybook before capturing.`);
-	const server = createServer((req, res) => {
-		handleRequest(root, req.url ?? "/", res).catch(() => {
-			sendNotFound(res);
-		});
-	});
-	return {
-		url: `http://127.0.0.1:${await listen(server)}`,
-		close: async () => {
-			await closeServer(server);
-		}
-	};
-}
 //#endregion
 export { createStaticServer };
 

package/dist/static-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"static-server.mjs","names":[],"sources":["../src/static-server.ts"],"sourcesContent":["import { createReadStream } from \"node:fs\";\nimport { stat } from \"node:fs/promises\";\nimport { createServer, type Server, type ServerResponse } from \"node:http\";\nimport { extname, join, normalize, sep } from \"node:path\";\n\n/** A local HTTP server serving a built Storybook directory for capture. */\nexport interface StaticServer {\n  url: string;\n  close(): Promise<void>;\n}\n\nconst MIME_TYPES: Record<string, string> = {\n  \".css\": \"text/css; charset=utf-8\",\n  \".html\": \"text/html; charset=utf-8\",\n  \".ico\": \"image/x-icon\",\n  \".jpeg\": \"image/jpeg\",\n  \".jpg\": \"image/jpeg\",\n  \".js\": \"text/javascript; charset=utf-8\",\n  \".json\": \"application/json; charset=utf-8\",\n  \".map\": \"application/json; charset=utf-8\",\n  \".mjs\": \"text/javascript; charset=utf-8\",\n  \".png\": \"image/png\",\n  \".svg\": \"image/svg+xml\",\n};\n\nfunction mimeFor(file: string): string {\n  return MIME_TYPES[extname(file).toLowerCase()] ?? \"application/octet-stream\";\n}\n\nfunction sendNotFound(res: ServerResponse): void {\n  res.writeHead(404, { \"content-type\": \"text/plain\" });\n  res.end(\"Not found\");\n}\n\nasync function resolveFile(root: string, urlPath: string): Promise<string | null> {\n  const clean = (urlPath.split(\"?\")[0] ?? \"/\").replace(/^\\/+/u, \"\");\n  const target = normalize(join(root, clean === \"\" ? \"index.html\" : clean));\n  if (target !== root && !target.startsWith(root + sep)) {\n    return null;\n  }\n  const info = await stat(target).catch(() => null);\n  if (!info) {\n    return null;\n  }\n  if (info.isDirectory()) {\n    return resolveFile(root, `${clean}/index.html`);\n  }\n  return info.isFile() ? target : null;\n}\n\nasync function handleRequest(root: string, url: string, res: ServerResponse): Promise<void> {\n  const file = await resolveFile(root, url);\n  if (!file) {\n    sendNotFound(res);\n    return;\n  }\n  res.writeHead(200, { \"content-type\": mimeFor(file) });\n  createReadStream(file).pipe(res);\n}\n\nasync function listen(server: Server): Promise<number> {\n  return await new Promise((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(0, \"127.0.0.1\", () => {\n      const address = server.address();\n      resolve(typeof address === \"object\" && address !== null ? address.port : 0);\n    });\n  });\n}\n\nasync function closeServer(server: Server): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    server.close((error) => {\n      if (error) {\n        reject(error);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n\n/**\n * Serve a built Storybook directory over HTTP on 127.0.0.1 for capture.\n *\n * @param rootDir - Directory containing the built Storybook (`index.html` entry).\n * @returns The server URL and a `close` function to stop it.\n */\nexport async function createStaticServer(rootDir: string): Promise<StaticServer> {\n  const root = normalize(rootDir);\n  const info = await stat(root).catch(() => null);\n  if (!info || !info.isDirectory()) {\n    throw new Error(\n      `Storybook directory not found: ${rootDir}. Upload the built Storybook before capturing.`,\n    );\n  }\n\n  const server = createServer((req, res) => {\n    handleRequest(root, req.url ?? \"/\", res).catch(() => {\n      sendNotFound(res);\n    });\n  });\n\n  const port = await listen(server);\n\n  return {\n    url: `http://127.0.0.1:${port}`,\n    close: async () => {\n      await closeServer(server);\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAWA,MAAM,aAAqC;CACzC,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,OAAO;CACP,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;AACV;AAEA,SAAS,QAAQ,MAAsB;CACrC,OAAO,WAAW,QAAQ,IAAI,CAAC,CAAC,YAAY,MAAM;AACpD;AAEA,SAAS,aAAa,KAA2B;CAC/C,IAAI,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC;CACnD,IAAI,IAAI,WAAW;AACrB;AAEA,eAAe,YAAY,MAAc,SAAyC;CAChF,MAAM,SAAS,QAAQ,MAAM,GAAG,CAAC,CAAC,MAAM,IAAA,CAAK,QAAQ,SAAS,EAAE;CAChE,MAAM,SAAS,UAAU,KAAK,MAAM,UAAU,KAAK,eAAe,KAAK,CAAC;CACxE,IAAI,WAAW,QAAQ,CAAC,OAAO,WAAW,OAAO,GAAG,GAClD,OAAO;CAET,MAAM,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,YAAY,IAAI;CAChD,IAAI,CAAC,MACH,OAAO;CAET,IAAI,KAAK,YAAY,GACnB,OAAO,YAAY,MAAM,GAAG,MAAM,YAAY;CAEhD,OAAO,KAAK,OAAO,IAAI,SAAS;AAClC;AAEA,eAAe,cAAc,MAAc,KAAa,KAAoC;CAC1F,MAAM,OAAO,MAAM,YAAY,MAAM,GAAG;CACxC,IAAI,CAAC,MAAM;EACT,aAAa,GAAG;EAChB;CACF;CACA,IAAI,UAAU,KAAK,EAAE,gBAAgB,QAAQ,IAAI,EAAE,CAAC;CACpD,iBAAiB,IAAI,CAAC,CAAC,KAAK,GAAG;AACjC;AAEA,eAAe,OAAO,QAAiC;CACrD,OAAO,MAAM,IAAI,SAAS,SAAS,WAAW;EAC5C,OAAO,KAAK,SAAS,MAAM;EAC3B,OAAO,OAAO,GAAG,mBAAmB;GAClC,MAAM,UAAU,OAAO,QAAQ;GAC/B,QAAQ,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO,CAAC;EAC5E,CAAC;CACH,CAAC;AACH;AAEA,eAAe,YAAY,QAA+B;CACxD,MAAM,IAAI,SAAe,SAAS,WAAW;EAC3C,OAAO,OAAO,UAAU;GACtB,IAAI,OACF,OAAO,KAAK;QAEZ,QAAQ;EAEZ,CAAC;CACH,CAAC;AACH;;;;;;;AAQA,eAAsB,mBAAmB,SAAwC;CAC/E,MAAM,OAAO,UAAU,OAAO;CAC9B,MAAM,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,YAAY,IAAI;CAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,YAAY,GAC7B,MAAM,IAAI,MACR,kCAAkC,QAAQ,+CAC5C;CAGF,MAAM,SAAS,cAAc,KAAK,QAAQ;EACxC,cAAc,MAAM,IAAI,OAAO,KAAK,GAAG,CAAC,CAAC,YAAY;GACnD,aAAa,GAAG;EAClB,CAAC;CACH,CAAC;CAID,OAAO;EACL,KAAK,oBAAoB,MAHR,OAAO,MAAM;EAI9B,OAAO,YAAY;GACjB,MAAM,YAAY,MAAM;EAC1B;CACF;AACF"}
+{"version":3,"file":"static-server.mjs","names":[],"sources":["../src/static-server.ts"],"sourcesContent":["import { isPathSafe, mimeFor } from \"@storyshelf/core/utils\";\nimport { createReadStream } from \"node:fs\";\nimport { stat } from \"node:fs/promises\";\nimport { createServer, type Server, type ServerResponse } from \"node:http\";\nimport { join, normalize } from \"node:path\";\n\n/** A local HTTP server serving a built Storybook directory for capture. */\nexport interface StaticServer {\n  url: string;\n  close(): Promise<void>;\n}\n\n/**\n * Serve a built Storybook directory over HTTP on 127.0.0.1 for capture.\n *\n * @param rootDir - Directory containing the built Storybook (`index.html` entry).\n * @returns The server URL and a `close` function to stop it.\n */\nexport async function createStaticServer(rootDir: string): Promise<StaticServer> {\n  const root = normalize(rootDir);\n  const info = await stat(root).catch(() => null);\n  if (!info || !info.isDirectory()) {\n    throw new Error(\n      `Storybook directory not found: ${rootDir}. Upload the built Storybook before capturing.`,\n    );\n  }\n\n  const server = createServer((req, res) => {\n    handleRequest(root, req.url ?? \"/\", res).catch(() => {\n      sendNotFound(res);\n    });\n  });\n\n  const port = await listen(server);\n\n  return {\n    url: `http://127.0.0.1:${port}`,\n    close: async () => {\n      await closeServer(server);\n    },\n  };\n}\n\nfunction sendNotFound(res: ServerResponse): void {\n  res.writeHead(404, { \"content-type\": \"text/plain\" });\n  res.end(\"Not found\");\n}\n\nasync function resolveFile(root: string, urlPath: string): Promise<string | null> {\n  const clean = (urlPath.split(\"?\")[0] ?? \"/\").replace(/^\\/+/u, \"\");\n  const target = normalize(join(root, clean === \"\" ? \"index.html\" : clean));\n  if (!isPathSafe(root, target)) {\n    return null;\n  }\n  const info = await stat(target).catch(() => null);\n  if (!info) {\n    return null;\n  }\n  if (info.isDirectory()) {\n    return resolveFile(root, `${clean}/index.html`);\n  }\n  return info.isFile() ? target : null;\n}\n\nasync function handleRequest(root: string, url: string, res: ServerResponse): Promise<void> {\n  const file = await resolveFile(root, url);\n  if (!file) {\n    sendNotFound(res);\n    return;\n  }\n  res.writeHead(200, { \"content-type\": mimeFor(file) });\n  createReadStream(file).pipe(res);\n}\n\nasync function listen(server: Server): Promise<number> {\n  return await new Promise((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(0, \"127.0.0.1\", () => {\n      const address = server.address();\n      resolve(typeof address === \"object\" && address !== null ? address.port : 0);\n    });\n  });\n}\n\nasync function closeServer(server: Server): Promise<void> {\n  await new Promise<void>((resolve, reject) => {\n    server.close((error) => {\n      if (error) {\n        reject(error);\n      } else {\n        resolve();\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,eAAsB,mBAAmB,SAAwC;CAC/E,MAAM,OAAO,UAAU,OAAO;CAC9B,MAAM,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,YAAY,IAAI;CAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,YAAY,GAC7B,MAAM,IAAI,MACR,kCAAkC,QAAQ,+CAC5C;CAGF,MAAM,SAAS,cAAc,KAAK,QAAQ;EACxC,cAAc,MAAM,IAAI,OAAO,KAAK,GAAG,CAAC,CAAC,YAAY;GACnD,aAAa,GAAG;EAClB,CAAC;CACH,CAAC;CAID,OAAO;EACL,KAAK,oBAAoB,MAHR,OAAO,MAAM;EAI9B,OAAO,YAAY;GACjB,MAAM,YAAY,MAAM;EAC1B;CACF;AACF;AAEA,SAAS,aAAa,KAA2B;CAC/C,IAAI,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC;CACnD,IAAI,IAAI,WAAW;AACrB;AAEA,eAAe,YAAY,MAAc,SAAyC;CAChF,MAAM,SAAS,QAAQ,MAAM,GAAG,CAAC,CAAC,MAAM,IAAA,CAAK,QAAQ,SAAS,EAAE;CAChE,MAAM,SAAS,UAAU,KAAK,MAAM,UAAU,KAAK,eAAe,KAAK,CAAC;CACxE,IAAI,CAAC,WAAW,MAAM,MAAM,GAC1B,OAAO;CAET,MAAM,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,YAAY,IAAI;CAChD,IAAI,CAAC,MACH,OAAO;CAET,IAAI,KAAK,YAAY,GACnB,OAAO,YAAY,MAAM,GAAG,MAAM,YAAY;CAEhD,OAAO,KAAK,OAAO,IAAI,SAAS;AAClC;AAEA,eAAe,cAAc,MAAc,KAAa,KAAoC;CAC1F,MAAM,OAAO,MAAM,YAAY,MAAM,GAAG;CACxC,IAAI,CAAC,MAAM;EACT,aAAa,GAAG;EAChB;CACF;CACA,IAAI,UAAU,KAAK,EAAE,gBAAgB,QAAQ,IAAI,EAAE,CAAC;CACpD,iBAAiB,IAAI,CAAC,CAAC,KAAK,GAAG;AACjC;AAEA,eAAe,OAAO,QAAiC;CACrD,OAAO,MAAM,IAAI,SAAS,SAAS,WAAW;EAC5C,OAAO,KAAK,SAAS,MAAM;EAC3B,OAAO,OAAO,GAAG,mBAAmB;GAClC,MAAM,UAAU,OAAO,QAAQ;GAC/B,QAAQ,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO,CAAC;EAC5E,CAAC;CACH,CAAC;AACH;AAEA,eAAe,YAAY,QAA+B;CACxD,MAAM,IAAI,SAAe,SAAS,WAAW;EAC3C,OAAO,OAAO,UAAU;GACtB,IAAI,OACF,OAAO,KAAK;QAEZ,QAAQ;EAEZ,CAAC;CACH,CAAC;AACH"}

package/dist/types.d.mts

@@ -0,0 +1,6 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName } from "@storyshelf/core/adapter/capture-runner";
+import "@storyshelf/core/capture";
+import "playwright-core";
+import "@storyshelf/core/logger";

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@storyshelf/runner-playwright",
-  "version": "0.3.2",
+  "version": "0.5.3",
   "description": "Pure Playwright CaptureRunner implementation for StoryShelf: renders Storybook screenshots in-process (no db/storage coupling).",
+  "keywords": [
+    "playwright",
+    "screenshot",
+    "self-hosted",
+    "storybook",
+    "visual-testing"
+  ],
   "homepage": "https://github.com/GuptaSiddhant/StoryShelf#readme",
   "bugs": {
     "url": "https://github.com/GuptaSiddhant/StoryShelf/issues"
@@ -42,25 +49,28 @@
     "fmt": "oxfmt ./src",
     "lint": "oxlint --type-aware --type-check ./src",
     "test": "vitest run",
-    "test:integration": "RUN_INTEGRATION=1 vitest run integration.test.ts",
+    "test:integration": "RUN_INTEGRATION=1 vitest run integration.test.ts passkey.integration.test.ts",
     "prepublishOnly": "nub run build"
   },
   "dependencies": {
-    "@storyshelf/core": "^0.3.2",
-    "adm-zip": "^0.6.0",
-    "playwright": "^1.52.0"
+    "@storyshelf/core": "0.5.3",
+    "playwright-core": "1.63.0"
   },
   "devDependencies": {
-    "@storyshelf/db-sqlite": "workspace:*",
-    "@storyshelf/storage-local": "workspace:*",
-    "@types/node": "catalog:",
-    "@vitest/coverage-v8": "catalog:",
-    "oxfmt": "catalog:",
-    "oxlint": "catalog:",
-    "oxlint-tsgolint": "catalog:",
-    "tsdown": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "@hono/node-server": "^1.17.0",
+    "@storyshelf/app": "0.5.3",
+    "@storyshelf/auth": "0.5.3",
+    "@storyshelf/db-sqlite": "0.5.3",
+    "@storyshelf/storage-local": "0.5.3",
+    "@types/node": "^26.0.0",
+    "@vitest/coverage-v8": "^4.0.0",
+    "adm-zip": "0.6.0",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
   },
   "jsr": {
     "runtimeCompat": {