soff-money 0.1.0 → 0.2.0

package/README.md

@@ -1,25 +1,45 @@
-# soff-money 💸
+# Soff Money
+
+[![npm](https://img.shields.io/npm/v/soff-money)](https://www.npmjs.com/package/soff-money)
+[![License](https://img.shields.io/github/license/bledxs/soff-monorepo)](LICENSE)
+[![Build Status](https://github.com/bledxs/soff-monorepo/actions/workflows/ci.yml/badge.svg)](https://github.com/bledxs/soff-monorepo/actions)
+[![codecov](https://codecov.io/gh/bledxs/soff-monorepo/branch/master/graph/badge.svg)](https://codecov.io/gh/bledxs/soff-monorepo)
+[![minzipped size](https://img.shields.io/bundlephobia/minzip/soff-money)](https://bundlephobia.com/package/soff-money)
 
 Safe money handling for JavaScript with integer-based arithmetic and LATAM locale formatting.
 
-## The Problem
+**Zero dependencies** · **TypeScript** · **~8KB core**
+
+## Table of Contents
+
+- [Soff Money](#soff-money)
+  - [Table of Contents](#table-of-contents)
+  - [Why?](#why)
+  - [Install](#install)
+  - [Quick Start](#quick-start)
+  - [Fair Distribution](#fair-distribution)
+    - [Proportional Distribution](#proportional-distribution)
+  - [Available Locales](#available-locales)
+  - [API Reference](#api-reference)
+    - [Creating Money](#creating-money)
+    - [Arithmetic Operations](#arithmetic-operations)
+    - [Percentage Operations](#percentage-operations)
+    - [Min/Max Operations](#minmax-operations)
+    - [Comparisons](#comparisons)
+    - [Formatting](#formatting)
+  - [Static Methods](#static-methods)
+  - [Bundle Size](#bundle-size)
+  - [Contributing](#contributing)
+  - [License](#license)
+  - [Documentation](#documentation)
+
+## Why?
 
 In JavaScript, `0.1 + 0.2 === 0.30000000000000004`. This is fatal for e-commerce or financial applications. Additionally, formatting currencies in Latin America is painful - does the symbol go before or after? Dots or commas for thousands?
 
-## The Solution
-
-A library that handles money using integers (Safe Money pattern) and formats according to the country's locale.
-
-## Features
-
-- 🔢 **Integer-based arithmetic** - No floating point errors
-- 🌎 **LATAM-first locales** - CO, MX, AR, BR, US
-- 🌳 **Tree-shakeable** - Import only what you need
-- 📦 **Tiny bundle** - Core is < 2KB gzipped
-- 💯 **TypeScript** - Full type safety
-- ⚡ **Zero dependencies** - Pure JavaScript
+This library handles money using integers (Safe Money pattern) and formats according to the country's locale.
 
-## Installation
+## Install
 
 ```bash
 npm install soff-money
@@ -28,30 +48,30 @@ npm install soff-money
 ## Quick Start
 
 ```typescript
-import { Money } from 'soff-money';
-import { COP } from 'soff-money/locales/co';
+import { Money, COP, USD } from 'soff-money';
 
-// Create money from cents (safe)
-const price = Money.fromCents(10000, COP); // $100.00 COP
+// Create money from decimal (safe - converted to cents internally)
+const price = Money.fromDecimal(1500000, COP);
 
-// Arithmetic operations
-const total = price.add(Money.fromCents(5000, COP)); // $150.00
-const discounted = total.multiply(0.9); // $135.00
+// Arithmetic operations (all return new Money instances)
+const withTax = price.addPercentage(19); // Add 19% tax
+const discounted = withTax.subtractPercentage(10); // 10% discount
 
 // Format for display
-console.log(total.format()); // "$ 150,00" or "$150.00" depending on locale
+console.log(price.format()); // "$ 1.500.000,00"
+console.log(discounted.format()); // "$ 1.606.500,00"
 
-// Safe distribution (no lost cents!)
-const [part1, part2, part3] = Money.fromCents(10000, COP).distribute(3);
-// 33.34 + 33.33 + 33.33 = 100.00 ✓
+// Safe comparisons
+price.equals(Money.fromDecimal(1500000, COP)); // true
+price.greaterThan(discounted); // false
 ```
 
-## Killer Feature: Fair Distribution
+## Fair Distribution
 
 When splitting money, you never lose cents:
 
 ```typescript
-const bill = Money.fromCents(10000, COP); // $100.00
+const bill = Money.fromDecimal(100, USD);
 const [alice, bob, charlie] = bill.distribute(3);
 
 // alice:   $33.34
@@ -60,16 +80,152 @@ const [alice, bob, charlie] = bill.distribute(3);
 // Total:   $100.00 ✓ (not $99.99!)
 ```
 
+The extra cent goes to the first person - no money is lost!
+
+### Proportional Distribution
+
+```typescript
+const total = Money.fromDecimal(100, USD);
+const [share1, share2, share3] = total.distributeByRatios([1, 2, 2]);
+
+// share1: $20.00 (20%)
+// share2: $40.00 (40%)
+// share3: $40.00 (40%)
+```
+
 ## Available Locales
 
-| Locale | Currency | Symbol | Format      |
-| ------ | -------- | ------ | ----------- |
-| `co`   | COP      | $      | $ 1.000,00  |
-| `mx`   | MXN      | $      | $1,000.00   |
-| `ar`   | ARS      | $      | $ 1.000,00  |
-| `br`   | BRL      | R$     | R$ 1.000,00 |
-| `us`   | USD      | $      | $1,000.00   |
+| Locale       | Import                  | Currency | Symbol | Format      |
+| ------------ | ----------------------- | -------- | ------ | ----------- |
+| 🇨🇴 Colombia  | `soff-money/locales/co` | COP      | $      | $ 1.500.000 |
+| 🇲🇽 México    | `soff-money/locales/mx` | MXN      | $      | $1,500.00   |
+| 🇦🇷 Argentina | `soff-money/locales/ar` | ARS      | $      | $ 1.500,00  |
+| 🇧🇷 Brasil    | `soff-money/locales/br` | BRL      | R$     | R$ 1.500,00 |
+| 🇺🇸 USA       | `soff-money/locales/us` | USD      | $      | $1,500.00   |
+| 🇨🇱 Chile     | `soff-money/locales/cl` | CLP      | $      | $ 1.500     |
+| 🇵🇪 Perú      | `soff-money/locales/pe` | PEN      | S/     | S/ 1,500.00 |
+| 🇺🇾 Uruguay   | `soff-money/locales/uy` | UYU      | $      | $ 1.500,00  |
+| 🇪🇺 Euro      | `soff-money/locales/eu` | EUR      | €      | 1.500,00 €  |
+
+## API Reference
+
+### Creating Money
+
+```typescript
+// From decimal (recommended)
+Money.fromDecimal(1500.5, COP);
+
+// From cents (when you already have cents)
+Money.fromCents(150050, COP);
+
+// Zero
+Money.zero(COP);
+```
+
+### Arithmetic Operations
+
+All operations return new Money instances (immutable):
+
+```typescript
+const a = Money.fromDecimal(100, USD);
+const b = Money.fromDecimal(50, USD);
+
+a.add(b); // $150
+a.subtract(b); // $50
+a.multiply(2); // $200
+a.multiply(0.5); // $50
+a.divide(2); // $50
+a.negate(); // -$100
+a.abs(); // $100 (absolute value)
+```
+
+### Percentage Operations
+
+```typescript
+const price = Money.fromDecimal(100, USD);
+
+price.percentage(10); // $10.00 (10% of price)
+price.addPercentage(19); // $119.00 (price + 19% tax)
+price.subtractPercentage(10); // $90.00 (price - 10% discount)
+```
+
+### Min/Max Operations
+
+```typescript
+const a = Money.fromDecimal(100, USD);
+const b = Money.fromDecimal(50, USD);
+
+a.min(b); // $50 (minimum of a and b)
+a.max(b); // $100 (maximum of a and b)
+
+const min = Money.fromDecimal(10, USD);
+const max = Money.fromDecimal(100, USD);
+a.clamp(min, max); // $100 (clamp a between min and max)
+
+a.isBetween(min, max); // true (check if a is in range)
+```
+
+### Comparisons
+
+```typescript
+a.equals(b); // false
+a.greaterThan(b); // true
+a.greaterThanOrEqual(b); // true
+a.lessThan(b); // false
+a.lessThanOrEqual(b); // false
+a.isZero(); // false
+a.isPositive(); // true
+a.isNegative(); // false
+```
+
+### Formatting
+
+```typescript
+const price = Money.fromDecimal(1500.5, USD);
+
+price.format(); // "$1,500.50"
+price.format({ showSymbol: false }); // "1,500.50"
+price.format({ showDecimals: false }); // "$1,501"
+price.format({ symbolPosition: 'after' }); // "1,500.50 $"
+price.toDecimal(); // 1500.50
+price.toCents(); // 150050
+price.toJSON(); // { cents: 150050, currency: 'USD' }
+```
+
+## Static Methods
+
+```typescript
+// Sum multiple values
+const items = [Money.fromDecimal(100, USD), Money.fromDecimal(50, USD), Money.fromDecimal(25, USD)];
+
+Money.sum(items); // $175.00
+
+// Get min/max from array
+Money.minimum(items); // $25.00
+Money.maximum(items); // $100.00
+
+// Calculate average
+Money.average(items); // $58.33
+```
+
+## Bundle Size
+
+| Import       | Size (minified) |
+| ------------ | --------------- |
+| `core`       | ~8.8KB          |
+| `locales/*`  | ~0.3KB each     |
+| Full package | ~10.6KB         |
+
+Tree-shaking ensures you only ship what you import.
+
+## Contributing
+
+Please read [CONTRIBUTING.md](../../CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests.
 
 ## License
 
-MIT
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Documentation
+
+- [Español](docs/README.es.md)

package/dist/core/index.cjs

@@ -203,6 +203,105 @@ var Money = class _Money {
   negate() {
     return new _Money(-this.cents, this.currency);
   }
+  /**
+   * Calculate a percentage of this money
+   * @example money.percentage(10) returns 10% of the amount
+   */
+  percentage(percent) {
+    return new _Money(Math.round(this.cents * percent / 100), this.currency);
+  }
+  /**
+   * Add a percentage to this money
+   * @example money.addPercentage(19) adds 19% (like tax)
+   */
+  addPercentage(percent) {
+    return this.add(this.percentage(percent));
+  }
+  /**
+   * Subtract a percentage from this money
+   * @example money.subtractPercentage(10) subtracts 10% (like discount)
+   */
+  subtractPercentage(percent) {
+    return this.subtract(this.percentage(percent));
+  }
+  /**
+   * Get the minimum of this and another money value
+   */
+  min(other) {
+    this.assertSameCurrency(other);
+    return this.cents <= other.cents ? this : new _Money(other.cents, this.currency);
+  }
+  /**
+   * Get the maximum of this and another money value
+   */
+  max(other) {
+    this.assertSameCurrency(other);
+    return this.cents >= other.cents ? this : new _Money(other.cents, this.currency);
+  }
+  /**
+   * Clamp this money between a minimum and maximum
+   */
+  clamp(minValue, maxValue) {
+    return this.max(minValue).min(maxValue);
+  }
+  /**
+   * Get cents (smallest unit)
+   */
+  toCents() {
+    return this.cents;
+  }
+  /**
+   * Check if within a range (inclusive)
+   */
+  isBetween(min, max) {
+    this.assertSameCurrency(min);
+    this.assertSameCurrency(max);
+    return this.cents >= min.cents && this.cents <= max.cents;
+  }
+  /**
+   * Sum multiple money values
+   */
+  static sum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot sum empty array");
+    }
+    const currency = values[0].currency;
+    const total = values.reduce((sum, m) => {
+      if (m.currency.code !== currency.code) {
+        throw new Error("Cannot sum different currencies");
+      }
+      return sum + m.cents;
+    }, 0);
+    return new _Money(total, currency);
+  }
+  /**
+   * Get the minimum from an array of money values
+   */
+  static minimum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot get minimum of empty array");
+    }
+    return values.reduce((min, m) => m.cents < min.cents ? m : min);
+  }
+  /**
+   * Get the maximum from an array of money values
+   */
+  static maximum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot get maximum of empty array");
+    }
+    return values.reduce((max, m) => m.cents > max.cents ? m : max);
+  }
+  /**
+   * Calculate the average of money values
+   */
+  static average(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot calculate average of empty array");
+    }
+    const total = _Money.sum(values);
+    return total.divide(values.length);
+  }
   /**
    * Convert to JSON-serializable object
    */

package/dist/core/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/money.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Currency, FormatOptions, IMoney } from './types.js';\n\n/**\n * Immutable Money class that uses integer arithmetic for precision\n */\nexport class Money implements IMoney {\n  readonly cents: number;\n  readonly currency: Currency;\n\n  private constructor(cents: number, currency: Currency) {\n    if (!Number.isInteger(cents)) {\n      throw new Error('Money must be created with an integer number of cents');\n    }\n    this.cents = cents;\n    this.currency = currency;\n    Object.freeze(this);\n  }\n\n  /**\n   * Create money from cents (smallest unit)\n   */\n  static fromCents(cents: number, currency: Currency): Money {\n    return new Money(Math.round(cents), currency);\n  }\n\n  /**\n   * Create money from a decimal amount\n   * @example Money.fromDecimal(100.50, USD) creates $100.50\n   */\n  static fromDecimal(amount: number, currency: Currency): Money {\n    const multiplier = Math.pow(10, currency.decimals);\n    const cents = Math.round(amount * multiplier);\n    return new Money(cents, currency);\n  }\n\n  /**\n   * Create zero money\n   */\n  static zero(currency: Currency): Money {\n    return new Money(0, currency);\n  }\n\n  /**\n   * Add another money value (must be same currency)\n   */\n  add(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents + other.cents, this.currency);\n  }\n\n  /**\n   * Subtract another money value (must be same currency)\n   */\n  subtract(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents - other.cents, this.currency);\n  }\n\n  /**\n   * Multiply by a factor (rounds to nearest cent)\n   */\n  multiply(factor: number): Money {\n    return new Money(Math.round(this.cents * factor), this.currency);\n  }\n\n  /**\n   * Divide by a divisor (rounds to nearest cent)\n   */\n  divide(divisor: number): Money {\n    if (divisor === 0) {\n      throw new Error('Cannot divide by zero');\n    }\n    return new Money(Math.round(this.cents / divisor), this.currency);\n  }\n\n  /**\n   * Distribute money evenly without losing cents\n   * The remainder is distributed to the first parts\n   * @example $100 / 3 = [$33.34, $33.33, $33.33]\n   */\n  distribute(parts: number): Money[] {\n    if (parts <= 0 || !Number.isInteger(parts)) {\n      throw new Error('Parts must be a positive integer');\n    }\n\n    const quotient = Math.floor(this.cents / parts);\n    const remainder = this.cents % parts;\n\n    const result: Money[] = [];\n    for (let i = 0; i < parts; i++) {\n      // Add 1 cent to the first 'remainder' parts\n      const extra = i < remainder ? 1 : 0;\n      result.push(new Money(quotient + extra, this.currency));\n    }\n\n    return result;\n  }\n\n  /**\n   * Distribute money according to ratios\n   * @example $100 with ratios [1, 2, 2] = [$20, $40, $40]\n   */\n  distributeByRatios(ratios: number[]): Money[] {\n    if (ratios.length === 0) {\n      throw new Error('Ratios array cannot be empty');\n    }\n\n    const total = ratios.reduce((sum, r) => sum + r, 0);\n    if (total <= 0) {\n      throw new Error('Sum of ratios must be positive');\n    }\n\n    let remaining = this.cents;\n    const result: Money[] = [];\n\n    for (let i = 0; i < ratios.length; i++) {\n      if (i === ratios.length - 1) {\n        // Last part gets whatever is remaining to avoid rounding errors\n        result.push(new Money(remaining, this.currency));\n      } else {\n        const share = Math.round((this.cents * ratios[i]) / total);\n        result.push(new Money(share, this.currency));\n        remaining -= share;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Format money for display\n   */\n  format(options: FormatOptions = {}): string {\n    const { showSymbol = true, showDecimals = true, symbolPosition } = options;\n\n    const decimal = this.toDecimal();\n    const absValue = Math.abs(decimal);\n    const isNegative = decimal < 0;\n\n    // Format the number\n    let formatted: string;\n    if (showDecimals && this.currency.decimals > 0) {\n      const [intPart, decPart] = absValue.toFixed(this.currency.decimals).split('.');\n      const intFormatted = this.formatInteger(intPart);\n      formatted = `${intFormatted}${this.currency.decimalSeparator}${decPart}`;\n    } else {\n      formatted = this.formatInteger(Math.round(absValue).toString());\n    }\n\n    // Add negative sign\n    if (isNegative) {\n      formatted = `-${formatted}`;\n    }\n\n    // Add symbol\n    if (showSymbol) {\n      const pos = symbolPosition ?? this.currency.symbolPosition;\n      const space = this.currency.symbolSpacing ? ' ' : '';\n\n      if (pos === 'before') {\n        formatted = `${this.currency.symbol}${space}${formatted}`;\n      } else {\n        formatted = `${formatted}${space}${this.currency.symbol}`;\n      }\n    }\n\n    return formatted;\n  }\n\n  /**\n   * Get the decimal representation\n   */\n  toDecimal(): number {\n    return this.cents / Math.pow(10, this.currency.decimals);\n  }\n\n  /**\n   * Check equality with another money value\n   */\n  equals(other: IMoney): boolean {\n    return this.cents === other.cents && this.currency.code === other.currency.code;\n  }\n\n  /**\n   * Check if greater than another money value\n   */\n  greaterThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents > other.cents;\n  }\n\n  /**\n   * Check if less than another money value\n   */\n  lessThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents < other.cents;\n  }\n\n  /**\n   * Check if greater than or equal\n   */\n  greaterThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents >= other.cents;\n  }\n\n  /**\n   * Check if less than or equal\n   */\n  lessThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents <= other.cents;\n  }\n\n  /**\n   * Check if zero\n   */\n  isZero(): boolean {\n    return this.cents === 0;\n  }\n\n  /**\n   * Check if positive\n   */\n  isPositive(): boolean {\n    return this.cents > 0;\n  }\n\n  /**\n   * Check if negative\n   */\n  isNegative(): boolean {\n    return this.cents < 0;\n  }\n\n  /**\n   * Get absolute value\n   */\n  abs(): Money {\n    return new Money(Math.abs(this.cents), this.currency);\n  }\n\n  /**\n   * Negate the value\n   */\n  negate(): Money {\n    return new Money(-this.cents, this.currency);\n  }\n\n  /**\n   * Convert to JSON-serializable object\n   */\n  toJSON(): { cents: number; currency: string } {\n    return {\n      cents: this.cents,\n      currency: this.currency.code,\n    };\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return this.format();\n  }\n\n  private formatInteger(intStr: string): string {\n    const parts: string[] = [];\n    let remaining = intStr;\n\n    while (remaining.length > 3) {\n      parts.unshift(remaining.slice(-3));\n      remaining = remaining.slice(0, -3);\n    }\n\n    if (remaining) {\n      parts.unshift(remaining);\n    }\n\n    return parts.join(this.currency.thousandsSeparator);\n  }\n\n  private assertSameCurrency(other: IMoney): void {\n    if (this.currency.code !== other.currency.code) {\n      throw new Error(\n        `Cannot perform operation with different currencies: ${this.currency.code} and ${other.currency.code}`\n      );\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/core/money.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Currency, FormatOptions, IMoney } from './types.js';\n\n/**\n * Immutable Money class that uses integer arithmetic for precision\n */\nexport class Money implements IMoney {\n  readonly cents: number;\n  readonly currency: Currency;\n\n  private constructor(cents: number, currency: Currency) {\n    if (!Number.isInteger(cents)) {\n      throw new Error('Money must be created with an integer number of cents');\n    }\n    this.cents = cents;\n    this.currency = currency;\n    Object.freeze(this);\n  }\n\n  /**\n   * Create money from cents (smallest unit)\n   */\n  static fromCents(cents: number, currency: Currency): Money {\n    return new Money(Math.round(cents), currency);\n  }\n\n  /**\n   * Create money from a decimal amount\n   * @example Money.fromDecimal(100.50, USD) creates $100.50\n   */\n  static fromDecimal(amount: number, currency: Currency): Money {\n    const multiplier = Math.pow(10, currency.decimals);\n    const cents = Math.round(amount * multiplier);\n    return new Money(cents, currency);\n  }\n\n  /**\n   * Create zero money\n   */\n  static zero(currency: Currency): Money {\n    return new Money(0, currency);\n  }\n\n  /**\n   * Add another money value (must be same currency)\n   */\n  add(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents + other.cents, this.currency);\n  }\n\n  /**\n   * Subtract another money value (must be same currency)\n   */\n  subtract(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return new Money(this.cents - other.cents, this.currency);\n  }\n\n  /**\n   * Multiply by a factor (rounds to nearest cent)\n   */\n  multiply(factor: number): Money {\n    return new Money(Math.round(this.cents * factor), this.currency);\n  }\n\n  /**\n   * Divide by a divisor (rounds to nearest cent)\n   */\n  divide(divisor: number): Money {\n    if (divisor === 0) {\n      throw new Error('Cannot divide by zero');\n    }\n    return new Money(Math.round(this.cents / divisor), this.currency);\n  }\n\n  /**\n   * Distribute money evenly without losing cents\n   * The remainder is distributed to the first parts\n   * @example $100 / 3 = [$33.34, $33.33, $33.33]\n   */\n  distribute(parts: number): Money[] {\n    if (parts <= 0 || !Number.isInteger(parts)) {\n      throw new Error('Parts must be a positive integer');\n    }\n\n    const quotient = Math.floor(this.cents / parts);\n    const remainder = this.cents % parts;\n\n    const result: Money[] = [];\n    for (let i = 0; i < parts; i++) {\n      // Add 1 cent to the first 'remainder' parts\n      const extra = i < remainder ? 1 : 0;\n      result.push(new Money(quotient + extra, this.currency));\n    }\n\n    return result;\n  }\n\n  /**\n   * Distribute money according to ratios\n   * @example $100 with ratios [1, 2, 2] = [$20, $40, $40]\n   */\n  distributeByRatios(ratios: number[]): Money[] {\n    if (ratios.length === 0) {\n      throw new Error('Ratios array cannot be empty');\n    }\n\n    const total = ratios.reduce((sum, r) => sum + r, 0);\n    if (total <= 0) {\n      throw new Error('Sum of ratios must be positive');\n    }\n\n    let remaining = this.cents;\n    const result: Money[] = [];\n\n    for (let i = 0; i < ratios.length; i++) {\n      if (i === ratios.length - 1) {\n        // Last part gets whatever is remaining to avoid rounding errors\n        result.push(new Money(remaining, this.currency));\n      } else {\n        const share = Math.round((this.cents * ratios[i]) / total);\n        result.push(new Money(share, this.currency));\n        remaining -= share;\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Format money for display\n   */\n  format(options: FormatOptions = {}): string {\n    const { showSymbol = true, showDecimals = true, symbolPosition } = options;\n\n    const decimal = this.toDecimal();\n    const absValue = Math.abs(decimal);\n    const isNegative = decimal < 0;\n\n    // Format the number\n    let formatted: string;\n    if (showDecimals && this.currency.decimals > 0) {\n      const [intPart, decPart] = absValue.toFixed(this.currency.decimals).split('.');\n      const intFormatted = this.formatInteger(intPart);\n      formatted = `${intFormatted}${this.currency.decimalSeparator}${decPart}`;\n    } else {\n      formatted = this.formatInteger(Math.round(absValue).toString());\n    }\n\n    // Add negative sign\n    if (isNegative) {\n      formatted = `-${formatted}`;\n    }\n\n    // Add symbol\n    if (showSymbol) {\n      const pos = symbolPosition ?? this.currency.symbolPosition;\n      const space = this.currency.symbolSpacing ? ' ' : '';\n\n      if (pos === 'before') {\n        formatted = `${this.currency.symbol}${space}${formatted}`;\n      } else {\n        formatted = `${formatted}${space}${this.currency.symbol}`;\n      }\n    }\n\n    return formatted;\n  }\n\n  /**\n   * Get the decimal representation\n   */\n  toDecimal(): number {\n    return this.cents / Math.pow(10, this.currency.decimals);\n  }\n\n  /**\n   * Check equality with another money value\n   */\n  equals(other: IMoney): boolean {\n    return this.cents === other.cents && this.currency.code === other.currency.code;\n  }\n\n  /**\n   * Check if greater than another money value\n   */\n  greaterThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents > other.cents;\n  }\n\n  /**\n   * Check if less than another money value\n   */\n  lessThan(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents < other.cents;\n  }\n\n  /**\n   * Check if greater than or equal\n   */\n  greaterThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents >= other.cents;\n  }\n\n  /**\n   * Check if less than or equal\n   */\n  lessThanOrEqual(other: IMoney): boolean {\n    this.assertSameCurrency(other);\n    return this.cents <= other.cents;\n  }\n\n  /**\n   * Check if zero\n   */\n  isZero(): boolean {\n    return this.cents === 0;\n  }\n\n  /**\n   * Check if positive\n   */\n  isPositive(): boolean {\n    return this.cents > 0;\n  }\n\n  /**\n   * Check if negative\n   */\n  isNegative(): boolean {\n    return this.cents < 0;\n  }\n\n  /**\n   * Get absolute value\n   */\n  abs(): Money {\n    return new Money(Math.abs(this.cents), this.currency);\n  }\n\n  /**\n   * Negate the value\n   */\n  negate(): Money {\n    return new Money(-this.cents, this.currency);\n  }\n\n  /**\n   * Calculate a percentage of this money\n   * @example money.percentage(10) returns 10% of the amount\n   */\n  percentage(percent: number): Money {\n    return new Money(Math.round((this.cents * percent) / 100), this.currency);\n  }\n\n  /**\n   * Add a percentage to this money\n   * @example money.addPercentage(19) adds 19% (like tax)\n   */\n  addPercentage(percent: number): Money {\n    return this.add(this.percentage(percent));\n  }\n\n  /**\n   * Subtract a percentage from this money\n   * @example money.subtractPercentage(10) subtracts 10% (like discount)\n   */\n  subtractPercentage(percent: number): Money {\n    return this.subtract(this.percentage(percent));\n  }\n\n  /**\n   * Get the minimum of this and another money value\n   */\n  min(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return this.cents <= other.cents ? this : new Money(other.cents, this.currency);\n  }\n\n  /**\n   * Get the maximum of this and another money value\n   */\n  max(other: IMoney): Money {\n    this.assertSameCurrency(other);\n    return this.cents >= other.cents ? this : new Money(other.cents, this.currency);\n  }\n\n  /**\n   * Clamp this money between a minimum and maximum\n   */\n  clamp(minValue: IMoney, maxValue: IMoney): Money {\n    return this.max(minValue).min(maxValue);\n  }\n\n  /**\n   * Get cents (smallest unit)\n   */\n  toCents(): number {\n    return this.cents;\n  }\n\n  /**\n   * Check if within a range (inclusive)\n   */\n  isBetween(min: IMoney, max: IMoney): boolean {\n    this.assertSameCurrency(min);\n    this.assertSameCurrency(max);\n    return this.cents >= min.cents && this.cents <= max.cents;\n  }\n\n  /**\n   * Sum multiple money values\n   */\n  static sum(values: IMoney[]): Money {\n    if (values.length === 0) {\n      throw new Error('Cannot sum empty array');\n    }\n    const currency = values[0].currency;\n    const total = values.reduce((sum, m) => {\n      if (m.currency.code !== currency.code) {\n        throw new Error('Cannot sum different currencies');\n      }\n      return sum + m.cents;\n    }, 0);\n    return new Money(total, currency);\n  }\n\n  /**\n   * Get the minimum from an array of money values\n   */\n  static minimum(values: IMoney[]): Money {\n    if (values.length === 0) {\n      throw new Error('Cannot get minimum of empty array');\n    }\n    return values.reduce((min, m) => (m.cents < min.cents ? m : min)) as Money;\n  }\n\n  /**\n   * Get the maximum from an array of money values\n   */\n  static maximum(values: IMoney[]): Money {\n    if (values.length === 0) {\n      throw new Error('Cannot get maximum of empty array');\n    }\n    return values.reduce((max, m) => (m.cents > max.cents ? m : max)) as Money;\n  }\n\n  /**\n   * Calculate the average of money values\n   */\n  static average(values: IMoney[]): Money {\n    if (values.length === 0) {\n      throw new Error('Cannot calculate average of empty array');\n    }\n    const total = Money.sum(values);\n    return total.divide(values.length);\n  }\n\n  /**\n   * Convert to JSON-serializable object\n   */\n  toJSON(): { cents: number; currency: string } {\n    return {\n      cents: this.cents,\n      currency: this.currency.code,\n    };\n  }\n\n  /**\n   * String representation\n   */\n  toString(): string {\n    return this.format();\n  }\n\n  private formatInteger(intStr: string): string {\n    const parts: string[] = [];\n    let remaining = intStr;\n\n    while (remaining.length > 3) {\n      parts.unshift(remaining.slice(-3));\n      remaining = remaining.slice(0, -3);\n    }\n\n    if (remaining) {\n      parts.unshift(remaining);\n    }\n\n    return parts.join(this.currency.thousandsSeparator);\n  }\n\n  private assertSameCurrency(other: IMoney): void {\n    if (this.currency.code !== other.currency.code) {\n      throw new Error(\n        `Cannot perform operation with different currencies: ${this.currency.code} and ${other.currency.code}`\n      );\n    }\n  }\n}\n"]}

package/dist/core/index.d.cts

@@ -163,6 +163,57 @@ declare class Money implements IMoney {
      * Negate the value
      */
     negate(): Money;
+    /**
+     * Calculate a percentage of this money
+     * @example money.percentage(10) returns 10% of the amount
+     */
+    percentage(percent: number): Money;
+    /**
+     * Add a percentage to this money
+     * @example money.addPercentage(19) adds 19% (like tax)
+     */
+    addPercentage(percent: number): Money;
+    /**
+     * Subtract a percentage from this money
+     * @example money.subtractPercentage(10) subtracts 10% (like discount)
+     */
+    subtractPercentage(percent: number): Money;
+    /**
+     * Get the minimum of this and another money value
+     */
+    min(other: IMoney): Money;
+    /**
+     * Get the maximum of this and another money value
+     */
+    max(other: IMoney): Money;
+    /**
+     * Clamp this money between a minimum and maximum
+     */
+    clamp(minValue: IMoney, maxValue: IMoney): Money;
+    /**
+     * Get cents (smallest unit)
+     */
+    toCents(): number;
+    /**
+     * Check if within a range (inclusive)
+     */
+    isBetween(min: IMoney, max: IMoney): boolean;
+    /**
+     * Sum multiple money values
+     */
+    static sum(values: IMoney[]): Money;
+    /**
+     * Get the minimum from an array of money values
+     */
+    static minimum(values: IMoney[]): Money;
+    /**
+     * Get the maximum from an array of money values
+     */
+    static maximum(values: IMoney[]): Money;
+    /**
+     * Calculate the average of money values
+     */
+    static average(values: IMoney[]): Money;
     /**
      * Convert to JSON-serializable object
      */

package/dist/core/index.d.ts

@@ -163,6 +163,57 @@ declare class Money implements IMoney {
      * Negate the value
      */
     negate(): Money;
+    /**
+     * Calculate a percentage of this money
+     * @example money.percentage(10) returns 10% of the amount
+     */
+    percentage(percent: number): Money;
+    /**
+     * Add a percentage to this money
+     * @example money.addPercentage(19) adds 19% (like tax)
+     */
+    addPercentage(percent: number): Money;
+    /**
+     * Subtract a percentage from this money
+     * @example money.subtractPercentage(10) subtracts 10% (like discount)
+     */
+    subtractPercentage(percent: number): Money;
+    /**
+     * Get the minimum of this and another money value
+     */
+    min(other: IMoney): Money;
+    /**
+     * Get the maximum of this and another money value
+     */
+    max(other: IMoney): Money;
+    /**
+     * Clamp this money between a minimum and maximum
+     */
+    clamp(minValue: IMoney, maxValue: IMoney): Money;
+    /**
+     * Get cents (smallest unit)
+     */
+    toCents(): number;
+    /**
+     * Check if within a range (inclusive)
+     */
+    isBetween(min: IMoney, max: IMoney): boolean;
+    /**
+     * Sum multiple money values
+     */
+    static sum(values: IMoney[]): Money;
+    /**
+     * Get the minimum from an array of money values
+     */
+    static minimum(values: IMoney[]): Money;
+    /**
+     * Get the maximum from an array of money values
+     */
+    static maximum(values: IMoney[]): Money;
+    /**
+     * Calculate the average of money values
+     */
+    static average(values: IMoney[]): Money;
     /**
      * Convert to JSON-serializable object
      */

package/dist/core/index.js

@@ -201,6 +201,105 @@ var Money = class _Money {
   negate() {
     return new _Money(-this.cents, this.currency);
   }
+  /**
+   * Calculate a percentage of this money
+   * @example money.percentage(10) returns 10% of the amount
+   */
+  percentage(percent) {
+    return new _Money(Math.round(this.cents * percent / 100), this.currency);
+  }
+  /**
+   * Add a percentage to this money
+   * @example money.addPercentage(19) adds 19% (like tax)
+   */
+  addPercentage(percent) {
+    return this.add(this.percentage(percent));
+  }
+  /**
+   * Subtract a percentage from this money
+   * @example money.subtractPercentage(10) subtracts 10% (like discount)
+   */
+  subtractPercentage(percent) {
+    return this.subtract(this.percentage(percent));
+  }
+  /**
+   * Get the minimum of this and another money value
+   */
+  min(other) {
+    this.assertSameCurrency(other);
+    return this.cents <= other.cents ? this : new _Money(other.cents, this.currency);
+  }
+  /**
+   * Get the maximum of this and another money value
+   */
+  max(other) {
+    this.assertSameCurrency(other);
+    return this.cents >= other.cents ? this : new _Money(other.cents, this.currency);
+  }
+  /**
+   * Clamp this money between a minimum and maximum
+   */
+  clamp(minValue, maxValue) {
+    return this.max(minValue).min(maxValue);
+  }
+  /**
+   * Get cents (smallest unit)
+   */
+  toCents() {
+    return this.cents;
+  }
+  /**
+   * Check if within a range (inclusive)
+   */
+  isBetween(min, max) {
+    this.assertSameCurrency(min);
+    this.assertSameCurrency(max);
+    return this.cents >= min.cents && this.cents <= max.cents;
+  }
+  /**
+   * Sum multiple money values
+   */
+  static sum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot sum empty array");
+    }
+    const currency = values[0].currency;
+    const total = values.reduce((sum, m) => {
+      if (m.currency.code !== currency.code) {
+        throw new Error("Cannot sum different currencies");
+      }
+      return sum + m.cents;
+    }, 0);
+    return new _Money(total, currency);
+  }
+  /**
+   * Get the minimum from an array of money values
+   */
+  static minimum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot get minimum of empty array");
+    }
+    return values.reduce((min, m) => m.cents < min.cents ? m : min);
+  }
+  /**
+   * Get the maximum from an array of money values
+   */
+  static maximum(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot get maximum of empty array");
+    }
+    return values.reduce((max, m) => m.cents > max.cents ? m : max);
+  }
+  /**
+   * Calculate the average of money values
+   */
+  static average(values) {
+    if (values.length === 0) {
+      throw new Error("Cannot calculate average of empty array");
+    }
+    const total = _Money.sum(values);
+    return total.divide(values.length);
+  }
   /**
    * Convert to JSON-serializable object
    */