playwright.config.js

import { defineConfig, devices } from '@playwright/test';
import dotenv from 'dotenv';

// Load .env file for local development (GITHUB_AUTH_STATE, API_CONTRACT_TEST_PAT)
dotenv.config({ quiet: true });

// Prevent list reporter from truncating test names
process.stdout.columns = 200;

export default defineConfig({
  globalSetup: './tests/global-setup.js',
  testDir: './tests/chrome',
  snapshotPathTemplate: '{snapshotDir}/{arg}{ext}',
  snapshotDir: './tests/screenshots/chrome',
  fullyParallel: false,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: 1,
  outputDir: './tests/runs/chrome/results',
  reporter: [['list'], ['html', { open: 'never', outputFolder: './tests/runs/chrome/report' }]],
  use: {
    trace: 'on-first-retry',
  },
  expect: {
    toHaveScreenshot: {
      // 2% threshold: tolerates system font differences across platforms
      // (macOS: San Francisco, Linux: Noto Sans/DejaVu, Windows: Segoe UI)
      maxDiffPixelRatio: 0.02,
      // Per-pixel threshold: allow slight color variance from anti-aliasing
      threshold: 0.2,
    },
  },
  projects: [
    {
      name: 'chromium',
      use: { ...devices['Desktop Chrome'] },
    },
  ],
});