stateofpixel 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,79 +2,33 @@
2
2
 
3
3
  Visual regression testing that runs in your CI. Upload a folder of screenshots, review the changes on [stateofpixel.com](https://stateofpixel.com), and a GitHub check blocks the merge until every change is approved.
4
4
 
5
+ The docs are at [stateofpixel.com/docs](https://stateofpixel.com/docs): Playwright, Storybook, other CI, sharding, the CLI reference and limits.
6
+
5
7
  ## GitHub Actions
6
8
 
7
9
  Install the GitHub App from [stateofpixel.com](https://stateofpixel.com), then add a step after the one that writes your screenshots:
8
10
 
9
11
  ```yaml
12
+ on:
13
+ push:
14
+ branches: [main]
15
+ pull_request:
16
+
10
17
  permissions:
11
18
  contents: read
12
19
  id-token: write
13
20
 
14
- steps:
15
- - uses: actions/checkout@v4
16
- with:
17
- fetch-depth: 0
18
- - run: npx playwright test
19
- - run: npx stateofpixel upload screenshots
21
+ jobs:
22
+ visual:
23
+ runs-on: ubuntu-latest
24
+ steps:
25
+ - uses: actions/checkout@v4
26
+ with:
27
+ fetch-depth: 0
28
+ - run: npx playwright test
29
+ - run: npx stateofpixel upload screenshots
20
30
  ```
21
31
 
22
- On other CI, set `STATEOFPIXEL_TOKEN` to a project token. Admins create tokens in the project settings on stateofpixel.com.
23
-
24
- ## Commands
25
-
26
- | Command | Purpose |
27
- |---|---|
28
- | `stateofpixel upload <dir>` | Upload a folder of PNGs and compare it with the baseline. |
29
- | `stateofpixel storybook <static-dir>` | Capture every story of a built Storybook, then upload. |
30
- | `stateofpixel finalize` | Finish a build whose shards ran with `--shard auto`. |
31
- | `stateofpixel compare <dir> <baseline-dir>` | Compare two folders locally and write `stateofpixel-report/index.html`. |
32
-
33
- Run `stateofpixel <command> --help` for every flag.
34
-
35
- A `<name>.meta.json` next to `<name>.png` is sent as that snapshot's metadata and shown on the review page.
36
-
37
- ## Storybook
38
-
39
- `storybook` and the Playwright reporter need Playwright in your project: `npm install -D playwright`, then `npx playwright install chromium`.
40
-
41
- ```yaml
42
- - run: npx storybook build
43
- - run: npx stateofpixel storybook storybook-static --viewports 375,1280
44
- ```
45
-
46
- Each story is captured at every viewport width and named `Title/Name [chromium 1280]`. Filter with `--include` and `--exclude` globs on `Title/Name`, and use `--wait-for-selector` and `--delay` for stories that render late.
47
-
48
- ## Playwright
49
-
50
- ```ts
51
- // playwright.config.ts
52
- reporter: [["list"], ["stateofpixel/playwright"]]
53
-
54
- // in a test
55
- import { snapshot } from "stateofpixel/playwright";
56
- await snapshot(page, "Checkout/Empty cart");
57
- ```
58
-
59
- `snapshot` waits for fonts, disables animations, hides the caret, and saves a full-page screenshot named `Checkout/Empty cart [chromium 1280]` into `stateofpixel-screenshots`. The reporter uploads that folder when the run ends, once per shard when Playwright sharding is on. It uploads on CI only (when `CI` is set); pass `{ uploadOutsideCi: true }` as reporter options to upload from your machine. When a test fails, the upload is marked as a subset so skipped snapshots are not reported as removed.
60
-
61
- ## Sharding
62
-
63
- With a known shard count, each job runs `stateofpixel upload screenshots --shard 1/4` through `4/4`, and the build finishes when the last shard is done.
64
-
65
- When the count is not known, each job runs `stateofpixel upload screenshots --shard auto`, and one last job runs `stateofpixel finalize`. Add `--skip-if-empty` so the check still reports when no shard ran.
66
-
67
- ## Service errors
68
-
69
- When the service is down, or a rate limit is hit, `upload` and `finalize` print a warning and exit 0, so our outage does not break your CI. Pass `--strict` to fail instead.
70
-
71
- ## Limits
72
-
73
- - 20,000 snapshots and 256 shards per build.
74
- - 20 MB and 10,000 x 50,000 px per image. Bigger images are rejected, their snapshots fail and `upload` exits 1.
75
- - 512 characters per snapshot name, 4 KB of metadata per snapshot.
76
- - 2,000 builds and 20 GB of uploads per account per day, 600 requests per minute per token.
77
-
78
- When an account passes 80% of its storage, the CLI prints a warning. After 14 days over the limit, new images are not stored and the check passes with a note, so CI keeps passing.
32
+ On other CI, set `STATEOFPIXEL_TOKEN` to a project token from the project settings on stateofpixel.com.
79
33
 
80
34
  Requires Node 20 or newer.
package/dist/index.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
- import { _ as readPngSize, a as defaultNonce, c as resolveToken, d as createApiClient, f as isRateLimited, g as collectSnapshots, h as createDiffEngine, i as waitForFinalize, l as ApiError, m as formatCounts, n as uploadCommand, o as readCiInfo, p as isServerError, r as metadataFile, s as readGitInfo, t as parseShard, u as DEFAULT_API_URL, v as sha256, y as mapConcurrent } from "./upload-DKzFVTAz.mjs";
3
- import { Command, InvalidArgumentError } from "commander";
2
+ import { _ as createDiffEngine, a as COMMANDS, b as sha256, c as readCiInfo, d as ApiError, f as DEFAULT_API_URL, g as formatCounts, h as isServerError, i as waitForFinalize, l as readGitInfo, m as isRateLimited, n as uploadCommand, o as ENV, p as createApiClient, r as metadataFile, s as defaultNonce, t as parseShard, u as resolveToken, v as collectSnapshots, x as mapConcurrent, y as readPngSize } from "./upload-CmJjvPgD.mjs";
3
+ import { Command, InvalidArgumentError, Option } from "commander";
4
4
  import { copyFile, mkdir, mkdtemp, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
5
5
  import path from "node:path";
6
6
  import { availableParallelism, tmpdir } from "node:os";
@@ -8,7 +8,7 @@ import { createReadStream } from "node:fs";
8
8
  import { createServer } from "node:http";
9
9
 
10
10
  //#region package.json
11
- var version = "1.3.0";
11
+ var version = "1.4.0";
12
12
 
13
13
  //#endregion
14
14
  //#region src/compare.ts
@@ -503,10 +503,10 @@ function countByStatus(statuses) {
503
503
  //#region src/commands/finalize.ts
504
504
  async function finalizeCommand(options) {
505
505
  const env = process.env;
506
- const buildName = options.buildName ?? env.STATEOFPIXEL_BUILD_NAME ?? "default";
507
- const nonce = options.nonce ?? env.STATEOFPIXEL_NONCE ?? defaultNonce(env);
506
+ const buildName = options.buildName ?? env[ENV.buildName] ?? "default";
507
+ const nonce = options.nonce ?? env[ENV.nonce] ?? defaultNonce(env);
508
508
  if (nonce === null) throw new Error("Set --nonce to the nonce the shards used.");
509
- const git = options.skipIfEmpty ? await readGitInfo(env, process.cwd(), options.baselineBranch ?? env.STATEOFPIXEL_BASELINE_BRANCH) : void 0;
509
+ const git = options.skipIfEmpty ? await readGitInfo(env, process.cwd(), options.baselineBranch ?? env[ENV.baselineBranch]) : void 0;
510
510
  const api = createApiClient({
511
511
  baseUrl: env.STATEOFPIXEL_API_URL ?? "https://graceful-dogfish-423.convex.site/api/v1",
512
512
  token: await resolveToken(env)
@@ -694,11 +694,31 @@ function parseDelay(value) {
694
694
 
695
695
  //#endregion
696
696
  //#region src/index.ts
697
+ const PARSERS = {
698
+ "--threshold <number>": parseThreshold,
699
+ "--shard <i/n>": parseShard,
700
+ "--viewports <widths>": parseViewports,
701
+ "--delay <ms>": parseDelay
702
+ };
703
+ const ACTIONS = {
704
+ compare: compareCommand,
705
+ upload: uploadCommand,
706
+ storybook: storybookCommand,
707
+ finalize: finalizeCommand
708
+ };
697
709
  const program = new Command().name("stateofpixel").description("Visual regression testing that runs in your CI").version(version);
698
- program.command("compare").description("Compare a folder of screenshots against a baseline folder").argument("<dir>", "folder with new screenshots").argument("<baseline-dir>", "folder with baseline screenshots").option("--out <dir>", "report folder", "stateofpixel-report").option("--threshold <number>", "color difference threshold, 0 to 1", parseThreshold, .1).option("--include-aa", "count anti-aliased pixels as changes", false).action(compareCommand);
699
- program.command("upload").description("Upload a folder of screenshots and compare it with the baseline").argument("<dir>", "folder with screenshots").option("--build-name <name>", "separate builds of one project, like storybook").option("--shard <i/n>", "this shard and the shard count, or auto with a finalize step", parseShard).option("--nonce <id>", "shared by every shard of one build").option("--baseline-branch <branch>", "branch to compare against").option("--subset", "only some snapshots ran, do not mark others removed", false).option("--threshold <number>", "color difference threshold, 0 to 1, overrides project settings", parseThreshold).option("--strict", "fail when the service is not reachable", false).option("--dry-run", "hash and print the plan, upload nothing", false).action(uploadCommand);
700
- program.command("storybook").description("Capture every story of a built Storybook, then upload").argument("<static-dir>", "the output of storybook build").option("--viewports <widths>", "comma separated viewport widths", parseViewports, [1280]).option("--include <glob>", "only stories whose title/name match").option("--exclude <glob>", "skip stories whose title/name match").option("--wait-for-selector <selector>", "wait for this before each screenshot", "#storybook-root > *").option("--delay <ms>", "wait this long before each screenshot", parseDelay, 0).option("--build-name <name>", "separate builds of one project, like storybook").option("--shard <i/n>", "this shard and the shard count, or auto with a finalize step", parseShard).option("--nonce <id>", "shared by every shard of one build").option("--baseline-branch <branch>", "branch to compare against").option("--subset", "only some snapshots ran, do not mark others removed", false).option("--threshold <number>", "color difference threshold, 0 to 1, overrides project settings", parseThreshold).option("--strict", "fail when the service is not reachable", false).option("--dry-run", "capture and print the plan, upload nothing", false).action(storybookCommand);
701
- program.command("finalize").description("Finish a build whose shards ran with --shard auto").option("--build-name <name>", "the build name the shards used").option("--nonce <id>", "the nonce the shards used").option("--baseline-branch <branch>", "branch to compare against, for --skip-if-empty").option("--skip-if-empty", "create a build with no changes when no shard ran", false).option("--strict", "fail when the service is not reachable", false).action(finalizeCommand);
710
+ for (const spec of COMMANDS) {
711
+ const command = program.command(spec.name).description(spec.description);
712
+ for (const argument of spec.arguments) command.argument(argument.name, argument.description);
713
+ for (const option of spec.options) {
714
+ const commanderOption = new Option(option.flags, option.description);
715
+ const parse = PARSERS[option.flags];
716
+ if (parse !== void 0) commanderOption.argParser(parse);
717
+ if (option.default !== void 0) commanderOption.default(option.default);
718
+ command.addOption(commanderOption);
719
+ }
720
+ command.action(ACTIONS[spec.name]);
721
+ }
702
722
  try {
703
723
  await program.parseAsync();
704
724
  } catch (error) {
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["packageJson.version"],"sources":["../package.json","../src/compare.ts","../src/report/template.ts","../src/report/write-report.ts","../src/commands/compare.ts","../src/commands/finalize.ts","../src/commands/storybook.ts","../src/index.ts"],"sourcesContent":["","import { copyFile, mkdir, readFile, rename, rm } from \"node:fs/promises\";\nimport { availableParallelism } from \"node:os\";\nimport path from \"node:path\";\nimport type { DiffEngine, DiffOptions } from \"./diff/engine\";\nimport { mapConcurrent } from \"./map-concurrent\";\nimport { readPngSize, sha256 } from \"./png\";\nimport { collectSnapshots } from \"./snapshots\";\n\nexport type SnapshotStatus = \"unchanged\" | \"changed\" | \"added\" | \"removed\";\n\nexport type ImageRef = {\n file: string;\n width: number;\n height: number;\n};\n\nexport type SnapshotResult = {\n name: string;\n status: SnapshotStatus;\n image?: ImageRef;\n baselineImage?: ImageRef;\n diffImage?: ImageRef;\n diffPixels?: number;\n diffRatio?: number;\n};\n\ntype CompareDirectoriesInput = {\n dir: string;\n baselineDir: string;\n outDir: string;\n engine: DiffEngine;\n options: DiffOptions;\n};\n\nexport async function compareDirectories({\n dir,\n baselineDir,\n outDir,\n engine,\n options,\n}: CompareDirectoriesInput): Promise<SnapshotResult[]> {\n const [snapshots, baselines] = await Promise.all([\n collectSnapshots(dir),\n collectSnapshots(baselineDir),\n ]);\n const imagesDir = path.join(outDir, \"images\");\n const workDir = path.join(outDir, \".work\");\n await mkdir(imagesDir, { recursive: true });\n await mkdir(workDir, { recursive: true });\n\n const names = [...new Set([...snapshots.keys(), ...baselines.keys()])].sort(\n (a, b) => (a < b ? -1 : a > b ? 1 : 0),\n );\n\n const results = await mapConcurrent(\n names,\n availableParallelism(),\n async (name, index): Promise<SnapshotResult> => {\n const filePath = snapshots.get(name);\n const baselinePath = baselines.get(name);\n\n if (!filePath && baselinePath) {\n return {\n name,\n status: \"removed\",\n baselineImage: await storeImage(baselinePath, imagesDir),\n };\n }\n if (!filePath) {\n throw new Error(`Snapshot ${name} has no file`);\n }\n\n const image = await storeImage(filePath, imagesDir);\n if (!baselinePath) {\n return { name, status: \"added\", image };\n }\n\n const baselineImage = await storeImage(baselinePath, imagesDir);\n if (image.file === baselineImage.file) {\n return { name, status: \"unchanged\", image, baselineImage };\n }\n\n const workPath = path.join(workDir, `${index}.png`);\n const { diffPixels, diffRatio } = await engine.diff(\n baselinePath,\n filePath,\n workPath,\n options,\n );\n if (diffPixels === 0) {\n await rm(workPath, { force: true });\n return { name, status: \"unchanged\", image, baselineImage };\n }\n\n return {\n name,\n status: \"changed\",\n image,\n baselineImage,\n diffImage: await storeImage(workPath, imagesDir, { move: true }),\n diffPixels,\n diffRatio,\n };\n },\n );\n\n await rm(workDir, { recursive: true, force: true });\n return results;\n}\n\nasync function storeImage(\n filePath: string,\n imagesDir: string,\n { move = false } = {},\n): Promise<ImageRef> {\n const bytes = await readFile(filePath);\n const file = `images/${sha256(bytes)}.png`;\n const target = path.join(imagesDir, path.basename(file));\n if (move) {\n await rename(filePath, target);\n } else {\n await copyFile(filePath, target);\n }\n return { file, ...readPngSize(bytes) };\n}\n","import type { SnapshotResult } from \"../compare\";\nimport type { ReportMeta } from \"./write-report\";\n\nexport function renderReport(\n snapshots: SnapshotResult[],\n meta: ReportMeta,\n): string {\n const data = JSON.stringify({ meta, snapshots }).replace(/</g, \"\\\\u003c\");\n\n return `<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>stateofpixel report</title>\n<style>${STYLES}</style>\n</head>\n<body>\n<header class=\"header\">\n <div class=\"title\"><strong>stateofpixel</strong> <span class=\"muted mono\" id=\"dirs\"></span></div>\n <div class=\"counts\" id=\"counts\"></div>\n</header>\n<div class=\"layout\">\n <aside class=\"sidebar\">\n <input class=\"filter\" id=\"filter\" type=\"search\" placeholder=\"Filter snapshots\" aria-label=\"Filter snapshots\">\n <div id=\"list\" role=\"listbox\" aria-label=\"Snapshots\"></div>\n </aside>\n <main class=\"viewer\" id=\"viewer\"></main>\n</div>\n<script id=\"data\" type=\"application/json\">${data}</script>\n<script>${SCRIPT}</script>\n</body>\n</html>\n`;\n}\n\nconst STYLES = `\n:root {\n color-scheme: light dark;\n --bg: #fafafa; --surface: #ffffff; --surface-2: #f2f2f2; --hover: #ebebeb; --border: #ebebeb;\n --text: #171717; --muted: #666666; --accent: #171717; --accent-fg: #ffffff; --link: #0068d6;\n --unchanged: #666666; --unchanged-bg: #f2f2f2; --changed: #a35200; --changed-bg: #fff6e6;\n --added: #0068d6; --added-bg: #f0f7ff; --removed: #7820bc; --removed-bg: #f9f0ff;\n --canvas: #f2f2f2; --checker-a: #ffffff; --checker-b: #e6e6e6;\n --sans: \"IBM Plex Sans Variable\", \"IBM Plex Sans\", ui-sans-serif, system-ui, sans-serif;\n --mono: \"Lilex Variable\", \"Lilex\", ui-monospace, \"SF Mono\", monospace;\n}\n@media (prefers-color-scheme: dark) {\n :root {\n --bg: #000000; --surface: #0a0a0a; --surface-2: #1a1a1a; --hover: #1f1f1f; --border: #2e2e2e;\n --text: #ededed; --muted: #a1a1a1; --accent: #ededed; --accent-fg: #0a0a0a; --link: #52a8ff;\n --unchanged: #a1a1a1; --unchanged-bg: #1a1a1a; --changed: #f2a20d; --changed-bg: #291800;\n --added: #52a8ff; --added-bg: #0f1c2e; --removed: #bf7af0; --removed-bg: #231528;\n --canvas: #000000; --checker-a: #1a1a1a; --checker-b: #292929;\n }\n}\n* { box-sizing: border-box; }\nhtml, body { height: 100%; margin: 0; }\nbody { display: flex; flex-direction: column; background: var(--bg); color: var(--text); font: 400 13px/20px var(--sans); -webkit-font-smoothing: antialiased; }\n:focus-visible { outline: 2px solid var(--link); outline-offset: 2px; }\n.muted { color: var(--muted); }\n.mono { font-family: var(--mono); }\n.num { font-variant-numeric: tabular-nums; }\n.header { display: flex; flex-wrap: wrap; gap: 8px 16px; align-items: center; justify-content: space-between; padding: 12px 16px; background: var(--surface); border-bottom: 1px solid var(--border); }\n.title strong { font-size: 14px; font-weight: 600; }\n.counts { display: flex; flex-wrap: wrap; gap: 6px; }\n.pill { display: inline-flex; align-items: center; gap: 4px; height: 20px; padding: 0 6px; border-radius: 5px; font-size: 11px; font-weight: 500; font-variant-numeric: tabular-nums; white-space: nowrap; }\n.pill[data-status=unchanged] { color: var(--unchanged); background: var(--unchanged-bg); }\n.pill[data-status=changed] { color: var(--changed); background: var(--changed-bg); }\n.pill[data-status=added] { color: var(--added); background: var(--added-bg); }\n.pill[data-status=removed] { color: var(--removed); background: var(--removed-bg); }\n.layout { flex: 1; display: flex; min-height: 0; }\n.sidebar { width: 300px; flex-shrink: 0; display: flex; flex-direction: column; background: var(--surface); border-right: 1px solid var(--border); }\n.filter { margin: 8px; height: 28px; padding: 0 10px; border: 0; border-radius: 8px; background: var(--surface); color: var(--text); font: inherit; box-shadow: inset 0 0 0 1px #8f8f8f; }\n#list { flex: 1; overflow-y: auto; padding: 0 8px 8px; }\n.group { display: flex; align-items: center; gap: 6px; width: 100%; height: 28px; padding: 0 8px; border: 0; background: none; color: var(--muted); font: 500 12px/16px var(--sans); cursor: pointer; text-align: left; }\n.row { display: flex; align-items: center; gap: 8px; width: 100%; height: 32px; padding: 0 8px; border: 0; border-radius: 7px; background: none; color: var(--text); font: 13px/20px var(--mono); text-align: left; cursor: pointer; position: relative; }\n.row:hover { background: var(--hover); }\n.row[aria-selected=true] { background: var(--hover); }\n.row[aria-selected=true]::before { content: \"\"; position: absolute; left: 0; top: 6px; bottom: 6px; width: 2px; border-radius: 2px; background: var(--link); }\n.row .name { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.row .ratio { color: var(--muted); font: 12px/16px var(--sans); font-variant-numeric: tabular-nums; }\n.viewer { flex: 1; min-width: 0; display: flex; flex-direction: column; background: var(--surface); }\n.viewer-title { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; min-height: 48px; padding: 8px 16px; border-bottom: 1px solid var(--border); }\n.viewer-title .name { font: 500 14px/20px var(--mono); }\n.viewer-title .dims { margin-left: auto; }\n.toolbar { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 8px; padding: 6px 16px; border-bottom: 1px solid var(--border); }\n.segmented { display: inline-flex; padding: 2px; border-radius: 11px; background: var(--surface-2); }\n.segmented button { height: 28px; padding: 0 10px; border: 1px solid transparent; border-radius: 7px; background: none; color: var(--muted); font: 500 13px/20px var(--sans); cursor: pointer; }\n.segmented button[aria-pressed=true] { background: var(--surface); color: var(--text); border-color: var(--border); }\n.segmented button:disabled { opacity: .45; cursor: default; }\nkbd { display: inline-flex; align-items: center; justify-content: center; min-width: 16px; height: 16px; margin-left: 6px; padding: 0 4px; border: 1px solid var(--border); border-radius: 5px; background: var(--surface); color: var(--muted); font: 500 11px/16px var(--mono); }\n.stage { flex: 1; overflow: auto; padding: 16px; background: var(--canvas); }\n.pair { display: flex; gap: 16px; align-items: flex-start; }\n.pair > figure { flex: 1; min-width: 0; }\nfigure { margin: 0; }\nfigcaption { height: 24px; color: var(--muted); font-size: 12px; }\n.frame { position: relative; background-color: var(--checker-a); background-image: conic-gradient(var(--checker-b) 25%, transparent 0 50%, var(--checker-b) 0 75%, transparent 0); background-size: 16px 16px; }\n.frame img { position: absolute; top: 0; left: 0; display: block; }\n.zoom-actual .frame img { image-rendering: pixelated; }\n.frame[data-flip=baseline] { outline: 1px solid var(--link); }\n.diff-layer { opacity: .7; }\n.slider { display: block; width: 100%; margin: 12px 0 0; accent-color: var(--link); }\n.handle { position: absolute; top: 0; bottom: 0; width: 2px; margin-left: -1px; background: var(--link); pointer-events: none; }\n.empty { padding: 24px; color: var(--muted); font-size: 24px; line-height: 34px; }\n.empty strong { color: var(--text); font-weight: 600; }\n@media (max-width: 767px) {\n .layout { flex-direction: column; }\n .sidebar { width: auto; max-height: 40vh; border-right: 0; border-bottom: 1px solid var(--border); }\n .pair { flex-direction: column; }\n .pair > figure { width: 100%; }\n}\n`;\n\nconst SCRIPT = `\nconst { meta, snapshots } = JSON.parse(document.getElementById(\"data\").textContent);\nconst GROUPS = [\"changed\", \"added\", \"removed\", \"unchanged\"];\nconst MODES = [[\"side\", \"Side by side\"], [\"diff\", \"Diff\"], [\"slider\", \"Slider\"], [\"flip\", \"Flip\"]];\nconst store = {\n get(key, fallback) { try { return localStorage.getItem(\"stateofpixel:\" + key) || fallback; } catch { return fallback; } },\n set(key, value) { try { localStorage.setItem(\"stateofpixel:\" + key, value); } catch {} },\n};\nconst state = {\n filter: \"\",\n collapsed: new Set([\"unchanged\"]),\n selected: null,\n mode: store.get(\"mode\", \"side\"),\n zoom: store.get(\"zoom\", \"fit\"),\n flip: \"new\",\n slider: 50,\n};\n\nfunction el(tag, props, children) {\n const node = document.createElement(tag);\n Object.assign(node, props || {});\n for (const child of children || []) node.append(child);\n return node;\n}\n\nfunction pill(status, label) {\n const node = el(\"span\", { className: \"pill\", textContent: label });\n node.dataset.status = status;\n return node;\n}\n\nfunction percent(ratio) {\n return (ratio * 100).toFixed(ratio < 0.001 ? 3 : 2) + \"%\";\n}\n\nfunction visibleGroups() {\n const query = state.filter.toLowerCase();\n return GROUPS.map((status) => ({\n status,\n items: snapshots.filter((s) => s.status === status && s.name.toLowerCase().includes(query)),\n })).filter((group) => group.items.length > 0);\n}\n\nfunction navigable() {\n return visibleGroups().flatMap((group) => (state.collapsed.has(group.status) ? [] : group.items));\n}\n\nfunction renderHeader() {\n document.getElementById(\"dirs\").textContent = meta.dir + \" vs \" + meta.baselineDir;\n const counts = document.getElementById(\"counts\");\n counts.replaceChildren(\n ...GROUPS.map((status) => {\n const count = snapshots.filter((s) => s.status === status).length;\n return pill(status, count.toLocaleString() + \" \" + status);\n }),\n );\n}\n\nfunction renderList() {\n const list = document.getElementById(\"list\");\n list.replaceChildren(\n ...visibleGroups().flatMap((group) => {\n const collapsed = state.collapsed.has(group.status);\n const header = el(\"button\", {\n className: \"group\",\n textContent: (collapsed ? \"+ \" : \"- \") + group.status[0].toUpperCase() + group.status.slice(1) + \" (\" + group.items.length.toLocaleString() + \")\",\n onclick: () => {\n if (collapsed) state.collapsed.delete(group.status);\n else state.collapsed.add(group.status);\n renderList();\n },\n });\n header.setAttribute(\"aria-expanded\", String(!collapsed));\n if (collapsed) return [header];\n return [\n header,\n ...group.items.map((snapshot) => {\n const row = el(\"button\", { className: \"row\", title: snapshot.name, onclick: () => select(snapshot) }, [\n el(\"span\", { className: \"name\", textContent: snapshot.name }),\n ]);\n row.setAttribute(\"role\", \"option\");\n row.setAttribute(\"aria-selected\", String(snapshot === state.selected));\n if (snapshot.diffRatio !== undefined) row.append(el(\"span\", { className: \"ratio\", textContent: percent(snapshot.diffRatio) }));\n return row;\n }),\n ];\n }),\n );\n list.querySelector(\"[aria-selected=true]\")?.scrollIntoView({ block: \"nearest\" });\n}\n\nfunction frame(images, width, height) {\n const node = el(\"div\", { className: \"frame\" });\n if (state.zoom === \"fit\") {\n node.style.width = \"100%\";\n node.style.maxWidth = width + \"px\";\n node.style.aspectRatio = width + \" / \" + height;\n } else {\n node.style.width = width + \"px\";\n node.style.height = height + \"px\";\n }\n for (const { image, className, style } of images) {\n const img = el(\"img\", { src: image.file, alt: \"\", className: className || \"\" });\n img.style.width = (image.width / width) * 100 + \"%\";\n Object.assign(img.style, style || {});\n node.append(img);\n }\n return node;\n}\n\nfunction figure(caption, image) {\n return el(\"figure\", {}, [el(\"figcaption\", { textContent: caption }), frame([{ image }], image.width, image.height)]);\n}\n\nfunction renderStage(snapshot) {\n const { image, baselineImage, diffImage } = snapshot;\n if (!image || !baselineImage) {\n const only = image || baselineImage;\n return [figure(image ? \"New\" : \"Baseline\", only)];\n }\n const width = Math.max(image.width, baselineImage.width);\n const height = Math.max(image.height, baselineImage.height);\n if (state.mode === \"side\") {\n return [el(\"div\", { className: \"pair\" }, [figure(\"Baseline\", baselineImage), figure(\"New\", image)])];\n }\n if (state.mode === \"diff\") {\n const layers = [{ image }];\n if (diffImage) layers.push({ image: diffImage, className: \"diff-layer\" });\n return [el(\"figure\", {}, [el(\"figcaption\", { textContent: \"New with diff overlay\" }), frame(layers, width, height)])];\n }\n if (state.mode === \"slider\") {\n const clipFor = (value) => \"inset(0 \" + (100 - value) + \"% 0 0)\";\n const stageNode = frame([{ image }, { image: baselineImage, style: { clipPath: clipFor(state.slider) } }], width, height);\n const handle = el(\"div\", { className: \"handle\" });\n handle.style.left = state.slider + \"%\";\n stageNode.append(handle);\n const slider = el(\"input\", {\n className: \"slider\",\n type: \"range\",\n min: 0,\n max: 100,\n value: state.slider,\n oninput: (event) => {\n state.slider = Number(event.target.value);\n stageNode.querySelectorAll(\"img\")[1].style.clipPath = clipFor(state.slider);\n handle.style.left = state.slider + \"%\";\n },\n });\n slider.setAttribute(\"aria-label\", \"Baseline to new\");\n const node = el(\"figure\", {}, [el(\"figcaption\", { textContent: \"Baseline on the left of the handle, new on the right\" }), stageNode, slider]);\n node.style[state.zoom === \"fit\" ? \"maxWidth\" : \"width\"] = width + \"px\";\n return [node];\n }\n const showing = state.flip === \"baseline\" ? baselineImage : image;\n const node = frame([{ image: showing }], width, height);\n node.dataset.flip = state.flip;\n return [el(\"figure\", {}, [el(\"figcaption\", { textContent: \"Showing \" + state.flip + \". Press space to flip.\" }), node])];\n}\n\nfunction renderViewer() {\n const viewer = document.getElementById(\"viewer\");\n const snapshot = state.selected;\n if (!snapshot) {\n const empty = el(\"p\", { className: \"empty\" }, [el(\"strong\", { textContent: \"No visual changes.\" }), \" Every snapshot matches its baseline.\"]);\n viewer.replaceChildren(empty);\n return;\n }\n const comparable = Boolean(snapshot.image && snapshot.baselineImage);\n const title = el(\"div\", { className: \"viewer-title\" }, [\n el(\"span\", { className: \"name\", textContent: snapshot.name }),\n pill(snapshot.status, snapshot.status),\n ]);\n if (snapshot.diffPixels !== undefined) {\n title.append(el(\"span\", { className: \"muted num\", textContent: percent(snapshot.diffRatio) + \" diff, \" + snapshot.diffPixels.toLocaleString() + \" px\" }));\n }\n const dims = [snapshot.baselineImage, snapshot.image].filter(Boolean).map((i) => i.width + \"x\" + i.height);\n title.append(el(\"span\", { className: \"dims muted num\", textContent: [...new Set(dims)].join(\" to \") }));\n\n const modes = el(\"div\", { className: \"segmented\" }, MODES.map(([mode, label], index) => {\n const button = el(\"button\", { disabled: !comparable, onclick: () => setMode(mode) }, [label, el(\"kbd\", { textContent: String(index + 1) })]);\n button.setAttribute(\"aria-pressed\", String(comparable && state.mode === mode));\n return button;\n }));\n const zoom = el(\"div\", { className: \"segmented\" }, [[\"fit\", \"Fit\", \"f\"], [\"actual\", \"100%\", \"0\"]].map(([value, label, key]) => {\n const button = el(\"button\", { onclick: () => setZoom(value) }, [label, el(\"kbd\", { textContent: key })]);\n button.setAttribute(\"aria-pressed\", String(state.zoom === value));\n return button;\n }));\n const stage = el(\"div\", { className: \"stage zoom-\" + state.zoom }, renderStage(snapshot));\n viewer.replaceChildren(title, el(\"div\", { className: \"toolbar\" }, [modes, zoom]), stage);\n}\n\nfunction select(snapshot) {\n state.selected = snapshot;\n state.flip = \"new\";\n renderList();\n renderViewer();\n}\n\nfunction setMode(mode) {\n state.mode = mode;\n store.set(\"mode\", mode);\n renderViewer();\n}\n\nfunction setZoom(zoom) {\n state.zoom = zoom;\n store.set(\"zoom\", zoom);\n renderViewer();\n}\n\nfunction move(step) {\n const items = navigable();\n if (items.length === 0) return;\n const index = items.indexOf(state.selected);\n const next = index === -1 ? 0 : Math.min(items.length - 1, Math.max(0, index + step));\n select(items[next]);\n}\n\nconst filter = document.getElementById(\"filter\");\nfilter.addEventListener(\"input\", () => {\n state.filter = filter.value;\n renderList();\n});\n\ndocument.addEventListener(\"keydown\", (event) => {\n if (event.target === filter) {\n if (event.key === \"Escape\") filter.blur();\n return;\n }\n if (event.metaKey || event.ctrlKey || event.altKey) return;\n const modeIndex = [\"1\", \"2\", \"3\", \"4\"].indexOf(event.key);\n if (event.key === \"j\") move(1);\n else if (event.key === \"k\") move(-1);\n else if (modeIndex !== -1) setMode(MODES[modeIndex][0]);\n else if (event.key === \"f\") setZoom(\"fit\");\n else if (event.key === \"0\") setZoom(\"actual\");\n else if (event.key === \"/\") { event.preventDefault(); filter.focus(); }\n else if (event.key === \" \" && state.mode === \"flip\") {\n event.preventDefault();\n state.flip = state.flip === \"new\" ? \"baseline\" : \"new\";\n renderViewer();\n }\n});\n\nrenderHeader();\nconst first = navigable().find((s) => s.status !== \"unchanged\");\nif (first) select(first);\nelse { renderList(); renderViewer(); }\n`;\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { SnapshotResult } from \"../compare\";\nimport { renderReport } from \"./template\";\n\nexport type ReportMeta = {\n dir: string;\n baselineDir: string;\n engine: string;\n createdAt: string;\n};\n\nexport async function writeReport(\n outDir: string,\n results: SnapshotResult[],\n meta: ReportMeta,\n): Promise<string> {\n await mkdir(outDir, { recursive: true });\n const reportPath = path.join(outDir, \"index.html\");\n await writeFile(reportPath, renderReport(results, meta));\n return reportPath;\n}\n","import { stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport { compareDirectories, type SnapshotStatus } from \"../compare\";\nimport { createDiffEngine } from \"../diff/engine\";\nimport { formatCounts } from \"../format\";\nimport { writeReport } from \"../report/write-report\";\n\nexport type CompareCommandOptions = {\n out: string;\n threshold: number;\n includeAa: boolean;\n};\n\nexport async function compareCommand(\n dir: string,\n baselineDir: string,\n options: CompareCommandOptions,\n): Promise<void> {\n await assertDirectory(dir);\n await assertDirectory(baselineDir);\n\n const startedAt = performance.now();\n const engine = await createDiffEngine();\n const results = await compareDirectories({\n dir,\n baselineDir,\n outDir: options.out,\n engine,\n options: { threshold: options.threshold, includeAA: options.includeAa },\n });\n const reportPath = await writeReport(options.out, results, {\n dir,\n baselineDir,\n engine: engine.name,\n createdAt: new Date().toISOString(),\n });\n\n const counts = countByStatus(results.map((result) => result.status));\n const seconds = ((performance.now() - startedAt) / 1000).toFixed(1);\n console.log(`stateofpixel compare ${dir} vs ${baselineDir}`);\n console.log(formatCounts(results.length, counts));\n console.log(` compared with ${engine.name} in ${seconds} s`);\n console.log(` report: ${path.relative(process.cwd(), reportPath)}`);\n}\n\nexport function parseThreshold(value: string): number {\n const threshold = Number(value);\n if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {\n throw new InvalidArgumentError(\"Must be a number from 0 to 1.\");\n }\n return threshold;\n}\n\nasync function assertDirectory(dir: string): Promise<void> {\n const stats = await stat(dir).catch(() => undefined);\n if (!stats?.isDirectory()) {\n throw new Error(`Not a directory: ${dir}`);\n }\n}\n\nfunction countByStatus(\n statuses: SnapshotStatus[],\n): Record<SnapshotStatus, number> {\n const counts = { unchanged: 0, changed: 0, added: 0, removed: 0 };\n for (const status of statuses) {\n counts[status]++;\n }\n return counts;\n}\n","import {\n ApiError,\n createApiClient,\n DEFAULT_API_URL,\n isRateLimited,\n isServerError,\n} from \"../api\";\nimport { defaultNonce, readCiInfo, readGitInfo, resolveToken } from \"../ci-env\";\nimport { formatCounts } from \"../format\";\nimport { waitForFinalize } from \"../upload\";\n\nexport type FinalizeCommandOptions = {\n buildName?: string;\n nonce?: string;\n baselineBranch?: string;\n skipIfEmpty: boolean;\n strict: boolean;\n};\n\nexport async function finalizeCommand(\n options: FinalizeCommandOptions,\n): Promise<void> {\n const env = process.env;\n const buildName =\n options.buildName ?? env.STATEOFPIXEL_BUILD_NAME ?? \"default\";\n const nonce = options.nonce ?? env.STATEOFPIXEL_NONCE ?? defaultNonce(env);\n if (nonce === null) {\n throw new Error(\"Set --nonce to the nonce the shards used.\");\n }\n const git = options.skipIfEmpty\n ? await readGitInfo(\n env,\n process.cwd(),\n options.baselineBranch ?? env.STATEOFPIXEL_BASELINE_BRANCH,\n )\n : undefined;\n\n const api = createApiClient({\n baseUrl: env.STATEOFPIXEL_API_URL ?? DEFAULT_API_URL,\n token: await resolveToken(env),\n });\n let build: { buildId: string; buildNumber: number; url: string };\n let final: Awaited<ReturnType<typeof waitForFinalize>>;\n try {\n build = await api.request(\"POST\", \"/builds/finalize\", {\n buildName,\n nonce,\n skipIfEmpty: options.skipIfEmpty,\n git,\n ci: readCiInfo(env),\n });\n final = await waitForFinalize(api, build.buildId, true);\n } catch (error) {\n if (isRateLimited(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, ${error.message} Use --strict to fail instead.`,\n );\n return;\n }\n if (isServerError(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, the service is not reachable (${error instanceof Error ? error.message : error}). Use --strict to fail instead.`,\n );\n return;\n }\n if (error instanceof ApiError) {\n throw new Error(`${error.message} (${error.code})`);\n }\n throw error;\n }\n\n if (final === null) {\n console.log(`stateofpixel build #${build.buildNumber} finalizing`);\n } else {\n const { counts, shards } = final;\n console.log(\n `stateofpixel build #${build.buildNumber} finalized, ${shards.done} ${shards.done === 1 ? \"shard\" : \"shards\"}`,\n );\n console.log(\n formatCounts(\n counts.unchanged + counts.changed + counts.added + counts.failed,\n counts,\n ),\n );\n }\n console.log(` review: ${build.url}`);\n}\n","import { createReadStream } from \"node:fs\";\nimport {\n mkdir,\n mkdtemp,\n readFile,\n rm,\n stat,\n writeFile,\n} from \"node:fs/promises\";\nimport { createServer, type Server } from \"node:http\";\nimport type { AddressInfo } from \"node:net\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport { mapConcurrent } from \"../map-concurrent\";\nimport { metadataFile } from \"../upload\";\nimport { type UploadCommandOptions, uploadCommand } from \"./upload\";\n\nconst CAPTURE_CONCURRENCY = 4;\nconst STORY_TIMEOUT_MS = 15_000;\nconst VIEWPORT_HEIGHT = 720;\n\nconst CONTENT_TYPES: Record<string, string> = {\n \".html\": \"text/html\",\n \".js\": \"text/javascript\",\n \".mjs\": \"text/javascript\",\n \".css\": \"text/css\",\n \".json\": \"application/json\",\n \".svg\": \"image/svg+xml\",\n \".png\": \"image/png\",\n \".jpg\": \"image/jpeg\",\n \".gif\": \"image/gif\",\n \".webp\": \"image/webp\",\n \".woff\": \"font/woff\",\n \".woff2\": \"font/woff2\",\n \".ttf\": \"font/ttf\",\n};\n\nexport type StorybookCommandOptions = UploadCommandOptions & {\n viewports: number[];\n include?: string;\n exclude?: string;\n waitForSelector: string;\n delay: number;\n};\n\nexport type Story = {\n id: string;\n title: string;\n name: string;\n importPath?: string;\n};\n\nexport async function storybookCommand(\n staticDir: string,\n options: StorybookCommandOptions,\n): Promise<void> {\n const stories = filterStories(\n await readStories(staticDir),\n options.include,\n options.exclude,\n );\n if (stories.length === 0) {\n throw new Error(`No stories found in ${staticDir}/index.json.`);\n }\n const outDir = await mkdtemp(path.join(tmpdir(), \"stateofpixel-storybook-\"));\n try {\n const failed = await captureStories(staticDir, outDir, stories, options);\n if (failed.length > 0) {\n throw new Error(`Stories that did not render: ${failed.join(\", \")}`);\n }\n await uploadCommand(outDir, options);\n } finally {\n await rm(outDir, { recursive: true, force: true });\n }\n}\n\nasync function readStories(staticDir: string): Promise<Story[]> {\n const text = await readFile(path.join(staticDir, \"index.json\"), \"utf8\").catch(\n () => {\n throw new Error(\n `No index.json in ${staticDir}. Run storybook build first, Storybook 7 or newer.`,\n );\n },\n );\n const index = JSON.parse(text) as {\n entries?: Record<string, Story & { type?: string }>;\n };\n return Object.values(index.entries ?? {})\n .filter((entry) => entry.type === \"story\")\n .map(({ id, title, name, importPath }) => ({\n id,\n title,\n name,\n importPath,\n }));\n}\n\nexport function filterStories(\n stories: Story[],\n include: string | undefined,\n exclude: string | undefined,\n): Story[] {\n const includes = include === undefined ? null : globToRegExp(include);\n const excludes = exclude === undefined ? null : globToRegExp(exclude);\n return stories.filter((story) => {\n const name = `${story.title}/${story.name}`;\n return (\n (includes === null || includes.test(name)) &&\n (excludes === null || !excludes.test(name))\n );\n });\n}\n\nfunction globToRegExp(glob: string): RegExp {\n const source = glob\n .split(\"**\")\n .map((part) =>\n part\n .split(\"*\")\n .map((text) => text.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\"))\n .join(\"[^/]*\"),\n )\n .join(\".*\");\n return new RegExp(`^${source}$`);\n}\n\nexport function storySnapshotName(story: Story, width: number): string {\n return `${story.title}/${story.name} [chromium ${width}]`;\n}\n\nasync function captureStories(\n staticDir: string,\n outDir: string,\n stories: Story[],\n options: StorybookCommandOptions,\n): Promise<string[]> {\n const { chromium } = await import(\"playwright\").catch(() => {\n throw new Error(\n \"stateofpixel storybook needs Playwright. Run npm install -D playwright, then npx playwright install chromium.\",\n );\n });\n const server = await serveStatic(staticDir);\n const baseUrl = `http://127.0.0.1:${(server.address() as AddressInfo).port}`;\n const browser = await chromium.launch();\n const failed: string[] = [];\n try {\n for (const width of options.viewports) {\n const context = await browser.newContext({\n viewport: { width, height: VIEWPORT_HEIGHT },\n deviceScaleFactor: 1,\n reducedMotion: \"reduce\",\n });\n await mapConcurrent(stories, CAPTURE_CONCURRENCY, async (story) => {\n const name = storySnapshotName(story, width);\n const file = path.join(outDir, `${name}.png`);\n const page = await context.newPage();\n try {\n await page.goto(\n `${baseUrl}/iframe.html?id=${encodeURIComponent(story.id)}&viewMode=story`,\n { timeout: STORY_TIMEOUT_MS },\n );\n await page.waitForSelector(options.waitForSelector, {\n timeout: STORY_TIMEOUT_MS,\n });\n await page.evaluate(\"document.fonts.ready\");\n if (options.delay > 0) {\n await page.waitForTimeout(options.delay);\n }\n await mkdir(path.dirname(file), { recursive: true });\n await page.screenshot({\n path: file,\n fullPage: true,\n animations: \"disabled\",\n caret: \"hide\",\n });\n await writeFile(\n metadataFile(file),\n JSON.stringify({\n browser: \"chromium\",\n viewport: width,\n storyId: story.id,\n importPath: story.importPath,\n }),\n );\n } catch {\n failed.push(name);\n } finally {\n await page.close();\n }\n });\n await context.close();\n }\n } finally {\n await browser.close();\n server.close();\n }\n console.log(\n `stateofpixel captured ${stories.length * options.viewports.length - failed.length} screenshots from ${stories.length} stories`,\n );\n return failed;\n}\n\nasync function serveStatic(root: string): Promise<Server> {\n const base = path.resolve(root);\n const server = createServer((request, response) => {\n const pathname = decodeURIComponent(\n new URL(request.url ?? \"/\", \"http://localhost\").pathname,\n );\n const file = path.join(\n base,\n pathname.endsWith(\"/\") ? `${pathname}index.html` : pathname,\n );\n if (!file.startsWith(`${base}${path.sep}`)) {\n response.writeHead(403).end();\n return;\n }\n stat(file).then(\n (stats) => {\n if (!stats.isFile()) {\n response.writeHead(404).end();\n return;\n }\n response.writeHead(200, {\n \"Content-Type\":\n CONTENT_TYPES[path.extname(file).toLowerCase()] ??\n \"application/octet-stream\",\n });\n createReadStream(file).pipe(response);\n },\n () => response.writeHead(404).end(),\n );\n });\n await new Promise<void>((resolve) => server.listen(0, \"127.0.0.1\", resolve));\n return server;\n}\n\nexport function parseViewports(value: string): number[] {\n const widths = value.split(\",\").map((width) => Number(width.trim()));\n if (\n widths.length === 0 ||\n widths.some((width) => !Number.isInteger(width) || width < 1)\n ) {\n throw new InvalidArgumentError(\"Must look like 375,1280.\");\n }\n return widths;\n}\n\nexport function parseDelay(value: string): number {\n const delay = Number(value);\n if (!Number.isInteger(delay) || delay < 0) {\n throw new InvalidArgumentError(\"Must be a whole number of milliseconds.\");\n }\n return delay;\n}\n","#!/usr/bin/env node\nimport { Command } from \"commander\";\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport { compareCommand, parseThreshold } from \"./commands/compare\";\nimport { finalizeCommand } from \"./commands/finalize\";\nimport {\n parseDelay,\n parseViewports,\n storybookCommand,\n} from \"./commands/storybook\";\nimport { parseShard, uploadCommand } from \"./commands/upload\";\n\nconst program = new Command()\n .name(\"stateofpixel\")\n .description(\"Visual regression testing that runs in your CI\")\n .version(packageJson.version);\n\nprogram\n .command(\"compare\")\n .description(\"Compare a folder of screenshots against a baseline folder\")\n .argument(\"<dir>\", \"folder with new screenshots\")\n .argument(\"<baseline-dir>\", \"folder with baseline screenshots\")\n .option(\"--out <dir>\", \"report folder\", \"stateofpixel-report\")\n .option(\n \"--threshold <number>\",\n \"color difference threshold, 0 to 1\",\n parseThreshold,\n 0.1,\n )\n .option(\"--include-aa\", \"count anti-aliased pixels as changes\", false)\n .action(compareCommand);\n\nprogram\n .command(\"upload\")\n .description(\n \"Upload a folder of screenshots and compare it with the baseline\",\n )\n .argument(\"<dir>\", \"folder with screenshots\")\n .option(\n \"--build-name <name>\",\n \"separate builds of one project, like storybook\",\n )\n .option(\n \"--shard <i/n>\",\n \"this shard and the shard count, or auto with a finalize step\",\n parseShard,\n )\n .option(\"--nonce <id>\", \"shared by every shard of one build\")\n .option(\"--baseline-branch <branch>\", \"branch to compare against\")\n .option(\n \"--subset\",\n \"only some snapshots ran, do not mark others removed\",\n false,\n )\n .option(\n \"--threshold <number>\",\n \"color difference threshold, 0 to 1, overrides project settings\",\n parseThreshold,\n )\n .option(\"--strict\", \"fail when the service is not reachable\", false)\n .option(\"--dry-run\", \"hash and print the plan, upload nothing\", false)\n .action(uploadCommand);\n\nprogram\n .command(\"storybook\")\n .description(\"Capture every story of a built Storybook, then upload\")\n .argument(\"<static-dir>\", \"the output of storybook build\")\n .option(\n \"--viewports <widths>\",\n \"comma separated viewport widths\",\n parseViewports,\n [1280],\n )\n .option(\"--include <glob>\", \"only stories whose title/name match\")\n .option(\"--exclude <glob>\", \"skip stories whose title/name match\")\n .option(\n \"--wait-for-selector <selector>\",\n \"wait for this before each screenshot\",\n \"#storybook-root > *\",\n )\n .option(\n \"--delay <ms>\",\n \"wait this long before each screenshot\",\n parseDelay,\n 0,\n )\n .option(\n \"--build-name <name>\",\n \"separate builds of one project, like storybook\",\n )\n .option(\n \"--shard <i/n>\",\n \"this shard and the shard count, or auto with a finalize step\",\n parseShard,\n )\n .option(\"--nonce <id>\", \"shared by every shard of one build\")\n .option(\"--baseline-branch <branch>\", \"branch to compare against\")\n .option(\n \"--subset\",\n \"only some snapshots ran, do not mark others removed\",\n false,\n )\n .option(\n \"--threshold <number>\",\n \"color difference threshold, 0 to 1, overrides project settings\",\n parseThreshold,\n )\n .option(\"--strict\", \"fail when the service is not reachable\", false)\n .option(\"--dry-run\", \"capture and print the plan, upload nothing\", false)\n .action(storybookCommand);\n\nprogram\n .command(\"finalize\")\n .description(\"Finish a build whose shards ran with --shard auto\")\n .option(\"--build-name <name>\", \"the build name the shards used\")\n .option(\"--nonce <id>\", \"the nonce the shards used\")\n .option(\n \"--baseline-branch <branch>\",\n \"branch to compare against, for --skip-if-empty\",\n )\n .option(\n \"--skip-if-empty\",\n \"create a build with no changes when no shard ran\",\n false,\n )\n .option(\"--strict\", \"fail when the service is not reachable\", false)\n .action(finalizeCommand);\n\ntry {\n await program.parseAsync();\n} catch (error) {\n console.error(\n `stateofpixel: ${error instanceof Error ? error.message : error}`,\n );\n process.exitCode = 1;\n}\n"],"mappings":";;;;;;;;;;;;;;ACkCA,eAAsB,mBAAmB,EACvC,KACA,aACA,QACA,QACA,WACqD;CACrD,MAAM,CAAC,WAAW,aAAa,MAAM,QAAQ,IAAI,CAC/C,iBAAiB,GAAG,GACpB,iBAAiB,WAAW,CAC9B,CAAC;CACD,MAAM,YAAY,KAAK,KAAK,QAAQ,QAAQ;CAC5C,MAAM,UAAU,KAAK,KAAK,QAAQ,OAAO;CACzC,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;CAC1C,MAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;CAExC,MAAM,QAAQ,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,UAAU,KAAK,GAAG,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MACpE,GAAG,MAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CACtC;CAEA,MAAM,UAAU,MAAM,cACpB,OACA,qBAAqB,GACrB,OAAO,MAAM,UAAmC;EAC9C,MAAM,WAAW,UAAU,IAAI,IAAI;EACnC,MAAM,eAAe,UAAU,IAAI,IAAI;EAEvC,IAAI,CAAC,YAAY,cACf,OAAO;GACL;GACA,QAAQ;GACR,eAAe,MAAM,WAAW,cAAc,SAAS;EACzD;EAEF,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,YAAY,KAAK,aAAa;EAGhD,MAAM,QAAQ,MAAM,WAAW,UAAU,SAAS;EAClD,IAAI,CAAC,cACH,OAAO;GAAE;GAAM,QAAQ;GAAS;EAAM;EAGxC,MAAM,gBAAgB,MAAM,WAAW,cAAc,SAAS;EAC9D,IAAI,MAAM,SAAS,cAAc,MAC/B,OAAO;GAAE;GAAM,QAAQ;GAAa;GAAO;EAAc;EAG3D,MAAM,WAAW,KAAK,KAAK,SAAS,GAAG,MAAM,KAAK;EAClD,MAAM,EAAE,YAAY,cAAc,MAAM,OAAO,KAC7C,cACA,UACA,UACA,OACF;EACA,IAAI,eAAe,GAAG;GACpB,MAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;GAClC,OAAO;IAAE;IAAM,QAAQ;IAAa;IAAO;GAAc;EAC3D;EAEA,OAAO;GACL;GACA,QAAQ;GACR;GACA;GACA,WAAW,MAAM,WAAW,UAAU,WAAW,EAAE,MAAM,KAAK,CAAC;GAC/D;GACA;EACF;CACF,CACF;CAEA,MAAM,GAAG,SAAS;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CAClD,OAAO;AACT;AAEA,eAAe,WACb,UACA,WACA,EAAE,OAAO,UAAU,CAAC,GACD;CACnB,MAAM,QAAQ,MAAM,SAAS,QAAQ;CACrC,MAAM,OAAO,UAAU,OAAO,KAAK,EAAE;CACrC,MAAM,SAAS,KAAK,KAAK,WAAW,KAAK,SAAS,IAAI,CAAC;CACvD,IAAI,MACF,MAAM,OAAO,UAAU,MAAM;MAE7B,MAAM,SAAS,UAAU,MAAM;CAEjC,OAAO;EAAE;EAAM,GAAG,YAAY,KAAK;CAAE;AACvC;;;;ACzHA,SAAgB,aACd,WACA,MACQ;CACR,MAAM,OAAO,KAAK,UAAU;EAAE;EAAM;CAAU,CAAC,CAAC,CAAC,QAAQ,MAAM,SAAS;CAExE,OAAO;;;;;;SAMA,OAAO;;;;;;;;;;;;;;4CAc4B,KAAK;UACvC,OAAO;;;;AAIjB;AAEA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8Ef,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtGf,eAAsB,YACpB,QACA,SACA,MACiB;CACjB,MAAM,MAAM,QAAQ,EAAE,WAAW,KAAK,CAAC;CACvC,MAAM,aAAa,KAAK,KAAK,QAAQ,YAAY;CACjD,MAAM,UAAU,YAAY,aAAa,SAAS,IAAI,CAAC;CACvD,OAAO;AACT;;;;ACPA,eAAsB,eACpB,KACA,aACA,SACe;CACf,MAAM,gBAAgB,GAAG;CACzB,MAAM,gBAAgB,WAAW;CAEjC,MAAM,YAAY,YAAY,IAAI;CAClC,MAAM,SAAS,MAAM,iBAAiB;CACtC,MAAM,UAAU,MAAM,mBAAmB;EACvC;EACA;EACA,QAAQ,QAAQ;EAChB;EACA,SAAS;GAAE,WAAW,QAAQ;GAAW,WAAW,QAAQ;EAAU;CACxE,CAAC;CACD,MAAM,aAAa,MAAM,YAAY,QAAQ,KAAK,SAAS;EACzD;EACA;EACA,QAAQ,OAAO;EACf,4BAAW,IAAI,KAAK,EAAC,CAAC,YAAY;CACpC,CAAC;CAED,MAAM,SAAS,cAAc,QAAQ,KAAK,WAAW,OAAO,MAAM,CAAC;CACnE,MAAM,YAAY,YAAY,IAAI,IAAI,aAAa,IAAI,CAAE,QAAQ,CAAC;CAClE,QAAQ,IAAI,0BAA0B,IAAI,MAAM,aAAa;CAC7D,QAAQ,IAAI,aAAa,QAAQ,QAAQ,MAAM,CAAC;CAChD,QAAQ,IAAI,mBAAmB,OAAO,KAAK,MAAM,QAAQ,GAAG;CAC5D,QAAQ,IAAI,aAAa,KAAK,SAAS,QAAQ,IAAI,GAAG,UAAU,GAAG;AACrE;AAEA,SAAgB,eAAe,OAAuB;CACpD,MAAM,YAAY,OAAO,KAAK;CAC9B,IAAI,CAAC,OAAO,SAAS,SAAS,KAAK,YAAY,KAAK,YAAY,GAC9D,MAAM,IAAI,qBAAqB,+BAA+B;CAEhE,OAAO;AACT;AAEA,eAAe,gBAAgB,KAA4B;CAEzD,IAAI,EAAC,MADe,KAAK,GAAG,CAAC,CAAC,YAAY,MAAS,EACzC,EAAE,YAAY,GACtB,MAAM,IAAI,MAAM,oBAAoB,KAAK;AAE7C;AAEA,SAAS,cACP,UACgC;CAChC,MAAM,SAAS;EAAE,WAAW;EAAG,SAAS;EAAG,OAAO;EAAG,SAAS;CAAE;CAChE,KAAK,MAAM,UAAU,UACnB,OAAO,OAAO;CAEhB,OAAO;AACT;;;;AClDA,eAAsB,gBACpB,SACe;CACf,MAAM,MAAM,QAAQ;CACpB,MAAM,YACJ,QAAQ,aAAa,IAAI,2BAA2B;CACtD,MAAM,QAAQ,QAAQ,SAAS,IAAI,sBAAsB,aAAa,GAAG;CACzE,IAAI,UAAU,MACZ,MAAM,IAAI,MAAM,2CAA2C;CAE7D,MAAM,MAAM,QAAQ,cAChB,MAAM,YACJ,KACA,QAAQ,IAAI,GACZ,QAAQ,kBAAkB,IAAI,4BAChC,IACA;CAEJ,MAAM,MAAM,gBAAgB;EAC1B,SAAS,IAAI;EACb,OAAO,MAAM,aAAa,GAAG;CAC/B,CAAC;CACD,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,QAAQ,MAAM,IAAI,QAAQ,QAAQ,oBAAoB;GACpD;GACA;GACA,aAAa,QAAQ;GACrB;GACA,IAAI,WAAW,GAAG;EACpB,CAAC;EACD,QAAQ,MAAM,gBAAgB,KAAK,MAAM,SAAS,IAAI;CACxD,SAAS,OAAO;EACd,IAAI,cAAc,KAAK,KAAK,CAAC,QAAQ,QAAQ;GAC3C,QAAQ,KACN,0BAA0B,MAAM,QAAQ,+BAC1C;GACA;EACF;EACA,IAAI,cAAc,KAAK,KAAK,CAAC,QAAQ,QAAQ;GAC3C,QAAQ,KACN,wDAAwD,iBAAiB,QAAQ,MAAM,UAAU,MAAM,iCACzG;GACA;EACF;EACA,IAAI,iBAAiB,UACnB,MAAM,IAAI,MAAM,GAAG,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE;EAEpD,MAAM;CACR;CAEA,IAAI,UAAU,MACZ,QAAQ,IAAI,wBAAwB,MAAM,YAAY,aAAa;MAC9D;EACL,MAAM,EAAE,QAAQ,WAAW;EAC3B,QAAQ,IACN,wBAAwB,MAAM,YAAY,eAAe,OAAO,KAAK,GAAG,OAAO,SAAS,IAAI,UAAU,UACxG;EACA,QAAQ,IACN,aACE,OAAO,YAAY,OAAO,UAAU,OAAO,QAAQ,OAAO,QAC1D,MACF,CACF;CACF;CACA,QAAQ,IAAI,aAAa,MAAM,KAAK;AACtC;;;;ACpEA,MAAM,sBAAsB;AAC5B,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AAExB,MAAM,gBAAwC;CAC5C,SAAS;CACT,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,SAAS;CACT,UAAU;CACV,QAAQ;AACV;AAiBA,eAAsB,iBACpB,WACA,SACe;CACf,MAAM,UAAU,cACd,MAAM,YAAY,SAAS,GAC3B,QAAQ,SACR,QAAQ,OACV;CACA,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,uBAAuB,UAAU,aAAa;CAEhE,MAAM,SAAS,MAAM,QAAQ,KAAK,KAAK,OAAO,GAAG,yBAAyB,CAAC;CAC3E,IAAI;EACF,MAAM,SAAS,MAAM,eAAe,WAAW,QAAQ,SAAS,OAAO;EACvE,IAAI,OAAO,SAAS,GAClB,MAAM,IAAI,MAAM,gCAAgC,OAAO,KAAK,IAAI,GAAG;EAErE,MAAM,cAAc,QAAQ,OAAO;CACrC,UAAU;EACR,MAAM,GAAG,QAAQ;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;CACnD;AACF;AAEA,eAAe,YAAY,WAAqC;CAC9D,MAAM,OAAO,MAAM,SAAS,KAAK,KAAK,WAAW,YAAY,GAAG,MAAM,CAAC,CAAC,YAChE;EACJ,MAAM,IAAI,MACR,oBAAoB,UAAU,mDAChC;CACF,CACF;CACA,MAAM,QAAQ,KAAK,MAAM,IAAI;CAG7B,OAAO,OAAO,OAAO,MAAM,WAAW,CAAC,CAAC,CAAC,CACtC,QAAQ,UAAU,MAAM,SAAS,OAAO,CAAC,CACzC,KAAK,EAAE,IAAI,OAAO,MAAM,kBAAkB;EACzC;EACA;EACA;EACA;CACF,EAAE;AACN;AAEA,SAAgB,cACd,SACA,SACA,SACS;CACT,MAAM,WAAW,YAAY,SAAY,OAAO,aAAa,OAAO;CACpE,MAAM,WAAW,YAAY,SAAY,OAAO,aAAa,OAAO;CACpE,OAAO,QAAQ,QAAQ,UAAU;EAC/B,MAAM,OAAO,GAAG,MAAM,MAAM,GAAG,MAAM;EACrC,QACG,aAAa,QAAQ,SAAS,KAAK,IAAI,OACvC,aAAa,QAAQ,CAAC,SAAS,KAAK,IAAI;CAE7C,CAAC;AACH;AAEA,SAAS,aAAa,MAAsB;CAC1C,MAAM,SAAS,KACZ,MAAM,IAAI,CAAC,CACX,KAAK,SACJ,KACG,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,KAAK,QAAQ,sBAAsB,MAAM,CAAC,CAAC,CACzD,KAAK,OAAO,CACjB,CAAC,CACA,KAAK,IAAI;CACZ,OAAO,IAAI,OAAO,IAAI,OAAO,EAAE;AACjC;AAEA,SAAgB,kBAAkB,OAAc,OAAuB;CACrE,OAAO,GAAG,MAAM,MAAM,GAAG,MAAM,KAAK,aAAa,MAAM;AACzD;AAEA,eAAe,eACb,WACA,QACA,SACA,SACmB;CACnB,MAAM,EAAE,aAAa,MAAM,OAAO,aAAa,CAAC,YAAY;EAC1D,MAAM,IAAI,MACR,+GACF;CACF,CAAC;CACD,MAAM,SAAS,MAAM,YAAY,SAAS;CAC1C,MAAM,UAAU,oBAAqB,OAAO,QAAQ,CAAC,CAAiB;CACtE,MAAM,UAAU,MAAM,SAAS,OAAO;CACtC,MAAM,SAAmB,CAAC;CAC1B,IAAI;EACF,KAAK,MAAM,SAAS,QAAQ,WAAW;GACrC,MAAM,UAAU,MAAM,QAAQ,WAAW;IACvC,UAAU;KAAE;KAAO,QAAQ;IAAgB;IAC3C,mBAAmB;IACnB,eAAe;GACjB,CAAC;GACD,MAAM,cAAc,SAAS,qBAAqB,OAAO,UAAU;IACjE,MAAM,OAAO,kBAAkB,OAAO,KAAK;IAC3C,MAAM,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,KAAK;IAC5C,MAAM,OAAO,MAAM,QAAQ,QAAQ;IACnC,IAAI;KACF,MAAM,KAAK,KACT,GAAG,QAAQ,kBAAkB,mBAAmB,MAAM,EAAE,EAAE,kBAC1D,EAAE,SAAS,iBAAiB,CAC9B;KACA,MAAM,KAAK,gBAAgB,QAAQ,iBAAiB,EAClD,SAAS,iBACX,CAAC;KACD,MAAM,KAAK,SAAS,sBAAsB;KAC1C,IAAI,QAAQ,QAAQ,GAClB,MAAM,KAAK,eAAe,QAAQ,KAAK;KAEzC,MAAM,MAAM,KAAK,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;KACnD,MAAM,KAAK,WAAW;MACpB,MAAM;MACN,UAAU;MACV,YAAY;MACZ,OAAO;KACT,CAAC;KACD,MAAM,UACJ,aAAa,IAAI,GACjB,KAAK,UAAU;MACb,SAAS;MACT,UAAU;MACV,SAAS,MAAM;MACf,YAAY,MAAM;KACpB,CAAC,CACH;IACF,QAAQ;KACN,OAAO,KAAK,IAAI;IAClB,UAAU;KACR,MAAM,KAAK,MAAM;IACnB;GACF,CAAC;GACD,MAAM,QAAQ,MAAM;EACtB;CACF,UAAU;EACR,MAAM,QAAQ,MAAM;EACpB,OAAO,MAAM;CACf;CACA,QAAQ,IACN,0BAA0B,QAAQ,SAAS,QAAQ,UAAU,SAAS,OAAO,OAAO,oBAAoB,QAAQ,OAAO,SACzH;CACA,OAAO;AACT;AAEA,eAAe,YAAY,MAA+B;CACxD,MAAM,OAAO,KAAK,QAAQ,IAAI;CAC9B,MAAM,SAAS,cAAc,SAAS,aAAa;EACjD,MAAM,WAAW,mBACf,IAAI,IAAI,QAAQ,OAAO,KAAK,kBAAkB,CAAC,CAAC,QAClD;EACA,MAAM,OAAO,KAAK,KAChB,MACA,SAAS,SAAS,GAAG,IAAI,GAAG,SAAS,cAAc,QACrD;EACA,IAAI,CAAC,KAAK,WAAW,GAAG,OAAO,KAAK,KAAK,GAAG;GAC1C,SAAS,UAAU,GAAG,CAAC,CAAC,IAAI;GAC5B;EACF;EACA,KAAK,IAAI,CAAC,CAAC,MACR,UAAU;GACT,IAAI,CAAC,MAAM,OAAO,GAAG;IACnB,SAAS,UAAU,GAAG,CAAC,CAAC,IAAI;IAC5B;GACF;GACA,SAAS,UAAU,KAAK,EACtB,gBACE,cAAc,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,MAC7C,2BACJ,CAAC;GACD,iBAAiB,IAAI,CAAC,CAAC,KAAK,QAAQ;EACtC,SACM,SAAS,UAAU,GAAG,CAAC,CAAC,IAAI,CACpC;CACF,CAAC;CACD,MAAM,IAAI,SAAe,YAAY,OAAO,OAAO,GAAG,aAAa,OAAO,CAAC;CAC3E,OAAO;AACT;AAEA,SAAgB,eAAe,OAAyB;CACtD,MAAM,SAAS,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,UAAU,OAAO,MAAM,KAAK,CAAC,CAAC;CACnE,IACE,OAAO,WAAW,KAClB,OAAO,MAAM,UAAU,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,CAAC,GAE5D,MAAM,IAAI,qBAAqB,0BAA0B;CAE3D,OAAO;AACT;AAEA,SAAgB,WAAW,OAAuB;CAChD,MAAM,QAAQ,OAAO,KAAK;CAC1B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GACtC,MAAM,IAAI,qBAAqB,yCAAyC;CAE1E,OAAO;AACT;;;;AClPA,MAAM,UAAU,IAAI,QAAQ,CAAC,CAC1B,KAAK,cAAc,CAAC,CACpB,YAAY,gDAAgD,CAAC,CAC7D,QAAQA,OAAmB;AAE9B,QACG,QAAQ,SAAS,CAAC,CAClB,YAAY,2DAA2D,CAAC,CACxE,SAAS,SAAS,6BAA6B,CAAC,CAChD,SAAS,kBAAkB,kCAAkC,CAAC,CAC9D,OAAO,eAAe,iBAAiB,qBAAqB,CAAC,CAC7D,OACC,wBACA,sCACA,gBACA,EACF,CAAC,CACA,OAAO,gBAAgB,wCAAwC,KAAK,CAAC,CACrE,OAAO,cAAc;AAExB,QACG,QAAQ,QAAQ,CAAC,CACjB,YACC,iEACF,CAAC,CACA,SAAS,SAAS,yBAAyB,CAAC,CAC5C,OACC,uBACA,gDACF,CAAC,CACA,OACC,iBACA,gEACA,UACF,CAAC,CACA,OAAO,gBAAgB,oCAAoC,CAAC,CAC5D,OAAO,8BAA8B,2BAA2B,CAAC,CACjE,OACC,YACA,uDACA,KACF,CAAC,CACA,OACC,wBACA,kEACA,cACF,CAAC,CACA,OAAO,YAAY,0CAA0C,KAAK,CAAC,CACnE,OAAO,aAAa,2CAA2C,KAAK,CAAC,CACrE,OAAO,aAAa;AAEvB,QACG,QAAQ,WAAW,CAAC,CACpB,YAAY,uDAAuD,CAAC,CACpE,SAAS,gBAAgB,+BAA+B,CAAC,CACzD,OACC,wBACA,mCACA,gBACA,CAAC,IAAI,CACP,CAAC,CACA,OAAO,oBAAoB,qCAAqC,CAAC,CACjE,OAAO,oBAAoB,qCAAqC,CAAC,CACjE,OACC,kCACA,wCACA,qBACF,CAAC,CACA,OACC,gBACA,yCACA,YACA,CACF,CAAC,CACA,OACC,uBACA,gDACF,CAAC,CACA,OACC,iBACA,gEACA,UACF,CAAC,CACA,OAAO,gBAAgB,oCAAoC,CAAC,CAC5D,OAAO,8BAA8B,2BAA2B,CAAC,CACjE,OACC,YACA,uDACA,KACF,CAAC,CACA,OACC,wBACA,kEACA,cACF,CAAC,CACA,OAAO,YAAY,0CAA0C,KAAK,CAAC,CACnE,OAAO,aAAa,8CAA8C,KAAK,CAAC,CACxE,OAAO,gBAAgB;AAE1B,QACG,QAAQ,UAAU,CAAC,CACnB,YAAY,mDAAmD,CAAC,CAChE,OAAO,uBAAuB,gCAAgC,CAAC,CAC/D,OAAO,gBAAgB,2BAA2B,CAAC,CACnD,OACC,8BACA,gDACF,CAAC,CACA,OACC,mBACA,oDACA,KACF,CAAC,CACA,OAAO,YAAY,0CAA0C,KAAK,CAAC,CACnE,OAAO,eAAe;AAEzB,IAAI;CACF,MAAM,QAAQ,WAAW;AAC3B,SAAS,OAAO;CACd,QAAQ,MACN,iBAAiB,iBAAiB,QAAQ,MAAM,UAAU,OAC5D;CACA,QAAQ,WAAW;AACrB"}
1
+ {"version":3,"file":"index.mjs","names":["packageJson.version"],"sources":["../package.json","../src/compare.ts","../src/report/template.ts","../src/report/write-report.ts","../src/commands/compare.ts","../src/commands/finalize.ts","../src/commands/storybook.ts","../src/index.ts"],"sourcesContent":["","import { copyFile, mkdir, readFile, rename, rm } from \"node:fs/promises\";\nimport { availableParallelism } from \"node:os\";\nimport path from \"node:path\";\nimport type { DiffEngine, DiffOptions } from \"./diff/engine\";\nimport { mapConcurrent } from \"./map-concurrent\";\nimport { readPngSize, sha256 } from \"./png\";\nimport { collectSnapshots } from \"./snapshots\";\n\nexport type SnapshotStatus = \"unchanged\" | \"changed\" | \"added\" | \"removed\";\n\nexport type ImageRef = {\n file: string;\n width: number;\n height: number;\n};\n\nexport type SnapshotResult = {\n name: string;\n status: SnapshotStatus;\n image?: ImageRef;\n baselineImage?: ImageRef;\n diffImage?: ImageRef;\n diffPixels?: number;\n diffRatio?: number;\n};\n\ntype CompareDirectoriesInput = {\n dir: string;\n baselineDir: string;\n outDir: string;\n engine: DiffEngine;\n options: DiffOptions;\n};\n\nexport async function compareDirectories({\n dir,\n baselineDir,\n outDir,\n engine,\n options,\n}: CompareDirectoriesInput): Promise<SnapshotResult[]> {\n const [snapshots, baselines] = await Promise.all([\n collectSnapshots(dir),\n collectSnapshots(baselineDir),\n ]);\n const imagesDir = path.join(outDir, \"images\");\n const workDir = path.join(outDir, \".work\");\n await mkdir(imagesDir, { recursive: true });\n await mkdir(workDir, { recursive: true });\n\n const names = [...new Set([...snapshots.keys(), ...baselines.keys()])].sort(\n (a, b) => (a < b ? -1 : a > b ? 1 : 0),\n );\n\n const results = await mapConcurrent(\n names,\n availableParallelism(),\n async (name, index): Promise<SnapshotResult> => {\n const filePath = snapshots.get(name);\n const baselinePath = baselines.get(name);\n\n if (!filePath && baselinePath) {\n return {\n name,\n status: \"removed\",\n baselineImage: await storeImage(baselinePath, imagesDir),\n };\n }\n if (!filePath) {\n throw new Error(`Snapshot ${name} has no file`);\n }\n\n const image = await storeImage(filePath, imagesDir);\n if (!baselinePath) {\n return { name, status: \"added\", image };\n }\n\n const baselineImage = await storeImage(baselinePath, imagesDir);\n if (image.file === baselineImage.file) {\n return { name, status: \"unchanged\", image, baselineImage };\n }\n\n const workPath = path.join(workDir, `${index}.png`);\n const { diffPixels, diffRatio } = await engine.diff(\n baselinePath,\n filePath,\n workPath,\n options,\n );\n if (diffPixels === 0) {\n await rm(workPath, { force: true });\n return { name, status: \"unchanged\", image, baselineImage };\n }\n\n return {\n name,\n status: \"changed\",\n image,\n baselineImage,\n diffImage: await storeImage(workPath, imagesDir, { move: true }),\n diffPixels,\n diffRatio,\n };\n },\n );\n\n await rm(workDir, { recursive: true, force: true });\n return results;\n}\n\nasync function storeImage(\n filePath: string,\n imagesDir: string,\n { move = false } = {},\n): Promise<ImageRef> {\n const bytes = await readFile(filePath);\n const file = `images/${sha256(bytes)}.png`;\n const target = path.join(imagesDir, path.basename(file));\n if (move) {\n await rename(filePath, target);\n } else {\n await copyFile(filePath, target);\n }\n return { file, ...readPngSize(bytes) };\n}\n","import type { SnapshotResult } from \"../compare\";\nimport type { ReportMeta } from \"./write-report\";\n\nexport function renderReport(\n snapshots: SnapshotResult[],\n meta: ReportMeta,\n): string {\n const data = JSON.stringify({ meta, snapshots }).replace(/</g, \"\\\\u003c\");\n\n return `<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n<title>stateofpixel report</title>\n<style>${STYLES}</style>\n</head>\n<body>\n<header class=\"header\">\n <div class=\"title\"><strong>stateofpixel</strong> <span class=\"muted mono\" id=\"dirs\"></span></div>\n <div class=\"counts\" id=\"counts\"></div>\n</header>\n<div class=\"layout\">\n <aside class=\"sidebar\">\n <input class=\"filter\" id=\"filter\" type=\"search\" placeholder=\"Filter snapshots\" aria-label=\"Filter snapshots\">\n <div id=\"list\" role=\"listbox\" aria-label=\"Snapshots\"></div>\n </aside>\n <main class=\"viewer\" id=\"viewer\"></main>\n</div>\n<script id=\"data\" type=\"application/json\">${data}</script>\n<script>${SCRIPT}</script>\n</body>\n</html>\n`;\n}\n\nconst STYLES = `\n:root {\n color-scheme: light dark;\n --bg: #fafafa; --surface: #ffffff; --surface-2: #f2f2f2; --hover: #ebebeb; --border: #ebebeb;\n --text: #171717; --muted: #666666; --accent: #171717; --accent-fg: #ffffff; --link: #0068d6;\n --unchanged: #666666; --unchanged-bg: #f2f2f2; --changed: #a35200; --changed-bg: #fff6e6;\n --added: #0068d6; --added-bg: #f0f7ff; --removed: #7820bc; --removed-bg: #f9f0ff;\n --canvas: #f2f2f2; --checker-a: #ffffff; --checker-b: #e6e6e6;\n --sans: \"IBM Plex Sans Variable\", \"IBM Plex Sans\", ui-sans-serif, system-ui, sans-serif;\n --mono: \"Lilex Variable\", \"Lilex\", ui-monospace, \"SF Mono\", monospace;\n}\n@media (prefers-color-scheme: dark) {\n :root {\n --bg: #000000; --surface: #0a0a0a; --surface-2: #1a1a1a; --hover: #1f1f1f; --border: #2e2e2e;\n --text: #ededed; --muted: #a1a1a1; --accent: #ededed; --accent-fg: #0a0a0a; --link: #52a8ff;\n --unchanged: #a1a1a1; --unchanged-bg: #1a1a1a; --changed: #f2a20d; --changed-bg: #291800;\n --added: #52a8ff; --added-bg: #0f1c2e; --removed: #bf7af0; --removed-bg: #231528;\n --canvas: #000000; --checker-a: #1a1a1a; --checker-b: #292929;\n }\n}\n* { box-sizing: border-box; }\nhtml, body { height: 100%; margin: 0; }\nbody { display: flex; flex-direction: column; background: var(--bg); color: var(--text); font: 400 13px/20px var(--sans); -webkit-font-smoothing: antialiased; }\n:focus-visible { outline: 2px solid var(--link); outline-offset: 2px; }\n.muted { color: var(--muted); }\n.mono { font-family: var(--mono); }\n.num { font-variant-numeric: tabular-nums; }\n.header { display: flex; flex-wrap: wrap; gap: 8px 16px; align-items: center; justify-content: space-between; padding: 12px 16px; background: var(--surface); border-bottom: 1px solid var(--border); }\n.title strong { font-size: 14px; font-weight: 600; }\n.counts { display: flex; flex-wrap: wrap; gap: 6px; }\n.pill { display: inline-flex; align-items: center; gap: 4px; height: 20px; padding: 0 6px; border-radius: 5px; font-size: 11px; font-weight: 500; font-variant-numeric: tabular-nums; white-space: nowrap; }\n.pill[data-status=unchanged] { color: var(--unchanged); background: var(--unchanged-bg); }\n.pill[data-status=changed] { color: var(--changed); background: var(--changed-bg); }\n.pill[data-status=added] { color: var(--added); background: var(--added-bg); }\n.pill[data-status=removed] { color: var(--removed); background: var(--removed-bg); }\n.layout { flex: 1; display: flex; min-height: 0; }\n.sidebar { width: 300px; flex-shrink: 0; display: flex; flex-direction: column; background: var(--surface); border-right: 1px solid var(--border); }\n.filter { margin: 8px; height: 28px; padding: 0 10px; border: 0; border-radius: 8px; background: var(--surface); color: var(--text); font: inherit; box-shadow: inset 0 0 0 1px #8f8f8f; }\n#list { flex: 1; overflow-y: auto; padding: 0 8px 8px; }\n.group { display: flex; align-items: center; gap: 6px; width: 100%; height: 28px; padding: 0 8px; border: 0; background: none; color: var(--muted); font: 500 12px/16px var(--sans); cursor: pointer; text-align: left; }\n.row { display: flex; align-items: center; gap: 8px; width: 100%; height: 32px; padding: 0 8px; border: 0; border-radius: 7px; background: none; color: var(--text); font: 13px/20px var(--mono); text-align: left; cursor: pointer; position: relative; }\n.row:hover { background: var(--hover); }\n.row[aria-selected=true] { background: var(--hover); }\n.row[aria-selected=true]::before { content: \"\"; position: absolute; left: 0; top: 6px; bottom: 6px; width: 2px; border-radius: 2px; background: var(--link); }\n.row .name { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n.row .ratio { color: var(--muted); font: 12px/16px var(--sans); font-variant-numeric: tabular-nums; }\n.viewer { flex: 1; min-width: 0; display: flex; flex-direction: column; background: var(--surface); }\n.viewer-title { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; min-height: 48px; padding: 8px 16px; border-bottom: 1px solid var(--border); }\n.viewer-title .name { font: 500 14px/20px var(--mono); }\n.viewer-title .dims { margin-left: auto; }\n.toolbar { display: flex; flex-wrap: wrap; justify-content: space-between; gap: 8px; padding: 6px 16px; border-bottom: 1px solid var(--border); }\n.segmented { display: inline-flex; padding: 2px; border-radius: 11px; background: var(--surface-2); }\n.segmented button { height: 28px; padding: 0 10px; border: 1px solid transparent; border-radius: 7px; background: none; color: var(--muted); font: 500 13px/20px var(--sans); cursor: pointer; }\n.segmented button[aria-pressed=true] { background: var(--surface); color: var(--text); border-color: var(--border); }\n.segmented button:disabled { opacity: .45; cursor: default; }\nkbd { display: inline-flex; align-items: center; justify-content: center; min-width: 16px; height: 16px; margin-left: 6px; padding: 0 4px; border: 1px solid var(--border); border-radius: 5px; background: var(--surface); color: var(--muted); font: 500 11px/16px var(--mono); }\n.stage { flex: 1; overflow: auto; padding: 16px; background: var(--canvas); }\n.pair { display: flex; gap: 16px; align-items: flex-start; }\n.pair > figure { flex: 1; min-width: 0; }\nfigure { margin: 0; }\nfigcaption { height: 24px; color: var(--muted); font-size: 12px; }\n.frame { position: relative; background-color: var(--checker-a); background-image: conic-gradient(var(--checker-b) 25%, transparent 0 50%, var(--checker-b) 0 75%, transparent 0); background-size: 16px 16px; }\n.frame img { position: absolute; top: 0; left: 0; display: block; }\n.zoom-actual .frame img { image-rendering: pixelated; }\n.frame[data-flip=baseline] { outline: 1px solid var(--link); }\n.diff-layer { opacity: .7; }\n.slider { display: block; width: 100%; margin: 12px 0 0; accent-color: var(--link); }\n.handle { position: absolute; top: 0; bottom: 0; width: 2px; margin-left: -1px; background: var(--link); pointer-events: none; }\n.empty { padding: 24px; color: var(--muted); font-size: 24px; line-height: 34px; }\n.empty strong { color: var(--text); font-weight: 600; }\n@media (max-width: 767px) {\n .layout { flex-direction: column; }\n .sidebar { width: auto; max-height: 40vh; border-right: 0; border-bottom: 1px solid var(--border); }\n .pair { flex-direction: column; }\n .pair > figure { width: 100%; }\n}\n`;\n\nconst SCRIPT = `\nconst { meta, snapshots } = JSON.parse(document.getElementById(\"data\").textContent);\nconst GROUPS = [\"changed\", \"added\", \"removed\", \"unchanged\"];\nconst MODES = [[\"side\", \"Side by side\"], [\"diff\", \"Diff\"], [\"slider\", \"Slider\"], [\"flip\", \"Flip\"]];\nconst store = {\n get(key, fallback) { try { return localStorage.getItem(\"stateofpixel:\" + key) || fallback; } catch { return fallback; } },\n set(key, value) { try { localStorage.setItem(\"stateofpixel:\" + key, value); } catch {} },\n};\nconst state = {\n filter: \"\",\n collapsed: new Set([\"unchanged\"]),\n selected: null,\n mode: store.get(\"mode\", \"side\"),\n zoom: store.get(\"zoom\", \"fit\"),\n flip: \"new\",\n slider: 50,\n};\n\nfunction el(tag, props, children) {\n const node = document.createElement(tag);\n Object.assign(node, props || {});\n for (const child of children || []) node.append(child);\n return node;\n}\n\nfunction pill(status, label) {\n const node = el(\"span\", { className: \"pill\", textContent: label });\n node.dataset.status = status;\n return node;\n}\n\nfunction percent(ratio) {\n return (ratio * 100).toFixed(ratio < 0.001 ? 3 : 2) + \"%\";\n}\n\nfunction visibleGroups() {\n const query = state.filter.toLowerCase();\n return GROUPS.map((status) => ({\n status,\n items: snapshots.filter((s) => s.status === status && s.name.toLowerCase().includes(query)),\n })).filter((group) => group.items.length > 0);\n}\n\nfunction navigable() {\n return visibleGroups().flatMap((group) => (state.collapsed.has(group.status) ? [] : group.items));\n}\n\nfunction renderHeader() {\n document.getElementById(\"dirs\").textContent = meta.dir + \" vs \" + meta.baselineDir;\n const counts = document.getElementById(\"counts\");\n counts.replaceChildren(\n ...GROUPS.map((status) => {\n const count = snapshots.filter((s) => s.status === status).length;\n return pill(status, count.toLocaleString() + \" \" + status);\n }),\n );\n}\n\nfunction renderList() {\n const list = document.getElementById(\"list\");\n list.replaceChildren(\n ...visibleGroups().flatMap((group) => {\n const collapsed = state.collapsed.has(group.status);\n const header = el(\"button\", {\n className: \"group\",\n textContent: (collapsed ? \"+ \" : \"- \") + group.status[0].toUpperCase() + group.status.slice(1) + \" (\" + group.items.length.toLocaleString() + \")\",\n onclick: () => {\n if (collapsed) state.collapsed.delete(group.status);\n else state.collapsed.add(group.status);\n renderList();\n },\n });\n header.setAttribute(\"aria-expanded\", String(!collapsed));\n if (collapsed) return [header];\n return [\n header,\n ...group.items.map((snapshot) => {\n const row = el(\"button\", { className: \"row\", title: snapshot.name, onclick: () => select(snapshot) }, [\n el(\"span\", { className: \"name\", textContent: snapshot.name }),\n ]);\n row.setAttribute(\"role\", \"option\");\n row.setAttribute(\"aria-selected\", String(snapshot === state.selected));\n if (snapshot.diffRatio !== undefined) row.append(el(\"span\", { className: \"ratio\", textContent: percent(snapshot.diffRatio) }));\n return row;\n }),\n ];\n }),\n );\n list.querySelector(\"[aria-selected=true]\")?.scrollIntoView({ block: \"nearest\" });\n}\n\nfunction frame(images, width, height) {\n const node = el(\"div\", { className: \"frame\" });\n if (state.zoom === \"fit\") {\n node.style.width = \"100%\";\n node.style.maxWidth = width + \"px\";\n node.style.aspectRatio = width + \" / \" + height;\n } else {\n node.style.width = width + \"px\";\n node.style.height = height + \"px\";\n }\n for (const { image, className, style } of images) {\n const img = el(\"img\", { src: image.file, alt: \"\", className: className || \"\" });\n img.style.width = (image.width / width) * 100 + \"%\";\n Object.assign(img.style, style || {});\n node.append(img);\n }\n return node;\n}\n\nfunction figure(caption, image) {\n return el(\"figure\", {}, [el(\"figcaption\", { textContent: caption }), frame([{ image }], image.width, image.height)]);\n}\n\nfunction renderStage(snapshot) {\n const { image, baselineImage, diffImage } = snapshot;\n if (!image || !baselineImage) {\n const only = image || baselineImage;\n return [figure(image ? \"New\" : \"Baseline\", only)];\n }\n const width = Math.max(image.width, baselineImage.width);\n const height = Math.max(image.height, baselineImage.height);\n if (state.mode === \"side\") {\n return [el(\"div\", { className: \"pair\" }, [figure(\"Baseline\", baselineImage), figure(\"New\", image)])];\n }\n if (state.mode === \"diff\") {\n const layers = [{ image }];\n if (diffImage) layers.push({ image: diffImage, className: \"diff-layer\" });\n return [el(\"figure\", {}, [el(\"figcaption\", { textContent: \"New with diff overlay\" }), frame(layers, width, height)])];\n }\n if (state.mode === \"slider\") {\n const clipFor = (value) => \"inset(0 \" + (100 - value) + \"% 0 0)\";\n const stageNode = frame([{ image }, { image: baselineImage, style: { clipPath: clipFor(state.slider) } }], width, height);\n const handle = el(\"div\", { className: \"handle\" });\n handle.style.left = state.slider + \"%\";\n stageNode.append(handle);\n const slider = el(\"input\", {\n className: \"slider\",\n type: \"range\",\n min: 0,\n max: 100,\n value: state.slider,\n oninput: (event) => {\n state.slider = Number(event.target.value);\n stageNode.querySelectorAll(\"img\")[1].style.clipPath = clipFor(state.slider);\n handle.style.left = state.slider + \"%\";\n },\n });\n slider.setAttribute(\"aria-label\", \"Baseline to new\");\n const node = el(\"figure\", {}, [el(\"figcaption\", { textContent: \"Baseline on the left of the handle, new on the right\" }), stageNode, slider]);\n node.style[state.zoom === \"fit\" ? \"maxWidth\" : \"width\"] = width + \"px\";\n return [node];\n }\n const showing = state.flip === \"baseline\" ? baselineImage : image;\n const node = frame([{ image: showing }], width, height);\n node.dataset.flip = state.flip;\n return [el(\"figure\", {}, [el(\"figcaption\", { textContent: \"Showing \" + state.flip + \". Press space to flip.\" }), node])];\n}\n\nfunction renderViewer() {\n const viewer = document.getElementById(\"viewer\");\n const snapshot = state.selected;\n if (!snapshot) {\n const empty = el(\"p\", { className: \"empty\" }, [el(\"strong\", { textContent: \"No visual changes.\" }), \" Every snapshot matches its baseline.\"]);\n viewer.replaceChildren(empty);\n return;\n }\n const comparable = Boolean(snapshot.image && snapshot.baselineImage);\n const title = el(\"div\", { className: \"viewer-title\" }, [\n el(\"span\", { className: \"name\", textContent: snapshot.name }),\n pill(snapshot.status, snapshot.status),\n ]);\n if (snapshot.diffPixels !== undefined) {\n title.append(el(\"span\", { className: \"muted num\", textContent: percent(snapshot.diffRatio) + \" diff, \" + snapshot.diffPixels.toLocaleString() + \" px\" }));\n }\n const dims = [snapshot.baselineImage, snapshot.image].filter(Boolean).map((i) => i.width + \"x\" + i.height);\n title.append(el(\"span\", { className: \"dims muted num\", textContent: [...new Set(dims)].join(\" to \") }));\n\n const modes = el(\"div\", { className: \"segmented\" }, MODES.map(([mode, label], index) => {\n const button = el(\"button\", { disabled: !comparable, onclick: () => setMode(mode) }, [label, el(\"kbd\", { textContent: String(index + 1) })]);\n button.setAttribute(\"aria-pressed\", String(comparable && state.mode === mode));\n return button;\n }));\n const zoom = el(\"div\", { className: \"segmented\" }, [[\"fit\", \"Fit\", \"f\"], [\"actual\", \"100%\", \"0\"]].map(([value, label, key]) => {\n const button = el(\"button\", { onclick: () => setZoom(value) }, [label, el(\"kbd\", { textContent: key })]);\n button.setAttribute(\"aria-pressed\", String(state.zoom === value));\n return button;\n }));\n const stage = el(\"div\", { className: \"stage zoom-\" + state.zoom }, renderStage(snapshot));\n viewer.replaceChildren(title, el(\"div\", { className: \"toolbar\" }, [modes, zoom]), stage);\n}\n\nfunction select(snapshot) {\n state.selected = snapshot;\n state.flip = \"new\";\n renderList();\n renderViewer();\n}\n\nfunction setMode(mode) {\n state.mode = mode;\n store.set(\"mode\", mode);\n renderViewer();\n}\n\nfunction setZoom(zoom) {\n state.zoom = zoom;\n store.set(\"zoom\", zoom);\n renderViewer();\n}\n\nfunction move(step) {\n const items = navigable();\n if (items.length === 0) return;\n const index = items.indexOf(state.selected);\n const next = index === -1 ? 0 : Math.min(items.length - 1, Math.max(0, index + step));\n select(items[next]);\n}\n\nconst filter = document.getElementById(\"filter\");\nfilter.addEventListener(\"input\", () => {\n state.filter = filter.value;\n renderList();\n});\n\ndocument.addEventListener(\"keydown\", (event) => {\n if (event.target === filter) {\n if (event.key === \"Escape\") filter.blur();\n return;\n }\n if (event.metaKey || event.ctrlKey || event.altKey) return;\n const modeIndex = [\"1\", \"2\", \"3\", \"4\"].indexOf(event.key);\n if (event.key === \"j\") move(1);\n else if (event.key === \"k\") move(-1);\n else if (modeIndex !== -1) setMode(MODES[modeIndex][0]);\n else if (event.key === \"f\") setZoom(\"fit\");\n else if (event.key === \"0\") setZoom(\"actual\");\n else if (event.key === \"/\") { event.preventDefault(); filter.focus(); }\n else if (event.key === \" \" && state.mode === \"flip\") {\n event.preventDefault();\n state.flip = state.flip === \"new\" ? \"baseline\" : \"new\";\n renderViewer();\n }\n});\n\nrenderHeader();\nconst first = navigable().find((s) => s.status !== \"unchanged\");\nif (first) select(first);\nelse { renderList(); renderViewer(); }\n`;\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { SnapshotResult } from \"../compare\";\nimport { renderReport } from \"./template\";\n\nexport type ReportMeta = {\n dir: string;\n baselineDir: string;\n engine: string;\n createdAt: string;\n};\n\nexport async function writeReport(\n outDir: string,\n results: SnapshotResult[],\n meta: ReportMeta,\n): Promise<string> {\n await mkdir(outDir, { recursive: true });\n const reportPath = path.join(outDir, \"index.html\");\n await writeFile(reportPath, renderReport(results, meta));\n return reportPath;\n}\n","import { stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport { compareDirectories, type SnapshotStatus } from \"../compare\";\nimport { createDiffEngine } from \"../diff/engine\";\nimport { formatCounts } from \"../format\";\nimport { writeReport } from \"../report/write-report\";\n\nexport type CompareCommandOptions = {\n out: string;\n threshold: number;\n includeAa: boolean;\n};\n\nexport async function compareCommand(\n dir: string,\n baselineDir: string,\n options: CompareCommandOptions,\n): Promise<void> {\n await assertDirectory(dir);\n await assertDirectory(baselineDir);\n\n const startedAt = performance.now();\n const engine = await createDiffEngine();\n const results = await compareDirectories({\n dir,\n baselineDir,\n outDir: options.out,\n engine,\n options: { threshold: options.threshold, includeAA: options.includeAa },\n });\n const reportPath = await writeReport(options.out, results, {\n dir,\n baselineDir,\n engine: engine.name,\n createdAt: new Date().toISOString(),\n });\n\n const counts = countByStatus(results.map((result) => result.status));\n const seconds = ((performance.now() - startedAt) / 1000).toFixed(1);\n console.log(`stateofpixel compare ${dir} vs ${baselineDir}`);\n console.log(formatCounts(results.length, counts));\n console.log(` compared with ${engine.name} in ${seconds} s`);\n console.log(` report: ${path.relative(process.cwd(), reportPath)}`);\n}\n\nexport function parseThreshold(value: string): number {\n const threshold = Number(value);\n if (!Number.isFinite(threshold) || threshold < 0 || threshold > 1) {\n throw new InvalidArgumentError(\"Must be a number from 0 to 1.\");\n }\n return threshold;\n}\n\nasync function assertDirectory(dir: string): Promise<void> {\n const stats = await stat(dir).catch(() => undefined);\n if (!stats?.isDirectory()) {\n throw new Error(`Not a directory: ${dir}`);\n }\n}\n\nfunction countByStatus(\n statuses: SnapshotStatus[],\n): Record<SnapshotStatus, number> {\n const counts = { unchanged: 0, changed: 0, added: 0, removed: 0 };\n for (const status of statuses) {\n counts[status]++;\n }\n return counts;\n}\n","import {\n ApiError,\n createApiClient,\n DEFAULT_API_URL,\n isRateLimited,\n isServerError,\n} from \"../api\";\nimport { defaultNonce, readCiInfo, readGitInfo, resolveToken } from \"../ci-env\";\nimport { formatCounts } from \"../format\";\nimport { ENV } from \"../reference\";\nimport { waitForFinalize } from \"../upload\";\n\nexport type FinalizeCommandOptions = {\n buildName?: string;\n nonce?: string;\n baselineBranch?: string;\n skipIfEmpty: boolean;\n strict: boolean;\n};\n\nexport async function finalizeCommand(\n options: FinalizeCommandOptions,\n): Promise<void> {\n const env = process.env;\n const buildName = options.buildName ?? env[ENV.buildName] ?? \"default\";\n const nonce = options.nonce ?? env[ENV.nonce] ?? defaultNonce(env);\n if (nonce === null) {\n throw new Error(\"Set --nonce to the nonce the shards used.\");\n }\n const git = options.skipIfEmpty\n ? await readGitInfo(\n env,\n process.cwd(),\n options.baselineBranch ?? env[ENV.baselineBranch],\n )\n : undefined;\n\n const api = createApiClient({\n baseUrl: env.STATEOFPIXEL_API_URL ?? DEFAULT_API_URL,\n token: await resolveToken(env),\n });\n let build: { buildId: string; buildNumber: number; url: string };\n let final: Awaited<ReturnType<typeof waitForFinalize>>;\n try {\n build = await api.request(\"POST\", \"/builds/finalize\", {\n buildName,\n nonce,\n skipIfEmpty: options.skipIfEmpty,\n git,\n ci: readCiInfo(env),\n });\n final = await waitForFinalize(api, build.buildId, true);\n } catch (error) {\n if (isRateLimited(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, ${error.message} Use --strict to fail instead.`,\n );\n return;\n }\n if (isServerError(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, the service is not reachable (${error instanceof Error ? error.message : error}). Use --strict to fail instead.`,\n );\n return;\n }\n if (error instanceof ApiError) {\n throw new Error(`${error.message} (${error.code})`);\n }\n throw error;\n }\n\n if (final === null) {\n console.log(`stateofpixel build #${build.buildNumber} finalizing`);\n } else {\n const { counts, shards } = final;\n console.log(\n `stateofpixel build #${build.buildNumber} finalized, ${shards.done} ${shards.done === 1 ? \"shard\" : \"shards\"}`,\n );\n console.log(\n formatCounts(\n counts.unchanged + counts.changed + counts.added + counts.failed,\n counts,\n ),\n );\n }\n console.log(` review: ${build.url}`);\n}\n","import { createReadStream } from \"node:fs\";\nimport {\n mkdir,\n mkdtemp,\n readFile,\n rm,\n stat,\n writeFile,\n} from \"node:fs/promises\";\nimport { createServer, type Server } from \"node:http\";\nimport type { AddressInfo } from \"node:net\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport { mapConcurrent } from \"../map-concurrent\";\nimport { metadataFile } from \"../upload\";\nimport { type UploadCommandOptions, uploadCommand } from \"./upload\";\n\nconst CAPTURE_CONCURRENCY = 4;\nconst STORY_TIMEOUT_MS = 15_000;\nconst VIEWPORT_HEIGHT = 720;\n\nconst CONTENT_TYPES: Record<string, string> = {\n \".html\": \"text/html\",\n \".js\": \"text/javascript\",\n \".mjs\": \"text/javascript\",\n \".css\": \"text/css\",\n \".json\": \"application/json\",\n \".svg\": \"image/svg+xml\",\n \".png\": \"image/png\",\n \".jpg\": \"image/jpeg\",\n \".gif\": \"image/gif\",\n \".webp\": \"image/webp\",\n \".woff\": \"font/woff\",\n \".woff2\": \"font/woff2\",\n \".ttf\": \"font/ttf\",\n};\n\nexport type StorybookCommandOptions = UploadCommandOptions & {\n viewports: number[];\n include?: string;\n exclude?: string;\n waitForSelector: string;\n delay: number;\n};\n\nexport type Story = {\n id: string;\n title: string;\n name: string;\n importPath?: string;\n};\n\nexport async function storybookCommand(\n staticDir: string,\n options: StorybookCommandOptions,\n): Promise<void> {\n const stories = filterStories(\n await readStories(staticDir),\n options.include,\n options.exclude,\n );\n if (stories.length === 0) {\n throw new Error(`No stories found in ${staticDir}/index.json.`);\n }\n const outDir = await mkdtemp(path.join(tmpdir(), \"stateofpixel-storybook-\"));\n try {\n const failed = await captureStories(staticDir, outDir, stories, options);\n if (failed.length > 0) {\n throw new Error(`Stories that did not render: ${failed.join(\", \")}`);\n }\n await uploadCommand(outDir, options);\n } finally {\n await rm(outDir, { recursive: true, force: true });\n }\n}\n\nasync function readStories(staticDir: string): Promise<Story[]> {\n const text = await readFile(path.join(staticDir, \"index.json\"), \"utf8\").catch(\n () => {\n throw new Error(\n `No index.json in ${staticDir}. Run storybook build first, Storybook 7 or newer.`,\n );\n },\n );\n const index = JSON.parse(text) as {\n entries?: Record<string, Story & { type?: string }>;\n };\n return Object.values(index.entries ?? {})\n .filter((entry) => entry.type === \"story\")\n .map(({ id, title, name, importPath }) => ({\n id,\n title,\n name,\n importPath,\n }));\n}\n\nexport function filterStories(\n stories: Story[],\n include: string | undefined,\n exclude: string | undefined,\n): Story[] {\n const includes = include === undefined ? null : globToRegExp(include);\n const excludes = exclude === undefined ? null : globToRegExp(exclude);\n return stories.filter((story) => {\n const name = `${story.title}/${story.name}`;\n return (\n (includes === null || includes.test(name)) &&\n (excludes === null || !excludes.test(name))\n );\n });\n}\n\nfunction globToRegExp(glob: string): RegExp {\n const source = glob\n .split(\"**\")\n .map((part) =>\n part\n .split(\"*\")\n .map((text) => text.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\"))\n .join(\"[^/]*\"),\n )\n .join(\".*\");\n return new RegExp(`^${source}$`);\n}\n\nexport function storySnapshotName(story: Story, width: number): string {\n return `${story.title}/${story.name} [chromium ${width}]`;\n}\n\nasync function captureStories(\n staticDir: string,\n outDir: string,\n stories: Story[],\n options: StorybookCommandOptions,\n): Promise<string[]> {\n const { chromium } = await import(\"playwright\").catch(() => {\n throw new Error(\n \"stateofpixel storybook needs Playwright. Run npm install -D playwright, then npx playwright install chromium.\",\n );\n });\n const server = await serveStatic(staticDir);\n const baseUrl = `http://127.0.0.1:${(server.address() as AddressInfo).port}`;\n const browser = await chromium.launch();\n const failed: string[] = [];\n try {\n for (const width of options.viewports) {\n const context = await browser.newContext({\n viewport: { width, height: VIEWPORT_HEIGHT },\n deviceScaleFactor: 1,\n reducedMotion: \"reduce\",\n });\n await mapConcurrent(stories, CAPTURE_CONCURRENCY, async (story) => {\n const name = storySnapshotName(story, width);\n const file = path.join(outDir, `${name}.png`);\n const page = await context.newPage();\n try {\n await page.goto(\n `${baseUrl}/iframe.html?id=${encodeURIComponent(story.id)}&viewMode=story`,\n { timeout: STORY_TIMEOUT_MS },\n );\n await page.waitForSelector(options.waitForSelector, {\n timeout: STORY_TIMEOUT_MS,\n });\n await page.evaluate(\"document.fonts.ready\");\n if (options.delay > 0) {\n await page.waitForTimeout(options.delay);\n }\n await mkdir(path.dirname(file), { recursive: true });\n await page.screenshot({\n path: file,\n fullPage: true,\n animations: \"disabled\",\n caret: \"hide\",\n });\n await writeFile(\n metadataFile(file),\n JSON.stringify({\n browser: \"chromium\",\n viewport: width,\n storyId: story.id,\n importPath: story.importPath,\n }),\n );\n } catch {\n failed.push(name);\n } finally {\n await page.close();\n }\n });\n await context.close();\n }\n } finally {\n await browser.close();\n server.close();\n }\n console.log(\n `stateofpixel captured ${stories.length * options.viewports.length - failed.length} screenshots from ${stories.length} stories`,\n );\n return failed;\n}\n\nasync function serveStatic(root: string): Promise<Server> {\n const base = path.resolve(root);\n const server = createServer((request, response) => {\n const pathname = decodeURIComponent(\n new URL(request.url ?? \"/\", \"http://localhost\").pathname,\n );\n const file = path.join(\n base,\n pathname.endsWith(\"/\") ? `${pathname}index.html` : pathname,\n );\n if (!file.startsWith(`${base}${path.sep}`)) {\n response.writeHead(403).end();\n return;\n }\n stat(file).then(\n (stats) => {\n if (!stats.isFile()) {\n response.writeHead(404).end();\n return;\n }\n response.writeHead(200, {\n \"Content-Type\":\n CONTENT_TYPES[path.extname(file).toLowerCase()] ??\n \"application/octet-stream\",\n });\n createReadStream(file).pipe(response);\n },\n () => response.writeHead(404).end(),\n );\n });\n await new Promise<void>((resolve) => server.listen(0, \"127.0.0.1\", resolve));\n return server;\n}\n\nexport function parseViewports(value: string): number[] {\n const widths = value.split(\",\").map((width) => Number(width.trim()));\n if (\n widths.length === 0 ||\n widths.some((width) => !Number.isInteger(width) || width < 1)\n ) {\n throw new InvalidArgumentError(\"Must look like 375,1280.\");\n }\n return widths;\n}\n\nexport function parseDelay(value: string): number {\n const delay = Number(value);\n if (!Number.isInteger(delay) || delay < 0) {\n throw new InvalidArgumentError(\"Must be a whole number of milliseconds.\");\n }\n return delay;\n}\n","#!/usr/bin/env node\nimport { Command, Option } from \"commander\";\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport { compareCommand, parseThreshold } from \"./commands/compare\";\nimport { finalizeCommand } from \"./commands/finalize\";\nimport {\n parseDelay,\n parseViewports,\n storybookCommand,\n} from \"./commands/storybook\";\nimport { parseShard, uploadCommand } from \"./commands/upload\";\nimport { COMMANDS, type CommandSpec } from \"./reference\";\n\nconst PARSERS: Record<string, (value: string) => unknown> = {\n \"--threshold <number>\": parseThreshold,\n \"--shard <i/n>\": parseShard,\n \"--viewports <widths>\": parseViewports,\n \"--delay <ms>\": parseDelay,\n};\n\nconst ACTIONS: Record<CommandSpec[\"name\"], Parameters<Command[\"action\"]>[0]> = {\n compare: compareCommand,\n upload: uploadCommand,\n storybook: storybookCommand,\n finalize: finalizeCommand,\n};\n\nconst program = new Command()\n .name(\"stateofpixel\")\n .description(\"Visual regression testing that runs in your CI\")\n .version(packageJson.version);\n\nfor (const spec of COMMANDS) {\n const command = program.command(spec.name).description(spec.description);\n for (const argument of spec.arguments) {\n command.argument(argument.name, argument.description);\n }\n for (const option of spec.options) {\n const commanderOption = new Option(option.flags, option.description);\n const parse = PARSERS[option.flags];\n if (parse !== undefined) {\n commanderOption.argParser(parse);\n }\n if (option.default !== undefined) {\n commanderOption.default(option.default);\n }\n command.addOption(commanderOption);\n }\n command.action(ACTIONS[spec.name]);\n}\n\ntry {\n await program.parseAsync();\n} catch (error) {\n console.error(\n `stateofpixel: ${error instanceof Error ? error.message : error}`,\n );\n process.exitCode = 1;\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { n as uploadCommand, r as metadataFile } from "./upload-DKzFVTAz.mjs";
1
+ import { n as uploadCommand, r as metadataFile } from "./upload-CmJjvPgD.mjs";
2
2
  import { mkdir, rm, writeFile } from "node:fs/promises";
3
3
  import path from "node:path";
4
4
  import { test } from "@playwright/test";
@@ -308,6 +308,161 @@ async function git(cwd, ...args) {
308
308
  }
309
309
  }
310
310
 
311
+ //#endregion
312
+ //#region src/reference.ts
313
+ const ENV = {
314
+ buildName: "STATEOFPIXEL_BUILD_NAME",
315
+ shard: "STATEOFPIXEL_SHARD",
316
+ nonce: "STATEOFPIXEL_NONCE",
317
+ baselineBranch: "STATEOFPIXEL_BASELINE_BRANCH"
318
+ };
319
+ const buildOptions = (dryRun) => [
320
+ {
321
+ flags: "--build-name <name>",
322
+ description: "separate builds of one project, like storybook",
323
+ env: ENV.buildName
324
+ },
325
+ {
326
+ flags: "--shard <i/n>",
327
+ description: "this shard and the shard count, or auto with a finalize step",
328
+ env: ENV.shard
329
+ },
330
+ {
331
+ flags: "--nonce <id>",
332
+ description: "shared by every shard of one build",
333
+ env: ENV.nonce
334
+ },
335
+ {
336
+ flags: "--baseline-branch <branch>",
337
+ description: "branch to compare against",
338
+ env: ENV.baselineBranch
339
+ },
340
+ {
341
+ flags: "--subset",
342
+ description: "only some snapshots ran, do not mark others removed",
343
+ default: false
344
+ },
345
+ {
346
+ flags: "--threshold <number>",
347
+ description: "color difference threshold, 0 to 1, overrides project settings"
348
+ },
349
+ {
350
+ flags: "--strict",
351
+ description: "fail when the service is not reachable",
352
+ default: false
353
+ },
354
+ {
355
+ flags: "--dry-run",
356
+ description: dryRun,
357
+ default: false
358
+ }
359
+ ];
360
+ const COMMANDS = [
361
+ {
362
+ name: "upload",
363
+ description: "Upload a folder of screenshots and compare it with the baseline",
364
+ arguments: [{
365
+ name: "<dir>",
366
+ description: "folder with screenshots"
367
+ }],
368
+ options: buildOptions("hash and print the plan, upload nothing")
369
+ },
370
+ {
371
+ name: "storybook",
372
+ description: "Capture every story of a built Storybook, then upload",
373
+ arguments: [{
374
+ name: "<static-dir>",
375
+ description: "the output of storybook build"
376
+ }],
377
+ options: [
378
+ {
379
+ flags: "--viewports <widths>",
380
+ description: "comma separated viewport widths",
381
+ default: [1280]
382
+ },
383
+ {
384
+ flags: "--include <glob>",
385
+ description: "only stories whose title/name match"
386
+ },
387
+ {
388
+ flags: "--exclude <glob>",
389
+ description: "skip stories whose title/name match"
390
+ },
391
+ {
392
+ flags: "--wait-for-selector <selector>",
393
+ description: "wait for this before each screenshot",
394
+ default: "#storybook-root > *"
395
+ },
396
+ {
397
+ flags: "--delay <ms>",
398
+ description: "wait this long before each screenshot",
399
+ default: 0
400
+ },
401
+ ...buildOptions("capture and print the plan, upload nothing")
402
+ ]
403
+ },
404
+ {
405
+ name: "finalize",
406
+ description: "Finish a build whose shards ran with --shard auto",
407
+ arguments: [],
408
+ options: [
409
+ {
410
+ flags: "--build-name <name>",
411
+ description: "the build name the shards used",
412
+ env: ENV.buildName
413
+ },
414
+ {
415
+ flags: "--nonce <id>",
416
+ description: "the nonce the shards used",
417
+ env: ENV.nonce
418
+ },
419
+ {
420
+ flags: "--baseline-branch <branch>",
421
+ description: "branch to compare against, for --skip-if-empty",
422
+ env: ENV.baselineBranch
423
+ },
424
+ {
425
+ flags: "--skip-if-empty",
426
+ description: "create a build with no changes when no shard ran",
427
+ default: false
428
+ },
429
+ {
430
+ flags: "--strict",
431
+ description: "fail when the service is not reachable",
432
+ default: false
433
+ }
434
+ ]
435
+ },
436
+ {
437
+ name: "compare",
438
+ description: "Compare a folder of screenshots against a baseline folder",
439
+ arguments: [{
440
+ name: "<dir>",
441
+ description: "folder with new screenshots"
442
+ }, {
443
+ name: "<baseline-dir>",
444
+ description: "folder with baseline screenshots"
445
+ }],
446
+ options: [
447
+ {
448
+ flags: "--out <dir>",
449
+ description: "report folder",
450
+ default: "stateofpixel-report"
451
+ },
452
+ {
453
+ flags: "--threshold <number>",
454
+ description: "color difference threshold, 0 to 1",
455
+ default: .1
456
+ },
457
+ {
458
+ flags: "--include-aa",
459
+ description: "count anti-aliased pixels as changes",
460
+ default: false
461
+ }
462
+ ]
463
+ }
464
+ ];
465
+
311
466
  //#endregion
312
467
  //#region src/upload.ts
313
468
  const UPLOAD_CONCURRENCY = 8;
@@ -480,11 +635,11 @@ function uniqueByHash(snapshots) {
480
635
  async function uploadCommand(dir, options) {
481
636
  const env = process.env;
482
637
  if (!(await stat(dir).catch(() => void 0))?.isDirectory()) throw new Error(`Not a directory: ${dir}`);
483
- const shard = options.shard ?? parseShard(env.STATEOFPIXEL_SHARD ?? "1/1");
484
- const buildName = options.buildName ?? env.STATEOFPIXEL_BUILD_NAME ?? "default";
485
- const nonce = options.nonce ?? env.STATEOFPIXEL_NONCE ?? defaultNonce(env);
638
+ const shard = options.shard ?? parseShard(env[ENV.shard] ?? "1/1");
639
+ const buildName = options.buildName ?? env[ENV.buildName] ?? "default";
640
+ const nonce = options.nonce ?? env[ENV.nonce] ?? defaultNonce(env);
486
641
  if (nonce === null && shard.total !== 1) throw new Error("Set --nonce so every shard joins the same build.");
487
- const git = await readGitInfo(env, process.cwd(), options.baselineBranch ?? env.STATEOFPIXEL_BASELINE_BRANCH);
642
+ const git = await readGitInfo(env, process.cwd(), options.baselineBranch ?? env[ENV.baselineBranch]);
488
643
  if (options.dryRun) {
489
644
  const snapshots = await readSnapshots(dir);
490
645
  console.log(`stateofpixel dry run ${git.branch} vs ${git.baselineBranch}`);
@@ -571,5 +726,5 @@ function parseShard(value) {
571
726
  }
572
727
 
573
728
  //#endregion
574
- export { readPngSize as _, defaultNonce as a, resolveToken as c, createApiClient as d, isRateLimited as f, collectSnapshots as g, createDiffEngine as h, waitForFinalize as i, ApiError as l, formatCounts as m, uploadCommand as n, readCiInfo as o, isServerError as p, metadataFile as r, readGitInfo as s, parseShard as t, DEFAULT_API_URL as u, sha256 as v, mapConcurrent as y };
575
- //# sourceMappingURL=upload-DKzFVTAz.mjs.map
729
+ export { createDiffEngine as _, COMMANDS as a, sha256 as b, readCiInfo as c, ApiError as d, DEFAULT_API_URL as f, formatCounts as g, isServerError as h, waitForFinalize as i, readGitInfo as l, isRateLimited as m, uploadCommand as n, ENV as o, createApiClient as p, metadataFile as r, defaultNonce as s, parseShard as t, resolveToken as u, collectSnapshots as v, mapConcurrent as x, readPngSize as y };
730
+ //# sourceMappingURL=upload-CmJjvPgD.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-CmJjvPgD.mjs","names":[],"sources":["../src/map-concurrent.ts","../src/png.ts","../src/snapshots.ts","../src/diff/odiff.ts","../src/diff/pixelmatch.ts","../src/diff/engine.ts","../src/format.ts","../src/api.ts","../src/ci-env.ts","../src/reference.ts","../src/upload.ts","../src/commands/upload.ts"],"sourcesContent":["export async function mapConcurrent<Item, Result>(\n items: Item[],\n concurrency: number,\n fn: (item: Item, index: number) => Promise<Result>,\n): Promise<Result[]> {\n const results = new Array<Result>(items.length);\n let nextIndex = 0;\n\n async function worker() {\n while (nextIndex < items.length) {\n const index = nextIndex++;\n results[index] = await fn(items[index] as Item, index);\n }\n }\n\n await Promise.all(\n Array.from({ length: Math.min(concurrency, items.length) }, worker),\n );\n return results;\n}\n","import { createHash } from \"node:crypto\";\n\nconst PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);\n\nexport function sha256(bytes: Buffer): string {\n return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\nexport function readPngSize(bytes: Buffer): { width: number; height: number } {\n if (bytes.length < 24 || !bytes.subarray(0, 8).equals(PNG_SIGNATURE)) {\n throw new Error(\"Not a PNG file\");\n }\n return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };\n}\n","import { readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport async function collectSnapshots(\n dir: string,\n): Promise<Map<string, string>> {\n const entries = await readdir(dir, { recursive: true, withFileTypes: true });\n const snapshots = new Map<string, string>();\n\n for (const entry of entries) {\n if (!entry.isFile() || !entry.name.toLowerCase().endsWith(\".png\")) {\n continue;\n }\n const filePath = path.join(entry.parentPath, entry.name);\n snapshots.set(snapshotName(dir, filePath), filePath);\n }\n\n return new Map(\n [...snapshots].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n );\n}\n\nfunction snapshotName(dir: string, filePath: string): string {\n const relativePath = path.relative(dir, filePath).split(path.sep).join(\"/\");\n return relativePath.slice(0, -\".png\".length);\n}\n","import { open } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { readPngSize } from \"../png\";\nimport type { DiffEngine } from \"./engine\";\n\nexport async function createOdiffEngine(): Promise<DiffEngine> {\n const require = createRequire(import.meta.url);\n const { findBinary } = require(\"odiff-bin/binary.js\") as {\n findBinary(): string;\n };\n findBinary();\n const { compare } = await import(\"odiff-bin\");\n\n return {\n name: \"odiff\",\n async diff(basePath, newPath, diffPath, options) {\n const result = await compare(basePath, newPath, diffPath, {\n threshold: options.threshold,\n antialiasing: !options.includeAA,\n outputDiffMask: true,\n });\n\n if (result.match) {\n return { diffPixels: 0, diffRatio: 0 };\n }\n if (result.reason === \"pixel-diff\") {\n const [base, next] = await Promise.all([\n readPngSizeFromFile(basePath),\n readPngSizeFromFile(newPath),\n ]);\n const pixels =\n Math.max(base.width, next.width) * Math.max(base.height, next.height);\n return {\n diffPixels: result.diffCount,\n diffRatio: result.diffCount / pixels,\n };\n }\n throw new Error(`odiff could not compare ${newPath}: ${result.reason}`);\n },\n };\n}\n\nasync function readPngSizeFromFile(\n filePath: string,\n): Promise<{ width: number; height: number }> {\n const file = await open(filePath);\n try {\n const { buffer } = await file.read(Buffer.alloc(24), 0, 24, 0);\n return readPngSize(buffer);\n } finally {\n await file.close();\n }\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\nimport type { DiffEngine } from \"./engine\";\n\nexport function createPixelmatchEngine(): DiffEngine {\n return {\n name: \"pixelmatch\",\n async diff(basePath, newPath, diffPath, options) {\n const [base, next] = await Promise.all([\n readPng(basePath),\n readPng(newPath),\n ]);\n const width = Math.max(base.width, next.width);\n const height = Math.max(base.height, next.height);\n const diff = new PNG({ width, height });\n\n const diffPixels = pixelmatch(\n padTo(base, width, height),\n padTo(next, width, height),\n diff.data,\n width,\n height,\n {\n threshold: options.threshold,\n includeAA: options.includeAA,\n diffMask: true,\n },\n );\n\n if (diffPixels > 0) {\n await writeFile(diffPath, PNG.sync.write(diff));\n }\n return { diffPixels, diffRatio: diffPixels / (width * height) };\n },\n };\n}\n\nasync function readPng(filePath: string): Promise<PNG> {\n return PNG.sync.read(await readFile(filePath));\n}\n\nfunction padTo(image: PNG, width: number, height: number): Uint8Array {\n if (image.width === width && image.height === height) {\n return image.data;\n }\n const padded = new Uint8Array(width * height * 4);\n const rowBytes = image.width * 4;\n for (let y = 0; y < image.height; y++) {\n padded.set(\n image.data.subarray(y * rowBytes, (y + 1) * rowBytes),\n y * width * 4,\n );\n }\n return padded;\n}\n","import { createOdiffEngine } from \"./odiff\";\nimport { createPixelmatchEngine } from \"./pixelmatch\";\n\nexport type DiffOptions = {\n threshold: number;\n includeAA: boolean;\n};\n\nexport type DiffResult = {\n diffPixels: number;\n diffRatio: number;\n};\n\nexport type DiffEngine = {\n name: \"odiff\" | \"pixelmatch\";\n diff(\n basePath: string,\n newPath: string,\n diffPath: string,\n options: DiffOptions,\n ): Promise<DiffResult>;\n};\n\nexport async function createDiffEngine(): Promise<DiffEngine> {\n try {\n return await createOdiffEngine();\n } catch {\n return createPixelmatchEngine();\n }\n}\n","import type { BuildCounts } from \"./api\";\n\nexport function formatCount(count: number): string {\n return count.toLocaleString(\"en-US\");\n}\n\nexport function formatCounts(\n total: number,\n counts: Pick<BuildCounts, \"unchanged\" | \"changed\" | \"added\" | \"removed\"> &\n Partial<Pick<BuildCounts, \"failed\">>,\n): string {\n const failed = counts.failed ?? 0;\n return ` ${formatCount(total)} snapshots ${formatCount(counts.unchanged)} unchanged ${formatCount(counts.changed)} changed ${formatCount(counts.added)} added ${formatCount(counts.removed)} removed${failed > 0 ? ` ${formatCount(failed)} failed` : \"\"}`;\n}\n","export const DEFAULT_API_URL =\n \"https://graceful-dogfish-423.convex.site/api/v1\";\n\nexport class ApiError extends Error {\n constructor(\n readonly status: number,\n readonly code: string,\n message: string,\n ) {\n super(message);\n }\n}\n\nexport type SnapshotLookup = {\n name: string;\n status: \"unchanged\" | \"changed\" | \"added\";\n baselineUrl?: string;\n uploadUrl?: string;\n};\n\nexport type CreateBuildResponse = {\n buildId: string;\n buildNumber: number;\n shardIndex: number;\n url: string;\n diff: { threshold: number; includeAA: boolean };\n baseline: { buildNumber: number; commit: string } | null;\n snapshots: SnapshotLookup[];\n warnings: string[];\n};\n\nexport type BuildCounts = {\n unchanged: number;\n changed: number;\n added: number;\n removed: number;\n failed: number;\n pending: number;\n approved: number;\n rejected: number;\n};\n\nexport type BuildResponse = {\n buildId: string;\n buildNumber: number;\n url: string;\n status: \"pending\" | \"finalized\" | \"expired\" | \"error\";\n conclusion: \"no_changes\" | \"changes\" | \"approved\" | \"rejected\" | null;\n counts: BuildCounts;\n shards: { done: number; total: number | null };\n};\n\ntype ApiClientOptions = {\n baseUrl: string;\n token: string;\n fetch?: typeof fetch;\n retries?: number;\n retryDelayMs?: number;\n};\n\nexport type ApiClient = ReturnType<typeof createApiClient>;\n\nexport function createApiClient({\n baseUrl,\n token,\n fetch = globalThis.fetch,\n retries = 3,\n retryDelayMs = 1000,\n}: ApiClientOptions) {\n async function withRetries<Result>(\n fn: () => Promise<Result>,\n ): Promise<Result> {\n for (let attempt = 0; ; attempt++) {\n try {\n return await fn();\n } catch (error) {\n if (attempt >= retries || !isServerError(error)) {\n throw error;\n }\n await sleep(retryDelayMs * 2 ** attempt);\n }\n }\n }\n\n function request<Result>(\n method: \"GET\" | \"POST\",\n path: string,\n body?: unknown,\n ): Promise<Result> {\n return withRetries(async () => {\n const response = await fetch(`${baseUrl}${path}`, {\n method,\n headers: {\n Authorization: `Bearer ${token}`,\n \"Content-Type\": \"application/json\",\n },\n ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n });\n if (!response.ok) {\n throw await toApiError(response);\n }\n return (await response.json()) as Result;\n });\n }\n\n function upload(uploadUrl: string, bytes: Buffer): Promise<string> {\n return withRetries(async () => {\n const response = await fetch(uploadUrl, {\n method: \"POST\",\n headers: { \"Content-Type\": \"image/png\" },\n body: new Uint8Array(bytes),\n });\n if (!response.ok) {\n throw await toApiError(response);\n }\n const { storageId } = (await response.json()) as { storageId: string };\n return storageId;\n });\n }\n\n function download(url: string): Promise<Buffer> {\n return withRetries(async () => {\n const response = await fetch(url);\n if (!response.ok) {\n throw await toApiError(response);\n }\n return Buffer.from(await response.arrayBuffer());\n });\n }\n\n return { request, upload, download };\n}\n\nasync function toApiError(response: Response): Promise<ApiError> {\n const body = (await response.json().catch(() => null)) as {\n error?: { code?: string; message?: string };\n } | null;\n return new ApiError(\n response.status,\n body?.error?.code ?? \"http_error\",\n body?.error?.message ?? `HTTP ${response.status}`,\n );\n}\n\nexport function isServerError(error: unknown): boolean {\n return (\n (error instanceof ApiError && error.status >= 500) ||\n error instanceof TypeError\n );\n}\n\nexport function isRateLimited(error: unknown): error is ApiError {\n return error instanceof ApiError && error.status === 429;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { execFile } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\nconst MAX_ANCESTORS = 100;\nconst OIDC_AUDIENCE = \"stateofpixel\";\n\nexport type Env = Record<string, string | undefined>;\n\nexport type GitInfo = {\n commit: string;\n commitMessage: string;\n branch: string;\n baselineBranch: string;\n prNumber: number | null;\n mergeBase: string | null;\n ancestors: string[];\n};\n\nexport type CiInfo = { provider?: string; runUrl?: string };\n\ntype GithubEvent = {\n pull_request?: {\n number: number;\n head: { sha: string; ref: string };\n base: { ref: string };\n };\n head_commit?: { message: string } | null;\n repository?: { default_branch?: string };\n};\n\nexport async function readGitInfo(\n env: Env,\n cwd: string,\n baselineBranchOverride?: string,\n): Promise<GitInfo> {\n const event = await readGithubEvent(env);\n const pullRequest = event?.pull_request;\n const commit =\n pullRequest?.head.sha ||\n env.GITHUB_SHA ||\n (await git(cwd, \"rev-parse\", \"HEAD\"));\n if (commit === null) {\n throw new Error(\"Could not find the commit. Run inside a git checkout.\");\n }\n const branch =\n pullRequest?.head.ref ||\n env.GITHUB_HEAD_REF ||\n env.GITHUB_REF_NAME ||\n (await git(cwd, \"rev-parse\", \"--abbrev-ref\", \"HEAD\")) ||\n \"HEAD\";\n const baselineBranch =\n baselineBranchOverride ||\n pullRequest?.base.ref ||\n event?.repository?.default_branch ||\n (await defaultBranch(cwd)) ||\n \"main\";\n\n return {\n commit,\n commitMessage:\n (await git(cwd, \"log\", \"-1\", \"--format=%s\", commit)) ??\n event?.head_commit?.message?.split(\"\\n\")[0] ??\n \"\",\n branch,\n baselineBranch,\n prNumber: pullRequest?.number ?? null,\n mergeBase: await git(cwd, \"merge-base\", commit, `origin/${baselineBranch}`),\n ancestors: await ancestors(cwd, commit),\n };\n}\n\nexport function readCiInfo(env: Env): CiInfo {\n if (env.GITHUB_ACTIONS === \"true\") {\n return {\n provider: \"github-actions\",\n runUrl:\n env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY && env.GITHUB_RUN_ID\n ? `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}`\n : undefined,\n };\n }\n return env.CI ? { provider: \"unknown\" } : {};\n}\n\nexport function defaultNonce(env: Env): string | null {\n if (env.GITHUB_RUN_ID) {\n return `${env.GITHUB_RUN_ID}-${env.GITHUB_RUN_ATTEMPT ?? \"1\"}`;\n }\n return null;\n}\n\nexport async function resolveToken(\n env: Env,\n fetchImpl: typeof fetch = fetch,\n): Promise<string> {\n if (env.STATEOFPIXEL_TOKEN) {\n return env.STATEOFPIXEL_TOKEN;\n }\n const requestUrl = env.ACTIONS_ID_TOKEN_REQUEST_URL;\n const requestToken = env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;\n if (!requestUrl || !requestToken) {\n throw new Error(\n \"No token. On GitHub Actions add `permissions: id-token: write`, elsewhere set STATEOFPIXEL_TOKEN.\",\n );\n }\n const url = new URL(requestUrl);\n url.searchParams.set(\"audience\", OIDC_AUDIENCE);\n const response = await fetchImpl(url, {\n headers: { Authorization: `Bearer ${requestToken}` },\n });\n if (!response.ok) {\n throw new Error(\n `GitHub Actions OIDC token request failed with HTTP ${response.status}.`,\n );\n }\n const { value } = (await response.json()) as { value: string };\n return value;\n}\n\nasync function readGithubEvent(env: Env): Promise<GithubEvent | null> {\n if (!env.GITHUB_EVENT_PATH) {\n return null;\n }\n try {\n return JSON.parse(await readFile(env.GITHUB_EVENT_PATH, \"utf8\"));\n } catch {\n return null;\n }\n}\n\nasync function ancestors(cwd: string, commit: string): Promise<string[]> {\n for (const start of [commit, \"HEAD\"]) {\n const output = await git(\n cwd,\n \"rev-list\",\n `--max-count=${MAX_ANCESTORS + 2}`,\n start,\n );\n if (output !== null) {\n return output\n .split(\"\\n\")\n .filter((sha) => sha !== \"\" && sha !== commit)\n .slice(start === \"HEAD\" ? 1 : 0)\n .slice(0, MAX_ANCESTORS);\n }\n }\n return [];\n}\n\nasync function defaultBranch(cwd: string): Promise<string | null> {\n const ref = await git(\n cwd,\n \"symbolic-ref\",\n \"--short\",\n \"refs/remotes/origin/HEAD\",\n );\n return ref?.replace(/^origin\\//, \"\") ?? null;\n}\n\nasync function git(cwd: string, ...args: string[]): Promise<string | null> {\n try {\n const { stdout } = await execFileAsync(\"git\", args, { cwd });\n return stdout.trim();\n } catch {\n return null;\n }\n}\n","export const ENV = {\n buildName: \"STATEOFPIXEL_BUILD_NAME\",\n shard: \"STATEOFPIXEL_SHARD\",\n nonce: \"STATEOFPIXEL_NONCE\",\n baselineBranch: \"STATEOFPIXEL_BASELINE_BRANCH\",\n} as const;\n\nexport type OptionSpec = {\n flags: string;\n description: string;\n default?: string | number | boolean | number[];\n env?: string;\n};\n\nexport type CommandSpec = {\n name: \"compare\" | \"upload\" | \"storybook\" | \"finalize\";\n description: string;\n arguments: { name: string; description: string }[];\n options: OptionSpec[];\n};\n\nconst buildOptions = (dryRun: string): OptionSpec[] => [\n {\n flags: \"--build-name <name>\",\n description: \"separate builds of one project, like storybook\",\n env: ENV.buildName,\n },\n {\n flags: \"--shard <i/n>\",\n description: \"this shard and the shard count, or auto with a finalize step\",\n env: ENV.shard,\n },\n {\n flags: \"--nonce <id>\",\n description: \"shared by every shard of one build\",\n env: ENV.nonce,\n },\n {\n flags: \"--baseline-branch <branch>\",\n description: \"branch to compare against\",\n env: ENV.baselineBranch,\n },\n {\n flags: \"--subset\",\n description: \"only some snapshots ran, do not mark others removed\",\n default: false,\n },\n {\n flags: \"--threshold <number>\",\n description:\n \"color difference threshold, 0 to 1, overrides project settings\",\n },\n {\n flags: \"--strict\",\n description: \"fail when the service is not reachable\",\n default: false,\n },\n { flags: \"--dry-run\", description: dryRun, default: false },\n];\n\nexport const COMMANDS: CommandSpec[] = [\n {\n name: \"upload\",\n description:\n \"Upload a folder of screenshots and compare it with the baseline\",\n arguments: [{ name: \"<dir>\", description: \"folder with screenshots\" }],\n options: buildOptions(\"hash and print the plan, upload nothing\"),\n },\n {\n name: \"storybook\",\n description: \"Capture every story of a built Storybook, then upload\",\n arguments: [\n { name: \"<static-dir>\", description: \"the output of storybook build\" },\n ],\n options: [\n {\n flags: \"--viewports <widths>\",\n description: \"comma separated viewport widths\",\n default: [1280],\n },\n {\n flags: \"--include <glob>\",\n description: \"only stories whose title/name match\",\n },\n {\n flags: \"--exclude <glob>\",\n description: \"skip stories whose title/name match\",\n },\n {\n flags: \"--wait-for-selector <selector>\",\n description: \"wait for this before each screenshot\",\n default: \"#storybook-root > *\",\n },\n {\n flags: \"--delay <ms>\",\n description: \"wait this long before each screenshot\",\n default: 0,\n },\n ...buildOptions(\"capture and print the plan, upload nothing\"),\n ],\n },\n {\n name: \"finalize\",\n description: \"Finish a build whose shards ran with --shard auto\",\n arguments: [],\n options: [\n {\n flags: \"--build-name <name>\",\n description: \"the build name the shards used\",\n env: ENV.buildName,\n },\n {\n flags: \"--nonce <id>\",\n description: \"the nonce the shards used\",\n env: ENV.nonce,\n },\n {\n flags: \"--baseline-branch <branch>\",\n description: \"branch to compare against, for --skip-if-empty\",\n env: ENV.baselineBranch,\n },\n {\n flags: \"--skip-if-empty\",\n description: \"create a build with no changes when no shard ran\",\n default: false,\n },\n {\n flags: \"--strict\",\n description: \"fail when the service is not reachable\",\n default: false,\n },\n ],\n },\n {\n name: \"compare\",\n description: \"Compare a folder of screenshots against a baseline folder\",\n arguments: [\n { name: \"<dir>\", description: \"folder with new screenshots\" },\n {\n name: \"<baseline-dir>\",\n description: \"folder with baseline screenshots\",\n },\n ],\n options: [\n {\n flags: \"--out <dir>\",\n description: \"report folder\",\n default: \"stateofpixel-report\",\n },\n {\n flags: \"--threshold <number>\",\n description: \"color difference threshold, 0 to 1\",\n default: 0.1,\n },\n {\n flags: \"--include-aa\",\n description: \"count anti-aliased pixels as changes\",\n default: false,\n },\n ],\n },\n];\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport { availableParallelism } from \"node:os\";\nimport path from \"node:path\";\nimport type {\n ApiClient,\n BuildResponse,\n CreateBuildResponse,\n SnapshotLookup,\n} from \"./api\";\nimport type { CiInfo, GitInfo } from \"./ci-env\";\nimport type { DiffEngine } from \"./diff/engine\";\nimport { mapConcurrent } from \"./map-concurrent\";\nimport { readPngSize, sha256 } from \"./png\";\nimport { collectSnapshots } from \"./snapshots\";\n\nconst UPLOAD_CONCURRENCY = 8;\nconst FINALIZE_POLLS = 10;\nconst FINALIZE_POLL_MS = 1000;\n\nexport type LocalSnapshot = {\n name: string;\n file: string;\n hash: string;\n bytes: number;\n width: number;\n height: number;\n metadata?: Record<string, unknown>;\n};\n\ntype Upload = {\n hash: string;\n storageId: string;\n kind: \"screenshot\" | \"diff\";\n width: number;\n height: number;\n};\n\nexport type ShardResult = {\n name: string;\n hash: string;\n status: \"unchanged\" | \"changed\" | \"added\" | \"failed\";\n diffHash?: string;\n diffRatio?: number;\n diffPixels?: number;\n metadata?: Record<string, unknown>;\n};\n\nexport type Shard = { index: number | null; total: number | null };\n\nexport type UploadInput = {\n dir: string;\n workDir: string;\n api: ApiClient;\n engine: DiffEngine;\n buildName: string;\n nonce: string;\n shard: Shard;\n subset: boolean;\n threshold?: number;\n git: GitInfo;\n ci: CiInfo;\n};\n\nexport type UploadOutput = {\n build: CreateBuildResponse;\n results: ShardResult[];\n uploadedImages: number;\n uploadedBytes: number;\n failedUploads: string[];\n final: BuildResponse | null;\n};\n\nexport async function readSnapshots(dir: string): Promise<LocalSnapshot[]> {\n const files = await collectSnapshots(dir);\n return mapConcurrent(\n [...files],\n availableParallelism(),\n async ([name, file]) => {\n const bytes = await readFile(file);\n const metadata = await readMetadata(file);\n return {\n name,\n file,\n hash: sha256(bytes),\n bytes: bytes.length,\n ...readPngSize(bytes),\n ...(metadata === undefined ? {} : { metadata }),\n };\n },\n );\n}\n\nexport function metadataFile(pngFile: string): string {\n return `${pngFile.slice(0, -\".png\".length)}.meta.json`;\n}\n\nasync function readMetadata(\n pngFile: string,\n): Promise<Record<string, unknown> | undefined> {\n const text = await readFile(metadataFile(pngFile), \"utf8\").catch(\n () => undefined,\n );\n return text === undefined ? undefined : JSON.parse(text);\n}\n\nexport async function uploadDirectory(\n input: UploadInput,\n): Promise<UploadOutput> {\n const snapshots = await readSnapshots(input.dir);\n const build = await input.api.request<CreateBuildResponse>(\n \"POST\",\n \"/builds\",\n {\n buildName: input.buildName,\n nonce: input.nonce,\n shard: input.shard,\n subset: input.subset,\n git: input.git,\n ci: input.ci,\n snapshots: snapshots.map(({ name, hash, bytes, width, height }) => ({\n name,\n hash,\n bytes,\n width,\n height,\n })),\n },\n );\n const lookups = new Map(\n build.snapshots.map((lookup) => [lookup.name, lookup]),\n );\n\n const failedUploads: string[] = [];\n const uploads: Upload[] = [];\n let uploadedBytes = 0;\n const pendingUploads = uniqueByHash(\n snapshots.filter((snapshot) => lookups.get(snapshot.name)?.uploadUrl),\n );\n await mapConcurrent(pendingUploads, UPLOAD_CONCURRENCY, async (snapshot) => {\n const uploadUrl = lookups.get(snapshot.name)?.uploadUrl as string;\n try {\n const bytes = await readFile(snapshot.file);\n uploads.push({\n hash: snapshot.hash,\n storageId: await input.api.upload(uploadUrl, bytes),\n kind: \"screenshot\",\n width: snapshot.width,\n height: snapshot.height,\n });\n uploadedBytes += bytes.length;\n } catch {\n failedUploads.push(snapshot.hash);\n }\n });\n\n const failedScreenshots = new Set(failedUploads);\n const options = {\n threshold: input.threshold ?? build.diff.threshold,\n includeAA: build.diff.includeAA,\n };\n const diffs = new Map<\n string,\n { file: string; hash: string; width: number; height: number }\n >();\n const results = await mapConcurrent(\n snapshots,\n availableParallelism(),\n async (snapshot, index): Promise<ShardResult> => {\n const lookup = lookups.get(snapshot.name) as SnapshotLookup;\n const base = {\n name: snapshot.name,\n hash: snapshot.hash,\n ...(snapshot.metadata === undefined\n ? {}\n : { metadata: snapshot.metadata }),\n };\n if (failedScreenshots.has(snapshot.hash)) {\n return { ...base, status: \"failed\" };\n }\n if (lookup.status !== \"changed\") {\n return { ...base, status: lookup.status };\n }\n if (lookup.baselineUrl === undefined) {\n return { ...base, status: \"changed\" };\n }\n try {\n const baselineFile = path.join(input.workDir, `baseline-${index}.png`);\n const diffFile = path.join(input.workDir, `diff-${index}.png`);\n await writeFile(\n baselineFile,\n await input.api.download(lookup.baselineUrl),\n );\n const { diffPixels, diffRatio } = await input.engine.diff(\n baselineFile,\n snapshot.file,\n diffFile,\n options,\n );\n if (diffPixels === 0) {\n return { ...base, status: \"unchanged\" };\n }\n const diffBytes = await readFile(diffFile);\n const diffHash = sha256(diffBytes);\n diffs.set(diffHash, {\n file: diffFile,\n hash: diffHash,\n ...readPngSize(diffBytes),\n });\n return { ...base, status: \"changed\", diffHash, diffRatio, diffPixels };\n } catch {\n return { ...base, status: \"failed\" };\n }\n },\n );\n\n if (diffs.size > 0) {\n const { uploads: diffTargets } = await input.api.request<{\n uploads: { hash: string; uploadUrl: string }[];\n }>(\"POST\", `/builds/${build.buildId}/upload-urls`, {\n hashes: [...diffs.keys()],\n });\n await mapConcurrent(\n diffTargets,\n UPLOAD_CONCURRENCY,\n async ({ hash, uploadUrl }) => {\n const diff = diffs.get(hash);\n if (diff === undefined) {\n return;\n }\n try {\n const bytes = await readFile(diff.file);\n uploads.push({\n hash,\n storageId: await input.api.upload(uploadUrl, bytes),\n kind: \"diff\",\n width: diff.width,\n height: diff.height,\n });\n uploadedBytes += bytes.length;\n } catch {\n failedUploads.push(hash);\n }\n },\n );\n }\n\n const { rejectedUploads } = await input.api.request<{\n rejectedUploads: string[];\n }>(\"POST\", `/builds/${build.buildId}/shards/${build.shardIndex}/complete`, {\n uploads,\n results,\n });\n failedUploads.push(...rejectedUploads);\n\n return {\n build,\n results,\n uploadedImages: uploads.length,\n uploadedBytes,\n failedUploads,\n final: await waitForFinalize(input.api, build.buildId, false),\n };\n}\n\nexport async function waitForFinalize(\n api: ApiClient,\n buildId: string,\n finalizeRequested: boolean,\n): Promise<BuildResponse | null> {\n for (let poll = 0; poll < FINALIZE_POLLS; poll++) {\n const build = await api.request<BuildResponse>(\"GET\", `/builds/${buildId}`);\n const lastShardDone =\n build.shards.total !== null && build.shards.done >= build.shards.total;\n if (build.status !== \"pending\" || !(finalizeRequested || lastShardDone)) {\n return build.status === \"finalized\" ? build : null;\n }\n await new Promise((resolve) => setTimeout(resolve, FINALIZE_POLL_MS));\n }\n return null;\n}\n\nfunction uniqueByHash(snapshots: LocalSnapshot[]): LocalSnapshot[] {\n return [\n ...new Map(snapshots.map((snapshot) => [snapshot.hash, snapshot])).values(),\n ];\n}\n","import { mkdtemp, rm, stat } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport {\n ApiError,\n createApiClient,\n DEFAULT_API_URL,\n isRateLimited,\n isServerError,\n} from \"../api\";\nimport { defaultNonce, readCiInfo, readGitInfo, resolveToken } from \"../ci-env\";\nimport { createDiffEngine } from \"../diff/engine\";\nimport { formatCount, formatCounts } from \"../format\";\nimport { ENV } from \"../reference\";\nimport {\n readSnapshots,\n type Shard,\n type UploadOutput,\n uploadDirectory,\n} from \"../upload\";\n\nexport type UploadCommandOptions = {\n buildName?: string;\n shard?: Shard;\n nonce?: string;\n baselineBranch?: string;\n subset: boolean;\n threshold?: number;\n strict: boolean;\n dryRun: boolean;\n};\n\nexport async function uploadCommand(\n dir: string,\n options: UploadCommandOptions,\n): Promise<void> {\n const env = process.env;\n const stats = await stat(dir).catch(() => undefined);\n if (!stats?.isDirectory()) {\n throw new Error(`Not a directory: ${dir}`);\n }\n const shard = options.shard ?? parseShard(env[ENV.shard] ?? \"1/1\");\n const buildName = options.buildName ?? env[ENV.buildName] ?? \"default\";\n const nonce = options.nonce ?? env[ENV.nonce] ?? defaultNonce(env);\n if (nonce === null && shard.total !== 1) {\n throw new Error(\"Set --nonce so every shard joins the same build.\");\n }\n const git = await readGitInfo(\n env,\n process.cwd(),\n options.baselineBranch ?? env[ENV.baselineBranch],\n );\n\n if (options.dryRun) {\n const snapshots = await readSnapshots(dir);\n console.log(\n `stateofpixel dry run ${git.branch} vs ${git.baselineBranch}`,\n );\n console.log(` ${formatCount(snapshots.length)} snapshots in ${dir}`);\n console.log(\n ` build ${buildName}, shard ${shard.total === null ? \"auto\" : `${shard.index}/${shard.total}`}, commit ${git.commit.slice(0, 7)}, ${git.ancestors.length} ancestors`,\n );\n return;\n }\n\n const startedAt = performance.now();\n const workDir = await mkdtemp(path.join(tmpdir(), \"stateofpixel-upload-\"));\n let output: UploadOutput;\n try {\n output = await uploadDirectory({\n dir,\n workDir,\n api: createApiClient({\n baseUrl: env.STATEOFPIXEL_API_URL ?? DEFAULT_API_URL,\n token: await resolveToken(env),\n }),\n engine: await createDiffEngine(),\n buildName,\n nonce: nonce ?? `local-${Date.now()}`,\n shard,\n subset: options.subset,\n threshold: options.threshold,\n git,\n ci: readCiInfo(env),\n });\n } catch (error) {\n if (isRateLimited(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, ${error.message} Use --strict to fail instead.`,\n );\n return;\n }\n if (isServerError(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, the service is not reachable (${error instanceof Error ? error.message : error}). Use --strict to fail instead.`,\n );\n return;\n }\n if (error instanceof ApiError) {\n throw new Error(`${error.message} (${error.code})`);\n }\n throw error;\n } finally {\n await rm(workDir, { recursive: true, force: true });\n }\n\n printSummary(output, git.branch, git.baselineBranch, startedAt);\n if (output.failedUploads.length > 0) {\n throw new Error(`${output.failedUploads.length} uploads failed.`);\n }\n}\n\nfunction printSummary(\n output: UploadOutput,\n branch: string,\n baselineBranch: string,\n startedAt: number,\n) {\n const { build, results, final } = output;\n const counts = final?.counts ?? countResults(results);\n const baseline =\n build.baseline === null ? \"no baseline\" : `#${build.baseline.buildNumber}`;\n const seconds = ((performance.now() - startedAt) / 1000).toFixed(1);\n const megabytes = (output.uploadedBytes / 1024 / 1024).toFixed(1);\n console.log(\n `stateofpixel build #${build.buildNumber} ${branch} vs ${baselineBranch} (${baseline})`,\n );\n console.log(formatCounts(results.length, counts));\n console.log(\n ` uploaded ${formatCount(output.uploadedImages)} images (${megabytes} MB) in ${seconds} s`,\n );\n for (const warning of build.warnings) {\n console.log(` warning: ${warning}`);\n }\n console.log(` review: ${build.url}`);\n}\n\nfunction countResults(results: UploadOutput[\"results\"]) {\n const counts = { unchanged: 0, changed: 0, added: 0, removed: 0, failed: 0 };\n for (const result of results) {\n counts[result.status]++;\n }\n return counts;\n}\n\nexport function parseShard(value: string): Shard {\n if (value === \"auto\") {\n return { index: null, total: null };\n }\n const match = /^(\\d+)\\/(\\d+)$/.exec(value);\n const index = Number(match?.[1]);\n const total = Number(match?.[2]);\n if (!match || index < 1 || total < 1 || index > total) {\n throw new InvalidArgumentError(\"Must look like 1/4, or auto.\");\n }\n return { index, total };\n}\n"],"mappings":"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CP,aAAa;EACb,KAAK,IAAI;CACX;CACA;EACE,OAAO;EACP,aAAa;EACb,SAAS;CACX;CACA;EACE,OAAO;EACP,aACE;CACJ;CACA;EACE,OAAO;EACP,aAAa;EACb,SAAS;CACX;CACA;EAAE,OAAO;EAAa,aAAa;EAAQ,SAAS;CAAM;AAC5D;AAEA,MAAa,WAA0B;CACrC;EACE,MAAM;EACN,aACE;EACF,WAAW,CAAC;GAAE,MAAM;GAAS,aAAa;EAA0B,CAAC;EACrE,SAAS,aAAa,yCAAyC;CACjE;CACA;EACE,MAAM;EACN,aAAa;EACb,WAAW,CACT;GAAE,MAAM;GAAgB,aAAa;EAAgC,CACvE;EACA,SAAS;GACP;IACE,OAAO;IACP,aAAa;IACb,SAAS,CAAC,IAAI;GAChB;GACA;IACE,OAAO;IACP,aAAa;GACf;GACA;IACE,OAAO;IACP,aAAa;GACf;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;GACA,GAAG,aAAa,4CAA4C;EAC9D;CACF;CACA;EACE,MAAM;EACN,aAAa;EACb,WAAW,CAAC;EACZ,SAAS;GACP;IACE,OAAO;IACP,aAAa;IACb,KAAK,IAAI;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,KAAK,IAAI;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,KAAK,IAAI;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;EACF;CACF;CACA;EACE,MAAM;EACN,aAAa;EACb,WAAW,CACT;GAAE,MAAM;GAAS,aAAa;EAA8B,GAC5D;GACE,MAAM;GACN,aAAa;EACf,CACF;EACA,SAAS;GACP;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;GACA;IACE,OAAO;IACP,aAAa;IACb,SAAS;GACX;EACF;CACF;AACF;;;;AClJA,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,mBAAmB;AAuDzB,eAAsB,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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stateofpixel",
3
- "version": "1.3.0",
3
+ "version": "1.4.0",
4
4
  "description": "Visual regression testing that runs in your CI",
5
5
  "homepage": "https://stateofpixel.com",
6
6
  "license": "UNLICENSED",
@@ -1 +0,0 @@
1
- {"version":3,"file":"upload-DKzFVTAz.mjs","names":[],"sources":["../src/map-concurrent.ts","../src/png.ts","../src/snapshots.ts","../src/diff/odiff.ts","../src/diff/pixelmatch.ts","../src/diff/engine.ts","../src/format.ts","../src/api.ts","../src/ci-env.ts","../src/upload.ts","../src/commands/upload.ts"],"sourcesContent":["export async function mapConcurrent<Item, Result>(\n items: Item[],\n concurrency: number,\n fn: (item: Item, index: number) => Promise<Result>,\n): Promise<Result[]> {\n const results = new Array<Result>(items.length);\n let nextIndex = 0;\n\n async function worker() {\n while (nextIndex < items.length) {\n const index = nextIndex++;\n results[index] = await fn(items[index] as Item, index);\n }\n }\n\n await Promise.all(\n Array.from({ length: Math.min(concurrency, items.length) }, worker),\n );\n return results;\n}\n","import { createHash } from \"node:crypto\";\n\nconst PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);\n\nexport function sha256(bytes: Buffer): string {\n return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\nexport function readPngSize(bytes: Buffer): { width: number; height: number } {\n if (bytes.length < 24 || !bytes.subarray(0, 8).equals(PNG_SIGNATURE)) {\n throw new Error(\"Not a PNG file\");\n }\n return { width: bytes.readUInt32BE(16), height: bytes.readUInt32BE(20) };\n}\n","import { readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport async function collectSnapshots(\n dir: string,\n): Promise<Map<string, string>> {\n const entries = await readdir(dir, { recursive: true, withFileTypes: true });\n const snapshots = new Map<string, string>();\n\n for (const entry of entries) {\n if (!entry.isFile() || !entry.name.toLowerCase().endsWith(\".png\")) {\n continue;\n }\n const filePath = path.join(entry.parentPath, entry.name);\n snapshots.set(snapshotName(dir, filePath), filePath);\n }\n\n return new Map(\n [...snapshots].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n );\n}\n\nfunction snapshotName(dir: string, filePath: string): string {\n const relativePath = path.relative(dir, filePath).split(path.sep).join(\"/\");\n return relativePath.slice(0, -\".png\".length);\n}\n","import { open } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { readPngSize } from \"../png\";\nimport type { DiffEngine } from \"./engine\";\n\nexport async function createOdiffEngine(): Promise<DiffEngine> {\n const require = createRequire(import.meta.url);\n const { findBinary } = require(\"odiff-bin/binary.js\") as {\n findBinary(): string;\n };\n findBinary();\n const { compare } = await import(\"odiff-bin\");\n\n return {\n name: \"odiff\",\n async diff(basePath, newPath, diffPath, options) {\n const result = await compare(basePath, newPath, diffPath, {\n threshold: options.threshold,\n antialiasing: !options.includeAA,\n outputDiffMask: true,\n });\n\n if (result.match) {\n return { diffPixels: 0, diffRatio: 0 };\n }\n if (result.reason === \"pixel-diff\") {\n const [base, next] = await Promise.all([\n readPngSizeFromFile(basePath),\n readPngSizeFromFile(newPath),\n ]);\n const pixels =\n Math.max(base.width, next.width) * Math.max(base.height, next.height);\n return {\n diffPixels: result.diffCount,\n diffRatio: result.diffCount / pixels,\n };\n }\n throw new Error(`odiff could not compare ${newPath}: ${result.reason}`);\n },\n };\n}\n\nasync function readPngSizeFromFile(\n filePath: string,\n): Promise<{ width: number; height: number }> {\n const file = await open(filePath);\n try {\n const { buffer } = await file.read(Buffer.alloc(24), 0, 24, 0);\n return readPngSize(buffer);\n } finally {\n await file.close();\n }\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport pixelmatch from \"pixelmatch\";\nimport { PNG } from \"pngjs\";\nimport type { DiffEngine } from \"./engine\";\n\nexport function createPixelmatchEngine(): DiffEngine {\n return {\n name: \"pixelmatch\",\n async diff(basePath, newPath, diffPath, options) {\n const [base, next] = await Promise.all([\n readPng(basePath),\n readPng(newPath),\n ]);\n const width = Math.max(base.width, next.width);\n const height = Math.max(base.height, next.height);\n const diff = new PNG({ width, height });\n\n const diffPixels = pixelmatch(\n padTo(base, width, height),\n padTo(next, width, height),\n diff.data,\n width,\n height,\n {\n threshold: options.threshold,\n includeAA: options.includeAA,\n diffMask: true,\n },\n );\n\n if (diffPixels > 0) {\n await writeFile(diffPath, PNG.sync.write(diff));\n }\n return { diffPixels, diffRatio: diffPixels / (width * height) };\n },\n };\n}\n\nasync function readPng(filePath: string): Promise<PNG> {\n return PNG.sync.read(await readFile(filePath));\n}\n\nfunction padTo(image: PNG, width: number, height: number): Uint8Array {\n if (image.width === width && image.height === height) {\n return image.data;\n }\n const padded = new Uint8Array(width * height * 4);\n const rowBytes = image.width * 4;\n for (let y = 0; y < image.height; y++) {\n padded.set(\n image.data.subarray(y * rowBytes, (y + 1) * rowBytes),\n y * width * 4,\n );\n }\n return padded;\n}\n","import { createOdiffEngine } from \"./odiff\";\nimport { createPixelmatchEngine } from \"./pixelmatch\";\n\nexport type DiffOptions = {\n threshold: number;\n includeAA: boolean;\n};\n\nexport type DiffResult = {\n diffPixels: number;\n diffRatio: number;\n};\n\nexport type DiffEngine = {\n name: \"odiff\" | \"pixelmatch\";\n diff(\n basePath: string,\n newPath: string,\n diffPath: string,\n options: DiffOptions,\n ): Promise<DiffResult>;\n};\n\nexport async function createDiffEngine(): Promise<DiffEngine> {\n try {\n return await createOdiffEngine();\n } catch {\n return createPixelmatchEngine();\n }\n}\n","import type { BuildCounts } from \"./api\";\n\nexport function formatCount(count: number): string {\n return count.toLocaleString(\"en-US\");\n}\n\nexport function formatCounts(\n total: number,\n counts: Pick<BuildCounts, \"unchanged\" | \"changed\" | \"added\" | \"removed\"> &\n Partial<Pick<BuildCounts, \"failed\">>,\n): string {\n const failed = counts.failed ?? 0;\n return ` ${formatCount(total)} snapshots ${formatCount(counts.unchanged)} unchanged ${formatCount(counts.changed)} changed ${formatCount(counts.added)} added ${formatCount(counts.removed)} removed${failed > 0 ? ` ${formatCount(failed)} failed` : \"\"}`;\n}\n","export const DEFAULT_API_URL =\n \"https://graceful-dogfish-423.convex.site/api/v1\";\n\nexport class ApiError extends Error {\n constructor(\n readonly status: number,\n readonly code: string,\n message: string,\n ) {\n super(message);\n }\n}\n\nexport type SnapshotLookup = {\n name: string;\n status: \"unchanged\" | \"changed\" | \"added\";\n baselineUrl?: string;\n uploadUrl?: string;\n};\n\nexport type CreateBuildResponse = {\n buildId: string;\n buildNumber: number;\n shardIndex: number;\n url: string;\n diff: { threshold: number; includeAA: boolean };\n baseline: { buildNumber: number; commit: string } | null;\n snapshots: SnapshotLookup[];\n warnings: string[];\n};\n\nexport type BuildCounts = {\n unchanged: number;\n changed: number;\n added: number;\n removed: number;\n failed: number;\n pending: number;\n approved: number;\n rejected: number;\n};\n\nexport type BuildResponse = {\n buildId: string;\n buildNumber: number;\n url: string;\n status: \"pending\" | \"finalized\" | \"expired\" | \"error\";\n conclusion: \"no_changes\" | \"changes\" | \"approved\" | \"rejected\" | null;\n counts: BuildCounts;\n shards: { done: number; total: number | null };\n};\n\ntype ApiClientOptions = {\n baseUrl: string;\n token: string;\n fetch?: typeof fetch;\n retries?: number;\n retryDelayMs?: number;\n};\n\nexport type ApiClient = ReturnType<typeof createApiClient>;\n\nexport function createApiClient({\n baseUrl,\n token,\n fetch = globalThis.fetch,\n retries = 3,\n retryDelayMs = 1000,\n}: ApiClientOptions) {\n async function withRetries<Result>(\n fn: () => Promise<Result>,\n ): Promise<Result> {\n for (let attempt = 0; ; attempt++) {\n try {\n return await fn();\n } catch (error) {\n if (attempt >= retries || !isServerError(error)) {\n throw error;\n }\n await sleep(retryDelayMs * 2 ** attempt);\n }\n }\n }\n\n function request<Result>(\n method: \"GET\" | \"POST\",\n path: string,\n body?: unknown,\n ): Promise<Result> {\n return withRetries(async () => {\n const response = await fetch(`${baseUrl}${path}`, {\n method,\n headers: {\n Authorization: `Bearer ${token}`,\n \"Content-Type\": \"application/json\",\n },\n ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n });\n if (!response.ok) {\n throw await toApiError(response);\n }\n return (await response.json()) as Result;\n });\n }\n\n function upload(uploadUrl: string, bytes: Buffer): Promise<string> {\n return withRetries(async () => {\n const response = await fetch(uploadUrl, {\n method: \"POST\",\n headers: { \"Content-Type\": \"image/png\" },\n body: new Uint8Array(bytes),\n });\n if (!response.ok) {\n throw await toApiError(response);\n }\n const { storageId } = (await response.json()) as { storageId: string };\n return storageId;\n });\n }\n\n function download(url: string): Promise<Buffer> {\n return withRetries(async () => {\n const response = await fetch(url);\n if (!response.ok) {\n throw await toApiError(response);\n }\n return Buffer.from(await response.arrayBuffer());\n });\n }\n\n return { request, upload, download };\n}\n\nasync function toApiError(response: Response): Promise<ApiError> {\n const body = (await response.json().catch(() => null)) as {\n error?: { code?: string; message?: string };\n } | null;\n return new ApiError(\n response.status,\n body?.error?.code ?? \"http_error\",\n body?.error?.message ?? `HTTP ${response.status}`,\n );\n}\n\nexport function isServerError(error: unknown): boolean {\n return (\n (error instanceof ApiError && error.status >= 500) ||\n error instanceof TypeError\n );\n}\n\nexport function isRateLimited(error: unknown): error is ApiError {\n return error instanceof ApiError && error.status === 429;\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { execFile } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\nconst MAX_ANCESTORS = 100;\nconst OIDC_AUDIENCE = \"stateofpixel\";\n\nexport type Env = Record<string, string | undefined>;\n\nexport type GitInfo = {\n commit: string;\n commitMessage: string;\n branch: string;\n baselineBranch: string;\n prNumber: number | null;\n mergeBase: string | null;\n ancestors: string[];\n};\n\nexport type CiInfo = { provider?: string; runUrl?: string };\n\ntype GithubEvent = {\n pull_request?: {\n number: number;\n head: { sha: string; ref: string };\n base: { ref: string };\n };\n head_commit?: { message: string } | null;\n repository?: { default_branch?: string };\n};\n\nexport async function readGitInfo(\n env: Env,\n cwd: string,\n baselineBranchOverride?: string,\n): Promise<GitInfo> {\n const event = await readGithubEvent(env);\n const pullRequest = event?.pull_request;\n const commit =\n pullRequest?.head.sha ||\n env.GITHUB_SHA ||\n (await git(cwd, \"rev-parse\", \"HEAD\"));\n if (commit === null) {\n throw new Error(\"Could not find the commit. Run inside a git checkout.\");\n }\n const branch =\n pullRequest?.head.ref ||\n env.GITHUB_HEAD_REF ||\n env.GITHUB_REF_NAME ||\n (await git(cwd, \"rev-parse\", \"--abbrev-ref\", \"HEAD\")) ||\n \"HEAD\";\n const baselineBranch =\n baselineBranchOverride ||\n pullRequest?.base.ref ||\n event?.repository?.default_branch ||\n (await defaultBranch(cwd)) ||\n \"main\";\n\n return {\n commit,\n commitMessage:\n (await git(cwd, \"log\", \"-1\", \"--format=%s\", commit)) ??\n event?.head_commit?.message?.split(\"\\n\")[0] ??\n \"\",\n branch,\n baselineBranch,\n prNumber: pullRequest?.number ?? null,\n mergeBase: await git(cwd, \"merge-base\", commit, `origin/${baselineBranch}`),\n ancestors: await ancestors(cwd, commit),\n };\n}\n\nexport function readCiInfo(env: Env): CiInfo {\n if (env.GITHUB_ACTIONS === \"true\") {\n return {\n provider: \"github-actions\",\n runUrl:\n env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY && env.GITHUB_RUN_ID\n ? `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}`\n : undefined,\n };\n }\n return env.CI ? { provider: \"unknown\" } : {};\n}\n\nexport function defaultNonce(env: Env): string | null {\n if (env.GITHUB_RUN_ID) {\n return `${env.GITHUB_RUN_ID}-${env.GITHUB_RUN_ATTEMPT ?? \"1\"}`;\n }\n return null;\n}\n\nexport async function resolveToken(\n env: Env,\n fetchImpl: typeof fetch = fetch,\n): Promise<string> {\n if (env.STATEOFPIXEL_TOKEN) {\n return env.STATEOFPIXEL_TOKEN;\n }\n const requestUrl = env.ACTIONS_ID_TOKEN_REQUEST_URL;\n const requestToken = env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;\n if (!requestUrl || !requestToken) {\n throw new Error(\n \"No token. On GitHub Actions add `permissions: id-token: write`, elsewhere set STATEOFPIXEL_TOKEN.\",\n );\n }\n const url = new URL(requestUrl);\n url.searchParams.set(\"audience\", OIDC_AUDIENCE);\n const response = await fetchImpl(url, {\n headers: { Authorization: `Bearer ${requestToken}` },\n });\n if (!response.ok) {\n throw new Error(\n `GitHub Actions OIDC token request failed with HTTP ${response.status}.`,\n );\n }\n const { value } = (await response.json()) as { value: string };\n return value;\n}\n\nasync function readGithubEvent(env: Env): Promise<GithubEvent | null> {\n if (!env.GITHUB_EVENT_PATH) {\n return null;\n }\n try {\n return JSON.parse(await readFile(env.GITHUB_EVENT_PATH, \"utf8\"));\n } catch {\n return null;\n }\n}\n\nasync function ancestors(cwd: string, commit: string): Promise<string[]> {\n for (const start of [commit, \"HEAD\"]) {\n const output = await git(\n cwd,\n \"rev-list\",\n `--max-count=${MAX_ANCESTORS + 2}`,\n start,\n );\n if (output !== null) {\n return output\n .split(\"\\n\")\n .filter((sha) => sha !== \"\" && sha !== commit)\n .slice(start === \"HEAD\" ? 1 : 0)\n .slice(0, MAX_ANCESTORS);\n }\n }\n return [];\n}\n\nasync function defaultBranch(cwd: string): Promise<string | null> {\n const ref = await git(\n cwd,\n \"symbolic-ref\",\n \"--short\",\n \"refs/remotes/origin/HEAD\",\n );\n return ref?.replace(/^origin\\//, \"\") ?? null;\n}\n\nasync function git(cwd: string, ...args: string[]): Promise<string | null> {\n try {\n const { stdout } = await execFileAsync(\"git\", args, { cwd });\n return stdout.trim();\n } catch {\n return null;\n }\n}\n","import { readFile, writeFile } from \"node:fs/promises\";\nimport { availableParallelism } from \"node:os\";\nimport path from \"node:path\";\nimport type {\n ApiClient,\n BuildResponse,\n CreateBuildResponse,\n SnapshotLookup,\n} from \"./api\";\nimport type { CiInfo, GitInfo } from \"./ci-env\";\nimport type { DiffEngine } from \"./diff/engine\";\nimport { mapConcurrent } from \"./map-concurrent\";\nimport { readPngSize, sha256 } from \"./png\";\nimport { collectSnapshots } from \"./snapshots\";\n\nconst UPLOAD_CONCURRENCY = 8;\nconst FINALIZE_POLLS = 10;\nconst FINALIZE_POLL_MS = 1000;\n\nexport type LocalSnapshot = {\n name: string;\n file: string;\n hash: string;\n bytes: number;\n width: number;\n height: number;\n metadata?: Record<string, unknown>;\n};\n\ntype Upload = {\n hash: string;\n storageId: string;\n kind: \"screenshot\" | \"diff\";\n width: number;\n height: number;\n};\n\nexport type ShardResult = {\n name: string;\n hash: string;\n status: \"unchanged\" | \"changed\" | \"added\" | \"failed\";\n diffHash?: string;\n diffRatio?: number;\n diffPixels?: number;\n metadata?: Record<string, unknown>;\n};\n\nexport type Shard = { index: number | null; total: number | null };\n\nexport type UploadInput = {\n dir: string;\n workDir: string;\n api: ApiClient;\n engine: DiffEngine;\n buildName: string;\n nonce: string;\n shard: Shard;\n subset: boolean;\n threshold?: number;\n git: GitInfo;\n ci: CiInfo;\n};\n\nexport type UploadOutput = {\n build: CreateBuildResponse;\n results: ShardResult[];\n uploadedImages: number;\n uploadedBytes: number;\n failedUploads: string[];\n final: BuildResponse | null;\n};\n\nexport async function readSnapshots(dir: string): Promise<LocalSnapshot[]> {\n const files = await collectSnapshots(dir);\n return mapConcurrent(\n [...files],\n availableParallelism(),\n async ([name, file]) => {\n const bytes = await readFile(file);\n const metadata = await readMetadata(file);\n return {\n name,\n file,\n hash: sha256(bytes),\n bytes: bytes.length,\n ...readPngSize(bytes),\n ...(metadata === undefined ? {} : { metadata }),\n };\n },\n );\n}\n\nexport function metadataFile(pngFile: string): string {\n return `${pngFile.slice(0, -\".png\".length)}.meta.json`;\n}\n\nasync function readMetadata(\n pngFile: string,\n): Promise<Record<string, unknown> | undefined> {\n const text = await readFile(metadataFile(pngFile), \"utf8\").catch(\n () => undefined,\n );\n return text === undefined ? undefined : JSON.parse(text);\n}\n\nexport async function uploadDirectory(\n input: UploadInput,\n): Promise<UploadOutput> {\n const snapshots = await readSnapshots(input.dir);\n const build = await input.api.request<CreateBuildResponse>(\n \"POST\",\n \"/builds\",\n {\n buildName: input.buildName,\n nonce: input.nonce,\n shard: input.shard,\n subset: input.subset,\n git: input.git,\n ci: input.ci,\n snapshots: snapshots.map(({ name, hash, bytes, width, height }) => ({\n name,\n hash,\n bytes,\n width,\n height,\n })),\n },\n );\n const lookups = new Map(\n build.snapshots.map((lookup) => [lookup.name, lookup]),\n );\n\n const failedUploads: string[] = [];\n const uploads: Upload[] = [];\n let uploadedBytes = 0;\n const pendingUploads = uniqueByHash(\n snapshots.filter((snapshot) => lookups.get(snapshot.name)?.uploadUrl),\n );\n await mapConcurrent(pendingUploads, UPLOAD_CONCURRENCY, async (snapshot) => {\n const uploadUrl = lookups.get(snapshot.name)?.uploadUrl as string;\n try {\n const bytes = await readFile(snapshot.file);\n uploads.push({\n hash: snapshot.hash,\n storageId: await input.api.upload(uploadUrl, bytes),\n kind: \"screenshot\",\n width: snapshot.width,\n height: snapshot.height,\n });\n uploadedBytes += bytes.length;\n } catch {\n failedUploads.push(snapshot.hash);\n }\n });\n\n const failedScreenshots = new Set(failedUploads);\n const options = {\n threshold: input.threshold ?? build.diff.threshold,\n includeAA: build.diff.includeAA,\n };\n const diffs = new Map<\n string,\n { file: string; hash: string; width: number; height: number }\n >();\n const results = await mapConcurrent(\n snapshots,\n availableParallelism(),\n async (snapshot, index): Promise<ShardResult> => {\n const lookup = lookups.get(snapshot.name) as SnapshotLookup;\n const base = {\n name: snapshot.name,\n hash: snapshot.hash,\n ...(snapshot.metadata === undefined\n ? {}\n : { metadata: snapshot.metadata }),\n };\n if (failedScreenshots.has(snapshot.hash)) {\n return { ...base, status: \"failed\" };\n }\n if (lookup.status !== \"changed\") {\n return { ...base, status: lookup.status };\n }\n if (lookup.baselineUrl === undefined) {\n return { ...base, status: \"changed\" };\n }\n try {\n const baselineFile = path.join(input.workDir, `baseline-${index}.png`);\n const diffFile = path.join(input.workDir, `diff-${index}.png`);\n await writeFile(\n baselineFile,\n await input.api.download(lookup.baselineUrl),\n );\n const { diffPixels, diffRatio } = await input.engine.diff(\n baselineFile,\n snapshot.file,\n diffFile,\n options,\n );\n if (diffPixels === 0) {\n return { ...base, status: \"unchanged\" };\n }\n const diffBytes = await readFile(diffFile);\n const diffHash = sha256(diffBytes);\n diffs.set(diffHash, {\n file: diffFile,\n hash: diffHash,\n ...readPngSize(diffBytes),\n });\n return { ...base, status: \"changed\", diffHash, diffRatio, diffPixels };\n } catch {\n return { ...base, status: \"failed\" };\n }\n },\n );\n\n if (diffs.size > 0) {\n const { uploads: diffTargets } = await input.api.request<{\n uploads: { hash: string; uploadUrl: string }[];\n }>(\"POST\", `/builds/${build.buildId}/upload-urls`, {\n hashes: [...diffs.keys()],\n });\n await mapConcurrent(\n diffTargets,\n UPLOAD_CONCURRENCY,\n async ({ hash, uploadUrl }) => {\n const diff = diffs.get(hash);\n if (diff === undefined) {\n return;\n }\n try {\n const bytes = await readFile(diff.file);\n uploads.push({\n hash,\n storageId: await input.api.upload(uploadUrl, bytes),\n kind: \"diff\",\n width: diff.width,\n height: diff.height,\n });\n uploadedBytes += bytes.length;\n } catch {\n failedUploads.push(hash);\n }\n },\n );\n }\n\n const { rejectedUploads } = await input.api.request<{\n rejectedUploads: string[];\n }>(\"POST\", `/builds/${build.buildId}/shards/${build.shardIndex}/complete`, {\n uploads,\n results,\n });\n failedUploads.push(...rejectedUploads);\n\n return {\n build,\n results,\n uploadedImages: uploads.length,\n uploadedBytes,\n failedUploads,\n final: await waitForFinalize(input.api, build.buildId, false),\n };\n}\n\nexport async function waitForFinalize(\n api: ApiClient,\n buildId: string,\n finalizeRequested: boolean,\n): Promise<BuildResponse | null> {\n for (let poll = 0; poll < FINALIZE_POLLS; poll++) {\n const build = await api.request<BuildResponse>(\"GET\", `/builds/${buildId}`);\n const lastShardDone =\n build.shards.total !== null && build.shards.done >= build.shards.total;\n if (build.status !== \"pending\" || !(finalizeRequested || lastShardDone)) {\n return build.status === \"finalized\" ? build : null;\n }\n await new Promise((resolve) => setTimeout(resolve, FINALIZE_POLL_MS));\n }\n return null;\n}\n\nfunction uniqueByHash(snapshots: LocalSnapshot[]): LocalSnapshot[] {\n return [\n ...new Map(snapshots.map((snapshot) => [snapshot.hash, snapshot])).values(),\n ];\n}\n","import { mkdtemp, rm, stat } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { InvalidArgumentError } from \"commander\";\nimport {\n ApiError,\n createApiClient,\n DEFAULT_API_URL,\n isRateLimited,\n isServerError,\n} from \"../api\";\nimport { defaultNonce, readCiInfo, readGitInfo, resolveToken } from \"../ci-env\";\nimport { createDiffEngine } from \"../diff/engine\";\nimport { formatCount, formatCounts } from \"../format\";\nimport {\n readSnapshots,\n type Shard,\n type UploadOutput,\n uploadDirectory,\n} from \"../upload\";\n\nexport type UploadCommandOptions = {\n buildName?: string;\n shard?: Shard;\n nonce?: string;\n baselineBranch?: string;\n subset: boolean;\n threshold?: number;\n strict: boolean;\n dryRun: boolean;\n};\n\nexport async function uploadCommand(\n dir: string,\n options: UploadCommandOptions,\n): Promise<void> {\n const env = process.env;\n const stats = await stat(dir).catch(() => undefined);\n if (!stats?.isDirectory()) {\n throw new Error(`Not a directory: ${dir}`);\n }\n const shard = options.shard ?? parseShard(env.STATEOFPIXEL_SHARD ?? \"1/1\");\n const buildName =\n options.buildName ?? env.STATEOFPIXEL_BUILD_NAME ?? \"default\";\n const nonce = options.nonce ?? env.STATEOFPIXEL_NONCE ?? defaultNonce(env);\n if (nonce === null && shard.total !== 1) {\n throw new Error(\"Set --nonce so every shard joins the same build.\");\n }\n const git = await readGitInfo(\n env,\n process.cwd(),\n options.baselineBranch ?? env.STATEOFPIXEL_BASELINE_BRANCH,\n );\n\n if (options.dryRun) {\n const snapshots = await readSnapshots(dir);\n console.log(\n `stateofpixel dry run ${git.branch} vs ${git.baselineBranch}`,\n );\n console.log(` ${formatCount(snapshots.length)} snapshots in ${dir}`);\n console.log(\n ` build ${buildName}, shard ${shard.total === null ? \"auto\" : `${shard.index}/${shard.total}`}, commit ${git.commit.slice(0, 7)}, ${git.ancestors.length} ancestors`,\n );\n return;\n }\n\n const startedAt = performance.now();\n const workDir = await mkdtemp(path.join(tmpdir(), \"stateofpixel-upload-\"));\n let output: UploadOutput;\n try {\n output = await uploadDirectory({\n dir,\n workDir,\n api: createApiClient({\n baseUrl: env.STATEOFPIXEL_API_URL ?? DEFAULT_API_URL,\n token: await resolveToken(env),\n }),\n engine: await createDiffEngine(),\n buildName,\n nonce: nonce ?? `local-${Date.now()}`,\n shard,\n subset: options.subset,\n threshold: options.threshold,\n git,\n ci: readCiInfo(env),\n });\n } catch (error) {\n if (isRateLimited(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, ${error.message} Use --strict to fail instead.`,\n );\n return;\n }\n if (isServerError(error) && !options.strict) {\n console.warn(\n `stateofpixel: skipped, the service is not reachable (${error instanceof Error ? error.message : error}). Use --strict to fail instead.`,\n );\n return;\n }\n if (error instanceof ApiError) {\n throw new Error(`${error.message} (${error.code})`);\n }\n throw error;\n } finally {\n await rm(workDir, { recursive: true, force: true });\n }\n\n printSummary(output, git.branch, git.baselineBranch, startedAt);\n if (output.failedUploads.length > 0) {\n throw new Error(`${output.failedUploads.length} uploads failed.`);\n }\n}\n\nfunction printSummary(\n output: UploadOutput,\n branch: string,\n baselineBranch: string,\n startedAt: number,\n) {\n const { build, results, final } = output;\n const counts = final?.counts ?? countResults(results);\n const baseline =\n build.baseline === null ? \"no baseline\" : `#${build.baseline.buildNumber}`;\n const seconds = ((performance.now() - startedAt) / 1000).toFixed(1);\n const megabytes = (output.uploadedBytes / 1024 / 1024).toFixed(1);\n console.log(\n `stateofpixel build #${build.buildNumber} ${branch} vs ${baselineBranch} (${baseline})`,\n );\n console.log(formatCounts(results.length, counts));\n console.log(\n ` uploaded ${formatCount(output.uploadedImages)} images (${megabytes} MB) in ${seconds} s`,\n );\n for (const warning of build.warnings) {\n console.log(` warning: ${warning}`);\n }\n console.log(` review: ${build.url}`);\n}\n\nfunction countResults(results: UploadOutput[\"results\"]) {\n const counts = { unchanged: 0, changed: 0, added: 0, removed: 0, failed: 0 };\n for (const result of results) {\n counts[result.status]++;\n }\n return counts;\n}\n\nexport function parseShard(value: string): Shard {\n if (value === \"auto\") {\n return { index: null, total: null };\n }\n const match = /^(\\d+)\\/(\\d+)$/.exec(value);\n const index = Number(match?.[1]);\n const total = Number(match?.[2]);\n if (!match || index < 1 || total < 1 || index > total) {\n throw new InvalidArgumentError(\"Must look like 1/4, or auto.\");\n }\n return { index, total };\n}\n"],"mappings":"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"}