intl-tel-input 26.9.2 → 27.0.0

package/{react/build/IntlTelInput.cjs → dist/js/intlTelInput.mjs}

@@ -1,40 +1,4 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// react/src/intl-tel-input/react.tsx
-var react_exports = {};
-__export(react_exports, {
-  default: () => react_default,
-  intlTelInput: () => intl_tel_input_default
-});
-module.exports = __toCommonJS(react_exports);
-
-// src/js/intl-tel-input/data.ts
+// src/js/data.ts
 var rawCountryData = [
   [
     "af",
@@ -1737,7 +1701,7 @@ var iso2Set = new Set(allCountries.map((c) => c.iso2));
 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",
@@ -1858,10 +1822,10 @@ var ARIA = {
   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",
@@ -1878,7 +1842,7 @@ var interfaceTranslations = {
 };
 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 = () => {
@@ -1915,7 +1879,7 @@ var defaults = {
   //* 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
@@ -1935,7 +1899,7 @@ var defaults = {
   //* 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.
@@ -1953,7 +1917,9 @@ var toString = (val) => JSON.stringify(val);
 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";
 };
@@ -2068,9 +2034,13 @@ var validateOptions = (customOptions) => {
         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;
       }
@@ -2154,7 +2124,7 @@ var applyOptionSideEffects = (o) => {
       o.fixDropdownWidth = true;
     }
   }
-  if (o.onlyCountries.length === 1) {
+  if (o.onlyCountries?.length === 1) {
     o.initialCountry = o.onlyCountries[0];
   }
   if (o.separateDialCode) {
@@ -2169,14 +2139,14 @@ var applyOptionSideEffects = (o) => {
   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 = [];
@@ -2221,7 +2191,7 @@ var findFirstCountryStartingWith = (countries, query) => {
   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);
@@ -2236,7 +2206,7 @@ var createEl = (tagName, attrs, container) => {
   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" />
@@ -2263,31 +2233,15 @@ var buildGlobeIcon = () => `
     <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;
@@ -2296,7 +2250,30 @@ var UI = class _UI {
   #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;
@@ -2312,6 +2289,9 @@ var UI = class _UI {
   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");
     }
@@ -2531,7 +2511,7 @@ var UI = class _UI {
       },
       this.#dropdownContent
     );
-    this.#searchNoResults.textContent = i18n.searchEmptyState;
+    this.#searchNoResults.textContent = i18n.searchEmptyState ?? null;
   }
   #maybeUpdateInputPaddingAndReveal() {
     if (this.countryContainer) {
@@ -2549,13 +2529,13 @@ var UI = class _UI {
           `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) {
@@ -2800,28 +2780,9 @@ var UI = class _UI {
     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() {
@@ -2845,10 +2806,10 @@ var UI = class _UI {
     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();
@@ -2863,6 +2824,8 @@ var UI = class _UI {
     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;
@@ -2917,7 +2880,9 @@ var UI = class _UI {
   }
   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);
     }
@@ -2946,7 +2911,7 @@ var UI = class _UI {
   }
 };
 
-// src/js/modules/data/country-data.ts
+// src/js/data/country-data.ts
 var processAllCountries = (options) => {
   const { onlyCountries, excludeCountries } = options;
   if (onlyCountries?.length) {
@@ -3051,7 +3016,7 @@ var cacheSearchTokens = (countries) => {
   }
 };
 
-// src/js/modules/data/intl-regionless.ts
+// src/js/data/intl-regionless.ts
 var REGIONLESS_DIAL_CODES = /* @__PURE__ */ new Set([
   "800",
   "808",
@@ -3067,7 +3032,7 @@ var hasRegionlessDialCode = (number) => {
   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) {
@@ -3080,8 +3045,8 @@ var beforeSetNumber = (fullNumber, hasValidDialCode, separateDialCode, selectedC
   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();
@@ -3089,7 +3054,7 @@ var formatNumberAsYouType = (fullNumber, telInputValue, utils, selectedCountryDa
   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;
@@ -3109,7 +3074,7 @@ var translateCursorPosition = (relevantChars, formattedValue, prevCaretPos, isDe
   return formattedValue.length;
 };
 
-// src/js/modules/data/nanp-regionless.ts
+// src/js/data/nanp-regionless.ts
 var regionlessNanpNumbers = /* @__PURE__ */ new Set([
   "800",
   "822",
@@ -3138,7 +3103,7 @@ var isRegionlessNanp = (number) => {
   return false;
 };
 
-// src/js/modules/core/numerals.ts
+// src/js/core/numerals.ts
 var Numerals = class {
   #userNumeralSet;
   constructor(initialValue) {
@@ -3185,7 +3150,26 @@ var Numerals = class {
 
 // 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;
@@ -3196,16 +3180,15 @@ var Iti = class _Iti {
   #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);
@@ -3238,37 +3221,19 @@ var Iti = class _Iti {
     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);
@@ -3293,7 +3258,7 @@ var Iti = class _Iti {
   //* 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;
@@ -3328,15 +3293,15 @@ var Iti = class _Iti {
     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 || "";
@@ -3405,12 +3370,12 @@ var Iti = class _Iti {
         });
       }
     } 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();
       }
@@ -3505,7 +3470,7 @@ var Iti = class _Iti {
           fullNumber,
           inputValue,
           intlTelInput.utils,
-          this.#selectedCountryData ?? {},
+          this.#selectedCountryData,
           separateDialCode
         );
         const newCaretPos = translateCursorPosition(
@@ -3522,7 +3487,7 @@ var Iti = class _Iti {
           inputValue,
           true,
           separateDialCode,
-          this.#selectedCountryData ?? {}
+          this.#selectedCountryData
         );
         this.#setTelInputValue(cleanNumber);
       }
@@ -3555,8 +3520,8 @@ var Iti = class _Iti {
             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;
@@ -3588,8 +3553,8 @@ var Iti = class _Iti {
         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);
@@ -3600,7 +3565,7 @@ var Iti = class _Iti {
         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);
@@ -3890,10 +3855,10 @@ var Iti = class _Iti {
   #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;
@@ -3941,14 +3906,14 @@ var Iti = class _Iti {
     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);
     }
@@ -4047,14 +4012,16 @@ var Iti = class _Iti {
       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 };
   }
@@ -4068,32 +4035,32 @@ var Iti = class _Iti {
   //**************************
   //* 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) {
@@ -4101,74 +4068,77 @@ var Iti = class _Iti {
       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() {
@@ -4176,32 +4146,35 @@ var Iti = class _Iti {
   }
   //* 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;
         }
       }
     }
@@ -4209,6 +4182,10 @@ var Iti = class _Iti {
   }
   //* Validate the input val with precise validation
   isValidNumberPrecise() {
+    if (this.#destroyed) {
+      return null;
+    }
+    ensureUtils("isValidNumberPrecise");
     return this.#validateNumber(true);
   }
   #utilsIsPossibleNumber(val) {
@@ -4220,13 +4197,10 @@ var Iti = class _Iti {
   }
   //* 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;
@@ -4256,7 +4230,7 @@ var Iti = class _Iti {
   }
   //* Update the selected country, and update the input val accordingly.
   setCountry(iso2) {
-    if (!this.#ui.telInput) {
+    if (this.#destroyed) {
       return;
     }
     const iso2Lower = iso2?.toLowerCase();
@@ -4277,7 +4251,7 @@ var Iti = class _Iti {
   }
   //* Set the input value and update the country.
   setNumber(number) {
-    if (!this.#ui.telInput) {
+    if (this.#destroyed) {
       return;
     }
     const normalisedNumber = this.#numerals.normalise(number);
@@ -4288,16 +4262,17 @@ var Iti = class _Iti {
     }
     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;
@@ -4309,6 +4284,20 @@ var Iti = class _Iti {
       }
     }
   }
+  // 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
   //********************
@@ -4316,7 +4305,7 @@ var Iti = class _Iti {
   // 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)) {
@@ -4356,8 +4345,8 @@ var attachUtils = (source) => {
       );
     }
     intlTelInput.startedLoadingUtilsScript = true;
-    return loadCall.then((module2) => {
-      const utils = module2?.default;
+    return loadCall.then((module) => {
+      const utils = module?.default;
       if (!utils || typeof utils !== "object") {
         throw new TypeError(
           "The loader function passed to attachUtils did not resolve to a module object with utils as its default export."
@@ -4376,7 +4365,7 @@ var attachUtils = (source) => {
 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;
   },
@@ -4389,117 +4378,18 @@ var intlTelInput = Object.assign(
     //* 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;
-
-// react/src/intl-tel-input/react.tsx
-var import_react = __toESM(require("react"));
-var IntlTelInput = (0, import_react.forwardRef)(function IntlTelInput2({
-  initialValue = "",
-  onChangeNumber = () => {
-  },
-  onChangeCountry = () => {
-  },
-  onChangeValidity = () => {
-  },
-  onChangeErrorCode = () => {
-  },
-  usePreciseValidation = false,
-  initOptions = {},
-  inputProps = {},
-  disabled = void 0
-}, ref) {
-  const inputRef = (0, import_react.useRef)(null);
-  const itiRef = (0, import_react.useRef)(null);
-  const lastEmittedNumberRef = (0, import_react.useRef)();
-  const lastEmittedCountryRef = (0, import_react.useRef)();
-  const lastEmittedValidityRef = (0, import_react.useRef)();
-  const lastEmittedErrorCodeRef = (0, import_react.useRef)();
-  (0, import_react.useImperativeHandle)(ref, () => ({
-    getInstance: () => itiRef.current,
-    getInput: () => inputRef.current
-  }));
-  const update = (0, import_react.useCallback)(() => {
-    if (!itiRef.current?.isActive()) {
-      return;
-    }
-    const num = itiRef.current?.getNumber() || "";
-    const countryIso = itiRef.current?.getSelectedCountryData().iso2 || "";
-    if (num !== lastEmittedNumberRef.current) {
-      lastEmittedNumberRef.current = num;
-      onChangeNumber(num);
-    }
-    if (countryIso !== lastEmittedCountryRef.current) {
-      lastEmittedCountryRef.current = countryIso;
-      onChangeCountry(countryIso);
-    }
-    if (itiRef.current) {
-      const isValid = usePreciseValidation ? itiRef.current.isValidNumberPrecise() : itiRef.current.isValidNumber();
-      const errorCode = isValid ? null : itiRef.current.getValidationError();
-      if (isValid !== lastEmittedValidityRef.current) {
-        lastEmittedValidityRef.current = isValid;
-        onChangeValidity(isValid);
-      }
-      if (errorCode !== lastEmittedErrorCodeRef.current) {
-        lastEmittedErrorCodeRef.current = errorCode;
-        onChangeErrorCode(errorCode);
-      }
-    }
-  }, [
-    onChangeCountry,
-    onChangeErrorCode,
-    onChangeNumber,
-    onChangeValidity,
-    usePreciseValidation
-  ]);
-  (0, import_react.useEffect)(() => {
-    if (inputRef.current) {
-      itiRef.current = intl_tel_input_default(inputRef.current, initOptions);
-    }
-    return () => {
-      itiRef.current?.destroy();
-    };
-  }, []);
-  (0, import_react.useEffect)(() => {
-    const inputRefCurrent = inputRef.current;
-    if (inputRefCurrent) {
-      inputRefCurrent.addEventListener("countrychange", update);
-      itiRef.current.promise.then(update);
-    }
-    return () => {
-      if (inputRefCurrent) {
-        inputRefCurrent.removeEventListener("countrychange", update);
-      }
-    };
-  }, [update]);
-  (0, import_react.useEffect)(() => {
-    if (itiRef.current && disabled !== void 0) {
-      itiRef.current.setDisabled(disabled);
-    }
-  }, [disabled]);
-  const {
-    value: _value,
-    // disabled: _disabled,
-    ...sanitizedInputProps
-  } = inputProps;
-  return /* @__PURE__ */ import_react.default.createElement(
-    "input",
-    {
-      ...sanitizedInputProps,
-      type: "tel",
-      ref: inputRef,
-      onInput: update,
-      defaultValue: initialValue
-    }
-  );
-});
-var react_default = IntlTelInput;
+export {
+  Iti,
+  intl_tel_input_default as default
+};