intl-tel-input 24.8.1 → 25.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intl-tel-input",
-  "version": "24.8.1",
+  "version": "25.0.0",
   "description": "A JavaScript plugin for entering and validating international telephone numbers",
   "keywords": [
     "international",

package/react/README.md

@@ -28,7 +28,7 @@ import "intl-tel-input/styles";
 
 See the [Validation demo](https://github.com/jackocnr/intl-tel-input/blob/master/react/demo/validation/ValidationApp.tsx) for a more fleshed-out example of how to handle validation.
 
-A note on the utils script (~260KB): if you're lazy loading the IntlTelInput chunk (and so less worried about filesize) then you can just import IntlTelInput from `"intl-tel-input/reactWithUtils"`, to include the utils script. Alternatively, if you use the main `"intl-tel-input/react"` import, then you should couple this with the `utilsScript` initialisation option - you will need to host the [utils.js](https://github.com/jackocnr/intl-tel-input/blob/master/build/js/utils.js) file, and then set the `utilsScript` option to that URL, or alternatively just point it to a CDN hosted version e.g. `"https://cdn.jsdelivr.net/npm/intl-tel-input@24.8.1/build/js/utils.js"`.
+A note on the utils script (~260KB): if you're lazy loading the IntlTelInput chunk (and so less worried about filesize) then you can just import IntlTelInput from `"intl-tel-input/reactWithUtils"`, to include the utils script. Alternatively, if you use the main `"intl-tel-input/react"` import, then you should couple this with the `utilsScript` initialisation option - you will need to host the [utils.js](https://github.com/jackocnr/intl-tel-input/blob/master/build/js/utils.js) file, and then set the `utilsScript` option to that URL, or alternatively just point it to a CDN hosted version e.g. `"https://cdn.jsdelivr.net/npm/intl-tel-input@25.0.0/build/js/utils.js"`.
 
 ## Props
 Here's a list of all of the current props you can pass to the IntlTelInput React component.

package/react/build/IntlTelInput.cjs

@@ -1659,8 +1659,8 @@ var defaults = {
   i18n: {},
   //* Initial country.
   initialCountry: "",
-  //* Specify the path to the libphonenumber script to enable validation/formatting.
-  loadUtilsOnInit: "",
+  //* A function to load the utils script.
+  loadUtils: null,
   //* National vs international formatting for numbers e.g. placeholders and displaying existing numbers.
   nationalMode: true,
   //* Display only these countries.
@@ -1681,10 +1681,8 @@ var defaults = {
       navigator.userAgent
     ) || window.innerWidth <= 500
   ) : false,
-  //* Deprecated! Use `loadUtilsOnInit` instead.
-  utilsScript: "",
   //* The number type to enforce during validation.
-  validationNumberType: "MOBILE"
+  validationNumberTypes: ["MOBILE"]
 };
 var regionlessNanpNumbers = [
   "800",
@@ -2193,15 +2191,11 @@ var Iti = class {
   }
   //* Init many requests: utils script / geo ip lookup.
   _initRequests() {
-    let { loadUtilsOnInit, utilsScript, initialCountry, geoIpLookup } = this.options;
-    if (!loadUtilsOnInit && utilsScript) {
-      console.warn("intl-tel-input: The `utilsScript` option is deprecated and will be removed in a future release! Please use the `loadUtilsOnInit` option instead.");
-      loadUtilsOnInit = utilsScript;
-    }
-    if (loadUtilsOnInit && !intlTelInput.utils) {
+    let { loadUtils, initialCountry, geoIpLookup } = this.options;
+    if (loadUtils && !intlTelInput.utils) {
       this._handlePageLoad = () => {
         window.removeEventListener("load", this._handlePageLoad);
-        intlTelInput.loadUtils(loadUtilsOnInit)?.catch(() => {
+        intlTelInput.attachUtils(loadUtils)?.catch(() => {
         });
       };
       if (intlTelInput.documentReady()) {
@@ -2665,7 +2659,7 @@ var Iti = class {
   }
   //* Update the maximum valid number length for the currently selected country.
   _updateMaxLength() {
-    const { strictMode, placeholderNumberType, validationNumberType } = this.options;
+    const { strictMode, placeholderNumberType, validationNumberTypes } = this.options;
     const { iso2 } = this.selectedCountryData;
     if (strictMode && intlTelInput.utils) {
       if (iso2) {
@@ -2677,7 +2671,7 @@ var Iti = class {
           true
         );
         let validNumber = exampleNumber;
-        while (intlTelInput.utils.isPossibleNumber(exampleNumber, iso2, validationNumberType)) {
+        while (intlTelInput.utils.isPossibleNumber(exampleNumber, iso2, validationNumberTypes)) {
           validNumber = exampleNumber;
           exampleNumber += "0";
         }
@@ -3029,7 +3023,7 @@ var Iti = class {
     return this._utilsIsPossibleNumber(val);
   }
   _utilsIsPossibleNumber(val) {
-    return intlTelInput.utils ? intlTelInput.utils.isPossibleNumber(val, this.selectedCountryData.iso2, this.options.validationNumberType) : null;
+    return intlTelInput.utils ? intlTelInput.utils.isPossibleNumber(val, this.selectedCountryData.iso2, this.options.validationNumberTypes) : null;
   }
   //* Validate the input val (precise)
   isValidNumberPrecise() {
@@ -3047,7 +3041,7 @@ var Iti = class {
     return this._utilsIsValidNumber(val);
   }
   _utilsIsValidNumber(val) {
-    return intlTelInput.utils ? intlTelInput.utils.isValidNumber(val, this.selectedCountryData.iso2) : null;
+    return intlTelInput.utils ? intlTelInput.utils.isValidNumber(val, this.selectedCountryData.iso2, this.options.validationNumberTypes) : null;
   }
   //* Update the selected country, and update the input val accordingly.
   setCountry(iso2) {
@@ -3083,33 +3077,23 @@ var Iti = class {
     }
   }
 };
-var loadUtils = (source) => {
+var attachUtils = (source) => {
   if (!intlTelInput.utils && !intlTelInput.startedLoadingUtilsScript) {
     let loadCall;
-    if (typeof source === "string") {
-      loadCall = import(
-        /* webpackIgnore: true */
-        /* @vite-ignore */
-        source
-      );
-    } else if (typeof source === "function") {
+    if (typeof source === "function") {
       try {
         loadCall = Promise.resolve(source());
       } catch (error) {
         return Promise.reject(error);
       }
     } else {
-      return Promise.reject(new TypeError(`The argument passed to loadUtils must be a URL string or a function that returns a promise for the utilities module, not ${typeof source}`));
+      return Promise.reject(new TypeError(`The argument passed to attachUtils must be a function that returns a promise for the utilities module, not ${typeof source}`));
     }
     intlTelInput.startedLoadingUtilsScript = true;
     return loadCall.then((module2) => {
       const utils = module2?.default;
       if (!utils || typeof utils !== "object") {
-        if (typeof source === "string") {
-          throw new TypeError(`The module loaded from ${source} did not set utils as its default export.`);
-        } else {
-          throw new TypeError("The loader function passed to loadUtils did not resolve to a module object with utils as its default export.");
-        }
+        throw new TypeError("The loader function passed to attachUtils did not resolve to a module object with utils as its default export.");
       }
       intlTelInput.utils = utils;
       forEachInstance("handleUtils");
@@ -3142,10 +3126,10 @@ var intlTelInput = Object.assign(
     },
     //* A map from instance ID to instance object.
     instances: {},
-    loadUtils,
+    attachUtils,
     startedLoadingUtilsScript: false,
     startedLoadingAutoCountry: false,
-    version: "24.8.1"
+    version: "25.0.0"
   }
 );
 var intl_tel_input_default = intlTelInput;

package/react/build/IntlTelInput.d.ts

@@ -299,7 +299,7 @@ declare module "intl-tel-input" {
         instances: {
             [key: string]: Iti;
         };
-        loadUtils: (source: string | UtilsLoader) => Promise<unknown> | null;
+        attachUtils: (source: UtilsLoader) => Promise<unknown> | null;
         startedLoadingAutoCountry: boolean;
         startedLoadingUtilsScript: boolean;
         version: string | undefined;
@@ -311,10 +311,10 @@ declare module "intl-tel-input" {
         getCoreNumber(number: string, iso2: string | undefined): string;
         getExampleNumber(iso2: string | undefined, nationalMode: boolean, numberType: number, useE164?: boolean): string;
         getExtension(number: string, iso2: string | undefined): string;
-        getNumberType: (number: string, iso2: string | undefined) => number;
+        getNumberType(number: string, iso2: string | undefined): number;
         getValidationError(number: string, iso2: string | undefined): number;
-        isPossibleNumber(number: string, iso2: string | undefined, numberType?: string): boolean;
-        isValidNumber: (number: string, iso2: string | undefined) => boolean;
+        isPossibleNumber(number: string, iso2: string | undefined, numberType?: NumberType[] | null): boolean;
+        isValidNumber(number: string, iso2: string | undefined, numberType?: NumberType[] | null): boolean;
         numberFormat: {
             NATIONAL: number;
             INTERNATIONAL: number;
@@ -348,7 +348,7 @@ declare module "intl-tel-input" {
         }) | null;
         i18n: I18n;
         initialCountry: string;
-        loadUtilsOnInit: string | UtilsLoader;
+        loadUtils: UtilsLoader;
         nationalMode: boolean;
         onlyCountries: string[];
         placeholderNumberType: NumberType;
@@ -356,9 +356,7 @@ declare module "intl-tel-input" {
         separateDialCode: boolean;
         strictMode: boolean;
         useFullscreenPopup: boolean;
-        /** @deprecated Please use the `loadUtilsOnInit` option. */
-        utilsScript: string | UtilsLoader;
-        validationNumberType: NumberType | null;
+        validationNumberTypes: NumberType[] | null;
     }
     export type SomeOptions = Partial<AllOptions>;
     export class Iti {

package/react/build/IntlTelInput.js

@@ -1623,8 +1623,8 @@ var defaults = {
   i18n: {},
   //* Initial country.
   initialCountry: "",
-  //* Specify the path to the libphonenumber script to enable validation/formatting.
-  loadUtilsOnInit: "",
+  //* A function to load the utils script.
+  loadUtils: null,
   //* National vs international formatting for numbers e.g. placeholders and displaying existing numbers.
   nationalMode: true,
   //* Display only these countries.
@@ -1645,10 +1645,8 @@ var defaults = {
       navigator.userAgent
     ) || window.innerWidth <= 500
   ) : false,
-  //* Deprecated! Use `loadUtilsOnInit` instead.
-  utilsScript: "",
   //* The number type to enforce during validation.
-  validationNumberType: "MOBILE"
+  validationNumberTypes: ["MOBILE"]
 };
 var regionlessNanpNumbers = [
   "800",
@@ -2157,15 +2155,11 @@ var Iti = class {
   }
   //* Init many requests: utils script / geo ip lookup.
   _initRequests() {
-    let { loadUtilsOnInit, utilsScript, initialCountry, geoIpLookup } = this.options;
-    if (!loadUtilsOnInit && utilsScript) {
-      console.warn("intl-tel-input: The `utilsScript` option is deprecated and will be removed in a future release! Please use the `loadUtilsOnInit` option instead.");
-      loadUtilsOnInit = utilsScript;
-    }
-    if (loadUtilsOnInit && !intlTelInput.utils) {
+    let { loadUtils, initialCountry, geoIpLookup } = this.options;
+    if (loadUtils && !intlTelInput.utils) {
       this._handlePageLoad = () => {
         window.removeEventListener("load", this._handlePageLoad);
-        intlTelInput.loadUtils(loadUtilsOnInit)?.catch(() => {
+        intlTelInput.attachUtils(loadUtils)?.catch(() => {
         });
       };
       if (intlTelInput.documentReady()) {
@@ -2629,7 +2623,7 @@ var Iti = class {
   }
   //* Update the maximum valid number length for the currently selected country.
   _updateMaxLength() {
-    const { strictMode, placeholderNumberType, validationNumberType } = this.options;
+    const { strictMode, placeholderNumberType, validationNumberTypes } = this.options;
     const { iso2 } = this.selectedCountryData;
     if (strictMode && intlTelInput.utils) {
       if (iso2) {
@@ -2641,7 +2635,7 @@ var Iti = class {
           true
         );
         let validNumber = exampleNumber;
-        while (intlTelInput.utils.isPossibleNumber(exampleNumber, iso2, validationNumberType)) {
+        while (intlTelInput.utils.isPossibleNumber(exampleNumber, iso2, validationNumberTypes)) {
           validNumber = exampleNumber;
           exampleNumber += "0";
         }
@@ -2993,7 +2987,7 @@ var Iti = class {
     return this._utilsIsPossibleNumber(val);
   }
   _utilsIsPossibleNumber(val) {
-    return intlTelInput.utils ? intlTelInput.utils.isPossibleNumber(val, this.selectedCountryData.iso2, this.options.validationNumberType) : null;
+    return intlTelInput.utils ? intlTelInput.utils.isPossibleNumber(val, this.selectedCountryData.iso2, this.options.validationNumberTypes) : null;
   }
   //* Validate the input val (precise)
   isValidNumberPrecise() {
@@ -3011,7 +3005,7 @@ var Iti = class {
     return this._utilsIsValidNumber(val);
   }
   _utilsIsValidNumber(val) {
-    return intlTelInput.utils ? intlTelInput.utils.isValidNumber(val, this.selectedCountryData.iso2) : null;
+    return intlTelInput.utils ? intlTelInput.utils.isValidNumber(val, this.selectedCountryData.iso2, this.options.validationNumberTypes) : null;
   }
   //* Update the selected country, and update the input val accordingly.
   setCountry(iso2) {
@@ -3047,33 +3041,23 @@ var Iti = class {
     }
   }
 };
-var loadUtils = (source) => {
+var attachUtils = (source) => {
   if (!intlTelInput.utils && !intlTelInput.startedLoadingUtilsScript) {
     let loadCall;
-    if (typeof source === "string") {
-      loadCall = import(
-        /* webpackIgnore: true */
-        /* @vite-ignore */
-        source
-      );
-    } else if (typeof source === "function") {
+    if (typeof source === "function") {
       try {
         loadCall = Promise.resolve(source());
       } catch (error) {
         return Promise.reject(error);
       }
     } else {
-      return Promise.reject(new TypeError(`The argument passed to loadUtils must be a URL string or a function that returns a promise for the utilities module, not ${typeof source}`));
+      return Promise.reject(new TypeError(`The argument passed to attachUtils must be a function that returns a promise for the utilities module, not ${typeof source}`));
     }
     intlTelInput.startedLoadingUtilsScript = true;
     return loadCall.then((module) => {
       const utils = module?.default;
       if (!utils || typeof utils !== "object") {
-        if (typeof source === "string") {
-          throw new TypeError(`The module loaded from ${source} did not set utils as its default export.`);
-        } else {
-          throw new TypeError("The loader function passed to loadUtils did not resolve to a module object with utils as its default export.");
-        }
+        throw new TypeError("The loader function passed to attachUtils did not resolve to a module object with utils as its default export.");
       }
       intlTelInput.utils = utils;
       forEachInstance("handleUtils");
@@ -3106,10 +3090,10 @@ var intlTelInput = Object.assign(
     },
     //* A map from instance ID to instance object.
     instances: {},
-    loadUtils,
+    attachUtils,
     startedLoadingUtilsScript: false,
     startedLoadingAutoCountry: false,
-    version: "24.8.1"
+    version: "25.0.0"
   }
 );
 var intl_tel_input_default = intlTelInput;