@storyshelf/runner-puppeteer 0.0.0-stage → 0.5.3

package/LICENSE

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

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @storyshelf/runner-puppeteer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Puppeteer capture runner for StoryShelf (Chromium via chrome-headless-shell), a smaller-image alternative to the Playwright runner.
+
+## Install
+
+```sh
+nub add @storyshelf/runner-puppeteer
+```
+
+or
+
+```sh
+npm install @storyshelf/runner-puppeteer
+```
+
+## Usage
+
+```ts
+import { createPuppeteerCaptureRunner } from "@storyshelf/runner-puppeteer";
+
+const capture = createPuppeteerCaptureRunner();
+```
+
+See the [StoryShelf documentation](https://github.com/GuptaSiddhant/StoryShelf#readme) for configuration details.
+
+## License
+
+MIT

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 \"puppeteer-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 Puppeteer. */\n\nimport type { Browser } from \"puppeteer-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

@@ -0,0 +1,16 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+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 Puppeteer (Chromium via chrome-headless-shell). */
+declare function createPuppeteerCaptureRunner(options?: {
+  browser?: BrowserName;
+  supportedBrowsers?: readonly BrowserName[];
+  executablePath?: string;
+  args?: string[];
+}): CaptureRunner;
+//#endregion
+export { createPuppeteerCaptureRunner };
+//# sourceMappingURL=capture-runner.d.mts.map

package/dist/capture-runner.mjs

@@ -0,0 +1,42 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { activeRuns, closeBrowser } from "./browser.mjs";
+import "./runtime-params.mjs";
+import { renderAll } from "./pipeline.mjs";
+//#region src/capture-runner.ts
+/** Create a CaptureRunner that renders Storybook stories with Puppeteer (Chromium via chrome-headless-shell). */
+function createPuppeteerCaptureRunner(options = {}) {
+	return {
+		metadata: {
+			name: "Puppeteer",
+			version: globalThis.__PKG_VERSION__ ?? "0.0.0",
+			description: "Puppeteer capture runner (chrome-headless-shell)",
+			kind: "puppeteer",
+			category: "capture-runner",
+			supportedBrowsers: options.supportedBrowsers ?? ["chromium", "chrome"]
+		},
+		async render(input) {
+			const active = {
+				cancelled: false,
+				browser: null
+			};
+			activeRuns.set(input.buildId, active);
+			try {
+				return await renderAll(input, active, options);
+			} finally {
+				activeRuns.delete(input.buildId);
+			}
+		},
+		async cancel(buildId) {
+			const active = activeRuns.get(buildId);
+			if (!active) return;
+			active.cancelled = true;
+			await closeBrowser(active.browser);
+		}
+	};
+}
+//#endregion
+export { createPuppeteerCaptureRunner };
+
+//# sourceMappingURL=capture-runner.mjs.map

package/dist/capture-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-runner.mjs","names":[],"sources":["../src/capture-runner.ts"],"sourcesContent":["/** Puppeteer capture runner — composition root (factory wiring). */\n\nimport type { BrowserName, CaptureRunner } from \"@storyshelf/core/adapter/capture-runner\";\nimport { activeRuns, closeBrowser } from \"./browser.ts\";\nimport { renderAll } from \"./pipeline.ts\";\nimport type { ActiveRun, PuppeteerRenderInput } from \"./types.ts\";\n\ndeclare const __PKG_VERSION__: string | undefined;\n\n/** Create a CaptureRunner that renders Storybook stories with Puppeteer (Chromium via chrome-headless-shell). */\nexport function createPuppeteerCaptureRunner(\n  options: {\n    browser?: BrowserName;\n    supportedBrowsers?: readonly BrowserName[];\n    executablePath?: string;\n    args?: string[];\n  } = {},\n): CaptureRunner {\n  return {\n    metadata: {\n      name: \"Puppeteer\",\n      version: (globalThis as unknown as { __PKG_VERSION__?: string }).__PKG_VERSION__ ?? \"0.0.0\",\n      description: \"Puppeteer capture runner (chrome-headless-shell)\",\n      kind: \"puppeteer\",\n      category: \"capture-runner\",\n      supportedBrowsers: options.supportedBrowsers ?? [\"chromium\", \"chrome\"],\n    },\n    async render(input: PuppeteerRenderInput) {\n      const active: ActiveRun = { cancelled: false, browser: null };\n      activeRuns.set(input.buildId, active);\n      try {\n        return await renderAll(input, active, options);\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 { PuppeteerRenderInput, RuntimeParamsState } from \"./types.ts\";\nexport { createRuntimeParamsState, runtimeParametersForStory } from \"./runtime-params.ts\";\n"],"mappings":";;;;;;;;AAUA,SAAgB,6BACd,UAKI,CAAC,GACU;CACf,OAAO;EACL,UAAU;GACR,MAAM;GACN,SAAU,WAAuD,mBAAmB;GACpF,aAAa;GACb,MAAM;GACN,UAAU;GACV,mBAAmB,QAAQ,qBAAqB,CAAC,YAAY,QAAQ;EACvE;EACA,MAAM,OAAO,OAA6B;GACxC,MAAM,SAAoB;IAAE,WAAW;IAAO,SAAS;GAAK;GAC5D,WAAW,IAAI,MAAM,SAAS,MAAM;GACpC,IAAI;IACF,OAAO,MAAM,UAAU,OAAO,QAAQ,OAAO;GAC/C,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/index.d.mts

@@ -0,0 +1,4 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { createPuppeteerCaptureRunner } from "./capture-runner.mjs";
+export { createPuppeteerCaptureRunner };

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createPuppeteerCaptureRunner } from "./capture-runner.mjs";
+export { createPuppeteerCaptureRunner };

package/dist/pipeline.mjs

@@ -0,0 +1,102 @@
+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 puppeteer from "puppeteer-core";
+//#region src/pipeline.ts
+/** Render all story/viewport combinations for a build. */
+async function renderAll(input, active, runnerOptions) {
+	const server = await createStaticServer(input.storybookDir);
+	return await runWithBrowser(input, active, await launchBrowser(runnerOptions), 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(opts) {
+	return await puppeteer.launch({
+		headless: true,
+		executablePath: opts.executablePath,
+		args: opts.args ?? ["--no-sandbox", "--disable-setuid-sandbox"]
+	});
+}
+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  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 \"puppeteer-core\";\nimport puppeteer from \"puppeteer-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, PuppeteerRenderInput } from \"./types.ts\";\n\n/** Render all story/viewport combinations for a build. */\nexport async function renderAll(\n  input: PuppeteerRenderInput,\n  active: ActiveRun,\n  runnerOptions: { executablePath?: string; args?: string[] },\n): Promise<RenderResult> {\n  const server = await createStaticServer(input.storybookDir);\n  const browser = await launchBrowser(runnerOptions);\n  return await runWithBrowser(input, active, browser, server);\n}\n\nasync function runWithBrowser(\n  input: PuppeteerRenderInput,\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(opts: { executablePath?: string; args?: string[] }): Promise<Browser> {\n  return await puppeteer.launch({\n    headless: true,\n    executablePath: opts.executablePath,\n    args: opts.args ?? [\"--no-sandbox\", \"--disable-setuid-sandbox\"],\n  });\n}\n\nfunction buildContext(\n  browser: Browser,\n  baseUrl: string,\n  input: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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: PuppeteerRenderInput,\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":";;;;;;;;;;;AAkBA,eAAsB,UACpB,OACA,QACA,eACuB;CACvB,MAAM,SAAS,MAAM,mBAAmB,MAAM,YAAY;CAE1D,OAAO,MAAM,eAAe,OAAO,QAAQ,MADrB,cAAc,aAAa,GACG,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,MAAsE;CACjG,OAAO,MAAM,UAAU,OAAO;EAC5B,UAAU;EACV,gBAAgB,KAAK;EACrB,MAAM,KAAK,QAAQ,CAAC,gBAAgB,0BAA0B;CAChE,CAAC;AACH;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 \"puppeteer-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,133 @@
+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();
+	await page.setViewport({
+		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.setViewport({
+		width: plan.viewport.width,
+		height: plan.viewport.height
+	});
+	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: "networkidle0" });
+	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, { visible: false });
+	await delay(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 readBoundingBox(page);
+	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 readBoundingBox(page) {
+	try {
+		const el = await page.$("#storybook-root");
+		if (!el) return null;
+		return await el.boundingBox();
+	} catch {
+		return null;
+	}
+}
+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 delay(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({
+		type: "png",
+		...plan.fullPage ? { fullPage: true } : {},
+		...plan.clip ? { clip: plan.clip } : {}
+	});
+}
+async function shotOne(page, plan, _story) {
+	return await page.screenshot({
+		type: "png",
+		...plan.fullPage ? { fullPage: true } : {},
+		...plan.clip ? { clip: plan.clip } : {}
+	});
+}
+async function delay(ms) {
+	await new Promise((resolve) => {
+		setTimeout(() => {
+			resolve();
+		}, ms);
+	});
+}
+//#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 (Puppeteer). */\n\nimport type { StoryEntry, Viewport } from \"@storyshelf/core/adapter/capture-runner\";\nimport { getScreenshotPlan } from \"@storyshelf/core/capture\";\nimport type { Page } from \"puppeteer-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  await page.setViewport({ width: viewport.width, height: viewport.height });\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.setViewport({ width: plan.viewport.width, height: plan.viewport.height });\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: \"networkidle0\" });\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, { visible: false });\n  await delay(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 readBoundingBox(page);\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}\n\nasync function readBoundingBox(\n  page: Page,\n): Promise<{ x: number; y: number; width: number; height: number } | null> {\n  try {\n    const el = await page.$(\"#storybook-root\");\n    if (!el) return null;\n    return await el.boundingBox();\n  } catch {\n    return null;\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 delay(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    type: \"png\",\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    type: \"png\",\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\nasync function delay(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => {\n    setTimeout(() => {\n      resolve();\n    }, ms);\n  });\n}\n"],"mappings":"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"}

package/dist/static-server.mjs

@@ -0,0 +1,74 @@
+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 { join, normalize } from "node:path";
+//#region src/static-server.ts
+/**
+* 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" });
+	res.end("Not found");
+}
+async function resolveFile(root, urlPath) {
+	const clean = (urlPath.split("?")[0] ?? "/").replace(/^\/+/u, "");
+	const target = normalize(join(root, clean === "" ? "index.html" : clean));
+	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`);
+	return info.isFile() ? target : null;
+}
+async function handleRequest(root, url, res) {
+	const file = await resolveFile(root, url);
+	if (!file) {
+		sendNotFound(res);
+		return;
+	}
+	res.writeHead(200, { "content-type": mimeFor(file) });
+	createReadStream(file).pipe(res);
+}
+async function listen(server) {
+	return await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(0, "127.0.0.1", () => {
+			const address = server.address();
+			resolve(typeof address === "object" && address !== null ? address.port : 0);
+		});
+	});
+}
+async function closeServer(server) {
+	await new Promise((resolve, reject) => {
+		server.close((error) => {
+			if (error) reject(error);
+			else resolve();
+		});
+	});
+}
+//#endregion
+export { createStaticServer };
+
+//# sourceMappingURL=static-server.mjs.map

package/dist/static-server.mjs.map

@@ -0,0 +1 @@
+{"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 "@storyshelf/core/capture";
+import "puppeteer-core";
+import { BrowserName } from "@storyshelf/core/adapter/capture-runner";
+import "@storyshelf/core/logger";

package/package.json

@@ -1,6 +1,81 @@
 {
   "name": "@storyshelf/runner-puppeteer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.3",
+  "description": "Puppeteer CaptureRunner for StoryShelf (Chromium via chrome-headless-shell, smaller image).",
+  "keywords": [
+    "puppeteer",
+    "screenshot",
+    "self-hosted",
+    "storybook",
+    "visual-testing"
+  ],
+  "homepage": "https://github.com/GuptaSiddhant/StoryShelf#readme",
+  "bugs": {
+    "url": "https://github.com/GuptaSiddhant/StoryShelf/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Siddhant Gupta",
+    "url": "https://guptasiddhant.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuptaSiddhant/StoryShelf.git",
+    "directory": "packages/runner-puppeteer"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.mjs",
+      "./package.json": "./package.json"
+    },
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown -w",
+    "fmt": "oxfmt ./src",
+    "lint": "oxlint --type-aware --type-check ./src",
+    "test": "vitest run",
+    "prepublishOnly": "nub run build"
+  },
+  "dependencies": {
+    "@storyshelf/core": "0.5.3",
+    "puppeteer-core": "^24.0.0"
+  },
+  "devDependencies": {
+    "@storyshelf/app": "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": {
+      "node": true,
+      "deno": true,
+      "browser": false,
+      "workerd": false,
+      "bun": true
+    }
+  }
+}