@storyshelf/runner-puppeteer 0.6.2 → 0.8.0

package/dist/static-server.mjs

@@ -1,12 +1,11 @@
-import "node:path";
+import { join, normalize } from "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
+// src/static-server.ts
 /**
 * Serve a built Storybook directory over HTTP on 127.0.0.1 for capture.
 *
@@ -68,7 +67,6 @@ async function closeServer(server) {
 		});
 	});
 }
-//#endregion
 export { createStaticServer };
 
 //# sourceMappingURL=static-server.mjs.map

package/dist/static-server.mjs.map

@@ -1 +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"}
+{"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/targets.d.mts

@@ -0,0 +1,23 @@
+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 local}. */
+interface LocalOptions {
+  /** The browser binary this target launches (`puppeteer-core` ships none). */
+  executablePath?: string;
+}
+/** A local engine with options (ADR 0007, decision 1). */
+interface LocalBrowser {
+  readonly kind: "local";
+  readonly engine: BrowserName;
+  readonly options: LocalOptions;
+}
+/**
+ * One entry of `browsers`: a bare engine name, {@link local}, or a remote CDP service from
+ * `@storyshelf/runner-puppeteer/remote` (`cdp(...)`), which stands for one target per engine.
+ */
+type BrowserEntry = BrowserName | LocalBrowser | RemoteBrowser;
+/** A local engine with options, for `browsers`: `local("chrome", { executablePath: "/usr/bin/google-chrome" })`. */
+declare function local(engine: BrowserName, options?: LocalOptions): LocalBrowser;
+export { BrowserEntry, LocalBrowser, LocalOptions, local };
+//# sourceMappingURL=targets.d.mts.map

package/dist/targets.mjs

@@ -0,0 +1,79 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isBrowserName, isRemoteBrowser, remoteTargetsOf } from "@storyshelf/core/adapter/capture-runner";
+// src/targets.ts
+/** The runner's `browsers` option: what an operator lists, and the local targets it flattens to. */
+/** Engines Puppeteer drives: the Chromium family. */
+const SUPPORTED = ["chromium", "chrome"];
+/** A local engine with options, for `browsers`: `local("chrome", { executablePath: "/usr/bin/google-chrome" })`. */
+function local(engine, options = {}) {
+	if (!isBrowserName(engine)) throw new Error(`local(): unknown engine "${String(engine)}"`);
+	if (!SUPPORTED.includes(engine)) throw new Error(`local("${engine}"): the Puppeteer runner drives Chromium-family engines only (${SUPPORTED.join(", ")})`);
+	return {
+		kind: "local",
+		engine,
+		options
+	};
+}
+/**
+* Flatten the `browsers` list into targets, first = default. Throws on an empty list, an engine
+* Puppeteer cannot drive, bare `chrome` (it needs its own `executablePath`, since the runner's
+* would launch whatever it points at under Chrome's name), or two entries producing one target,
+* so a mistake fails when the runner is created and not when the first build runs.
+*/
+function flattenBrowsers(entries, runnerExecutablePath) {
+	if (entries.length === 0) throw new Error("browsers must list at least one target");
+	const seen = /* @__PURE__ */ new Map();
+	const flat = {
+		declared: [],
+		locals: [],
+		remotes: []
+	};
+	for (const [index, entry] of entries.entries()) {
+		const produced = isRemoteBrowser(entry) ? remoteTargetsOf(entry) : [localOf(entry, runnerExecutablePath)];
+		for (const target of produced) {
+			claim(seen, target.target, index);
+			add(flat, target);
+		}
+	}
+	return flat;
+}
+/** Record that entry `index` produces `target`, refusing a second entry that does. */
+function claim(seen, target, index) {
+	const first = seen.get(target);
+	if (first !== void 0) throw new Error(`browsers entries ${first + 1} and ${index + 1} both produce the target "${target}"`);
+	seen.set(target, index);
+}
+function localOf(entry, runnerExecutablePath) {
+	const { engine, options } = typeof entry === "string" ? local(entry) : entry;
+	return {
+		target: engine,
+		executablePath: pathOf(engine, options, runnerExecutablePath)
+	};
+}
+function add(flat, target) {
+	if ("kind" in target) {
+		flat.remotes.push(target);
+		flat.declared.push({
+			target: target.target,
+			reach: target.reach,
+			status: "ready"
+		});
+	} else {
+		flat.locals.push(target);
+		flat.declared.push({
+			target: target.target,
+			reach: "loopback",
+			status: "ready"
+		});
+	}
+}
+function pathOf(engine, options, runnerExecutablePath) {
+	if (options.executablePath !== void 0) return options.executablePath;
+	if (engine === "chrome") throw new Error(`"chrome" needs an executablePath: use local("chrome", { executablePath: "/usr/bin/google-chrome" })`);
+	return runnerExecutablePath;
+}
+export { flattenBrowsers, local };
+
+//# sourceMappingURL=targets.mjs.map

package/dist/targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.mjs","names":[],"sources":["../src/targets.ts"],"sourcesContent":["/** The runner's `browsers` option: what an operator lists, and the local targets it flattens to. */\nimport {\n  isBrowserName,\n  isRemoteBrowser,\n  remoteTargetsOf,\n  type BrowserName,\n  type RemoteBrowser,\n  type RemoteTarget,\n  type RunnerTarget,\n} from \"@storyshelf/core/adapter/capture-runner\";\n\n/** Options of {@link local}. */\nexport interface LocalOptions {\n  /** The browser binary this target launches (`puppeteer-core` ships none). */\n  executablePath?: string;\n}\n\n/** A local engine with options (ADR 0007, decision 1). */\nexport interface LocalBrowser {\n  readonly kind: \"local\";\n  readonly engine: BrowserName;\n  readonly options: LocalOptions;\n}\n\n/**\n * One entry of `browsers`: a bare engine name, {@link local}, or a remote CDP service from\n * `@storyshelf/runner-puppeteer/remote` (`cdp(...)`), which stands for one target per engine.\n */\nexport type BrowserEntry = BrowserName | LocalBrowser | RemoteBrowser;\n\n/** A local engine this runner launches. */\nexport interface LocalTarget {\n  /** The engine name, which is also the target. */\n  target: BrowserName;\n  /** The binary to launch: the entry's own, else the runner's for `chromium`; none for bare `chrome`. */\n  executablePath: string | undefined;\n}\n\n/** Engines Puppeteer drives: the Chromium family. */\nconst SUPPORTED: readonly BrowserName[] = [\"chromium\", \"chrome\"];\n\n/** A local engine with options, for `browsers`: `local(\"chrome\", { executablePath: \"/usr/bin/google-chrome\" })`. */\nexport function local(engine: BrowserName, options: LocalOptions = {}): LocalBrowser {\n  if (!isBrowserName(engine)) {\n    throw new Error(`local(): unknown engine \"${String(engine)}\"`);\n  }\n  if (!SUPPORTED.includes(engine)) {\n    throw new Error(\n      `local(\"${engine}\"): the Puppeteer runner drives Chromium-family engines only (${SUPPORTED.join(\", \")})`,\n    );\n  }\n  return { kind: \"local\", engine, options };\n}\n\n/** The `browsers` list, flattened: what the runner offers and how to start each target. */\nexport interface FlatTargets {\n  /** Every target as the runner declares it, default first (all `ready` until verified). */\n  declared: RunnerTarget[];\n  locals: LocalTarget[];\n  remotes: RemoteTarget[];\n}\n\n/**\n * Flatten the `browsers` list into targets, first = default. Throws on an empty list, an engine\n * Puppeteer cannot drive, bare `chrome` (it needs its own `executablePath`, since the runner's\n * would launch whatever it points at under Chrome's name), or two entries producing one target,\n * so a mistake fails when the runner is created and not when the first build runs.\n */\nexport function flattenBrowsers(\n  entries: readonly BrowserEntry[],\n  runnerExecutablePath?: string,\n): FlatTargets {\n  if (entries.length === 0) {\n    throw new Error(\"browsers must list at least one target\");\n  }\n  const seen = new Map<string, number>();\n  const flat: FlatTargets = { declared: [], locals: [], remotes: [] };\n  for (const [index, entry] of entries.entries()) {\n    const produced = isRemoteBrowser(entry)\n      ? remoteTargetsOf(entry)\n      : [localOf(entry, runnerExecutablePath)];\n    for (const target of produced) {\n      claim(seen, target.target, index);\n      add(flat, target);\n    }\n  }\n  return flat;\n}\n\n/** Record that entry `index` produces `target`, refusing a second entry that does. */\nfunction claim(seen: Map<string, number>, target: string, index: number): void {\n  const first = seen.get(target);\n  if (first !== undefined) {\n    throw new Error(\n      `browsers entries ${first + 1} and ${index + 1} both produce the target \"${target}\"`,\n    );\n  }\n  seen.set(target, index);\n}\n\nfunction localOf(entry: BrowserName | LocalBrowser, runnerExecutablePath?: string): LocalTarget {\n  const { engine, options } = typeof entry === \"string\" ? local(entry) : entry;\n  return { target: engine, executablePath: pathOf(engine, options, runnerExecutablePath) };\n}\n\nfunction add(flat: FlatTargets, target: LocalTarget | RemoteTarget): void {\n  if (\"kind\" in target) {\n    flat.remotes.push(target);\n    flat.declared.push({ target: target.target, reach: target.reach, status: \"ready\" });\n  } else {\n    flat.locals.push(target);\n    flat.declared.push({ target: target.target, reach: \"loopback\", status: \"ready\" });\n  }\n}\n\nfunction pathOf(\n  engine: BrowserName,\n  options: LocalOptions,\n  runnerExecutablePath?: string,\n): string | undefined {\n  if (options.executablePath !== undefined) {\n    return options.executablePath;\n  }\n  if (engine === \"chrome\") {\n    throw new Error(\n      `\"chrome\" needs an executablePath: use local(\"chrome\", { executablePath: \"/usr/bin/google-chrome\" })`,\n    );\n  }\n  return runnerExecutablePath;\n}\n"],"mappings":";;;;;;;AAuCA,MAAM,YAAoC,CAAC,YAAY,QAAQ;;AAG/D,SAAgB,MAAM,QAAqB,UAAwB,CAAC,GAAiB;CACnF,IAAI,CAAC,cAAc,MAAM,GACvB,MAAM,IAAI,MAAM,4BAA4B,OAAO,MAAM,EAAE,EAAE;CAE/D,IAAI,CAAC,UAAU,SAAS,MAAM,GAC5B,MAAM,IAAI,MACR,UAAU,OAAO,gEAAgE,UAAU,KAAK,IAAI,EAAE,EACxG;CAEF,OAAO;EAAE,MAAM;EAAS;EAAQ;CAAQ;AAC1C;;;;;;;AAgBA,SAAgB,gBACd,SACA,sBACa;CACb,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,wCAAwC;CAE1D,MAAM,uBAAO,IAAI,IAAoB;CACrC,MAAM,OAAoB;EAAE,UAAU,CAAC;EAAG,QAAQ,CAAC;EAAG,SAAS,CAAC;CAAE;CAClE,KAAK,MAAM,CAAC,OAAO,UAAU,QAAQ,QAAQ,GAAG;EAC9C,MAAM,WAAW,gBAAgB,KAAK,IAClC,gBAAgB,KAAK,IACrB,CAAC,QAAQ,OAAO,oBAAoB,CAAC;EACzC,KAAK,MAAM,UAAU,UAAU;GAC7B,MAAM,MAAM,OAAO,QAAQ,KAAK;GAChC,IAAI,MAAM,MAAM;EAClB;CACF;CACA,OAAO;AACT;;AAGA,SAAS,MAAM,MAA2B,QAAgB,OAAqB;CAC7E,MAAM,QAAQ,KAAK,IAAI,MAAM;CAC7B,IAAI,UAAU,KAAA,GACZ,MAAM,IAAI,MACR,oBAAoB,QAAQ,EAAE,OAAO,QAAQ,EAAE,4BAA4B,OAAO,EACpF;CAEF,KAAK,IAAI,QAAQ,KAAK;AACxB;AAEA,SAAS,QAAQ,OAAmC,sBAA4C;CAC9F,MAAM,EAAE,QAAQ,YAAY,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CACvE,OAAO;EAAE,QAAQ;EAAQ,gBAAgB,OAAO,QAAQ,SAAS,oBAAoB;CAAE;AACzF;AAEA,SAAS,IAAI,MAAmB,QAA0C;CACxE,IAAI,UAAU,QAAQ;EACpB,KAAK,QAAQ,KAAK,MAAM;EACxB,KAAK,SAAS,KAAK;GAAE,QAAQ,OAAO;GAAQ,OAAO,OAAO;GAAO,QAAQ;EAAQ,CAAC;CACpF,OAAO;EACL,KAAK,OAAO,KAAK,MAAM;EACvB,KAAK,SAAS,KAAK;GAAE,QAAQ,OAAO;GAAQ,OAAO;GAAY,QAAQ;EAAQ,CAAC;CAClF;AACF;AAEA,SAAS,OACP,QACA,SACA,sBACoB;CACpB,IAAI,QAAQ,mBAAmB,KAAA,GAC7B,OAAO,QAAQ;CAEjB,IAAI,WAAW,UACb,MAAM,IAAI,MACR,qGACF;CAEF,OAAO;AACT"}

package/dist/tests.mjs

@@ -0,0 +1,119 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { abortIfCancelled, finishing, messageOf, outcomeOf, safeCloseServer } from "./browser.mjs";
+import { waitForSettled } from "./settle.mjs";
+import { acquirePage } from "./pages.mjs";
+import { createBrowserSession } from "./session.mjs";
+import { assertReachable, launchContextOf, planRun, serve } from "./pipeline.mjs";
+import { engineOf } from "@storyshelf/core/adapter/capture-runner";
+import { createPageLimiter, isTimeoutError } from "@storyshelf/core/utils";
+import { StorybookAdapter } from "@storyshelf/core/capture";
+// src/tests.ts
+/** Storybook 10 `.test()` entries run as interaction tests in the iframe (ADR 0004, decision 10). */
+/** How long one test may take (render plus body) when the project sets nothing. */
+const DEFAULT_TEST_TIMEOUT_MS = 1e4;
+/** A viewport for tests: they take no screenshot, so one size serves every entry. */
+const TEST_VIEWPORT = {
+	name: "test",
+	width: 1280,
+	height: 720
+};
+/** Run every test entry once and report pass or fail for each; a failing test never throws. */
+async function runTestEntries(rawInput, active, driver, defaultTarget) {
+	if (rawInput.tests.length === 0) return [];
+	const { input, name, remote } = planRun(rawInput, driver, defaultTarget);
+	assertReachable(name, remote, input.storybookUrl);
+	const session = createBrowserSession(await driver.launch(name, input.logger, launchContextOf(input, "tests", active.abort?.signal)));
+	active.session = session;
+	await abortIfCancelled(active, session);
+	let server;
+	return await finishing(async () => {
+		server = await serve(input, session);
+		return await runAll(session, server.url, input, active);
+	}, async (failed, error) => {
+		if (active.session === session) active.session = null;
+		await Promise.all([session.release(outcomeOf(active, failed), error), closeServer(server)]);
+	});
+}
+async function closeServer(server) {
+	if (server !== void 0) await safeCloseServer(server);
+}
+async function runAll(session, baseUrl, input, active) {
+	const outcomes = /* @__PURE__ */ new Map();
+	const pages = createPageLimiter({
+		concurrency: input.concurrency,
+		...input.gate === void 0 ? {} : { gate: input.gate },
+		browser: engineOf(input.target),
+		logger: input.logger
+	});
+	try {
+		await pages.each(input.tests, async (test) => {
+			if (active.cancelled) throw new Error("Capture cancelled");
+			const outcome = await runTestEntry(session, baseUrl, test, input);
+			outcomes.set(test.id, outcome);
+			return outcome.timedOut === true;
+		});
+	} finally {
+		pages.dispose();
+	}
+	return input.tests.flatMap((test) => outcomes.get(test.id) ?? []);
+}
+/** One test: open its iframe URL, let Storybook render and run it, then read the verdict. */
+async function runTestEntry(session, baseUrl, test, input) {
+	const started = performance.now();
+	const lease = await acquirePage({ session }, TEST_VIEWPORT);
+	let reusable = false;
+	try {
+		const report = await openAndWait(lease.page, baseUrl, test, input);
+		reusable = true;
+		const timeoutMs = input.playTimeoutMs ?? 1e4;
+		return verdictOf(test.id, report, timeoutMs, elapsedSince(started));
+	} catch (error) {
+		return crashed(test.id, error, elapsedSince(started));
+	} finally {
+		await lease.release(reusable);
+	}
+}
+function elapsedSince(started) {
+	return Math.round(performance.now() - started);
+}
+/** The page or navigation failed before Storybook could say anything: the test failed. */
+function crashed(storyId, error, durationMs) {
+	return {
+		storyId,
+		status: "failed",
+		error: messageOf(error),
+		durationMs,
+		timedOut: isTimeoutError(error)
+	};
+}
+async function openAndWait(page, baseUrl, test, input) {
+	if (input.navigationTimeoutMs) page.setDefaultTimeout(input.navigationTimeoutMs);
+	const adapter = input.adapter ?? new StorybookAdapter();
+	await page.goto(adapter.buildUrl(baseUrl, test.id), { waitUntil: "load" });
+	return await waitForSettled(page, input.playTimeoutMs ?? 1e4, true);
+}
+/** Read Storybook's own account of the run: a thrown play body or render error fails the test. */
+function verdictOf(storyId, report, timeoutMs, durationMs) {
+	const failed = (error, timedOut = false) => ({
+		storyId,
+		status: "failed",
+		error,
+		durationMs,
+		...timedOut ? { timedOut } : {}
+	});
+	if (!report.hooked) return failed("Storybook's preview did not start (no channel to listen to)");
+	if (report.renderError !== void 0) return failed(`render failed: ${report.renderError}`);
+	if (report.playError !== void 0) return failed(report.playError);
+	if (report.unhandled?.[0] !== void 0) return failed(report.unhandled[0]);
+	if (!report.settled) return failed(`test did not finish within ${timeoutMs}ms (phase: ${report.phase ?? "unknown"})`, true);
+	return {
+		storyId,
+		status: "passed",
+		durationMs
+	};
+}
+export { DEFAULT_TEST_TIMEOUT_MS, runTestEntries, verdictOf };
+
+//# sourceMappingURL=tests.mjs.map

package/dist/tests.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tests.mjs","names":[],"sources":["../src/tests.ts"],"sourcesContent":["/** Storybook 10 `.test()` entries run as interaction tests in the iframe (ADR 0004, decision 10). */\n\nimport {\n  engineOf,\n  type CaptureTarget,\n  type StoryEntry,\n  type TestOutcome,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { StorybookAdapter } from \"@storyshelf/core/capture\";\nimport { createPageLimiter, isTimeoutError, type SessionGate } from \"@storyshelf/core/utils\";\nimport type { Page } from \"puppeteer-core\";\nimport { abortIfCancelled, finishing, messageOf, outcomeOf, safeCloseServer } from \"./browser.ts\";\nimport { acquirePage } from \"./pages.ts\";\nimport { assertReachable, launchContextOf, planRun, serve } from \"./pipeline.ts\";\nimport { createBrowserSession, type BrowserSession } from \"./session.ts\";\nimport { waitForSettled, type SettleReport } from \"./settle.ts\";\nimport type { ActiveRun, PuppeteerTestsInput, TargetDriver } from \"./types.ts\";\n\n/** How long one test may take (render plus body) when the project sets nothing. */\nexport const DEFAULT_TEST_TIMEOUT_MS = 10_000;\n\n/** A viewport for tests: they take no screenshot, so one size serves every entry. */\nconst TEST_VIEWPORT = { name: \"test\", width: 1280, height: 720 };\n\n/** Run every test entry once and report pass or fail for each; a failing test never throws. */\nexport async function runTestEntries(\n  rawInput: PuppeteerTestsInput,\n  active: ActiveRun,\n  driver: TargetDriver,\n  defaultTarget: CaptureTarget,\n): Promise<TestOutcome[]> {\n  if (rawInput.tests.length === 0) return [];\n  const { input, name, remote } = planRun(rawInput, driver, defaultTarget);\n  assertReachable(name, remote, input.storybookUrl);\n  const session = createBrowserSession(\n    await driver.launch(name, input.logger, launchContextOf(input, \"tests\", active.abort?.signal)),\n  );\n  active.session = session;\n  await abortIfCancelled(active, session);\n  let server: { url: string; close(): Promise<void> } | undefined;\n  return await finishing(\n    async () => {\n      server = await serve(input, session);\n      return await runAll(session, server.url, input, active);\n    },\n    async (failed, error) => {\n      if (active.session === session) active.session = null;\n      await Promise.all([session.release(outcomeOf(active, failed), error), closeServer(server)]);\n    },\n  );\n}\n\nasync function closeServer(server: { close(): Promise<void> } | undefined): Promise<void> {\n  if (server !== undefined) await safeCloseServer(server);\n}\n\nasync function runAll(\n  session: BrowserSession,\n  baseUrl: string,\n  input: PuppeteerTestsInput & { target: CaptureTarget; gate?: SessionGate | undefined },\n  active: ActiveRun,\n): Promise<TestOutcome[]> {\n  const outcomes = new Map<string, TestOutcome>();\n  const pages = createPageLimiter({\n    concurrency: input.concurrency,\n    ...(input.gate === undefined ? {} : { gate: input.gate }),\n    browser: engineOf(input.target),\n    logger: input.logger,\n  });\n  try {\n    await pages.each(input.tests, async (test) => {\n      if (active.cancelled) throw new Error(\"Capture cancelled\");\n      const outcome = await runTestEntry(session, baseUrl, test, input);\n      outcomes.set(test.id, outcome);\n      return outcome.timedOut === true;\n    });\n  } finally {\n    pages.dispose();\n  }\n  return input.tests.flatMap((test) => outcomes.get(test.id) ?? []);\n}\n\n/** One test: open its iframe URL, let Storybook render and run it, then read the verdict. */\nasync function runTestEntry(\n  session: BrowserSession,\n  baseUrl: string,\n  test: StoryEntry,\n  input: PuppeteerTestsInput,\n): Promise<TestOutcome & { timedOut?: boolean }> {\n  const started = performance.now();\n  const lease = await acquirePage({ session }, TEST_VIEWPORT);\n  let reusable = false;\n  try {\n    const report = await openAndWait(lease.page, baseUrl, test, input);\n    reusable = true;\n    const timeoutMs = input.playTimeoutMs ?? DEFAULT_TEST_TIMEOUT_MS;\n    return verdictOf(test.id, report, timeoutMs, elapsedSince(started));\n  } catch (error) {\n    return crashed(test.id, error, elapsedSince(started));\n  } finally {\n    await lease.release(reusable);\n  }\n}\n\nfunction elapsedSince(started: number): number {\n  return Math.round(performance.now() - started);\n}\n\n/** The page or navigation failed before Storybook could say anything: the test failed. */\nfunction crashed(\n  storyId: string,\n  error: unknown,\n  durationMs: number,\n): TestOutcome & { timedOut?: boolean } {\n  return {\n    storyId,\n    status: \"failed\",\n    error: messageOf(error),\n    durationMs,\n    timedOut: isTimeoutError(error),\n  };\n}\n\nasync function openAndWait(\n  page: Page,\n  baseUrl: string,\n  test: StoryEntry,\n  input: PuppeteerTestsInput,\n): Promise<SettleReport> {\n  if (input.navigationTimeoutMs) page.setDefaultTimeout(input.navigationTimeoutMs);\n  const adapter = input.adapter ?? new StorybookAdapter();\n  await page.goto(adapter.buildUrl(baseUrl, test.id), { waitUntil: \"load\" });\n  return await waitForSettled(page, input.playTimeoutMs ?? DEFAULT_TEST_TIMEOUT_MS, true);\n}\n\n/** Read Storybook's own account of the run: a thrown play body or render error fails the test. */\nexport function verdictOf(\n  storyId: string,\n  report: SettleReport,\n  timeoutMs: number,\n  durationMs: number,\n): TestOutcome & { timedOut?: boolean } {\n  const failed = (error: string, timedOut = false): TestOutcome & { timedOut?: boolean } => ({\n    storyId,\n    status: \"failed\",\n    error,\n    durationMs,\n    ...(timedOut ? { timedOut } : {}),\n  });\n  if (!report.hooked) return failed(\"Storybook's preview did not start (no channel to listen to)\");\n  if (report.renderError !== undefined) return failed(`render failed: ${report.renderError}`);\n  if (report.playError !== undefined) return failed(report.playError);\n  if (report.unhandled?.[0] !== undefined) return failed(report.unhandled[0]);\n  if (!report.settled) {\n    return failed(\n      `test did not finish within ${timeoutMs}ms (phase: ${report.phase ?? \"unknown\"})`,\n      true,\n    );\n  }\n  return { storyId, status: \"passed\", durationMs };\n}\n"],"mappings":"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"}

package/dist/types.d.mts

@@ -1,6 +1,8 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import "./session.mjs";
+import "./pages.mjs";
+import "@storyshelf/core/adapter/capture-runner";
+import "@storyshelf/core/utils";
 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,6 @@
 {
   "name": "@storyshelf/runner-puppeteer",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "Puppeteer CaptureRunner for StoryShelf (Chromium via chrome-headless-shell, smaller image).",
   "keywords": [
     "puppeteer",
@@ -27,9 +27,6 @@
     "dist"
   ],
   "type": "module",
-  "engines": {
-    "node": ">=24"
-  },
   "sideEffects": false,
   "types": "./dist/index.d.mts",
   "exports": {
@@ -37,11 +34,16 @@
       "source": "./src/index.ts",
       "default": "./dist/index.mjs"
     },
+    "./remote": {
+      "source": "./src/remote/index.ts",
+      "default": "./dist/remote/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "exports": {
       ".": "./dist/index.mjs",
+      "./remote": "./dist/remote/index.mjs",
       "./package.json": "./package.json"
     },
     "access": "public"
@@ -52,25 +54,30 @@
     "fmt": "oxfmt ./src",
     "lint": "oxlint --type-aware --type-check ./src",
     "test": "vitest run",
-    "prepublishOnly": "nub run build"
+    "test:integration": "RUN_INTEGRATION=1 vitest run a11y.integration.test.ts settle.integration.test.ts remote.integration.test.ts ignore-regions.integration.test.ts",
+    "prepublishOnly": "nub run build",
+    "test:flake": "vitest run --repeats=20 --maxWorkers=1 --no-file-parallelism src/capture-runner.test.ts src/settle.test.ts src/screenshot.test.ts"
   },
   "dependencies": {
-    "@storyshelf/core": "0.6.2",
+    "@storyshelf/core": "0.8.0",
     "puppeteer-core": "^24.0.0"
   },
   "devDependencies": {
-    "@storyshelf/app": "0.6.2",
-    "@storyshelf/db-sqlite": "0.6.2",
-    "@storyshelf/storage-local": "0.6.2",
+    "@storyshelf/app": "0.8.0",
+    "@storyshelf/db-sqlite": "0.8.0",
+    "@storyshelf/storage-local": "0.8.0",
     "@types/node": "^26.0.0",
     "@vitest/coverage-v8": "^4.0.0",
-    "adm-zip": "0.6.0",
+    "adm-zip": "0.6.1",
     "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"
+    "vitest": "^5.0.5"
+  },
+  "engines": {
+    "node": ">=24"
   },
   "jsr": {
     "runtimeCompat": {