govuk_tech_docs 5.2.1 → 6.0.0.beta

data/node_modules/govuk-frontend/dist/govuk/components/file-upload/file-upload.bundle.js

@@ -41,9 +41,6 @@
    * @typedef ComponentWithModuleName
    * @property {string} moduleName - Name of the component
    */
-  /**
-   * @import { ObjectNested } from './configuration.mjs'
-   */
 
   class GOVUKFrontendError extends Error {
     constructor(...args) {
@@ -72,7 +69,7 @@
   class ElementError extends GOVUKFrontendError {
     constructor(messageOrOptions) {
       let message = typeof messageOrOptions === 'string' ? messageOrOptions : '';
-      if (typeof messageOrOptions === 'object') {
+      if (isObject(messageOrOptions)) {
         const {
           component,
           identifier,
@@ -81,7 +78,9 @@
         } = 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';
@@ -295,6 +294,9 @@
    * @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 = {}) {
@@ -309,7 +311,7 @@
         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;
@@ -351,8 +353,8 @@
         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) {
@@ -362,132 +364,7 @@
       }
       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';
-    }
-  };
 
   /**
    * File upload component
@@ -520,7 +397,6 @@
         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,
@@ -536,6 +412,7 @@
         $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';
@@ -602,7 +479,7 @@
       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');
@@ -624,12 +501,30 @@
     }
     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) {
@@ -676,6 +571,13 @@
       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: {
@@ -697,10 +599,14 @@
       }
     }
   });
-  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;
   }
 
   /**

data/node_modules/govuk-frontend/dist/govuk/components/file-upload/file-upload.bundle.mjs

@@ -35,9 +35,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) {
@@ -66,7 +63,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,
@@ -75,7 +72,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';
@@ -289,6 +288,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 = {}) {
@@ -303,7 +305,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;
@@ -345,8 +347,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) {
@@ -356,132 +358,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';
-  }
-};
 
 /**
  * File upload component
@@ -514,7 +391,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,
@@ -530,6 +406,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';
@@ -596,7 +473,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');
@@ -618,12 +495,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) {
@@ -670,6 +565,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: {
@@ -691,10 +593,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;
 }
 
 /**

data/node_modules/govuk-frontend/dist/govuk/components/file-upload/file-upload.mjs

@@ -35,7 +35,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,
@@ -51,6 +50,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';
@@ -117,7 +117,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');
@@ -139,12 +139,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) {
@@ -191,6 +209,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: {
@@ -212,10 +237,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;
 }
 
 /**