PHP Luminova: Basic Maths Utility Class

use Luminova\Utility\Maths;

$distanceKm = Maths::distance(12.971603, 77.594605, 13.035542, 77.597100);        // default 'km'
$distanceMi = Maths::distance(12.971603, 77.594605, 13.035542, 77.597100, 'mi');  // in miles
$distanceFt = Maths::distance(12.971603, 77.594605, 13.035542, 77.597100, 'ft');  // in feet

// Check latitude
Maths::isLat(12.971603);                   // true
Maths::isLat(91);                           // false (out of range)
Maths::isLat(12.9716032, true, 6);          // true (strict, up to 6 decimals)

// Check longitude
Maths::isLng(77.594605);                    // true
Maths::isLng(181);                           // false (out of range)

// Check both coordinates
Maths::isLatLng('12.971603', '77.594605');              // true
Maths::isLatLng('12.9716032', '77.5946052', true);      // true (strict)
Maths::isLatLng('12.97160321', '77.59460521', true, 6); // false (too many decimals)

use Luminova\Utility\Maths;

// Format currency
echo Maths::currency(5000);                   // "$5,000.00" (default USD)
echo Maths::currency(5000, 'EUR');            // "€5,000.00"
echo Maths::currency(5000, 'JPY', 'ja-JP');   // "￥5,000"

// Calculate average rating
$average = Maths::rating(5, 42.5, true);     // 8.50 (rounded)

// Average of numbers
$avg = Maths::average(10, 20, 30, 40, 50);   // 30

// Money formatting
Maths::money(5000, 2);                        // "5000.00"

// Percentages, discounts, interest
Maths::percentage(10, of: 5000);             // 500
Maths::discount(5000, 10);                    // 4500
Maths::interest(5000, 10);                    // 5500

// Convert human-readable sizes to bytes
$bytes = Maths::toBytes('1KB');              // 1024
$bytes = Maths::toBytes('1.5MB');            // 1572864

// Convert bytes to readable format
echo Maths::toUnit(1024);                     // 1.00
echo Maths::toUnit(1048576, 2, true);        // "1.00 MB"

// Convert milliseconds to human-readable time
echo Maths::toTimeUnit(1500);                 // "1.50" (seconds not displayed)
echo Maths::toTimeUnit(1500, 2, true);       // "1.50 s"
echo Maths::toTimeUnit(60000, 2, true, true); // "1.00 minutes"

// Basic math
$sum        = Maths::add(10, 20, 30);        // 60
$difference = Maths::subtract(50, 20);       // 30
$product    = Maths::multiply(2, 3, 4);      // 24
$quotient   = Maths::divide(10, 2);          // 5
$quotientByZero = Maths::divide(10, 0);      // null

// Factorial
$fact = Maths::factorial(5);                 // 120

// Clamp values
$clamped = Maths::clamp(120, 0, 100);        // 100
$clamped = Maths::clamp(-5, 0, 100);         // 0

// GCD & LCM
$gcd = Maths::gcd(24, 36);                   // 12
$lcm = Maths::lcm(4, 6);                     // 12

// Prime check
Maths::isPrime(17);                           // true
Maths::isPrime(18);                           // false

// Even & Odd checks
Maths::isEven(10);                            // true
Maths::isOdd(7);                              // true

use Luminova\Utility\Maths;

// Generate a random BIGINT (default UNSIGNED range)
$bigint = Maths::bigInteger(); 
echo $bigint; // e.g., "12345678901234567890"

// Generate a BIGINT within a custom range
$bigint = Maths::bigInteger('1000000000000', '9999999999999'); 
echo $bigint; // e.g., "5482938475623"

// Generate a SIGNED BIGINT
$bigint = Maths::bigInteger('-9223372036854775808', '9223372036854775807'); 
echo $bigint; // e.g., "-1234567890123456789"

public static toUnit(
    float|int $bytes, 
    int $decimals = 2,  
    bool $withName = false,
    bool $trimZeros = false
): string

public static toBytes(string $units): int

public static toTimeUnit(
    float|int $milliseconds,
    int $decimals = 2,
    bool $withName = false,
    bool $withFullName = false,
    bool $trimZeros = true
): string

public static average(int|float ...$numbers): float|null

public static rating(int $reviews, float $rating, bool $round = false): float

echo Math::rating(5, 42.5, true)

public static money(mixed $amount, int $decimals = 2): string

public static currency(float $number, string $code = 'USD', string|null $locale = null): string|false

public static crypto(int|float|string $amount, string $network = 'BTC'): string|false

public static distance(
  float|string $originLat, 
  float|string $originLng, 
  float|string $destLat, 
  float|string $destLng, 
  string $unit = 'km'
): float

public static fixed(float|int|string $number, ?int $decimals = null): string

public static discount(
    float|int|string $value, 
    float|int|string $rate,
    ?int $precision = null
): float

public static interest(
    float|int|string $value, 
    float|int|string $rate,
    ?int $precision = null
): float

public static percentage(
    string|float|int $rate,
    string|float|int $of,
    ?int $precision = null
): float

public static bigInteger(int $min, int $max): string

public static isLat(float|string $lat, bool $strict = false, int $precision = 6): bool

public static isLng(float|string $lng, bool $strict = false, int $precision = 6): bool

public static isLatLng(
    float|string $lat,
    float|string $lng,
    bool $strict = false,
    int $precision = 6
): bool