monify-ts v1.0.3

🌍 Monify - A Simple Currency Formatter

Monify is a lightweight currency formatting library built with TypeScript. It supports multiple currencies and provides flexible formatting options.

📦 Installation

npm install monify-ts

or with yarn:

yarn add monify-ts

🚀 Usage

import { format } from "monify-ts";

📦 Basic Usage

console.log(format(1234567.89, "USD")); // "$1,234,567.89"
console.log(format(1234567.89, "EUR")); // "1.234.567,89 €"
console.log(format(1234567.89, "IDR")); // "Rp 1.234.567,00"

// Custom decimal digits
console.log(format(1234567.89, "JPY", 0)); // "¥1,234,567"

// Disable currency symbol spacing
console.log(format(1234567.89, "GBP", 2, false, false)); // "£1,234,567.89"

// Enable suffix formatting
console.log(format(1500000, "USD", 2, true)); // "$1.5M"

📜 API Reference

format(
  value: number,
  currency: string,
  decimalDigits?: number,  // Optional (Default: Auto)
  useSuffix?: boolean,     // Optional (Default: false) → Enable "K, M, B" suffix
  useSpace?: boolean       // Optional (Default: true) → Add space between symbol and number
): string

🌎 Supported Currencies

🧪 Running Tests

To run tests, use:

npm test

or

yarn test

Tests are written using Jest, covering multiple currencies to ensure accuracy.

🤝 Contributing

Contributions are welcome! To contribute:

Fork the repository.
Clone your forked repo.
Create a new feature branch.
Implement and test changes.
Submit a pull request.

📜 License

Monify is released under the MIT License.

📩 Support

For questions or issues, open a GitHub Issue or contact me at lelianto.eko@gmail.com.