@intl-tel-input/angular 29.3.0 → 29.4.1

package/README.md

@@ -1,6 +1,6 @@
 # Angular component for intl-tel-input
 
-For entering, formatting, and validating international telephone numbers.
+For entering, formatting, and validating international telephone numbers. Requires Angular 17 or later.
 
 [Explore docs »](https://intl-tel-input.com/docs/angular-component)
 

package/dist/IntlTelInput.d.ts

@@ -33,6 +33,7 @@ declare class IntlTelInput implements AfterViewInit, OnDestroy, OnChanges, Contr
     excludeCountries?: AllOptions["excludeCountries"];
     matchDropdownWidth?: AllOptions["matchDropdownWidth"];
     formatAsYouType?: AllOptions["formatAsYouType"];
+    fullscreenParent?: AllOptions["fullscreenParent"];
     hiddenInputs?: AllOptions["hiddenInputs"];
     uiTranslations?: AllOptions["uiTranslations"];
     initialCountry?: AllOptions["initialCountry"];
@@ -107,6 +108,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; }; "countrySelectorMode": { "alias": "countrySelectorMode"; "required": false; }; "allowedNumberTypes": { "alias": "allowedNumberTypes"; "required": false; }; "allowNumberExtensions": { "alias": "allowNumberExtensions"; "required": false; }; "allowPhonewords": { "alias": "allowPhonewords"; "required": false; }; "classNames": { "alias": "classNames"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "countryNameLocale": { "alias": "countryNameLocale"; "required": false; }; "countryNameOverrides": { "alias": "countryNameOverrides"; "required": false; }; "countryOrder": { "alias": "countryOrder"; "required": false; }; "countrySearch": { "alias": "countrySearch"; "required": false; }; "customPlaceholder": { "alias": "customPlaceholder"; "required": false; }; "dropdownAlwaysOpen": { "alias": "dropdownAlwaysOpen"; "required": false; }; "dropdownParent": { "alias": "dropdownParent"; "required": false; }; "excludeCountries": { "alias": "excludeCountries"; "required": false; }; "matchDropdownWidth": { "alias": "matchDropdownWidth"; "required": false; }; "formatAsYouType": { "alias": "formatAsYouType"; "required": false; }; "hiddenInputs": { "alias": "hiddenInputs"; "required": false; }; "uiTranslations": { "alias": "uiTranslations"; "required": false; }; "initialCountry": { "alias": "initialCountry"; "required": false; }; "initialCountryLookup": { "alias": "initialCountryLookup"; "required": false; }; "loadUtils": { "alias": "loadUtils"; "required": false; }; "numberDisplayFormat": { "alias": "numberDisplayFormat"; "required": false; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; }; "placeholderNumberPolicy": { "alias": "placeholderNumberPolicy"; "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; }; }, { "numberChange": "numberChange"; "countryChange": "countryChange"; "validityChange": "validityChange"; "errorCodeChange": "errorCodeChange"; "openCountrySelector": "openCountrySelector"; "closeCountrySelector": "closeCountrySelector"; "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; }; "countrySelectorMode": { "alias": "countrySelectorMode"; "required": false; }; "allowedNumberTypes": { "alias": "allowedNumberTypes"; "required": false; }; "allowNumberExtensions": { "alias": "allowNumberExtensions"; "required": false; }; "allowPhonewords": { "alias": "allowPhonewords"; "required": false; }; "classNames": { "alias": "classNames"; "required": false; }; "containerClass": { "alias": "containerClass"; "required": false; }; "countryNameLocale": { "alias": "countryNameLocale"; "required": false; }; "countryNameOverrides": { "alias": "countryNameOverrides"; "required": false; }; "countryOrder": { "alias": "countryOrder"; "required": false; }; "countrySearch": { "alias": "countrySearch"; "required": false; }; "customPlaceholder": { "alias": "customPlaceholder"; "required": false; }; "dropdownAlwaysOpen": { "alias": "dropdownAlwaysOpen"; "required": false; }; "dropdownParent": { "alias": "dropdownParent"; "required": false; }; "excludeCountries": { "alias": "excludeCountries"; "required": false; }; "matchDropdownWidth": { "alias": "matchDropdownWidth"; "required": false; }; "formatAsYouType": { "alias": "formatAsYouType"; "required": false; }; "fullscreenParent": { "alias": "fullscreenParent"; "required": false; }; "hiddenInputs": { "alias": "hiddenInputs"; "required": false; }; "uiTranslations": { "alias": "uiTranslations"; "required": false; }; "initialCountry": { "alias": "initialCountry"; "required": false; }; "initialCountryLookup": { "alias": "initialCountryLookup"; "required": false; }; "loadUtils": { "alias": "loadUtils"; "required": false; }; "numberDisplayFormat": { "alias": "numberDisplayFormat"; "required": false; }; "onlyCountries": { "alias": "onlyCountries"; "required": false; }; "placeholderNumberPolicy": { "alias": "placeholderNumberPolicy"; "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; }; }, { "numberChange": "numberChange"; "countryChange": "countryChange"; "validityChange": "validityChange"; "errorCodeChange": "errorCodeChange"; "openCountrySelector": "openCountrySelector"; "closeCountrySelector": "closeCountrySelector"; "strictReject": "strictReject"; "blur": "blur"; "focus": "focus"; "keydown": "keydown"; "keyup": "keyup"; "paste": "paste"; "click": "click"; }, never, never, true, never>;
 }
 export default IntlTelInput;

package/dist/IntlTelInput.js

@@ -1977,7 +1977,7 @@ var defaults = {
   customPlaceholder: null,
   //* Always show the dropdown
   dropdownAlwaysOpen: false,
-  //* Optional DOM element to append the dropdown to (used to escape ancestors with overflow:hidden, or to mount in a custom container). Only consulted in dropdown rendering; ignored when the country selector renders as a fullscreen popup.
+  //* Optional DOM element to append the dropdown to (used to escape ancestors with overflow:hidden, or to mount in a custom container). Only consulted in dropdown rendering; ignored when the country selector renders as a fullscreen popup (see fullscreenParent).
   dropdownParent: null,
   //* Don't display these countries.
   excludeCountries: null,
@@ -1985,6 +1985,8 @@ var defaults = {
   matchDropdownWidth: true,
   //* Format the number as the user types
   formatAsYouType: true,
+  //* Optional DOM element to append the fullscreen popup to, instead of document.body (e.g. a modal <dialog>, where a body-mounted popup would be unreachable). Only consulted in fullscreen rendering (see dropdownParent for the dropdown). Null means document.body, which is resolved on open rather than here, as document may not exist yet (e.g. SSR).
+  fullscreenParent: null,
   //* Inject hidden inputs with the names returned from this function, and on submit, populate them with the full number and selected country iso2.
   hiddenInputs: null,
   //* Translations for the core library UI strings e.g. search input placeholder, country names.
@@ -2168,8 +2170,9 @@ var validateOptions = (customOptions) => {
         validatedOptions[key] = value;
         break;
       case "dropdownParent":
+      case "fullscreenParent":
         if (value !== null && !isElLike(value)) {
-          warnOption("dropdownParent", "an HTMLElement or null", value);
+          warnOption(key, "an HTMLElement or null", value);
           break;
         }
         validatedOptions[key] = value;
@@ -2733,6 +2736,9 @@ var UI = class {
       },
       this.#countrySelectorEl
     );
+    if (!countrySearch) {
+      this.#countryListEl.setAttribute("tabindex", "0");
+    }
     this.#appendListItems();
     if (countrySearch) {
       this.#updateSearchResultsA11yText();
@@ -2753,11 +2759,12 @@ var UI = class {
       this.#countryContainerEl.appendChild(this.#countrySelectorEl);
     }
   }
-  //* Resolve the DOM element to attach the country selector to. Fullscreen always uses document.body; dropdown uses the consumer-supplied dropdownParent (if any); otherwise the country selector renders inline within the input wrapper (no detached element).
+  //* Resolve the DOM element to attach the country selector to. Fullscreen is always detached: it uses the consumer-supplied fullscreenParent, falling back to document.body; dropdown uses the consumer-supplied dropdownParent (if any); otherwise the country selector renders inline within the input wrapper (no detached element).
+  //* NOTE: these are deliberately two separate options. For the dropdown, setting a parent switches it from inline to detached rendering (pos:fixed, positioned against the input), whereas the fullscreen popup is detached regardless, so its parent only relocates it. Sharing one option would force a detached dropdown on anyone who only needs to move the fullscreen popup e.g. into a modal <dialog> (issue #2199).
   #getDetachedParent() {
-    const { countrySelectorMode, dropdownParent } = this.#options;
+    const { countrySelectorMode, dropdownParent, fullscreenParent } = this.#options;
     if (countrySelectorMode === COUNTRY_SELECTOR_MODE.FULLSCREEN) {
-      return document.body;
+      return fullscreenParent ?? document.body;
     }
     if (countrySelectorMode === COUNTRY_SELECTOR_MODE.DROPDOWN) {
       return dropdownParent;
@@ -2883,7 +2890,6 @@ var UI = class {
       const listItem = createEl("li", {
         id: `iti-${this.#id}__item-${c.iso2}`,
         class: liClass,
-        tabindex: "-1",
         role: "option",
         [ARIA.SELECTED]: "false"
       });
@@ -3075,18 +3081,20 @@ var UI = class {
       container.scrollTop = offsetTop - containerRect.height + elementRect.height;
     }
   }
+  //* The element that holds focus while the country selector is open: the search input, or (when countrySearch is disabled) the country list itself.
+  #getOpenFocusEl() {
+    return this.#options.countrySearch ? this.#searchInputEl : this.#countryListEl;
+  }
   //* Remove highlighting from the previous list item and highlight the new one.
   #highlightListItem(listItem, doScroll = true) {
     this.#highlightedListItemEl?.classList.remove(CLASSES.HIGHLIGHT);
     if (listItem) {
       listItem.classList.add(CLASSES.HIGHLIGHT);
-      if (this.#options.countrySearch) {
-        const activeDescendant = listItem.getAttribute("id") || "";
-        this.#searchInputEl.setAttribute(
-          ARIA.ACTIVE_DESCENDANT,
-          activeDescendant
-        );
-      }
+      const activeDescendant = listItem.getAttribute("id") || "";
+      this.#getOpenFocusEl().setAttribute(
+        ARIA.ACTIVE_DESCENDANT,
+        activeDescendant
+      );
       if (doScroll) {
         this.#scrollCountryListToItem(listItem);
       }
@@ -3165,7 +3173,7 @@ var UI = class {
   //* Open the country selector: create a fresh AbortController, do the DOM work, and wire up all
   //* open-state listeners (which invoke the caller's onSelect / onClose callbacks).
   openCountrySelector(onSelect, onClose) {
-    const { countrySearch, dropdownAlwaysOpen } = this.#options;
+    const { dropdownAlwaysOpen } = this.#options;
     this.#countrySelectorAbortController = new AbortController();
     if (this.#options.countrySelectorMode !== COUNTRY_SELECTOR_MODE.FULLSCREEN) {
       this.#ensureInlineDropdownSizeMeasured();
@@ -3188,10 +3196,11 @@ var UI = class {
     if (itemToHighlight) {
       this.#highlightListItem(itemToHighlight);
     }
-    if (countrySearch && !dropdownAlwaysOpen) {
-      this.#searchInputEl.focus();
+    if (!dropdownAlwaysOpen) {
+      this.#getOpenFocusEl().focus();
     }
     if (this.#options.countrySelectorMode === COUNTRY_SELECTOR_MODE.FULLSCREEN && this.#detachedCountrySelectorEl && window.visualViewport) {
+      this.#adjustFullscreenPopupToViewport();
       window.visualViewport.addEventListener(
         "resize",
         () => {
@@ -3308,6 +3317,20 @@ var UI = class {
     };
     this.#selectedCountryEl?.addEventListener("keydown", handleKeydown, { signal });
     this.#countrySelectorEl?.addEventListener("keydown", handleKeydown, { signal });
+    if (this.#detachedCountrySelectorEl) {
+      this.#countrySelectorEl?.addEventListener(
+        "keydown",
+        (e) => {
+          if (e.key === KEYS.TAB) {
+            e.preventDefault();
+            onEscape();
+            const focusEl = e.shiftKey ? this.#selectedCountryEl : this.telInputEl;
+            focusEl.focus();
+          }
+        },
+        { signal }
+      );
+    }
   }
   //* Wire up country search input listener: typing filters the list, the clear button resets it.
   #bindSearchInputListener(signal) {
@@ -3405,8 +3428,8 @@ var UI = class {
     this.#countrySelectorAbortController = null;
     this.#countrySelectorEl.classList.add(CLASSES.HIDE);
     this.#selectedCountryEl.setAttribute(ARIA.EXPANDED, "false");
+    this.#getOpenFocusEl().removeAttribute(ARIA.ACTIVE_DESCENDANT);
     if (countrySearch) {
-      this.#searchInputEl.removeAttribute(ARIA.ACTIVE_DESCENDANT);
       this.#searchInputEl.value = "";
       this.#applySearchFilter();
       if (this.#highlightedListItemEl) {
@@ -3419,6 +3442,7 @@ var UI = class {
       this.#detachedCountrySelectorEl.remove();
       this.#detachedCountrySelectorEl.style.top = "";
       this.#detachedCountrySelectorEl.style.bottom = "";
+      this.#detachedCountrySelectorEl.style.removeProperty("--iti-virtual-keyboard-height");
       this.#detachedCountrySelectorEl.style.paddingLeft = "";
       this.#detachedCountrySelectorEl.style.paddingRight = "";
     } else {
@@ -3477,15 +3501,16 @@ var UI = class {
     this.telInputEl.style.anchorName = existing && existing !== "none" ? `${existing}, ${anchorName}` : anchorName;
     this.#detachedCountrySelectorEl.style.positionAnchor = anchorName;
   }
-  // Adjust the fullscreen popup dimensions to match the visual viewport,
-  // so it stays above the virtual keyboard on mobile devices.
+  // Tell the CSS how much of the fullscreen popup is covered by the virtual keyboard, so it can fit the
+  // country selector above it, while the popup itself (the dark backdrop) stays fullscreen behind the keyboard.
   #adjustFullscreenPopupToViewport() {
     const vv = window.visualViewport;
-    if (!vv || !this.#detachedCountrySelectorEl) {
+    const popup = this.#detachedCountrySelectorEl;
+    if (!vv || !popup) {
       return;
     }
-    const virtualKeyboardHeight = window.innerHeight - vv.height;
-    this.#detachedCountrySelectorEl.style.bottom = `${virtualKeyboardHeight}px`;
+    const virtualKeyboardHeight = Math.max(0, popup.offsetHeight - vv.height);
+    popup.style.setProperty("--iti-virtual-keyboard-height", `${virtualKeyboardHeight}px`);
   }
   // UI: Whether the country selector is currently open (visible).
   isCountrySelectorOpen() {
@@ -4955,7 +4980,7 @@ var intlTelInput = Object.assign(
     attachUtils,
     startedLoadingUtils: false,
     startedLoadingAutoCountry: false,
-    version: "29.3.0",
+    version: "29.4.1",
     NUMBER_FORMAT,
     NUMBER_TYPE,
     VALIDATION_ERROR,
@@ -4997,6 +5022,7 @@ var IntlTelInput = class _IntlTelInput {
   excludeCountries;
   matchDropdownWidth;
   formatAsYouType;
+  fullscreenParent;
   hiddenInputs;
   uiTranslations;
   initialCountry;
@@ -5069,6 +5095,7 @@ var IntlTelInput = class _IntlTelInput {
     if (this.readonly) {
       this.iti.setReadonly(this.readonly);
     }
+    this.lastEmittedCountry = this.iti.getSelectedCountry()?.iso2 ?? "";
     this.iti.promise.then(() => {
       if (!this.iti?.isActive()) {
         return;
@@ -5105,6 +5132,7 @@ var IntlTelInput = class _IntlTelInput {
       excludeCountries: this.excludeCountries,
       matchDropdownWidth: this.matchDropdownWidth,
       formatAsYouType: this.formatAsYouType,
+      fullscreenParent: this.fullscreenParent,
       hiddenInputs: this.hiddenInputs,
       uiTranslations: this.uiTranslations,
       initialCountry: this.initialCountry,
@@ -5288,7 +5316,7 @@ var IntlTelInput = class _IntlTelInput {
     this.onValidatorChange = fn;
   }
   static \u0275fac = i0.\u0275\u0275ngDeclareFactory({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: _IntlTelInput, deps: [], target: i0.\u0275\u0275FactoryTarget.Component });
-  static \u0275cmp = i0.\u0275\u0275ngDeclareComponent({ minVersion: "14.0.0", version: "21.2.7", type: _IntlTelInput, isStandalone: true, selector: "intl-tel-input", inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", countrySelectorMode: "countrySelectorMode", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", classNames: "classNames", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryNameOverrides: "countryNameOverrides", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownParent: "dropdownParent", excludeCountries: "excludeCountries", matchDropdownWidth: "matchDropdownWidth", formatAsYouType: "formatAsYouType", hiddenInputs: "hiddenInputs", uiTranslations: "uiTranslations", initialCountry: "initialCountry", initialCountryLookup: "initialCountryLookup", loadUtils: "loadUtils", numberDisplayFormat: "numberDisplayFormat", onlyCountries: "onlyCountries", placeholderNumberPolicy: "placeholderNumberPolicy", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", strictRejectAnimation: "strictRejectAnimation" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountrySelector: "openCountrySelector", closeCountrySelector: "closeCountrySelector", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, providers: [
+  static \u0275cmp = i0.\u0275\u0275ngDeclareComponent({ minVersion: "14.0.0", version: "21.2.7", type: _IntlTelInput, isStandalone: true, selector: "intl-tel-input", inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", countrySelectorMode: "countrySelectorMode", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", classNames: "classNames", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryNameOverrides: "countryNameOverrides", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownParent: "dropdownParent", excludeCountries: "excludeCountries", matchDropdownWidth: "matchDropdownWidth", formatAsYouType: "formatAsYouType", fullscreenParent: "fullscreenParent", hiddenInputs: "hiddenInputs", uiTranslations: "uiTranslations", initialCountry: "initialCountry", initialCountryLookup: "initialCountryLookup", loadUtils: "loadUtils", numberDisplayFormat: "numberDisplayFormat", onlyCountries: "onlyCountries", placeholderNumberPolicy: "placeholderNumberPolicy", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", strictRejectAnimation: "strictRejectAnimation" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountrySelector: "openCountrySelector", closeCountrySelector: "closeCountrySelector", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, providers: [
     {
       provide: NG_VALUE_ACCESSOR,
       useExisting: forwardRef(() => _IntlTelInput),
@@ -5387,6 +5415,8 @@ i0.\u0275\u0275ngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7",
   type: Input
 }], formatAsYouType: [{
   type: Input
+}], fullscreenParent: [{
+  type: Input
 }], hiddenInputs: [{
   type: Input
 }], uiTranslations: [{

package/dist/IntlTelInputWithUtils.js

@@ -1977,7 +1977,7 @@ var defaults = {
   customPlaceholder: null,
   //* Always show the dropdown
   dropdownAlwaysOpen: false,
-  //* Optional DOM element to append the dropdown to (used to escape ancestors with overflow:hidden, or to mount in a custom container). Only consulted in dropdown rendering; ignored when the country selector renders as a fullscreen popup.
+  //* Optional DOM element to append the dropdown to (used to escape ancestors with overflow:hidden, or to mount in a custom container). Only consulted in dropdown rendering; ignored when the country selector renders as a fullscreen popup (see fullscreenParent).
   dropdownParent: null,
   //* Don't display these countries.
   excludeCountries: null,
@@ -1985,6 +1985,8 @@ var defaults = {
   matchDropdownWidth: true,
   //* Format the number as the user types
   formatAsYouType: true,
+  //* Optional DOM element to append the fullscreen popup to, instead of document.body (e.g. a modal <dialog>, where a body-mounted popup would be unreachable). Only consulted in fullscreen rendering (see dropdownParent for the dropdown). Null means document.body, which is resolved on open rather than here, as document may not exist yet (e.g. SSR).
+  fullscreenParent: null,
   //* Inject hidden inputs with the names returned from this function, and on submit, populate them with the full number and selected country iso2.
   hiddenInputs: null,
   //* Translations for the core library UI strings e.g. search input placeholder, country names.
@@ -2168,8 +2170,9 @@ var validateOptions = (customOptions) => {
         validatedOptions[key] = value;
         break;
       case "dropdownParent":
+      case "fullscreenParent":
         if (value !== null && !isElLike(value)) {
-          warnOption("dropdownParent", "an HTMLElement or null", value);
+          warnOption(key, "an HTMLElement or null", value);
           break;
         }
         validatedOptions[key] = value;
@@ -2733,6 +2736,9 @@ var UI = class {
       },
       this.#countrySelectorEl
     );
+    if (!countrySearch) {
+      this.#countryListEl.setAttribute("tabindex", "0");
+    }
     this.#appendListItems();
     if (countrySearch) {
       this.#updateSearchResultsA11yText();
@@ -2753,11 +2759,12 @@ var UI = class {
       this.#countryContainerEl.appendChild(this.#countrySelectorEl);
     }
   }
-  //* Resolve the DOM element to attach the country selector to. Fullscreen always uses document.body; dropdown uses the consumer-supplied dropdownParent (if any); otherwise the country selector renders inline within the input wrapper (no detached element).
+  //* Resolve the DOM element to attach the country selector to. Fullscreen is always detached: it uses the consumer-supplied fullscreenParent, falling back to document.body; dropdown uses the consumer-supplied dropdownParent (if any); otherwise the country selector renders inline within the input wrapper (no detached element).
+  //* NOTE: these are deliberately two separate options. For the dropdown, setting a parent switches it from inline to detached rendering (pos:fixed, positioned against the input), whereas the fullscreen popup is detached regardless, so its parent only relocates it. Sharing one option would force a detached dropdown on anyone who only needs to move the fullscreen popup e.g. into a modal <dialog> (issue #2199).
   #getDetachedParent() {
-    const { countrySelectorMode, dropdownParent } = this.#options;
+    const { countrySelectorMode, dropdownParent, fullscreenParent } = this.#options;
     if (countrySelectorMode === COUNTRY_SELECTOR_MODE.FULLSCREEN) {
-      return document.body;
+      return fullscreenParent ?? document.body;
     }
     if (countrySelectorMode === COUNTRY_SELECTOR_MODE.DROPDOWN) {
       return dropdownParent;
@@ -2883,7 +2890,6 @@ var UI = class {
       const listItem = createEl("li", {
         id: `iti-${this.#id}__item-${c.iso2}`,
         class: liClass,
-        tabindex: "-1",
         role: "option",
         [ARIA.SELECTED]: "false"
       });
@@ -3075,18 +3081,20 @@ var UI = class {
       container.scrollTop = offsetTop - containerRect.height + elementRect.height;
     }
   }
+  //* The element that holds focus while the country selector is open: the search input, or (when countrySearch is disabled) the country list itself.
+  #getOpenFocusEl() {
+    return this.#options.countrySearch ? this.#searchInputEl : this.#countryListEl;
+  }
   //* Remove highlighting from the previous list item and highlight the new one.
   #highlightListItem(listItem, doScroll = true) {
     this.#highlightedListItemEl?.classList.remove(CLASSES.HIGHLIGHT);
     if (listItem) {
       listItem.classList.add(CLASSES.HIGHLIGHT);
-      if (this.#options.countrySearch) {
-        const activeDescendant = listItem.getAttribute("id") || "";
-        this.#searchInputEl.setAttribute(
-          ARIA.ACTIVE_DESCENDANT,
-          activeDescendant
-        );
-      }
+      const activeDescendant = listItem.getAttribute("id") || "";
+      this.#getOpenFocusEl().setAttribute(
+        ARIA.ACTIVE_DESCENDANT,
+        activeDescendant
+      );
       if (doScroll) {
         this.#scrollCountryListToItem(listItem);
       }
@@ -3165,7 +3173,7 @@ var UI = class {
   //* Open the country selector: create a fresh AbortController, do the DOM work, and wire up all
   //* open-state listeners (which invoke the caller's onSelect / onClose callbacks).
   openCountrySelector(onSelect, onClose) {
-    const { countrySearch, dropdownAlwaysOpen } = this.#options;
+    const { dropdownAlwaysOpen } = this.#options;
     this.#countrySelectorAbortController = new AbortController();
     if (this.#options.countrySelectorMode !== COUNTRY_SELECTOR_MODE.FULLSCREEN) {
       this.#ensureInlineDropdownSizeMeasured();
@@ -3188,10 +3196,11 @@ var UI = class {
     if (itemToHighlight) {
       this.#highlightListItem(itemToHighlight);
     }
-    if (countrySearch && !dropdownAlwaysOpen) {
-      this.#searchInputEl.focus();
+    if (!dropdownAlwaysOpen) {
+      this.#getOpenFocusEl().focus();
     }
     if (this.#options.countrySelectorMode === COUNTRY_SELECTOR_MODE.FULLSCREEN && this.#detachedCountrySelectorEl && window.visualViewport) {
+      this.#adjustFullscreenPopupToViewport();
       window.visualViewport.addEventListener(
         "resize",
         () => {
@@ -3308,6 +3317,20 @@ var UI = class {
     };
     this.#selectedCountryEl?.addEventListener("keydown", handleKeydown, { signal });
     this.#countrySelectorEl?.addEventListener("keydown", handleKeydown, { signal });
+    if (this.#detachedCountrySelectorEl) {
+      this.#countrySelectorEl?.addEventListener(
+        "keydown",
+        (e) => {
+          if (e.key === KEYS.TAB) {
+            e.preventDefault();
+            onEscape();
+            const focusEl = e.shiftKey ? this.#selectedCountryEl : this.telInputEl;
+            focusEl.focus();
+          }
+        },
+        { signal }
+      );
+    }
   }
   //* Wire up country search input listener: typing filters the list, the clear button resets it.
   #bindSearchInputListener(signal) {
@@ -3405,8 +3428,8 @@ var UI = class {
     this.#countrySelectorAbortController = null;
     this.#countrySelectorEl.classList.add(CLASSES.HIDE);
     this.#selectedCountryEl.setAttribute(ARIA.EXPANDED, "false");
+    this.#getOpenFocusEl().removeAttribute(ARIA.ACTIVE_DESCENDANT);
     if (countrySearch) {
-      this.#searchInputEl.removeAttribute(ARIA.ACTIVE_DESCENDANT);
       this.#searchInputEl.value = "";
       this.#applySearchFilter();
       if (this.#highlightedListItemEl) {
@@ -3419,6 +3442,7 @@ var UI = class {
       this.#detachedCountrySelectorEl.remove();
       this.#detachedCountrySelectorEl.style.top = "";
       this.#detachedCountrySelectorEl.style.bottom = "";
+      this.#detachedCountrySelectorEl.style.removeProperty("--iti-virtual-keyboard-height");
       this.#detachedCountrySelectorEl.style.paddingLeft = "";
       this.#detachedCountrySelectorEl.style.paddingRight = "";
     } else {
@@ -3477,15 +3501,16 @@ var UI = class {
     this.telInputEl.style.anchorName = existing && existing !== "none" ? `${existing}, ${anchorName}` : anchorName;
     this.#detachedCountrySelectorEl.style.positionAnchor = anchorName;
   }
-  // Adjust the fullscreen popup dimensions to match the visual viewport,
-  // so it stays above the virtual keyboard on mobile devices.
+  // Tell the CSS how much of the fullscreen popup is covered by the virtual keyboard, so it can fit the
+  // country selector above it, while the popup itself (the dark backdrop) stays fullscreen behind the keyboard.
   #adjustFullscreenPopupToViewport() {
     const vv = window.visualViewport;
-    if (!vv || !this.#detachedCountrySelectorEl) {
+    const popup = this.#detachedCountrySelectorEl;
+    if (!vv || !popup) {
       return;
     }
-    const virtualKeyboardHeight = window.innerHeight - vv.height;
-    this.#detachedCountrySelectorEl.style.bottom = `${virtualKeyboardHeight}px`;
+    const virtualKeyboardHeight = Math.max(0, popup.offsetHeight - vv.height);
+    popup.style.setProperty("--iti-virtual-keyboard-height", `${virtualKeyboardHeight}px`);
   }
   // UI: Whether the country selector is currently open (visible).
   isCountrySelectorOpen() {
@@ -4955,7 +4980,7 @@ var intlTelInput = Object.assign(
     attachUtils,
     startedLoadingUtils: false,
     startedLoadingAutoCountry: false,
-    version: "29.3.0",
+    version: "29.4.1",
     NUMBER_FORMAT,
     NUMBER_TYPE,
     VALIDATION_ERROR,
@@ -11231,6 +11256,7 @@ var IntlTelInput = class _IntlTelInput {
   excludeCountries;
   matchDropdownWidth;
   formatAsYouType;
+  fullscreenParent;
   hiddenInputs;
   uiTranslations;
   initialCountry;
@@ -11303,6 +11329,7 @@ var IntlTelInput = class _IntlTelInput {
     if (this.readonly) {
       this.iti.setReadonly(this.readonly);
     }
+    this.lastEmittedCountry = this.iti.getSelectedCountry()?.iso2 ?? "";
     this.iti.promise.then(() => {
       if (!this.iti?.isActive()) {
         return;
@@ -11339,6 +11366,7 @@ var IntlTelInput = class _IntlTelInput {
       excludeCountries: this.excludeCountries,
       matchDropdownWidth: this.matchDropdownWidth,
       formatAsYouType: this.formatAsYouType,
+      fullscreenParent: this.fullscreenParent,
       hiddenInputs: this.hiddenInputs,
       uiTranslations: this.uiTranslations,
       initialCountry: this.initialCountry,
@@ -11522,7 +11550,7 @@ var IntlTelInput = class _IntlTelInput {
     this.onValidatorChange = fn;
   }
   static \u0275fac = i0.\u0275\u0275ngDeclareFactory({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: _IntlTelInput, deps: [], target: i0.\u0275\u0275FactoryTarget.Component });
-  static \u0275cmp = i0.\u0275\u0275ngDeclareComponent({ minVersion: "14.0.0", version: "21.2.7", type: _IntlTelInput, isStandalone: true, selector: "intl-tel-input", inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", countrySelectorMode: "countrySelectorMode", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", classNames: "classNames", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryNameOverrides: "countryNameOverrides", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownParent: "dropdownParent", excludeCountries: "excludeCountries", matchDropdownWidth: "matchDropdownWidth", formatAsYouType: "formatAsYouType", hiddenInputs: "hiddenInputs", uiTranslations: "uiTranslations", initialCountry: "initialCountry", initialCountryLookup: "initialCountryLookup", loadUtils: "loadUtils", numberDisplayFormat: "numberDisplayFormat", onlyCountries: "onlyCountries", placeholderNumberPolicy: "placeholderNumberPolicy", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", strictRejectAnimation: "strictRejectAnimation" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountrySelector: "openCountrySelector", closeCountrySelector: "closeCountrySelector", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, providers: [
+  static \u0275cmp = i0.\u0275\u0275ngDeclareComponent({ minVersion: "14.0.0", version: "21.2.7", type: _IntlTelInput, isStandalone: true, selector: "intl-tel-input", inputs: { initialValue: "initialValue", usePreciseValidation: "usePreciseValidation", inputAttributes: "inputAttributes", disabled: "disabled", readonly: "readonly", countrySelectorMode: "countrySelectorMode", allowedNumberTypes: "allowedNumberTypes", allowNumberExtensions: "allowNumberExtensions", allowPhonewords: "allowPhonewords", classNames: "classNames", containerClass: "containerClass", countryNameLocale: "countryNameLocale", countryNameOverrides: "countryNameOverrides", countryOrder: "countryOrder", countrySearch: "countrySearch", customPlaceholder: "customPlaceholder", dropdownAlwaysOpen: "dropdownAlwaysOpen", dropdownParent: "dropdownParent", excludeCountries: "excludeCountries", matchDropdownWidth: "matchDropdownWidth", formatAsYouType: "formatAsYouType", fullscreenParent: "fullscreenParent", hiddenInputs: "hiddenInputs", uiTranslations: "uiTranslations", initialCountry: "initialCountry", initialCountryLookup: "initialCountryLookup", loadUtils: "loadUtils", numberDisplayFormat: "numberDisplayFormat", onlyCountries: "onlyCountries", placeholderNumberPolicy: "placeholderNumberPolicy", placeholderNumberType: "placeholderNumberType", searchInputClass: "searchInputClass", separateDialCode: "separateDialCode", showFlags: "showFlags", strictMode: "strictMode", strictRejectAnimation: "strictRejectAnimation" }, outputs: { numberChange: "numberChange", countryChange: "countryChange", validityChange: "validityChange", errorCodeChange: "errorCodeChange", openCountrySelector: "openCountrySelector", closeCountrySelector: "closeCountrySelector", strictReject: "strictReject", blur: "blur", focus: "focus", keydown: "keydown", keyup: "keyup", paste: "paste", click: "click" }, providers: [
     {
       provide: NG_VALUE_ACCESSOR,
       useExisting: forwardRef(() => _IntlTelInput),
@@ -11621,6 +11649,8 @@ i0.\u0275\u0275ngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7",
   type: Input
 }], formatAsYouType: [{
   type: Input
+}], fullscreenParent: [{
+  type: Input
 }], hiddenInputs: [{
   type: Input
 }], uiTranslations: [{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intl-tel-input/angular",
-  "version": "29.3.0",
+  "version": "29.4.1",
   "description": "An Angular component for intl-tel-input, for entering, formatting, and validating international telephone numbers",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "README.md"
   ],
   "dependencies": {
-    "intl-tel-input": "^29.3.0"
+    "intl-tel-input": "^29.4.1"
   },
   "peerDependencies": {
     "@angular/common": ">=17",