Add vitest-axe documentation

docs/.vitepress/config.js

@@ -101,6 +101,10 @@ export default defineConfig({
                         text: 'postcss-url-rebase',
                         link: '/guide/postcss-url-rebase',
                     },
+                    {
+                        text: 'vitest-axe',
+                        link: '/guide/vitest-axe',
+                    },
                     // {
                     //     text: 'Write a plugin',
                     //     link: '/guide/write-a-plugin',

docs/guide/vitest-axe.md

@@ -0,0 +1,58 @@
+# Vitest Axe matchers
+
+Axe violations matchers for Vitest.
+
+## Install
+
+::: code-group
+
+```sh[npm]
+npm i -D axe-core @chialab/vitest-axe
+```
+
+```sh[yarn]
+yarn add -D axe-core @chialab/vitest-axe
+```
+
+```sh[pnpm]
+pnpm add -D axe-core @chialab/vitest-axe
+```
+
+:::
+
+## Usage
+
+Use a Vitest setup file to add the matchers to the test runner.
+
+::: code-group
+
+```ts[vitest.config.ts]
+export default {
+    test: {
+        setupFiles: ['./test/setup.ts'],
+    },
+}
+```
+
+```ts[test/setup.ts]
+import matchers from '@chialab/vitest-axe';
+import { expect } from 'vitest';
+
+expect.extend(matchers);
+```
+
+:::
+
+## Example
+
+```ts
+import { run as axe } from 'axe-core';
+import { describe, expect, test } from 'vitest';
+
+describe('button', () => {
+    test('accessibility', async () => {
+        const button = document.createElement('button');
+        expect(await axe(button)).toHaveNoViolations();
+    });
+});
+```

packages/vitest-axe/README.md

@@ -18,11 +18,9 @@ npm i @chialab/vitest-axe -D
 yarn add @chialab/vitest-axe -D
 ```
 
-## Usage
+## Documentation
 
-```js
-import '@chialab/vitest-axe';
-```
+Read the documentation at [chialab.github.io/rna](https://chialab.github.io/rna/guide/vitest-axe).
 
 ---