@vielzeug/coins 3.0.0 → 26.10.1

package/dist/money.js.map

@@ -1 +1 @@
-{"version":3,"file":"money.js","names":[],"sources":["../src/money.ts"],"sourcesContent":["import { decimal, roundDivision, toDecimalString } from './_decimal';\nimport { currency, isCurrency } from './currency';\nimport { CoinsError, CurrencyMismatchError } from './errors';\nimport type { Currency, Money, RoundingMode } from './types';\n\nconst canonicalMoney = new WeakSet<object>();\n\nconst defaultRounding: RoundingMode = 'halfAwayFromZero';\n\nconst INTEGER = /^(?:0|-[1-9]\\d*|[1-9]\\d*)$/;\nconst MAX_INTEGER_DIGITS = 1000;\n\nexport function money<C extends Currency>(amount: string, currency: C, options?: { rounding?: RoundingMode }): Money<C>;\nexport function money<C extends Currency>(amount: bigint, currency: C, options: { unit: 'minor' }): Money<C>;\nexport function money<C extends Currency>(\n  amount: bigint | string,\n  currency: C,\n  options?: { rounding?: RoundingMode } | { unit: 'minor' },\n): Money<C> {\n  assertCurrency(currency);\n\n  if (typeof amount === 'bigint') {\n    if (!options || !('unit' in options) || options.unit !== 'minor') {\n      throw new CoinsError('INVALID_MONEY', \"Bigint amounts require { unit: 'minor' }\");\n    }\n\n    return createMoney(amount, currency);\n  }\n\n  if (options && 'unit' in options)\n    throw new CoinsError('INVALID_MONEY', 'Decimal strings do not accept a unit option');\n\n  const value = decimal(amount);\n  const scaled = value.numerator * 10n ** BigInt(currency.minorUnit);\n  const remainder = scaled % value.denominator;\n\n  if (remainder !== 0n && options?.rounding === undefined) {\n    throw new CoinsError('INVALID_MONEY', `Amount \"${amount}\" exceeds ${currency.code} precision; provide rounding`);\n  }\n\n  return createMoney(roundDivision(scaled, value.denominator, options?.rounding ?? defaultRounding), currency);\n}\n\n/**\n * Decodes untrusted/persisted data into canonical `Money`.\n * Accepts either a plain `Money`-shaped object (`{ amount: bigint, currency: Currency }`)\n * or a `MoneyJSON`-shaped object (`{ amount: string, currency: string, unit: 'minor' }`).\n * Use `money()` for trusted construction; use `decodeMoney()` for network/storage data.\n */\nexport function decodeMoney(value: unknown, options?: { currency?: (code: string) => Currency }): Money {\n  if (!isPlainDataObject(value)) throw new CoinsError('INVALID_MONEY', 'Money must be a plain data object');\n\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  const amountDescriptor = descriptors.amount;\n  const currencyDescriptor = descriptors.currency;\n\n  if (!isDataProperty(amountDescriptor) || !isDataProperty(currencyDescriptor)) {\n    throw new CoinsError('INVALID_MONEY', 'Money properties must be plain data values');\n  }\n\n  const ownKeys = Reflect.ownKeys(value);\n\n  // Plain Money: bigint amount + registered currency\n  if (typeof amountDescriptor.value === 'bigint' && isCurrency(currencyDescriptor.value)) {\n    if (ownKeys.length !== 2) {\n      throw new CoinsError('INVALID_MONEY', 'Plain money must have exactly the keys amount and currency');\n    }\n\n    return createMoney(amountDescriptor.value, currencyDescriptor.value);\n  }\n\n  // MoneyJSON: string amount + string currency code + unit: 'minor'\n  const unitDescriptor = descriptors.unit;\n  if (\n    typeof amountDescriptor.value === 'string' &&\n    typeof currencyDescriptor.value === 'string' &&\n    isDataProperty(unitDescriptor) &&\n    unitDescriptor.value === 'minor'\n  ) {\n    if (ownKeys.length !== 3) {\n      throw new CoinsError('INVALID_MONEY', 'MoneyJSON must have exactly the keys amount, currency, unit');\n    }\n    if (amountDescriptor.value.length > MAX_INTEGER_DIGITS) {\n      throw new CoinsError('INVALID_MONEY', `Money JSON amount is too long; maximum ${MAX_INTEGER_DIGITS} characters`);\n    }\n    if (!INTEGER.test(amountDescriptor.value)) {\n      throw new CoinsError('INVALID_MONEY', `Invalid Money JSON amount \"${amountDescriptor.value}\"`);\n    }\n    const resolveCurrency = options?.currency ?? currency;\n    try {\n      const resolvedCurrency = resolveCurrency(currencyDescriptor.value);\n\n      if (!isCurrency(resolvedCurrency) || resolvedCurrency.code !== currencyDescriptor.value) {\n        throw new CoinsError(\n          'INVALID_CURRENCY',\n          `Currency resolver must return the canonical \"${currencyDescriptor.value}\" definition`,\n        );\n      }\n\n      return money(BigInt(amountDescriptor.value), resolvedCurrency, { unit: 'minor' });\n    } catch (error) {\n      throw new CoinsError('INVALID_MONEY', `Invalid Money JSON for currency \"${currencyDescriptor.value}\"`, {\n        cause: error,\n      });\n    }\n  }\n\n  throw new CoinsError(\n    'INVALID_MONEY',\n    'Money must contain bigint amount and a registered currency, or a valid MoneyJSON shape',\n  );\n}\n\nexport function isMoney(value: unknown): value is Money {\n  return typeof value === 'object' && value !== null && canonicalMoney.has(value);\n}\n\nexport function add<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): Money<C> {\n  assertSameCurrency(left, right);\n\n  return createMoney(left.amount + right.amount, left.currency);\n}\n\nexport function subtract<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): Money<C> {\n  assertSameCurrency(left, right);\n\n  return createMoney(left.amount - right.amount, left.currency);\n}\n\nexport function multiply<C extends Currency>(\n  value: Money<C>,\n  factor: string,\n  options: { rounding?: RoundingMode } = {},\n): Money<C> {\n  assertMoney(value);\n\n  const scalar = decimal(factor);\n\n  return createMoney(\n    roundDivision(value.amount * scalar.numerator, scalar.denominator, options.rounding ?? defaultRounding),\n    value.currency,\n  );\n}\n\nexport function divide<C extends Currency>(\n  value: Money<C>,\n  divisor: string,\n  options: { rounding?: RoundingMode } = {},\n): Money<C> {\n  assertMoney(value);\n\n  const scalar = decimal(divisor);\n\n  if (scalar.numerator === 0n) throw new CoinsError('DIVISION_BY_ZERO', 'Cannot divide money by zero');\n\n  const divisorMagnitude = scalar.numerator < 0n ? -scalar.numerator : scalar.numerator;\n  const dividend = value.amount * scalar.denominator;\n  const quotient = roundDivision(\n    scalar.numerator < 0n ? -dividend : dividend,\n    divisorMagnitude,\n    options.rounding ?? defaultRounding,\n  );\n\n  return createMoney(quotient, value.currency);\n}\n\nexport function compare<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): -1 | 0 | 1 {\n  assertSameCurrency(left, right);\n\n  return left.amount === right.amount ? 0 : left.amount < right.amount ? -1 : 1;\n}\n\nexport function clamp<C extends Currency>(\n  value: Money<C>,\n  options: { max: Money<NoInfer<C>>; min: Money<NoInfer<C>> },\n): Money<C> {\n  if (compare(options.min, options.max) === 1) {\n    throw new CoinsError('INVALID_RANGE', 'Clamp minimum cannot exceed maximum');\n  }\n\n  return compare(value, options.min) === -1 ? options.min : compare(value, options.max) === 1 ? options.max : value;\n}\n\nexport function abs<C extends Currency>(value: Money<C>): Money<C> {\n  assertMoney(value);\n\n  return createMoney(value.amount < 0n ? -value.amount : value.amount, value.currency);\n}\n\nexport function negate<C extends Currency>(value: Money<C>): Money<C> {\n  assertMoney(value);\n\n  return createMoney(-value.amount, value.currency);\n}\n\nexport function round<C extends Currency>(\n  value: Money<C>,\n  options: { fractionDigits: number; rounding?: RoundingMode },\n): Money<C> {\n  assertMoney(value);\n\n  const { fractionDigits, rounding = defaultRounding } = options;\n\n  if (!Number.isInteger(fractionDigits) || fractionDigits < 0 || fractionDigits > value.currency.minorUnit) {\n    throw new CoinsError('INVALID_ROUNDING', `fractionDigits must be an integer from 0 to ${value.currency.minorUnit}`);\n  }\n\n  const factor = 10n ** BigInt(value.currency.minorUnit - fractionDigits);\n\n  return createMoney(roundDivision(value.amount, factor, rounding) * factor, value.currency);\n}\n\nexport function toDecimal(value: Money): string {\n  assertMoney(value);\n\n  return toDecimalString(value.amount, value.currency.minorUnit);\n}\n\nexport function createMoney<C extends Currency>(amount: bigint, currency: C): Money<C> {\n  const value = Object.freeze({ amount, currency }) as Money<C>;\n\n  canonicalMoney.add(value);\n\n  return value;\n}\n\nexport function assertMoney(value: unknown): asserts value is Money {\n  if (!isMoney(value)) {\n    throw new CoinsError('INVALID_MONEY', 'Money must be a canonical @vielzeug/coins value');\n  }\n}\n\nfunction assertSameCurrency(left: Money, right: Money): void {\n  assertMoney(left);\n  assertMoney(right);\n\n  if (left.currency !== right.currency) {\n    throw new CurrencyMismatchError(left.currency.code, right.currency.code);\n  }\n}\n\nfunction assertCurrency(value: unknown): asserts value is Currency {\n  if (!isCurrency(value)) throw new CoinsError('INVALID_CURRENCY', 'Money requires a registered currency');\n}\n\nfunction isPlainDataObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction isDataProperty(\n  descriptor: PropertyDescriptor | undefined,\n): descriptor is PropertyDescriptor & { value: unknown } {\n  return (\n    descriptor !== undefined && 'value' in descriptor && descriptor.get === undefined && descriptor.set === undefined\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"money.js","names":[],"sources":["../src/money.ts"],"sourcesContent":["import { decimal, roundDivision, toDecimalString } from './_decimal';\nimport { currency, isCurrency } from './currency';\nimport { CoinsError, CurrencyMismatchError } from './errors';\nimport type { Currency, Money, RoundingMode } from './types';\n\nconst canonicalMoney = new WeakSet<object>();\n\nconst defaultRounding: RoundingMode = 'halfAwayFromZero';\n\nconst INTEGER = /^(?:0|-[1-9]\\d*|[1-9]\\d*)$/;\nconst MAX_INTEGER_DIGITS = 1000;\n\nexport function money<C extends Currency>(amount: string, currency: C, options?: { rounding?: RoundingMode }): Money<C>;\nexport function money<C extends Currency>(amount: bigint, currency: C, options: { unit: 'minor' }): Money<C>;\nexport function money<C extends Currency>(\n  amount: bigint | string,\n  currency: C,\n  options?: { rounding?: RoundingMode } | { unit: 'minor' },\n): Money<C> {\n  assertCurrency(currency);\n\n  if (typeof amount === 'bigint') {\n    if (!options || !('unit' in options) || options.unit !== 'minor') {\n      throw new CoinsError('INVALID_MONEY', \"Bigint amounts require { unit: 'minor' }\");\n    }\n\n    return createMoney(amount, currency);\n  }\n\n  if (options && 'unit' in options)\n    throw new CoinsError('INVALID_MONEY', 'Decimal strings do not accept a unit option');\n\n  const value = decimal(amount);\n  const scaled = value.numerator * 10n ** BigInt(currency.minorUnit);\n  const remainder = scaled % value.denominator;\n\n  if (remainder !== 0n && options?.rounding === undefined) {\n    throw new CoinsError('INVALID_MONEY', `Amount \"${amount}\" exceeds ${currency.code} precision; provide rounding`);\n  }\n\n  return createMoney(roundDivision(scaled, value.denominator, options?.rounding ?? defaultRounding), currency);\n}\n\n/**\n * Decodes untrusted/persisted data into canonical `Money`.\n * Accepts either a plain `Money`-shaped object (`{ amount: bigint, currency: Currency }`)\n * or a `MoneyJSON`-shaped object (`{ amount: string, currency: string, unit: 'minor' }`).\n * Use `money()` for trusted construction; use `decodeMoney()` for network/storage data.\n */\nexport function decodeMoney(value: unknown, options?: { currency?: (code: string) => Currency }): Money {\n  if (!isPlainDataObject(value)) throw new CoinsError('INVALID_MONEY', 'Money must be a plain data object');\n\n  const descriptors = Object.getOwnPropertyDescriptors(value);\n  const amountDescriptor = descriptors.amount;\n  const currencyDescriptor = descriptors.currency;\n\n  if (!isDataProperty(amountDescriptor) || !isDataProperty(currencyDescriptor)) {\n    throw new CoinsError('INVALID_MONEY', 'Money properties must be plain data values');\n  }\n\n  const ownKeys = Reflect.ownKeys(value);\n\n  // Plain Money: bigint amount + registered currency\n  if (typeof amountDescriptor.value === 'bigint' && isCurrency(currencyDescriptor.value)) {\n    if (ownKeys.length !== 2) {\n      throw new CoinsError('INVALID_MONEY', 'Plain money must have exactly the keys amount and currency');\n    }\n\n    return createMoney(amountDescriptor.value, currencyDescriptor.value);\n  }\n\n  // MoneyJSON: string amount + string currency code + unit: 'minor'\n  const unitDescriptor = descriptors.unit;\n  if (\n    typeof amountDescriptor.value === 'string' &&\n    typeof currencyDescriptor.value === 'string' &&\n    isDataProperty(unitDescriptor) &&\n    unitDescriptor.value === 'minor'\n  ) {\n    if (ownKeys.length !== 3) {\n      throw new CoinsError('INVALID_MONEY', 'MoneyJSON must have exactly the keys amount, currency, unit');\n    }\n    if (amountDescriptor.value.length > MAX_INTEGER_DIGITS) {\n      throw new CoinsError('INVALID_MONEY', `Money JSON amount is too long; maximum ${MAX_INTEGER_DIGITS} characters`);\n    }\n    if (!INTEGER.test(amountDescriptor.value)) {\n      throw new CoinsError('INVALID_MONEY', `Invalid Money JSON amount \"${amountDescriptor.value}\"`);\n    }\n    const resolveCurrency = options?.currency ?? currency;\n    try {\n      const resolvedCurrency = resolveCurrency(currencyDescriptor.value);\n\n      if (!isCurrency(resolvedCurrency) || resolvedCurrency.code !== currencyDescriptor.value) {\n        throw new CoinsError(\n          'INVALID_CURRENCY',\n          `Currency resolver must return the canonical \"${currencyDescriptor.value}\" definition`,\n        );\n      }\n\n      return money(BigInt(amountDescriptor.value), resolvedCurrency, { unit: 'minor' });\n    } catch (error) {\n      throw new CoinsError('INVALID_MONEY', `Invalid Money JSON for currency \"${currencyDescriptor.value}\"`, {\n        cause: error,\n      });\n    }\n  }\n\n  throw new CoinsError(\n    'INVALID_MONEY',\n    'Money must contain bigint amount and a registered currency, or a valid MoneyJSON shape',\n  );\n}\n\nexport function isMoney(value: unknown): value is Money {\n  return typeof value === 'object' && value !== null && canonicalMoney.has(value);\n}\n\nexport function add<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): Money<C> {\n  assertSameCurrency(left, right);\n\n  return createMoney(left.amount + right.amount, left.currency);\n}\n\nexport function subtract<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): Money<C> {\n  assertSameCurrency(left, right);\n\n  return createMoney(left.amount - right.amount, left.currency);\n}\n\nexport function multiply<C extends Currency>(\n  value: Money<C>,\n  factor: string,\n  options: { rounding?: RoundingMode } = {},\n): Money<C> {\n  assertMoney(value);\n\n  const scalar = decimal(factor);\n\n  return createMoney(\n    roundDivision(value.amount * scalar.numerator, scalar.denominator, options.rounding ?? defaultRounding),\n    value.currency,\n  );\n}\n\nexport function divide<C extends Currency>(\n  value: Money<C>,\n  divisor: string,\n  options: { rounding?: RoundingMode } = {},\n): Money<C> {\n  assertMoney(value);\n\n  const scalar = decimal(divisor);\n\n  if (scalar.numerator === 0n) throw new CoinsError('DIVISION_BY_ZERO', 'Cannot divide money by zero');\n\n  const divisorMagnitude = scalar.numerator < 0n ? -scalar.numerator : scalar.numerator;\n  const dividend = value.amount * scalar.denominator;\n  const quotient = roundDivision(\n    scalar.numerator < 0n ? -dividend : dividend,\n    divisorMagnitude,\n    options.rounding ?? defaultRounding,\n  );\n\n  return createMoney(quotient, value.currency);\n}\n\nexport function compare<C extends Currency>(left: Money<C>, right: Money<NoInfer<C>>): -1 | 0 | 1 {\n  assertSameCurrency(left, right);\n\n  return left.amount === right.amount ? 0 : left.amount < right.amount ? -1 : 1;\n}\n\nexport function clamp<C extends Currency>(\n  value: Money<C>,\n  options: { max: Money<NoInfer<C>>; min: Money<NoInfer<C>> },\n): Money<C> {\n  if (compare(options.min, options.max) === 1) {\n    throw new CoinsError('INVALID_RANGE', 'Clamp minimum cannot exceed maximum');\n  }\n\n  return compare(value, options.min) === -1 ? options.min : compare(value, options.max) === 1 ? options.max : value;\n}\n\nexport function abs<C extends Currency>(value: Money<C>): Money<C> {\n  assertMoney(value);\n\n  return createMoney(value.amount < 0n ? -value.amount : value.amount, value.currency);\n}\n\nexport function negate<C extends Currency>(value: Money<C>): Money<C> {\n  assertMoney(value);\n\n  return createMoney(-value.amount, value.currency);\n}\n\nexport function round<C extends Currency>(\n  value: Money<C>,\n  options: { fractionDigits: number; rounding?: RoundingMode },\n): Money<C> {\n  assertMoney(value);\n\n  const { fractionDigits, rounding = defaultRounding } = options;\n\n  if (!Number.isInteger(fractionDigits) || fractionDigits < 0 || fractionDigits > value.currency.minorUnit) {\n    throw new CoinsError('INVALID_ROUNDING', `fractionDigits must be an integer from 0 to ${value.currency.minorUnit}`);\n  }\n\n  const factor = 10n ** BigInt(value.currency.minorUnit - fractionDigits);\n\n  return createMoney(roundDivision(value.amount, factor, rounding) * factor, value.currency);\n}\n\nexport function toDecimal(value: Money): string {\n  assertMoney(value);\n\n  return toDecimalString(value.amount, value.currency.minorUnit);\n}\n\nexport function createMoney<C extends Currency>(amount: bigint, currency: C): Money<C> {\n  const value = Object.freeze({ amount, currency }) as Money<C>;\n\n  canonicalMoney.add(value);\n\n  return value;\n}\n\nexport function assertMoney(value: unknown): asserts value is Money {\n  if (!isMoney(value)) {\n    throw new CoinsError('INVALID_MONEY', 'Money must be a canonical @vielzeug/coins value');\n  }\n}\n\nfunction assertSameCurrency(left: Money, right: Money): void {\n  assertMoney(left);\n  assertMoney(right);\n\n  if (left.currency !== right.currency) {\n    throw new CurrencyMismatchError(left.currency.code, right.currency.code);\n  }\n}\n\nfunction assertCurrency(value: unknown): asserts value is Currency {\n  if (!isCurrency(value)) throw new CoinsError('INVALID_CURRENCY', 'Money requires a registered currency');\n}\n\nfunction isPlainDataObject(value: unknown): value is Record<PropertyKey, unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction isDataProperty(\n  descriptor: PropertyDescriptor | undefined,\n): descriptor is PropertyDescriptor & { value: unknown } {\n  return (\n    descriptor !== undefined && 'value' in descriptor && descriptor.get === undefined && descriptor.set === undefined\n  );\n}\n"],"mappings":"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"}

package/dist/serialization.cjs

@@ -1,2 +1,2 @@
-const e=require("./money.cjs");function t(t){return e.assertMoney(t),{amount:t.amount.toString(),currency:t.currency.code,unit:`minor`}}exports.toJSON=t;
+const e=require("./money.cjs");function toJSON(t){return e.assertMoney(t),{amount:t.amount.toString(),currency:t.currency.code,unit:`minor`}}exports.toJSON=toJSON;
 //# sourceMappingURL=serialization.cjs.map

package/dist/serialization.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.cjs","names":[],"sources":["../src/serialization.ts"],"sourcesContent":["import { assertMoney } from './money';\nimport type { Money, MoneyJSON } from './types';\n\nexport function toJSON(value: Money): MoneyJSON {\n  assertMoney(value);\n\n  return { amount: value.amount.toString(), currency: value.currency.code, unit: 'minor' };\n}\n"],"mappings":"+BAGA,SAAgB,EAAO,EAAyB,CAG9C,OAFA,EAAA,YAAY,CAAK,EAEV,CAAE,OAAQ,EAAM,OAAO,SAAS,EAAG,SAAU,EAAM,SAAS,KAAM,KAAM,OAAQ,CACzF"}
+{"version":3,"file":"serialization.cjs","names":[],"sources":["../src/serialization.ts"],"sourcesContent":["import { assertMoney } from './money';\nimport type { Money, MoneyJSON } from './types';\n\nexport function toJSON(value: Money): MoneyJSON {\n  assertMoney(value);\n\n  return { amount: value.amount.toString(), currency: value.currency.code, unit: 'minor' };\n}\n"],"mappings":"+BAGA,SAAgB,OAAO,EAAyB,CAG9C,OAFA,EAAA,YAAY,CAAK,EAEV,CAAE,OAAQ,EAAM,OAAO,SAAS,EAAG,SAAU,EAAM,SAAS,KAAM,KAAM,OAAQ,CACzF"}

package/dist/serialization.js

@@ -1,13 +1,2 @@
-import { assertMoney as e } from "./money.js";
-//#region src/serialization.ts
-function t(t) {
-	return e(t), {
-		amount: t.amount.toString(),
-		currency: t.currency.code,
-		unit: "minor"
-	};
-}
-//#endregion
-export { t as toJSON };
-
+import{assertMoney as e}from"./money.js";function toJSON(t){return e(t),{amount:t.amount.toString(),currency:t.currency.code,unit:`minor`}}export{toJSON};
 //# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.js","names":[],"sources":["../src/serialization.ts"],"sourcesContent":["import { assertMoney } from './money';\nimport type { Money, MoneyJSON } from './types';\n\nexport function toJSON(value: Money): MoneyJSON {\n  assertMoney(value);\n\n  return { amount: value.amount.toString(), currency: value.currency.code, unit: 'minor' };\n}\n"],"mappings":";;AAGA,SAAgB,EAAO,GAAyB;CAG9C,OAFA,EAAY,CAAK,GAEV;EAAE,QAAQ,EAAM,OAAO,SAAS;EAAG,UAAU,EAAM,SAAS;EAAM,MAAM;CAAQ;AACzF"}
+{"version":3,"file":"serialization.js","names":[],"sources":["../src/serialization.ts"],"sourcesContent":["import { assertMoney } from './money';\nimport type { Money, MoneyJSON } from './types';\n\nexport function toJSON(value: Money): MoneyJSON {\n  assertMoney(value);\n\n  return { amount: value.amount.toString(), currency: value.currency.code, unit: 'minor' };\n}\n"],"mappings":"yCAGA,SAAgB,OAAO,EAAyB,CAG9C,OAFA,EAAY,CAAK,EAEV,CAAE,OAAQ,EAAM,OAAO,SAAS,EAAG,SAAU,EAAM,SAAS,KAAM,KAAM,OAAQ,CACzF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vielzeug/coins",
-  "version": "3.0.0",
-  "description": "Bigint-based monetary arithmetic with currency formatting, exchange rates, and rounding policies",
+  "version": "26.10.1",
+  "description": "Currency formatting and exchange utilities for monetary arithmetic",
   "repository": {
     "type": "git",
     "url": "https://github.com/helmuthdu/vielzeug",
@@ -40,9 +40,9 @@
     "verify:exports": "node verify-exports.mjs"
   },
   "devDependencies": {
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.6.2",
     "typescript": "^6.0.3",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1"
   }
 }