intl-tel-input 25.10.12 → 25.11.1

package/react/build/IntlTelInput.d.ts

@@ -11,9 +11,9 @@ declare module "intl-tel-input/data" {
         nodeById: {
             [instanceId: number]: HTMLElement;
         };
-        normalisedName?: string;
-        initials?: string;
-        dialCodePlus?: string;
+        normalisedName: string;
+        initials: string;
+        dialCodePlus: string;
     };
     const allCountries: Country[];
     export default allCountries;
@@ -50,6 +50,92 @@ declare module "intl-tel-input/i18n/en" {
     const allTranslations: I18n;
     export default allTranslations;
 }
+declare module "modules/constants" {
+    import { Iso2 } from "intl-tel-input/data";
+    export const EVENTS: {
+        readonly OPEN_COUNTRY_DROPDOWN: "open:countrydropdown";
+        readonly CLOSE_COUNTRY_DROPDOWN: "close:countrydropdown";
+        readonly COUNTRY_CHANGE: "countrychange";
+        readonly INPUT: "input";
+    };
+    export const CLASSES: {
+        readonly HIDE: "iti__hide";
+        readonly V_HIDE: "iti__v-hide";
+        readonly ARROW_UP: "iti__arrow--up";
+        readonly GLOBE: "iti__globe";
+        readonly FLAG: "iti__flag";
+        readonly COUNTRY_ITEM: "iti__country";
+        readonly HIGHLIGHT: "iti__highlight";
+    };
+    export const KEYS: {
+        readonly ARROW_UP: "ArrowUp";
+        readonly ARROW_DOWN: "ArrowDown";
+        readonly SPACE: " ";
+        readonly ENTER: "Enter";
+        readonly ESC: "Escape";
+        readonly TAB: "Tab";
+    };
+    export const INPUT_TYPES: {
+        readonly PASTE: "insertFromPaste";
+        readonly DELETE_FWD: "deleteContentForward";
+    };
+    export const REGEX: {
+        readonly ALPHA_UNICODE: RegExp;
+        readonly NON_PLUS_NUMERIC: RegExp;
+        readonly NON_PLUS_NUMERIC_GLOBAL: RegExp;
+        readonly HIDDEN_SEARCH_CHAR: RegExp;
+    };
+    export const TIMINGS: {
+        readonly SEARCH_DEBOUNCE_MS: 100;
+        readonly HIDDEN_SEARCH_RESET_MS: 1000;
+        readonly NEXT_TICK: 0;
+    };
+    export const SENTINELS: {
+        readonly UNKNOWN_NUMBER_TYPE: -99;
+        readonly UNKNOWN_VALIDATION_ERROR: -99;
+    };
+    export const LAYOUT: {
+        readonly SANE_SELECTED_WITH_DIAL_WIDTH: 78;
+        readonly SANE_SELECTED_NO_DIAL_WIDTH: 42;
+        readonly INPUT_PADDING_EXTRA_LEFT: 6;
+    };
+    export const DIAL: {
+        readonly PLUS: "+";
+        readonly NANP: "1";
+    };
+    export const UK: {
+        readonly ISO2: Iso2;
+        readonly DIAL_CODE: "44";
+        readonly MOBILE_PREFIX: "7";
+        readonly MOBILE_CORE_LENGTH: 10;
+    };
+    export const US: {
+        ISO2: Iso2;
+        DIAL_CODE: string;
+    };
+    export const PLACEHOLDER_MODES: {
+        readonly AGGRESSIVE: "aggressive";
+        readonly POLITE: "polite";
+    };
+    export const INITIAL_COUNTRY: {
+        readonly AUTO: "auto";
+    };
+    export const DATA_KEYS: {
+        readonly COUNTRY_CODE: "countryCode";
+        readonly DIAL_CODE: "dialCode";
+    };
+    export const ARIA: {
+        readonly EXPANDED: "aria-expanded";
+        readonly LABEL: "aria-label";
+        readonly SELECTED: "aria-selected";
+        readonly ACTIVE_DESCENDANT: "aria-activedescendant";
+        readonly HASPOPUP: "aria-haspopup";
+        readonly CONTROLS: "aria-controls";
+        readonly HIDDEN: "aria-hidden";
+        readonly AUTOCOMPLETE: "aria-autocomplete";
+        readonly MODAL: "aria-modal";
+    };
+}
 declare module "modules/types/public-api" {
     import type { Country, Iso2 } from "intl-tel-input/data";
     import type { I18n } from "intl-tel-input/i18n/types";
@@ -123,19 +209,101 @@ declare module "modules/types/public-api" {
         version: string | undefined;
         utils?: ItiUtils;
     }
+    type EmptyObject = Record<string, never>;
+    export type SelectedCountryData = Country | EmptyObject;
 }
 declare module "modules/core/options" {
+    import { I18n } from "intl-tel-input/i18n/types";
     import type { AllOptions } from "modules/types/public-api";
     export const defaults: AllOptions;
-    export function applyOptionSideEffects(o: AllOptions): void;
+    export const applyOptionSideEffects: (o: AllOptions, defaultEnglishStrings: I18n) => void;
 }
 declare module "modules/utils/string" {
     export const getNumeric: (s: string) => string;
     export const normaliseString: (s?: string) => string;
 }
+declare module "modules/core/countrySearch" {
+    import type { Country } from "intl-tel-input/data";
+    /**
+     * Country search: Given raw query, return ordered list of countries by priority buckets.
+     * Buckets (in order):
+     *  1. exact ISO2 matches
+     *  2. name starts with
+     *  3. name contains
+     *  4. dial code exact match (bare or with plus)
+     *  5. dial code contains (with plus form)
+     *  6. initials match
+     * Each bucket preserves country.priority ordering.
+     */
+    export const getMatchedCountries: (countries: Country[], query: string) => Country[];
+    /**
+     * Hidden search (when countrySearch disabled): find first whose name starts with query (case-insensitive).
+     */
+    export const findFirstCountryStartingWith: (countries: Country[], query: string) => Country | null;
+}
 declare module "modules/utils/dom" {
+    /**
+     * Build a space-delimited class string from an object map of className -> truthy/falsey.
+     * Only keys with truthy values are included.
+     */
+    export const buildClassNames: (flags: Record<string, unknown>) => string;
     export const createEl: (tagName: string, attrs?: object | null, container?: HTMLElement) => HTMLElement;
 }
+declare module "modules/core/icons" {
+    /** Magnifying glass search icon */
+    export const buildSearchIcon: () => string;
+    /**
+     * Clear (circle with X) icon
+     * @param id Instance id used to create a unique mask id.
+     */
+    export const buildClearIcon: (id: number) => string;
+}
+declare module "modules/core/ui" {
+    import { Country } from "intl-tel-input/data";
+    import { AllOptions } from "modules/types/public-api";
+    export default class UI {
+        private readonly options;
+        private readonly id;
+        private readonly isRTL;
+        private readonly originalPaddingLeft;
+        private countries;
+        telInput: HTMLInputElement;
+        countryContainer: HTMLElement;
+        selectedCountry: HTMLElement;
+        selectedCountryInner: HTMLElement;
+        selectedDialCode: HTMLElement;
+        dropdownArrow: HTMLElement;
+        dropdownContent: HTMLElement;
+        searchInput: HTMLInputElement;
+        searchIcon: HTMLElement;
+        searchClearButton: HTMLButtonElement;
+        searchNoResults: HTMLElement;
+        searchResultsA11yText: HTMLElement;
+        countryList: HTMLElement;
+        dropdown: HTMLElement;
+        hiddenInput: HTMLInputElement;
+        hiddenInputCountry: HTMLInputElement;
+        highlightedItem: HTMLElement | null;
+        readonly hadInitialPlaceholder: boolean;
+        constructor(input: HTMLInputElement, options: AllOptions, id: number);
+        generateMarkup(countries: Country[]): void;
+        private _prepareTelInput;
+        private _createWrapperAndInsert;
+        private _maybeBuildCountryContainer;
+        private _buildDropdownContent;
+        private _buildSearchUI;
+        private _maybeUpdateInputPaddingAndReveal;
+        private _maybeBuildHiddenInputs;
+        private _appendListItems;
+        updateInputPadding(): void;
+        private _getHiddenSelectedCountryWidth;
+        updateSearchResultsA11yText(): void;
+        scrollTo(element: HTMLElement): void;
+        highlightListItem(listItem: HTMLElement | null, shouldFocus: boolean): void;
+        filterCountries(matchedCountries: Country[]): void;
+        destroy(): void;
+    }
+}
 declare module "modules/data/country-data" {
     import { Country, Iso2 } from "intl-tel-input/data";
     import type { AllOptions } from "modules/types/public-api";
@@ -144,104 +312,68 @@ declare module "modules/data/country-data" {
         dialCodeMaxLen: number;
         dialCodeToIso2Map: Record<string, Iso2[]>;
     }
-    export function processAllCountries(options: AllOptions): Country[];
-    export function translateCountryNames(countries: Country[], options: AllOptions): void;
-    export function processDialCodes(countries: Country[], options: AllOptions): DialCodeProcessingResult;
-    export function sortCountries(countries: Country[], options: AllOptions): void;
-    export function cacheSearchTokens(countries: Country[]): void;
+    export const processAllCountries: (options: AllOptions) => Country[];
+    export const translateCountryNames: (countries: Country[], options: AllOptions) => void;
+    export const processDialCodes: (countries: Country[], options: AllOptions) => DialCodeProcessingResult;
+    export const sortCountries: (countries: Country[], options: AllOptions) => void;
+    export const cacheSearchTokens: (countries: Country[]) => void;
 }
 declare module "modules/format/formatting" {
-    import { Country } from "intl-tel-input/data";
-    export function beforeSetNumber(fullNumber: string, dialCode: string, separateDialCode: boolean, selectedCountryData: Partial<Country>): string;
-    export function formatNumberAsYouType(fullNumber: string, telInputValue: string, utils: any, selectedCountryData: Partial<Country>, separateDialCode: boolean): string;
+    import { SelectedCountryData } from "modules/types/public-api";
+    export const beforeSetNumber: (fullNumber: string, dialCode: string, separateDialCode: boolean, selectedCountryData: SelectedCountryData) => string;
+    export const formatNumberAsYouType: (fullNumber: string, telInputValue: string, utils: any, selectedCountryData: SelectedCountryData, separateDialCode: boolean) => string;
 }
 declare module "modules/format/caret" {
-    export function translateCursorPosition(relevantChars: number, formattedValue: string, prevCaretPos: number, isDeleteForwards: boolean): number;
+    export const translateCursorPosition: (relevantChars: number, formattedValue: string, prevCaretPos: number, isDeleteForwards: boolean) => number;
 }
 declare module "modules/data/nanp-regionless" {
     export const regionlessNanpNumbers: string[];
     export const isRegionlessNanp: (number: string) => boolean;
 }
+declare module "modules/types/events" {
+    import { EVENTS } from "modules/constants";
+    export type ItiEventMap = {
+        [EVENTS.COUNTRY_CHANGE]: Record<string, never>;
+        [EVENTS.OPEN_COUNTRY_DROPDOWN]: Record<string, never>;
+        [EVENTS.CLOSE_COUNTRY_DROPDOWN]: Record<string, never>;
+        [EVENTS.INPUT]: {
+            isSetNumber?: boolean;
+        };
+    };
+}
 declare module "intl-tel-input" {
-    import { Country, Iso2 } from "intl-tel-input/data";
-    import type { NumberType, SomeOptions, IntlTelInputInterface } from "modules/types/public-api";
+    import { Iso2 } from "intl-tel-input/data";
+    import type { NumberType, SomeOptions, IntlTelInputInterface, SelectedCountryData } from "modules/types/public-api";
     global {
         interface HTMLInputElement {
             iti?: Iti;
         }
     }
     export class Iti {
-        id: number;
-        promise: Promise<[unknown, unknown]>;
-        private telInput;
-        private highlightedItem;
-        private options;
-        private hadInitialPlaceholder;
-        private isRTL;
-        private isAndroid;
+        readonly id: number;
+        readonly promise: Promise<[unknown, unknown]>;
+        private readonly ui;
+        private readonly options;
+        private readonly isAndroid;
+        private readonly countries;
+        private readonly dialCodeMaxLen;
+        private readonly dialCodeToIso2Map;
+        private readonly dialCodes;
+        private readonly countryByIso2;
         private selectedCountryData;
-        private countries;
-        private dialCodeMaxLen;
-        private dialCodeToIso2Map;
-        private dialCodes;
-        private countryByIso2;
-        private countryContainer;
-        private selectedCountry;
-        private selectedCountryInner;
-        private selectedDialCode;
-        private dropdownArrow;
-        private dropdownContent;
-        private searchInput;
-        private searchIcon;
-        private searchClearButton;
-        private searchNoResults;
-        private searchResultsA11yText;
-        private countryList;
-        private dropdown;
-        private hiddenInput;
-        private hiddenInputCountry;
         private maxCoreNumberLength;
         private defaultCountry;
-        private originalPaddingLeft;
-        private _handleHiddenInputSubmit;
-        private _handleLabelClick;
-        private _handleClickSelectedCountry;
-        private _handleCountryContainerKeydown;
-        private _handleInputEvent;
-        private _handleKeydownEvent;
-        private _handlePasteEvent;
-        private _handleWindowScroll;
-        private _handleMouseoverCountryList;
-        private _handleClickCountryList;
-        private _handleClickOffToClose;
-        private _handleKeydownOnDropdown;
-        private _handleSearchChange;
-        private _handleSearchClear;
-        private _handlePageLoad;
-        private _doAttachUtils;
+        private abortController;
+        private dropdownAbortController;
         private resolveAutoCountryPromise;
         private rejectAutoCountryPromise;
         private resolveUtilsScriptPromise;
         private rejectUtilsScriptPromise;
-        /**
-         * Build a space-delimited class string from an object map of className -> truthy/falsey.
-         * Only keys with truthy values are included.
-         */
-        private static _buildClassNames;
         constructor(input: HTMLInputElement, customOptions?: SomeOptions);
-        private _detectEnvironmentAndLayout;
+        private static _getIsAndroid;
         private _createInitPromises;
         _init(): void;
         private _processCountryData;
-        private _generateMarkup;
-        private _prepareTelInput;
-        private _createWrapperAndInsert;
-        private _maybeBuildCountryContainer;
-        private _buildDropdownContent;
-        private _buildSearchUI;
-        private _maybeUpdateInputPaddingAndReveal;
-        private _maybeBuildHiddenInputs;
-        private _appendListItems;
         private _setInitialState;
         private _initListeners;
         private _initHiddenInputListener;
@@ -258,25 +390,24 @@ declare module "intl-tel-input" {
         private _openDropdown;
         private _setDropdownPosition;
         private _bindDropdownListeners;
+        private _bindDropdownMouseoverListener;
+        private _bindDropdownCountryClickListener;
+        private _bindDropdownClickOffListener;
+        private _bindDropdownKeydownListener;
+        private _bindDropdownSearchListeners;
         private _searchForCountry;
-        private _filterCountries;
-        private _getMatchedCountries;
-        private _updateSearchResultsA11yText;
+        private _filterCountriesByQuery;
         private _handleUpDownKey;
         private _handleEnterKey;
         private _updateValFromNumber;
         private _updateCountryFromNumber;
         private _ensureHasDialCode;
         private _getNewCountryFromNumber;
-        private _highlightListItem;
         private _setCountry;
-        private _updateInputPadding;
         private _updateMaxLength;
-        private _getHiddenSelectedCountryWidth;
         private _updatePlaceholder;
         private _selectListItem;
         private _closeDropdown;
-        private _scrollTo;
         private _updateDialCode;
         private _getDialCode;
         private _getFullNumber;
@@ -288,7 +419,7 @@ declare module "intl-tel-input" {
         getExtension(): string;
         getNumber(format?: number): string;
         getNumberType(): number;
-        getSelectedCountryData(): Partial<Country>;
+        getSelectedCountryData(): SelectedCountryData;
         getValidationError(): number;
         isValidNumber(): boolean | null;
         isValidNumberPrecise(): boolean | null;