intl-tel-input 27.3.0 → 28.0.0

package/dist/js/intlTelInput.js

@@ -1,5 +1,5 @@
 /*
- * International Telephone Input v27.3.0
+ * International Telephone Input v28.0.0
  * git+https://github.com/jackocnr/intl-tel-input.git
  * Licensed under the MIT license
  */
@@ -23,14 +23,17 @@ var _factory = (() => {
   };
   var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-  // src/js/intlTelInput.ts
+  // packages/core/src/js/intlTelInput.ts
   var intlTelInput_exports = {};
   __export(intlTelInput_exports, {
     Iti: () => Iti,
+    NUMBER_FORMAT: () => NUMBER_FORMAT,
+    NUMBER_TYPE: () => NUMBER_TYPE,
+    VALIDATION_ERROR: () => VALIDATION_ERROR,
     default: () => intlTelInput_default
   });
 
-  // src/js/data.ts
+  // packages/core/src/js/data.ts
   var rawCountryData = [
     [
       "af",
@@ -1775,20 +1778,14 @@ var _factory = (() => {
       dialCode: c[1],
       priority: c[2] || 0,
       areaCodes: c[3] || null,
-      nationalPrefix: c[4] || null,
-      normalisedName: "",
-      // populated in the plugin
-      initials: "",
-      // populated in the plugin
-      dialCodePlus: ""
-      // populated in the plugin
+      nationalPrefix: c[4] || null
     });
   }
   var iso2Set = new Set(allCountries.map((c) => c.iso2));
   var isIso2 = (val) => iso2Set.has(val);
   var data_default = allCountries;
 
-  // src/js/constants.ts
+  // packages/core/src/js/constants.ts
   var EVENTS = {
     OPEN_COUNTRY_DROPDOWN: "open:countrydropdown",
     CLOSE_COUNTRY_DROPDOWN: "close:countrydropdown",
@@ -1834,10 +1831,6 @@ var _factory = (() => {
     HIDDEN_SEARCH_RESET_MS: 1e3,
     NEXT_TICK: 0
   };
-  var SENTINELS = {
-    UNKNOWN_NUMBER_TYPE: -99,
-    UNKNOWN_VALIDATION_ERROR: -99
-  };
   var LAYOUT = {
     NARROW_VIEWPORT_WIDTH: 500,
     // keep in sync with .iti__country-list CSS media query
@@ -1879,6 +1872,12 @@ var _factory = (() => {
   var INITIAL_COUNTRY = {
     AUTO: "auto"
   };
+  var NUMBER_FORMATS = [
+    "E164",
+    "INTERNATIONAL",
+    "NATIONAL",
+    "RFC3966"
+  ];
   var NUMBER_TYPES = [
     "FIXED_LINE",
     "MOBILE",
@@ -1893,11 +1892,21 @@ var _factory = (() => {
     "VOICEMAIL",
     "UNKNOWN"
   ];
-  var NUMBER_TYPE_SET = new Set(NUMBER_TYPES);
+  var VALIDATION_ERRORS = [
+    "IS_POSSIBLE",
+    "INVALID_COUNTRY_CODE",
+    "TOO_SHORT",
+    "TOO_LONG",
+    "IS_POSSIBLE_LOCAL_ONLY",
+    "INVALID_LENGTH"
+  ];
+  var toEnumObject = (arr) => Object.fromEntries(arr.map((v) => [v, v]));
+  var NUMBER_FORMAT = toEnumObject(NUMBER_FORMATS);
+  var NUMBER_TYPE = toEnumObject(NUMBER_TYPES);
+  var VALIDATION_ERROR = toEnumObject(VALIDATION_ERRORS);
   var DATA_KEYS = {
-    // e.g. <li data-country-code="us"> for country items in dropdown
-    // in the future, the value should be changed to "iso2", but this is a breaking change for another day
-    ISO2: "countryCode",
+    // e.g. <li data-iso2="us"> for country items in dropdown
+    ISO2: "iso2",
     DIAL_CODE: "dialCode",
     // e.g. <input data-intl-tel-input-id="0"> on the input element
     INSTANCE_ID: "intlTelInputId"
@@ -1914,7 +1923,7 @@ var _factory = (() => {
     MODAL: "aria-modal"
   };
 
-  // src/js/i18n/en.ts
+  // packages/core/src/js/i18n/en.ts
   var interfaceTranslations = {
     selectedCountryAriaLabel: "Change country for phone number, currently selected ${countryName} (${dialCode})",
     noCountrySelected: "Select country for phone number",
@@ -1934,7 +1943,7 @@ var _factory = (() => {
   };
   var en_default = interfaceTranslations;
 
-  // src/js/core/options.ts
+  // packages/core/src/js/core/options.ts
   var mediaQuery = (q) => typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia(q).matches;
   var isNarrowViewport = () => mediaQuery(`(max-width: ${LAYOUT.NARROW_VIEWPORT_WIDTH}px)`);
   var computeDefaultUseFullscreenPopup = () => {
@@ -1949,7 +1958,7 @@ var _factory = (() => {
     //* Whether or not to allow the dropdown.
     allowDropdown: true,
     //* The number type to enforce during validation.
-    allowedNumberTypes: ["MOBILE", "FIXED_LINE"],
+    allowedNumberTypes: [NUMBER_TYPE.MOBILE, NUMBER_TYPE.FIXED_LINE],
     //* Whether or not to allow extensions after the main number.
     allowNumberExtensions: false,
     // Allow alphanumeric "phonewords" (e.g. +1 800 FLOWERS) as valid numbers
@@ -1960,6 +1969,8 @@ var _factory = (() => {
     containerClass: "",
     //* Locale for localising country names via Intl.DisplayNames.
     countryNameLocale: "en",
+    //* Override individual country names by iso2 code.
+    countryNameOverrides: {},
     //* The order of the countries in the dropdown. Defaults to alphabetical.
     countryOrder: null,
     //* Add a country search input at the top of the dropdown.
@@ -1993,17 +2004,17 @@ var _factory = (() => {
     //* Display only these countries.
     onlyCountries: null,
     //* Number type to use for placeholders.
-    placeholderNumberType: "MOBILE",
+    placeholderNumberType: NUMBER_TYPE.MOBILE,
     //* Add custom classes to the search input element.
     searchInputClass: "",
     //* Display the international dial code next to the selected flag.
-    separateDialCode: false,
+    separateDialCode: true,
     //* When strictMode rejects a key (etc), play a short feedback animation
-    strictRejectAnimation: false,
+    strictRejectAnimation: true,
     //* Show flags - for both the selected country, and in the country dropdown
     showFlags: true,
     //* Only allow certain chars e.g. a plus followed by numeric digits, and cap at max valid length.
-    strictMode: false,
+    strictMode: true,
     //* Use full screen popup instead of dropdown for country list.
     useFullscreenPopup: computeDefaultUseFullscreenPopup()
   };
@@ -2147,6 +2158,13 @@ var _factory = (() => {
           }
           validatedOptions[key] = value;
           break;
+        case "countryNameOverrides":
+          if (value && !isPlainObject(value)) {
+            warnOption("countryNameOverrides", "an object", value);
+            break;
+          }
+          validatedOptions[key] = value;
+          break;
         case "initialCountry": {
           if (typeof value !== "string") {
             warnOption("initialCountry", "a string", value);
@@ -2165,8 +2183,8 @@ var _factory = (() => {
           break;
         }
         case "placeholderNumberType":
-          if (typeof value !== "string" || !NUMBER_TYPE_SET.has(value)) {
-            const validTypes = Array.from(NUMBER_TYPE_SET).join(", ");
+          if (typeof value !== "string" || !NUMBER_TYPES.includes(value)) {
+            const validTypes = NUMBER_TYPES.join(", ");
             warnOption("placeholderNumberType", `one of ${validTypes}`, value);
             break;
           }
@@ -2184,8 +2202,8 @@ var _factory = (() => {
             }
             let allValid = true;
             for (const v of value) {
-              if (typeof v !== "string" || !NUMBER_TYPE_SET.has(v)) {
-                const validTypes = Array.from(NUMBER_TYPE_SET).join(", ");
+              if (typeof v !== "string" || !NUMBER_TYPES.includes(v)) {
+                const validTypes = NUMBER_TYPES.join(", ");
                 warnOption(
                   "allowedNumberTypes",
                   `an array of valid number types (${validTypes})`,
@@ -2247,11 +2265,11 @@ var _factory = (() => {
     o.i18n = { ...en_default, ...o.i18n };
   };
 
-  // src/js/helpers/string.ts
+  // packages/core/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/helpers/dom.ts
+  // packages/core/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);
@@ -2266,7 +2284,7 @@ var _factory = (() => {
     return el;
   };
 
-  // src/js/core/icons.ts
+  // packages/core/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" />
@@ -2293,8 +2311,21 @@ var _factory = (() => {
     <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/core/countrySearch.ts
-  var getMatchedCountries = (countries, query) => {
+  // packages/core/src/js/core/countrySearch.ts
+  var buildSearchTokens = (countries) => {
+    const tokens = /* @__PURE__ */ new Map();
+    for (const c of countries) {
+      const normalisedName = normaliseString(c.name);
+      const initials = normalisedName.split(/[^a-z]/).map((word) => word[0]).join("");
+      tokens.set(c.iso2, {
+        normalisedName,
+        initials,
+        dialCodePlus: `+${c.dialCode}`
+      });
+    }
+    return tokens;
+  };
+  var getMatchedCountries = (countries, searchTokens, query) => {
     const normalisedQuery = normaliseString(query);
     const iso2Matches = [];
     const nameStartsWith = [];
@@ -2303,17 +2334,18 @@ var _factory = (() => {
     const dialCodeContains = [];
     const initialsMatches = [];
     for (const c of countries) {
+      const t = searchTokens.get(c.iso2);
       if (c.iso2 === normalisedQuery) {
         iso2Matches.push(c);
-      } else if (c.normalisedName.startsWith(normalisedQuery)) {
+      } else if (t.normalisedName.startsWith(normalisedQuery)) {
         nameStartsWith.push(c);
-      } else if (c.normalisedName.includes(normalisedQuery)) {
+      } else if (t.normalisedName.includes(normalisedQuery)) {
         nameContains.push(c);
-      } else if (normalisedQuery === c.dialCode || normalisedQuery === c.dialCodePlus) {
+      } else if (normalisedQuery === c.dialCode || normalisedQuery === t.dialCodePlus) {
         dialCodeMatches.push(c);
-      } else if (c.dialCodePlus.includes(normalisedQuery)) {
+      } else if (t.dialCodePlus.includes(normalisedQuery)) {
         dialCodeContains.push(c);
-      } else if (c.initials.includes(normalisedQuery)) {
+      } else if (t.initials.includes(normalisedQuery)) {
         initialsMatches.push(c);
       }
     }
@@ -2328,17 +2360,76 @@ var _factory = (() => {
       ...initialsMatches
     ];
   };
-  var findFirstCountryStartingWith = (countries, query) => {
+  var findFirstCountryStartingWith = (countries, searchTokens, query) => {
     const normalisedQuery = normaliseString(query);
     for (const c of countries) {
-      if (c.normalisedName.startsWith(normalisedQuery)) {
+      const { normalisedName } = searchTokens.get(c.iso2);
+      if (normalisedName.startsWith(normalisedQuery)) {
         return c;
       }
     }
     return null;
   };
 
-  // src/js/core/ui.ts
+  // packages/core/src/js/core/numerals.ts
+  var Numerals = class _Numerals {
+    #userNumeralSet;
+    //* Stateless conversion of any Arabic-Indic / Persian digits to ASCII 0-9.
+    //* Use this when you need to normalise digits without affecting any instance's tracked numeral set (e.g. for the country-search query).
+    static toAscii(str) {
+      if (!str) {
+        return "";
+      }
+      return str.replace(
+        /[٠-٩]/g,
+        (ch) => String.fromCharCode(48 + (ch.charCodeAt(0) - 1632))
+      ).replace(
+        /[۰-۹]/g,
+        (ch) => String.fromCharCode(48 + (ch.charCodeAt(0) - 1776))
+      );
+    }
+    constructor(initialValue) {
+      if (initialValue) {
+        this.#updateNumeralSet(initialValue);
+      }
+    }
+    // If any Arabic-Indic digits, then label it as that set. Same for Persian. Otherwise assume ASCII.
+    #updateNumeralSet(str) {
+      if (/[٠-٩]/.test(str)) {
+        this.#userNumeralSet = "arabic-indic";
+      } else if (/[۰-۹]/.test(str)) {
+        this.#userNumeralSet = "persian";
+      } else {
+        this.#userNumeralSet = "ascii";
+      }
+    }
+    // Denormalise ASCII 0-9 to the user's numeral set. If not yet known, return as-is.
+    // NOTE: normalise is always called before this, so it should be impossible for the numeral set to be unknown at this point.
+    denormalise(str) {
+      if (!this.#userNumeralSet || this.#userNumeralSet === "ascii") {
+        return str;
+      }
+      const base = this.#userNumeralSet === "arabic-indic" ? 1632 : 1776;
+      return str.replace(/[0-9]/g, (d) => String.fromCharCode(base + Number(d)));
+    }
+    // Normalize Eastern Arabic (U+0660-0669) and Persian/Extended Arabic-Indic (U+06F0-06F9) numerals to ASCII 0-9.
+    // Tracks the user's numeral set as a side effect so denormalise can mirror it back.
+    normalise(str) {
+      if (!str) {
+        return "";
+      }
+      this.#updateNumeralSet(str);
+      if (this.#userNumeralSet === "ascii") {
+        return str;
+      }
+      return _Numerals.toAscii(str);
+    }
+    isAscii() {
+      return !this.#userNumeralSet || this.#userNumeralSet === "ascii";
+    }
+  };
+
+  // packages/core/src/js/core/ui.ts
   var UI = class _UI {
     // private
     #options;
@@ -2346,6 +2437,7 @@ var _factory = (() => {
     #isRTL;
     #originalPaddingLeft = "";
     #countries;
+    #searchTokens;
     #searchDebounceTimer = null;
     #inlineDropdownHeight;
     #countryContainerEl;
@@ -2391,8 +2483,9 @@ var _factory = (() => {
       }
     }
     //* Generate all of the markup for the plugin: the selected country overlay, and the dropdown.
-    buildMarkup(countries) {
+    buildMarkup(countries, searchTokens) {
       this.#countries = countries;
+      this.#searchTokens = searchTokens;
       this.telInputEl.classList.add("iti__tel-input");
       if (!this.telInputEl.hasAttribute("type")) {
         this.telInputEl.setAttribute("type", "tel");
@@ -2760,7 +2853,12 @@ var _factory = (() => {
       if (query === "") {
         matchedCountries = this.#countries;
       } else {
-        matchedCountries = getMatchedCountries(this.#countries, query);
+        const normalisedQuery = Numerals.toAscii(query);
+        matchedCountries = getMatchedCountries(
+          this.#countries,
+          this.#searchTokens,
+          normalisedQuery
+        );
       }
       this.#showFilteredCountries(matchedCountries);
     }
@@ -3055,7 +3153,11 @@ var _factory = (() => {
     }
     //* Hidden search (countrySearch disabled): jump to the first list item whose name starts with the query.
     #searchForCountry(query) {
-      const match = findFirstCountryStartingWith(this.#countries, query);
+      const match = findFirstCountryStartingWith(
+        this.#countries,
+        this.#searchTokens,
+        query
+      );
       if (match) {
         const listItem = this.#listItemByIso2.get(match.iso2);
         this.#highlightListItem(listItem);
@@ -3080,7 +3182,7 @@ var _factory = (() => {
       }
       if (iso2 && !this.#selectedListItemEl) {
         const newListItem = this.#countryListEl.querySelector(
-          `[data-country-code="${iso2}"]`
+          `[data-iso2="${iso2}"]`
         );
         if (newListItem) {
           newListItem.setAttribute(ARIA.SELECTED, "true");
@@ -3268,7 +3370,7 @@ var _factory = (() => {
     }
   };
 
-  // src/js/data/country-data.ts
+  // packages/core/src/js/data/country-data.ts
   var processAllCountries = (options) => {
     const { onlyCountries, excludeCountries } = options;
     if (onlyCountries?.length) {
@@ -3283,7 +3385,7 @@ var _factory = (() => {
     return [...data_default];
   };
   var generateCountryNames = (countries, options) => {
-    const { countryNameLocale, i18n } = options;
+    const { countryNameLocale, countryNameOverrides } = options;
     let displayNames;
     try {
       const hasDisplayNames = typeof Intl !== "undefined" && typeof Intl.DisplayNames === "function";
@@ -3299,7 +3401,7 @@ var _factory = (() => {
       displayNames = null;
     }
     for (const c of countries) {
-      c.name = i18n[c.iso2] || displayNames?.of(c.iso2.toUpperCase()) || "";
+      c.name = countryNameOverrides[c.iso2] || displayNames?.of(c.iso2.toUpperCase()) || "";
     }
   };
   var processDialCodes = (countries) => {
@@ -3367,15 +3469,8 @@ var _factory = (() => {
       return a.name.localeCompare(b.name);
     });
   };
-  var cacheSearchTokens = (countries) => {
-    for (const c of countries) {
-      c.normalisedName = normaliseString(c.name);
-      c.initials = c.normalisedName.split(/[^a-z]/).map((word) => word[0]).join("");
-      c.dialCodePlus = `+${c.dialCode}`;
-    }
-  };
 
-  // src/js/data/intl-regionless.ts
+  // packages/core/src/js/data/intl-regionless.ts
   var regionlessDialCodes = /* @__PURE__ */ new Set([
     "800",
     "808",
@@ -3391,7 +3486,7 @@ var _factory = (() => {
     return number.startsWith("+") && regionlessDialCodes.has(dialCode);
   };
 
-  // src/js/format/formatting.ts
+  // packages/core/src/js/format/formatting.ts
   var stripSeparateDialCode = (fullNumber, hasValidDialCode, separateDialCode, selectedCountryData) => {
     if (!separateDialCode || !hasValidDialCode) {
       return fullNumber;
@@ -3410,7 +3505,7 @@ var _factory = (() => {
     return result;
   };
 
-  // src/js/format/caret.ts
+  // packages/core/src/js/format/caret.ts
   var computeNewCaretPosition = (relevantChars, formattedValue, prevCaretPos, isDeleteForwards) => {
     if (prevCaretPos === 0 && !isDeleteForwards) {
       return 0;
@@ -3430,7 +3525,7 @@ var _factory = (() => {
     return formattedValue.length;
   };
 
-  // src/js/data/nanp-regionless.ts
+  // packages/core/src/js/data/nanp-regionless.ts
   var regionlessNanpAreaCodes = /* @__PURE__ */ new Set([
     "800",
     "822",
@@ -3459,55 +3554,7 @@ var _factory = (() => {
     return false;
   };
 
-  // src/js/core/numerals.ts
-  var Numerals = class {
-    #userNumeralSet;
-    constructor(initialValue) {
-      if (initialValue) {
-        this.#updateNumeralSet(initialValue);
-      }
-    }
-    // If any Arabic-Indic digits, then label it as that set. Same for Persian. Otherwise assume ASCII.
-    #updateNumeralSet(str) {
-      if (/[\u0660-\u0669]/.test(str)) {
-        this.#userNumeralSet = "arabic-indic";
-      } else if (/[\u06F0-\u06F9]/.test(str)) {
-        this.#userNumeralSet = "persian";
-      } else {
-        this.#userNumeralSet = "ascii";
-      }
-    }
-    // Denormalise ASCII 0-9 to the user's numeral set. If not yet known, return as-is.
-    // NOTE: normalise is always called before this, so it should be impossible for the numeral set to be unknown at this point.
-    denormalise(str) {
-      if (!this.#userNumeralSet || this.#userNumeralSet === "ascii") {
-        return str;
-      }
-      const base = this.#userNumeralSet === "arabic-indic" ? 1632 : 1776;
-      return str.replace(/[0-9]/g, (d) => String.fromCharCode(base + Number(d)));
-    }
-    // Normalize Eastern Arabic (U+0660-0669) and Persian/Extended Arabic-Indic (U+06F0-06F9) numerals to ASCII 0-9
-    normalise(str) {
-      if (!str) {
-        return "";
-      }
-      this.#updateNumeralSet(str);
-      if (this.#userNumeralSet === "ascii") {
-        return str;
-      }
-      const base = this.#userNumeralSet === "arabic-indic" ? 1632 : 1776;
-      const regex = this.#userNumeralSet === "arabic-indic" ? /[\u0660-\u0669]/g : /[\u06F0-\u06F9]/g;
-      return str.replace(
-        regex,
-        (ch) => String.fromCharCode(48 + (ch.charCodeAt(0) - base))
-      );
-    }
-    isAscii() {
-      return !this.#userNumeralSet || this.#userNumeralSet === "ascii";
-    }
-  };
-
-  // src/js/intlTelInput.ts
+  // packages/core/src/js/intlTelInput.ts
   var nextId = 0;
   var ensureUtils = (methodName) => {
     if (!intlTelInput.utils) {
@@ -3541,6 +3588,7 @@ var _factory = (() => {
     #dialCodeToIso2Map;
     #dialCodes;
     #countryByIso2;
+    #searchTokens;
     #selectedCountry = null;
     #maxCoreNumberLength = null;
     #fallbackCountryIso2;
@@ -3597,7 +3645,7 @@ var _factory = (() => {
     #init() {
       this.#abortController = new AbortController();
       this.#processCountryData();
-      this.#ui.buildMarkup(this.#countries);
+      this.#ui.buildMarkup(this.#countries, this.#searchTokens);
       this.#setInitialState();
       this.#initListeners();
       this.#startAsyncLoads();
@@ -3612,7 +3660,7 @@ var _factory = (() => {
     #processCountryData() {
       generateCountryNames(this.#countries, this.#options);
       sortCountries(this.#countries, this.#options);
-      cacheSearchTokens(this.#countries);
+      this.#searchTokens = buildSearchTokens(this.#countries);
     }
     //* Set the initial state of the input value and the selected country by:
     //* 1. Extracting a dial code from the given number
@@ -3673,7 +3721,7 @@ var _factory = (() => {
       if (this.#utilsDeferred) {
         const { loadUtils } = this.#options;
         const doAttachUtils = () => {
-          intlTelInput.attachUtils(loadUtils)?.catch(() => {
+          intlTelInput.attachUtils(loadUtils).catch(() => {
           });
         };
         if (intlTelInput.documentReady()) {
@@ -3693,7 +3741,7 @@ var _factory = (() => {
       }
     }
     //* Perform the geo ip lookup.
-    #loadAutoCountry() {
+    async #loadAutoCountry() {
       if (intlTelInput.autoCountry) {
         this.#handleAutoCountryLoaded();
         return;
@@ -3704,19 +3752,18 @@ var _factory = (() => {
       }
       intlTelInput.startedLoadingAutoCountry = true;
       if (typeof this.#options.geoIpLookup === "function") {
-        const successCallback = (iso2 = "") => {
-          const iso2Lower = iso2.toLowerCase();
-          if (isIso2(iso2Lower)) {
-            intlTelInput.autoCountry = iso2Lower;
-            setTimeout(() => _Iti.forEachInstance("handleAutoCountryLoaded"));
-          } else {
+        try {
+          const iso2 = await this.#options.geoIpLookup();
+          const iso2Lower = typeof iso2 === "string" ? iso2.toLowerCase() : "";
+          if (!isIso2(iso2Lower)) {
             _Iti.forEachInstance("handleAutoCountryFailure");
+            return;
           }
-        };
-        const failureCallback = () => {
+          intlTelInput.autoCountry = iso2Lower;
+          setTimeout(() => _Iti.forEachInstance("handleAutoCountryLoaded"));
+        } catch {
           _Iti.forEachInstance("handleAutoCountryFailure");
-        };
-        this.#options.geoIpLookup(successCallback, failureCallback);
+        }
       }
     }
     #openDropdownWithPlus() {
@@ -3735,7 +3782,7 @@ var _factory = (() => {
     #bindAllTelInputListeners() {
       this.#bindInputListener();
       this.#bindKeydownListener();
-      this.#bindPasteListener();
+      this.#bindStrictPasteListener();
     }
     //* Android workaround for handling plus when separateDialCode enabled (as impossible to handle with keydown/keyup, for which e.key always returns "Unidentified", see https://stackoverflow.com/q/59584061/217866)
     #handleAndroidPlusKey(inputValue) {
@@ -3903,15 +3950,16 @@ var _factory = (() => {
         e.preventDefault();
       }
     };
-    #bindPasteListener() {
+    #bindStrictPasteListener() {
       if (!this.#options.strictMode) {
         return;
       }
-      this.#ui.telInputEl.addEventListener("paste", this.#handlePasteEvent, {
+      this.#ui.telInputEl.addEventListener("paste", this.#handleStrictPasteEvent, {
         signal: this.#abortController.signal
       });
     }
-    #handlePasteEvent = (e) => {
+    // Handle paste events when strictMode is enabled by sanitising the pasted content before it's inserted into the input, and rejecting it entirely if it would result in an invalid number
+    #handleStrictPasteEvent = (e) => {
       e.preventDefault();
       const input = this.#ui.telInputEl;
       const selStart = input.selectionStart;
@@ -3930,6 +3978,15 @@ var _factory = (() => {
       const sanitised = hasLeadingPlus && allowLeadingPlus ? `+${numerics}` : numerics;
       let newValue = before + sanitised + after;
       let rejectReason = sanitised !== pasted ? "invalid" : null;
+      if (newValue.length > 30) {
+        this.#playStrictRejectAnimation();
+        this.#dispatchEvent(EVENTS.STRICT_REJECT, {
+          source: "paste",
+          rejectedInput: pastedRaw,
+          reason: "max-length"
+        });
+        return;
+      }
       if (newValue.length > 5 && intlTelInput.utils) {
         let coreNumber = intlTelInput.utils.getCoreNumber(newValue, iso2);
         while (coreNumber.length === 0 && newValue.length > 0) {
@@ -4021,8 +4078,7 @@ var _factory = (() => {
       if (formatOnDisplay && intlTelInput.utils && this.#selectedCountry) {
         const isRegionless = hasRegionlessDialCode(fullNumber);
         const useNational = nationalMode && !isRegionless || !number.startsWith("+") && !separateDialCode;
-        const { NATIONAL, INTERNATIONAL } = intlTelInput.utils.numberFormat;
-        const format = useNational ? NATIONAL : INTERNATIONAL;
+        const format = useNational ? NUMBER_FORMAT.NATIONAL : NUMBER_FORMAT.INTERNATIONAL;
         number = intlTelInput.utils.formatNumber(
           number,
           this.#selectedCountry?.iso2,
@@ -4142,11 +4198,10 @@ var _factory = (() => {
         this.#maxCoreNumberLength = null;
         return;
       }
-      const numberType = intlTelInput.utils.numberType[placeholderNumberType];
       let exampleNumber = intlTelInput.utils.getExampleNumber(
         iso2,
         false,
-        numberType,
+        placeholderNumberType,
         true
       );
       let validNumber = exampleNumber;
@@ -4176,11 +4231,10 @@ var _factory = (() => {
       if (!intlTelInput.utils || !shouldSetPlaceholder) {
         return;
       }
-      const numberType = intlTelInput.utils.numberType[placeholderNumberType];
       let placeholder = this.#selectedCountry ? intlTelInput.utils.getExampleNumber(
         this.#selectedCountry.iso2,
         nationalMode,
-        numberType
+        placeholderNumberType
       ) : "";
       placeholder = this.#prepareNumberForInput(placeholder);
       if (typeof customPlaceholder === "function") {
@@ -4290,19 +4344,9 @@ var _factory = (() => {
       );
       return this.#truncateToMaxLength(number);
     }
-    //* Return only the public-facing subset of the selected country data.
-    #getPublicCountryData() {
-      const d = this.#selectedCountry;
-      if (!d) {
-        return null;
-      }
-      const { iso2, dialCode, name } = d;
-      return { iso2, dialCode, name };
-    }
     //* Dispatch the 'countrychange' event.
     #dispatchCountryChangeEvent() {
-      const countryData = this.#getPublicCountryData();
-      this.#dispatchEvent(EVENTS.COUNTRY_CHANGE, countryData);
+      this.#dispatchEvent(EVENTS.COUNTRY_CHANGE, this.#selectedCountry ?? null);
     }
     //**************************
     //*  INTERNAL METHODS
@@ -4393,7 +4437,7 @@ var _factory = (() => {
         this.#selectedCountry?.iso2
       );
     }
-    //* Format the number to the given format.
+    //* Format the number to the given format (defaults to "E164").
     getNumber(format) {
       if (!this.#isActive) {
         return "";
@@ -4408,10 +4452,10 @@ var _factory = (() => {
       );
       return this.#numerals.denormalise(formattedNumber);
     }
-    //* Get the type of the entered number e.g. landline/mobile.
+    //* Get the type of the entered number e.g. "FIXED_LINE" / "MOBILE", or null if it can't be determined / instance is destroyed.
     getNumberType() {
       if (!this.#isActive) {
-        return SENTINELS.UNKNOWN_NUMBER_TYPE;
+        return null;
       }
       ensureUtils("getNumberType");
       return intlTelInput.utils.getNumberType(
@@ -4421,12 +4465,12 @@ var _factory = (() => {
     }
     //* Get the country data for the currently selected country.
     getSelectedCountryData() {
-      return this.#getPublicCountryData();
+      return this.#selectedCountry ?? null;
     }
-    //* Get the validation error.
+    //* Get the validation error e.g. "TOO_SHORT" / "TOO_LONG", or null if it can't be determined / instance is destroyed.
     getValidationError() {
       if (!this.#isActive) {
-        return SENTINELS.UNKNOWN_VALIDATION_ERROR;
+        return null;
       }
       ensureUtils("getValidationError");
       const iso2 = this.#selectedCountry?.iso2;
@@ -4575,39 +4619,31 @@ var _factory = (() => {
       });
     }
   };
-  var attachUtils = (source) => {
-    if (!intlTelInput.utils && !intlTelInput.startedLoadingUtils) {
-      let loadCall;
-      if (typeof source === "function") {
-        try {
-          loadCall = Promise.resolve(source());
-        } catch (error) {
-          return Promise.reject(error);
-        }
-      } else {
-        return Promise.reject(
-          new TypeError(
-            `The argument passed to attachUtils must be a function that returns a promise for the utils module, not ${typeof source}`
-          )
+  var attachUtils = async (source) => {
+    if (intlTelInput.utils || intlTelInput.startedLoadingUtils) {
+      return null;
+    }
+    if (typeof source !== "function") {
+      throw new TypeError(
+        `The argument passed to attachUtils must be a function that returns a promise for the utils module, not ${typeof source}`
+      );
+    }
+    intlTelInput.startedLoadingUtils = true;
+    try {
+      const module = await source();
+      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."
         );
       }
-      intlTelInput.startedLoadingUtils = true;
-      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."
-          );
-        }
-        intlTelInput.utils = utils;
-        Iti.forEachInstance("handleUtilsLoaded");
-        return true;
-      }).catch((error) => {
-        Iti.forEachInstance("handleUtilsFailure", error);
-        throw error;
-      });
+      intlTelInput.utils = utils;
+      Iti.forEachInstance("handleUtilsLoaded");
+      return true;
+    } catch (error) {
+      Iti.forEachInstance("handleUtilsFailure", error);
+      throw error;
     }
-    return null;
   };
   var intlTelInput = Object.assign(
     (input, options) => {
@@ -4632,7 +4668,10 @@ var _factory = (() => {
       attachUtils,
       startedLoadingUtils: false,
       startedLoadingAutoCountry: false,
-      version: "27.3.0"
+      version: "28.0.0",
+      NUMBER_FORMAT,
+      NUMBER_TYPE,
+      VALIDATION_ERROR
     }
   );
   var intlTelInput_default = intlTelInput;