govuk_tech_docs 3.4.0 → 3.4.5

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

@@ -1,174 +1,194 @@
 (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".')
-  }
-  if (!namespace || typeof namespace !== 'string') {
-    throw new Error('Provide a `namespace` of type "string" to filter the `configObject` by.')
+    return formattedConfigObject
   }
-  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}
- */
+  /**
+   * @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}
+   */
 
-// Implementation of common function is gathered in the `common` folder
+  // Implementation of common function is gathered in the `common` folder
 
-exports.nodeListForEach = nodeListForEach;
-exports.generateUniqueID = generateUniqueID;
-exports.mergeConfigs = mergeConfigs;
-exports.extractConfigByNamespace = extractConfigByNamespace;
+  exports.nodeListForEach = nodeListForEach;
+  exports.generateUniqueID = generateUniqueID;
+  exports.mergeConfigs = mergeConfigs;
+  exports.extractConfigByNamespace = extractConfigByNamespace;
 
 })));
+//# sourceMappingURL=common.js.map

data/node_modules/govuk-frontend/govuk/components/_all.scss

@@ -7,16 +7,16 @@
 @import "checkboxes/index";
 @import "character-count/index";
 @import "cookie-banner/index";
-@import "summary-list/index";
 @import "date-input/index";
 @import "details/index";
 @import "error-message/index";
 @import "error-summary/index";
+@import "exit-this-page/index";
 @import "fieldset/index";
 @import "file-upload/index";
 @import "footer/index";
-@import "hint/index";
 @import "header/index";
+@import "hint/index";
 @import "input/index";
 @import "inset-text/index";
 @import "label/index";
@@ -29,6 +29,7 @@
 @import "radios/index";
 @import "select/index";
 @import "skip-link/index";
+@import "summary-list/index";
 @import "table/index";
 @import "textarea/index";
 @import "warning-text/index";

data/node_modules/govuk-frontend/govuk/components/accordion/_index.scss

@@ -46,11 +46,26 @@
       padding-top: 0;
     }
 
-    // Hide the body of collapsed sections
+    // Hide the body of collapsed sections by default for browsers that lack
+    // support for `content-visibility` paired with [hidden=until-found]
     .govuk-accordion__section-content {
       display: none;
-      @include govuk-responsive-padding(8, "bottom");
+
       @include govuk-responsive-padding(3, "top");
+      @include govuk-responsive-padding(8, "bottom");
+    }
+
+    // Hide the body of collapsed sections using `content-visibility` to enable
+    // page search within [hidden=until-found] regions where browser supported
+    .govuk-accordion__section-content[hidden] {
+      @supports (content-visibility: hidden) {
+        content-visibility: hidden;
+        display: inherit;
+      }
+
+      // Hide the padding of collapsed sections
+      padding-top: 0;
+      padding-bottom: 0;
     }
 
     // Show the body of expanded sections
@@ -74,7 +89,7 @@
       cursor: pointer;
       -webkit-appearance: none;
 
-      @include govuk-media-query ($from: desktop) {
+      @include govuk-media-query ($from: tablet) {
         margin-bottom: 14px;
       }
 
@@ -140,7 +155,7 @@
       vertical-align: middle;
 
       // IE8 fallback of icon
-      @include govuk-if-ie8 {
+      @include _govuk-if-ie8 {
         display: inline-block;
         max-height: 20px;
         line-height: 1;
@@ -169,7 +184,7 @@
         border-right: govuk-px-to-rem(2px) solid;
 
         // IE8 fallback of icon with HTML symbol
-        @include govuk-if-ie8 {
+        @include _govuk-if-ie8 {
           content: "\25B2"; // "▲"
           position: relative;
           border: 0;
@@ -184,7 +199,7 @@
               transform: rotate(180deg);
 
       // IE8 fallback of arrow icon
-      @include govuk-if-ie8 {
+      @include _govuk-if-ie8 {
         &:after {
           content: "\25BC"; // "▼"
           -webkit-transform: none;
@@ -274,8 +289,12 @@
     // relates to the content below. Adjust padding to maintain the height of the element.
     // See https://github.com/alphagov/govuk-frontend/pull/2257#issuecomment-951920798
     .govuk-accordion__section--expanded .govuk-accordion__section-button {
-      padding-bottom: govuk-spacing(4);
+      padding-bottom: govuk-spacing(3);
       border-bottom: 0;
+
+      @include govuk-media-query ($from: tablet) {
+        padding-bottom: govuk-spacing(4);
+      }
     }
 
     // As Chevron icon is vertically aligned it overlaps with the focus state bottom border