govuk_publishing_components 30.3.0 → 30.5.0

data/node_modules/axe-core/doc/examples/html-handlebars.md

@@ -1,164 +0,0 @@
-# Turning violation nodes into readable HTML
-
-The violations returns a list of rules that had failures. Each rule has a list of nodes that failed the rule. Each node may have failed for one or more reasons. This information is encoded in a set of structures that can be somewhat difficult to comprehend. This code shows how to turn a list of violations into a table and then for each node in a rule's nodes list, how to generate a summary of the reason(s) that rule failed.
-
-The example uses handlebars templates but can be easily adapted to other formats
-
-## The JavaScript
-
-```js
-function helperItemIterator(items, template) {
-	var out = '';
-	if (items) {
-		for (var i = 0; i < items.length; i++) {
-			out += template(items[i]);
-		}
-	}
-	return out;
-}
-Handlebars.registerHelper('violations', function(items) {
-	return helperItemIterator(items, compiledRowTemplate);
-});
-Handlebars.registerHelper('related', function(items) {
-	return helperItemIterator(items, compiledRelatedNodeTemplate);
-});
-Handlebars.registerHelper('reasons', function(items) {
-	return helperItemIterator(items, compiledFailureTemplate);
-});
-
-// Setup handlebars templates
-
-compiledRowTemplate = Handlebars.compile(rowTemplate.innerHTML);
-compiledTableTemplate = Handlebars.compile(tableTemplate.innerHTML);
-compiledRelatedListTemplate = Handlebars.compile(relatedListTemplate.innerHTML);
-compiledRelatedNodeTemplate = Handlebars.compile(relatedNodeTemplate.innerHTML);
-compiledFailureTemplate = Handlebars.compile(failureTemplate.innerHTML);
-compiledReasonsTemplate = Handlebars.compile(reasonsTemplate.innerHTML);
-
-function messageFromRelatedNodes(relatedNodes) {
-	var retVal = '';
-	if (relatedNodes.length) {
-		var list = relatedNodes.map(function(node) {
-			return {
-				targetArrayString: JSON.stringify(node.target),
-				targetString: node.target.join(' ')
-			};
-		});
-		retVal += compiledRelatedListTemplate({ relatedNodeList: list });
-	}
-	return retVal;
-}
-
-function messagesFromArray(nodes) {
-	var list = nodes.map(function(failure) {
-		return {
-			message: failure.message.replace(/</gi, '&lt;').replace(/>/gi, '&gt;'),
-			relatedNodesMessage: messageFromRelatedNodes(failure.relatedNodes)
-		};
-	});
-	return compiledReasonsTemplate({ reasonsList: list });
-}
-
-function summary(node) {
-	var retVal = '';
-	if (node.any.length) {
-		retVal += '<h3 class="error-title">Fix any of the following</h3>';
-		retVal += messagesFromArray(node.any);
-	}
-
-	var all = node.all.concat(node.none);
-	if (all.length) {
-		retVal += '<h3 class="error-title">Fix all of the following</h3>';
-		retVal += messagesFromArray(all);
-	}
-	return retVal;
-}
-
-/*
- * This code will generate a table of the rules that failed including counts and links to the Deque University help
- * for each rule.
- *
- * When used, you should attach click handlers to the anchors in order to generate the details for each of the
- * violations for each rule.
- */
-
-if (results.violations.length) {
-	var violations = results.violations.map(function(rule, i) {
-		return {
-			impact: rule.impact,
-			help: rule.help.replace(/</gi, '&lt;').replace(/>/gi, '&gt;'),
-			bestpractice: rule.tags.indexOf('best-practice') !== -1,
-			helpUrl: rule.helpUrl,
-			count: rule.nodes.length,
-			index: i
-		};
-	});
-
-	html = compiledTableTemplate({ violationList: violations });
-}
-
-/*
- * To generate the human readable summary, call the `summary` function with the node. This will return HTML for that node.
- */
-
-reasonHtml = summary(node);
-```
-
-## The Handlebars Templates
-
-```handlebars
-<script id="rowTemplate" type="text/x-handlebars-template">
-<tr>
-  <th scope="row" class="help">
-    <a href="javascript:;" class="rule" data-index="{{index}}">
-      {{{help}}}
-    </a>
-  </th>
-  <td scope="row">
-    <a target="_blank" href="{{helpUrl}}">?</a>
-  </td>
-  <td class="count">
-    {{count}}
-  </td>
-  <td class="impact">
-    {{impact}}
-  </td>
-</tr>
-</script>
-<script id="tableTemplate" type="text/x-handlebars-template">
-<table>
-  <tr>
-  <th scope="col">Description</th>
-  <th scope="col">Info</th>
-  <th scope="col">Count</th>
-  <th scope="col">Impact</th>
-  </tr>
-  {{#violations violationList}}{{/violations}}
-</table>
-</script>
-<script id="relatedListTemplate" type="text/x-handlebars-template">
-<ul>Related Nodes:
-  {{#related relatedNodeList}}{{/related}}
-</ul>
-</script>
-<script id="relatedNodeTemplate" type="text/x-handlebars-template">
-<li>
-  <a href="javascript:;" class="related-node" data-element="{{targetArrayString}}">
-    {{targetString}}
-  </a>
-</li>
-</script>
-<script id="reasonsTemplate" type="text/x-handlebars-template">
-<p class="summary">
-  <ul class="failure-message">
-    {{#reasons reasonsList}}{{/reasons}}
-  </ul>
-</p>
-</script>
-<script id="failureTemplate" type="text/x-handlebars-template">
-<li>
-  {{message}}
-  {{{relatedNodesMessage}}}
-</li>
-</script>
-```

data/node_modules/axe-core/doc/examples/jasmine/README.md

@@ -1,35 +0,0 @@
-# Jasmine README
-
-This example demonstrates how to use axe with the Jasmine unit testing framework.
-
-The unit test is in `spec/a11y.js`, and has two test cases: One that shows the
-expected results from HTML with no errors, and one that shows the expected
-result from HTML with a single error.
-
-## To configure the example
-
-- Node must be installed; please follow the directions at http://www.nodejs.org
-  to install it.
-- Move to the `doc/examples/jasmine` directory
-- `npm install` to install dependencies
-
-## To run the example
-
-- Move to the `doc/examples/jasmine` directory
-- `npm test` to run Jasmine
-
-You should see output indicating that the tests ran successfully, with zero
-failures.
-
-## To modify the example
-
-To run the example on your own HTML, such as widgets or controls, insert the
-HTML into the document, retrieve the root element of your widget (with e.g.,
-`document.getElementById()`), and pass that as the first argument into a call
-to `axe.run`.
-
-The third argument to the `axe.run` call should be the function to test
-the results. The example is simply looking at the count of violations, but much
-more detailed information is available if desired. The axe documentation
-should be consulted for more details on customizing and analyzing calls to
-`axe.run`.

data/node_modules/axe-core/doc/examples/jasmine/karma.conf.js

@@ -1,29 +0,0 @@
-module.exports = function(config) {
-	config.set({
-		basePath: '',
-
-		frameworks: ['jasmine'],
-
-		files: ['spec/**/*.js', 'node_modules/axe-core/axe.js'],
-
-		exclude: [],
-
-		preprocessors: {},
-
-		reporters: ['progress'],
-
-		port: 9876,
-
-		colors: true,
-
-		logLevel: config.LOG_INFO,
-
-		autoWatch: true,
-
-		browsers: ['ChromeHeadless'],
-
-		singleRun: true,
-
-		concurrency: Infinity
-	});
-};

data/node_modules/axe-core/doc/examples/jasmine/package.json

@@ -1,21 +0,0 @@
-{
-	"name": "axe-jasmine-example",
-	"description": "Axe Jasmine Example",
-	"version": "0.0.1",
-	"private": true,
-	"author": {
-		"name": "David Sturley",
-		"organization": "Deque Systems, Inc.",
-		"url": "http://deque.com/"
-	},
-	"dependencies": {},
-	"scripts": {
-		"test": "karma start karma.conf.js"
-	},
-	"devDependencies": {
-		"axe-core": "^3.3.1",
-		"karma": "^4.2.0",
-		"karma-chrome-launcher": "^3.0.0",
-		"karma-jasmine": "^2.0.1"
-	}
-}

data/node_modules/axe-core/doc/examples/jasmine/spec/a11y.js

@@ -1,36 +0,0 @@
-/* global describe, it, expect, axe, document */
-
-describe('axe', function() {
-	'use strict';
-
-	document
-		.getElementsByTagName('body')[0]
-		.insertAdjacentHTML(
-			'beforeend',
-			'<div id="working">' +
-				'<label for="has-label">Label for this text field.</label>' +
-				'<input type="text" id="has-label">' +
-				'</div>' +
-				'<div id="broken">' +
-				'<p>Not a label</p><input type="text" id="no-label">' +
-				'</div>'
-		);
-
-	it('should report that good HTML is good', function(done) {
-		var n = document.getElementById('working');
-		axe.run(n, function(err, result) {
-			expect(err).toBe(null);
-			expect(result.violations.length).toBe(0);
-			done();
-		});
-	});
-
-	it('should report that bad HTML is bad', function(done) {
-		var n = document.getElementById('broken');
-		axe.run(n, function(err, result) {
-			expect(err).toBe(null);
-			expect(result.violations.length).toBe(1);
-			done();
-		});
-	});
-});

data/node_modules/axe-core/doc/examples/jest_react/README.md

@@ -1,41 +0,0 @@
-# Jest + React README
-
-This example demonstrates how to use axe to test React components using the
-Jest unit testing framework.
-
-The unit test is in `link.test.js`, and has one test cases, showing how to run
-axe-core in Jest (using JSDOM and Enzyme).
-
-## To configure the example
-
-- Node must be installed; please follow the directions at http://www.nodejs.org
-  to install it.
-- Move to the `doc/examples/jest_react` directory
-- `npm install` to install dependencies
-
-## To run the example
-
-- Move to the `doc/examples/jest_react` directory
-- `npm test` to run Jasmine
-
-You should see output indicating that the tests ran successfully, with zero
-failures.
-
-Note: to work better with JSDOM (which has limited support for necessary DOM APIs),
-the color-contrast and link-in-text-block rules have been disabled in this example.
-You can test for these rules more reliably using full browser DOM integration
-testing using [axe-webdriverjs](https://github.com/dequelabs/axe-webdriverjs).
-
-## To modify the example
-
-This example can be modified to test components in other test frameworks as well. To use axe-core with JSDOM (Like Jest does), you will need to ensure that JSDOM variables are made available on the global object. An easy way to do this is to use [jsdom-global](https://github.com/rstacruz/jsdom-global).
-
-For example, when running Mocha, you should require `jsdom-global/register`. The command for this is as follows:
-
-```sh
-mocha *.test.js --require jsdom-global/register
-```
-
-## Timeout Issues
-
-Axe-core is very fast for what it does, but when testing larger components, it may take a few seconds to complete. This is because axe will be running thousands of tests in a single call. When testing composite components, you may have to increase the timeout setting.

data/node_modules/axe-core/doc/examples/jest_react/link.js

@@ -1,7 +0,0 @@
-import React from 'react';
-
-export default class Link extends React.Component {
-	render() {
-		return <a href={this.props.page || '#'}>{this.props.children}</a>;
-	}
-}

data/node_modules/axe-core/doc/examples/jest_react/link.test.js

@@ -1,24 +0,0 @@
-import React from 'react';
-import axe from 'axe-core';
-import { mountToDoc } from './test-helpers';
-
-import Link from './link';
-
-test('Link has no axe violations', done => {
-	const linkComponent = mountToDoc(
-		<Link page="http://www.axe-core.org">axe website</Link>
-	);
-	const linkNode = linkComponent.getDOMNode();
-
-	const config = {
-		rules: {
-			'color-contrast': { enabled: false },
-			'link-in-text-block': { enabled: false }
-		}
-	};
-	axe.run(linkNode, config, (err, { violations }) => {
-		expect(err).toBe(null);
-		expect(violations).toHaveLength(0);
-		done();
-	});
-});

data/node_modules/axe-core/doc/examples/jest_react/package.json

@@ -1,28 +0,0 @@
-{
-	"name": "axe-jest-react-example",
-	"description": "Axe Jest + React Example",
-	"version": "0.0.1",
-	"private": true,
-	"author": {
-		"name": "Wilco Fiers",
-		"organization": "Deque Systems, Inc.",
-		"url": "http://deque.com/"
-	},
-	"dependencies": {},
-	"scripts": {
-		"test": "jest"
-	},
-	"devDependencies": {
-		"@babel/preset-env": "^7.5.5",
-		"@babel/preset-react": "^7.0.0",
-		"axe-core": "^3.3.1",
-		"babel-jest": "^24.8.0",
-		"enzyme": "^3.10.0",
-		"enzyme-adapter-react-16": "^1.14.0",
-		"jest": "^24.8.0",
-		"jest-cli": "^24.8.0",
-		"react": "^16.4.0",
-		"react-dom": "^16.4.0",
-		"react-test-renderer": "^16.2.0"
-	}
-}

data/node_modules/axe-core/doc/examples/jest_react/test-helpers.js

@@ -1,21 +0,0 @@
-import { configure, mount } from 'enzyme';
-import Adapter from 'enzyme-adapter-react-16';
-
-configure({ adapter: new Adapter() });
-
-let wrapper;
-export function mountToDoc(reactElm) {
-	if (!document) {
-		// Set up a basic DOM
-		global.document = jsdom('<!doctype html><html><body></body></html>');
-	}
-	if (!wrapper) {
-		wrapper = document.createElement('main');
-		document.body.appendChild(wrapper);
-	}
-
-	const container = mount(reactElm);
-	wrapper.innerHTML = '';
-	wrapper.appendChild(container.getDOMNode());
-	return container;
-}

data/node_modules/axe-core/doc/examples/jsdom/package.json

@@ -1,15 +0,0 @@
-{
-	"name": "axe-jsdom-example",
-	"description": "Axe JSDOM Example",
-	"version": "0.0.1",
-	"private": true,
-	"dependencies": {},
-	"scripts": {
-		"test": "mocha"
-	},
-	"devDependencies": {
-		"axe-core": "^3.3.1",
-		"jsdom": "^15.1.1",
-		"mocha": "^6.2.0"
-	}
-}

data/node_modules/axe-core/doc/examples/mocha/README.md

@@ -1,35 +0,0 @@
-# Mocha README
-
-This example demonstrates how to use axe with the Mocha unit testing framework.
-
-The unit test is in `test/a11y.js`, and has two test cases: One that shows the
-expected results from HTML with no errors, and one that shows the expected
-result from HTML with a single error.
-
-## To configure the example
-
-- Node must be installed; please follow the directions at http://www.nodejs.org
-  to install it.
-- Move to the `doc/examples/mocha` directory
-- `npm install` to install dependencies
-
-## To run the example
-
-- Move to the `doc/examples/mocha` directory
-- `npm test` to run Mocha
-
-You should see output indicating that the tests ran successfully, with zero
-failures.
-
-## To modify the example
-
-To run the example on your own HTML, such as widgets or controls, insert the
-HTML into the document, retrieve the root element of your widget (with e.g.,
-`document.getElementById()`), and pass that as the first argument into a call
-to `axe.run`.
-
-The third argument to the `axe.run` call should be the function to test
-the results. The example is simply looking at the count of violations, but much
-more detailed information is available if desired. The axe documentation
-should be consulted for more details on customizing and analyzing calls to
-`axe.run`.

data/node_modules/axe-core/doc/examples/mocha/karma.conf.js

@@ -1,29 +0,0 @@
-module.exports = function(config) {
-	config.set({
-		basePath: '',
-
-		frameworks: ['mocha', 'chai'],
-
-		files: ['test/**/*.js', 'node_modules/axe-core/axe.js'],
-
-		exclude: [],
-
-		preprocessors: {},
-
-		reporters: ['progress'],
-
-		port: 9876,
-
-		colors: true,
-
-		logLevel: config.LOG_INFO,
-
-		autoWatch: true,
-
-		browsers: ['ChromeHeadless'],
-
-		singleRun: true,
-
-		concurrency: Infinity
-	});
-};

data/node_modules/axe-core/doc/examples/mocha/package.json

@@ -1,22 +0,0 @@
-{
-	"name": "axe-mocha-example",
-	"description": "Axe Mocha Example",
-	"version": "0.0.1",
-	"private": true,
-	"author": {
-		"name": "David Sturley",
-		"organization": "Deque Systems, Inc.",
-		"url": "http://deque.com/"
-	},
-	"dependencies": {},
-	"scripts": {
-		"test": "karma start karma.conf.js"
-	},
-	"devDependencies": {
-		"axe-core": "^3.3.1",
-		"karma": "^4.2.0",
-		"karma-chai": "^0.1.0",
-		"karma-chrome-launcher": "^3.0.0",
-		"karma-mocha": "^1.3.0"
-	}
-}

data/node_modules/axe-core/doc/examples/phantomjs/README.md

@@ -1,17 +0,0 @@
-# PhantomJS README
-
-This example demonstrates how to use axe with PhantomJS.
-
-## To configure the example
-
-- PhantomJS must be installed; please follow the directions at http://phantomjs.org/
-  to install it.
-- Run `npm install axe-core`
-
-## To run the example
-
-- Move to the `doc/examples/phantomjs` directory
-- `phantomjs axe-phantom.js http://www.deque.com` to run axe in PhantomJS
-  against http://www.deque.com and output results to the terminal
-- `phantomjs axe-phantom.js http://www.deque.com results.json` to run axe in PhantomJS
-  against http://www.deque.com and save results to `results.json`

data/node_modules/axe-core/doc/examples/phantomjs/axe-phantom.js

@@ -1,53 +0,0 @@
-/*global window, phantom */
-var PATH_TO_AXE = 'node_modules/axe-core/axe.min.js';
-
-var args = require('system').args;
-var fs = require('fs');
-var page = require('webpage').create();
-
-if (args.length < 2) {
-	console.log('axe-phantomjs.js accepts 1 argument, the URL to test');
-	phantom.exit(1);
-}
-
-console.log('Testing, please wait...');
-
-page.open(args[1], function(status) {
-	// Check for page load success
-	if (status !== 'success') {
-		console.log('Unable to access network');
-		return;
-	}
-
-	page.injectJs(PATH_TO_AXE);
-	page.framesName.forEach(function(name) {
-		page.switchToFrame(name);
-		page.injectJs(PATH_TO_AXE);
-	});
-	page.switchToMainFrame();
-	page.evaluateAsync(function() {
-		/*global axe */
-		axe.run({ include: ['#page'] }, function(err, results) {
-			if (err) {
-				throw err;
-			}
-			window.callPhantom(results);
-		});
-	});
-
-	page.onCallback = function(msg) {
-		if (args[2]) {
-			fs.write(args[2], JSON.stringify(msg, null, '  '), 'w');
-		} else {
-			if (msg.violations.length) {
-				console.log(JSON.stringify(msg.violations, null, '  '));
-			} else {
-				console.log('No violations found!');
-			}
-		}
-
-		// NOTE: to fail the test when violations are found, uncomment the line below.
-		// phantom.exit(msg.violations.length);
-		phantom.exit(0);
-	};
-});

data/node_modules/axe-core/doc/examples/phantomjs/package.json

@@ -1,19 +0,0 @@
-{
-	"name": "axe-phantomjs-example",
-	"description": "Axe PhantomJS Example",
-	"version": "0.0.1",
-	"private": true,
-	"author": {
-		"name": "Wlico Fiers",
-		"organization": "Deque Systems, Inc.",
-		"url": "http://deque.com/"
-	},
-	"dependencies": {},
-	"scripts": {
-		"test": "phantomjs axe-phantom.js https://www.deque.com"
-	},
-	"devDependencies": {
-		"axe-core": "^3.3.1",
-		"phantomjs": "^2.1.7"
-	}
-}

data/node_modules/axe-core/doc/examples/puppeteer/README.md

@@ -1,12 +0,0 @@
-# axe-puppeteer-example
-
-This (very minimal) example demonstrates how to use `axe-core` with [Puppeteer](https://github.com/GoogleChrome/puppeteer).
-
-The example does not have feature parity with [`axe-webdriverjs`](https://github.com/dequelabs/axe-webdriverjs), and does not run on `<iframe>`s.
-
-## To run the example
-
-- Ensure Node v8+ is installed and on `PATH`
-- Move to the `doc/examples/puppeteer` directory
-- Run `npm install`
-- Run `node axe-puppeteer.js http://www.deque.com` to run `axe-core` via Puppeteer against http://www.deque.com and output results to the terminal