@ducatjs/money 0.0.0 → 0.1.0

package/dist/decimal.js

@@ -0,0 +1,251 @@
+// Exact decimal-string handling. No floating point is used on amounts: numbers given as factors are
+// converted through their shortest round-trip decimal representation (String(x)), never multiplied.
+/** The largest minor-unit count held as a number (2^53 - 1); larger values are bigints. */
+const MAX_SAFE_MINOR = Number.MAX_SAFE_INTEGER;
+const MAXN = BigInt(MAX_SAFE_MINOR);
+const POW10N = [];
+/** 10^exponent as a bigint, cached. */
+export function pow10n(exponent) {
+    return (POW10N[exponent] ??= 10n ** BigInt(exponent));
+}
+/** 10^e as a number for 0 <= e <= 15 (all exact and safe). */
+export const POW10 = [
+    1, 10, 100, 1e3, 1e4, 1e5, 1e6, 1e7, 1e8, 1e9, 1e10, 1e11, 1e12, 1e13, 1e14, 1e15,
+];
+/**
+ * A bigint as a number when it is a safe integer, else unchanged: the representation Money keeps.
+ */
+export const normalizeMinor = (value) => value <= MAXN && value >= -MAXN ? Number(value) : value;
+/**
+ * Parses a plain decimal string ("-12.345", "+7", "0.50") into digits/10^scale. Returns the integer
+ * of all digits (number when safe, else bigint) and the count of fraction digits. Hand-rolled (no
+ * regex, no BigInt for short inputs): this is the hot path of `money("12.34", ...)`.
+ */
+export function parsePlainDecimal(input) {
+    const len = input.length;
+    let i = 0;
+    let neg = false;
+    let code = input.charCodeAt(0);
+    if (code === 45 /* - */ || code === 43 /* + */) {
+        neg = code === 45;
+        i = 1;
+    }
+    let acc = 0;
+    let digitsSeen = 0;
+    let scale = -1;
+    let big = false;
+    const start = i;
+    for (; i < len; i++) {
+        code = input.charCodeAt(i);
+        if (code >= 48 && code <= 57) {
+            digitsSeen++;
+            if (scale >= 0) {
+                scale++;
+            }
+            if (!big) {
+                // 15 digits always fit exactly in a double; beyond that use BigInt
+                if (digitsSeen > 15) {
+                    big = true;
+                }
+                else {
+                    acc = acc * 10 + (code - 48);
+                }
+            }
+        }
+        else if (code === 46 /* . */ && scale < 0 && digitsSeen > 0) {
+            scale = 0;
+        }
+        else {
+            return null;
+        }
+    }
+    // "", "-" and "12." are not decimals
+    if (digitsSeen === 0 || scale === 0) {
+        return null;
+    }
+    // parseDecimal reports fractions longer than MAX_DECIMAL_SCALE
+    if (scale > MAX_DECIMAL_SCALE) {
+        return null;
+    }
+    if (scale < 0) {
+        scale = 0;
+    }
+    if (big) {
+        const raw = input.slice(start).replace('.', '');
+        const value = BigInt(raw);
+        return { digits: normalizeMinor(neg ? -value : value), scale };
+    }
+    return { digits: neg ? 0 - acc : acc, scale };
+}
+const EXP_RE = /^([+-]?)(\d+)(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/;
+/**
+ * The largest exponent and number of fraction digits a decimal string may have. Far beyond any real
+ * amount or rate, and it keeps input such as "1e999999999" from building enormous powers of ten.
+ */
+export const MAX_DECIMAL_SCALE = 1000;
+/** Parses a decimal string, allowing exponent notation ("1e-7", as produced by String(1e-7)). */
+export function parseDecimal(input) {
+    const match = EXP_RE.exec(input.trim());
+    if (!match) {
+        throw new SyntaxError(`Invalid decimal string "${input}"`);
+    }
+    const [, sign, int, frac = '', exp = '0'] = match;
+    const exponent = Number(exp);
+    let scale = frac.length - exponent;
+    if (!(Math.abs(exponent) <= MAX_DECIMAL_SCALE) || scale > MAX_DECIMAL_SCALE) {
+        // The input itself is not quoted: it may be huge.
+        throw new RangeError(`Decimal string exponent or fraction digits beyond ${MAX_DECIMAL_SCALE}`);
+    }
+    let digits = BigInt(int + frac);
+    if (scale < 0) {
+        digits *= pow10n(-scale);
+        scale = 0;
+    }
+    return { digits: sign === '-' ? -digits : digits, scale };
+}
+function gcd(left, right) {
+    if (left < 0n) {
+        left = -left;
+    }
+    // a temporary, not a destructuring swap: `[a, b] = [b, a % b]` builds an array per step until the
+    // optimiser removes it, and this loop runs for every ratio that is built
+    while (right) {
+        const remainder = left % right;
+        left = right;
+        right = remainder;
+    }
+    return left;
+}
+/** The value as a number when it is a safe integer, otherwise NaN (a Ratio's `n` and `d`). */
+function safeNumberOrNaN(value) {
+    return value <= MAXN && value >= -MAXN ? Number(value) : NaN;
+}
+function makeRatio(num, den) {
+    if (den === 0n) {
+        throw new RangeError('Division by zero');
+    }
+    if (den < 0n) {
+        num = -num;
+        den = -den;
+    }
+    // an integer (den 1) is already in lowest terms
+    if (den !== 1n) {
+        const divisor = gcd(num, den);
+        if (divisor > 1n) {
+            num /= divisor;
+            den /= divisor;
+        }
+    }
+    return { num, den, n: safeNumberOrNaN(num), d: safeNumberOrNaN(den) };
+}
+const cache = new Map();
+const INT_RATIOS = [];
+/**
+ * Builds an exact ratio. `ratio('1.075')`, `ratio(3, 4)`, `ratio(10n)`, `ratio('1/3')`.
+ * Numbers are taken at their shortest decimal representation: `ratio(0.1)` is exactly 1/10.
+ * Pre-build ratios you use in hot loops; strings are also cached (up to 1024 entries).
+ */
+export function ratio(value, den) {
+    if (den !== undefined) {
+        // two bigints (divide, percentages, tax): one reduction instead of three
+        if (typeof value === 'bigint' && typeof den === 'bigint') {
+            return makeRatio(value, den);
+        }
+        const numeratorRatio = ratio(value);
+        const denominatorRatio = ratio(den);
+        return makeRatio(numeratorRatio.num * denominatorRatio.den, numeratorRatio.den * denominatorRatio.num);
+    }
+    if (typeof value === 'object') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        if (Number.isSafeInteger(value)) {
+            if (value >= 0 && value < 128) {
+                return (INT_RATIOS[value] ??= makeRatio(BigInt(value), 1n));
+            }
+            return makeRatio(BigInt(value), 1n);
+        }
+        if (!Number.isFinite(value)) {
+            throw new RangeError(`Invalid factor ${value}`);
+        }
+        value = String(value);
+    }
+    if (typeof value === 'bigint') {
+        return makeRatio(value, 1n);
+    }
+    let cached = cache.get(value);
+    if (cached === undefined) {
+        const slash = value.indexOf('/');
+        if (slash > 0) {
+            cached = ratio(value.slice(0, slash).trim(), value.slice(slash + 1).trim());
+        }
+        else {
+            const { digits, scale } = parseDecimal(value);
+            cached = makeRatio(digits, pow10n(scale));
+        }
+        if (cache.size >= 1024) {
+            cache.clear();
+        }
+        cache.set(value, cached);
+    }
+    return cached;
+}
+/** num/den -> exact decimal string if the expansion terminates, else null. */
+export function ratioToDecimal(value) {
+    let remainingDenominator = value.den;
+    let twos = 0;
+    let fives = 0;
+    while (remainingDenominator % 2n === 0n) {
+        remainingDenominator /= 2n;
+        twos++;
+    }
+    while (remainingDenominator % 5n === 0n) {
+        remainingDenominator /= 5n;
+        fives++;
+    }
+    if (remainingDenominator !== 1n) {
+        return null;
+    }
+    const scale = Math.max(twos, fives);
+    return formatScaled(value.num * (pow10n(scale) / value.den), scale);
+}
+// Zero padding for the fraction digits, built once: indexing it is faster than padStart.
+const ZPAD = Array.from({ length: 16 }, (_, length) => '0'.repeat(length));
+/** Formats an integer at `scale` as a plain decimal string ("-0.05"). */
+export function formatScaled(minor, scale) {
+    if (typeof minor === 'number' && scale <= 15) {
+        if (scale === 0) {
+            return String(minor);
+        }
+        // integer/fraction split with exact integer arithmetic (the float quotient is corrected)
+        const magnitude = minor < 0 ? 0 - minor : minor;
+        const unit = POW10[scale];
+        if (magnitude + unit <= MAX_SAFE_MINOR) {
+            let whole = Math.floor(magnitude / unit);
+            let fraction = magnitude - whole * unit;
+            if (fraction < 0) {
+                whole -= 1;
+                fraction += unit;
+            }
+            else if (fraction >= unit) {
+                whole += 1;
+                fraction -= unit;
+            }
+            let fractionDigits = String(fraction);
+            if (fractionDigits.length < scale) {
+                fractionDigits = ZPAD[scale - fractionDigits.length] + fractionDigits;
+            }
+            return (minor < 0 ? '-' : '') + whole + '.' + fractionDigits;
+        }
+    }
+    const neg = minor < 0;
+    let digits = typeof minor === 'number' ? String(neg ? 0 - minor : minor) : (neg ? -minor : minor).toString();
+    if (scale > 0) {
+        if (digits.length <= scale) {
+            digits = '0'.repeat(scale - digits.length + 1) + digits;
+        }
+        digits = digits.slice(0, digits.length - scale) + '.' + digits.slice(digits.length - scale);
+    }
+    return neg ? '-' + digits : digits;
+}
+//# sourceMappingURL=decimal.js.map

package/dist/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"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"}

package/dist/ecb.d.ts

@@ -0,0 +1,17 @@
+import { type RateTable } from './provider.js';
+/**
+ * Parses eurofxref-daily.xml, eurofxref-hist-90d.xml or eurofxref-hist.xml into one EUR-based table
+ * per day, newest first. Each rate is EUR → currency, with `source: 'ECB'`, `type: 'reference'` and
+ * `asOf` the publication day. A day without any rates is left out, so a lookback goes on to the day
+ * before. A rate entry that can't be read throws SyntaxError.
+ *
+ *     const [latest] = parseEcbXml(await readFile('eurofxref-daily.xml', 'utf8'));
+ */
+export declare function parseEcbXml(xml: string): RateTable[];
+/**
+ * Parses eurofxref.csv or eurofxref-hist.csv (from the ECB's zips) the way parseEcbXml does.
+ * 'N/A' and blank cells (currencies not quoted that day) are skipped, and a day with no rates at
+ * all is left out, so a lookback goes on to the day before.
+ */
+export declare function parseEcbCsv(csv: string): RateTable[];
+//# sourceMappingURL=ecb.d.ts.map

package/dist/ecb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecb.d.ts","sourceRoot":"","sources":["../src/ecb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAuE1D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgBpD;AAiCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BpD"}

package/dist/ecb.js

@@ -0,0 +1,147 @@
+// Offline parsers for the ECB euro foreign exchange reference rates (eurofxref). No I/O: fetch or
+// read the files yourself, or use ducat/convert/fetch. Rates are kept exactly as published.
+import { rateTable } from './provider.js';
+const MONTHS = [
+    'january',
+    'february',
+    'march',
+    'april',
+    'may',
+    'june',
+    'july',
+    'august',
+    'september',
+    'october',
+    'november',
+    'december',
+];
+const DAY_CUBE = /<Cube\s+time=["'](\d{4}-\d\d-\d\d)["']\s*>([\s\S]*?)<\/Cube>/g;
+// One <Cube .../> element, and its attributes in any order and with any quoting or spacing.
+const INNER_CUBE = /<Cube\b([^>]*?)\/?>/g;
+const ATTRIBUTE = /([A-Za-z]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+const RATE_TEXT = /^\d+(?:\.\d+)?$/;
+const ISO_DAY = /^(\d{4})-(\d\d)-(\d\d)$/;
+/**
+ * The ECB's rates are typed 'reference', not 'mid': they are set once a day, around 14:10 CET, from
+ * a regular concertation between central banks, and published for information only. They are not a
+ * market mid-rate that anyone deals at.
+ */
+function ecbTable(asOf, rates) {
+    return rateTable({ base: 'EUR', asOf, source: 'ECB', type: 'reference', rates });
+}
+function notAnEcbFile() {
+    throw new SyntaxError('Not an ECB reference rate file');
+}
+function withoutByteOrderMark(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+/** The currency → rate attributes of the <Cube> elements in one day's cube. */
+function ratesOfDay(body) {
+    const rates = {};
+    for (const [, attributeText] of body.matchAll(INNER_CUBE)) {
+        const attributes = {};
+        for (const [, name, doubleQuoted, singleQuoted] of attributeText.matchAll(ATTRIBUTE)) {
+            attributes[name] = doubleQuoted ?? singleQuoted;
+        }
+        const currency = attributes['currency'];
+        const rate = attributes['rate'];
+        if (currency === undefined && rate === undefined) {
+            continue;
+        }
+        // Fail rather than silently drop a currency: a missing rate would look like "not quoted".
+        if (currency === undefined ||
+            !/^[A-Z]{3}$/.test(currency) ||
+            rate === undefined ||
+            !RATE_TEXT.test(rate)) {
+            throw new SyntaxError(`Malformed ECB rate entry <Cube${attributeText}>`);
+        }
+        rates[currency] = rate;
+    }
+    return rates;
+}
+function newestFirst(tables) {
+    return tables.sort((table, other) => other.asOf.localeCompare(table.asOf));
+}
+/**
+ * Parses eurofxref-daily.xml, eurofxref-hist-90d.xml or eurofxref-hist.xml into one EUR-based table
+ * per day, newest first. Each rate is EUR → currency, with `source: 'ECB'`, `type: 'reference'` and
+ * `asOf` the publication day. A day without any rates is left out, so a lookback goes on to the day
+ * before. A rate entry that can't be read throws SyntaxError.
+ *
+ *     const [latest] = parseEcbXml(await readFile('eurofxref-daily.xml', 'utf8'));
+ */
+export function parseEcbXml(xml) {
+    let days = 0;
+    const tables = [];
+    for (const [, asOf, body] of withoutByteOrderMark(xml).matchAll(DAY_CUBE)) {
+        days++;
+        const day = isoDay(asOf);
+        const rates = ratesOfDay(body);
+        if (Object.keys(rates).length > 0) {
+            tables.push(ecbTable(day, rates));
+        }
+    }
+    if (days === 0) {
+        notAnEcbFile();
+    }
+    return newestFirst(tables);
+}
+/** The ISO date of year-month-day, or a SyntaxError when that day doesn't exist (32 November). */
+function calendarDay(year, month, day) {
+    const date = new Date(Date.UTC(year, month - 1, day));
+    if (date.getUTCFullYear() !== year ||
+        date.getUTCMonth() !== month - 1 ||
+        date.getUTCDate() !== day) {
+        throw new SyntaxError(`Not a calendar day: ${year}-${month}-${day}`);
+    }
+    return date.toISOString().slice(0, 10);
+}
+/** '2026-11-06', or '06 November 2026' as in the daily CSV, as an ISO date. */
+function isoDay(text) {
+    const iso = ISO_DAY.exec(text);
+    if (iso !== null) {
+        return calendarDay(Number(iso[1]), Number(iso[2]), Number(iso[3]));
+    }
+    const match = /^(\d{1,2}) ([A-Za-z]+) (\d{4})$/.exec(text);
+    if (match === null) {
+        notAnEcbFile();
+    }
+    const [, day, monthName, year] = match;
+    const month = MONTHS.indexOf(monthName.toLowerCase()) + 1;
+    if (month === 0) {
+        notAnEcbFile();
+    }
+    return calendarDay(Number(year), month, Number(day));
+}
+/**
+ * Parses eurofxref.csv or eurofxref-hist.csv (from the ECB's zips) the way parseEcbXml does.
+ * 'N/A' and blank cells (currencies not quoted that day) are skipped, and a day with no rates at
+ * all is left out, so a lookback goes on to the day before.
+ */
+export function parseEcbCsv(csv) {
+    const lines = withoutByteOrderMark(csv)
+        .split(/\r?\n/)
+        .filter((line) => line.trim() !== '');
+    const columns = (lines[0] ?? '').split(',').map((cell) => cell.trim());
+    if (columns[0] !== 'Date') {
+        notAnEcbFile();
+    }
+    const tables = [];
+    for (const line of lines.slice(1)) {
+        const cells = line.split(',').map((cell) => cell.trim());
+        const rates = {};
+        for (let i = 1; i < columns.length; i++) {
+            const currency = columns[i];
+            const rate = cells[i];
+            if (currency && rate && rate !== 'N/A') {
+                rates[currency] = rate;
+            }
+        }
+        const day = isoDay(cells[0]);
+        if (Object.keys(rates).length > 0) {
+            tables.push(ecbTable(day, rates));
+        }
+    }
+    return newestFirst(tables);
+}
+//# sourceMappingURL=ecb.js.map

package/dist/ecb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecb.js","sourceRoot":"","sources":["../src/ecb.ts"],"names":[],"mappings":"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"}

package/dist/exact.d.ts

@@ -0,0 +1,62 @@
+import { type Factor } from './decimal.js';
+import { type Money } from './money.js';
+import type { Rate } from './rate.js';
+import { type RoundingMode } from './rounding.js';
+/**
+ * A rounded value and what rounding left out: `value + residual` is exactly the unrounded amount.
+ */
+export interface Rounded<C extends string> {
+    readonly value: Money<C>;
+    readonly residual: ExactMoney<C>;
+}
+/**
+ * An exact amount of `currency`: num/den major units, reduced, den > 0. Build it with `exact()`.
+ */
+export declare class ExactMoney<C extends string = string> {
+    readonly currency: C;
+    readonly num: bigint;
+    readonly den: bigint;
+    /** @internal use exact() */
+    constructor(currency: C, numerator: bigint, denominator: bigint);
+    /** this + other, exactly. */
+    add(other: ExactMoney<C>): ExactMoney<C>;
+    /** this − other, exactly. */
+    subtract(other: ExactMoney<C>): ExactMoney<C>;
+    /** −this. */
+    negate(): ExactMoney<C>;
+    /** this × factor, exactly. */
+    multiply(factor: Factor): ExactMoney<C>;
+    /** this ÷ divisor, exactly. */
+    divide(divisor: Factor): ExactMoney<C>;
+    /** Converts exactly at `rate`; nothing is rounded. */
+    convert<To extends string>(rate: Rate<C, To>): ExactMoney<To>;
+    /** −1, 0 or 1. */
+    compare(other: ExactMoney<C>): -1 | 0 | 1;
+    /** Same currency and the same exact value. */
+    equals(other: ExactMoney): boolean;
+    /** −1, 0 or 1. */
+    sign(): -1 | 0 | 1;
+    /** Whether the amount is zero. */
+    isZero(): boolean;
+    /** Whether the amount fits `scale` (default: the currency's exponent) without rounding. */
+    isExact(scale?: number): boolean;
+    /** Rounds once to `scale` (default: the currency's exponent). */
+    round(rounding?: RoundingMode, scale?: number): Money<C>;
+    /** Rounds once and reports the difference, for booking it (e.g. an "FX rounding" ledger line). */
+    roundWithResidual(rounding?: RoundingMode, scale?: number): Rounded<C>;
+    /** "10/3 EUR", for debugging only. */
+    toString(): string;
+    /** Blocks `a + b` and `a > b`: round() first. */
+    [Symbol.toPrimitive](hint: string): string;
+}
+/**
+ * The exact value of `money`, for chained arithmetic: `exact(price).divide(3).round('halfEven')`.
+ */
+export declare function exact<C extends string>(money: Money<C>): ExactMoney<C>;
+/**
+ * The exact sum (zero of `currency` for an empty list). Round it once for a batch's rounding line.
+ */
+export declare function sumExact<C extends string>(items: readonly ExactMoney<C>[], currency?: C): ExactMoney<C>;
+/** Whether `value` is an ExactMoney. */
+export declare function isExactMoney(value: unknown): value is ExactMoney;
+//# sourceMappingURL=exact.d.ts.map

package/dist/exact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact.d.ts","sourceRoot":"","sources":["../src/exact.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAA+B,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,4BAA4B;gBAChB,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAO/D,6BAA6B;IAC7B,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAMxC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAI7C,aAAa;IACb,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC;IAIvB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAKvC,+BAA+B;IAC/B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAQtC,sDAAsD;IACtD,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC;IAO7D,kBAAkB;IAClB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAczC,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO;IAIlC,kBAAkB;IAClB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAUlB,kCAAkC;IAClC,MAAM,IAAI,OAAO;IAIjB,2FAA2F;IAC3F,OAAO,CAAC,KAAK,GAAE,MAAwC,GAAG,OAAO;IAIjE,iEAAiE;IACjE,KAAK,CACH,QAAQ,GAAE,YAA+B,EACzC,KAAK,GAAE,MAAwC,GAC9C,KAAK,CAAC,CAAC,CAAC;IAKX,kGAAkG;IAClG,iBAAiB,CAAC,QAAQ,GAAE,YAA+B,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAMxF,sCAAsC;IACtC,QAAQ,IAAI,MAAM;IAOlB,iDAAiD;IACjD,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAM3C;AAQD;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,KAAK,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,EAC/B,QAAQ,CAAC,EAAE,CAAC,GACX,UAAU,CAAC,CAAC,CAAC,CAUf;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}

package/dist/exact.js

@@ -0,0 +1,147 @@
+// ExactMoney: an exact rational amount for chains of arithmetic that should round once, at the end.
+// It has no formatting, JSON or minor units on purpose: it must be rounded back to Money before it
+// leaves the process.
+import { currencyExponent } from './currency.js';
+import { pow10n, ratio } from './decimal.js';
+import { CurrencyMismatchError, make } from './money.js';
+import { DEFAULT_ROUNDING, divideAndRoundBigint } from './rounding.js';
+/**
+ * An exact amount of `currency`: num/den major units, reduced, den > 0. Build it with `exact()`.
+ */
+export class ExactMoney {
+    currency;
+    num;
+    den;
+    /** @internal use exact() */
+    constructor(currency, numerator, denominator) {
+        const reduced = ratio(numerator, denominator); // reduces and makes the denominator positive
+        this.currency = currency;
+        this.num = reduced.num;
+        this.den = reduced.den;
+    }
+    /** this + other, exactly. */
+    add(other) {
+        assertSameCurrency(this, other);
+        const numerator = this.num * other.den + other.num * this.den;
+        return new ExactMoney(this.currency, numerator, this.den * other.den);
+    }
+    /** this − other, exactly. */
+    subtract(other) {
+        return this.add(other.negate());
+    }
+    /** −this. */
+    negate() {
+        return new ExactMoney(this.currency, -this.num, this.den);
+    }
+    /** this × factor, exactly. */
+    multiply(factor) {
+        const factorRatio = ratio(factor);
+        return new ExactMoney(this.currency, this.num * factorRatio.num, this.den * factorRatio.den);
+    }
+    /** this ÷ divisor, exactly. */
+    divide(divisor) {
+        const divisorRatio = ratio(divisor);
+        if (divisorRatio.num === 0n) {
+            throw new RangeError('Division by zero');
+        }
+        return new ExactMoney(this.currency, this.num * divisorRatio.den, this.den * divisorRatio.num);
+    }
+    /** Converts exactly at `rate`; nothing is rounded. */
+    convert(rate) {
+        if (rate.from !== this.currency) {
+            throw new CurrencyMismatchError(rate.from, this.currency);
+        }
+        return new ExactMoney(rate.to, this.num * rate.ratio.num, this.den * rate.ratio.den);
+    }
+    /** −1, 0 or 1. */
+    compare(other) {
+        assertSameCurrency(this, other);
+        // Both denominators are positive, so cross-multiplying keeps the order.
+        const left = this.num * other.den;
+        const right = other.num * this.den;
+        if (left < right) {
+            return -1;
+        }
+        if (left > right) {
+            return 1;
+        }
+        return 0;
+    }
+    /** Same currency and the same exact value. */
+    equals(other) {
+        return this.currency === other.currency && this.num === other.num && this.den === other.den;
+    }
+    /** −1, 0 or 1. */
+    sign() {
+        if (this.num > 0n) {
+            return 1;
+        }
+        if (this.num < 0n) {
+            return -1;
+        }
+        return 0;
+    }
+    /** Whether the amount is zero. */
+    isZero() {
+        return this.num === 0n;
+    }
+    /** Whether the amount fits `scale` (default: the currency's exponent) without rounding. */
+    isExact(scale = currencyExponent(this.currency)) {
+        return (this.num * pow10n(scale)) % this.den === 0n;
+    }
+    /** Rounds once to `scale` (default: the currency's exponent). */
+    round(rounding = DEFAULT_ROUNDING, scale = currencyExponent(this.currency)) {
+        const minor = divideAndRoundBigint(this.num * pow10n(scale), this.den, rounding);
+        return make(this.currency, minor, scale);
+    }
+    /** Rounds once and reports the difference, for booking it (e.g. an "FX rounding" ledger line). */
+    roundWithResidual(rounding = DEFAULT_ROUNDING, scale) {
+        const value = this.round(rounding, scale);
+        const residual = this.subtract(exact(value));
+        return { value, residual };
+    }
+    /** "10/3 EUR", for debugging only. */
+    toString() {
+        if (this.den === 1n) {
+            return `${this.num} ${this.currency}`;
+        }
+        return `${this.num}/${this.den} ${this.currency}`;
+    }
+    /** Blocks `a + b` and `a > b`: round() first. */
+    [Symbol.toPrimitive](hint) {
+        if (hint === 'string') {
+            return this.toString();
+        }
+        throw new TypeError('ExactMoney cannot be converted to a number; round() it first');
+    }
+}
+function assertSameCurrency(money, other) {
+    if (money.currency !== other.currency) {
+        throw new CurrencyMismatchError(money.currency, other.currency);
+    }
+}
+/**
+ * The exact value of `money`, for chained arithmetic: `exact(price).divide(3).round('halfEven')`.
+ */
+export function exact(money) {
+    return new ExactMoney(money.currency, BigInt(money.minor), pow10n(money.scale));
+}
+/**
+ * The exact sum (zero of `currency` for an empty list). Round it once for a batch's rounding line.
+ */
+export function sumExact(items, currency) {
+    const sumCurrency = currency ?? items[0]?.currency;
+    if (sumCurrency === undefined) {
+        throw new RangeError('sumExact of an empty list needs a currency');
+    }
+    let sum = new ExactMoney(sumCurrency, 0n, 1n);
+    for (const item of items) {
+        sum = sum.add(item);
+    }
+    return sum;
+}
+/** Whether `value` is an ExactMoney. */
+export function isExactMoney(value) {
+    return value instanceof ExactMoney;
+}
+//# sourceMappingURL=exact.js.map