govuk_publishing_components 30.4.1 → 30.5.2

data/node_modules/axe-core/CONTRIBUTING.md

@@ -1,187 +0,0 @@
-# Contributing
-
-## Contributor License Agreement
-
-In order to contribute, you must accept the [contributor license agreement](https://cla-assistant.io/dequelabs/axe-core) (CLA). Acceptance of this agreement will be checked automatically and pull requests without a CLA cannot be merged.
-
-## Contribution Guidelines
-
-Submitting code to the project? Please review and follow our
-[Git commit and pull request guidelines](doc/code-submission-guidelines.md).
-
-### Code Quality
-
-Although we do not have official code style guidelines, we can and will request you to make changes
-if we think that your code is sloppy. You can take clues from the existing code base to see what we
-consider to be reasonable code quality. Please be prepared to make changes that we ask of you even
-if you might not agree with the request(s).
-
-Please respect the coding style of the files you are changing and adhere to that.
-
-The JavaScript files in this project are formatted by [Prettier](https://prettier.io/). Additionally, we prefer:
-
-1. Tabs over spaces
-2. Single quotes for string literals
-3. Function definitions like `function functionName(arguments) {`
-4. Variable function definitions like `Class.prototype.functionName = function (arguments) {`
-5. Use of 'use strict'
-6. Variables declared at the top of functions
-
-### Shadow DOM
-
-For any proposed changes to rules, checks, commons, or other APIs to be accepted
-in axe-core, your code must support open Shadow DOM. See [API.md](./doc/API.md) and the
-[developer guide](./doc/developer-guide.md) for documentation on the available methods
-and test utilities. You can also look at existing tests for examples using our APIs.
-
-### Testing
-
-We expect all code to be 100% covered by tests. We don't have or want code coverage metrics but we will review tests and suggest changes when we think the test(s) do(es) not adequately exercise the code/code changes.
-
-### Documentation and Comments
-
-Functions should contain a preceding comment block with [jsdoc](http://usejsdoc.org/) style documentation of the function. For example:
-
-```js
-/**
- * Runs the Audit; which in turn should call `run` on each rule.
- * @async
- * @param  {Context}   context The scope definition/context for analysis (include/exclude)
- * @param  {Object}    options Options object to pass into rules and/or disable rules or checks
- * @param  {Function} fn       Callback function to fire when audit is complete
- */
-```
-
-Classes should contain a jsdoc comment block for each attribute. For example:
-
-```js
-/**
- * Constructor for the result of checks
- * @param {Object} check CheckResult specification
- */
-function CheckResult(check) {
-	'use strict';
-
-	/**
-	 * ID of the check.  Unique in the context of a rule.
-	 * @type {String}
-	 */
-	this.id = check.id;
-
-	/**
-	 * Any data passed by Check (by calling `this.data()`)
-	 * @type {Mixed}
-	 */
-	this.data = null;
-
-	/**
-	 * Any node that is related to the Check, specified by calling `this.relatedNodes([HTMLElement...])` inside the Check
-	 * @type {Array}
-	 */
-	this.relatedNodes = [];
-
-	/**
-	 * The return value of the Check's evaluate function
-	 * @type {Mixed}
-	 */
-	this.result = null;
-}
-```
-
-## Setting up your environment
-
-In order to get going, fork and clone the repository. Then, if you do not have [Node.js](https://nodejs.org/download/) installed, install it!
-
-Once the basic infrastructure is installed, from the repository root, do the following:
-
-```console
-npm install
-```
-
-To run tests:
-
-```console
-grunt test
-```
-
-To build the package:
-
-```console
-grunt build
-```
-
-## Using axe with TypeScript
-
-### Axe Development
-
-The TypeScript definition file for axe-core is distributed with this module and can be found in [axe.d.ts](./axe.d.ts). It currently supports TypeScript 2.0+.
-
-To maintain axe support for TypeScript you must first install it (globally recommended):
-
-```console
-sudo npm -g install typescript
-```
-
-Once that's installed, you can run TypeScript definition tests (with the optional `--noImplicitAny` flag):
-
-```console
-tsc --noImplicitAny typings/axe-core/axe-core-tests.ts
-```
-
-## Including axe's type definition in tests
-
-Installing axe to run accessibility tests in your TypeScript project should be as simple as importing the module:
-
-```js
-import * as axe from 'axe-core';
-
-describe('Module', () => {
-	it('should have no accessibility violations', done => {
-		axe.run(compiledFixture).then(results => {
-			expect(results.violations.length).toBe(0);
-			done();
-		}, done);
-	});
-});
-```
-
-## Debugging tests that only fail on CircleCI
-
-First install an X-Windows client on your machine. XQuartz is a good one.
-
-Then follow the [instructions here to connect the X-Windows on CircleCI to XQuartz](https://circleci.com/docs/1.0/browser-debugging/#x11-forwarding-over-ssh)
-
-Start the build using the "Retry the build with SSH enabled" option in the CircleCI interface
-
-Copy the SSH command and add the -X flag to it for example
-
-```console
-ssh -X -p 64605 ubuntu@13.58.157.61
-```
-
-When you login, set up the environment and start the chrome browser
-
-```console
-export DISPLAY=localhost:10.0
-/opt/google/chrome/chrome
-```
-
-### .Xauthority does not exist
-
-Edit the ~/.Xauthority file and just save it with the following commands
-
-```console
-vi ~/.Xauthority
-:wq
-```
-
-### Starting the web server
-
-Log into a second ssh terminal (without -X) and execute the following commands
-
-```console
-cd axe-core
-grunt connect watch
-```
-
-Load your test file URL in the Chrome browser opened in XQuartz

data/node_modules/axe-core/bower.json

@@ -1,40 +0,0 @@
-{
-	"name": "axe-core",
-	"version": "3.5.5",
-	"contributors": [
-		{
-			"name": "David Sturley",
-			"organization": "Deque Systems, Inc.",
-			"url": "http://deque.com/"
-		},
-		{
-			"name": "Dylan Barrell",
-			"organization": "Deque Systems, Inc.",
-			"url": "http://deque.com/"
-		},
-		{
-			"name": "Wilco Fiers",
-			"organization": "Deque Systems, Inc.",
-			"url": "http://deque.com/"
-		},
-		{
-			"name": "Dian Fay",
-			"organization": "Deque Systems, Inc.",
-			"url": "http://deque.com/"
-		},
-		{
-			"name": "Marcy Sutton",
-			"organization": "Deque Systems, Inc.",
-			"url": "http://deque.com/"
-		}
-	],
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/dequelabs/axe-core.git"
-	},
-	"main": "axe.js",
-	"typings": "axe.d.ts",
-	"license": "MPL-2.0",
-	"ignore": ["**/.*", "node_modules", "test", "build", "typings"],
-	"devDependencies": {}
-}