PackageTrack
Sign in Get early access

amount_to_word

A comprehensive Flutter package for converting numbers and amounts to words in multiple languages (Persian, English, Turkish) with full currency support and smart pluralization.

2.0.2 ialirezairanmanesh/amount_to_word

What this package is like to depend on

Last release 10 months ago

28 Sep 2025

Too new to tell

only 1 release windows

Nearly every release is documented

notes for 3 of 3 stable releases

Nothing withdrawn

no release was ever pulled

10 months old

3 releases · first in 2025

3 releases in the last 12 months

see the full history below

Release timeline

3 releases · Sep 2025 to Sep 2025
2026
Release Pre-release

Releases

latest 3
  1. 2.0.2 28 Sep 2025
    Release notes

    Fixed

    • Turkish Currency: Fixed "kurus" to "kuruş" in Turkish Lira sub-unit name
    • App Name: Updated partner app name to "Fida Invoice" in English
    Open source →
  2. 2.0.1 28 Sep 2025
    Release notes

    Added

    • Support Section: Added support section for Fida Invoice app in README
    • Partnership: Official partnership with Fida Invoice - professional invoice application
    Open source →
  3. 2.0.0 28 Sep 2025
    Release notes

    Added

    • Turkish Language Support: Complete number-to-word conversion for Turkish language
    • Multi-language Currency Units: Currency units now support Persian, English, and Turkish
    • Smart Pluralization: Automatic singular/plural handling for English currencies
    • Extensible Architecture: Easy to add new languages via addLanguage() method
    • Comprehensive Currency Support: 7 predefined currencies with proper localization
    • Enhanced Testing: 100% test coverage with edge cases and performance tests
    • Complete Documentation: Comprehensive README, usage guide, and API documentation

    Changed

    • BREAKING: Refactored CurrencyConfig to use Map<Language, String> for multi-language support
    • BREAKING: Currency methods now accept count parameter for pluralization
    • BREAKING: Removed string-based currency parameters in favor of CurrencyConfig objects
    • Improved: Number conversion accuracy and conjunction word handling
    • Improved: Performance optimizations for large number processing
    • Enhanced: Error handling and input validation

    Fixed

    • Persian Conjunction: Fixed "و" placement - now correctly appears between groups but not at the end
    • English Conjunction: Fixed "and" placement for decimal numbers
    • Decimal Handling: Fixed handling of numbers like 10000.0 (no trailing conjunction)
    • Turkish Grammar: Proper handling of "bin" and "yüz" without "bir" prefix

    Deprecated

    • mainUnit and subUnit getters in CurrencyConfig (use getMainUnit() and getSubUnit() instead)
    • CurrencyConfig.tomanRial, CurrencyConfig.dollarCent, CurrencyConfig.euroCent (renamed to clearer names)

    Migration Guide

    From 1.x to 2.0

    Currency Configuration:

    // Old
    converter.convert(amount, mainUnit: 'dollar', subUnit: 'cent');
    
    // New
    converter.convert(amount, currency: CurrencyConfig.usDollar);
    

    Custom Currencies:

    // Old
    // Not supported in 1.x
    
    // New
    final customCurrency = CurrencyConfig(
      mainUnits: {
        Language.en: 'token',
        Language.fa: 'ژتون',
      },
      subUnits: {
        Language.en: 'bit',
        Language.fa: 'بیت',
      },
    );
    

    Pluralization:

    // Old - Manual handling
    final unit = amount == 1 ? 'dollar' : 'dollars';
    
    // New - Automatic
    final unit = currency.getMainUnit(Language.en, count: amount);
    
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive