intl-tel-input 26.9.2 → 27.0.0

package/{build → dist}/js/intlTelInput.js

@@ -1,19 +1,10 @@
 /*
- * International Telephone Input v26.9.2
+ * International Telephone Input v27.0.0
  * https://github.com/jackocnr/intl-tel-input.git
  * Licensed under the MIT license
  */
-
-// UMD
-(function(factory) {
-  if (typeof module === 'object' && module.exports) {
-    module.exports = factory();
-  } else {
-    window.intlTelInput = factory();
-  }
-}(() => {
-
-var factoryOutput = (() => {
+"use strict";
+var _factory = (() => {
   var __defProp = Object.defineProperty;
   var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
   var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -39,7 +30,7 @@ var factoryOutput = (() => {
     default: () => intl_tel_input_default
   });
 
-  // src/js/intl-tel-input/data.ts
+  // src/js/data.ts
   var rawCountryData = [
     [
       "af",
@@ -1742,7 +1733,7 @@ var factoryOutput = (() => {
   var isIso2 = (val) => iso2Set.has(val);
   var data_default = allCountries;
 
-  // src/js/modules/constants.ts
+  // src/js/constants.ts
   var EVENTS = {
     OPEN_COUNTRY_DROPDOWN: "open:countrydropdown",
     CLOSE_COUNTRY_DROPDOWN: "close:countrydropdown",
@@ -1863,10 +1854,10 @@ var factoryOutput = (() => {
     MODAL: "aria-modal"
   };
 
-  // src/js/intl-tel-input/i18n/en/index.ts
+  // src/js/i18n/en.ts
   var interfaceTranslations = {
-    selectedCountryAriaLabel: "Change country, selected ${countryName} (${dialCode})",
-    noCountrySelected: "Select country",
+    selectedCountryAriaLabel: "Change country for phone number, currently selected ${countryName} (${dialCode})",
+    noCountrySelected: "Select country for phone number",
     countryListAriaLabel: "List of countries",
     searchPlaceholder: "Search",
     clearSearchAriaLabel: "Clear search",
@@ -1883,7 +1874,7 @@ var factoryOutput = (() => {
   };
   var en_default = interfaceTranslations;
 
-  // src/js/modules/core/options.ts
+  // src/js/core/options.ts
   var mq = (q) => typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia(q).matches;
   var isNarrowViewport = () => mq(`(max-width: ${LAYOUT.NARROW_VIEWPORT_WIDTH}px)`);
   var computeDefaultUseFullscreenPopup = () => {
@@ -1920,7 +1911,7 @@ var factoryOutput = (() => {
     //* Append menu to specified element.
     dropdownContainer: null,
     //* Don't display these countries.
-    excludeCountries: [],
+    excludeCountries: null,
     //* Fix the dropdown width to the input width (rather than being as wide as the longest country name).
     fixDropdownWidth: true,
     //* Format the number as the user types
@@ -1940,7 +1931,7 @@ var factoryOutput = (() => {
     //* National vs international formatting for numbers e.g. placeholders and displaying existing numbers.
     nationalMode: true,
     //* Display only these countries.
-    onlyCountries: [],
+    onlyCountries: null,
     //* Number type to use for placeholders.
     placeholderNumberType: "MOBILE",
     //* Add custom classes to the search input element.
@@ -1958,7 +1949,9 @@ var factoryOutput = (() => {
   var isPlainObject = (val) => Boolean(val) && typeof val === "object" && !Array.isArray(val);
   var isFn = (val) => typeof val === "function";
   var isElLike = (val) => {
-    if (!val || typeof val !== "object") return false;
+    if (!val || typeof val !== "object") {
+      return false;
+    }
     const v = val;
     return v.nodeType === 1 && typeof v.tagName === "string" && typeof v.appendChild === "function";
   };
@@ -2073,9 +2066,13 @@ var factoryOutput = (() => {
           break;
         case "excludeCountries":
         case "onlyCountries": {
-          const filtered = validateIso2Array(key, value);
-          if (filtered !== false) {
-            validatedOptions[key] = filtered;
+          if (value === null) {
+            validatedOptions[key] = value;
+          } else {
+            const filtered = validateIso2Array(key, value);
+            if (filtered !== false) {
+              validatedOptions[key] = filtered;
+            }
           }
           break;
         }
@@ -2159,7 +2156,7 @@ var factoryOutput = (() => {
         o.fixDropdownWidth = true;
       }
     }
-    if (o.onlyCountries.length === 1) {
+    if (o.onlyCountries?.length === 1) {
       o.initialCountry = o.onlyCountries[0];
     }
     if (o.separateDialCode) {
@@ -2174,14 +2171,14 @@ var factoryOutput = (() => {
     o.i18n = { ...en_default, ...o.i18n };
   };
 
-  // src/js/modules/utils/string.ts
+  // src/js/helpers/string.ts
   var getNumeric = (s) => s.replace(/\D/g, "");
   var normaliseString = (s = "") => s.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
 
-  // src/js/modules/utils/isAndroid.ts
+  // src/js/helpers/isAndroid.ts
   var getIsAndroid = () => typeof navigator !== "undefined" ? /Android/i.test(navigator.userAgent) : false;
 
-  // src/js/modules/core/countrySearch.ts
+  // src/js/core/countrySearch.ts
   var getMatchedCountries = (countries, query) => {
     const normalisedQuery = normaliseString(query);
     const iso2Matches = [];
@@ -2226,7 +2223,7 @@ var factoryOutput = (() => {
     return null;
   };
 
-  // src/js/modules/utils/dom.ts
+  // src/js/helpers/dom.ts
   var buildClassNames = (flags) => Object.keys(flags).filter((k) => Boolean(flags[k])).join(" ");
   var createEl = (tagName, attrs, container) => {
     const el = document.createElement(tagName);
@@ -2241,7 +2238,7 @@ var factoryOutput = (() => {
     return el;
   };
 
-  // src/js/modules/core/icons.ts
+  // src/js/core/icons.ts
   var buildSearchIcon = () => `
   <svg class="iti__search-icon-svg" width="14" height="14" viewBox="0 0 24 24" focusable="false" ${ARIA.HIDDEN}="true">
     <circle cx="11" cy="11" r="7" />
@@ -2268,31 +2265,15 @@ var factoryOutput = (() => {
     <path d="m261 428-2-2-22-21a40 40 0 0 0-32-11h-1a37 37 0 0 0-18 8l-1 1-4 2-2 2-5 4c-9-3-36-31-47-44s-32-45-34-55l3-2a151 151 0 0 0 11-9v-1a39 39 0 0 0 5-48l-3-3-11-19-3-4-5-7h-1l-3-3-4-3-5-2a35 35 0 0 0-16-3h-5c-4 1-14 5-24 11l-4 2-4 3-4 2c-9 8-17 17-18 27a380 380 0 0 0 212 259h3c12 0 25-10 36-21l10-12 6-11a39 39 0 0 0-8-40"/>
   </svg>`;
 
-  // src/js/modules/core/ui.ts
+  // src/js/core/ui.ts
   var UI = class _UI {
-    constructor(input, options, id2) {
-      this.#searchKeyupTimer = null;
-      this.#inlineDropdownHeight = null;
-      this.#dropdownForContainer = null;
-      this.#selectedItem = null;
-      this.highlightedItem = null;
-      input.dataset.intlTelInputId = id2.toString();
-      this.telInput = input;
-      this.#options = options;
-      this.#id = id2;
-      this.hadInitialPlaceholder = Boolean(input.getAttribute("placeholder"));
-      this.#isRTL = !!this.telInput.closest("[dir=rtl]");
-      if (this.#options.separateDialCode) {
-        this.#originalPaddingLeft = this.telInput.style.paddingLeft;
-      }
-    }
     // private
     #options;
     #id;
     #isRTL;
-    #originalPaddingLeft;
+    #originalPaddingLeft = "";
     #countries;
-    #searchKeyupTimer;
+    #searchKeyupTimer = null;
     #inlineDropdownHeight;
     #selectedDialCode;
     #dropdownArrow;
@@ -2301,7 +2282,30 @@ var factoryOutput = (() => {
     #searchNoResults;
     #searchResultsA11yText;
     #dropdownForContainer;
-    #selectedItem;
+    #selectedItem = null;
+    // public
+    telInput;
+    countryContainer;
+    selectedCountry;
+    selectedCountryInner;
+    searchInput;
+    searchClearButton;
+    countryList;
+    hiddenInputPhone;
+    hiddenInputCountry;
+    highlightedItem = null;
+    hadInitialPlaceholder;
+    constructor(input, options, id2) {
+      input.dataset.intlTelInputId = id2.toString();
+      this.telInput = input;
+      this.#options = options;
+      this.#id = id2;
+      this.hadInitialPlaceholder = Boolean(input.getAttribute("placeholder"));
+      this.#isRTL = !!this.telInput.closest("[dir=rtl]");
+      if (this.#options.separateDialCode) {
+        this.#originalPaddingLeft = this.telInput.style.paddingLeft;
+      }
+    }
     // Validate that the provided element is an HTMLInputElement.
     static validateInput(input) {
       const tagName = input?.tagName;
@@ -2317,6 +2321,9 @@ var factoryOutput = (() => {
     generateMarkup(countries) {
       this.#countries = countries;
       this.telInput.classList.add("iti__tel-input");
+      if (!this.telInput.hasAttribute("type")) {
+        this.telInput.setAttribute("type", "tel");
+      }
       if (!this.telInput.hasAttribute("autocomplete")) {
         this.telInput.setAttribute("autocomplete", "tel");
       }
@@ -2536,7 +2543,7 @@ var factoryOutput = (() => {
         },
         this.#dropdownContent
       );
-      this.#searchNoResults.textContent = i18n.searchEmptyState;
+      this.#searchNoResults.textContent = i18n.searchEmptyState ?? null;
     }
     #maybeUpdateInputPaddingAndReveal() {
       if (this.countryContainer) {
@@ -2554,13 +2561,13 @@ var factoryOutput = (() => {
             `input[name="${names.phone}"]`
           );
           if (existingInput) {
-            this.hiddenInput = existingInput;
+            this.hiddenInputPhone = existingInput;
           } else {
-            this.hiddenInput = createEl("input", {
+            this.hiddenInputPhone = createEl("input", {
               type: "hidden",
               name: names.phone
             });
-            wrapper.appendChild(this.hiddenInput);
+            wrapper.appendChild(this.hiddenInputPhone);
           }
         }
         if (names.country) {
@@ -2805,28 +2812,9 @@ var factoryOutput = (() => {
       const wrapper = this.telInput.parentNode;
       wrapper.before(this.telInput);
       wrapper.remove();
-      this.telInput = null;
-      this.countryContainer = null;
-      this.selectedCountry = null;
-      this.selectedCountryInner = null;
-      this.searchInput = null;
-      this.searchClearButton = null;
-      this.countryList = null;
-      this.hiddenInput = null;
-      this.hiddenInputCountry = null;
-      this.highlightedItem = null;
-      this.#selectedDialCode = null;
-      this.#dropdownArrow = null;
-      this.#dropdownContent = null;
-      this.#searchIcon = null;
-      this.#searchNoResults = null;
-      this.#searchResultsA11yText = null;
-      this.#dropdownForContainer = null;
-      this.#selectedItem = null;
       for (const c of this.#countries) {
         delete c.nodeById[this.#id];
       }
-      this.#countries = null;
     }
     // UI: Open the dropdown (DOM only).
     openDropdown() {
@@ -2850,10 +2838,10 @@ var factoryOutput = (() => {
       this.#dropdownContent.classList.remove(CLASSES.HIDE);
       this.selectedCountry.setAttribute(ARIA.EXPANDED, "true");
       if (countrySearch) {
-        const firstCountryItem = this.countryList.firstElementChild;
-        if (firstCountryItem) {
-          this.highlightListItem(firstCountryItem, false);
-          this.countryList.scrollTop = 0;
+        const itemToHighlight = this.#selectedItem ?? this.countryList.firstElementChild;
+        if (itemToHighlight) {
+          this.highlightListItem(itemToHighlight, false);
+          this.scrollCountryListToItem(itemToHighlight);
         }
         if (!dropdownAlwaysOpen) {
           this.searchInput.focus();
@@ -2868,6 +2856,8 @@ var factoryOutput = (() => {
       this.selectedCountry.setAttribute(ARIA.EXPANDED, "false");
       if (countrySearch) {
         this.searchInput.removeAttribute(ARIA.ACTIVE_DESCENDANT);
+        this.searchInput.value = "";
+        this.#doFilter();
         if (this.highlightedItem) {
           this.highlightedItem.classList.remove(CLASSES.HIGHLIGHT);
           this.highlightedItem = null;
@@ -2922,7 +2912,9 @@ var factoryOutput = (() => {
     }
     setCountry(selectedCountryData) {
       const { allowDropdown, showFlags, separateDialCode, i18n } = this.#options;
-      const { name, dialCode, iso2 = "" } = selectedCountryData;
+      const name = selectedCountryData?.name;
+      const dialCode = selectedCountryData?.dialCode;
+      const iso2 = selectedCountryData?.iso2 ?? "";
       if (allowDropdown) {
         this.#updateSelectedItem(iso2);
       }
@@ -2951,7 +2943,7 @@ var factoryOutput = (() => {
     }
   };
 
-  // src/js/modules/data/country-data.ts
+  // src/js/data/country-data.ts
   var processAllCountries = (options) => {
     const { onlyCountries, excludeCountries } = options;
     if (onlyCountries?.length) {
@@ -3056,7 +3048,7 @@ var factoryOutput = (() => {
     }
   };
 
-  // src/js/modules/data/intl-regionless.ts
+  // src/js/data/intl-regionless.ts
   var REGIONLESS_DIAL_CODES = /* @__PURE__ */ new Set([
     "800",
     "808",
@@ -3072,7 +3064,7 @@ var factoryOutput = (() => {
     return number.startsWith("+") && REGIONLESS_DIAL_CODES.has(dialCode);
   };
 
-  // src/js/modules/format/formatting.ts
+  // src/js/format/formatting.ts
   var beforeSetNumber = (fullNumber, hasValidDialCode, separateDialCode, selectedCountryData) => {
     let number = fullNumber;
     if (separateDialCode) {
@@ -3085,8 +3077,8 @@ var factoryOutput = (() => {
     return number;
   };
   var formatNumberAsYouType = (fullNumber, telInputValue, utils, selectedCountryData, separateDialCode) => {
-    const result = utils ? utils.formatNumberAsYouType(fullNumber, selectedCountryData.iso2) : fullNumber;
-    const { dialCode } = selectedCountryData;
+    const result = utils ? utils.formatNumberAsYouType(fullNumber, selectedCountryData?.iso2) : fullNumber;
+    const dialCode = selectedCountryData?.dialCode;
     if (separateDialCode && telInputValue.charAt(0) !== "+" && result.includes(`+${dialCode}`)) {
       const afterDialCode = result.split(`+${dialCode}`)[1] || "";
       return afterDialCode.trim();
@@ -3094,7 +3086,7 @@ var factoryOutput = (() => {
     return result;
   };
 
-  // src/js/modules/format/caret.ts
+  // src/js/format/caret.ts
   var translateCursorPosition = (relevantChars, formattedValue, prevCaretPos, isDeleteForwards) => {
     if (prevCaretPos === 0 && !isDeleteForwards) {
       return 0;
@@ -3114,7 +3106,7 @@ var factoryOutput = (() => {
     return formattedValue.length;
   };
 
-  // src/js/modules/data/nanp-regionless.ts
+  // src/js/data/nanp-regionless.ts
   var regionlessNanpNumbers = /* @__PURE__ */ new Set([
     "800",
     "822",
@@ -3143,7 +3135,7 @@ var factoryOutput = (() => {
     return false;
   };
 
-  // src/js/modules/core/numerals.ts
+  // src/js/core/numerals.ts
   var Numerals = class {
     #userNumeralSet;
     constructor(initialValue) {
@@ -3190,7 +3182,26 @@ var factoryOutput = (() => {
 
   // src/js/intl-tel-input.ts
   var id = 0;
+  var ensureUtils = (methodName) => {
+    if (!intlTelInput.utils) {
+      throw new Error(`intlTelInput.utils is required for ${methodName}(). See: https://intl-tel-input.com/docs/utils`);
+    }
+  };
+  var createDeferred = () => {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+      resolve = res;
+      reject = rej;
+    });
+    return { promise, resolve, reject };
+  };
   var Iti = class _Iti {
+    //* PUBLIC FIELDS - READONLY
+    //* Can't be private as it's called from intlTelInput convenience wrapper.
+    id;
+    // accessed externally via iti.promise.then(...)
+    promise;
     //* PRIVATE FIELDS
     #ui;
     #options;
@@ -3201,16 +3212,15 @@ var factoryOutput = (() => {
     #dialCodeToIso2Map;
     #dialCodes;
     #countryByIso2;
-    #selectedCountryData;
-    #maxCoreNumberLength;
+    #selectedCountryData = null;
+    #maxCoreNumberLength = null;
     #defaultCountry;
+    #destroyed = false;
     #abortController;
-    #dropdownAbortController;
+    #dropdownAbortController = null;
     #numerals;
-    #resolveAutoCountryPromise;
-    #rejectAutoCountryPromise;
-    #resolveUtilsScriptPromise;
-    #rejectUtilsScriptPromise;
+    #autoCountryDeferred;
+    #utilsScriptDeferred;
     constructor(input, customOptions = {}) {
       this.id = id++;
       UI.validateInput(input);
@@ -3243,37 +3253,19 @@ var factoryOutput = (() => {
       const { initialCountry, geoIpLookup, loadUtils } = options;
       const needsAutoCountryPromise = initialCountry === INITIAL_COUNTRY.AUTO && Boolean(geoIpLookup);
       const needsUtilsScriptPromise = Boolean(loadUtils) && !intlTelInput.utils;
-      let autoCountryPromise;
       if (needsAutoCountryPromise) {
-        autoCountryPromise = new Promise((resolve, reject) => {
-          this.#resolveAutoCountryPromise = resolve;
-          this.#rejectAutoCountryPromise = reject;
-        });
-      } else {
-        autoCountryPromise = Promise.resolve(void 0);
-        this.#resolveAutoCountryPromise = () => {
-        };
-        this.#rejectAutoCountryPromise = () => {
-        };
+        this.#autoCountryDeferred = createDeferred();
       }
-      let utilsScriptPromise;
       if (needsUtilsScriptPromise) {
-        utilsScriptPromise = new Promise((resolve, reject) => {
-          this.#resolveUtilsScriptPromise = resolve;
-          this.#rejectUtilsScriptPromise = reject;
-        });
-      } else {
-        utilsScriptPromise = Promise.resolve(void 0);
-        this.#resolveUtilsScriptPromise = () => {
-        };
-        this.#rejectUtilsScriptPromise = () => {
-        };
+        this.#utilsScriptDeferred = createDeferred();
       }
-      return Promise.all([autoCountryPromise, utilsScriptPromise]).then(() => {
+      return Promise.all([
+        this.#autoCountryDeferred?.promise,
+        this.#utilsScriptDeferred?.promise
+      ]).then(() => {
       });
     }
     #init() {
-      this.#selectedCountryData = null;
       this.#abortController = new AbortController();
       this.#processCountryData();
       this.#ui.generateMarkup(this.#countries);
@@ -3298,7 +3290,7 @@ var factoryOutput = (() => {
     //* 2. Using explicit initialCountry
     #setInitialState(overrideAutoCountry = false) {
       const attributeValueRaw = this.#ui.telInput.getAttribute("value");
-      const attributeValue = this.#numerals.normalise(attributeValueRaw);
+      const attributeValue = this.#numerals.normalise(attributeValueRaw ?? "");
       const inputValue = this.#getTelInputValue();
       const useAttribute = attributeValue && attributeValue.startsWith("+") && (!inputValue || !inputValue.startsWith("+"));
       const val = useAttribute ? attributeValue : inputValue;
@@ -3333,15 +3325,15 @@ var factoryOutput = (() => {
       if (this.#options.allowDropdown) {
         this.#initDropdownListeners();
       }
-      if ((this.#ui.hiddenInput || this.#ui.hiddenInputCountry) && this.#ui.telInput.form) {
+      if ((this.#ui.hiddenInputPhone || this.#ui.hiddenInputCountry) && this.#ui.telInput.form) {
         this.#initHiddenInputListener();
       }
     }
     //* Update hidden input on form submit.
     #initHiddenInputListener() {
       const handleHiddenInputSubmit = () => {
-        if (this.#ui.hiddenInput) {
-          this.#ui.hiddenInput.value = this.getNumber();
+        if (this.#ui.hiddenInputPhone) {
+          this.#ui.hiddenInputPhone.value = this.getNumber();
         }
         if (this.#ui.hiddenInputCountry) {
           this.#ui.hiddenInputCountry.value = this.#selectedCountryData?.iso2 || "";
@@ -3410,12 +3402,12 @@ var factoryOutput = (() => {
           });
         }
       } else {
-        this.#resolveUtilsScriptPromise();
+        this.#utilsScriptDeferred?.resolve();
       }
       const isAutoCountry = initialCountry === INITIAL_COUNTRY.AUTO && geoIpLookup;
       if (isAutoCountry) {
-        if (this.#selectedCountryData?.iso2) {
-          this.#resolveAutoCountryPromise();
+        if (this.#selectedCountryData) {
+          this.#autoCountryDeferred?.resolve();
         } else {
           this.#loadAutoCountry();
         }
@@ -3510,7 +3502,7 @@ var factoryOutput = (() => {
             fullNumber,
             inputValue,
             intlTelInput.utils,
-            this.#selectedCountryData ?? {},
+            this.#selectedCountryData,
             separateDialCode
           );
           const newCaretPos = translateCursorPosition(
@@ -3527,7 +3519,7 @@ var factoryOutput = (() => {
             inputValue,
             true,
             separateDialCode,
-            this.#selectedCountryData ?? {}
+            this.#selectedCountryData
           );
           this.#setTelInputValue(cleanNumber);
         }
@@ -3560,8 +3552,8 @@ var factoryOutput = (() => {
               const input = this.#ui.telInput;
               const selStart = input.selectionStart;
               const selEnd = input.selectionEnd;
-              const before = inputValue.slice(0, selStart);
-              const after = inputValue.slice(selEnd);
+              const before = inputValue.slice(0, selStart ?? void 0);
+              const after = inputValue.slice(selEnd ?? void 0);
               const newValue = before + e.key + after;
               const newFullNumber = this.#getFullNumber(newValue);
               let hasExceededMaxLength = false;
@@ -3593,8 +3585,8 @@ var factoryOutput = (() => {
           const selStart = input.selectionStart;
           const selEnd = input.selectionEnd;
           const inputValue = this.#getTelInputValue();
-          const before = inputValue.slice(0, selStart);
-          const after = inputValue.slice(selEnd);
+          const before = inputValue.slice(0, selStart ?? void 0);
+          const after = inputValue.slice(selEnd ?? void 0);
           const iso2 = this.#selectedCountryData?.iso2;
           const pastedRaw = e.clipboardData.getData("text");
           const pasted = this.#numerals.normalise(pastedRaw);
@@ -3605,7 +3597,7 @@ var factoryOutput = (() => {
           const numerics = allowedChars.replace(/\+/g, "");
           const sanitised = hasLeadingPlus && allowLeadingPlus ? `+${numerics}` : numerics;
           let newVal = before + sanitised + after;
-          if (newVal.length > 5) {
+          if (newVal.length > 5 && intlTelInput.utils) {
             let coreNumber = intlTelInput.utils.getCoreNumber(newVal, iso2);
             while (coreNumber.length === 0 && newVal.length > 0) {
               newVal = newVal.slice(0, -1);
@@ -3895,10 +3887,10 @@ var factoryOutput = (() => {
     #setCountry(iso2) {
       const prevIso2 = this.#selectedCountryData?.iso2 || "";
       this.#selectedCountryData = iso2 ? this.#countryByIso2.get(iso2) : null;
-      if (this.#selectedCountryData?.iso2) {
+      if (this.#selectedCountryData) {
         this.#defaultCountry = this.#selectedCountryData.iso2;
       }
-      this.#ui.setCountry(this.#selectedCountryData ?? {});
+      this.#ui.setCountry(this.#selectedCountryData);
       this.#updatePlaceholder();
       this.#updateMaxLength();
       return prevIso2 !== iso2;
@@ -3946,14 +3938,14 @@ var factoryOutput = (() => {
       const shouldSetPlaceholder = autoPlaceholder === PLACEHOLDER_MODES.AGGRESSIVE || !this.#ui.hadInitialPlaceholder && autoPlaceholder === PLACEHOLDER_MODES.POLITE;
       if (intlTelInput.utils && shouldSetPlaceholder) {
         const numberType = intlTelInput.utils.numberType[placeholderNumberType];
-        let placeholder = this.#selectedCountryData?.iso2 ? intlTelInput.utils.getExampleNumber(
+        let placeholder = this.#selectedCountryData ? intlTelInput.utils.getExampleNumber(
           this.#selectedCountryData.iso2,
           nationalMode,
           numberType
         ) : "";
         placeholder = this.#beforeSetNumber(placeholder);
         if (typeof customPlaceholder === "function") {
-          placeholder = customPlaceholder(placeholder, this.#selectedCountryData ?? {});
+          placeholder = customPlaceholder(placeholder, this.#selectedCountryData);
         }
         this.#ui.telInput.setAttribute("placeholder", placeholder);
       }
@@ -4052,14 +4044,16 @@ var factoryOutput = (() => {
         fullNumber,
         hasValidDialCode,
         this.#options.separateDialCode,
-        this.#selectedCountryData ?? {}
+        this.#selectedCountryData
       );
       return this.#cap(number);
     }
     //* Return only the public-facing subset of the selected country data.
     #getPublicCountryData() {
       const d = this.#selectedCountryData;
-      if (!d) return {};
+      if (!d) {
+        return null;
+      }
       const { iso2, dialCode, name } = d;
       return { iso2, dialCode, name };
     }
@@ -4073,32 +4067,32 @@ var factoryOutput = (() => {
     //**************************
     //* Called when the geoip call returns.
     #handleAutoCountry() {
-      if (!this.#ui.telInput) {
-        this.#resolveAutoCountryPromise?.();
+      if (this.#destroyed) {
+        this.#autoCountryDeferred?.resolve();
         return;
       }
       if (this.#options.initialCountry === INITIAL_COUNTRY.AUTO && intlTelInput.autoCountry) {
         this.#defaultCountry = intlTelInput.autoCountry;
-        const hasSelectedCountryOrGlobe = this.#selectedCountryData?.iso2 || this.#ui.selectedCountryInner.classList.contains(CLASSES.GLOBE);
+        const hasSelectedCountryOrGlobe = this.#selectedCountryData || this.#ui.selectedCountryInner.classList.contains(CLASSES.GLOBE);
         if (!hasSelectedCountryOrGlobe) {
           this.setCountry(this.#defaultCountry);
         }
-        this.#resolveAutoCountryPromise();
+        this.#autoCountryDeferred?.resolve();
       }
     }
     //* Called when the geoip call fails or times out.
     #handleAutoCountryFailure() {
-      if (!this.#ui.telInput) {
-        this.#rejectAutoCountryPromise?.();
+      if (this.#destroyed) {
+        this.#autoCountryDeferred?.reject();
         return;
       }
       this.#setInitialState(true);
-      this.#rejectAutoCountryPromise();
+      this.#autoCountryDeferred?.reject();
     }
     //* Called when the utils request completes.
     #handleUtils() {
-      if (!this.#ui.telInput) {
-        this.#resolveUtilsScriptPromise?.();
+      if (this.#destroyed) {
+        this.#utilsScriptDeferred?.resolve();
         return;
       }
       if (intlTelInput.utils) {
@@ -4106,74 +4100,77 @@ var factoryOutput = (() => {
         if (inputValue) {
           this.#updateValFromNumber(inputValue);
         }
-        if (this.#selectedCountryData?.iso2) {
+        if (this.#selectedCountryData) {
           this.#updatePlaceholder();
           this.#updateMaxLength();
         }
       }
-      this.#resolveUtilsScriptPromise();
+      this.#utilsScriptDeferred?.resolve();
     }
     //* Called when the utils request fails or times out.
     #handleUtilsFailure(error) {
-      if (!this.#ui.telInput) {
-        this.#rejectUtilsScriptPromise?.(error);
+      if (this.#destroyed) {
+        this.#utilsScriptDeferred?.reject(error);
         return;
       }
-      this.#rejectUtilsScriptPromise(error);
+      this.#utilsScriptDeferred?.reject(error);
     }
     //********************
     //*  PUBLIC METHODS
     //********************
     //* Remove plugin.
     destroy() {
-      if (!this.#ui.telInput) {
+      if (this.#destroyed) {
         return;
       }
+      this.#destroyed = true;
       if (this.#options.allowDropdown) {
         this.#closeDropdown(true);
       }
       this.#abortController.abort();
-      this.#abortController = null;
       this.#ui.destroy();
-      delete intlTelInput.instances[this.id];
+      intlTelInput.instances.delete(String(this.id));
     }
-    // check if the instance is still valid (not destroyed/unmounted)
+    // check if the instance is still valid (not destroyed)
     isActive() {
-      return !!this.#ui?.telInput;
+      return !this.#destroyed;
     }
     //* Get the extension from the current number.
     getExtension() {
-      if (intlTelInput.utils && this.#ui.telInput) {
-        return intlTelInput.utils.getExtension(
-          this.#getFullNumber(),
-          this.#selectedCountryData?.iso2
-        );
+      if (this.#destroyed) {
+        return "";
       }
-      return "";
+      ensureUtils("getExtension");
+      return intlTelInput.utils.getExtension(
+        this.#getFullNumber(),
+        this.#selectedCountryData?.iso2
+      );
     }
     //* Format the number to the given format.
     getNumber(format) {
-      if (intlTelInput.utils && this.#ui.telInput) {
-        const iso2 = this.#selectedCountryData?.iso2;
-        const fullNumber = this.#getFullNumber();
-        const formattedNumber = intlTelInput.utils.formatNumber(
-          fullNumber,
-          iso2,
-          format
-        );
-        return this.#numerals.denormalise(formattedNumber);
+      if (this.#destroyed) {
+        return "";
       }
-      return "";
+      ensureUtils("getNumber");
+      const iso2 = this.#selectedCountryData?.iso2;
+      const fullNumber = this.#getFullNumber();
+      const formattedNumber = intlTelInput.utils.formatNumber(
+        fullNumber,
+        iso2,
+        format
+      );
+      return this.#numerals.denormalise(formattedNumber);
     }
     //* Get the type of the entered number e.g. landline/mobile.
     getNumberType() {
-      if (intlTelInput.utils && this.#ui.telInput) {
-        return intlTelInput.utils.getNumberType(
-          this.#getFullNumber(),
-          this.#selectedCountryData?.iso2
-        );
+      if (this.#destroyed) {
+        return SENTINELS.UNKNOWN_NUMBER_TYPE;
       }
-      return SENTINELS.UNKNOWN_NUMBER_TYPE;
+      ensureUtils("getNumberType");
+      return intlTelInput.utils.getNumberType(
+        this.#getFullNumber(),
+        this.#selectedCountryData?.iso2
+      );
     }
     //* Get the country data for the currently selected country.
     getSelectedCountryData() {
@@ -4181,32 +4178,35 @@ var factoryOutput = (() => {
     }
     //* Get the validation error.
     getValidationError() {
-      if (intlTelInput.utils && this.#ui.telInput) {
-        const iso2 = this.#selectedCountryData?.iso2;
-        return intlTelInput.utils.getValidationError(this.#getFullNumber(), iso2);
+      if (this.#destroyed) {
+        return SENTINELS.UNKNOWN_VALIDATION_ERROR;
       }
-      return SENTINELS.UNKNOWN_VALIDATION_ERROR;
+      ensureUtils("getValidationError");
+      const iso2 = this.#selectedCountryData?.iso2;
+      return intlTelInput.utils.getValidationError(this.#getFullNumber(), iso2);
     }
     //* Validate the input val using number length only
     isValidNumber() {
+      if (this.#destroyed) {
+        return null;
+      }
+      ensureUtils("isValidNumber");
       const dialCode = this.#selectedCountryData?.dialCode;
       const iso2 = this.#selectedCountryData?.iso2;
-      if (intlTelInput.utils && this.#ui.telInput) {
-        const number = this.#getFullNumber();
-        const coreNumber = intlTelInput.utils.getCoreNumber(number, iso2);
-        if (coreNumber) {
-          if (dialCode === UK.DIAL_CODE) {
-            if (coreNumber[0] === UK.MOBILE_PREFIX && coreNumber.length !== UK.MOBILE_CORE_LENGTH) {
-              return false;
-            }
+      const number = this.#getFullNumber();
+      const coreNumber = intlTelInput.utils.getCoreNumber(number, iso2);
+      if (coreNumber) {
+        if (dialCode === UK.DIAL_CODE) {
+          if (coreNumber[0] === UK.MOBILE_PREFIX && coreNumber.length !== UK.MOBILE_CORE_LENGTH) {
+            return false;
           }
-          const hasAlphaChar = REGEX.ALPHA_UNICODE.test(number);
-          if (!hasAlphaChar && dialCode) {
-            const nationalPortion = number.startsWith("+") ? number.slice(1 + dialCode.length) : number;
-            const nationalDigitCount = getNumeric(nationalPortion).length;
-            if (coreNumber.length > nationalDigitCount) {
-              return false;
-            }
+        }
+        const hasAlphaChar = REGEX.ALPHA_UNICODE.test(number);
+        if (!hasAlphaChar && dialCode) {
+          const nationalPortion = number.startsWith("+") ? number.slice(1 + dialCode.length) : number;
+          const nationalDigitCount = getNumeric(nationalPortion).length;
+          if (coreNumber.length > nationalDigitCount) {
+            return false;
           }
         }
       }
@@ -4214,6 +4214,10 @@ var factoryOutput = (() => {
     }
     //* Validate the input val with precise validation
     isValidNumberPrecise() {
+      if (this.#destroyed) {
+        return null;
+      }
+      ensureUtils("isValidNumberPrecise");
       return this.#validateNumber(true);
     }
     #utilsIsPossibleNumber(val) {
@@ -4225,13 +4229,10 @@ var factoryOutput = (() => {
     }
     //* Shared internal validation logic to handle alpha character extension rules.
     #validateNumber(precise) {
-      if (!intlTelInput.utils || !this.#ui.telInput) {
-        return null;
-      }
       const { allowNumberExtensions, allowPhonewords } = this.#options;
       const testValidity = (s) => precise ? this.#utilsIsValidNumber(s) : this.#utilsIsPossibleNumber(s);
       const val = this.#getFullNumber();
-      if (!this.#selectedCountryData?.iso2) {
+      if (!this.#selectedCountryData) {
         const isRegionlessDialCode = hasRegionlessDialCode(val);
         if (!isRegionlessDialCode) {
           return false;
@@ -4261,7 +4262,7 @@ var factoryOutput = (() => {
     }
     //* Update the selected country, and update the input val accordingly.
     setCountry(iso2) {
-      if (!this.#ui.telInput) {
+      if (this.#destroyed) {
         return;
       }
       const iso2Lower = iso2?.toLowerCase();
@@ -4282,7 +4283,7 @@ var factoryOutput = (() => {
     }
     //* Set the input value and update the country.
     setNumber(number) {
-      if (!this.#ui.telInput) {
+      if (this.#destroyed) {
         return;
       }
       const normalisedNumber = this.#numerals.normalise(number);
@@ -4293,16 +4294,17 @@ var factoryOutput = (() => {
       }
       this.#trigger(EVENTS.INPUT, { isSetNumber: true });
     }
-    //* Set the placeholder number typ
+    //* Set the placeholder number type
     setPlaceholderNumberType(type) {
-      if (!this.#ui.telInput) {
+      if (this.#destroyed) {
         return;
       }
       this.#options.placeholderNumberType = type;
       this.#updatePlaceholder();
     }
+    // Set the disabled state of the input and dropdown.
     setDisabled(disabled) {
-      if (!this.#ui.telInput) {
+      if (this.#destroyed) {
         return;
       }
       this.#ui.telInput.disabled = disabled;
@@ -4314,6 +4316,20 @@ var factoryOutput = (() => {
         }
       }
     }
+    // Set the readonly state of the input and dropdown.
+    setReadonly(readonly) {
+      if (!this.#ui.telInput) {
+        return;
+      }
+      this.#ui.telInput.readOnly = readonly;
+      if (this.#ui.selectedCountry) {
+        if (readonly) {
+          this.#ui.selectedCountry.setAttribute("disabled", "true");
+        } else {
+          this.#ui.selectedCountry.removeAttribute("disabled");
+        }
+      }
+    }
     //********************
     //*  STATIC METHODS
     //********************
@@ -4321,7 +4337,7 @@ var factoryOutput = (() => {
     // Kept public so module-level helpers (e.g. attachUtils) can call it, while still allowing
     // access to private instance methods.
     static forEachInstance(method, ...args) {
-      const values = Object.values(intlTelInput.instances);
+      const values = [...intlTelInput.instances.values()];
       const arg = args[0];
       values.forEach((instance) => {
         if (!(instance instanceof _Iti)) {
@@ -4381,7 +4397,7 @@ var factoryOutput = (() => {
   var intlTelInput = Object.assign(
     (input, options) => {
       const iti = new Iti(input, options);
-      intlTelInput.instances[iti.id] = iti;
+      intlTelInput.instances.set(String(iti.id), iti);
       input.iti = iti;
       return iti;
     },
@@ -4394,20 +4410,17 @@ var factoryOutput = (() => {
       //* A getter for the plugin instance.
       getInstance: (input) => {
         const id2 = input.dataset.intlTelInputId;
-        return id2 ? intlTelInput.instances[id2] : null;
+        return id2 ? intlTelInput.instances.get(id2) ?? null : null;
       },
       //* A map from instance ID to instance object.
-      instances: {},
+      instances: /* @__PURE__ */ new Map(),
       attachUtils,
       startedLoadingUtilsScript: false,
       startedLoadingAutoCountry: false,
-      version: "26.9.2"
+      version: "27.0.0"
     }
   );
   var intl_tel_input_default = intlTelInput;
   return __toCommonJS(intl_tel_input_exports);
 })();
-
-// UMD
-  return factoryOutput.default;
-}));
+var intlTelInput = _factory.default;