govuk_tech_docs 5.2.1 → 6.0.0.beta

data/node_modules/govuk-frontend/dist/govuk/all.bundle.mjs

@@ -1,11 +1,5 @@
-const version = '5.11.0';
+const version = '6.0.0';
 
-function getFragmentFromUrl(url) {
-  if (!url.includes('#')) {
-    return undefined;
-  }
-  return url.split('#').pop();
-}
 function getBreakpoint(name) {
   const property = `--govuk-breakpoint-${name}`;
   const value = window.getComputedStyle(document.documentElement).getPropertyValue(property);
@@ -63,6 +57,9 @@ function isArray(option) {
 function isObject(option) {
   return !!option && typeof option === 'object' && !isArray(option);
 }
+function isScope($scope) {
+  return !!$scope && ($scope instanceof Element || $scope instanceof Document);
+}
 function formatErrorMessage(Component, message) {
   return `${Component.moduleName}: ${message}`;
 }
@@ -70,9 +67,6 @@ function formatErrorMessage(Component, message) {
  * @typedef ComponentWithModuleName
  * @property {string} moduleName - Name of the component
  */
-/**
- * @import { ObjectNested } from './configuration.mjs'
- */
 
 class GOVUKFrontendError extends Error {
   constructor(...args) {
@@ -101,7 +95,7 @@ class ConfigError extends GOVUKFrontendError {
 class ElementError extends GOVUKFrontendError {
   constructor(messageOrOptions) {
     let message = typeof messageOrOptions === 'string' ? messageOrOptions : '';
-    if (typeof messageOrOptions === 'object') {
+    if (isObject(messageOrOptions)) {
       const {
         component,
         identifier,
@@ -110,7 +104,9 @@ class ElementError extends GOVUKFrontendError {
       } = messageOrOptions;
       message = identifier;
       message += element ? ` is not of type ${expectedType != null ? expectedType : 'HTMLElement'}` : ' not found';
-      message = formatErrorMessage(component, message);
+      if (component) {
+        message = formatErrorMessage(component, message);
+      }
     }
     super(message);
     this.name = 'ElementError';
@@ -250,6 +246,30 @@ function normaliseDataset(Component, dataset) {
   }
   return out;
 }
+function normaliseOptions(scopeOrOptions) {
+  let $scope = document;
+  let onError;
+  if (isObject(scopeOrOptions)) {
+    const options = scopeOrOptions;
+    if (isScope(options.scope) || options.scope === null) {
+      $scope = options.scope;
+    }
+    if (typeof options.onError === 'function') {
+      onError = options.onError;
+    }
+  }
+  if (isScope(scopeOrOptions)) {
+    $scope = scopeOrOptions;
+  } else if (scopeOrOptions === null) {
+    $scope = null;
+  } else if (typeof scopeOrOptions === 'function') {
+    onError = scopeOrOptions;
+  }
+  return {
+    scope: $scope,
+    onError
+  };
+}
 function mergeConfigs(...configObjects) {
   const formattedConfigObject = {};
   for (const configObject of configObjects) {
@@ -344,6 +364,9 @@ function extractConfigByNamespace(schema, dataset, namespace) {
  * @template {Partial<Record<keyof ConfigurationType, unknown>>} [ConfigurationType=ObjectNested]
  * @typedef {typeof Component & ChildClass<ConfigurationType>} ChildClassConstructor<ConfigurationType>
  */
+/**
+ * @import { CompatibleClass, Config, CreateAllOptions, OnErrorCallback } from '../init.mjs'
+ */
 
 class I18n {
   constructor(translations = {}, config = {}) {
@@ -358,7 +381,7 @@ class I18n {
       throw new Error('i18n: lookup key missing');
     }
     let translation = this.translations[lookupKey];
-    if (typeof (options == null ? void 0 : options.count) === 'number' && typeof translation === 'object') {
+    if (typeof (options == null ? void 0 : options.count) === 'number' && isObject(translation)) {
       const translationPluralForm = translation[this.getPluralSuffix(lookupKey, options.count)];
       if (translationPluralForm) {
         translation = translationPluralForm;
@@ -400,8 +423,8 @@ class I18n {
       return 'other';
     }
     const translation = this.translations[lookupKey];
-    const preferredForm = this.hasIntlPluralRulesSupport() ? new Intl.PluralRules(this.locale).select(count) : this.selectPluralFormUsingFallbackRules(count);
-    if (typeof translation === 'object') {
+    const preferredForm = this.hasIntlPluralRulesSupport() ? new Intl.PluralRules(this.locale).select(count) : 'other';
+    if (isObject(translation)) {
       if (preferredForm in translation) {
         return preferredForm;
       } else if ('other' in translation) {
@@ -411,132 +434,7 @@ class I18n {
     }
     throw new Error(`i18n: Plural form ".other" is required for "${this.locale}" locale`);
   }
-  selectPluralFormUsingFallbackRules(count) {
-    count = Math.abs(Math.floor(count));
-    const ruleset = this.getPluralRulesForLocale();
-    if (ruleset) {
-      return I18n.pluralRules[ruleset](count);
-    }
-    return 'other';
-  }
-  getPluralRulesForLocale() {
-    const localeShort = this.locale.split('-')[0];
-    for (const pluralRule in I18n.pluralRulesMap) {
-      const languages = I18n.pluralRulesMap[pluralRule];
-      if (languages.includes(this.locale) || languages.includes(localeShort)) {
-        return pluralRule;
-      }
-    }
-  }
 }
-I18n.pluralRulesMap = {
-  arabic: ['ar'],
-  chinese: ['my', 'zh', 'id', 'ja', 'jv', 'ko', 'ms', 'th', 'vi'],
-  french: ['hy', 'bn', 'fr', 'gu', 'hi', 'fa', 'pa', 'zu'],
-  german: ['af', 'sq', 'az', 'eu', 'bg', 'ca', 'da', 'nl', 'en', 'et', 'fi', 'ka', 'de', 'el', 'hu', 'lb', 'no', 'so', 'sw', 'sv', 'ta', 'te', 'tr', 'ur'],
-  irish: ['ga'],
-  russian: ['ru', 'uk'],
-  scottish: ['gd'],
-  spanish: ['pt-PT', 'it', 'es'],
-  welsh: ['cy']
-};
-I18n.pluralRules = {
-  arabic(n) {
-    if (n === 0) {
-      return 'zero';
-    }
-    if (n === 1) {
-      return 'one';
-    }
-    if (n === 2) {
-      return 'two';
-    }
-    if (n % 100 >= 3 && n % 100 <= 10) {
-      return 'few';
-    }
-    if (n % 100 >= 11 && n % 100 <= 99) {
-      return 'many';
-    }
-    return 'other';
-  },
-  chinese() {
-    return 'other';
-  },
-  french(n) {
-    return n === 0 || n === 1 ? 'one' : 'other';
-  },
-  german(n) {
-    return n === 1 ? 'one' : 'other';
-  },
-  irish(n) {
-    if (n === 1) {
-      return 'one';
-    }
-    if (n === 2) {
-      return 'two';
-    }
-    if (n >= 3 && n <= 6) {
-      return 'few';
-    }
-    if (n >= 7 && n <= 10) {
-      return 'many';
-    }
-    return 'other';
-  },
-  russian(n) {
-    const lastTwo = n % 100;
-    const last = lastTwo % 10;
-    if (last === 1 && lastTwo !== 11) {
-      return 'one';
-    }
-    if (last >= 2 && last <= 4 && !(lastTwo >= 12 && lastTwo <= 14)) {
-      return 'few';
-    }
-    if (last === 0 || last >= 5 && last <= 9 || lastTwo >= 11 && lastTwo <= 14) {
-      return 'many';
-    }
-    return 'other';
-  },
-  scottish(n) {
-    if (n === 1 || n === 11) {
-      return 'one';
-    }
-    if (n === 2 || n === 12) {
-      return 'two';
-    }
-    if (n >= 3 && n <= 10 || n >= 13 && n <= 19) {
-      return 'few';
-    }
-    return 'other';
-  },
-  spanish(n) {
-    if (n === 1) {
-      return 'one';
-    }
-    if (n % 1000000 === 0 && n !== 0) {
-      return 'many';
-    }
-    return 'other';
-  },
-  welsh(n) {
-    if (n === 0) {
-      return 'zero';
-    }
-    if (n === 1) {
-      return 'one';
-    }
-    if (n === 2) {
-      return 'two';
-    }
-    if (n === 3) {
-      return 'few';
-    }
-    if (n === 6) {
-      return 'many';
-    }
-    return 'other';
-  }
-};
 
 /**
  * Accordion component
@@ -737,11 +635,11 @@ class Accordion extends ConfigurableComponent {
     const ariaLabelParts = [];
     const $headingText = $section.querySelector(`.${this.sectionHeadingTextClass}`);
     if ($headingText) {
-      ariaLabelParts.push(`${$headingText.textContent}`.trim());
+      ariaLabelParts.push($headingText.textContent.trim());
     }
     const $summary = $section.querySelector(`.${this.sectionSummaryClass}`);
     if ($summary) {
-      ariaLabelParts.push(`${$summary.textContent}`.trim());
+      ariaLabelParts.push($summary.textContent.trim());
     }
     const ariaLabelMessage = expanded ? this.i18n.t('hideSectionAriaLabel') : this.i18n.t('showSectionAriaLabel');
     ariaLabelParts.push(ariaLabelMessage);
@@ -794,7 +692,7 @@ class Accordion extends ConfigurableComponent {
     if (id) {
       try {
         window.sessionStorage.setItem(id, isExpanded.toString());
-      } catch (exception) {}
+      } catch (_unused) {}
     }
   }
   setInitialState($section) {
@@ -808,7 +706,7 @@ class Accordion extends ConfigurableComponent {
         if (state !== null) {
           this.setExpanded(state === 'true', $section);
         }
-      } catch (exception) {}
+      } catch (_unused2) {}
     }
   }
   getButtonPunctuationEl() {
@@ -982,6 +880,7 @@ class CharacterCount extends ConfigurableComponent {
     var _ref, _this$config$maxwords;
     super($root, config);
     this.$textarea = void 0;
+    this.count = 0;
     this.$visibleCountMessage = void 0;
     this.$screenReaderCountMessage = void 0;
     this.lastInputTimestamp = null;
@@ -1017,7 +916,7 @@ class CharacterCount extends ConfigurableComponent {
       });
     }
     this.$errorMessage = this.$root.querySelector('.govuk-error-message');
-    if (`${$textareaDescription.textContent}`.match(/^\s*$/)) {
+    if ($textareaDescription.textContent.match(/^\s*$/)) {
       $textareaDescription.textContent = this.i18n.t('textareaDescription', {
         count: this.maxLength
       });
@@ -1037,15 +936,22 @@ class CharacterCount extends ConfigurableComponent {
     $textareaDescription.classList.add('govuk-visually-hidden');
     this.$textarea.removeAttribute('maxlength');
     this.bindChangeEvents();
-    window.addEventListener('pageshow', () => this.updateCountMessage());
+    window.addEventListener('pageshow', () => {
+      if (this.$textarea.value !== this.$textarea.textContent) {
+        this.updateCount();
+        this.updateCountMessage();
+      }
+    });
+    this.updateCount();
     this.updateCountMessage();
   }
   bindChangeEvents() {
-    this.$textarea.addEventListener('keyup', () => this.handleKeyUp());
+    this.$textarea.addEventListener('input', () => this.handleInput());
     this.$textarea.addEventListener('focus', () => this.handleFocus());
     this.$textarea.addEventListener('blur', () => this.handleBlur());
   }
-  handleKeyUp() {
+  handleInput() {
+    this.updateCount();
     this.updateVisibleCountMessage();
     this.lastInputTimestamp = Date.now();
   }
@@ -1072,7 +978,7 @@ class CharacterCount extends ConfigurableComponent {
     this.updateScreenReaderCountMessage();
   }
   updateVisibleCountMessage() {
-    const remainingNumber = this.maxLength - this.count(this.$textarea.value);
+    const remainingNumber = this.maxLength - this.count;
     const isError = remainingNumber < 0;
     this.$visibleCountMessage.classList.toggle('govuk-character-count__message--disabled', !this.isOverThreshold());
     if (!this.$errorMessage) {
@@ -1090,16 +996,18 @@ class CharacterCount extends ConfigurableComponent {
     }
     this.$screenReaderCountMessage.textContent = this.getCountMessage();
   }
-  count(text) {
+  updateCount() {
+    const text = this.$textarea.value;
     if (this.config.maxwords) {
       var _text$match;
       const tokens = (_text$match = text.match(/\S+/g)) != null ? _text$match : [];
-      return tokens.length;
+      this.count = tokens.length;
+      return;
     }
-    return text.length;
+    this.count = text.length;
   }
   getCountMessage() {
-    const remainingNumber = this.maxLength - this.count(this.$textarea.value);
+    const remainingNumber = this.maxLength - this.count;
     const countType = this.config.maxwords ? 'words' : 'characters';
     return this.formatCountMessage(remainingNumber, countType);
   }
@@ -1116,7 +1024,7 @@ class CharacterCount extends ConfigurableComponent {
     if (!this.config.threshold) {
       return true;
     }
-    const currentLength = this.count(this.$textarea.value);
+    const currentLength = this.count;
     const maxLength = this.maxLength;
     const thresholdValue = maxLength * this.config.threshold / 100;
     return thresholdValue <= currentLength;
@@ -1377,7 +1285,7 @@ class ErrorSummary extends ConfigurableComponent {
     if (!($target instanceof HTMLAnchorElement)) {
       return false;
     }
-    const inputId = getFragmentFromUrl($target.href);
+    const inputId = $target.hash.replace('#', '');
     if (!inputId) {
       return false;
     }
@@ -1690,7 +1598,6 @@ class FileUpload extends ConfigurableComponent {
       throw new ElementError(formatErrorMessage(FileUpload, 'File input (`<input type="file">`) attribute (`type`) is not `file`'));
     }
     this.$input = $input;
-    this.$input.setAttribute('hidden', 'true');
     if (!this.$input.id) {
       throw new ElementError({
         component: FileUpload,
@@ -1706,6 +1613,7 @@ class FileUpload extends ConfigurableComponent {
       $label.id = `${this.id}-label`;
     }
     this.$input.id = `${this.id}-input`;
+    this.$input.setAttribute('hidden', 'true');
     const $button = document.createElement('button');
     $button.classList.add('govuk-file-upload-button');
     $button.type = 'button';
@@ -1772,7 +1680,7 @@ class FileUpload extends ConfigurableComponent {
     if (this.$button.disabled) return;
     if (event.target instanceof Node) {
       if (this.$root.contains(event.target)) {
-        if (event.dataTransfer && isContainingFiles(event.dataTransfer)) {
+        if (event.dataTransfer && this.canDrop(event.dataTransfer)) {
           if (!this.$button.classList.contains('govuk-file-upload-button--dragging')) {
             this.showDraggingState();
             this.$announcements.innerText = this.i18n.t('enteredDropZone');
@@ -1794,12 +1702,30 @@ class FileUpload extends ConfigurableComponent {
   }
   onDrop(event) {
     event.preventDefault();
-    if (event.dataTransfer && isContainingFiles(event.dataTransfer)) {
+    if (event.dataTransfer && this.canFillInput(event.dataTransfer)) {
       this.$input.files = event.dataTransfer.files;
       this.$input.dispatchEvent(new CustomEvent('change'));
       this.hideDraggingState();
     }
   }
+  canFillInput(dataTransfer) {
+    return this.matchesInputCapacity(dataTransfer.files.length);
+  }
+  canDrop(dataTransfer) {
+    if (dataTransfer.items.length) {
+      return this.matchesInputCapacity(countFileItems(dataTransfer.items));
+    }
+    if (dataTransfer.types.length) {
+      return dataTransfer.types.includes('Files');
+    }
+    return true;
+  }
+  matchesInputCapacity(numberOfFiles) {
+    if (this.$input.multiple) {
+      return numberOfFiles > 0;
+    }
+    return numberOfFiles === 1;
+  }
   onChange() {
     const fileCount = this.$input.files.length;
     if (fileCount === 0) {
@@ -1846,6 +1772,13 @@ class FileUpload extends ConfigurableComponent {
     this.$root.classList.toggle('govuk-drop-zone--disabled', this.$button.disabled);
   }
 }
+
+/**
+ * Counts the number of `DataTransferItem` whose kind is `file`
+ *
+ * @param {DataTransferItemList} list - The list
+ * @returns {number} - The number of items whose kind is `file` in the list
+ */
 FileUpload.moduleName = 'govuk-file-upload';
 FileUpload.defaults = Object.freeze({
   i18n: {
@@ -1867,10 +1800,14 @@ FileUpload.schema = Object.freeze({
     }
   }
 });
-function isContainingFiles(dataTransfer) {
-  const hasNoTypesInfo = dataTransfer.types.length === 0;
-  const isDraggingFiles = dataTransfer.types.some(type => type === 'Files');
-  return hasNoTypesInfo || isDraggingFiles;
+function countFileItems(list) {
+  let result = 0;
+  for (let i = 0; i < list.length; i++) {
+    if (list[i].kind === 'file') {
+      result++;
+    }
+  }
+  return result;
 }
 
 /**
@@ -1908,89 +1845,6 @@ function isContainingFiles(dataTransfer) {
  * @import { TranslationPluralForms } from '../../i18n.mjs'
  */
 
-/**
- * Header component
- *
- * @preserve
- */
-class Header extends Component {
-  /**
-   * Apply a matchMedia for desktop which will trigger a state sync if the
-   * browser viewport moves between states.
-   *
-   * @param {Element | null} $root - HTML element to use for header
-   */
-  constructor($root) {
-    super($root);
-    this.$menuButton = void 0;
-    this.$menu = void 0;
-    this.menuIsOpen = false;
-    this.mql = null;
-    const $menuButton = this.$root.querySelector('.govuk-js-header-toggle');
-    if (!$menuButton) {
-      return this;
-    }
-    this.$root.classList.add('govuk-header--with-js-navigation');
-    const menuId = $menuButton.getAttribute('aria-controls');
-    if (!menuId) {
-      throw new ElementError({
-        component: Header,
-        identifier: 'Navigation button (`<button class="govuk-js-header-toggle">`) attribute (`aria-controls`)'
-      });
-    }
-    const $menu = document.getElementById(menuId);
-    if (!$menu) {
-      throw new ElementError({
-        component: Header,
-        element: $menu,
-        identifier: `Navigation (\`<ul id="${menuId}">\`)`
-      });
-    }
-    this.$menu = $menu;
-    this.$menuButton = $menuButton;
-    this.setupResponsiveChecks();
-    this.$menuButton.addEventListener('click', () => this.handleMenuButtonClick());
-  }
-  setupResponsiveChecks() {
-    const breakpoint = getBreakpoint('desktop');
-    if (!breakpoint.value) {
-      throw new ElementError({
-        component: Header,
-        identifier: `CSS custom property (\`${breakpoint.property}\`) on pseudo-class \`:root\``
-      });
-    }
-    this.mql = window.matchMedia(`(min-width: ${breakpoint.value})`);
-    if ('addEventListener' in this.mql) {
-      this.mql.addEventListener('change', () => this.checkMode());
-    } else {
-      this.mql.addListener(() => this.checkMode());
-    }
-    this.checkMode();
-  }
-  checkMode() {
-    if (!this.mql || !this.$menu || !this.$menuButton) {
-      return;
-    }
-    if (this.mql.matches) {
-      this.$menu.removeAttribute('hidden');
-      this.$menuButton.setAttribute('hidden', '');
-    } else {
-      this.$menuButton.removeAttribute('hidden');
-      this.$menuButton.setAttribute('aria-expanded', this.menuIsOpen.toString());
-      if (this.menuIsOpen) {
-        this.$menu.removeAttribute('hidden');
-      } else {
-        this.$menu.setAttribute('hidden', '');
-      }
-    }
-  }
-  handleMenuButtonClick() {
-    this.menuIsOpen = !this.menuIsOpen;
-    this.checkMode();
-  }
-}
-Header.moduleName = 'govuk-header';
-
 /**
  * Notification Banner component
  *
@@ -2322,9 +2176,9 @@ class ServiceNavigation extends Component {
     }
     if (this.mql.matches) {
       this.$menu.removeAttribute('hidden');
-      this.$menuButton.setAttribute('hidden', '');
+      setAttributes(this.$menuButton, attributesForHidingButton);
     } else {
-      this.$menuButton.removeAttribute('hidden');
+      removeAttributes(this.$menuButton, Object.keys(attributesForHidingButton));
       this.$menuButton.setAttribute('aria-expanded', this.menuIsOpen.toString());
       if (this.menuIsOpen) {
         this.$menu.removeAttribute('hidden');
@@ -2339,6 +2193,34 @@ class ServiceNavigation extends Component {
   }
 }
 ServiceNavigation.moduleName = 'govuk-service-navigation';
+const attributesForHidingButton = {
+  hidden: '',
+  'aria-hidden': 'true'
+};
+
+/**
+ * Sets a group of attributes on the given element
+ *
+ * @param {Element} $element - The element to set the attribute on
+ * @param {{[attributeName: string]: string}} attributes - The attributes to set
+ */
+function setAttributes($element, attributes) {
+  for (const attributeName in attributes) {
+    $element.setAttribute(attributeName, attributes[attributeName]);
+  }
+}
+
+/**
+ * Removes a list of attributes from the given element
+ *
+ * @param {Element} $element - The element to remove the attributes from
+ * @param {string[]} attributeNames - The names of the attributes to remove
+ */
+function removeAttributes($element, attributeNames) {
+  for (const attributeName of attributeNames) {
+    $element.removeAttribute(attributeName);
+  }
+}
 
 /**
  * Skip link component
@@ -2358,16 +2240,10 @@ class SkipLink extends Component {
     super($root);
     const hash = this.$root.hash;
     const href = (_this$$root$getAttrib = this.$root.getAttribute('href')) != null ? _this$$root$getAttrib : '';
-    let url;
-    try {
-      url = new window.URL(this.$root.href);
-    } catch (error) {
-      throw new ElementError(`Skip link: Target link (\`href="${href}"\`) is invalid`);
-    }
-    if (url.origin !== window.location.origin || url.pathname !== window.location.pathname) {
+    if (this.$root.origin !== window.location.origin || this.$root.pathname !== window.location.pathname) {
       return;
     }
-    const linkedElementId = getFragmentFromUrl(hash);
+    const linkedElementId = hash.replace('#', '');
     if (!linkedElementId) {
       throw new ElementError(`Skip link: Target link (\`href="${href}"\`) has no hash fragment`);
     }
@@ -2523,7 +2399,7 @@ class Tabs extends Component {
     return this.$root.querySelector(`a.govuk-tabs__tab[href="${hash}"]`);
   }
   setAttributes($tab) {
-    const panelId = getFragmentFromUrl($tab.href);
+    const panelId = $tab.hash.replace('#', '');
     if (!panelId) {
       return;
     }
@@ -2627,7 +2503,7 @@ class Tabs extends Component {
     this.createHistoryEntry($previousTab);
   }
   getPanel($tab) {
-    const panelId = getFragmentFromUrl($tab.href);
+    const panelId = $tab.hash.replace('#', '');
     if (!panelId) {
       return null;
     }
@@ -2675,28 +2551,34 @@ Tabs.moduleName = 'govuk-tabs';
  * Use the `data-module` attributes to find, instantiate and init all of the
  * components provided as part of GOV.UK Frontend.
  *
- * @param {Config & { scope?: Element, onError?: OnErrorCallback<CompatibleClass> }} [config] - Config for all components (with optional scope)
+ * @param {Config | Element | Document | null} [scopeOrConfig] - Scope of the document to search within or config for all components (with optional scope)
  */
-function initAll(config) {
-  var _config$scope;
-  config = typeof config !== 'undefined' ? config : {};
-  if (!isSupported()) {
-    if (config.onError) {
-      config.onError(new SupportError(), {
+function initAll(scopeOrConfig = {}) {
+  const config = isObject(scopeOrConfig) ? scopeOrConfig : {};
+  const options = normaliseOptions(scopeOrConfig);
+  try {
+    if (!isSupported()) {
+      throw new SupportError();
+    }
+    if (options.scope === null) {
+      throw new ElementError({
+        element: options.scope,
+        identifier: 'GOV.UK Frontend scope element (`$scope`)'
+      });
+    }
+  } catch (error) {
+    if (options.onError) {
+      options.onError(error, {
         config
       });
     } else {
-      console.log(new SupportError());
+      console.log(error);
     }
     return;
   }
-  const components = [[Accordion, config.accordion], [Button, config.button], [CharacterCount, config.characterCount], [Checkboxes], [ErrorSummary, config.errorSummary], [ExitThisPage, config.exitThisPage], [FileUpload, config.fileUpload], [Header], [NotificationBanner, config.notificationBanner], [PasswordInput, config.passwordInput], [Radios], [ServiceNavigation], [SkipLink], [Tabs]];
-  const options = {
-    scope: (_config$scope = config.scope) != null ? _config$scope : document,
-    onError: config.onError
-  };
-  components.forEach(([Component, config]) => {
-    createAll(Component, config, options);
+  const components = [[Accordion, config.accordion], [Button, config.button], [CharacterCount, config.characterCount], [Checkboxes], [ErrorSummary, config.errorSummary], [ExitThisPage, config.exitThisPage], [FileUpload, config.fileUpload], [NotificationBanner, config.notificationBanner], [PasswordInput, config.passwordInput], [Radios], [ServiceNavigation], [SkipLink], [Tabs]];
+  components.forEach(([Component, componentConfig]) => {
+    createAll(Component, componentConfig, options);
   });
 }
 
@@ -2712,42 +2594,42 @@ function initAll(config) {
  * @template {CompatibleClass} ComponentClass
  * @param {ComponentClass} Component - class of the component to create
  * @param {ComponentConfig<ComponentClass>} [config] - Config supplied to component
- * @param {OnErrorCallback<ComponentClass> | Element | Document | CreateAllOptions<ComponentClass> } [createAllOptions] - options for createAll including scope of the document to search within and callback function if error throw by component on init
+ * @param {OnErrorCallback<ComponentClass> | Element | Document | null | CreateAllOptions<ComponentClass>} [scopeOrOptions] - options for createAll including scope of the document to search within and callback function if error throw by component on init
  * @returns {Array<InstanceType<ComponentClass>>} - array of instantiated components
  */
-function createAll(Component, config, createAllOptions) {
-  let $scope = document;
-  let onError;
-  if (typeof createAllOptions === 'object') {
-    var _createAllOptions$sco;
-    createAllOptions = createAllOptions;
-    $scope = (_createAllOptions$sco = createAllOptions.scope) != null ? _createAllOptions$sco : $scope;
-    onError = createAllOptions.onError;
-  }
-  if (typeof createAllOptions === 'function') {
-    onError = createAllOptions;
-  }
-  if (createAllOptions instanceof HTMLElement) {
-    $scope = createAllOptions;
-  }
-  const $elements = $scope.querySelectorAll(`[data-module="${Component.moduleName}"]`);
-  if (!isSupported()) {
-    if (onError) {
-      onError(new SupportError(), {
+function createAll(Component, config, scopeOrOptions) {
+  let $elements;
+  const options = normaliseOptions(scopeOrOptions);
+  try {
+    var _options$scope;
+    if (!isSupported()) {
+      throw new SupportError();
+    }
+    if (options.scope === null) {
+      throw new ElementError({
+        element: options.scope,
+        component: Component,
+        identifier: 'Scope element (`$scope`)'
+      });
+    }
+    $elements = (_options$scope = options.scope) == null ? void 0 : _options$scope.querySelectorAll(`[data-module="${Component.moduleName}"]`);
+  } catch (error) {
+    if (options.onError) {
+      options.onError(error, {
         component: Component,
         config
       });
     } else {
-      console.log(new SupportError());
+      console.log(error);
     }
     return [];
   }
-  return Array.from($elements).map($element => {
+  return Array.from($elements != null ? $elements : []).map($element => {
     try {
       return typeof config !== 'undefined' ? new Component($element, config) : new Component($element);
     } catch (error) {
-      if (onError) {
-        onError(error, {
+      if (options.onError) {
+        options.onError(error, {
           element: $element,
           component: Component,
           config
@@ -2766,6 +2648,8 @@ function createAll(Component, config, createAllOptions) {
  * Config for all components via `initAll()`
  *
  * @typedef {object} Config
+ * @property {Element | Document | null} [scope] - Scope of the document to search within
+ * @property {OnErrorCallback<CompatibleClass>} [onError] - Initialisation error callback
  * @property {AccordionConfig} [accordion] - Accordion config
  * @property {ButtonConfig} [button] - Button config
  * @property {CharacterCountConfig} [characterCount] - Character Count config
@@ -2790,7 +2674,7 @@ function createAll(Component, config, createAllOptions) {
 /**
  * Component config keys, e.g. `accordion` and `characterCount`
  *
- * @typedef {keyof Config} ConfigKey
+ * @typedef {keyof Omit<Config, 'scope' | 'onError'>} ConfigKey
  */
 /**
  * @template {CompatibleClass} ComponentClass
@@ -2801,7 +2685,7 @@ function createAll(Component, config, createAllOptions) {
  * @typedef {object} ErrorContext
  * @property {Element} [element] - Element used for component module initialisation
  * @property {ComponentClass} [component] - Class of component
- * @property {ComponentConfig<ComponentClass>} config - Config supplied to component
+ * @property {Config | ComponentConfig<ComponentClass>} [config] - Config supplied to components
  */
 /**
  * @template {CompatibleClass} ComponentClass
@@ -2812,9 +2696,9 @@ function createAll(Component, config, createAllOptions) {
 /**
  * @template {CompatibleClass} ComponentClass
  * @typedef {object} CreateAllOptions
- * @property {Element | Document} [scope] - scope of the document to search within
+ * @property {Element | Document | null} [scope] - scope of the document to search within
  * @property {OnErrorCallback<ComponentClass>} [onError] - callback function if error throw by component on init
  */
 
-export { Accordion, Button, CharacterCount, Checkboxes, Component, ConfigurableComponent, ErrorSummary, ExitThisPage, FileUpload, Header, NotificationBanner, PasswordInput, Radios, ServiceNavigation, SkipLink, Tabs, createAll, initAll, isSupported, version };
+export { Accordion, Button, CharacterCount, Checkboxes, Component, ConfigurableComponent, ErrorSummary, ExitThisPage, FileUpload, NotificationBanner, PasswordInput, Radios, ServiceNavigation, SkipLink, Tabs, createAll, initAll, isSupported, version };
 //# sourceMappingURL=all.bundle.mjs.map