@cappa/cli 0.1.2 → 0.1.4

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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Tim Richter
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,7 @@
1
+ # CLI Package
2
+
3
+ This package contains the CLI for Cappa.
4
+
5
+ It is the entry point for the Cappa CLI.
6
+
7
+ For detailed documentation, see the [CLI Documentation](https://tim-richter.github.io/cappa/cli).
package/dist/index.js CHANGED
@@ -23,6 +23,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
23
23
  //#endregion
24
24
  let node_fs = require("node:fs");
25
25
  node_fs = __toESM(node_fs);
26
+ let node_fs_promises = require("node:fs/promises");
27
+ node_fs_promises = __toESM(node_fs_promises);
26
28
  let node_path = require("node:path");
27
29
  node_path = __toESM(node_path);
28
30
  let __cappa_core = require("@cappa/core");
@@ -35,8 +37,6 @@ let chalk = require("chalk");
35
37
  chalk = __toESM(chalk);
36
38
  let commander = require("commander");
37
39
  commander = __toESM(commander);
38
- let glob = require("glob");
39
- glob = __toESM(glob);
40
40
  let cosmiconfig = require("cosmiconfig");
41
41
  cosmiconfig = __toESM(cosmiconfig);
42
42
  let jiti = require("jiti");
@@ -45,7 +45,7 @@ let node_crypto = require("node:crypto");
45
45
  node_crypto = __toESM(node_crypto);
46
46
 
47
47
  //#region package.json
48
- var version = "0.1.1";
48
+ var version = "0.1.4";
49
49
 
50
50
  //#endregion
51
51
  //#region src/utils/getPlugins.ts
@@ -197,26 +197,43 @@ program.name("cappa").description("Cappa CLI").version(version).option("-l, --lo
197
197
  });
198
198
  program.command("capture").description("Capture screenshots").action(async () => {
199
199
  const logger = (0, __cappa_logger.getLogger)();
200
- const result = await getCosmiConfig("cappa");
201
- const config = await getConfig(result);
200
+ const config = await getConfig(await getCosmiConfig("cappa"));
202
201
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
203
202
  logger.debug(`Cleaning output directory: ${config.outputDir}`);
204
- if (node_fs.default.existsSync(`${config.outputDir}/actual`)) node_fs.default.rmSync(`${config.outputDir}/actual`, {
205
- recursive: true,
206
- force: true
207
- });
208
- if (node_fs.default.existsSync(`${config.outputDir}/diff`)) node_fs.default.rmSync(`${config.outputDir}/diff`, {
209
- recursive: true,
210
- force: true
211
- });
203
+ const fileSystem = new __cappa_core.ScreenshotFileSystem(config.outputDir);
204
+ fileSystem.clearActual();
205
+ fileSystem.clearDiff();
212
206
  const screenshotTool = new __cappa_core.ScreenshotTool({
213
207
  outputDir: config.outputDir,
214
- diff: config.diff
208
+ diff: config.diff,
209
+ retries: config.retries,
210
+ concurrency: config.concurrency
215
211
  });
216
212
  try {
213
+ await screenshotTool.init();
217
214
  for (const plugin of config.plugins) {
218
- logger.debug(`Executing plugin: ${plugin.name || "unnamed"}`);
219
- await plugin.execute(screenshotTool);
215
+ logger.debug(`Discovering tasks for plugin: ${plugin.name}`);
216
+ const tasks = await plugin.discover(screenshotTool);
217
+ logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);
218
+ if (tasks.length === 0) continue;
219
+ const effectiveConcurrency = Math.min(tasks.length, screenshotTool.concurrency);
220
+ const chunkSize = Math.ceil(tasks.length / effectiveConcurrency);
221
+ const chunks = [];
222
+ for (let i = 0; i < tasks.length; i += chunkSize) chunks.push(tasks.slice(i, i + chunkSize));
223
+ logger.debug(`Processing ${tasks.length} tasks with ${effectiveConcurrency} contexts in ${chunks.length} chunks`);
224
+ const results = (await Promise.all(chunks.map(async (chunk, chunkIndex) => {
225
+ const page = screenshotTool.getPageFromPool(chunkIndex);
226
+ const chunkResults = [];
227
+ let context;
228
+ if (plugin.initPage) context = await plugin.initPage(page, screenshotTool);
229
+ for (const task of chunk) {
230
+ logger.debug(`Executing task: ${task.id}`);
231
+ const result = await plugin.execute(task, page, screenshotTool, context);
232
+ chunkResults.push(result);
233
+ }
234
+ return chunkResults;
235
+ }))).flat();
236
+ logger.success(`Plugin ${plugin.name} completed: ${results.length} results`);
220
237
  }
221
238
  logger.success("All plugins completed successfully");
222
239
  } catch (error) {
@@ -228,12 +245,11 @@ program.command("capture").description("Capture screenshots").action(async () =>
228
245
  });
229
246
  program.command("review").description("Review screenshots").action(async () => {
230
247
  const logger = (0, __cappa_logger.getLogger)();
231
- const result = await getCosmiConfig("cappa");
232
- const config = await getConfig(result);
248
+ const config = await getConfig(await getCosmiConfig("cappa"));
233
249
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
234
- const actualScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
235
- const expectedScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
236
- const diffScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
250
+ const actualScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
251
+ const expectedScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
252
+ const diffScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
237
253
  const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
238
254
  actualScreenshotsPromise,
239
255
  expectedScreenshotsPromise,
@@ -251,10 +267,9 @@ program.command("review").description("Review screenshots").action(async () => {
251
267
  });
252
268
  program.command("approve").description("Approve screenshots").option("-f, --filter <filter...>", "only approve screenshots whose name includes the provided filter value(s)").action(async (options) => {
253
269
  const logger = (0, __cappa_logger.getLogger)();
254
- const result = await getCosmiConfig("cappa");
255
- const config = await getConfig(result);
270
+ const config = await getConfig(await getCosmiConfig("cappa"));
256
271
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
257
- const actualScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
272
+ const actualScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
258
273
  const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);
259
274
  let screenshotsToApprove = actualScreenshots;
260
275
  if (options.filter?.length) {
@@ -270,25 +285,18 @@ program.command("approve").description("Approve screenshots").option("-f, --filt
270
285
  return;
271
286
  }
272
287
  }
273
- for (const screenshot of screenshotsToApprove) {
274
- const destPath = node_path.default.resolve(config.outputDir, "expected", node_path.default.relative(`${config.outputDir}/actual`, screenshot));
275
- const destDir = node_path.default.dirname(destPath);
276
- node_fs.default.mkdirSync(destDir, { recursive: true });
277
- node_fs.default.copyFileSync(screenshot, destPath);
278
- const diffPath = node_path.default.resolve(config.outputDir, "diff", node_path.default.relative(`${config.outputDir}/actual`, screenshot));
279
- if (node_fs.default.existsSync(diffPath)) node_fs.default.unlinkSync(diffPath);
280
- }
288
+ const fileSystem = new __cappa_core.ScreenshotFileSystem(config.outputDir);
289
+ for (const screenshot of screenshotsToApprove) fileSystem.approveFromActualPath(screenshot);
281
290
  if (screenshotsToApprove.length === actualScreenshots.length) logger.success("All screenshots approved");
282
291
  else logger.success(`${screenshotsToApprove.length} screenshot(s) approved (filtered)`);
283
292
  });
284
293
  program.command("status").description("Get status of screenshots").action(async () => {
285
294
  const logger = (0, __cappa_logger.getLogger)();
286
- const result = await getCosmiConfig("cappa");
287
- const config = await getConfig(result);
295
+ const config = await getConfig(await getCosmiConfig("cappa"));
288
296
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
289
- const actualScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
290
- const expectedScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
291
- const diffScreenshotsPromise = (0, glob.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
297
+ const actualScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "actual", "**/*.png"));
298
+ const expectedScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "expected", "**/*.png"));
299
+ const diffScreenshotsPromise = (0, node_fs_promises.glob)(node_path.default.resolve(config.outputDir, "diff", "**/*.png"));
292
300
  const [actualScreenshots, expectedScreenshots, diffScreenshots] = await Promise.all([
293
301
  actualScreenshotsPromise,
294
302
  expectedScreenshotsPromise,
@@ -311,6 +319,7 @@ program.command("init").description("Initialize Cappa in the current directory")
311
319
 
312
320
  export default defineConfig({
313
321
  outputDir: "./screenshots",
322
+ retries: 3,
314
323
  diff: {
315
324
  threshold: 0.1,
316
325
  includeAA: false,
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["loadedPlugins: PluginDef[]","results: Array<Config>","screenshotRepresentations: Screenshot[]","path","expectedScreenshot","diffScreenshot","Command","fs","ScreenshotTool","path"],"sources":["../package.json","../src/utils/getPlugins.ts","../src/utils/getConfig.ts","../src/utils/getCosmiConfig.ts","../src/utils/groupScreenshots.ts","../src/index.ts"],"sourcesContent":["{\n \"name\": \"@cappa/cli\",\n \"version\": \"0.1.1\",\n \"description\": \"Command line interface for Cappa\",\n \"author\": \"Tim Richter\",\n \"keywords\": [\n \"screenshot\",\n \"cli\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"license\": \"MIT\",\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.mjs\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.mjs\",\n \"require\": \"./dist/index.js\"\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\",\n \"bin\",\n \"package.json\",\n \"README.md\"\n ],\n \"bin\": {\n \"cappa\": \"./bin/cappa.cjs\"\n },\n \"scripts\": {\n \"test\": \"vitest\",\n \"screenshot\": \"node src/index.ts\",\n \"build\": \"tsdown\",\n \"tsc\": \"tsc\"\n },\n \"dependencies\": {\n \"@cappa/core\": \"workspace:*\",\n \"@cappa/server\": \"workspace:*\",\n \"@cappa/logger\": \"workspace:*\",\n \"chalk\": \"^5.6.2\",\n \"commander\": \"14.0.1\",\n \"cosmiconfig\": \"9.0.0\",\n \"glob\": \"^11.0.3\",\n \"jiti\": \"2.5.1\",\n \"picocolors\": \"1.1.1\",\n \"ts-node\": \"10.9.2\"\n },\n \"devDependencies\": {\n \"@types/node\": \"catalog:\",\n \"@vitest/coverage-v8\": \"catalog:\",\n \"@vitest/ui\": \"catalog:\",\n \"tsdown\": \"catalog:\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\n }\n}\n","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 type { UserConfig } from \"@cappa/core\";\nimport type { Config } from \"cosmiconfig\";\nimport type { CosmiconfigResult } from \"./getCosmiConfig.ts\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n result: CosmiconfigResult,\n): Promise<Array<Config> | Config> {\n const config = result?.config;\n let cappaUserConfig = Promise.resolve(config) as Promise<\n UserConfig | Array<UserConfig>\n >;\n\n // for ts or js files\n if (typeof config === \"function\") {\n const possiblePromise = config();\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<\n UserConfig | Array<UserConfig>\n >;\n }\n cappaUserConfig = Promise.resolve(possiblePromise);\n }\n\n let JSONConfig = await cappaUserConfig;\n\n if (Array.isArray(JSONConfig)) {\n const results: Array<Config> = [];\n\n for (const item of JSONConfig) {\n const plugins = item.plugins ? await getPlugins(item.plugins) : undefined;\n\n results.push({\n ...item,\n plugins,\n } as Config);\n }\n\n return results;\n }\n\n JSONConfig = {\n ...JSONConfig,\n plugins: JSONConfig.plugins\n ? await getPlugins(JSONConfig.plugins)\n : undefined,\n };\n\n return JSONConfig as Config;\n}\n","import type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { cosmiconfig } from \"cosmiconfig\";\nimport { createJiti } from \"jiti\";\n\nexport type CosmiconfigResult = {\n filepath: string;\n isEmpty?: boolean;\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 getCosmiConfig(\n moduleName: string,\n config?: string,\n): Promise<CosmiconfigResult> {\n const searchPlaces = [\n \"package.json\",\n `.${moduleName}rc`,\n `.${moduleName}rc.json`,\n `.${moduleName}rc.yaml`,\n `.${moduleName}rc.yml`,\n\n `.${moduleName}rc.ts`,\n `.${moduleName}rc.js`,\n `.${moduleName}rc.mjs`,\n `.${moduleName}rc.cjs`,\n\n `${moduleName}.config.ts`,\n `${moduleName}.config.js`,\n `${moduleName}.config.mjs`,\n `${moduleName}.config.cjs`,\n ];\n const explorer = cosmiconfig(moduleName, {\n cache: false,\n searchPlaces: [\n ...searchPlaces.map((searchPlace) => {\n return `.config/${searchPlace}`;\n }),\n ...searchPlaces.map((searchPlace) => {\n return `configs/${searchPlace}`;\n }),\n ...searchPlaces,\n ],\n loaders: {\n \".ts\": tsLoader,\n },\n });\n\n const result = config ? await explorer.load(config) : await explorer.search();\n\n if (result?.isEmpty || !result || !result.config) {\n throw new Error(\n \"Config not defined, create a cappa.config.js or pass through your config with the option --config\",\n );\n }\n\n return result as CosmiconfigResult;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n) => {\n const screenshotRepresentations: Screenshot[] = [];\n\n actualScreenshots.forEach((screenshot) => {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n const name = path\n .relative(`${outputDir}/actual`, screenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedScreenshots.find(\n (expectedScreenshot) => {\n const expectedName = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n return expectedName === relativePath;\n },\n );\n\n const diffScreenshot = diffScreenshots.find((diffScreenshot) => {\n const diffName = path.relative(`${outputDir}/diff`, diffScreenshot);\n return diffName === relativePath;\n });\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 approved: false,\n });\n });\n\n expectedScreenshots.forEach((expectedScreenshot) => {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n const name = path\n .relative(`${outputDir}/expected`, expectedScreenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const actualScreenshot = actualScreenshots.find((actualScreenshot) => {\n const actualName = path.relative(`${outputDir}/actual`, actualScreenshot);\n return actualName === relativePath;\n });\n\n // If the actual screenshot exists, it means we already added it to the screenshotRepresentations\n if (actualScreenshot) {\n return;\n }\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n actualPath: undefined,\n expectedPath: path.relative(outputDir, expectedScreenshot),\n diffPath: undefined,\n approved: false,\n });\n });\n\n return screenshotRepresentations;\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","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ScreenshotTool } from \"@cappa/core\";\nimport { getLogger, initLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport chalk from \"chalk\";\nimport { Command } from \"commander\";\nimport { glob } from \"glob\";\nimport { version } from \"../package.json\";\nimport { getConfig } from \"./utils/getConfig\";\nimport { getCosmiConfig } from \"./utils/getCosmiConfig\";\nimport { groupScreenshots } from \"./utils/groupScreenshots\";\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\nprogram\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n if (fs.existsSync(`${config.outputDir}/actual`)) {\n fs.rmSync(`${config.outputDir}/actual`, { recursive: true, force: true });\n }\n if (fs.existsSync(`${config.outputDir}/diff`)) {\n fs.rmSync(`${config.outputDir}/diff`, { recursive: true, force: true });\n }\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n });\n\n try {\n // Wait for all plugins to complete\n for (const plugin of config.plugins) {\n logger.debug(`Executing plugin: ${plugin.name || \"unnamed\"}`);\n await plugin.execute(screenshotTool);\n }\n logger.success(\"All plugins completed successfully\");\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n throw error;\n } finally {\n // Always close the browser to ensure the process exits\n await screenshotTool.close();\n }\n });\n\nprogram\n .command(\"review\")\n .description(\"Review screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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 });\n\n logger.success(\"Review UI available at http://localhost:3000\");\n await server.listen({ port: 3000 });\n });\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(async (options) => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n\n const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);\n\n let screenshotsToApprove = actualScreenshots;\n\n if (options.filter?.length) {\n const filters = options.filter.map((filter: string) =>\n filter.toLowerCase(),\n );\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = actualScreenshots.filter((screenshot) => {\n const screenshotName = path.basename(screenshot).toLowerCase();\n const screenshotPath = screenshot.toLowerCase();\n\n return filters.some(\n (filter: string) =>\n screenshotName.includes(filter) || screenshotPath.includes(filter),\n );\n });\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n // copy actual screenshots to expected directory\n for (const screenshot of screenshotsToApprove) {\n const destPath = path.resolve(\n config.outputDir,\n \"expected\",\n path.relative(`${config.outputDir}/actual`, screenshot),\n );\n const destDir = path.dirname(destPath);\n\n // Create destination directory if it doesn't exist\n fs.mkdirSync(destDir, { recursive: true });\n fs.copyFileSync(screenshot, destPath);\n\n const diffPath = path.resolve(\n config.outputDir,\n \"diff\",\n path.relative(`${config.outputDir}/actual`, screenshot),\n );\n\n if (fs.existsSync(diffPath)) {\n fs.unlinkSync(diffPath);\n }\n }\n\n if (screenshotsToApprove.length === actualScreenshots.length) {\n logger.success(\"All screenshots approved\");\n } else {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n }\n });\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(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 const configContent = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n\n fs.writeFileSync(configPath, configContent);\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(\n fs.readFileSync(packageJsonPath, \"utf-8\"),\n );\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\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["loadedPlugins: PluginDef[]","results: Array<Config>","screenshotRepresentations: Screenshot[]","path","expectedScreenshot","diffScreenshot","Command","ScreenshotFileSystem","ScreenshotTool","chunks: (typeof tasks)[]","context: any","path","fs"],"sources":["../package.json","../src/utils/getPlugins.ts","../src/utils/getConfig.ts","../src/utils/getCosmiConfig.ts","../src/utils/groupScreenshots.ts","../src/index.ts"],"sourcesContent":["{\n \"name\": \"@cappa/cli\",\n \"version\": \"0.1.4\",\n \"description\": \"Command line interface for Cappa\",\n \"author\": \"Tim Richter\",\n \"license\": \"MIT\",\n \"keywords\": [\n \"screenshot\",\n \"cli\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.mjs\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.mjs\",\n \"require\": \"./dist/index.js\"\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\",\n \"bin\",\n \"package.json\",\n \"README.md\"\n ],\n \"bin\": {\n \"cappa\": \"./bin/cappa.cjs\"\n },\n \"scripts\": {\n \"test\": \"vitest\",\n \"test:run\": \"vitest --run\",\n \"test:ui\": \"vitest --ui\",\n \"test:coverage\": \"vitest --coverage\",\n \"screenshot\": \"node src/index.ts\",\n \"build\": \"tsdown\",\n \"tsc\": \"tsc\"\n },\n \"dependencies\": {\n \"@cappa/core\": \"workspace:*\",\n \"@cappa/logger\": \"workspace:*\",\n \"@cappa/server\": \"workspace:*\",\n \"chalk\": \"^5.6.2\",\n \"commander\": \"14.0.1\",\n \"cosmiconfig\": \"9.0.0\",\n \"jiti\": \"2.6.1\",\n \"picocolors\": \"1.1.1\",\n \"ts-node\": \"10.9.2\"\n },\n \"devDependencies\": {\n \"@types/node\": \"catalog:\",\n \"@vitest/coverage-v8\": \"catalog:\",\n \"@vitest/ui\": \"catalog:\",\n \"tsdown\": \"catalog:\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\n }\n}\n","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 type { UserConfig } from \"@cappa/core\";\nimport type { Config } from \"cosmiconfig\";\nimport type { CosmiconfigResult } from \"./getCosmiConfig.ts\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n result: CosmiconfigResult,\n): Promise<Array<Config> | Config> {\n const config = result?.config;\n let cappaUserConfig = Promise.resolve(config) as Promise<\n UserConfig | Array<UserConfig>\n >;\n\n // for ts or js files\n if (typeof config === \"function\") {\n const possiblePromise = config();\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<\n UserConfig | Array<UserConfig>\n >;\n }\n cappaUserConfig = Promise.resolve(possiblePromise);\n }\n\n let JSONConfig = await cappaUserConfig;\n\n if (Array.isArray(JSONConfig)) {\n const results: Array<Config> = [];\n\n for (const item of JSONConfig) {\n const plugins = item.plugins ? await getPlugins(item.plugins) : undefined;\n\n results.push({\n ...item,\n plugins,\n } as Config);\n }\n\n return results;\n }\n\n JSONConfig = {\n ...JSONConfig,\n plugins: JSONConfig.plugins\n ? await getPlugins(JSONConfig.plugins)\n : undefined,\n };\n\n return JSONConfig as Config;\n}\n","import type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { cosmiconfig } from \"cosmiconfig\";\nimport { createJiti } from \"jiti\";\n\nexport type CosmiconfigResult = {\n filepath: string;\n isEmpty?: boolean;\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 getCosmiConfig(\n moduleName: string,\n config?: string,\n): Promise<CosmiconfigResult> {\n const searchPlaces = [\n \"package.json\",\n `.${moduleName}rc`,\n `.${moduleName}rc.json`,\n `.${moduleName}rc.yaml`,\n `.${moduleName}rc.yml`,\n\n `.${moduleName}rc.ts`,\n `.${moduleName}rc.js`,\n `.${moduleName}rc.mjs`,\n `.${moduleName}rc.cjs`,\n\n `${moduleName}.config.ts`,\n `${moduleName}.config.js`,\n `${moduleName}.config.mjs`,\n `${moduleName}.config.cjs`,\n ];\n const explorer = cosmiconfig(moduleName, {\n cache: false,\n searchPlaces: [\n ...searchPlaces.map((searchPlace) => {\n return `.config/${searchPlace}`;\n }),\n ...searchPlaces.map((searchPlace) => {\n return `configs/${searchPlace}`;\n }),\n ...searchPlaces,\n ],\n loaders: {\n \".ts\": tsLoader,\n },\n });\n\n const result = config ? await explorer.load(config) : await explorer.search();\n\n if (result?.isEmpty || !result || !result.config) {\n throw new Error(\n \"Config not defined, create a cappa.config.js or pass through your config with the option --config\",\n );\n }\n\n return result as CosmiconfigResult;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n) => {\n const screenshotRepresentations: Screenshot[] = [];\n\n actualScreenshots.forEach((screenshot) => {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n const name = path\n .relative(`${outputDir}/actual`, screenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedScreenshots.find(\n (expectedScreenshot) => {\n const expectedName = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n return expectedName === relativePath;\n },\n );\n\n const diffScreenshot = diffScreenshots.find((diffScreenshot) => {\n const diffName = path.relative(`${outputDir}/diff`, diffScreenshot);\n return diffName === relativePath;\n });\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 approved: false,\n });\n });\n\n expectedScreenshots.forEach((expectedScreenshot) => {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n const name = path\n .relative(`${outputDir}/expected`, expectedScreenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const actualScreenshot = actualScreenshots.find((actualScreenshot) => {\n const actualName = path.relative(`${outputDir}/actual`, actualScreenshot);\n return actualName === relativePath;\n });\n\n // If the actual screenshot exists, it means we already added it to the screenshotRepresentations\n if (actualScreenshot) {\n return;\n }\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n actualPath: undefined,\n expectedPath: path.relative(outputDir, expectedScreenshot),\n diffPath: undefined,\n approved: false,\n });\n });\n\n return screenshotRepresentations;\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","import fs from \"node:fs\";\nimport { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { ScreenshotFileSystem, ScreenshotTool } from \"@cappa/core\";\nimport { getLogger, initLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport chalk from \"chalk\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { getConfig } from \"./utils/getConfig\";\nimport { getCosmiConfig } from \"./utils/getCosmiConfig\";\nimport { groupScreenshots } from \"./utils/groupScreenshots\";\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\nprogram\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 });\n\n try {\n await screenshotTool.init();\n\n for (const plugin of config.plugins) {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n\n // Phase 1: Discover all tasks\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n\n if (tasks.length === 0) {\n continue;\n }\n\n // Phase 2: Execute tasks in parallel chunks\n // Use the minimum of concurrency and actual number of tasks to avoid empty chunks\n const effectiveConcurrency = Math.min(\n tasks.length,\n screenshotTool.concurrency,\n );\n const chunkSize = Math.ceil(tasks.length / effectiveConcurrency);\n const chunks: (typeof tasks)[] = [];\n\n for (let i = 0; i < tasks.length; i += chunkSize) {\n chunks.push(tasks.slice(i, i + chunkSize));\n }\n\n logger.debug(\n `Processing ${tasks.length} tasks with ${effectiveConcurrency} contexts in ${chunks.length} chunks`,\n );\n\n const allResults = await Promise.all(\n chunks.map(async (chunk, chunkIndex) => {\n const page = screenshotTool.getPageFromPool(chunkIndex);\n const chunkResults = [];\n let context: any;\n\n // Initialize page if plugin has initPage method\n if (plugin.initPage) {\n context = await plugin.initPage(page, screenshotTool);\n }\n\n for (const task of chunk) {\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n chunkResults.push(result);\n }\n\n return chunkResults;\n }),\n );\n\n const results = allResults.flat();\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n\n logger.success(\"All plugins completed successfully\");\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n throw error;\n } finally {\n // Always close the browser to ensure the process exits\n await screenshotTool.close();\n }\n });\n\nprogram\n .command(\"review\")\n .description(\"Review screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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 });\n\n logger.success(\"Review UI available at http://localhost:3000\");\n await server.listen({ port: 3000 });\n });\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(async (options) => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n\n const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);\n\n let screenshotsToApprove = actualScreenshots;\n\n if (options.filter?.length) {\n const filters = options.filter.map((filter: string) =>\n filter.toLowerCase(),\n );\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = actualScreenshots.filter((screenshot) => {\n const screenshotName = path.basename(screenshot).toLowerCase();\n const screenshotPath = screenshot.toLowerCase();\n\n return filters.some(\n (filter: string) =>\n screenshotName.includes(filter) || screenshotPath.includes(filter),\n );\n });\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n // copy actual screenshots to expected directory\n for (const screenshot of screenshotsToApprove) {\n fileSystem.approveFromActualPath(screenshot);\n }\n\n if (screenshotsToApprove.length === actualScreenshots.length) {\n logger.success(\"All screenshots approved\");\n } else {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n }\n });\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(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 const configContent = `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\n fs.writeFileSync(configPath, configContent);\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(\n fs.readFileSync(packageJsonPath, \"utf-8\"),\n );\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\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -1,17 +1,17 @@
1
1
  import fs from "node:fs";
2
+ import { glob } from "node:fs/promises";
2
3
  import path from "node:path";
3
- import { ScreenshotTool } from "@cappa/core";
4
+ import { ScreenshotFileSystem, ScreenshotTool } from "@cappa/core";
4
5
  import { getLogger, initLogger } from "@cappa/logger";
5
6
  import { createServer } from "@cappa/server";
6
7
  import chalk from "chalk";
7
8
  import { Command } from "commander";
8
- import { glob } from "glob";
9
9
  import { cosmiconfig } from "cosmiconfig";
10
10
  import { createJiti } from "jiti";
11
11
  import { createHash } from "node:crypto";
12
12
 
13
13
  //#region package.json
14
- var version = "0.1.1";
14
+ var version = "0.1.4";
15
15
 
16
16
  //#endregion
17
17
  //#region src/utils/getPlugins.ts
@@ -163,26 +163,43 @@ program.name("cappa").description("Cappa CLI").version(version).option("-l, --lo
163
163
  });
164
164
  program.command("capture").description("Capture screenshots").action(async () => {
165
165
  const logger = getLogger();
166
- const result = await getCosmiConfig("cappa");
167
- const config = await getConfig(result);
166
+ const config = await getConfig(await getCosmiConfig("cappa"));
168
167
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
169
168
  logger.debug(`Cleaning output directory: ${config.outputDir}`);
170
- if (fs.existsSync(`${config.outputDir}/actual`)) fs.rmSync(`${config.outputDir}/actual`, {
171
- recursive: true,
172
- force: true
173
- });
174
- if (fs.existsSync(`${config.outputDir}/diff`)) fs.rmSync(`${config.outputDir}/diff`, {
175
- recursive: true,
176
- force: true
177
- });
169
+ const fileSystem = new ScreenshotFileSystem(config.outputDir);
170
+ fileSystem.clearActual();
171
+ fileSystem.clearDiff();
178
172
  const screenshotTool = new ScreenshotTool({
179
173
  outputDir: config.outputDir,
180
- diff: config.diff
174
+ diff: config.diff,
175
+ retries: config.retries,
176
+ concurrency: config.concurrency
181
177
  });
182
178
  try {
179
+ await screenshotTool.init();
183
180
  for (const plugin of config.plugins) {
184
- logger.debug(`Executing plugin: ${plugin.name || "unnamed"}`);
185
- await plugin.execute(screenshotTool);
181
+ logger.debug(`Discovering tasks for plugin: ${plugin.name}`);
182
+ const tasks = await plugin.discover(screenshotTool);
183
+ logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);
184
+ if (tasks.length === 0) continue;
185
+ const effectiveConcurrency = Math.min(tasks.length, screenshotTool.concurrency);
186
+ const chunkSize = Math.ceil(tasks.length / effectiveConcurrency);
187
+ const chunks = [];
188
+ for (let i = 0; i < tasks.length; i += chunkSize) chunks.push(tasks.slice(i, i + chunkSize));
189
+ logger.debug(`Processing ${tasks.length} tasks with ${effectiveConcurrency} contexts in ${chunks.length} chunks`);
190
+ const results = (await Promise.all(chunks.map(async (chunk, chunkIndex) => {
191
+ const page = screenshotTool.getPageFromPool(chunkIndex);
192
+ const chunkResults = [];
193
+ let context;
194
+ if (plugin.initPage) context = await plugin.initPage(page, screenshotTool);
195
+ for (const task of chunk) {
196
+ logger.debug(`Executing task: ${task.id}`);
197
+ const result = await plugin.execute(task, page, screenshotTool, context);
198
+ chunkResults.push(result);
199
+ }
200
+ return chunkResults;
201
+ }))).flat();
202
+ logger.success(`Plugin ${plugin.name} completed: ${results.length} results`);
186
203
  }
187
204
  logger.success("All plugins completed successfully");
188
205
  } catch (error) {
@@ -194,8 +211,7 @@ program.command("capture").description("Capture screenshots").action(async () =>
194
211
  });
195
212
  program.command("review").description("Review screenshots").action(async () => {
196
213
  const logger = getLogger();
197
- const result = await getCosmiConfig("cappa");
198
- const config = await getConfig(result);
214
+ const config = await getConfig(await getCosmiConfig("cappa"));
199
215
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
200
216
  const actualScreenshotsPromise = glob(path.resolve(config.outputDir, "actual", "**/*.png"));
201
217
  const expectedScreenshotsPromise = glob(path.resolve(config.outputDir, "expected", "**/*.png"));
@@ -217,8 +233,7 @@ program.command("review").description("Review screenshots").action(async () => {
217
233
  });
218
234
  program.command("approve").description("Approve screenshots").option("-f, --filter <filter...>", "only approve screenshots whose name includes the provided filter value(s)").action(async (options) => {
219
235
  const logger = getLogger();
220
- const result = await getCosmiConfig("cappa");
221
- const config = await getConfig(result);
236
+ const config = await getConfig(await getCosmiConfig("cappa"));
222
237
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
223
238
  const actualScreenshotsPromise = glob(path.resolve(config.outputDir, "actual", "**/*.png"));
224
239
  const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);
@@ -236,21 +251,14 @@ program.command("approve").description("Approve screenshots").option("-f, --filt
236
251
  return;
237
252
  }
238
253
  }
239
- for (const screenshot of screenshotsToApprove) {
240
- const destPath = path.resolve(config.outputDir, "expected", path.relative(`${config.outputDir}/actual`, screenshot));
241
- const destDir = path.dirname(destPath);
242
- fs.mkdirSync(destDir, { recursive: true });
243
- fs.copyFileSync(screenshot, destPath);
244
- const diffPath = path.resolve(config.outputDir, "diff", path.relative(`${config.outputDir}/actual`, screenshot));
245
- if (fs.existsSync(diffPath)) fs.unlinkSync(diffPath);
246
- }
254
+ const fileSystem = new ScreenshotFileSystem(config.outputDir);
255
+ for (const screenshot of screenshotsToApprove) fileSystem.approveFromActualPath(screenshot);
247
256
  if (screenshotsToApprove.length === actualScreenshots.length) logger.success("All screenshots approved");
248
257
  else logger.success(`${screenshotsToApprove.length} screenshot(s) approved (filtered)`);
249
258
  });
250
259
  program.command("status").description("Get status of screenshots").action(async () => {
251
260
  const logger = getLogger();
252
- const result = await getCosmiConfig("cappa");
253
- const config = await getConfig(result);
261
+ const config = await getConfig(await getCosmiConfig("cappa"));
254
262
  logger.debug("Configuration loaded:", JSON.stringify(config, null, 2));
255
263
  const actualScreenshotsPromise = glob(path.resolve(config.outputDir, "actual", "**/*.png"));
256
264
  const expectedScreenshotsPromise = glob(path.resolve(config.outputDir, "expected", "**/*.png"));
@@ -277,6 +285,7 @@ program.command("init").description("Initialize Cappa in the current directory")
277
285
 
278
286
  export default defineConfig({
279
287
  outputDir: "./screenshots",
288
+ retries: 3,
280
289
  diff: {
281
290
  threshold: 0.1,
282
291
  includeAA: false,
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["loadedPlugins: PluginDef[]","results: Array<Config>","screenshotRepresentations: Screenshot[]","expectedScreenshot","diffScreenshot"],"sources":["../package.json","../src/utils/getPlugins.ts","../src/utils/getConfig.ts","../src/utils/getCosmiConfig.ts","../src/utils/groupScreenshots.ts","../src/index.ts"],"sourcesContent":["{\n \"name\": \"@cappa/cli\",\n \"version\": \"0.1.1\",\n \"description\": \"Command line interface for Cappa\",\n \"author\": \"Tim Richter\",\n \"keywords\": [\n \"screenshot\",\n \"cli\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"license\": \"MIT\",\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.mjs\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.mjs\",\n \"require\": \"./dist/index.js\"\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\",\n \"bin\",\n \"package.json\",\n \"README.md\"\n ],\n \"bin\": {\n \"cappa\": \"./bin/cappa.cjs\"\n },\n \"scripts\": {\n \"test\": \"vitest\",\n \"screenshot\": \"node src/index.ts\",\n \"build\": \"tsdown\",\n \"tsc\": \"tsc\"\n },\n \"dependencies\": {\n \"@cappa/core\": \"workspace:*\",\n \"@cappa/server\": \"workspace:*\",\n \"@cappa/logger\": \"workspace:*\",\n \"chalk\": \"^5.6.2\",\n \"commander\": \"14.0.1\",\n \"cosmiconfig\": \"9.0.0\",\n \"glob\": \"^11.0.3\",\n \"jiti\": \"2.5.1\",\n \"picocolors\": \"1.1.1\",\n \"ts-node\": \"10.9.2\"\n },\n \"devDependencies\": {\n \"@types/node\": \"catalog:\",\n \"@vitest/coverage-v8\": \"catalog:\",\n \"@vitest/ui\": \"catalog:\",\n \"tsdown\": \"catalog:\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\n }\n}\n","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 type { UserConfig } from \"@cappa/core\";\nimport type { Config } from \"cosmiconfig\";\nimport type { CosmiconfigResult } from \"./getCosmiConfig.ts\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n result: CosmiconfigResult,\n): Promise<Array<Config> | Config> {\n const config = result?.config;\n let cappaUserConfig = Promise.resolve(config) as Promise<\n UserConfig | Array<UserConfig>\n >;\n\n // for ts or js files\n if (typeof config === \"function\") {\n const possiblePromise = config();\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<\n UserConfig | Array<UserConfig>\n >;\n }\n cappaUserConfig = Promise.resolve(possiblePromise);\n }\n\n let JSONConfig = await cappaUserConfig;\n\n if (Array.isArray(JSONConfig)) {\n const results: Array<Config> = [];\n\n for (const item of JSONConfig) {\n const plugins = item.plugins ? await getPlugins(item.plugins) : undefined;\n\n results.push({\n ...item,\n plugins,\n } as Config);\n }\n\n return results;\n }\n\n JSONConfig = {\n ...JSONConfig,\n plugins: JSONConfig.plugins\n ? await getPlugins(JSONConfig.plugins)\n : undefined,\n };\n\n return JSONConfig as Config;\n}\n","import type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { cosmiconfig } from \"cosmiconfig\";\nimport { createJiti } from \"jiti\";\n\nexport type CosmiconfigResult = {\n filepath: string;\n isEmpty?: boolean;\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 getCosmiConfig(\n moduleName: string,\n config?: string,\n): Promise<CosmiconfigResult> {\n const searchPlaces = [\n \"package.json\",\n `.${moduleName}rc`,\n `.${moduleName}rc.json`,\n `.${moduleName}rc.yaml`,\n `.${moduleName}rc.yml`,\n\n `.${moduleName}rc.ts`,\n `.${moduleName}rc.js`,\n `.${moduleName}rc.mjs`,\n `.${moduleName}rc.cjs`,\n\n `${moduleName}.config.ts`,\n `${moduleName}.config.js`,\n `${moduleName}.config.mjs`,\n `${moduleName}.config.cjs`,\n ];\n const explorer = cosmiconfig(moduleName, {\n cache: false,\n searchPlaces: [\n ...searchPlaces.map((searchPlace) => {\n return `.config/${searchPlace}`;\n }),\n ...searchPlaces.map((searchPlace) => {\n return `configs/${searchPlace}`;\n }),\n ...searchPlaces,\n ],\n loaders: {\n \".ts\": tsLoader,\n },\n });\n\n const result = config ? await explorer.load(config) : await explorer.search();\n\n if (result?.isEmpty || !result || !result.config) {\n throw new Error(\n \"Config not defined, create a cappa.config.js or pass through your config with the option --config\",\n );\n }\n\n return result as CosmiconfigResult;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n) => {\n const screenshotRepresentations: Screenshot[] = [];\n\n actualScreenshots.forEach((screenshot) => {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n const name = path\n .relative(`${outputDir}/actual`, screenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedScreenshots.find(\n (expectedScreenshot) => {\n const expectedName = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n return expectedName === relativePath;\n },\n );\n\n const diffScreenshot = diffScreenshots.find((diffScreenshot) => {\n const diffName = path.relative(`${outputDir}/diff`, diffScreenshot);\n return diffName === relativePath;\n });\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 approved: false,\n });\n });\n\n expectedScreenshots.forEach((expectedScreenshot) => {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n const name = path\n .relative(`${outputDir}/expected`, expectedScreenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const actualScreenshot = actualScreenshots.find((actualScreenshot) => {\n const actualName = path.relative(`${outputDir}/actual`, actualScreenshot);\n return actualName === relativePath;\n });\n\n // If the actual screenshot exists, it means we already added it to the screenshotRepresentations\n if (actualScreenshot) {\n return;\n }\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n actualPath: undefined,\n expectedPath: path.relative(outputDir, expectedScreenshot),\n diffPath: undefined,\n approved: false,\n });\n });\n\n return screenshotRepresentations;\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","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { ScreenshotTool } from \"@cappa/core\";\nimport { getLogger, initLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport chalk from \"chalk\";\nimport { Command } from \"commander\";\nimport { glob } from \"glob\";\nimport { version } from \"../package.json\";\nimport { getConfig } from \"./utils/getConfig\";\nimport { getCosmiConfig } from \"./utils/getCosmiConfig\";\nimport { groupScreenshots } from \"./utils/groupScreenshots\";\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\nprogram\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n logger.debug(`Cleaning output directory: ${config.outputDir}`);\n if (fs.existsSync(`${config.outputDir}/actual`)) {\n fs.rmSync(`${config.outputDir}/actual`, { recursive: true, force: true });\n }\n if (fs.existsSync(`${config.outputDir}/diff`)) {\n fs.rmSync(`${config.outputDir}/diff`, { recursive: true, force: true });\n }\n\n const screenshotTool = new ScreenshotTool({\n outputDir: config.outputDir,\n diff: config.diff,\n });\n\n try {\n // Wait for all plugins to complete\n for (const plugin of config.plugins) {\n logger.debug(`Executing plugin: ${plugin.name || \"unnamed\"}`);\n await plugin.execute(screenshotTool);\n }\n logger.success(\"All plugins completed successfully\");\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n throw error;\n } finally {\n // Always close the browser to ensure the process exits\n await screenshotTool.close();\n }\n });\n\nprogram\n .command(\"review\")\n .description(\"Review screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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 });\n\n logger.success(\"Review UI available at http://localhost:3000\");\n await server.listen({ port: 3000 });\n });\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(async (options) => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n\n const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);\n\n let screenshotsToApprove = actualScreenshots;\n\n if (options.filter?.length) {\n const filters = options.filter.map((filter: string) =>\n filter.toLowerCase(),\n );\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = actualScreenshots.filter((screenshot) => {\n const screenshotName = path.basename(screenshot).toLowerCase();\n const screenshotPath = screenshot.toLowerCase();\n\n return filters.some(\n (filter: string) =>\n screenshotName.includes(filter) || screenshotPath.includes(filter),\n );\n });\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n // copy actual screenshots to expected directory\n for (const screenshot of screenshotsToApprove) {\n const destPath = path.resolve(\n config.outputDir,\n \"expected\",\n path.relative(`${config.outputDir}/actual`, screenshot),\n );\n const destDir = path.dirname(destPath);\n\n // Create destination directory if it doesn't exist\n fs.mkdirSync(destDir, { recursive: true });\n fs.copyFileSync(screenshot, destPath);\n\n const diffPath = path.resolve(\n config.outputDir,\n \"diff\",\n path.relative(`${config.outputDir}/actual`, screenshot),\n );\n\n if (fs.existsSync(diffPath)) {\n fs.unlinkSync(diffPath);\n }\n }\n\n if (screenshotsToApprove.length === actualScreenshots.length) {\n logger.success(\"All screenshots approved\");\n } else {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n }\n });\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(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 const configContent = `import { defineConfig } from \"@cappa/core\";\n\nexport default defineConfig({\n outputDir: \"./screenshots\",\n diff: {\n threshold: 0.1,\n includeAA: false,\n fastBufferCheck: true,\n maxDiffPixels: 0,\n maxDiffPercentage: 0,\n },\n plugins: [],\n});\n`;\n\n fs.writeFileSync(configPath, configContent);\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(\n fs.readFileSync(packageJsonPath, \"utf-8\"),\n );\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\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["loadedPlugins: PluginDef[]","results: Array<Config>","screenshotRepresentations: Screenshot[]","expectedScreenshot","diffScreenshot","chunks: (typeof tasks)[]","context: any"],"sources":["../package.json","../src/utils/getPlugins.ts","../src/utils/getConfig.ts","../src/utils/getCosmiConfig.ts","../src/utils/groupScreenshots.ts","../src/index.ts"],"sourcesContent":["{\n \"name\": \"@cappa/cli\",\n \"version\": \"0.1.4\",\n \"description\": \"Command line interface for Cappa\",\n \"author\": \"Tim Richter\",\n \"license\": \"MIT\",\n \"keywords\": [\n \"screenshot\",\n \"cli\"\n ],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"main\": \"./dist/index.js\",\n \"module\": \"./dist/index.mjs\",\n \"types\": \"./dist/index.d.ts\",\n \"exports\": {\n \".\": {\n \"import\": \"./dist/index.mjs\",\n \"require\": \"./dist/index.js\"\n },\n \"./package.json\": \"./package.json\"\n },\n \"files\": [\n \"dist\",\n \"bin\",\n \"package.json\",\n \"README.md\"\n ],\n \"bin\": {\n \"cappa\": \"./bin/cappa.cjs\"\n },\n \"scripts\": {\n \"test\": \"vitest\",\n \"test:run\": \"vitest --run\",\n \"test:ui\": \"vitest --ui\",\n \"test:coverage\": \"vitest --coverage\",\n \"screenshot\": \"node src/index.ts\",\n \"build\": \"tsdown\",\n \"tsc\": \"tsc\"\n },\n \"dependencies\": {\n \"@cappa/core\": \"workspace:*\",\n \"@cappa/logger\": \"workspace:*\",\n \"@cappa/server\": \"workspace:*\",\n \"chalk\": \"^5.6.2\",\n \"commander\": \"14.0.1\",\n \"cosmiconfig\": \"9.0.0\",\n \"jiti\": \"2.6.1\",\n \"picocolors\": \"1.1.1\",\n \"ts-node\": \"10.9.2\"\n },\n \"devDependencies\": {\n \"@types/node\": \"catalog:\",\n \"@vitest/coverage-v8\": \"catalog:\",\n \"@vitest/ui\": \"catalog:\",\n \"tsdown\": \"catalog:\",\n \"typescript\": \"catalog:\",\n \"vitest\": \"catalog:\"\n }\n}\n","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 type { UserConfig } from \"@cappa/core\";\nimport type { Config } from \"cosmiconfig\";\nimport type { CosmiconfigResult } from \"./getCosmiConfig.ts\";\nimport { getPlugins, isPromise } from \"./getPlugins\";\n\n/**\n * Converting UserConfig to Config without a change in the object beside the JSON convert.\n */\nexport async function getConfig(\n result: CosmiconfigResult,\n): Promise<Array<Config> | Config> {\n const config = result?.config;\n let cappaUserConfig = Promise.resolve(config) as Promise<\n UserConfig | Array<UserConfig>\n >;\n\n // for ts or js files\n if (typeof config === \"function\") {\n const possiblePromise = config();\n if (isPromise(possiblePromise)) {\n cappaUserConfig = possiblePromise as Promise<\n UserConfig | Array<UserConfig>\n >;\n }\n cappaUserConfig = Promise.resolve(possiblePromise);\n }\n\n let JSONConfig = await cappaUserConfig;\n\n if (Array.isArray(JSONConfig)) {\n const results: Array<Config> = [];\n\n for (const item of JSONConfig) {\n const plugins = item.plugins ? await getPlugins(item.plugins) : undefined;\n\n results.push({\n ...item,\n plugins,\n } as Config);\n }\n\n return results;\n }\n\n JSONConfig = {\n ...JSONConfig,\n plugins: JSONConfig.plugins\n ? await getPlugins(JSONConfig.plugins)\n : undefined,\n };\n\n return JSONConfig as Config;\n}\n","import type { defineConfig, UserConfig } from \"@cappa/core\";\nimport { cosmiconfig } from \"cosmiconfig\";\nimport { createJiti } from \"jiti\";\n\nexport type CosmiconfigResult = {\n filepath: string;\n isEmpty?: boolean;\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 getCosmiConfig(\n moduleName: string,\n config?: string,\n): Promise<CosmiconfigResult> {\n const searchPlaces = [\n \"package.json\",\n `.${moduleName}rc`,\n `.${moduleName}rc.json`,\n `.${moduleName}rc.yaml`,\n `.${moduleName}rc.yml`,\n\n `.${moduleName}rc.ts`,\n `.${moduleName}rc.js`,\n `.${moduleName}rc.mjs`,\n `.${moduleName}rc.cjs`,\n\n `${moduleName}.config.ts`,\n `${moduleName}.config.js`,\n `${moduleName}.config.mjs`,\n `${moduleName}.config.cjs`,\n ];\n const explorer = cosmiconfig(moduleName, {\n cache: false,\n searchPlaces: [\n ...searchPlaces.map((searchPlace) => {\n return `.config/${searchPlace}`;\n }),\n ...searchPlaces.map((searchPlace) => {\n return `configs/${searchPlace}`;\n }),\n ...searchPlaces,\n ],\n loaders: {\n \".ts\": tsLoader,\n },\n });\n\n const result = config ? await explorer.load(config) : await explorer.search();\n\n if (result?.isEmpty || !result || !result.config) {\n throw new Error(\n \"Config not defined, create a cappa.config.js or pass through your config with the option --config\",\n );\n }\n\n return result as CosmiconfigResult;\n}\n","import { createHash } from \"node:crypto\";\nimport path from \"node:path\";\nimport type { Screenshot } from \"@cappa/core\";\n\nexport const groupScreenshots = (\n actualScreenshots: string[],\n expectedScreenshots: string[],\n diffScreenshots: string[],\n outputDir: string,\n) => {\n const screenshotRepresentations: Screenshot[] = [];\n\n actualScreenshots.forEach((screenshot) => {\n const relativePath = path.relative(`${outputDir}/actual`, screenshot);\n const name = path\n .relative(`${outputDir}/actual`, screenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const expectedScreenshot = expectedScreenshots.find(\n (expectedScreenshot) => {\n const expectedName = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n return expectedName === relativePath;\n },\n );\n\n const diffScreenshot = diffScreenshots.find((diffScreenshot) => {\n const diffName = path.relative(`${outputDir}/diff`, diffScreenshot);\n return diffName === relativePath;\n });\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 approved: false,\n });\n });\n\n expectedScreenshots.forEach((expectedScreenshot) => {\n const relativePath = path.relative(\n `${outputDir}/expected`,\n expectedScreenshot,\n );\n const name = path\n .relative(`${outputDir}/expected`, expectedScreenshot)\n .replace(\".png\", \"\");\n const id = createHash(\"sha256\").update(relativePath).digest(\"hex\");\n\n const actualScreenshot = actualScreenshots.find((actualScreenshot) => {\n const actualName = path.relative(`${outputDir}/actual`, actualScreenshot);\n return actualName === relativePath;\n });\n\n // If the actual screenshot exists, it means we already added it to the screenshotRepresentations\n if (actualScreenshot) {\n return;\n }\n\n screenshotRepresentations.push({\n id: id,\n name: name,\n category: \"deleted\",\n actualPath: undefined,\n expectedPath: path.relative(outputDir, expectedScreenshot),\n diffPath: undefined,\n approved: false,\n });\n });\n\n return screenshotRepresentations;\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","import fs from \"node:fs\";\nimport { glob } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { ScreenshotFileSystem, ScreenshotTool } from \"@cappa/core\";\nimport { getLogger, initLogger } from \"@cappa/logger\";\nimport { createServer } from \"@cappa/server\";\nimport chalk from \"chalk\";\nimport { Command } from \"commander\";\nimport { version } from \"../package.json\";\nimport { getConfig } from \"./utils/getConfig\";\nimport { getCosmiConfig } from \"./utils/getCosmiConfig\";\nimport { groupScreenshots } from \"./utils/groupScreenshots\";\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\nprogram\n .command(\"capture\")\n .description(\"Capture screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 });\n\n try {\n await screenshotTool.init();\n\n for (const plugin of config.plugins) {\n logger.debug(`Discovering tasks for plugin: ${plugin.name}`);\n\n // Phase 1: Discover all tasks\n const tasks = await plugin.discover(screenshotTool);\n logger.info(`Found ${tasks.length} tasks for ${plugin.name}`);\n\n if (tasks.length === 0) {\n continue;\n }\n\n // Phase 2: Execute tasks in parallel chunks\n // Use the minimum of concurrency and actual number of tasks to avoid empty chunks\n const effectiveConcurrency = Math.min(\n tasks.length,\n screenshotTool.concurrency,\n );\n const chunkSize = Math.ceil(tasks.length / effectiveConcurrency);\n const chunks: (typeof tasks)[] = [];\n\n for (let i = 0; i < tasks.length; i += chunkSize) {\n chunks.push(tasks.slice(i, i + chunkSize));\n }\n\n logger.debug(\n `Processing ${tasks.length} tasks with ${effectiveConcurrency} contexts in ${chunks.length} chunks`,\n );\n\n const allResults = await Promise.all(\n chunks.map(async (chunk, chunkIndex) => {\n const page = screenshotTool.getPageFromPool(chunkIndex);\n const chunkResults = [];\n let context: any;\n\n // Initialize page if plugin has initPage method\n if (plugin.initPage) {\n context = await plugin.initPage(page, screenshotTool);\n }\n\n for (const task of chunk) {\n logger.debug(`Executing task: ${task.id}`);\n const result = await plugin.execute(\n task,\n page,\n screenshotTool,\n context,\n );\n chunkResults.push(result);\n }\n\n return chunkResults;\n }),\n );\n\n const results = allResults.flat();\n logger.success(\n `Plugin ${plugin.name} completed: ${results.length} results`,\n );\n }\n\n logger.success(\"All plugins completed successfully\");\n } catch (error) {\n logger.error(\"Error during plugin execution:\", error);\n throw error;\n } finally {\n // Always close the browser to ensure the process exits\n await screenshotTool.close();\n }\n });\n\nprogram\n .command(\"review\")\n .description(\"Review screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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 });\n\n logger.success(\"Review UI available at http://localhost:3000\");\n await server.listen({ port: 3000 });\n });\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(async (options) => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\n\n const actualScreenshotsPromise = glob(\n path.resolve(config.outputDir, \"actual\", \"**/*.png\"),\n );\n\n const [actualScreenshots] = await Promise.all([actualScreenshotsPromise]);\n\n let screenshotsToApprove = actualScreenshots;\n\n if (options.filter?.length) {\n const filters = options.filter.map((filter: string) =>\n filter.toLowerCase(),\n );\n logger.debug(\n `Filtering actual screenshots by filter: ${filters.join(\", \")}`,\n );\n\n screenshotsToApprove = actualScreenshots.filter((screenshot) => {\n const screenshotName = path.basename(screenshot).toLowerCase();\n const screenshotPath = screenshot.toLowerCase();\n\n return filters.some(\n (filter: string) =>\n screenshotName.includes(filter) || screenshotPath.includes(filter),\n );\n });\n\n if (screenshotsToApprove.length === 0) {\n logger.warn(\"No screenshots matched the provided filter(s)\");\n return;\n }\n }\n\n const fileSystem = new ScreenshotFileSystem(config.outputDir);\n\n // copy actual screenshots to expected directory\n for (const screenshot of screenshotsToApprove) {\n fileSystem.approveFromActualPath(screenshot);\n }\n\n if (screenshotsToApprove.length === actualScreenshots.length) {\n logger.success(\"All screenshots approved\");\n } else {\n logger.success(\n `${screenshotsToApprove.length} screenshot(s) approved (filtered)`,\n );\n }\n });\n\nprogram\n .command(\"status\")\n .description(\"Get status of screenshots\")\n .action(async () => {\n const logger = getLogger();\n\n const result = await getCosmiConfig(\"cappa\");\n const config = await getConfig(result);\n\n logger.debug(\"Configuration loaded:\", JSON.stringify(config, null, 2));\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 actualScreenshots,\n expectedScreenshots,\n 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\nprogram\n .command(\"init\")\n .description(\"Initialize Cappa in the current directory\")\n .action(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 const configContent = `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\n fs.writeFileSync(configPath, configContent);\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(\n fs.readFileSync(packageJsonPath, \"utf-8\"),\n );\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\nexport async function run(): Promise<void> {\n await program.parseAsync();\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,8 +1,9 @@
1
1
  {
2
2
  "name": "@cappa/cli",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "Command line interface for Cappa",
5
5
  "author": "Tim Richter",
6
+ "license": "MIT",
6
7
  "keywords": [
7
8
  "screenshot",
8
9
  "cli"
@@ -10,7 +11,6 @@
10
11
  "publishConfig": {
11
12
  "access": "public"
12
13
  },
13
- "license": "MIT",
14
14
  "main": "./dist/index.js",
15
15
  "module": "./dist/index.mjs",
16
16
  "types": "./dist/index.d.ts",
@@ -34,24 +34,26 @@
34
34
  "chalk": "^5.6.2",
35
35
  "commander": "14.0.1",
36
36
  "cosmiconfig": "9.0.0",
37
- "glob": "^11.0.3",
38
- "jiti": "2.5.1",
37
+ "jiti": "2.6.1",
39
38
  "picocolors": "1.1.1",
40
39
  "ts-node": "10.9.2",
41
- "@cappa/core": "0.1.2",
42
- "@cappa/server": "0.1.2",
43
- "@cappa/logger": "0.0.2"
40
+ "@cappa/core": "0.2.0",
41
+ "@cappa/logger": "0.0.3",
42
+ "@cappa/server": "0.1.4"
44
43
  },
45
44
  "devDependencies": {
46
- "@types/node": "22.13.10",
45
+ "@types/node": "24.8.0",
47
46
  "@vitest/coverage-v8": "3.2.4",
48
47
  "@vitest/ui": "3.2.4",
49
- "tsdown": "0.14.1",
50
- "typescript": "5.7.3",
48
+ "tsdown": "0.15.7",
49
+ "typescript": "5.9.3",
51
50
  "vitest": "3.2.4"
52
51
  },
53
52
  "scripts": {
54
53
  "test": "vitest",
54
+ "test:run": "vitest --run",
55
+ "test:ui": "vitest --ui",
56
+ "test:coverage": "vitest --coverage",
55
57
  "screenshot": "node src/index.ts",
56
58
  "build": "tsdown",
57
59
  "tsc": "tsc"