pn-new-crm/tests/e2e/smoke/20-accessibility.spec.ts

/**
 * Accessibility smoke test - runs axe-core against the main authenticated
 * pages and fails CI if a new WCAG 2.1 A/AA serious-or-critical violation
 * shows up. Existing violations on third-party / shadcn primitives are
 * pruned via the disableRules list, kept small and audited.
 *
 * Add new pages here as they're built; each entry is < 200ms in a smoke run.
 */

import { expect, test } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

import { login } from './helpers';

const PAGES = [
  { path: '/port-nimara', label: 'Dashboard' },
  { path: '/port-nimara/clients', label: 'Clients list' },
  { path: '/port-nimara/yachts', label: 'Yachts list' },
  { path: '/port-nimara/interests', label: 'Interests list' },
  { path: '/port-nimara/berths', label: 'Berths list' },
  { path: '/port-nimara/admin/branding', label: 'Admin / Branding' },
];

// Known third-party + shadcn primitives whose violations we accept for now.
// Tightened as the design system addresses each one.
const DISABLED_RULES = [
  // Radix's hidden focus traps occasionally produce "tabindex >= 0 should
  // not be on a non-interactive element" - known shadcn dialog/sheet shape.
  'tabindex',
  // Color-contrast on muted body text - design pass pending.
  'color-contrast',
];

test.describe('accessibility - smoke', () => {
  test.beforeEach(async ({ page }) => {
    await login(page, 'super_admin');
  });

  for (const { path, label } of PAGES) {
    test(`${label} has no critical/serious WCAG violations`, async ({ page }) => {
      await page.goto(path);
      await page.waitForLoadState('networkidle');
      const results = await new AxeBuilder({ page })
        .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'])
        .disableRules(DISABLED_RULES)
        .analyze();
      const blocking = results.violations.filter(
        (v) => v.impact === 'critical' || v.impact === 'serious',
      );
      if (blocking.length > 0) {
        const summary = blocking
          .map((v) => `  - [${v.impact}] ${v.id}: ${v.help} (${v.nodes.length} occurrences)`)
          .join('\n');
        throw new Error(`Accessibility violations on ${path}:\n${summary}\n\nSee ${results.url}`);
      }
      expect(blocking).toEqual([]);
    });
  }
});