@cappa/cli 0.11.1 → 0.12.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/dist/index.cjs CHANGED
@@ -35,7 +35,7 @@ let chalk = require("chalk");
35
35
  chalk = __toESM(chalk);
36
36
  let _cappa_server = require("@cappa/server");
37
37
  //#region package.json
38
- var version = "0.11.1";
38
+ var version = "0.12.0";
39
39
  //#endregion
40
40
  //#region src/features/config/getPlugins.ts
41
41
  async function getPlugins(plugins) {
@@ -232,6 +232,100 @@ const filterScreenshots = (screenshots, filters) => {
232
232
  });
233
233
  };
234
234
  //#endregion
235
+ //#region src/utils/collectScreenshots.ts
236
+ const listPngs = async (dir) => Array.fromAsync(await (0, node_fs_promises.glob)(node_path.default.resolve(dir, "**/*.png")));
237
+ /**
238
+ * Read the `actual/`, `expected/` and `diff/` directories of `outputDir` and
239
+ * group them into the screenshot representations used by the CLI commands
240
+ * (including the diff metadata sidecar with the optional interpretation).
241
+ */
242
+ const collectScreenshots = async (outputDir) => {
243
+ const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
244
+ listPngs(node_path.default.resolve(outputDir, "actual")),
245
+ listPngs(node_path.default.resolve(outputDir, "expected")),
246
+ listPngs(node_path.default.resolve(outputDir, "diff"))
247
+ ]);
248
+ return groupScreenshots(actualScreenshots, expectedScreenshots, diffScreenshots, outputDir);
249
+ };
250
+ //#endregion
251
+ //#region src/utils/describeChanges.ts
252
+ const severityColor = (severity) => {
253
+ switch (severity) {
254
+ case "High": return chalk.default.red;
255
+ case "Medium": return chalk.default.yellow;
256
+ case "Low": return chalk.default.green;
257
+ default: return chalk.default.gray;
258
+ }
259
+ };
260
+ /** Human-readable labels for the `changeType` values reported by blazediff. */
261
+ const CHANGE_TYPE_LABELS = {
262
+ Addition: "added",
263
+ Deletion: "removed",
264
+ ColorChange: "color",
265
+ ContentChange: "content",
266
+ Shift: "shifted",
267
+ RenderingNoise: "noise"
268
+ };
269
+ const changeTypeLabel = (changeType) => CHANGE_TYPE_LABELS[changeType] ?? changeType;
270
+ /** `content at center · 0.90% · 360x200 at (420, 300)` */
271
+ const describeRegion = (region) => {
272
+ const { bbox } = region;
273
+ return [
274
+ chalk.default.cyan(changeTypeLabel(region.changeType)),
275
+ `at ${region.position}`,
276
+ chalk.default.dim("·"),
277
+ `${region.percentage.toFixed(2)}%`,
278
+ chalk.default.dim("·"),
279
+ chalk.default.dim(`${bbox.width}x${bbox.height} at (${bbox.x}, ${bbox.y})`)
280
+ ].join(" ");
281
+ };
282
+ /**
283
+ * Build human-readable lines describing the changed screenshots, surfacing the
284
+ * pixel-diff percentage and (when `diff.interpret` is enabled) the structured
285
+ * interpretation: severity, region count, summary and the individual regions
286
+ * with their position and bounding box.
287
+ *
288
+ * Returns an empty array when there are no changed screenshots.
289
+ */
290
+ const describeChanges = (screenshots, options = {}) => {
291
+ const { maxRegions = 5 } = options;
292
+ const changed = screenshots.filter((screenshot) => screenshot.category === "changed");
293
+ if (changed.length === 0) return [];
294
+ const lines = [];
295
+ for (const screenshot of changed) {
296
+ const meta = screenshot.diffMeta;
297
+ const interpretation = meta?.interpretation;
298
+ const parts = [];
299
+ if (interpretation) parts.push(severityColor(interpretation.severity)(interpretation.severity.toUpperCase()));
300
+ if (meta) parts.push(`${meta.percentDifference.toFixed(2)}%`);
301
+ if (interpretation) {
302
+ const { totalRegions } = interpretation;
303
+ parts.push(`${totalRegions} ${totalRegions === 1 ? "region" : "regions"}`);
304
+ }
305
+ const suffix = parts.length > 0 ? ` ${chalk.default.dim("·")} ${parts.join(chalk.default.dim(" · "))}` : "";
306
+ lines.push(`${chalk.default.bold(screenshot.name)}${suffix}`);
307
+ if (interpretation?.summary) lines.push(` ${chalk.default.dim(interpretation.summary)}`);
308
+ const regions = [...interpretation?.regions ?? []].sort((a, b) => b.percentage - a.percentage);
309
+ if (maxRegions > 0 && regions.length > 0) {
310
+ for (const region of regions.slice(0, maxRegions)) lines.push(` ${chalk.default.dim("→")} ${describeRegion(region)}`);
311
+ const remaining = regions.length - maxRegions;
312
+ if (remaining > 0) lines.push(chalk.default.dim(` … and ${remaining} more ${remaining === 1 ? "region" : "regions"}`));
313
+ }
314
+ }
315
+ return lines;
316
+ };
317
+ //#endregion
318
+ //#region src/utils/parseMaxRegions.ts
319
+ /**
320
+ * Parse the `--max-regions` option: a non-negative integer, where `0` disables
321
+ * the per-region breakdown. Falls back to the default when omitted.
322
+ */
323
+ const parseMaxRegions = (value) => {
324
+ if (value === void 0) return 5;
325
+ if (!/^\d+$/.test(value.trim())) throw new commander.InvalidArgumentError("Expected a non-negative integer (0 disables the region breakdown).");
326
+ return Number(value.trim());
327
+ };
328
+ //#endregion
235
329
  //#region src/commands/capture.ts
236
330
  const isObject = (value) => typeof value === "object" && value !== null;
237
331
  const didScreenshotFail = (result) => {
@@ -247,18 +341,10 @@ const didScreenshotFail = (result) => {
247
341
  }
248
342
  return false;
249
343
  };
250
- async function executeOnFailCallback(config) {
344
+ async function executeOnFailCallback(config, groupedScreenshots) {
251
345
  const logger = (0, _cappa_logger.getLogger)();
252
346
  if (!config.onFail) return;
253
- const actualScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
254
- const expectedScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
255
- const diffScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
256
- const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
257
- actualScreenshotsPromise,
258
- expectedScreenshotsPromise,
259
- diffScreenshotsPromise
260
- ]);
261
- const failingScreenshots = (await groupScreenshots(await Array.fromAsync(actualScreenshots), await Array.fromAsync(expectedScreenshots), await Array.fromAsync(diffScreenshots), config.outputDir)).filter((screenshot) => screenshot.category !== "passed").map((screenshot) => ({
347
+ const failingScreenshots = groupedScreenshots.filter((screenshot) => screenshot.category !== "passed").map((screenshot) => ({
262
348
  ...screenshot,
263
349
  absoluteActualPath: "actualPath" in screenshot && screenshot.actualPath ? node_path.default.resolve(config.outputDir, screenshot.actualPath) : void 0,
264
350
  absoluteExpectedPath: "expectedPath" in screenshot && screenshot.expectedPath ? node_path.default.resolve(config.outputDir, screenshot.expectedPath) : void 0,
@@ -432,7 +518,13 @@ const runCapture = async (options = {}) => {
432
518
  logger.warn("Could not check for deleted screenshots:", err);
433
519
  }
434
520
  const isCi = options.ci || process.env.CI === "true";
435
- if (!captureError && isCi) await executeOnFailCallback(config);
521
+ let groupedScreenshots = [];
522
+ if (!captureError && (isCi || hasScreenshotFailure)) try {
523
+ groupedScreenshots = await collectScreenshots(config.outputDir);
524
+ } catch (err) {
525
+ logger.warn("Could not collect screenshot results:", err);
526
+ }
527
+ if (!captureError && isCi) await executeOnFailCallback(config, groupedScreenshots);
436
528
  const duration = formatDuration(performance.now() - captureStart);
437
529
  if (hasScreenshotFailure) {
438
530
  const reportMessage = generateFailureReportMessage(failedScreenshots, deletedScreenshots);
@@ -440,12 +532,17 @@ const runCapture = async (options = {}) => {
440
532
  title: "Failed Screenshots",
441
533
  message: reportMessage
442
534
  });
535
+ const changeLines = describeChanges(groupedScreenshots, { maxRegions: options.maxRegions });
536
+ if (changeLines.length > 0) logger.box({
537
+ title: "Changed Screenshots",
538
+ message: changeLines.join("\n")
539
+ });
443
540
  logger.error(`One or more screenshots failed in ${duration}. See report above for details.`);
444
541
  process.exit(1);
445
542
  } else logger.success(`All plugins completed successfully in ${duration}`);
446
543
  };
447
544
  const registerCaptureCommand = (program) => {
448
- program.command("capture").description("Capture screenshots").option("--ci", "run capture in CI mode and execute onFail callback").option("-f, --filter <pattern>", "only capture tasks whose id matches the given glob pattern").action(async (options) => {
545
+ program.command("capture").description("Capture screenshots").option("--ci", "run capture in CI mode and execute onFail callback").option("-f, --filter <pattern>", "only capture tasks whose id matches the given glob pattern").option("--max-regions <count>", "maximum number of interpreted diff regions listed per changed screenshot (0 to disable)", parseMaxRegions, 5).action(async (options) => {
449
546
  await runCapture(options);
450
547
  });
451
548
  };
@@ -519,62 +616,16 @@ const review = async () => {
519
616
  await server.listen({ port: config.review.port });
520
617
  };
521
618
  //#endregion
522
- //#region src/utils/describeChanges.ts
523
- const severityColor = (severity) => {
524
- switch (severity) {
525
- case "High": return chalk.default.red;
526
- case "Medium": return chalk.default.yellow;
527
- case "Low": return chalk.default.green;
528
- default: return chalk.default.gray;
529
- }
530
- };
531
- /**
532
- * Build human-readable lines describing the changed screenshots, surfacing the
533
- * pixel-diff percentage and (when `diff.interpret` is enabled) the structured
534
- * interpretation: severity, region count and summary.
535
- *
536
- * Returns an empty array when there are no changed screenshots.
537
- */
538
- const describeChanges = (screenshots) => {
539
- const changed = screenshots.filter((screenshot) => screenshot.category === "changed");
540
- if (changed.length === 0) return [];
541
- const lines = [];
542
- for (const screenshot of changed) {
543
- const meta = screenshot.diffMeta;
544
- const interpretation = meta?.interpretation;
545
- const parts = [];
546
- if (interpretation) parts.push(severityColor(interpretation.severity)(interpretation.severity.toUpperCase()));
547
- if (meta) parts.push(`${meta.percentDifference.toFixed(2)}%`);
548
- if (interpretation) {
549
- const { totalRegions } = interpretation;
550
- parts.push(`${totalRegions} ${totalRegions === 1 ? "region" : "regions"}`);
551
- }
552
- const suffix = parts.length > 0 ? ` ${chalk.default.dim("·")} ${parts.join(chalk.default.dim(" · "))}` : "";
553
- lines.push(`${chalk.default.bold(screenshot.name)}${suffix}`);
554
- if (interpretation?.summary) lines.push(` ${chalk.default.dim(interpretation.summary)}`);
555
- }
556
- return lines;
557
- };
558
- //#endregion
559
619
  //#region src/commands/status.ts
560
- const status = async () => {
620
+ const status = async (options = {}) => {
561
621
  const logger = (0, _cappa_logger.getLogger)();
562
- const config = await getConfig();
563
- const actualScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
564
- const expectedScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
565
- const diffScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
566
- const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
567
- actualScreenshotsPromise,
568
- expectedScreenshotsPromise,
569
- diffScreenshotsPromise
570
- ]);
571
- const groupedScreenshots = await groupScreenshots(await Array.fromAsync(actualScreenshots), await Array.fromAsync(expectedScreenshots), await Array.fromAsync(diffScreenshots), config.outputDir);
622
+ const groupedScreenshots = await collectScreenshots((await getConfig()).outputDir);
572
623
  logger.debug("All screenshot information:", JSON.stringify(groupedScreenshots, null, 2));
573
624
  logger.box({
574
625
  title: "Screenshot Status",
575
626
  message: `${chalk.default.yellow("New screenshots:")} ${groupedScreenshots.filter((r) => r.category === "new").length}\n${chalk.default.red("Deleted screenshots:")} ${groupedScreenshots.filter((r) => r.category === "deleted").length}\n${chalk.default.green("Changed screenshots:")} ${groupedScreenshots.filter((r) => r.category === "changed").length}\n${chalk.default.blue("Passed screenshots:")} ${groupedScreenshots.filter((r) => r.category === "passed").length}`
576
627
  });
577
- const changeLines = describeChanges(groupedScreenshots);
628
+ const changeLines = describeChanges(groupedScreenshots, { maxRegions: options.maxRegions });
578
629
  if (changeLines.length > 0) logger.box({
579
630
  title: "Changed Screenshots",
580
631
  message: changeLines.join("\n")
@@ -595,7 +646,7 @@ program.name("cappa").description("Cappa CLI").version(version).option("-l, --lo
595
646
  registerCaptureCommand(program);
596
647
  program.command("review").description("Review screenshots").action(review);
597
648
  program.command("approve").description("Approve screenshots").option("-f, --filter <filter...>", "only approve screenshots whose name includes the provided filter value(s)").action(approve);
598
- program.command("status").description("Get status of screenshots").action(status);
649
+ program.command("status").description("Get status of screenshots").option("--max-regions <count>", "maximum number of interpreted diff regions listed per changed screenshot (0 to disable)", parseMaxRegions, 5).action(status);
599
650
  program.command("init").description("Initialize Cappa in the current directory").action(init);
600
651
  async function run() {
601
652
  await program.parseAsync();
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["path","fs","path","ScreenshotFileSystem","path","ScreenshotFileSystem","ScreenshotTool","path","fs","path","path","Command"],"sources":["../package.json","../src/features/config/getPlugins.ts","../src/features/config/loadConfig.ts","../src/features/config/getConfig.ts","../src/utils/groupScreenshots.ts","../src/commands/approve.ts","../src/commands/capture.ts","../src/features/config/default.ts","../src/commands/init.ts","../src/commands/review.ts","../src/utils/describeChanges.ts","../src/commands/status.ts","../src/index.ts"],"sourcesContent":["","import type { PluginDef, UserConfig } from \"@cappa/core\";\n\nexport async function getPlugins(\n plugins: UserConfig[\"plugins\"],\n): Promise<PluginDef[]> {\n if (!plugins) {\n return [];\n }\n\n const loadedPlugins: PluginDef[] = [];\n\n for (const plugin of plugins) {\n if (typeof plugin === \"function\") {\n // Plugin is a function that returns PluginDef\n const pluginDef = plugin();\n loadedPlugins.push(pluginDef);\n } else {\n // Plugin is already a PluginDef\n loadedPlugins.push(plugin);\n }\n }\n\n return loadedPlugins;\n}\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n return (\n value !== null &&\n typeof value === \"object\" &&\n \"then\" in value &&\n typeof (value as any).then === \"function\"\n );\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { createJiti } from \"jiti\";\n\nexport type ConfigResult = {\n filepath: string;\n config: ReturnType<typeof defineConfig> | UserConfig;\n};\n\nconst tsLoader = async (configFile: string) => {\n const jiti = createJiti(import.meta.url, {\n jsx: {\n runtime: \"automatic\",\n importSource: \"@cappa/core\",\n },\n sourceMaps: true,\n });\n\n const mod = await jiti.import(configFile, { default: true });\n\n return mod;\n};\n\nexport async function loadConfig(): Promise<ConfigResult> {\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n\n if (!fs.existsSync(configPath)) {\n throw new Error(\n \"Config not found. Please create a cappa.config.ts file in the current directory.\",\n );\n }\n\n try {\n const config = await tsLoader(configPath);\n\n if (!config) {\n throw new Error(\n \"Config file is empty or does not export a valid configuration.\",\n );\n }\n\n return {\n filepath: configPath,\n config,\n };\n } catch (error) {\n throw new Error(\n `Failed to load config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n}\n","import type { ConfigEnv, UserConfig } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\nimport type { ConfigResult } from \"./loadConfig\";\nimport { loadConfig } from \"./loadConfig\";\n\ntype ResolvedUserConfig = Required<Omit<UserConfig, \"onFail\">> &\n Pick<UserConfig, \"onFail\">;\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n loadResult?: ConfigResult,\n): Promise<ResolvedUserConfig> {\n const result = loadResult ?? (await loadConfig());\n\n const configData = result?.config;\n let cappaUserConfig: Promise<UserConfig> = Promise.resolve(\n configData as UserConfig,\n );\n\n const configEnv: ConfigEnv = {\n command: process.argv[2],\n mode: process.env.NODE_ENV || \"development\",\n env: process.env,\n };\n\n // for ts or js files\n if (typeof configData === \"function\") {\n const possiblePromise = (configData as (env: ConfigEnv) => any)(configEnv);\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<UserConfig>;\n } else {\n cappaUserConfig = Promise.resolve(possiblePromise as UserConfig);\n }\n }\n\n const userConfig = await cappaUserConfig;\n\n if (!userConfig || typeof userConfig === \"function\") {\n throw new Error(\"Invalid configuration: no valid config found\");\n }\n\n const diffConfig: UserConfig[\"diff\"] = (() => {\n if (userConfig.diff?.type !== \"gmsd\") {\n return {\n type: \"pixel\",\n threshold: userConfig.diff?.threshold ?? 0.1,\n includeAA: userConfig.diff?.includeAA ?? false,\n fastBufferCheck: userConfig.diff?.fastBufferCheck ?? true,\n maxDiffPixels: userConfig.diff?.maxDiffPixels ?? 0,\n maxDiffPercentage: userConfig.diff?.maxDiffPercentage ?? 0,\n interpret: userConfig.diff?.interpret ?? false,\n };\n }\n\n return {\n type: \"gmsd\",\n threshold: userConfig.diff.threshold ?? 0.1,\n downsample: userConfig.diff.downsample ?? 0,\n c: userConfig.diff.c ?? 170,\n };\n })();\n\n const configWithDefaults = {\n outputDir: userConfig.outputDir || \"./screenshots\",\n retries: userConfig.retries || 2,\n concurrency: userConfig.concurrency || 1,\n logConsoleEvents: userConfig.logConsoleEvents ?? true,\n diff: diffConfig,\n plugins: userConfig.plugins ? await getPlugins(userConfig.plugins) : [],\n onFail: userConfig.onFail,\n screenshot: {\n fullPage: userConfig.screenshot?.fullPage ?? true,\n viewport: userConfig.screenshot?.viewport ?? {\n width: 1920,\n height: 1080,\n },\n },\n review: {\n theme: userConfig.review?.theme ?? \"light\",\n port: userConfig.review?.port ?? 3000,\n },\n connectionTimeout: userConfig.connectionTimeout ?? 20000,\n };\n\n getLogger().debug(\n \"Configuration loaded:\",\n JSON.stringify(configWithDefaults, null, 2),\n );\n\n return configWithDefaults;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { readDiffMeta, type Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = async (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n): Promise<Screenshot[]> => {\n const screenshotRepresentations: Screenshot[] = [];\n\n // Build Maps for O(1) lookups instead of O(n) .find() calls\n const expectedByRelativePath = new Map<string, string>();\n for (const screenshot of expectedScreenshots) {\n const relativePath = path.relative(`${outputDir}/expected`, screenshot);\n expectedByRelativePath.set(relativePath, screenshot);\n }\n\n const diffByRelativePath = new Map<string, string>();\n for (const screenshot of diffScreenshots) {\n const relativePath = path.relative(`${outputDir}/diff`, screenshot);\n diffByRelativePath.set(relativePath, screenshot);\n }\n\n const actualRelativePaths = new Set<string>();\n\n for (const screenshot of actualScreenshots) {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n actualRelativePaths.add(relativePath);\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedByRelativePath.get(relativePath);\n const diffScreenshot = diffByRelativePath.get(relativePath);\n\n // Load the diff metadata sidecar (stats + interpretation) for changed\n // screenshots so it can be surfaced in the review UI and CLI.\n const diffMeta = diffScreenshot\n ? await readDiffMeta(diffScreenshot)\n : undefined;\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: buildCategory(expectedScreenshot, diffScreenshot),\n expectedPath: expectedScreenshot\n ? path.relative(outputDir, expectedScreenshot)\n : undefined,\n diffPath: diffScreenshot\n ? path.relative(outputDir, diffScreenshot)\n : undefined,\n actualPath: path.relative(outputDir, screenshot),\n ...(diffMeta ? { diffMeta } : {}),\n } as Screenshot);\n }\n\n for (const expectedScreenshot of expectedScreenshots) {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n\n // If the actual screenshot exists, it means we already added it\n if (actualRelativePaths.has(relativePath)) {\n continue;\n }\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n expectedPath: path.relative(outputDir, expectedScreenshot),\n });\n }\n\n return screenshotRepresentations.sort((a, b) => {\n return CATEGORY_ORDER[a.category] - CATEGORY_ORDER[b.category];\n });\n};\n\nconst buildCategory = (\n expectedScreenshot: string | undefined,\n diffScreenshot: string | undefined,\n) => {\n if (expectedScreenshot && diffScreenshot) {\n return \"changed\";\n }\n if (expectedScreenshot) {\n return \"passed\";\n }\n\n return \"new\";\n};\n\nconst CATEGORY_ORDER: Record<Screenshot[\"category\"], number> = {\n new: 0,\n deleted: 1,\n changed: 2,\n passed: 3,\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport { ScreenshotFileSystem } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const approve = async (options: { filter?: string[] }) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n logger.start(\"Approving screenshots...\");\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n const [actualScreenshots, diffScreenshots, expectedScreenshots] =\n await Promise.all([\n fileSystem.getActualScreenshots(),\n fileSystem.getDiffScreenshots(),\n fileSystem.getExpectedScreenshots(),\n ]);\n\n let screenshotsToApprove = await groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n config.outputDir,\n );\n\n const filters =\n options.filter?.map((filter: string) => filter.toLowerCase()) ?? [];\n\n if (filters.length > 0) {\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = filterScreenshots(screenshotsToApprove, filters);\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n await fileSystem.approveScreenshots(screenshotsToApprove, config.diff);\n\n if (filters.length > 0) {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n } else {\n logger.success(\"All screenshots approved\");\n }\n};\n\nexport const filterScreenshots = (\n screenshots: Screenshot[],\n filters: string[],\n) => {\n return screenshots.filter((screenshot) => {\n return filters.some((filter: string) => {\n const nameMatches = screenshot.name.toLowerCase().includes(filter);\n const pathMatches =\n \"actualPath\" in screenshot &&\n screenshot.actualPath?.toLowerCase().includes(filter);\n return nameMatches || pathMatches;\n });\n });\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { PluginTask } from \"@cappa/core\";\nimport {\n type FailedScreenshot,\n mapWithConcurrency,\n ScreenshotFileSystem,\n ScreenshotTool,\n} from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport type { Command } from \"commander\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\ntype PluginCaptureResult = {\n success?: boolean;\n skipped?: boolean;\n isNew?: boolean;\n error?: unknown;\n filepath?: string;\n storyId?: string;\n storyName?: string;\n [key: string]: unknown;\n};\n\ntype FailedScreenshotInfo = {\n taskId: string;\n taskUrl: string;\n result: PluginCaptureResult;\n pluginName: string;\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null;\n\nexport const didScreenshotFail = (result: unknown): boolean => {\n if (!isObject(result)) {\n return false;\n }\n\n if (\"error\" in result && result.error != null) {\n return true;\n }\n\n if (\"success\" in result) {\n const { success } = result as PluginCaptureResult;\n if (success === false) {\n return true;\n }\n }\n\n if (\"filepath\" in result) {\n const { filepath, skipped } = result as PluginCaptureResult;\n if (!filepath && skipped !== true) {\n return true;\n }\n }\n\n return false;\n};\n\nasync function executeOnFailCallback(\n config: Awaited<ReturnType<typeof getConfig>>,\n): Promise<void> {\n const logger = getLogger();\n\n if (!config.onFail) {\n return;\n }\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const failingScreenshots: FailedScreenshot[] = groupedScreenshots\n .filter((screenshot) => screenshot.category !== \"passed\")\n .map((screenshot) => ({\n ...screenshot,\n absoluteActualPath:\n \"actualPath\" in screenshot && screenshot.actualPath\n ? path.resolve(config.outputDir, screenshot.actualPath)\n : undefined,\n absoluteExpectedPath:\n \"expectedPath\" in screenshot && screenshot.expectedPath\n ? path.resolve(config.outputDir, screenshot.expectedPath)\n : undefined,\n absoluteDiffPath:\n \"diffPath\" in screenshot && screenshot.diffPath\n ? path.resolve(config.outputDir, screenshot.diffPath)\n : undefined,\n }));\n\n if (failingScreenshots.length > 0) {\n logger.debug(\n `Executing onFail callback with ${failingScreenshots.length} failing screenshot(s)`,\n );\n\n try {\n await config.onFail(failingScreenshots);\n } catch (error) {\n logger.error(\"Error executing onFail callback:\", error);\n }\n }\n}\n\nexport function formatProgress(\n completed: number,\n total: number,\n taskId: string,\n): string {\n return `[${completed}/${total}] captured ${taskId}`;\n}\n\nexport function formatDuration(ms: number): string {\n const seconds = Math.floor(ms / 1000);\n const minutes = Math.floor(seconds / 60);\n const remainingSeconds = seconds % 60;\n\n if (minutes > 0) {\n return `${minutes}m ${remainingSeconds}s`;\n }\n return `${(ms / 1000).toFixed(2)}s`;\n}\n\nfunction generateFailureReportMessage(\n failedScreenshots: FailedScreenshotInfo[],\n deletedScreenshots: string[],\n): string {\n const total = failedScreenshots.length + deletedScreenshots.length;\n if (total === 0) {\n return \"\";\n }\n\n const lines: string[] = [];\n lines.push(`${chalk.red(`Total failures: ${total}`)}\\n`);\n\n // Group by plugin\n const byPlugin = new Map<string, FailedScreenshotInfo[]>();\n for (const failed of failedScreenshots) {\n const pluginFailures = byPlugin.get(failed.pluginName);\n if (pluginFailures) {\n pluginFailures.push(failed);\n } else {\n byPlugin.set(failed.pluginName, [failed]);\n }\n }\n\n for (const [pluginName, failures] of byPlugin.entries()) {\n lines.push(`\\n${chalk.bold(`Plugin: ${pluginName}`)}`);\n\n for (const failed of failures) {\n lines.push(`\\n ${chalk.dim(\"Task ID:\")} ${failed.taskId}`);\n\n const result = failed.result;\n if (result.storyName) {\n lines.push(` ${chalk.dim(\"Story:\")} ${result.storyName}`);\n }\n if (result.error) {\n const errorMsg =\n typeof result.error === \"string\"\n ? result.error\n : result.error instanceof Error\n ? result.error.message\n : String(result.error);\n lines.push(` ${chalk.red(\"Error:\")} ${errorMsg}`);\n }\n if (result.success === false) {\n if (result.isNew) {\n lines.push(\n ` ${chalk.yellow(\"Status:\")} New screenshot (no baseline — run 'cappa approve' to accept)`,\n );\n } else {\n lines.push(` ${chalk.red(\"Status:\")} Failed (comparison failed)`);\n }\n }\n if (!result.filepath && result.skipped !== true) {\n lines.push(` ${chalk.red(\"Status:\")} Failed (no filepath generated)`);\n }\n }\n }\n\n if (deletedScreenshots.length > 0) {\n lines.push(`\\n${chalk.bold(\"Deleted baselines:\")}`);\n for (const screenshotPath of deletedScreenshots) {\n lines.push(\n ` ${chalk.dim(\"Name:\")} ${screenshotPath.replace(/\\.png$/, \"\")}`,\n );\n }\n }\n\n return lines.join(\"\\n\");\n}\n\nexport async function getDeletedScreenshots(\n outputDir: string,\n): Promise<string[]> {\n const actualDir = path.resolve(outputDir, \"actual\");\n const expectedDir = path.resolve(outputDir, \"expected\");\n\n const [actualFiles, expectedFiles] = await Promise.all([\n Array.fromAsync(glob(path.join(actualDir, \"**/*.png\"))),\n Array.fromAsync(glob(path.join(expectedDir, \"**/*.png\"))),\n ]);\n\n const actualRelative = new Set(\n actualFiles.map((p) => path.relative(actualDir, p)),\n );\n\n return expectedFiles\n .map((p) => path.relative(expectedDir, p))\n .filter((rel) => !actualRelative.has(rel));\n}\n\ntype CaptureOptions = {\n ci?: boolean;\n filter?: string;\n};\n\nexport function filterTasks(tasks: PluginTask[], filter: string): PluginTask[] {\n return tasks.filter((task) => path.matchesGlob(task.id, filter));\n}\n\nexport function registerSignalHandlers(\n screenshotTool: ScreenshotTool,\n exitFn: (code: number) => void = process.exit,\n): () => void {\n const handleSignal = async () => {\n await screenshotTool.close();\n exitFn(130);\n };\n\n process.once(\"SIGINT\", handleSignal);\n process.once(\"SIGTERM\", handleSignal);\n\n return () => {\n process.off(\"SIGINT\", handleSignal);\n process.off(\"SIGTERM\", handleSignal);\n };\n}\n\nconst runCapture = async (options: CaptureOptions = {}): Promise<void> => {\n const logger = getLogger();\n const captureStart = performance.now();\n\n const config = await getConfig();\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n fileSystem.clearActual();\n fileSystem.clearDiff();\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n retries: config.retries,\n concurrency: config.concurrency,\n logConsoleEvents: config.logConsoleEvents,\n fullPage: config.screenshot?.fullPage ?? true,\n viewport: config.screenshot?.viewport ?? { width: 1920, height: 1080 },\n connectionTimeout: config.connectionTimeout,\n });\n\n const unregisterSignalHandlers = registerSignalHandlers(screenshotTool);\n\n let captureError: unknown;\n let hasScreenshotFailure = false;\n let anyTasksRan = false;\n const failedScreenshots: FailedScreenshotInfo[] = [];\n\n try {\n await screenshotTool.init();\n\n const plugins = (config.plugins || []) as any[];\n\n // Phase 1: Discover all tasks in parallel across plugins\n const pluginTasks = await Promise.all(\n plugins.map(async (plugin) => {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n return { plugin, tasks };\n }),\n );\n\n if (options.filter) {\n logger.box({\n title: \"Filter Active\",\n message: `Only capturing tasks matching: ${chalk.cyan(options.filter)}`,\n });\n\n for (const entry of pluginTasks) {\n const before = entry.tasks.length;\n entry.tasks = filterTasks(entry.tasks, options.filter);\n logger.info(\n `${entry.plugin.name}: ${entry.tasks.length}/${before} tasks match filter`,\n );\n }\n }\n\n for (const { plugin, tasks } of pluginTasks) {\n if (tasks.length === 0) {\n continue;\n }\n\n anyTasksRan = true;\n let pluginHasFailure = false;\n\n logger.debug(\n `Processing ${tasks.length} tasks with concurrency ${screenshotTool.concurrency}`,\n );\n\n let completedTasks = 0;\n const pageContexts = new Map<number, any>();\n\n const allResults = await mapWithConcurrency(\n screenshotTool.concurrency,\n tasks,\n async (task: any, workerIndex) => {\n const page = screenshotTool.getPageFromPool(workerIndex);\n\n if (!pageContexts.has(workerIndex) && plugin.initPage) {\n pageContexts.set(\n workerIndex,\n await plugin.initPage(page, screenshotTool),\n );\n }\n const context = pageContexts.get(workerIndex);\n\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n\n completedTasks++;\n logger.info(formatProgress(completedTasks, tasks.length, task.id));\n\n if (didScreenshotFail(result)) {\n pluginHasFailure = true;\n hasScreenshotFailure = true;\n failedScreenshots.push({\n taskId: task.id,\n taskUrl: task.url,\n result: result as PluginCaptureResult,\n pluginName: plugin.name,\n });\n }\n\n return result;\n },\n );\n\n const results = allResults;\n if (pluginHasFailure) {\n logger.error(\n `Plugin ${plugin.name} completed with failures: ${results.length} results`,\n );\n } else {\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n }\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n captureError = error;\n throw error;\n } finally {\n unregisterSignalHandlers();\n await screenshotTool.close();\n }\n\n let deletedScreenshots: string[] = [];\n if (anyTasksRan) {\n try {\n deletedScreenshots = await getDeletedScreenshots(config.outputDir);\n if (deletedScreenshots.length > 0) {\n hasScreenshotFailure = true;\n }\n } catch (err) {\n logger.warn(\"Could not check for deleted screenshots:\", err);\n }\n }\n\n const isCi = options.ci || process.env.CI === \"true\";\n\n if (!captureError && isCi) {\n await executeOnFailCallback(config);\n }\n\n const duration = formatDuration(performance.now() - captureStart);\n\n if (hasScreenshotFailure) {\n const reportMessage = generateFailureReportMessage(\n failedScreenshots,\n deletedScreenshots,\n );\n logger.box({\n title: \"Failed Screenshots\",\n message: reportMessage,\n });\n logger.error(\n `One or more screenshots failed in ${duration}. See report above for details.`,\n );\n process.exit(1);\n } else {\n logger.success(`All plugins completed successfully in ${duration}`);\n }\n};\n\nexport const registerCaptureCommand = (program: Command): void => {\n program\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .option(\"--ci\", \"run capture in CI mode and execute onFail callback\")\n .option(\n \"-f, --filter <pattern>\",\n \"only capture tasks whose id matches the given glob pattern\",\n )\n .action(async (options: CaptureOptions) => {\n await runCapture(options);\n });\n};\n","export const defaultConfig = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n retries: 3,\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { defaultConfig } from \"../features/config/default\";\n\nexport const init = async () => {\n const logger = getLogger();\n\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n const packageJsonPath = path.resolve(process.cwd(), \"package.json\");\n\n // Create cappa.config.ts\n if (fs.existsSync(configPath)) {\n logger.warn(\"cappa.config.ts already exists, skipping...\");\n } else {\n fs.writeFileSync(configPath, defaultConfig);\n logger.success(\"Created cappa.config.ts\");\n }\n\n // Add scripts to package.json\n if (fs.existsSync(packageJsonPath)) {\n try {\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n\n if (!packageJson.scripts) {\n packageJson.scripts = {};\n }\n\n if (packageJson.scripts.cappa) {\n logger.warn(\n \"'cappa' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts.cappa = \"cappa capture\";\n }\n\n if (packageJson.scripts[\"cappa:review\"]) {\n logger.warn(\n \"'cappa:review' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts[\"cappa:review\"] = \"cappa review\";\n }\n\n fs.writeFileSync(\n packageJsonPath,\n `${JSON.stringify(packageJson, null, 2)}\\n`,\n );\n logger.success(\"Added 'cappa' scripts to package.json\");\n } catch (error) {\n logger.error(\"Failed to update package.json:\", error);\n }\n } else {\n logger.warn(\"package.json not found, skipping script addition\");\n }\n\n logger.success(\"Cappa initialization complete!\");\n logger.warn(\n \"cappa relies on playwright to capture screenshots. Please install playwright and browsers before running cappa.\",\n );\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const review = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const server = await createServer({\n isProd: true,\n outputDir: path.resolve(config.outputDir),\n screenshots: groupedScreenshots,\n logger: getLogger().level >= 4,\n theme: config.review.theme,\n diff: config.diff,\n });\n\n logger.success(\n `Review UI available at http://localhost:${config.review.port}`,\n );\n await server.listen({ port: config.review.port });\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport chalk from \"chalk\";\n\nconst severityColor = (severity: string) => {\n switch (severity) {\n case \"High\":\n return chalk.red;\n case \"Medium\":\n return chalk.yellow;\n case \"Low\":\n return chalk.green;\n default:\n return chalk.gray;\n }\n};\n\n/**\n * Build human-readable lines describing the changed screenshots, surfacing the\n * pixel-diff percentage and (when `diff.interpret` is enabled) the structured\n * interpretation: severity, region count and summary.\n *\n * Returns an empty array when there are no changed screenshots.\n */\nexport const describeChanges = (screenshots: Screenshot[]): string[] => {\n const changed = screenshots.filter(\n (screenshot) => screenshot.category === \"changed\",\n );\n\n if (changed.length === 0) {\n return [];\n }\n\n const lines: string[] = [];\n\n for (const screenshot of changed) {\n const meta = screenshot.diffMeta;\n const interpretation = meta?.interpretation;\n\n const parts: string[] = [];\n if (interpretation) {\n parts.push(\n severityColor(interpretation.severity)(\n interpretation.severity.toUpperCase(),\n ),\n );\n }\n if (meta) {\n parts.push(`${meta.percentDifference.toFixed(2)}%`);\n }\n if (interpretation) {\n const { totalRegions } = interpretation;\n parts.push(\n `${totalRegions} ${totalRegions === 1 ? \"region\" : \"regions\"}`,\n );\n }\n\n const suffix =\n parts.length > 0\n ? ` ${chalk.dim(\"·\")} ${parts.join(chalk.dim(\" · \"))}`\n : \"\";\n lines.push(`${chalk.bold(screenshot.name)}${suffix}`);\n\n if (interpretation?.summary) {\n lines.push(` ${chalk.dim(interpretation.summary)}`);\n }\n }\n\n return lines;\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport { getConfig } from \"../features/config\";\nimport { describeChanges } from \"../utils/describeChanges\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const status = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n logger.debug(\n \"All screenshot information:\",\n JSON.stringify(groupedScreenshots, null, 2),\n );\n\n logger.box({\n title: \"Screenshot Status\",\n message: `${chalk.yellow(\"New screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"new\").length}\\n${chalk.red(\"Deleted screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"deleted\").length}\\n${chalk.green(\"Changed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"changed\").length}\\n${chalk.blue(\"Passed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"passed\").length}`,\n });\n\n const changeLines = describeChanges(groupedScreenshots);\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n if (\n groupedScreenshots.some((s) =>\n [\"new\", \"changed\", \"deleted\"].includes(s.category),\n )\n ) {\n process.exitCode = 1;\n }\n};\n","import { initLogger } from \"@cappa/logger\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { approve } from \"./commands/approve\";\nimport { registerCaptureCommand } from \"./commands/capture\";\nimport { init } from \"./commands/init\";\nimport { review } from \"./commands/review\";\nimport { status } from \"./commands/status\";\n\nconst program = new Command();\n\nprogram\n .name(\"cappa\")\n .description(\"Cappa CLI\")\n .version(version)\n .option(\n \"-l, --log-level <level>\",\n \"set log level (0: fatal and error, 1: warn, 2: log, 3: info, 4: debug, 5: trace)\",\n \"3\",\n )\n .hook(\"preAction\", (thisCommand) => {\n const logLevel = parseInt(thisCommand.opts().logLevel, 10);\n const logger = initLogger(logLevel);\n logger?.debug(`Log level set to: ${logLevel}`);\n });\n\nregisterCaptureCommand(program);\n\nprogram.command(\"review\").description(\"Review screenshots\").action(review);\n\nprogram\n .command(\"approve\")\n .description(\"Approve screenshots\")\n .option(\n \"-f, --filter <filter...>\",\n \"only approve screenshots whose name includes the provided filter value(s)\",\n )\n .action(approve);\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(status);\n\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(init);\n\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["path","fs","path","ScreenshotFileSystem","path","InvalidArgumentError","path","ScreenshotFileSystem","ScreenshotTool","path","fs","path","Command"],"sources":["../package.json","../src/features/config/getPlugins.ts","../src/features/config/loadConfig.ts","../src/features/config/getConfig.ts","../src/utils/groupScreenshots.ts","../src/commands/approve.ts","../src/utils/collectScreenshots.ts","../src/utils/describeChanges.ts","../src/utils/parseMaxRegions.ts","../src/commands/capture.ts","../src/features/config/default.ts","../src/commands/init.ts","../src/commands/review.ts","../src/commands/status.ts","../src/index.ts"],"sourcesContent":["","import type { PluginDef, UserConfig } from \"@cappa/core\";\n\nexport async function getPlugins(\n plugins: UserConfig[\"plugins\"],\n): Promise<PluginDef[]> {\n if (!plugins) {\n return [];\n }\n\n const loadedPlugins: PluginDef[] = [];\n\n for (const plugin of plugins) {\n if (typeof plugin === \"function\") {\n // Plugin is a function that returns PluginDef\n const pluginDef = plugin();\n loadedPlugins.push(pluginDef);\n } else {\n // Plugin is already a PluginDef\n loadedPlugins.push(plugin);\n }\n }\n\n return loadedPlugins;\n}\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n return (\n value !== null &&\n typeof value === \"object\" &&\n \"then\" in value &&\n typeof (value as any).then === \"function\"\n );\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { createJiti } from \"jiti\";\n\nexport type ConfigResult = {\n filepath: string;\n config: ReturnType<typeof defineConfig> | UserConfig;\n};\n\nconst tsLoader = async (configFile: string) => {\n const jiti = createJiti(import.meta.url, {\n jsx: {\n runtime: \"automatic\",\n importSource: \"@cappa/core\",\n },\n sourceMaps: true,\n });\n\n const mod = await jiti.import(configFile, { default: true });\n\n return mod;\n};\n\nexport async function loadConfig(): Promise<ConfigResult> {\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n\n if (!fs.existsSync(configPath)) {\n throw new Error(\n \"Config not found. Please create a cappa.config.ts file in the current directory.\",\n );\n }\n\n try {\n const config = await tsLoader(configPath);\n\n if (!config) {\n throw new Error(\n \"Config file is empty or does not export a valid configuration.\",\n );\n }\n\n return {\n filepath: configPath,\n config,\n };\n } catch (error) {\n throw new Error(\n `Failed to load config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n}\n","import type { ConfigEnv, UserConfig } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\nimport type { ConfigResult } from \"./loadConfig\";\nimport { loadConfig } from \"./loadConfig\";\n\ntype ResolvedUserConfig = Required<Omit<UserConfig, \"onFail\">> &\n Pick<UserConfig, \"onFail\">;\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n loadResult?: ConfigResult,\n): Promise<ResolvedUserConfig> {\n const result = loadResult ?? (await loadConfig());\n\n const configData = result?.config;\n let cappaUserConfig: Promise<UserConfig> = Promise.resolve(\n configData as UserConfig,\n );\n\n const configEnv: ConfigEnv = {\n command: process.argv[2],\n mode: process.env.NODE_ENV || \"development\",\n env: process.env,\n };\n\n // for ts or js files\n if (typeof configData === \"function\") {\n const possiblePromise = (configData as (env: ConfigEnv) => any)(configEnv);\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<UserConfig>;\n } else {\n cappaUserConfig = Promise.resolve(possiblePromise as UserConfig);\n }\n }\n\n const userConfig = await cappaUserConfig;\n\n if (!userConfig || typeof userConfig === \"function\") {\n throw new Error(\"Invalid configuration: no valid config found\");\n }\n\n const diffConfig: UserConfig[\"diff\"] = (() => {\n if (userConfig.diff?.type !== \"gmsd\") {\n return {\n type: \"pixel\",\n threshold: userConfig.diff?.threshold ?? 0.1,\n includeAA: userConfig.diff?.includeAA ?? false,\n fastBufferCheck: userConfig.diff?.fastBufferCheck ?? true,\n maxDiffPixels: userConfig.diff?.maxDiffPixels ?? 0,\n maxDiffPercentage: userConfig.diff?.maxDiffPercentage ?? 0,\n interpret: userConfig.diff?.interpret ?? false,\n };\n }\n\n return {\n type: \"gmsd\",\n threshold: userConfig.diff.threshold ?? 0.1,\n downsample: userConfig.diff.downsample ?? 0,\n c: userConfig.diff.c ?? 170,\n };\n })();\n\n const configWithDefaults = {\n outputDir: userConfig.outputDir || \"./screenshots\",\n retries: userConfig.retries || 2,\n concurrency: userConfig.concurrency || 1,\n logConsoleEvents: userConfig.logConsoleEvents ?? true,\n diff: diffConfig,\n plugins: userConfig.plugins ? await getPlugins(userConfig.plugins) : [],\n onFail: userConfig.onFail,\n screenshot: {\n fullPage: userConfig.screenshot?.fullPage ?? true,\n viewport: userConfig.screenshot?.viewport ?? {\n width: 1920,\n height: 1080,\n },\n },\n review: {\n theme: userConfig.review?.theme ?? \"light\",\n port: userConfig.review?.port ?? 3000,\n },\n connectionTimeout: userConfig.connectionTimeout ?? 20000,\n };\n\n getLogger().debug(\n \"Configuration loaded:\",\n JSON.stringify(configWithDefaults, null, 2),\n );\n\n return configWithDefaults;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { readDiffMeta, type Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = async (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n): Promise<Screenshot[]> => {\n const screenshotRepresentations: Screenshot[] = [];\n\n // Build Maps for O(1) lookups instead of O(n) .find() calls\n const expectedByRelativePath = new Map<string, string>();\n for (const screenshot of expectedScreenshots) {\n const relativePath = path.relative(`${outputDir}/expected`, screenshot);\n expectedByRelativePath.set(relativePath, screenshot);\n }\n\n const diffByRelativePath = new Map<string, string>();\n for (const screenshot of diffScreenshots) {\n const relativePath = path.relative(`${outputDir}/diff`, screenshot);\n diffByRelativePath.set(relativePath, screenshot);\n }\n\n const actualRelativePaths = new Set<string>();\n\n for (const screenshot of actualScreenshots) {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n actualRelativePaths.add(relativePath);\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedByRelativePath.get(relativePath);\n const diffScreenshot = diffByRelativePath.get(relativePath);\n\n // Load the diff metadata sidecar (stats + interpretation) for changed\n // screenshots so it can be surfaced in the review UI and CLI.\n const diffMeta = diffScreenshot\n ? await readDiffMeta(diffScreenshot)\n : undefined;\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: buildCategory(expectedScreenshot, diffScreenshot),\n expectedPath: expectedScreenshot\n ? path.relative(outputDir, expectedScreenshot)\n : undefined,\n diffPath: diffScreenshot\n ? path.relative(outputDir, diffScreenshot)\n : undefined,\n actualPath: path.relative(outputDir, screenshot),\n ...(diffMeta ? { diffMeta } : {}),\n } as Screenshot);\n }\n\n for (const expectedScreenshot of expectedScreenshots) {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n\n // If the actual screenshot exists, it means we already added it\n if (actualRelativePaths.has(relativePath)) {\n continue;\n }\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n expectedPath: path.relative(outputDir, expectedScreenshot),\n });\n }\n\n return screenshotRepresentations.sort((a, b) => {\n return CATEGORY_ORDER[a.category] - CATEGORY_ORDER[b.category];\n });\n};\n\nconst buildCategory = (\n expectedScreenshot: string | undefined,\n diffScreenshot: string | undefined,\n) => {\n if (expectedScreenshot && diffScreenshot) {\n return \"changed\";\n }\n if (expectedScreenshot) {\n return \"passed\";\n }\n\n return \"new\";\n};\n\nconst CATEGORY_ORDER: Record<Screenshot[\"category\"], number> = {\n new: 0,\n deleted: 1,\n changed: 2,\n passed: 3,\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport { ScreenshotFileSystem } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const approve = async (options: { filter?: string[] }) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n logger.start(\"Approving screenshots...\");\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n const [actualScreenshots, diffScreenshots, expectedScreenshots] =\n await Promise.all([\n fileSystem.getActualScreenshots(),\n fileSystem.getDiffScreenshots(),\n fileSystem.getExpectedScreenshots(),\n ]);\n\n let screenshotsToApprove = await groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n config.outputDir,\n );\n\n const filters =\n options.filter?.map((filter: string) => filter.toLowerCase()) ?? [];\n\n if (filters.length > 0) {\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = filterScreenshots(screenshotsToApprove, filters);\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n await fileSystem.approveScreenshots(screenshotsToApprove, config.diff);\n\n if (filters.length > 0) {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n } else {\n logger.success(\"All screenshots approved\");\n }\n};\n\nexport const filterScreenshots = (\n screenshots: Screenshot[],\n filters: string[],\n) => {\n return screenshots.filter((screenshot) => {\n return filters.some((filter: string) => {\n const nameMatches = screenshot.name.toLowerCase().includes(filter);\n const pathMatches =\n \"actualPath\" in screenshot &&\n screenshot.actualPath?.toLowerCase().includes(filter);\n return nameMatches || pathMatches;\n });\n });\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\nimport { groupScreenshots } from \"./groupScreenshots\";\n\nconst listPngs = async (dir: string): Promise<string[]> =>\n Array.fromAsync(await glob(path.resolve(dir, \"**/*.png\")));\n\n/**\n * Read the `actual/`, `expected/` and `diff/` directories of `outputDir` and\n * group them into the screenshot representations used by the CLI commands\n * (including the diff metadata sidecar with the optional interpretation).\n */\nexport const collectScreenshots = async (\n outputDir: string,\n): Promise<Screenshot[]> => {\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n listPngs(path.resolve(outputDir, \"actual\")),\n listPngs(path.resolve(outputDir, \"expected\")),\n listPngs(path.resolve(outputDir, \"diff\")),\n ]);\n\n return groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n outputDir,\n );\n};\n","import type { ChangeRegion, Screenshot } from \"@cappa/core\";\nimport chalk from \"chalk\";\n\nconst severityColor = (severity: string) => {\n switch (severity) {\n case \"High\":\n return chalk.red;\n case \"Medium\":\n return chalk.yellow;\n case \"Low\":\n return chalk.green;\n default:\n return chalk.gray;\n }\n};\n\n/** Human-readable labels for the `changeType` values reported by blazediff. */\nconst CHANGE_TYPE_LABELS: Record<string, string> = {\n Addition: \"added\",\n Deletion: \"removed\",\n ColorChange: \"color\",\n ContentChange: \"content\",\n Shift: \"shifted\",\n RenderingNoise: \"noise\",\n};\n\nconst changeTypeLabel = (changeType: string) =>\n CHANGE_TYPE_LABELS[changeType] ?? changeType;\n\n/** `content at center · 0.90% · 360x200 at (420, 300)` */\nconst describeRegion = (region: ChangeRegion): string => {\n const { bbox } = region;\n\n return [\n chalk.cyan(changeTypeLabel(region.changeType)),\n `at ${region.position}`,\n chalk.dim(\"·\"),\n `${region.percentage.toFixed(2)}%`,\n chalk.dim(\"·\"),\n chalk.dim(`${bbox.width}x${bbox.height} at (${bbox.x}, ${bbox.y})`),\n ].join(\" \");\n};\n\n/** Default number of regions listed per changed screenshot. */\nexport const DEFAULT_MAX_REGIONS = 5;\n\nexport type DescribeChangesOptions = {\n /**\n * Maximum number of interpreted regions listed per screenshot. The largest\n * regions are listed first; the remainder is collapsed into a\n * `… and N more region(s)` line. Set to `0` to omit the per-region\n * breakdown entirely.\n *\n * @default 5\n */\n maxRegions?: number;\n};\n\n/**\n * Build human-readable lines describing the changed screenshots, surfacing the\n * pixel-diff percentage and (when `diff.interpret` is enabled) the structured\n * interpretation: severity, region count, summary and the individual regions\n * with their position and bounding box.\n *\n * Returns an empty array when there are no changed screenshots.\n */\nexport const describeChanges = (\n screenshots: Screenshot[],\n options: DescribeChangesOptions = {},\n): string[] => {\n const { maxRegions = DEFAULT_MAX_REGIONS } = options;\n\n const changed = screenshots.filter(\n (screenshot) => screenshot.category === \"changed\",\n );\n\n if (changed.length === 0) {\n return [];\n }\n\n const lines: string[] = [];\n\n for (const screenshot of changed) {\n const meta = screenshot.diffMeta;\n const interpretation = meta?.interpretation;\n\n const parts: string[] = [];\n if (interpretation) {\n parts.push(\n severityColor(interpretation.severity)(\n interpretation.severity.toUpperCase(),\n ),\n );\n }\n if (meta) {\n parts.push(`${meta.percentDifference.toFixed(2)}%`);\n }\n if (interpretation) {\n const { totalRegions } = interpretation;\n parts.push(\n `${totalRegions} ${totalRegions === 1 ? \"region\" : \"regions\"}`,\n );\n }\n\n const suffix =\n parts.length > 0\n ? ` ${chalk.dim(\"·\")} ${parts.join(chalk.dim(\" · \"))}`\n : \"\";\n lines.push(`${chalk.bold(screenshot.name)}${suffix}`);\n\n if (interpretation?.summary) {\n lines.push(` ${chalk.dim(interpretation.summary)}`);\n }\n\n // Largest regions first, so truncating keeps the most significant ones.\n const regions = [...(interpretation?.regions ?? [])].sort(\n (a, b) => b.percentage - a.percentage,\n );\n if (maxRegions > 0 && regions.length > 0) {\n for (const region of regions.slice(0, maxRegions)) {\n lines.push(` ${chalk.dim(\"→\")} ${describeRegion(region)}`);\n }\n\n const remaining = regions.length - maxRegions;\n if (remaining > 0) {\n lines.push(\n chalk.dim(\n ` … and ${remaining} more ${remaining === 1 ? \"region\" : \"regions\"}`,\n ),\n );\n }\n }\n }\n\n return lines;\n};\n","import { InvalidArgumentError } from \"commander\";\nimport { DEFAULT_MAX_REGIONS } from \"./describeChanges\";\n\n/**\n * Parse the `--max-regions` option: a non-negative integer, where `0` disables\n * the per-region breakdown. Falls back to the default when omitted.\n */\nexport const parseMaxRegions = (value: string | undefined): number => {\n if (value === undefined) {\n return DEFAULT_MAX_REGIONS;\n }\n\n if (!/^\\d+$/.test(value.trim())) {\n throw new InvalidArgumentError(\n \"Expected a non-negative integer (0 disables the region breakdown).\",\n );\n }\n\n return Number(value.trim());\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { PluginTask, Screenshot } from \"@cappa/core\";\nimport {\n type FailedScreenshot,\n mapWithConcurrency,\n ScreenshotFileSystem,\n ScreenshotTool,\n} from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport type { Command } from \"commander\";\nimport { getConfig } from \"../features/config\";\nimport { collectScreenshots } from \"../utils/collectScreenshots\";\nimport { DEFAULT_MAX_REGIONS, describeChanges } from \"../utils/describeChanges\";\nimport { parseMaxRegions } from \"../utils/parseMaxRegions\";\n\ntype PluginCaptureResult = {\n success?: boolean;\n skipped?: boolean;\n isNew?: boolean;\n error?: unknown;\n filepath?: string;\n storyId?: string;\n storyName?: string;\n [key: string]: unknown;\n};\n\ntype FailedScreenshotInfo = {\n taskId: string;\n taskUrl: string;\n result: PluginCaptureResult;\n pluginName: string;\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null;\n\nexport const didScreenshotFail = (result: unknown): boolean => {\n if (!isObject(result)) {\n return false;\n }\n\n if (\"error\" in result && result.error != null) {\n return true;\n }\n\n if (\"success\" in result) {\n const { success } = result as PluginCaptureResult;\n if (success === false) {\n return true;\n }\n }\n\n if (\"filepath\" in result) {\n const { filepath, skipped } = result as PluginCaptureResult;\n if (!filepath && skipped !== true) {\n return true;\n }\n }\n\n return false;\n};\n\nasync function executeOnFailCallback(\n config: Awaited<ReturnType<typeof getConfig>>,\n groupedScreenshots: Screenshot[],\n): Promise<void> {\n const logger = getLogger();\n\n if (!config.onFail) {\n return;\n }\n\n const failingScreenshots: FailedScreenshot[] = groupedScreenshots\n .filter((screenshot) => screenshot.category !== \"passed\")\n .map((screenshot) => ({\n ...screenshot,\n absoluteActualPath:\n \"actualPath\" in screenshot && screenshot.actualPath\n ? path.resolve(config.outputDir, screenshot.actualPath)\n : undefined,\n absoluteExpectedPath:\n \"expectedPath\" in screenshot && screenshot.expectedPath\n ? path.resolve(config.outputDir, screenshot.expectedPath)\n : undefined,\n absoluteDiffPath:\n \"diffPath\" in screenshot && screenshot.diffPath\n ? path.resolve(config.outputDir, screenshot.diffPath)\n : undefined,\n }));\n\n if (failingScreenshots.length > 0) {\n logger.debug(\n `Executing onFail callback with ${failingScreenshots.length} failing screenshot(s)`,\n );\n\n try {\n await config.onFail(failingScreenshots);\n } catch (error) {\n logger.error(\"Error executing onFail callback:\", error);\n }\n }\n}\n\nexport function formatProgress(\n completed: number,\n total: number,\n taskId: string,\n): string {\n return `[${completed}/${total}] captured ${taskId}`;\n}\n\nexport function formatDuration(ms: number): string {\n const seconds = Math.floor(ms / 1000);\n const minutes = Math.floor(seconds / 60);\n const remainingSeconds = seconds % 60;\n\n if (minutes > 0) {\n return `${minutes}m ${remainingSeconds}s`;\n }\n return `${(ms / 1000).toFixed(2)}s`;\n}\n\nfunction generateFailureReportMessage(\n failedScreenshots: FailedScreenshotInfo[],\n deletedScreenshots: string[],\n): string {\n const total = failedScreenshots.length + deletedScreenshots.length;\n if (total === 0) {\n return \"\";\n }\n\n const lines: string[] = [];\n lines.push(`${chalk.red(`Total failures: ${total}`)}\\n`);\n\n // Group by plugin\n const byPlugin = new Map<string, FailedScreenshotInfo[]>();\n for (const failed of failedScreenshots) {\n const pluginFailures = byPlugin.get(failed.pluginName);\n if (pluginFailures) {\n pluginFailures.push(failed);\n } else {\n byPlugin.set(failed.pluginName, [failed]);\n }\n }\n\n for (const [pluginName, failures] of byPlugin.entries()) {\n lines.push(`\\n${chalk.bold(`Plugin: ${pluginName}`)}`);\n\n for (const failed of failures) {\n lines.push(`\\n ${chalk.dim(\"Task ID:\")} ${failed.taskId}`);\n\n const result = failed.result;\n if (result.storyName) {\n lines.push(` ${chalk.dim(\"Story:\")} ${result.storyName}`);\n }\n if (result.error) {\n const errorMsg =\n typeof result.error === \"string\"\n ? result.error\n : result.error instanceof Error\n ? result.error.message\n : String(result.error);\n lines.push(` ${chalk.red(\"Error:\")} ${errorMsg}`);\n }\n if (result.success === false) {\n if (result.isNew) {\n lines.push(\n ` ${chalk.yellow(\"Status:\")} New screenshot (no baseline — run 'cappa approve' to accept)`,\n );\n } else {\n lines.push(` ${chalk.red(\"Status:\")} Failed (comparison failed)`);\n }\n }\n if (!result.filepath && result.skipped !== true) {\n lines.push(` ${chalk.red(\"Status:\")} Failed (no filepath generated)`);\n }\n }\n }\n\n if (deletedScreenshots.length > 0) {\n lines.push(`\\n${chalk.bold(\"Deleted baselines:\")}`);\n for (const screenshotPath of deletedScreenshots) {\n lines.push(\n ` ${chalk.dim(\"Name:\")} ${screenshotPath.replace(/\\.png$/, \"\")}`,\n );\n }\n }\n\n return lines.join(\"\\n\");\n}\n\nexport async function getDeletedScreenshots(\n outputDir: string,\n): Promise<string[]> {\n const actualDir = path.resolve(outputDir, \"actual\");\n const expectedDir = path.resolve(outputDir, \"expected\");\n\n const [actualFiles, expectedFiles] = await Promise.all([\n Array.fromAsync(glob(path.join(actualDir, \"**/*.png\"))),\n Array.fromAsync(glob(path.join(expectedDir, \"**/*.png\"))),\n ]);\n\n const actualRelative = new Set(\n actualFiles.map((p) => path.relative(actualDir, p)),\n );\n\n return expectedFiles\n .map((p) => path.relative(expectedDir, p))\n .filter((rel) => !actualRelative.has(rel));\n}\n\ntype CaptureOptions = {\n ci?: boolean;\n filter?: string;\n maxRegions?: number;\n};\n\nexport function filterTasks(tasks: PluginTask[], filter: string): PluginTask[] {\n return tasks.filter((task) => path.matchesGlob(task.id, filter));\n}\n\nexport function registerSignalHandlers(\n screenshotTool: ScreenshotTool,\n exitFn: (code: number) => void = process.exit,\n): () => void {\n const handleSignal = async () => {\n await screenshotTool.close();\n exitFn(130);\n };\n\n process.once(\"SIGINT\", handleSignal);\n process.once(\"SIGTERM\", handleSignal);\n\n return () => {\n process.off(\"SIGINT\", handleSignal);\n process.off(\"SIGTERM\", handleSignal);\n };\n}\n\nconst runCapture = async (options: CaptureOptions = {}): Promise<void> => {\n const logger = getLogger();\n const captureStart = performance.now();\n\n const config = await getConfig();\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n fileSystem.clearActual();\n fileSystem.clearDiff();\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n retries: config.retries,\n concurrency: config.concurrency,\n logConsoleEvents: config.logConsoleEvents,\n fullPage: config.screenshot?.fullPage ?? true,\n viewport: config.screenshot?.viewport ?? { width: 1920, height: 1080 },\n connectionTimeout: config.connectionTimeout,\n });\n\n const unregisterSignalHandlers = registerSignalHandlers(screenshotTool);\n\n let captureError: unknown;\n let hasScreenshotFailure = false;\n let anyTasksRan = false;\n const failedScreenshots: FailedScreenshotInfo[] = [];\n\n try {\n await screenshotTool.init();\n\n const plugins = (config.plugins || []) as any[];\n\n // Phase 1: Discover all tasks in parallel across plugins\n const pluginTasks = await Promise.all(\n plugins.map(async (plugin) => {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n return { plugin, tasks };\n }),\n );\n\n if (options.filter) {\n logger.box({\n title: \"Filter Active\",\n message: `Only capturing tasks matching: ${chalk.cyan(options.filter)}`,\n });\n\n for (const entry of pluginTasks) {\n const before = entry.tasks.length;\n entry.tasks = filterTasks(entry.tasks, options.filter);\n logger.info(\n `${entry.plugin.name}: ${entry.tasks.length}/${before} tasks match filter`,\n );\n }\n }\n\n for (const { plugin, tasks } of pluginTasks) {\n if (tasks.length === 0) {\n continue;\n }\n\n anyTasksRan = true;\n let pluginHasFailure = false;\n\n logger.debug(\n `Processing ${tasks.length} tasks with concurrency ${screenshotTool.concurrency}`,\n );\n\n let completedTasks = 0;\n const pageContexts = new Map<number, any>();\n\n const allResults = await mapWithConcurrency(\n screenshotTool.concurrency,\n tasks,\n async (task: any, workerIndex) => {\n const page = screenshotTool.getPageFromPool(workerIndex);\n\n if (!pageContexts.has(workerIndex) && plugin.initPage) {\n pageContexts.set(\n workerIndex,\n await plugin.initPage(page, screenshotTool),\n );\n }\n const context = pageContexts.get(workerIndex);\n\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n\n completedTasks++;\n logger.info(formatProgress(completedTasks, tasks.length, task.id));\n\n if (didScreenshotFail(result)) {\n pluginHasFailure = true;\n hasScreenshotFailure = true;\n failedScreenshots.push({\n taskId: task.id,\n taskUrl: task.url,\n result: result as PluginCaptureResult,\n pluginName: plugin.name,\n });\n }\n\n return result;\n },\n );\n\n const results = allResults;\n if (pluginHasFailure) {\n logger.error(\n `Plugin ${plugin.name} completed with failures: ${results.length} results`,\n );\n } else {\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n }\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n captureError = error;\n throw error;\n } finally {\n unregisterSignalHandlers();\n await screenshotTool.close();\n }\n\n let deletedScreenshots: string[] = [];\n if (anyTasksRan) {\n try {\n deletedScreenshots = await getDeletedScreenshots(config.outputDir);\n if (deletedScreenshots.length > 0) {\n hasScreenshotFailure = true;\n }\n } catch (err) {\n logger.warn(\"Could not check for deleted screenshots:\", err);\n }\n }\n\n const isCi = options.ci || process.env.CI === \"true\";\n\n // Read back the diff metadata sidecars once and reuse them for both the\n // onFail callback and the changed-screenshot report below.\n let groupedScreenshots: Screenshot[] = [];\n if (!captureError && (isCi || hasScreenshotFailure)) {\n try {\n groupedScreenshots = await collectScreenshots(config.outputDir);\n } catch (err) {\n logger.warn(\"Could not collect screenshot results:\", err);\n }\n }\n\n if (!captureError && isCi) {\n await executeOnFailCallback(config, groupedScreenshots);\n }\n\n const duration = formatDuration(performance.now() - captureStart);\n\n if (hasScreenshotFailure) {\n const reportMessage = generateFailureReportMessage(\n failedScreenshots,\n deletedScreenshots,\n );\n logger.box({\n title: \"Failed Screenshots\",\n message: reportMessage,\n });\n\n // Surface the diff stats and, when `diff.interpret` is enabled, what\n // changed and where — this is often the only debugging signal on CI.\n const changeLines = describeChanges(groupedScreenshots, {\n maxRegions: options.maxRegions,\n });\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n logger.error(\n `One or more screenshots failed in ${duration}. See report above for details.`,\n );\n process.exit(1);\n } else {\n logger.success(`All plugins completed successfully in ${duration}`);\n }\n};\n\nexport const registerCaptureCommand = (program: Command): void => {\n program\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .option(\"--ci\", \"run capture in CI mode and execute onFail callback\")\n .option(\n \"-f, --filter <pattern>\",\n \"only capture tasks whose id matches the given glob pattern\",\n )\n .option(\n \"--max-regions <count>\",\n \"maximum number of interpreted diff regions listed per changed screenshot (0 to disable)\",\n parseMaxRegions,\n DEFAULT_MAX_REGIONS,\n )\n .action(async (options: CaptureOptions) => {\n await runCapture(options);\n });\n};\n","export const defaultConfig = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n retries: 3,\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { defaultConfig } from \"../features/config/default\";\n\nexport const init = async () => {\n const logger = getLogger();\n\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n const packageJsonPath = path.resolve(process.cwd(), \"package.json\");\n\n // Create cappa.config.ts\n if (fs.existsSync(configPath)) {\n logger.warn(\"cappa.config.ts already exists, skipping...\");\n } else {\n fs.writeFileSync(configPath, defaultConfig);\n logger.success(\"Created cappa.config.ts\");\n }\n\n // Add scripts to package.json\n if (fs.existsSync(packageJsonPath)) {\n try {\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n\n if (!packageJson.scripts) {\n packageJson.scripts = {};\n }\n\n if (packageJson.scripts.cappa) {\n logger.warn(\n \"'cappa' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts.cappa = \"cappa capture\";\n }\n\n if (packageJson.scripts[\"cappa:review\"]) {\n logger.warn(\n \"'cappa:review' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts[\"cappa:review\"] = \"cappa review\";\n }\n\n fs.writeFileSync(\n packageJsonPath,\n `${JSON.stringify(packageJson, null, 2)}\\n`,\n );\n logger.success(\"Added 'cappa' scripts to package.json\");\n } catch (error) {\n logger.error(\"Failed to update package.json:\", error);\n }\n } else {\n logger.warn(\"package.json not found, skipping script addition\");\n }\n\n logger.success(\"Cappa initialization complete!\");\n logger.warn(\n \"cappa relies on playwright to capture screenshots. Please install playwright and browsers before running cappa.\",\n );\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const review = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const server = await createServer({\n isProd: true,\n outputDir: path.resolve(config.outputDir),\n screenshots: groupedScreenshots,\n logger: getLogger().level >= 4,\n theme: config.review.theme,\n diff: config.diff,\n });\n\n logger.success(\n `Review UI available at http://localhost:${config.review.port}`,\n );\n await server.listen({ port: config.review.port });\n};\n","import { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport { getConfig } from \"../features/config\";\nimport { collectScreenshots } from \"../utils/collectScreenshots\";\nimport { describeChanges } from \"../utils/describeChanges\";\n\ntype StatusOptions = {\n maxRegions?: number;\n};\n\nexport const status = async (options: StatusOptions = {}) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const groupedScreenshots = await collectScreenshots(config.outputDir);\n\n logger.debug(\n \"All screenshot information:\",\n JSON.stringify(groupedScreenshots, null, 2),\n );\n\n logger.box({\n title: \"Screenshot Status\",\n message: `${chalk.yellow(\"New screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"new\").length}\\n${chalk.red(\"Deleted screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"deleted\").length}\\n${chalk.green(\"Changed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"changed\").length}\\n${chalk.blue(\"Passed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"passed\").length}`,\n });\n\n const changeLines = describeChanges(groupedScreenshots, {\n maxRegions: options.maxRegions,\n });\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n if (\n groupedScreenshots.some((s) =>\n [\"new\", \"changed\", \"deleted\"].includes(s.category),\n )\n ) {\n process.exitCode = 1;\n }\n};\n","import { initLogger } from \"@cappa/logger\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { approve } from \"./commands/approve\";\nimport { registerCaptureCommand } from \"./commands/capture\";\nimport { init } from \"./commands/init\";\nimport { review } from \"./commands/review\";\nimport { status } from \"./commands/status\";\nimport { DEFAULT_MAX_REGIONS } from \"./utils/describeChanges\";\nimport { parseMaxRegions } from \"./utils/parseMaxRegions\";\n\nconst program = new Command();\n\nprogram\n .name(\"cappa\")\n .description(\"Cappa CLI\")\n .version(version)\n .option(\n \"-l, --log-level <level>\",\n \"set log level (0: fatal and error, 1: warn, 2: log, 3: info, 4: debug, 5: trace)\",\n \"3\",\n )\n .hook(\"preAction\", (thisCommand) => {\n const logLevel = parseInt(thisCommand.opts().logLevel, 10);\n const logger = initLogger(logLevel);\n logger?.debug(`Log level set to: ${logLevel}`);\n });\n\nregisterCaptureCommand(program);\n\nprogram.command(\"review\").description(\"Review screenshots\").action(review);\n\nprogram\n .command(\"approve\")\n .description(\"Approve screenshots\")\n .option(\n \"-f, --filter <filter...>\",\n \"only approve screenshots whose name includes the provided filter value(s)\",\n )\n .action(approve);\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .option(\n \"--max-regions <count>\",\n \"maximum number of interpreted diff regions listed per changed screenshot (0 to disable)\",\n parseMaxRegions,\n DEFAULT_MAX_REGIONS,\n )\n .action(status);\n\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(init);\n\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  import { getLogger, initLogger } from "@cappa/logger";
2
- import { Command } from "commander";
2
+ import { Command, InvalidArgumentError } from "commander";
3
3
  import { ScreenshotFileSystem, ScreenshotTool, mapWithConcurrency, readDiffMeta } from "@cappa/core";
4
4
  import fs from "node:fs";
5
5
  import path from "node:path";
@@ -9,7 +9,7 @@ import { glob } from "node:fs/promises";
9
9
  import chalk from "chalk";
10
10
  import { createServer } from "@cappa/server";
11
11
  //#region package.json
12
- var version = "0.11.1";
12
+ var version = "0.12.0";
13
13
  //#endregion
14
14
  //#region src/features/config/getPlugins.ts
15
15
  async function getPlugins(plugins) {
@@ -206,6 +206,100 @@ const filterScreenshots = (screenshots, filters) => {
206
206
  });
207
207
  };
208
208
  //#endregion
209
+ //#region src/utils/collectScreenshots.ts
210
+ const listPngs = async (dir) => Array.fromAsync(await glob(path.resolve(dir, "**/*.png")));
211
+ /**
212
+ * Read the `actual/`, `expected/` and `diff/` directories of `outputDir` and
213
+ * group them into the screenshot representations used by the CLI commands
214
+ * (including the diff metadata sidecar with the optional interpretation).
215
+ */
216
+ const collectScreenshots = async (outputDir) => {
217
+ const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
218
+ listPngs(path.resolve(outputDir, "actual")),
219
+ listPngs(path.resolve(outputDir, "expected")),
220
+ listPngs(path.resolve(outputDir, "diff"))
221
+ ]);
222
+ return groupScreenshots(actualScreenshots, expectedScreenshots, diffScreenshots, outputDir);
223
+ };
224
+ //#endregion
225
+ //#region src/utils/describeChanges.ts
226
+ const severityColor = (severity) => {
227
+ switch (severity) {
228
+ case "High": return chalk.red;
229
+ case "Medium": return chalk.yellow;
230
+ case "Low": return chalk.green;
231
+ default: return chalk.gray;
232
+ }
233
+ };
234
+ /** Human-readable labels for the `changeType` values reported by blazediff. */
235
+ const CHANGE_TYPE_LABELS = {
236
+ Addition: "added",
237
+ Deletion: "removed",
238
+ ColorChange: "color",
239
+ ContentChange: "content",
240
+ Shift: "shifted",
241
+ RenderingNoise: "noise"
242
+ };
243
+ const changeTypeLabel = (changeType) => CHANGE_TYPE_LABELS[changeType] ?? changeType;
244
+ /** `content at center · 0.90% · 360x200 at (420, 300)` */
245
+ const describeRegion = (region) => {
246
+ const { bbox } = region;
247
+ return [
248
+ chalk.cyan(changeTypeLabel(region.changeType)),
249
+ `at ${region.position}`,
250
+ chalk.dim("·"),
251
+ `${region.percentage.toFixed(2)}%`,
252
+ chalk.dim("·"),
253
+ chalk.dim(`${bbox.width}x${bbox.height} at (${bbox.x}, ${bbox.y})`)
254
+ ].join(" ");
255
+ };
256
+ /**
257
+ * Build human-readable lines describing the changed screenshots, surfacing the
258
+ * pixel-diff percentage and (when `diff.interpret` is enabled) the structured
259
+ * interpretation: severity, region count, summary and the individual regions
260
+ * with their position and bounding box.
261
+ *
262
+ * Returns an empty array when there are no changed screenshots.
263
+ */
264
+ const describeChanges = (screenshots, options = {}) => {
265
+ const { maxRegions = 5 } = options;
266
+ const changed = screenshots.filter((screenshot) => screenshot.category === "changed");
267
+ if (changed.length === 0) return [];
268
+ const lines = [];
269
+ for (const screenshot of changed) {
270
+ const meta = screenshot.diffMeta;
271
+ const interpretation = meta?.interpretation;
272
+ const parts = [];
273
+ if (interpretation) parts.push(severityColor(interpretation.severity)(interpretation.severity.toUpperCase()));
274
+ if (meta) parts.push(`${meta.percentDifference.toFixed(2)}%`);
275
+ if (interpretation) {
276
+ const { totalRegions } = interpretation;
277
+ parts.push(`${totalRegions} ${totalRegions === 1 ? "region" : "regions"}`);
278
+ }
279
+ const suffix = parts.length > 0 ? ` ${chalk.dim("·")} ${parts.join(chalk.dim(" · "))}` : "";
280
+ lines.push(`${chalk.bold(screenshot.name)}${suffix}`);
281
+ if (interpretation?.summary) lines.push(` ${chalk.dim(interpretation.summary)}`);
282
+ const regions = [...interpretation?.regions ?? []].sort((a, b) => b.percentage - a.percentage);
283
+ if (maxRegions > 0 && regions.length > 0) {
284
+ for (const region of regions.slice(0, maxRegions)) lines.push(` ${chalk.dim("→")} ${describeRegion(region)}`);
285
+ const remaining = regions.length - maxRegions;
286
+ if (remaining > 0) lines.push(chalk.dim(` … and ${remaining} more ${remaining === 1 ? "region" : "regions"}`));
287
+ }
288
+ }
289
+ return lines;
290
+ };
291
+ //#endregion
292
+ //#region src/utils/parseMaxRegions.ts
293
+ /**
294
+ * Parse the `--max-regions` option: a non-negative integer, where `0` disables
295
+ * the per-region breakdown. Falls back to the default when omitted.
296
+ */
297
+ const parseMaxRegions = (value) => {
298
+ if (value === void 0) return 5;
299
+ if (!/^\d+$/.test(value.trim())) throw new InvalidArgumentError("Expected a non-negative integer (0 disables the region breakdown).");
300
+ return Number(value.trim());
301
+ };
302
+ //#endregion
209
303
  //#region src/commands/capture.ts
210
304
  const isObject = (value) => typeof value === "object" && value !== null;
211
305
  const didScreenshotFail = (result) => {
@@ -221,18 +315,10 @@ const didScreenshotFail = (result) => {
221
315
  }
222
316
  return false;
223
317
  };
224
- async function executeOnFailCallback(config) {
318
+ async function executeOnFailCallback(config, groupedScreenshots) {
225
319
  const logger = getLogger();
226
320
  if (!config.onFail) return;
227
- const actualScreenshotsPromise = glob(path.resolve(config.outputDir, "actual", "**/*.png"));
228
- const expectedScreenshotsPromise = glob(path.resolve(config.outputDir, "expected", "**/*.png"));
229
- const diffScreenshotsPromise = glob(path.resolve(config.outputDir, "diff", "**/*.png"));
230
- const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
231
- actualScreenshotsPromise,
232
- expectedScreenshotsPromise,
233
- diffScreenshotsPromise
234
- ]);
235
- const failingScreenshots = (await groupScreenshots(await Array.fromAsync(actualScreenshots), await Array.fromAsync(expectedScreenshots), await Array.fromAsync(diffScreenshots), config.outputDir)).filter((screenshot) => screenshot.category !== "passed").map((screenshot) => ({
321
+ const failingScreenshots = groupedScreenshots.filter((screenshot) => screenshot.category !== "passed").map((screenshot) => ({
236
322
  ...screenshot,
237
323
  absoluteActualPath: "actualPath" in screenshot && screenshot.actualPath ? path.resolve(config.outputDir, screenshot.actualPath) : void 0,
238
324
  absoluteExpectedPath: "expectedPath" in screenshot && screenshot.expectedPath ? path.resolve(config.outputDir, screenshot.expectedPath) : void 0,
@@ -406,7 +492,13 @@ const runCapture = async (options = {}) => {
406
492
  logger.warn("Could not check for deleted screenshots:", err);
407
493
  }
408
494
  const isCi = options.ci || process.env.CI === "true";
409
- if (!captureError && isCi) await executeOnFailCallback(config);
495
+ let groupedScreenshots = [];
496
+ if (!captureError && (isCi || hasScreenshotFailure)) try {
497
+ groupedScreenshots = await collectScreenshots(config.outputDir);
498
+ } catch (err) {
499
+ logger.warn("Could not collect screenshot results:", err);
500
+ }
501
+ if (!captureError && isCi) await executeOnFailCallback(config, groupedScreenshots);
410
502
  const duration = formatDuration(performance.now() - captureStart);
411
503
  if (hasScreenshotFailure) {
412
504
  const reportMessage = generateFailureReportMessage(failedScreenshots, deletedScreenshots);
@@ -414,12 +506,17 @@ const runCapture = async (options = {}) => {
414
506
  title: "Failed Screenshots",
415
507
  message: reportMessage
416
508
  });
509
+ const changeLines = describeChanges(groupedScreenshots, { maxRegions: options.maxRegions });
510
+ if (changeLines.length > 0) logger.box({
511
+ title: "Changed Screenshots",
512
+ message: changeLines.join("\n")
513
+ });
417
514
  logger.error(`One or more screenshots failed in ${duration}. See report above for details.`);
418
515
  process.exit(1);
419
516
  } else logger.success(`All plugins completed successfully in ${duration}`);
420
517
  };
421
518
  const registerCaptureCommand = (program) => {
422
- program.command("capture").description("Capture screenshots").option("--ci", "run capture in CI mode and execute onFail callback").option("-f, --filter <pattern>", "only capture tasks whose id matches the given glob pattern").action(async (options) => {
519
+ program.command("capture").description("Capture screenshots").option("--ci", "run capture in CI mode and execute onFail callback").option("-f, --filter <pattern>", "only capture tasks whose id matches the given glob pattern").option("--max-regions <count>", "maximum number of interpreted diff regions listed per changed screenshot (0 to disable)", parseMaxRegions, 5).action(async (options) => {
423
520
  await runCapture(options);
424
521
  });
425
522
  };
@@ -493,62 +590,16 @@ const review = async () => {
493
590
  await server.listen({ port: config.review.port });
494
591
  };
495
592
  //#endregion
496
- //#region src/utils/describeChanges.ts
497
- const severityColor = (severity) => {
498
- switch (severity) {
499
- case "High": return chalk.red;
500
- case "Medium": return chalk.yellow;
501
- case "Low": return chalk.green;
502
- default: return chalk.gray;
503
- }
504
- };
505
- /**
506
- * Build human-readable lines describing the changed screenshots, surfacing the
507
- * pixel-diff percentage and (when `diff.interpret` is enabled) the structured
508
- * interpretation: severity, region count and summary.
509
- *
510
- * Returns an empty array when there are no changed screenshots.
511
- */
512
- const describeChanges = (screenshots) => {
513
- const changed = screenshots.filter((screenshot) => screenshot.category === "changed");
514
- if (changed.length === 0) return [];
515
- const lines = [];
516
- for (const screenshot of changed) {
517
- const meta = screenshot.diffMeta;
518
- const interpretation = meta?.interpretation;
519
- const parts = [];
520
- if (interpretation) parts.push(severityColor(interpretation.severity)(interpretation.severity.toUpperCase()));
521
- if (meta) parts.push(`${meta.percentDifference.toFixed(2)}%`);
522
- if (interpretation) {
523
- const { totalRegions } = interpretation;
524
- parts.push(`${totalRegions} ${totalRegions === 1 ? "region" : "regions"}`);
525
- }
526
- const suffix = parts.length > 0 ? ` ${chalk.dim("·")} ${parts.join(chalk.dim(" · "))}` : "";
527
- lines.push(`${chalk.bold(screenshot.name)}${suffix}`);
528
- if (interpretation?.summary) lines.push(` ${chalk.dim(interpretation.summary)}`);
529
- }
530
- return lines;
531
- };
532
- //#endregion
533
593
  //#region src/commands/status.ts
534
- const status = async () => {
594
+ const status = async (options = {}) => {
535
595
  const logger = getLogger();
536
- const config = await getConfig();
537
- const actualScreenshotsPromise = glob(path.resolve(config.outputDir, "actual", "**/*.png"));
538
- const expectedScreenshotsPromise = glob(path.resolve(config.outputDir, "expected", "**/*.png"));
539
- const diffScreenshotsPromise = glob(path.resolve(config.outputDir, "diff", "**/*.png"));
540
- const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
541
- actualScreenshotsPromise,
542
- expectedScreenshotsPromise,
543
- diffScreenshotsPromise
544
- ]);
545
- const groupedScreenshots = await groupScreenshots(await Array.fromAsync(actualScreenshots), await Array.fromAsync(expectedScreenshots), await Array.fromAsync(diffScreenshots), config.outputDir);
596
+ const groupedScreenshots = await collectScreenshots((await getConfig()).outputDir);
546
597
  logger.debug("All screenshot information:", JSON.stringify(groupedScreenshots, null, 2));
547
598
  logger.box({
548
599
  title: "Screenshot Status",
549
600
  message: `${chalk.yellow("New screenshots:")} ${groupedScreenshots.filter((r) => r.category === "new").length}\n${chalk.red("Deleted screenshots:")} ${groupedScreenshots.filter((r) => r.category === "deleted").length}\n${chalk.green("Changed screenshots:")} ${groupedScreenshots.filter((r) => r.category === "changed").length}\n${chalk.blue("Passed screenshots:")} ${groupedScreenshots.filter((r) => r.category === "passed").length}`
550
601
  });
551
- const changeLines = describeChanges(groupedScreenshots);
602
+ const changeLines = describeChanges(groupedScreenshots, { maxRegions: options.maxRegions });
552
603
  if (changeLines.length > 0) logger.box({
553
604
  title: "Changed Screenshots",
554
605
  message: changeLines.join("\n")
@@ -569,7 +620,7 @@ program.name("cappa").description("Cappa CLI").version(version).option("-l, --lo
569
620
  registerCaptureCommand(program);
570
621
  program.command("review").description("Review screenshots").action(review);
571
622
  program.command("approve").description("Approve screenshots").option("-f, --filter <filter...>", "only approve screenshots whose name includes the provided filter value(s)").action(approve);
572
- program.command("status").description("Get status of screenshots").action(status);
623
+ program.command("status").description("Get status of screenshots").option("--max-regions <count>", "maximum number of interpreted diff regions listed per changed screenshot (0 to disable)", parseMaxRegions, 5).action(status);
573
624
  program.command("init").description("Initialize Cappa in the current directory").action(init);
574
625
  async function run() {
575
626
  await program.parseAsync();
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../package.json","../src/features/config/getPlugins.ts","../src/features/config/loadConfig.ts","../src/features/config/getConfig.ts","../src/utils/groupScreenshots.ts","../src/commands/approve.ts","../src/commands/capture.ts","../src/features/config/default.ts","../src/commands/init.ts","../src/commands/review.ts","../src/utils/describeChanges.ts","../src/commands/status.ts","../src/index.ts"],"sourcesContent":["","import type { PluginDef, UserConfig } from \"@cappa/core\";\n\nexport async function getPlugins(\n plugins: UserConfig[\"plugins\"],\n): Promise<PluginDef[]> {\n if (!plugins) {\n return [];\n }\n\n const loadedPlugins: PluginDef[] = [];\n\n for (const plugin of plugins) {\n if (typeof plugin === \"function\") {\n // Plugin is a function that returns PluginDef\n const pluginDef = plugin();\n loadedPlugins.push(pluginDef);\n } else {\n // Plugin is already a PluginDef\n loadedPlugins.push(plugin);\n }\n }\n\n return loadedPlugins;\n}\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n return (\n value !== null &&\n typeof value === \"object\" &&\n \"then\" in value &&\n typeof (value as any).then === \"function\"\n );\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { createJiti } from \"jiti\";\n\nexport type ConfigResult = {\n filepath: string;\n config: ReturnType<typeof defineConfig> | UserConfig;\n};\n\nconst tsLoader = async (configFile: string) => {\n const jiti = createJiti(import.meta.url, {\n jsx: {\n runtime: \"automatic\",\n importSource: \"@cappa/core\",\n },\n sourceMaps: true,\n });\n\n const mod = await jiti.import(configFile, { default: true });\n\n return mod;\n};\n\nexport async function loadConfig(): Promise<ConfigResult> {\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n\n if (!fs.existsSync(configPath)) {\n throw new Error(\n \"Config not found. Please create a cappa.config.ts file in the current directory.\",\n );\n }\n\n try {\n const config = await tsLoader(configPath);\n\n if (!config) {\n throw new Error(\n \"Config file is empty or does not export a valid configuration.\",\n );\n }\n\n return {\n filepath: configPath,\n config,\n };\n } catch (error) {\n throw new Error(\n `Failed to load config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n}\n","import type { ConfigEnv, UserConfig } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\nimport type { ConfigResult } from \"./loadConfig\";\nimport { loadConfig } from \"./loadConfig\";\n\ntype ResolvedUserConfig = Required<Omit<UserConfig, \"onFail\">> &\n Pick<UserConfig, \"onFail\">;\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n loadResult?: ConfigResult,\n): Promise<ResolvedUserConfig> {\n const result = loadResult ?? (await loadConfig());\n\n const configData = result?.config;\n let cappaUserConfig: Promise<UserConfig> = Promise.resolve(\n configData as UserConfig,\n );\n\n const configEnv: ConfigEnv = {\n command: process.argv[2],\n mode: process.env.NODE_ENV || \"development\",\n env: process.env,\n };\n\n // for ts or js files\n if (typeof configData === \"function\") {\n const possiblePromise = (configData as (env: ConfigEnv) => any)(configEnv);\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<UserConfig>;\n } else {\n cappaUserConfig = Promise.resolve(possiblePromise as UserConfig);\n }\n }\n\n const userConfig = await cappaUserConfig;\n\n if (!userConfig || typeof userConfig === \"function\") {\n throw new Error(\"Invalid configuration: no valid config found\");\n }\n\n const diffConfig: UserConfig[\"diff\"] = (() => {\n if (userConfig.diff?.type !== \"gmsd\") {\n return {\n type: \"pixel\",\n threshold: userConfig.diff?.threshold ?? 0.1,\n includeAA: userConfig.diff?.includeAA ?? false,\n fastBufferCheck: userConfig.diff?.fastBufferCheck ?? true,\n maxDiffPixels: userConfig.diff?.maxDiffPixels ?? 0,\n maxDiffPercentage: userConfig.diff?.maxDiffPercentage ?? 0,\n interpret: userConfig.diff?.interpret ?? false,\n };\n }\n\n return {\n type: \"gmsd\",\n threshold: userConfig.diff.threshold ?? 0.1,\n downsample: userConfig.diff.downsample ?? 0,\n c: userConfig.diff.c ?? 170,\n };\n })();\n\n const configWithDefaults = {\n outputDir: userConfig.outputDir || \"./screenshots\",\n retries: userConfig.retries || 2,\n concurrency: userConfig.concurrency || 1,\n logConsoleEvents: userConfig.logConsoleEvents ?? true,\n diff: diffConfig,\n plugins: userConfig.plugins ? await getPlugins(userConfig.plugins) : [],\n onFail: userConfig.onFail,\n screenshot: {\n fullPage: userConfig.screenshot?.fullPage ?? true,\n viewport: userConfig.screenshot?.viewport ?? {\n width: 1920,\n height: 1080,\n },\n },\n review: {\n theme: userConfig.review?.theme ?? \"light\",\n port: userConfig.review?.port ?? 3000,\n },\n connectionTimeout: userConfig.connectionTimeout ?? 20000,\n };\n\n getLogger().debug(\n \"Configuration loaded:\",\n JSON.stringify(configWithDefaults, null, 2),\n );\n\n return configWithDefaults;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { readDiffMeta, type Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = async (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n): Promise<Screenshot[]> => {\n const screenshotRepresentations: Screenshot[] = [];\n\n // Build Maps for O(1) lookups instead of O(n) .find() calls\n const expectedByRelativePath = new Map<string, string>();\n for (const screenshot of expectedScreenshots) {\n const relativePath = path.relative(`${outputDir}/expected`, screenshot);\n expectedByRelativePath.set(relativePath, screenshot);\n }\n\n const diffByRelativePath = new Map<string, string>();\n for (const screenshot of diffScreenshots) {\n const relativePath = path.relative(`${outputDir}/diff`, screenshot);\n diffByRelativePath.set(relativePath, screenshot);\n }\n\n const actualRelativePaths = new Set<string>();\n\n for (const screenshot of actualScreenshots) {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n actualRelativePaths.add(relativePath);\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedByRelativePath.get(relativePath);\n const diffScreenshot = diffByRelativePath.get(relativePath);\n\n // Load the diff metadata sidecar (stats + interpretation) for changed\n // screenshots so it can be surfaced in the review UI and CLI.\n const diffMeta = diffScreenshot\n ? await readDiffMeta(diffScreenshot)\n : undefined;\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: buildCategory(expectedScreenshot, diffScreenshot),\n expectedPath: expectedScreenshot\n ? path.relative(outputDir, expectedScreenshot)\n : undefined,\n diffPath: diffScreenshot\n ? path.relative(outputDir, diffScreenshot)\n : undefined,\n actualPath: path.relative(outputDir, screenshot),\n ...(diffMeta ? { diffMeta } : {}),\n } as Screenshot);\n }\n\n for (const expectedScreenshot of expectedScreenshots) {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n\n // If the actual screenshot exists, it means we already added it\n if (actualRelativePaths.has(relativePath)) {\n continue;\n }\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n expectedPath: path.relative(outputDir, expectedScreenshot),\n });\n }\n\n return screenshotRepresentations.sort((a, b) => {\n return CATEGORY_ORDER[a.category] - CATEGORY_ORDER[b.category];\n });\n};\n\nconst buildCategory = (\n expectedScreenshot: string | undefined,\n diffScreenshot: string | undefined,\n) => {\n if (expectedScreenshot && diffScreenshot) {\n return \"changed\";\n }\n if (expectedScreenshot) {\n return \"passed\";\n }\n\n return \"new\";\n};\n\nconst CATEGORY_ORDER: Record<Screenshot[\"category\"], number> = {\n new: 0,\n deleted: 1,\n changed: 2,\n passed: 3,\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport { ScreenshotFileSystem } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const approve = async (options: { filter?: string[] }) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n logger.start(\"Approving screenshots...\");\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n const [actualScreenshots, diffScreenshots, expectedScreenshots] =\n await Promise.all([\n fileSystem.getActualScreenshots(),\n fileSystem.getDiffScreenshots(),\n fileSystem.getExpectedScreenshots(),\n ]);\n\n let screenshotsToApprove = await groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n config.outputDir,\n );\n\n const filters =\n options.filter?.map((filter: string) => filter.toLowerCase()) ?? [];\n\n if (filters.length > 0) {\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = filterScreenshots(screenshotsToApprove, filters);\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n await fileSystem.approveScreenshots(screenshotsToApprove, config.diff);\n\n if (filters.length > 0) {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n } else {\n logger.success(\"All screenshots approved\");\n }\n};\n\nexport const filterScreenshots = (\n screenshots: Screenshot[],\n filters: string[],\n) => {\n return screenshots.filter((screenshot) => {\n return filters.some((filter: string) => {\n const nameMatches = screenshot.name.toLowerCase().includes(filter);\n const pathMatches =\n \"actualPath\" in screenshot &&\n screenshot.actualPath?.toLowerCase().includes(filter);\n return nameMatches || pathMatches;\n });\n });\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { PluginTask } from \"@cappa/core\";\nimport {\n type FailedScreenshot,\n mapWithConcurrency,\n ScreenshotFileSystem,\n ScreenshotTool,\n} from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport type { Command } from \"commander\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\ntype PluginCaptureResult = {\n success?: boolean;\n skipped?: boolean;\n isNew?: boolean;\n error?: unknown;\n filepath?: string;\n storyId?: string;\n storyName?: string;\n [key: string]: unknown;\n};\n\ntype FailedScreenshotInfo = {\n taskId: string;\n taskUrl: string;\n result: PluginCaptureResult;\n pluginName: string;\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null;\n\nexport const didScreenshotFail = (result: unknown): boolean => {\n if (!isObject(result)) {\n return false;\n }\n\n if (\"error\" in result && result.error != null) {\n return true;\n }\n\n if (\"success\" in result) {\n const { success } = result as PluginCaptureResult;\n if (success === false) {\n return true;\n }\n }\n\n if (\"filepath\" in result) {\n const { filepath, skipped } = result as PluginCaptureResult;\n if (!filepath && skipped !== true) {\n return true;\n }\n }\n\n return false;\n};\n\nasync function executeOnFailCallback(\n config: Awaited<ReturnType<typeof getConfig>>,\n): Promise<void> {\n const logger = getLogger();\n\n if (!config.onFail) {\n return;\n }\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const failingScreenshots: FailedScreenshot[] = groupedScreenshots\n .filter((screenshot) => screenshot.category !== \"passed\")\n .map((screenshot) => ({\n ...screenshot,\n absoluteActualPath:\n \"actualPath\" in screenshot && screenshot.actualPath\n ? path.resolve(config.outputDir, screenshot.actualPath)\n : undefined,\n absoluteExpectedPath:\n \"expectedPath\" in screenshot && screenshot.expectedPath\n ? path.resolve(config.outputDir, screenshot.expectedPath)\n : undefined,\n absoluteDiffPath:\n \"diffPath\" in screenshot && screenshot.diffPath\n ? path.resolve(config.outputDir, screenshot.diffPath)\n : undefined,\n }));\n\n if (failingScreenshots.length > 0) {\n logger.debug(\n `Executing onFail callback with ${failingScreenshots.length} failing screenshot(s)`,\n );\n\n try {\n await config.onFail(failingScreenshots);\n } catch (error) {\n logger.error(\"Error executing onFail callback:\", error);\n }\n }\n}\n\nexport function formatProgress(\n completed: number,\n total: number,\n taskId: string,\n): string {\n return `[${completed}/${total}] captured ${taskId}`;\n}\n\nexport function formatDuration(ms: number): string {\n const seconds = Math.floor(ms / 1000);\n const minutes = Math.floor(seconds / 60);\n const remainingSeconds = seconds % 60;\n\n if (minutes > 0) {\n return `${minutes}m ${remainingSeconds}s`;\n }\n return `${(ms / 1000).toFixed(2)}s`;\n}\n\nfunction generateFailureReportMessage(\n failedScreenshots: FailedScreenshotInfo[],\n deletedScreenshots: string[],\n): string {\n const total = failedScreenshots.length + deletedScreenshots.length;\n if (total === 0) {\n return \"\";\n }\n\n const lines: string[] = [];\n lines.push(`${chalk.red(`Total failures: ${total}`)}\\n`);\n\n // Group by plugin\n const byPlugin = new Map<string, FailedScreenshotInfo[]>();\n for (const failed of failedScreenshots) {\n const pluginFailures = byPlugin.get(failed.pluginName);\n if (pluginFailures) {\n pluginFailures.push(failed);\n } else {\n byPlugin.set(failed.pluginName, [failed]);\n }\n }\n\n for (const [pluginName, failures] of byPlugin.entries()) {\n lines.push(`\\n${chalk.bold(`Plugin: ${pluginName}`)}`);\n\n for (const failed of failures) {\n lines.push(`\\n ${chalk.dim(\"Task ID:\")} ${failed.taskId}`);\n\n const result = failed.result;\n if (result.storyName) {\n lines.push(` ${chalk.dim(\"Story:\")} ${result.storyName}`);\n }\n if (result.error) {\n const errorMsg =\n typeof result.error === \"string\"\n ? result.error\n : result.error instanceof Error\n ? result.error.message\n : String(result.error);\n lines.push(` ${chalk.red(\"Error:\")} ${errorMsg}`);\n }\n if (result.success === false) {\n if (result.isNew) {\n lines.push(\n ` ${chalk.yellow(\"Status:\")} New screenshot (no baseline — run 'cappa approve' to accept)`,\n );\n } else {\n lines.push(` ${chalk.red(\"Status:\")} Failed (comparison failed)`);\n }\n }\n if (!result.filepath && result.skipped !== true) {\n lines.push(` ${chalk.red(\"Status:\")} Failed (no filepath generated)`);\n }\n }\n }\n\n if (deletedScreenshots.length > 0) {\n lines.push(`\\n${chalk.bold(\"Deleted baselines:\")}`);\n for (const screenshotPath of deletedScreenshots) {\n lines.push(\n ` ${chalk.dim(\"Name:\")} ${screenshotPath.replace(/\\.png$/, \"\")}`,\n );\n }\n }\n\n return lines.join(\"\\n\");\n}\n\nexport async function getDeletedScreenshots(\n outputDir: string,\n): Promise<string[]> {\n const actualDir = path.resolve(outputDir, \"actual\");\n const expectedDir = path.resolve(outputDir, \"expected\");\n\n const [actualFiles, expectedFiles] = await Promise.all([\n Array.fromAsync(glob(path.join(actualDir, \"**/*.png\"))),\n Array.fromAsync(glob(path.join(expectedDir, \"**/*.png\"))),\n ]);\n\n const actualRelative = new Set(\n actualFiles.map((p) => path.relative(actualDir, p)),\n );\n\n return expectedFiles\n .map((p) => path.relative(expectedDir, p))\n .filter((rel) => !actualRelative.has(rel));\n}\n\ntype CaptureOptions = {\n ci?: boolean;\n filter?: string;\n};\n\nexport function filterTasks(tasks: PluginTask[], filter: string): PluginTask[] {\n return tasks.filter((task) => path.matchesGlob(task.id, filter));\n}\n\nexport function registerSignalHandlers(\n screenshotTool: ScreenshotTool,\n exitFn: (code: number) => void = process.exit,\n): () => void {\n const handleSignal = async () => {\n await screenshotTool.close();\n exitFn(130);\n };\n\n process.once(\"SIGINT\", handleSignal);\n process.once(\"SIGTERM\", handleSignal);\n\n return () => {\n process.off(\"SIGINT\", handleSignal);\n process.off(\"SIGTERM\", handleSignal);\n };\n}\n\nconst runCapture = async (options: CaptureOptions = {}): Promise<void> => {\n const logger = getLogger();\n const captureStart = performance.now();\n\n const config = await getConfig();\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n fileSystem.clearActual();\n fileSystem.clearDiff();\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n retries: config.retries,\n concurrency: config.concurrency,\n logConsoleEvents: config.logConsoleEvents,\n fullPage: config.screenshot?.fullPage ?? true,\n viewport: config.screenshot?.viewport ?? { width: 1920, height: 1080 },\n connectionTimeout: config.connectionTimeout,\n });\n\n const unregisterSignalHandlers = registerSignalHandlers(screenshotTool);\n\n let captureError: unknown;\n let hasScreenshotFailure = false;\n let anyTasksRan = false;\n const failedScreenshots: FailedScreenshotInfo[] = [];\n\n try {\n await screenshotTool.init();\n\n const plugins = (config.plugins || []) as any[];\n\n // Phase 1: Discover all tasks in parallel across plugins\n const pluginTasks = await Promise.all(\n plugins.map(async (plugin) => {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n return { plugin, tasks };\n }),\n );\n\n if (options.filter) {\n logger.box({\n title: \"Filter Active\",\n message: `Only capturing tasks matching: ${chalk.cyan(options.filter)}`,\n });\n\n for (const entry of pluginTasks) {\n const before = entry.tasks.length;\n entry.tasks = filterTasks(entry.tasks, options.filter);\n logger.info(\n `${entry.plugin.name}: ${entry.tasks.length}/${before} tasks match filter`,\n );\n }\n }\n\n for (const { plugin, tasks } of pluginTasks) {\n if (tasks.length === 0) {\n continue;\n }\n\n anyTasksRan = true;\n let pluginHasFailure = false;\n\n logger.debug(\n `Processing ${tasks.length} tasks with concurrency ${screenshotTool.concurrency}`,\n );\n\n let completedTasks = 0;\n const pageContexts = new Map<number, any>();\n\n const allResults = await mapWithConcurrency(\n screenshotTool.concurrency,\n tasks,\n async (task: any, workerIndex) => {\n const page = screenshotTool.getPageFromPool(workerIndex);\n\n if (!pageContexts.has(workerIndex) && plugin.initPage) {\n pageContexts.set(\n workerIndex,\n await plugin.initPage(page, screenshotTool),\n );\n }\n const context = pageContexts.get(workerIndex);\n\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n\n completedTasks++;\n logger.info(formatProgress(completedTasks, tasks.length, task.id));\n\n if (didScreenshotFail(result)) {\n pluginHasFailure = true;\n hasScreenshotFailure = true;\n failedScreenshots.push({\n taskId: task.id,\n taskUrl: task.url,\n result: result as PluginCaptureResult,\n pluginName: plugin.name,\n });\n }\n\n return result;\n },\n );\n\n const results = allResults;\n if (pluginHasFailure) {\n logger.error(\n `Plugin ${plugin.name} completed with failures: ${results.length} results`,\n );\n } else {\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n }\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n captureError = error;\n throw error;\n } finally {\n unregisterSignalHandlers();\n await screenshotTool.close();\n }\n\n let deletedScreenshots: string[] = [];\n if (anyTasksRan) {\n try {\n deletedScreenshots = await getDeletedScreenshots(config.outputDir);\n if (deletedScreenshots.length > 0) {\n hasScreenshotFailure = true;\n }\n } catch (err) {\n logger.warn(\"Could not check for deleted screenshots:\", err);\n }\n }\n\n const isCi = options.ci || process.env.CI === \"true\";\n\n if (!captureError && isCi) {\n await executeOnFailCallback(config);\n }\n\n const duration = formatDuration(performance.now() - captureStart);\n\n if (hasScreenshotFailure) {\n const reportMessage = generateFailureReportMessage(\n failedScreenshots,\n deletedScreenshots,\n );\n logger.box({\n title: \"Failed Screenshots\",\n message: reportMessage,\n });\n logger.error(\n `One or more screenshots failed in ${duration}. See report above for details.`,\n );\n process.exit(1);\n } else {\n logger.success(`All plugins completed successfully in ${duration}`);\n }\n};\n\nexport const registerCaptureCommand = (program: Command): void => {\n program\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .option(\"--ci\", \"run capture in CI mode and execute onFail callback\")\n .option(\n \"-f, --filter <pattern>\",\n \"only capture tasks whose id matches the given glob pattern\",\n )\n .action(async (options: CaptureOptions) => {\n await runCapture(options);\n });\n};\n","export const defaultConfig = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n retries: 3,\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { defaultConfig } from \"../features/config/default\";\n\nexport const init = async () => {\n const logger = getLogger();\n\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n const packageJsonPath = path.resolve(process.cwd(), \"package.json\");\n\n // Create cappa.config.ts\n if (fs.existsSync(configPath)) {\n logger.warn(\"cappa.config.ts already exists, skipping...\");\n } else {\n fs.writeFileSync(configPath, defaultConfig);\n logger.success(\"Created cappa.config.ts\");\n }\n\n // Add scripts to package.json\n if (fs.existsSync(packageJsonPath)) {\n try {\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n\n if (!packageJson.scripts) {\n packageJson.scripts = {};\n }\n\n if (packageJson.scripts.cappa) {\n logger.warn(\n \"'cappa' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts.cappa = \"cappa capture\";\n }\n\n if (packageJson.scripts[\"cappa:review\"]) {\n logger.warn(\n \"'cappa:review' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts[\"cappa:review\"] = \"cappa review\";\n }\n\n fs.writeFileSync(\n packageJsonPath,\n `${JSON.stringify(packageJson, null, 2)}\\n`,\n );\n logger.success(\"Added 'cappa' scripts to package.json\");\n } catch (error) {\n logger.error(\"Failed to update package.json:\", error);\n }\n } else {\n logger.warn(\"package.json not found, skipping script addition\");\n }\n\n logger.success(\"Cappa initialization complete!\");\n logger.warn(\n \"cappa relies on playwright to capture screenshots. Please install playwright and browsers before running cappa.\",\n );\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const review = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const server = await createServer({\n isProd: true,\n outputDir: path.resolve(config.outputDir),\n screenshots: groupedScreenshots,\n logger: getLogger().level >= 4,\n theme: config.review.theme,\n diff: config.diff,\n });\n\n logger.success(\n `Review UI available at http://localhost:${config.review.port}`,\n );\n await server.listen({ port: config.review.port });\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport chalk from \"chalk\";\n\nconst severityColor = (severity: string) => {\n switch (severity) {\n case \"High\":\n return chalk.red;\n case \"Medium\":\n return chalk.yellow;\n case \"Low\":\n return chalk.green;\n default:\n return chalk.gray;\n }\n};\n\n/**\n * Build human-readable lines describing the changed screenshots, surfacing the\n * pixel-diff percentage and (when `diff.interpret` is enabled) the structured\n * interpretation: severity, region count and summary.\n *\n * Returns an empty array when there are no changed screenshots.\n */\nexport const describeChanges = (screenshots: Screenshot[]): string[] => {\n const changed = screenshots.filter(\n (screenshot) => screenshot.category === \"changed\",\n );\n\n if (changed.length === 0) {\n return [];\n }\n\n const lines: string[] = [];\n\n for (const screenshot of changed) {\n const meta = screenshot.diffMeta;\n const interpretation = meta?.interpretation;\n\n const parts: string[] = [];\n if (interpretation) {\n parts.push(\n severityColor(interpretation.severity)(\n interpretation.severity.toUpperCase(),\n ),\n );\n }\n if (meta) {\n parts.push(`${meta.percentDifference.toFixed(2)}%`);\n }\n if (interpretation) {\n const { totalRegions } = interpretation;\n parts.push(\n `${totalRegions} ${totalRegions === 1 ? \"region\" : \"regions\"}`,\n );\n }\n\n const suffix =\n parts.length > 0\n ? ` ${chalk.dim(\"·\")} ${parts.join(chalk.dim(\" · \"))}`\n : \"\";\n lines.push(`${chalk.bold(screenshot.name)}${suffix}`);\n\n if (interpretation?.summary) {\n lines.push(` ${chalk.dim(interpretation.summary)}`);\n }\n }\n\n return lines;\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport { getConfig } from \"../features/config\";\nimport { describeChanges } from \"../utils/describeChanges\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const status = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n logger.debug(\n \"All screenshot information:\",\n JSON.stringify(groupedScreenshots, null, 2),\n );\n\n logger.box({\n title: \"Screenshot Status\",\n message: `${chalk.yellow(\"New screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"new\").length}\\n${chalk.red(\"Deleted screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"deleted\").length}\\n${chalk.green(\"Changed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"changed\").length}\\n${chalk.blue(\"Passed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"passed\").length}`,\n });\n\n const changeLines = describeChanges(groupedScreenshots);\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n if (\n groupedScreenshots.some((s) =>\n [\"new\", \"changed\", \"deleted\"].includes(s.category),\n )\n ) {\n process.exitCode = 1;\n }\n};\n","import { initLogger } from \"@cappa/logger\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { approve } from \"./commands/approve\";\nimport { registerCaptureCommand } from \"./commands/capture\";\nimport { init } from \"./commands/init\";\nimport { review } from \"./commands/review\";\nimport { status } from \"./commands/status\";\n\nconst program = new Command();\n\nprogram\n .name(\"cappa\")\n .description(\"Cappa CLI\")\n .version(version)\n .option(\n \"-l, --log-level <level>\",\n \"set log level (0: fatal and error, 1: warn, 2: log, 3: info, 4: debug, 5: trace)\",\n \"3\",\n )\n .hook(\"preAction\", (thisCommand) => {\n const logLevel = parseInt(thisCommand.opts().logLevel, 10);\n const logger = initLogger(logLevel);\n logger?.debug(`Log level set to: ${logLevel}`);\n });\n\nregisterCaptureCommand(program);\n\nprogram.command(\"review\").description(\"Review screenshots\").action(review);\n\nprogram\n .command(\"approve\")\n .description(\"Approve screenshots\")\n .option(\n \"-f, --filter <filter...>\",\n \"only approve screenshots whose name includes the provided filter value(s)\",\n )\n .action(approve);\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(status);\n\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(init);\n\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../package.json","../src/features/config/getPlugins.ts","../src/features/config/loadConfig.ts","../src/features/config/getConfig.ts","../src/utils/groupScreenshots.ts","../src/commands/approve.ts","../src/utils/collectScreenshots.ts","../src/utils/describeChanges.ts","../src/utils/parseMaxRegions.ts","../src/commands/capture.ts","../src/features/config/default.ts","../src/commands/init.ts","../src/commands/review.ts","../src/commands/status.ts","../src/index.ts"],"sourcesContent":["","import type { PluginDef, UserConfig } from \"@cappa/core\";\n\nexport async function getPlugins(\n plugins: UserConfig[\"plugins\"],\n): Promise<PluginDef[]> {\n if (!plugins) {\n return [];\n }\n\n const loadedPlugins: PluginDef[] = [];\n\n for (const plugin of plugins) {\n if (typeof plugin === \"function\") {\n // Plugin is a function that returns PluginDef\n const pluginDef = plugin();\n loadedPlugins.push(pluginDef);\n } else {\n // Plugin is already a PluginDef\n loadedPlugins.push(plugin);\n }\n }\n\n return loadedPlugins;\n}\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n return (\n value !== null &&\n typeof value === \"object\" &&\n \"then\" in value &&\n typeof (value as any).then === \"function\"\n );\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { createJiti } from \"jiti\";\n\nexport type ConfigResult = {\n filepath: string;\n config: ReturnType<typeof defineConfig> | UserConfig;\n};\n\nconst tsLoader = async (configFile: string) => {\n const jiti = createJiti(import.meta.url, {\n jsx: {\n runtime: \"automatic\",\n importSource: \"@cappa/core\",\n },\n sourceMaps: true,\n });\n\n const mod = await jiti.import(configFile, { default: true });\n\n return mod;\n};\n\nexport async function loadConfig(): Promise<ConfigResult> {\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n\n if (!fs.existsSync(configPath)) {\n throw new Error(\n \"Config not found. Please create a cappa.config.ts file in the current directory.\",\n );\n }\n\n try {\n const config = await tsLoader(configPath);\n\n if (!config) {\n throw new Error(\n \"Config file is empty or does not export a valid configuration.\",\n );\n }\n\n return {\n filepath: configPath,\n config,\n };\n } catch (error) {\n throw new Error(\n `Failed to load config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n );\n }\n}\n","import type { ConfigEnv, UserConfig } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\nimport type { ConfigResult } from \"./loadConfig\";\nimport { loadConfig } from \"./loadConfig\";\n\ntype ResolvedUserConfig = Required<Omit<UserConfig, \"onFail\">> &\n Pick<UserConfig, \"onFail\">;\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n loadResult?: ConfigResult,\n): Promise<ResolvedUserConfig> {\n const result = loadResult ?? (await loadConfig());\n\n const configData = result?.config;\n let cappaUserConfig: Promise<UserConfig> = Promise.resolve(\n configData as UserConfig,\n );\n\n const configEnv: ConfigEnv = {\n command: process.argv[2],\n mode: process.env.NODE_ENV || \"development\",\n env: process.env,\n };\n\n // for ts or js files\n if (typeof configData === \"function\") {\n const possiblePromise = (configData as (env: ConfigEnv) => any)(configEnv);\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<UserConfig>;\n } else {\n cappaUserConfig = Promise.resolve(possiblePromise as UserConfig);\n }\n }\n\n const userConfig = await cappaUserConfig;\n\n if (!userConfig || typeof userConfig === \"function\") {\n throw new Error(\"Invalid configuration: no valid config found\");\n }\n\n const diffConfig: UserConfig[\"diff\"] = (() => {\n if (userConfig.diff?.type !== \"gmsd\") {\n return {\n type: \"pixel\",\n threshold: userConfig.diff?.threshold ?? 0.1,\n includeAA: userConfig.diff?.includeAA ?? false,\n fastBufferCheck: userConfig.diff?.fastBufferCheck ?? true,\n maxDiffPixels: userConfig.diff?.maxDiffPixels ?? 0,\n maxDiffPercentage: userConfig.diff?.maxDiffPercentage ?? 0,\n interpret: userConfig.diff?.interpret ?? false,\n };\n }\n\n return {\n type: \"gmsd\",\n threshold: userConfig.diff.threshold ?? 0.1,\n downsample: userConfig.diff.downsample ?? 0,\n c: userConfig.diff.c ?? 170,\n };\n })();\n\n const configWithDefaults = {\n outputDir: userConfig.outputDir || \"./screenshots\",\n retries: userConfig.retries || 2,\n concurrency: userConfig.concurrency || 1,\n logConsoleEvents: userConfig.logConsoleEvents ?? true,\n diff: diffConfig,\n plugins: userConfig.plugins ? await getPlugins(userConfig.plugins) : [],\n onFail: userConfig.onFail,\n screenshot: {\n fullPage: userConfig.screenshot?.fullPage ?? true,\n viewport: userConfig.screenshot?.viewport ?? {\n width: 1920,\n height: 1080,\n },\n },\n review: {\n theme: userConfig.review?.theme ?? \"light\",\n port: userConfig.review?.port ?? 3000,\n },\n connectionTimeout: userConfig.connectionTimeout ?? 20000,\n };\n\n getLogger().debug(\n \"Configuration loaded:\",\n JSON.stringify(configWithDefaults, null, 2),\n );\n\n return configWithDefaults;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport { readDiffMeta, type Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = async (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n): Promise<Screenshot[]> => {\n const screenshotRepresentations: Screenshot[] = [];\n\n // Build Maps for O(1) lookups instead of O(n) .find() calls\n const expectedByRelativePath = new Map<string, string>();\n for (const screenshot of expectedScreenshots) {\n const relativePath = path.relative(`${outputDir}/expected`, screenshot);\n expectedByRelativePath.set(relativePath, screenshot);\n }\n\n const diffByRelativePath = new Map<string, string>();\n for (const screenshot of diffScreenshots) {\n const relativePath = path.relative(`${outputDir}/diff`, screenshot);\n diffByRelativePath.set(relativePath, screenshot);\n }\n\n const actualRelativePaths = new Set<string>();\n\n for (const screenshot of actualScreenshots) {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n actualRelativePaths.add(relativePath);\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedByRelativePath.get(relativePath);\n const diffScreenshot = diffByRelativePath.get(relativePath);\n\n // Load the diff metadata sidecar (stats + interpretation) for changed\n // screenshots so it can be surfaced in the review UI and CLI.\n const diffMeta = diffScreenshot\n ? await readDiffMeta(diffScreenshot)\n : undefined;\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: buildCategory(expectedScreenshot, diffScreenshot),\n expectedPath: expectedScreenshot\n ? path.relative(outputDir, expectedScreenshot)\n : undefined,\n diffPath: diffScreenshot\n ? path.relative(outputDir, diffScreenshot)\n : undefined,\n actualPath: path.relative(outputDir, screenshot),\n ...(diffMeta ? { diffMeta } : {}),\n } as Screenshot);\n }\n\n for (const expectedScreenshot of expectedScreenshots) {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n\n // If the actual screenshot exists, it means we already added it\n if (actualRelativePaths.has(relativePath)) {\n continue;\n }\n\n const name = relativePath.replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n expectedPath: path.relative(outputDir, expectedScreenshot),\n });\n }\n\n return screenshotRepresentations.sort((a, b) => {\n return CATEGORY_ORDER[a.category] - CATEGORY_ORDER[b.category];\n });\n};\n\nconst buildCategory = (\n expectedScreenshot: string | undefined,\n diffScreenshot: string | undefined,\n) => {\n if (expectedScreenshot && diffScreenshot) {\n return \"changed\";\n }\n if (expectedScreenshot) {\n return \"passed\";\n }\n\n return \"new\";\n};\n\nconst CATEGORY_ORDER: Record<Screenshot[\"category\"], number> = {\n new: 0,\n deleted: 1,\n changed: 2,\n passed: 3,\n};\n","import type { Screenshot } from \"@cappa/core\";\nimport { ScreenshotFileSystem } from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const approve = async (options: { filter?: string[] }) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n logger.start(\"Approving screenshots...\");\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n const [actualScreenshots, diffScreenshots, expectedScreenshots] =\n await Promise.all([\n fileSystem.getActualScreenshots(),\n fileSystem.getDiffScreenshots(),\n fileSystem.getExpectedScreenshots(),\n ]);\n\n let screenshotsToApprove = await groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n config.outputDir,\n );\n\n const filters =\n options.filter?.map((filter: string) => filter.toLowerCase()) ?? [];\n\n if (filters.length > 0) {\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = filterScreenshots(screenshotsToApprove, filters);\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n await fileSystem.approveScreenshots(screenshotsToApprove, config.diff);\n\n if (filters.length > 0) {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n } else {\n logger.success(\"All screenshots approved\");\n }\n};\n\nexport const filterScreenshots = (\n screenshots: Screenshot[],\n filters: string[],\n) => {\n return screenshots.filter((screenshot) => {\n return filters.some((filter: string) => {\n const nameMatches = screenshot.name.toLowerCase().includes(filter);\n const pathMatches =\n \"actualPath\" in screenshot &&\n screenshot.actualPath?.toLowerCase().includes(filter);\n return nameMatches || pathMatches;\n });\n });\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\nimport { groupScreenshots } from \"./groupScreenshots\";\n\nconst listPngs = async (dir: string): Promise<string[]> =>\n Array.fromAsync(await glob(path.resolve(dir, \"**/*.png\")));\n\n/**\n * Read the `actual/`, `expected/` and `diff/` directories of `outputDir` and\n * group them into the screenshot representations used by the CLI commands\n * (including the diff metadata sidecar with the optional interpretation).\n */\nexport const collectScreenshots = async (\n outputDir: string,\n): Promise<Screenshot[]> => {\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n listPngs(path.resolve(outputDir, \"actual\")),\n listPngs(path.resolve(outputDir, \"expected\")),\n listPngs(path.resolve(outputDir, \"diff\")),\n ]);\n\n return groupScreenshots(\n actualScreenshots,\n expectedScreenshots,\n diffScreenshots,\n outputDir,\n );\n};\n","import type { ChangeRegion, Screenshot } from \"@cappa/core\";\nimport chalk from \"chalk\";\n\nconst severityColor = (severity: string) => {\n switch (severity) {\n case \"High\":\n return chalk.red;\n case \"Medium\":\n return chalk.yellow;\n case \"Low\":\n return chalk.green;\n default:\n return chalk.gray;\n }\n};\n\n/** Human-readable labels for the `changeType` values reported by blazediff. */\nconst CHANGE_TYPE_LABELS: Record<string, string> = {\n Addition: \"added\",\n Deletion: \"removed\",\n ColorChange: \"color\",\n ContentChange: \"content\",\n Shift: \"shifted\",\n RenderingNoise: \"noise\",\n};\n\nconst changeTypeLabel = (changeType: string) =>\n CHANGE_TYPE_LABELS[changeType] ?? changeType;\n\n/** `content at center · 0.90% · 360x200 at (420, 300)` */\nconst describeRegion = (region: ChangeRegion): string => {\n const { bbox } = region;\n\n return [\n chalk.cyan(changeTypeLabel(region.changeType)),\n `at ${region.position}`,\n chalk.dim(\"·\"),\n `${region.percentage.toFixed(2)}%`,\n chalk.dim(\"·\"),\n chalk.dim(`${bbox.width}x${bbox.height} at (${bbox.x}, ${bbox.y})`),\n ].join(\" \");\n};\n\n/** Default number of regions listed per changed screenshot. */\nexport const DEFAULT_MAX_REGIONS = 5;\n\nexport type DescribeChangesOptions = {\n /**\n * Maximum number of interpreted regions listed per screenshot. The largest\n * regions are listed first; the remainder is collapsed into a\n * `… and N more region(s)` line. Set to `0` to omit the per-region\n * breakdown entirely.\n *\n * @default 5\n */\n maxRegions?: number;\n};\n\n/**\n * Build human-readable lines describing the changed screenshots, surfacing the\n * pixel-diff percentage and (when `diff.interpret` is enabled) the structured\n * interpretation: severity, region count, summary and the individual regions\n * with their position and bounding box.\n *\n * Returns an empty array when there are no changed screenshots.\n */\nexport const describeChanges = (\n screenshots: Screenshot[],\n options: DescribeChangesOptions = {},\n): string[] => {\n const { maxRegions = DEFAULT_MAX_REGIONS } = options;\n\n const changed = screenshots.filter(\n (screenshot) => screenshot.category === \"changed\",\n );\n\n if (changed.length === 0) {\n return [];\n }\n\n const lines: string[] = [];\n\n for (const screenshot of changed) {\n const meta = screenshot.diffMeta;\n const interpretation = meta?.interpretation;\n\n const parts: string[] = [];\n if (interpretation) {\n parts.push(\n severityColor(interpretation.severity)(\n interpretation.severity.toUpperCase(),\n ),\n );\n }\n if (meta) {\n parts.push(`${meta.percentDifference.toFixed(2)}%`);\n }\n if (interpretation) {\n const { totalRegions } = interpretation;\n parts.push(\n `${totalRegions} ${totalRegions === 1 ? \"region\" : \"regions\"}`,\n );\n }\n\n const suffix =\n parts.length > 0\n ? ` ${chalk.dim(\"·\")} ${parts.join(chalk.dim(\" · \"))}`\n : \"\";\n lines.push(`${chalk.bold(screenshot.name)}${suffix}`);\n\n if (interpretation?.summary) {\n lines.push(` ${chalk.dim(interpretation.summary)}`);\n }\n\n // Largest regions first, so truncating keeps the most significant ones.\n const regions = [...(interpretation?.regions ?? [])].sort(\n (a, b) => b.percentage - a.percentage,\n );\n if (maxRegions > 0 && regions.length > 0) {\n for (const region of regions.slice(0, maxRegions)) {\n lines.push(` ${chalk.dim(\"→\")} ${describeRegion(region)}`);\n }\n\n const remaining = regions.length - maxRegions;\n if (remaining > 0) {\n lines.push(\n chalk.dim(\n ` … and ${remaining} more ${remaining === 1 ? \"region\" : \"regions\"}`,\n ),\n );\n }\n }\n }\n\n return lines;\n};\n","import { InvalidArgumentError } from \"commander\";\nimport { DEFAULT_MAX_REGIONS } from \"./describeChanges\";\n\n/**\n * Parse the `--max-regions` option: a non-negative integer, where `0` disables\n * the per-region breakdown. Falls back to the default when omitted.\n */\nexport const parseMaxRegions = (value: string | undefined): number => {\n if (value === undefined) {\n return DEFAULT_MAX_REGIONS;\n }\n\n if (!/^\\d+$/.test(value.trim())) {\n throw new InvalidArgumentError(\n \"Expected a non-negative integer (0 disables the region breakdown).\",\n );\n }\n\n return Number(value.trim());\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { PluginTask, Screenshot } from \"@cappa/core\";\nimport {\n type FailedScreenshot,\n mapWithConcurrency,\n ScreenshotFileSystem,\n ScreenshotTool,\n} from \"@cappa/core\";\nimport { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport type { Command } from \"commander\";\nimport { getConfig } from \"../features/config\";\nimport { collectScreenshots } from \"../utils/collectScreenshots\";\nimport { DEFAULT_MAX_REGIONS, describeChanges } from \"../utils/describeChanges\";\nimport { parseMaxRegions } from \"../utils/parseMaxRegions\";\n\ntype PluginCaptureResult = {\n success?: boolean;\n skipped?: boolean;\n isNew?: boolean;\n error?: unknown;\n filepath?: string;\n storyId?: string;\n storyName?: string;\n [key: string]: unknown;\n};\n\ntype FailedScreenshotInfo = {\n taskId: string;\n taskUrl: string;\n result: PluginCaptureResult;\n pluginName: string;\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null;\n\nexport const didScreenshotFail = (result: unknown): boolean => {\n if (!isObject(result)) {\n return false;\n }\n\n if (\"error\" in result && result.error != null) {\n return true;\n }\n\n if (\"success\" in result) {\n const { success } = result as PluginCaptureResult;\n if (success === false) {\n return true;\n }\n }\n\n if (\"filepath\" in result) {\n const { filepath, skipped } = result as PluginCaptureResult;\n if (!filepath && skipped !== true) {\n return true;\n }\n }\n\n return false;\n};\n\nasync function executeOnFailCallback(\n config: Awaited<ReturnType<typeof getConfig>>,\n groupedScreenshots: Screenshot[],\n): Promise<void> {\n const logger = getLogger();\n\n if (!config.onFail) {\n return;\n }\n\n const failingScreenshots: FailedScreenshot[] = groupedScreenshots\n .filter((screenshot) => screenshot.category !== \"passed\")\n .map((screenshot) => ({\n ...screenshot,\n absoluteActualPath:\n \"actualPath\" in screenshot && screenshot.actualPath\n ? path.resolve(config.outputDir, screenshot.actualPath)\n : undefined,\n absoluteExpectedPath:\n \"expectedPath\" in screenshot && screenshot.expectedPath\n ? path.resolve(config.outputDir, screenshot.expectedPath)\n : undefined,\n absoluteDiffPath:\n \"diffPath\" in screenshot && screenshot.diffPath\n ? path.resolve(config.outputDir, screenshot.diffPath)\n : undefined,\n }));\n\n if (failingScreenshots.length > 0) {\n logger.debug(\n `Executing onFail callback with ${failingScreenshots.length} failing screenshot(s)`,\n );\n\n try {\n await config.onFail(failingScreenshots);\n } catch (error) {\n logger.error(\"Error executing onFail callback:\", error);\n }\n }\n}\n\nexport function formatProgress(\n completed: number,\n total: number,\n taskId: string,\n): string {\n return `[${completed}/${total}] captured ${taskId}`;\n}\n\nexport function formatDuration(ms: number): string {\n const seconds = Math.floor(ms / 1000);\n const minutes = Math.floor(seconds / 60);\n const remainingSeconds = seconds % 60;\n\n if (minutes > 0) {\n return `${minutes}m ${remainingSeconds}s`;\n }\n return `${(ms / 1000).toFixed(2)}s`;\n}\n\nfunction generateFailureReportMessage(\n failedScreenshots: FailedScreenshotInfo[],\n deletedScreenshots: string[],\n): string {\n const total = failedScreenshots.length + deletedScreenshots.length;\n if (total === 0) {\n return \"\";\n }\n\n const lines: string[] = [];\n lines.push(`${chalk.red(`Total failures: ${total}`)}\\n`);\n\n // Group by plugin\n const byPlugin = new Map<string, FailedScreenshotInfo[]>();\n for (const failed of failedScreenshots) {\n const pluginFailures = byPlugin.get(failed.pluginName);\n if (pluginFailures) {\n pluginFailures.push(failed);\n } else {\n byPlugin.set(failed.pluginName, [failed]);\n }\n }\n\n for (const [pluginName, failures] of byPlugin.entries()) {\n lines.push(`\\n${chalk.bold(`Plugin: ${pluginName}`)}`);\n\n for (const failed of failures) {\n lines.push(`\\n ${chalk.dim(\"Task ID:\")} ${failed.taskId}`);\n\n const result = failed.result;\n if (result.storyName) {\n lines.push(` ${chalk.dim(\"Story:\")} ${result.storyName}`);\n }\n if (result.error) {\n const errorMsg =\n typeof result.error === \"string\"\n ? result.error\n : result.error instanceof Error\n ? result.error.message\n : String(result.error);\n lines.push(` ${chalk.red(\"Error:\")} ${errorMsg}`);\n }\n if (result.success === false) {\n if (result.isNew) {\n lines.push(\n ` ${chalk.yellow(\"Status:\")} New screenshot (no baseline — run 'cappa approve' to accept)`,\n );\n } else {\n lines.push(` ${chalk.red(\"Status:\")} Failed (comparison failed)`);\n }\n }\n if (!result.filepath && result.skipped !== true) {\n lines.push(` ${chalk.red(\"Status:\")} Failed (no filepath generated)`);\n }\n }\n }\n\n if (deletedScreenshots.length > 0) {\n lines.push(`\\n${chalk.bold(\"Deleted baselines:\")}`);\n for (const screenshotPath of deletedScreenshots) {\n lines.push(\n ` ${chalk.dim(\"Name:\")} ${screenshotPath.replace(/\\.png$/, \"\")}`,\n );\n }\n }\n\n return lines.join(\"\\n\");\n}\n\nexport async function getDeletedScreenshots(\n outputDir: string,\n): Promise<string[]> {\n const actualDir = path.resolve(outputDir, \"actual\");\n const expectedDir = path.resolve(outputDir, \"expected\");\n\n const [actualFiles, expectedFiles] = await Promise.all([\n Array.fromAsync(glob(path.join(actualDir, \"**/*.png\"))),\n Array.fromAsync(glob(path.join(expectedDir, \"**/*.png\"))),\n ]);\n\n const actualRelative = new Set(\n actualFiles.map((p) => path.relative(actualDir, p)),\n );\n\n return expectedFiles\n .map((p) => path.relative(expectedDir, p))\n .filter((rel) => !actualRelative.has(rel));\n}\n\ntype CaptureOptions = {\n ci?: boolean;\n filter?: string;\n maxRegions?: number;\n};\n\nexport function filterTasks(tasks: PluginTask[], filter: string): PluginTask[] {\n return tasks.filter((task) => path.matchesGlob(task.id, filter));\n}\n\nexport function registerSignalHandlers(\n screenshotTool: ScreenshotTool,\n exitFn: (code: number) => void = process.exit,\n): () => void {\n const handleSignal = async () => {\n await screenshotTool.close();\n exitFn(130);\n };\n\n process.once(\"SIGINT\", handleSignal);\n process.once(\"SIGTERM\", handleSignal);\n\n return () => {\n process.off(\"SIGINT\", handleSignal);\n process.off(\"SIGTERM\", handleSignal);\n };\n}\n\nconst runCapture = async (options: CaptureOptions = {}): Promise<void> => {\n const logger = getLogger();\n const captureStart = performance.now();\n\n const config = await getConfig();\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n fileSystem.clearActual();\n fileSystem.clearDiff();\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n retries: config.retries,\n concurrency: config.concurrency,\n logConsoleEvents: config.logConsoleEvents,\n fullPage: config.screenshot?.fullPage ?? true,\n viewport: config.screenshot?.viewport ?? { width: 1920, height: 1080 },\n connectionTimeout: config.connectionTimeout,\n });\n\n const unregisterSignalHandlers = registerSignalHandlers(screenshotTool);\n\n let captureError: unknown;\n let hasScreenshotFailure = false;\n let anyTasksRan = false;\n const failedScreenshots: FailedScreenshotInfo[] = [];\n\n try {\n await screenshotTool.init();\n\n const plugins = (config.plugins || []) as any[];\n\n // Phase 1: Discover all tasks in parallel across plugins\n const pluginTasks = await Promise.all(\n plugins.map(async (plugin) => {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n return { plugin, tasks };\n }),\n );\n\n if (options.filter) {\n logger.box({\n title: \"Filter Active\",\n message: `Only capturing tasks matching: ${chalk.cyan(options.filter)}`,\n });\n\n for (const entry of pluginTasks) {\n const before = entry.tasks.length;\n entry.tasks = filterTasks(entry.tasks, options.filter);\n logger.info(\n `${entry.plugin.name}: ${entry.tasks.length}/${before} tasks match filter`,\n );\n }\n }\n\n for (const { plugin, tasks } of pluginTasks) {\n if (tasks.length === 0) {\n continue;\n }\n\n anyTasksRan = true;\n let pluginHasFailure = false;\n\n logger.debug(\n `Processing ${tasks.length} tasks with concurrency ${screenshotTool.concurrency}`,\n );\n\n let completedTasks = 0;\n const pageContexts = new Map<number, any>();\n\n const allResults = await mapWithConcurrency(\n screenshotTool.concurrency,\n tasks,\n async (task: any, workerIndex) => {\n const page = screenshotTool.getPageFromPool(workerIndex);\n\n if (!pageContexts.has(workerIndex) && plugin.initPage) {\n pageContexts.set(\n workerIndex,\n await plugin.initPage(page, screenshotTool),\n );\n }\n const context = pageContexts.get(workerIndex);\n\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n\n completedTasks++;\n logger.info(formatProgress(completedTasks, tasks.length, task.id));\n\n if (didScreenshotFail(result)) {\n pluginHasFailure = true;\n hasScreenshotFailure = true;\n failedScreenshots.push({\n taskId: task.id,\n taskUrl: task.url,\n result: result as PluginCaptureResult,\n pluginName: plugin.name,\n });\n }\n\n return result;\n },\n );\n\n const results = allResults;\n if (pluginHasFailure) {\n logger.error(\n `Plugin ${plugin.name} completed with failures: ${results.length} results`,\n );\n } else {\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n }\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n captureError = error;\n throw error;\n } finally {\n unregisterSignalHandlers();\n await screenshotTool.close();\n }\n\n let deletedScreenshots: string[] = [];\n if (anyTasksRan) {\n try {\n deletedScreenshots = await getDeletedScreenshots(config.outputDir);\n if (deletedScreenshots.length > 0) {\n hasScreenshotFailure = true;\n }\n } catch (err) {\n logger.warn(\"Could not check for deleted screenshots:\", err);\n }\n }\n\n const isCi = options.ci || process.env.CI === \"true\";\n\n // Read back the diff metadata sidecars once and reuse them for both the\n // onFail callback and the changed-screenshot report below.\n let groupedScreenshots: Screenshot[] = [];\n if (!captureError && (isCi || hasScreenshotFailure)) {\n try {\n groupedScreenshots = await collectScreenshots(config.outputDir);\n } catch (err) {\n logger.warn(\"Could not collect screenshot results:\", err);\n }\n }\n\n if (!captureError && isCi) {\n await executeOnFailCallback(config, groupedScreenshots);\n }\n\n const duration = formatDuration(performance.now() - captureStart);\n\n if (hasScreenshotFailure) {\n const reportMessage = generateFailureReportMessage(\n failedScreenshots,\n deletedScreenshots,\n );\n logger.box({\n title: \"Failed Screenshots\",\n message: reportMessage,\n });\n\n // Surface the diff stats and, when `diff.interpret` is enabled, what\n // changed and where — this is often the only debugging signal on CI.\n const changeLines = describeChanges(groupedScreenshots, {\n maxRegions: options.maxRegions,\n });\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n logger.error(\n `One or more screenshots failed in ${duration}. See report above for details.`,\n );\n process.exit(1);\n } else {\n logger.success(`All plugins completed successfully in ${duration}`);\n }\n};\n\nexport const registerCaptureCommand = (program: Command): void => {\n program\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .option(\"--ci\", \"run capture in CI mode and execute onFail callback\")\n .option(\n \"-f, --filter <pattern>\",\n \"only capture tasks whose id matches the given glob pattern\",\n )\n .option(\n \"--max-regions <count>\",\n \"maximum number of interpreted diff regions listed per changed screenshot (0 to disable)\",\n parseMaxRegions,\n DEFAULT_MAX_REGIONS,\n )\n .action(async (options: CaptureOptions) => {\n await runCapture(options);\n });\n};\n","export const defaultConfig = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n retries: 3,\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { defaultConfig } from \"../features/config/default\";\n\nexport const init = async () => {\n const logger = getLogger();\n\n const configPath = path.resolve(process.cwd(), \"cappa.config.ts\");\n const packageJsonPath = path.resolve(process.cwd(), \"package.json\");\n\n // Create cappa.config.ts\n if (fs.existsSync(configPath)) {\n logger.warn(\"cappa.config.ts already exists, skipping...\");\n } else {\n fs.writeFileSync(configPath, defaultConfig);\n logger.success(\"Created cappa.config.ts\");\n }\n\n // Add scripts to package.json\n if (fs.existsSync(packageJsonPath)) {\n try {\n const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\"));\n\n if (!packageJson.scripts) {\n packageJson.scripts = {};\n }\n\n if (packageJson.scripts.cappa) {\n logger.warn(\n \"'cappa' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts.cappa = \"cappa capture\";\n }\n\n if (packageJson.scripts[\"cappa:review\"]) {\n logger.warn(\n \"'cappa:review' script already exists in package.json, skipping...\",\n );\n } else {\n packageJson.scripts[\"cappa:review\"] = \"cappa review\";\n }\n\n fs.writeFileSync(\n packageJsonPath,\n `${JSON.stringify(packageJson, null, 2)}\\n`,\n );\n logger.success(\"Added 'cappa' scripts to package.json\");\n } catch (error) {\n logger.error(\"Failed to update package.json:\", error);\n }\n } else {\n logger.warn(\"package.json not found, skipping script addition\");\n }\n\n logger.success(\"Cappa initialization complete!\");\n logger.warn(\n \"cappa relies on playwright to capture screenshots. Please install playwright and browsers before running cappa.\",\n );\n};\n","import { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport { getConfig } from \"../features/config\";\nimport { groupScreenshots } from \"../utils/groupScreenshots\";\n\nexport const review = async () => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n const expectedScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"expected\", \"**/*.png\"),\n );\n const diffScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"diff\", \"**/*.png\"),\n );\n\n const [actualScreenshots, expectedScreenshots, diffScreenshots] =\n await Promise.all([\n actualScreenshotsPromise,\n expectedScreenshotsPromise,\n diffScreenshotsPromise,\n ]);\n\n const groupedScreenshots = await groupScreenshots(\n await Array.fromAsync(actualScreenshots),\n await Array.fromAsync(expectedScreenshots),\n await Array.fromAsync(diffScreenshots),\n config.outputDir,\n );\n\n const server = await createServer({\n isProd: true,\n outputDir: path.resolve(config.outputDir),\n screenshots: groupedScreenshots,\n logger: getLogger().level >= 4,\n theme: config.review.theme,\n diff: config.diff,\n });\n\n logger.success(\n `Review UI available at http://localhost:${config.review.port}`,\n );\n await server.listen({ port: config.review.port });\n};\n","import { getLogger } from \"@cappa/logger\";\nimport chalk from \"chalk\";\nimport { getConfig } from \"../features/config\";\nimport { collectScreenshots } from \"../utils/collectScreenshots\";\nimport { describeChanges } from \"../utils/describeChanges\";\n\ntype StatusOptions = {\n maxRegions?: number;\n};\n\nexport const status = async (options: StatusOptions = {}) => {\n const logger = getLogger();\n\n const config = await getConfig();\n\n const groupedScreenshots = await collectScreenshots(config.outputDir);\n\n logger.debug(\n \"All screenshot information:\",\n JSON.stringify(groupedScreenshots, null, 2),\n );\n\n logger.box({\n title: \"Screenshot Status\",\n message: `${chalk.yellow(\"New screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"new\").length}\\n${chalk.red(\"Deleted screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"deleted\").length}\\n${chalk.green(\"Changed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"changed\").length}\\n${chalk.blue(\"Passed screenshots:\")} ${groupedScreenshots.filter((r) => r.category === \"passed\").length}`,\n });\n\n const changeLines = describeChanges(groupedScreenshots, {\n maxRegions: options.maxRegions,\n });\n if (changeLines.length > 0) {\n logger.box({\n title: \"Changed Screenshots\",\n message: changeLines.join(\"\\n\"),\n });\n }\n\n if (\n groupedScreenshots.some((s) =>\n [\"new\", \"changed\", \"deleted\"].includes(s.category),\n )\n ) {\n process.exitCode = 1;\n }\n};\n","import { initLogger } from \"@cappa/logger\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { approve } from \"./commands/approve\";\nimport { registerCaptureCommand } from \"./commands/capture\";\nimport { init } from \"./commands/init\";\nimport { review } from \"./commands/review\";\nimport { status } from \"./commands/status\";\nimport { DEFAULT_MAX_REGIONS } from \"./utils/describeChanges\";\nimport { parseMaxRegions } from \"./utils/parseMaxRegions\";\n\nconst program = new Command();\n\nprogram\n .name(\"cappa\")\n .description(\"Cappa CLI\")\n .version(version)\n .option(\n \"-l, --log-level <level>\",\n \"set log level (0: fatal and error, 1: warn, 2: log, 3: info, 4: debug, 5: trace)\",\n \"3\",\n )\n .hook(\"preAction\", (thisCommand) => {\n const logLevel = parseInt(thisCommand.opts().logLevel, 10);\n const logger = initLogger(logLevel);\n logger?.debug(`Log level set to: ${logLevel}`);\n });\n\nregisterCaptureCommand(program);\n\nprogram.command(\"review\").description(\"Review screenshots\").action(review);\n\nprogram\n .command(\"approve\")\n .description(\"Approve screenshots\")\n .option(\n \"-f, --filter <filter...>\",\n \"only approve screenshots whose name includes the provided filter value(s)\",\n )\n .action(approve);\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .option(\n \"--max-regions <count>\",\n \"maximum number of interpreted diff regions listed per changed screenshot (0 to disable)\",\n parseMaxRegions,\n DEFAULT_MAX_REGIONS,\n )\n .action(status);\n\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(init);\n\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cappa/cli",
3
- "version": "0.11.1",
3
+ "version": "0.12.0",
4
4
  "description": "Command line interface for Cappa",
5
5
  "author": "Tim Richter",
6
6
  "license": "MIT",
@@ -41,8 +41,8 @@
41
41
  "picocolors": "1.1.1",
42
42
  "ts-node": "10.9.2",
43
43
  "@cappa/core": "0.12.4",
44
- "@cappa/logger": "0.0.11",
45
- "@cappa/server": "0.8.6"
44
+ "@cappa/server": "0.8.6",
45
+ "@cappa/logger": "0.0.11"
46
46
  },
47
47
  "devDependencies": {
48
48
  "@arethetypeswrong/cli": "0.18.5",