pagamio-frontend-commons-lib/lib/helpers/utils.js

Pagamio library for Frontend reusable components like the form engine and table container

import { clsx } from 'clsx';
import { twMerge } from 'tailwind-merge';
export function cn(...inputs) {
    return twMerge(clsx(inputs));
}
/**
 * Formats a number as currency using en-US locale standards.
 *
 * @param {number} price - The numeric value to format as currency
 * @param {string} [currency="ZAR"] - ISO 4217 currency code (default: "ZAR")
 * @param {number} [minimumFractionDigits=2] - Minimum fraction digits (default: 2)
 * @param {number} [maximumFractionDigits] - Optional maximum fraction digits
 * @returns {string} Formatted currency string
 *
 * @example
 * // Basic usage with ZAR (South African Rand)
 * formatPrice(1234.56); // Returns "ZAR 1,234.56"
 *
 * @example
 * // USD with 2 decimal places
 * formatPrice(1234.56, "USD"); // Returns "$1,234.56"
 *
 * @example
 * // Euro with standard formatting
 * formatPrice(1234.56, "EUR"); // Returns "€1,234.56"
 *
 * @example
 * // Custom decimal places (clamping)
 * formatPrice(1234.5678, "GBP", 2, 3); // Returns "£1,234.568"
 *
 * @example
 * // Fallback behavior with invalid currency
 * formatPrice(1234.56, "XYZ"); // Returns "XYZ 1,234.56"
 */
export const formatPrice = (price, currency = 'ZAR', minimumFractionDigits = 2, maximumFractionDigits) => {
    const options = {
        style: 'currency',
        currency,
        minimumFractionDigits,
    };
    if (maximumFractionDigits !== undefined) {
        options.maximumFractionDigits = maximumFractionDigits;
    }
    try {
        return price.toLocaleString('en-US', options);
    }
    catch (error) {
        console.error('Error formatting currency:', error);
        // Fallback to basic formatting when Intl fails
        return `${currency} ${price.toFixed(minimumFractionDigits)}`;
    }
};