@crvy/rprtr 0.2.3 → 0.3.0

package/dist/cli.d.ts

@@ -1,11 +1,18 @@
 #!/usr/bin/env node
 import { type ServerOptions } from './server.ts';
+import type { DockerOptions } from './server/docker-launcher.ts';
+import type { RunMode } from './server/run-mode.ts';
 interface ResolvedCliOptions extends ServerOptions {
     port: number;
     screenshotDir: string;
     reportPath: string;
     outputDir: string;
+    runMode?: RunMode;
+    docker?: DockerOptions;
 }
+export declare const HELP_TEXT = "Usage: crvy-rprtr [artifact-dir] [options]\n\nStart the @crvy/rprtr visual regression report UI server.\n\nArguments:\n  artifact-dir                Directory of downloaded CI test artifacts. When set,\n                              --report-path defaults to <dir>/report.json and\n                              --screenshot-dir defaults to <dir>/screenshots.\n\nOptions:\n  -p, --port <number>           Server port (default: 3000)\n  -s, --screenshot-dir <dir>    Screenshot artifact directory (default: ./screenshots)\n  -r, --report-path <path>      Path to report.json (default: ./report.json)\n  -o, --output-dir <dir>        Playwright test output directory (default: ./test-results)\n  -c, --config <path>           Path to playwright.config.ts, used for approval routing\n  --run-mode <mode>             Test run backend: local, docker, or auto (default: auto)\n  --docker-image <image>        Docker image for docker mode (default: official Playwright image matching the installed @playwright/test version)\n  --docker-platform <platform>  Container platform: linux/amd64 or linux/arm64 (default: host architecture)\n  -h, --help                    Show this help message\n";
+export declare function printHelp(): void;
+export declare function wantsHelp(args: string[]): boolean;
 export declare function resolveCliOptions(args: string[]): ResolvedCliOptions;
 export {};
 //# sourceMappingURL=cli.d.ts.map

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;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,CA8BpE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAOnD,UAAU,kBAAmB,SAAQ,aAAa;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED,eAAO,MAAM,SAAS,oqCAmBrB,CAAA;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAgDpE"}

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   startServer
-} from "./chunk-473CWZ4V.js";
-import "./chunk-HAFWYUNO.js";
+} from "./chunk-IFHYWPXG.js";
+import "./chunk-4YJL655E.js";
 
 // src/cli.ts
 import { join } from "path";
@@ -32,6 +32,32 @@ var DEFAULT_PORT = 3e3;
 var DEFAULT_SCREENSHOT_DIR = "./screenshots";
 var DEFAULT_REPORT_PATH = "./report.json";
 var DEFAULT_OUTPUT_DIR = "./test-results";
+var HELP_TEXT = `Usage: crvy-rprtr [artifact-dir] [options]
+
+Start the @crvy/rprtr visual regression report UI server.
+
+Arguments:
+  artifact-dir                Directory of downloaded CI test artifacts. When set,
+                              --report-path defaults to <dir>/report.json and
+                              --screenshot-dir defaults to <dir>/screenshots.
+
+Options:
+  -p, --port <number>           Server port (default: 3000)
+  -s, --screenshot-dir <dir>    Screenshot artifact directory (default: ./screenshots)
+  -r, --report-path <path>      Path to report.json (default: ./report.json)
+  -o, --output-dir <dir>        Playwright test output directory (default: ./test-results)
+  -c, --config <path>           Path to playwright.config.ts, used for approval routing
+  --run-mode <mode>             Test run backend: local, docker, or auto (default: auto)
+  --docker-image <image>        Docker image for docker mode (default: official Playwright image matching the installed @playwright/test version)
+  --docker-platform <platform>  Container platform: linux/amd64 or linux/arm64 (default: host architecture)
+  -h, --help                    Show this help message
+`;
+function printHelp() {
+  console.log(HELP_TEXT);
+}
+function wantsHelp(args) {
+  return args.includes("--help") || args.includes("-h");
+}
 function resolveCliOptions(args) {
   const { values, positionals } = parseArgs({
     args,
@@ -41,7 +67,10 @@ function resolveCliOptions(args) {
       "screenshot-dir": { type: "string", short: "s" },
       "report-path": { type: "string", short: "r" },
       "output-dir": { type: "string", short: "o" },
-      config: { type: "string", short: "c" }
+      config: { type: "string", short: "c" },
+      "run-mode": { type: "string" },
+      "docker-image": { type: "string" },
+      "docker-platform": { type: "string" }
     }
   });
   if (positionals.length > 1) {
@@ -50,17 +79,39 @@ function resolveCliOptions(args) {
   const artifactDir = positionals[0];
   const reportPath = values["report-path"] ?? (artifactDir === void 0 ? DEFAULT_REPORT_PATH : join(artifactDir, "report.json"));
   const screenshotDir = values["screenshot-dir"] ?? (artifactDir === void 0 ? DEFAULT_SCREENSHOT_DIR : join(artifactDir, "screenshots"));
+  const runMode = values["run-mode"];
+  if (runMode !== void 0 && runMode !== "local" && runMode !== "docker" && runMode !== "auto") {
+    throw new TypeError(`Invalid --run-mode: ${runMode} (expected local, docker, or auto)`);
+  }
+  const dockerPlatform = values["docker-platform"];
+  if (dockerPlatform !== void 0 && dockerPlatform !== "linux/amd64" && dockerPlatform !== "linux/arm64") {
+    throw new TypeError(`Invalid --docker-platform: ${dockerPlatform} (expected linux/amd64 or linux/arm64)`);
+  }
+  const docker = {};
+  if (values["docker-image"] !== void 0) docker.image = values["docker-image"];
+  if (dockerPlatform !== void 0) docker.platform = dockerPlatform;
+  const hasDockerOptions = values["docker-image"] !== void 0 || dockerPlatform !== void 0;
   return {
     port: parseInt(values.port ?? `${DEFAULT_PORT}`, 10),
     screenshotDir,
     reportPath,
     outputDir: values["output-dir"] ?? DEFAULT_OUTPUT_DIR,
-    playwrightConfig: values.config
+    playwrightConfig: values.config,
+    ...runMode === void 0 ? {} : { runMode },
+    ...hasDockerOptions ? { docker } : {}
   };
 }
 if (isDirectExecution(import.meta.url)) {
-  await startServer(resolveCliOptions(process.argv.slice(2)));
+  const args = process.argv.slice(2);
+  if (wantsHelp(args)) {
+    printHelp();
+  } else {
+    await startServer(resolveCliOptions(args));
+  }
 }
 export {
-  resolveCliOptions
+  HELP_TEXT,
+  printHelp,
+  resolveCliOptions,
+  wantsHelp
 };

package/dist/index.css

@@ -305,6 +305,9 @@
   .mr-3 {
     margin-right: calc(var(--spacing) * 3);
   }
+  .mb-1 {
+    margin-bottom: calc(var(--spacing) * 1);
+  }
   .mb-2 {
     margin-bottom: calc(var(--spacing) * 2);
   }
@@ -841,6 +844,10 @@
   .outline-accent {
     outline-color: var(--color-accent);
   }
+  .grayscale {
+    --tw-grayscale: grayscale(100%);
+    filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
+  }
   .invert {
     --tw-invert: invert(100%);
     filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);