@crvy/rprtr 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.3.3] - 2026-09-14
+
+### Added
+
+- **rendering:** Pin grayscale text antialiasing in every run mode
+
+### Documentation
+
+- **examples:** Add component-testing example for playwright stories + gallery
+
+### Fixed
+
+- **ci:** Green lint and docker smoke after grayscale antialiasing
+- **docker:** Stop forwarding host HOME and Windows-path env into the container
+- **ci:** Install example deps in publish and enforce formatting checks
+
+### Miscellaneous
+
+- **ci:** Pin bun to 1.4 across workflows and engines
 ## [0.3.2] - 2026-08-25
 
 ### Fixed

package/README.md

@@ -90,6 +90,10 @@ When the server can resolve a Playwright config (via `--config` or auto-discover
 3. **In the browser:** The UI shows all screenshot tests with side-by-side, swap, slide, and blend diff views.
 4. **Approving changes:** Start the UI server and click "Approve" or "Approve All" to accept a new screenshot as the baseline. Approval uses the same exact Playwright-aware resolver as passed-baseline display, including default layouts, unnamed screenshots, duplicate names, and custom templates when the running server was started with matching resolver options. Those approval-routing options are read from the server startup path, not from reporter options. If the server starts without explicit resolver overrides, approval falls back to the server defaults instead. If Crvy Rprtr cannot determine exactly one target path, it leaves the image unresolved instead of guessing.
 
+## Component Testing
+
+Crvy Rprtr works with [Playwright Component Testing](https://playwright.dev/docs/test-components) (the stories + gallery model, Playwright ≥ 1.62) out of the box — component tests are regular Playwright tests, so live reporting, baseline display, diffs, approval, and Docker mode all work unchanged. See the complete, annotated example in [examples/component-testing](./examples/component-testing).
+
 ## Offline Mode
 
 When the server isn't running during tests, the reporter automatically falls back to offline mode:
@@ -143,8 +147,9 @@ The server still runs on your host; only `playwright test` executes in the conta
 | `--run-mode <mode>`            | `local`, `docker`, or `auto` (default: `auto`)                                                                                                                               |
 | `--docker-image <image>`       | Custom image. With a custom image, the container-side package manager is auto-detected from your lockfile (`npx` / `pnpm exec` / `yarn` / `bunx`); the image must contain it |
 | `--docker-platform <platform>` | `linux/amd64` or `linux/arm64` (default: host architecture)                                                                                                                  |
+| `--font-rendering <mode>`      | Text antialiasing for runs in either mode: `grayscale` (default, deterministic) or `inherit` (see [Text antialiasing](#text-antialiasing))                                   |
 
-Programmatic equivalents: `startServer({ runMode: 'docker', docker: { image, platform, command, extraArgs } })`. `docker.command` overrides the container-side invocation verbatim (e.g. `['pnpm', 'exec', 'playwright']`); `docker.extraArgs` appends raw `docker run` flags.
+Programmatic equivalents: `startServer({ runMode: 'docker', fontRendering: 'grayscale', docker: { image, platform, command, extraArgs } })`. `docker.command` overrides the container-side invocation verbatim (e.g. `['pnpm', 'exec', 'playwright']`); `docker.extraArgs` appends raw `docker run` flags.
 
 ### Windows
 
@@ -161,8 +166,45 @@ Notes:
 - Baselines are **not** architecture-specific for typical DOM/text pages: amd64 and arm64 variants of the same image render bit-identically in practice (verified: 100/103 tests byte-identical between an amd64 CI runner and Apple Silicon). Use the native architecture on every host — do **not** pin `--docker-platform` to force amd64 emulation on Apple Silicon (Rosetta/QEMU is slower and less stable, and buys nothing). Residual risk: canvas 2D / complex SVG / WebGL content can show tiny cross-arch anti-aliasing diffs; handle per-test with `maxDiffPixels`.
 - If your `playwright.config.ts` uses `webServer`, that server now starts inside the container: it must bind `0.0.0.0`, and hosts it references must resolve inside the container.
 - Timezone and locale are pinned (`TZ=UTC`, `LANG=C.UTF-8`, `LC_ALL=C.UTF-8`) so date/number rendering in screenshots is stable; override via `docker.extraArgs` if you need a different locale under test.
+- Text antialiasing is pinned too: a fontconfig drop-in mounted at `/etc/fonts/conf.d/99-crvy-rprtr-grayscale.conf` switches Chromium to grayscale AA, so screenshots no longer depend on whether the image enables subpixel (LCD) rendering. Opt out with `fontRendering: 'inherit'` (see [Text antialiasing](#text-antialiasing)).
 - The "Run & update baselines" button (▶↻) regenerates baselines inside the container, keeping generation and verification in the same image.
 
+### Text antialiasing
+
+Chromium on Linux takes its text AA mode from **fontconfig**, so screenshots change with the environment rather than with the page: a system Chromium passed via `executablePath`, an agent-provided binary or a second image renders the same text with colored subpixel fringes on every glyph. Glyph positions stay identical, so the diff is invisible by eye and fatal to the comparator — colored fringes on ~3% of a text-heavy page, channel deltas up to 100.
+
+crvy-rprtr therefore pins grayscale AA in **both** run modes, with no configuration:
+
+| run mode | mechanism                                                                                                                                                                                  |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| docker   | fontconfig drop-in mounted at `/etc/fonts/conf.d/99-crvy-rprtr-grayscale.conf`                                                                                                             |
+| local    | `FONTCONFIG_FILE` exported to the spawned `playwright test` process (a generated root config that includes the system one, then forces `rgba=none`); every browser it launches inherits it |
+
+Both were verified to produce byte-identical screenshots, so runs can be mixed freely. On macOS and Windows the local-mode override is skipped: fontconfig does not drive text rendering there (macOS has had no subpixel AA since Mojave, Windows uses DirectWrite).
+
+Turn it off with `fontRendering: 'inherit'` — as `startServer({ fontRendering: 'inherit' })` or `crvy-rprtr --font-rendering inherit` — when faithful "what a desktop user sees" text matters more than determinism. `docker: { fontRendering: 'inherit' }` still works and takes precedence in docker mode.
+
+#### Runs that crvy-rprtr does not launch
+
+Plain `npx playwright test` in CI is not covered by the above — it does not go through the launcher. Match it from the Playwright config:
+
+```ts
+import { defineConfig } from '@playwright/test'
+import { deterministicLaunchOptions } from '@crvy/rprtr/rendering'
+
+export default defineConfig({
+  use: { launchOptions: deterministicLaunchOptions() },
+})
+```
+
+The helper writes the same generated fontconfig root config and merges `FONTCONFIG_FILE` into `launchOptions.env`, keeping the inherited environment and the caller's own entries. It applies to every browser (`deterministicLaunchOptions(base, { fontRendering: 'inherit' })` opts out), needs no file committed to the repo, and produces screenshots byte-identical to both run modes. Outside Linux it returns the options unchanged.
+
+`deterministicChromiumLaunchOptions()`, which adds `--disable-lcd-text` instead, remains available for configs that cannot set browser env vars; it is byte-identical for Chromium but Chromium-only, since Firefox rejects unknown command-line flags.
+
+Firefox and WebKit need no equivalent: the Playwright builds never rasterize with subpixel AA — forcing `rgba=rgb` through fontconfig leaves their screenshots byte-identical — so a multi-browser suite is fully covered.
+
+Baselines captured with subpixel AA have to be regenerated once after adopting any of this. Full investigation: [docs/text-antialiasing-determinism.md](docs/text-antialiasing-determinism.md).
+
 ## Programmatic API
 
 ```ts

package/dist/chunk-7JUICMVX.js

@@ -0,0 +1,62 @@
+// src/fontconfig.ts
+import { existsSync, mkdirSync, renameSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+var GRAYSCALE_MATCH = `  <match target="font">
+    <edit name="rgba" mode="assign"><const>none</const></edit>
+  </match>`;
+var HEADER = `<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<!-- Written by crvy-rprtr: pins grayscale text antialiasing for screenshot determinism. -->`;
+var GRAYSCALE_FONTCONFIG_XML = `${HEADER}
+<fontconfig>
+${GRAYSCALE_MATCH}
+</fontconfig>
+`;
+function grayscaleRootFontconfigXml(systemConfigPath) {
+  return `${HEADER}
+<fontconfig>
+  <include ignore_missing="no">${escapeXml(systemConfigPath)}</include>
+${GRAYSCALE_MATCH}
+</fontconfig>
+`;
+}
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+var SYSTEM_FONTCONFIG_PATHS = ["/etc/fonts/fonts.conf", "/usr/local/etc/fonts/fonts.conf"];
+function rootFontconfigPath() {
+  return join(tmpdir(), "crvy-rprtr", "fonts.conf");
+}
+function resolveSystemFontconfig(env = process.env, exists = existsSync) {
+  const ours = rootFontconfigPath();
+  const candidates = [
+    env.FONTCONFIG_FILE,
+    env.FONTCONFIG_PATH === void 0 ? void 0 : join(env.FONTCONFIG_PATH, "fonts.conf"),
+    ...SYSTEM_FONTCONFIG_PATHS
+  ];
+  for (const candidate of candidates) {
+    if (candidate === void 0 || candidate === ours) continue;
+    if (exists(candidate)) return candidate;
+  }
+  return null;
+}
+function ensureRootFontconfig(systemConfigPath) {
+  const path = rootFontconfigPath();
+  mkdirSync(join(tmpdir(), "crvy-rprtr"), { recursive: true });
+  const staging = `${path}.${process.pid}.tmp`;
+  writeFileSync(staging, grayscaleRootFontconfigXml(systemConfigPath), "utf8");
+  renameSync(staging, path);
+  return path;
+}
+function grayscaleFontconfigEnv(baseEnv = process.env, options = {}) {
+  if ((options.platform ?? process.platform) !== "linux") return null;
+  const systemConfig = resolveSystemFontconfig(baseEnv, options.exists);
+  if (systemConfig === null) return null;
+  return { FONTCONFIG_FILE: (options.writeConfig ?? ensureRootFontconfig)(systemConfig) };
+}
+
+export {
+  GRAYSCALE_FONTCONFIG_XML,
+  grayscaleFontconfigEnv
+};

package/dist/{chunk-C5SVPK2O.js → chunk-NXW25MU3.js}

@@ -17,9 +17,13 @@ import {
   resolveBaselineTargets,
   safeParse
 } from "./chunk-7YLKL3SL.js";
+import {
+  GRAYSCALE_FONTCONFIG_XML,
+  grayscaleFontconfigEnv
+} from "./chunk-7JUICMVX.js";
 
 // src/server/app.ts
-import { dirname as dirname4, join as join6 } from "path";
+import { dirname as dirname4, join as join7 } from "path";
 import { fileURLToPath } from "url";
 
 // src/offline-reports.ts
@@ -209,6 +213,47 @@ function mergeOfflineReportsIntoTests(existingTests, offlineReports, options = {
   };
 }
 
+// src/server/docker-env.ts
+var ENV_DENYLIST = /* @__PURE__ */ new Set([
+  "CI",
+  "PLAYWRIGHT_BROWSERS_PATH",
+  "CRVY_RPRTR_SERVER_URL",
+  "CRVY_RPRTR_PORTABLE_ARTIFACTS",
+  "TZ",
+  // The container must use its own home: a forwarded host HOME makes NSS (browser cert
+  // store init) and npm resolve their state under it, and a Windows-style value like
+  // `C:\Users\dev` is a *relative* path on Linux, so those tools would create a literal
+  // `C:\Users\dev/.local/share/pki/nssdb` tree under the container CWD — i.e. inside the
+  // bind-mounted project.
+  "HOME",
+  "NPM_CONFIG_CACHE",
+  "LANG",
+  "LC_ALL",
+  "PLAYWRIGHT_HTML_OPEN",
+  "PATH",
+  // Host paths that do not exist in the container: fontconfig resolves them to nothing and
+  // the browser ends up with no font directories at all (blank text). The container gets its
+  // AA from the mounted drop-in instead.
+  "FONTCONFIG_FILE",
+  "FONTCONFIG_PATH"
+]);
+var WINDOWS_ENV_NOISE = new Set(
+  "SYSTEMROOT COMSPEC WINDIR PATHEXT OS PROGRAMFILES PROGRAMFILES(X86) PROGRAMW6432 PROGRAMDATA ALLUSERSPROFILE PUBLIC APPDATA LOCALAPPDATA TEMP TMP USERPROFILE HOMEDRIVE HOMEPATH USERNAME PSMODULEPATH DRIVERDATA NUMBER_OF_PROCESSORS PROCESSOR_ARCHITECTURE PROCESSOR_LEVEL PROCESSOR_REVISION".split(
+    " "
+  )
+);
+var WINDOWS_PATH_VALUE = /^(?:[A-Za-z]:[\\/]|\\\\)/;
+function collectForwardedEnvNames(env, platform) {
+  const names = [];
+  for (const [key, value] of Object.entries(env)) {
+    const upper = key.toUpperCase();
+    if (ENV_DENYLIST.has(upper) || WINDOWS_ENV_NOISE.has(upper) || value === void 0) continue;
+    if (platform === "win32" && WINDOWS_PATH_VALUE.test(value)) continue;
+    names.push(key);
+  }
+  return names;
+}
+
 // src/server/docker-support.ts
 import { spawn } from "child_process";
 import { readFileSync } from "node:fs";
@@ -372,12 +417,27 @@ function buildTestListEntries(tests, rootDir, cwd, pathStyle = "host") {
   });
 }
 
+// src/server/fontconfig.ts
+import { mkdirSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join as join3 } from "path";
+var CONTAINER_FONTCONFIG_PATH = "/etc/fonts/conf.d/99-crvy-rprtr-grayscale.conf";
+function hostFontconfigPath() {
+  return join3(tmpdir(), "crvy-rprtr", "99-crvy-rprtr-grayscale.conf");
+}
+function ensureGrayscaleFontconfig() {
+  const path = hostFontconfigPath();
+  mkdirSync(join3(tmpdir(), "crvy-rprtr"), { recursive: true });
+  writeFileSync(path, GRAYSCALE_FONTCONFIG_XML, "utf8");
+  return path;
+}
+
 // src/server/run-controller.ts
 import { spawn as spawn2 } from "child_process";
-import { unlinkSync, writeFileSync } from "node:fs";
+import { unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { tmpdir } from "node:os";
-import { join as join3 } from "node:path";
+import { tmpdir as tmpdir2 } from "node:os";
+import { join as join4 } from "node:path";
 
 // src/server/run-launcher.ts
 import { resolveCommand } from "package-manager-detector/commands";
@@ -388,7 +448,7 @@ function resolvePlaywrightLaunch(cwd, playwrightArgs) {
   if (resolved !== null) return { cmd: resolved.command, args: resolved.args };
   return { cmd: "npx", args: ["playwright", ...playwrightArgs] };
 }
-function buildSpawnEnv(port, baseEnv = process.env) {
+function buildSpawnEnv(port, baseEnv = process.env, options = {}) {
   const env = {};
   for (const [key, value] of Object.entries(baseEnv)) {
     if (key === "CI") continue;
@@ -396,6 +456,10 @@ function buildSpawnEnv(port, baseEnv = process.env) {
   }
   env.CRVY_RPRTR_SERVER_URL = `ws://localhost:${port}`;
   env.PLAYWRIGHT_HTML_OPEN = "never";
+  const { fontRendering = "grayscale", ...fontconfigOptions } = options;
+  if (fontRendering !== "inherit") {
+    Object.assign(env, grayscaleFontconfigEnv(baseEnv, fontconfigOptions) ?? {});
+  }
   return env;
 }
 function createLocalLauncher(options) {
@@ -404,7 +468,8 @@ function createLocalLauncher(options) {
     launch({ ctx, playwrightArgs }) {
       const resolve5 = options.resolveLaunch ?? resolvePlaywrightLaunch;
       const { cmd, args } = resolve5(ctx.cwd, playwrightArgs);
-      return { cmd, args, env: buildSpawnEnv(options.port, options.env) };
+      const { port, resolveLaunch: _resolveLaunch, env: baseEnv, ...spawnEnvOptions } = options;
+      return { cmd, args, env: buildSpawnEnv(port, baseEnv, spawnEnvOptions) };
     }
   };
 }
@@ -432,8 +497,8 @@ function gteMinor(version, major, minor) {
   return min >= minor;
 }
 var defaultWriteTempFile = (content) => {
-  const path = join3(tmpdir(), `crvy-rprtr-test-list-${process.pid}-${Date.now()}.txt`);
-  writeFileSync(path, content, "utf8");
+  const path = join4(tmpdir2(), `crvy-rprtr-test-list-${process.pid}-${Date.now()}.txt`);
+  writeFileSync2(path, content, "utf8");
   return path;
 };
 function defaultDeleteTempFile(path) {
@@ -444,7 +509,7 @@ function defaultDeleteTempFile(path) {
 }
 function resolveReporterDefault(cwd) {
   try {
-    return createRequire2(join3(cwd, "package.json")).resolve("@crvy/rprtr");
+    return createRequire2(join4(cwd, "package.json")).resolve("@crvy/rprtr");
   } catch {
   }
   try {
@@ -610,22 +675,6 @@ function createRealTimers() {
 // src/server/docker-launcher.ts
 var DOCKER_WORK_DIR = "/work";
 var DOCKER_HOST_GATEWAY = "host.docker.internal";
-var ENV_DENYLIST = /* @__PURE__ */ new Set([
-  "CI",
-  "PLAYWRIGHT_BROWSERS_PATH",
-  "CRVY_RPRTR_SERVER_URL",
-  "CRVY_RPRTR_PORTABLE_ARTIFACTS",
-  "TZ",
-  "LANG",
-  "LC_ALL",
-  "PLAYWRIGHT_HTML_OPEN",
-  "PATH"
-]);
-var WINDOWS_ENV_NOISE = new Set(
-  "SYSTEMROOT COMSPEC WINDIR PATHEXT OS PROGRAMFILES PROGRAMFILES(X86) PROGRAMW6432 PROGRAMDATA ALLUSERSPROFILE PUBLIC APPDATA LOCALAPPDATA TEMP TMP USERPROFILE HOMEDRIVE HOMEPATH USERNAME PSMODULEPATH DRIVERDATA NUMBER_OF_PROCESSORS PROCESSOR_ARCHITECTURE PROCESSOR_IDENTIFIER PROCESSOR_LEVEL PROCESSOR_REVISION".split(
-    " "
-  )
-);
 var DockerUnavailableError = class extends Error {
   constructor() {
     super("Docker daemon is not available");
@@ -691,9 +740,10 @@ function buildDockerRunArgs(ctx, playwrightArgs, deps) {
   args.push("-e", `CRVY_RPRTR_SERVER_URL=ws://${DOCKER_HOST_GATEWAY}:${deps.port}`);
   args.push("-e", "CRVY_RPRTR_PORTABLE_ARTIFACTS=1", "-e", "TZ=UTC", "-e", "LANG=C.UTF-8", "-e", "LC_ALL=C.UTF-8");
   args.push("-e", "PLAYWRIGHT_HTML_OPEN=never");
-  for (const [key, value] of Object.entries(deps.env)) {
-    const upper = key.toUpperCase();
-    if (ENV_DENYLIST.has(upper) || WINDOWS_ENV_NOISE.has(upper) || value === void 0) continue;
+  if (deps.docker?.fontRendering !== "inherit") {
+    args.push("-v", `${ensureGrayscaleFontconfig()}:${CONTAINER_FONTCONFIG_PATH}:ro`);
+  }
+  for (const key of collectForwardedEnvNames(deps.env, deps.platform)) {
     args.push("-e", key);
   }
   if (deps.docker?.extraArgs !== void 0) args.push(...deps.docker.extraArgs);
@@ -756,7 +806,8 @@ function buildLauncher(state, deps) {
         env: deps.baseEnv,
         image,
         command: state.command,
-        warn: deps.warn
+        warn: deps.warn,
+        platform: deps.platform
       });
       return { cmd: "docker", args, env: stripCi(deps.baseEnv) };
     },
@@ -1078,7 +1129,11 @@ async function resolveRunBackend(options) {
       console.warn(`[crvy-rprtr] ${message}`);
     }
   });
-  const launcher = resolvedRunMode === "docker" ? createDockerLauncher({ port: options.port, docker: options.docker, exec: dockerExec }) : createLocalLauncher({ port: options.port });
+  const launcher = resolvedRunMode === "docker" ? createDockerLauncher({
+    port: options.port,
+    docker: { fontRendering: options.fontRendering, ...options.docker },
+    exec: dockerExec
+  }) : createLocalLauncher({ port: options.port, fontRendering: options.fontRendering });
   return {
     launcher,
     routesContextOptions: {
@@ -1089,7 +1144,7 @@ async function resolveRunBackend(options) {
 }
 
 // src/server/playwright-config.ts
-import { join as join4, resolve as resolve4 } from "path";
+import { join as join5, resolve as resolve4 } from "path";
 var CONFIG_FILES = [
   "playwright.config.ts",
   "playwright.config.mts",
@@ -1101,7 +1156,7 @@ var CONFIG_FILES = [
 async function resolvePlaywrightConfig(cwd) {
   const matches = await Promise.all(
     CONFIG_FILES.map(async (file) => {
-      const candidate = join4(cwd, file);
+      const candidate = join5(cwd, file);
       return await fileExists(candidate) ? candidate : null;
     })
   );
@@ -1191,7 +1246,7 @@ function createRoutesContext(reportData, staticDir, saveReport, options) {
 }
 
 // src/server/routes.ts
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 
 // src/server/run-routes.ts
 function handleRunRoutes(pathname, method, runController, req) {
@@ -1230,7 +1285,7 @@ function handleApiStop(runController) {
 
 // src/server/routes.ts
 async function handleRoot(ctx) {
-  const html = await respondWithFile(join5(ctx.staticDir, "index.html"), "text/html");
+  const html = await respondWithFile(join6(ctx.staticDir, "index.html"), "text/html");
   return html ?? new Response("Not Found", { status: 404 });
 }
 async function handleAppCss() {
@@ -1254,7 +1309,7 @@ function handleApiReport(ctx) {
 var APPROVAL_TARGET_ERROR = "Could not resolve approval target";
 function actualPathFromUrl(ctx, actualUrl) {
   if (actualUrl.startsWith("/screenshots/")) {
-    return join5(ctx.reportData.screenshotDir, actualUrl.slice("/screenshots/".length));
+    return join6(ctx.reportData.screenshotDir, actualUrl.slice("/screenshots/".length));
   }
   if (actualUrl.startsWith("/file/")) {
     return decodeURIComponent(actualUrl.slice("/file/".length));
@@ -1376,7 +1431,7 @@ async function handleScreenshots(ctx, req) {
 }
 async function handleDist(ctx, req) {
   const path = new URL(req.url).pathname.slice("/dist/".length);
-  const filePath = join5(ctx.staticDir, path);
+  const filePath = join6(ctx.staticDir, path);
   const contentType = filePath.endsWith(".css") ? "text/css" : filePath.endsWith(".js") ? "application/javascript" : filePath.endsWith(".svelte") ? "text/plain" : "application/octet-stream";
   const file = await respondWithFile(filePath, contentType);
   return file ?? new Response("Not Found", { status: 404 });
@@ -1565,16 +1620,16 @@ async function resolveStaticDir(staticDir) {
   const currentDir = dirname4(fileURLToPath(import.meta.url));
   const candidates = staticDir === void 0 ? [
     currentDir,
-    join6(currentDir, "dist"),
-    join6(currentDir, "..", "dist"),
-    join6(currentDir, "..", "..", "dist"),
-    join6(currentDir, ".."),
-    join6(currentDir, "..", "..")
-  ] : [staticDir, join6(staticDir, "dist")];
+    join7(currentDir, "dist"),
+    join7(currentDir, "..", "dist"),
+    join7(currentDir, "..", "..", "dist"),
+    join7(currentDir, ".."),
+    join7(currentDir, "..", "..")
+  ] : [staticDir, join7(staticDir, "dist")];
   const resolvedCandidates = await Promise.all(
     candidates.map(async (candidate) => ({
       candidate,
-      exists: await fileExists(join6(candidate, "index.html"))
+      exists: await fileExists(join7(candidate, "index.html"))
     }))
   );
   const resolved = resolvedCandidates.find(({ exists }) => exists);
@@ -1585,7 +1640,7 @@ async function resolveStaticDir(staticDir) {
 }
 async function resolveReportPath(reportPath) {
   if (await isDirectory(reportPath)) {
-    return { reportFile: join6(reportPath, "report.json"), offlineReportDir: reportPath };
+    return { reportFile: join7(reportPath, "report.json"), offlineReportDir: reportPath };
   }
   return { reportFile: reportPath, offlineReportDir: dirname4(reportPath) };
 }
@@ -1602,6 +1657,7 @@ async function setupRoutesContext(options, reportData, staticDir, saveReport, po
   const { launcher, routesContextOptions } = await resolveRunBackend({
     runMode: options.runMode,
     docker: options.docker,
+    fontRendering: options.fontRendering,
     port
   });
   const routesContext = createRoutesContext(reportData, staticDir, saveReport, {

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import type { FontRendering } from './rendering.ts';
 import { type ServerOptions } from './server.ts';
 import type { DockerOptions } from './server/docker-launcher.ts';
 import type { RunMode } from './server/run-mode.ts';
@@ -9,8 +10,9 @@ interface ResolvedCliOptions extends ServerOptions {
     outputDir: string;
     runMode?: RunMode;
     docker?: DockerOptions;
+    fontRendering?: FontRendering;
 }
-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 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  --font-rendering <mode>       Text antialiasing for runs: grayscale (default, deterministic) or inherit (the environment's own rendering)\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;

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;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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,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;IACtB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,eAAO,MAAM,SAAS,izCAoBrB,CAAA;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjD;AA0BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CA6CpE"}

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
   startServer
-} from "./chunk-C5SVPK2O.js";
+} from "./chunk-NXW25MU3.js";
 import "./chunk-7YLKL3SL.js";
+import "./chunk-7JUICMVX.js";
 
 // src/cli.ts
 import { join } from "path";
@@ -50,6 +51,7 @@ Options:
   --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)
+  --font-rendering <mode>       Text antialiasing for runs: grayscale (default, deterministic) or inherit (the environment's own rendering)
   -h, --help                    Show this help message
 `;
 function printHelp() {
@@ -58,6 +60,27 @@ function printHelp() {
 function wantsHelp(args) {
   return args.includes("--help") || args.includes("-h");
 }
+function parseRunMode(value) {
+  if (value === void 0) return void 0;
+  if (value !== "local" && value !== "docker" && value !== "auto") {
+    throw new TypeError(`Invalid --run-mode: ${value} (expected local, docker, or auto)`);
+  }
+  return value;
+}
+function parseDockerPlatform(value) {
+  if (value === void 0) return void 0;
+  if (value !== "linux/amd64" && value !== "linux/arm64") {
+    throw new TypeError(`Invalid --docker-platform: ${value} (expected linux/amd64 or linux/arm64)`);
+  }
+  return value;
+}
+function parseFontRendering(value) {
+  if (value === void 0) return void 0;
+  if (value !== "grayscale" && value !== "inherit") {
+    throw new TypeError(`Invalid --font-rendering: ${value} (expected grayscale or inherit)`);
+  }
+  return value;
+}
 function resolveCliOptions(args) {
   const { values, positionals } = parseArgs({
     args,
@@ -70,7 +93,8 @@ function resolveCliOptions(args) {
       config: { type: "string", short: "c" },
       "run-mode": { type: "string" },
       "docker-image": { type: "string" },
-      "docker-platform": { type: "string" }
+      "docker-platform": { type: "string" },
+      "font-rendering": { type: "string" }
     }
   });
   if (positionals.length > 1) {
@@ -79,14 +103,9 @@ 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 runMode = parseRunMode(values["run-mode"]);
+  const dockerPlatform = parseDockerPlatform(values["docker-platform"]);
+  const fontRendering = parseFontRendering(values["font-rendering"]);
   const docker = {};
   if (values["docker-image"] !== void 0) docker.image = values["docker-image"];
   if (dockerPlatform !== void 0) docker.platform = dockerPlatform;
@@ -98,6 +117,7 @@ function resolveCliOptions(args) {
     outputDir: values["output-dir"] ?? DEFAULT_OUTPUT_DIR,
     playwrightConfig: values.config,
     ...runMode === void 0 ? {} : { runMode },
+    ...fontRendering === void 0 ? {} : { fontRendering },
     ...hasDockerOptions ? { docker } : {}
   };
 }

package/dist/fontconfig.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Drop-in form, for `conf.d`: the rule alone, with the surrounding config supplied by the
+ * distro. Docker run mode mounts this at {@link CONTAINER_FONTCONFIG_PATH}.
+ */
+export declare const GRAYSCALE_FONTCONFIG_XML = "<?xml version=\"1.0\"?>\n<!DOCTYPE fontconfig SYSTEM \"urn:fontconfig:fonts.dtd\">\n<!-- Written by crvy-rprtr: pins grayscale text antialiasing for screenshot determinism. -->\n<fontconfig>\n  <match target=\"font\">\n    <edit name=\"rgba\" mode=\"assign\"><const>none</const></edit>\n  </match>\n</fontconfig>\n";
+/**
+ * Root-config form, for `FONTCONFIG_FILE`: the same rule, plus an include of the system
+ * config it replaces. The include is not optional — `FONTCONFIG_FILE` replaces the root
+ * config outright, and a root config with no font directories leaves the browser with no
+ * fonts at all (verified: a page of text rendered completely blank, total ink 0).
+ */
+export declare function grayscaleRootFontconfigXml(systemConfigPath: string): string;
+/** Generated root config; stable path so repeated runs reuse one file. */
+export declare function rootFontconfigPath(): string;
+/**
+ * The root config our generated one must include: the caller's own `FONTCONFIG_FILE` /
+ * `FONTCONFIG_PATH` when they set one (their rules survive, ours are appended after), else the
+ * distro default. Returns null when nothing exists to include — the caller must then leave the
+ * environment alone rather than break font lookup.
+ */
+export declare function resolveSystemFontconfig(env?: Record<string, string | undefined>, exists?: (path: string) => boolean): string | null;
+/** Writes the generated root config and returns its path. Rename keeps concurrent Playwright workers from reading a half-written file. */
+export declare function ensureRootFontconfig(systemConfigPath: string): string;
+export interface GrayscaleFontconfigEnvOptions {
+    /** Injectable seams for tests; default to the real platform and filesystem. */
+    platform?: NodeJS.Platform;
+    exists?: (path: string) => boolean;
+    writeConfig?: (systemConfigPath: string) => string;
+}
+/**
+ * The `FONTCONFIG_FILE` override that pins grayscale AA for **every** browser that reads
+ * fontconfig, or null when it does not apply.
+ *
+ * Why the environment and not `--disable-lcd-text`: browser args reach Chromium only, and
+ * Firefox rejects unknown flags. The env var reaches whatever binary Playwright launches,
+ * including a system Chromium passed via `executablePath`. Verified byte-identical to
+ * `--disable-lcd-text` in `mcr.microsoft.com/playwright:v1.59.0-noble`.
+ *
+ * Null on non-Linux (macOS has had no subpixel AA since Mojave, Windows uses DirectWrite) and
+ * when no system config exists to include — see {@link grayscaleRootFontconfigXml}.
+ */
+export declare function grayscaleFontconfigEnv(baseEnv?: Record<string, string | undefined>, options?: GrayscaleFontconfigEnvOptions): Record<string, string> | null;
+//# sourceMappingURL=fontconfig.d.ts.map

package/dist/fontconfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontconfig.d.ts","sourceRoot":"","sources":["../src/fontconfig.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,eAAO,MAAM,wBAAwB,+TAIpC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAO3E;AASD,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,MAAM,GAAG,IAAI,CAcf;AAED,0IAA0I;AAC1I,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAOrE;AAED,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAClC,WAAW,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,MAAM,CAAA;CACnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACzD,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAK/B"}

package/dist/index.css

@@ -847,6 +847,10 @@
   .outline-accent {
     outline-color: var(--color-accent);
   }
+  .blur {
+    --tw-blur: blur(8px);
+    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,);
+  }
   .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,);