feat(plugin-axe): add plugin configuration validation

Author: hanna-skryl

packages/plugin-axe/src/lib/config.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import { pluginScoreTargetsSchema } from '@code-pushup/models';
+import { AXE_DEFAULT_PRESET, AXE_PRESETS } from './constants';
+
+export const axePluginOptionsSchema = z
+  .object({
+    preset: z.enum(AXE_PRESETS).default(AXE_DEFAULT_PRESET).meta({
+      description:
+        'Accessibility ruleset preset (default: wcag21aa for WCAG 2.1 Level AA compliance)',
+    }),
+    scoreTargets: pluginScoreTargetsSchema.optional(),
+  })
+  .meta({
+    title: 'AxePluginOptions',
+    description: 'Configuration options for the Axe plugin',
+  });
+
+export type AxePluginOptions = z.input<typeof axePluginOptionsSchema>;

packages/plugin-axe/src/lib/config.unit.test.ts

@@ -0,0 +1,58 @@
+import { describe, expect, it } from 'vitest';
+import { axePluginOptionsSchema } from './config.js';
+
+describe('axePluginOptionsSchema', () => {
+  it('should accept empty options object with default preset', () => {
+    expect(axePluginOptionsSchema.parse({}).preset).toBe('wcag21aa');
+  });
+
+  it('should accept wcag21aa preset', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({ preset: 'wcag21aa' }),
+    ).not.toThrow();
+  });
+
+  it('should accept wcag22aa preset', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({ preset: 'wcag22aa' }),
+    ).not.toThrow();
+  });
+
+  it('should accept best-practice preset', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({ preset: 'best-practice' }),
+    ).not.toThrow();
+  });
+
+  it('should accept all preset', () => {
+    expect(() => axePluginOptionsSchema.parse({ preset: 'all' })).not.toThrow();
+  });
+
+  it('should accept number scoreTargets', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({ scoreTargets: 0.99 }),
+    ).not.toThrow();
+  });
+
+  it('should accept object scoreTargets', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({
+        scoreTargets: { 'color-contrast': 0.99 },
+      }),
+    ).not.toThrow();
+  });
+
+  it('should throw for invalid preset', () => {
+    expect(() => axePluginOptionsSchema.parse({ preset: 'wcag3aa' })).toThrow();
+  });
+
+  it('should throw for invalid scoreTargets value', () => {
+    expect(() => axePluginOptionsSchema.parse({ scoreTargets: 1.5 })).toThrow();
+  });
+
+  it('should throw for negative scoreTargets', () => {
+    expect(() =>
+      axePluginOptionsSchema.parse({ scoreTargets: -0.1 }),
+    ).toThrow();
+  });
+});