intl-tel-input 27.2.1 → 27.3.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 See the Github Releases page for changelog: https://github.com/jackocnr/intl-tel-input/releases
 
-Or to view a specific version, e.g. v27.2.1, update the URL accordingly, e.g. https://github.com/jackocnr/intl-tel-input/releases/tag/v27.2.1
+Or to view a specific version, e.g. v27.3.1, update the URL accordingly, e.g. https://github.com/jackocnr/intl-tel-input/releases/tag/v27.3.1
 
 ## Breaking changes
 

package/README.md

@@ -23,20 +23,31 @@ We provide React, Vue, Angular and Svelte (beta) components alongside the regula
 We have a newly updated website, where you can find [a full set of docs](https://intl-tel-input.com/docs/integrations), a [live playground](https://intl-tel-input.com/playground/) where you can try out all of the options, as well as plenty of [examples](https://intl-tel-input.com/examples/validation-practical.html) of different setups.
 
 ## Features
-* Automatically select the user's current country using an IP lookup
-* Automatically set the input placeholder to an example number for the selected country
-* Navigate the country dropdown by typing a country's name, or using the up/down keys
-* Automatically format the number as the user types
-* Optionally, only allow numeric characters and cap the number at the maximum valid length
-* The user types their national number, and the plugin gives you the full standardised international number
-* Number validation, including specific error types
-* High-resolution flag images
-* Accessibility provided via ARIA tags
-* Typescript type definitions included
-* Easily customise styles by overriding CSS variables, e.g. support dark mode
-* React, Vue, Angular and Svelte components also included
-* Translations provided in over 40 languages, as well as support for RTL layout and alternative numeral sets
-* Lots of initialisation options for customisation, as well as instance methods/events for interaction
+
+🔍 **Fast country picking**
+* Search by country name or dial code
+* Full keyboard navigation
+
+✨ **Smart defaults**
+* Optionally auto-detect the user's country via IP lookup
+* Example placeholders per country
+
+📞 **Formatting & output**
+* Formats the number as the user types
+* Extract standard E.164 numbers to store
+
+🛡️ **Validation**
+* Validate numbers with specific error types
+* Strict mode: only allow valid digits and enforce max length
+
+🌍 **International & accessible**
+* Translated into 40+ languages, with support for RTL and alternative numerals
+* Screen reader-friendly ARIA markup
+
+🎛️ **Customisable**
+* Override CSS variables (e.g. dark mode)
+* Optionally display the dial code next to the number
+* Extensive initialisation options, methods, and events
 
 ## Contributing
 See the [contributing guide](https://github.com/jackocnr/intl-tel-input/blob/master/.github/CONTRIBUTING.md) for instructions on setting up the project and making changes, and also on how to update the flag images, or how to add a new translation.

package/angular/dist/IntlTelInput.d.ts

@@ -45,6 +45,7 @@ declare class IntlTelInput implements AfterViewInit, OnDestroy, OnChanges, Contr
     separateDialCode?: AllOptions["separateDialCode"];
     showFlags?: AllOptions["showFlags"];
     strictMode?: AllOptions["strictMode"];
+    strictRejectAnimation?: AllOptions["strictRejectAnimation"];
     useFullscreenPopup?: AllOptions["useFullscreenPopup"];
     numberChange: EventEmitter<string>;
     countryChange: EventEmitter<string>;
@@ -61,6 +62,7 @@ declare class IntlTelInput implements AfterViewInit, OnDestroy, OnChanges, Contr
     click: EventEmitter<MouseEvent>;
     private iti?;
     private appliedInputAttrKeys;
+    private pluginInputClasses;
     private lastEmittedNumber?;
     private lastEmittedCountry?;
     private lastEmittedValidity?;
@@ -103,6 +105,6 @@ declare class IntlTelInput implements AfterViewInit, OnDestroy, OnChanges, Contr
     validate(_control: AbstractControl): ValidationErrors | null;
     registerOnValidatorChange(fn: () => void): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<IntlTelInput, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IntlTelInput, "intl-tel-input", never, { "initialValue": { "alias": "initialValue"; "required": false; }; "usePreciseValidation": { "alias": "usePreciseValidation"; "required": false; }; "inputAttributes": { "alias": "inputAttributes"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "allowDropdown": { "alias": "allowDropdown"; "required": false; }; "allowedNumberTypes": { "alias": "allowedNumberTypes"; "required": false; }; "allowNumberExtensions": { "alias": "allowNumberExtensions"; "required": false; }; "allowPhonewords": { "alias": "allowPhonewords"; "required": false; }; "autoPlaceholder": { "alias": "autoPlaceholder"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "countryNameLocale": { "alias": "countryNameLocale"; "required": false; }; "countryOrder": { "alias": "countryOrder"; "required": false; }; "countrySearch": { "alias": "countrySearch"; "required": false; }; "customPlaceholder": { "alias": "customPlaceholder"; "required": false; }; "dropdownAlwaysOpen": { "alias": "dropdownAlwaysOpen"; "required": false; }; "dropdownContainer": { "alias": "dropdownContainer"; "required": false; }; "excludeCountries": { "alias": "excludeCountries"; "required": false; }; "fixDropdownWidth": { "alias": "fixDropdownWidth"; "required": false; }; "formatAsYouType": { "alias": "formatAsYouType"; "required": false; }; "formatOnDisplay": { "alias": "formatOnDisplay"; "required": false; }; "geoIpLookup": { "alias": "geoIpLookup"; "required": false; }; "hiddenInput": { "alias": "hiddenInput"; "required": false; }; "i18n": { "alias": "i18n"; "required": false; }; "initialCountry": { "alias": "initialCountry"; "required": false; }; "loadUtils": { "alias": "loadUtils"; "required": false; }; "nationalMode": { "alias": "nationalMode"; "required": false; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; }; "placeholderNumberType": { "alias": "placeholderNumberType"; "required": false; }; "searchInputClass": { "alias": "searchInputClass"; "required": false; }; "separateDialCode": { "alias": "separateDialCode"; "required": false; }; "showFlags": { "alias": "showFlags"; "required": false; }; "strictMode": { "alias": "strictMode"; "required": false; }; "useFullscreenPopup": { "alias": "useFullscreenPopup"; "required": false; }; }, { "numberChange": "numberChange"; "countryChange": "countryChange"; "validityChange": "validityChange"; "errorCodeChange": "errorCodeChange"; "openCountryDropdown": "openCountryDropdown"; "closeCountryDropdown": "closeCountryDropdown"; "strictReject": "strictReject"; "blur": "blur"; "focus": "focus"; "keydown": "keydown"; "keyup": "keyup"; "paste": "paste"; "click": "click"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IntlTelInput, "intl-tel-input", never, { "initialValue": { "alias": "initialValue"; "required": false; }; "usePreciseValidation": { "alias": "usePreciseValidation"; "required": false; }; "inputAttributes": { "alias": "inputAttributes"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "allowDropdown": { "alias": "allowDropdown"; "required": false; }; "allowedNumberTypes": { "alias": "allowedNumberTypes"; "required": false; }; "allowNumberExtensions": { "alias": "allowNumberExtensions"; "required": false; }; "allowPhonewords": { "alias": "allowPhonewords"; "required": false; }; "autoPlaceholder": { "alias": "autoPlaceholder"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "countryNameLocale": { "alias": "countryNameLocale"; "required": false; }; "countryOrder": { "alias": "countryOrder"; "required": false; }; "countrySearch": { "alias": "countrySearch"; "required": false; }; "customPlaceholder": { "alias": "customPlaceholder"; "required": false; }; "dropdownAlwaysOpen": { "alias": "dropdownAlwaysOpen"; "required": false; }; "dropdownContainer": { "alias": "dropdownContainer"; "required": false; }; "excludeCountries": { "alias": "excludeCountries"; "required": false; }; "fixDropdownWidth": { "alias": "fixDropdownWidth"; "required": false; }; "formatAsYouType": { "alias": "formatAsYouType"; "required": false; }; "formatOnDisplay": { "alias": "formatOnDisplay"; "required": false; }; "geoIpLookup": { "alias": "geoIpLookup"; "required": false; }; "hiddenInput": { "alias": "hiddenInput"; "required": false; }; "i18n": { "alias": "i18n"; "required": false; }; "initialCountry": { "alias": "initialCountry"; "required": false; }; "loadUtils": { "alias": "loadUtils"; "required": false; }; "nationalMode": { "alias": "nationalMode"; "required": false; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; }; "placeholderNumberType": { "alias": "placeholderNumberType"; "required": false; }; "searchInputClass": { "alias": "searchInputClass"; "required": false; }; "separateDialCode": { "alias": "separateDialCode"; "required": false; }; "showFlags": { "alias": "showFlags"; "required": false; }; "strictMode": { "alias": "strictMode"; "required": false; }; "strictRejectAnimation": { "alias": "strictRejectAnimation"; "required": false; }; "useFullscreenPopup": { "alias": "useFullscreenPopup"; "required": false; }; }, { "numberChange": "numberChange"; "countryChange": "countryChange"; "validityChange": "validityChange"; "errorCodeChange": "errorCodeChange"; "openCountryDropdown": "openCountryDropdown"; "closeCountryDropdown": "closeCountryDropdown"; "strictReject": "strictReject"; "blur": "blur"; "focus": "focus"; "keydown": "keydown"; "keyup": "keyup"; "paste": "paste"; "click": "click"; }, never, never, true, never>;
 }
 export default IntlTelInput;

package/angular/dist/IntlTelInput.js

@@ -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;
@@ -4621,6 +4684,7 @@ var IntlTelInput = class _IntlTelInput {
   separateDialCode;
   showFlags;
   strictMode;
+  strictRejectAnimation;
   useFullscreenPopup;
   numberChange = new EventEmitter();
   countryChange = new EventEmitter();
@@ -4637,6 +4701,8 @@ var IntlTelInput = class _IntlTelInput {
   click = new EventEmitter();
   iti;
   appliedInputAttrKeys = /* @__PURE__ */ new Set();
+  // Classes the plugin adds directly to the input (e.g. iti__tel-input)
+  pluginInputClasses = "";
   lastEmittedNumber;
   lastEmittedCountry;
   lastEmittedValidity;
@@ -4661,6 +4727,7 @@ var IntlTelInput = class _IntlTelInput {
   };
   ngAfterViewInit() {
     this.iti = intlTelInput_default(this.inputRef.nativeElement, this.buildInitOptions());
+    this.pluginInputClasses = this.inputRef.nativeElement.className;
     this.inputRef.nativeElement.addEventListener("open:countrydropdown", this.handleOpenDropdown);
     this.inputRef.nativeElement.addEventListener("close:countrydropdown", this.handleCloseDropdown);
     this.inputRef.nativeElement.addEventListener("strict:reject", this.handleStrictReject);
@@ -4719,6 +4786,7 @@ var IntlTelInput = class _IntlTelInput {
       separateDialCode: this.separateDialCode,
       showFlags: this.showFlags,
       strictMode: this.strictMode,
+      strictRejectAnimation: this.strictRejectAnimation,
       useFullscreenPopup: this.useFullscreenPopup
     };
     return Object.fromEntries(Object.entries(options).filter(([, value]) => value !== void 0));
@@ -4824,7 +4892,8 @@ var IntlTelInput = class _IntlTelInput {
         warnInputAttr(key);
       } else {
         currentKeys.add(key);
-        this.inputRef.nativeElement.setAttribute(key, value);
+        const next = key === "class" && this.pluginInputClasses ? `${this.pluginInputClasses} ${value}` : value;
+        this.inputRef.nativeElement.setAttribute(key, next);
       }
     });
     this.appliedInputAttrKeys.forEach((key) => {
@@ -4885,7 +4954,7 @@ var IntlTelInput = class _IntlTelInput {
       let _t;
       i0.\u0275\u0275queryRefresh(_t = i0.\u0275\u0275loadQuery()) && (ctx.inputRef = _t.first);
     }
-  }, inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", allowDropdown: "allowDropdown", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", autoPlaceholder: "autoPlaceholder", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownContainer: "dropdownContainer", excludeCountries: "excludeCountries", fixDropdownWidth: "fixDropdownWidth", formatAsYouType: "formatAsYouType", formatOnDisplay: "formatOnDisplay", geoIpLookup: "geoIpLookup", hiddenInput: "hiddenInput", i18n: "i18n", initialCountry: "initialCountry", loadUtils: "loadUtils", nationalMode: "nationalMode", onlyCountries: "onlyCountries", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", useFullscreenPopup: "useFullscreenPopup" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountryDropdown: "openCountryDropdown", closeCountryDropdown: "closeCountryDropdown", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, features: [i0.\u0275\u0275ProvidersFeature([
+  }, inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", allowDropdown: "allowDropdown", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", autoPlaceholder: "autoPlaceholder", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownContainer: "dropdownContainer", excludeCountries: "excludeCountries", fixDropdownWidth: "fixDropdownWidth", formatAsYouType: "formatAsYouType", formatOnDisplay: "formatOnDisplay", geoIpLookup: "geoIpLookup", hiddenInput: "hiddenInput", i18n: "i18n", initialCountry: "initialCountry", loadUtils: "loadUtils", nationalMode: "nationalMode", onlyCountries: "onlyCountries", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", strictRejectAnimation: "strictRejectAnimation", useFullscreenPopup: "useFullscreenPopup" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountryDropdown: "openCountryDropdown", closeCountryDropdown: "closeCountryDropdown", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, features: [i0.\u0275\u0275ProvidersFeature([
     {
       provide: NG_VALUE_ACCESSOR,
       useExisting: forwardRef(() => _IntlTelInput),
@@ -5019,6 +5088,8 @@ var IntlTelInput = class _IntlTelInput {
     type: Input
   }], strictMode: [{
     type: Input
+  }], strictRejectAnimation: [{
+    type: Input
   }], useFullscreenPopup: [{
     type: Input
   }], numberChange: [{