intl-tel-input 27.3.0 → 28.0.0

package/dist/js/intlTelInput.mjs

@@ -1,4 +1,4 @@
-// src/js/data.ts
+// packages/core/src/js/data.ts
 var rawCountryData = [
   [
     "af",
@@ -1743,20 +1743,14 @@ for (const c of rawCountryData) {
     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",
@@ -1802,10 +1796,6 @@ var TIMINGS = {
   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
@@ -1847,6 +1837,12 @@ var PLACEHOLDER_MODES = {
 var INITIAL_COUNTRY = {
   AUTO: "auto"
 };
+var NUMBER_FORMATS = [
+  "E164",
+  "INTERNATIONAL",
+  "NATIONAL",
+  "RFC3966"
+];
 var NUMBER_TYPES = [
   "FIXED_LINE",
   "MOBILE",
@@ -1861,11 +1857,21 @@ var NUMBER_TYPES = [
   "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"
@@ -1882,7 +1888,7 @@ var ARIA = {
   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",
@@ -1902,7 +1908,7 @@ var interfaceTranslations = {
 };
 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 = () => {
@@ -1917,7 +1923,7 @@ var defaults = {
   //* 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
@@ -1928,6 +1934,8 @@ var defaults = {
   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.
@@ -1961,17 +1969,17 @@ var defaults = {
   //* 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()
 };
@@ -2115,6 +2123,13 @@ var validateOptions = (customOptions) => {
         }
         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);
@@ -2133,8 +2148,8 @@ var validateOptions = (customOptions) => {
         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;
         }
@@ -2152,8 +2167,8 @@ var validateOptions = (customOptions) => {
           }
           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})`,
@@ -2215,11 +2230,11 @@ var applyOptionSideEffects = (o) => {
   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);
@@ -2234,7 +2249,7 @@ var createEl = (tagName, attrs, container) => {
   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" />
@@ -2261,8 +2276,21 @@ 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/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 = [];
@@ -2271,17 +2299,18 @@ var getMatchedCountries = (countries, query) => {
   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);
     }
   }
@@ -2296,17 +2325,76 @@ var getMatchedCountries = (countries, query) => {
     ...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;
@@ -2314,6 +2402,7 @@ var UI = class _UI {
   #isRTL;
   #originalPaddingLeft = "";
   #countries;
+  #searchTokens;
   #searchDebounceTimer = null;
   #inlineDropdownHeight;
   #countryContainerEl;
@@ -2359,8 +2448,9 @@ var UI = class _UI {
     }
   }
   //* 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");
@@ -2728,7 +2818,12 @@ var UI = class _UI {
     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);
   }
@@ -3023,7 +3118,11 @@ var UI = class _UI {
   }
   //* 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);
@@ -3048,7 +3147,7 @@ var UI = class _UI {
     }
     if (iso2 && !this.#selectedListItemEl) {
       const newListItem = this.#countryListEl.querySelector(
-        `[data-country-code="${iso2}"]`
+        `[data-iso2="${iso2}"]`
       );
       if (newListItem) {
         newListItem.setAttribute(ARIA.SELECTED, "true");
@@ -3236,7 +3335,7 @@ var UI = class _UI {
   }
 };
 
-// src/js/data/country-data.ts
+// packages/core/src/js/data/country-data.ts
 var processAllCountries = (options) => {
   const { onlyCountries, excludeCountries } = options;
   if (onlyCountries?.length) {
@@ -3251,7 +3350,7 @@ var processAllCountries = (options) => {
   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";
@@ -3267,7 +3366,7 @@ var generateCountryNames = (countries, options) => {
     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) => {
@@ -3335,15 +3434,8 @@ var sortCountries = (countries, options) => {
     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",
@@ -3359,7 +3451,7 @@ var hasRegionlessDialCode = (number) => {
   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;
@@ -3378,7 +3470,7 @@ var formatNumberAsYouType = (fullNumber, telInputValue, utils, selectedCountryDa
   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;
@@ -3398,7 +3490,7 @@ var computeNewCaretPosition = (relevantChars, formattedValue, prevCaretPos, isDe
   return formattedValue.length;
 };
 
-// src/js/data/nanp-regionless.ts
+// packages/core/src/js/data/nanp-regionless.ts
 var regionlessNanpAreaCodes = /* @__PURE__ */ new Set([
   "800",
   "822",
@@ -3427,55 +3519,7 @@ var isRegionlessNanp = (number) => {
   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) {
@@ -3509,6 +3553,7 @@ var Iti = class _Iti {
   #dialCodeToIso2Map;
   #dialCodes;
   #countryByIso2;
+  #searchTokens;
   #selectedCountry = null;
   #maxCoreNumberLength = null;
   #fallbackCountryIso2;
@@ -3565,7 +3610,7 @@ var Iti = class _Iti {
   #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();
@@ -3580,7 +3625,7 @@ var Iti = class _Iti {
   #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
@@ -3641,7 +3686,7 @@ var Iti = class _Iti {
     if (this.#utilsDeferred) {
       const { loadUtils } = this.#options;
       const doAttachUtils = () => {
-        intlTelInput.attachUtils(loadUtils)?.catch(() => {
+        intlTelInput.attachUtils(loadUtils).catch(() => {
         });
       };
       if (intlTelInput.documentReady()) {
@@ -3661,7 +3706,7 @@ var Iti = class _Iti {
     }
   }
   //* Perform the geo ip lookup.
-  #loadAutoCountry() {
+  async #loadAutoCountry() {
     if (intlTelInput.autoCountry) {
       this.#handleAutoCountryLoaded();
       return;
@@ -3672,19 +3717,18 @@ var Iti = class _Iti {
     }
     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() {
@@ -3703,7 +3747,7 @@ var Iti = class _Iti {
   #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) {
@@ -3871,15 +3915,16 @@ var Iti = class _Iti {
       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;
@@ -3898,6 +3943,15 @@ var Iti = class _Iti {
     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) {
@@ -3989,8 +4043,7 @@ var Iti = class _Iti {
     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,
@@ -4110,11 +4163,10 @@ var Iti = class _Iti {
       this.#maxCoreNumberLength = null;
       return;
     }
-    const numberType = intlTelInput.utils.numberType[placeholderNumberType];
     let exampleNumber = intlTelInput.utils.getExampleNumber(
       iso2,
       false,
-      numberType,
+      placeholderNumberType,
       true
     );
     let validNumber = exampleNumber;
@@ -4144,11 +4196,10 @@ var Iti = class _Iti {
     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") {
@@ -4258,19 +4309,9 @@ var Iti = class _Iti {
     );
     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
@@ -4361,7 +4402,7 @@ var Iti = class _Iti {
       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 "";
@@ -4376,10 +4417,10 @@ var Iti = class _Iti {
     );
     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(
@@ -4389,12 +4430,12 @@ var Iti = class _Iti {
   }
   //* 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;
@@ -4543,39 +4584,31 @@ var Iti = class _Iti {
     });
   }
 };
-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) => {
@@ -4600,11 +4633,17 @@ var intlTelInput = Object.assign(
     attachUtils,
     startedLoadingUtils: false,
     startedLoadingAutoCountry: false,
-    version: "27.3.0"
+    version: "28.0.0",
+    NUMBER_FORMAT,
+    NUMBER_TYPE,
+    VALIDATION_ERROR
   }
 );
 var intlTelInput_default = intlTelInput;
 export {
   Iti,
+  NUMBER_FORMAT,
+  NUMBER_TYPE,
+  VALIDATION_ERROR,
   intlTelInput_default as default
 };