govuk_tech_docs 3.4.0 → 3.5.0

data/node_modules/govuk-frontend/govuk/common/closest-attribute-value.js

@@ -1,70 +1,75 @@
 (function (global, factory) {
-	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-	typeof define === 'function' && define.amd ? define('GOVUKFrontend', ['exports'], factory) :
-	(factory((global.GOVUKFrontend = {})));
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define('GOVUKFrontend', ['exports'], factory) :
+  (factory((global.GOVUKFrontend = {})));
 }(this, (function (exports) { 'use strict';
 
-(function(undefined) {
+  // @ts-nocheck
+  (function (undefined) {
 
-  // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/matches/detect.js
-  var detect = (
-    'document' in this && "matches" in document.documentElement
-  );
+    // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/matches/detect.js
+    var detect = (
+      'document' in this && "matches" in document.documentElement
+    );
 
-  if (detect) return
+    if (detect) return
 
-  // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/matches/polyfill.js
-  Element.prototype.matches = Element.prototype.webkitMatchesSelector || Element.prototype.oMatchesSelector || Element.prototype.msMatchesSelector || Element.prototype.mozMatchesSelector || function matches(selector) {
-    var element = this;
-    var elements = (element.document || element.ownerDocument).querySelectorAll(selector);
-    var index = 0;
+    // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/matches/polyfill.js
+    Element.prototype.matches = Element.prototype.webkitMatchesSelector || Element.prototype.oMatchesSelector || Element.prototype.msMatchesSelector || Element.prototype.mozMatchesSelector || function matches(selector) {
+      var element = this;
+      var elements = (element.document || element.ownerDocument).querySelectorAll(selector);
+      var index = 0;
 
-    while (elements[index] && elements[index] !== element) {
-      ++index;
-    }
+      while (elements[index] && elements[index] !== element) {
+        ++index;
+      }
 
-    return !!elements[index];
-  };
+      return !!elements[index];
+    };
 
-}).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
+  }).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
 
-(function(undefined) {
+  // @ts-nocheck
 
-  // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/closest/detect.js
-  var detect = (
-    'document' in this && "closest" in document.documentElement
-  );
+  (function(undefined) {
 
-  if (detect) return
+    // Detection from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/closest/detect.js
+    var detect = (
+      'document' in this && "closest" in document.documentElement
+    );
 
-  // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/closest/polyfill.js
-  Element.prototype.closest = function closest(selector) {
-    var node = this;
+    if (detect) return
 
-    while (node) {
-      if (node.matches(selector)) return node;
-      else node = 'SVGElement' in window && node instanceof SVGElement ? node.parentNode : node.parentElement;
-    }
+    // Polyfill from https://raw.githubusercontent.com/Financial-Times/polyfill-service/1f3c09b402f65bf6e393f933a15ba63f1b86ef1f/packages/polyfill-library/polyfills/Element/prototype/closest/polyfill.js
+    Element.prototype.closest = function closest(selector) {
+      var node = this;
 
-    return null;
-  };
+      while (node) {
+        if (node.matches(selector)) return node;
+        else node = 'SVGElement' in window && node instanceof SVGElement ? node.parentNode : node.parentElement;
+      }
 
-}).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
+      return null;
+    };
 
-/**
- * Returns the value of the given attribute closest to the given element (including itself)
- *
- * @param {HTMLElement} $element - The element to start walking the DOM tree up
- * @param {string} attributeName - The name of the attribute
- * @returns {string | undefined} Attribute value
- */
-function closestAttributeValue ($element, attributeName) {
-  var closestElementWithAttribute = $element.closest('[' + attributeName + ']');
-  if (closestElementWithAttribute) {
-    return closestElementWithAttribute.getAttribute(attributeName)
+  }).call('object' === typeof window && window || 'object' === typeof self && self || 'object' === typeof global && global || {});
+
+  /**
+   * Returns the value of the given attribute closest to the given element (including itself)
+   *
+   * @deprecated Will be made private in v5.0
+   * @param {Element} $element - The element to start walking the DOM tree up
+   * @param {string} attributeName - The name of the attribute
+   * @returns {string | null} Attribute value
+   */
+  function closestAttributeValue ($element, attributeName) {
+    var $closestElementWithAttribute = $element.closest('[' + attributeName + ']');
+    return $closestElementWithAttribute
+      ? $closestElementWithAttribute.getAttribute(attributeName)
+      : null
   }
-}
 
-exports.closestAttributeValue = closestAttributeValue;
+  exports.closestAttributeValue = closestAttributeValue;
 
 })));
+//# sourceMappingURL=closest-attribute-value.js.map

data/node_modules/govuk-frontend/govuk/common/govuk-frontend-version.js

@@ -0,0 +1,17 @@
+(function (global, factory) {
+	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+	typeof define === 'function' && define.amd ? define('GOVUKFrontend', ['exports'], factory) :
+	(factory((global.GOVUKFrontend = {})));
+}(this, (function (exports) { 'use strict';
+
+	/*
+	 * This variable is automatically overwritten during builds and releases.
+	 * It doesn't need to be updated manually.
+	 */
+
+	var version = '4.7.0';
+
+	exports.version = version;
+
+})));
+//# sourceMappingURL=govuk-frontend-version.js.map

data/node_modules/govuk-frontend/govuk/common/index.js

@@ -1,172 +1,192 @@
 (function (global, factory) {
-	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-	typeof define === 'function' && define.amd ? define('GOVUKFrontend', ['exports'], factory) :
-	(factory((global.GOVUKFrontend = {})));
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+  typeof define === 'function' && define.amd ? define('GOVUKFrontend', ['exports'], factory) :
+  (factory((global.GOVUKFrontend = {})));
 }(this, (function (exports) { 'use strict';
 
-/**
- * Common helpers which do not require polyfill.
- *
- * IMPORTANT: If a helper require a polyfill, please isolate it in its own module
- * so that the polyfill can be properly tree-shaken and does not burden
- * the components that do not need that helper
- *
- * @module common/index
- */
-
-/**
- * TODO: Ideally this would be a NodeList.prototype.forEach polyfill
- * This seems to fail in IE8, requires more investigation.
- * See: https://github.com/imagitama/nodelist-foreach-polyfill
- *
- * @param {NodeListOf<Element>} nodes - NodeList from querySelectorAll()
- * @param {nodeListIterator} callback - Callback function to run for each node
- * @returns {undefined}
- */
-function nodeListForEach (nodes, callback) {
-  if (window.NodeList.prototype.forEach) {
-    return nodes.forEach(callback)
-  }
-  for (var i = 0; i < nodes.length; i++) {
-    callback.call(window, nodes[i], i, nodes);
+  /**
+   * Common helpers which do not require polyfill.
+   *
+   * IMPORTANT: If a helper require a polyfill, please isolate it in its own module
+   * so that the polyfill can be properly tree-shaken and does not burden
+   * the components that do not need that helper
+   *
+   * @module common/index
+   */
+
+  /**
+   * TODO: Ideally this would be a NodeList.prototype.forEach polyfill
+   * This seems to fail in IE8, requires more investigation.
+   * See: https://github.com/imagitama/nodelist-foreach-polyfill
+   *
+   * @deprecated Will be made private in v5.0
+   * @template {Node} ElementType
+   * @param {NodeListOf<ElementType>} nodes - NodeList from querySelectorAll()
+   * @param {nodeListIterator<ElementType>} callback - Callback function to run for each node
+   * @returns {void}
+   */
+  function nodeListForEach (nodes, callback) {
+    if (window.NodeList.prototype.forEach) {
+      return nodes.forEach(callback)
+    }
+    for (var i = 0; i < nodes.length; i++) {
+      callback.call(window, nodes[i], i, nodes);
+    }
   }
-}
-
-/**
- * Used to generate a unique string, allows multiple instances of the component
- * without them conflicting with each other.
- * https://stackoverflow.com/a/8809472
- *
- * @returns {string} Unique ID
- */
-function generateUniqueID () {
-  var d = new Date().getTime();
-  if (typeof window.performance !== 'undefined' && typeof window.performance.now === 'function') {
-    d += window.performance.now(); // use high-precision timer if available
+
+  /**
+   * Used to generate a unique string, allows multiple instances of the component
+   * without them conflicting with each other.
+   * https://stackoverflow.com/a/8809472
+   *
+   * @deprecated Will be made private in v5.0
+   * @returns {string} Unique ID
+   */
+  function generateUniqueID () {
+    var d = new Date().getTime();
+    if (typeof window.performance !== 'undefined' && typeof window.performance.now === 'function') {
+      d += window.performance.now(); // use high-precision timer if available
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+      var r = (d + Math.random() * 16) % 16 | 0;
+      d = Math.floor(d / 16);
+      return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16)
+    })
   }
-  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
-    var r = (d + Math.random() * 16) % 16 | 0;
-    d = Math.floor(d / 16);
-    return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16)
-  })
-}
-
-/**
- * Config flattening function
- *
- * Takes any number of objects, flattens them into namespaced key-value pairs,
- * (e.g. {'i18n.showSection': 'Show section'}) and combines them together, with
- * greatest priority on the LAST item passed in.
- *
- * @returns {object} A flattened object of key-value pairs.
- */
-function mergeConfigs (/* configObject1, configObject2, ...configObjects */) {
+
   /**
-   * Function to take nested objects and flatten them to a dot-separated keyed
-   * object. Doing this means we don't need to do any deep/recursive merging of
-   * each of our objects, nor transform our dataset from a flat list into a
-   * nested object.
+   * Config flattening function
+   *
+   * Takes any number of objects, flattens them into namespaced key-value pairs,
+   * (e.g. {'i18n.showSection': 'Show section'}) and combines them together, with
+   * greatest priority on the LAST item passed in.
    *
-   * @param {object} configObject - Deeply nested object
-   * @returns {object} Flattened object with dot-separated keys
+   * @deprecated Will be made private in v5.0
+   * @returns {Object<string, unknown>} A flattened object of key-value pairs.
    */
-  var flattenObject = function (configObject) {
-    // Prepare an empty return object
-    var flattenedObject = {};
-
-    // Our flattening function, this is called recursively for each level of
-    // depth in the object. At each level we prepend the previous level names to
-    // the key using `prefix`.
-    var flattenLoop = function (obj, prefix) {
-      // Loop through keys...
-      for (var key in obj) {
-        // Check to see if this is a prototypical key/value,
-        // if it is, skip it.
-        if (!Object.prototype.hasOwnProperty.call(obj, key)) {
-          continue
-        }
-        var value = obj[key];
-        var prefixedKey = prefix ? prefix + '.' + key : key;
-        if (typeof value === 'object') {
-          // If the value is a nested object, recurse over that too
-          flattenLoop(value, prefixedKey);
-        } else {
-          // Otherwise, add this value to our return object
-          flattenedObject[prefixedKey] = value;
+  function mergeConfigs (/* configObject1, configObject2, ...configObjects */) {
+    /**
+     * Function to take nested objects and flatten them to a dot-separated keyed
+     * object. Doing this means we don't need to do any deep/recursive merging of
+     * each of our objects, nor transform our dataset from a flat list into a
+     * nested object.
+     *
+     * @param {Object<string, unknown>} configObject - Deeply nested object
+     * @returns {Object<string, unknown>} Flattened object with dot-separated keys
+     */
+    var flattenObject = function (configObject) {
+      // Prepare an empty return object
+      /** @type {Object<string, unknown>} */
+      var flattenedObject = {};
+
+      /**
+       * Our flattening function, this is called recursively for each level of
+       * depth in the object. At each level we prepend the previous level names to
+       * the key using `prefix`.
+       *
+       * @param {Partial<Object<string, unknown>>} obj - Object to flatten
+       * @param {string} [prefix] - Optional dot-separated prefix
+       */
+      var flattenLoop = function (obj, prefix) {
+        // Loop through keys...
+        for (var key in obj) {
+          // Check to see if this is a prototypical key/value,
+          // if it is, skip it.
+          if (!Object.prototype.hasOwnProperty.call(obj, key)) {
+            continue
+          }
+          var value = obj[key];
+          var prefixedKey = prefix ? prefix + '.' + key : key;
+          if (typeof value === 'object') {
+            // If the value is a nested object, recurse over that too
+            flattenLoop(value, prefixedKey);
+          } else {
+            // Otherwise, add this value to our return object
+            flattenedObject[prefixedKey] = value;
+          }
         }
-      }
+      };
+
+      // Kick off the recursive loop
+      flattenLoop(configObject);
+      return flattenedObject
     };
 
-    // Kick off the recursive loop
-    flattenLoop(configObject);
-    return flattenedObject
-  };
-
-  // Start with an empty object as our base
-  var formattedConfigObject = {};
-
-  // Loop through each of the remaining passed objects and push their keys
-  // one-by-one into configObject. Any duplicate keys will override the existing
-  // key with the new value.
-  for (var i = 0; i < arguments.length; i++) {
-    var obj = flattenObject(arguments[i]);
-    for (var key in obj) {
-      if (Object.prototype.hasOwnProperty.call(obj, key)) {
-        formattedConfigObject[key] = obj[key];
+    // Start with an empty object as our base
+    /** @type {Object<string, unknown>} */
+    var formattedConfigObject = {};
+
+    // Loop through each of the remaining passed objects and push their keys
+    // one-by-one into configObject. Any duplicate keys will override the existing
+    // key with the new value.
+    for (var i = 0; i < arguments.length; i++) {
+      var obj = flattenObject(arguments[i]);
+      for (var key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+          formattedConfigObject[key] = obj[key];
+        }
       }
     }
-  }
 
-  return formattedConfigObject
-}
-
-/**
- * Extracts keys starting with a particular namespace from a flattened config
- * object, removing the namespace in the process.
- *
- * @param {object} configObject - The object to extract key-value pairs from.
- * @param {string} namespace - The namespace to filter keys with.
- * @returns {object} Flattened object with dot-separated key namespace removed
- */
-function extractConfigByNamespace (configObject, namespace) {
-  // Check we have what we need
-  if (!configObject || typeof configObject !== 'object') {
-    throw new Error('Provide a `configObject` of type "object".')
+    return formattedConfigObject
   }
-  if (!namespace || typeof namespace !== 'string') {
-    throw new Error('Provide a `namespace` of type "string" to filter the `configObject` by.')
-  }
-  var newObject = {};
-  for (var key in configObject) {
-    // Split the key into parts, using . as our namespace separator
-    var keyParts = key.split('.');
-    // Check if the first namespace matches the configured namespace
-    if (Object.prototype.hasOwnProperty.call(configObject, key) && keyParts[0] === namespace) {
-      // Remove the first item (the namespace) from the parts array,
-      // but only if there is more than one part (we don't want blank keys!)
-      if (keyParts.length > 1) {
-        keyParts.shift();
+
+  /**
+   * Extracts keys starting with a particular namespace from a flattened config
+   * object, removing the namespace in the process.
+   *
+   * @deprecated Will be made private in v5.0
+   * @param {Object<string, unknown>} configObject - The object to extract key-value pairs from.
+   * @param {string} namespace - The namespace to filter keys with.
+   * @returns {Object<string, unknown>} Flattened object with dot-separated key namespace removed
+   * @throws {Error} Config object required
+   * @throws {Error} Namespace string required
+   */
+  function extractConfigByNamespace (configObject, namespace) {
+    // Check we have what we need
+    if (!configObject || typeof configObject !== 'object') {
+      throw new Error('Provide a `configObject` of type "object".')
+    }
+
+    if (!namespace || typeof namespace !== 'string') {
+      throw new Error('Provide a `namespace` of type "string" to filter the `configObject` by.')
+    }
+
+    /** @type {Object<string, unknown>} */
+    var newObject = {};
+
+    for (var key in configObject) {
+      // Split the key into parts, using . as our namespace separator
+      var keyParts = key.split('.');
+      // Check if the first namespace matches the configured namespace
+      if (Object.prototype.hasOwnProperty.call(configObject, key) && keyParts[0] === namespace) {
+        // Remove the first item (the namespace) from the parts array,
+        // but only if there is more than one part (we don't want blank keys!)
+        if (keyParts.length > 1) {
+          keyParts.shift();
+        }
+        // Join the remaining parts back together
+        var newKey = keyParts.join('.');
+        // Add them to our new object
+        newObject[newKey] = configObject[key];
       }
-      // Join the remaining parts back together
-      var newKey = keyParts.join('.');
-      // Add them to our new object
-      newObject[newKey] = configObject[key];
     }
+    return newObject
   }
-  return newObject
-}
-
-/**
- * @callback nodeListIterator
- * @param {Element} value - The current node being iterated on
- * @param {number} index - The current index in the iteration
- * @param {NodeListOf<Element>} nodes - NodeList from querySelectorAll()
- * @returns {undefined}
- */
-
-exports.nodeListForEach = nodeListForEach;
-exports.generateUniqueID = generateUniqueID;
-exports.mergeConfigs = mergeConfigs;
-exports.extractConfigByNamespace = extractConfigByNamespace;
+
+  /**
+   * @template {Node} ElementType
+   * @callback nodeListIterator
+   * @param {ElementType} value - The current node being iterated on
+   * @param {number} index - The current index in the iteration
+   * @param {NodeListOf<ElementType>} nodes - NodeList from querySelectorAll()
+   * @returns {void}
+   */
+
+  exports.nodeListForEach = nodeListForEach;
+  exports.generateUniqueID = generateUniqueID;
+  exports.mergeConfigs = mergeConfigs;
+  exports.extractConfigByNamespace = extractConfigByNamespace;
 
 })));
+//# sourceMappingURL=index.js.map