defra_ruby_template 6.4.0 → 6.6.0

data/node_modules/govuk-frontend/dist/govuk/components/character-count/character-count.bundle.mjs

@@ -28,6 +28,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}`;
 }
@@ -46,11 +49,14 @@ class SupportError extends GOVUKFrontendError {
   /**
    * Checks if GOV.UK Frontend is supported on this page
    *
-   * @param {HTMLElement | null} [$scope] - HTML element `<body>` checked for browser support
+   * @param {Element | Document | null | string} [scopeOrMessage] - HTML element `<body>` checked for browser support or support error message
    */
-  constructor($scope = document.body) {
-    const supportMessage = 'noModule' in HTMLScriptElement.prototype ? 'GOV.UK Frontend initialised without `<body class="govuk-frontend-supported">` from template `<script>` snippet' : 'GOV.UK Frontend is not supported in this browser';
-    super($scope ? supportMessage : 'GOV.UK Frontend initialised without `<script type="module">`');
+  constructor(scopeOrMessage = document.body) {
+    let supportMessage = 'noModule' in HTMLScriptElement.prototype ? 'GOV.UK Frontend initialised without `<body class="govuk-frontend-supported">` from template `<script>` snippet' : 'GOV.UK Frontend is not supported in this browser';
+    if (!isScope(scopeOrMessage)) {
+      supportMessage = 'GOV.UK Frontend initialised without `<script type="module">`';
+    }
+    super(typeof scopeOrMessage === 'string' ? scopeOrMessage : supportMessage);
     this.name = 'SupportError';
   }
 }
@@ -91,6 +97,7 @@ class InitError extends GOVUKFrontendError {
  * @import { ComponentWithModuleName } from '../common/index.mjs'
  */
 
+const _self = typeof globalThis !== 'undefined' ? globalThis : self;
 class Component {
   /**
    * Returns the root element of the component
@@ -144,7 +151,7 @@ class Component {
 /**
  * @typedef {typeof Component & ChildClass} ChildClassConstructor
  */
-Component.elementType = HTMLElement;
+Component.elementType = _self.HTMLElement;
 
 const configOverride = Symbol.for('configOverride');
 class ConfigurableComponent extends Component {
@@ -169,10 +176,14 @@ class ConfigurableComponent extends Component {
       throw new ConfigError(formatErrorMessage(childConstructor, 'Config passed as parameter into constructor but no defaults defined'));
     }
     const datasetConfig = normaliseDataset(childConstructor, this._$root.dataset);
-    this._config = mergeConfigs(childConstructor.defaults, config != null ? config : {}, this[configOverride](datasetConfig), datasetConfig);
+    this._config = mergeConfigs(childConstructor.defaults, config != null ? config : {});
+    this._config = mergeConfigs(this._config, this[configOverride](datasetConfig), datasetConfig);
   }
 }
 function normaliseString(value, property) {
+  if (property != null && property.type && !['string', 'number', 'boolean'].includes(property.type)) {
+    return;
+  }
   const trimmedValue = value ? value.trim() : '';
   let output;
   let outputType = property == null ? void 0 : property.type;
@@ -312,6 +323,17 @@ function extractConfigByNamespace(schema, dataset, namespace) {
  * @import { CompatibleClass, Config, CreateAllOptions, OnErrorCallback } from '../init.mjs'
  */
 
+function createElement(tagName, attributes = {}, children = []) {
+  const $element = document.createElement(tagName);
+  Object.entries(attributes).forEach(([name, value]) => {
+    $element.setAttribute(name, value);
+  });
+  for (const child of children) {
+    $element.append(child);
+  }
+  return $element;
+}
+
 class I18n {
   constructor(translations = {}, config = {}) {
     var _config$locale;
@@ -402,6 +424,14 @@ class CharacterCount extends ConfigurableComponent {
         maxwords: undefined
       };
     }
+    if ('maxwords' in datasetConfig || this.config.maxwords !== undefined) {
+      console.warn(formatErrorMessage(CharacterCount, 'Option `maxwords` is deprecated. Use `maxlength` with `countType: "words"` instead.'));
+      if (!('maxlength' in datasetConfig)) {
+        var _datasetConfig$maxwor;
+        configOverrides.maxlength = (_datasetConfig$maxwor = datasetConfig.maxwords) != null ? _datasetConfig$maxwor : this.config.maxwords;
+        configOverrides.countType = 'words';
+      }
+    }
     return configOverrides;
   }
 
@@ -410,10 +440,11 @@ class CharacterCount extends ConfigurableComponent {
    * @param {CharacterCountConfig} [config] - Character count config
    */
   constructor($root, config = {}) {
-    var _ref, _this$config$maxwords;
+    var _this$config$maxlengt;
     super($root, config);
     this.$textarea = void 0;
     this.count = 0;
+    this.segmenter = null;
     this.$visibleCountMessage = void 0;
     this.$screenReaderCountMessage = void 0;
     this.lastInputTimestamp = null;
@@ -437,7 +468,15 @@ class CharacterCount extends ConfigurableComponent {
     this.i18n = new I18n(this.config.i18n, {
       locale: closestAttributeValue(this.$root, 'lang')
     });
-    this.maxLength = (_ref = (_this$config$maxwords = this.config.maxwords) != null ? _this$config$maxwords : this.config.maxlength) != null ? _ref : Infinity;
+    if (this.config.countType === 'characters' || this.config.countType === 'words' && this.config.maxwords === undefined) {
+      if (!('Segmenter' in Intl)) {
+        throw new SupportError(formatErrorMessage(CharacterCount, 'Support for "Intl.Segmenter" required'));
+      }
+      this.segmenter = new Intl.Segmenter(this.i18n.locale, {
+        granularity: this.config.countType === 'words' ? 'word' : 'grapheme'
+      });
+    }
+    this.maxLength = (_this$config$maxlengt = this.config.maxlength) != null ? _this$config$maxlengt : Infinity;
     this.$textarea = $textarea;
     const textareaDescriptionId = `${this.$textarea.id}-info`;
     const $textareaDescription = document.getElementById(textareaDescriptionId);
@@ -455,15 +494,16 @@ class CharacterCount extends ConfigurableComponent {
       });
     }
     this.$textarea.insertAdjacentElement('afterend', $textareaDescription);
-    const $screenReaderCountMessage = document.createElement('div');
-    $screenReaderCountMessage.className = 'govuk-character-count__sr-status govuk-visually-hidden';
-    $screenReaderCountMessage.setAttribute('aria-live', 'polite');
+    const $screenReaderCountMessage = createElement('div', {
+      class: 'govuk-character-count__sr-status govuk-visually-hidden',
+      'aria-live': 'polite'
+    });
     this.$screenReaderCountMessage = $screenReaderCountMessage;
     $textareaDescription.insertAdjacentElement('afterend', $screenReaderCountMessage);
-    const $visibleCountMessage = document.createElement('div');
-    $visibleCountMessage.className = $textareaDescription.className;
-    $visibleCountMessage.classList.add('govuk-character-count__status');
-    $visibleCountMessage.setAttribute('aria-hidden', 'true');
+    const $visibleCountMessage = createElement('div', {
+      class: `${$textareaDescription.className} govuk-character-count__status`,
+      'aria-hidden': 'true'
+    });
     this.$visibleCountMessage = $visibleCountMessage;
     $textareaDescription.insertAdjacentElement('afterend', $visibleCountMessage);
     $textareaDescription.classList.add('govuk-visually-hidden');
@@ -531,26 +571,38 @@ class CharacterCount extends ConfigurableComponent {
   }
   updateCount() {
     const text = this.$textarea.value;
-    if (this.config.maxwords) {
-      var _text$match;
-      const tokens = (_text$match = text.match(/\S+/g)) != null ? _text$match : [];
-      this.count = tokens.length;
+    if (this.config.countType === 'characters') {
+      this.count = this.segmenter ? Array.from(this.segmenter.segment(text)).length : 0;
+      return;
+    }
+    if (this.config.countType === 'words') {
+      if (this.config.maxwords !== undefined) {
+        var _text$match$length, _text$match;
+        this.count = (_text$match$length = (_text$match = text.match(/\S+/g)) == null ? void 0 : _text$match.length) != null ? _text$match$length : 0;
+        return;
+      }
+      const segments = this.segmenter ? Array.from(this.segmenter.segment(text)) : [];
+      this.count = segments.filter(segment => segment.isWordLike).length;
       return;
     }
     this.count = text.length;
   }
   getCountMessage() {
     const remainingNumber = this.maxLength - this.count;
-    const countType = this.config.maxwords ? 'words' : 'characters';
-    return this.formatCountMessage(remainingNumber, countType);
+    return this.formatCountMessage(remainingNumber);
   }
   formatCountMessage(remainingNumber, countType) {
+    countType = countType != null ? countType : this.config.countType;
+    let translationKeyPrefix = 'characters';
+    let translationKeySuffix = remainingNumber < 0 ? 'OverLimit' : 'UnderLimit';
+    if (countType === 'words') {
+      translationKeyPrefix = 'words';
+    }
     if (remainingNumber === 0) {
-      return this.i18n.t(`${countType}AtLimit`);
+      translationKeySuffix = 'AtLimit';
     }
-    const translationKeySuffix = remainingNumber < 0 ? 'OverLimit' : 'UnderLimit';
-    return this.i18n.t(`${countType}${translationKeySuffix}`, {
-      count: Math.abs(remainingNumber)
+    return this.i18n.t(`${translationKeyPrefix}${translationKeySuffix}`, {
+      count: remainingNumber === 0 ? undefined : Math.abs(remainingNumber)
     });
   }
   isOverThreshold() {
@@ -569,13 +621,15 @@ class CharacterCount extends ConfigurableComponent {
  *
  * @see {@link CharacterCount.defaults}
  * @typedef {object} CharacterCountConfig
- * @property {number} [maxlength] - The maximum number of characters.
- *   If maxwords is provided, the maxlength option will be ignored.
- * @property {number} [maxwords] - The maximum number of words. If maxwords is
- *   provided, the maxlength option will be ignored.
+ * @property {number} [maxlength] - The maximum number of characters (or words
+ *   if `countType` is set to `"words"`).
+ * @property {number} [maxwords] - Deprecated. Use `maxlength` and
+ *   `countType: "words"` instead.
  * @property {number} [threshold=0] - The percentage value of the limit at
  *   which point the count message is displayed. If this attribute is set, the
  *   count message will be hidden by default.
+ * @property {'characters' | 'length' | 'words'} [countType] - The count type
+ *   (`"characters"`, `"length"` or `"words"`) used to count the text.
  * @property {CharacterCountTranslations} [i18n=CharacterCount.defaults.i18n] - Character count translations
  */
 
@@ -621,9 +675,9 @@ class CharacterCount extends ConfigurableComponent {
  * @property {TranslationPluralForms} [textareaDescription] - Message made
  *   available to assistive technologies, if none is already present in the
  *   HTML, to describe that the component accepts only a limited amount of
- *   content. It is visible on the page when JavaScript is unavailable. The
- *   component will replace the `%{count}` placeholder with the value of the
- *   `maxlength` or `maxwords` parameter.
+ *   content. It is visible on the page if `countType` is not supported or
+ *   JavaScript is unavailable. The component will replace the `%{count}`
+ *   placeholder with the value of the `maxlength` parameter.
  */
 
 /**
@@ -633,6 +687,7 @@ class CharacterCount extends ConfigurableComponent {
 CharacterCount.moduleName = 'govuk-character-count';
 CharacterCount.defaults = Object.freeze({
   threshold: 0,
+  countType: 'length',
   i18n: {
     charactersUnderLimit: {
       one: 'You have %{count} character remaining',
@@ -670,6 +725,9 @@ CharacterCount.schema = Object.freeze({
     },
     threshold: {
       type: 'number'
+    },
+    countType: {
+      type: 'string'
     }
   },
   anyOf: [{