@crvy/rprtr 0.0.9 → 0.1.0

package/CHANGELOG.md

@@ -5,6 +5,56 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.0] - 2026-06-08
+
+### Added
+
+- **resolver:** Expose playwrightAnonymousVisualName
+- **resolver:** Add withResolvedVisualNames
+- **server:** Add isPathWithinRoots allowlist helper
+- **server:** Add allowlisted /file artifact route
+- **server:** Add /baseline route, consolidate baseline resolution
+- **server:** Wire artifactRoots and outputDir option
+- Add isCI helper
+- **report-utils:** Route absolute attachment paths to /file
+- **server:** Enrich declared-only images with /baseline urls
+- **reporter:** Add rewriteTestEndAttachments helper
+- **reporter:** Gate screenshot copying and artifacts on CI
+- **cli:** Add --output-dir for live native artifact serving
+
+### Changed
+
+- **resolver:** Compute anonymous title list once
+
+### Documentation
+
+- **spec:** CI-gated screenshot artifact handling design
+- **plans:** Naming fix, live-mode serving, CI-gated copying
+- **server:** Clarify outputDir is resolved against CWD
+
+### Fixed
+
+- Apply web socket payloads directly to the client tree
+- **reporter:** Use Playwright auto-name for unnamed screenshots
+- **server:** Realpath-guard /file route and set nosniff header
+- **server:** Guard /baseline decode, retry parsing, and read errors
+- **server:** Exclude test source dir from /file allowlist
+- **server:** Guard /baseline url parsing, decode testId, test nosniff
+- **server:** Decode /file URLs in approval path
+- **server:** Only enrich declared-only baselines for passed tests
+- **server:** Enrich baselines only when the snapshot file exists
+- **reporter:** Bound onEnd concurrency, fix retry attachments, stop CI queue growth
+
+### Styling
+
+- **client:** Center-align image comparison views
+
+### Testing
+
+- **report-state:** Assert no phantom entry for finalized unnamed screenshot
+- **report-state:** Make phantom-entry guard falsifiable
+- Document phantom fixture divergence and cover multi-occurrence rewrite
+- **server:** Cover raw-traversal and empty-roots cases for isPathWithinRoots
 ## [0.0.9] - 2026-06-05
 
 ### Fixed

package/dist/{chunk-TS64TROX.js → chunk-35CZLYSW.js}

@@ -1,17 +1,18 @@
 import {
   ApproveRequestBodySchema,
+  IncomingWebSocketMessageSchema,
   LoadedReportDataSchema,
   OfflineReportSchema,
+  RunEndDataSchema,
   TestBeginDataSchema,
   TestEndDataSchema,
-  WebSocketMessageSchema,
   applyTestBeginEvent,
   applyTestEndEvent,
   createMutableReportState,
   finalizeRunEvent,
   resolveBaselineTargets,
   safeParse
-} from "./chunk-EJRLZZ22.js";
+} from "./chunk-43JLQN36.js";
 
 // src/server/app.ts
 import { dirname as dirname3, join as join3 } from "path";
@@ -157,7 +158,10 @@ async function respondWithFile(filePath, contentType) {
   try {
     const file = await readFile(filePath);
     const resolvedContentType = contentType ?? inferContentType(filePath);
-    const headers = resolvedContentType === void 0 ? void 0 : { "Content-Type": resolvedContentType };
+    const headers = { "X-Content-Type-Options": "nosniff" };
+    if (resolvedContentType !== void 0) {
+      headers["Content-Type"] = resolvedContentType;
+    }
     return new Response(file, { headers });
   } catch (error) {
     if (isFileNotFound(error)) {
@@ -167,56 +171,210 @@ async function respondWithFile(filePath, contentType) {
   }
 }
 
+// src/server/handlers.ts
+import { existsSync as existsSync2 } from "fs";
+
+// src/server/artifact-routes.ts
+import { existsSync } from "fs";
+import { realpath } from "fs/promises";
+import { dirname as dirname2, resolve as resolve2 } from "path";
+
 // src/server/utils.ts
+import { isAbsolute, relative, resolve, sep } from "path";
+var LIVE_UPDATES_WEBSOCKET_PATH = "/";
 function broadcastToBrowsers(wsClients, msg) {
   const payload = JSON.stringify(msg);
   wsClients.forEach((ws) => {
     ws.send(payload);
   });
 }
+function isWebSocketUpgradeRequest(req) {
+  return new URL(req.url).pathname === LIVE_UPDATES_WEBSOCKET_PATH && req.headers.get("upgrade")?.toLowerCase() === "websocket";
+}
+function isPathWithinRoots(target, roots) {
+  const resolvedTarget = resolve(target);
+  return roots.some((root) => {
+    const rel = relative(resolve(root), resolvedTarget);
+    return rel === "" || !rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel);
+  });
+}
+
+// src/server/artifact-routes.ts
+async function realpathOrNull(path) {
+  try {
+    return await realpath(path);
+  } catch {
+    return null;
+  }
+}
+async function handleFile(ctx, req) {
+  const notFound = () => new Response("Not Found", { status: 404 });
+  let decodedPath;
+  try {
+    decodedPath = resolve2(decodeURIComponent(new URL(req.url).pathname.slice("/file/".length)));
+  } catch {
+    return notFound();
+  }
+  const realTarget = await realpathOrNull(decodedPath);
+  if (realTarget === null) {
+    return notFound();
+  }
+  const realRoots = (await Promise.all((ctx.artifactRoots ?? []).map((root) => realpathOrNull(resolve2(root))))).filter(
+    (root) => root !== null
+  );
+  if (!isPathWithinRoots(realTarget, realRoots)) {
+    return notFound();
+  }
+  try {
+    const file = await respondWithFile(realTarget);
+    return file ?? notFound();
+  } catch {
+    return notFound();
+  }
+}
+function reporterTitlePath(test) {
+  const testFile = test.location?.file;
+  return ["", test.browser, testFile ?? "", ...test.titlePath, test.title];
+}
+function resolveBaselineSnapshotPath(routing, test, retry, imageName) {
+  const testFile = test.location?.file;
+  const declaration = test.results?.[retry]?.visualDeclarations?.find((candidate) => candidate.visualName === imageName);
+  if (routing === void 0 || testFile === void 0 || declaration === void 0) {
+    return null;
+  }
+  const targets = resolveBaselineTargets({
+    testFile,
+    reporterTitlePath: reporterTitlePath(test),
+    declarations: [declaration],
+    config: {
+      configDir: routing.configDir,
+      testDir: routing.playwrightTestDir ?? dirname2(testFile),
+      snapshotDir: routing.playwrightSnapshotDir ?? dirname2(testFile),
+      projectName: test.browser,
+      snapshotSuffix: process.platform,
+      snapshotPathTemplate: routing.playwrightSnapshotPathTemplate,
+      toHaveScreenshotPathTemplate: routing.playwrightToHaveScreenshotPathTemplate
+    },
+    snapshotPathExists: existsSync
+  });
+  return targets.length === 1 ? targets[0]?.snapshotPath ?? null : null;
+}
+async function handleBaseline(ctx, req) {
+  const notFound = () => new Response("Not Found", { status: 404 });
+  let testId;
+  let retry;
+  let visualName;
+  try {
+    const segments = new URL(req.url).pathname.slice("/baseline/".length).split("/");
+    const [rawTestId, retryRaw, ...visualNameParts] = segments;
+    if (rawTestId === void 0 || retryRaw === void 0 || !/^\d+$/.test(retryRaw) || visualNameParts.length === 0) {
+      return notFound();
+    }
+    testId = decodeURIComponent(rawTestId);
+    retry = Number(retryRaw);
+    visualName = decodeURIComponent(visualNameParts.join("/"));
+  } catch {
+    return notFound();
+  }
+  const test = ctx.reportData.tests[testId];
+  if (test === void 0) {
+    return notFound();
+  }
+  const snapshotPath = resolveBaselineSnapshotPath(ctx.approvalRouting, test, retry, visualName);
+  if (snapshotPath === null) {
+    return notFound();
+  }
+  try {
+    const file = await respondWithFile(snapshotPath);
+    return file ?? notFound();
+  } catch {
+    return notFound();
+  }
+}
+function handleArtifactRoute(ctx, req, pathname) {
+  if (pathname.startsWith("/file/")) {
+    return handleFile(ctx, req);
+  }
+  if (pathname.startsWith("/baseline/")) {
+    return handleBaseline(ctx, req);
+  }
+  return null;
+}
 
 // src/server/handlers.ts
 function handleTestBegin(ctx, data) {
   const test = applyTestBeginEvent(ctx, data);
   ctx.reportData.isRunning = true;
   console.log(`  \u25B6 [${test.browser ?? "?"}] ${test.title}`);
-  broadcastToBrowsers(ctx.wsClients, { type: "test-begin", data });
+  const message = { type: "test-begin", data: test };
+  broadcastToBrowsers(ctx.wsClients, message);
+}
+function enrichDeclaredBaselines(ctx, test) {
+  const retry = (test.results?.length ?? 0) - 1;
+  const images = test.results?.[retry]?.images;
+  if (retry < 0 || images === void 0) {
+    return;
+  }
+  for (const [visualName, image] of Object.entries(images)) {
+    if (image === void 0 || image.source !== "declared-only") {
+      continue;
+    }
+    const snapshotPath = resolveBaselineSnapshotPath(ctx.approvalRouting, test, retry, visualName);
+    if (snapshotPath === null || !existsSync2(snapshotPath)) {
+      continue;
+    }
+    image.expect = `/baseline/${encodeURIComponent(test.id)}/${retry}/${encodeURIComponent(visualName)}`;
+    image.source = "baseline-only";
+  }
 }
 function handleTestEnd(ctx, data) {
   const result = applyTestEndEvent(ctx, data);
-  if (result !== null) {
-    const { test, diffCount } = result;
-    const icon = data.status === "passed" ? "\u2713" : data.status === "skipped" ? "\u2013" : "\u2717";
-    const dur = data.duration === null || data.duration === void 0 ? "" : ` (${data.duration}ms)`;
-    const diffNote = diffCount > 0 ? ` [${diffCount} diff(s)]` : "";
-    const errNote = data.error !== null && data.error !== void 0 ? `
-    Error: ${data.error}` : "";
-    console.log(`  ${icon} [${test.browser}] ${test.title}${dur}${diffNote}${errNote}`);
+  if (result === null) {
+    console.error("[Server] test-end for unknown test id:", data.id);
+    return;
+  }
+  const { test, diffCount } = result;
+  if (data.status === "passed") {
+    enrichDeclaredBaselines(ctx, test);
   }
-  broadcastToBrowsers(ctx.wsClients, { type: "test-update", data });
+  const icon = data.status === "passed" ? "\u2713" : data.status === "skipped" ? "\u2013" : "\u2717";
+  const dur = data.duration === null || data.duration === void 0 ? "" : ` (${data.duration}ms)`;
+  const diffNote = diffCount > 0 ? ` [${diffCount} diff(s)]` : "";
+  const errNote = data.error !== null && data.error !== void 0 ? `
+    Error: ${data.error}` : "";
+  console.log(`  ${icon} [${test.browser}] ${test.title}${dur}${diffNote}${errNote}`);
+  const message = { type: "test-update", data: test };
+  broadcastToBrowsers(ctx.wsClients, message);
 }
 async function handleRunEnd(ctx, data) {
+  const removedTestIds = Object.keys(ctx.reportData.tests).filter((id) => !ctx.currentRunIds.has(id));
   const { passed, failed, pending } = finalizeRunEvent(ctx);
   await ctx.saveReport();
   console.log(`
 Run complete \u2014 ${passed} passed, ${failed} failed, ${pending} skipped`);
-  broadcastToBrowsers(ctx.wsClients, { type: "run-end", data });
+  const message = {
+    type: "run-end",
+    data: { status: data.status, removedTestIds }
+  };
+  broadcastToBrowsers(ctx.wsClients, message);
 }
 function handleApprove() {
   console.log("[Server] Received approve message via WebSocket (handled via HTTP API)");
 }
 function handleSync(ctx) {
   console.log("[Server] Received sync message");
-  broadcastToBrowsers(ctx.wsClients, { type: "sync", data: ctx.reportData });
+  const message = {
+    type: "sync",
+    data: {
+      tests: ctx.reportData.tests,
+      isUpdateMode: ctx.reportData.isUpdateMode
+    }
+  };
+  broadcastToBrowsers(ctx.wsClients, message);
 }
 
 // src/server/routes.ts
-import { existsSync } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
-var LIVE_UPDATES_WEBSOCKET_PATH = "/";
-function isWebSocketUpgradeRequest(req) {
-  return new URL(req.url).pathname === LIVE_UPDATES_WEBSOCKET_PATH && req.headers.get("upgrade")?.toLowerCase() === "websocket";
-}
+import { join as join2 } from "path";
 async function handleRoot(ctx) {
   const html = await respondWithFile(join2(ctx.staticDir, "index.html"), "text/html");
   return html ?? new Response("Not Found", { status: 404 });
@@ -237,34 +395,13 @@ function handleApiReport(ctx) {
 }
 var APPROVAL_TARGET_ERROR = "Could not resolve approval target";
 function actualPathFromUrl(ctx, actualUrl) {
-  return actualUrl.startsWith("/screenshots/") ? join2(ctx.reportData.screenshotDir, actualUrl.slice("/screenshots/".length)) : actualUrl;
-}
-function reporterTitlePath(test) {
-  const testFile = test.location?.file;
-  return ["", test.browser, testFile ?? "", ...test.titlePath, test.title];
-}
-function resolveApprovalTarget(ctx, test, retry, imageName) {
-  const testFile = test.location?.file;
-  const declaration = test.results?.[retry]?.visualDeclarations?.find((candidate) => candidate.visualName === imageName);
-  if (ctx.approvalRouting === void 0 || testFile === void 0 || declaration === void 0) {
-    return null;
+  if (actualUrl.startsWith("/screenshots/")) {
+    return join2(ctx.reportData.screenshotDir, actualUrl.slice("/screenshots/".length));
   }
-  const targets = resolveBaselineTargets({
-    testFile,
-    reporterTitlePath: reporterTitlePath(test),
-    declarations: [declaration],
-    config: {
-      configDir: ctx.approvalRouting.configDir,
-      testDir: ctx.approvalRouting.playwrightTestDir ?? dirname2(testFile),
-      snapshotDir: ctx.approvalRouting.playwrightSnapshotDir ?? dirname2(testFile),
-      projectName: test.browser,
-      snapshotSuffix: process.platform,
-      snapshotPathTemplate: ctx.approvalRouting.playwrightSnapshotPathTemplate,
-      toHaveScreenshotPathTemplate: ctx.approvalRouting.playwrightToHaveScreenshotPathTemplate
-    },
-    snapshotPathExists: existsSync
-  });
-  return targets.length === 1 ? targets[0]?.snapshotPath ?? null : null;
+  if (actualUrl.startsWith("/file/")) {
+    return decodeURIComponent(actualUrl.slice("/file/".length));
+  }
+  return actualUrl;
 }
 async function handleApiApprove(ctx, req) {
   try {
@@ -283,7 +420,7 @@ async function handleApiApprove(ctx, req) {
     if (actualUrl === void 0) {
       return Response.json({ success: false, error: "Actual image not found" }, { status: 409 });
     }
-    const snapshotPath = resolveApprovalTarget(ctx, test, retry, image);
+    const snapshotPath = resolveBaselineSnapshotPath(ctx.approvalRouting, test, retry, image);
     if (snapshotPath === null) {
       return Response.json({ success: false, error: APPROVAL_TARGET_ERROR }, { status: 409 });
     }
@@ -318,7 +455,7 @@ function createBulkApprovalUpdates(ctx) {
       if (actualUrl === void 0) {
         return [Promise.resolve({ kind: "unresolved" })];
       }
-      const snapshotPath = resolveApprovalTarget(ctx, test, lastRetry, imageName);
+      const snapshotPath = resolveBaselineSnapshotPath(ctx.approvalRouting, test, lastRetry, imageName);
       if (snapshotPath === null) {
         return [Promise.resolve({ kind: "unresolved" })];
       }
@@ -409,6 +546,10 @@ function handleHttpRequest(ctx, req) {
   if (pathname.startsWith("/api/images/")) {
     return handleApiImages(req);
   }
+  const artifactResponse = handleArtifactRoute(ctx, req, pathname);
+  if (artifactResponse !== null) {
+    return artifactResponse;
+  }
   if (pathname.startsWith("/screenshots/")) {
     return handleScreenshots(ctx, req);
   }
@@ -429,12 +570,13 @@ function createReportData(options) {
     screenshotDir: options.screenshotDir ?? "./screenshots"
   };
 }
-function createHandlerContext(reportData, wsClients, currentRunIds, saveReport) {
+function createHandlerContext(reportData, wsClients, currentRunIds, saveReport, approvalRouting) {
   return {
     reportData,
     wsClients,
     currentRunIds,
-    saveReport
+    saveReport,
+    approvalRouting
   };
 }
 async function loadReport(reportPath, reportData) {
@@ -504,9 +646,15 @@ async function handleParsedWebSocketMessage(ctx, msg) {
       handleTestEnd(ctx, parsed);
       break;
     }
-    case "run-end":
-      await handleRunEnd(ctx, msg.data);
+    case "run-end": {
+      const parsed = safeParse(RunEndDataSchema, msg.data);
+      if (parsed === null) {
+        console.error("Invalid run-end message data", msg.data);
+        break;
+      }
+      await handleRunEnd(ctx, parsed);
       break;
+    }
     case "approve":
       handleApprove();
       break;
@@ -519,7 +667,7 @@ function createWebSocketMessageHandler(getHandlerContext) {
   return async function handleWebSocketMessage(message) {
     try {
       const parsed = JSON.parse(message);
-      const wsMessage = safeParse(WebSocketMessageSchema, parsed);
+      const wsMessage = safeParse(IncomingWebSocketMessageSchema, parsed);
       if (wsMessage === null) {
         console.error("Invalid WebSocket message: missing or invalid type", parsed);
         return;
@@ -560,10 +708,14 @@ async function resolveReportPath(reportPath) {
   return { reportFile: reportPath, offlineReportDir: dirname3(reportPath) };
 }
 function createRoutesContext(reportData, staticDir, saveReport, options) {
+  const artifactRoots = [reportData.screenshotDir, options.outputDir, options.playwrightSnapshotDir].filter(
+    (root) => root !== void 0 && root !== ""
+  );
   return {
     reportData,
     staticDir,
     saveReport,
+    artifactRoots,
     approvalRouting: {
       configDir: options.configDir ?? process.cwd(),
       playwrightTestDir: options.playwrightTestDir,
@@ -585,7 +737,7 @@ async function createServerApp(options = {}) {
     await writeJsonFile(reportFile, reportData);
   }
   const routesContext = createRoutesContext(reportData, staticDir, saveReport, options);
-  const getHandlerContext = () => createHandlerContext(reportData, wsClients, currentRunIds, saveReport);
+  const getHandlerContext = () => createHandlerContext(reportData, wsClients, currentRunIds, saveReport, routesContext.approvalRouting);
   const handleRequest = (req) => handleHttpRequest(routesContext, req);
   const handleWebSocketMessage = createWebSocketMessageHandler(getHandlerContext);
   await loadReport(reportFile, reportData);
@@ -775,7 +927,7 @@ function attachWebSocketServer(server, app) {
   });
 }
 async function listen(server, port) {
-  await new Promise((resolve, reject) => {
+  await new Promise((resolve3, reject) => {
     const onError = (error) => {
       server.off("error", onError);
       reject(error);
@@ -783,7 +935,7 @@ async function listen(server, port) {
     server.on("error", onError);
     server.listen(port, () => {
       server.off("error", onError);
-      resolve();
+      resolve3();
     });
   });
 }

package/dist/{chunk-EJRLZZ22.js → chunk-43JLQN36.js}

@@ -131,9 +131,15 @@ function resolveNamedTarget(input, declaration) {
 function reporterTitlesWithoutProjectAndFile(reporterTitlePath) {
   return reporterTitlePath.slice(3).filter((part) => part !== "");
 }
+function anonymousNameFromTitles(titles, occurrenceIndex) {
+  return sanitizeFilePathBeforeExtension(trimLongString(`${titles.join(" ")} ${occurrenceIndex}.png`), ".png");
+}
 function anonymousName(reporterTitlePath, occurrenceIndex) {
-  const rawAnonymousName = `${reporterTitlesWithoutProjectAndFile(reporterTitlePath).join(" ")} ${occurrenceIndex}.png`;
-  return sanitizeFilePathBeforeExtension(trimLongString(rawAnonymousName), ".png");
+  return anonymousNameFromTitles(reporterTitlesWithoutProjectAndFile(reporterTitlePath), occurrenceIndex);
+}
+function playwrightAnonymousVisualName(reporterTitlePath, occurrenceIndex) {
+  const titles = reporterTitlesWithoutProjectAndFile(reporterTitlePath);
+  return titles.length === 0 ? null : removeExtension(anonymousNameFromTitles(titles, occurrenceIndex), ".png");
 }
 function resolveTarget(input, declaration) {
   switch (declaration.kind) {
@@ -147,6 +153,15 @@ function resolveTarget(input, declaration) {
     }
   }
 }
+function withResolvedVisualNames(declarations, reporterTitlePath) {
+  return declarations.map((declaration) => {
+    if (declaration.kind !== "unnamed") {
+      return declaration;
+    }
+    const resolvedName = playwrightAnonymousVisualName(reporterTitlePath, declaration.occurrenceIndex);
+    return resolvedName === null ? declaration : { ...declaration, visualName: resolvedName };
+  });
+}
 function resolveBaselineTargets(input) {
   return input.declarations.flatMap((declaration) => {
     const resolvedTarget = resolveTarget(input, declaration);
@@ -224,10 +239,29 @@ var CrvyRprtrSuiteSchema = z.lazy(
     children: z.record(z.string(), z.union([CrvyRprtrSuiteSchema, CrvyRprtrTestSchema])).optional()
   })
 );
-var WebSocketMessageSchema = z.object({
+var IncomingWebSocketMessageSchema = z.object({
   type: z.enum(["test-begin", "test-end", "run-end", "approve", "sync"]),
   data: z.unknown()
 });
+var WebSocketMessageSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("test-begin"), data: TestDataSchema }),
+  z.object({ type: z.literal("test-update"), data: TestDataSchema }),
+  z.object({
+    type: z.literal("run-end"),
+    data: z.object({
+      status: z.enum(["passed", "failed", "skipped"]),
+      removedTestIds: z.array(z.string())
+    })
+  }),
+  z.object({
+    type: z.literal("sync"),
+    data: z.object({
+      tests: z.record(z.string(), TestDataSchema),
+      isUpdateMode: z.boolean().optional()
+    })
+  }),
+  z.object({ type: z.literal("approve"), data: z.unknown() })
+]);
 var TestBeginDataSchema = z.object({
   id: z.string(),
   title: z.string(),
@@ -247,6 +281,9 @@ var TestEndDataSchema = z.object({
   error: z.string().optional(),
   duration: z.number().optional()
 });
+var RunEndDataSchema = z.object({
+  status: z.enum(["passed", "failed", "skipped"])
+});
 var ReportDataSchema = z.object({
   isRunning: z.boolean(),
   tests: z.record(z.string(), TestDataSchema),
@@ -297,6 +334,7 @@ function safeParse(schema, data) {
 }
 
 // src/report-utils.ts
+import { isAbsolute } from "path";
 function normalizeScreenshotsBaseUrl(baseUrl) {
   return baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
 }
@@ -341,7 +379,7 @@ function attachmentsToImages(attachments, screenshotsBaseUrl = "/screenshots/")
     const role = match[2];
     if (baseName === null || baseName === void 0 || role === null || role === void 0) continue;
     images[baseName] ??= {};
-    const url = `${baseUrl}${attachment.path}`;
+    const url = isAbsolute(attachment.path) ? `/file/${encodeURIComponent(attachment.path)}` : `${baseUrl}${attachment.path}`;
     const img = images[baseName];
     if (img !== null && img !== void 0) {
       if (role === "actual") img.actual = url;
@@ -488,13 +526,15 @@ export {
   applyTestBeginEvent,
   applyTestEndEvent,
   finalizeRunEvent,
-  WebSocketMessageSchema,
+  IncomingWebSocketMessageSchema,
   TestBeginDataSchema,
   TestEndDataSchema,
+  RunEndDataSchema,
   LoadedReportDataSchema,
   OfflineReportSchema,
   ApproveRequestBodySchema,
   ClientBootstrapDataSchema,
   safeParse,
+  withResolvedVisualNames,
   resolveBaselineTargets
 };

package/dist/ci.d.ts

@@ -0,0 +1,2 @@
+export declare function isCI(env?: Record<string, string | undefined>): boolean;
+//# sourceMappingURL=ci.d.ts.map

package/dist/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAGnF"}

package/dist/cli.d.ts

@@ -4,6 +4,7 @@ interface ResolvedCliOptions extends ServerOptions {
     port: number;
     screenshotDir: string;
     reportPath: string;
+    outputDir: string;
 }
 export declare function resolveCliOptions(args: string[]): ResolvedCliOptions;
 export {};

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAM7D,UAAU,kBAAmB,SAAQ,aAAa;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CA0BpE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAO7D,UAAU,kBAAmB,SAAQ,aAAa;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CA4BpE"}

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   startServer
-} from "./chunk-TS64TROX.js";
-import "./chunk-EJRLZZ22.js";
+} from "./chunk-35CZLYSW.js";
+import "./chunk-43JLQN36.js";
 
 // src/cli.ts
 import { join } from "path";
@@ -31,6 +31,7 @@ function isDirectExecution(moduleUrl) {
 var DEFAULT_PORT = 3e3;
 var DEFAULT_SCREENSHOT_DIR = "./screenshots";
 var DEFAULT_REPORT_PATH = "./report.json";
+var DEFAULT_OUTPUT_DIR = "./test-results";
 function resolveCliOptions(args) {
   const { values, positionals } = parseArgs({
     args,
@@ -38,7 +39,8 @@ function resolveCliOptions(args) {
     options: {
       port: { type: "string", short: "p", default: `${DEFAULT_PORT}` },
       "screenshot-dir": { type: "string", short: "s" },
-      "report-path": { type: "string", short: "r" }
+      "report-path": { type: "string", short: "r" },
+      "output-dir": { type: "string", short: "o" }
     }
   });
   if (positionals.length > 1) {
@@ -50,7 +52,8 @@ function resolveCliOptions(args) {
   return {
     port: parseInt(values.port ?? `${DEFAULT_PORT}`, 10),
     screenshotDir,
-    reportPath
+    reportPath,
+    outputDir: values["output-dir"] ?? DEFAULT_OUTPUT_DIR
   };
 }
 if (isDirectExecution(import.meta.url)) {