@metamask/assets-controllers 74.3.3 → 75.1.0

package/dist/utils/formatters.cjs

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFormatters = void 0;
+const FALLBACK_LOCALE = 'en';
+const twoDecimals = {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+};
+const oneSignificantDigit = {
+    minimumSignificantDigits: 1,
+    maximumSignificantDigits: 1,
+};
+const threeSignificantDigits = {
+    minimumSignificantDigits: 3,
+    maximumSignificantDigits: 3,
+};
+const numberFormatCache = {};
+/**
+ * Get cached number format instance.
+ *
+ * @param locale - Locale string.
+ * @param options - Optional Intl.NumberFormat options.
+ * @returns Cached Intl.NumberFormat instance.
+ */
+function getCachedNumberFormat(locale, options = {}) {
+    const key = `${locale}_${JSON.stringify(options)}`;
+    let format = numberFormatCache[key];
+    if (format) {
+        return format;
+    }
+    try {
+        format = new Intl.NumberFormat(locale, options);
+    }
+    catch (error) {
+        if (error instanceof RangeError) {
+            // Fallback for invalid options (e.g. currency code)
+            format = new Intl.NumberFormat(locale, twoDecimals);
+        }
+        else {
+            throw error;
+        }
+    }
+    numberFormatCache[key] = format;
+    return format;
+}
+/**
+ * Format a value as a currency string.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @param options - Optional Intl.NumberFormat overrides.
+ * @returns Formatted currency string.
+ */
+function formatCurrency(config, value, currency, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, {
+        style: 'currency',
+        currency,
+        ...options,
+    });
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    return numberFormat.format(value);
+}
+/**
+ * Compact currency formatting (e.g. $1.2K, $3.4M).
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted compact currency string.
+ */
+function formatCurrencyCompact(config, value, currency) {
+    return formatCurrency(config, value, currency, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+/**
+ * Currency formatting with minimum threshold for small values.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted currency string with threshold handling.
+ */
+function formatCurrencyWithMinThreshold(config, value, currency) {
+    const minThreshold = 0.01;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatCurrency(config, 0, currency);
+    }
+    if (absoluteValue < minThreshold) {
+        const formattedMin = formatCurrency(config, minThreshold, currency);
+        return `<${formattedMin}`;
+    }
+    return formatCurrency(config, number, currency);
+}
+/**
+ * Format a value as a token string with symbol.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param symbol - Token symbol.
+ * @param options - Optional Intl.NumberFormat overrides.
+ * @returns Formatted token string.
+ */
+function formatToken(config, value, symbol, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, {
+        style: 'decimal',
+        ...options,
+    });
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    const formattedNumber = numberFormat.format(value);
+    return `${formattedNumber} ${symbol}`;
+}
+/**
+ * Format token price with varying precision based on value.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted token price string.
+ */
+function formatCurrencyTokenPrice(config, value, currency) {
+    const minThreshold = 0.00000001;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatCurrency(config, 0, currency);
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatCurrency(config, minThreshold, currency, oneSignificantDigit)}`;
+    }
+    if (absoluteValue < 1) {
+        return formatCurrency(config, number, currency, threeSignificantDigits);
+    }
+    if (absoluteValue < 1000000) {
+        return formatCurrency(config, number, currency);
+    }
+    return formatCurrencyCompact(config, number, currency);
+}
+/**
+ * Format token quantity with varying precision based on value.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param symbol - Token symbol.
+ * @returns Formatted token quantity string.
+ */
+function formatTokenQuantity(config, value, symbol) {
+    const minThreshold = 0.00001;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatToken(config, 0, symbol);
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatToken(config, minThreshold, symbol, oneSignificantDigit)}`;
+    }
+    if (absoluteValue < 1) {
+        return formatToken(config, number, symbol, threeSignificantDigits);
+    }
+    if (absoluteValue < 1000000) {
+        return formatToken(config, number, symbol);
+    }
+    return formatToken(config, number, symbol, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+/**
+ * Create formatter functions with the given locale.
+ *
+ * @param options - Configuration options.
+ * @param options.locale - Locale string.
+ * @returns Object with formatter functions.
+ */
+function createFormatters({ locale = FALLBACK_LOCALE }) {
+    return {
+        /**
+         * Format a value as a currency string.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code (e.g. 'USD').
+         * @param options - Optional Intl.NumberFormat overrides.
+         */
+        formatCurrency: formatCurrency.bind(null, { locale }),
+        /**
+         * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyCompact: formatCurrencyCompact.bind(null, { locale }),
+        /**
+         * Currency with thresholds for small values.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, {
+            locale,
+        }),
+        /**
+         * Format token price with varying precision based on value.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, { locale }),
+        /**
+         * Format a value as a token string with symbol.
+         *
+         * @param value - Numeric value to format.
+         * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+         * @param options - Optional Intl.NumberFormat overrides.
+         */
+        formatToken: formatToken.bind(null, { locale }),
+        /**
+         * Format token quantity with varying precision based on value.
+         *
+         * @param value - Numeric value to format.
+         * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+         */
+        formatTokenQuantity: formatTokenQuantity.bind(null, { locale }),
+    };
+}
+exports.createFormatters = createFormatters;
+//# sourceMappingURL=formatters.cjs.map

package/dist/utils/formatters.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.cjs","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"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","sourcesContent":["const FALLBACK_LOCALE = 'en';\n\nconst twoDecimals = {\n  minimumFractionDigits: 2,\n  maximumFractionDigits: 2,\n};\n\nconst oneSignificantDigit = {\n  minimumSignificantDigits: 1,\n  maximumSignificantDigits: 1,\n};\n\nconst threeSignificantDigits = {\n  minimumSignificantDigits: 3,\n  maximumSignificantDigits: 3,\n};\n\nconst numberFormatCache: Record<string, Intl.NumberFormat> = {};\n\n/**\n * Get cached number format instance.\n *\n * @param locale - Locale string.\n * @param options - Optional Intl.NumberFormat options.\n * @returns Cached Intl.NumberFormat instance.\n */\nfunction getCachedNumberFormat(\n  locale: string,\n  options: Intl.NumberFormatOptions = {},\n) {\n  const key = `${locale}_${JSON.stringify(options)}`;\n\n  let format = numberFormatCache[key];\n\n  if (format) {\n    return format;\n  }\n\n  try {\n    format = new Intl.NumberFormat(locale, options);\n  } catch (error) {\n    if (error instanceof RangeError) {\n      // Fallback for invalid options (e.g. currency code)\n      format = new Intl.NumberFormat(locale, twoDecimals);\n    } else {\n      throw error;\n    }\n  }\n\n  numberFormatCache[key] = format;\n  return format;\n}\n\n/**\n * Format a value as a currency string.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @param options - Optional Intl.NumberFormat overrides.\n * @returns Formatted currency string.\n */\nfunction formatCurrency(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n  options: Intl.NumberFormatOptions = {},\n) {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, {\n    style: 'currency',\n    currency,\n    ...options,\n  });\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  return numberFormat.format(value);\n}\n\n/**\n * Compact currency formatting (e.g. $1.2K, $3.4M).\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted compact currency string.\n */\nfunction formatCurrencyCompact(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  return formatCurrency(config, value, currency, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\n/**\n * Currency formatting with minimum threshold for small values.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted currency string with threshold handling.\n */\nfunction formatCurrencyWithMinThreshold(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  const minThreshold = 0.01;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatCurrency(config, 0, currency);\n  }\n\n  if (absoluteValue < minThreshold) {\n    const formattedMin = formatCurrency(config, minThreshold, currency);\n    return `<${formattedMin}`;\n  }\n\n  return formatCurrency(config, number, currency);\n}\n\n/**\n * Format a value as a token string with symbol.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param symbol - Token symbol.\n * @param options - Optional Intl.NumberFormat overrides.\n * @returns Formatted token string.\n */\nfunction formatToken(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  symbol: string,\n  options: Intl.NumberFormatOptions = {},\n) {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, {\n    style: 'decimal',\n    ...options,\n  });\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  const formattedNumber = numberFormat.format(value);\n\n  return `${formattedNumber} ${symbol}`;\n}\n\n/**\n * Format token price with varying precision based on value.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted token price string.\n */\nfunction formatCurrencyTokenPrice(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  const minThreshold = 0.00000001;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatCurrency(config, 0, currency);\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatCurrency(config, minThreshold, currency, oneSignificantDigit)}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatCurrency(config, number, currency, threeSignificantDigits);\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatCurrency(config, number, currency);\n  }\n\n  return formatCurrencyCompact(config, number, currency);\n}\n\n/**\n * Format token quantity with varying precision based on value.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param symbol - Token symbol.\n * @returns Formatted token quantity string.\n */\nfunction formatTokenQuantity(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  symbol: string,\n) {\n  const minThreshold = 0.00001;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatToken(config, 0, symbol);\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatToken(config, minThreshold, symbol, oneSignificantDigit)}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatToken(config, number, symbol, threeSignificantDigits);\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatToken(config, number, symbol);\n  }\n\n  return formatToken(config, number, symbol, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\n/**\n * Create formatter functions with the given locale.\n *\n * @param options - Configuration options.\n * @param options.locale - Locale string.\n * @returns Object with formatter functions.\n */\nexport function createFormatters({ locale = FALLBACK_LOCALE }) {\n  return {\n    /**\n     * Format a value as a currency string.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code (e.g. 'USD').\n     * @param options - Optional Intl.NumberFormat overrides.\n     */\n    formatCurrency: formatCurrency.bind(null, { locale }),\n    /**\n     * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyCompact: formatCurrencyCompact.bind(null, { locale }),\n    /**\n     * Currency with thresholds for small values.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, {\n      locale,\n    }),\n    /**\n     * Format token price with varying precision based on value.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, { locale }),\n    /**\n     * Format a value as a token string with symbol.\n     *\n     * @param value - Numeric value to format.\n     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').\n     * @param options - Optional Intl.NumberFormat overrides.\n     */\n    formatToken: formatToken.bind(null, { locale }),\n    /**\n     * Format token quantity with varying precision based on value.\n     *\n     * @param value - Numeric value to format.\n     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').\n     */\n    formatTokenQuantity: formatTokenQuantity.bind(null, { locale }),\n  };\n}\n"]}

package/dist/utils/formatters.d.cts

@@ -0,0 +1,56 @@
+/**
+ * Create formatter functions with the given locale.
+ *
+ * @param options - Configuration options.
+ * @param options.locale - Locale string.
+ * @returns Object with formatter functions.
+ */
+export declare function createFormatters({ locale }: {
+    locale?: string | undefined;
+}): {
+    /**
+     * Format a value as a currency string.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code (e.g. 'USD').
+     * @param options - Optional Intl.NumberFormat overrides.
+     */
+    formatCurrency: (value: number | bigint | `${number}`, currency: string | undefined, options?: Intl.NumberFormatOptions | undefined) => string;
+    /**
+     * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyCompact: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Currency with thresholds for small values.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyWithMinThreshold: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Format token price with varying precision based on value.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyTokenPrice: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Format a value as a token string with symbol.
+     *
+     * @param value - Numeric value to format.
+     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+     * @param options - Optional Intl.NumberFormat overrides.
+     */
+    formatToken: (value: number | bigint | `${number}`, symbol: string, options?: Intl.NumberFormatOptions | undefined) => string;
+    /**
+     * Format token quantity with varying precision based on value.
+     *
+     * @param value - Numeric value to format.
+     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+     */
+    formatTokenQuantity: (value: number | bigint | `${number}`, symbol: string) => string;
+};
+//# sourceMappingURL=formatters.d.cts.map

package/dist/utils/formatters.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.cts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AA6PA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAwB,EAAE;;CAAA;IAEzD;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAIH;;;;;OAKG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;EAGN"}

package/dist/utils/formatters.d.mts

@@ -0,0 +1,56 @@
+/**
+ * Create formatter functions with the given locale.
+ *
+ * @param options - Configuration options.
+ * @param options.locale - Locale string.
+ * @returns Object with formatter functions.
+ */
+export declare function createFormatters({ locale }: {
+    locale?: string | undefined;
+}): {
+    /**
+     * Format a value as a currency string.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code (e.g. 'USD').
+     * @param options - Optional Intl.NumberFormat overrides.
+     */
+    formatCurrency: (value: number | bigint | `${number}`, currency: string | undefined, options?: Intl.NumberFormatOptions | undefined) => string;
+    /**
+     * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyCompact: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Currency with thresholds for small values.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyWithMinThreshold: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Format token price with varying precision based on value.
+     *
+     * @param value - Numeric value to format.
+     * @param currency - ISO 4217 currency code.
+     */
+    formatCurrencyTokenPrice: (value: number | bigint | `${number}`, currency: string | undefined) => string;
+    /**
+     * Format a value as a token string with symbol.
+     *
+     * @param value - Numeric value to format.
+     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+     * @param options - Optional Intl.NumberFormat overrides.
+     */
+    formatToken: (value: number | bigint | `${number}`, symbol: string, options?: Intl.NumberFormatOptions | undefined) => string;
+    /**
+     * Format token quantity with varying precision based on value.
+     *
+     * @param value - Numeric value to format.
+     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+     */
+    formatTokenQuantity: (value: number | bigint | `${number}`, symbol: string) => string;
+};
+//# sourceMappingURL=formatters.d.mts.map

package/dist/utils/formatters.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.mts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AA6PA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAwB,EAAE;;CAAA;IAEzD;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;IAIH;;;;;OAKG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;EAGN"}

package/dist/utils/formatters.mjs

@@ -0,0 +1,247 @@
+const FALLBACK_LOCALE = 'en';
+const twoDecimals = {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+};
+const oneSignificantDigit = {
+    minimumSignificantDigits: 1,
+    maximumSignificantDigits: 1,
+};
+const threeSignificantDigits = {
+    minimumSignificantDigits: 3,
+    maximumSignificantDigits: 3,
+};
+const numberFormatCache = {};
+/**
+ * Get cached number format instance.
+ *
+ * @param locale - Locale string.
+ * @param options - Optional Intl.NumberFormat options.
+ * @returns Cached Intl.NumberFormat instance.
+ */
+function getCachedNumberFormat(locale, options = {}) {
+    const key = `${locale}_${JSON.stringify(options)}`;
+    let format = numberFormatCache[key];
+    if (format) {
+        return format;
+    }
+    try {
+        format = new Intl.NumberFormat(locale, options);
+    }
+    catch (error) {
+        if (error instanceof RangeError) {
+            // Fallback for invalid options (e.g. currency code)
+            format = new Intl.NumberFormat(locale, twoDecimals);
+        }
+        else {
+            throw error;
+        }
+    }
+    numberFormatCache[key] = format;
+    return format;
+}
+/**
+ * Format a value as a currency string.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @param options - Optional Intl.NumberFormat overrides.
+ * @returns Formatted currency string.
+ */
+function formatCurrency(config, value, currency, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, {
+        style: 'currency',
+        currency,
+        ...options,
+    });
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    return numberFormat.format(value);
+}
+/**
+ * Compact currency formatting (e.g. $1.2K, $3.4M).
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted compact currency string.
+ */
+function formatCurrencyCompact(config, value, currency) {
+    return formatCurrency(config, value, currency, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+/**
+ * Currency formatting with minimum threshold for small values.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted currency string with threshold handling.
+ */
+function formatCurrencyWithMinThreshold(config, value, currency) {
+    const minThreshold = 0.01;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatCurrency(config, 0, currency);
+    }
+    if (absoluteValue < minThreshold) {
+        const formattedMin = formatCurrency(config, minThreshold, currency);
+        return `<${formattedMin}`;
+    }
+    return formatCurrency(config, number, currency);
+}
+/**
+ * Format a value as a token string with symbol.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param symbol - Token symbol.
+ * @param options - Optional Intl.NumberFormat overrides.
+ * @returns Formatted token string.
+ */
+function formatToken(config, value, symbol, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, {
+        style: 'decimal',
+        ...options,
+    });
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    const formattedNumber = numberFormat.format(value);
+    return `${formattedNumber} ${symbol}`;
+}
+/**
+ * Format token price with varying precision based on value.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param currency - ISO 4217 currency code.
+ * @returns Formatted token price string.
+ */
+function formatCurrencyTokenPrice(config, value, currency) {
+    const minThreshold = 0.00000001;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatCurrency(config, 0, currency);
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatCurrency(config, minThreshold, currency, oneSignificantDigit)}`;
+    }
+    if (absoluteValue < 1) {
+        return formatCurrency(config, number, currency, threeSignificantDigits);
+    }
+    if (absoluteValue < 1000000) {
+        return formatCurrency(config, number, currency);
+    }
+    return formatCurrencyCompact(config, number, currency);
+}
+/**
+ * Format token quantity with varying precision based on value.
+ *
+ * @param config - Configuration object with locale.
+ * @param config.locale - Locale string.
+ * @param value - Numeric value to format.
+ * @param symbol - Token symbol.
+ * @returns Formatted token quantity string.
+ */
+function formatTokenQuantity(config, value, symbol) {
+    const minThreshold = 0.00001;
+    const number = Number(value);
+    const absoluteValue = Math.abs(number);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    if (number === 0) {
+        return formatToken(config, 0, symbol);
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatToken(config, minThreshold, symbol, oneSignificantDigit)}`;
+    }
+    if (absoluteValue < 1) {
+        return formatToken(config, number, symbol, threeSignificantDigits);
+    }
+    if (absoluteValue < 1000000) {
+        return formatToken(config, number, symbol);
+    }
+    return formatToken(config, number, symbol, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+/**
+ * Create formatter functions with the given locale.
+ *
+ * @param options - Configuration options.
+ * @param options.locale - Locale string.
+ * @returns Object with formatter functions.
+ */
+export function createFormatters({ locale = FALLBACK_LOCALE }) {
+    return {
+        /**
+         * Format a value as a currency string.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code (e.g. 'USD').
+         * @param options - Optional Intl.NumberFormat overrides.
+         */
+        formatCurrency: formatCurrency.bind(null, { locale }),
+        /**
+         * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyCompact: formatCurrencyCompact.bind(null, { locale }),
+        /**
+         * Currency with thresholds for small values.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, {
+            locale,
+        }),
+        /**
+         * Format token price with varying precision based on value.
+         *
+         * @param value - Numeric value to format.
+         * @param currency - ISO 4217 currency code.
+         */
+        formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, { locale }),
+        /**
+         * Format a value as a token string with symbol.
+         *
+         * @param value - Numeric value to format.
+         * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+         * @param options - Optional Intl.NumberFormat overrides.
+         */
+        formatToken: formatToken.bind(null, { locale }),
+        /**
+         * Format token quantity with varying precision based on value.
+         *
+         * @param value - Numeric value to format.
+         * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').
+         */
+        formatTokenQuantity: formatTokenQuantity.bind(null, { locale }),
+    };
+}
+//# sourceMappingURL=formatters.mjs.map

package/dist/utils/formatters.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.mjs","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"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","sourcesContent":["const FALLBACK_LOCALE = 'en';\n\nconst twoDecimals = {\n  minimumFractionDigits: 2,\n  maximumFractionDigits: 2,\n};\n\nconst oneSignificantDigit = {\n  minimumSignificantDigits: 1,\n  maximumSignificantDigits: 1,\n};\n\nconst threeSignificantDigits = {\n  minimumSignificantDigits: 3,\n  maximumSignificantDigits: 3,\n};\n\nconst numberFormatCache: Record<string, Intl.NumberFormat> = {};\n\n/**\n * Get cached number format instance.\n *\n * @param locale - Locale string.\n * @param options - Optional Intl.NumberFormat options.\n * @returns Cached Intl.NumberFormat instance.\n */\nfunction getCachedNumberFormat(\n  locale: string,\n  options: Intl.NumberFormatOptions = {},\n) {\n  const key = `${locale}_${JSON.stringify(options)}`;\n\n  let format = numberFormatCache[key];\n\n  if (format) {\n    return format;\n  }\n\n  try {\n    format = new Intl.NumberFormat(locale, options);\n  } catch (error) {\n    if (error instanceof RangeError) {\n      // Fallback for invalid options (e.g. currency code)\n      format = new Intl.NumberFormat(locale, twoDecimals);\n    } else {\n      throw error;\n    }\n  }\n\n  numberFormatCache[key] = format;\n  return format;\n}\n\n/**\n * Format a value as a currency string.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @param options - Optional Intl.NumberFormat overrides.\n * @returns Formatted currency string.\n */\nfunction formatCurrency(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n  options: Intl.NumberFormatOptions = {},\n) {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, {\n    style: 'currency',\n    currency,\n    ...options,\n  });\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  return numberFormat.format(value);\n}\n\n/**\n * Compact currency formatting (e.g. $1.2K, $3.4M).\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted compact currency string.\n */\nfunction formatCurrencyCompact(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  return formatCurrency(config, value, currency, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\n/**\n * Currency formatting with minimum threshold for small values.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted currency string with threshold handling.\n */\nfunction formatCurrencyWithMinThreshold(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  const minThreshold = 0.01;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatCurrency(config, 0, currency);\n  }\n\n  if (absoluteValue < minThreshold) {\n    const formattedMin = formatCurrency(config, minThreshold, currency);\n    return `<${formattedMin}`;\n  }\n\n  return formatCurrency(config, number, currency);\n}\n\n/**\n * Format a value as a token string with symbol.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param symbol - Token symbol.\n * @param options - Optional Intl.NumberFormat overrides.\n * @returns Formatted token string.\n */\nfunction formatToken(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  symbol: string,\n  options: Intl.NumberFormatOptions = {},\n) {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, {\n    style: 'decimal',\n    ...options,\n  });\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  const formattedNumber = numberFormat.format(value);\n\n  return `${formattedNumber} ${symbol}`;\n}\n\n/**\n * Format token price with varying precision based on value.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param currency - ISO 4217 currency code.\n * @returns Formatted token price string.\n */\nfunction formatCurrencyTokenPrice(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  currency: Intl.NumberFormatOptions['currency'],\n) {\n  const minThreshold = 0.00000001;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatCurrency(config, 0, currency);\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatCurrency(config, minThreshold, currency, oneSignificantDigit)}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatCurrency(config, number, currency, threeSignificantDigits);\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatCurrency(config, number, currency);\n  }\n\n  return formatCurrencyCompact(config, number, currency);\n}\n\n/**\n * Format token quantity with varying precision based on value.\n *\n * @param config - Configuration object with locale.\n * @param config.locale - Locale string.\n * @param value - Numeric value to format.\n * @param symbol - Token symbol.\n * @returns Formatted token quantity string.\n */\nfunction formatTokenQuantity(\n  config: { locale: string },\n  value: number | bigint | `${number}`,\n  symbol: string,\n) {\n  const minThreshold = 0.00001;\n  const number = Number(value);\n  const absoluteValue = Math.abs(number);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  if (number === 0) {\n    return formatToken(config, 0, symbol);\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatToken(config, minThreshold, symbol, oneSignificantDigit)}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatToken(config, number, symbol, threeSignificantDigits);\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatToken(config, number, symbol);\n  }\n\n  return formatToken(config, number, symbol, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\n/**\n * Create formatter functions with the given locale.\n *\n * @param options - Configuration options.\n * @param options.locale - Locale string.\n * @returns Object with formatter functions.\n */\nexport function createFormatters({ locale = FALLBACK_LOCALE }) {\n  return {\n    /**\n     * Format a value as a currency string.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code (e.g. 'USD').\n     * @param options - Optional Intl.NumberFormat overrides.\n     */\n    formatCurrency: formatCurrency.bind(null, { locale }),\n    /**\n     * Compact currency (e.g. $1.2K, $3.4M) with up to two decimal digits.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyCompact: formatCurrencyCompact.bind(null, { locale }),\n    /**\n     * Currency with thresholds for small values.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, {\n      locale,\n    }),\n    /**\n     * Format token price with varying precision based on value.\n     *\n     * @param value - Numeric value to format.\n     * @param currency - ISO 4217 currency code.\n     */\n    formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, { locale }),\n    /**\n     * Format a value as a token string with symbol.\n     *\n     * @param value - Numeric value to format.\n     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').\n     * @param options - Optional Intl.NumberFormat overrides.\n     */\n    formatToken: formatToken.bind(null, { locale }),\n    /**\n     * Format token quantity with varying precision based on value.\n     *\n     * @param value - Numeric value to format.\n     * @param symbol - Token symbol (e.g. 'ETH', 'SepoliaETH').\n     */\n    formatTokenQuantity: formatTokenQuantity.bind(null, { locale }),\n  };\n}\n"]}