@amboras-dev/money 0.2.0 → 0.4.0

package/dist/fx.d.cts

@@ -1,9 +1,8 @@
-import { R as DecimalText, i as Money, z as RoundingMode } from "./money-B-3aFjNJ.cjs";
-import { n as priceRoundingParams, r as roundRetail, t as RetailRounding } from "./retail-C_BPLvMj.cjs";
-import { a as RateRow, c as rate, d as rateFromRow, f as rateToDecimal, i as RateFromDecimalOptions, l as rateEquals, n as RATE_REF, o as crossRate, p as rateToNumber, r as Rate, s as invertRate, t as RATE_BOUNDS, u as rateFromDecimal } from "./rate-tqK8ijG0.cjs";
-import { i as toReporting, n as ReportingTotal, r as storeFactors, t as FactorTable } from "./reporting-CG-ai2sM.cjs";
-import { n as MoneyByCurrency } from "./medusa-4K8N1pUc.cjs";
-//#region src/fx/convert.d.ts
+import { R as DecimalText, i as Money, z as RoundingMode } from "./money-BkMeYDEW.cjs";
+import { n as priceRoundingParams, r as roundRetail, t as RetailRounding } from "./retail-CmEyJQOH.cjs";
+import { a as RateRow, c as rate, d as rateFromRow, f as rateToDecimal, i as RateFromDecimalOptions, l as rateEquals, n as RATE_REF, o as crossRate, p as rateToNumber, r as Rate, s as invertRate, t as RATE_BOUNDS, u as rateFromDecimal } from "./rate-CEakW3ia.cjs";
+import { i as toReporting, n as ReportingTotal, r as storeFactors, t as FactorTable } from "./reporting-DFNyDBdi.cjs";
+import { n as MoneyByCurrency } from "./medusa-DofdvIgQ.cjs";
 /**
  * The factor taking a stored `from` amount to a stored `to` amount for the major rate `r`
  * (1 from = r to): `{ r.n x storageScale(to), r.d x storageScale(from) }`. Replaces Medusa
@@ -31,8 +30,6 @@ export declare function convert(m: Money, to: string, r: Rate, options?: Convert
  * 150000 against USD 1000 gives 150). Both must be positive, else `rate_invalid`.
  */
 export declare function impliedRate(a: Money, b: Money): Rate;
-//#endregion
-//#region src/fx/format-rate.d.ts
 /**
  * `'1 USD = 83.42 INR'`. `decimals: 'auto'` (default) shows 4 significant digits with at
  * least 2 and at most 8 fraction digits; a number fixes them. Rounded half-up exactly, then
@@ -42,8 +39,6 @@ export declare function formatRate(r: Rate, from: string, to: string, options?:
   decimals?: 'auto' | number;
   locale?: string;
 }): string;
-//#endregion
-//#region src/fx/plausibility.d.ts
 /** Medusa PRICE_SEED_RATE_MAX_DEVIATION's default. */
 export declare const DEFAULT_RATE_MAX_DEVIATION = 2;
 /** chooseFactor's tolerance between the conventional factor and the observed median. */
@@ -106,8 +101,6 @@ export declare function rateConsensus(rates: readonly Rate[], options?: {
   median: Rate | null;
   accepted: boolean[];
 };
-//#endregion
-//#region src/fx/settings.d.ts
 export declare const RATE_MODES: readonly ["manual", "dynamic"];
 export declare const PRICE_ROUNDINGS: readonly ["none", "nearest"];
 /** `store_currency_rate.rate_mode` as readers coerce it: `'manual'` exactly, else `'dynamic'`. */
@@ -137,8 +130,6 @@ export declare function resolveMoneyByCurrency(setting: MoneyByCurrency, currenc
   money: Money;
   source: 'listed' | 'fallback';
 } | null;
-//#endregion
-//#region src/fx/tables.d.ts
 /** 1 USD = rate units of the currency, exact (see data/pegs.ts for the sources). Upper-case keys. */
 export declare const USD_PEGS: Readonly<Record<string, Rate>>;
 /** A feed's rate table with lower-case keys and only finite positive numbers kept (Medusa `lowerKeys`). Never throws. */
@@ -153,5 +144,4 @@ export declare function mergeRateTables(primary: Readonly<Record<string, number>
  * gives 1/1; anything else null.
  */
 export declare function pegFallback(from: string, to: string, ratesPerUsd: Readonly<Record<string, number>>, pegs?: Readonly<Record<string, Rate>>): Rate | null;
-//#endregion
 export { type ConvertOptions, type FactorTable, type MoneyByCurrencyFallback, RATE_BOUNDS, RATE_REF, type Rate, type RateClassification, type RateFromDecimalOptions, type RateReference, type RateRow, type ReportingTotal, type RetailRounding, crossRate, invertRate, priceRoundingParams, rate, rateEquals, rateFromDecimal, rateFromRow, rateToDecimal, rateToNumber, roundRetail, storeFactors, toReporting };

package/dist/fx.d.ts

@@ -1,9 +1,8 @@
-import { R as DecimalText, i as Money, z as RoundingMode } from "./money-B-3aFjNJ.js";
-import { n as priceRoundingParams, r as roundRetail, t as RetailRounding } from "./retail-DRUTTQoJ.js";
-import { a as RateRow, c as rate, d as rateFromRow, f as rateToDecimal, i as RateFromDecimalOptions, l as rateEquals, n as RATE_REF, o as crossRate, p as rateToNumber, r as Rate, s as invertRate, t as RATE_BOUNDS, u as rateFromDecimal } from "./rate-DBPiYgT1.js";
-import { i as toReporting, n as ReportingTotal, r as storeFactors, t as FactorTable } from "./reporting-tpGJbqYp.js";
-import { n as MoneyByCurrency } from "./medusa-DBXJXXvF.js";
-//#region src/fx/convert.d.ts
+import { R as DecimalText, i as Money, z as RoundingMode } from "./money-BkMeYDEW.js";
+import { n as priceRoundingParams, r as roundRetail, t as RetailRounding } from "./retail-B04CjW3b.js";
+import { a as RateRow, c as rate, d as rateFromRow, f as rateToDecimal, i as RateFromDecimalOptions, l as rateEquals, n as RATE_REF, o as crossRate, p as rateToNumber, r as Rate, s as invertRate, t as RATE_BOUNDS, u as rateFromDecimal } from "./rate-BvvZUdSu.js";
+import { i as toReporting, n as ReportingTotal, r as storeFactors, t as FactorTable } from "./reporting-jIBILvnr.js";
+import { n as MoneyByCurrency } from "./medusa-DrbYmD2Y.js";
 /**
  * The factor taking a stored `from` amount to a stored `to` amount for the major rate `r`
  * (1 from = r to): `{ r.n x storageScale(to), r.d x storageScale(from) }`. Replaces Medusa
@@ -31,8 +30,6 @@ export declare function convert(m: Money, to: string, r: Rate, options?: Convert
  * 150000 against USD 1000 gives 150). Both must be positive, else `rate_invalid`.
  */
 export declare function impliedRate(a: Money, b: Money): Rate;
-//#endregion
-//#region src/fx/format-rate.d.ts
 /**
  * `'1 USD = 83.42 INR'`. `decimals: 'auto'` (default) shows 4 significant digits with at
  * least 2 and at most 8 fraction digits; a number fixes them. Rounded half-up exactly, then
@@ -42,8 +39,6 @@ export declare function formatRate(r: Rate, from: string, to: string, options?:
   decimals?: 'auto' | number;
   locale?: string;
 }): string;
-//#endregion
-//#region src/fx/plausibility.d.ts
 /** Medusa PRICE_SEED_RATE_MAX_DEVIATION's default. */
 export declare const DEFAULT_RATE_MAX_DEVIATION = 2;
 /** chooseFactor's tolerance between the conventional factor and the observed median. */
@@ -106,8 +101,6 @@ export declare function rateConsensus(rates: readonly Rate[], options?: {
   median: Rate | null;
   accepted: boolean[];
 };
-//#endregion
-//#region src/fx/settings.d.ts
 export declare const RATE_MODES: readonly ["manual", "dynamic"];
 export declare const PRICE_ROUNDINGS: readonly ["none", "nearest"];
 /** `store_currency_rate.rate_mode` as readers coerce it: `'manual'` exactly, else `'dynamic'`. */
@@ -137,8 +130,6 @@ export declare function resolveMoneyByCurrency(setting: MoneyByCurrency, currenc
   money: Money;
   source: 'listed' | 'fallback';
 } | null;
-//#endregion
-//#region src/fx/tables.d.ts
 /** 1 USD = rate units of the currency, exact (see data/pegs.ts for the sources). Upper-case keys. */
 export declare const USD_PEGS: Readonly<Record<string, Rate>>;
 /** A feed's rate table with lower-case keys and only finite positive numbers kept (Medusa `lowerKeys`). Never throws. */
@@ -153,5 +144,4 @@ export declare function mergeRateTables(primary: Readonly<Record<string, number>
  * gives 1/1; anything else null.
  */
 export declare function pegFallback(from: string, to: string, ratesPerUsd: Readonly<Record<string, number>>, pegs?: Readonly<Record<string, Rate>>): Rate | null;
-//#endregion
 export { type ConvertOptions, type FactorTable, type MoneyByCurrencyFallback, RATE_BOUNDS, RATE_REF, type Rate, type RateClassification, type RateFromDecimalOptions, type RateReference, type RateRow, type ReportingTotal, type RetailRounding, crossRate, invertRate, priceRoundingParams, rate, rateEquals, rateFromDecimal, rateFromRow, rateToDecimal, rateToNumber, roundRetail, storeFactors, toReporting };

package/dist/fx.js

@@ -1,10 +1,10 @@
-import { $ as describeValue, B as decimalOf, E as resolveCurrency, J as compareRatio, M as resolveLocale, Q as MoneyError, X as mulDiv, Y as gcd, Z as ratioToDecimal, it as formatDecimal, j as numberFormat, n as fromMajor, nt as decimalFromNumber, pt as toDecimalText, s as storedDecimal, t as boundedMoney, ut as pow10, y as findCurrency } from "./money-WhnGiI00.js";
-import { t as mulDivToUnit } from "./rounding-g9rvye0k.js";
-import { t as hasOwnKey } from "./own-D7544D3k.js";
-import { r as moneyFor } from "./medusa-DqJY1qpj.js";
-import { a as invertRate, c as rateFromDecimal, d as rateToNumber, i as crossRate, l as rateFromRow, n as RATE_REF, o as rate, r as checkRate, s as rateEquals, t as RATE_BOUNDS, u as rateToDecimal } from "./rate-DicStBue.js";
-import { n as retailUnits, r as roundRetail, t as priceRoundingParams } from "./retail-1mu888J1.js";
-//#region src/fx/convert.ts
+import { $ as describeValue, B as decimalOf, E as resolveCurrency, J as compareRatio, M as resolveLocale, Q as MoneyError, X as mulDiv, Y as gcd, Z as ratioToDecimal, it as formatDecimal, j as numberFormat, n as fromMajor, nt as decimalFromNumber, pt as toDecimalText, s as storedDecimal, t as boundedMoney, ut as pow10, y as findCurrency } from "./money-BxbAw7BP.js";
+import { t as mulDivToUnit } from "./rounding-CA1PVP3b.js";
+import { t as hasOwnKey } from "./own-DHxqIYqL.js";
+import { r as moneyFor } from "./medusa-pKGlImn9.js";
+import { a as invertRate, c as rateFromDecimal, d as rateToNumber, i as crossRate, l as rateFromRow, n as RATE_REF, o as rate, r as checkRate, s as rateEquals, t as RATE_BOUNDS, u as rateToDecimal } from "./rate-D6S2_wgZ.js";
+import { n as retailUnits, r as roundRetail, t as priceRoundingParams } from "./retail-DXgs11ov.js";
+// src/fx/convert.ts
 const infoOf = (code) => resolveCurrency(code, { allowHistoric: true });
 /**
 * The factor taking a stored `from` amount to a stored `to` amount for the major rate `r`
@@ -46,8 +46,7 @@ function impliedRate(a, b) {
 		denominator: denominator / divisor
 	};
 }
-//#endregion
-//#region src/fx/format-rate.ts
+// src/fx/format-rate.ts
 /** `floor(log10(n / d))` of a positive ratio, exactly. */
 function exponentOf(n, d) {
 	let e = n.toString().length - d.toString().length;
@@ -76,8 +75,7 @@ function formatRate(r, from, to, options = {}) {
 		maximumFractionDigits: digits
 	}).format(asIntlValue(formatDecimal(value)))} ${toCode}`;
 }
-//#endregion
-//#region src/fx/plausibility.ts
+// src/fx/plausibility.ts
 /** Medusa PRICE_SEED_RATE_MAX_DEVIATION's default. */
 const DEFAULT_RATE_MAX_DEVIATION = 2;
 /** chooseFactor's tolerance between the conventional factor and the observed median. */
@@ -205,8 +203,7 @@ function rateConsensus(rates, options = {}) {
 		})
 	};
 }
-//#endregion
-//#region src/fx/reporting.ts
+// src/fx/reporting.ts
 const FACTOR_DIGITS = 20;
 /**
 * The reporting factors of a store whose locked rates say `1 default = n/d <code>`:
@@ -259,8 +256,7 @@ function toReporting(items, table) {
 		missing: [...missing].sort()
 	};
 }
-//#endregion
-//#region src/fx/settings.ts
+// src/fx/settings.ts
 const RATE_MODES = ["manual", "dynamic"];
 const PRICE_ROUNDINGS = ["none", "nearest"];
 /** `store_currency_rate.rate_mode` as readers coerce it: `'manual'` exactly, else `'dynamic'`. */
@@ -298,8 +294,7 @@ function resolveMoneyByCurrency(setting, currency, options) {
 	}
 	return null;
 }
-//#endregion
-//#region src/fx/tables.ts
+// src/fx/tables.ts
 /** 1 USD = rate units of the currency, exact (see data/pegs.ts for the sources). Upper-case keys. */
 const USD_PEGS = Object.freeze(Object.fromEntries(Object.entries({
 	AED: [36725n, 10000n],
@@ -370,5 +365,4 @@ function pegFallback(from, to, ratesPerUsd, pegs = USD_PEGS) {
 	const fromPeg = own(pegs, f);
 	return fromPeg !== void 0 && t === "USD" ? invertRate(fromPeg) : null;
 }
-//#endregion
 export { DEFAULT_RATE_MAX_DEVIATION, FACTOR_TOLERANCE, PRICE_ROUNDINGS, RATE_BOUNDS, RATE_MODES, RATE_REF, USD_PEGS, classifyRate, confirmStoredFactor, convert, convertFactor, crossRate, deviationFactor, formatRate, impliedRate, invertRate, mergeRateTables, parsePriceRounding, parseRateMode, pegFallback, priceRoundingParams, rate, rateConsensus, rateEquals, rateFromDecimal, rateFromRow, rateToDecimal, rateToNumber, resolveMoneyByCurrency, roundRetail, sanitizeRateTable, storeFactors, toReporting };

package/dist/index.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_money = require("./money-B3wH_Z4S.cjs");
-const require_rounding = require("./rounding-DHBtNCHG.cjs");
-const require_allocate = require("./allocate-CZRg4TOP.cjs");
-const require_arithmetic = require("./arithmetic-DjT4Kzgt.cjs");
-const require_own = require("./own-oP9DXFWv.cjs");
-const require_format = require("./format-DLhno7eX.cjs");
-const require_iso_minor = require("./iso-minor-wSwJN57T.cjs");
-const require_medusa = require("./medusa-lRY9xlsf.cjs");
-//#region src/data/countries.ts
+const require_money = require("./money-DWBjuuEK.cjs");
+const require_rounding = require("./rounding-4QKTRbMQ.cjs");
+const require_allocate = require("./allocate-AusholrC.cjs");
+const require_arithmetic = require("./arithmetic-D8A6IeZ0.cjs");
+const require_own = require("./own-C5imDkyB.cjs");
+const require_format = require("./format-92fzvTXY.cjs");
+const require_iso_minor = require("./iso-minor-DyNjT9A1.cjs");
+const require_medusa = require("./medusa-CzVK0bth.cjs");
+// src/data/countries.ts
 const COUNTRY_CURRENCY = {
 	AC: "SHP",
 	AD: "EUR",
@@ -265,15 +265,13 @@ const COUNTRY_CURRENCY = {
 	ZM: "ZMW",
 	ZW: "ZWG"
 };
-//#endregion
-//#region src/country.ts
+// src/country.ts
 /** The current legal tender of an ISO 3166 country (`'US'` or `'us'`), or null when unknown. Never guesses USD. */
 function defaultCurrencyForCountry(country) {
 	if (typeof country !== "string") return null;
 	const key = country.toUpperCase();
 	return require_own.hasOwnKey(COUNTRY_CURRENCY, key) ? COUNTRY_CURRENCY[key] : null;
 }
-//#endregion
 exports.CURRENCIES = require_money.CURRENCIES;
 exports.MoneyError = require_money.MoneyError;
 exports.add = require_arithmetic.add;

package/dist/index.d.cts

@@ -1,6 +1,5 @@
-import { A as isCurrencyCode, C as currencyInfo, D as currencySymbol, E as currencyOptions, F as sameCurrency, I as storageDigits, L as storageScale, M as medusaCurrencyCode, N as medusaEpsilon, O as displayDigits, P as parseCurrencyCode, R as DecimalText, S as currencyCode, T as currencyName, _ as CurrencyCodeOptions, a as ReadStoredOptions, b as FractionDigits, c as ToMajorDecimalOptions, d as money, f as readStored, g as CurrencyCode, h as CURRENCIES, i as Money, j as localeForCurrency, k as firstCurrency, l as fromMajor, m as toMajorNumber, n as FromMajorOptions, o as StoredAmount, p as toMajorDecimal, r as MajorDecimal, s as StoredAmountOptions, t as FractionalMoney, u as isStoredAmount, v as CurrencyInfo, w as currencyLabel, x as StorageScale, y as CurrencyStatus, z as RoundingMode } from "./money-B-3aFjNJ.cjs";
-import { a as isPositiveAmount, c as readCalculatedPrice, d as readStoredLiteral, f as toMedusaAmountInput, i as ReadStoredDecimalOptions, l as readStoredDecimal, n as MoneyByCurrency, o as moneyByCurrency, p as toMedusaRaw, r as PriceLike, s as moneyFor, t as MedusaRaw, u as readStoredField } from "./medusa-4K8N1pUc.cjs";
-//#region src/allocate.d.ts
+import { A as isCurrencyCode, C as currencyInfo, D as currencySymbol, E as currencyOptions, F as sameCurrency, I as storageDigits, L as storageScale, M as medusaCurrencyCode, N as medusaEpsilon, O as displayDigits, P as parseCurrencyCode, R as DecimalText, S as currencyCode, T as currencyName, _ as CurrencyCodeOptions, a as ReadStoredOptions, b as FractionDigits, c as ToMajorDecimalOptions, d as money, f as readStored, g as CurrencyCode, h as CURRENCIES, i as Money, j as localeForCurrency, k as firstCurrency, l as fromMajor, m as toMajorNumber, n as FromMajorOptions, o as StoredAmount, p as toMajorDecimal, r as MajorDecimal, s as StoredAmountOptions, t as FractionalMoney, u as isStoredAmount, v as CurrencyInfo, w as currencyLabel, x as StorageScale, y as CurrencyStatus, z as RoundingMode } from "./money-BkMeYDEW.cjs";
+import { a as isPositiveAmount, c as readCalculatedPrice, d as readStoredLiteral, f as toMedusaAmountInput, i as ReadStoredDecimalOptions, l as readStoredDecimal, n as MoneyByCurrency, o as moneyByCurrency, p as toMedusaRaw, r as PriceLike, s as moneyFor, t as MedusaRaw, u as readStoredField } from "./medusa-DofdvIgQ.cjs";
 /**
  * Where the rounding remainder goes:
  * - `'largest-remainder'` (default; promotion parity engine): floor every share, then +1 unit
@@ -67,8 +66,6 @@ interface UnitPricePart {
 export declare function splitUnitPrice(net: Money, quantity: number, options?: {
   unit?: 'storage' | 'currency';
 }): UnitPricePart[];
-//#endregion
-//#region src/rounding.d.ts
 /**
  * - `'storage'`: one storage unit (USD 1 cent, JPY 1/100 yen).
  * - `'currency'`: the smallest unit the currency stores, 10^-storageDigits major (JPY 1 yen
@@ -99,8 +96,6 @@ export declare function roundMajor(major: number | DecimalText, currency: string
   digits?: 'display' | 'storage';
   rounding?: RoundingMode;
 }): number;
-//#endregion
-//#region src/arithmetic.d.ts
 /** An exact ratio of integers (`{ numerator: 1, denominator: 3 }`). */
 interface Ratio {
   readonly numerator: number | bigint;
@@ -145,12 +140,8 @@ export declare function within(a: Money, b: Money, tolerance: Money, options?: {
 }): boolean;
 /** `d = a - b`; `d` below `tolerance` counts as rounding and gives 0, else `d` (Stripe `refundSyncDelta`). */
 export declare function excessOver(a: Money, b: Money, tolerance: Money): Money;
-//#endregion
-//#region src/country.d.ts
 /** The current legal tender of an ISO 3166 country (`'US'` or `'us'`), or null when unknown. Never guesses USD. */
 export declare function defaultCurrencyForCountry(country: string): CurrencyCode | null;
-//#endregion
-//#region src/decimal-text.d.ts
 /** Anything the family takes as a value. */
 type DecimalInput = DecimalText | string | number | bigint;
 /** Canonical DecimalText of `input` (`'4300.00'` gives `'4300'`, `0.1 + 0.2` gives `'0.30000000000000004'`). See `decimalOf` for what is refused. */
@@ -205,8 +196,6 @@ export declare function decimalClamp(a: DecimalText | string, bounds: {
 export declare function decimalWithin(a: DecimalText | string, b: DecimalText | string, tolerance: DecimalText | string, options?: {
   inclusive?: boolean;
 }): boolean;
-//#endregion
-//#region src/errors.d.ts
 /**
  * Why a money operation refused its input:
  * - `currency_invalid`: not a currency this package knows (or a retired one where only active codes are allowed)
@@ -231,8 +220,6 @@ export declare class MoneyError extends Error {
   readonly field?: string;
   constructor(code: MoneyErrorCode, message: string, options?: MoneyErrorOptions);
 }
-//#endregion
-//#region src/format.d.ts
 interface FormatMoneyOptions {
   /** Default `'en-US'`; an unsupported or malformed tag falls back to it. */
   locale?: string;
@@ -248,16 +235,26 @@ interface FormatMoneyOptions {
   signDisplay?: 'auto' | 'always' | 'exceptZero';
   /** Default `'-'`; `'−'` (U+2212) replaces the leading ASCII minus. */
   minusSign?: '-' | '−';
+  /**
+   * How the amount is rounded to the digits shown: `'half-up'` (default) or `'down'` (toward
+   * zero), for an upper bound that must not read above itself: a refund cap of HUF 435050
+   * (4,350.50) shows `'HUF 4,350'` with `'down'`, never 4,351. `formatStored` rounds a fractional
+   * amount to a storage unit the same way first.
+   */
+  rounding?: DisplayRounding;
 }
+/** The roundings `formatMoney` and `formatStored` take. */
+type DisplayRounding = Extract<RoundingMode, 'half-up' | 'down'>;
 /**
  * Money for people: `'$1,234.50'`, `'¥1,200'`, `'KWD 1.005'`, `'-€5.00'`. Locale, currency
- * display, digits and sign are explicit options; the active app locale is the caller's to
- * pass. If Intl throws, `'<CODE> <decimal>'`.
+ * display, digits, sign and rounding (half-up by default, `'down'` for caps) are explicit
+ * options; the active app locale is the caller's to pass. If Intl throws, `'<CODE> <decimal>'`.
  */
 export declare function formatMoney(m: Money, options?: FormatMoneyOptions): string;
 /**
  * A stored amount that may be fractional (a Medusa total, 107.8175; a percentage promotion) for
- * people: rounded half-up to a whole storage unit (`roundToUnit`), then `formatMoney` with `options`.
+ * people: rounded to a whole storage unit by `options.rounding` (`roundToUnit`; half-up by default,
+ * `'down'` toward zero for a cap), then `formatMoney` with `options`.
  * A number must be finite; text is plain decimal; an unknown currency throws `currency_invalid`.
  */
 export declare function formatStored(amount: number | DecimalText, currency: string, options?: FormatMoneyOptions): string;
@@ -265,7 +262,7 @@ export declare function formatStored(amount: number | DecimalText, currency: str
  * Like `formatMoney` below `threshold` major units (default 10000, by magnitude); at or above
  * it, compact short notation with `maximumSignificantDigits` (default 3): `'$12.3K'`.
  */
-export declare function formatMoneyCompact(m: Money, options?: FormatMoneyOptions & {
+export declare function formatMoneyCompact(m: Money, options?: Omit<FormatMoneyOptions, 'rounding'> & {
   threshold?: number;
   maximumSignificantDigits?: number;
 }): string;
@@ -278,8 +275,6 @@ export declare function formatMoneyRange(low: Money, high: Money | null, options
  * same rounding as `formatMoneyCompact` (`1234567` gives `'$1.23M'`).
  */
 export declare function moneyAxisFormatter(currency: string, options?: Pick<FormatMoneyOptions, 'locale' | 'currencyDisplay'>): (major: number) => string;
-//#endregion
-//#region src/iso-minor.d.ts
 /**
  * ISO minor units at the display digits: `round(major x 10^displayDigits)` with `rounding`
  * (default half-up). JPY 150000 gives 1500, KWD 1005 gives 1005, IQD 10000 gives 10, HUF
@@ -296,5 +291,4 @@ export declare function toIsoMinor(m: Money, options?: {
 export declare function fromIsoMinor(value: number | string, currency: string, options?: {
   digits?: FractionDigits;
 }): Money;
-//#endregion
-export { type AllocateOptions, type AllocationStrategy, type AllocationWeight, type AmountUnit, CURRENCIES, type CurrencyCode, type CurrencyCodeOptions, type CurrencyInfo, type CurrencyStatus, type DecimalInput, type DecimalText, type FormatMoneyOptions, type FractionDigits, type FractionalMoney, type FromMajorOptions, type MajorDecimal, type MedusaRaw, type Money, type MoneyByCurrency, type MoneyErrorCode, type MoneyErrorOptions, type PriceLike, type Ratio, type ReadStoredDecimalOptions, type ReadStoredOptions, type RoundToUnitOptions, type RoundingMode, type StorageScale, type StoredAmount, type StoredAmountOptions, type ToMajorDecimalOptions, type UnitPricePart, type WaterfallResult, currencyCode, currencyInfo, currencyLabel, currencyName, currencyOptions, currencySymbol, displayDigits, firstCurrency, fromMajor, isCurrencyCode, isPositiveAmount, isStoredAmount, localeForCurrency, medusaCurrencyCode, medusaEpsilon, money, moneyByCurrency, moneyFor, parseCurrencyCode, readCalculatedPrice, readStored, readStoredDecimal, readStoredField, readStoredLiteral, sameCurrency, storageDigits, storageScale, toMajorDecimal, toMajorNumber, toMedusaAmountInput, toMedusaRaw };
+export { type AllocateOptions, type AllocationStrategy, type AllocationWeight, type AmountUnit, CURRENCIES, type CurrencyCode, type CurrencyCodeOptions, type CurrencyInfo, type CurrencyStatus, type DecimalInput, type DecimalText, type DisplayRounding, type FormatMoneyOptions, type FractionDigits, type FractionalMoney, type FromMajorOptions, type MajorDecimal, type MedusaRaw, type Money, type MoneyByCurrency, type MoneyErrorCode, type MoneyErrorOptions, type PriceLike, type Ratio, type ReadStoredDecimalOptions, type ReadStoredOptions, type RoundToUnitOptions, type RoundingMode, type StorageScale, type StoredAmount, type StoredAmountOptions, type ToMajorDecimalOptions, type UnitPricePart, type WaterfallResult, currencyCode, currencyInfo, currencyLabel, currencyName, currencyOptions, currencySymbol, displayDigits, firstCurrency, fromMajor, isCurrencyCode, isPositiveAmount, isStoredAmount, localeForCurrency, medusaCurrencyCode, medusaEpsilon, money, moneyByCurrency, moneyFor, parseCurrencyCode, readCalculatedPrice, readStored, readStoredDecimal, readStoredField, readStoredLiteral, sameCurrency, storageDigits, storageScale, toMajorDecimal, toMajorNumber, toMedusaAmountInput, toMedusaRaw };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { A as isCurrencyCode, C as currencyInfo, D as currencySymbol, E as currencyOptions, F as sameCurrency, I as storageDigits, L as storageScale, M as medusaCurrencyCode, N as medusaEpsilon, O as displayDigits, P as parseCurrencyCode, R as DecimalText, S as currencyCode, T as currencyName, _ as CurrencyCodeOptions, a as ReadStoredOptions, b as FractionDigits, c as ToMajorDecimalOptions, d as money, f as readStored, g as CurrencyCode, h as CURRENCIES, i as Money, j as localeForCurrency, k as firstCurrency, l as fromMajor, m as toMajorNumber, n as FromMajorOptions, o as StoredAmount, p as toMajorDecimal, r as MajorDecimal, s as StoredAmountOptions, t as FractionalMoney, u as isStoredAmount, v as CurrencyInfo, w as currencyLabel, x as StorageScale, y as CurrencyStatus, z as RoundingMode } from "./money-B-3aFjNJ.js";
-import { a as isPositiveAmount, c as readCalculatedPrice, d as readStoredLiteral, f as toMedusaAmountInput, i as ReadStoredDecimalOptions, l as readStoredDecimal, n as MoneyByCurrency, o as moneyByCurrency, p as toMedusaRaw, r as PriceLike, s as moneyFor, t as MedusaRaw, u as readStoredField } from "./medusa-DBXJXXvF.js";
-//#region src/allocate.d.ts
+import { A as isCurrencyCode, C as currencyInfo, D as currencySymbol, E as currencyOptions, F as sameCurrency, I as storageDigits, L as storageScale, M as medusaCurrencyCode, N as medusaEpsilon, O as displayDigits, P as parseCurrencyCode, R as DecimalText, S as currencyCode, T as currencyName, _ as CurrencyCodeOptions, a as ReadStoredOptions, b as FractionDigits, c as ToMajorDecimalOptions, d as money, f as readStored, g as CurrencyCode, h as CURRENCIES, i as Money, j as localeForCurrency, k as firstCurrency, l as fromMajor, m as toMajorNumber, n as FromMajorOptions, o as StoredAmount, p as toMajorDecimal, r as MajorDecimal, s as StoredAmountOptions, t as FractionalMoney, u as isStoredAmount, v as CurrencyInfo, w as currencyLabel, x as StorageScale, y as CurrencyStatus, z as RoundingMode } from "./money-BkMeYDEW.js";
+import { a as isPositiveAmount, c as readCalculatedPrice, d as readStoredLiteral, f as toMedusaAmountInput, i as ReadStoredDecimalOptions, l as readStoredDecimal, n as MoneyByCurrency, o as moneyByCurrency, p as toMedusaRaw, r as PriceLike, s as moneyFor, t as MedusaRaw, u as readStoredField } from "./medusa-DrbYmD2Y.js";
 /**
  * Where the rounding remainder goes:
  * - `'largest-remainder'` (default; promotion parity engine): floor every share, then +1 unit
@@ -67,8 +66,6 @@ interface UnitPricePart {
 export declare function splitUnitPrice(net: Money, quantity: number, options?: {
   unit?: 'storage' | 'currency';
 }): UnitPricePart[];
-//#endregion
-//#region src/rounding.d.ts
 /**
  * - `'storage'`: one storage unit (USD 1 cent, JPY 1/100 yen).
  * - `'currency'`: the smallest unit the currency stores, 10^-storageDigits major (JPY 1 yen
@@ -99,8 +96,6 @@ export declare function roundMajor(major: number | DecimalText, currency: string
   digits?: 'display' | 'storage';
   rounding?: RoundingMode;
 }): number;
-//#endregion
-//#region src/arithmetic.d.ts
 /** An exact ratio of integers (`{ numerator: 1, denominator: 3 }`). */
 interface Ratio {
   readonly numerator: number | bigint;
@@ -145,12 +140,8 @@ export declare function within(a: Money, b: Money, tolerance: Money, options?: {
 }): boolean;
 /** `d = a - b`; `d` below `tolerance` counts as rounding and gives 0, else `d` (Stripe `refundSyncDelta`). */
 export declare function excessOver(a: Money, b: Money, tolerance: Money): Money;
-//#endregion
-//#region src/country.d.ts
 /** The current legal tender of an ISO 3166 country (`'US'` or `'us'`), or null when unknown. Never guesses USD. */
 export declare function defaultCurrencyForCountry(country: string): CurrencyCode | null;
-//#endregion
-//#region src/decimal-text.d.ts
 /** Anything the family takes as a value. */
 type DecimalInput = DecimalText | string | number | bigint;
 /** Canonical DecimalText of `input` (`'4300.00'` gives `'4300'`, `0.1 + 0.2` gives `'0.30000000000000004'`). See `decimalOf` for what is refused. */
@@ -205,8 +196,6 @@ export declare function decimalClamp(a: DecimalText | string, bounds: {
 export declare function decimalWithin(a: DecimalText | string, b: DecimalText | string, tolerance: DecimalText | string, options?: {
   inclusive?: boolean;
 }): boolean;
-//#endregion
-//#region src/errors.d.ts
 /**
  * Why a money operation refused its input:
  * - `currency_invalid`: not a currency this package knows (or a retired one where only active codes are allowed)
@@ -231,8 +220,6 @@ export declare class MoneyError extends Error {
   readonly field?: string;
   constructor(code: MoneyErrorCode, message: string, options?: MoneyErrorOptions);
 }
-//#endregion
-//#region src/format.d.ts
 interface FormatMoneyOptions {
   /** Default `'en-US'`; an unsupported or malformed tag falls back to it. */
   locale?: string;
@@ -248,16 +235,26 @@ interface FormatMoneyOptions {
   signDisplay?: 'auto' | 'always' | 'exceptZero';
   /** Default `'-'`; `'−'` (U+2212) replaces the leading ASCII minus. */
   minusSign?: '-' | '−';
+  /**
+   * How the amount is rounded to the digits shown: `'half-up'` (default) or `'down'` (toward
+   * zero), for an upper bound that must not read above itself: a refund cap of HUF 435050
+   * (4,350.50) shows `'HUF 4,350'` with `'down'`, never 4,351. `formatStored` rounds a fractional
+   * amount to a storage unit the same way first.
+   */
+  rounding?: DisplayRounding;
 }
+/** The roundings `formatMoney` and `formatStored` take. */
+type DisplayRounding = Extract<RoundingMode, 'half-up' | 'down'>;
 /**
  * Money for people: `'$1,234.50'`, `'¥1,200'`, `'KWD 1.005'`, `'-€5.00'`. Locale, currency
- * display, digits and sign are explicit options; the active app locale is the caller's to
- * pass. If Intl throws, `'<CODE> <decimal>'`.
+ * display, digits, sign and rounding (half-up by default, `'down'` for caps) are explicit
+ * options; the active app locale is the caller's to pass. If Intl throws, `'<CODE> <decimal>'`.
  */
 export declare function formatMoney(m: Money, options?: FormatMoneyOptions): string;
 /**
  * A stored amount that may be fractional (a Medusa total, 107.8175; a percentage promotion) for
- * people: rounded half-up to a whole storage unit (`roundToUnit`), then `formatMoney` with `options`.
+ * people: rounded to a whole storage unit by `options.rounding` (`roundToUnit`; half-up by default,
+ * `'down'` toward zero for a cap), then `formatMoney` with `options`.
  * A number must be finite; text is plain decimal; an unknown currency throws `currency_invalid`.
  */
 export declare function formatStored(amount: number | DecimalText, currency: string, options?: FormatMoneyOptions): string;
@@ -265,7 +262,7 @@ export declare function formatStored(amount: number | DecimalText, currency: str
  * Like `formatMoney` below `threshold` major units (default 10000, by magnitude); at or above
  * it, compact short notation with `maximumSignificantDigits` (default 3): `'$12.3K'`.
  */
-export declare function formatMoneyCompact(m: Money, options?: FormatMoneyOptions & {
+export declare function formatMoneyCompact(m: Money, options?: Omit<FormatMoneyOptions, 'rounding'> & {
   threshold?: number;
   maximumSignificantDigits?: number;
 }): string;
@@ -278,8 +275,6 @@ export declare function formatMoneyRange(low: Money, high: Money | null, options
  * same rounding as `formatMoneyCompact` (`1234567` gives `'$1.23M'`).
  */
 export declare function moneyAxisFormatter(currency: string, options?: Pick<FormatMoneyOptions, 'locale' | 'currencyDisplay'>): (major: number) => string;
-//#endregion
-//#region src/iso-minor.d.ts
 /**
  * ISO minor units at the display digits: `round(major x 10^displayDigits)` with `rounding`
  * (default half-up). JPY 150000 gives 1500, KWD 1005 gives 1005, IQD 10000 gives 10, HUF
@@ -296,5 +291,4 @@ export declare function toIsoMinor(m: Money, options?: {
 export declare function fromIsoMinor(value: number | string, currency: string, options?: {
   digits?: FractionDigits;
 }): Money;
-//#endregion
-export { type AllocateOptions, type AllocationStrategy, type AllocationWeight, type AmountUnit, CURRENCIES, type CurrencyCode, type CurrencyCodeOptions, type CurrencyInfo, type CurrencyStatus, type DecimalInput, type DecimalText, type FormatMoneyOptions, type FractionDigits, type FractionalMoney, type FromMajorOptions, type MajorDecimal, type MedusaRaw, type Money, type MoneyByCurrency, type MoneyErrorCode, type MoneyErrorOptions, type PriceLike, type Ratio, type ReadStoredDecimalOptions, type ReadStoredOptions, type RoundToUnitOptions, type RoundingMode, type StorageScale, type StoredAmount, type StoredAmountOptions, type ToMajorDecimalOptions, type UnitPricePart, type WaterfallResult, currencyCode, currencyInfo, currencyLabel, currencyName, currencyOptions, currencySymbol, displayDigits, firstCurrency, fromMajor, isCurrencyCode, isPositiveAmount, isStoredAmount, localeForCurrency, medusaCurrencyCode, medusaEpsilon, money, moneyByCurrency, moneyFor, parseCurrencyCode, readCalculatedPrice, readStored, readStoredDecimal, readStoredField, readStoredLiteral, sameCurrency, storageDigits, storageScale, toMajorDecimal, toMajorNumber, toMedusaAmountInput, toMedusaRaw };
+export { type AllocateOptions, type AllocationStrategy, type AllocationWeight, type AmountUnit, CURRENCIES, type CurrencyCode, type CurrencyCodeOptions, type CurrencyInfo, type CurrencyStatus, type DecimalInput, type DecimalText, type DisplayRounding, type FormatMoneyOptions, type FractionDigits, type FractionalMoney, type FromMajorOptions, type MajorDecimal, type MedusaRaw, type Money, type MoneyByCurrency, type MoneyErrorCode, type MoneyErrorOptions, type PriceLike, type Ratio, type ReadStoredDecimalOptions, type ReadStoredOptions, type RoundToUnitOptions, type RoundingMode, type StorageScale, type StoredAmount, type StoredAmountOptions, type ToMajorDecimalOptions, type UnitPricePart, type WaterfallResult, currencyCode, currencyInfo, currencyLabel, currencyName, currencyOptions, currencySymbol, displayDigits, firstCurrency, fromMajor, isCurrencyCode, isPositiveAmount, isStoredAmount, localeForCurrency, medusaCurrencyCode, medusaEpsilon, money, moneyByCurrency, moneyFor, parseCurrencyCode, readCalculatedPrice, readStored, readStoredDecimal, readStoredField, readStoredLiteral, sameCurrency, storageDigits, storageScale, toMajorDecimal, toMajorNumber, toMedusaAmountInput, toMedusaRaw };

package/dist/index.js

@@ -1,12 +1,12 @@
-import { A as storageScale, C as medusaCurrencyCode, D as sameCurrency, F as decimalClamp, G as isDecimalLiteral, H as decimalSubtract, I as decimalCompare, K as parseDecimalText, L as decimalDivide, O as storageDigits, P as assertDecimalLiteral, Q as MoneyError, R as decimalEquals, S as localeForCurrency, T as parseCurrencyCode, U as decimalSum, V as decimalRound, W as decimalWithin, _ as currencySymbol, a as money, b as firstCurrency, c as toMajorDecimal, d as currencyCode, f as currencyInfo, g as currencyOptions, h as currencyName, l as toMajorNumber, n as fromMajor, o as readStored, p as currencyLabel, q as trimDecimalZeros, r as isStoredAmount, u as CURRENCIES, v as displayDigits, w as medusaEpsilon, x as isCurrencyCode, z as decimalMultiply } from "./money-WhnGiI00.js";
-import { i as roundToUnit, n as roundMajor } from "./rounding-g9rvye0k.js";
-import { i as splitUnitPrice, r as allocateWaterfall, t as allocate } from "./allocate-X7_jAtOj.js";
-import { _ as within, a as equals, c as isPositive, d as min, f as multiply, g as sum, h as subtract, i as divide, l as isZero, m as remaining, n as clamp, o as excessOver, p as percentOf, r as compare, s as isNegative, t as add, u as max } from "./arithmetic-BhNwisjb.js";
-import { t as hasOwnKey } from "./own-D7544D3k.js";
-import { a as moneyAxisFormatter, i as formatStored, n as formatMoneyCompact, r as formatMoneyRange, t as formatMoney } from "./format-BdPnijvn.js";
-import { r as toIsoMinor, t as fromIsoMinor } from "./iso-minor-CqkWDxHS.js";
-import { a as readStoredDecimal, i as readCalculatedPrice, l as toMedusaAmountInput, n as moneyByCurrency, o as readStoredField, r as moneyFor, s as readStoredLiteral, t as isPositiveAmount, u as toMedusaRaw } from "./medusa-DqJY1qpj.js";
-//#region src/data/countries.ts
+import { A as storageScale, C as medusaCurrencyCode, D as sameCurrency, F as decimalClamp, G as isDecimalLiteral, H as decimalSubtract, I as decimalCompare, K as parseDecimalText, L as decimalDivide, O as storageDigits, P as assertDecimalLiteral, Q as MoneyError, R as decimalEquals, S as localeForCurrency, T as parseCurrencyCode, U as decimalSum, V as decimalRound, W as decimalWithin, _ as currencySymbol, a as money, b as firstCurrency, c as toMajorDecimal, d as currencyCode, f as currencyInfo, g as currencyOptions, h as currencyName, l as toMajorNumber, n as fromMajor, o as readStored, p as currencyLabel, q as trimDecimalZeros, r as isStoredAmount, u as CURRENCIES, v as displayDigits, w as medusaEpsilon, x as isCurrencyCode, z as decimalMultiply } from "./money-BxbAw7BP.js";
+import { i as roundToUnit, n as roundMajor } from "./rounding-CA1PVP3b.js";
+import { i as splitUnitPrice, r as allocateWaterfall, t as allocate } from "./allocate-BBRfdaSC.js";
+import { _ as within, a as equals, c as isPositive, d as min, f as multiply, g as sum, h as subtract, i as divide, l as isZero, m as remaining, n as clamp, o as excessOver, p as percentOf, r as compare, s as isNegative, t as add, u as max } from "./arithmetic-C97-YafD.js";
+import { t as hasOwnKey } from "./own-DHxqIYqL.js";
+import { a as moneyAxisFormatter, i as formatStored, n as formatMoneyCompact, r as formatMoneyRange, t as formatMoney } from "./format-BJC513u4.js";
+import { r as toIsoMinor, t as fromIsoMinor } from "./iso-minor-odkY-e6I.js";
+import { a as readStoredDecimal, i as readCalculatedPrice, l as toMedusaAmountInput, n as moneyByCurrency, o as readStoredField, r as moneyFor, s as readStoredLiteral, t as isPositiveAmount, u as toMedusaRaw } from "./medusa-pKGlImn9.js";
+// src/data/countries.ts
 const COUNTRY_CURRENCY = {
 	AC: "SHP",
 	AD: "EUR",
@@ -264,13 +264,11 @@ const COUNTRY_CURRENCY = {
 	ZM: "ZMW",
 	ZW: "ZWG"
 };
-//#endregion
-//#region src/country.ts
+// src/country.ts
 /** The current legal tender of an ISO 3166 country (`'US'` or `'us'`), or null when unknown. Never guesses USD. */
 function defaultCurrencyForCountry(country) {
 	if (typeof country !== "string") return null;
 	const key = country.toUpperCase();
 	return hasOwnKey(COUNTRY_CURRENCY, key) ? COUNTRY_CURRENCY[key] : null;
 }
-//#endregion
 export { CURRENCIES, MoneyError, add, allocate, allocateWaterfall, assertDecimalLiteral, clamp, compare, currencyCode, currencyInfo, currencyLabel, currencyName, currencyOptions, currencySymbol, decimalClamp, decimalCompare, decimalDivide, decimalEquals, decimalMultiply, decimalRound, decimalSubtract, decimalSum, decimalWithin, defaultCurrencyForCountry, displayDigits, divide, equals, excessOver, firstCurrency, formatMoney, formatMoneyCompact, formatMoneyRange, formatStored, fromIsoMinor, fromMajor, isCurrencyCode, isDecimalLiteral, isNegative, isPositive, isPositiveAmount, isStoredAmount, isZero, localeForCurrency, max, medusaCurrencyCode, medusaEpsilon, min, money, moneyAxisFormatter, moneyByCurrency, moneyFor, multiply, parseCurrencyCode, parseDecimalText, percentOf, readCalculatedPrice, readStored, readStoredDecimal, readStoredField, readStoredLiteral, remaining, roundMajor, roundToUnit, sameCurrency, splitUnitPrice, storageDigits, storageScale, subtract, sum, toIsoMinor, toMajorDecimal, toMajorNumber, toMedusaAmountInput, toMedusaRaw, trimDecimalZeros, within };

package/dist/input.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_money = require("./money-B3wH_Z4S.cjs");
-const require_number_text = require("./number-text-BWu67jUq.cjs");
-const require_rate = require("./rate-CVeMii4a.cjs");
-const require_amount = require("./amount-BV0O-aN8.cjs");
-//#region src/input/import.ts
+const require_money = require("./money-DWBjuuEK.cjs");
+const require_number_text = require("./number-text-CWuVwrlg.cjs");
+const require_rate = require("./rate-CEjWTATc.cjs");
+const require_amount = require("./amount-Bzxw9aD4.cjs");
+// src/input/import.ts
 /**
 * Amount text from a file or a third party to canonical DecimalText (major units, exactly as
 * written: `'1.299,00'` gives `'1299'`), or null when it is not an amount (empty, exponent,
@@ -53,8 +53,7 @@ function parseDecimalInput(text, options) {
 		value: require_money.toDecimalText(value)
 	};
 }
-//#endregion
-//#region src/input/percent-rate.ts
+// src/input/percent-rate.ts
 /**
 * A typed percent (`'20'`, `'12.5'`, `'12,5 %'` in de-DE) as DecimalText. A `%` before or after
 * the number is allowed. Default range 0..100 with 2 decimals; below 0 (with a non-negative
@@ -103,8 +102,7 @@ function parseRateInput(text, options = {}) {
 		throw error;
 	}
 }
-//#endregion
-//#region src/input/template.ts
+// src/input/template.ts
 const DEFAULT_TEMPLATE = Object.freeze({
 	prefix: "",
 	suffix: "",
@@ -150,7 +148,6 @@ function formatWithTemplate(m, template) {
 	const tail = fraction === void 0 ? "" : `${template.decimalSeparator}${fraction}`;
 	return `${template.prefix}${negative ? "-" : ""}${grouped}${tail}${template.suffix}`;
 }
-//#endregion
 exports.formatAmountInput = require_amount.formatAmountInput;
 exports.formatWithTemplate = formatWithTemplate;
 exports.inputPlaceholder = require_amount.inputPlaceholder;