@metamask/client-utils 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.0]
+
+### Added
+
+- Add `createFormatters` factory with shared display formatters (`formatNumber`, `formatCurrency`, `formatCurrencyCompact`, `formatCurrencyWithMinThreshold`, `formatCurrencyTokenPrice`, `formatToken`, `formatTokenQuantity`, `formatTokenAmount`, `formatPercentWithMinThreshold`, `formatCompact`, `formatDateTime`) ([#9504](https://github.com/MetaMask/core/pull/9504))
+
 ## [1.1.0]
 
 ### Added
@@ -33,6 +39,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Bump `@metamask/transaction-controller` from `^68.2.2` to `^68.3.0` ([#9421](https://github.com/MetaMask/core/pull/9421))
 - Bump `@metamask/keyring-api` from `^23.3.0` to `^23.5.0` ([#9390](https://github.com/MetaMask/core/pull/9390))
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.2.0...HEAD
+[1.2.0]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.1.0...@metamask/client-utils@1.2.0
 [1.1.0]: https://github.com/MetaMask/core/compare/@metamask/client-utils@1.0.0...@metamask/client-utils@1.1.0
 [1.0.0]: https://github.com/MetaMask/core/releases/tag/@metamask/client-utils@1.0.0

package/dist/formatters/create-formatters.cjs

@@ -0,0 +1,238 @@
+"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 = {};
+const dateTimeFormatCache = {};
+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) {
+            format = new Intl.NumberFormat(locale, twoDecimals);
+        }
+        else {
+            throw error;
+        }
+    }
+    numberFormatCache[key] = format;
+    return format;
+}
+function getCachedDateTimeFormat(locale, options) {
+    const key = `${locale}_${JSON.stringify(options)}`;
+    if (!dateTimeFormatCache[key]) {
+        dateTimeFormatCache[key] = new Intl.DateTimeFormat(locale, options);
+    }
+    return dateTimeFormatCache[key];
+}
+function formatNumber(config, value, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, options);
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    return numberFormat.format(value);
+}
+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);
+}
+function formatCurrencyCompact(config, value, currency) {
+    return formatCurrency(config, value, currency, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+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);
+}
+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);
+}
+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}`;
+}
+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,
+    });
+}
+// Format token quantity without trailing zeros.
+function formatTokenAmount(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, { maximumFractionDigits: 0 });
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatToken(config, minThreshold, symbol, {
+            minimumSignificantDigits: 1,
+            maximumSignificantDigits: 1,
+        })}`;
+    }
+    if (absoluteValue < 1) {
+        return formatToken(config, number, symbol, {
+            minimumSignificantDigits: 1,
+            maximumSignificantDigits: 4,
+        });
+    }
+    if (absoluteValue < 1000000) {
+        return formatToken(config, number, symbol, {
+            minimumFractionDigits: 0,
+            maximumFractionDigits: 4,
+        });
+    }
+    return formatToken(config, number, symbol, {
+        notation: 'compact',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    });
+}
+function formatPercentWithMinThreshold(config, value, options = {}) {
+    const minThreshold = 0.0001; // 0.01%
+    const number = Number(value);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    const clamped = number === 0
+        ? 0
+        : Math.sign(number) * Math.max(Math.abs(number), minThreshold);
+    return formatNumber(config, clamped, {
+        style: 'percent',
+        maximumFractionDigits: 2,
+        minimumFractionDigits: 2,
+        ...options,
+    });
+}
+function formatCompact(config, value) {
+    return formatNumber(config, value, {
+        notation: 'compact',
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+}
+function formatDateTime(config, timestamp, options) {
+    if (!timestamp) {
+        return '';
+    }
+    const date = new Date(timestamp);
+    if (isNaN(date.getTime())) {
+        return '';
+    }
+    return getCachedDateTimeFormat(config.locale, {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric',
+        hour12: true,
+        ...options,
+    }).format(date);
+}
+function createFormatters({ locale = FALLBACK_LOCALE, }) {
+    const config = { locale };
+    return {
+        formatNumber: formatNumber.bind(null, config),
+        formatCurrency: formatCurrency.bind(null, config),
+        formatCurrencyCompact: formatCurrencyCompact.bind(null, config),
+        formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, config),
+        formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, config),
+        formatToken: formatToken.bind(null, config),
+        formatTokenQuantity: formatTokenQuantity.bind(null, config),
+        formatTokenAmount: formatTokenAmount.bind(null, config),
+        formatPercentWithMinThreshold: formatPercentWithMinThreshold.bind(null, config),
+        formatCompact: formatCompact.bind(null, config),
+        formatDateTime: formatDateTime.bind(null, config),
+    };
+}
+exports.createFormatters = createFormatters;
+//# sourceMappingURL=create-formatters.cjs.map

package/dist/formatters/create-formatters.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-formatters.cjs","sourceRoot":"","sources":["../../src/formatters/create-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> = {};\nconst dateTimeFormatCache: Record<string, Intl.DateTimeFormat> = {};\n\ntype Value = number | bigint | `${number}`;\n\nfunction getCachedNumberFormat(\n  locale: string,\n  options: Intl.NumberFormatOptions,\n): Intl.NumberFormat {\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      format = new Intl.NumberFormat(locale, twoDecimals);\n    } else {\n      throw error;\n    }\n  }\n\n  numberFormatCache[key] = format;\n  return format;\n}\n\nfunction getCachedDateTimeFormat(\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): Intl.DateTimeFormat {\n  const key = `${locale}_${JSON.stringify(options)}`;\n  if (!dateTimeFormatCache[key]) {\n    dateTimeFormatCache[key] = new Intl.DateTimeFormat(locale, options);\n  }\n  return dateTimeFormatCache[key];\n}\n\nfunction formatNumber(\n  config: { locale: string },\n  value: Value,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, options);\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  return numberFormat.format(value);\n}\n\nfunction formatCurrency(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n  options: Intl.NumberFormatOptions = {},\n): string {\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\nfunction formatCurrencyCompact(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\n  return formatCurrency(config, value, currency, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\nfunction formatCurrencyWithMinThreshold(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\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\nfunction formatCurrencyTokenPrice(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\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\nfunction formatToken(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n  options: Intl.NumberFormatOptions = {},\n): string {\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\nfunction formatTokenQuantity(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n): string {\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// Format token quantity without trailing zeros.\nfunction formatTokenAmount(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n): string {\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, { maximumFractionDigits: 0 });\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatToken(config, minThreshold, symbol, {\n      minimumSignificantDigits: 1,\n      maximumSignificantDigits: 1,\n    })}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatToken(config, number, symbol, {\n      minimumSignificantDigits: 1,\n      maximumSignificantDigits: 4,\n    });\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatToken(config, number, symbol, {\n      minimumFractionDigits: 0,\n      maximumFractionDigits: 4,\n    });\n  }\n\n  return formatToken(config, number, symbol, {\n    notation: 'compact',\n    minimumFractionDigits: 0,\n    maximumFractionDigits: 2,\n  });\n}\n\nfunction formatPercentWithMinThreshold(\n  config: { locale: string },\n  value: Value,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  const minThreshold = 0.0001; // 0.01%\n  const number = Number(value);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  const clamped =\n    number === 0\n      ? 0\n      : Math.sign(number) * Math.max(Math.abs(number), minThreshold);\n\n  return formatNumber(config, clamped, {\n    style: 'percent',\n    maximumFractionDigits: 2,\n    minimumFractionDigits: 2,\n    ...options,\n  });\n}\n\nfunction formatCompact(config: { locale: string }, value: Value): string {\n  return formatNumber(config, value, {\n    notation: 'compact',\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  });\n}\n\nfunction formatDateTime(\n  config: { locale: string },\n  timestamp: string | number,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  if (!timestamp) {\n    return '';\n  }\n  const date = new Date(timestamp);\n  if (isNaN(date.getTime())) {\n    return '';\n  }\n  return getCachedDateTimeFormat(config.locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n    hour12: true,\n    ...options,\n  }).format(date);\n}\n\nexport type Formatters = {\n  formatNumber: (value: Value, options?: Intl.NumberFormatOptions) => string;\n  formatCurrency: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatCurrencyCompact: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatCurrencyWithMinThreshold: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatCurrencyTokenPrice: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatToken: (\n    value: Value,\n    symbol: string,\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatTokenQuantity: (value: Value, symbol: string) => string;\n  formatTokenAmount: (value: Value, symbol: string) => string;\n  formatPercentWithMinThreshold: (\n    value: Value,\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatCompact: (value: Value) => string;\n  formatDateTime: (\n    timestamp: string | number,\n    options?: Intl.DateTimeFormatOptions,\n  ) => string;\n};\n\nexport function createFormatters({\n  locale = FALLBACK_LOCALE,\n}: {\n  locale?: string;\n}): Formatters {\n  const config = { locale };\n  return {\n    formatNumber: formatNumber.bind(null, config),\n    formatCurrency: formatCurrency.bind(null, config),\n    formatCurrencyCompact: formatCurrencyCompact.bind(null, config),\n    formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(\n      null,\n      config,\n    ),\n    formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, config),\n    formatToken: formatToken.bind(null, config),\n    formatTokenQuantity: formatTokenQuantity.bind(null, config),\n    formatTokenAmount: formatTokenAmount.bind(null, config),\n    formatPercentWithMinThreshold: formatPercentWithMinThreshold.bind(\n      null,\n      config,\n    ),\n    formatCompact: formatCompact.bind(null, config),\n    formatDateTime: formatDateTime.bind(null, config),\n  };\n}\n"]}

package/dist/formatters/create-formatters.d.cts

@@ -0,0 +1,19 @@
+type Value = number | bigint | `${number}`;
+export type Formatters = {
+    formatNumber: (value: Value, options?: Intl.NumberFormatOptions) => string;
+    formatCurrency: (value: Value, currency: Intl.NumberFormatOptions['currency'], options?: Intl.NumberFormatOptions) => string;
+    formatCurrencyCompact: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatCurrencyWithMinThreshold: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatCurrencyTokenPrice: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatToken: (value: Value, symbol: string, options?: Intl.NumberFormatOptions) => string;
+    formatTokenQuantity: (value: Value, symbol: string) => string;
+    formatTokenAmount: (value: Value, symbol: string) => string;
+    formatPercentWithMinThreshold: (value: Value, options?: Intl.NumberFormatOptions) => string;
+    formatCompact: (value: Value) => string;
+    formatDateTime: (timestamp: string | number, options?: Intl.DateTimeFormatOptions) => string;
+};
+export declare function createFormatters({ locale, }: {
+    locale?: string;
+}): Formatters;
+export {};
+//# sourceMappingURL=create-formatters.d.cts.map

package/dist/formatters/create-formatters.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-formatters.d.cts","sourceRoot":"","sources":["../../src/formatters/create-formatters.ts"],"names":[],"mappings":"AAoBA,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AA4S3C,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAAK,MAAM,CAAC;IAC3E,cAAc,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAC9C,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,qBAAqB,EAAE,CACrB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,8BAA8B,EAAE,CAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,wBAAwB,EAAE,CACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,WAAW,EAAE,CACX,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,mBAAmB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5D,6BAA6B,EAAE,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACxC,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,KACjC,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,MAAwB,GACzB,EAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAqBb"}

package/dist/formatters/create-formatters.d.mts

@@ -0,0 +1,19 @@
+type Value = number | bigint | `${number}`;
+export type Formatters = {
+    formatNumber: (value: Value, options?: Intl.NumberFormatOptions) => string;
+    formatCurrency: (value: Value, currency: Intl.NumberFormatOptions['currency'], options?: Intl.NumberFormatOptions) => string;
+    formatCurrencyCompact: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatCurrencyWithMinThreshold: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatCurrencyTokenPrice: (value: Value, currency: Intl.NumberFormatOptions['currency']) => string;
+    formatToken: (value: Value, symbol: string, options?: Intl.NumberFormatOptions) => string;
+    formatTokenQuantity: (value: Value, symbol: string) => string;
+    formatTokenAmount: (value: Value, symbol: string) => string;
+    formatPercentWithMinThreshold: (value: Value, options?: Intl.NumberFormatOptions) => string;
+    formatCompact: (value: Value) => string;
+    formatDateTime: (timestamp: string | number, options?: Intl.DateTimeFormatOptions) => string;
+};
+export declare function createFormatters({ locale, }: {
+    locale?: string;
+}): Formatters;
+export {};
+//# sourceMappingURL=create-formatters.d.mts.map

package/dist/formatters/create-formatters.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-formatters.d.mts","sourceRoot":"","sources":["../../src/formatters/create-formatters.ts"],"names":[],"mappings":"AAoBA,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;AA4S3C,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAAK,MAAM,CAAC;IAC3E,cAAc,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAC9C,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,qBAAqB,EAAE,CACrB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,8BAA8B,EAAE,CAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,wBAAwB,EAAE,CACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,KAC3C,MAAM,CAAC;IACZ,WAAW,EAAE,CACX,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,mBAAmB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5D,6BAA6B,EAAE,CAC7B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAC/B,MAAM,CAAC;IACZ,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACxC,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,KACjC,MAAM,CAAC;CACb,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,MAAwB,GACzB,EAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAqBb"}

package/dist/formatters/create-formatters.mjs

@@ -0,0 +1,234 @@
+const FALLBACK_LOCALE = 'en';
+const twoDecimals = {
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+};
+const oneSignificantDigit = {
+    minimumSignificantDigits: 1,
+    maximumSignificantDigits: 1,
+};
+const threeSignificantDigits = {
+    minimumSignificantDigits: 3,
+    maximumSignificantDigits: 3,
+};
+const numberFormatCache = {};
+const dateTimeFormatCache = {};
+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) {
+            format = new Intl.NumberFormat(locale, twoDecimals);
+        }
+        else {
+            throw error;
+        }
+    }
+    numberFormatCache[key] = format;
+    return format;
+}
+function getCachedDateTimeFormat(locale, options) {
+    const key = `${locale}_${JSON.stringify(options)}`;
+    if (!dateTimeFormatCache[key]) {
+        dateTimeFormatCache[key] = new Intl.DateTimeFormat(locale, options);
+    }
+    return dateTimeFormatCache[key];
+}
+function formatNumber(config, value, options = {}) {
+    if (!Number.isFinite(Number(value))) {
+        return '';
+    }
+    const numberFormat = getCachedNumberFormat(config.locale, options);
+    // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+
+    return numberFormat.format(value);
+}
+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);
+}
+function formatCurrencyCompact(config, value, currency) {
+    return formatCurrency(config, value, currency, {
+        notation: 'compact',
+        ...twoDecimals,
+    });
+}
+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);
+}
+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);
+}
+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}`;
+}
+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,
+    });
+}
+// Format token quantity without trailing zeros.
+function formatTokenAmount(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, { maximumFractionDigits: 0 });
+    }
+    if (absoluteValue < minThreshold) {
+        return `<${formatToken(config, minThreshold, symbol, {
+            minimumSignificantDigits: 1,
+            maximumSignificantDigits: 1,
+        })}`;
+    }
+    if (absoluteValue < 1) {
+        return formatToken(config, number, symbol, {
+            minimumSignificantDigits: 1,
+            maximumSignificantDigits: 4,
+        });
+    }
+    if (absoluteValue < 1000000) {
+        return formatToken(config, number, symbol, {
+            minimumFractionDigits: 0,
+            maximumFractionDigits: 4,
+        });
+    }
+    return formatToken(config, number, symbol, {
+        notation: 'compact',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+    });
+}
+function formatPercentWithMinThreshold(config, value, options = {}) {
+    const minThreshold = 0.0001; // 0.01%
+    const number = Number(value);
+    if (!Number.isFinite(number)) {
+        return '';
+    }
+    const clamped = number === 0
+        ? 0
+        : Math.sign(number) * Math.max(Math.abs(number), minThreshold);
+    return formatNumber(config, clamped, {
+        style: 'percent',
+        maximumFractionDigits: 2,
+        minimumFractionDigits: 2,
+        ...options,
+    });
+}
+function formatCompact(config, value) {
+    return formatNumber(config, value, {
+        notation: 'compact',
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+}
+function formatDateTime(config, timestamp, options) {
+    if (!timestamp) {
+        return '';
+    }
+    const date = new Date(timestamp);
+    if (isNaN(date.getTime())) {
+        return '';
+    }
+    return getCachedDateTimeFormat(config.locale, {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric',
+        hour12: true,
+        ...options,
+    }).format(date);
+}
+export function createFormatters({ locale = FALLBACK_LOCALE, }) {
+    const config = { locale };
+    return {
+        formatNumber: formatNumber.bind(null, config),
+        formatCurrency: formatCurrency.bind(null, config),
+        formatCurrencyCompact: formatCurrencyCompact.bind(null, config),
+        formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(null, config),
+        formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, config),
+        formatToken: formatToken.bind(null, config),
+        formatTokenQuantity: formatTokenQuantity.bind(null, config),
+        formatTokenAmount: formatTokenAmount.bind(null, config),
+        formatPercentWithMinThreshold: formatPercentWithMinThreshold.bind(null, config),
+        formatCompact: formatCompact.bind(null, config),
+        formatDateTime: formatDateTime.bind(null, config),
+    };
+}
+//# sourceMappingURL=create-formatters.mjs.map

package/dist/formatters/create-formatters.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-formatters.mjs","sourceRoot":"","sources":["../../src/formatters/create-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> = {};\nconst dateTimeFormatCache: Record<string, Intl.DateTimeFormat> = {};\n\ntype Value = number | bigint | `${number}`;\n\nfunction getCachedNumberFormat(\n  locale: string,\n  options: Intl.NumberFormatOptions,\n): Intl.NumberFormat {\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      format = new Intl.NumberFormat(locale, twoDecimals);\n    } else {\n      throw error;\n    }\n  }\n\n  numberFormatCache[key] = format;\n  return format;\n}\n\nfunction getCachedDateTimeFormat(\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): Intl.DateTimeFormat {\n  const key = `${locale}_${JSON.stringify(options)}`;\n  if (!dateTimeFormatCache[key]) {\n    dateTimeFormatCache[key] = new Intl.DateTimeFormat(locale, options);\n  }\n  return dateTimeFormatCache[key];\n}\n\nfunction formatNumber(\n  config: { locale: string },\n  value: Value,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  if (!Number.isFinite(Number(value))) {\n    return '';\n  }\n\n  const numberFormat = getCachedNumberFormat(config.locale, options);\n\n  // @ts-expect-error Remove this comment once TypeScript is updated to 5.5+\n  return numberFormat.format(value);\n}\n\nfunction formatCurrency(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n  options: Intl.NumberFormatOptions = {},\n): string {\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\nfunction formatCurrencyCompact(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\n  return formatCurrency(config, value, currency, {\n    notation: 'compact',\n    ...twoDecimals,\n  });\n}\n\nfunction formatCurrencyWithMinThreshold(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\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\nfunction formatCurrencyTokenPrice(\n  config: { locale: string },\n  value: Value,\n  currency: Intl.NumberFormatOptions['currency'],\n): string {\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\nfunction formatToken(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n  options: Intl.NumberFormatOptions = {},\n): string {\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\nfunction formatTokenQuantity(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n): string {\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// Format token quantity without trailing zeros.\nfunction formatTokenAmount(\n  config: { locale: string },\n  value: Value,\n  symbol: string,\n): string {\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, { maximumFractionDigits: 0 });\n  }\n\n  if (absoluteValue < minThreshold) {\n    return `<${formatToken(config, minThreshold, symbol, {\n      minimumSignificantDigits: 1,\n      maximumSignificantDigits: 1,\n    })}`;\n  }\n\n  if (absoluteValue < 1) {\n    return formatToken(config, number, symbol, {\n      minimumSignificantDigits: 1,\n      maximumSignificantDigits: 4,\n    });\n  }\n\n  if (absoluteValue < 1_000_000) {\n    return formatToken(config, number, symbol, {\n      minimumFractionDigits: 0,\n      maximumFractionDigits: 4,\n    });\n  }\n\n  return formatToken(config, number, symbol, {\n    notation: 'compact',\n    minimumFractionDigits: 0,\n    maximumFractionDigits: 2,\n  });\n}\n\nfunction formatPercentWithMinThreshold(\n  config: { locale: string },\n  value: Value,\n  options: Intl.NumberFormatOptions = {},\n): string {\n  const minThreshold = 0.0001; // 0.01%\n  const number = Number(value);\n\n  if (!Number.isFinite(number)) {\n    return '';\n  }\n\n  const clamped =\n    number === 0\n      ? 0\n      : Math.sign(number) * Math.max(Math.abs(number), minThreshold);\n\n  return formatNumber(config, clamped, {\n    style: 'percent',\n    maximumFractionDigits: 2,\n    minimumFractionDigits: 2,\n    ...options,\n  });\n}\n\nfunction formatCompact(config: { locale: string }, value: Value): string {\n  return formatNumber(config, value, {\n    notation: 'compact',\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  });\n}\n\nfunction formatDateTime(\n  config: { locale: string },\n  timestamp: string | number,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  if (!timestamp) {\n    return '';\n  }\n  const date = new Date(timestamp);\n  if (isNaN(date.getTime())) {\n    return '';\n  }\n  return getCachedDateTimeFormat(config.locale, {\n    month: 'short',\n    day: 'numeric',\n    year: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n    hour12: true,\n    ...options,\n  }).format(date);\n}\n\nexport type Formatters = {\n  formatNumber: (value: Value, options?: Intl.NumberFormatOptions) => string;\n  formatCurrency: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatCurrencyCompact: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatCurrencyWithMinThreshold: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatCurrencyTokenPrice: (\n    value: Value,\n    currency: Intl.NumberFormatOptions['currency'],\n  ) => string;\n  formatToken: (\n    value: Value,\n    symbol: string,\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatTokenQuantity: (value: Value, symbol: string) => string;\n  formatTokenAmount: (value: Value, symbol: string) => string;\n  formatPercentWithMinThreshold: (\n    value: Value,\n    options?: Intl.NumberFormatOptions,\n  ) => string;\n  formatCompact: (value: Value) => string;\n  formatDateTime: (\n    timestamp: string | number,\n    options?: Intl.DateTimeFormatOptions,\n  ) => string;\n};\n\nexport function createFormatters({\n  locale = FALLBACK_LOCALE,\n}: {\n  locale?: string;\n}): Formatters {\n  const config = { locale };\n  return {\n    formatNumber: formatNumber.bind(null, config),\n    formatCurrency: formatCurrency.bind(null, config),\n    formatCurrencyCompact: formatCurrencyCompact.bind(null, config),\n    formatCurrencyWithMinThreshold: formatCurrencyWithMinThreshold.bind(\n      null,\n      config,\n    ),\n    formatCurrencyTokenPrice: formatCurrencyTokenPrice.bind(null, config),\n    formatToken: formatToken.bind(null, config),\n    formatTokenQuantity: formatTokenQuantity.bind(null, config),\n    formatTokenAmount: formatTokenAmount.bind(null, config),\n    formatPercentWithMinThreshold: formatPercentWithMinThreshold.bind(\n      null,\n      config,\n    ),\n    formatCompact: formatCompact.bind(null, config),\n    formatDateTime: formatDateTime.bind(null, config),\n  };\n}\n"]}

package/dist/index.cjs

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapLocalTransaction = exports.mapKeyringTransaction = exports.mapApiTransaction = void 0;
+exports.mapLocalTransaction = exports.mapKeyringTransaction = exports.mapApiTransaction = exports.createFormatters = void 0;
+var create_formatters_1 = require("./formatters/create-formatters.cjs");
+Object.defineProperty(exports, "createFormatters", { enumerable: true, get: function () { return create_formatters_1.createFormatters; } });
 var api_transaction_mapper_1 = require("./mappers/api-transaction-mapper.cjs");
 Object.defineProperty(exports, "mapApiTransaction", { enumerable: true, get: function () { return api_transaction_mapper_1.mapApiTransaction; } });
 var keyring_transaction_mapper_1 = require("./mappers/keyring-transaction-mapper.cjs");

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAAqE;AAA5D,2HAAA,iBAAiB,OAAA;AAC1B,uFAA6E;AAApE,mIAAA,qBAAqB,OAAA;AAC9B,mFAAyE;AAAhE,+HAAA,mBAAmB,OAAA","sourcesContent":["export { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wEAAkE;AAAzD,qHAAA,gBAAgB,OAAA;AAGzB,+EAAqE;AAA5D,2HAAA,iBAAiB,OAAA;AAC1B,uFAA6E;AAApE,mIAAA,qBAAqB,OAAA;AAC9B,mFAAyE;AAAhE,+HAAA,mBAAmB,OAAA","sourcesContent":["export { createFormatters } from './formatters/create-formatters';\nexport type { Formatters } from './formatters/create-formatters';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+export { createFormatters } from "./formatters/create-formatters.cjs";
+export type { Formatters } from "./formatters/create-formatters.cjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.cjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.cjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.cjs";

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAAuC;AAClE,YAAY,EAAE,UAAU,EAAE,2CAAuC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+export { createFormatters } from "./formatters/create-formatters.mjs";
+export type { Formatters } from "./formatters/create-formatters.mjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAAuC;AAClE,YAAY,EAAE,UAAU,EAAE,2CAAuC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C;AAEzE,iCAA6B"}

package/dist/index.mjs

@@ -1,3 +1,4 @@
+export { createFormatters } from "./formatters/create-formatters.mjs";
 export { mapApiTransaction } from "./mappers/api-transaction-mapper.mjs";
 export { mapKeyringTransaction } from "./mappers/keyring-transaction-mapper.mjs";
 export { mapLocalTransaction } from "./mappers/local-transaction-mapper.mjs";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C","sourcesContent":["export { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,2CAAuC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EAAE,qBAAqB,EAAE,iDAA6C;AAC7E,OAAO,EAAE,mBAAmB,EAAE,+CAA2C","sourcesContent":["export { createFormatters } from './formatters/create-formatters';\nexport type { Formatters } from './formatters/create-formatters';\n\nexport { mapApiTransaction } from './mappers/api-transaction-mapper';\nexport { mapKeyringTransaction } from './mappers/keyring-transaction-mapper';\nexport { mapLocalTransaction } from './mappers/local-transaction-mapper';\n\nexport type * from './types';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/client-utils",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Shared functions and utilities used across MetaMask clients (extension and mobile)",
   "keywords": [
     "Ethereum",
@@ -44,6 +44,8 @@
     "build:docs": "typedoc",
     "changelog:update": "../../scripts/update-changelog.sh @metamask/client-utils",
     "changelog:validate": "../../scripts/validate-changelog.sh @metamask/client-utils",
+    "lint:tsconfigs": "tsx ../../scripts/lint-tsconfigs/lint-tsconfigs.mts",
+    "lint:tsconfigs:fix": "tsx ../../scripts/lint-tsconfigs/lint-tsconfigs.mts --fix",
     "messenger-action-types:check": "tsx ../../packages/messenger-cli/src/cli.ts --formatter oxfmt --check",
     "messenger-action-types:generate": "tsx ../../packages/messenger-cli/src/cli.ts --formatter oxfmt --generate",
     "since-latest-release": "../../scripts/since-latest-release.sh",