intl-tel-input 27.2.1 → 27.3.1

package/dist/js/intlTelInput.mjs

@@ -1743,13 +1743,7 @@ 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));
@@ -1966,6 +1960,8 @@ var defaults = {
   searchInputClass: "",
   //* Display the international dial code next to the selected flag.
   separateDialCode: false,
+  //* When strictMode rejects a key (etc), play a short feedback animation
+  strictRejectAnimation: false,
   //* 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.
@@ -2041,6 +2037,7 @@ var validateOptions = (customOptions) => {
       case "showFlags":
       case "separateDialCode":
       case "strictMode":
+      case "strictRejectAnimation":
       case "useFullscreenPopup":
         if (typeof value !== "boolean") {
           warnOption(key, "a boolean", value);
@@ -2259,7 +2256,20 @@ var buildGlobeIcon = () => `
   </svg>`;
 
 // src/js/core/countrySearch.ts
-var getMatchedCountries = (countries, query) => {
+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 = [];
@@ -2268,17 +2278,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);
     }
   }
@@ -2293,16 +2304,75 @@ 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/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";
+  }
+};
+
 // src/js/core/ui.ts
 var UI = class _UI {
   // private
@@ -2311,6 +2381,7 @@ var UI = class _UI {
   #isRTL;
   #originalPaddingLeft = "";
   #countries;
+  #searchTokens;
   #searchDebounceTimer = null;
   #inlineDropdownHeight;
   #countryContainerEl;
@@ -2356,8 +2427,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");
@@ -2725,7 +2797,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);
   }
@@ -3020,7 +3097,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);
@@ -3332,13 +3413,6 @@ 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
 var regionlessDialCodes = /* @__PURE__ */ new Set([
@@ -3424,54 +3498,6 @@ 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
 var nextId = 0;
 var ensureUtils = (methodName) => {
@@ -3506,6 +3532,7 @@ var Iti = class _Iti {
   #dialCodeToIso2Map;
   #dialCodes;
   #countryByIso2;
+  #searchTokens;
   #selectedCountry = null;
   #maxCoreNumberLength = null;
   #fallbackCountryIso2;
@@ -3529,9 +3556,7 @@ var Iti = class _Iti {
     this.#numerals = new Numerals(input.value);
     this.promise = this.#createInitPromise(this.#options);
     this.#countries = processAllCountries(this.#options);
-    const { dialCodes, dialCodeMaxLength, dialCodeToIso2Map } = processDialCodes(
-      this.#countries
-    );
+    const { dialCodes, dialCodeMaxLength, dialCodeToIso2Map } = processDialCodes(this.#countries);
     this.#dialCodes = dialCodes;
     this.#dialCodeMaxLength = dialCodeMaxLength;
     this.#dialCodeToIso2Map = dialCodeToIso2Map;
@@ -3564,7 +3589,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();
@@ -3579,7 +3604,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
@@ -3702,7 +3727,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) {
@@ -3713,6 +3738,7 @@ var Iti = class _Iti {
   #handleAndroidStrictReject(inputValue, rejectedInput) {
     const newCaretPos = this.#removeJustTypedChar(inputValue);
     this.#ui.telInputEl.setSelectionRange(newCaretPos, newCaretPos);
+    this.#playStrictRejectAnimation();
     this.#dispatchEvent(EVENTS.STRICT_REJECT, {
       source: "key",
       rejectedInput,
@@ -3772,7 +3798,13 @@ var Iti = class _Iti {
   //* On input event: (1) Update selected country, (2) Format-as-you-type.
   //* Note that this fires AFTER the input is updated.
   #handleInputEvent = (e) => {
-    const { strictMode, formatAsYouType, separateDialCode, allowDropdown, countrySearch } = this.#options;
+    const {
+      strictMode,
+      formatAsYouType,
+      separateDialCode,
+      allowDropdown,
+      countrySearch
+    } = this.#options;
     const detail = e?.detail;
     if (detail?.["isCountryChange"]) {
       return;
@@ -3854,6 +3886,7 @@ var Iti = class _Iti {
     const newCountry = this.#resolveCountryChangeFromNumber(newFullNumber);
     const isChangingDialCode = newCountry !== null;
     if (!isAllowedChar || hasExceededMaxLength && !isChangingDialCode && !isInitialPlus) {
+      this.#playStrictRejectAnimation();
       this.#dispatchEvent(EVENTS.STRICT_REJECT, {
         source: "key",
         rejectedInput: e.key,
@@ -3862,15 +3895,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;
@@ -3889,6 +3923,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) {
@@ -3896,6 +3939,7 @@ var Iti = class _Iti {
         coreNumber = intlTelInput.utils.getCoreNumber(newValue, iso2);
       }
       if (!coreNumber) {
+        this.#playStrictRejectAnimation();
         this.#dispatchEvent(EVENTS.STRICT_REJECT, {
           source: "paste",
           rejectedInput: pastedRaw,
@@ -3909,6 +3953,7 @@ var Iti = class _Iti {
           newValue = newValue.slice(0, newValue.length - trimLength);
           rejectReason = "max-length";
         } else {
+          this.#playStrictRejectAnimation();
           this.#dispatchEvent(EVENTS.STRICT_REJECT, {
             source: "paste",
             rejectedInput: pastedRaw,
@@ -3923,6 +3968,9 @@ var Iti = class _Iti {
     input.setSelectionRange(caretPos, caretPos);
     input.dispatchEvent(new InputEvent("input", { bubbles: true }));
     if (rejectReason) {
+      if (pasted.length > 0 && sanitised.length === 0) {
+        this.#playStrictRejectAnimation();
+      }
       this.#dispatchEvent(EVENTS.STRICT_REJECT, {
         source: "paste",
         rejectedInput: pastedRaw,
@@ -3935,6 +3983,21 @@ var Iti = class _Iti {
     const max = Number(this.#ui.telInputEl.getAttribute("maxlength"));
     return max && number.length > max ? number.substring(0, max) : number;
   }
+  //* Play the strict-reject animation (shake, or background-colour flash under prefers-reduced-motion) on the wrapper.
+  //* Called when strictMode rejects the whole input (keystroke, or whole paste).
+  //* Uses the wrapper (not the input) so any separateDialCode / country button move together with the input.
+  #playStrictRejectAnimation() {
+    if (!this.#options.strictRejectAnimation) {
+      return;
+    }
+    const wrapperEl = this.#ui.telInputEl.parentElement;
+    if (!wrapperEl) {
+      return;
+    }
+    wrapperEl.classList.remove("iti__strict-reject-animation");
+    void wrapperEl.offsetWidth;
+    wrapperEl.classList.add("iti__strict-reject-animation");
+  }
   //* Trigger a custom event on the input (typed via ItiEventMap).
   #dispatchEvent(name, detailProps = {}) {
     const e = new CustomEvent(name, {
@@ -4571,7 +4634,7 @@ var intlTelInput = Object.assign(
     attachUtils,
     startedLoadingUtils: false,
     startedLoadingAutoCountry: false,
-    version: "27.2.1"
+    version: "27.3.1"
   }
 );
 var intlTelInput_default = intlTelInput;