iso-price 1.0.3

package/dist/domain.operations/arithmetic/sumPrices.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.priceAdd = exports.priceSum = exports.addPrices = exports.sumPrices = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const IsoPriceExponent_1 = require("../../domain.objects/IsoPriceExponent");
+const asIsoPriceShape_1 = require("../cast/asIsoPriceShape");
+const asIsoPriceWords_1 = require("../cast/asIsoPriceWords");
+/**
+ * .what = gets the numeric exponent value from exponent string
+ * .why = needed for precision comparison and normalization
+ */
+const getExponentValue = (exponent) => {
+    const match = exponent.match(/\^(-?\d+)$/);
+    if (!match)
+        return -2; // default to centi
+    return parseInt(match[1], 10);
+};
+function sumPrices(...args) {
+    // parse args: array syntax vs spread syntax
+    let prices;
+    let options;
+    if (Array.isArray(args[0])) {
+        prices = args[0];
+        options = args[1];
+    }
+    else {
+        prices = args;
+        options = undefined;
+    }
+    // handle empty array
+    if (prices.length === 0) {
+        throw new helpful_errors_1.BadRequestError('cannot sum empty price array', { prices });
+    }
+    // convert all to shapes
+    const shapes = prices.map((p) => (0, asIsoPriceShape_1.asIsoPriceShape)(p));
+    // verify all currencies match
+    const currency = shapes[0].currency;
+    const mismatch = shapes.find((s) => s.currency !== currency);
+    if (mismatch) {
+        throw new helpful_errors_1.BadRequestError('currency mismatch in price sum', {
+            expected: currency,
+            found: mismatch.currency,
+            prices,
+        });
+    }
+    // find the highest precision (lowest exponent value)
+    const exponents = shapes.map((s) => s.exponent ?? IsoPriceExponent_1.IsoPriceExponent.CENTI);
+    const exponentValues = exponents.map(getExponentValue);
+    const targetExponentValue = Math.min(...exponentValues);
+    const targetExponent = exponents[exponentValues.indexOf(targetExponentValue)];
+    // normalize all amounts to target precision and sum
+    let total = 0n;
+    for (let i = 0; i < shapes.length; i++) {
+        const shape = shapes[i];
+        const currentExp = getExponentValue(shape.exponent ?? IsoPriceExponent_1.IsoPriceExponent.CENTI);
+        const shift = currentExp - targetExponentValue;
+        const normalizedAmount = shape.amount * 10n ** BigInt(shift);
+        total += normalizedAmount;
+    }
+    // build result shape
+    const resultShape = {
+        amount: total,
+        currency,
+        exponent: targetExponent,
+    };
+    // return in requested format
+    if (options?.format === 'shape') {
+        return resultShape;
+    }
+    return (0, asIsoPriceWords_1.asIsoPriceWords)(resultShape);
+}
+exports.sumPrices = sumPrices;
+/**
+ * .what = alias for sumPrices
+ * .why = provides semantic name for binary addition
+ */
+exports.addPrices = sumPrices;
+/**
+ * .what = alias for sumPrices
+ * .why = provides price-prefixed variant
+ */
+exports.priceSum = sumPrices;
+/**
+ * .what = alias for sumPrices
+ * .why = provides price-prefixed variant
+ */
+exports.priceAdd = sumPrices;
+//# sourceMappingURL=sumPrices.js.map

package/dist/domain.operations/arithmetic/sumPrices.js.map

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

package/dist/domain.operations/cast/asIsoPrice.d.ts

@@ -0,0 +1,35 @@
+import type { IsoPrice } from '../../domain.objects/IsoPrice';
+import type { IsoPriceWords } from '../../domain.objects/IsoPriceWords';
+/**
+ * .what = normalizes any price input to IsoPriceWords format
+ * .why = provides a single entry point for price conversion
+ *
+ * this is the recommended entry point for all price conversion:
+ * - accepts human format: '$50.37', '€100.00'
+ * - accepts words format: 'USD 50.37', 'EUR 100.00'
+ * - accepts shape format: { amount: 5037n, currency: 'USD' }
+ * - normalizes commas to underscores in output
+ *
+ * @example
+ * asIsoPrice('$50.37')
+ * // => 'USD 50.37'
+ *
+ * @example
+ * asIsoPrice('$50.37', { currency: 'CAD' })
+ * // => 'CAD 50.37'
+ *
+ * @example
+ * asIsoPrice('€50.37', { currency: 'USD' })
+ * // throws BadRequestError (symbol/currency mismatch)
+ *
+ * @example
+ * asIsoPrice('USD 1,000,000.00')
+ * // => 'USD 1_000_000.00'
+ */
+export declare const asIsoPrice: <TCurrency extends string = string>(input: IsoPrice<TCurrency> | string | {
+    amount: number | bigint;
+    currency: TCurrency;
+    exponent?: string;
+}, options?: {
+    currency?: TCurrency;
+}) => IsoPriceWords<TCurrency>;

package/dist/domain.operations/cast/asIsoPrice.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIsoPrice = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const isIsoPriceHuman_1 = require("../guard/isIsoPriceHuman");
+const asIsoPriceWords_1 = require("./asIsoPriceWords");
+/**
+ * .what = currency symbol to code mappings
+ * .why = validates symbol/currency consistency
+ */
+const SYMBOL_TO_CODE = {
+    $: 'USD',
+    '€': 'EUR',
+    '£': 'GBP',
+    '¥': 'JPY',
+    '₹': 'INR',
+    '₽': 'RUB',
+    '₩': 'KRW',
+    '₪': 'ILS',
+    '฿': 'THB',
+    '₫': 'VND',
+    kr: 'SEK',
+    R: 'ZAR',
+    zł: 'PLN',
+    Kč: 'CZK',
+    CHF: 'CHF',
+};
+/**
+ * .what = currencies that have unique, unambiguous symbols
+ * .why = throw on currency override if the target has a different unique symbol
+ *
+ * when a currency has a unique symbol (like EUR → €), a different input
+ * symbol (like $) with that currency is a clear mismatch.
+ *
+ * see `define.currency-symbols-lossy.md` for why symbols are ambiguous
+ */
+const UNIQUE_SYMBOL_CURRENCIES = {
+    EUR: '€',
+    // note: most other currencies share symbols ($ used by USD/CAD/AUD, etc.)
+    // so we only list currencies with truly unique symbols here
+};
+/**
+ * .what = detects the symbol used in a human format string
+ * .why = enables symbol/currency mismatch detection
+ */
+const detectSymbol = (value) => {
+    for (const symbol of Object.keys(SYMBOL_TO_CODE)) {
+        if (value.startsWith(symbol) ||
+            value.endsWith(symbol) ||
+            value.endsWith(` ${symbol}`)) {
+            return symbol;
+        }
+    }
+    return null;
+};
+/**
+ * .what = normalizes any price input to IsoPriceWords format
+ * .why = provides a single entry point for price conversion
+ *
+ * this is the recommended entry point for all price conversion:
+ * - accepts human format: '$50.37', '€100.00'
+ * - accepts words format: 'USD 50.37', 'EUR 100.00'
+ * - accepts shape format: { amount: 5037n, currency: 'USD' }
+ * - normalizes commas to underscores in output
+ *
+ * @example
+ * asIsoPrice('$50.37')
+ * // => 'USD 50.37'
+ *
+ * @example
+ * asIsoPrice('$50.37', { currency: 'CAD' })
+ * // => 'CAD 50.37'
+ *
+ * @example
+ * asIsoPrice('€50.37', { currency: 'USD' })
+ * // throws BadRequestError (symbol/currency mismatch)
+ *
+ * @example
+ * asIsoPrice('USD 1,000,000.00')
+ * // => 'USD 1_000_000.00'
+ */
+const asIsoPrice = (input, options) => {
+    // validate symbol/currency consistency for human format
+    if (typeof input === 'string' && (0, isIsoPriceHuman_1.isIsoPriceHuman)(input)) {
+        const symbol = detectSymbol(input);
+        if (symbol && options?.currency) {
+            const expectedCode = SYMBOL_TO_CODE[symbol];
+            // check if input symbol belongs to a unique-symbol currency
+            const expectedUniqueSymbol = expectedCode
+                ? UNIQUE_SYMBOL_CURRENCIES[expectedCode]
+                : undefined;
+            // check if override currency has a unique symbol
+            const targetUniqueSymbol = UNIQUE_SYMBOL_CURRENCIES[options.currency];
+            // if input symbol is unique to a currency, override must match that currency
+            // e.g., €50.37 + USD → throw (€ uniquely identifies EUR)
+            if (expectedUniqueSymbol && expectedCode !== options.currency) {
+                throw new helpful_errors_1.BadRequestError('symbol/currency mismatch', {
+                    symbol,
+                    expectedCode,
+                    providedCurrency: options.currency,
+                });
+            }
+            // if target currency has a unique symbol that differs from input, throw
+            // e.g., $50.37 + EUR → throw (EUR requires €, not $)
+            if (targetUniqueSymbol && targetUniqueSymbol !== symbol) {
+                throw new helpful_errors_1.BadRequestError('symbol/currency mismatch', {
+                    symbol,
+                    expectedCode,
+                    providedCurrency: options.currency,
+                });
+            }
+        }
+    }
+    return (0, asIsoPriceWords_1.asIsoPriceWords)(input, options);
+};
+exports.asIsoPrice = asIsoPrice;
+//# sourceMappingURL=asIsoPrice.js.map

package/dist/domain.operations/cast/asIsoPrice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asIsoPrice.js","sourceRoot":"","sources":["../../../src/domain.operations/cast/asIsoPrice.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAIjD,8DAA2D;AAC3D,uDAAoD;AAEpD;;;GAGG;AACH,MAAM,cAAc,GAA2B;IAC7C,CAAC,EAAE,KAAK;IACR,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,KAAK;IACT,CAAC,EAAE,KAAK;IACR,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,GAAG,EAAE,KAAK;CACX,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAA2B;IACvD,GAAG,EAAE,GAAG;IACR,0EAA0E;IAC1E,4DAA4D;CAC7D,CAAC;AAEF;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAC,KAAa,EAAiB,EAAE;IACpD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,IACE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YACxB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtB,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,EAC5B,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,MAAM,UAAU,GAAG,CACxB,KAGuE,EACvE,OAAkC,EACR,EAAE;IAC5B,wDAAwD;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,iCAAe,EAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAC5C,4DAA4D;YAC5D,MAAM,oBAAoB,GAAG,YAAY;gBACvC,CAAC,CAAC,wBAAwB,CAAC,YAAY,CAAC;gBACxC,CAAC,CAAC,SAAS,CAAC;YACd,iDAAiD;YACjD,MAAM,kBAAkB,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEtE,6EAA6E;YAC7E,yDAAyD;YACzD,IAAI,oBAAoB,IAAI,YAAY,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC9D,MAAM,IAAI,gCAAe,CAAC,0BAA0B,EAAE;oBACpD,MAAM;oBACN,YAAY;oBACZ,gBAAgB,EAAE,OAAO,CAAC,QAAQ;iBACnC,CAAC,CAAC;YACL,CAAC;YAED,wEAAwE;YACxE,qDAAqD;YACrD,IAAI,kBAAkB,IAAI,kBAAkB,KAAK,MAAM,EAAE,CAAC;gBACxD,MAAM,IAAI,gCAAe,CAAC,0BAA0B,EAAE;oBACpD,MAAM;oBACN,YAAY;oBACZ,gBAAgB,EAAE,OAAO,CAAC,QAAQ;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAA,iCAAe,EAAC,KAA4B,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC,CAAC;AA1CW,QAAA,UAAU,cA0CrB"}

package/dist/domain.operations/cast/asIsoPriceHuman.d.ts

@@ -0,0 +1,25 @@
+import type { IsoPrice } from '../../domain.objects/IsoPrice';
+import type { IsoPriceHuman } from '../../domain.objects/IsoPriceHuman';
+/**
+ * .what = converts any IsoPrice format to IsoPriceHuman (symbol format)
+ * .why = enables human-readable display with currency symbols
+ *
+ * @example
+ * asIsoPriceHuman('USD 50.37')
+ * // => '$50.37'
+ *
+ * @example
+ * asIsoPriceHuman({ amount: 5037n, currency: 'USD' })
+ * // => '$50.37'
+ *
+ * @example
+ * asIsoPriceHuman('USD 1_000_000.00')
+ * // => '$1,000,000.00'
+ */
+export declare const asIsoPriceHuman: <TCurrency extends string = string>(input: IsoPrice<TCurrency> | {
+    amount: number | bigint;
+    currency: TCurrency;
+    exponent?: string;
+} | string, options?: {
+    currency?: TCurrency;
+}) => IsoPriceHuman;

package/dist/domain.operations/cast/asIsoPriceHuman.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIsoPriceHuman = void 0;
+const IsoPriceExponent_1 = require("../../domain.objects/IsoPriceExponent");
+const getIsoPriceExponentByCurrency_1 = require("../precision/getIsoPriceExponentByCurrency");
+const asIsoPriceShape_1 = require("./asIsoPriceShape");
+/**
+ * .what = currency code to symbol mappings
+ * .why = enables conversion from iso 4217 codes to display symbols
+ */
+const CODE_TO_SYMBOL = {
+    USD: '$',
+    EUR: '€',
+    GBP: '£',
+    JPY: '¥',
+    CNY: '¥',
+    INR: '₹',
+    RUB: '₽',
+    KRW: '₩',
+    ILS: '₪',
+    THB: '฿',
+    VND: '₫',
+    SEK: 'kr',
+    NOK: 'kr',
+    DKK: 'kr',
+    ZAR: 'R',
+    BRL: 'R$',
+    PLN: 'zł',
+    CZK: 'Kč',
+    CHF: 'CHF',
+};
+/**
+ * .what = gets the decimal places for an exponent
+ * .why = determines how to format the amount string
+ */
+const getDecimalPlaces = (exponent) => {
+    const match = exponent.match(/\^(-?\d+)$/);
+    if (!match)
+        return 2;
+    return Math.abs(parseInt(match[1], 10));
+};
+/**
+ * .what = formats a bigint amount to human-readable string with commas
+ * .why = converts 5037n with exponent 2 to '50.37'
+ */
+const formatAmountHuman = (amount, exponent = IsoPriceExponent_1.IsoPriceExponent.CENTI) => {
+    const decimalPlaces = getDecimalPlaces(exponent);
+    const isNegative = amount < 0n;
+    const absAmount = isNegative ? -amount : amount;
+    // handle zero decimal places (whole units like JPY)
+    if (decimalPlaces === 0) {
+        const formattedInt = absAmount
+            .toString()
+            .replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+        return isNegative ? `-${formattedInt}` : formattedInt;
+    }
+    // convert to string and pad with zeros at start if needed
+    const amountStr = absAmount.toString().padStart(decimalPlaces + 1, '0');
+    // split into integer and decimal parts
+    const intPart = amountStr.slice(0, -decimalPlaces) || '0';
+    const decPart = amountStr.slice(-decimalPlaces);
+    // format integer part with comma thousands separators (human format)
+    const formattedInt = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    // build the result
+    const sign = isNegative ? '-' : '';
+    // for whole numbers at centi precision, show .00
+    if (decPart === '00' && decimalPlaces === 2) {
+        return `${sign}${formattedInt}.00`;
+    }
+    // omit zeros at end of decimal part for higher precision
+    const trimmedDec = decPart.replace(/0+$/, '');
+    if (trimmedDec.length === 0 && decimalPlaces > 2) {
+        return `${sign}${formattedInt}`;
+    }
+    return `${sign}${formattedInt}.${decPart}`;
+};
+/**
+ * .what = converts any IsoPrice format to IsoPriceHuman (symbol format)
+ * .why = enables human-readable display with currency symbols
+ *
+ * @example
+ * asIsoPriceHuman('USD 50.37')
+ * // => '$50.37'
+ *
+ * @example
+ * asIsoPriceHuman({ amount: 5037n, currency: 'USD' })
+ * // => '$50.37'
+ *
+ * @example
+ * asIsoPriceHuman('USD 1_000_000.00')
+ * // => '$1,000,000.00'
+ */
+const asIsoPriceHuman = (input, options) => {
+    // convert to shape first
+    const shape = (0, asIsoPriceShape_1.asIsoPriceShape)(input, options);
+    // get the symbol for this currency
+    const symbol = CODE_TO_SYMBOL[shape.currency] ?? shape.currency;
+    // use currency's standard exponent when shape.exponent is not set
+    const exponent = shape.exponent ?? (0, getIsoPriceExponentByCurrency_1.getIsoPriceExponentByCurrency)(shape.currency);
+    // format the amount with commas
+    const formatted = formatAmountHuman(shape.amount, exponent);
+    // build the human-readable string (symbol prefix)
+    return `${symbol}${formatted}`;
+};
+exports.asIsoPriceHuman = asIsoPriceHuman;
+//# sourceMappingURL=asIsoPriceHuman.js.map

package/dist/domain.operations/cast/asIsoPriceHuman.js.map

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

package/dist/domain.operations/cast/asIsoPriceShape.d.ts

@@ -0,0 +1,25 @@
+import type { IsoPrice } from '../../domain.objects/IsoPrice';
+import type { IsoPriceShape } from '../../domain.objects/IsoPriceShape';
+/**
+ * .what = converts any IsoPrice format to IsoPriceShape
+ * .why = enables uniform representation as shape for arithmetic operations
+ *
+ * @example
+ * asIsoPriceShape('USD 50.37')
+ * // => { amount: 5037n, currency: 'USD' }
+ *
+ * @example
+ * asIsoPriceShape({ amount: 5037, currency: 'USD' })
+ * // => { amount: 5037n, currency: 'USD' }  // number → bigint
+ *
+ * @example
+ * asIsoPriceShape('$50.37')
+ * // => { amount: 5037n, currency: 'USD' }
+ */
+export declare const asIsoPriceShape: <TCurrency extends string = string>(input: IsoPrice<TCurrency> | {
+    amount: number | bigint;
+    currency: TCurrency;
+    exponent?: string;
+} | string, options?: {
+    currency?: TCurrency;
+}) => IsoPriceShape<TCurrency>;

package/dist/domain.operations/cast/asIsoPriceShape.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asIsoPriceShape = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const IsoPriceExponent_1 = require("../../domain.objects/IsoPriceExponent");
+const isIsoPriceHuman_1 = require("../guard/isIsoPriceHuman");
+const isIsoPriceWords_1 = require("../guard/isIsoPriceWords");
+const getIsoPriceExponentByCurrency_1 = require("../precision/getIsoPriceExponentByCurrency");
+/**
+ * .what = currency symbol to code mappings
+ * .why = enables conversion from human format symbols to iso 4217 codes
+ */
+const SYMBOL_TO_CODE = {
+    $: 'USD',
+    '€': 'EUR',
+    '£': 'GBP',
+    '¥': 'JPY',
+    '₹': 'INR',
+    '₽': 'RUB',
+    '₩': 'KRW',
+    '₪': 'ILS',
+    '฿': 'THB',
+    '₫': 'VND',
+    kr: 'SEK',
+    R: 'ZAR',
+    zł: 'PLN',
+    Kč: 'CZK',
+    CHF: 'CHF',
+};
+/**
+ * .what = parses amount string to bigint in minor units
+ * .why = converts decimal string like '50.37' to bigint 5037n
+ */
+const parseAmountToMinorUnits = (amountStr, exponent = IsoPriceExponent_1.IsoPriceExponent.CENTI) => {
+    // get the decimal places for this exponent
+    const decimalPlaces = Math.abs(parseInt(exponent.split('^')[1] ?? '-2', 10));
+    // clean the string: remove underscores and commas
+    const cleaned = amountStr.replace(/[_,]/g, '');
+    // split into integer and decimal parts
+    const [intPart, decPart = ''] = cleaned.split('.');
+    // pad or truncate decimal part to match exponent
+    const paddedDecimal = decPart.padEnd(decimalPlaces, '0');
+    const truncatedDecimal = paddedDecimal.slice(0, decimalPlaces);
+    // detect if we need higher precision
+    if (decPart.length > decimalPlaces) {
+        // use the actual decimal length to determine exponent
+        const actualDecPlaces = decPart.length;
+        const exponentMap = {
+            0: IsoPriceExponent_1.IsoPriceExponent.WHOLE,
+            2: IsoPriceExponent_1.IsoPriceExponent.CENTI,
+            3: IsoPriceExponent_1.IsoPriceExponent.MILLI,
+            6: IsoPriceExponent_1.IsoPriceExponent.MICRO,
+            9: IsoPriceExponent_1.IsoPriceExponent.NANO,
+            12: IsoPriceExponent_1.IsoPriceExponent.PICO,
+        };
+        // find the smallest exponent that fits
+        const newExponent = Object.entries(exponentMap)
+            .filter(([places]) => parseInt(places) >= actualDecPlaces)
+            .sort((a, b) => parseInt(a[0]) - parseInt(b[0]))[0]?.[1] ??
+            IsoPriceExponent_1.IsoPriceExponent.PICO;
+        const newDecPlaces = Math.abs(parseInt(newExponent.split('^')[1] ?? '-2', 10));
+        const fullDecimal = decPart.padEnd(newDecPlaces, '0');
+        return {
+            amount: BigInt(`${intPart ?? '0'}${fullDecimal}`),
+            exponent: newExponent,
+        };
+    }
+    // combine integer and decimal parts
+    const combined = `${intPart ?? '0'}${truncatedDecimal}`;
+    return {
+        amount: BigInt(combined),
+        exponent,
+    };
+};
+/**
+ * .what = extracts currency code and amount from words format
+ * .why = parses 'USD 50.37' into { currency: 'USD', amount: '50.37' }
+ */
+const parseWordsFormat = (value) => {
+    const match = value.match(/^([A-Z]{3}) (.+)$/);
+    if (!match)
+        throw new helpful_errors_1.BadRequestError('invalid words format', { value });
+    return { currency: match[1], amountStr: match[2] };
+};
+/**
+ * .what = extracts currency code and amount from human format
+ * .why = parses '$50.37' or '50.37 €' into { currency: 'USD', amount: '50.37' }
+ */
+const parseHumanFormat = (value, options) => {
+    // try prefix symbols
+    for (const [symbol, code] of Object.entries(SYMBOL_TO_CODE)) {
+        if (value.startsWith(symbol)) {
+            const amountStr = value.slice(symbol.length);
+            const currency = options?.currency ?? code;
+            return { currency, amountStr };
+        }
+    }
+    // try suffix symbols
+    for (const [symbol, code] of Object.entries(SYMBOL_TO_CODE)) {
+        if (value.endsWith(symbol) || value.endsWith(` ${symbol}`)) {
+            const amountStr = value.replace(new RegExp(`\\s*${symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`), '');
+            const currency = options?.currency ?? code;
+            return { currency, amountStr };
+        }
+    }
+    throw new helpful_errors_1.BadRequestError('unable to parse human format', { value });
+};
+/**
+ * .what = converts any IsoPrice format to IsoPriceShape
+ * .why = enables uniform representation as shape for arithmetic operations
+ *
+ * @example
+ * asIsoPriceShape('USD 50.37')
+ * // => { amount: 5037n, currency: 'USD' }
+ *
+ * @example
+ * asIsoPriceShape({ amount: 5037, currency: 'USD' })
+ * // => { amount: 5037n, currency: 'USD' }  // number → bigint
+ *
+ * @example
+ * asIsoPriceShape('$50.37')
+ * // => { amount: 5037n, currency: 'USD' }
+ */
+const asIsoPriceShape = (input, options) => {
+    // handle shape format (may need number → bigint conversion)
+    if (typeof input === 'object' &&
+        input !== null &&
+        'amount' in input &&
+        'currency' in input) {
+        const amount = typeof input.amount === 'bigint' ? input.amount : BigInt(input.amount);
+        return {
+            amount,
+            currency: input.currency,
+            exponent: input.exponent,
+        };
+    }
+    // handle words format
+    if ((0, isIsoPriceWords_1.isIsoPriceWords)(input)) {
+        const { currency, amountStr } = parseWordsFormat(input);
+        const currencyExponent = (0, getIsoPriceExponentByCurrency_1.getIsoPriceExponentByCurrency)(currency);
+        const { amount, exponent } = parseAmountToMinorUnits(amountStr, currencyExponent);
+        // only include exponent if it differs from currency's standard exponent
+        return {
+            amount,
+            currency: currency,
+            ...(exponent !== currencyExponent ? { exponent } : {}),
+        };
+    }
+    // handle human format
+    if ((0, isIsoPriceHuman_1.isIsoPriceHuman)(input)) {
+        const { currency, amountStr } = parseHumanFormat(input, options);
+        const currencyExponent = (0, getIsoPriceExponentByCurrency_1.getIsoPriceExponentByCurrency)(currency);
+        const { amount, exponent } = parseAmountToMinorUnits(amountStr, currencyExponent);
+        // only include exponent if it differs from currency's standard exponent
+        return {
+            amount,
+            currency: currency,
+            ...(exponent !== currencyExponent ? { exponent } : {}),
+        };
+    }
+    throw new helpful_errors_1.BadRequestError('unable to convert to IsoPriceShape', { input });
+};
+exports.asIsoPriceShape = asIsoPriceShape;
+//# sourceMappingURL=asIsoPriceShape.js.map

package/dist/domain.operations/cast/asIsoPriceShape.js.map

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

package/dist/domain.operations/cast/asIsoPriceWords.d.ts

@@ -0,0 +1,25 @@
+import type { IsoPrice } from '../../domain.objects/IsoPrice';
+import type { IsoPriceWords } from '../../domain.objects/IsoPriceWords';
+/**
+ * .what = converts any IsoPrice format to IsoPriceWords
+ * .why = enables uniform representation as words for serialization
+ *
+ * @example
+ * asIsoPriceWords({ amount: 5037n, currency: 'USD' })
+ * // => 'USD 50.37'
+ *
+ * @example
+ * asIsoPriceWords('$50.37')
+ * // => 'USD 50.37'
+ *
+ * @example
+ * asIsoPriceWords({ amount: 1000000n, currency: 'USD' })
+ * // => 'USD 10_000.00'
+ */
+export declare const asIsoPriceWords: <TCurrency extends string = string>(input: IsoPrice<TCurrency> | {
+    amount: number | bigint;
+    currency: TCurrency;
+    exponent?: string;
+} | string, options?: {
+    currency?: TCurrency;
+}) => IsoPriceWords<TCurrency>;