@samline/formatter 1.0.1 → 1.1.0

package/dist/browser/global.global.js

@@ -2082,8 +2082,8 @@ var Formatter = (() => {
     }
     return cleared_string;
   }
-  function populateTemplateWithDigits(template, position, digits) {
-    for (var _iterator2 = _createForOfIteratorHelperLoose5(digits.split("")), _step2; !(_step2 = _iterator2()).done; ) {
+  function populateTemplateWithDigits(template, position, digits2) {
+    for (var _iterator2 = _createForOfIteratorHelperLoose5(digits2.split("")), _step2; !(_step2 = _iterator2()).done; ) {
       var digit = _step2.value;
       if (template.slice(position + 1).search(DIGIT_PLACEHOLDER_MATCHER) < 0) {
         return;
@@ -2894,14 +2894,14 @@ var Formatter = (() => {
         if (SUPPORT_LEGACY_FORMATTING_PATTERNS) {
           pattern = pattern.replace(CREATE_CHARACTER_CLASS_PATTERN(), "\\d").replace(CREATE_STANDALONE_DIGIT_PATTERN(), "\\d");
         }
-        var digits = LONGEST_DUMMY_PHONE_NUMBER.match(pattern)[0];
-        if (nationalSignificantNumber.length > digits.length) {
+        var digits2 = LONGEST_DUMMY_PHONE_NUMBER.match(pattern)[0];
+        if (nationalSignificantNumber.length > digits2.length) {
           return;
         }
         var strictPattern = new RegExp("^" + pattern + "$");
         var nationalNumberDummyDigits = nationalSignificantNumber.replace(/\d/g, DUMMY_DIGIT);
         if (strictPattern.test(nationalNumberDummyDigits)) {
-          digits = nationalNumberDummyDigits;
+          digits2 = nationalNumberDummyDigits;
         }
         var numberFormat = this.getFormatFormat(format2, international);
         var nationalPrefixIncludedInTemplate;
@@ -2922,7 +2922,7 @@ var Formatter = (() => {
             }
           }
         }
-        var template = digits.replace(new RegExp(pattern), numberFormat).replace(new RegExp(DUMMY_DIGIT, "g"), DIGIT_PLACEHOLDER);
+        var template = digits2.replace(new RegExp(pattern), numberFormat).replace(new RegExp(DUMMY_DIGIT, "g"), DIGIT_PLACEHOLDER);
         if (!nationalPrefixIncludedInTemplate) {
           if (prefixBeforeNationalSignificantNumberThatIsNotNationalPrefix) {
             template = repeat(DIGIT_PLACEHOLDER, prefixBeforeNationalSignificantNumberThatIsNotNationalPrefix.length) + " " + template;
@@ -2937,8 +2937,8 @@ var Formatter = (() => {
       }
     }, {
       key: "formatNextNationalNumberDigits",
-      value: function formatNextNationalNumberDigits(digits) {
-        var result = populateTemplateWithDigits(this.populatedNationalNumberTemplate, this.populatedNationalNumberTemplatePosition, digits);
+      value: function formatNextNationalNumberDigits(digits2) {
+        var result = populateTemplateWithDigits(this.populatedNationalNumberTemplate, this.populatedNationalNumberTemplatePosition, digits2);
         if (!result) {
           this.resetFormat();
           return;
@@ -3056,21 +3056,21 @@ var Formatter = (() => {
       key: "input",
       value: function input(text, state) {
         var _extractFormattedDigi = extractFormattedDigitsAndPlus(text), _extractFormattedDigi2 = _slicedToArray(_extractFormattedDigi, 2), formattedDigits = _extractFormattedDigi2[0], hasPlus = _extractFormattedDigi2[1];
-        var digits = parseDigits(formattedDigits);
+        var digits2 = parseDigits(formattedDigits);
         var justLeadingPlus;
         if (hasPlus) {
           if (!state.digits) {
             state.startInternationalNumber(void 0, void 0);
-            if (!digits) {
+            if (!digits2) {
               justLeadingPlus = true;
             }
           }
         }
-        if (digits) {
-          this.inputDigits(digits, state);
+        if (digits2) {
+          this.inputDigits(digits2, state);
         }
         return {
-          digits,
+          digits: digits2,
           justLeadingPlus
         };
       }
@@ -3082,8 +3082,8 @@ var Formatter = (() => {
     }, {
       key: "inputDigits",
       value: function inputDigits(nextDigits, state) {
-        var digits = state.digits;
-        var hasReceivedThreeLeadingDigits = digits.length < 3 && digits.length + nextDigits.length >= 3;
+        var digits2 = state.digits;
+        var hasReceivedThreeLeadingDigits = digits2.length < 3 && digits2.length + nextDigits.length >= 3;
         state.appendDigits(nextDigits);
         if (hasReceivedThreeLeadingDigits) {
           this.extractIddPrefix(state);
@@ -3222,14 +3222,14 @@ var Formatter = (() => {
     }, {
       key: "extractIddPrefix",
       value: function extractIddPrefix(state) {
-        var international = state.international, IDDPrefix = state.IDDPrefix, digits = state.digits, nationalSignificantNumber = state.nationalSignificantNumber;
+        var international = state.international, IDDPrefix = state.IDDPrefix, digits2 = state.digits, nationalSignificantNumber = state.nationalSignificantNumber;
         if (international || IDDPrefix) {
           return;
         }
-        var numberWithoutIDD = stripIddPrefix(digits, this.defaultCountry, this.defaultCallingCode, this.metadata.metadata);
-        if (numberWithoutIDD !== void 0 && numberWithoutIDD !== digits) {
+        var numberWithoutIDD = stripIddPrefix(digits2, this.defaultCountry, this.defaultCallingCode, this.metadata.metadata);
+        if (numberWithoutIDD !== void 0 && numberWithoutIDD !== digits2) {
           state.update({
-            IDDPrefix: digits.slice(0, digits.length - numberWithoutIDD.length)
+            IDDPrefix: digits2.slice(0, digits2.length - numberWithoutIDD.length)
           });
           this.startInternationalNumber(state, {
             country: void 0,
@@ -3429,17 +3429,17 @@ var Formatter = (() => {
     }, {
       key: "input",
       value: function input(text) {
-        var _this$parser$input = this.parser.input(text, this.state), digits = _this$parser$input.digits, justLeadingPlus = _this$parser$input.justLeadingPlus;
+        var _this$parser$input = this.parser.input(text, this.state), digits2 = _this$parser$input.digits, justLeadingPlus = _this$parser$input.justLeadingPlus;
         if (justLeadingPlus) {
           this.formattedOutput = "+";
-        } else if (digits) {
+        } else if (digits2) {
           this.determineTheCountryIfNeeded();
           if (this.state.nationalSignificantNumber) {
             this.formatter.narrowDownMatchingFormats(this.state);
           }
           var formattedNationalNumber;
           if (this.metadata.hasSelectedNumberingPlan()) {
-            formattedNationalNumber = this.formatter.format(digits, this.state);
+            formattedNationalNumber = this.formatter.format(digits2, this.state);
           }
           if (formattedNationalNumber === void 0) {
             if (this.parser.reExtractNationalSignificantNumber(this.state)) {
@@ -3527,8 +3527,8 @@ var Formatter = (() => {
     }, {
       key: "getCountry",
       value: function getCountry() {
-        var digits = this.state.digits;
-        if (digits) {
+        var digits2 = this.state.digits;
+        if (digits2) {
           return this._getCountry();
         }
       }
@@ -3647,15 +3647,15 @@ var Formatter = (() => {
     }, {
       key: "getNumberValue",
       value: function getNumberValue() {
-        var _this$state2 = this.state, digits = _this$state2.digits, callingCode = _this$state2.callingCode, country = _this$state2.country, nationalSignificantNumber = _this$state2.nationalSignificantNumber;
-        if (!digits) {
+        var _this$state2 = this.state, digits2 = _this$state2.digits, callingCode = _this$state2.callingCode, country = _this$state2.country, nationalSignificantNumber = _this$state2.nationalSignificantNumber;
+        if (!digits2) {
           return;
         }
         if (this.isInternational()) {
           if (callingCode) {
             return "+" + callingCode + nationalSignificantNumber;
           } else {
-            return "+" + digits;
+            return "+" + digits2;
           }
         } else {
           if (country || callingCode) {
@@ -3733,8 +3733,8 @@ var Formatter = (() => {
     }, {
       key: "validateLength",
       value: function validateLength() {
-        var _this$state4 = this.state, digits = _this$state4.digits, nationalSignificantNumber = _this$state4.nationalSignificantNumber;
-        if (!digits) {
+        var _this$state4 = this.state, digits2 = _this$state4.digits, nationalSignificantNumber = _this$state4.nationalSignificantNumber;
+        if (!digits2) {
           return "NOT_A_NUMBER";
         }
         if (!this.metadata.numberingPlan) {
@@ -3795,9 +3795,9 @@ var Formatter = (() => {
   // src/core/phone.ts
   var formatPhone = (value, country = "MX", delimiter = " ") => {
     if (!value) return "";
-    const digits = value.replace(/[^\d+]/g, "");
+    const digits2 = value.replace(/[^\d+]/g, "");
     const formatter = new AsYouType2(country);
-    const formatted = formatter.input(digits);
+    const formatted = formatter.input(digits2);
     if (delimiter !== " ") {
       return formatted.replace(/ /g, delimiter);
     }
@@ -3834,12 +3834,12 @@ var Formatter = (() => {
     }
   };
   var getDateSegments = (value, pattern) => {
-    const digits = value.replace(/[^\d]/g, "");
+    const digits2 = value.replace(/[^\d]/g, "");
     const segments = {};
     let start = 0;
     for (const unit of pattern) {
       const end = start + getDateUnitLength(unit);
-      const segment = digits.slice(start, end);
+      const segment = digits2.slice(start, end);
       if (segment) {
         segments[getDateSegmentKey(unit)] = segment;
       }
@@ -3861,12 +3861,12 @@ var Formatter = (() => {
     }
   };
   var getTimeSegments = (value, pattern) => {
-    const digits = value.replace(/[^\d]/g, "");
+    const digits2 = value.replace(/[^\d]/g, "");
     const segments = {};
     let start = 0;
     for (const unit of pattern) {
       const end = start + 2;
-      const segment = digits.slice(start, end);
+      const segment = digits2.slice(start, end);
       if (segment) {
         segments[getTimeSegmentKey(unit)] = segment;
       }
@@ -4032,21 +4032,81 @@ var Formatter = (() => {
   };
 
   // src/core/regex.ts
-  var regex = {
+  function createDigits(min, max, errorMsg) {
+    return {
+      pattern: new RegExp(`^\\d{${min},${max}}$`),
+      errorMessage: errorMsg
+    };
+  }
+  function createPhone(length) {
+    return {
+      pattern: new RegExp(`^(?:\\D*\\d){${length}}\\D*$`),
+      errorMessage: `Please enter a valid ${length}-digit phone number.`
+    };
+  }
+  function createCreditCard(min, max) {
+    return {
+      pattern: new RegExp(`^(?:\\D*\\d){${min},${max}}\\D*$`),
+      errorMessage: `Please enter a valid card number (${min}-${max} digits).`
+    };
+  }
+  function createUrl(requireProtocol) {
+    const protocol = requireProtocol === "all" ? "https?" : requireProtocol;
+    return {
+      pattern: new RegExp(`^${protocol}://[^\\s]+$`),
+      errorMessage: `Please enter a valid URL${requireProtocol !== "all" ? ` (${requireProtocol}://...)` : ""}.`
+    };
+  }
+  function createPassword(params) {
+    const {
+      min = 8,
+      max = 128,
+      uppercase = true,
+      lowercase = true,
+      numbers = true,
+      special = false
+    } = params;
+    let chars = "";
+    if (uppercase) chars += "A-Z";
+    if (lowercase) chars += "a-z";
+    if (numbers) chars += "0-9";
+    if (special) chars += `!@#$%^&*()_+\\-=\\[\\]{}|;:'",.<>?/`;
+    const ruleParts = [];
+    if (uppercase) ruleParts.push("uppercase letter");
+    if (lowercase) ruleParts.push("lowercase letter");
+    if (numbers) ruleParts.push("number");
+    if (special) ruleParts.push("special character");
+    const rulesText = ruleParts.length > 2 ? ruleParts.slice(0, -1).join(", ") + " and " + ruleParts.slice(-1) : ruleParts.join(" and ");
+    return {
+      pattern: new RegExp(`^[${chars}]{${min},${max}}$`),
+      errorMessage: `Password must be ${min}-${max} characters with at least one ${rulesText}.`
+    };
+  }
+  var _regex = {
     phone: {
-      // 10 digit phone numbers, allowing for optional country code and delimiters
       pattern: /^(?:\D*\d){10}\D*$/,
       errorMessage: "Please enter a valid 10-digit phone number."
     },
     email: {
+      // Simple but effective email validation
       pattern: /^[^\s@]+@[^\s@]+\.[a-zA-Z]{2,}$/,
       errorMessage: "Please enter a valid email address."
     },
     rfc: {
-      // Mexican RFC format (simplified)
+      // Mexican RFC ( Personas Morales y Físicas )
       pattern: /^([A-ZÑ&]{3,4})\d{6}([A-Z0-9]{0,3})$/i,
       errorMessage: "Please enter a valid RFC."
     },
+    curp: {
+      // Mexican CURP (18 characters)
+      pattern: /^[A-Z]{4}\d{6}[A-Z]{6}[0-9A-Z]\d$/i,
+      errorMessage: "Please enter a valid CURP."
+    },
+    cp: {
+      // Mexican postal code (5 digits)
+      pattern: /^\d{5}$/,
+      errorMessage: "Please enter a valid 5-digit postal code."
+    },
     numeral: {
       // Numbers with optional thousand separators and decimal points
       pattern: /\d{1,3}(,\d{3})*(\.\d+)?/,
@@ -4059,17 +4119,17 @@ var Formatter = (() => {
     creditCard: {
       // 15 or 16 digits, allowing spaces or delimiters
       pattern: /^(?:\D*\d){15,16}\D*$/,
-      errorMessage: "Please enter a valid card number."
+      errorMessage: "Please enter a valid card number (15-16 digits)."
     },
     expirationDate: {
-      // MM/YY format
-      pattern: /^(0[1-9]|1[0-2])\/\d{2}$/,
-      errorMessage: "Please enter a valid expiration date."
+      // MM/YY or MM/YYYY format
+      pattern: /^(0[1-9]|1[0-2])\/(\d{2}|\d{4})$/,
+      errorMessage: "Please enter a valid expiration date (MM/YY or MM/YYYY)."
     },
     cardCvc: {
       // 3 or 4 digit card security codes
       pattern: /^\d{3,4}$/,
-      errorMessage: "Please enter a valid CVC."
+      errorMessage: "Please enter a valid CVC (3-4 digits)."
     },
     onlyLetters: {
       // Letters only (including accented characters and spaces)
@@ -4080,15 +4140,150 @@ var Formatter = (() => {
       // Letters and numbers (including accented characters and spaces)
       pattern: /^[A-Za-zÁÉÍÓÚáéíóúÑñ0-9\s]+$/,
       errorMessage: "Please enter only letters and numbers."
+    },
+    url: {
+      // Accepts http, https, ftp
+      pattern: /^(?:https?|ftp):\/\/[^\s]+$/,
+      errorMessage: "Please enter a valid URL."
+    },
+    ipv4: {
+      // IPv4 addresses (0-255 per octet)
+      pattern: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+      errorMessage: "Please enter a valid IPv4 address."
+    },
+    ipv6: {
+      // IPv6 addresses (simplified)
+      pattern: /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/,
+      errorMessage: "Please enter a valid IPv6 address."
+    },
+    uuid: {
+      // UUID v4
+      pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+      errorMessage: "Please enter a valid UUID."
+    },
+    hexColor: {
+      // Hex color codes (#RGB or #RRGGBB)
+      pattern: /^#(?:[0-9a-fA-F]{3}){1,2}$/,
+      errorMessage: "Please enter a valid hex color code (e.g., #FFF or #FFFFFF)."
+    },
+    hashtag: {
+      // Social media hashtags
+      pattern: /^#[a-zA-Z_][a-zA-Z0-9_]*$/,
+      errorMessage: "Please enter a valid hashtag (e.g., #example)."
+    },
+    mention: {
+      // Social media mentions
+      pattern: /^@[a-zA-Z_][a-zA-Z0-9_]*$/,
+      errorMessage: "Please enter a valid mention (e.g., @username)."
+    },
+    postalCode: {
+      // Generic 5-digit postal code (US-style ZIP / MX CP)
+      pattern: /^\d{5}(?:-\d{4})?$/,
+      errorMessage: "Please enter a valid postal code (e.g., 90210 or 90210-1234)."
+    },
+    time24: {
+      // 24-hour time HH:MM
+      pattern: /^([01]\d|2[0-3]):([0-5]\d)$/,
+      errorMessage: "Please enter a valid 24-hour time (HH:MM)."
+    },
+    date: {
+      // ISO-like date YYYY-MM-DD (loose)
+      pattern: /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/,
+      errorMessage: "Please enter a valid date (YYYY-MM-DD)."
+    },
+    slug: {
+      // URL slug (lowercase, hyphens, no spaces)
+      pattern: /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+      errorMessage: "Please enter a valid slug (lowercase, hyphens, no spaces)."
+    },
+    username: {
+      // Username: 3-20 chars, alphanumeric, underscore, hyphen
+      pattern: /^[a-zA-Z0-9_-]{3,20}$/,
+      errorMessage: "Please enter a valid username (3-20 chars, letters, numbers, _ or -)."
+    },
+    macAddress: {
+      // MAC address (colon or hyphen separated)
+      pattern: /^([0-9A-Fa-f]{2}[:-]){5}[0-9A-Fa-f]{2}$/,
+      errorMessage: "Please enter a valid MAC address (e.g., 00:1B:44:11:3A:B7)."
+    },
+    semver: {
+      // Semantic version (X.Y.Z with optional -prerelease)
+      pattern: /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[a-zA-Z0-9.-]+)?$/,
+      errorMessage: "Please enter a valid semantic version (e.g., 1.2.3)."
+    },
+    base64: {
+      // Base64 encoded string
+      pattern: /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,
+      errorMessage: "Please enter a valid Base64 encoded string."
     }
   };
+  function digits(params) {
+    if (typeof params === "number") {
+      return createDigits(params, params, `Please enter exactly ${params} digits.`);
+    }
+    const { length, min = 1, max = 20 } = params ?? {};
+    const actualMin = length ?? min;
+    const actualMax = length ?? max;
+    if (actualMin === actualMax) {
+      return createDigits(actualMin, actualMax, `Please enter exactly ${actualMin} digits.`);
+    }
+    return createDigits(actualMin, actualMax, `Please enter ${actualMin}-${actualMax} digits.`);
+  }
+  function _phoneFn(params) {
+    const length = params?.length ?? 10;
+    return createPhone(length);
+  }
+  function _creditCardFn(params) {
+    const min = params?.min ?? 15;
+    const max = params?.max ?? 16;
+    return createCreditCard(min, max);
+  }
+  function _urlFn(params) {
+    const protocol = params?.protocol ?? "all";
+    return createUrl(protocol);
+  }
+  function _passwordFn(params) {
+    return createPassword(params ?? {});
+  }
+  function _customFn(arg1, arg2) {
+    if (arg1 instanceof RegExp) {
+      return { pattern: arg1, errorMessage: arg2 ?? "Invalid value." };
+    }
+    return { pattern: arg1.pattern, errorMessage: arg1.errorMessage };
+  }
+  var phoneFn = _phoneFn;
+  phoneFn.pattern = _regex.phone.pattern;
+  phoneFn.errorMessage = _regex.phone.errorMessage;
+  var creditCardFn = _creditCardFn;
+  creditCardFn.pattern = _regex.creditCard.pattern;
+  creditCardFn.errorMessage = _regex.creditCard.errorMessage;
+  var urlFn = _urlFn;
+  urlFn.pattern = _regex.url.pattern;
+  urlFn.errorMessage = _regex.url.errorMessage;
+  var digitsFn = digits;
+  digitsFn.errorMessage = "Please enter a valid number.";
+  var passwordFn = _passwordFn;
+  passwordFn.errorMessage = "Please enter a valid password.";
+  var customFn = _customFn;
+  customFn.errorMessage = "Please enter a valid value.";
+  var regex = {
+    // Static entries (backward compatible - spread first)
+    ..._regex,
+    // Parametric functions
+    digits: digitsFn,
+    phone: phoneFn,
+    creditCard: creditCardFn,
+    url: urlFn,
+    password: passwordFn,
+    custom: customFn
+  };
 
   // src/browser/global.ts
   var Formatter = {
     format,
     regex,
     // Keep in sync with `version` in `package.json`.
-    version: "1.0.1"
+    version: "1.1.0"
   };
   if (typeof window !== "undefined") {
     window.Formatter = Formatter;