@automattic/number-formatters 1.1.8 → 1.1.10

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [1.1.10] - 2026-05-21
+### Changed
+- Update package dependencies. [#49012]
+
+## [1.1.9] - 2026-05-19
+### Fixed
+- Currency formatting: use ISO 4217 minor-unit exponent for smallest-unit conversion to correctly format IDR and other currencies where browser ICU disagrees with ISO 4217. [#48967]
+
 ## [1.1.8] - 2026-05-19
 ### Changed
 - Internal updates.
@@ -144,6 +152,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Initial release
 - Basic number formatting functionality
 
+[1.1.10]: https://github.com/Automattic/number-formatters/compare/1.1.9...1.1.10
+[1.1.9]: https://github.com/Automattic/number-formatters/compare/1.1.8...1.1.9
 [1.1.8]: https://github.com/Automattic/number-formatters/compare/1.1.7...1.1.8
 [1.1.7]: https://github.com/Automattic/number-formatters/compare/1.1.6...1.1.7
 [1.1.6]: https://github.com/Automattic/number-formatters/compare/1.1.5...1.1.6

package/dist/cjs/number-format-currency/index.cjs

@@ -84,6 +84,35 @@ function getCurrencyFormatter({ number, currency, browserSafeLocale, forceLatin
         options: numberFormatOptions,
     });
 }
+/**
+ * Smallest-unit exponent overrides for currencies where browser ICU's
+ * `maximumFractionDigits` disagrees with the API's smallest-unit encoding.
+ *
+ * Keep this list minimal — the backend is the source of truth for the API's
+ * smallest-unit encoding, so adding speculative entries here risks silent
+ * drift. Only add a currency once we've verified that browsers report a
+ * value the API does not use.
+ *
+ * - IDR: modern Chrome / Node 24+ ICU reports 0; the API encodes with exponent 2.
+ * - HUF: same browser/API divergence as IDR.
+ */
+const SMALLEST_UNIT_EXPONENT_OVERRIDES = {
+    IDR: 2,
+    HUF: 2,
+};
+/**
+ * Returns the smallest unit exponent for a currency.
+ *
+ * Falls back to the browser-derived display precision for any currency not in
+ * the override map — i.e. existing behavior is preserved for everything except
+ * the explicitly listed currencies.
+ * @param currency - The currency code (ISO 4217)
+ * @param fallback - The browser-derived precision to use when no override applies
+ * @return number  - The smallest unit exponent
+ */
+function getSmallestUnitExponent(currency, fallback) {
+    return SMALLEST_UNIT_EXPONENT_OVERRIDES[currency] ?? fallback;
+}
 /**
  * Returns the precision for a given locale and currency.
  * @param  browserSafeLocale - The browser safe locale.
@@ -119,14 +148,12 @@ function scaleNumberForPrecision(number, currencyPrecision) {
 /**
  * Prepares a number for formatting.
  * @param  number            - The number to prepare.
- * @param  currencyPrecision - The precision to prepare the number for.
+ * @param  currencyPrecision - The display precision (from the browser) to round the result to.
+ * @param  currency          - The currency code, used to look up any smallest-unit exponent override.
  * @param  isSmallestUnit    - Whether the number is the smallest unit of a currency.
  * @return {number} The prepared number.
  */
-function prepareNumberForFormatting(number, 
-// currencyPrecision here must be the precision of the currency, regardless
-// of what precision is requested for display!
-currencyPrecision, isSmallestUnit) {
+function prepareNumberForFormatting(number, currencyPrecision, currency, isSmallestUnit) {
     if (isNaN(number)) {
         debug('formatCurrency was called with NaN');
         return 0;
@@ -135,7 +162,7 @@ currencyPrecision, isSmallestUnit) {
         if (!Number.isInteger(number)) {
             debug('formatCurrency was called with isSmallestUnit and a float which will be rounded', number);
         }
-        const smallestUnitDivisor = 10 ** currencyPrecision;
+        const smallestUnitDivisor = 10 ** getSmallestUnitExponent(currency, currencyPrecision);
         return scaleNumberForPrecision(Math.round(number) / smallestUnitDivisor, currencyPrecision);
     }
     return scaleNumberForPrecision(number, currencyPrecision);
@@ -186,7 +213,7 @@ const numberFormatCurrency = ({ number, browserSafeLocale, currency, stripZeros,
     if (isSmallestUnit && typeof currencyPrecision === 'undefined') {
         throw new Error(`Could not determine currency precision for ${validCurrency} in ${browserSafeLocale}`);
     }
-    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, isSmallestUnit);
+    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, validCurrency, isSmallestUnit);
     const formatter = getCurrencyFormatter({
         number: numberAsFloat,
         currency: validCurrency,
@@ -259,7 +286,7 @@ const getCurrencyObject = ({ number, browserSafeLocale, currency, stripZeros, is
     const validCurrency = getValidCurrency(currency, geoLocation);
     const currencyOverride = getCurrencyOverride(validCurrency, geoLocation);
     const currencyPrecision = getPrecisionForLocaleAndCurrency(browserSafeLocale, validCurrency, forceLatin);
-    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, isSmallestUnit);
+    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, validCurrency, isSmallestUnit);
     const formatter = getCurrencyFormatter({
         number: numberAsFloat,
         currency: validCurrency,

package/dist/esm/number-format-currency/index.js

@@ -80,6 +80,35 @@ function getCurrencyFormatter({ number, currency, browserSafeLocale, forceLatin
         options: numberFormatOptions,
     });
 }
+/**
+ * Smallest-unit exponent overrides for currencies where browser ICU's
+ * `maximumFractionDigits` disagrees with the API's smallest-unit encoding.
+ *
+ * Keep this list minimal — the backend is the source of truth for the API's
+ * smallest-unit encoding, so adding speculative entries here risks silent
+ * drift. Only add a currency once we've verified that browsers report a
+ * value the API does not use.
+ *
+ * - IDR: modern Chrome / Node 24+ ICU reports 0; the API encodes with exponent 2.
+ * - HUF: same browser/API divergence as IDR.
+ */
+const SMALLEST_UNIT_EXPONENT_OVERRIDES = {
+    IDR: 2,
+    HUF: 2,
+};
+/**
+ * Returns the smallest unit exponent for a currency.
+ *
+ * Falls back to the browser-derived display precision for any currency not in
+ * the override map — i.e. existing behavior is preserved for everything except
+ * the explicitly listed currencies.
+ * @param currency - The currency code (ISO 4217)
+ * @param fallback - The browser-derived precision to use when no override applies
+ * @return number  - The smallest unit exponent
+ */
+function getSmallestUnitExponent(currency, fallback) {
+    return SMALLEST_UNIT_EXPONENT_OVERRIDES[currency] ?? fallback;
+}
 /**
  * Returns the precision for a given locale and currency.
  * @param  browserSafeLocale - The browser safe locale.
@@ -115,14 +144,12 @@ function scaleNumberForPrecision(number, currencyPrecision) {
 /**
  * Prepares a number for formatting.
  * @param  number            - The number to prepare.
- * @param  currencyPrecision - The precision to prepare the number for.
+ * @param  currencyPrecision - The display precision (from the browser) to round the result to.
+ * @param  currency          - The currency code, used to look up any smallest-unit exponent override.
  * @param  isSmallestUnit    - Whether the number is the smallest unit of a currency.
  * @return {number} The prepared number.
  */
-function prepareNumberForFormatting(number, 
-// currencyPrecision here must be the precision of the currency, regardless
-// of what precision is requested for display!
-currencyPrecision, isSmallestUnit) {
+function prepareNumberForFormatting(number, currencyPrecision, currency, isSmallestUnit) {
     if (isNaN(number)) {
         debug('formatCurrency was called with NaN');
         return 0;
@@ -131,7 +158,7 @@ currencyPrecision, isSmallestUnit) {
         if (!Number.isInteger(number)) {
             debug('formatCurrency was called with isSmallestUnit and a float which will be rounded', number);
         }
-        const smallestUnitDivisor = 10 ** currencyPrecision;
+        const smallestUnitDivisor = 10 ** getSmallestUnitExponent(currency, currencyPrecision);
         return scaleNumberForPrecision(Math.round(number) / smallestUnitDivisor, currencyPrecision);
     }
     return scaleNumberForPrecision(number, currencyPrecision);
@@ -182,7 +209,7 @@ const numberFormatCurrency = ({ number, browserSafeLocale, currency, stripZeros,
     if (isSmallestUnit && typeof currencyPrecision === 'undefined') {
         throw new Error(`Could not determine currency precision for ${validCurrency} in ${browserSafeLocale}`);
     }
-    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, isSmallestUnit);
+    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, validCurrency, isSmallestUnit);
     const formatter = getCurrencyFormatter({
         number: numberAsFloat,
         currency: validCurrency,
@@ -254,7 +281,7 @@ const getCurrencyObject = ({ number, browserSafeLocale, currency, stripZeros, is
     const validCurrency = getValidCurrency(currency, geoLocation);
     const currencyOverride = getCurrencyOverride(validCurrency, geoLocation);
     const currencyPrecision = getPrecisionForLocaleAndCurrency(browserSafeLocale, validCurrency, forceLatin);
-    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, isSmallestUnit);
+    const numberAsFloat = prepareNumberForFormatting(number, currencyPrecision ?? 0, validCurrency, isSmallestUnit);
     const formatter = getCurrencyFormatter({
         number: numberAsFloat,
         currency: validCurrency,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@automattic/number-formatters",
-	"version": "1.1.8",
+	"version": "1.1.10",
 	"description": "Number formatting utilities",
 	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/js-packages/number-formatters/#readme",
 	"bugs": {
@@ -39,11 +39,11 @@
 	"devDependencies": {
 		"@babel/core": "7.29.0",
 		"@babel/preset-react": "7.28.5",
-		"@jest/globals": "30.3.0",
+		"@jest/globals": "30.4.1",
 		"@knighted/duel": "4.0.2",
 		"@types/jest": "30.0.0",
 		"@typescript/native-preview": "7.0.0-dev.20260225.1",
-		"jest": "30.3.0",
+		"jest": "30.4.2",
 		"jetpack-js-tools": "workspace:*",
 		"typescript": "5.9.3"
 	}

package/src/number-format-currency/index.ts

@@ -98,6 +98,37 @@ function getCurrencyFormatter( {
 	} );
 }
 
+/**
+ * Smallest-unit exponent overrides for currencies where browser ICU's
+ * `maximumFractionDigits` disagrees with the API's smallest-unit encoding.
+ *
+ * Keep this list minimal — the backend is the source of truth for the API's
+ * smallest-unit encoding, so adding speculative entries here risks silent
+ * drift. Only add a currency once we've verified that browsers report a
+ * value the API does not use.
+ *
+ * - IDR: modern Chrome / Node 24+ ICU reports 0; the API encodes with exponent 2.
+ * - HUF: same browser/API divergence as IDR.
+ */
+const SMALLEST_UNIT_EXPONENT_OVERRIDES: Record< string, number > = {
+	IDR: 2,
+	HUF: 2,
+};
+
+/**
+ * Returns the smallest unit exponent for a currency.
+ *
+ * Falls back to the browser-derived display precision for any currency not in
+ * the override map — i.e. existing behavior is preserved for everything except
+ * the explicitly listed currencies.
+ * @param currency - The currency code (ISO 4217)
+ * @param fallback - The browser-derived precision to use when no override applies
+ * @return number  - The smallest unit exponent
+ */
+function getSmallestUnitExponent( currency: string, fallback: number ): number {
+	return SMALLEST_UNIT_EXPONENT_OVERRIDES[ currency ] ?? fallback;
+}
+
 /**
  * Returns the precision for a given locale and currency.
  * @param  browserSafeLocale - The browser safe locale.
@@ -139,15 +170,15 @@ function scaleNumberForPrecision( number: number, currencyPrecision: number ): n
 /**
  * Prepares a number for formatting.
  * @param  number            - The number to prepare.
- * @param  currencyPrecision - The precision to prepare the number for.
+ * @param  currencyPrecision - The display precision (from the browser) to round the result to.
+ * @param  currency          - The currency code, used to look up any smallest-unit exponent override.
  * @param  isSmallestUnit    - Whether the number is the smallest unit of a currency.
  * @return {number} The prepared number.
  */
 function prepareNumberForFormatting(
 	number: number,
-	// currencyPrecision here must be the precision of the currency, regardless
-	// of what precision is requested for display!
 	currencyPrecision: number,
+	currency: string,
 	isSmallestUnit?: boolean
 ): number {
 	if ( isNaN( number ) ) {
@@ -162,7 +193,7 @@ function prepareNumberForFormatting(
 				number
 			);
 		}
-		const smallestUnitDivisor = 10 ** currencyPrecision;
+		const smallestUnitDivisor = 10 ** getSmallestUnitExponent( currency, currencyPrecision );
 		return scaleNumberForPrecision( Math.round( number ) / smallestUnitDivisor, currencyPrecision );
 	}
 
@@ -235,6 +266,7 @@ const numberFormatCurrency = ( {
 	const numberAsFloat = prepareNumberForFormatting(
 		number,
 		currencyPrecision ?? 0,
+		validCurrency,
 		isSmallestUnit
 	);
 	const formatter = getCurrencyFormatter( {
@@ -326,6 +358,7 @@ const getCurrencyObject = ( {
 	const numberAsFloat = prepareNumberForFormatting(
 		number,
 		currencyPrecision ?? 0,
+		validCurrency,
 		isSmallestUnit
 	);
 	const formatter = getCurrencyFormatter( {