Merge branch 'main' into mask-properties

.changeset/twenty-boxes-complain.md

@@ -0,0 +1,8 @@
+---
+"@siteimprove/alfa-rules": minor
+"@siteimprove/alfa-aria": minor
+---
+
+**Added:** Expose `allowedAttributes` on ARIA Element type.
+
+This function takes into account "implicit ARIA semantics" and "ARIA role allowances" from [ARIA in HTML](https://w3c.github.io/html-aria/#docconformance). The logic is moved from rule R18 implementation.

.yarnrc.yml

@@ -4,4 +4,4 @@ npmScopes:
   siteimprove:
     npmRegistryServer: "https://npm.pkg.github.com"
 
-yarnPath: .yarn/releases/yarn-4.5.2.cjs
+yarnPath: .yarn/releases/yarn-4.5.3.cjs

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Alfa changelog
 
+## [0.95.0](../../compare/v0.94.1...v0.95.0) (2024-11-28)
+
+### Breaking
+
+- [@siteimprove/alfa-test-deprecated](packages/alfa-test-deprecated/CHANGELOG.md#0950), [@siteimprove/alfa-test](packages/alfa-test/CHANGELOG.md#0950): The `alfa-test` package is now called `alfa-test-deprecated` and a new `alfa-test` package was added. ([#1692](https://github.com/Siteimprove/alfa/pull/1692))
+
 ## [0.94.1](../../compare/v0.94.0...v0.94.1) (2024-11-22)
 
 ### Fixed

config/validate-structure.json

@@ -10,7 +10,8 @@
     "noExternalDeps": true,
     "allowedExternalDeps": {
       "@siteimprove/alfa-compatibility": ["browserslist"],
-      "@siteimprove/alfa-test": ["chalk"],
+      "@siteimprove/alfa-test": ["vitest"],
+      "@siteimprove/alfa-test-deprecated": ["chalk"],
       "@siteimprove/alfa-toolchain": [
         "@changesets/assemble-release-plan",
         "@changesets/config",

config/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["test/**/*.spec.ts?(x)"],
+  },
+});

config/vitest.workspace.ts

@@ -0,0 +1 @@
+export default ["packages/alfa-*", "!packages/alfa-test-deprecated"];

docs/api/alfa-rules.alfaversion.md

@@ -8,5 +8,5 @@
 **Signature:**
 
 ```typescript
-alfaVersion = "0.94.1"
+alfaVersion = "0.95.0"
 ```

docs/api/alfa-test-deprecated.assertions.deepequal.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [deepEqual](./alfa-test-deprecated.assertions.deepequal.md)
+
+## Assertions.deepEqual() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_deepequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_deepequal_actual_expected_message)
+
+**Signature:**
+
+```typescript
+deepEqual<T>(actual: T, expected: T, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  actual | T |  |
+|  expected | T |  |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.assertions.equal.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [equal](./alfa-test-deprecated.assertions.equal.md)
+
+## Assertions.equal() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_equal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_equal_actual_expected_message)
+
+**Signature:**
+
+```typescript
+equal<T>(actual: T, expected: T, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  actual | T |  |
+|  expected | T |  |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.assertions.fail.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [fail](./alfa-test-deprecated.assertions.fail.md)
+
+## Assertions.fail() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_fail\_message](https://nodejs.org/api/assert.html#assert_assert_fail_message)
+
+**Signature:**
+
+```typescript
+fail(message?: string): never;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+never
+

docs/api/alfa-test-deprecated.assertions.md

@@ -0,0 +1,25 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md)
+
+## Assertions interface
+
+
+**Signature:**
+
+```typescript
+export interface Assertions 
+```
+
+## Methods
+
+|  Method | Description |
+|  --- | --- |
+|  [deepEqual(actual, expected, message)](./alfa-test-deprecated.assertions.deepequal.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_deepequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_deepequal_actual_expected_message) |
+|  [equal(actual, expected, message)](./alfa-test-deprecated.assertions.equal.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_equal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_equal_actual_expected_message) |
+|  [fail(message)](./alfa-test-deprecated.assertions.fail.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_fail\_message](https://nodejs.org/api/assert.html#assert_assert_fail_message) |
+|  [notDeepEqual(actual, expected, message)](./alfa-test-deprecated.assertions.notdeepequal.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_notdeepequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_notdeepequal_actual_expected_message) |
+|  [notEqual(actual, expected, message)](./alfa-test-deprecated.assertions.notequal.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_notequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_notequal_actual_expected_message) |
+|  [rejects(block, error, message)](./alfa-test-deprecated.assertions.rejects.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_rejects\_block\_error\_message](https://nodejs.org/api/assert.html#assert_assert_rejects_block_error_message) |
+|  [throws(block, error, message)](./alfa-test-deprecated.assertions.throws.md) | [https://nodejs.org/api/assert.html\#assert\_assert\_throws\_block\_error\_message](https://nodejs.org/api/assert.html#assert_assert_throws_block_error_message) |
+

docs/api/alfa-test-deprecated.assertions.notdeepequal.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [notDeepEqual](./alfa-test-deprecated.assertions.notdeepequal.md)
+
+## Assertions.notDeepEqual() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_notdeepequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_notdeepequal_actual_expected_message)
+
+**Signature:**
+
+```typescript
+notDeepEqual<T>(actual: T, expected: T, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  actual | T |  |
+|  expected | T |  |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.assertions.notequal.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [notEqual](./alfa-test-deprecated.assertions.notequal.md)
+
+## Assertions.notEqual() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_notequal\_actual\_expected\_message](https://nodejs.org/api/assert.html#assert_assert_notequal_actual_expected_message)
+
+**Signature:**
+
+```typescript
+notEqual<T>(actual: T, expected: T, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  actual | T |  |
+|  expected | T |  |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.assertions.rejects.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [rejects](./alfa-test-deprecated.assertions.rejects.md)
+
+## Assertions.rejects() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_rejects\_block\_error\_message](https://nodejs.org/api/assert.html#assert_assert_rejects_block_error_message)
+
+**Signature:**
+
+```typescript
+rejects<T>(block: Function | Promise<T>, error?: RegExp | Function | Object | Error, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  block | Function \| Promise&lt;T&gt; |  |
+|  error | RegExp \| Function \| Object \| Error | _(Optional)_ |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.assertions.throws.md

@@ -0,0 +1,26 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Assertions](./alfa-test-deprecated.assertions.md) &gt; [throws](./alfa-test-deprecated.assertions.throws.md)
+
+## Assertions.throws() method
+
+[https://nodejs.org/api/assert.html\#assert\_assert\_throws\_block\_error\_message](https://nodejs.org/api/assert.html#assert_assert_throws_block_error_message)
+
+**Signature:**
+
+```typescript
+throws(block: Function, error?: RegExp | Function | Object | Error, message?: string): void;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  block | Function |  |
+|  error | RegExp \| Function \| Object \| Error | _(Optional)_ |
+|  message | string | _(Optional)_ |
+
+**Returns:**
+
+void
+

docs/api/alfa-test-deprecated.controller.iterations.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Controller](./alfa-test-deprecated.controller.md) &gt; [iterations](./alfa-test-deprecated.controller.iterations.md)
+
+## Controller.iterations property
+
+**Signature:**
+
+```typescript
+iterations: number;
+```

docs/api/alfa-test-deprecated.controller.md

@@ -0,0 +1,21 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Controller](./alfa-test-deprecated.controller.md)
+
+## Controller interface
+
+
+**Signature:**
+
+```typescript
+export interface Controller<T = number> 
+```
+
+## Properties
+
+|  Property | Modifiers | Type | Description |
+|  --- | --- | --- | --- |
+|  [iterations](./alfa-test-deprecated.controller.iterations.md) |  | number |  |
+|  [seed?](./alfa-test-deprecated.controller.seed.md) |  | number | _(Optional)_ |
+|  [wrapper](./alfa-test-deprecated.controller.wrapper.md) |  | (rng: [RNG](./alfa-test-deprecated.rng.md)<!-- -->&lt;number&gt;, iteration: number) =&gt; [RNG](./alfa-test-deprecated.rng.md)<!-- -->&lt;T&gt; |  |
+

docs/api/alfa-test-deprecated.controller.seed.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Controller](./alfa-test-deprecated.controller.md) &gt; [seed](./alfa-test-deprecated.controller.seed.md)
+
+## Controller.seed property
+
+**Signature:**
+
+```typescript
+seed?: number;
+```

docs/api/alfa-test-deprecated.controller.wrapper.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [Controller](./alfa-test-deprecated.controller.md) &gt; [wrapper](./alfa-test-deprecated.controller.wrapper.md)
+
+## Controller.wrapper property
+
+**Signature:**
+
+```typescript
+wrapper: (rng: RNG<number>, iteration: number) => RNG<T>;
+```

docs/api/alfa-test-deprecated.md

@@ -0,0 +1,25 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md)
+
+## alfa-test-deprecated package
+
+## Functions
+
+|  Function | Description |
+|  --- | --- |
+|  [test(name, assertion, controller)](./alfa-test-deprecated.test.md) |  |
+
+## Interfaces
+
+|  Interface | Description |
+|  --- | --- |
+|  [Assertions](./alfa-test-deprecated.assertions.md) |  |
+|  [Controller](./alfa-test-deprecated.controller.md) |  |
+
+## Type Aliases
+
+|  Type Alias | Description |
+|  --- | --- |
+|  [RNG](./alfa-test-deprecated.rng.md) |  |
+

docs/api/alfa-test-deprecated.rng.md

@@ -0,0 +1,12 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [RNG](./alfa-test-deprecated.rng.md)
+
+## RNG type
+
+
+**Signature:**
+
+```typescript
+export type RNG<T = number> = () => T;
+```

docs/api/alfa-test-deprecated.test.md

@@ -0,0 +1,25 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) &gt; [test](./alfa-test-deprecated.test.md)
+
+## test() function
+
+
+**Signature:**
+
+```typescript
+export declare function test<T = number>(name: string, assertion: (assert: Assertions, rng: RNG<T>, seed: number) => void | Promise<void>, controller?: Partial<Controller<T>>): Promise<void>;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  name | string |  |
+|  assertion | (assert: [Assertions](./alfa-test-deprecated.assertions.md)<!-- -->, rng: [RNG](./alfa-test-deprecated.rng.md)<!-- -->&lt;T&gt;, seed: number) =&gt; void \| Promise&lt;void&gt; |  |
+|  controller | Partial&lt;[Controller](./alfa-test-deprecated.controller.md)<!-- -->&lt;T&gt;&gt; | _(Optional)_ |
+
+**Returns:**
+
+Promise&lt;void&gt;
+

docs/api/index.md

@@ -72,6 +72,7 @@
 |  [@siteimprove/alfa-string](./alfa-string.md) |  |
 |  [@siteimprove/alfa-style](./alfa-style.md) |  |
 |  [@siteimprove/alfa-table](./alfa-table.md) |  |
+|  [@siteimprove/alfa-test-deprecated](./alfa-test-deprecated.md) |  |
 |  [@siteimprove/alfa-thenable](./alfa-thenable.md) |  |
 |  [@siteimprove/alfa-thunk](./alfa-thunk.md) |  |
 |  [@siteimprove/alfa-time](./alfa-time.md) |  |