@storyshelf/core 0.6.2 → 0.8.0

package/dist/capture/a11y/axe-source.mjs

@@ -0,0 +1,36 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { createRequire } from "node:module";
+import { readFile } from "node:fs/promises";
+// src/capture/a11y/axe-source.ts
+/** Lazy, cached loader for the axe-core browser bundle. */
+let cached;
+/**
+* Read `axe.min.js` (~550 KB) once per process, on first use. Lazy on purpose: servers that never run
+* accessibility checks do not touch the file at boot. A failed read is not cached.
+*/
+async function loadAxeSource() {
+	cached ??= readAxeSource();
+	try {
+		return await cached;
+	} catch (error) {
+		cached = void 0;
+		throw error;
+	}
+}
+/**
+* Wrap the axe source so evaluating it twice in one document is a no-op. Evaluate it as a string
+* (CDP `Runtime.evaluate`: not bound by the page's CSP and works over remote browsers, since the
+* source travels over the wire instead of a file path).
+*/
+function axeInjectionScript(source) {
+	return `(function(){if(typeof globalThis.axe!=="undefined")return;\n${source}\n})()`;
+}
+async function readAxeSource() {
+	const path = createRequire(import.meta.url).resolve("axe-core/axe.min.js");
+	return await readFile(path, "utf8");
+}
+export { axeInjectionScript, loadAxeSource };
+
+//# sourceMappingURL=axe-source.mjs.map

package/dist/capture/a11y/axe-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"axe-source.mjs","names":[],"sources":["../../../src/capture/a11y/axe-source.ts"],"sourcesContent":["/** Lazy, cached loader for the axe-core browser bundle. */\n\nimport { readFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\n\nlet cached: Promise<string> | undefined;\n\n/**\n * Read `axe.min.js` (~550 KB) once per process, on first use. Lazy on purpose: servers that never run\n * accessibility checks do not touch the file at boot. A failed read is not cached.\n */\nexport async function loadAxeSource(): Promise<string> {\n  cached ??= readAxeSource();\n  try {\n    return await cached;\n  } catch (error) {\n    cached = undefined;\n    throw error;\n  }\n}\n\n/**\n * Wrap the axe source so evaluating it twice in one document is a no-op. Evaluate it as a string\n * (CDP `Runtime.evaluate`: not bound by the page's CSP and works over remote browsers, since the\n * source travels over the wire instead of a file path).\n */\nexport function axeInjectionScript(source: string): string {\n  return `(function(){if(typeof globalThis.axe!==\"undefined\")return;\\n${source}\\n})()`;\n}\n\n/** Drop the cached source (tests). */\nexport function resetAxeSourceCache(): void {\n  cached = undefined;\n}\n\nasync function readAxeSource(): Promise<string> {\n  const path = createRequire(import.meta.url).resolve(\"axe-core/axe.min.js\");\n  return await readFile(path, \"utf8\");\n}\n"],"mappings":";;;;;;;AAKA,IAAI;;;;;AAMJ,eAAsB,gBAAiC;CACrD,WAAW,cAAc;CACzB,IAAI;EACF,OAAO,MAAM;CACf,SAAS,OAAO;EACd,SAAS,KAAA;EACT,MAAM;CACR;AACF;;;;;;AAOA,SAAgB,mBAAmB,QAAwB;CACzD,OAAO,+DAA+D,OAAO;AAC/E;AAOA,eAAe,gBAAiC;CAC9C,MAAM,OAAO,cAAc,YAAY,GAAG,CAAC,CAAC,QAAQ,qBAAqB;CACzE,OAAO,MAAM,SAAS,MAAM,MAAM;AACpC"}

package/dist/capture/a11y/in-page.d.mts

@@ -0,0 +1,25 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { SlimViolation } from "./map.mjs";
+import { A11yRunPlan } from "./options.mjs";
+/** What {@link inPageReadA11yParameters} found: the plain-data `parameters.a11y` and what was dropped. */
+interface A11yParametersRead {
+  params: unknown;
+  /** Function, symbol and undefined values left out because a page cannot hand them over. */
+  dropped: number;
+}
+/**
+ * Read the current story's `parameters.a11y` from the running Storybook preview as plain data.
+ * Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are
+ * dropped, and an object or array item that held nothing else goes with them (an emptied rule item
+ * would otherwise reset to axe's default). Returns undefined when there is no `a11y` parameter or it
+ * cannot be read at all (cyclic).
+ */
+declare function inPageReadA11yParameters(): A11yParametersRead | undefined;
+/**
+ * Run the injected axe over the plan's context and return only slim fields (id, impact, help, first
+ * target, node count). Throws when axe is not present in the page.
+ */
+declare function inPageRunAxe(plan: A11yRunPlan): Promise<SlimViolation[]>;
+export { A11yParametersRead, inPageReadA11yParameters, inPageRunAxe };
+//# sourceMappingURL=in-page.d.mts.map

package/dist/capture/a11y/in-page.mjs

@@ -0,0 +1,59 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/a11y/in-page.ts
+/**
+* Read the current story's `parameters.a11y` from the running Storybook preview as plain data.
+* Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are
+* dropped, and an object or array item that held nothing else goes with them (an emptied rule item
+* would otherwise reset to axe's default). Returns undefined when there is no `a11y` parameter or it
+* cannot be read at all (cyclic).
+*/
+function inPageReadA11yParameters() {
+	const a11y = globalThis.__STORYBOOK_PREVIEW__?.currentRender?.story?.parameters?.a11y;
+	if (a11y === void 0) return void 0;
+	const state = { dropped: 0 };
+	const DROP = Symbol("drop");
+	const clean = (value, depth) => {
+		if (depth > 32) throw new Error("too deep");
+		if (typeof value === "function" || typeof value === "symbol" || value === void 0) {
+			state.dropped += 1;
+			return DROP;
+		}
+		if (value === null || typeof value !== "object") return value;
+		const before = state.dropped;
+		const entries = Array.isArray(value) ? value.map((item, index) => [String(index), item]) : Object.entries(value);
+		const kept = entries.map(([key, item]) => [key, clean(item, depth + 1)]).filter(([, item]) => item !== DROP);
+		if (kept.length === 0 && entries.length > 0 && state.dropped > before) return DROP;
+		return Array.isArray(value) ? kept.map(([, item]) => item) : Object.fromEntries(kept);
+	};
+	try {
+		const params = clean(a11y, 0);
+		return {
+			params: params === DROP ? void 0 : params,
+			dropped: state.dropped
+		};
+	} catch {
+		return;
+	}
+}
+/**
+* Run the injected axe over the plan's context and return only slim fields (id, impact, help, first
+* target, node count). Throws when axe is not present in the page.
+*/
+async function inPageRunAxe(plan) {
+	const win = globalThis;
+	if (!win.axe) throw new Error("axe is not loaded in the page");
+	if (typeof plan.context === "string" && !win.document.querySelector(plan.context)) return [];
+	if (Object.keys(plan.config).length > 0) win.axe.configure(plan.config);
+	return (await win.axe.run(plan.context, plan.options)).violations.map((v) => ({
+		id: v.id,
+		impact: v.impact ?? null,
+		help: v.help,
+		target: (v.nodes[0]?.target ?? []).flat(Infinity).join(" "),
+		count: v.nodes.length
+	}));
+}
+export { inPageReadA11yParameters, inPageRunAxe };
+
+//# sourceMappingURL=in-page.mjs.map

package/dist/capture/a11y/in-page.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page.mjs","names":["win"],"sources":["../../../src/capture/a11y/in-page.ts"],"sourcesContent":["/**\n * Functions evaluated inside the story page. Playwright and Puppeteer serialise only a function's\n * source, so each must stay ONE self-contained function: no imports, helpers or module bindings\n * (`in-page.test.ts` rebuilds them from source in a bare scope to guard that).\n */\n\nimport type { SlimViolation } from \"./map.ts\";\nimport type { A11yRunPlan } from \"./options.ts\";\n\n/** What {@link inPageReadA11yParameters} found: the plain-data `parameters.a11y` and what was dropped. */\nexport interface A11yParametersRead {\n  params: unknown;\n  /** Function, symbol and undefined values left out because a page cannot hand them over. */\n  dropped: number;\n}\n\n/**\n * Read the current story's `parameters.a11y` from the running Storybook preview as plain data.\n * Functions (`config.rules[].matches`, custom checks) cannot cross into the runner, so they are\n * dropped, and an object or array item that held nothing else goes with them (an emptied rule item\n * would otherwise reset to axe's default). Returns undefined when there is no `a11y` parameter or it\n * cannot be read at all (cyclic).\n */\n// oxlint-disable-next-line eslint/max-statements -- must stay one self-contained function (see above)\nexport function inPageReadA11yParameters(): A11yParametersRead | undefined {\n  const win = globalThis as unknown as {\n    // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n    __STORYBOOK_PREVIEW__?: {\n      currentRender?: { story?: { parameters?: { a11y?: unknown } } };\n    };\n  };\n  // oxlint-disable-next-line eslint/no-underscore-dangle -- Storybook global\n  const a11y = win.__STORYBOOK_PREVIEW__?.currentRender?.story?.parameters?.a11y;\n  if (a11y === undefined) return undefined;\n  const state = { dropped: 0 };\n  const DROP = Symbol(\"drop\");\n  const clean = (value: unknown, depth: number): unknown => {\n    if (depth > 32) throw new Error(\"too deep\");\n    if (typeof value === \"function\" || typeof value === \"symbol\" || value === undefined) {\n      state.dropped += 1;\n      return DROP;\n    }\n    if (value === null || typeof value !== \"object\") return value;\n    const before = state.dropped;\n    const entries: [string, unknown][] = Array.isArray(value)\n      ? value.map((item, index): [string, unknown] => [String(index), item])\n      : Object.entries(value);\n    const kept = entries\n      .map(([key, item]): [string, unknown] => [key, clean(item, depth + 1)])\n      .filter(([, item]) => item !== DROP);\n    if (kept.length === 0 && entries.length > 0 && state.dropped > before) return DROP;\n    return Array.isArray(value) ? kept.map(([, item]) => item) : Object.fromEntries(kept);\n  };\n  try {\n    const params = clean(a11y, 0);\n    return { params: params === DROP ? undefined : params, dropped: state.dropped };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Run the injected axe over the plan's context and return only slim fields (id, impact, help, first\n * target, node count). Throws when axe is not present in the page.\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 inPageRunAxe(plan: A11yRunPlan): Promise<SlimViolation[]> {\n  const win = globalThis as unknown as {\n    axe?: {\n      configure: (config: unknown) => void;\n      run: (context: unknown, options: unknown) => Promise<{ violations: AxeViolation[] }>;\n    };\n    document: { querySelector: (selector: string) => unknown };\n  };\n  interface AxeViolation {\n    id: string;\n    impact?: string | null;\n    help: string;\n    nodes: { target: unknown[] }[];\n  }\n  if (!win.axe) throw new Error(\"axe is not loaded in the page\");\n  if (typeof plan.context === \"string\" && !win.document.querySelector(plan.context)) return [];\n  if (Object.keys(plan.config).length > 0) win.axe.configure(plan.config);\n  const results = await win.axe.run(plan.context, plan.options);\n  return results.violations.map((v) => ({\n    id: v.id,\n    impact: v.impact ?? null,\n    help: v.help,\n    target: (v.nodes[0]?.target ?? []).flat(Infinity).join(\" \"),\n    count: v.nodes.length,\n  }));\n}\n"],"mappings":";;;;;;;;;;;AAwBA,SAAgB,2BAA2D;CAQzE,MAAM,OAAOA,WAAI,uBAAuB,eAAe,OAAO,YAAY;CAC1E,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,MAAM,QAAQ,EAAE,SAAS,EAAE;CAC3B,MAAM,OAAO,OAAO,MAAM;CAC1B,MAAM,SAAS,OAAgB,UAA2B;EACxD,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,UAAU;EAC1C,IAAI,OAAO,UAAU,cAAc,OAAO,UAAU,YAAY,UAAU,KAAA,GAAW;GACnF,MAAM,WAAW;GACjB,OAAO;EACT;EACA,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;EACxD,MAAM,SAAS,MAAM;EACrB,MAAM,UAA+B,MAAM,QAAQ,KAAK,IACpD,MAAM,KAAK,MAAM,UAA6B,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC,IACnE,OAAO,QAAQ,KAAK;EACxB,MAAM,OAAO,QACV,KAAK,CAAC,KAAK,UAA6B,CAAC,KAAK,MAAM,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,CACtE,QAAQ,GAAG,UAAU,SAAS,IAAI;EACrC,IAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,KAAK,MAAM,UAAU,QAAQ,OAAO;EAC9E,OAAO,MAAM,QAAQ,KAAK,IAAI,KAAK,KAAK,GAAG,UAAU,IAAI,IAAI,OAAO,YAAY,IAAI;CACtF;CACA,IAAI;EACF,MAAM,SAAS,MAAM,MAAM,CAAC;EAC5B,OAAO;GAAE,QAAQ,WAAW,OAAO,KAAA,IAAY;GAAQ,SAAS,MAAM;EAAQ;CAChF,QAAQ;EACN;CACF;AACF;;;;;AAOA,eAAsB,aAAa,MAA6C;CAC9E,MAAM,MAAM;CAaZ,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,+BAA+B;CAC7D,IAAI,OAAO,KAAK,YAAY,YAAY,CAAC,IAAI,SAAS,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC;CAC3F,IAAI,OAAO,KAAK,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,UAAU,KAAK,MAAM;CAEtE,QAAO,MADe,IAAI,IAAI,IAAI,KAAK,SAAS,KAAK,OAAO,EAAA,CAC7C,WAAW,KAAK,OAAO;EACpC,IAAI,EAAE;EACN,QAAQ,EAAE,UAAU;EACpB,MAAM,EAAE;EACR,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAA,CAAG,KAAK,QAAQ,CAAC,CAAC,KAAK,GAAG;EAC1D,OAAO,EAAE,MAAM;CACjB,EAAE;AACJ"}

package/dist/capture/a11y/map.d.mts

@@ -0,0 +1,22 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** Map slim in-page axe results to `a11y:` violation strings. */
+/** Most violations reported per snapshot; the rest collapse into "…and N more". */
+declare const MAX_REPORTED_VIOLATIONS = 10;
+/** The only per-violation fields that leave the page (raw axe nodes carry large html payloads). */
+interface SlimViolation {
+  id: string;
+  impact: string | null;
+  help: string;
+  /** Selector of the first affected node. */
+  target: string;
+  /** Number of affected nodes. */
+  count: number;
+}
+/**
+ * One string per violation: rule id, impact, help text, short target and node count, worst impact
+ * first. `;` is reserved (the pipeline joins annotations with it), so it never appears in a string.
+ */
+declare function mapAxeViolations(violations: readonly SlimViolation[]): string[];
+export { MAX_REPORTED_VIOLATIONS, SlimViolation, mapAxeViolations };
+//# sourceMappingURL=map.d.mts.map

package/dist/capture/a11y/map.mjs

@@ -0,0 +1,47 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/a11y/map.ts
+/** Map slim in-page axe results to `a11y:` violation strings. */
+/** Most violations reported per snapshot; the rest collapse into "…and N more". */
+const MAX_REPORTED_VIOLATIONS = 10;
+const MAX_SELECTOR_LENGTH = 60;
+const MAX_HELP_LENGTH = 90;
+const IMPACT_ORDER = [
+	"critical",
+	"serious",
+	"moderate",
+	"minor"
+];
+/**
+* One string per violation: rule id, impact, help text, short target and node count, worst impact
+* first. `;` is reserved (the pipeline joins annotations with it), so it never appears in a string.
+*/
+function mapAxeViolations(violations) {
+	const sorted = violations.toSorted(compareViolations);
+	const lines = sorted.slice(0, 10).map((violation) => formatViolation(violation));
+	const more = sorted.length - lines.length;
+	if (more > 0) lines.push(`…and ${more} more`);
+	return lines;
+}
+function formatViolation(v) {
+	const nodes = `${v.count} node${v.count === 1 ? "" : "s"}`;
+	const target = truncate(v.target, MAX_SELECTOR_LENGTH);
+	return clean(`${v.id} (${v.impact ?? "unknown"}): ${truncate(v.help, MAX_HELP_LENGTH)} [${target}] ${nodes}`);
+}
+function compareViolations(a, b) {
+	return rank(a.impact) - rank(b.impact) || a.id.localeCompare(b.id);
+}
+function rank(impact) {
+	const index = IMPACT_ORDER.indexOf(impact ?? "");
+	return index === -1 ? IMPACT_ORDER.length : index;
+}
+function truncate(text, max) {
+	return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+function clean(text) {
+	return text.replaceAll(/\s+/gu, " ").replaceAll(";", ",");
+}
+export { MAX_REPORTED_VIOLATIONS, mapAxeViolations };
+
+//# sourceMappingURL=map.mjs.map

package/dist/capture/a11y/map.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.mjs","names":[],"sources":["../../../src/capture/a11y/map.ts"],"sourcesContent":["/** Map slim in-page axe results to `a11y:` violation strings. */\n\n/** Most violations reported per snapshot; the rest collapse into \"…and N more\". */\nexport const MAX_REPORTED_VIOLATIONS = 10;\nconst MAX_SELECTOR_LENGTH = 60;\nconst MAX_HELP_LENGTH = 90;\nconst IMPACT_ORDER = [\"critical\", \"serious\", \"moderate\", \"minor\"];\n\n/** The only per-violation fields that leave the page (raw axe nodes carry large html payloads). */\nexport interface SlimViolation {\n  id: string;\n  impact: string | null;\n  help: string;\n  /** Selector of the first affected node. */\n  target: string;\n  /** Number of affected nodes. */\n  count: number;\n}\n\n/**\n * One string per violation: rule id, impact, help text, short target and node count, worst impact\n * first. `;` is reserved (the pipeline joins annotations with it), so it never appears in a string.\n */\nexport function mapAxeViolations(violations: readonly SlimViolation[]): string[] {\n  const sorted = violations.toSorted(compareViolations);\n  const lines = sorted\n    .slice(0, MAX_REPORTED_VIOLATIONS)\n    .map((violation) => formatViolation(violation));\n  const more = sorted.length - lines.length;\n  if (more > 0) lines.push(`…and ${more} more`);\n  return lines;\n}\n\nfunction formatViolation(v: SlimViolation): string {\n  const nodes = `${v.count} node${v.count === 1 ? \"\" : \"s\"}`;\n  const target = truncate(v.target, MAX_SELECTOR_LENGTH);\n  return clean(\n    `${v.id} (${v.impact ?? \"unknown\"}): ${truncate(v.help, MAX_HELP_LENGTH)} [${target}] ${nodes}`,\n  );\n}\n\nfunction compareViolations(a: SlimViolation, b: SlimViolation): number {\n  return rank(a.impact) - rank(b.impact) || a.id.localeCompare(b.id);\n}\n\nfunction rank(impact: string | null): number {\n  const index = IMPACT_ORDER.indexOf(impact ?? \"\");\n  return index === -1 ? IMPACT_ORDER.length : index;\n}\n\nfunction truncate(text: string, max: number): string {\n  return text.length > max ? `${text.slice(0, max - 1)}…` : text;\n}\n\nfunction clean(text: string): string {\n  return text.replaceAll(/\\s+/gu, \" \").replaceAll(\";\", \",\");\n}\n"],"mappings":";;;;;;AAGA,MAAa,0BAA0B;AACvC,MAAM,sBAAsB;AAC5B,MAAM,kBAAkB;AACxB,MAAM,eAAe;CAAC;CAAY;CAAW;CAAY;AAAO;;;;;AAiBhE,SAAgB,iBAAiB,YAAgD;CAC/E,MAAM,SAAS,WAAW,SAAS,iBAAiB;CACpD,MAAM,QAAQ,OACX,MAAM,GAAA,EAA0B,CAAC,CACjC,KAAK,cAAc,gBAAgB,SAAS,CAAC;CAChD,MAAM,OAAO,OAAO,SAAS,MAAM;CACnC,IAAI,OAAO,GAAG,MAAM,KAAK,QAAQ,KAAK,MAAM;CAC5C,OAAO;AACT;AAEA,SAAS,gBAAgB,GAA0B;CACjD,MAAM,QAAQ,GAAG,EAAE,MAAM,OAAO,EAAE,UAAU,IAAI,KAAK;CACrD,MAAM,SAAS,SAAS,EAAE,QAAQ,mBAAmB;CACrD,OAAO,MACL,GAAG,EAAE,GAAG,IAAI,EAAE,UAAU,UAAU,KAAK,SAAS,EAAE,MAAM,eAAe,EAAE,IAAI,OAAO,IAAI,OAC1F;AACF;AAEA,SAAS,kBAAkB,GAAkB,GAA0B;CACrE,OAAO,KAAK,EAAE,MAAM,IAAI,KAAK,EAAE,MAAM,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE;AACnE;AAEA,SAAS,KAAK,QAA+B;CAC3C,MAAM,QAAQ,aAAa,QAAQ,UAAU,EAAE;CAC/C,OAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;AAEA,SAAS,SAAS,MAAc,KAAqB;CACnD,OAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK;AAC5D;AAEA,SAAS,MAAM,MAAsB;CACnC,OAAO,KAAK,WAAW,SAAS,GAAG,CAAC,CAAC,WAAW,KAAK,GAAG;AAC1D"}

package/dist/capture/a11y/options.d.mts

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/** Turn Storybook's `parameters.a11y` into an axe run plan. */
+/** The story root axe scans unless `parameters.a11y.element`/`context` says otherwise. */
+declare const A11Y_ROOT_SELECTOR = "#storybook-root";
+/** What to hand to `axe.configure` / `axe.run` in the page (JSON-serialisable). */
+interface A11yRunPlan {
+  /** Why the story is skipped (`disable`, `test: "off"`); undefined when axe should run. */
+  skip?: string;
+  config: Record<string, unknown>;
+  options: Record<string, unknown>;
+  context: unknown;
+}
+/**
+ * Resolve the run plan from the JSON-serialisable subset of `parameters.a11y` (functions cannot be
+ * read from the page). `disable: true` and `test: "off"` skip the story; `test: "todo" | "error"`
+ * still only annotate, results never fail a build.
+ */
+declare function resolveA11yRun(raw: unknown): A11yRunPlan;
+export { A11Y_ROOT_SELECTOR, A11yRunPlan, resolveA11yRun };
+//# sourceMappingURL=options.d.mts.map

package/dist/capture/a11y/options.mjs

@@ -0,0 +1,74 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/capture/a11y/options.ts
+/** Turn Storybook's `parameters.a11y` into an axe run plan. */
+/** The story root axe scans unless `parameters.a11y.element`/`context` says otherwise. */
+const A11Y_ROOT_SELECTOR = "#storybook-root";
+/**
+* Rule tags scanned by default: WCAG A/AA plus axe's `best-practice` rules; `parameters.a11y.options.runOnly`
+* replaces them. The page-level best-practice rules (`region`, `landmark-one-main`,
+* `page-has-heading-one`) need the whole document in scope and so stay silent for the default
+* scan of `#storybook-root`; no rule is switched off by default (checked in a real browser).
+*/
+const DEFAULT_RUN_ONLY = {
+	type: "tag",
+	values: [
+		"wcag2a",
+		"wcag2aa",
+		"wcag21a",
+		"wcag21aa",
+		"wcag22aa",
+		"best-practice"
+	]
+};
+/**
+* Resolve the run plan from the JSON-serialisable subset of `parameters.a11y` (functions cannot be
+* read from the page). `disable: true` and `test: "off"` skip the story; `test: "todo" | "error"`
+* still only annotate, results never fail a build.
+*/
+function resolveA11yRun(raw) {
+	const params = asRecord(raw) ?? {};
+	const skip = skipReason(params);
+	const config = asRecord(params["config"]) ?? {};
+	const userOptions = asRecord(params["options"]);
+	const rules = {
+		...disabledByConfig(config),
+		...asRecord(userOptions?.["rules"])
+	};
+	const options = {
+		runOnly: DEFAULT_RUN_ONLY,
+		...userOptions,
+		rules
+	};
+	const context = params["element"] ?? params["context"] ?? "#storybook-root";
+	return {
+		...skip ? { skip } : {},
+		config,
+		options,
+		context
+	};
+}
+/**
+* `axe.configure({ rules: [{ id, enabled: false }] })` is ignored under a tag-based `runOnly`, so
+* mirror those switches into the run options where they are honoured.
+*/
+function disabledByConfig(config) {
+	const out = {};
+	const rules = Array.isArray(config["rules"]) ? config["rules"] : [];
+	for (const rule of rules) {
+		const entry = asRecord(rule);
+		if (entry?.["enabled"] === false && typeof entry["id"] === "string") out[entry["id"]] = { enabled: false };
+	}
+	return out;
+}
+function skipReason(params) {
+	if (params["disable"] === true) return "parameters.a11y.disable";
+	if (params["test"] === "off") return "parameters.a11y.test is \"off\"";
+}
+function asRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+export { A11Y_ROOT_SELECTOR, resolveA11yRun };
+
+//# sourceMappingURL=options.mjs.map

package/dist/capture/a11y/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","names":[],"sources":["../../../src/capture/a11y/options.ts"],"sourcesContent":["/** Turn Storybook's `parameters.a11y` into an axe run plan. */\n\n/** The story root axe scans unless `parameters.a11y.element`/`context` says otherwise. */\nexport const A11Y_ROOT_SELECTOR = \"#storybook-root\";\n\n/**\n * Rule tags scanned by default: WCAG A/AA plus axe's `best-practice` rules; `parameters.a11y.options.runOnly`\n * replaces them. The page-level best-practice rules (`region`, `landmark-one-main`,\n * `page-has-heading-one`) need the whole document in scope and so stay silent for the default\n * scan of `#storybook-root`; no rule is switched off by default (checked in a real browser).\n */\nconst DEFAULT_RUN_ONLY = {\n  type: \"tag\",\n  values: [\"wcag2a\", \"wcag2aa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\", \"best-practice\"],\n};\n\n/** What to hand to `axe.configure` / `axe.run` in the page (JSON-serialisable). */\nexport interface A11yRunPlan {\n  /** Why the story is skipped (`disable`, `test: \"off\"`); undefined when axe should run. */\n  skip?: string;\n  config: Record<string, unknown>;\n  options: Record<string, unknown>;\n  context: unknown;\n}\n\n/**\n * Resolve the run plan from the JSON-serialisable subset of `parameters.a11y` (functions cannot be\n * read from the page). `disable: true` and `test: \"off\"` skip the story; `test: \"todo\" | \"error\"`\n * still only annotate, results never fail a build.\n */\nexport function resolveA11yRun(raw: unknown): A11yRunPlan {\n  const params = asRecord(raw) ?? {};\n  const skip = skipReason(params);\n  const config = asRecord(params[\"config\"]) ?? {};\n  const userOptions = asRecord(params[\"options\"]);\n  const rules = { ...disabledByConfig(config), ...asRecord(userOptions?.[\"rules\"]) };\n  const options = { runOnly: DEFAULT_RUN_ONLY, ...userOptions, rules };\n  const context = params[\"element\"] ?? params[\"context\"] ?? A11Y_ROOT_SELECTOR;\n  return { ...(skip ? { skip } : {}), config, options, context };\n}\n\n/**\n * `axe.configure({ rules: [{ id, enabled: false }] })` is ignored under a tag-based `runOnly`, so\n * mirror those switches into the run options where they are honoured.\n */\nfunction disabledByConfig(config: Record<string, unknown>): Record<string, { enabled: false }> {\n  const out: Record<string, { enabled: false }> = {};\n  const rules = Array.isArray(config[\"rules\"]) ? (config[\"rules\"] as unknown[]) : [];\n  for (const rule of rules) {\n    const entry = asRecord(rule);\n    if (entry?.[\"enabled\"] === false && typeof entry[\"id\"] === \"string\")\n      out[entry[\"id\"]] = { enabled: false };\n  }\n  return out;\n}\n\nfunction skipReason(params: Record<string, unknown>): string | undefined {\n  if (params[\"disable\"] === true) return \"parameters.a11y.disable\";\n  if (params[\"test\"] === \"off\") return 'parameters.a11y.test is \"off\"';\n  return undefined;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":";;;;;;AAGA,MAAa,qBAAqB;;;;;;;AAQlC,MAAM,mBAAmB;CACvB,MAAM;CACN,QAAQ;EAAC;EAAU;EAAW;EAAW;EAAY;EAAY;CAAe;AAClF;;;;;;AAgBA,SAAgB,eAAe,KAA2B;CACxD,MAAM,SAAS,SAAS,GAAG,KAAK,CAAC;CACjC,MAAM,OAAO,WAAW,MAAM;CAC9B,MAAM,SAAS,SAAS,OAAO,SAAS,KAAK,CAAC;CAC9C,MAAM,cAAc,SAAS,OAAO,UAAU;CAC9C,MAAM,QAAQ;EAAE,GAAG,iBAAiB,MAAM;EAAG,GAAG,SAAS,cAAc,QAAQ;CAAE;CACjF,MAAM,UAAU;EAAE,SAAS;EAAkB,GAAG;EAAa;CAAM;CACnE,MAAM,UAAU,OAAO,cAAc,OAAO,cAAA;CAC5C,OAAO;EAAE,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;EAAI;EAAQ;EAAS;CAAQ;AAC/D;;;;;AAMA,SAAS,iBAAiB,QAAqE;CAC7F,MAAM,MAA0C,CAAC;CACjD,MAAM,QAAQ,MAAM,QAAQ,OAAO,QAAQ,IAAK,OAAO,WAAyB,CAAC;CACjF,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,SAAS,IAAI;EAC3B,IAAI,QAAQ,eAAe,SAAS,OAAO,MAAM,UAAU,UACzD,IAAI,MAAM,SAAS,EAAE,SAAS,MAAM;CACxC;CACA,OAAO;AACT;AAEA,SAAS,WAAW,QAAqD;CACvE,IAAI,OAAO,eAAe,MAAM,OAAO;CACvC,IAAI,OAAO,YAAY,OAAO,OAAO;AAEvC;AAEA,SAAS,SAAS,OAAqD;CACrE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD,KAAA;AACN"}

package/dist/capture/adapter.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { DepGraph } from "@storyshelf/affected";
-//#region src/capture/adapter.d.ts
 /** A custom viewport registered on a story via `parameters.viewport`. */
 interface StoryViewportDefinition {
   name?: string;
@@ -15,6 +14,23 @@ interface StoryViewportConfig {
   defaultViewport?: string;
   viewports?: Record<string, StoryViewportDefinition>;
 }
+/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */
+type ModeViewportValue = number | string | {
+  width: number;
+  height: number;
+};
+/**
+ * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the
+ * page, `disable` removes an inherited mode, every other key is a Storybook
+ * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.
+ */
+interface ModeDefinition {
+  viewport?: ModeViewportValue;
+  disable?: boolean;
+  [global: string]: unknown;
+}
+/** Named modes keyed by display name (the slug of the name is the baseline identity). */
+type ModeMap = Record<string, ModeDefinition>;
 /** Per-story capture parameters from the Storybook index. */
 interface StoryParameters {
   disableSnapshot?: boolean;
@@ -39,6 +55,13 @@ interface StoryParameters {
   waitForFonts?: boolean;
   /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */
   viewport?: StoryViewportConfig;
+  /**
+   * CSS selectors hidden (`visibility: hidden`) before the screenshot. `storyshelf` replaces
+   * `chromatic`; `[data-storyshelf-ignore]` and the Chromatic markers always apply.
+   */
+  ignoreSelectors?: string[];
+  /** Named modes: extra captures of this story under different globals/viewports. */
+  modes?: ModeMap;
 }
 /** Return whether a story is marked flaky (failures stay non-blocking). */
 declare function isFlakyStory(entry: Pick<StoryEntry, "tags" | "parameters">): boolean;
@@ -52,18 +75,35 @@ interface StoryEntry {
   importPath?: string;
   tags?: string[];
   type: "story" | "docs";
+  /**
+   * Set on a Storybook 10 `.test()` entry (index `subtype: "test"`): the id of the story it is
+   * written under. Test entries are never captured; a project that runs tests runs them in the
+   * iframe (ADR 0004, decision 10).
+   */
+  parentId?: string;
   parameters?: StoryParameters;
+  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */
+  designUrl?: string;
+  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */
+  designInvalid?: string;
 }
 /** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */
 interface CapturePage {
   evaluate(pageFunction: string | ((...args: unknown[]) => unknown), arg?: unknown): Promise<unknown>;
   waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;
 }
+/** Optional discovery inputs. */
+interface DiscoverOptions {
+  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */
+  parseDesignUrl?: (raw: string) => {
+    url: string;
+  } | null;
+}
 /** Adapter that discovers and renders stories from a Storybook build. */
 interface StorySourceAdapter {
   name: string;
-  discover(source: string): Promise<StoryEntry[]>;
-  buildUrl(baseUrl: string, storyId: string): string;
+  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;
+  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;
   screenshotSelector?: string;
   /**
    * Optional hook loading the module dependency graph of an extracted build,
@@ -85,9 +125,10 @@ interface Viewport {
   name: string;
   width: number;
   height: number;
+  /** Storybook globals applied for this capture (set for modes only). */
+  globals?: Record<string, unknown>;
 }
 /** Default viewport used when none is configured. */
 declare const DEFAULT_VIEWPORTS: Viewport[];
-//#endregion
-export { CapturePage, DEFAULT_VIEWPORTS, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory };
+export { CapturePage, DEFAULT_VIEWPORTS, DiscoverOptions, ModeDefinition, ModeMap, ModeViewportValue, StoryEntry, StoryParameters, StorySourceAdapter, StoryViewportConfig, StoryViewportDefinition, Viewport, isDisabledStory, isFlakyStory };
 //# sourceMappingURL=adapter.d.mts.map

package/dist/capture/adapter.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/adapter.ts
+// src/capture/adapter.ts
 /** Return whether a story is marked flaky (failures stay non-blocking). */
 function isFlakyStory(entry) {
 	if (entry.parameters?.flakyTest) return true;
@@ -25,7 +25,6 @@ const DEFAULT_VIEWPORTS = [{
 	width: 1280,
 	height: 720
 }];
-//#endregion
 export { DEFAULT_VIEWPORTS, isDisabledStory, isFlakyStory };
 
 //# sourceMappingURL=adapter.mjs.map

package/dist/capture/adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  parameters?: StoryParameters;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AA4CA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAoDA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}
+{"version":3,"file":"adapter.mjs","names":[],"sources":["../../src/capture/adapter.ts"],"sourcesContent":["import type { DepGraph } from \"@storyshelf/affected\";\n\n/** A custom viewport registered on a story via `parameters.viewport`. */\nexport interface StoryViewportDefinition {\n  name?: string;\n  styles?: {\n    width?: string | number;\n    height?: string | number;\n  };\n}\n\n/** Storybook `parameters.viewport` config; carried through discovery for per-story viewport capture. */\nexport interface StoryViewportConfig {\n  defaultViewport?: string;\n  viewports?: Record<string, StoryViewportDefinition>;\n}\n\n/** Viewport a mode captures at: a width, a Storybook viewport name, or explicit dimensions. */\nexport type ModeViewportValue = number | string | { width: number; height: number };\n\n/**\n * One entry of `parameters.{chromatic,storyshelf}.modes`. `viewport` sizes the\n * page, `disable` removes an inherited mode, every other key is a Storybook\n * global (theme, locale, backgrounds, …) applied through the `globals` URL arg.\n */\nexport interface ModeDefinition {\n  viewport?: ModeViewportValue;\n  disable?: boolean;\n  [global: string]: unknown;\n}\n\n/** Named modes keyed by display name (the slug of the name is the baseline identity). */\nexport type ModeMap = Record<string, ModeDefinition>;\n\n/** Per-story capture parameters from the Storybook index. */\nexport interface StoryParameters {\n  disableSnapshot?: boolean;\n  delay?: number;\n  diffThreshold?: number;\n  pauseAnimationAtEnd?: boolean;\n  flakyTest?: boolean;\n  /** Force auto-crop (true) or full viewport (false) for this story; undefined uses 60% whitespace rule. */\n  autoCrop?: boolean;\n  /** Whitespace fraction (0..1) above which we crop; default 0.6. */\n  autoCropThreshold?: number;\n  /** Whether overflow should trigger fullPage; default true. */\n  fullPageOnOverflow?: boolean;\n  /** Min dimensions for the final PNG (clamp after padding). */\n  minWidth?: number;\n  minHeight?: number;\n  maxWidth?: number;\n  maxHeight?: number;\n  /** Burst count for steady capture (1 = single shot, 3 = burst 100ms); default 1. */\n  burst?: number;\n  /** Whether to wait for fonts.ready before screenshot; default true when burst >1. */\n  waitForFonts?: boolean;\n  /** Storybook viewport config; adds the story's default viewport to the project list at capture time. */\n  viewport?: StoryViewportConfig;\n  /**\n   * CSS selectors hidden (`visibility: hidden`) before the screenshot. `storyshelf` replaces\n   * `chromatic`; `[data-storyshelf-ignore]` and the Chromatic markers always apply.\n   */\n  ignoreSelectors?: string[];\n  /** Named modes: extra captures of this story under different globals/viewports. */\n  modes?: ModeMap;\n}\n\n/** Return whether a story is marked flaky (failures stay non-blocking). */\nexport function isFlakyStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.flakyTest) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    if (t.toLowerCase() === \"flaky-test\") return true;\n  }\n  return false;\n}\n\n/** Return whether a story is excluded from snapshot capture. */\nexport function isDisabledStory(entry: Pick<StoryEntry, \"tags\" | \"parameters\">): boolean {\n  if (entry.parameters?.disableSnapshot) return true;\n  const tags = entry.tags ?? [];\n  for (const t of tags) {\n    const lower = t.toLowerCase();\n    if (lower === \"skip\" || lower === \"disable\" || lower === \"disable-snapshot\") return true;\n  }\n  return false;\n}\n\n/** A single discoverable story or docs entry within a Storybook. */\nexport interface StoryEntry {\n  id: string;\n  title: string;\n  name: string;\n  importPath?: string;\n  tags?: string[];\n  type: \"story\" | \"docs\";\n  /**\n   * Set on a Storybook 10 `.test()` entry (index `subtype: \"test\"`): the id of the story it is\n   * written under. Test entries are never captured; a project that runs tests runs them in the\n   * iframe (ADR 0004, decision 10).\n   */\n  parentId?: string;\n  parameters?: StoryParameters;\n  /** Figma URL declared via `parameters.design` / `parameters.storyshelf.figma`. */\n  designUrl?: string;\n  /** Declared design value that is not a usable Figma URL (ignored; logged at capture). */\n  designInvalid?: string;\n}\n\n/** Minimal structural page handle handed to `StorySourceAdapter.waitForReady`. */\nexport interface CapturePage {\n  evaluate(\n    pageFunction: string | ((...args: unknown[]) => unknown),\n    arg?: unknown,\n  ): Promise<unknown>;\n  waitForSelector(selector: string, options?: Record<string, unknown>): Promise<unknown>;\n}\n\n/** Optional discovery inputs. */\nexport interface DiscoverOptions {\n  /** Validates declared design links (`design` / `storyshelf.figma`); without it none are extracted. */\n  parseDesignUrl?: (raw: string) => { url: string } | null;\n}\n\n/** Adapter that discovers and renders stories from a Storybook build. */\nexport interface StorySourceAdapter {\n  name: string;\n  discover(source: string, options?: DiscoverOptions): Promise<StoryEntry[]>;\n  buildUrl(baseUrl: string, storyId: string, globals?: Record<string, unknown>): string;\n  screenshotSelector?: string;\n  /**\n   * Optional hook loading the module dependency graph of an extracted build,\n   * enabling affected capture (render only stories downstream of a change).\n   * Absent (or resolving `null`) means the source cannot be traced, so the\n   * orchestrator renders every story.\n   */\n  loadDependencyGraph?(sourceDir: string): Promise<DepGraph | null>;\n  /**\n   * Optional hook invoked after navigation and before the screenshot sequence,\n   * letting a custom source wait until it is ready to capture. The built-in\n   * Storybook adapter leaves this undefined (rendered via iframe). See\n   * ADR 0005.\n   */\n  waitForReady?(page: CapturePage): Promise<void>;\n}\n\n/** A viewport size at which stories are captured. */\nexport interface Viewport {\n  name: string;\n  width: number;\n  height: number;\n  /** Storybook globals applied for this capture (set for modes only). */\n  globals?: Record<string, unknown>;\n}\n\n/** Default viewport used when none is configured. */\nexport const DEFAULT_VIEWPORTS: Viewport[] = [{ name: \"desktop\", width: 1280, height: 720 }];\n"],"mappings":";;;;;AAoEA,SAAgB,aAAa,OAAyD;CACpF,IAAI,MAAM,YAAY,WAAW,OAAO;CACxC,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MACd,IAAI,EAAE,YAAY,MAAM,cAAc,OAAO;CAE/C,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAAyD;CACvF,IAAI,MAAM,YAAY,iBAAiB,OAAO;CAC9C,MAAM,OAAO,MAAM,QAAQ,CAAC;CAC5B,KAAK,MAAM,KAAK,MAAM;EACpB,MAAM,QAAQ,EAAE,YAAY;EAC5B,IAAI,UAAU,UAAU,UAAU,aAAa,UAAU,oBAAoB,OAAO;CACtF;CACA,OAAO;AACT;;AAsEA,MAAa,oBAAgC,CAAC;CAAE,MAAM;CAAW,OAAO;CAAM,QAAQ;AAAI,CAAC"}

package/dist/capture/affected.d.mts

@@ -4,13 +4,13 @@ import { StoryEntry, Viewport } from "./adapter.mjs";
 import "../adapter/database.mjs";
 import { Baseline } from "../schema/baseline.mjs";
 import "../models/baseline.mjs";
-//#region src/capture/affected.d.ts
 /** An inherit candidate paired with the baseline it reuses. */
 interface InheritedStory {
   story: StoryEntry;
   viewport: Viewport;
   baseline: Baseline;
+  /** Engine whose baseline is reused (chromium when absent). */
+  browser?: string;
 }
-//#endregion
 export { InheritedStory };
 //# sourceMappingURL=affected.d.mts.map

package/dist/capture/affected.mjs

@@ -1,10 +1,18 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-import { BaselineModel } from "../models/baseline.mjs";
 import { resolveStoryViewports } from "./storybook.mjs";
+import { BuildModel } from "../models/build.mjs";
+import { BaselineModel } from "../models/baseline.mjs";
 import { selectAffectedStories } from "@storyshelf/affected";
-//#region src/capture/affected.ts
+// src/capture/affected.ts
+/**
+* Resolve the affected import paths for a build, or `null` for full capture (affected capture
+* disabled, or no computation was posted). The one rule for the whole and the sharded path alike.
+*/
+function affectedPathsFor(build) {
+	return build.affectedOnly ? BuildModel.affectedPaths(build) : null;
+}
 /** Split one inherit candidate by per-viewport baseline availability. */
 async function splitStory(baselines, input, story) {
 	const render = [];
@@ -12,12 +20,13 @@ async function splitStory(baselines, input, story) {
 	const viewports = resolveStoryViewports(story, input.viewports);
 	const settled = await Promise.all(viewports.map(async (viewport) => ({
 		viewport,
-		baseline: await baselines.resolve(input.projectId, story.id, viewport.name, input.branch, input.defaultBranch)
+		baseline: await baselines.resolve(input.projectId, story.id, viewport.name, input.branch, input.defaultBranch, input.browser)
 	})));
 	for (const { viewport, baseline } of settled) if (baseline) inherited.push({
 		story,
 		viewport,
-		baseline
+		baseline,
+		...input.browser ? { browser: input.browser } : {}
 	});
 	else if (!render.includes(story)) render.push(story);
 	return {
@@ -58,7 +67,6 @@ async function partitionAffectedStories(input) {
 		inherited: merged.inherited
 	};
 }
-//#endregion
-export { partitionAffectedStories };
+export { affectedPathsFor, partitionAffectedStories };
 
 //# sourceMappingURL=affected.mjs.map

package/dist/capture/affected.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"affected.mjs","names":[],"sources":["../../src/capture/affected.ts"],"sourcesContent":["import { selectAffectedStories } from \"@storyshelf/affected\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { StoryEntry, Viewport } from \"./adapter.ts\";\nimport { resolveStoryViewports } from \"./storybook.ts\";\n\n/** An inherit candidate paired with the baseline it reuses. */\nexport interface InheritedStory {\n  story: StoryEntry;\n  viewport: Viewport;\n  baseline: Baseline;\n}\n\n/** Stories split into capture-now versus inherit-from-baseline sets. */\nexport interface AffectedPartition {\n  render: StoryEntry[];\n  inherited: InheritedStory[];\n}\n\n/** Inputs for partitioning a build's stories by affected status. */\nexport interface PartitionInput {\n  db: DatabaseAdapter;\n  tables: BaselineTables;\n  projectId: string;\n  branch: string;\n  defaultBranch: string;\n  stories: StoryEntry[];\n  viewports: Viewport[];\n  /** Affected import paths, or `null` to render everything. */\n  affectedPaths: string[] | null;\n}\n\n/** Split one inherit candidate by per-viewport baseline availability. */\nasync function splitStory(\n  baselines: BaselineModel,\n  input: PartitionInput,\n  story: StoryEntry,\n): Promise<AffectedPartition> {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  const viewports = resolveStoryViewports(story, input.viewports);\n  const settled = await Promise.all(\n    viewports.map(async (viewport) => ({\n      viewport,\n      baseline: await baselines.resolve(\n        input.projectId,\n        story.id,\n        viewport.name,\n        input.branch,\n        input.defaultBranch,\n      ),\n    })),\n  );\n  for (const { viewport, baseline } of settled) {\n    if (baseline) {\n      inherited.push({ story, viewport, baseline });\n    } else if (!render.includes(story)) {\n      render.push(story);\n    }\n  }\n  return { render, inherited };\n}\n\n/** Merge per-story partitions into a single render/inherit split. */\nfunction mergePartitions(partitions: AffectedPartition[]): AffectedPartition {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  for (const partition of partitions) {\n    render.push(...partition.render);\n    inherited.push(...partition.inherited);\n  }\n  return { render, inherited };\n}\n\n/**\n * Partition discovered stories into render versus inherit sets.\n *\n * Stories outside the affected set inherit their baseline without rendering,\n * except when no baseline exists (new stories always render). A `null`\n * affected set renders everything.\n */\nexport async function partitionAffectedStories(input: PartitionInput): Promise<AffectedPartition> {\n  const selected = selectAffectedStories(input.stories, input.affectedPaths);\n  if (selected.inherit.length === 0) {\n    return { render: selected.render, inherited: [] };\n  }\n  const baselines = new BaselineModel(input.db, input.tables);\n  const partitions = await Promise.all(\n    selected.inherit.map(async (story) => await splitStory(baselines, input, story)),\n  );\n  const merged = mergePartitions(partitions);\n  return { render: [...selected.render, ...merged.render], inherited: merged.inherited };\n}\n"],"mappings":";;;;;;;;AAkCA,eAAe,WACb,WACA,OACA,OAC4B;CAC5B,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,MAAM,YAAY,sBAAsB,OAAO,MAAM,SAAS;CAC9D,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,IAAI,OAAO,cAAc;EACjC;EACA,UAAU,MAAM,UAAU,QACxB,MAAM,WACN,MAAM,IACN,SAAS,MACT,MAAM,QACN,MAAM,aACR;CACF,EAAE,CACJ;CACA,KAAK,MAAM,EAAE,UAAU,cAAc,SACnC,IAAI,UACF,UAAU,KAAK;EAAE;EAAO;EAAU;CAAS,CAAC;MACvC,IAAI,CAAC,OAAO,SAAS,KAAK,GAC/B,OAAO,KAAK,KAAK;CAGrB,OAAO;EAAE;EAAQ;CAAU;AAC7B;;AAGA,SAAS,gBAAgB,YAAoD;CAC3E,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,KAAK,MAAM,aAAa,YAAY;EAClC,OAAO,KAAK,GAAG,UAAU,MAAM;EAC/B,UAAU,KAAK,GAAG,UAAU,SAAS;CACvC;CACA,OAAO;EAAE;EAAQ;CAAU;AAC7B;;;;;;;;AASA,eAAsB,yBAAyB,OAAmD;CAChG,MAAM,WAAW,sBAAsB,MAAM,SAAS,MAAM,aAAa;CACzE,IAAI,SAAS,QAAQ,WAAW,GAC9B,OAAO;EAAE,QAAQ,SAAS;EAAQ,WAAW,CAAC;CAAE;CAElD,MAAM,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MAAM;CAI1D,MAAM,SAAS,gBAAgB,MAHN,QAAQ,IAC/B,SAAS,QAAQ,IAAI,OAAO,UAAU,MAAM,WAAW,WAAW,OAAO,KAAK,CAAC,CACjF,CACyC;CACzC,OAAO;EAAE,QAAQ,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM;EAAG,WAAW,OAAO;CAAU;AACvF"}
+{"version":3,"file":"affected.mjs","names":[],"sources":["../../src/capture/affected.ts"],"sourcesContent":["import { selectAffectedStories } from \"@storyshelf/affected\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport { BaselineModel, type BaselineTables } from \"../models/baseline.ts\";\nimport { BuildModel } from \"../models/build.ts\";\nimport type { Baseline } from \"../schema/baseline.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { StoryEntry, Viewport } from \"./adapter.ts\";\nimport { resolveStoryViewports } from \"./storybook.ts\";\n\n/**\n * Resolve the affected import paths for a build, or `null` for full capture (affected capture\n * disabled, or no computation was posted). The one rule for the whole and the sharded path alike.\n */\nexport function affectedPathsFor(\n  build: Pick<Build, \"affectedOnly\" | \"affectedImportPaths\">,\n): string[] | null {\n  return build.affectedOnly ? BuildModel.affectedPaths(build) : null;\n}\n\n/** An inherit candidate paired with the baseline it reuses. */\nexport interface InheritedStory {\n  story: StoryEntry;\n  viewport: Viewport;\n  baseline: Baseline;\n  /** Engine whose baseline is reused (chromium when absent). */\n  browser?: string;\n}\n\n/** Stories split into capture-now versus inherit-from-baseline sets. */\nexport interface AffectedPartition {\n  render: StoryEntry[];\n  inherited: InheritedStory[];\n}\n\n/** Inputs for partitioning a build's stories by affected status. */\nexport interface PartitionInput {\n  db: DatabaseAdapter;\n  tables: BaselineTables;\n  projectId: string;\n  branch: string;\n  defaultBranch: string;\n  stories: StoryEntry[];\n  viewports: Viewport[];\n  /** Engine to resolve baselines for (default chromium). */\n  browser?: string;\n  /** Affected import paths, or `null` to render everything. */\n  affectedPaths: string[] | null;\n}\n\n/** Split one inherit candidate by per-viewport baseline availability. */\nasync function splitStory(\n  baselines: BaselineModel,\n  input: PartitionInput,\n  story: StoryEntry,\n): Promise<AffectedPartition> {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  const viewports = resolveStoryViewports(story, input.viewports);\n  const settled = await Promise.all(\n    viewports.map(async (viewport) => ({\n      viewport,\n      baseline: await baselines.resolve(\n        input.projectId,\n        story.id,\n        viewport.name,\n        input.branch,\n        input.defaultBranch,\n        input.browser,\n      ),\n    })),\n  );\n  for (const { viewport, baseline } of settled) {\n    if (baseline) {\n      inherited.push({\n        story,\n        viewport,\n        baseline,\n        ...(input.browser ? { browser: input.browser } : {}),\n      });\n    } else if (!render.includes(story)) {\n      render.push(story);\n    }\n  }\n  return { render, inherited };\n}\n\n/** Merge per-story partitions into a single render/inherit split. */\nfunction mergePartitions(partitions: AffectedPartition[]): AffectedPartition {\n  const render: StoryEntry[] = [];\n  const inherited: InheritedStory[] = [];\n  for (const partition of partitions) {\n    render.push(...partition.render);\n    inherited.push(...partition.inherited);\n  }\n  return { render, inherited };\n}\n\n/**\n * Partition discovered stories into render versus inherit sets.\n *\n * Stories outside the affected set inherit their baseline without rendering,\n * except when no baseline exists (new stories always render). A `null`\n * affected set renders everything.\n */\nexport async function partitionAffectedStories(input: PartitionInput): Promise<AffectedPartition> {\n  const selected = selectAffectedStories(input.stories, input.affectedPaths);\n  if (selected.inherit.length === 0) {\n    return { render: selected.render, inherited: [] };\n  }\n  const baselines = new BaselineModel(input.db, input.tables);\n  const partitions = await Promise.all(\n    selected.inherit.map(async (story) => await splitStory(baselines, input, story)),\n  );\n  const merged = mergePartitions(partitions);\n  return { render: [...selected.render, ...merged.render], inherited: merged.inherited };\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,iBACd,OACiB;CACjB,OAAO,MAAM,eAAe,WAAW,cAAc,KAAK,IAAI;AAChE;;AAiCA,eAAe,WACb,WACA,OACA,OAC4B;CAC5B,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,MAAM,YAAY,sBAAsB,OAAO,MAAM,SAAS;CAC9D,MAAM,UAAU,MAAM,QAAQ,IAC5B,UAAU,IAAI,OAAO,cAAc;EACjC;EACA,UAAU,MAAM,UAAU,QACxB,MAAM,WACN,MAAM,IACN,SAAS,MACT,MAAM,QACN,MAAM,eACN,MAAM,OACR;CACF,EAAE,CACJ;CACA,KAAK,MAAM,EAAE,UAAU,cAAc,SACnC,IAAI,UACF,UAAU,KAAK;EACb;EACA;EACA;EACA,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;CACpD,CAAC;MACI,IAAI,CAAC,OAAO,SAAS,KAAK,GAC/B,OAAO,KAAK,KAAK;CAGrB,OAAO;EAAE;EAAQ;CAAU;AAC7B;;AAGA,SAAS,gBAAgB,YAAoD;CAC3E,MAAM,SAAuB,CAAC;CAC9B,MAAM,YAA8B,CAAC;CACrC,KAAK,MAAM,aAAa,YAAY;EAClC,OAAO,KAAK,GAAG,UAAU,MAAM;EAC/B,UAAU,KAAK,GAAG,UAAU,SAAS;CACvC;CACA,OAAO;EAAE;EAAQ;CAAU;AAC7B;;;;;;;;AASA,eAAsB,yBAAyB,OAAmD;CAChG,MAAM,WAAW,sBAAsB,MAAM,SAAS,MAAM,aAAa;CACzE,IAAI,SAAS,QAAQ,WAAW,GAC9B,OAAO;EAAE,QAAQ,SAAS;EAAQ,WAAW,CAAC;CAAE;CAElD,MAAM,YAAY,IAAI,cAAc,MAAM,IAAI,MAAM,MAAM;CAI1D,MAAM,SAAS,gBAAgB,MAHN,QAAQ,IAC/B,SAAS,QAAQ,IAAI,OAAO,UAAU,MAAM,WAAW,WAAW,OAAO,KAAK,CAAC,CACjF,CACyC;CACzC,OAAO;EAAE,QAAQ,CAAC,GAAG,SAAS,QAAQ,GAAG,OAAO,MAAM;EAAG,WAAW,OAAO;CAAU;AACvF"}