@storyshelf/core 0.7.0 → 0.8.0

package/dist/capture/db-queue/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/capture/db-queue/types.ts"],"sourcesContent":["/** Option, job and runtime types of the database capture queue. */\nimport type {\n  CaptureJob,\n  LeaseRenewal,\n  PollableCaptureQueue,\n  PollableJob,\n} from \"../../adapters/capture-queue.ts\";\nimport type { AdapterLifecycle } from \"../../adapters/metadata.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport type { CaptureJobModel } from \"../../models/capture-job.ts\";\nimport type { CaptureJobKind } from \"../../schema/capture-job.ts\";\nimport type { QueueTimers } from \"./timers.ts\";\nimport type { WakeSignal } from \"./wake.ts\";\n\n/** Options of {@link createDatabaseCaptureQueue}. */\nexport interface DatabaseCaptureQueueOptions {\n  /** Job kinds this instance polls (default `[\"capture\"]`); enqueue accepts every kind. */\n  kinds?: readonly CaptureJobKind[];\n  /** Lease granted per attempt, renewed by a heartbeat and by progress (default {@link DEFAULT_LEASE_MS}, 5 min; `testing.leaseSeconds`). */\n  leaseMs?: number;\n  /** Retries after the first attempt (`testing.retries`, default 2: three attempts in total). */\n  retries?: number;\n  /** Identity written on the attempt rows this instance holds (default host, pid and a random tag). */\n  owner?: string;\n  /** Clock in epoch ms (default `Date.now`); tests inject one to drive leases and visibility. */\n  now?: () => number;\n  /** Timers of the local wake wait (default the global timers); tests inject a manual clock. */\n  timers?: QueueTimers;\n  /** Explicit logger override; the host normally binds one through `setLogger`. */\n  logger?: Logger;\n  /**\n   * Called after a job failed because its last attempt lost its lease: nothing was running to\n   * record the failure, so the host writes it (a build left `capturing`). May run on every\n   * instance that finds the job, so it must be idempotent; a throw is logged and ignored.\n   */\n  onExhausted?: (job: DatabaseJob, error: string) => Promise<void>;\n}\n\n/** Default lease per attempt: long enough for a slow stage, short enough to recover a crash. */\nexport const DEFAULT_LEASE_MS = 5 * 60_000;\n\n/** Default `testing.retries` (ADR 0006, decision 11). */\nexport const DEFAULT_RETRIES = 2;\n\n/** A job of any kind, as `enqueueJob` takes it. */\nexport interface QueueJobInput {\n  kind: CaptureJobKind;\n  /** Build the job works on; notify jobs may have none. */\n  buildId?: string | null;\n  /** `capture_shards` row, for a shard capture job. */\n  shard?: string;\n  reqId?: string;\n  traceparent?: string;\n  /** Kind-specific fields (channel id, zip key, …), stored as JSON. */\n  data?: Record<string, unknown>;\n  /** Attempts allowed in total for this job; defaults to the queue's (`retries` + 1). */\n  maxAttempts?: number;\n}\n\n/** A job claimed from the database queue. */\nexport interface DatabaseJob extends PollableJob {\n  /** Id of the job row (`receipt` is the attempt row, `<jobId>:<attempt>`). */\n  jobId: string;\n  kind: CaptureJobKind;\n  /** Attempt number, from 1 (`attempts` is the number made before this one). */\n  attempt: number;\n  maxAttempts: number;\n  /** Kind-specific fields given at enqueue. */\n  data: Record<string, unknown>;\n}\n\n/** The database queue: a {@link PollableCaptureQueue} plus multi-kind enqueue and a local wake. */\nexport interface DatabaseCaptureQueue extends PollableCaptureQueue {\n  readonly lifecycle: AdapterLifecycle;\n  poll(options?: { waitMs?: number }): Promise<DatabaseJob | null>;\n  extend(job: PollableJob): Promise<LeaseRenewal>;\n  /** Put a job of any kind on the queue; resolves to its job id. */\n  enqueueJob(job: QueueJobInput): Promise<string>;\n  /** Cancel a job by job id, or every unfinished job of a build (every kind) by build id. */\n  cancel(id: string): Promise<boolean>;\n  /** Read the job's state without renewing its lease (the 5 s cancel check). */\n  inspect(job: PollableJob): Promise<LeaseRenewal>;\n  /**\n   * Resolve true when this instance enqueues a job (including one enqueued since the last `poll`\n   * began, so no wake-up is lost), false after `ms`.\n   */\n  waitForWork(ms: number): Promise<boolean>;\n}\n\n/** State shared by the queue's modules. */\nexport interface QueueRuntime {\n  model: CaptureJobModel;\n  kinds: readonly CaptureJobKind[];\n  leaseMs: number;\n  maxAttempts: number;\n  owner: string;\n  now: () => number;\n  wake: WakeSignal;\n  /** Wake version read when the latest poll began. */\n  pollVersion: number;\n  logger?: Logger;\n  onExhausted?: DatabaseCaptureQueueOptions[\"onExhausted\"];\n}\n\n/** The capture-shaped job `enqueue` takes, re-exported for the modules. */\nexport type { CaptureJob };\n"],"mappings":";;;;;AAuCA,MAAa,mBAAmB;;AAGhC,MAAa,kBAAkB"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/capture/db-queue/types.ts"],"sourcesContent":["/** Option, job and runtime types of the database capture queue. */\nimport type {\n  CaptureJob,\n  LeaseRenewal,\n  PollableCaptureQueue,\n  PollableJob,\n} from \"../../adapters/capture-queue.ts\";\nimport type { AdapterLifecycle } from \"../../adapters/metadata.ts\";\nimport type { Logger } from \"../../logger.ts\";\nimport type { CaptureJobModel } from \"../../models/capture-job.ts\";\nimport type { CaptureJobKind } from \"../../schema/capture-job.ts\";\nimport type { QueueTimers } from \"./timers.ts\";\nimport type { WakeSignal } from \"./wake.ts\";\n\n/** Options of {@link createDatabaseCaptureQueue}. */\nexport interface DatabaseCaptureQueueOptions {\n  /** Job kinds this instance polls (default `[\"capture\"]`); enqueue accepts every kind. */\n  kinds?: readonly CaptureJobKind[];\n  /** Lease granted per attempt, renewed by a heartbeat and by progress (default {@link DEFAULT_LEASE_MS}, 5 min; `testing.leaseSeconds`). */\n  leaseMs?: number;\n  /** Retries after the first attempt (`testing.retries`, default 2: three attempts in total). */\n  retries?: number;\n  /** Identity written on the attempt rows this instance holds (default host, pid and a random tag). */\n  owner?: string;\n  /** Clock in epoch ms (default `Date.now`); tests inject one to drive leases and visibility. */\n  now?: () => number;\n  /** Timers of the local wake wait (default the global timers); tests inject a manual clock. */\n  timers?: QueueTimers;\n  /** Explicit logger override; the host normally binds one through `setLogger`. */\n  logger?: Logger;\n  /**\n   * Called after a job failed because its last attempt lost its lease: nothing was running to\n   * record the failure, so the host writes it (a build left `capturing`). May run on every\n   * instance that finds the job, so it must be idempotent; a throw is logged and ignored.\n   */\n  onExhausted?: (job: DatabaseJob, error: string) => Promise<void>;\n}\n\n/** Default lease per attempt: long enough for a slow stage, short enough to recover a crash. */\nexport const DEFAULT_LEASE_MS = 5 * 60_000;\n\n/** Default `testing.retries` (ADR 0006, decision 11). */\nexport const DEFAULT_RETRIES = 2;\n\n/** A job of any kind, as `enqueueJob` takes it. */\nexport interface QueueJobInput {\n  kind: CaptureJobKind;\n  /** Build the job works on; notify jobs may have none. */\n  buildId?: string | null;\n  /** `capture_shards` row, for a shard capture job. */\n  shard?: string;\n  reqId?: string;\n  traceparent?: string;\n  /** Kind-specific fields (channel id, zip key, …), stored as JSON. */\n  data?: Record<string, unknown>;\n  /** Attempts allowed in total for this job; defaults to the queue's (`retries` + 1). */\n  maxAttempts?: number;\n}\n\n/** A job claimed from the database queue. */\nexport interface DatabaseJob extends PollableJob {\n  /** Id of the job row (`receipt` is the attempt row, `<jobId>:<attempt>`). */\n  jobId: string;\n  kind: CaptureJobKind;\n  /** Attempt number, from 1 (`attempts` is the number made before this one). */\n  attempt: number;\n  maxAttempts: number;\n  /** Kind-specific fields given at enqueue. */\n  data: Record<string, unknown>;\n}\n\n/** The database queue: a {@link PollableCaptureQueue} plus multi-kind enqueue and a local wake. */\nexport interface DatabaseCaptureQueue extends PollableCaptureQueue {\n  readonly lifecycle: AdapterLifecycle;\n  poll(options?: { waitMs?: number }): Promise<DatabaseJob | null>;\n  extend(job: PollableJob): Promise<LeaseRenewal>;\n  /** Put a job of any kind on the queue; resolves to its job id. */\n  enqueueJob(job: QueueJobInput): Promise<string>;\n  /** Cancel a job by job id, or every unfinished job of a build (every kind) by build id. */\n  cancel(id: string): Promise<boolean>;\n  /** Read the job's state without renewing its lease (the 5 s cancel check). */\n  inspect(job: PollableJob): Promise<LeaseRenewal>;\n  /**\n   * Resolve true when this instance enqueues a job (including one enqueued since the last `poll`\n   * began, so no wake-up is lost), false after `ms`.\n   */\n  waitForWork(ms: number): Promise<boolean>;\n}\n\n/** State shared by the queue's modules. */\nexport interface QueueRuntime {\n  model: CaptureJobModel;\n  kinds: readonly CaptureJobKind[];\n  leaseMs: number;\n  maxAttempts: number;\n  owner: string;\n  now: () => number;\n  timers?: QueueTimers;\n  wake: WakeSignal;\n  /** Wake version read when the latest poll began. */\n  pollVersion: number;\n  logger?: Logger;\n  onExhausted?: DatabaseCaptureQueueOptions[\"onExhausted\"];\n}\n\n/** The capture-shaped job `enqueue` takes, re-exported for the modules. */\nexport type { CaptureJob };\n"],"mappings":";;;;;AAuCA,MAAa,mBAAmB;;AAGhC,MAAa,kBAAkB"}

package/dist/capture/db-queue/wake.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { REAL_TIMERS } from "./timers.mjs";
-//#region src/capture/db-queue/wake.ts
+// src/capture/db-queue/wake.ts
 /** In-process wake signal: an enqueue on this instance wakes its waiting poller at once. */
 /** Create a wake signal over `timers` (unref'd globals by default). */
 function createWakeSignal(timers = REAL_TIMERS) {
@@ -42,7 +42,6 @@ async function waitFor(timers, waiters, ms) {
 	waiters.add(settle);
 	return await promise;
 }
-//#endregion
 export { createWakeSignal };
 
 //# sourceMappingURL=wake.mjs.map

package/dist/capture/design.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/design.ts
+// src/capture/design.ts
 /**
 * Resolve a story's design URL. `storyshelf.figma` (plain string) wins over the
 * `design` addon shape (`string | {url} | {type,url} | {type,url}[]`, first URL wins).
@@ -33,7 +33,6 @@ function logInvalidDesigns(logger, stories) {
 		design: story.designInvalid
 	}, "ignored invalid design url");
 }
-//#endregion
 export { extractDesignUrl, logInvalidDesigns };
 
 //# sourceMappingURL=design.mjs.map

package/dist/capture/diff-record.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { DEFAULT_DIFF_OPTIONS, diffImagesAsync } from "@storyshelf/image";
-//#region src/capture/diff-record.ts
+// src/capture/diff-record.ts
 /** Diff a stored screenshot against a baseline and persist the overlay; shared by capture and re-diff. */
 /** Per-story `diffThreshold` when it is a finite number in 0..1; otherwise the project threshold. */
 function resolvePixelThreshold(projectThreshold, override) {
@@ -44,7 +44,6 @@ async function writeDiffOverlay(storage, path, result, passed) {
 	await storage.write(path, result.diffImage);
 	return path;
 }
-//#endregion
 export { diffStoredScreenshots, resolvePixelThreshold, writeDiffOverlay };
 
 //# sourceMappingURL=diff-record.mjs.map

package/dist/capture/dispatch.d.mts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { DatabaseAdapter } from "../adapter/database.mjs";
 import { Logger } from "../logger.mjs";
+import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildTables } from "../models/build.mjs";
 import { CaptureAttemptTables } from "../models/capture-attempt.mjs";
 import { CaptureLogTables } from "../models/capture-log.mjs";
@@ -9,7 +9,6 @@ import { ProjectTables } from "../models/project.mjs";
 import { JobLease } from "./job-lease.mjs";
 import { CaptureJobOptions } from "./orchestrator.mjs";
 import { BuildStatePublisher } from "./build-state/types.mjs";
-//#region src/capture/dispatch.d.ts
 /** Build the queue's job runner: post pending, apply skip rules, capture, report. */
 declare function createDispatchJob(deps: DispatchDeps): (job: CaptureDispatchJob, lease?: JobLease) => Promise<void>;
 /** Table handles required by dispatch. */
@@ -36,6 +35,5 @@ interface CaptureDispatchJob {
   /** W3C `traceparent` continuing the enqueueing request's trace. */
   traceparent?: string;
 }
-//#endregion
 export { CaptureDispatchJob, DispatchDeps, DispatchTables, createDispatchJob };
 //# sourceMappingURL=dispatch.d.mts.map

package/dist/capture/dispatch.mjs

@@ -4,6 +4,7 @@ import.meta.url;
 import { redactSecrets } from "../utils/redact.mjs";
 import { CaptureAttemptModel, emitAttemptLog } from "../models/capture-attempt.mjs";
 import { BuildModel } from "../models/build.mjs";
+import { SignedUrlLifetimeError } from "./token-chunks.mjs";
 import { CaptureShardModel } from "../models/capture-shard.mjs";
 import { ProjectModel } from "../models/project.mjs";
 import { executeCaptureJob } from "./orchestrator.mjs";
@@ -11,7 +12,7 @@ import { CaptureLogModel } from "../models/capture-log.mjs";
 import { leaseProgress } from "./progress.mjs";
 import { executeCaptureShard } from "./shards/execute.mjs";
 import { hasApprovedBuildForSha } from "./skip-checks.mjs";
-//#region src/capture/dispatch.ts
+// src/capture/dispatch.ts
 /** Build the queue's job runner: post pending, apply skip rules, capture, report. */
 function createDispatchJob(deps) {
 	return async (job, lease) => {
@@ -119,11 +120,23 @@ async function runAndReport(ctx, job) {
 			progress: ctx.progress
 		}, deps.jobOptions));
 	} catch (error) {
-		await finishAttempt(ctx, "failed", errorText(error));
-		await deps.buildState.request(build.id);
-		throw error;
+		await reportFailure(ctx, error);
 	}
 }
+/** Record a failed run, then rethrow so the job is redelivered, unless another try cannot help. */
+async function reportFailure(ctx, error) {
+	const { deps, build } = ctx;
+	await finishAttempt(ctx, "failed", errorText(error));
+	await deps.buildState.request(build.id);
+	if (error instanceof SignedUrlLifetimeError) {
+		deps.logger.error({
+			buildId: build.id,
+			err: error
+		}, "capture not retried");
+		return;
+	}
+	throw error;
+}
 /** Load the build + project for a job, running orphan jobs directly. */
 async function loadJobTarget(deps, job) {
 	const build = await new BuildModel(deps.db, deps.tables).get(job.buildId);
@@ -180,7 +193,6 @@ async function loadClosing(deps, buildId) {
 		project
 	} : null;
 }
-//#endregion
 export { createDispatchJob };
 
 //# sourceMappingURL=dispatch.mjs.map

package/dist/capture/dispatch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.mjs","names":[],"sources":["../../src/capture/dispatch.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport {\n  CaptureAttemptModel,\n  emitAttemptLog,\n  type AttemptLogRecorder,\n  type CaptureAttemptTables,\n} from \"../models/capture-attempt.ts\";\nimport { CaptureLogModel, type CaptureLogTables } from \"../models/capture-log.ts\";\nimport { CaptureShardModel } from \"../models/capture-shard.ts\";\nimport { ProjectModel, type ProjectTables } from \"../models/project.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { CaptureAttempt } from \"../schema/capture-attempt.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { redactSecrets } from \"../utils/redact.ts\";\nimport type { BuildStatePublisher } from \"./build-state/types.ts\";\nimport type { JobLease } from \"./job-lease.ts\";\nimport { executeCaptureJob, type CaptureJobOptions, type CaptureSummary } from \"./orchestrator.ts\";\nimport { leaseProgress, type CaptureProgress } from \"./progress.ts\";\nimport { executeCaptureShard } from \"./shards/execute.ts\";\nimport type { FinalSummary } from \"./shards/reduce.ts\";\nimport { hasApprovedBuildForSha } from \"./skip-checks.ts\";\n\n/** Build the queue's job runner: post pending, apply skip rules, capture, report. */\nexport function createDispatchJob(\n  deps: DispatchDeps,\n): (job: CaptureDispatchJob, lease?: JobLease) => Promise<void> {\n  return async (job: CaptureDispatchJob, lease?: JobLease): Promise<void> => {\n    await (job.shard\n      ? runShardJob(deps, { ...job, shard: job.shard }, lease)\n      : runBuildJob(deps, job, lease));\n  };\n}\n\n/** The build's own job: post pending, apply skip rules, capture (or plan), report. */\nasync function runBuildJob(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob,\n  lease?: JobLease,\n): Promise<void> {\n  const target = await loadJobTarget(deps, job);\n  if (!target) {\n    return;\n  }\n  await deps.buildState.request(job.buildId);\n  const { attempt, recordLog } = await beginAttempt(\n    deps,\n    target.project,\n    target.build,\n    job.reqId,\n    lease,\n  );\n  const ctx: JobContext = {\n    deps,\n    build: target.build,\n    project: target.project,\n    attempt,\n    recordLog,\n    progress: leaseProgress(lease),\n  };\n  if (await maybeSkipDuplicate(ctx)) {\n    return;\n  }\n  await runAndReport(ctx, job);\n}\n\n/** Table handles required by dispatch. */\nexport type DispatchTables = BuildTables & ProjectTables & CaptureAttemptTables & CaptureLogTables;\n\n/** Dependencies for building the capture queue's job runner. */\nexport interface DispatchDeps {\n  db: DatabaseAdapter;\n  tables: DispatchTables;\n  jobOptions: CaptureJobOptions;\n  /** Shows a build's current state on its git channels; called at every transition. */\n  buildState: BuildStatePublisher;\n  logger: Logger;\n  /** Redeliveries the queue allows a failing job; a shard's last try is its final word. */\n  maxRetries?: number | undefined;\n}\n\n/** A queued capture job. */\nexport interface CaptureDispatchJob {\n  buildId: string;\n  /** A `capture_shards` row to render; absent for the build's own (plan or whole-build) job. */\n  shard?: string | undefined;\n  /** Times the queue has already delivered this job and seen it fail. */\n  attempts?: number | undefined;\n  reqId?: string;\n  /** W3C `traceparent` continuing the enqueueing request's trace. */\n  traceparent?: string;\n}\n\ninterface JobContext {\n  deps: DispatchDeps;\n  build: Build;\n  project: Project;\n  attempt: CaptureAttempt;\n  recordLog: AttemptLogRecorder;\n  progress: CaptureProgress | undefined;\n}\n\n/** Open a new attempt row for this run and return its log recorder. */\nasync function beginAttempt(\n  deps: DispatchDeps,\n  project: Project,\n  build: Build,\n  reqId: string | undefined,\n  lease?: JobLease,\n): Promise<{ attempt: CaptureAttempt; recordLog: AttemptLogRecorder }> {\n  const attempts = new CaptureAttemptModel(deps.db, deps.tables);\n  const logs = new CaptureLogModel(deps.db, deps.tables);\n  const attempt = await attempts.startAttempt(project.id, build.id, reqId);\n  // Every attempt-log line (stages, render progress, runner output) counts as progress.\n  const recordLog: AttemptLogRecorder = async (level, message, fields) => {\n    lease?.touch();\n    await logs.append(project.id, build.id, attempt.id, level, message, fields);\n  };\n  await emitAttemptLog(recordLog, deps.logger, \"info\", \"capture queued\", {\n    buildId: build.id,\n    attemptNo: attempt.attemptNo,\n  });\n  return { attempt, recordLog };\n}\n\n/** Close the attempt row with its terminal status, counts, and error. */\nasync function finishAttempt(\n  ctx: JobContext,\n  status: \"completed\" | \"failed\" | \"cancelled\",\n  error?: string,\n  counts?: { storyCount: number; failedCount: number },\n): Promise<void> {\n  const { deps, attempt } = ctx;\n  await new CaptureAttemptModel(deps.db, deps.tables).markFinished(\n    attempt.id,\n    status,\n    error,\n    counts,\n  );\n  await emitAttemptLog(\n    ctx.recordLog,\n    deps.logger,\n    status === \"failed\" ? \"error\" : \"info\",\n    `capture ${status}`,\n    { attemptNo: attempt.attemptNo },\n  );\n}\n\n/** Full error text for an attempt row (message plus stack when available). */\nfunction errorText(reason: unknown): string {\n  // A runner's error can quote the signed Storybook URL it failed to open.\n  return redactSecrets(reason instanceof Error ? (reason.stack ?? reason.message) : String(reason));\n}\n\nasync function approveWithoutCapture(ctx: JobContext, reason: string): Promise<void> {\n  const { deps, build } = ctx;\n  deps.logger.info({ buildId: build.id, sha: build.gitSha, branch: build.gitBranch }, reason);\n  await emitAttemptLog(ctx.recordLog, deps.logger, \"info\", reason, {\n    sha: build.gitSha,\n    branch: build.gitBranch,\n  });\n  await finishAttempt(ctx, \"completed\");\n  await new BuildModel(deps.db, deps.tables).setStatus(build.id, \"approved\").catch(() => {}); // Intentionally empty — fire-and-forget\n  await deps.buildState.request(build.id);\n}\n\nasync function maybeSkipDuplicate(ctx: JobContext): Promise<boolean> {\n  const { deps, build, project } = ctx;\n  const dup = await hasApprovedBuildForSha(\n    deps.db,\n    deps.tables,\n    project.id,\n    build.gitSha,\n    build.id,\n  );\n  if (dup) {\n    await approveWithoutCapture(ctx, \"skipping capture — duplicate sha already approved\");\n    return true;\n  }\n  return false;\n}\n\n/** A sharded build's attempt stays open: the worker that finishes the last shard closes it. */\nasync function finishUnlessSharded(ctx: JobContext, summary: CaptureSummary): Promise<void> {\n  if (summary.shards) {\n    await emitAttemptLog(ctx.recordLog, ctx.deps.logger, \"info\", \"capture sharded\", {\n      shards: summary.shards,\n    });\n    return;\n  }\n  await finishAttempt(ctx, \"completed\", undefined, summary);\n  await ctx.deps.buildState.request(ctx.build.id);\n}\n\nasync function runAndReport(ctx: JobContext, job: CaptureDispatchJob): Promise<void> {\n  const { deps, build } = ctx;\n  await new CaptureAttemptModel(deps.db, deps.tables).markRunning(ctx.attempt.id);\n  await emitAttemptLog(ctx.recordLog, deps.logger, \"info\", \"capture started\", {\n    buildId: build.id,\n    attemptNo: ctx.attempt.attemptNo,\n  });\n  try {\n    const summary = await executeCaptureJob(\n      {\n        buildId: job.buildId,\n        reqId: job.reqId,\n        traceparent: job.traceparent,\n        attempt: {\n          id: ctx.attempt.id,\n          attemptNo: ctx.attempt.attemptNo,\n          projectId: ctx.project.id,\n        },\n        recordLog: ctx.recordLog,\n        progress: ctx.progress,\n      },\n      deps.jobOptions,\n    );\n    await finishUnlessSharded(ctx, summary);\n  } catch (error: unknown) {\n    await finishAttempt(ctx, \"failed\", errorText(error));\n    await deps.buildState.request(build.id);\n    throw error;\n  }\n}\n\n/** Load the build + project for a job, running orphan jobs directly. */\nasync function loadJobTarget(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(deps.db, deps.tables).get(job.buildId);\n  const project = build ? await new ProjectModel(deps.db, deps.tables).get(build.projectId) : null;\n  if (!build || !project) {\n    await executeCaptureJob(\n      { buildId: job.buildId, reqId: job.reqId, traceparent: job.traceparent },\n      deps.jobOptions,\n    );\n    return null;\n  }\n  return { build, project };\n}\n\n/**\n * Run one render shard. Only the run that finalized the build closes the plan's attempt and posts\n * the terminal status, whether its shard succeeded or failed; every other run leaves them alone.\n */\nasync function runShardJob(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob & { shard: string },\n  lease?: JobLease,\n): Promise<void> {\n  const final = (job.attempts ?? 0) >= (deps.maxRetries ?? 0);\n  await executeCaptureShard(\n    {\n      buildId: job.buildId,\n      shard: job.shard,\n      reqId: job.reqId,\n      final,\n      progress: leaseProgress(lease),\n      onFinalized: async (summary, error) => {\n        await closeShardedBuild(deps, job.buildId, summary, error);\n      },\n    },\n    deps.jobOptions,\n  );\n}\n\n/** End the plan's attempt with the finalizer's counts and report the build's terminal status. */\nasync function closeShardedBuild(\n  deps: DispatchDeps,\n  buildId: string,\n  summary: FinalSummary,\n  error?: unknown,\n): Promise<void> {\n  const loaded = await loadClosing(deps, buildId);\n  if (!loaded) {\n    return;\n  }\n  const failure = error === undefined ? summary.error : errorText(error);\n  const failed = failure !== undefined || summary.buildStatus === \"failed\";\n  const attemptId = summary.attemptId ?? (await planAttemptId(deps, buildId));\n  if (attemptId) {\n    await new CaptureAttemptModel(deps.db, deps.tables)\n      .markFinished(attemptId, failed ? \"failed\" : \"completed\", failure, summary)\n      .catch((closeError: unknown) => {\n        deps.logger.error({ err: closeError }, \"failed to close attempt\");\n      });\n  }\n  await deps.buildState.request(buildId);\n}\n\nasync function planAttemptId(deps: DispatchDeps, buildId: string): Promise<string | null> {\n  const plan = await new CaptureShardModel(deps.db).plan(buildId);\n  return plan?.attemptId ?? null;\n}\n\nasync function loadClosing(\n  deps: DispatchDeps,\n  buildId: string,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(deps.db, deps.tables).get(buildId);\n  const project = build ? await new ProjectModel(deps.db, deps.tables).get(build.projectId) : null;\n  return build && project ? { build, project } : null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"dispatch.mjs","names":[],"sources":["../../src/capture/dispatch.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport { BuildModel, type BuildTables } from \"../models/build.ts\";\nimport {\n  CaptureAttemptModel,\n  emitAttemptLog,\n  type AttemptLogRecorder,\n  type CaptureAttemptTables,\n} from \"../models/capture-attempt.ts\";\nimport { CaptureLogModel, type CaptureLogTables } from \"../models/capture-log.ts\";\nimport { CaptureShardModel } from \"../models/capture-shard.ts\";\nimport { ProjectModel, type ProjectTables } from \"../models/project.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { CaptureAttempt } from \"../schema/capture-attempt.ts\";\nimport type { Project } from \"../schema/project.ts\";\nimport { redactSecrets } from \"../utils/redact.ts\";\nimport type { BuildStatePublisher } from \"./build-state/types.ts\";\nimport type { JobLease } from \"./job-lease.ts\";\nimport { executeCaptureJob, type CaptureJobOptions, type CaptureSummary } from \"./orchestrator.ts\";\nimport { leaseProgress, type CaptureProgress } from \"./progress.ts\";\nimport { executeCaptureShard } from \"./shards/execute.ts\";\nimport type { FinalSummary } from \"./shards/reduce.ts\";\nimport { hasApprovedBuildForSha } from \"./skip-checks.ts\";\nimport { SignedUrlLifetimeError } from \"./token-chunks.ts\";\n\n/** Build the queue's job runner: post pending, apply skip rules, capture, report. */\nexport function createDispatchJob(\n  deps: DispatchDeps,\n): (job: CaptureDispatchJob, lease?: JobLease) => Promise<void> {\n  return async (job: CaptureDispatchJob, lease?: JobLease): Promise<void> => {\n    await (job.shard\n      ? runShardJob(deps, { ...job, shard: job.shard }, lease)\n      : runBuildJob(deps, job, lease));\n  };\n}\n\n/** The build's own job: post pending, apply skip rules, capture (or plan), report. */\nasync function runBuildJob(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob,\n  lease?: JobLease,\n): Promise<void> {\n  const target = await loadJobTarget(deps, job);\n  if (!target) {\n    return;\n  }\n  await deps.buildState.request(job.buildId);\n  const { attempt, recordLog } = await beginAttempt(\n    deps,\n    target.project,\n    target.build,\n    job.reqId,\n    lease,\n  );\n  const ctx: JobContext = {\n    deps,\n    build: target.build,\n    project: target.project,\n    attempt,\n    recordLog,\n    progress: leaseProgress(lease),\n  };\n  if (await maybeSkipDuplicate(ctx)) {\n    return;\n  }\n  await runAndReport(ctx, job);\n}\n\n/** Table handles required by dispatch. */\nexport type DispatchTables = BuildTables & ProjectTables & CaptureAttemptTables & CaptureLogTables;\n\n/** Dependencies for building the capture queue's job runner. */\nexport interface DispatchDeps {\n  db: DatabaseAdapter;\n  tables: DispatchTables;\n  jobOptions: CaptureJobOptions;\n  /** Shows a build's current state on its git channels; called at every transition. */\n  buildState: BuildStatePublisher;\n  logger: Logger;\n  /** Redeliveries the queue allows a failing job; a shard's last try is its final word. */\n  maxRetries?: number | undefined;\n}\n\n/** A queued capture job. */\nexport interface CaptureDispatchJob {\n  buildId: string;\n  /** A `capture_shards` row to render; absent for the build's own (plan or whole-build) job. */\n  shard?: string | undefined;\n  /** Times the queue has already delivered this job and seen it fail. */\n  attempts?: number | undefined;\n  reqId?: string;\n  /** W3C `traceparent` continuing the enqueueing request's trace. */\n  traceparent?: string;\n}\n\ninterface JobContext {\n  deps: DispatchDeps;\n  build: Build;\n  project: Project;\n  attempt: CaptureAttempt;\n  recordLog: AttemptLogRecorder;\n  progress: CaptureProgress | undefined;\n}\n\n/** Open a new attempt row for this run and return its log recorder. */\nasync function beginAttempt(\n  deps: DispatchDeps,\n  project: Project,\n  build: Build,\n  reqId: string | undefined,\n  lease?: JobLease,\n): Promise<{ attempt: CaptureAttempt; recordLog: AttemptLogRecorder }> {\n  const attempts = new CaptureAttemptModel(deps.db, deps.tables);\n  const logs = new CaptureLogModel(deps.db, deps.tables);\n  const attempt = await attempts.startAttempt(project.id, build.id, reqId);\n  // Every attempt-log line (stages, render progress, runner output) counts as progress.\n  const recordLog: AttemptLogRecorder = async (level, message, fields) => {\n    lease?.touch();\n    await logs.append(project.id, build.id, attempt.id, level, message, fields);\n  };\n  await emitAttemptLog(recordLog, deps.logger, \"info\", \"capture queued\", {\n    buildId: build.id,\n    attemptNo: attempt.attemptNo,\n  });\n  return { attempt, recordLog };\n}\n\n/** Close the attempt row with its terminal status, counts, and error. */\nasync function finishAttempt(\n  ctx: JobContext,\n  status: \"completed\" | \"failed\" | \"cancelled\",\n  error?: string,\n  counts?: { storyCount: number; failedCount: number },\n): Promise<void> {\n  const { deps, attempt } = ctx;\n  await new CaptureAttemptModel(deps.db, deps.tables).markFinished(\n    attempt.id,\n    status,\n    error,\n    counts,\n  );\n  await emitAttemptLog(\n    ctx.recordLog,\n    deps.logger,\n    status === \"failed\" ? \"error\" : \"info\",\n    `capture ${status}`,\n    { attemptNo: attempt.attemptNo },\n  );\n}\n\n/** Full error text for an attempt row (message plus stack when available). */\nfunction errorText(reason: unknown): string {\n  // A runner's error can quote the signed Storybook URL it failed to open.\n  return redactSecrets(reason instanceof Error ? (reason.stack ?? reason.message) : String(reason));\n}\n\nasync function approveWithoutCapture(ctx: JobContext, reason: string): Promise<void> {\n  const { deps, build } = ctx;\n  deps.logger.info({ buildId: build.id, sha: build.gitSha, branch: build.gitBranch }, reason);\n  await emitAttemptLog(ctx.recordLog, deps.logger, \"info\", reason, {\n    sha: build.gitSha,\n    branch: build.gitBranch,\n  });\n  await finishAttempt(ctx, \"completed\");\n  await new BuildModel(deps.db, deps.tables).setStatus(build.id, \"approved\").catch(() => {}); // Intentionally empty — fire-and-forget\n  await deps.buildState.request(build.id);\n}\n\nasync function maybeSkipDuplicate(ctx: JobContext): Promise<boolean> {\n  const { deps, build, project } = ctx;\n  const dup = await hasApprovedBuildForSha(\n    deps.db,\n    deps.tables,\n    project.id,\n    build.gitSha,\n    build.id,\n  );\n  if (dup) {\n    await approveWithoutCapture(ctx, \"skipping capture — duplicate sha already approved\");\n    return true;\n  }\n  return false;\n}\n\n/** A sharded build's attempt stays open: the worker that finishes the last shard closes it. */\nasync function finishUnlessSharded(ctx: JobContext, summary: CaptureSummary): Promise<void> {\n  if (summary.shards) {\n    await emitAttemptLog(ctx.recordLog, ctx.deps.logger, \"info\", \"capture sharded\", {\n      shards: summary.shards,\n    });\n    return;\n  }\n  await finishAttempt(ctx, \"completed\", undefined, summary);\n  await ctx.deps.buildState.request(ctx.build.id);\n}\n\nasync function runAndReport(ctx: JobContext, job: CaptureDispatchJob): Promise<void> {\n  const { deps, build } = ctx;\n  await new CaptureAttemptModel(deps.db, deps.tables).markRunning(ctx.attempt.id);\n  await emitAttemptLog(ctx.recordLog, deps.logger, \"info\", \"capture started\", {\n    buildId: build.id,\n    attemptNo: ctx.attempt.attemptNo,\n  });\n  try {\n    const summary = await executeCaptureJob(\n      {\n        buildId: job.buildId,\n        reqId: job.reqId,\n        traceparent: job.traceparent,\n        attempt: {\n          id: ctx.attempt.id,\n          attemptNo: ctx.attempt.attemptNo,\n          projectId: ctx.project.id,\n        },\n        recordLog: ctx.recordLog,\n        progress: ctx.progress,\n      },\n      deps.jobOptions,\n    );\n    await finishUnlessSharded(ctx, summary);\n  } catch (error: unknown) {\n    await reportFailure(ctx, error);\n  }\n}\n\n/** Record a failed run, then rethrow so the job is redelivered, unless another try cannot help. */\nasync function reportFailure(ctx: JobContext, error: unknown): Promise<void> {\n  const { deps, build } = ctx;\n  await finishAttempt(ctx, \"failed\", errorText(error));\n  await deps.buildState.request(build.id);\n  if (error instanceof SignedUrlLifetimeError) {\n    // A configuration problem: another delivery would fail the same way. The build is failed.\n    deps.logger.error({ buildId: build.id, err: error }, \"capture not retried\");\n    return;\n  }\n  throw error;\n}\n\n/** Load the build + project for a job, running orphan jobs directly. */\nasync function loadJobTarget(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(deps.db, deps.tables).get(job.buildId);\n  const project = build ? await new ProjectModel(deps.db, deps.tables).get(build.projectId) : null;\n  if (!build || !project) {\n    await executeCaptureJob(\n      { buildId: job.buildId, reqId: job.reqId, traceparent: job.traceparent },\n      deps.jobOptions,\n    );\n    return null;\n  }\n  return { build, project };\n}\n\n/**\n * Run one render shard. Only the run that finalized the build closes the plan's attempt and posts\n * the terminal status, whether its shard succeeded or failed; every other run leaves them alone.\n */\nasync function runShardJob(\n  deps: DispatchDeps,\n  job: CaptureDispatchJob & { shard: string },\n  lease?: JobLease,\n): Promise<void> {\n  const final = (job.attempts ?? 0) >= (deps.maxRetries ?? 0);\n  await executeCaptureShard(\n    {\n      buildId: job.buildId,\n      shard: job.shard,\n      reqId: job.reqId,\n      final,\n      progress: leaseProgress(lease),\n      onFinalized: async (summary, error) => {\n        await closeShardedBuild(deps, job.buildId, summary, error);\n      },\n    },\n    deps.jobOptions,\n  );\n}\n\n/** End the plan's attempt with the finalizer's counts and report the build's terminal status. */\nasync function closeShardedBuild(\n  deps: DispatchDeps,\n  buildId: string,\n  summary: FinalSummary,\n  error?: unknown,\n): Promise<void> {\n  const loaded = await loadClosing(deps, buildId);\n  if (!loaded) {\n    return;\n  }\n  const failure = error === undefined ? summary.error : errorText(error);\n  const failed = failure !== undefined || summary.buildStatus === \"failed\";\n  const attemptId = summary.attemptId ?? (await planAttemptId(deps, buildId));\n  if (attemptId) {\n    await new CaptureAttemptModel(deps.db, deps.tables)\n      .markFinished(attemptId, failed ? \"failed\" : \"completed\", failure, summary)\n      .catch((closeError: unknown) => {\n        deps.logger.error({ err: closeError }, \"failed to close attempt\");\n      });\n  }\n  await deps.buildState.request(buildId);\n}\n\nasync function planAttemptId(deps: DispatchDeps, buildId: string): Promise<string | null> {\n  const plan = await new CaptureShardModel(deps.db).plan(buildId);\n  return plan?.attemptId ?? null;\n}\n\nasync function loadClosing(\n  deps: DispatchDeps,\n  buildId: string,\n): Promise<{ build: Build; project: Project } | null> {\n  const build = await new BuildModel(deps.db, deps.tables).get(buildId);\n  const project = build ? await new ProjectModel(deps.db, deps.tables).get(build.projectId) : null;\n  return build && project ? { build, project } : null;\n}\n"],"mappings":"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"}

package/dist/capture/enrich.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { filterModes } from "./modes.mjs";
 import { renderBudgetMs } from "./render.mjs";
 import { resolveStoryViewports } from "./storybook.mjs";
-//#region src/capture/enrich.ts
+// src/capture/enrich.ts
 /**
 * Merge runtime-resolved parameters (project/component/story levels stacked by
 * Storybook) over the index's, then apply the project's mode allowlist. A
@@ -54,7 +54,6 @@ async function extractSafely(input) {
 		return {};
 	}
 }
-//#endregion
 export { assertModeCaps, enrichStories };
 
 //# sourceMappingURL=enrich.mjs.map

package/dist/capture/failure-sets.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { isFlakyStory } from "./adapter.mjs";
-//#region src/capture/failure-sets.ts
+// src/capture/failure-sets.ts
 /** Classify render failures: `a11y:` errors, then flaky stories, then everything else is blocking. */
 function classifyFailures(stories, failures) {
 	const flakyIds = new Set(stories.filter((story) => isFlakyStory(story)).map((story) => story.id));
@@ -16,7 +16,6 @@ function classifyFailures(stories, failures) {
 	else sets.blocking.add(failure.storyId);
 	return sets;
 }
-//#endregion
 export { classifyFailures };
 
 //# sourceMappingURL=failure-sets.mjs.map

package/dist/capture/fingerprint.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Viewport } from "./adapter.mjs";
 import { CaptureEnvironment } from "../adapter/capture-runner.mjs";
 import { SIZING_DEFAULTS } from "./sizing.mjs";
-//#region src/capture/fingerprint.d.ts
 /** The components behind a snapshot's `infraHash`, kept so a mismatch can say what changed. */
 interface Fingerprint {
   engine: string;
@@ -37,6 +36,5 @@ interface EnvironmentChange {
   from: Fingerprint | null;
   to: Fingerprint;
 }
-//#endregion
 export { EnvironmentChange, Fingerprint, buildFingerprint, changedFields, fingerprintHash, parseFingerprint };
 //# sourceMappingURL=fingerprint.d.mts.map

package/dist/capture/fingerprint.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { sha256 } from "../utils/hash.mjs";
 import { SIZING_DEFAULTS } from "./sizing.mjs";
-//#region src/capture/fingerprint.ts
+// src/capture/fingerprint.ts
 /** Build the fingerprint of one capture. Missing environment fields stay `null` (runner did not report them). */
 function buildFingerprint(engine, viewport, environment) {
 	return {
@@ -77,7 +77,6 @@ function parseFingerprint(raw) {
 		return null;
 	}
 }
-//#endregion
 export { buildFingerprint, changedFields, fingerprintHash, mergeFingerprint, parseFingerprint };
 
 //# sourceMappingURL=fingerprint.mjs.map

package/dist/capture/forked/channel.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ChildMessage, ParentMessage } from "./protocol.mjs";
-//#region src/capture/forked/channel.d.ts
 /** How the parent sees the capture child (`child_process.fork` adapts to this). */
 interface ChildProcessHandle {
   send(message: ParentMessage): void;
@@ -20,6 +19,5 @@ interface ParentPort {
   onMessage(listener: (message: unknown) => void): void;
   onDisconnect(listener: () => void): void;
 }
-//#endregion
 export { ChildProcessHandle, ParentPort };
 //# sourceMappingURL=channel.d.mts.map

package/dist/capture/forked/child.d.mts

@@ -4,7 +4,6 @@ import { Logger } from "../../logger.mjs";
 import { CaptureHandlerOptions } from "../consumer/capture-handler.mjs";
 import { CaptureConsumerOptions } from "../consumer/types.mjs";
 import { ChildMessage } from "./protocol.mjs";
-//#region src/capture/forked/child.d.ts
 /** Handler options minus the shard hand-out, which the child wires to the database queue. */
 type CaptureChildOptions = Omit<CaptureHandlerOptions, "enqueue" | "logger"> & Pick<CaptureConsumerOptions, "images" | "compare"> & {
   logger?: Logger;
@@ -29,6 +28,5 @@ interface ChildHost {
  * @throws When not running as a forked child (no IPC channel), or when the image engine cannot load.
  */
 declare function runCaptureChild(options: CaptureChildOptions, host?: ChildHost): Promise<void>;
-//#endregion
 export { CaptureChildOptions, ChildHost, runCaptureChild };
 //# sourceMappingURL=child.d.mts.map

package/dist/capture/forked/child.mjs

@@ -10,7 +10,7 @@ import { createCaptureHandler, originOf } from "../consumer/capture-handler.mjs"
 import { applyImageSettings, ensureImageEngine } from "../consumer/startup.mjs";
 import "./fork.mjs";
 import { isParentMessage } from "./protocol.mjs";
-//#region src/capture/forked/child.ts
+// src/capture/forked/child.ts
 /**
 * Entry helper for a forked capture child (`testing.workerEntry`). The app is the consumer: it
 * polls the database queue, holds the slots and the lease, and pushes each leased job here over
@@ -196,7 +196,6 @@ function processHost() {
 		exit: (code) => process.exit(code)
 	};
 }
-//#endregion
 export { runCaptureChild };
 
 //# sourceMappingURL=child.mjs.map

package/dist/capture/forked/crash-tracker.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/crash-tracker.ts
+// src/capture/forked/crash-tracker.ts
 /** Counts child crashes inside a sliding window, to tell a flaky child from a crash loop. */
 var CrashTracker = class {
 	#limit;
@@ -17,7 +17,6 @@ var CrashTracker = class {
 		return this.#times.length >= this.#limit;
 	}
 };
-//#endregion
 export { CrashTracker };
 
 //# sourceMappingURL=crash-tracker.mjs.map

package/dist/capture/forked/decision.d.mts

@@ -1,6 +1,5 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-//#region src/capture/forked/decision.d.ts
 /** Whether a capture child is worth forking on this host (ADR 0005 phase 3 fallback rules). */
 /** What the decision looks at. */
 interface ForkHost {
@@ -21,6 +20,5 @@ declare const FORK_MIN_CPUS = 2;
 declare const FORK_MIN_MEMORY_BYTES: number;
 /** Pick the capture process model for a host. */
 declare function decideCaptureProcess(host: ForkHost): ForkDecision;
-//#endregion
 export { FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, ForkDecision, ForkHost, decideCaptureProcess };
 //# sourceMappingURL=decision.d.mts.map

package/dist/capture/forked/decision.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/decision.ts
+// src/capture/forked/decision.ts
 /** Smallest host that still gains from a second process: below this the child only costs memory. */
 const FORK_MIN_CPUS = 2;
 const FORK_MIN_MEMORY_BYTES = 2 * 1024 ** 3;
@@ -21,7 +21,6 @@ function decideCaptureProcess(host) {
 	};
 	return { mode: "fork" };
 }
-//#endregion
 export { FORK_MIN_CPUS, FORK_MIN_MEMORY_BYTES, decideCaptureProcess };
 
 //# sourceMappingURL=decision.mjs.map

package/dist/capture/forked/exit.mjs

@@ -1,12 +1,11 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/exit.ts
+// src/capture/forked/exit.ts
 /** `signal SIGKILL` or `code 1`. */
 function describeExit(info) {
 	return info.signal ? `signal ${info.signal}` : `code ${info.code}`;
 }
-//#endregion
 export { describeExit };
 
 //# sourceMappingURL=exit.mjs.map

package/dist/capture/forked/fork.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ChildProcessHandle } from "./channel.mjs";
-//#region src/capture/forked/fork.d.ts
 /** Environment variable the forked child sees; set to this value so a module can tell it is the child. */
 declare const CAPTURE_WORKER_ROLE = "capture-worker";
 /** Environment variable carrying the parent's `testing.retries` to the child, which stamps it on the shard jobs it queues. */
@@ -26,6 +25,5 @@ interface ForkOptions {
  * @throws When the runtime cannot fork, or the fork itself throws.
  */
 declare function forkCaptureChild(options: ForkOptions): ChildProcessHandle;
-//#endregion
 export { CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, ForkOptions, canForkCaptureChild, forkCaptureChild };
 //# sourceMappingURL=fork.d.mts.map

package/dist/capture/forked/fork.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/fork.ts
+// src/capture/forked/fork.ts
 /** Environment variable the forked child sees; set to this value so a module can tell it is the child. */
 const CAPTURE_WORKER_ROLE = "capture-worker";
 /** Environment variable carrying the parent's `testing.retries` to the child, which stamps it on the shard jobs it queues. */
@@ -87,7 +87,6 @@ function wrap(child, stopOnExit) {
 		}
 	};
 }
-//#endregion
 export { CAPTURE_RETRIES_ENV, CAPTURE_SHARD_SIZE_ENV, CAPTURE_WORKER_ROLE, canForkCaptureChild, forkCaptureChild };
 
 //# sourceMappingURL=fork.mjs.map

package/dist/capture/forked/forked-capture.d.mts

@@ -3,7 +3,6 @@ import __tsdown_shims_url from 'node:url';
 import { Logger } from "../../logger.mjs";
 import { ConsumerJob, KindHandler } from "../consumer/types.mjs";
 import { ChildProcessHandle } from "./channel.mjs";
-//#region src/capture/forked/forked-capture.d.ts
 /** Options of {@link createForkedCaptureHandler}. */
 interface ForkedCaptureOptions {
   /** Start the capture child. Throwing counts as "fork failed" and trips the fallback. */
@@ -35,6 +34,5 @@ interface ForkedCaptureHandler extends KindHandler {
 }
 /** Create the handler; the child is forked when the first job arrives. */
 declare function createForkedCaptureHandler(options: ForkedCaptureOptions): ForkedCaptureHandler;
-//#endregion
 export { ForkedCaptureHandler, ForkedCaptureOptions, createForkedCaptureHandler };
 //# sourceMappingURL=forked-capture.d.mts.map

package/dist/capture/forked/forked-capture.mjs

@@ -8,7 +8,7 @@ import { CrashTracker } from "./crash-tracker.mjs";
 import { describeExit } from "./exit.mjs";
 import { LeaseBook } from "./lease-book.mjs";
 import { RunBook, jobKey } from "./runs.mjs";
-//#region src/capture/forked/forked-capture.ts
+// src/capture/forked/forked-capture.ts
 /** Create the handler; the child is forked when the first job arrives. */
 function createForkedCaptureHandler(options) {
 	const forked = new ForkedCapture(options);
@@ -234,7 +234,6 @@ async function delay(ms) {
 		setTimeout(resolve, ms).unref();
 	});
 }
-//#endregion
 export { createForkedCaptureHandler };
 
 //# sourceMappingURL=forked-capture.mjs.map

package/dist/capture/forked/lease-book.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { ProgressLease } from "../job-lease.mjs";
-//#region src/capture/forked/lease-book.ts
+// src/capture/forked/lease-book.ts
 /** Progress leases for jobs out with the capture child: no progress within the lease means the child is hung. */
 /** One {@link ProgressLease} per in-flight receipt. A `leaseMs` of 0 disables the whole book. */
 var LeaseBook = class {
@@ -40,7 +40,6 @@ var LeaseBook = class {
 		this.#leases.clear();
 	}
 };
-//#endregion
 export { LeaseBook };
 
 //# sourceMappingURL=lease-book.mjs.map

package/dist/capture/forked/protocol.d.mts

@@ -1,7 +1,6 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { ConsumerJob } from "../consumer/types.mjs";
-//#region src/capture/forked/protocol.d.ts
 /** Parent to child. `runId` names one push of a job; a re-push after a crash gets a new one. */
 type ParentMessage =
 /** Run this leased job. The child holds the same database, storage and runner configuration. */
@@ -33,6 +32,5 @@ type ChildMessage =
   runId: string;
   error: string;
 };
-//#endregion
 export { ChildMessage, ParentMessage };
 //# sourceMappingURL=protocol.d.mts.map

package/dist/capture/forked/protocol.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/protocol.ts
+// src/capture/forked/protocol.ts
 function isRecord(value) {
 	return typeof value === "object" && value !== null;
 }
@@ -19,7 +19,6 @@ function isParentMessage(value) {
 	if (!isRecord(value) || typeof value["runId"] !== "string") return false;
 	return value["type"] === "cancel" || value["type"] === "run" && isJob(value["job"]);
 }
-//#endregion
 export { isChildMessage, isParentMessage };
 
 //# sourceMappingURL=protocol.mjs.map

package/dist/capture/forked/runs.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/forked/runs.ts
+// src/capture/forked/runs.ts
 /** In-flight runs by id, plus the admission rule for solo runs and a signal for waiters. */
 var RunBook = class {
 	#runs = /* @__PURE__ */ new Map();
@@ -69,7 +69,6 @@ var RunBook = class {
 function jobKey(job) {
 	return job.receipt ?? `${job.buildId}:${job.shard ?? ""}`;
 }
-//#endregion
 export { RunBook, jobKey };
 
 //# sourceMappingURL=runs.mjs.map

package/dist/capture/guards.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/capture/guards.ts
+// src/capture/guards.ts
 /**
 * Capture output guards: a third-party runner returning garbage (or
 * gigabytes) must fail here, before bytes reach storage or baselines.
@@ -25,7 +25,6 @@ function assertScreenshotBuffer(buffer) {
 	if (buffer.length > 26214400) throw new Error(`Screenshot exceeds ${MAX_SCREENSHOT_BYTES} bytes`);
 	if (!PNG_MAGIC.every((byte, index) => buffer[index] === byte)) throw new Error("Screenshot is not a PNG");
 }
-//#endregion
 export { MAX_SCREENSHOT_BYTES, assertScreenshotBuffer };
 
 //# sourceMappingURL=guards.mjs.map

package/dist/capture/ignore-regions.d.mts

@@ -0,0 +1,36 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+/**
+ * Ignore regions: elements a story marks as dynamic (timestamps, avatars, ads) are hidden before
+ * the screenshot so they never produce a diff. Both runners inject the stylesheet built here, so
+ * the mask is identical across engines. Baseline keys and diff math are untouched.
+ */
+/** Most selectors one story may declare; the rest are dropped. */
+declare const MAX_IGNORE_SELECTORS = 50;
+/** Selectors that always apply: StoryShelf's attribute, then the Chromatic migration spellings. */
+declare const DEFAULT_IGNORE_SELECTORS: readonly string[];
+/** Whether `selector` is non-empty text that cannot break out of a single CSS rule. */
+declare function isSafeIgnoreSelector(selector: unknown): selector is string;
+/** The result of reading a story's `ignoreSelectors`. */
+interface IgnoreSelectorList {
+  /** Trimmed, deduplicated, safe selectors, at most {@link MAX_IGNORE_SELECTORS}. */
+  selectors: string[];
+  /** Entries that were refused (not a string, empty, or unsafe) or cut by the cap. */
+  skipped: string[];
+}
+/** Clean the declared `ignoreSelectors` value; anything that is not an array yields no selectors. */
+declare function cleanIgnoreSelectors(value: unknown): IgnoreSelectorList;
+/**
+ * The string entries of a declared `ignoreSelectors` value, untouched, or `undefined` when there
+ * are none. Safety and the cap are applied later by {@link cleanIgnoreSelectors}, in the runner,
+ * so a refused selector can still be reported on the snapshot log.
+ */
+declare function declaredIgnoreSelectors(value: unknown): string[] | undefined;
+/**
+ * The stylesheet that masks `selectors` plus {@link DEFAULT_IGNORE_SELECTORS}. One rule per
+ * selector, so a selector the browser rejects cannot take the others down with it. Unsafe selectors
+ * are dropped here as well.
+ */
+declare function ignoreStylesheet(selectors?: readonly string[]): string;
+export { DEFAULT_IGNORE_SELECTORS, IgnoreSelectorList, MAX_IGNORE_SELECTORS, cleanIgnoreSelectors, declaredIgnoreSelectors, ignoreStylesheet, isSafeIgnoreSelector };
+//# sourceMappingURL=ignore-regions.d.mts.map