@storyshelf/runner-playwright 0.6.2 → 0.8.0

package/dist/play.mjs.map

@@ -1 +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"}
+{"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, eslint/max-lines-per-function -- must stay one self-contained function (see above)\nexport async function inPagePlay({ storyId, timeoutMs }: PlayArgs): Promise<void> {\n  type Story = { playFunction?: (ctx: unknown) => Promise<void> };\n  type Store = {\n    loadStory?: (arg: { storyId: string }) => Promise<Story>;\n    getStoryContext?: (story: Story) => Record<string, unknown>;\n    fromId?: (id: string) => { play?: (ctx: unknown) => Promise<void> };\n  };\n  type Preview = {\n    executePlay?: (id: string) => Promise<void>;\n    storyStoreValue?: Store;\n    storyStore?: Store;\n    storyRenders?: { id: string; storyContext?: () => Record<string, unknown> }[];\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  // SB 8+ has no `executePlay`, and `fromId` throws until every CSF file is cached, so load just\n  // this story and run its `playFunction` with the context of the render that is already mounted.\n  const store = preview.storyStoreValue ?? preview.storyStore;\n  const runLoaded = async (): Promise<void> => {\n    const story = await store?.loadStory?.({ storyId });\n    if (!story?.playFunction) return;\n    const render = preview.storyRenders?.find((r) => r.id === storyId);\n    const context = render?.storyContext?.() ?? store?.getStoryContext?.(story) ?? {};\n    await story.playFunction({ ...context, canvasElement });\n  };\n  let work: Promise<void> | undefined;\n  if (preview.executePlay) work = preview.executePlay(storyId);\n  else if (store?.loadStory) work = runLoaded();\n  else work = store?.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;CAchF,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;CAG1E,MAAM,QAAQ,QAAQ,mBAAmB,QAAQ;CACjD,MAAM,YAAY,YAA2B;EAC3C,MAAM,QAAQ,MAAM,OAAO,YAAY,EAAE,QAAQ,CAAC;EAClD,IAAI,CAAC,OAAO,cAAc;EAE1B,MAAM,WADS,QAAQ,cAAc,MAAM,MAAM,EAAE,OAAO,OAAO,EAAA,EACzC,eAAe,KAAK,OAAO,kBAAkB,KAAK,KAAK,CAAC;EAChF,MAAM,MAAM,aAAa;GAAE,GAAG;GAAS;EAAc,CAAC;CACxD;CACA,IAAI;CACJ,IAAI,QAAQ,aAAa,OAAO,QAAQ,YAAY,OAAO;MACtD,IAAI,OAAO,WAAW,OAAO,UAAU;MACvC,OAAO,OAAO,SAAS,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC;CAC9D,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/remote/azure.d.mts

@@ -0,0 +1,24 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName, RemoteBrowser } from "@storyshelf/core/adapter/capture-runner";
+/** Options of {@link azurePlaywright}. */
+interface AzurePlaywrightOptions {
+  /** The target name half; default `azure`. */
+  name?: string;
+  /** The workspace's browser endpoint (`PLAYWRIGHT_SERVICE_URL`): `wss://<region>.api.playwright.microsoft.com/playwrightworkspaces/<id>/browsers`. */
+  endpoint: string;
+  /** Access token (`PLAYWRIGHT_SERVICE_ACCESS_TOKEN`). */
+  token: string;
+  /** OS of the cloud browsers (default `linux`). */
+  os?: "linux" | "windows";
+  /** API version the service is called with (default `2025-09-01`). */
+  apiVersion?: string;
+  /** Parallel pages (the workspace's parallel-worker limit; default 1). */
+  sessions?: number;
+  /** Engines to offer (default all three). */
+  engines?: readonly BrowserName[];
+}
+/** Targets on a workspace: `chromium@azure`, `firefox@azure`, `webkit@azure`. */
+declare function azurePlaywright(options: AzurePlaywrightOptions): RemoteBrowser;
+export { AzurePlaywrightOptions, azurePlaywright };
+//# sourceMappingURL=azure.d.mts.map

package/dist/remote/azure.mjs

@@ -0,0 +1,36 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { remote } from "./remote.mjs";
+// src/remote/azure.ts
+/** Targets on a workspace: `chromium@azure`, `firefox@azure`, `webkit@azure`. */
+function azurePlaywright(options) {
+	const os = options.os ?? "linux";
+	return remote({
+		name: options.name ?? "azure",
+		engines: options.engines ?? [
+			"chromium",
+			"firefox",
+			"webkit"
+		],
+		protocol: "playwright",
+		reach: "loopback",
+		connect: {
+			endpoint: withParams(options.endpoint, {
+				os,
+				"api-version": options.apiVersion ?? "2025-09-01"
+			}),
+			headers: { authorization: `Bearer ${options.token}` }
+		},
+		sessions: options.sessions ?? 1,
+		platform: os
+	});
+}
+function withParams(endpoint, params) {
+	const url = new URL(endpoint);
+	for (const [key, value] of Object.entries(params)) if (!url.searchParams.has(key)) url.searchParams.set(key, value);
+	return url.toString();
+}
+export { azurePlaywright };
+
+//# sourceMappingURL=azure.mjs.map

package/dist/remote/azure.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure.mjs","names":[],"sources":["../../src/remote/azure.ts"],"sourcesContent":["/** Microsoft Azure Playwright Workspaces (Azure App Testing). */\nimport type { BrowserName, RemoteBrowser } from \"@storyshelf/core/adapter/capture-runner\";\nimport { remote } from \"./remote.ts\";\n\n/** Options of {@link azurePlaywright}. */\nexport interface AzurePlaywrightOptions {\n  /** The target name half; default `azure`. */\n  name?: string;\n  /** The workspace's browser endpoint (`PLAYWRIGHT_SERVICE_URL`): `wss://<region>.api.playwright.microsoft.com/playwrightworkspaces/<id>/browsers`. */\n  endpoint: string;\n  /** Access token (`PLAYWRIGHT_SERVICE_ACCESS_TOKEN`). */\n  token: string;\n  /** OS of the cloud browsers (default `linux`). */\n  os?: \"linux\" | \"windows\";\n  /** API version the service is called with (default `2025-09-01`). */\n  apiVersion?: string;\n  /** Parallel pages (the workspace's parallel-worker limit; default 1). */\n  sessions?: number;\n  /** Engines to offer (default all three). */\n  engines?: readonly BrowserName[];\n}\n\n/** Targets on a workspace: `chromium@azure`, `firefox@azure`, `webkit@azure`. */\nexport function azurePlaywright(options: AzurePlaywrightOptions): RemoteBrowser {\n  const os = options.os ?? \"linux\";\n  return remote({\n    name: options.name ?? \"azure\",\n    engines: options.engines ?? [\"chromium\", \"firefox\", \"webkit\"],\n    protocol: \"playwright\",\n    // The service routes requests for the host's loopback back through the connection.\n    reach: \"loopback\",\n    connect: {\n      endpoint: withParams(options.endpoint, {\n        os,\n        \"api-version\": options.apiVersion ?? \"2025-09-01\",\n      }),\n      headers: { authorization: `Bearer ${options.token}` },\n    },\n    sessions: options.sessions ?? 1,\n    platform: os,\n  });\n}\n\nfunction withParams(endpoint: string, params: Record<string, string>): string {\n  const url = new URL(endpoint);\n  for (const [key, value] of Object.entries(params)) {\n    if (!url.searchParams.has(key)) url.searchParams.set(key, value);\n  }\n  return url.toString();\n}\n"],"mappings":";;;;;;AAuBA,SAAgB,gBAAgB,SAAgD;CAC9E,MAAM,KAAK,QAAQ,MAAM;CACzB,OAAO,OAAO;EACZ,MAAM,QAAQ,QAAQ;EACtB,SAAS,QAAQ,WAAW;GAAC;GAAY;GAAW;EAAQ;EAC5D,UAAU;EAEV,OAAO;EACP,SAAS;GACP,UAAU,WAAW,QAAQ,UAAU;IACrC;IACA,eAAe,QAAQ,cAAc;GACvC,CAAC;GACD,SAAS,EAAE,eAAe,UAAU,QAAQ,QAAQ;EACtD;EACA,UAAU,QAAQ,YAAY;EAC9B,UAAU;CACZ,CAAC;AACH;AAEA,SAAS,WAAW,UAAkB,QAAwC;CAC5E,MAAM,MAAM,IAAI,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,IAAI,CAAC,IAAI,aAAa,IAAI,GAAG,GAAG,IAAI,aAAa,IAAI,KAAK,KAAK;CAEjE,OAAO,IAAI,SAAS;AACtB"}

package/dist/remote/browserstack.d.mts

@@ -0,0 +1,31 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName, RemoteBrowser } from "@storyshelf/core/adapter/capture-runner";
+/** Options of {@link browserstack}. */
+interface BrowserStackOptions {
+  /** The target name half; default `browserstack`. A second entry needs its own. */
+  name?: string;
+  username: string;
+  accessKey: string;
+  /** OS the browsers run on, as BrowserStack names it (`{ name: "Windows", version: "11" }`). */
+  os?: {
+    name: string;
+    version: string;
+  };
+  /** Browser version (default `latest`). Pin it: a moving build is a baseline migration. */
+  browserVersion?: string;
+  /** Engines to offer (default `chromium`, `firefox`, `webkit`; `chrome` is real Chrome). */
+  engines?: readonly BrowserName[];
+  /** Parallel sessions of the plan (default 1). */
+  sessions?: number;
+  /** Build name shown in BrowserStack's dashboard. */
+  build?: string;
+}
+/**
+ * Targets on BrowserStack, for example `chromium@browserstack`. BrowserStack cannot route back to
+ * this host, so each target needs a signed Storybook URL (ADR 0007, decision 5). The credentials
+ * travel in the endpoint's capabilities and are scrubbed from every message and log.
+ */
+declare function browserstack(options: BrowserStackOptions): RemoteBrowser;
+export { BrowserStackOptions, browserstack };
+//# sourceMappingURL=browserstack.d.mts.map

package/dist/remote/browserstack.mjs

@@ -0,0 +1,50 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { playwrightVersion } from "../version.mjs";
+import { remote } from "./remote.mjs";
+// src/remote/browserstack.ts
+/** BrowserStack's `browser` capability per engine. */
+const BROWSER = {
+	chromium: "playwright-chromium",
+	firefox: "playwright-firefox",
+	webkit: "playwright-webkit",
+	chrome: "chrome"
+};
+/**
+* Targets on BrowserStack, for example `chromium@browserstack`. BrowserStack cannot route back to
+* this host, so each target needs a signed Storybook URL (ADR 0007, decision 5). The credentials
+* travel in the endpoint's capabilities and are scrubbed from every message and log.
+*/
+function browserstack(options) {
+	return remote({
+		name: options.name ?? "browserstack",
+		engines: options.engines ?? [
+			"chromium",
+			"firefox",
+			"webkit"
+		],
+		protocol: "playwright",
+		reach: "url",
+		connect: ({ engine }) => ({ endpoint: `wss://cdp.browserstack.com/playwright?caps=${encodeURIComponent(JSON.stringify(capabilities(options, engine)))}` }),
+		sessions: options.sessions ?? 1,
+		platform: options.os?.name.toLowerCase().replace(/^os x$/u, "macos")
+	});
+}
+function capabilities(options, engine) {
+	return {
+		browser: BROWSER[engine],
+		browser_version: options.browserVersion ?? "latest",
+		...options.os === void 0 ? {} : {
+			os: options.os.name,
+			os_version: options.os.version
+		},
+		"browserstack.username": options.username,
+		"browserstack.accessKey": options.accessKey,
+		"client.playwrightVersion": playwrightVersion(),
+		...options.build === void 0 ? {} : { build: options.build }
+	};
+}
+export { browserstack };
+
+//# sourceMappingURL=browserstack.mjs.map

package/dist/remote/browserstack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserstack.mjs","names":[],"sources":["../../src/remote/browserstack.ts"],"sourcesContent":["/** BrowserStack Automate over Playwright's protocol. */\nimport type { BrowserName, RemoteBrowser } from \"@storyshelf/core/adapter/capture-runner\";\nimport { playwrightVersion } from \"../version.ts\";\nimport { remote } from \"./remote.ts\";\n\n/** Options of {@link browserstack}. */\nexport interface BrowserStackOptions {\n  /** The target name half; default `browserstack`. A second entry needs its own. */\n  name?: string;\n  username: string;\n  accessKey: string;\n  /** OS the browsers run on, as BrowserStack names it (`{ name: \"Windows\", version: \"11\" }`). */\n  os?: { name: string; version: string };\n  /** Browser version (default `latest`). Pin it: a moving build is a baseline migration. */\n  browserVersion?: string;\n  /** Engines to offer (default `chromium`, `firefox`, `webkit`; `chrome` is real Chrome). */\n  engines?: readonly BrowserName[];\n  /** Parallel sessions of the plan (default 1). */\n  sessions?: number;\n  /** Build name shown in BrowserStack's dashboard. */\n  build?: string;\n}\n\n/** BrowserStack's `browser` capability per engine. */\nconst BROWSER: Record<BrowserName, string> = {\n  chromium: \"playwright-chromium\",\n  firefox: \"playwright-firefox\",\n  webkit: \"playwright-webkit\",\n  chrome: \"chrome\",\n};\n\n/**\n * Targets on BrowserStack, for example `chromium@browserstack`. BrowserStack cannot route back to\n * this host, so each target needs a signed Storybook URL (ADR 0007, decision 5). The credentials\n * travel in the endpoint's capabilities and are scrubbed from every message and log.\n */\nexport function browserstack(options: BrowserStackOptions): RemoteBrowser {\n  return remote({\n    name: options.name ?? \"browserstack\",\n    engines: options.engines ?? [\"chromium\", \"firefox\", \"webkit\"],\n    protocol: \"playwright\",\n    reach: \"url\",\n    connect: ({ engine }) => ({\n      endpoint: `wss://cdp.browserstack.com/playwright?caps=${encodeURIComponent(\n        JSON.stringify(capabilities(options, engine)),\n      )}`,\n    }),\n    sessions: options.sessions ?? 1,\n    platform: options.os?.name.toLowerCase().replace(/^os x$/u, \"macos\"),\n  });\n}\n\nfunction capabilities(options: BrowserStackOptions, engine: BrowserName): Record<string, unknown> {\n  return {\n    browser: BROWSER[engine],\n    browser_version: options.browserVersion ?? \"latest\",\n    ...(options.os === undefined ? {} : { os: options.os.name, os_version: options.os.version }),\n    \"browserstack.username\": options.username,\n    \"browserstack.accessKey\": options.accessKey,\n    \"client.playwrightVersion\": playwrightVersion(),\n    ...(options.build === undefined ? {} : { build: options.build }),\n  };\n}\n"],"mappings":";;;;;;;AAwBA,MAAM,UAAuC;CAC3C,UAAU;CACV,SAAS;CACT,QAAQ;CACR,QAAQ;AACV;;;;;;AAOA,SAAgB,aAAa,SAA6C;CACxE,OAAO,OAAO;EACZ,MAAM,QAAQ,QAAQ;EACtB,SAAS,QAAQ,WAAW;GAAC;GAAY;GAAW;EAAQ;EAC5D,UAAU;EACV,OAAO;EACP,UAAU,EAAE,cAAc,EACxB,UAAU,8CAA8C,mBACtD,KAAK,UAAU,aAAa,SAAS,MAAM,CAAC,CAC9C,IACF;EACA,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,WAAW,OAAO;CACrE,CAAC;AACH;AAEA,SAAS,aAAa,SAA8B,QAA8C;CAChG,OAAO;EACL,SAAS,QAAQ;EACjB,iBAAiB,QAAQ,kBAAkB;EAC3C,GAAI,QAAQ,OAAO,KAAA,IAAY,CAAC,IAAI;GAAE,IAAI,QAAQ,GAAG;GAAM,YAAY,QAAQ,GAAG;EAAQ;EAC1F,yBAAyB,QAAQ;EACjC,0BAA0B,QAAQ;EAClC,4BAA4B,kBAAkB;EAC9C,GAAI,QAAQ,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;CAChE;AACF"}

package/dist/remote/index.d.mts

@@ -0,0 +1,8 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName, RemoteBrowser, RemoteConnection, RemoteOptions, remote } from "./remote.mjs";
+import { PlaywrightServerOptions, playwrightServer } from "./playwright-server.mjs";
+import { AzurePlaywrightOptions, azurePlaywright } from "./azure.mjs";
+import { BrowserStackOptions, browserstack } from "./browserstack.mjs";
+import { PoolLease, RefCounted, RefCountedOptions, RemoteConnectContext, RemoteConnectError, RemoteReleaseInfo, refCounted } from "@storyshelf/core/adapter/capture-runner";
+export { type AzurePlaywrightOptions, type BrowserName, type BrowserStackOptions, type PlaywrightServerOptions, type PoolLease, type RefCounted, type RefCountedOptions, type RemoteBrowser, type RemoteConnectContext, RemoteConnectError, type RemoteConnection, type RemoteOptions, type RemoteReleaseInfo, azurePlaywright, browserstack, playwrightServer, refCounted, remote };

package/dist/remote/index.mjs

@@ -0,0 +1,9 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { remote } from "./remote.mjs";
+import { playwrightServer } from "./playwright-server.mjs";
+import { azurePlaywright } from "./azure.mjs";
+import { browserstack } from "./browserstack.mjs";
+import { RemoteConnectError, refCounted } from "@storyshelf/core/adapter/capture-runner";
+export { RemoteConnectError, azurePlaywright, browserstack, playwrightServer, refCounted, remote };

package/dist/remote/playwright-server.d.mts

@@ -0,0 +1,45 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName, RemoteBrowser } from "@storyshelf/core/adapter/capture-runner";
+/** Options of {@link playwrightServer}. */
+interface PlaywrightServerOptions {
+  /** The target name half (`chromium@<name>`); default `grid`. */
+  name?: string;
+  /** `ws://host:3000/` or `wss://…`: the server's address and `--path`. */
+  endpoint: string;
+  /**
+   * Bearer token for a reverse proxy in front of the server: a bare `run-server` has no
+   * authentication of its own. Sent as `authorization: Bearer …`.
+   */
+  token?: string;
+  /** Further handshake headers. */
+  headers?: Record<string, string>;
+  /**
+   * Route the remote browser's requests for the loopback Storybook server back through the
+   * connection (default `"<loopback>"`, the only pattern supported). `false` when the server
+   * cannot, which makes every target need a signed Storybook URL.
+   */
+  exposeNetwork?: "<loopback>" | false;
+  /** Parallel pages the farm should take from this runner (default 1: set it to the farm's cap). */
+  sessions?: number;
+  /** Maximum concurrent pages on each connection; the shared sessions limit still applies. */
+  maxPagesPerConnection?: number;
+  /**
+   * Maximum connections this process holds to the server at once (default: no cap), separate from
+   * the page limits above. Renders over the cap wait; per process, not per deployment.
+   */
+  maxConnections?: number;
+  /** Engines to offer (default all three; the server must have them installed). */
+  engines?: readonly BrowserName[];
+  /** OS the server runs on, reported when the page cannot tell. */
+  platform?: string;
+  /**
+   * How long one connect attempt waits in ms (default 30 000). A server started with
+   * `--max-clients` queues extra connections: raise this when renders outnumber its clients.
+   */
+  connectTimeoutMs?: number;
+}
+/** Targets on a Playwright server: `chromium@grid`, `firefox@grid`, `webkit@grid`. */
+declare function playwrightServer(options: PlaywrightServerOptions): RemoteBrowser;
+export { PlaywrightServerOptions, playwrightServer };
+//# sourceMappingURL=playwright-server.d.mts.map

package/dist/remote/playwright-server.mjs

@@ -0,0 +1,35 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { remote } from "./remote.mjs";
+// src/remote/playwright-server.ts
+/** Targets on a Playwright server: `chromium@grid`, `firefox@grid`, `webkit@grid`. */
+function playwrightServer(options) {
+	const headers = {
+		...options.token === void 0 ? {} : { authorization: `Bearer ${options.token}` },
+		...options.headers
+	};
+	const exposeNetwork = options.exposeNetwork ?? "<loopback>";
+	return remote({
+		name: options.name ?? "grid",
+		engines: options.engines ?? [
+			"chromium",
+			"firefox",
+			"webkit"
+		],
+		protocol: "playwright",
+		reach: exposeNetwork === false ? "url" : "loopback",
+		connect: {
+			endpoint: options.endpoint,
+			headers
+		},
+		sessions: options.sessions ?? 1,
+		maxPagesPerConnection: options.maxPagesPerConnection,
+		maxConnections: options.maxConnections,
+		platform: options.platform,
+		timeouts: { connectMs: options.connectTimeoutMs }
+	});
+}
+export { playwrightServer };
+
+//# sourceMappingURL=playwright-server.mjs.map

package/dist/remote/playwright-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-server.mjs","names":[],"sources":["../../src/remote/playwright-server.ts"],"sourcesContent":["/** A self-hosted Playwright server (`playwright run-server`), or anything speaking its protocol. */\nimport type { BrowserName, RemoteBrowser } from \"@storyshelf/core/adapter/capture-runner\";\nimport { remote } from \"./remote.ts\";\n\n/** Options of {@link playwrightServer}. */\nexport interface PlaywrightServerOptions {\n  /** The target name half (`chromium@<name>`); default `grid`. */\n  name?: string;\n  /** `ws://host:3000/` or `wss://…`: the server's address and `--path`. */\n  endpoint: string;\n  /**\n   * Bearer token for a reverse proxy in front of the server: a bare `run-server` has no\n   * authentication of its own. Sent as `authorization: Bearer …`.\n   */\n  token?: string;\n  /** Further handshake headers. */\n  headers?: Record<string, string>;\n  /**\n   * Route the remote browser's requests for the loopback Storybook server back through the\n   * connection (default `\"<loopback>\"`, the only pattern supported). `false` when the server\n   * cannot, which makes every target need a signed Storybook URL.\n   */\n  exposeNetwork?: \"<loopback>\" | false;\n  /** Parallel pages the farm should take from this runner (default 1: set it to the farm's cap). */\n  sessions?: number;\n  /** Maximum concurrent pages on each connection; the shared sessions limit still applies. */\n  maxPagesPerConnection?: number;\n  /**\n   * Maximum connections this process holds to the server at once (default: no cap), separate from\n   * the page limits above. Renders over the cap wait; per process, not per deployment.\n   */\n  maxConnections?: number;\n  /** Engines to offer (default all three; the server must have them installed). */\n  engines?: readonly BrowserName[];\n  /** OS the server runs on, reported when the page cannot tell. */\n  platform?: string;\n  /**\n   * How long one connect attempt waits in ms (default 30 000). A server started with\n   * `--max-clients` queues extra connections: raise this when renders outnumber its clients.\n   */\n  connectTimeoutMs?: number;\n}\n\n/** Targets on a Playwright server: `chromium@grid`, `firefox@grid`, `webkit@grid`. */\nexport function playwrightServer(options: PlaywrightServerOptions): RemoteBrowser {\n  const headers = {\n    ...(options.token === undefined ? {} : { authorization: `Bearer ${options.token}` }),\n    ...options.headers,\n  };\n  const exposeNetwork = options.exposeNetwork ?? \"<loopback>\";\n  return remote({\n    name: options.name ?? \"grid\",\n    engines: options.engines ?? [\"chromium\", \"firefox\", \"webkit\"],\n    protocol: \"playwright\",\n    reach: exposeNetwork === false ? \"url\" : \"loopback\",\n    connect: { endpoint: options.endpoint, headers },\n    sessions: options.sessions ?? 1,\n    maxPagesPerConnection: options.maxPagesPerConnection,\n    maxConnections: options.maxConnections,\n    platform: options.platform,\n    timeouts: { connectMs: options.connectTimeoutMs },\n  });\n}\n"],"mappings":";;;;;;AA4CA,SAAgB,iBAAiB,SAAiD;CAChF,MAAM,UAAU;EACd,GAAI,QAAQ,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,eAAe,UAAU,QAAQ,QAAQ;EAClF,GAAG,QAAQ;CACb;CACA,MAAM,gBAAgB,QAAQ,iBAAiB;CAC/C,OAAO,OAAO;EACZ,MAAM,QAAQ,QAAQ;EACtB,SAAS,QAAQ,WAAW;GAAC;GAAY;GAAW;EAAQ;EAC5D,UAAU;EACV,OAAO,kBAAkB,QAAQ,QAAQ;EACzC,SAAS;GAAE,UAAU,QAAQ;GAAU;EAAQ;EAC/C,UAAU,QAAQ,YAAY;EAC9B,uBAAuB,QAAQ;EAC/B,gBAAgB,QAAQ;EACxB,UAAU,QAAQ;EAClB,UAAU,EAAE,WAAW,QAAQ,iBAAiB;CAClD,CAAC;AACH"}

package/dist/remote/remote.d.mts

@@ -0,0 +1,38 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BrowserName as BrowserName$1, RemoteBrowser as RemoteBrowser$1, RemoteConnection, RemoteOptions } from "@storyshelf/core/adapter/capture-runner";
+/**
+ * A browser service the runner connects to instead of launching, for `browsers`. It offers one
+ * target per engine, `<engine>@<name>`, each with its own baselines (ADR 0007, decision 3), and
+ * throws when the runner is created for a bad name, engine, protocol or endpoint.
+ *
+ * ```ts
+ * // A fixed service:
+ * remote({
+ *   name: "mygrid",
+ *   engines: ["chromium", "firefox", "webkit"],
+ *   protocol: "playwright",
+ *   reach: "loopback", // its browser can route back to this host
+ *   connect: { endpoint: "wss://grid.example/" },
+ *   sessions: 4,
+ *   maxPagesPerConnection: 2,
+ * });
+ *
+ * // A service that must be woken first, with a lease handed back to `release`:
+ * remote<{ id: string }>({
+ *   name: "pool",
+ *   engines: ["chromium"],
+ *   protocol: "playwright",
+ *   reach: "loopback",
+ *   sessions: 4,
+ *   connect: async ({ shardIndex, signal }) => {
+ *     const server = await wake(shardIndex, signal);
+ *     return { endpoint: server.endpoint, lease: { id: server.id } };
+ *   },
+ *   release: async (lease, { outcome }) => await suspend(lease.id, outcome),
+ * });
+ * ```
+ */
+declare function remote<TLease = unknown>(options: RemoteOptions<TLease>): RemoteBrowser$1;
+export { type BrowserName$1 as BrowserName, type RemoteBrowser$1 as RemoteBrowser, type RemoteConnection, type RemoteOptions, remote };
+//# sourceMappingURL=remote.d.mts.map

package/dist/remote/remote.mjs

@@ -0,0 +1,55 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { defineRemote } from "@storyshelf/core/adapter/capture-runner";
+// src/remote/remote.ts
+/** The generic remote browser entry: every preset is sugar over it (ADR 0007, decision 1). */
+/** What the Playwright runner can drive: every engine, over its own protocol or CDP (Chromium only). */
+const SUPPORT = {
+	engines: [
+		"chromium",
+		"firefox",
+		"webkit",
+		"chrome"
+	],
+	protocols: ["playwright", "cdp"],
+	label: "remote()"
+};
+/**
+* A browser service the runner connects to instead of launching, for `browsers`. It offers one
+* target per engine, `<engine>@<name>`, each with its own baselines (ADR 0007, decision 3), and
+* throws when the runner is created for a bad name, engine, protocol or endpoint.
+*
+* ```ts
+* // A fixed service:
+* remote({
+*   name: "mygrid",
+*   engines: ["chromium", "firefox", "webkit"],
+*   protocol: "playwright",
+*   reach: "loopback", // its browser can route back to this host
+*   connect: { endpoint: "wss://grid.example/" },
+*   sessions: 4,
+*   maxPagesPerConnection: 2,
+* });
+*
+* // A service that must be woken first, with a lease handed back to `release`:
+* remote<{ id: string }>({
+*   name: "pool",
+*   engines: ["chromium"],
+*   protocol: "playwright",
+*   reach: "loopback",
+*   sessions: 4,
+*   connect: async ({ shardIndex, signal }) => {
+*     const server = await wake(shardIndex, signal);
+*     return { endpoint: server.endpoint, lease: { id: server.id } };
+*   },
+*   release: async (lease, { outcome }) => await suspend(lease.id, outcome),
+* });
+* ```
+*/
+function remote(options) {
+	return defineRemote(options, SUPPORT);
+}
+export { remote };
+
+//# sourceMappingURL=remote.mjs.map

package/dist/remote/remote.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.mjs","names":[],"sources":["../../src/remote/remote.ts"],"sourcesContent":["/** The generic remote browser entry: every preset is sugar over it (ADR 0007, decision 1). */\nimport {\n  defineRemote,\n  type BrowserName,\n  type RemoteBrowser,\n  type RemoteConnection,\n  type RemoteOptions,\n  type RemoteSupport,\n} from \"@storyshelf/core/adapter/capture-runner\";\n\n/** What the Playwright runner can drive: every engine, over its own protocol or CDP (Chromium only). */\nconst SUPPORT: RemoteSupport = {\n  engines: [\"chromium\", \"firefox\", \"webkit\", \"chrome\"],\n  protocols: [\"playwright\", \"cdp\"],\n  label: \"remote()\",\n};\n\n/**\n * A browser service the runner connects to instead of launching, for `browsers`. It offers one\n * target per engine, `<engine>@<name>`, each with its own baselines (ADR 0007, decision 3), and\n * throws when the runner is created for a bad name, engine, protocol or endpoint.\n *\n * ```ts\n * // A fixed service:\n * remote({\n *   name: \"mygrid\",\n *   engines: [\"chromium\", \"firefox\", \"webkit\"],\n *   protocol: \"playwright\",\n *   reach: \"loopback\", // its browser can route back to this host\n *   connect: { endpoint: \"wss://grid.example/\" },\n *   sessions: 4,\n *   maxPagesPerConnection: 2,\n * });\n *\n * // A service that must be woken first, with a lease handed back to `release`:\n * remote<{ id: string }>({\n *   name: \"pool\",\n *   engines: [\"chromium\"],\n *   protocol: \"playwright\",\n *   reach: \"loopback\",\n *   sessions: 4,\n *   connect: async ({ shardIndex, signal }) => {\n *     const server = await wake(shardIndex, signal);\n *     return { endpoint: server.endpoint, lease: { id: server.id } };\n *   },\n *   release: async (lease, { outcome }) => await suspend(lease.id, outcome),\n * });\n * ```\n */\nexport function remote<TLease = unknown>(options: RemoteOptions<TLease>): RemoteBrowser {\n  return defineRemote(options, SUPPORT);\n}\n\nexport type { BrowserName, RemoteBrowser, RemoteConnection, RemoteOptions };\n"],"mappings":";;;;;;;AAWA,MAAM,UAAyB;CAC7B,SAAS;EAAC;EAAY;EAAW;EAAU;CAAQ;CACnD,WAAW,CAAC,cAAc,KAAK;CAC/B,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,OAAyB,SAA+C;CACtF,OAAO,aAAa,SAAS,OAAO;AACtC"}

package/dist/remote-environment.mjs

@@ -0,0 +1,49 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { messageOf } from "./browser.mjs";
+import { FONT_PROBE_FAMILIES, boundedProbe, inPageProbe, remoteEnvironment } from "@storyshelf/core/utils";
+// src/remote-environment.ts
+/**
+* The fingerprint of the browser a render drove: its version, and what a blank page in it reports
+* (OS, pixel ratio, installed fonts). Never `process.platform` or `fc-list`, which describe this
+* host. The probe is bounded by `remote.timeouts.probeMs`: a page that cannot be probed, or that
+* overruns, leaves those fields out with a warning, and an unknown component is not a change
+* (ADR 0005), so a service outage here cannot rewrite baselines. A cancel is not an outage: it
+* throws `Capture cancelled` so the run stops and is never stored as an unknown environment.
+*/
+async function measureRemote(browser, remote, options = {}) {
+	return remoteEnvironment({
+		browserVersion: typeof browser.version === "function" ? browser.version() : void 0,
+		probe: await probeBlankPage(browser, remote.timeouts.probeMs, options),
+		declaredPlatform: remote.platform
+	});
+}
+/**
+* Open a blank page, read the probe and close the page, within the limit. The page is closed on
+* every path: after a result, after a failure, and after a timeout or cancel, when the work that
+* opened it may still be pending (a page it opens late is closed by the work itself).
+*/
+async function probeBlankPage(browser, timeoutMs, options) {
+	let page;
+	const outcome = await boundedProbe({
+		timeoutMs,
+		signal: options.signal,
+		run: async ({ stopped }) => {
+			const opened = await browser.newPage();
+			page = opened;
+			if (stopped()) {
+				await opened.close().catch(() => {});
+				throw new Error("the measurement stopped before its page opened");
+			}
+			return await opened.evaluate(inPageProbe, [...FONT_PROBE_FAMILIES]);
+		}
+	});
+	await page?.close().catch(() => {});
+	if (outcome.status === "done") return outcome.value;
+	if (outcome.status === "cancelled") throw new Error("Capture cancelled");
+	options.logger?.warn(outcome.status === "timeout" ? { timeoutMs } : { reason: messageOf(outcome.error) }, outcome.status === "timeout" ? "measuring the remote browser timed out; its environment is unknown" : "could not measure the remote browser");
+}
+export { measureRemote };
+
+//# sourceMappingURL=remote-environment.mjs.map

package/dist/remote-environment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-environment.mjs","names":[],"sources":["../src/remote-environment.ts"],"sourcesContent":["/** Measuring a remote browser's environment from inside it (ADR 0007, decision 2). */\nimport type { CaptureEnvironment, RemoteBrowser } from \"@storyshelf/core/adapter/capture-runner\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport {\n  FONT_PROBE_FAMILIES,\n  boundedProbe,\n  inPageProbe,\n  remoteEnvironment,\n  type BrowserProbe,\n} from \"@storyshelf/core/utils\";\nimport type { Browser, Page } from \"playwright-core\";\nimport { messageOf } from \"./browser.ts\";\n\n/** What stops a measurement: the run's cancel signal, and where warnings go. */\nexport interface MeasureOptions {\n  logger?: Logger | undefined;\n  /** Aborted when the run is cancelled; the measurement then stops the run. */\n  signal?: AbortSignal | undefined;\n}\n\n/**\n * The fingerprint of the browser a render drove: its version, and what a blank page in it reports\n * (OS, pixel ratio, installed fonts). Never `process.platform` or `fc-list`, which describe this\n * host. The probe is bounded by `remote.timeouts.probeMs`: a page that cannot be probed, or that\n * overruns, leaves those fields out with a warning, and an unknown component is not a change\n * (ADR 0005), so a service outage here cannot rewrite baselines. A cancel is not an outage: it\n * throws `Capture cancelled` so the run stops and is never stored as an unknown environment.\n */\nexport async function measureRemote(\n  browser: Browser,\n  remote: RemoteBrowser,\n  options: MeasureOptions = {},\n): Promise<CaptureEnvironment> {\n  return remoteEnvironment({\n    browserVersion: typeof browser.version === \"function\" ? browser.version() : undefined,\n    probe: await probeBlankPage(browser, remote.timeouts.probeMs, options),\n    declaredPlatform: remote.platform,\n  });\n}\n\n/**\n * Open a blank page, read the probe and close the page, within the limit. The page is closed on\n * every path: after a result, after a failure, and after a timeout or cancel, when the work that\n * opened it may still be pending (a page it opens late is closed by the work itself).\n */\nasync function probeBlankPage(\n  browser: Browser,\n  timeoutMs: number,\n  options: MeasureOptions,\n): Promise<BrowserProbe | undefined> {\n  let page: Page | undefined;\n  const outcome = await boundedProbe({\n    timeoutMs,\n    signal: options.signal,\n    run: async ({ stopped }) => {\n      const opened = await browser.newPage();\n      page = opened;\n      if (stopped()) {\n        await opened.close().catch(() => {});\n        throw new Error(\"the measurement stopped before its page opened\");\n      }\n      return await opened.evaluate(inPageProbe, [...FONT_PROBE_FAMILIES]);\n    },\n  });\n  await page?.close().catch(() => {});\n  if (outcome.status === \"done\") {\n    return outcome.value;\n  }\n  if (outcome.status === \"cancelled\") {\n    throw new Error(\"Capture cancelled\");\n  }\n  options.logger?.warn(\n    outcome.status === \"timeout\" ? { timeoutMs } : { reason: messageOf(outcome.error) },\n    outcome.status === \"timeout\"\n      ? \"measuring the remote browser timed out; its environment is unknown\"\n      : \"could not measure the remote browser\",\n  );\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AA4BA,eAAsB,cACpB,SACA,QACA,UAA0B,CAAC,GACE;CAC7B,OAAO,kBAAkB;EACvB,gBAAgB,OAAO,QAAQ,YAAY,aAAa,QAAQ,QAAQ,IAAI,KAAA;EAC5E,OAAO,MAAM,eAAe,SAAS,OAAO,SAAS,SAAS,OAAO;EACrE,kBAAkB,OAAO;CAC3B,CAAC;AACH;;;;;;AAOA,eAAe,eACb,SACA,WACA,SACmC;CACnC,IAAI;CACJ,MAAM,UAAU,MAAM,aAAa;EACjC;EACA,QAAQ,QAAQ;EAChB,KAAK,OAAO,EAAE,cAAc;GAC1B,MAAM,SAAS,MAAM,QAAQ,QAAQ;GACrC,OAAO;GACP,IAAI,QAAQ,GAAG;IACb,MAAM,OAAO,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACnC,MAAM,IAAI,MAAM,gDAAgD;GAClE;GACA,OAAO,MAAM,OAAO,SAAS,aAAa,CAAC,GAAG,mBAAmB,CAAC;EACpE;CACF,CAAC;CACD,MAAM,MAAM,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;CAClC,IAAI,QAAQ,WAAW,QACrB,OAAO,QAAQ;CAEjB,IAAI,QAAQ,WAAW,aACrB,MAAM,IAAI,MAAM,mBAAmB;CAErC,QAAQ,QAAQ,KACd,QAAQ,WAAW,YAAY,EAAE,UAAU,IAAI,EAAE,QAAQ,UAAU,QAAQ,KAAK,EAAE,GAClF,QAAQ,WAAW,YACf,uEACA,sCACN;AAEF"}

package/dist/runtime-params.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { mergeParameters } from "@storyshelf/core/capture";
-//#region src/runtime-params.ts
+// src/runtime-params.ts
 /** Per-run runtime-parameter extraction cache (ADR 0017). */
 /** Create the per-run runtime-parameter cache shared across captures. */
 function createRuntimeParamsState() {
@@ -15,6 +15,13 @@ function createRuntimeParamsState() {
 async function runtimeParametersForStory(state, page, storyId) {
 	return (state.extractFailed ? void 0 : await extractedParametersMap(state, page))?.get(storyId);
 }
+/** Read every story's resolved parameters from a loaded preview page in one call. */
+async function extractAllParameters(page) {
+	const raw = await readExtractedParameters(page);
+	const out = /* @__PURE__ */ new Map();
+	if (raw) fillParamsMap(out, raw);
+	return Object.fromEntries(out);
+}
 async function extractedParametersMap(state, page) {
 	state.extractPromise ??= loadExtractedParametersMap(state, page);
 	return await state.extractPromise;
@@ -54,7 +61,6 @@ async function readExtractedParameters(page) {
 function hasEntries(map) {
 	return Boolean(map && Object.keys(map).length > 0);
 }
-//#endregion
-export { createRuntimeParamsState, runtimeParametersForStory };
+export { createRuntimeParamsState, extractAllParameters, runtimeParametersForStory };
 
 //# sourceMappingURL=runtime-params.mjs.map

package/dist/runtime-params.mjs.map

@@ -1 +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"}
+{"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\n/** Read every story's resolved parameters from a loaded preview page in one call. */\nexport async function extractAllParameters(\n  page: RuntimeParamsPage,\n): Promise<Record<string, StoryParameters>> {\n  const raw = await readExtractedParameters(page);\n  const out = new Map<string, StoryParameters>();\n  if (raw) fillParamsMap(out, raw);\n  return Object.fromEntries(out);\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;;AAGA,eAAsB,qBACpB,MAC0C;CAC1C,MAAM,MAAM,MAAM,wBAAwB,IAAI;CAC9C,MAAM,sBAAM,IAAI,IAA6B;CAC7C,IAAI,KAAK,cAAc,KAAK,GAAG;CAC/B,OAAO,OAAO,YAAY,GAAG;AAC/B;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"}