govuk_publishing_components 35.3.2 → 35.3.4

data/node_modules/govuk-frontend/govuk-esm/components/error-summary/error-summary.mjs

@@ -1,10 +1,10 @@
-/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */
+import { mergeConfigs } from '../../common/index.mjs';
+import { normaliseDataset } from '../../common/normalise-dataset.mjs';
+import '../../vendor/polyfills/Element/prototype/closest.mjs';
+import '../../vendor/polyfills/Event.mjs';
+import '../../vendor/polyfills/Function/prototype/bind.mjs';
 
-import { mergeConfigs } from '../../common/index.mjs'
-import { normaliseDataset } from '../../common/normalise-dataset.mjs'
-import '../../vendor/polyfills/Element/prototype/closest.mjs'
-import '../../vendor/polyfills/Event.mjs' // addEventListener, event.target normalization and DOMContentLoaded
-import '../../vendor/polyfills/Function/prototype/bind.mjs'
+/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */
 
 /**
  * JavaScript enhancements for the ErrorSummary
@@ -12,7 +12,7 @@ import '../../vendor/polyfills/Function/prototype/bind.mjs'
  * Takes focus on initialisation for accessible announcement, unless disabled in configuration.
  *
  * @class
- * @param {HTMLElement} $module - HTML element to use for error summary
+ * @param {Element} $module - HTML element to use for error summary
  * @param {ErrorSummaryConfig} [config] - Error summary config
  */
 function ErrorSummary ($module, config) {
@@ -23,42 +23,52 @@ function ErrorSummary ($module, config) {
   // To avoid breaking further JavaScript initialisation
   // we need to safeguard against this so things keep
   // working the same now we read the elements data attributes
-  if (!$module) {
+  if (!($module instanceof HTMLElement)) {
     // Little safety in case code gets ported as-is
     // into and ES6 class constructor, where the return value matters
     return this
   }
 
-  this.$module = $module
+  /** @deprecated Will be made private in v5.0 */
+  this.$module = $module;
 
   var defaultConfig = {
     disableAutoFocus: false
-  }
+  };
+
+  /**
+   * @deprecated Will be made private in v5.0
+   * @type {ErrorSummaryConfig}
+   */
   this.config = mergeConfigs(
     defaultConfig,
     config || {},
     normaliseDataset($module.dataset)
-  )
+  );
 }
 
 /**
  * Initialise component
  */
 ErrorSummary.prototype.init = function () {
-  var $module = this.$module
-  if (!$module) {
+  // Check that required elements are present
+  if (!this.$module) {
     return
   }
 
-  this.setFocus()
-  $module.addEventListener('click', this.handleClick.bind(this))
-}
+  var $module = this.$module;
+
+  this.setFocus();
+  $module.addEventListener('click', this.handleClick.bind(this));
+};
 
 /**
  * Focus the error summary
+ *
+ * @deprecated Will be made private in v5.0
  */
 ErrorSummary.prototype.setFocus = function () {
-  var $module = this.$module
+  var $module = this.$module;
 
   if (this.config.disableAutoFocus) {
     return
@@ -66,26 +76,27 @@ ErrorSummary.prototype.setFocus = function () {
 
   // Set tabindex to -1 to make the element programmatically focusable, but
   // remove it on blur as the error summary doesn't need to be focused again.
-  $module.setAttribute('tabindex', '-1')
+  $module.setAttribute('tabindex', '-1');
 
   $module.addEventListener('blur', function () {
-    $module.removeAttribute('tabindex')
-  })
+    $module.removeAttribute('tabindex');
+  });
 
-  $module.focus()
-}
+  $module.focus();
+};
 
 /**
  * Click event handler
  *
+ * @deprecated Will be made private in v5.0
  * @param {MouseEvent} event - Click event
  */
 ErrorSummary.prototype.handleClick = function (event) {
-  var $target = event.target
+  var $target = event.target;
   if (this.focusTarget($target)) {
-    event.preventDefault()
+    event.preventDefault();
   }
-}
+};
 
 /**
  * Focus the target element
@@ -102,22 +113,27 @@ ErrorSummary.prototype.handleClick = function (event) {
  * NVDA (as tested in 2018.3.2) - without this only the field type is announced
  * (e.g. "Edit, has autocomplete").
  *
+ * @deprecated Will be made private in v5.0
  * @param {EventTarget} $target - Event target
  * @returns {boolean} True if the target was able to be focussed
  */
 ErrorSummary.prototype.focusTarget = function ($target) {
   // If the element that was clicked was not a link, return early
-  if ($target.tagName !== 'A' || $target.href === false) {
+  if (!($target instanceof HTMLAnchorElement)) {
     return false
   }
 
-  var inputId = this.getFragmentFromUrl($target.href)
-  var $input = document.getElementById(inputId)
+  var inputId = this.getFragmentFromUrl($target.href);
+  if (!inputId) {
+    return false
+  }
+
+  var $input = document.getElementById(inputId);
   if (!$input) {
     return false
   }
 
-  var $legendOrLabel = this.getAssociatedLegendOrLabel($input)
+  var $legendOrLabel = this.getAssociatedLegendOrLabel($input);
   if (!$legendOrLabel) {
     return false
   }
@@ -125,11 +141,11 @@ ErrorSummary.prototype.focusTarget = function ($target) {
   // Scroll the legend or label into view *before* calling focus on the input to
   // avoid extra scrolling in browsers that don't support `preventScroll` (which
   // at time of writing is most of them...)
-  $legendOrLabel.scrollIntoView()
-  $input.focus({ preventScroll: true })
+  $legendOrLabel.scrollIntoView();
+  $input.focus({ preventScroll: true });
 
   return true
-}
+};
 
 /**
  * Get fragment from URL
@@ -137,16 +153,17 @@ ErrorSummary.prototype.focusTarget = function ($target) {
  * Extract the fragment (everything after the hash) from a URL, but not including
  * the hash.
  *
+ * @deprecated Will be made private in v5.0
  * @param {string} url - URL
- * @returns {string} Fragment from URL, without the hash
+ * @returns {string | undefined} Fragment from URL, without the hash
  */
 ErrorSummary.prototype.getFragmentFromUrl = function (url) {
   if (url.indexOf('#') === -1) {
-    return false
+    return undefined
   }
 
   return url.split('#').pop()
-}
+};
 
 /**
  * Get associated legend or label
@@ -159,22 +176,23 @@ ErrorSummary.prototype.getFragmentFromUrl = function (url) {
  * - The first `<label>` that is associated with the input using for="inputId"
  * - The closest parent `<label>`
  *
- * @param {HTMLElement} $input - The input
- * @returns {HTMLElement} Associated legend or label, or null if no associated
- *                        legend or label can be found
+ * @deprecated Will be made private in v5.0
+ * @param {Element} $input - The input
+ * @returns {Element | null} Associated legend or label, or null if no associated
+ *   legend or label can be found
  */
 ErrorSummary.prototype.getAssociatedLegendOrLabel = function ($input) {
-  var $fieldset = $input.closest('fieldset')
+  var $fieldset = $input.closest('fieldset');
 
   if ($fieldset) {
-    var $legends = $fieldset.getElementsByTagName('legend')
+    var $legends = $fieldset.getElementsByTagName('legend');
 
     if ($legends.length) {
-      var $candidateLegend = $legends[0]
+      var $candidateLegend = $legends[0];
 
       // If the input type is radio or checkbox, always use the legend if there
       // is one.
-      if ($input.type === 'checkbox' || $input.type === 'radio') {
+      if ($input instanceof HTMLInputElement && ($input.type === 'checkbox' || $input.type === 'radio')) {
         return $candidateLegend
       }
 
@@ -184,13 +202,13 @@ ErrorSummary.prototype.getAssociatedLegendOrLabel = function ($input) {
       //
       // This should avoid situations where the input either ends up off the
       // screen, or obscured by a software keyboard.
-      var legendTop = $candidateLegend.getBoundingClientRect().top
-      var inputRect = $input.getBoundingClientRect()
+      var legendTop = $candidateLegend.getBoundingClientRect().top;
+      var inputRect = $input.getBoundingClientRect();
 
       // If the browser doesn't support Element.getBoundingClientRect().height
       // or window.innerHeight (like IE8), bail and just link to the label.
       if (inputRect.height && window.innerHeight) {
-        var inputBottom = inputRect.top + inputRect.height
+        var inputBottom = inputRect.top + inputRect.height;
 
         if (inputBottom - legendTop < window.innerHeight / 2) {
           return $candidateLegend
@@ -201,14 +219,15 @@ ErrorSummary.prototype.getAssociatedLegendOrLabel = function ($input) {
 
   return document.querySelector("label[for='" + $input.getAttribute('id') + "']") ||
     $input.closest('label')
-}
-
-export default ErrorSummary
+};
 
 /**
  * Error summary config
  *
  * @typedef {object} ErrorSummaryConfig
- * @property {boolean} [disableAutoFocus = false] -
- *  If set to `true` the error summary will not be focussed when the page loads.
+ * @property {boolean} [disableAutoFocus = false] - If set to `true` the error
+ *   summary will not be focussed when the page loads.
  */
+
+export default ErrorSummary;
+//# sourceMappingURL=components/error-summary/error-summary.mjs.map

data/node_modules/govuk-frontend/govuk-esm/components/error-summary/error-summary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-summary.mjs","sources":["../../../../src/govuk/components/error-summary/error-summary.mjs"],"sourcesContent":["/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */\n\nimport { mergeConfigs } from '../../common/index.mjs'\nimport { normaliseDataset } from '../../common/normalise-dataset.mjs'\nimport '../../vendor/polyfills/Element/prototype/closest.mjs'\nimport '../../vendor/polyfills/Event.mjs' // addEventListener, event.target normalization and DOMContentLoaded\nimport '../../vendor/polyfills/Function/prototype/bind.mjs'\n\n/**\n * JavaScript enhancements for the ErrorSummary\n *\n * Takes focus on initialisation for accessible announcement, unless disabled in configuration.\n *\n * @class\n * @param {Element} $module - HTML element to use for error summary\n * @param {ErrorSummaryConfig} [config] - Error summary config\n */\nfunction ErrorSummary ($module, config) {\n  // Some consuming code may not be passing a module,\n  // for example if they initialise the component\n  // on their own by directly passing the result\n  // of `document.querySelector`.\n  // To avoid breaking further JavaScript initialisation\n  // we need to safeguard against this so things keep\n  // working the same now we read the elements data attributes\n  if (!($module instanceof HTMLElement)) {\n    // Little safety in case code gets ported as-is\n    // into and ES6 class constructor, where the return value matters\n    return this\n  }\n\n  /** @deprecated Will be made private in v5.0 */\n  this.$module = $module\n\n  var defaultConfig = {\n    disableAutoFocus: false\n  }\n\n  /**\n   * @deprecated Will be made private in v5.0\n   * @type {ErrorSummaryConfig}\n   */\n  this.config = mergeConfigs(\n    defaultConfig,\n    config || {},\n    normaliseDataset($module.dataset)\n  )\n}\n\n/**\n * Initialise component\n */\nErrorSummary.prototype.init = function () {\n  // Check that required elements are present\n  if (!this.$module) {\n    return\n  }\n\n  var $module = this.$module\n\n  this.setFocus()\n  $module.addEventListener('click', this.handleClick.bind(this))\n}\n\n/**\n * Focus the error summary\n *\n * @deprecated Will be made private in v5.0\n */\nErrorSummary.prototype.setFocus = function () {\n  var $module = this.$module\n\n  if (this.config.disableAutoFocus) {\n    return\n  }\n\n  // Set tabindex to -1 to make the element programmatically focusable, but\n  // remove it on blur as the error summary doesn't need to be focused again.\n  $module.setAttribute('tabindex', '-1')\n\n  $module.addEventListener('blur', function () {\n    $module.removeAttribute('tabindex')\n  })\n\n  $module.focus()\n}\n\n/**\n * Click event handler\n *\n * @deprecated Will be made private in v5.0\n * @param {MouseEvent} event - Click event\n */\nErrorSummary.prototype.handleClick = function (event) {\n  var $target = event.target\n  if (this.focusTarget($target)) {\n    event.preventDefault()\n  }\n}\n\n/**\n * Focus the target element\n *\n * By default, the browser will scroll the target into view. Because our labels\n * or legends appear above the input, this means the user will be presented with\n * an input without any context, as the label or legend will be off the top of\n * the screen.\n *\n * Manually handling the click event, scrolling the question into view and then\n * focussing the element solves this.\n *\n * This also results in the label and/or legend being announced correctly in\n * NVDA (as tested in 2018.3.2) - without this only the field type is announced\n * (e.g. \"Edit, has autocomplete\").\n *\n * @deprecated Will be made private in v5.0\n * @param {EventTarget} $target - Event target\n * @returns {boolean} True if the target was able to be focussed\n */\nErrorSummary.prototype.focusTarget = function ($target) {\n  // If the element that was clicked was not a link, return early\n  if (!($target instanceof HTMLAnchorElement)) {\n    return false\n  }\n\n  var inputId = this.getFragmentFromUrl($target.href)\n  if (!inputId) {\n    return false\n  }\n\n  var $input = document.getElementById(inputId)\n  if (!$input) {\n    return false\n  }\n\n  var $legendOrLabel = this.getAssociatedLegendOrLabel($input)\n  if (!$legendOrLabel) {\n    return false\n  }\n\n  // Scroll the legend or label into view *before* calling focus on the input to\n  // avoid extra scrolling in browsers that don't support `preventScroll` (which\n  // at time of writing is most of them...)\n  $legendOrLabel.scrollIntoView()\n  $input.focus({ preventScroll: true })\n\n  return true\n}\n\n/**\n * Get fragment from URL\n *\n * Extract the fragment (everything after the hash) from a URL, but not including\n * the hash.\n *\n * @deprecated Will be made private in v5.0\n * @param {string} url - URL\n * @returns {string | undefined} Fragment from URL, without the hash\n */\nErrorSummary.prototype.getFragmentFromUrl = function (url) {\n  if (url.indexOf('#') === -1) {\n    return undefined\n  }\n\n  return url.split('#').pop()\n}\n\n/**\n * Get associated legend or label\n *\n * Returns the first element that exists from this list:\n *\n * - The `<legend>` associated with the closest `<fieldset>` ancestor, as long\n *   as the top of it is no more than half a viewport height away from the\n *   bottom of the input\n * - The first `<label>` that is associated with the input using for=\"inputId\"\n * - The closest parent `<label>`\n *\n * @deprecated Will be made private in v5.0\n * @param {Element} $input - The input\n * @returns {Element | null} Associated legend or label, or null if no associated\n *   legend or label can be found\n */\nErrorSummary.prototype.getAssociatedLegendOrLabel = function ($input) {\n  var $fieldset = $input.closest('fieldset')\n\n  if ($fieldset) {\n    var $legends = $fieldset.getElementsByTagName('legend')\n\n    if ($legends.length) {\n      var $candidateLegend = $legends[0]\n\n      // If the input type is radio or checkbox, always use the legend if there\n      // is one.\n      if ($input instanceof HTMLInputElement && ($input.type === 'checkbox' || $input.type === 'radio')) {\n        return $candidateLegend\n      }\n\n      // For other input types, only scroll to the fieldset’s legend (instead of\n      // the label associated with the input) if the input would end up in the\n      // top half of the screen.\n      //\n      // This should avoid situations where the input either ends up off the\n      // screen, or obscured by a software keyboard.\n      var legendTop = $candidateLegend.getBoundingClientRect().top\n      var inputRect = $input.getBoundingClientRect()\n\n      // If the browser doesn't support Element.getBoundingClientRect().height\n      // or window.innerHeight (like IE8), bail and just link to the label.\n      if (inputRect.height && window.innerHeight) {\n        var inputBottom = inputRect.top + inputRect.height\n\n        if (inputBottom - legendTop < window.innerHeight / 2) {\n          return $candidateLegend\n        }\n      }\n    }\n  }\n\n  return document.querySelector(\"label[for='\" + $input.getAttribute('id') + \"']\") ||\n    $input.closest('label')\n}\n\nexport default ErrorSummary\n\n/**\n * Error summary config\n *\n * @typedef {object} ErrorSummaryConfig\n * @property {boolean} [disableAutoFocus = false] - If set to `true` the error\n *   summary will not be focussed when the page loads.\n */\n"],"names":[],"mappings":"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"}

data/node_modules/govuk-frontend/govuk-esm/components/header/header.mjs

@@ -1,31 +1,48 @@
-/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */
+import '../../vendor/polyfills/Event.mjs';
+import '../../vendor/polyfills/Function/prototype/bind.mjs';
 
-import '../../vendor/polyfills/Event.mjs'
-import '../../vendor/polyfills/Function/prototype/bind.mjs'
+/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */
 
 /**
  * Header component
  *
  * @class
- * @param {HTMLElement} $module - HTML element to use for header
+ * @param {Element} $module - HTML element to use for header
  */
 function Header ($module) {
-  this.$module = $module
-  this.$menuButton = $module && $module.querySelector('.govuk-js-header-toggle')
+  if (!($module instanceof HTMLElement)) {
+    return this
+  }
+
+  /** @deprecated Will be made private in v5.0 */
+  this.$module = $module;
+
+  /** @deprecated Will be made private in v5.0 */
+  this.$menuButton = $module.querySelector('.govuk-js-header-toggle');
+
+  /** @deprecated Will be made private in v5.0 */
   this.$menu = this.$menuButton && $module.querySelector(
     '#' + this.$menuButton.getAttribute('aria-controls')
-  )
+  );
 
-  // Save the opened/closed state for the nav in memory so that we can
-  // accurately maintain state when the screen is changed from small to
-  // big and back to small
-  this.menuIsOpen = false
+  /**
+   * Save the opened/closed state for the nav in memory so that we can
+   * accurately maintain state when the screen is changed from small to
+   * big and back to small
+   *
+   * @deprecated Will be made private in v5.0
+   */
+  this.menuIsOpen = false;
 
-  // A global const for storing a matchMedia instance which we'll use to
-  // detect when a screen size change happens. We set this later during the
-  // init function and rely on it being null if the feature isn't available
-  // to initially apply hidden attributes
-  this.mql = null
+  /**
+   * A global const for storing a matchMedia instance which we'll use to
+   * detect when a screen size change happens. We set this later during the
+   * init function and rely on it being null if the feature isn't available
+   * to initially apply hidden attributes
+   *
+   * @deprecated Will be made private in v5.0
+   */
+  this.mql = null;
 }
 
 /**
@@ -39,29 +56,31 @@ function Header ($module) {
  * version of the menu to the user.
  */
 Header.prototype.init = function () {
+  // Check that required elements are present
   if (!this.$module || !this.$menuButton || !this.$menu) {
     return
   }
 
   if ('matchMedia' in window) {
     // Set the matchMedia to the govuk-frontend desktop breakpoint
-    this.mql = window.matchMedia('(min-width: 48.0625em)')
+    this.mql = window.matchMedia('(min-width: 48.0625em)');
 
     if ('addEventListener' in this.mql) {
-      this.mql.addEventListener('change', this.syncState.bind(this))
+      this.mql.addEventListener('change', this.syncState.bind(this));
     } else {
       // addListener is a deprecated function, however addEventListener
-      // isn't supported by IE or Safari. We therefore add this in as
+      // isn't supported by IE or Safari < 14. We therefore add this in as
       // a fallback for those browsers
-      this.mql.addListener(this.syncState.bind(this))
+      // @ts-expect-error Property 'addListener' does not exist
+      this.mql.addListener(this.syncState.bind(this));
     }
 
-    this.syncState()
-    this.$menuButton.addEventListener('click', this.handleMenuButtonClick.bind(this))
+    this.syncState();
+    this.$menuButton.addEventListener('click', this.handleMenuButtonClick.bind(this));
   } else {
-    this.$menuButton.setAttribute('hidden', '')
+    this.$menuButton.setAttribute('hidden', '');
   }
-}
+};
 
 /**
  * Sync menu state
@@ -70,32 +89,37 @@ Header.prototype.init = function () {
  * visual states of the menu and the menu button.
  * Additionally will force the menu to be visible and the menu button to be
  * hidden if the matchMedia is triggered to desktop.
+ *
+ * @deprecated Will be made private in v5.0
  */
 Header.prototype.syncState = function () {
   if (this.mql.matches) {
-    this.$menu.removeAttribute('hidden')
-    this.$menuButton.setAttribute('hidden', '')
+    this.$menu.removeAttribute('hidden');
+    this.$menuButton.setAttribute('hidden', '');
   } else {
-    this.$menuButton.removeAttribute('hidden')
-    this.$menuButton.setAttribute('aria-expanded', this.menuIsOpen)
+    this.$menuButton.removeAttribute('hidden');
+    this.$menuButton.setAttribute('aria-expanded', this.menuIsOpen.toString());
 
     if (this.menuIsOpen) {
-      this.$menu.removeAttribute('hidden')
+      this.$menu.removeAttribute('hidden');
     } else {
-      this.$menu.setAttribute('hidden', '')
+      this.$menu.setAttribute('hidden', '');
     }
   }
-}
+};
 
 /**
  * Handle menu button click
  *
  * When the menu button is clicked, change the visibility of the menu and then
  * sync the accessibility state and menu button state
+ *
+ * @deprecated Will be made private in v5.0
  */
 Header.prototype.handleMenuButtonClick = function () {
-  this.menuIsOpen = !this.menuIsOpen
-  this.syncState()
-}
+  this.menuIsOpen = !this.menuIsOpen;
+  this.syncState();
+};
 
-export default Header
+export default Header;
+//# sourceMappingURL=components/header/header.mjs.map

data/node_modules/govuk-frontend/govuk-esm/components/header/header.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.mjs","sources":["../../../../src/govuk/components/header/header.mjs"],"sourcesContent":["/* eslint-disable es-x/no-function-prototype-bind -- Polyfill imported */\n\nimport '../../vendor/polyfills/Event.mjs'\nimport '../../vendor/polyfills/Function/prototype/bind.mjs'\n\n/**\n * Header component\n *\n * @class\n * @param {Element} $module - HTML element to use for header\n */\nfunction Header ($module) {\n  if (!($module instanceof HTMLElement)) {\n    return this\n  }\n\n  /** @deprecated Will be made private in v5.0 */\n  this.$module = $module\n\n  /** @deprecated Will be made private in v5.0 */\n  this.$menuButton = $module.querySelector('.govuk-js-header-toggle')\n\n  /** @deprecated Will be made private in v5.0 */\n  this.$menu = this.$menuButton && $module.querySelector(\n    '#' + this.$menuButton.getAttribute('aria-controls')\n  )\n\n  /**\n   * Save the opened/closed state for the nav in memory so that we can\n   * accurately maintain state when the screen is changed from small to\n   * big and back to small\n   *\n   * @deprecated Will be made private in v5.0\n   */\n  this.menuIsOpen = false\n\n  /**\n   * A global const for storing a matchMedia instance which we'll use to\n   * detect when a screen size change happens. We set this later during the\n   * init function and rely on it being null if the feature isn't available\n   * to initially apply hidden attributes\n   *\n   * @deprecated Will be made private in v5.0\n   */\n  this.mql = null\n}\n\n/**\n * Initialise component\n *\n * Check for the presence of the header, menu and menu button – if any are\n * missing then there's nothing to do so return early.\n * Feature sniff for and apply a matchMedia for desktop which will\n * trigger a state sync if the browser viewport moves between states. If\n * matchMedia isn't available, hide the menu button and present the \"no js\"\n * version of the menu to the user.\n */\nHeader.prototype.init = function () {\n  // Check that required elements are present\n  if (!this.$module || !this.$menuButton || !this.$menu) {\n    return\n  }\n\n  if ('matchMedia' in window) {\n    // Set the matchMedia to the govuk-frontend desktop breakpoint\n    this.mql = window.matchMedia('(min-width: 48.0625em)')\n\n    if ('addEventListener' in this.mql) {\n      this.mql.addEventListener('change', this.syncState.bind(this))\n    } else {\n      // addListener is a deprecated function, however addEventListener\n      // isn't supported by IE or Safari < 14. We therefore add this in as\n      // a fallback for those browsers\n      // @ts-expect-error Property 'addListener' does not exist\n      this.mql.addListener(this.syncState.bind(this))\n    }\n\n    this.syncState()\n    this.$menuButton.addEventListener('click', this.handleMenuButtonClick.bind(this))\n  } else {\n    this.$menuButton.setAttribute('hidden', '')\n  }\n}\n\n/**\n * Sync menu state\n *\n * Uses the global variable menuIsOpen to correctly set the accessible and\n * visual states of the menu and the menu button.\n * Additionally will force the menu to be visible and the menu button to be\n * hidden if the matchMedia is triggered to desktop.\n *\n * @deprecated Will be made private in v5.0\n */\nHeader.prototype.syncState = function () {\n  if (this.mql.matches) {\n    this.$menu.removeAttribute('hidden')\n    this.$menuButton.setAttribute('hidden', '')\n  } else {\n    this.$menuButton.removeAttribute('hidden')\n    this.$menuButton.setAttribute('aria-expanded', this.menuIsOpen.toString())\n\n    if (this.menuIsOpen) {\n      this.$menu.removeAttribute('hidden')\n    } else {\n      this.$menu.setAttribute('hidden', '')\n    }\n  }\n}\n\n/**\n * Handle menu button click\n *\n * When the menu button is clicked, change the visibility of the menu and then\n * sync the accessibility state and menu button state\n *\n * @deprecated Will be made private in v5.0\n */\nHeader.prototype.handleMenuButtonClick = function () {\n  this.menuIsOpen = !this.menuIsOpen\n  this.syncState()\n}\n\nexport default Header\n"],"names":[],"mappings":";;;AAAA;AACA,AAGA;;;;;;;AAOA,SAAS,MAAM,EAAE,OAAO,EAAE;EACxB,IAAI,EAAE,OAAO,YAAY,WAAW,CAAC,EAAE;IACrC,OAAO,IAAI;GACZ;;;EAGD,IAAI,CAAC,OAAO,GAAG,QAAO;;;EAGtB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,yBAAyB,EAAC;;;EAGnE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,aAAa;IACpD,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,eAAe,CAAC;IACrD;;;;;;;;;EASD,IAAI,CAAC,UAAU,GAAG,MAAK;;;;;;;;;;EAUvB,IAAI,CAAC,GAAG,GAAG,KAAI;CAChB;;;;;;;;;;;;AAYD,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,YAAY;;EAElC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;IACrD,MAAM;GACP;;EAED,IAAI,YAAY,IAAI,MAAM,EAAE;;IAE1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,wBAAwB,EAAC;;IAEtD,IAAI,kBAAkB,IAAI,IAAI,CAAC,GAAG,EAAE;MAClC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC;KAC/D,MAAM;;;;;MAKL,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC;KAChD;;IAED,IAAI,CAAC,SAAS,GAAE;IAChB,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAC;GAClF,MAAM;IACL,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAC;GAC5C;EACF;;;;;;;;;;;;AAYD,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,YAAY;EACvC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE;IACpB,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAC;IACpC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAC;GAC5C,MAAM;IACL,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,QAAQ,EAAC;IAC1C,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAC;;IAE1E,IAAI,IAAI,CAAC,UAAU,EAAE;MACnB,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAC;KACrC,MAAM;MACL,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAC;KACtC;GACF;EACF;;;;;;;;;;AAUD,MAAM,CAAC,SAAS,CAAC,qBAAqB,GAAG,YAAY;EACnD,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,WAAU;EAClC,IAAI,CAAC,SAAS,GAAE;CACjB;;;;"}

data/node_modules/govuk-frontend/govuk-esm/components/notification-banner/notification-banner.mjs

@@ -1,39 +1,48 @@
-import { mergeConfigs } from '../../common/index.mjs'
-import { normaliseDataset } from '../../common/normalise-dataset.mjs'
-import '../../vendor/polyfills/Event.mjs' // addEventListener, event.target normalization and DOMContentLoaded
+import { mergeConfigs } from '../../common/index.mjs';
+import { normaliseDataset } from '../../common/normalise-dataset.mjs';
+import '../../vendor/polyfills/Event.mjs';
 
 /**
  * Notification Banner component
  *
  * @class
- * @param {HTMLElement} $module - HTML element to use for notification banner
+ * @param {Element} $module - HTML element to use for notification banner
  * @param {NotificationBannerConfig} [config] - Notification banner config
  */
 function NotificationBanner ($module, config) {
-  this.$module = $module
+  if (!($module instanceof HTMLElement)) {
+    return this
+  }
+
+  /** @deprecated Will be made private in v5.0 */
+  this.$module = $module;
 
   var defaultConfig = {
     disableAutoFocus: false
-  }
+  };
+
+  /**
+   * @deprecated Will be made private in v5.0
+   * @type {NotificationBannerConfig}
+   */
   this.config = mergeConfigs(
     defaultConfig,
     config || {},
     normaliseDataset($module.dataset)
-  )
+  );
 }
 
 /**
  * Initialise component
  */
 NotificationBanner.prototype.init = function () {
-  var $module = this.$module
-  // Check for module
-  if (!$module) {
+  // Check that required elements are present
+  if (!this.$module) {
     return
   }
 
-  this.setFocus()
-}
+  this.setFocus();
+};
 
 /**
  * Focus the element
@@ -44,9 +53,11 @@ NotificationBanner.prototype.init = function () {
  * You can turn off the auto-focus functionality by setting `data-disable-auto-focus="true"` in the
  * component HTML. You might wish to do this based on user research findings, or to avoid a clash
  * with another element which should be focused when the page loads.
+ *
+ * @deprecated Will be made private in v5.0
  */
 NotificationBanner.prototype.setFocus = function () {
-  var $module = this.$module
+  var $module = this.$module;
 
   if (this.config.disableAutoFocus) {
     return
@@ -60,25 +71,25 @@ NotificationBanner.prototype.setFocus = function () {
   // Remove the tabindex on blur as the component doesn't need to be focusable after the page has
   // loaded.
   if (!$module.getAttribute('tabindex')) {
-    $module.setAttribute('tabindex', '-1')
+    $module.setAttribute('tabindex', '-1');
 
     $module.addEventListener('blur', function () {
-      $module.removeAttribute('tabindex')
-    })
+      $module.removeAttribute('tabindex');
+    });
   }
 
-  $module.focus()
-}
-
-export default NotificationBanner
+  $module.focus();
+};
 
 /**
  * Notification banner config
  *
  * @typedef {object} NotificationBannerConfig
- * @property {boolean} [disableAutoFocus = false] -
- *   If set to `true` the notification banner will not be focussed when the page
- *   loads. This only applies if the component has a `role` of `alert` – in
- *   other cases the component will not be focused on page load, regardless of
- *   this option.
+ * @property {boolean} [disableAutoFocus = false] - If set to `true` the
+ *   notification banner will not be focussed when the page loads. This only
+ *   applies if the component has a `role` of `alert` – in other cases the
+ *   component will not be focused on page load, regardless of this option.
  */
+
+export default NotificationBanner;
+//# sourceMappingURL=components/notification-banner/notification-banner.mjs.map

data/node_modules/govuk-frontend/govuk-esm/components/notification-banner/notification-banner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-banner.mjs","sources":["../../../../src/govuk/components/notification-banner/notification-banner.mjs"],"sourcesContent":["import { mergeConfigs } from '../../common/index.mjs'\nimport { normaliseDataset } from '../../common/normalise-dataset.mjs'\nimport '../../vendor/polyfills/Event.mjs' // addEventListener, event.target normalization and DOMContentLoaded\n\n/**\n * Notification Banner component\n *\n * @class\n * @param {Element} $module - HTML element to use for notification banner\n * @param {NotificationBannerConfig} [config] - Notification banner config\n */\nfunction NotificationBanner ($module, config) {\n  if (!($module instanceof HTMLElement)) {\n    return this\n  }\n\n  /** @deprecated Will be made private in v5.0 */\n  this.$module = $module\n\n  var defaultConfig = {\n    disableAutoFocus: false\n  }\n\n  /**\n   * @deprecated Will be made private in v5.0\n   * @type {NotificationBannerConfig}\n   */\n  this.config = mergeConfigs(\n    defaultConfig,\n    config || {},\n    normaliseDataset($module.dataset)\n  )\n}\n\n/**\n * Initialise component\n */\nNotificationBanner.prototype.init = function () {\n  // Check that required elements are present\n  if (!this.$module) {\n    return\n  }\n\n  this.setFocus()\n}\n\n/**\n * Focus the element\n *\n * If `role=\"alert\"` is set, focus the element to help some assistive technologies\n * prioritise announcing it.\n *\n * You can turn off the auto-focus functionality by setting `data-disable-auto-focus=\"true\"` in the\n * component HTML. You might wish to do this based on user research findings, or to avoid a clash\n * with another element which should be focused when the page loads.\n *\n * @deprecated Will be made private in v5.0\n */\nNotificationBanner.prototype.setFocus = function () {\n  var $module = this.$module\n\n  if (this.config.disableAutoFocus) {\n    return\n  }\n\n  if ($module.getAttribute('role') !== 'alert') {\n    return\n  }\n\n  // Set tabindex to -1 to make the element focusable with JavaScript.\n  // Remove the tabindex on blur as the component doesn't need to be focusable after the page has\n  // loaded.\n  if (!$module.getAttribute('tabindex')) {\n    $module.setAttribute('tabindex', '-1')\n\n    $module.addEventListener('blur', function () {\n      $module.removeAttribute('tabindex')\n    })\n  }\n\n  $module.focus()\n}\n\nexport default NotificationBanner\n\n/**\n * Notification banner config\n *\n * @typedef {object} NotificationBannerConfig\n * @property {boolean} [disableAutoFocus = false] - If set to `true` the\n *   notification banner will not be focussed when the page loads. This only\n *   applies if the component has a `role` of `alert` – in other cases the\n *   component will not be focused on page load, regardless of this option.\n */\n"],"names":[],"mappings":";;;;AAIA;;;;;;;AAOA,SAAS,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE;EAC5C,IAAI,EAAE,OAAO,YAAY,WAAW,CAAC,EAAE;IACrC,OAAO,IAAI;GACZ;;;EAGD,IAAI,CAAC,OAAO,GAAG,QAAO;;EAEtB,IAAI,aAAa,GAAG;IAClB,gBAAgB,EAAE,KAAK;IACxB;;;;;;EAMD,IAAI,CAAC,MAAM,GAAG,YAAY;IACxB,aAAa;IACb,MAAM,IAAI,EAAE;IACZ,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;IAClC;CACF;;;;;AAKD,kBAAkB,CAAC,SAAS,CAAC,IAAI,GAAG,YAAY;;EAE9C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;IACjB,MAAM;GACP;;EAED,IAAI,CAAC,QAAQ,GAAE;EAChB;;;;;;;;;;;;;;AAcD,kBAAkB,CAAC,SAAS,CAAC,QAAQ,GAAG,YAAY;EAClD,IAAI,OAAO,GAAG,IAAI,CAAC,QAAO;;EAE1B,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;IAChC,MAAM;GACP;;EAED,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE;IAC5C,MAAM;GACP;;;;;EAKD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE;IACrC,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,EAAC;;IAEtC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,YAAY;MAC3C,OAAO,CAAC,eAAe,CAAC,UAAU,EAAC;KACpC,EAAC;GACH;;EAED,OAAO,CAAC,KAAK,GAAE;EAChB;AACD,AAEA;;;;;;;;;GASG;;;;"}