@arki/money 0.0.0-stage → 0.0.4

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,YAAY,GAAG;IACzB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,UAAU,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5D,kEAAkE;IAClE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;IAC1C,uGAAuG;IACvG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAC9C,CAAC;AAgLF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACtD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,YAAiB,GACzB,WAAW,CAAC,CAAC,CAAC,CA4BhB;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC/C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,YAAY,GACrB,KAAK,CAAC,CAAC,CAAC,CAEV"}

package/dist/parse.js

@@ -0,0 +1,222 @@
+/**
+ * Strict parsing of money typed by people: `'1.234,56 €'` in German,
+ * `'$1,234.56'` in English, `'₹1,23,456.78'` in Indian English.
+ *
+ * The locale's separators, digits, minus sign and currency symbols come from
+ * `Intl.NumberFormat#formatToParts`. You always say which currency you expect,
+ * so `'$10'` never has to guess between US, Canadian or Australian dollars.
+ *
+ * Strict means it refuses instead of guessing: grouping in the wrong place
+ * (`'1,23,4'`), a decimal separator the locale does not use, two signs, mixed
+ * digit scripts, a different currency's symbol, or any trailing text all throw
+ * `NumberFormatError`. Text without grouping is always fine: `'1234.5'`.
+ *
+ * Runtimes without `formatToParts` (React Native's Hermes on iOS) throw
+ * `UnsupportedFeatureError`; pass `symbols` to parse without `Intl`.
+ */
+import { NumberFormatError, ResourceLimitError, RoundingNecessaryError, UnsupportedFeatureError, } from '@arki/math/errors';
+import { toCurrency } from './currency.js';
+import { MAX_INPUT_LENGTH } from './internal/units.js';
+import { Money } from './money.js';
+const SPACES = /\s/g;
+const BIDI = /[\u061C\u200E\u200F]/g;
+const ASCII_DIGITS = /^\d+$/;
+function normalizeSpaces(text) {
+    return text.replaceAll(SPACES, ' ');
+}
+function grammarFromSymbols(currency, symbols) {
+    const [primary, secondary] = symbols.groupSizes ?? [3];
+    return {
+        decimal: normalizeSpaces(symbols.decimal),
+        group: symbols.group === undefined ? undefined : normalizeSpaces(symbols.group),
+        primary,
+        secondary: secondary ?? primary,
+        digits: undefined,
+        minus: ['-', '\u2212'],
+        marks: sortMarks([currency.code, ...(symbols.currency ?? [])]),
+    };
+}
+function sortMarks(marks) {
+    return [...new Set(marks.map(mark => normalizeSpaces(mark).trim()))]
+        .filter(mark => mark !== '')
+        .sort((a, b) => b.length - a.length);
+}
+function grammarFromIntl(currency, locale) {
+    let plain;
+    try {
+        plain = new Intl.NumberFormat(locale, { minimumFractionDigits: 1, useGrouping: true });
+    }
+    catch (error) {
+        throw new UnsupportedFeatureError(`This runtime's Intl does not support the locale ${locale}`, { cause: error });
+    }
+    if (typeof plain.formatToParts !== 'function') {
+        throw new UnsupportedFeatureError('This runtime lacks Intl.NumberFormat#formatToParts; pass options.symbols');
+    }
+    const parts = plain.formatToParts(-1_234_567_890.5);
+    const find = (type) => parts.find(part => part.type === type)?.value;
+    const integers = parts.filter(part => part.type === 'integer').map(part => part.value.length);
+    const primary = integers.at(-1) ?? 3;
+    const secondary = integers.length > 2 ? (integers.at(-2) ?? primary) : primary;
+    const digitFormat = new Intl.NumberFormat(locale, { useGrouping: false });
+    const localDigits = Array.from({ length: 10 }, (_, digit) => digitFormat.format(digit)).join('');
+    // The locale's symbols plus the English ones: people in Japan often type `¥` where Intl writes `￥`.
+    // Safe, because the caller has already said which currency to expect.
+    const marks = [currency.code];
+    if (currency.iso) {
+        for (const markLocale of [locale, 'en']) {
+            for (const currencyDisplay of ['symbol', 'narrowSymbol']) {
+                try {
+                    const formatted = new Intl.NumberFormat(markLocale, {
+                        style: 'currency',
+                        currency: currency.code,
+                        currencyDisplay,
+                    });
+                    for (const part of formatted.formatToParts(1))
+                        if (part.type === 'currency')
+                            marks.push(part.value);
+                }
+                catch {
+                    // A display the runtime lacks simply adds no mark; the ISO code is always accepted.
+                }
+            }
+        }
+    }
+    const group = find('group');
+    return {
+        decimal: normalizeSpaces(find('decimal') ?? '.'),
+        group: group === undefined ? undefined : normalizeSpaces(group),
+        primary,
+        secondary,
+        digits: localDigits === '0123456789' ? undefined : localDigits,
+        minus: [...new Set([find('minusSign') ?? '-', '-', '\u2212'])],
+        marks: sortMarks(marks),
+    };
+}
+function fail(text, reason) {
+    throw new NumberFormatError(`Cannot read ${JSON.stringify(text.slice(0, 40))} as money: ${reason}`);
+}
+/** Turns locale text into plain `'-1234.56'`, or throws `NumberFormatError`. */
+function toPlainDecimal(input, grammar) {
+    if (input.length > MAX_INPUT_LENGTH) {
+        throw new ResourceLimitError(`Money text is longer than ${MAX_INPUT_LENGTH} characters`);
+    }
+    let text = normalizeSpaces(input.replaceAll(BIDI, '')).trim();
+    let negative = false;
+    if (text.startsWith('(') && text.endsWith(')')) {
+        negative = true;
+        text = text.slice(1, -1).trim();
+    }
+    // Leading sign and currency mark, in either order; a trailing currency mark.
+    let sawSign = false;
+    let sawMark = false;
+    for (let round = 0; round < 2; round++) {
+        const sign = [...grammar.minus, '+'].find(candidate => text.startsWith(candidate));
+        if (sign !== undefined && !sawSign) {
+            sawSign = true;
+            if (sign !== '+')
+                negative = !negative;
+            text = text.slice(sign.length).trim();
+        }
+        const mark = grammar.marks.find(candidate => text.startsWith(candidate));
+        if (mark !== undefined && !sawMark) {
+            sawMark = true;
+            text = text.slice(mark.length).trim();
+        }
+    }
+    const trailing = grammar.marks.find(candidate => text.endsWith(candidate));
+    if (trailing !== undefined) {
+        if (sawMark)
+            fail(input, 'the currency appears twice');
+        text = text.slice(0, -trailing.length).trim();
+    }
+    if (sawSign && negative && input.trim().startsWith('('))
+        fail(input, 'it has both parentheses and a minus sign');
+    // Local digits → ASCII, refusing a mix of scripts.
+    if (grammar.digits !== undefined) {
+        let local = false;
+        let ascii = false;
+        let converted = '';
+        for (const char of text) {
+            const index = grammar.digits.indexOf(char);
+            if (index === -1) {
+                if (char >= '0' && char <= '9')
+                    ascii = true;
+                converted += char;
+            }
+            else {
+                local = true;
+                converted += String(index);
+            }
+        }
+        if (local && ascii)
+            fail(input, 'it mixes digit scripts');
+        text = converted;
+    }
+    const pieces = text.split(grammar.decimal);
+    if (pieces.length > 2)
+        fail(input, `the decimal separator ${JSON.stringify(grammar.decimal)} appears twice`);
+    const [whole = '', fraction] = pieces;
+    if (fraction !== undefined && !ASCII_DIGITS.test(fraction))
+        fail(input, 'the decimals are not digits');
+    const group = grammar.group;
+    if (!ASCII_DIGITS.test(group === undefined ? whole : whole.replaceAll(group, ''))) {
+        fail(input, 'it is not a number in this locale');
+    }
+    let digits = whole;
+    if (group !== undefined && whole.includes(group)) {
+        const groups = whole.split(group);
+        const last = groups.length - 1;
+        const valid = groups.every((group, index) => {
+            if (!ASCII_DIGITS.test(group))
+                return false;
+            if (index === last)
+                return group.length === grammar.primary;
+            if (index === 0)
+                return group.length <= (last === 1 ? grammar.primary : grammar.secondary);
+            return group.length === grammar.secondary;
+        });
+        if (!valid)
+            fail(input, 'the digit grouping does not match the locale');
+        digits = groups.join('');
+    }
+    if (!ASCII_DIGITS.test(digits))
+        fail(input, 'it is not a number in this locale');
+    return `${negative ? '-' : ''}${digits}${fraction === undefined ? '' : `.${fraction}`}`;
+}
+/**
+ * Prepares the locale's grammar once, for forms and imports:
+ * `const parse = createMoneyParser('EUR', { locale: 'de-DE' }); parse.parse('1.234,56 €')`.
+ */
+export function createMoneyParser(currency, options = {}) {
+    const target = toCurrency(currency);
+    const grammar = options.symbols === undefined
+        ? grammarFromIntl(target, options.locale ?? 'en-US')
+        : grammarFromSymbols(target, options.symbols);
+    const settle = { rounding: options.rounding, scale: options.scale };
+    const parse = (text) => {
+        if (typeof text !== 'string')
+            throw new TypeError('Expected text to parse');
+        return Money.of(toPlainDecimal(text, grammar), target, settle);
+    };
+    return {
+        parse,
+        tryParse(text) {
+            try {
+                return parse(text);
+            }
+            catch (error) {
+                if (error instanceof NumberFormatError ||
+                    error instanceof RoundingNecessaryError ||
+                    error instanceof ResourceLimitError) {
+                    return;
+                }
+                throw error;
+            }
+        },
+    };
+}
+/** One-shot form of `createMoneyParser`: `parseMoney('1.234,56 €', 'EUR', { locale: 'de-DE' })`. */
+export function parseMoney(text, currency, options) {
+    return createMoneyParser(currency, options).parse(text);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Payment providers count amounts in their own units, which are not always
+ * ISO's. A rule says how many decimals the provider's integer carries and,
+ * optionally, which multiple it must be. Conversion never rounds: an amount
+ * the provider cannot express throws `ProviderAmountError`.
+ *
+ * `@arki/money/stripe` ships Stripe's rules. Describe any other provider with
+ * a `ProviderUnitRule` and these two functions.
+ */
+import type { CurrencyLike } from './currency.js';
+import { Money } from './money.js';
+export type ProviderUnitRule = {
+    /** Decimals in the provider's integer: 2 means `1099` is `10.99`. */
+    scale: number;
+    /** The integer must be a multiple of this: `100` for whole-unit-only currencies sent with two decimals. */
+    step?: number;
+};
+/** `toProviderUnits(money('10.99', 'USD'), { scale: 2 })` → `1099`. Throws instead of rounding. */
+export declare function toProviderUnits(amount: Money, rule: ProviderUnitRule): number;
+/** The reverse of `toProviderUnits`, at the currency's own scale. Validates the step. */
+export declare function fromProviderUnits<const C extends string>(units: number | bigint | string, currency: CurrencyLike<C>, rule: ProviderUnitRule): Money<C>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,2GAA2G;IAC3G,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAQF,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAa7E;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACtD,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAC/B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,gBAAgB,GACrB,KAAK,CAAC,CAAC,CAAC,CAaV"}

package/dist/provider.js

@@ -0,0 +1,56 @@
+/**
+ * Payment providers count amounts in their own units, which are not always
+ * ISO's. A rule says how many decimals the provider's integer carries and,
+ * optionally, which multiple it must be. Conversion never rounds: an amount
+ * the provider cannot express throws `ProviderAmountError`.
+ *
+ * `@arki/money/stripe` ships Stripe's rules. Describe any other provider with
+ * a `ProviderUnitRule` and these two functions.
+ */
+import { NumericRangeError, RoundingNecessaryError } from '@arki/math/errors';
+import { toCurrency } from './currency.js';
+import { ProviderAmountError } from './errors.js';
+import { quantize } from './internal/units.js';
+import { Money } from './money.js';
+function checkStep(units, rule, what) {
+    if (rule.step !== undefined && BigInt(units) % BigInt(rule.step) !== 0n) {
+        throw new ProviderAmountError(`${what} must be a multiple of ${rule.step} in the provider's units`);
+    }
+}
+/** `toProviderUnits(money('10.99', 'USD'), { scale: 2 })` → `1099`. Throws instead of rounding. */
+export function toProviderUnits(amount, rule) {
+    let units;
+    try {
+        units = quantize(amount.units, amount.scale, rule.scale);
+    }
+    catch (error) {
+        if (!(error instanceof RoundingNecessaryError))
+            throw error;
+        throw new ProviderAmountError(`${amount.toString()} has more decimals than the provider accepts (${rule.scale})`, {
+            cause: error,
+        });
+    }
+    checkStep(units, rule, amount.toString());
+    if (typeof units !== 'number')
+        throw new NumericRangeError(`${amount.toString()} is too large for a provider amount`);
+    return units;
+}
+/** The reverse of `toProviderUnits`, at the currency's own scale. Validates the step. */
+export function fromProviderUnits(units, currency, rule) {
+    const target = toCurrency(currency);
+    const raw = Money.fromMinor(units, target, rule.scale);
+    checkStep(raw.units, rule, `The provider amount ${String(units)}`);
+    if (rule.scale <= target.scale)
+        return raw.toScale(target.scale);
+    try {
+        return raw.toScale(target.scale);
+    }
+    catch (error) {
+        if (!(error instanceof RoundingNecessaryError))
+            throw error;
+        throw new ProviderAmountError(`The provider amount ${String(units)} has a fraction ${target.code} does not have`, {
+            cause: error,
+        });
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AASnC,SAAS,SAAS,CAAC,KAAY,EAAE,IAAsB,EAAE,IAAY;IACnE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACxE,MAAM,IAAI,mBAAmB,CAAC,GAAG,IAAI,0BAA0B,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,MAAa,EAAE,IAAsB;IACnE,IAAI,KAAY,CAAC;IACjB,IAAI,CAAC;QACH,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,sBAAsB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC5D,MAAM,IAAI,mBAAmB,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,iDAAiD,IAAI,CAAC,KAAK,GAAG,EAAE;YAChH,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,iBAAiB,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;IACtH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAC/B,KAA+B,EAC/B,QAAyB,EACzB,IAAsB;IAEtB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,uBAAuB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,sBAAsB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC5D,MAAM,IAAI,mBAAmB,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,gBAAgB,EAAE;YAChH,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/rational.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Exact in-between money. A `RationalMoney` is a fraction of major units plus
+ * a currency, so a chain of steps (split a third, add tax, convert) never
+ * rounds until you settle it with `toMoney`, and the currency travels with
+ * the value the whole way: EUR and USD still cannot be mixed.
+ *
+ * ```ts
+ * const share = RationalMoney.from(money(100, 'EUR')).dividedBy(3).times('1.19');
+ * share.toString();                         // '119/3 EUR'
+ * share.toMoney({ rounding: 'halfEven' });  // 39.67 EUR, rounded once
+ * ```
+ */
+import type { Rational } from '@arki/math/rational';
+import type { Currency, CurrencyLike } from './currency.js';
+import type { Amount, FactorInput, MoneyJSON, MoneyOptions } from './money.js';
+import { Money } from './money.js';
+/** Something with an exact value in a currency: a `Money` or a `RationalMoney`. */
+export type ExactMoney<C extends string = string> = Money<C> | RationalMoney<C>;
+/** An immutable exact amount: a fraction of major units in one currency. */
+export declare class RationalMoney<C extends string = string> {
+    /** Major units as a reduced fraction. */
+    readonly amount: Rational;
+    readonly currency: Currency<C>;
+    private constructor();
+    /** `RationalMoney.of('1/3', 'EUR')`, or any `Amount` (`'19.99'`, `ratio(1, 3)`). Never rounds. */
+    static of<const C extends string>(amount: Amount | ExactMoney, currency: CurrencyLike<C>): RationalMoney<C>;
+    /** The exact value of a `Money`. */
+    static from<C extends string>(value: Money<C>): RationalMoney<C>;
+    /** Zero in this currency. */
+    static zero<const C extends string>(currency: CurrencyLike<C>): RationalMoney<C>;
+    /** Reads `{ amount: '1/3', currency: 'EUR' }`, as written by `toJSON`. */
+    static fromJSON(value: unknown, currencies?: readonly Currency[]): RationalMoney;
+    plus(other: ExactMoney<C>): RationalMoney<C>;
+    minus(other: ExactMoney<C>): RationalMoney<C>;
+    times(multiplier: FactorInput): RationalMoney<C>;
+    /** Zero throws `DivisionByZeroError`. */
+    dividedBy(divisor: FactorInput): RationalMoney<C>;
+    /** `percentage(15)` is `times(15 / 100)`. */
+    percentage(percent: FactorInput): RationalMoney<C>;
+    negated(): RationalMoney<C>;
+    abs(): RationalMoney<C>;
+    compareTo(other: ExactMoney<C>): -1 | 0 | 1;
+    eq(other: ExactMoney<C>): boolean;
+    lt(other: ExactMoney<C>): boolean;
+    lte(other: ExactMoney<C>): boolean;
+    gt(other: ExactMoney<C>): boolean;
+    gte(other: ExactMoney<C>): boolean;
+    isZero(): boolean;
+    isPositive(): boolean;
+    isNegative(): boolean;
+    sign(): -1 | 0 | 1;
+    /**
+     * Rounds once to a `Money` at the currency's scale (or `options.scale`).
+     * An inexact value needs `options.rounding`: `'1/3 EUR'` throws without it.
+     */
+    toMoney(options?: MoneyOptions): Money<C>;
+    /** `'1/3 EUR'`, `'5 EUR'`. */
+    toString(): string;
+    /** `{ amount: '1/3', currency: 'EUR' }`. */
+    toJSON(): MoneyJSON;
+    /** Throws. Settle with `toMoney()` first. */
+    valueOf(): never;
+    [Symbol.toPrimitive](hint: string): string;
+    get [Symbol.toStringTag](): string;
+}
+export declare function isRationalMoney(value: unknown): value is RationalMoney;
+//# sourceMappingURL=rational.d.ts.map

package/dist/rational.d.ts.map

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

package/dist/rational.js

@@ -0,0 +1,169 @@
+/**
+ * Exact in-between money. A `RationalMoney` is a fraction of major units plus
+ * a currency, so a chain of steps (split a third, add tax, convert) never
+ * rounds until you settle it with `toMoney`, and the currency travels with
+ * the value the whole way: EUR and USD still cannot be mixed.
+ *
+ * ```ts
+ * const share = RationalMoney.from(money(100, 'EUR')).dividedBy(3).times('1.19');
+ * share.toString();                         // '119/3 EUR'
+ * share.toMoney({ rounding: 'halfEven' });  // 39.67 EUR, rounded once
+ * ```
+ */
+import { InvalidArgumentError } from '@arki/math/errors';
+import { ratio } from '@arki/math/rational';
+import { assertSameCurrency, resolveCurrency, toCurrency } from './currency.js';
+import { Money, toFraction } from './money.js';
+const BRAND = Symbol('RationalMoney');
+function fraction(value) {
+    const [numerator, denominator] = toFraction(value);
+    return ratio(BigInt(numerator), BigInt(denominator));
+}
+function toRationalAmount(value) {
+    return value instanceof RationalMoney ? value.amount : ratio(BigInt(value.units), 10n ** BigInt(value.scale));
+}
+function refuseCoercion() {
+    throw new TypeError('RationalMoney cannot be turned into a number implicitly; settle it with toMoney()');
+}
+/** An immutable exact amount: a fraction of major units in one currency. */
+export class RationalMoney {
+    /** Major units as a reduced fraction. */
+    amount;
+    currency;
+    constructor(amount, currency, brand) {
+        if (brand !== BRAND)
+            throw new TypeError('Use RationalMoney.of() or RationalMoney.from() instead of new');
+        this.amount = amount;
+        this.currency = currency;
+    }
+    /** `RationalMoney.of('1/3', 'EUR')`, or any `Amount` (`'19.99'`, `ratio(1, 3)`). Never rounds. */
+    static of(amount, currency) {
+        const cur = toCurrency(currency);
+        if (amount instanceof Money || amount instanceof RationalMoney) {
+            assertSameCurrency(amount.currency, cur);
+            return new RationalMoney(toRationalAmount(amount), cur, BRAND);
+        }
+        if (typeof amount === 'string' && amount.includes('/'))
+            return new RationalMoney(ratio(amount), cur, BRAND);
+        return new RationalMoney(fraction(amount), cur, BRAND);
+    }
+    /** The exact value of a `Money`. */
+    static from(value) {
+        return new RationalMoney(toRationalAmount(value), value.currency, BRAND);
+    }
+    /** Zero in this currency. */
+    static zero(currency) {
+        return new RationalMoney(ratio(0), toCurrency(currency), BRAND);
+    }
+    /** Reads `{ amount: '1/3', currency: 'EUR' }`, as written by `toJSON`. */
+    static fromJSON(value, currencies) {
+        if (typeof value !== 'object' || value === null || !('amount' in value) || !('currency' in value)) {
+            throw new InvalidArgumentError('Expected { amount: string, currency: string }');
+        }
+        const { amount, currency } = value;
+        if (typeof amount !== 'string' || typeof currency !== 'string') {
+            throw new InvalidArgumentError('Expected { amount: string, currency: string }');
+        }
+        return RationalMoney.of(amount, resolveCurrency(currency, currencies));
+    }
+    /** @internal */
+    static create(amount, currency) {
+        return new RationalMoney(amount, currency, BRAND);
+    }
+    // Arithmetic: always exact ------------------------------------------------
+    plus(other) {
+        assertSameCurrency(this.currency, other.currency);
+        return new RationalMoney(this.amount.plus(toRationalAmount(other)), this.currency, BRAND);
+    }
+    minus(other) {
+        assertSameCurrency(this.currency, other.currency);
+        return new RationalMoney(this.amount.minus(toRationalAmount(other)), this.currency, BRAND);
+    }
+    times(multiplier) {
+        return new RationalMoney(this.amount.times(fraction(multiplier)), this.currency, BRAND);
+    }
+    /** Zero throws `DivisionByZeroError`. */
+    dividedBy(divisor) {
+        return new RationalMoney(this.amount.dividedBy(fraction(divisor)), this.currency, BRAND);
+    }
+    /** `percentage(15)` is `times(15 / 100)`. */
+    percentage(percent) {
+        return new RationalMoney(this.amount.times(fraction(percent)).dividedBy(100), this.currency, BRAND);
+    }
+    negated() {
+        return new RationalMoney(this.amount.negated(), this.currency, BRAND);
+    }
+    abs() {
+        return this.amount.isNegative() ? this.negated() : this;
+    }
+    // Comparison --------------------------------------------------------------
+    compareTo(other) {
+        assertSameCurrency(this.currency, other.currency);
+        return this.amount.compareTo(toRationalAmount(other));
+    }
+    eq(other) {
+        return this.compareTo(other) === 0;
+    }
+    lt(other) {
+        return this.compareTo(other) < 0;
+    }
+    lte(other) {
+        return this.compareTo(other) <= 0;
+    }
+    gt(other) {
+        return this.compareTo(other) > 0;
+    }
+    gte(other) {
+        return this.compareTo(other) >= 0;
+    }
+    isZero() {
+        return this.amount.isZero();
+    }
+    isPositive() {
+        return this.amount.isPositive();
+    }
+    isNegative() {
+        return this.amount.isNegative();
+    }
+    sign() {
+        return this.amount.sign();
+    }
+    // Settling and output -----------------------------------------------------
+    /**
+     * Rounds once to a `Money` at the currency's scale (or `options.scale`).
+     * An inexact value needs `options.rounding`: `'1/3 EUR'` throws without it.
+     */
+    toMoney(options) {
+        return Money.of(this.amount, this.currency, options);
+    }
+    /** `'1/3 EUR'`, `'5 EUR'`. */
+    toString() {
+        return `${this.amount.toString()} ${this.currency.code}`;
+    }
+    /** `{ amount: '1/3', currency: 'EUR' }`. */
+    toJSON() {
+        return { amount: this.amount.toString(), currency: this.currency.code };
+    }
+    /** Throws. Settle with `toMoney()` first. */
+    valueOf() {
+        return refuseCoercion();
+    }
+    [Symbol.toPrimitive](hint) {
+        return hint === 'string' ? this.toString() : refuseCoercion();
+    }
+    // A getter lives on the prototype; a field would add a slot to every value.
+    // eslint-disable-next-line @typescript-eslint/class-literal-property-style
+    get [Symbol.toStringTag]() {
+        return 'RationalMoney';
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return `RationalMoney(${this.toString()})`;
+    }
+    [Symbol.for('Deno.customInspect')]() {
+        return `RationalMoney(${this.toString()})`;
+    }
+}
+export function isRationalMoney(value) {
+    return value instanceof RationalMoney;
+}
+//# sourceMappingURL=rational.js.map

package/dist/rational.js.map

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

package/dist/stripe.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Stripe amounts. Stripe sends integers in its own units, which differ from
+ * ISO 4217 for some currencies. Rules from docs.stripe.com/currencies, read
+ * on 2026-10-12:
+ *
+ * - Zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF
+ *   (`500` is 500 JPY). MGA has 2 decimals in ISO but 0 at Stripe.
+ * - ISK and UGX: sent with two decimals that are always `00` (`500` is 5 ISK).
+ * - HUF and TWD: two-decimal charges; payouts must be divisible by 100.
+ * - Other currencies with 2 ISO decimals: two decimals.
+ *
+ * Stripe documents no rule for currencies with 3 or 4 ISO decimals, so those
+ * throw `ProviderAmountError` instead of being guessed. Whether your account
+ * can charge a currency, and its minimum and maximum amounts, are Stripe's to
+ * enforce; this module only gets the units right.
+ */
+import type { Currency, CurrencyLike } from './currency.js';
+import type { Money } from './money.js';
+import type { ProviderUnitRule } from './provider.js';
+/** When Stripe's rules in this module were last checked. */
+export declare const STRIPE_RULES_VERSION = "2026-10-12";
+export type StripeOperation = 'charge' | 'payout';
+/** Stripe's unit rule for a currency and operation. Throws `ProviderAmountError` where Stripe documents none. */
+export declare function stripeRule(currency: CurrencyLike, operation?: StripeOperation): ProviderUnitRule;
+/**
+ * `toStripeAmount(money('10.99', 'USD'))` → `1099`; `money(5, 'ISK')` → `500`.
+ * Throws `ProviderAmountError` for a negative amount or one Stripe cannot express (`10.50 MGA`).
+ */
+export declare function toStripeAmount(amount: Money, operation?: StripeOperation): number;
+/** `fromStripeAmount(1099, 'usd')` → `10.99 USD`. Accepts Stripe's lower-case codes. */
+export declare function fromStripeAmount(amount: number | bigint | string, currency: string | Currency, operation?: StripeOperation): Money;
+/** The `{ amount, currency }` pair a Stripe request takes: `{ amount: 1099, currency: 'usd' }`. */
+export declare function toStripe(amount: Money, operation?: StripeOperation): {
+    amount: number;
+    currency: string;
+};
+//# sourceMappingURL=stripe.d.ts.map

package/dist/stripe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../src/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAsBlD,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,GAAE,eAA0B,GAAG,gBAAgB,CAS1G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,GAAE,eAA0B,GAAG,MAAM,CAG3F;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAChC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAC3B,SAAS,GAAE,eAA0B,GACpC,KAAK,CAGP;AAED,mGAAmG;AACnG,wBAAgB,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,GAAE,eAA0B,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEnH"}