cline/numerus

Immutable numeric value object with chainable arithmetic operations and Laravel Number formatting

4.1.0 2025-10-25 03:23 UTC

Requires

• php: ^8.4.0
• ext-intl: *
• brick/math: ^0.14.0
• illuminate/support: ^12.0

Requires (Dev)

• cline/php-cs-fixer: ^1.0.5
• driftingly/rector-laravel: ^2.1.1
• ergebnis/composer-normalize: ^2.49@dev
• laravel/pint: ^1.25.1
• orchestra/testbench: ^10.6
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-laravel: ^3.2
• pestphp/pest-plugin-type-coverage: ^3.6.1
• phpstan/phpstan: ^2.1.31
• rector/rector: ^2.2.5
• symfony/var-dumper: ^7.3.4

MIT

• Brian Faust

• php
• i18n
• locale
• currency
• intl
• number
• laravel
• formatting
• arithmetic
• mathematics
• immutable
• numeric
• value-object
• percentage

README

Immutable numeric value object with chainable arithmetic operations and Laravel Number formatting. Uses brick/math for arbitrary-precision arithmetic, ensuring accurate calculations for financial and scientific use cases.

Requirements

Requires PHP 8.4+

Installation

composer require cline/numerus

Documentation

• Basic Usage - Core arithmetic and rounding operations
• Comparisons - Comparison operations and type checking
• Chaining - Advanced chaining patterns and practical examples
• Formatting - Laravel Number formatting, localization, and parsing

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.