Open Collective
Codymath
About
Version 0.5.0: The Utilities Module & Multi-Language Support
Published on October 4, 2025 by Jackson Douglas de Souza
This is a massive feature release that introduces the new utils module, a comprehensive toolkit designed to solve real-world problems. It also brings the highly anticipated multi-language toWords functionality to the library.

🚀 New Features

  • Introducing the utils Module: A powerful new suite of 14 high-level utility functions.
  • Multi-Language toWords Conversion:
    • Adds toWordsPure and toWordsCurrency functions to convert numbers into written words.
    • Initial language support for English (en-US), Brazilian Portuguese (pt-BR), and Spanish (es-ES).
    • The architecture is built to support over 30 languages in the future.
  • General Utilities: Added a robust collection of functions including map, distance, getIntegerPart, getFractionalPart, countDigits, padZeroes, and random.
  • Formatting: Includes a flexible formatCurrency function with customizable symbols and separators.

✨ Improvements

  • BigInt Support: The isPowerOfTwo function has been completely refactored to support the bigint type, allowing it to handle arbitrarily large integers.
  • Floating-Point Precision: Functions like getFractionalPart now include robust handling for common floating-point inaccuracies, ensuring more precise and predictable results.
  • Dogfooding: The library now extensively uses its own functions internally, increasing overall system integrity and consistency.

📚 Documentation

  • The main README.md has been updated with a complete API table and detailed, multi-level usage examples for the entire utils module.

🧪 Testing

  • Added over 80 new tests, bringing the total suite to more than 200 tests.
  • Every new function is validated with a "brutal stress test" to ensure stability and performance under heavy use.