Merge branch 'main' into api-extractor

* main: (43 commits)
  Update lockfile
  Update `normalize-url`
  Update README.md
  Add `archive` option in `Scraper#scrape()` (#840)
  Pass roles as part of diagnostics in SIA-R55 and SIA-R56 (#838)
  Update Node.js versions for workflows
  Fix listing of contrast ratios
  SIA R55: clean up unused imports (#836)
  Implement SIA-R55 (#835)
  Consider element with `height` or `width` of 0 as invisible unless the text overflows (#827)
  Formatting
  v0.19.0
  Update changelog
  Develop branch (#771)
  v0.18.0
  Update changelog
  Add missing annotations
  Deduplicate dependencies
  Update dependencies
  Bump browserslist from 4.16.3 to 4.16.6 (#814)
  ...

.github/workflows/integrate.yml

@@ -12,14 +12,16 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest]
-        node: [12, 14]
+        node: [14, 16]
     runs-on: ${{ matrix.os }}
+    env:
+      NODE_OPTIONS: "--max-old-space-size=4096"
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v2.3.4
       - uses: actions/[email protected]
         with:
           node-version: ${{ matrix.node }}
-      - uses: actions/[email protected].4
+      - uses: actions/[email protected].6
         with:
           path: .yarn/cache
           key: yarn-${{ hashFiles('yarn.lock') }}

.github/workflows/release.yml

@@ -8,11 +8,11 @@ jobs:
     name: Publish
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v2.3.4
       - uses: actions/[email protected]
         with:
-          node-version: 14
-      - uses: actions/[email protected].4
+          node-version: 16
+      - uses: actions/[email protected].6
         with:
           path: .yarn/cache
           key: yarn-${{ hashFiles('yarn.lock') }}
@@ -28,7 +28,7 @@ jobs:
           --no-private
           --topological
           npm publish --tolerate-republish
-      - uses: actions/create-release@v1
+      - uses: actions/create-release@v1.1.4
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:

.github/workflows/scan.yml

@@ -13,11 +13,11 @@ jobs:
     name: Analyze
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v2.3.4
       - uses: actions/[email protected]
         with:
-          node-version: 14
-      - uses: actions/[email protected].4
+          node-version: 16
+      - uses: actions/[email protected].6
         with:
           path: .yarn/cache
           key: yarn-${{ hashFiles('yarn.lock') }}

.yarnrc.yml

@@ -13,4 +13,4 @@ plugins:
   - path: .yarn/plugins/@yarnpkg/plugin-workspace-tools.cjs
     spec: "@yarnpkg/plugin-workspace-tools"
 
-yarnPath: .yarn/releases/yarn-sources.cjs
+yarnPath: .yarn/releases/yarn-3.0.0-rc.2.cjs

CHANGELOG.md

@@ -21,6 +21,82 @@ Items that are related, such as breaking changes, new features, or changes to ex
 
 ## [Unreleased]
 
+### Fixed
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): The contrast ratios output in messages from SIA-R66 and SIA-R69 are now correctly listed as `<bright>:<dark>` rather than `<dark>:<bright>`.
+
+## [0.19.0](../../compare/v0.18.0...v0.19.0) (2021-06-15)
+
+### Breaking
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): The second expectation of SIA-R62 has been removed due to poor accuracy. ([#772](../../pull/772))
+
+- [@siteimprove/alfa-style](packages/alfa-style): The `background-size` property is now specified as and computes to a `Tuple` instance rather than a plain array tuple. ([#788](../../pull/788))
+
+### Added
+
+- [@siteimprove/alfa-style](packages/alfa-style): The style system now supports the `text-decoration-thickness` and `font-variant-*` CSS properties. ([#817](../../pull/817), [#821](../../pull/821))
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): An implementation of SIA-R56 is now available. ([#829](../../pull/829))
+
+### Changed
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): SIA-R62 now accepts differences in font weight as a valid distinguishing feature for links. ([#779](../../pull/779))
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): SIA-R65 now accepts differences in borders as a valid focus indicator. ([#819](../../pull/819))
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): SIA-R66 and SIA-R69 now return a `CantTell` outcome for targets for which a `background-size` is found. ([#789](../../pull/789))
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): `hasRole()` now uses the role assigned to an element in the accessibility tree rather than just using `Role.from()`. ([#805](../../pull/805))
+
+### Fixed
+
+- [@siteimprove/alfa-css](packages/alfa-css): Functional pseudo-classes and -elements now correctly implement `#equals()` and `#toString()`. ([#773](../../pull/773))
+
+- [@siteimprove/alfa-aria](packages/alfa-aria): The first step of `Name.from()` is now correctly skipped when descending into child nodes. Additionally, descendant names that only consist of whitespace are no longer included. ([#778](../../pull/778), [#831](../../pull/831))
+
+- [@siteimprove/alfa-style](packages/alfa-style): The `background-size` property is now parsed correctly according to specification. ([#788](../../pull/788))
+
+## [0.18.0](../../compare/v0.17.0...v0.18.0) (2021-06-11)
+
+### Breaking
+
+- [@siteimprove/alfa-graph](packages/alfa-graph), [@siteimprove/alfa-network](packages/alfa-network): Several breaking changes have been made to the `Graph` and `Network` types. Please see the associated pull request for more details. ([#765](../../pull/765))
+
+- [@siteimprove/alfa-highlight](packages/alfa-highlight): The `syntax()` function has been removed. ([#764](../../pull/764))
+
+- [@siteimprove/alfa-json-ld](packages/alfa-json-ld): Several unused APIs have been removed. Please see the associated pull request for more details. ([#766](../../pull/766))
+
+### Added
+
+- [@siteimprove/alfa-graph](packages/alfa-graph), [@siteimprove/alfa-network](packages/alfa-network): `Graph#isEmpty()`, `Network#isEmpty()`, `Graph#path()`, `Network#path()`, `Graph#reverse()`, `Network#reverse()`, `Graph#sort()`, and `Network#sort()` are now available. ([#765](../../pull/765))
+
+## [0.17.0](../../compare/v0.16.2...v0.17.0) (2021-04-13)
+
+### Breaking
+
+- [@siteimprove/afa-style](packages/alfa-style): The type of the `display` has changed from a plain tuple to the `Tuple` class. ([#763](../../pull/763))
+
+### Added
+
+- [@siteimprove/alfa-style](packages/alfa-style): The style system now supports the `border-*` shorthand CSS properties. Full support for the new logical CSS properties, such as `border-block-*`, is still an area of investigation. ([#754](../../pull/754))
+
+- [@siteimprove/alfa-thenable](packages/alfa-thenable): A new package is now available with types for modelling values that can be used in `await` expressions.
+
+- [@siteimprove/alfa-css](packages/alfa-css): Radial gradients are now available as a type of `Gradient`. ([#438](../../pull/438))
+
+### Changed
+
+- [@siteimprove/alfa-formatter-earl](packages/alfa-formatter-earl), [@siteimprove/alfa-formatter-sarif](packages/alfa-formatter-sarif): The EARL and SARIF formatters now output additional vendor data. ([#753](../../pull/753))
+
+- [@siteimprove/alfa-rules](packages/alfa-rules): SIA-R62 is now a fully automated rule and will therefore no longer pose questions during an audit. ([#760](../../pull/760))
+
+### Fixed
+
+- [@siteimprove/alfa-scraper](packages/alfa-scraper): Some previously uncaught exceptions during page navigation are now caught and handled, resolving an issue where the scraper wouldn't terminate in rare cases.
+
+- [@siteimprove/alfa-style](packages/alfa-style): The `display` property now supports the full grammar as specified by CSS. ([#763](../../pull/763))
+
 ## [0.16.2](../../compare/v0.16.1...v0.16.2) (2021-03-31)
 
 This release contains only internal API changes.

README.md

@@ -18,11 +18,11 @@ Alfa is an open and standards-based accessibility conformance testing engine. It
 
 ## Goals
 
-- Alfa sets out to strike a balance between false positives and negatives with the goal of having result sets reach a high [F<sub>1</sub> score](https://en.wikipedia.org/wiki/F1_score). If a false positive is encountered, it is therefore just as important to avoid introducing a potential false negative as it is fixing the false positive.
+1. Alfa sets out to strike a balance between false positives and negatives with the goal of having result sets reach a high [F<sub>1</sub> score](https://en.wikipedia.org/wiki/F1_score). If a false positive is encountered, it is therefore just as important to avoid introducing a potential false negative as it is fixing the false positive.
 
-- Alfa is committed to complete transparency on how test results came to be. Every line of code that has the potential to influence test results will therefore always reside within Alfa itself and never with a third-party. However, this does not mean that Alfa does not rely on third-party dependencies, only that there are limitations to what third-party dependencies may be used for.
+2. Alfa is committed to complete transparency on how test results came to be. Every line of code that has the potential to influence test results will therefore always reside within Alfa itself and never with a third-party. However, this does not mean that Alfa does not rely on third-party dependencies, only that there are limitations to what third-party dependencies may be used for.
 
-- Alfa wants to foster a thriving ecosystem with people from many different backgrounds building on top of the core capabilities of Alfa. To this end, high-quality documentation is paramount to success. Picking up and putting any one of the many subsystems within Alfa to use should be a straightforward experience with every subsystem clearly stating its purpose and structure. **This goal is currently far from met and will be prioritised**.
+3. Alfa wants to foster a thriving ecosystem with people from many different backgrounds building on top of the core capabilities of Alfa. To this end, high-quality documentation is paramount to success. Picking up and putting any one of the many subsystems within Alfa to use should be a straightforward experience with every subsystem clearly stating its purpose and structure. **This goal is currently far from met and will be prioritised**.
 
 ## Usage
 
@@ -148,6 +148,18 @@ As new code is pulled from the repository, changes to dependencies and code may
 $ yarn build
 ```
 
+If you want to run tests and make sure everything is working, use:
+
+```console
+$ yarn test
+```
+
+When working on a specific package, you can run only these tests:
+
+```console
+$ yarn test packages/alfa-<package-name>
+```
+
 If you would like to contribute to Alfa, make sure to check out the [contribution guidelines](docs/contributing.md). If you have any questions, you are also welcome to [open an issue][].
 
 ## Architecture

package.json

@@ -27,10 +27,10 @@
     "@types/node": "^14.14.31",
     "async": "^3.2.0",
     "axios": "^0.21.1",
-    "execa": "^5.0.0",
+    "execa": "^5.1.1",
     "minimist": "^1.2.5",
-    "prettier": "^2.2.1",
-    "typescript": "^4.2.3"
+    "prettier": "^2.3.1",
+    "typescript": "^4.3.2"
   },
   "resolutions": {
     "@microsoft/api-documenter": "patch:@microsoft/[email protected]#.yarn/patches/api-documenter.patch"

packages/alfa-act/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-act",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.16.2",
+  "version": "0.19.0",
   "license": "MIT",
   "description": "Functionality for implementing rules specified in the ACT Rules Format",
   "repository": {
@@ -18,26 +18,26 @@
     "src/**/*.d.ts"
   ],
   "dependencies": {
-    "@siteimprove/alfa-earl": "workspace:^0.16.2",
-    "@siteimprove/alfa-equatable": "workspace:^0.16.2",
-    "@siteimprove/alfa-functor": "workspace:^0.16.2",
-    "@siteimprove/alfa-future": "workspace:^0.16.2",
-    "@siteimprove/alfa-iterable": "workspace:^0.16.2",
-    "@siteimprove/alfa-json": "workspace:^0.16.2",
-    "@siteimprove/alfa-list": "workspace:^0.16.2",
-    "@siteimprove/alfa-mapper": "workspace:^0.16.2",
-    "@siteimprove/alfa-monad": "workspace:^0.16.2",
-    "@siteimprove/alfa-option": "workspace:^0.16.2",
-    "@siteimprove/alfa-performance": "workspace:^0.16.2",
-    "@siteimprove/alfa-record": "workspace:^0.16.2",
-    "@siteimprove/alfa-result": "workspace:^0.16.2",
-    "@siteimprove/alfa-sarif": "workspace:^0.16.2",
-    "@siteimprove/alfa-sequence": "workspace:^0.16.2",
-    "@siteimprove/alfa-thunk": "workspace:^0.16.2",
-    "@siteimprove/alfa-trilean": "workspace:^0.16.2"
+    "@siteimprove/alfa-earl": "workspace:^0.19.0",
+    "@siteimprove/alfa-equatable": "workspace:^0.19.0",
+    "@siteimprove/alfa-functor": "workspace:^0.19.0",
+    "@siteimprove/alfa-future": "workspace:^0.19.0",
+    "@siteimprove/alfa-iterable": "workspace:^0.19.0",
+    "@siteimprove/alfa-json": "workspace:^0.19.0",
+    "@siteimprove/alfa-list": "workspace:^0.19.0",
+    "@siteimprove/alfa-mapper": "workspace:^0.19.0",
+    "@siteimprove/alfa-monad": "workspace:^0.19.0",
+    "@siteimprove/alfa-option": "workspace:^0.19.0",
+    "@siteimprove/alfa-performance": "workspace:^0.19.0",
+    "@siteimprove/alfa-record": "workspace:^0.19.0",
+    "@siteimprove/alfa-result": "workspace:^0.19.0",
+    "@siteimprove/alfa-sarif": "workspace:^0.19.0",
+    "@siteimprove/alfa-sequence": "workspace:^0.19.0",
+    "@siteimprove/alfa-thunk": "workspace:^0.19.0",
+    "@siteimprove/alfa-trilean": "workspace:^0.19.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "workspace:^0.16.2"
+    "@siteimprove/alfa-test": "workspace:^0.19.0"
   },
   "publishConfig": {
     "access": "public",

packages/alfa-affine/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-affine",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.16.2",
+  "version": "0.19.0",
   "license": "MIT",
   "description": "Functionality for working with affine transformations",
   "repository": {
@@ -18,13 +18,13 @@
     "src/**/*.d.ts"
   ],
   "dependencies": {
-    "@siteimprove/alfa-equatable": "workspace:^0.16.2",
-    "@siteimprove/alfa-json": "workspace:^0.16.2",
-    "@siteimprove/alfa-math": "workspace:^0.16.2",
-    "@siteimprove/alfa-option": "workspace:^0.16.2"
+    "@siteimprove/alfa-equatable": "workspace:^0.19.0",
+    "@siteimprove/alfa-json": "workspace:^0.19.0",
+    "@siteimprove/alfa-math": "workspace:^0.19.0",
+    "@siteimprove/alfa-option": "workspace:^0.19.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "workspace:^0.16.2"
+    "@siteimprove/alfa-test": "workspace:^0.19.0"
   },
   "publishConfig": {
     "access": "public",

packages/alfa-angular/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-angular",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.16.2",
+  "version": "0.19.0",
   "license": "MIT",
   "description": "Integrations and utilities for the Angular application framework",
   "repository": {
@@ -19,16 +19,16 @@
   ],
   "dependencies": {
     "@angular/core": "^11.0.0",
-    "@siteimprove/alfa-device": "workspace:^0.16.2",
-    "@siteimprove/alfa-dom": "workspace:^0.16.2",
-    "@siteimprove/alfa-http": "workspace:^0.16.2",
-    "@siteimprove/alfa-option": "workspace:^0.16.2",
-    "@siteimprove/alfa-web": "workspace:^0.16.2",
-    "rxjs": "^6.6.7",
+    "@siteimprove/alfa-device": "workspace:^0.19.0",
+    "@siteimprove/alfa-dom": "workspace:^0.19.0",
+    "@siteimprove/alfa-http": "workspace:^0.19.0",
+    "@siteimprove/alfa-option": "workspace:^0.19.0",
+    "@siteimprove/alfa-web": "workspace:^0.19.0",
+    "rxjs": "^7.1.0",
     "zone.js": "^0.11.4"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "workspace:^0.16.2"
+    "@siteimprove/alfa-test": "workspace:^0.19.0"
   },
   "publishConfig": {
     "access": "public",

packages/alfa-applicative/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-applicative",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.16.2",
+  "version": "0.19.0",
   "license": "MIT",
   "description": "Types for modelling applicative functors",
   "repository": {
@@ -18,10 +18,10 @@
     "src/**/*.d.ts"
   ],
   "dependencies": {
-    "@siteimprove/alfa-mapper": "workspace:^0.16.2"
+    "@siteimprove/alfa-mapper": "workspace:^0.19.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "workspace:^0.16.2"
+    "@siteimprove/alfa-test": "workspace:^0.19.0"
   },
   "publishConfig": {
     "access": "public",

packages/alfa-aria/package.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/package",
   "name": "@siteimprove/alfa-aria",
   "homepage": "https://alfa.siteimprove.com",
-  "version": "0.16.2",
+  "version": "0.19.0",
   "license": "MIT",
   "description": "Functionality for working with ARIA and the accessibility tree",
   "repository": {
@@ -21,31 +21,31 @@
     "generate": "node scripts/attributes.js && node scripts/roles.js"
   },
   "dependencies": {
-    "@siteimprove/alfa-array": "workspace:^0.16.2",
-    "@siteimprove/alfa-branched": "workspace:^0.16.2",
-    "@siteimprove/alfa-cache": "workspace:^0.16.2",
-    "@siteimprove/alfa-compatibility": "workspace:^0.16.2",
-    "@siteimprove/alfa-device": "workspace:^0.16.2",
-    "@siteimprove/alfa-dom": "workspace:^0.16.2",
-    "@siteimprove/alfa-equatable": "workspace:^0.16.2",
-    "@siteimprove/alfa-graph": "workspace:^0.16.2",
-    "@siteimprove/alfa-hash": "workspace:^0.16.2",
-    "@siteimprove/alfa-iterable": "workspace:^0.16.2",
-    "@siteimprove/alfa-json": "workspace:^0.16.2",
-    "@siteimprove/alfa-lazy": "workspace:^0.16.2",
-    "@siteimprove/alfa-map": "workspace:^0.16.2",
-    "@siteimprove/alfa-mapper": "workspace:^0.16.2",
-    "@siteimprove/alfa-option": "workspace:^0.16.2",
-    "@siteimprove/alfa-predicate": "workspace:^0.16.2",
-    "@siteimprove/alfa-refinement": "workspace:^0.16.2",
-    "@siteimprove/alfa-sequence": "workspace:^0.16.2",
-    "@siteimprove/alfa-set": "workspace:^0.16.2",
-    "@siteimprove/alfa-style": "workspace:^0.16.2",
-    "@siteimprove/alfa-table": "workspace:^0.16.2",
-    "@siteimprove/alfa-thunk": "workspace:^0.16.2"
+    "@siteimprove/alfa-array": "workspace:^0.19.0",
+    "@siteimprove/alfa-branched": "workspace:^0.19.0",
+    "@siteimprove/alfa-cache": "workspace:^0.19.0",
+    "@siteimprove/alfa-compatibility": "workspace:^0.19.0",
+    "@siteimprove/alfa-device": "workspace:^0.19.0",
+    "@siteimprove/alfa-dom": "workspace:^0.19.0",
+    "@siteimprove/alfa-equatable": "workspace:^0.19.0",
+    "@siteimprove/alfa-graph": "workspace:^0.19.0",
+    "@siteimprove/alfa-hash": "workspace:^0.19.0",
+    "@siteimprove/alfa-iterable": "workspace:^0.19.0",
+    "@siteimprove/alfa-json": "workspace:^0.19.0",
+    "@siteimprove/alfa-lazy": "workspace:^0.19.0",
+    "@siteimprove/alfa-map": "workspace:^0.19.0",
+    "@siteimprove/alfa-mapper": "workspace:^0.19.0",
+    "@siteimprove/alfa-option": "workspace:^0.19.0",
+    "@siteimprove/alfa-predicate": "workspace:^0.19.0",
+    "@siteimprove/alfa-refinement": "workspace:^0.19.0",
+    "@siteimprove/alfa-sequence": "workspace:^0.19.0",
+    "@siteimprove/alfa-set": "workspace:^0.19.0",
+    "@siteimprove/alfa-style": "workspace:^0.19.0",
+    "@siteimprove/alfa-table": "workspace:^0.19.0",
+    "@siteimprove/alfa-thunk": "workspace:^0.19.0"
   },
   "devDependencies": {
-    "@siteimprove/alfa-test": "workspace:^0.16.2"
+    "@siteimprove/alfa-test": "workspace:^0.19.0"
   },
   "publishConfig": {
     "access": "public",