@carbon/react 1.99.0-rc.0 → 1.99.0

package/es/components/NumberInput/NumberInput.d.ts

@@ -207,6 +207,15 @@ export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInp
      */
     warnText?: ReactNode;
 }
+/**
+ * Converts a string with any Unicode numeral system to a JavaScript number.
+ * Handles all numeral systems supported by Intl.NumberFormat.
+ *
+ * @param {string} input - The input string with numerals in any Unicode system
+ * @param {string} locale - The locale for parsing separators
+ * @returns {number} The parsed number, or NaN if invalid
+ */
+export declare const parseNumberWithLocale: (input: string, locale: string) => number;
 export declare const validateNumberSeparators: (input: string, locale: string) => boolean;
 declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLInputElement>>;
 export { NumberInput };

package/es/components/NumberInput/NumberInput.js

@@ -43,8 +43,41 @@ const getSeparators = locale => {
   const numberWithGroupAndDecimal = 1234567.89;
   const formatted = new Intl.NumberFormat(locale).format(numberWithGroupAndDecimal);
 
-  // Extract separators using regex
-  const match = formatted.match(/(\D+)\d{3}(\D+)\d{2}$/);
+  // Comprehensive Unicode digit pattern that includes all common numeral systems
+  // supported by Intl.NumberFormat across different locales
+  const digitPattern = '[' + '\\u0030-\\u0039' +
+  // Western
+  '\\u0660-\\u0669' +
+  // Eastern Arabic
+  '\\u0966-\\u096F' +
+  // Devanagari
+  '\\u09E6-\\u09EF' +
+  // Bengali
+  '\\uFF10-\\uFF19' +
+  // Fullwidth Japanese ０-９
+  '一二三四五六七八九〇零' +
+  // Kanji digits
+  ']';
+
+  // Non-digit pattern that excludes ALL digit types (not just ASCII 0-9)
+  const nonDigitPattern = '[^' + '\\u0030-\\u0039' +
+  // Western
+  '\\u0660-\\u0669' +
+  // Eastern Arabic
+  '\\u0966-\\u096F' +
+  // Devanagari
+  '\\u09E6-\\u09EF' +
+  // Bengali
+  '\\uFF10-\\uFF19' +
+  // Fullwidth Japanese ０-９
+  '一二三四五六七八九〇零' +
+  // Kanji digits
+  ']+';
+
+  // Extract separators using regex that handles all numeral systems
+  // Use nonDigitPattern instead of \D+ to correctly identify separators
+  const regex = new RegExp(`(${nonDigitPattern})${digitPattern}{3}(${nonDigitPattern})${digitPattern}{2}$`);
+  const match = formatted.match(regex);
   if (match) {
     const groupSeparator = match[1];
     const decimalSeparator = match[2];
@@ -59,11 +92,116 @@ const getSeparators = locale => {
     };
   }
 };
+
+// Normalizes all Unicode minus variants to ASCII hyphen-minus (-)
+const normalizeMinus = value => value.replace(/[\u2212\u2012\u2013\u2014\uFE63\uFF0D]/g, '-');
+const normalizeNumericInput = value => value
+// Remove bidi / direction control characters (Arabic keyboards)
+.replace(/[\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]/g, '')
+// Normalize Unicode minus variants to ASCII "-"
+.replace(/[\u2212\u2012\u2013\u2014\uFE63\uFF0D]/g, '-');
+/**
+ * Converts a string with any Unicode numeral system to a JavaScript number.
+ * Handles all numeral systems supported by Intl.NumberFormat.
+ *
+ * @param {string} input - The input string with numerals in any Unicode system
+ * @param {string} locale - The locale for parsing separators
+ * @returns {number} The parsed number, or NaN if invalid
+ */
+const parseNumberWithLocale = (input, locale) => {
+  // Handle empty, null, or undefined inputs
+  if (input === '' || input === undefined || input === null) {
+    return NaN;
+  }
+  input = normalizeNumericInput(input);
+  const {
+    groupSeparator,
+    decimalSeparator
+  } = getSeparators(locale);
+
+  // Kanji digit map
+  const kanjiMap = {
+    零: '0',
+    〇: '0',
+    一: '1',
+    二: '2',
+    三: '3',
+    四: '4',
+    五: '5',
+    六: '6',
+    七: '7',
+    八: '8',
+    九: '9'
+  };
+  const digitRanges = [{
+    start: 0x0030,
+    end: 0x0039,
+    base: 0x0030
+  }, {
+    start: 0x0660,
+    end: 0x0669,
+    base: 0x0660
+  }, {
+    start: 0x0966,
+    end: 0x096f,
+    base: 0x0966
+  }, {
+    start: 0x09e6,
+    end: 0x09ef,
+    base: 0x09e6
+  }, {
+    start: 0xff10,
+    end: 0xff19,
+    base: 0xff10
+  }];
+  let normalized = Array.from(input).map(char => {
+    // Preserve scientific notation characters
+    if (char === 'e' || char === 'E' || char === '+' || char === '-') {
+      return char;
+    }
+
+    // Check Kanji first
+    if (kanjiMap[char] !== undefined) {
+      return kanjiMap[char];
+    }
+    const code = char.charCodeAt(0);
+    for (const range of digitRanges) {
+      if (code >= range.start && code <= range.end) {
+        return String(code - range.start);
+      }
+    }
+    return char;
+  }).join('');
+
+  // Remove grouping separators
+  if (groupSeparator) {
+    if (groupSeparator?.trim() === '') {
+      normalized = normalized?.replace(/[\u00A0\u202F\s]/g, '');
+    } else {
+      if (decimalSeparator !== ',' && decimalSeparator !== '٬') {
+        normalized = normalized?.replace(/[,٬]/g, '');
+      }
+      if (groupSeparator !== ',' && groupSeparator !== '٬') {
+        const escaped = groupSeparator?.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        normalized = normalized?.replace(new RegExp(escaped, 'g'), '');
+      }
+    }
+  }
+  normalized = normalized.replace(/٫/g, '.');
+  if (decimalSeparator && decimalSeparator !== '.' && decimalSeparator !== '٫') {
+    const escaped = decimalSeparator.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    normalized = normalized.replace(new RegExp(escaped, 'g'), '.');
+  }
+  normalized = normalizeMinus(normalized);
+  return Number(normalized);
+};
 const validateNumberSeparators = (input, locale) => {
-  // allow empty string
-  if (input === '' || Number.isNaN(input)) {
+  if (input === '') {
     return true;
   }
+
+  // Normalize bidi marks + minus signs FIRST
+  input = normalizeNumericInput(input);
   const {
     groupSeparator,
     decimalSeparator
@@ -72,35 +210,54 @@ const validateNumberSeparators = (input, locale) => {
     return !isNaN(Number(input));
   }
   const esc = s => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const digit = '[' + '\\u0030-\\u0039' + '\\u0660-\\u0669' + '\\u0966-\\u096F' + '\\u09E6-\\u09EF' + '\\uFF10-\\uFF19' + '一二三四五六七八九〇零' + ']';
+
+  // Group separator regex
   let group = '';
   if (groupSeparator) {
-    if (groupSeparator.trim() === '') {
-      group = '[\\u00A0\\u202F\\s]'; // handle NBSP, narrow NBSP, space
+    if (groupSeparator?.trim() === '') {
+      group = '[\\u00A0\\u202F\\s]';
+    } else if (groupSeparator === ',' || groupSeparator === '٬') {
+      group = '[,٬]';
     } else {
       group = esc(groupSeparator);
     }
   }
-  const decimal = esc(decimalSeparator);
 
-  // Regex for:
-  // - integers (with/without grouping)
-  // - optional decimal with 0+ digits after separator
-  const regex = new RegExp(`^-?\\d{1,3}(${group}\\d{3})*(${decimal}\\d*)?$|^-?\\d+(${decimal}\\d*)?$`);
-  if (!regex.test(input)) {
-    return false;
+  // Decimal separator regex
+  let decimal = esc(decimalSeparator);
+  if (decimalSeparator === '.' || decimalSeparator === '٫') {
+    decimal = '[.٫]';
   }
+  const sign = '[\\-\\u2212]?';
+  const scientific = `([eE][+-]?${digit}+)?`;
 
-  // Normalize
-  let normalized = input;
-  if (groupSeparator) {
-    if (groupSeparator.trim() === '') {
-      normalized = normalized?.replace(/[\u00A0\u202F\s]/g, '');
-    } else {
-      normalized = normalized?.split(groupSeparator).join('');
-    }
+  // Detect if grouping is used AT ALL
+  const usesGrouping = group && (groupSeparator?.trim() === '' ? /[\u00A0\u202F\s]/.test(input) : groupSeparator === ',' || groupSeparator === '٬' ? /[,٬]/.test(input) : groupSeparator ? input.includes(groupSeparator) : false);
+  const scientificMatch = input?.match(/^([^eE]+)([eE][+-]?.*)?$/);
+  const baseNumber = scientificMatch ? scientificMatch[1] : input;
+
+  // Split integer part from the base number - handle both decimal separator variants
+  let integerPart;
+  if (decimalSeparator === '.' || decimalSeparator === '٫') {
+    // Split by either . or ٫
+    integerPart = baseNumber?.split(/[.,]/)[0];
+  } else {
+    integerPart = baseNumber?.split(decimalSeparator)[0];
   }
-  normalized = normalized?.replace(decimalSeparator, '.');
-  return !isNaN(Number(normalized));
+
+  // STEP 1: strict integer validation
+  // When grouping is used, we need to handle two cases:
+  // 1. Numbers with 1-3 digits (no separator required): 1, 12, 123
+  // 2. Numbers with 4+ digits (separator required): 1,234 or 12,345 or 123,456
+  const integerRegex = usesGrouping ? new RegExp(`^${sign}(${digit}{1,3}|${digit}{1,3}(${group}${digit}{3})+)$`) : new RegExp(`^${sign}${digit}+$`);
+  if (!integerRegex.test(integerPart)) {
+    return false;
+  }
+
+  // STEP 2: full number validation
+  const fullRegex = new RegExp(`^${sign}${digit}+` + (usesGrouping ? `(${group}${digit}{3})*` : '') + `(${decimal}${digit}+)?${scientific}$`);
+  return fullRegex.test(input);
 };
 
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
@@ -292,8 +449,9 @@ const NumberInput = /*#__PURE__*/React.forwardRef((props, forwardRef) => {
     }
   };
   const outerElementClasses = cx(`${prefix}--form-item`, {
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    [customClassName]: !!customClassName,
+    ...(customClassName ? {
+      [customClassName]: true
+    } : {}),
     [`${prefix}--number-input--fluid--invalid`]: isFluid && normalizedProps.invalid,
     [`${prefix}--number-input--fluid--focus`]: isFluid && isFocused,
     [`${prefix}--number-input--fluid--disabled`]: isFluid && disabled
@@ -764,23 +922,33 @@ function getInputValidity({
   validate,
   locale
 }) {
-  if (typeof validate === 'function') {
-    const result = validate(value, locale);
-    if (result === false) {
-      return false; // immediate invalid
-    }
-    // If true or undefined, continue to further validations
-  }
   if (invalid) {
     return false;
   }
-  if (value === '') {
-    return allowEmpty;
+
+  // Skip validation if value is empty and allowEmpty
+  if (value === '') return allowEmpty;
+
+  // Normalize the value
+  let numericValue;
+  if (typeof value === 'string') {
+    numericValue = parseNumberWithLocale(value, locale); // safe: handles Arabic, Kanji, etc.
+  } else {
+    numericValue = value;
   }
-  if (value > max || value < min) {
-    return false;
+
+  // Use custom validate ONLY for formatting, not numeric comparison
+  if (validate && typeof value === 'string') {
+    const isFormatValid = validate(value, locale);
+    if (isFormatValid === false) {
+      return false; // invalid format
+    }
   }
-  return true;
+
+  // Check min/max bounds
+  if (max !== undefined && numericValue > max) return false;
+  if (min !== undefined && numericValue < min) return false;
+  return true; // valid
 }
 
 /**
@@ -801,4 +969,4 @@ function disableWheel(e) {
   e.preventDefault();
 }
 
-export { NumberInput, validateNumberSeparators };
+export { NumberInput, parseNumberWithLocale, validateNumberSeparators };

package/lib/components/NumberInput/NumberInput.d.ts

@@ -207,6 +207,15 @@ export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInp
      */
     warnText?: ReactNode;
 }
+/**
+ * Converts a string with any Unicode numeral system to a JavaScript number.
+ * Handles all numeral systems supported by Intl.NumberFormat.
+ *
+ * @param {string} input - The input string with numerals in any Unicode system
+ * @param {string} locale - The locale for parsing separators
+ * @returns {number} The parsed number, or NaN if invalid
+ */
+export declare const parseNumberWithLocale: (input: string, locale: string) => number;
 export declare const validateNumberSeparators: (input: string, locale: string) => boolean;
 declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLInputElement>>;
 export { NumberInput };

package/lib/components/NumberInput/NumberInput.js

@@ -45,8 +45,41 @@ const getSeparators = locale => {
   const numberWithGroupAndDecimal = 1234567.89;
   const formatted = new Intl.NumberFormat(locale).format(numberWithGroupAndDecimal);
 
-  // Extract separators using regex
-  const match = formatted.match(/(\D+)\d{3}(\D+)\d{2}$/);
+  // Comprehensive Unicode digit pattern that includes all common numeral systems
+  // supported by Intl.NumberFormat across different locales
+  const digitPattern = '[' + '\\u0030-\\u0039' +
+  // Western
+  '\\u0660-\\u0669' +
+  // Eastern Arabic
+  '\\u0966-\\u096F' +
+  // Devanagari
+  '\\u09E6-\\u09EF' +
+  // Bengali
+  '\\uFF10-\\uFF19' +
+  // Fullwidth Japanese ０-９
+  '一二三四五六七八九〇零' +
+  // Kanji digits
+  ']';
+
+  // Non-digit pattern that excludes ALL digit types (not just ASCII 0-9)
+  const nonDigitPattern = '[^' + '\\u0030-\\u0039' +
+  // Western
+  '\\u0660-\\u0669' +
+  // Eastern Arabic
+  '\\u0966-\\u096F' +
+  // Devanagari
+  '\\u09E6-\\u09EF' +
+  // Bengali
+  '\\uFF10-\\uFF19' +
+  // Fullwidth Japanese ０-９
+  '一二三四五六七八九〇零' +
+  // Kanji digits
+  ']+';
+
+  // Extract separators using regex that handles all numeral systems
+  // Use nonDigitPattern instead of \D+ to correctly identify separators
+  const regex = new RegExp(`(${nonDigitPattern})${digitPattern}{3}(${nonDigitPattern})${digitPattern}{2}$`);
+  const match = formatted.match(regex);
   if (match) {
     const groupSeparator = match[1];
     const decimalSeparator = match[2];
@@ -61,11 +94,116 @@ const getSeparators = locale => {
     };
   }
 };
+
+// Normalizes all Unicode minus variants to ASCII hyphen-minus (-)
+const normalizeMinus = value => value.replace(/[\u2212\u2012\u2013\u2014\uFE63\uFF0D]/g, '-');
+const normalizeNumericInput = value => value
+// Remove bidi / direction control characters (Arabic keyboards)
+.replace(/[\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]/g, '')
+// Normalize Unicode minus variants to ASCII "-"
+.replace(/[\u2212\u2012\u2013\u2014\uFE63\uFF0D]/g, '-');
+/**
+ * Converts a string with any Unicode numeral system to a JavaScript number.
+ * Handles all numeral systems supported by Intl.NumberFormat.
+ *
+ * @param {string} input - The input string with numerals in any Unicode system
+ * @param {string} locale - The locale for parsing separators
+ * @returns {number} The parsed number, or NaN if invalid
+ */
+const parseNumberWithLocale = (input, locale) => {
+  // Handle empty, null, or undefined inputs
+  if (input === '' || input === undefined || input === null) {
+    return NaN;
+  }
+  input = normalizeNumericInput(input);
+  const {
+    groupSeparator,
+    decimalSeparator
+  } = getSeparators(locale);
+
+  // Kanji digit map
+  const kanjiMap = {
+    零: '0',
+    〇: '0',
+    一: '1',
+    二: '2',
+    三: '3',
+    四: '4',
+    五: '5',
+    六: '6',
+    七: '7',
+    八: '8',
+    九: '9'
+  };
+  const digitRanges = [{
+    start: 0x0030,
+    end: 0x0039,
+    base: 0x0030
+  }, {
+    start: 0x0660,
+    end: 0x0669,
+    base: 0x0660
+  }, {
+    start: 0x0966,
+    end: 0x096f,
+    base: 0x0966
+  }, {
+    start: 0x09e6,
+    end: 0x09ef,
+    base: 0x09e6
+  }, {
+    start: 0xff10,
+    end: 0xff19,
+    base: 0xff10
+  }];
+  let normalized = Array.from(input).map(char => {
+    // Preserve scientific notation characters
+    if (char === 'e' || char === 'E' || char === '+' || char === '-') {
+      return char;
+    }
+
+    // Check Kanji first
+    if (kanjiMap[char] !== undefined) {
+      return kanjiMap[char];
+    }
+    const code = char.charCodeAt(0);
+    for (const range of digitRanges) {
+      if (code >= range.start && code <= range.end) {
+        return String(code - range.start);
+      }
+    }
+    return char;
+  }).join('');
+
+  // Remove grouping separators
+  if (groupSeparator) {
+    if (groupSeparator?.trim() === '') {
+      normalized = normalized?.replace(/[\u00A0\u202F\s]/g, '');
+    } else {
+      if (decimalSeparator !== ',' && decimalSeparator !== '٬') {
+        normalized = normalized?.replace(/[,٬]/g, '');
+      }
+      if (groupSeparator !== ',' && groupSeparator !== '٬') {
+        const escaped = groupSeparator?.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        normalized = normalized?.replace(new RegExp(escaped, 'g'), '');
+      }
+    }
+  }
+  normalized = normalized.replace(/٫/g, '.');
+  if (decimalSeparator && decimalSeparator !== '.' && decimalSeparator !== '٫') {
+    const escaped = decimalSeparator.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    normalized = normalized.replace(new RegExp(escaped, 'g'), '.');
+  }
+  normalized = normalizeMinus(normalized);
+  return Number(normalized);
+};
 const validateNumberSeparators = (input, locale) => {
-  // allow empty string
-  if (input === '' || Number.isNaN(input)) {
+  if (input === '') {
     return true;
   }
+
+  // Normalize bidi marks + minus signs FIRST
+  input = normalizeNumericInput(input);
   const {
     groupSeparator,
     decimalSeparator
@@ -74,35 +212,54 @@ const validateNumberSeparators = (input, locale) => {
     return !isNaN(Number(input));
   }
   const esc = s => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const digit = '[' + '\\u0030-\\u0039' + '\\u0660-\\u0669' + '\\u0966-\\u096F' + '\\u09E6-\\u09EF' + '\\uFF10-\\uFF19' + '一二三四五六七八九〇零' + ']';
+
+  // Group separator regex
   let group = '';
   if (groupSeparator) {
-    if (groupSeparator.trim() === '') {
-      group = '[\\u00A0\\u202F\\s]'; // handle NBSP, narrow NBSP, space
+    if (groupSeparator?.trim() === '') {
+      group = '[\\u00A0\\u202F\\s]';
+    } else if (groupSeparator === ',' || groupSeparator === '٬') {
+      group = '[,٬]';
     } else {
       group = esc(groupSeparator);
     }
   }
-  const decimal = esc(decimalSeparator);
 
-  // Regex for:
-  // - integers (with/without grouping)
-  // - optional decimal with 0+ digits after separator
-  const regex = new RegExp(`^-?\\d{1,3}(${group}\\d{3})*(${decimal}\\d*)?$|^-?\\d+(${decimal}\\d*)?$`);
-  if (!regex.test(input)) {
-    return false;
+  // Decimal separator regex
+  let decimal = esc(decimalSeparator);
+  if (decimalSeparator === '.' || decimalSeparator === '٫') {
+    decimal = '[.٫]';
   }
+  const sign = '[\\-\\u2212]?';
+  const scientific = `([eE][+-]?${digit}+)?`;
 
-  // Normalize
-  let normalized = input;
-  if (groupSeparator) {
-    if (groupSeparator.trim() === '') {
-      normalized = normalized?.replace(/[\u00A0\u202F\s]/g, '');
-    } else {
-      normalized = normalized?.split(groupSeparator).join('');
-    }
+  // Detect if grouping is used AT ALL
+  const usesGrouping = group && (groupSeparator?.trim() === '' ? /[\u00A0\u202F\s]/.test(input) : groupSeparator === ',' || groupSeparator === '٬' ? /[,٬]/.test(input) : groupSeparator ? input.includes(groupSeparator) : false);
+  const scientificMatch = input?.match(/^([^eE]+)([eE][+-]?.*)?$/);
+  const baseNumber = scientificMatch ? scientificMatch[1] : input;
+
+  // Split integer part from the base number - handle both decimal separator variants
+  let integerPart;
+  if (decimalSeparator === '.' || decimalSeparator === '٫') {
+    // Split by either . or ٫
+    integerPart = baseNumber?.split(/[.,]/)[0];
+  } else {
+    integerPart = baseNumber?.split(decimalSeparator)[0];
   }
-  normalized = normalized?.replace(decimalSeparator, '.');
-  return !isNaN(Number(normalized));
+
+  // STEP 1: strict integer validation
+  // When grouping is used, we need to handle two cases:
+  // 1. Numbers with 1-3 digits (no separator required): 1, 12, 123
+  // 2. Numbers with 4+ digits (separator required): 1,234 or 12,345 or 123,456
+  const integerRegex = usesGrouping ? new RegExp(`^${sign}(${digit}{1,3}|${digit}{1,3}(${group}${digit}{3})+)$`) : new RegExp(`^${sign}${digit}+$`);
+  if (!integerRegex.test(integerPart)) {
+    return false;
+  }
+
+  // STEP 2: full number validation
+  const fullRegex = new RegExp(`^${sign}${digit}+` + (usesGrouping ? `(${group}${digit}{3})*` : '') + `(${decimal}${digit}+)?${scientific}$`);
+  return fullRegex.test(input);
 };
 
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
@@ -294,8 +451,9 @@ const NumberInput = /*#__PURE__*/React.forwardRef((props, forwardRef) => {
     }
   };
   const outerElementClasses = cx(`${prefix}--form-item`, {
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    [customClassName]: !!customClassName,
+    ...(customClassName ? {
+      [customClassName]: true
+    } : {}),
     [`${prefix}--number-input--fluid--invalid`]: isFluid && normalizedProps.invalid,
     [`${prefix}--number-input--fluid--focus`]: isFluid && isFocused,
     [`${prefix}--number-input--fluid--disabled`]: isFluid && disabled
@@ -766,23 +924,33 @@ function getInputValidity({
   validate,
   locale
 }) {
-  if (typeof validate === 'function') {
-    const result = validate(value, locale);
-    if (result === false) {
-      return false; // immediate invalid
-    }
-    // If true or undefined, continue to further validations
-  }
   if (invalid) {
     return false;
   }
-  if (value === '') {
-    return allowEmpty;
+
+  // Skip validation if value is empty and allowEmpty
+  if (value === '') return allowEmpty;
+
+  // Normalize the value
+  let numericValue;
+  if (typeof value === 'string') {
+    numericValue = parseNumberWithLocale(value, locale); // safe: handles Arabic, Kanji, etc.
+  } else {
+    numericValue = value;
   }
-  if (value > max || value < min) {
-    return false;
+
+  // Use custom validate ONLY for formatting, not numeric comparison
+  if (validate && typeof value === 'string') {
+    const isFormatValid = validate(value, locale);
+    if (isFormatValid === false) {
+      return false; // invalid format
+    }
   }
-  return true;
+
+  // Check min/max bounds
+  if (max !== undefined && numericValue > max) return false;
+  if (min !== undefined && numericValue < min) return false;
+  return true; // valid
 }
 
 /**
@@ -804,4 +972,5 @@ function disableWheel(e) {
 }
 
 exports.NumberInput = NumberInput;
+exports.parseNumberWithLocale = parseNumberWithLocale;
 exports.validateNumberSeparators = validateNumberSeparators;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.99.0-rc.0",
+  "version": "1.99.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -53,9 +53,9 @@
   "dependencies": {
     "@babel/runtime": "^7.27.3",
     "@carbon/feature-flags": ">=0.32.0",
-    "@carbon/icons-react": "^11.73.0-rc.0",
-    "@carbon/layout": "^11.46.0-rc.0",
-    "@carbon/styles": "^1.98.0-rc.0",
+    "@carbon/icons-react": "^11.73.0",
+    "@carbon/layout": "^11.46.0",
+    "@carbon/styles": "^1.98.0",
     "@carbon/utilities": "^0.14.0",
     "@floating-ui/react": "^0.27.4",
     "@ibm/telemetry-js": "^1.5.0",
@@ -78,8 +78,8 @@
     "@babel/preset-env": "^7.27.2",
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
-    "@carbon/test-utils": "^10.39.0-rc.0",
-    "@carbon/themes": "^11.66.0-rc.0",
+    "@carbon/test-utils": "^10.39.0",
+    "@carbon/themes": "^11.66.0",
     "@figma/code-connect": "^1.3.5",
     "@rollup/plugin-babel": "^6.0.0",
     "@rollup/plugin-commonjs": "^28.0.3",
@@ -131,5 +131,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "8263c72357fc43c00e66c9030698f759ef7977ce"
+  "gitHead": "ce7846aab8a3a1afe9b03d2d07d267af6cdb6ac2"
 }