@ducatjs/money 0.0.0 → 0.1.0

package/src/format.ts

@@ -0,0 +1,106 @@
+import { POW10 } from './decimal.js';
+import { toDecimal, type Money } from './money.js';
+
+const cache = new Map<string, Intl.NumberFormat>();
+// one-entry memo in front of the Map: formatting in a loop is almost always the same
+// locale/currency
+let lastLocale: string | undefined;
+let lastCurrency = '';
+let lastScale = -1;
+let lastFormatter: Intl.NumberFormat | undefined;
+
+let stringInput: boolean | undefined;
+/** ES2023 Intl.NumberFormat v3 formats decimal strings exactly; older engines convert to Number. */
+function supportsStringInput(): boolean {
+  if (stringInput === undefined) {
+    try {
+      stringInput =
+        new Intl.NumberFormat('en', { useGrouping: false }).format(
+          '9007199254740993' as unknown as number,
+        ) === '9007199254740993';
+    } catch {
+      stringInput = false;
+    }
+  }
+  return stringInput;
+}
+
+function formatter(
+  money: Money,
+  locale: string | undefined,
+  options: Intl.NumberFormatOptions | undefined,
+): Intl.NumberFormat {
+  if (
+    options === undefined &&
+    lastFormatter !== undefined &&
+    locale === lastLocale &&
+    money.currency === lastCurrency &&
+    money.scale === lastScale
+  ) {
+    return lastFormatter;
+  }
+  const key = options === undefined ? `${locale}|${money.currency}|${money.scale}` : null;
+  let numberFormat = key === null ? undefined : cache.get(key);
+  if (numberFormat === undefined) {
+    numberFormat = new Intl.NumberFormat(locale, {
+      style: 'currency',
+      currency: money.currency,
+      // ISO exponent (or the value's scale), not the engine's default digits: V8 (CLDR) shows ALL,
+      // IQD, RSD ... with 0 decimals and JSC with ISO's; we always show what the value holds.
+      minimumFractionDigits: money.scale,
+      maximumFractionDigits: money.scale,
+      ...options,
+    });
+    if (key !== null) {
+      if (cache.size > 256) {
+        cache.clear();
+      }
+      cache.set(key, numberFormat);
+    }
+  }
+  if (key !== null) {
+    lastLocale = locale;
+    lastCurrency = money.currency;
+    lastScale = money.scale;
+    lastFormatter = numberFormat;
+  }
+  return numberFormat;
+}
+
+/**
+ * Locale-aware formatting with Intl.NumberFormat (formatters are cached). The exact decimal string
+ * is passed to Intl, so amounts beyond 2^53 format exactly on engines with Intl.NumberFormat v3
+ * (Node 19+, Bun, Deno, Chrome 106+, Safari 15.4+, Firefox 116+).
+ *
+ *     format(money('1234.5', 'EUR'), 'de-DE')               // "1.234,50 €"
+ *     format(money('1234.5', 'EUR'), 'en-GB', { currencyDisplay: 'code' })
+ */
+export function format(money: Money, locale?: string, options?: Intl.NumberFormatOptions): string {
+  return formatter(money, locale, options).format(intlValue(money));
+}
+
+/**
+ * What to hand to Intl (which only accepts doubles or strings). Below 10^15 minor units the value
+ * has at most 15 significant digits, so the double nearest to it formats back to exactly the same
+ * digits. `minor / 10^scale` is a single correctly rounded IEEE division of two exactly
+ * representable integers, i.e. bit-identical to Number(toDecimal(m)) (asserted in
+ * test/format.test.ts), and 2-3x cheaper; this display hand-off is the only place a double ever
+ * touches an amount. Larger values go to Intl as the exact decimal string (Intl.NumberFormat v3).
+ */
+function intlValue(money: Money): number {
+  const minor = money.minor;
+  if (typeof minor === 'number' && minor < 1e15 && minor > -1e15 && money.scale <= 15) {
+    return minor / POW10[money.scale]!;
+  }
+  const decimal = toDecimal(money);
+  return (supportsStringInput() ? decimal : Number(decimal)) as number;
+}
+
+/** Like format(), but returns Intl parts (for styling the currency symbol separately, etc.). */
+export function formatToParts(
+  money: Money,
+  locale?: string,
+  options?: Intl.NumberFormatOptions,
+): Intl.NumberFormatPart[] {
+  return formatter(money, locale, options).formatToParts(intlValue(money));
+}

package/src/generated/adyen.ts

@@ -0,0 +1,144 @@
+// GENERATED by scripts/gen-currencies.mjs from data/adyen.json (https://docs.adyen.com/development-resources/currency-codes, retrieved 2026-11-07). Do not edit by hand.
+/* eslint-disable */
+
+/** Adyen minor-unit exponents (Adyen's table is authoritative where it differs from ISO: CLP, CVE, IDR, ISK). */
+export const ADYEN_EXPONENTS: Readonly<Record<string, number>> = {
+  AED: 2,
+  ALL: 2,
+  AMD: 2,
+  AOA: 2,
+  ARS: 2,
+  AUD: 2,
+  AWG: 2,
+  AZN: 2,
+  BAM: 2,
+  BBD: 2,
+  BDT: 2,
+  BHD: 3,
+  BMD: 2,
+  BND: 2,
+  BOB: 2,
+  BRL: 2,
+  BSD: 2,
+  BWP: 2,
+  BYN: 2,
+  BZD: 2,
+  CAD: 2,
+  CHF: 2,
+  CLP: 2,
+  CNH: 2,
+  CNY: 2,
+  COP: 2,
+  CRC: 2,
+  CUP: 2,
+  CVE: 0,
+  CZK: 2,
+  DJF: 0,
+  DKK: 2,
+  DOP: 2,
+  DZD: 2,
+  EGP: 2,
+  ETB: 2,
+  EUR: 2,
+  FJD: 2,
+  FKP: 2,
+  GBP: 2,
+  GEL: 2,
+  GHS: 2,
+  GIP: 2,
+  GMD: 2,
+  GNF: 0,
+  GTQ: 2,
+  GYD: 2,
+  HKD: 2,
+  HNL: 2,
+  HTG: 2,
+  HUF: 2,
+  IDR: 0,
+  ILS: 2,
+  INR: 2,
+  IQD: 3,
+  ISK: 2,
+  JMD: 2,
+  JOD: 3,
+  JPY: 0,
+  KES: 2,
+  KGS: 2,
+  KHR: 2,
+  KMF: 0,
+  KRW: 0,
+  KWD: 3,
+  KYD: 2,
+  KZT: 2,
+  LAK: 2,
+  LKR: 2,
+  LYD: 3,
+  MAD: 2,
+  MDL: 2,
+  MKD: 2,
+  MMK: 2,
+  MNT: 2,
+  MOP: 2,
+  MRU: 2,
+  MUR: 2,
+  MVR: 2,
+  MWK: 2,
+  MXN: 2,
+  MYR: 2,
+  MZN: 2,
+  NAD: 2,
+  NGN: 2,
+  NIO: 2,
+  NOK: 2,
+  NPR: 2,
+  NZD: 2,
+  OMR: 3,
+  PAB: 2,
+  PEN: 2,
+  PGK: 2,
+  PHP: 2,
+  PKR: 2,
+  PLN: 2,
+  PYG: 0,
+  QAR: 2,
+  RON: 2,
+  RSD: 2,
+  RUB: 2,
+  RWF: 0,
+  SAR: 2,
+  SBD: 2,
+  SCR: 2,
+  SEK: 2,
+  SGD: 2,
+  SHP: 2,
+  SLE: 2,
+  SOS: 2,
+  SRD: 2,
+  STN: 2,
+  SVC: 2,
+  SZL: 2,
+  THB: 2,
+  TND: 3,
+  TOP: 2,
+  TRY: 2,
+  TTD: 2,
+  TWD: 2,
+  TZS: 2,
+  UAH: 2,
+  UGX: 0,
+  USD: 2,
+  UYU: 2,
+  UZS: 2,
+  VEF: 2,
+  VND: 0,
+  VUV: 0,
+  WST: 2,
+  XAF: 0,
+  XCD: 2,
+  XCG: 2,
+  XOF: 0,
+  XPF: 0,
+  YER: 2,
+  ZAR: 2,
+  ZMW: 2,
+};

package/src/generated/braintree.ts

@@ -0,0 +1,140 @@
+// GENERATED by scripts/gen-currencies.mjs from data/braintree.json (https://developer.paypal.com/braintree/docs/reference/general/currencies, retrieved 2026-11-07). Do not edit by hand.
+/* eslint-disable */
+
+/** Braintree decimals per currency (`amount` is a decimal string). The zero-decimal list includes LAK (ISO 2). */
+export const BRAINTREE_EXPONENTS: Readonly<Record<string, number>> = {
+  AED: 2,
+  AMD: 2,
+  AOA: 2,
+  ARS: 2,
+  AUD: 2,
+  AWG: 2,
+  AZN: 2,
+  BAM: 2,
+  BBD: 2,
+  BDT: 2,
+  BIF: 0,
+  BMD: 2,
+  BND: 2,
+  BOB: 2,
+  BRL: 2,
+  BSD: 2,
+  BWP: 2,
+  BYN: 2,
+  BZD: 2,
+  CAD: 2,
+  CHF: 2,
+  CLP: 0,
+  CNY: 2,
+  COP: 2,
+  CRC: 2,
+  CVE: 2,
+  CZK: 2,
+  DJF: 0,
+  DKK: 2,
+  DOP: 2,
+  DZD: 2,
+  EGP: 2,
+  ETB: 2,
+  EUR: 2,
+  FJD: 2,
+  FKP: 2,
+  GBP: 2,
+  GEL: 2,
+  GHS: 2,
+  GIP: 2,
+  GMD: 2,
+  GNF: 0,
+  GTQ: 2,
+  GYD: 2,
+  HKD: 2,
+  HNL: 2,
+  HRK: 2,
+  HTG: 2,
+  HUF: 2,
+  IDR: 2,
+  ILS: 2,
+  INR: 2,
+  ISK: 0,
+  JMD: 2,
+  JPY: 0,
+  KES: 2,
+  KGS: 2,
+  KHR: 2,
+  KMF: 0,
+  KRW: 0,
+  KYD: 2,
+  KZT: 2,
+  LAK: 0,
+  LBP: 2,
+  LKR: 2,
+  LRD: 2,
+  LSL: 2,
+  LTL: 2,
+  MAD: 2,
+  MDL: 2,
+  MKD: 2,
+  MNT: 2,
+  MOP: 2,
+  MUR: 2,
+  MVR: 2,
+  MWK: 2,
+  MXN: 2,
+  MYR: 2,
+  MZN: 2,
+  NAD: 2,
+  NGN: 2,
+  NIO: 2,
+  NOK: 2,
+  NPR: 2,
+  NZD: 2,
+  PAB: 2,
+  PEN: 2,
+  PGK: 2,
+  PHP: 2,
+  PKR: 2,
+  PLN: 2,
+  PYG: 0,
+  QAR: 2,
+  RON: 2,
+  RSD: 2,
+  RUB: 2,
+  RWF: 0,
+  SAR: 2,
+  SBD: 2,
+  SCR: 2,
+  SEK: 2,
+  SGD: 2,
+  SHP: 2,
+  SLL: 2,
+  SOS: 2,
+  SRD: 2,
+  STD: 2,
+  SVC: 2,
+  SYP: 2,
+  SZL: 2,
+  THB: 2,
+  TJS: 2,
+  TOP: 2,
+  TRY: 2,
+  TTD: 2,
+  TWD: 2,
+  TZS: 2,
+  UAH: 2,
+  UGX: 0,
+  USD: 2,
+  UYU: 2,
+  UZS: 2,
+  VES: 2,
+  VND: 0,
+  VUV: 0,
+  WST: 2,
+  XAF: 0,
+  XCD: 2,
+  XOF: 0,
+  XPF: 0,
+  YER: 2,
+  ZAR: 2,
+  ZMK: 2,
+  ZWD: 2,
+};