@ducatjs/money 0.0.0 → 0.2.0

package/dist/schema.js

@@ -0,0 +1,77 @@
+import { isCurrency } from './currency.js';
+import { MAX_DECIMAL_SCALE } from './decimal.js';
+import { money } from './money.js';
+import { Rounding } from './rounding.js';
+/** The default `maxDigits`: far beyond any real amount, small enough to be cheap to reject. */
+export const DEFAULT_MAX_DIGITS = 50;
+const MODES = new Set(Object.values(Rounding));
+/**
+ * @internal Checks the options when the schema is built, so a mistake there throws at once
+ * instead of turning every input into a validation error.
+ */
+export function checkSchemaOptions(options) {
+    if (options === undefined) {
+        return;
+    }
+    const allowed = options.currency;
+    const codes = typeof allowed === 'string' || allowed === undefined ? [allowed] : allowed;
+    for (const code of codes) {
+        if (code !== undefined && !isCurrency(code)) {
+            throw new RangeError(`Unknown currency ${String(code)}`);
+        }
+    }
+    const scale = options.scale;
+    if (scale !== undefined &&
+        !(Number.isInteger(scale) && scale >= 0 && scale <= MAX_DECIMAL_SCALE)) {
+        throw new RangeError(`Invalid scale ${scale}`);
+    }
+    if (options.rounding !== undefined && !MODES.has(options.rounding)) {
+        throw new RangeError(`Invalid rounding mode ${String(options.rounding)}`);
+    }
+    const maxDigits = options.maxDigits;
+    if (maxDigits !== undefined && !(Number.isSafeInteger(maxDigits) && maxDigits >= 1)) {
+        throw new RangeError(`Invalid maxDigits ${maxDigits}`);
+    }
+}
+// The exact decimal strings `toJSON` writes: an optional minus, digits, and an optional fraction.
+// No exponent, no plus sign, no whitespace and no grouping, so the wire format stays unambiguous.
+const DECIMAL = /^-?\d+(?:\.\d+)?$/;
+/**
+ * @internal Reads `{ amount, currency }` (already known to have two string fields) into Money, or
+ * says what is wrong with it. Shared by the Zod and Valibot entries, so both accept exactly the
+ * same inputs.
+ */
+export function readMoneyJSON(json, options) {
+    const currency = json.currency;
+    const allowed = options?.currency;
+    if (allowed === undefined) {
+        if (!isCurrency(currency)) {
+            return { field: 'currency', message: `Unknown currency "${currency}"` };
+        }
+    }
+    else if (typeof allowed === 'string' ? currency !== allowed : !allowed.includes(currency)) {
+        const expected = typeof allowed === 'string' ? allowed : allowed.join(', ');
+        return { field: 'currency', message: `Expected currency ${expected}, got "${currency}"` };
+    }
+    const amount = json.amount;
+    // Checked before the pattern, so a huge string is rejected without scanning it.
+    const maxLength = (options?.maxDigits ?? DEFAULT_MAX_DIGITS) + 2;
+    if (amount.length > maxLength || !DECIMAL.test(amount)) {
+        return { field: 'amount', message: 'Expected a decimal string such as "12.34"' };
+    }
+    const digitCount = amount.length - (amount[0] === '-' ? 1 : 0) - (amount.includes('.') ? 1 : 0);
+    if (digitCount > (options?.maxDigits ?? DEFAULT_MAX_DIGITS)) {
+        return {
+            field: 'amount',
+            message: `More than ${options?.maxDigits ?? DEFAULT_MAX_DIGITS} digits`,
+        };
+    }
+    try {
+        return money(amount, currency, options);
+    }
+    catch (error) {
+        // the options are checked up front, so this is too many decimals for the scale
+        return { field: 'amount', message: error.message };
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/sql.d.ts

@@ -0,0 +1,54 @@
+import { type Money } from './money.js';
+/** The declared size of a NUMERIC/DECIMAL column. */
+export interface DecimalColumnSize {
+    /** Total number of significant digits the column holds. */
+    readonly precision: number;
+    /** Digits after the decimal point. */
+    readonly scale: number;
+}
+/** NUMERIC(19,4): 15 integer digits and 4 decimals, enough for every ISO 4217 exponent. */
+export declare const DEFAULT_DECIMAL_SIZE: DecimalColumnSize;
+/** Throws unless the money is in the column's currency (when the column has a fixed currency). */
+export declare function checkCurrency(money: Money, currency: string | undefined): void;
+/**
+ * Throws unless the money is at its currency's exponent. Columns store amounts at the currency's
+ * scale, so a value with sub-minor digits would have to be rounded, and the caller should choose how.
+ */
+export declare function checkIsoScale(money: Money): void;
+/**
+ * Minor units for a BIGINT column, as a bigint. Throws beyond the column's range, ±9.2·10^18:
+ * MySQL outside strict mode would store the nearest limit instead.
+ */
+export declare function minorToDriver(money: Money, currency: string | undefined): bigint;
+/**
+ * Money from a BIGINT driver value. Accepts a bigint, a safe-integer number, or an integer string
+ * (node-postgres returns int8 as a string). A number beyond 2^53 has already lost digits, so it
+ * throws.
+ */
+export declare function minorFromDriver<C extends string>(value: unknown, currency: C): Money<C>;
+/** Throws if a decimal column of this size would round amounts in this currency. */
+export declare function checkDecimalSize(currency: string, size: DecimalColumnSize): void;
+/**
+ * The exact decimal string for a NUMERIC/DECIMAL column. Throws if the column could not hold it
+ * unchanged: MySQL outside strict mode clamps an out-of-range value instead of failing.
+ */
+export declare function decimalToDriver(money: Money, currency: string | undefined, size: DecimalColumnSize | undefined): string;
+/**
+ * Throws if the decimal (the money's `toDecimal`) has more integer digits than a column of this
+ * size holds: Postgres rejects it, and MySQL outside strict mode clamps it.
+ */
+export declare function checkIntegerDigits(money: Money, decimal: string, size: DecimalColumnSize): void;
+/**
+ * Money from a NUMERIC/DECIMAL driver value, which must be a string: a number has been through a
+ * float. Trailing zeros (`12.3400` from NUMERIC(19,4)) are fine; more decimals than the currency
+ * has, `NaN` and `Infinity` throw.
+ */
+export declare function decimalFromDriver<C extends string>(value: unknown, currency: C): Money<C>;
+/** `{"amount":"12.34","currency":"EUR"}` for a JSON, JSONB or TEXT column. */
+export declare function jsonToDriver(money: Money, currency: string | undefined): string;
+/**
+ * Money from a JSON column: the parsed object (JSONB in node-postgres, JSON in mysql2) or the
+ * text (SQLite).
+ */
+export declare function jsonFromDriver<C extends string>(value: unknown, currency: C | undefined): Money<C>;
+//# sourceMappingURL=sql.d.ts.map

package/dist/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,KAAK,EAEX,MAAM,YAAY,CAAC;AAOpB,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,EAAE,iBAA+C,CAAC;AAEnF,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI9E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAOhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAShF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAWvF;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAkBhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAClC,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAU/F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAQzF;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,GAAG,SAAS,GACtB,KAAK,CAAC,CAAC,CAAC,CAOV"}

package/dist/sql.js

@@ -0,0 +1,131 @@
+// Conversions between Money and the values SQL drivers send and receive, shared by the ORM and
+// query-builder integrations (`/drizzle/*`, `/kysely`). Every reader is strict: a driver value that
+// may already have lost digits (an unsafe number, a float for a DECIMAL) is rejected rather than
+// trusted, and every writer refuses a value the column would change.
+import { currencyExponent } from './currency.js';
+import { CurrencyMismatchError, fromJSON, fromMinor, money as parseMoney, toDecimal, toMinor, } from './money.js';
+const INTEGER_TEXT = /^-?\d+$/;
+// a BIGINT (SQLite INTEGER) column's range: MySQL outside strict mode clips anything beyond it
+const BIGINT_MIN = -(2n ** 63n);
+const BIGINT_MAX = 2n ** 63n - 1n;
+/** NUMERIC(19,4): 15 integer digits and 4 decimals, enough for every ISO 4217 exponent. */
+export const DEFAULT_DECIMAL_SIZE = { precision: 19, scale: 4 };
+/** Throws unless the money is in the column's currency (when the column has a fixed currency). */
+export function checkCurrency(money, currency) {
+    if (currency !== undefined && money.currency !== currency) {
+        throw new CurrencyMismatchError(currency, money.currency);
+    }
+}
+/**
+ * Throws unless the money is at its currency's exponent. Columns store amounts at the currency's
+ * scale, so a value with sub-minor digits would have to be rounded, and the caller should choose how.
+ */
+export function checkIsoScale(money) {
+    const exponent = currencyExponent(money.currency);
+    if (money.scale !== exponent) {
+        throw new RangeError(`${money} has scale ${money.scale}; round() it to ${exponent} decimals before storing it`);
+    }
+}
+/**
+ * Minor units for a BIGINT column, as a bigint. Throws beyond the column's range, ±9.2·10^18:
+ * MySQL outside strict mode would store the nearest limit instead.
+ */
+export function minorToDriver(money, currency) {
+    checkCurrency(money, currency);
+    checkIsoScale(money);
+    const minor = toMinor(money);
+    if (minor < BIGINT_MIN || minor > BIGINT_MAX) {
+        throw new RangeError(`${money} is ${minor} minor units, beyond the range of a BIGINT column`);
+    }
+    return minor;
+}
+/**
+ * Money from a BIGINT driver value. Accepts a bigint, a safe-integer number, or an integer string
+ * (node-postgres returns int8 as a string). A number beyond 2^53 has already lost digits, so it
+ * throws.
+ */
+export function minorFromDriver(value, currency) {
+    if (typeof value === 'string') {
+        if (!INTEGER_TEXT.test(value)) {
+            throw new SyntaxError(`Expected an integer from a BIGINT column, got "${value}"`);
+        }
+        return fromMinor(BigInt(value), currency);
+    }
+    if (typeof value === 'number' || typeof value === 'bigint') {
+        return fromMinor(value, currency);
+    }
+    throw new TypeError(`Expected an integer from a BIGINT column, got ${typeof value}`);
+}
+/** Throws if a decimal column of this size would round amounts in this currency. */
+export function checkDecimalSize(currency, size) {
+    const { precision, scale } = size;
+    const isValidSize = Number.isInteger(precision) &&
+        Number.isInteger(scale) &&
+        precision >= 1 &&
+        scale >= 0 &&
+        scale <= precision;
+    if (!isValidSize) {
+        throw new RangeError(`NUMERIC(${precision},${scale}) is not a valid column size`);
+    }
+    const exponent = currencyExponent(currency);
+    if (size.scale < exponent) {
+        throw new RangeError(`NUMERIC(${size.precision},${size.scale}) would round ${currency}, which has ${exponent} decimals`);
+    }
+}
+/**
+ * The exact decimal string for a NUMERIC/DECIMAL column. Throws if the column could not hold it
+ * unchanged: MySQL outside strict mode clamps an out-of-range value instead of failing.
+ */
+export function decimalToDriver(money, currency, size) {
+    checkCurrency(money, currency);
+    checkIsoScale(money);
+    const decimal = toDecimal(money);
+    if (size !== undefined) {
+        checkIntegerDigits(money, decimal, size);
+    }
+    return decimal;
+}
+/**
+ * Throws if the decimal (the money's `toDecimal`) has more integer digits than a column of this
+ * size holds: Postgres rejects it, and MySQL outside strict mode clamps it.
+ */
+export function checkIntegerDigits(money, decimal, size) {
+    const integerPart = decimal.replace('-', '').split('.')[0];
+    // "0.12" has no integer digits: NUMERIC(4,4) holds it
+    const integerDigits = integerPart === '0' ? 0 : integerPart.length;
+    if (integerDigits > size.precision - size.scale) {
+        throw new RangeError(`${money} does not fit NUMERIC(${size.precision},${size.scale}), which holds ` +
+            `${size.precision - size.scale} integer digits`);
+    }
+}
+/**
+ * Money from a NUMERIC/DECIMAL driver value, which must be a string: a number has been through a
+ * float. Trailing zeros (`12.3400` from NUMERIC(19,4)) are fine; more decimals than the currency
+ * has, `NaN` and `Infinity` throw.
+ */
+export function decimalFromDriver(value, currency) {
+    if (typeof value !== 'string') {
+        throw new TypeError(`Expected a string from a DECIMAL column, got ${typeof value}; ` +
+            'configure the driver to return decimals as strings');
+    }
+    return parseMoney(value, currency);
+}
+/** `{"amount":"12.34","currency":"EUR"}` for a JSON, JSONB or TEXT column. */
+export function jsonToDriver(money, currency) {
+    checkCurrency(money, currency);
+    checkIsoScale(money);
+    return JSON.stringify(money);
+}
+/**
+ * Money from a JSON column: the parsed object (JSONB in node-postgres, JSON in mysql2) or the
+ * text (SQLite).
+ */
+export function jsonFromDriver(value, currency) {
+    if (typeof value !== 'string' && (typeof value !== 'object' || value === null)) {
+        throw new TypeError(`Expected JSON from a money column, got ${String(value)}`);
+    }
+    const parsed = fromJSON(value);
+    checkCurrency(parsed, currency);
+    return parsed;
+}
+//# sourceMappingURL=sql.js.map

package/dist/sql.js.map

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

package/dist/stripe-fx.d.ts

@@ -0,0 +1,22 @@
+import type { Money } from './money.js';
+import { type Rate } from './rate.js';
+/** The fields of a Stripe BalanceTransaction used here. */
+export interface StripeBalanceTransaction {
+    readonly amount: number;
+    readonly currency: string;
+    readonly exchange_rate?: number | null;
+    /** Seconds since the Unix epoch. */
+    readonly created?: number;
+}
+/**
+ * The rate Stripe quotes on a balance transaction, from the charge currency `from` to the balance
+ * currency: "the amount in currency A, multiplied by the exchange_rate, equals the amount in
+ * currency B". The JSON number is read at its shortest decimal form, so 1.234 is exactly 1234/1000.
+ * `asOf` is the balance transaction's `created` time, the closest timestamp Stripe gives for the
+ * conversion; it is not the charge's creation time, and Stripe doesn't say when the rate was
+ * quoted. `undefined` when nothing was converted.
+ */
+export declare function stripeRate<From extends string>(from: From, transaction: StripeBalanceTransaction): Rate<Uppercase<From>, Uppercase<string>> | undefined;
+/** The exact rate Stripe applied: the balance transaction's gross amount ÷ the charged amount. */
+export declare function stripeImpliedRate<From extends string>(charged: Money<From>, transaction: StripeBalanceTransaction): Rate<From, Uppercase<string>>;
+//# sourceMappingURL=stripe-fx.d.ts.map

package/dist/stripe-fx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-fx.d.ts","sourceRoot":"","sources":["../src/stripe-fx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAA6B,KAAK,IAAI,EAAiB,MAAM,WAAW,CAAC;AAGhF,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AASD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAOtD;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,MAAM,EACnD,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,EACpB,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAG/B"}

package/dist/stripe-fx.js

@@ -0,0 +1,30 @@
+import { exchangeRate, impliedRate } from './rate.js';
+import { fromStripe } from './stripe.js';
+function stripeInfo(transaction) {
+    if (transaction.created === undefined) {
+        return { source: 'stripe' };
+    }
+    return { source: 'stripe', asOf: new Date(transaction.created * 1000) };
+}
+/**
+ * The rate Stripe quotes on a balance transaction, from the charge currency `from` to the balance
+ * currency: "the amount in currency A, multiplied by the exchange_rate, equals the amount in
+ * currency B". The JSON number is read at its shortest decimal form, so 1.234 is exactly 1234/1000.
+ * `asOf` is the balance transaction's `created` time, the closest timestamp Stripe gives for the
+ * conversion; it is not the charge's creation time, and Stripe doesn't say when the rate was
+ * quoted. `undefined` when nothing was converted.
+ */
+export function stripeRate(from, transaction) {
+    if (transaction.exchange_rate === undefined || transaction.exchange_rate === null) {
+        return undefined;
+    }
+    const charged = from.toUpperCase();
+    const balance = transaction.currency.toUpperCase();
+    return exchangeRate(charged, balance, transaction.exchange_rate, stripeInfo(transaction));
+}
+/** The exact rate Stripe applied: the balance transaction's gross amount ÷ the charged amount. */
+export function stripeImpliedRate(charged, transaction) {
+    const settled = fromStripe(transaction.amount, transaction.currency.toUpperCase());
+    return impliedRate(charged, settled, stripeInfo(transaction));
+}
+//# sourceMappingURL=stripe-fx.js.map

package/dist/stripe-fx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe-fx.js","sourceRoot":"","sources":["../src/stripe-fx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,WAAW,EAA4B,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,SAAS,UAAU,CAAC,WAAqC;IACvD,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAU,EACV,WAAqC;IAErC,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,IAAI,WAAW,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAqB,CAAC;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAuB,CAAC;IACxE,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAC/B,OAAoB,EACpB,WAAqC;IAErC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnF,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/stripe.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Stripe's minor-unit view. Stripe uses ISO exponents except where documented otherwise
+ * (https://docs.stripe.com/currencies, encoded in data/stripe.json):
+ * - zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF (note MGA: ISO says
+ *   2)
+ * - ISK, UGX: sent as two-decimal values whose last two digits are 00 (5 ISK -> 500)
+ * - HUF, TWD: two decimals for charges, but payouts must be whole units (multiple of 100)
+ * - BHD JOD KWD OMR TND: three decimals, last digit must be 0 (UAE accounts only)
+ */
+import { STRIPE_RULES } from './generated/stripe.js';
+import { type CurrencyInput, type Money } from './money.js';
+import type { RoundingMode } from './rounding.js';
+export { STRIPE_RULES };
+/** Whether Stripe supports the currency as a presentment currency. */
+export declare const isStripeCurrency: (currency: string) => boolean;
+/** The exponent Stripe's API uses for a currency (ISK 2, JPY 0, KWD 3, MGA 0). */
+export declare const stripeExponent: (currency: string) => number;
+/**
+ * Options for the Stripe amount: payout rules and how to round when Stripe needs a coarser amount.
+ */
+export interface StripeAmountOptions {
+    /** Payout amounts have stricter rules (HUF, TWD: whole units). */
+    readonly payout?: boolean;
+    /** How to round when Stripe needs a coarser amount (default 'unnecessary': throw). */
+    readonly rounding?: RoundingMode;
+}
+/** The integer `amount` to send to Stripe, e.g. toStripeAmount(money('5', 'ISK')) === 500. */
+export declare function toStripeAmount(money: Money, options?: StripeAmountOptions): number;
+/** `{ amount, currency }` with Stripe's lowercase currency code, ready for a PaymentIntent. */
+export declare function toStripe(money: Money, options?: StripeAmountOptions): {
+    amount: number;
+    currency: string;
+};
+/** Reads a Stripe amount (e.g. from a webhook): fromStripe(500, 'isk') is 5 ISK. */
+export declare function fromStripe<C extends CurrencyInput>(amount: number | bigint, currency: C): Money<Uppercase<C>>;
+//# 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;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,CAAC;AAUxB,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,OACA,CAAC;AAErD,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAA2B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;CAClC;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CASlF;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CACtB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEtC;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,CAAC,SAAS,aAAa,EAChD,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,CAAC,GACV,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAGrB"}

package/dist/stripe.js

@@ -0,0 +1,39 @@
+/**
+ * Stripe's minor-unit view. Stripe uses ISO exponents except where documented otherwise
+ * (https://docs.stripe.com/currencies, encoded in data/stripe.json):
+ * - zero-decimal: BIF CLP DJF GNF JPY KMF KRW MGA PYG RWF VND VUV XAF XOF XPF (note MGA: ISO says
+ *   2)
+ * - ISK, UGX: sent as two-decimal values whose last two digits are 00 (5 ISK -> 500)
+ * - HUF, TWD: two decimals for charges, but payouts must be whole units (multiple of 100)
+ * - BHD JOD KWD OMR TND: three decimals, last digit must be 0 (UAE accounts only)
+ */
+import { STRIPE_RULES } from './generated/stripe.js';
+import {} from './money.js';
+import { fromProcessorAmount, toProcessorAmount } from './processor.js';
+export { STRIPE_RULES };
+function rule(currency) {
+    const found = STRIPE_RULES[currency.toUpperCase()];
+    if (!found) {
+        throw new RangeError(`${currency} is not a Stripe presentment currency`);
+    }
+    return found;
+}
+/** Whether Stripe supports the currency as a presentment currency. */
+export const isStripeCurrency = (currency) => STRIPE_RULES[currency.toUpperCase()] !== undefined;
+/** The exponent Stripe's API uses for a currency (ISK 2, JPY 0, KWD 3, MGA 0). */
+export const stripeExponent = (currency) => rule(currency)[0];
+/** The integer `amount` to send to Stripe, e.g. toStripeAmount(money('5', 'ISK')) === 500. */
+export function toStripeAmount(money, options) {
+    const [exp, charge, payout] = rule(money.currency);
+    return toProcessorAmount('Stripe', money, exp, options?.payout ? payout : charge, options?.rounding ?? 'unnecessary');
+}
+/** `{ amount, currency }` with Stripe's lowercase currency code, ready for a PaymentIntent. */
+export function toStripe(money, options) {
+    return { amount: toStripeAmount(money, options), currency: money.currency.toLowerCase() };
+}
+/** Reads a Stripe amount (e.g. from a webhook): fromStripe(500, 'isk') is 5 ISK. */
+export function fromStripe(amount, currency) {
+    const code = currency.toUpperCase();
+    return fromProcessorAmount('Stripe', amount, code, rule(code)[0]);
+}
+//# sourceMappingURL=stripe.js.map

package/dist/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../src/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAkC,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,SAAS,IAAI,CAAC,QAAgB;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC,GAAG,QAAQ,uCAAuC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAW,EAAE,CAC5D,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,SAAS,CAAC;AAErD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAY9E,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAA6B;IACxE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,iBAAiB,CACtB,QAAQ,EACR,KAAK,EACL,GAAG,EACH,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EACjC,OAAO,EAAE,QAAQ,IAAI,aAAa,CACnC,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,OAA6B;IAE7B,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;AAC5F,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CACxB,MAAuB,EACvB,QAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAkB,CAAC;IACpD,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/tax.d.ts

@@ -0,0 +1,33 @@
+import { type Factor } from './decimal.js';
+import { type Money, type RoundingInput } from './money.js';
+/**
+ * percent% of m: percentage(EUR 80, '12.5', 'halfEven') = EUR 10.00. Rounding defaults to
+ * 'halfExpand'.
+ */
+export declare function percentage<C extends string>(money: Money<C>, percent: Factor, rounding?: RoundingInput): Money<C>;
+/** A tax split: net + tax is always exactly gross. */
+export interface TaxBreakdown<C extends string> {
+    readonly net: Money<C>;
+    readonly tax: Money<C>;
+    /** Always exactly net + tax. */
+    readonly gross: Money<C>;
+}
+/**
+ * Tax-exclusive: adds percent% tax to a net amount. addTax(EUR 10, '20', 'halfEven') -> net 10, tax
+ * 2, gross 12. A rounding mode rounds the tax; a rounding policy rounds the gross (the amount
+ * charged) to its scale and increment. The other part is always the exact difference.
+ */
+export declare function addTax<C extends string>(net: Money<C>, percent: Factor, rounding?: RoundingInput): TaxBreakdown<C>;
+/**
+ * Tax-inclusive: extracts percent% tax contained in a gross amount (VAT extraction).
+ * net = gross / (1 + percent/100) rounded; tax = gross - net, so the parts always add up.
+ * extractTax(EUR 12, '20', 'halfEven') -> net 10.00, tax 2.00. A rounding policy rounds the net; the
+ * tax is on the policy's increment too whenever the gross is.
+ */
+export declare function extractTax<C extends string>(gross: Money<C>, percent: Factor, rounding?: RoundingInput): TaxBreakdown<C>;
+/**
+ * Price after a percent% discount. A rounding mode rounds the discount amount; a rounding policy
+ * rounds the discounted price itself, so the price lands on the policy's scale and increment.
+ */
+export declare function discount<C extends string>(price: Money<C>, percent: Factor, rounding?: RoundingInput): Money<C>;
+//# sourceMappingURL=tax.d.ts.map

package/dist/tax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax.d.ts","sourceRoot":"","sources":["../src/tax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,MAAM,EAAc,MAAM,cAAc,CAAC;AAC9D,OAAO,EAKL,KAAK,KAAK,EACV,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAgC,GACzC,KAAK,CAAC,CAAC,CAAC,CAEV;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM;IAC5C,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EACrC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAgC,GACzC,YAAY,CAAC,CAAC,CAAC,CAejB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAgC,GACzC,YAAY,CAAC,CAAC,CAAC,CASjB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,aAAgC,GACzC,KAAK,CAAC,CAAC,CAAC,CAUV"}

package/dist/tax.js

@@ -0,0 +1,55 @@
+import { ratio } from './decimal.js';
+import { add, multiplyByRatio, roundWithPolicy, subtract, } from './money.js';
+import { DEFAULT_ROUNDING } from './rounding.js';
+const percentRatio = (percent) => {
+    const asRatio = ratio(percent);
+    return ratio(asRatio.num, asRatio.den * 100n);
+};
+/**
+ * percent% of m: percentage(EUR 80, '12.5', 'halfEven') = EUR 10.00. Rounding defaults to
+ * 'halfExpand'.
+ */
+export function percentage(money, percent, rounding = DEFAULT_ROUNDING) {
+    return multiplyByRatio(money, percentRatio(percent), rounding);
+}
+/**
+ * Tax-exclusive: adds percent% tax to a net amount. addTax(EUR 10, '20', 'halfEven') -> net 10, tax
+ * 2, gross 12. A rounding mode rounds the tax; a rounding policy rounds the gross (the amount
+ * charged) to its scale and increment. The other part is always the exact difference.
+ */
+export function addTax(net, percent, rounding = DEFAULT_ROUNDING) {
+    // A rounding mode rounds the tax; a policy rounds the gross, the amount charged, so it lands on
+    // the policy's increment (CHF 0.05 for cash). Either way the other part is the exact difference.
+    if (typeof rounding === 'function') {
+        const percentAsRatio = ratio(percent);
+        const gross = roundWithPolicy(net, ratio(100n * percentAsRatio.den + percentAsRatio.num, 100n * percentAsRatio.den), rounding);
+        return { net, tax: subtract(gross, net), gross };
+    }
+    const tax = multiplyByRatio(net, percentRatio(percent), rounding);
+    const gross = add(net, tax);
+    return { net, tax, gross };
+}
+/**
+ * Tax-inclusive: extracts percent% tax contained in a gross amount (VAT extraction).
+ * net = gross / (1 + percent/100) rounded; tax = gross - net, so the parts always add up.
+ * extractTax(EUR 12, '20', 'halfEven') -> net 10.00, tax 2.00. A rounding policy rounds the net; the
+ * tax is on the policy's increment too whenever the gross is.
+ */
+export function extractTax(gross, percent, rounding = DEFAULT_ROUNDING) {
+    const percentAsRatio = ratio(percent);
+    // 1 / (1 + p/100) = 100 den / (100 den + num)
+    const net = multiplyByRatio(gross, ratio(100n * percentAsRatio.den, 100n * percentAsRatio.den + percentAsRatio.num), rounding);
+    return { net, tax: subtract(gross, net), gross };
+}
+/**
+ * Price after a percent% discount. A rounding mode rounds the discount amount; a rounding policy
+ * rounds the discounted price itself, so the price lands on the policy's scale and increment.
+ */
+export function discount(price, percent, rounding = DEFAULT_ROUNDING) {
+    if (typeof rounding === 'function') {
+        const percentAsRatio = ratio(percent);
+        return roundWithPolicy(price, ratio(100n * percentAsRatio.den - percentAsRatio.num, 100n * percentAsRatio.den), rounding);
+    }
+    return subtract(price, multiplyByRatio(price, percentRatio(percent), rounding));
+}
+//# sourceMappingURL=tax.js.map

package/dist/tax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax.js","sourceRoot":"","sources":["../src/tax.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA2B,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,GAAG,EACH,eAAe,EACf,eAAe,EACf,QAAQ,GAGT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,YAAY,GAAG,CAAC,OAAe,EAAS,EAAE;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,KAAe,EACf,OAAe,EACf,WAA0B,gBAAgB;IAE1C,OAAO,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACpB,GAAa,EACb,OAAe,EACf,WAA0B,gBAAgB;IAE1C,gGAAgG;IAChG,iGAAiG;IACjG,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,eAAe,CAC3B,GAAG,EACH,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,EAChF,QAAQ,CACT,CAAC;QACF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAAe,EACf,OAAe,EACf,WAA0B,gBAAgB;IAE1C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,8CAA8C;IAC9C,MAAM,GAAG,GAAG,eAAe,CACzB,KAAK,EACL,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,cAAc,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,EAChF,QAAQ,CACT,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAe,EACf,OAAe,EACf,WAA0B,gBAAgB;IAE1C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,eAAe,CACpB,KAAK,EACL,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,EAChF,QAAQ,CACT,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/testing/arbitraries.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `@ducatjs/money/testing/arbitraries`: fast-check arbitraries for property tests. They cover what
+ * hand-written cases tend to miss: amounts beyond 2^53 (bigint minor units), currencies with
+ * unusual exponents (JPY 0, KWD 3, CLF 4) and scales above the currency's exponent. fast-check is
+ * an optional peer dependency, needed only for this entry.
+ */
+import fc from 'fast-check';
+import { type Money } from '../money.js';
+/** Options for `arbCurrency`. */
+export interface ArbCurrencyOptions {
+    /** Only currencies with one of these exponents (default: the representative mix). */
+    readonly exponents?: readonly number[];
+    /** Draw from every ISO 4217 code instead of the representative mix. */
+    readonly all?: boolean;
+    /** More codes to draw from, such as ones registered with `defineCurrency`. */
+    readonly extra?: readonly string[];
+}
+/**
+ * Currency codes, by default a representative mix of exponents 0, 2, 3 and 4 (JPY, EUR, KWD,
+ * CLF...). `{ all: true }` draws from every ISO 4217 code, `extra` adds codes (custom ones from
+ * `defineCurrency`), and `exponents` narrows whichever pool that is.
+ */
+export declare function arbCurrency(options?: ArbCurrencyOptions): fc.Arbitrary<string>;
+/** Options for `arbMoney`. */
+export interface ArbMoneyOptions<C extends string = string> {
+    /** The currency, or an arbitrary of currencies (default: `arbCurrency()`). */
+    readonly currency?: C | fc.Arbitrary<C>;
+    /** The smallest amount, in major units (default: none, down to -10^30 minor units). */
+    readonly min?: string | number | bigint;
+    /** The largest amount, in major units (default: none, up to 10^30 minor units). */
+    readonly max?: string | number | bigint;
+    /**
+     * The scale, or an arbitrary of scales. By default mostly the currency's exponent, sometimes up
+     * to three more decimals.
+     */
+    readonly scale?: number | fc.Arbitrary<number>;
+}
+/**
+ * Money values for property tests: `arbMoney()`, `arbMoney({ currency: 'EUR', min: '0', max:
+ * '100' })`. With bounds, every value is within them; without, minor units reach ±10^30.
+ */
+export declare function arbMoney<C extends string = string>(options?: ArbMoneyOptions<C>): fc.Arbitrary<Money<C>>;
+//# sourceMappingURL=arbitraries.d.ts.map

package/dist/testing/arbitraries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitraries.d.ts","sourceRoot":"","sources":["../../src/testing/arbitraries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,OAAO,EAAoB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAK3D,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAYlF;AAED,8BAA8B;AAC9B,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACxD,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxC,uFAAuF;IACvF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CAChD;AA0BD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAChD,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA6CxB"}