@metamask-previews/perps-controller 3.0.0-preview-e61cfa5 → 3.1.0-preview-548bdd1d9

package/dist/utils/perpsFormatters.cjs

@@ -0,0 +1,498 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFundingRate = exports.formatPercentage = exports.formatPnl = exports.formatPositionSize = exports.formatPerpsFiat = exports.PRICE_RANGES_UNIVERSAL = exports.PRICE_RANGES_MINIMAL_VIEW = exports.formatWithSignificantDigits = exports.PRICE_THRESHOLD = void 0;
+/**
+ * Portable perps decimal formatters.
+ *
+ * These are the canonical implementations, exported from the controller so
+ * extension and any future consumer can import them directly.
+ * No mobile-specific imports — safe to sync to Core.
+ *
+ * Intl.NumberFormat instances are cached in a module-level Map keyed by
+ * serialized options, avoiding repeated construction costs.
+ */
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+// Module-level Intl.NumberFormat cache (keyed by serialized options).
+const _fmtCache = new Map();
+function _formatCurrency(value, currency, opts) {
+    const key = `${currency}:${opts.minimumFractionDigits}:${opts.maximumFractionDigits}`;
+    let formatter = _fmtCache.get(key);
+    if (!formatter) {
+        formatter = new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency,
+            currencyDisplay: 'narrowSymbol',
+            minimumFractionDigits: opts.minimumFractionDigits,
+            maximumFractionDigits: opts.maximumFractionDigits,
+        });
+        _fmtCache.set(key, formatter);
+    }
+    return formatter.format(value);
+}
+/**
+ * Internal equivalent of the mobile formatWithThreshold utility.
+ * Formats a currency value, returning "<$X.XX" for values below threshold.
+ *
+ * @param amount - The numeric amount to format.
+ * @param threshold - The threshold below which the "<" prefix is shown.
+ * @param options - Intl formatting options.
+ * @param options.currency - ISO 4217 currency code.
+ * @param options.minimumFractionDigits - Minimum decimal digits.
+ * @param options.maximumFractionDigits - Maximum decimal digits.
+ * @returns Formatted currency string.
+ */
+function _formatWithThreshold(amount, threshold, options) {
+    const formatOpts = {
+        minimumFractionDigits: options.minimumFractionDigits,
+        maximumFractionDigits: options.maximumFractionDigits,
+        currencyDisplay: 'narrowSymbol',
+    };
+    if (amount === 0) {
+        return _formatCurrency(0, options.currency, formatOpts);
+    }
+    return Math.abs(amount) < threshold
+        ? `<${_formatCurrency(threshold, options.currency, formatOpts)}`
+        : _formatCurrency(amount, options.currency, formatOpts);
+}
+/**
+ * Price threshold constants for PRICE_RANGES_UNIVERSAL
+ * These define the boundaries between different formatting ranges
+ */
+exports.PRICE_THRESHOLD = {
+    /** Very high values boundary (> $100k) */
+    VERY_HIGH: 100000,
+    /** High values boundary (> $10k) */
+    HIGH: 10000,
+    /** Large values boundary (> $1k) */
+    LARGE: 1000,
+    /** Medium values boundary (> $100) */
+    MEDIUM: 100,
+    /** Medium-low values boundary (> $10) */
+    MEDIUM_LOW: 10,
+    /** Low values boundary (>= $0.01) */
+    LOW: 0.01,
+    /**
+     * Very small values threshold (< $0.01)
+     * This is the minimum value for formatWithThreshold and should align with
+     * the 6 decimal maximum (0.000001 is the smallest representable value)
+     */
+    VERY_SMALL: 0.000001,
+};
+/**
+ * Formats a number to a specific number of significant digits
+ * Strips trailing zeros unless minDecimals requires them
+ *
+ * @param value - The numeric value to format
+ * @param significantDigits - Number of significant digits to maintain
+ * @param minDecimals - Minimum decimal places to show (may add zeros)
+ * @param maxDecimals - Maximum decimal places allowed
+ * @returns Formatted number with appropriate precision, trailing zeros removed
+ */
+function formatWithSignificantDigits(value, significantDigits, minDecimals, maxDecimals) {
+    // Handle special cases
+    if (value === 0) {
+        // Return zero with no trailing decimals by default (matches stripTrailingZeros behavior)
+        // Can be overridden by explicit minDecimals if needed
+        return { value: 0, decimals: minDecimals ?? 0 };
+    }
+    const absValue = Math.abs(value);
+    // For numbers >= 1, calculate decimals based on magnitude to achieve target significant figures
+    // This ensures consistent precision across different price ranges:
+    // Examples with 4 significant figures:
+    //   $123,456.78 → $123,456.78 (≥$1000: 2 decimals minimum, 8 sig figs)
+    //   $456.12 → $456.12 (≥$10: 2 decimals minimum, 5 sig figs)
+    //   $56.123 → $56.123 (≥$10: 2 decimals minimum, 5 sig figs)
+    //   $5.123 → $5.123 ($1-$10: 3 decimals = 4 sig figs)
+    //   $2.801 → $2.801 ($1-$10: 3 decimals = 4 sig figs)
+    //   $1.234 → $1.234 ($1-$10: 3 decimals = 4 sig figs)
+    if (absValue >= 1) {
+        let targetDecimals;
+        // Calculate decimals needed based on integer digits to achieve target significant figures
+        // For $38.388 with 5 sig figs: 2 integer digits, need 3 decimals (3,8,3,8,8)
+        // For $123.45 with 5 sig figs: 3 integer digits, need 2 decimals (1,2,3,4,5)
+        const integerDigits = Math.floor(Math.log10(absValue)) + 1;
+        const decimalsNeeded = significantDigits - integerDigits;
+        targetDecimals = Math.max(decimalsNeeded, 0); // Can't have negative decimals
+        // Apply explicit minimum decimals constraint if provided (for special cases)
+        if (minDecimals !== undefined && targetDecimals < minDecimals) {
+            targetDecimals = minDecimals;
+        }
+        // Apply maximum decimals constraint if specified
+        const finalDecimals = maxDecimals === undefined
+            ? targetDecimals
+            : Math.min(targetDecimals, maxDecimals);
+        // Round to prevent floating-point artifacts (e.g., 2.820000000000003 → 2.82)
+        const roundedValue = Number(value.toFixed(finalDecimals));
+        return {
+            value: roundedValue,
+            decimals: finalDecimals,
+        };
+    }
+    // For numbers < 1, use toPrecision to limit to significantDigits
+    // Examples: 0.1234, 0.01234 should show exactly 4 sig figs
+    const precisionStr = absValue.toPrecision(significantDigits);
+    const precisionNum = parseFloat(precisionStr);
+    // Convert to string to count actual decimals after trailing zeros are removed
+    const valueStr = precisionNum.toString();
+    const [, decPart = ''] = valueStr.split('.');
+    let actualDecimals = decPart.length;
+    // Apply min/max decimal constraints
+    if (minDecimals !== undefined && actualDecimals < minDecimals) {
+        actualDecimals = minDecimals; // Will add zeros if needed
+    }
+    if (maxDecimals !== undefined && actualDecimals > maxDecimals) {
+        actualDecimals = maxDecimals;
+    }
+    // Return the value with sign restored and decimal count
+    return {
+        value: value < 0 ? -precisionNum : precisionNum,
+        decimals: actualDecimals,
+    };
+}
+exports.formatWithSignificantDigits = formatWithSignificantDigits;
+/**
+ * Minimal view fiat range configuration
+ * Uses fiat-style stripping for clean currency display
+ * Strips only .00 to avoid partial decimals like $1,250.1
+ */
+exports.PRICE_RANGES_MINIMAL_VIEW = [
+    {
+        // Large values (>= $1000): Strip .00 only ($5,000 not $5,000.00, but $5,000.10 stays)
+        condition: (val) => Math.abs(val) >= exports.PRICE_THRESHOLD.LARGE,
+        minimumDecimals: 2,
+        maximumDecimals: 2,
+        threshold: exports.PRICE_THRESHOLD.LARGE,
+        stripTrailingZeros: true,
+        fiatStyleStripping: true,
+    },
+    {
+        // Small values (< $1000): Also use fiat-style stripping ($100 not $100.00, but $13.40 stays)
+        condition: () => true,
+        minimumDecimals: 2,
+        maximumDecimals: 2,
+        threshold: exports.PRICE_THRESHOLD.LOW,
+        stripTrailingZeros: true,
+        fiatStyleStripping: true,
+    },
+];
+/**
+ * Universal price range configuration following comprehensive rules from rules-decimals.md
+ *
+ * Rules:
+ * - Max 6 decimals across all ranges (Hyperliquid limit)
+ * - Strip trailing zeros by default
+ * - Use |v| (absolute value) for conditions
+ *
+ * Significant digits by range:
+ * - > $100,000: 6 sig digs
+ * - $100,000 > x > $0.01: 5 sig digs
+ * - < $0.01: 4 sig digs
+ *
+ * Decimal limits by price range:
+ * - |v| > 10,000: min 0, max 0 decimals; 5 sig digs (6 if >100k)
+ * - |v| > 1,000: min 0, max 1 decimal; 5 sig digs
+ * - |v| > 100: min 0, max 2 decimals; 5 sig digs
+ * - |v| > 10: min 0, max 4 decimals; 5 sig digs
+ * - |v| ≥ 0.01: 5 sig digs, min 2, max 6 decimals
+ * - |v| < 0.01: 4 sig digs, min 2, max 6 decimals
+ *
+ * Examples:
+ * - $123,456.78 → $123,457 (>$10k: 0 decimals, 6 sig figs)
+ * - $12,345.67 → $12,346 (>$10k: 0 decimals, 5 sig figs)
+ * - $1,234.56 → $1,234.6 ($1k-$10k: 1 decimal, 5 sig figs)
+ * - $123.456 → $123.46 ($100-$1k: 2 decimals, 5 sig figs)
+ * - $12.34567 → $12.346 ($10-$100: 4 decimals, 5 sig figs)
+ * - $1.3445555 → $1.3446 (≥$0.01: 5 sig figs)
+ * - $0.333333 → $0.33333 (≥$0.01: 5 sig figs)
+ * - $0.004236 → $0.004236 (<$0.01: 4 sig figs, max 6 decimals)
+ * - $0.0000006 → $0.000001 (<$0.01: 4 sig figs, rounds with max 6 decimals)
+ */
+exports.PRICE_RANGES_UNIVERSAL = [
+    {
+        // Very high values (> $100,000): No decimals, 6 significant figures
+        // Ex: $123,456.78 → $123,457
+        condition: (val) => Math.abs(val) > exports.PRICE_THRESHOLD.VERY_HIGH,
+        minimumDecimals: 0,
+        maximumDecimals: 0,
+        significantDigits: 6,
+        threshold: exports.PRICE_THRESHOLD.VERY_HIGH,
+    },
+    {
+        // High values ($10,000-$100,000]: No decimals, 5 significant figures
+        // Ex: $12,345.67 → $12,346
+        condition: (val) => Math.abs(val) > exports.PRICE_THRESHOLD.HIGH,
+        minimumDecimals: 0,
+        maximumDecimals: 0,
+        significantDigits: 5,
+        threshold: exports.PRICE_THRESHOLD.HIGH,
+    },
+    {
+        // Large values ($1,000-$10,000]: Max 1 decimal, 5 significant figures
+        // Ex: $1,234.56 → $1,234.6
+        condition: (val) => Math.abs(val) > exports.PRICE_THRESHOLD.LARGE,
+        minimumDecimals: 0,
+        maximumDecimals: 1,
+        significantDigits: 5,
+        threshold: exports.PRICE_THRESHOLD.LARGE,
+    },
+    {
+        // Medium values ($100-$1,000]: Max 2 decimals, 5 significant figures
+        // Ex: $123.456 → $123.46
+        condition: (val) => Math.abs(val) > exports.PRICE_THRESHOLD.MEDIUM,
+        minimumDecimals: 0,
+        maximumDecimals: 2,
+        significantDigits: 5,
+        threshold: exports.PRICE_THRESHOLD.MEDIUM,
+    },
+    {
+        // Medium-low values ($10-$100]: Max 4 decimals, 5 significant figures
+        // Ex: $12.34567 → $12.346
+        condition: (val) => Math.abs(val) > exports.PRICE_THRESHOLD.MEDIUM_LOW,
+        minimumDecimals: 0,
+        maximumDecimals: 4,
+        significantDigits: 5,
+        threshold: exports.PRICE_THRESHOLD.MEDIUM_LOW,
+    },
+    {
+        // Low values ($0.01-$10]: 5 significant figures, min 2 max MAX_PRICE_DECIMALS decimals
+        // Ex: $1.3445555 → $1.3446 | $0.333333 → $0.33333
+        condition: (val) => Math.abs(val) >= exports.PRICE_THRESHOLD.LOW,
+        significantDigits: 5,
+        minimumDecimals: 2,
+        maximumDecimals: perpsConfig_1.DECIMAL_PRECISION_CONFIG.MaxPriceDecimals,
+        threshold: exports.PRICE_THRESHOLD.LOW,
+    },
+    {
+        // Very small values (< $0.01): 4 significant figures, min 2 max MAX_PRICE_DECIMALS decimals
+        // Ex: $0.004236 → $0.004236 | $0.0000006 → $0.000001
+        condition: () => true,
+        significantDigits: 4,
+        minimumDecimals: 2,
+        maximumDecimals: perpsConfig_1.DECIMAL_PRECISION_CONFIG.MaxPriceDecimals,
+        threshold: exports.PRICE_THRESHOLD.VERY_SMALL,
+    },
+];
+/**
+ * Formats a balance value as USD currency with appropriate decimal places
+ *
+ * @param balance - Raw numeric balance value (e.g., 1234.56, not token minimal denomination)
+ * @param options - Optional formatting options
+ * @param options.minimumDecimals - Global minimum decimal places (overrides range configs)
+ * @param options.maximumDecimals - Global maximum decimal places (overrides range configs)
+ * @param options.significantDigits - Global significant digits (overrides decimal settings when set)
+ * @param options.ranges - Custom range configurations (defaults to PRICE_RANGES_MINIMAL_VIEW)
+ * @param options.currency - Currency code (default: 'USD')
+ * @param options.locale - Locale for formatting (default: 'en-US')
+ * @param options.stripTrailingZeros - Strip trailing zeros from output (default: false via PRICE_RANGES_MINIMAL_VIEW). When true, overrides minimumDecimals constraint.
+ * @returns Formatted currency string with variable decimals based on configured ranges
+ * @example
+ * // Using defaults (preserves trailing zeros for fiat)
+ * formatPerpsFiat(1234.56) => "$1,234.56"
+ * formatPerpsFiat(1250.00) => "$1,250.00"  // Trailing zeros preserved
+ * formatPerpsFiat(50000) => "$50,000.00"   // Trailing zeros preserved
+ *
+ * // Stripping trailing zeros when needed (e.g., for crypto)
+ * formatPerpsFiat(1250, { stripTrailingZeros: true }) => "$1,250"
+ *
+ * // With custom ranges
+ * formatPerpsFiat(0.00001, {
+ *   ranges: [
+ *     { condition: (v) => v < 0.001, minimumDecimals: 6, maximumDecimals: 8 },
+ *     { condition: () => true, minimumDecimals: 2, maximumDecimals: 2 }
+ *   ]
+ * }) => "$0.00001"  // Trailing zero stripped
+ *
+ * // With significant digits
+ * formatPerpsFiat(1234.56789, { significantDigits: 5 }) => "$1,234.6"
+ * formatPerpsFiat(0.0001234, { significantDigits: 3 }) => "$0.000123"
+ */
+const formatPerpsFiat = (balance, options) => {
+    const value = typeof balance === 'string' ? parseFloat(balance) : balance;
+    const currency = options?.currency ?? 'USD';
+    let formatted;
+    if (isNaN(value)) {
+        // Return placeholder for invalid values to avoid confusion with actual $0 values
+        return perpsConfig_1.PERPS_CONSTANTS.FallbackPriceDisplay;
+    }
+    // Use custom ranges or defaults
+    const ranges = options?.ranges ?? exports.PRICE_RANGES_MINIMAL_VIEW;
+    // Find the first matching range configuration
+    const rangeConfig = ranges.find((range) => range.condition(value));
+    if (rangeConfig) {
+        // Check for significant digits (global or range-specific)
+        const sigDigits = options?.significantDigits ?? rangeConfig.significantDigits;
+        // If significant digits are specified, use them
+        if (sigDigits) {
+            // Get min/max decimals (global overrides range, range overrides default)
+            const minDecimals = options?.minimumDecimals ?? rangeConfig.minimumDecimals;
+            const maxDecimals = options?.maximumDecimals ?? rangeConfig.maximumDecimals;
+            // Calculate appropriate formatting based on significant digits
+            const { value: formattedValue, decimals } = formatWithSignificantDigits(value, sigDigits, minDecimals, maxDecimals);
+            // Format with the calculated decimal places
+            formatted = _formatWithThreshold(formattedValue, rangeConfig.threshold ?? 0.01, {
+                currency,
+                minimumFractionDigits: decimals,
+                maximumFractionDigits: decimals,
+            });
+        }
+        else {
+            // Standard decimal-based formatting (existing logic)
+            const minDecimals = options?.minimumDecimals ?? rangeConfig.minimumDecimals;
+            const maxDecimals = options?.maximumDecimals ?? rangeConfig.maximumDecimals;
+            // Use custom formatting if provided
+            if (rangeConfig.customFormat) {
+                formatted = rangeConfig.customFormat(value, options?.locale ?? 'en-US', currency);
+            }
+            else {
+                // Use standard formatting with threshold
+                formatted = _formatWithThreshold(value, rangeConfig.threshold ?? 0.01, {
+                    currency,
+                    minimumFractionDigits: minDecimals,
+                    maximumFractionDigits: maxDecimals,
+                });
+            }
+        }
+    }
+    else {
+        // Fallback if no range matches (shouldn't happen with proper default config)
+        const fallbackMin = options?.minimumDecimals ?? 2;
+        const fallbackMax = options?.maximumDecimals ?? 2;
+        formatted = _formatWithThreshold(value, 0.01, {
+            currency,
+            minimumFractionDigits: fallbackMin,
+            maximumFractionDigits: fallbackMax,
+        });
+    }
+    // Post-process: strip trailing zeros unless explicitly disabled
+    // Priority: explicit options.stripTrailingZeros false > rangeConfig > options default > true
+    // If options.stripTrailingZeros is explicitly false, skip stripping entirely
+    if (options?.stripTrailingZeros === false) {
+        return formatted;
+    }
+    // Otherwise check range config or default to true
+    const shouldStrip = rangeConfig?.stripTrailingZeros ?? options?.stripTrailingZeros ?? true;
+    if (shouldStrip) {
+        // Check if fiat-style stripping is enabled (only strips .00)
+        const useFiatStyle = rangeConfig?.fiatStyleStripping ?? false;
+        if (useFiatStyle) {
+            // Fiat-style: Only strip .00 (no meaningful decimals), preserve 2-decimal format
+            // Examples: $1,250.00 → $1,250 | $1,000.10 → $1,000.10 | $13.40 → $13.40
+            return formatted.replace(/\.00$/u, '');
+        }
+        // Standard: Strip all trailing zeros after decimal point
+        // Examples: $1,250.00 → $1,250 | $100.0 → $100 | $10.5 → $10.5 | $1.234 → $1.234
+        return formatted.replace(/(\.\d*?)0+$/u, '$1').replace(/\.$/u, '');
+    }
+    return formatted;
+};
+exports.formatPerpsFiat = formatPerpsFiat;
+/**
+ * Formats position size with variable decimal precision based on magnitude or asset-specific decimals
+ * Removes trailing zeros to match task requirements
+ *
+ * @param size - Raw position size value
+ * @param szDecimals - Optional asset-specific decimal precision from Hyperliquid metadata (e.g., BTC=5, ETH=4, DOGE=1)
+ * @returns Format varies by size or uses asset-specific decimals, with trailing zeros removed:
+ * If szDecimals provided: Uses exact decimals (e.g., 0.00009 BTC with szDecimals=5 => "0.00009")
+ * Otherwise falls back to magnitude-based logic:
+ * - Size < 0.01: Up to 6 decimals (e.g., "0.00009" not "0.000090")
+ * - Size < 1: Up to 4 decimals (e.g., "0.0024" not "0.002400")
+ * - Size >= 1: Up to 2 decimals (e.g., "44" not "44.00")
+ * @example formatPositionSize(0.00009, 5) => "0.00009" (uses szDecimals)
+ * @example formatPositionSize(44.00, 1) => "44" (uses szDecimals, trailing zeros removed)
+ * @example formatPositionSize(0.0024) => "0.0024" (no szDecimals, uses magnitude logic)
+ * @example formatPositionSize(44.00) => "44" (no szDecimals, uses magnitude logic)
+ */
+const formatPositionSize = (size, szDecimals) => {
+    const value = typeof size === 'string' ? parseFloat(size) : size;
+    if (isNaN(value) || value === 0) {
+        return '0';
+    }
+    // Use asset-specific decimals if provided (Hyperliquid metadata)
+    if (szDecimals !== undefined) {
+        return value.toFixed(szDecimals).replace(/\.?0+$/u, '');
+    }
+    // Fallback: magnitude-based decimal logic for backwards compatibility
+    const abs = Math.abs(value);
+    let formatted;
+    if (abs < 0.01) {
+        // For very small numbers, use more decimal places
+        formatted = value.toFixed(6);
+    }
+    else if (abs < 1) {
+        // For small numbers, use 4 decimal places
+        formatted = value.toFixed(4);
+    }
+    else {
+        // For normal numbers, use 2 decimal places
+        formatted = value.toFixed(2);
+    }
+    // Remove trailing zeros and unnecessary decimal point
+    return formatted.replace(/\.?0+$/u, '');
+};
+exports.formatPositionSize = formatPositionSize;
+/**
+ * Formats a PnL (Profit and Loss) value with sign prefix
+ *
+ * @param pnl - Raw numeric PnL value (positive for profit, negative for loss)
+ * @returns Format: "+$X,XXX.XX" or "-$X,XXX.XX" (always shows sign, 2 decimals)
+ * @example formatPnl(1234.56) => "+$1,234.56"
+ * @example formatPnl(-500) => "-$500.00"
+ * @example formatPnl(0) => "+$0.00"
+ */
+const formatPnl = (pnl) => {
+    const value = typeof pnl === 'string' ? parseFloat(pnl) : pnl;
+    if (isNaN(value)) {
+        return perpsConfig_1.PERPS_CONSTANTS.ZeroAmountDetailedDisplay;
+    }
+    const formatted = _formatCurrency(Math.abs(value), 'USD', {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    });
+    return value >= 0 ? `+${formatted}` : `-${formatted}`;
+};
+exports.formatPnl = formatPnl;
+/**
+ * Formats a percentage value with sign prefix
+ *
+ * @param value - Raw percentage value (e.g., 5.25 for 5.25%, not 0.0525)
+ * @param decimals - Number of decimal places to show (default: 2)
+ * @returns Format: "+X.XX%" or "-X.XX%" (always shows sign, 2 decimals)
+ * @example formatPercentage(5.25) => "+5.25%"
+ * @example formatPercentage(-2.75) => "-2.75%"
+ * @example formatPercentage(0) => "+0.00%"
+ */
+const formatPercentage = (value, decimals = 2) => {
+    const parsed = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(parsed)) {
+        return '0.00%';
+    }
+    return `${parsed >= 0 ? '+' : ''}${parsed.toFixed(decimals)}%`;
+};
+exports.formatPercentage = formatPercentage;
+/**
+ * Formats funding rate for display
+ *
+ * @param value - Raw funding rate value (decimal, not percentage)
+ * @param options - Optional formatting options
+ * @param options.showZero - Whether to return zero display value for zero/undefined (default: true)
+ * @returns Formatted funding rate as percentage string
+ * @example formatFundingRate(0.0005) => "0.0500%"
+ * @example formatFundingRate(-0.0001) => "-0.0100%"
+ * @example formatFundingRate(undefined) => "0.0000%"
+ */
+const formatFundingRate = (value, options) => {
+    const showZero = options?.showZero ?? true;
+    if (value === undefined || value === null) {
+        return showZero ? perpsConfig_1.FUNDING_RATE_CONFIG.ZeroDisplay : '';
+    }
+    const percentage = value * perpsConfig_1.FUNDING_RATE_CONFIG.PercentageMultiplier;
+    const formatted = percentage.toFixed(perpsConfig_1.FUNDING_RATE_CONFIG.Decimals);
+    // Check if the result is effectively zero
+    if (showZero && parseFloat(formatted) === 0) {
+        return perpsConfig_1.FUNDING_RATE_CONFIG.ZeroDisplay;
+    }
+    return `${formatted}%`;
+};
+exports.formatFundingRate = formatFundingRate;
+//# sourceMappingURL=perpsFormatters.cjs.map

package/dist/utils/perpsFormatters.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perpsFormatters.cjs","sourceRoot":"","sources":["../../src/utils/perpsFormatters.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,8DAIkC;AAElC,sEAAsE;AACtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEvD,SAAS,eAAe,CACtB,KAAa,EACb,QAAgB,EAChB,IAAsE;IAEtE,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACtF,IAAI,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;YACzC,KAAK,EAAE,UAAU;YACjB,QAAQ;YACR,eAAe,EAAE,cAAc;YAC/B,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;SAClD,CAAC,CAAC;QACH,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,oBAAoB,CAC3B,MAAc,EACd,SAAiB,EACjB,OAIC;IAED,MAAM,UAAU,GAAG;QACjB,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;QACpD,eAAe,EAAE,cAAuB;KACzC,CAAC;IACF,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,eAAe,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS;QACjC,CAAC,CAAC,IAAI,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE;QAChE,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,0CAA0C;IAC1C,SAAS,EAAE,MAAO;IAClB,oCAAoC;IACpC,IAAI,EAAE,KAAM;IACZ,oCAAoC;IACpC,KAAK,EAAE,IAAK;IACZ,sCAAsC;IACtC,MAAM,EAAE,GAAG;IACX,yCAAyC;IACzC,UAAU,EAAE,EAAE;IACd,qCAAqC;IACrC,GAAG,EAAE,IAAI;IACT;;;;OAIG;IACH,UAAU,EAAE,QAAQ;CACZ,CAAC;AA+BX;;;;;;;;;GASG;AACH,SAAgB,2BAA2B,CACzC,KAAa,EACb,iBAAyB,EACzB,WAAoB,EACpB,WAAoB;IAEpB,uBAAuB;IACvB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,yFAAyF;QACzF,sDAAsD;QACtD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEjC,gGAAgG;IAChG,mEAAmE;IACnE,uCAAuC;IACvC,uEAAuE;IACvE,6DAA6D;IAC7D,6DAA6D;IAC7D,sDAAsD;IACtD,sDAAsD;IACtD,sDAAsD;IACtD,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,cAAsB,CAAC;QAE3B,0FAA0F;QAC1F,6EAA6E;QAC7E,6EAA6E;QAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,cAAc,GAAG,iBAAiB,GAAG,aAAa,CAAC;QACzD,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,+BAA+B;QAE7E,6EAA6E;QAC7E,IAAI,WAAW,KAAK,SAAS,IAAI,cAAc,GAAG,WAAW,EAAE,CAAC;YAC9D,cAAc,GAAG,WAAW,CAAC;QAC/B,CAAC;QAED,iDAAiD;QACjD,MAAM,aAAa,GACjB,WAAW,KAAK,SAAS;YACvB,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAE5C,6EAA6E;QAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAE1D,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,QAAQ,EAAE,aAAa;SACxB,CAAC;IACJ,CAAC;IAED,iEAAiE;IACjE,2DAA2D;IAC3D,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE9C,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAEpC,oCAAoC;IACpC,IAAI,WAAW,KAAK,SAAS,IAAI,cAAc,GAAG,WAAW,EAAE,CAAC;QAC9D,cAAc,GAAG,WAAW,CAAC,CAAC,2BAA2B;IAC3D,CAAC;IACD,IAAI,WAAW,KAAK,SAAS,IAAI,cAAc,GAAG,WAAW,EAAE,CAAC;QAC9D,cAAc,GAAG,WAAW,CAAC;IAC/B,CAAC;IAED,wDAAwD;IACxD,OAAO;QACL,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;QAC/C,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC;AA7ED,kEA6EC;AAED;;;;GAIG;AACU,QAAA,yBAAyB,GAAsB;IAC1D;QACE,sFAAsF;QACtF,SAAS,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,uBAAe,CAAC,KAAK;QAClE,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,uBAAe,CAAC,KAAK;QAChC,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,IAAI;KACzB;IACD;QACE,6FAA6F;QAC7F,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,uBAAe,CAAC,GAAG;QAC9B,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,IAAI;KACzB;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACU,QAAA,sBAAsB,GAAsB;IACvD;QACE,oEAAoE;QACpE,6BAA6B;QAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,uBAAe,CAAC,SAAS;QAC7D,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,uBAAe,CAAC,SAAS;KACrC;IACD;QACE,qEAAqE;QACrE,2BAA2B;QAC3B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,uBAAe,CAAC,IAAI;QACxD,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,uBAAe,CAAC,IAAI;KAChC;IACD;QACE,sEAAsE;QACtE,2BAA2B;QAC3B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,uBAAe,CAAC,KAAK;QACzD,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,uBAAe,CAAC,KAAK;KACjC;IACD;QACE,qEAAqE;QACrE,yBAAyB;QACzB,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,uBAAe,CAAC,MAAM;QAC1D,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,uBAAe,CAAC,MAAM;KAClC;IACD;QACE,sEAAsE;QACtE,0BAA0B;QAC1B,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,uBAAe,CAAC,UAAU;QAC9D,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,uBAAe,CAAC,UAAU;KACtC;IACD;QACE,uFAAuF;QACvF,kDAAkD;QAClD,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,uBAAe,CAAC,GAAG;QACxD,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,sCAAwB,CAAC,gBAAgB;QAC1D,SAAS,EAAE,uBAAe,CAAC,GAAG;KAC/B;IACD;QACE,4FAA4F;QAC5F,qDAAqD;QACrD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,sCAAwB,CAAC,gBAAgB;QAC1D,SAAS,EAAE,uBAAe,CAAC,UAAU;KACtC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACI,MAAM,eAAe,GAAG,CAC7B,OAAwB,EACxB,OAQC,EACO,EAAE;IACV,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;IAE5C,IAAI,SAAiB,CAAC;IAEtB,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,iFAAiF;QACjF,OAAO,6BAAe,CAAC,oBAAoB,CAAC;IAC9C,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,iCAAyB,CAAC;IAE5D,8CAA8C;IAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnE,IAAI,WAAW,EAAE,CAAC;QAChB,0DAA0D;QAC1D,MAAM,SAAS,GACb,OAAO,EAAE,iBAAiB,IAAI,WAAW,CAAC,iBAAiB,CAAC;QAE9D,gDAAgD;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,yEAAyE;YACzE,MAAM,WAAW,GACf,OAAO,EAAE,eAAe,IAAI,WAAW,CAAC,eAAe,CAAC;YAC1D,MAAM,WAAW,GACf,OAAO,EAAE,eAAe,IAAI,WAAW,CAAC,eAAe,CAAC;YAE1D,+DAA+D;YAC/D,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,2BAA2B,CACrE,KAAK,EACL,SAAS,EACT,WAAW,EACX,WAAW,CACZ,CAAC;YAEF,4CAA4C;YAC5C,SAAS,GAAG,oBAAoB,CAC9B,cAAc,EACd,WAAW,CAAC,SAAS,IAAI,IAAI,EAC7B;gBACE,QAAQ;gBACR,qBAAqB,EAAE,QAAQ;gBAC/B,qBAAqB,EAAE,QAAQ;aAChC,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,MAAM,WAAW,GACf,OAAO,EAAE,eAAe,IAAI,WAAW,CAAC,eAAe,CAAC;YAC1D,MAAM,WAAW,GACf,OAAO,EAAE,eAAe,IAAI,WAAW,CAAC,eAAe,CAAC;YAE1D,oCAAoC;YACpC,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gBAC7B,SAAS,GAAG,WAAW,CAAC,YAAY,CAClC,KAAK,EACL,OAAO,EAAE,MAAM,IAAI,OAAO,EAC1B,QAAQ,CACT,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,SAAS,GAAG,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,SAAS,IAAI,IAAI,EAAE;oBACrE,QAAQ;oBACR,qBAAqB,EAAE,WAAW;oBAClC,qBAAqB,EAAE,WAAW;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,6EAA6E;QAC7E,MAAM,WAAW,GAAG,OAAO,EAAE,eAAe,IAAI,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,OAAO,EAAE,eAAe,IAAI,CAAC,CAAC;QAClD,SAAS,GAAG,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE;YAC5C,QAAQ;YACR,qBAAqB,EAAE,WAAW;YAClC,qBAAqB,EAAE,WAAW;SACnC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,6FAA6F;IAC7F,6EAA6E;IAC7E,IAAI,OAAO,EAAE,kBAAkB,KAAK,KAAK,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kDAAkD;IAClD,MAAM,WAAW,GACf,WAAW,EAAE,kBAAkB,IAAI,OAAO,EAAE,kBAAkB,IAAI,IAAI,CAAC;IAEzE,IAAI,WAAW,EAAE,CAAC;QAChB,6DAA6D;QAC7D,MAAM,YAAY,GAAG,WAAW,EAAE,kBAAkB,IAAI,KAAK,CAAC;QAE9D,IAAI,YAAY,EAAE,CAAC;YACjB,iFAAiF;YACjF,yEAAyE;YACzE,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,yDAAyD;QACzD,iFAAiF;QACjF,OAAO,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAvHW,QAAA,eAAe,mBAuH1B;AAEF;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,kBAAkB,GAAG,CAChC,IAAqB,EACrB,UAAmB,EACX,EAAE;IACV,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEjE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iEAAiE;IACjE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,sEAAsE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,SAAiB,CAAC;IAEtB,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACf,kDAAkD;QAClD,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACnB,0CAA0C;QAC1C,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,2CAA2C;QAC3C,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,sDAAsD;IACtD,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC,CAAC;AAhCW,QAAA,kBAAkB,sBAgC7B;AAEF;;;;;;;;GAQG;AACI,MAAM,SAAS,GAAG,CAAC,GAAoB,EAAU,EAAE;IACxD,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAE9D,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,6BAAe,CAAC,yBAAyB,CAAC;IACnD,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE;QACxD,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;KACzB,CAAC,CAAC;IAEH,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;AACxD,CAAC,CAAC;AAbW,QAAA,SAAS,aAapB;AAEF;;;;;;;;;GASG;AACI,MAAM,gBAAgB,GAAG,CAC9B,KAAsB,EACtB,WAAmB,CAAC,EACZ,EAAE;IACV,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAErE,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;AACjE,CAAC,CAAC;AAXW,QAAA,gBAAgB,oBAW3B;AAEF;;;;;;;;;;GAUG;AACI,MAAM,iBAAiB,GAAG,CAC/B,KAAqB,EACrB,OAAgC,EACxB,EAAE;IACV,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;IAE3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,CAAC,CAAC,iCAAmB,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,GAAG,iCAAmB,CAAC,oBAAoB,CAAC;IACpE,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,iCAAmB,CAAC,QAAQ,CAAC,CAAC;IAEnE,0CAA0C;IAC1C,IAAI,QAAQ,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,iCAAmB,CAAC,WAAW,CAAC;IACzC,CAAC;IAED,OAAO,GAAG,SAAS,GAAG,CAAC;AACzB,CAAC,CAAC;AAnBW,QAAA,iBAAiB,qBAmB5B","sourcesContent":["/**\n * Portable perps decimal formatters.\n *\n * These are the canonical implementations, exported from the controller so\n * extension and any future consumer can import them directly.\n * No mobile-specific imports — safe to sync to Core.\n *\n * Intl.NumberFormat instances are cached in a module-level Map keyed by\n * serialized options, avoiding repeated construction costs.\n */\nimport {\n  DECIMAL_PRECISION_CONFIG,\n  FUNDING_RATE_CONFIG,\n  PERPS_CONSTANTS,\n} from '../constants/perpsConfig';\n\n// Module-level Intl.NumberFormat cache (keyed by serialized options).\nconst _fmtCache = new Map<string, Intl.NumberFormat>();\n\nfunction _formatCurrency(\n  value: number,\n  currency: string,\n  opts: { minimumFractionDigits: number; maximumFractionDigits: number },\n): string {\n  const key = `${currency}:${opts.minimumFractionDigits}:${opts.maximumFractionDigits}`;\n  let formatter = _fmtCache.get(key);\n  if (!formatter) {\n    formatter = new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency,\n      currencyDisplay: 'narrowSymbol',\n      minimumFractionDigits: opts.minimumFractionDigits,\n      maximumFractionDigits: opts.maximumFractionDigits,\n    });\n    _fmtCache.set(key, formatter);\n  }\n  return formatter.format(value);\n}\n\n/**\n * Internal equivalent of the mobile formatWithThreshold utility.\n * Formats a currency value, returning \"<$X.XX\" for values below threshold.\n *\n * @param amount - The numeric amount to format.\n * @param threshold - The threshold below which the \"<\" prefix is shown.\n * @param options - Intl formatting options.\n * @param options.currency - ISO 4217 currency code.\n * @param options.minimumFractionDigits - Minimum decimal digits.\n * @param options.maximumFractionDigits - Maximum decimal digits.\n * @returns Formatted currency string.\n */\nfunction _formatWithThreshold(\n  amount: number,\n  threshold: number,\n  options: {\n    currency: string;\n    minimumFractionDigits: number;\n    maximumFractionDigits: number;\n  },\n): string {\n  const formatOpts = {\n    minimumFractionDigits: options.minimumFractionDigits,\n    maximumFractionDigits: options.maximumFractionDigits,\n    currencyDisplay: 'narrowSymbol' as const,\n  };\n  if (amount === 0) {\n    return _formatCurrency(0, options.currency, formatOpts);\n  }\n  return Math.abs(amount) < threshold\n    ? `<${_formatCurrency(threshold, options.currency, formatOpts)}`\n    : _formatCurrency(amount, options.currency, formatOpts);\n}\n\n/**\n * Price threshold constants for PRICE_RANGES_UNIVERSAL\n * These define the boundaries between different formatting ranges\n */\nexport const PRICE_THRESHOLD = {\n  /** Very high values boundary (> $100k) */\n  VERY_HIGH: 100_000,\n  /** High values boundary (> $10k) */\n  HIGH: 10_000,\n  /** Large values boundary (> $1k) */\n  LARGE: 1_000,\n  /** Medium values boundary (> $100) */\n  MEDIUM: 100,\n  /** Medium-low values boundary (> $10) */\n  MEDIUM_LOW: 10,\n  /** Low values boundary (>= $0.01) */\n  LOW: 0.01,\n  /**\n   * Very small values threshold (< $0.01)\n   * This is the minimum value for formatWithThreshold and should align with\n   * the 6 decimal maximum (0.000001 is the smallest representable value)\n   */\n  VERY_SMALL: 0.000001,\n} as const;\n\n/**\n * Configuration for a specific number range formatting\n */\nexport type FiatRangeConfig = {\n  /**\n   * The condition to match for this range (e.g., < 0.0001, < 1, >= 1000)\n   * Function should return true if this config should be applied\n   */\n  condition: (value: number) => boolean;\n  /** Minimum decimal places for this range */\n  minimumDecimals: number;\n  /** Maximum decimal places for this range */\n  maximumDecimals: number;\n  /** Optional threshold for formatWithThreshold (defaults to the range boundary) */\n  threshold?: number;\n  /** Optional significant digits for this range (overrides decimal places when set) */\n  significantDigits?: number;\n  /** Optional custom formatting logic for this range */\n  customFormat?: (value: number, locale: string, currency: string) => string;\n  /** Optional flag to strip trailing zeros for this range (overrides global stripTrailingZeros option) */\n  stripTrailingZeros?: boolean;\n  /**\n   * Optional flag for fiat-style stripping (only strips .00, preserves meaningful decimals like .10, .40)\n   * When true, \"$1,250.00\" → \"$1,250\" but \"$1,250.10\" stays \"$1,250.10\"\n   * When false (default), strips all trailing zeros: \"$1,250.10\" → \"$1,250.1\"\n   */\n  fiatStyleStripping?: boolean;\n};\n\n/**\n * Formats a number to a specific number of significant digits\n * Strips trailing zeros unless minDecimals requires them\n *\n * @param value - The numeric value to format\n * @param significantDigits - Number of significant digits to maintain\n * @param minDecimals - Minimum decimal places to show (may add zeros)\n * @param maxDecimals - Maximum decimal places allowed\n * @returns Formatted number with appropriate precision, trailing zeros removed\n */\nexport function formatWithSignificantDigits(\n  value: number,\n  significantDigits: number,\n  minDecimals?: number,\n  maxDecimals?: number,\n): { value: number; decimals: number } {\n  // Handle special cases\n  if (value === 0) {\n    // Return zero with no trailing decimals by default (matches stripTrailingZeros behavior)\n    // Can be overridden by explicit minDecimals if needed\n    return { value: 0, decimals: minDecimals ?? 0 };\n  }\n\n  const absValue = Math.abs(value);\n\n  // For numbers >= 1, calculate decimals based on magnitude to achieve target significant figures\n  // This ensures consistent precision across different price ranges:\n  // Examples with 4 significant figures:\n  //   $123,456.78 → $123,456.78 (≥$1000: 2 decimals minimum, 8 sig figs)\n  //   $456.12 → $456.12 (≥$10: 2 decimals minimum, 5 sig figs)\n  //   $56.123 → $56.123 (≥$10: 2 decimals minimum, 5 sig figs)\n  //   $5.123 → $5.123 ($1-$10: 3 decimals = 4 sig figs)\n  //   $2.801 → $2.801 ($1-$10: 3 decimals = 4 sig figs)\n  //   $1.234 → $1.234 ($1-$10: 3 decimals = 4 sig figs)\n  if (absValue >= 1) {\n    let targetDecimals: number;\n\n    // Calculate decimals needed based on integer digits to achieve target significant figures\n    // For $38.388 with 5 sig figs: 2 integer digits, need 3 decimals (3,8,3,8,8)\n    // For $123.45 with 5 sig figs: 3 integer digits, need 2 decimals (1,2,3,4,5)\n    const integerDigits = Math.floor(Math.log10(absValue)) + 1;\n    const decimalsNeeded = significantDigits - integerDigits;\n    targetDecimals = Math.max(decimalsNeeded, 0); // Can't have negative decimals\n\n    // Apply explicit minimum decimals constraint if provided (for special cases)\n    if (minDecimals !== undefined && targetDecimals < minDecimals) {\n      targetDecimals = minDecimals;\n    }\n\n    // Apply maximum decimals constraint if specified\n    const finalDecimals =\n      maxDecimals === undefined\n        ? targetDecimals\n        : Math.min(targetDecimals, maxDecimals);\n\n    // Round to prevent floating-point artifacts (e.g., 2.820000000000003 → 2.82)\n    const roundedValue = Number(value.toFixed(finalDecimals));\n\n    return {\n      value: roundedValue,\n      decimals: finalDecimals,\n    };\n  }\n\n  // For numbers < 1, use toPrecision to limit to significantDigits\n  // Examples: 0.1234, 0.01234 should show exactly 4 sig figs\n  const precisionStr = absValue.toPrecision(significantDigits);\n  const precisionNum = parseFloat(precisionStr);\n\n  // Convert to string to count actual decimals after trailing zeros are removed\n  const valueStr = precisionNum.toString();\n  const [, decPart = ''] = valueStr.split('.');\n  let actualDecimals = decPart.length;\n\n  // Apply min/max decimal constraints\n  if (minDecimals !== undefined && actualDecimals < minDecimals) {\n    actualDecimals = minDecimals; // Will add zeros if needed\n  }\n  if (maxDecimals !== undefined && actualDecimals > maxDecimals) {\n    actualDecimals = maxDecimals;\n  }\n\n  // Return the value with sign restored and decimal count\n  return {\n    value: value < 0 ? -precisionNum : precisionNum,\n    decimals: actualDecimals,\n  };\n}\n\n/**\n * Minimal view fiat range configuration\n * Uses fiat-style stripping for clean currency display\n * Strips only .00 to avoid partial decimals like $1,250.1\n */\nexport const PRICE_RANGES_MINIMAL_VIEW: FiatRangeConfig[] = [\n  {\n    // Large values (>= $1000): Strip .00 only ($5,000 not $5,000.00, but $5,000.10 stays)\n    condition: (val: number) => Math.abs(val) >= PRICE_THRESHOLD.LARGE,\n    minimumDecimals: 2,\n    maximumDecimals: 2,\n    threshold: PRICE_THRESHOLD.LARGE,\n    stripTrailingZeros: true,\n    fiatStyleStripping: true,\n  },\n  {\n    // Small values (< $1000): Also use fiat-style stripping ($100 not $100.00, but $13.40 stays)\n    condition: () => true,\n    minimumDecimals: 2,\n    maximumDecimals: 2,\n    threshold: PRICE_THRESHOLD.LOW,\n    stripTrailingZeros: true,\n    fiatStyleStripping: true,\n  },\n];\n\n/**\n * Universal price range configuration following comprehensive rules from rules-decimals.md\n *\n * Rules:\n * - Max 6 decimals across all ranges (Hyperliquid limit)\n * - Strip trailing zeros by default\n * - Use |v| (absolute value) for conditions\n *\n * Significant digits by range:\n * - > $100,000: 6 sig digs\n * - $100,000 > x > $0.01: 5 sig digs\n * - < $0.01: 4 sig digs\n *\n * Decimal limits by price range:\n * - |v| > 10,000: min 0, max 0 decimals; 5 sig digs (6 if >100k)\n * - |v| > 1,000: min 0, max 1 decimal; 5 sig digs\n * - |v| > 100: min 0, max 2 decimals; 5 sig digs\n * - |v| > 10: min 0, max 4 decimals; 5 sig digs\n * - |v| ≥ 0.01: 5 sig digs, min 2, max 6 decimals\n * - |v| < 0.01: 4 sig digs, min 2, max 6 decimals\n *\n * Examples:\n * - $123,456.78 → $123,457 (>$10k: 0 decimals, 6 sig figs)\n * - $12,345.67 → $12,346 (>$10k: 0 decimals, 5 sig figs)\n * - $1,234.56 → $1,234.6 ($1k-$10k: 1 decimal, 5 sig figs)\n * - $123.456 → $123.46 ($100-$1k: 2 decimals, 5 sig figs)\n * - $12.34567 → $12.346 ($10-$100: 4 decimals, 5 sig figs)\n * - $1.3445555 → $1.3446 (≥$0.01: 5 sig figs)\n * - $0.333333 → $0.33333 (≥$0.01: 5 sig figs)\n * - $0.004236 → $0.004236 (<$0.01: 4 sig figs, max 6 decimals)\n * - $0.0000006 → $0.000001 (<$0.01: 4 sig figs, rounds with max 6 decimals)\n */\nexport const PRICE_RANGES_UNIVERSAL: FiatRangeConfig[] = [\n  {\n    // Very high values (> $100,000): No decimals, 6 significant figures\n    // Ex: $123,456.78 → $123,457\n    condition: (val) => Math.abs(val) > PRICE_THRESHOLD.VERY_HIGH,\n    minimumDecimals: 0,\n    maximumDecimals: 0,\n    significantDigits: 6,\n    threshold: PRICE_THRESHOLD.VERY_HIGH,\n  },\n  {\n    // High values ($10,000-$100,000]: No decimals, 5 significant figures\n    // Ex: $12,345.67 → $12,346\n    condition: (val) => Math.abs(val) > PRICE_THRESHOLD.HIGH,\n    minimumDecimals: 0,\n    maximumDecimals: 0,\n    significantDigits: 5,\n    threshold: PRICE_THRESHOLD.HIGH,\n  },\n  {\n    // Large values ($1,000-$10,000]: Max 1 decimal, 5 significant figures\n    // Ex: $1,234.56 → $1,234.6\n    condition: (val) => Math.abs(val) > PRICE_THRESHOLD.LARGE,\n    minimumDecimals: 0,\n    maximumDecimals: 1,\n    significantDigits: 5,\n    threshold: PRICE_THRESHOLD.LARGE,\n  },\n  {\n    // Medium values ($100-$1,000]: Max 2 decimals, 5 significant figures\n    // Ex: $123.456 → $123.46\n    condition: (val) => Math.abs(val) > PRICE_THRESHOLD.MEDIUM,\n    minimumDecimals: 0,\n    maximumDecimals: 2,\n    significantDigits: 5,\n    threshold: PRICE_THRESHOLD.MEDIUM,\n  },\n  {\n    // Medium-low values ($10-$100]: Max 4 decimals, 5 significant figures\n    // Ex: $12.34567 → $12.346\n    condition: (val) => Math.abs(val) > PRICE_THRESHOLD.MEDIUM_LOW,\n    minimumDecimals: 0,\n    maximumDecimals: 4,\n    significantDigits: 5,\n    threshold: PRICE_THRESHOLD.MEDIUM_LOW,\n  },\n  {\n    // Low values ($0.01-$10]: 5 significant figures, min 2 max MAX_PRICE_DECIMALS decimals\n    // Ex: $1.3445555 → $1.3446 | $0.333333 → $0.33333\n    condition: (val) => Math.abs(val) >= PRICE_THRESHOLD.LOW,\n    significantDigits: 5,\n    minimumDecimals: 2,\n    maximumDecimals: DECIMAL_PRECISION_CONFIG.MaxPriceDecimals,\n    threshold: PRICE_THRESHOLD.LOW,\n  },\n  {\n    // Very small values (< $0.01): 4 significant figures, min 2 max MAX_PRICE_DECIMALS decimals\n    // Ex: $0.004236 → $0.004236 | $0.0000006 → $0.000001\n    condition: () => true,\n    significantDigits: 4,\n    minimumDecimals: 2,\n    maximumDecimals: DECIMAL_PRECISION_CONFIG.MaxPriceDecimals,\n    threshold: PRICE_THRESHOLD.VERY_SMALL,\n  },\n];\n\n/**\n * Formats a balance value as USD currency with appropriate decimal places\n *\n * @param balance - Raw numeric balance value (e.g., 1234.56, not token minimal denomination)\n * @param options - Optional formatting options\n * @param options.minimumDecimals - Global minimum decimal places (overrides range configs)\n * @param options.maximumDecimals - Global maximum decimal places (overrides range configs)\n * @param options.significantDigits - Global significant digits (overrides decimal settings when set)\n * @param options.ranges - Custom range configurations (defaults to PRICE_RANGES_MINIMAL_VIEW)\n * @param options.currency - Currency code (default: 'USD')\n * @param options.locale - Locale for formatting (default: 'en-US')\n * @param options.stripTrailingZeros - Strip trailing zeros from output (default: false via PRICE_RANGES_MINIMAL_VIEW). When true, overrides minimumDecimals constraint.\n * @returns Formatted currency string with variable decimals based on configured ranges\n * @example\n * // Using defaults (preserves trailing zeros for fiat)\n * formatPerpsFiat(1234.56) => \"$1,234.56\"\n * formatPerpsFiat(1250.00) => \"$1,250.00\"  // Trailing zeros preserved\n * formatPerpsFiat(50000) => \"$50,000.00\"   // Trailing zeros preserved\n *\n * // Stripping trailing zeros when needed (e.g., for crypto)\n * formatPerpsFiat(1250, { stripTrailingZeros: true }) => \"$1,250\"\n *\n * // With custom ranges\n * formatPerpsFiat(0.00001, {\n *   ranges: [\n *     { condition: (v) => v < 0.001, minimumDecimals: 6, maximumDecimals: 8 },\n *     { condition: () => true, minimumDecimals: 2, maximumDecimals: 2 }\n *   ]\n * }) => \"$0.00001\"  // Trailing zero stripped\n *\n * // With significant digits\n * formatPerpsFiat(1234.56789, { significantDigits: 5 }) => \"$1,234.6\"\n * formatPerpsFiat(0.0001234, { significantDigits: 3 }) => \"$0.000123\"\n */\nexport const formatPerpsFiat = (\n  balance: string | number,\n  options?: {\n    minimumDecimals?: number;\n    maximumDecimals?: number;\n    significantDigits?: number;\n    ranges?: FiatRangeConfig[];\n    currency?: string;\n    locale?: string;\n    stripTrailingZeros?: boolean;\n  },\n): string => {\n  const value = typeof balance === 'string' ? parseFloat(balance) : balance;\n  const currency = options?.currency ?? 'USD';\n\n  let formatted: string;\n\n  if (isNaN(value)) {\n    // Return placeholder for invalid values to avoid confusion with actual $0 values\n    return PERPS_CONSTANTS.FallbackPriceDisplay;\n  }\n\n  // Use custom ranges or defaults\n  const ranges = options?.ranges ?? PRICE_RANGES_MINIMAL_VIEW;\n\n  // Find the first matching range configuration\n  const rangeConfig = ranges.find((range) => range.condition(value));\n\n  if (rangeConfig) {\n    // Check for significant digits (global or range-specific)\n    const sigDigits =\n      options?.significantDigits ?? rangeConfig.significantDigits;\n\n    // If significant digits are specified, use them\n    if (sigDigits) {\n      // Get min/max decimals (global overrides range, range overrides default)\n      const minDecimals =\n        options?.minimumDecimals ?? rangeConfig.minimumDecimals;\n      const maxDecimals =\n        options?.maximumDecimals ?? rangeConfig.maximumDecimals;\n\n      // Calculate appropriate formatting based on significant digits\n      const { value: formattedValue, decimals } = formatWithSignificantDigits(\n        value,\n        sigDigits,\n        minDecimals,\n        maxDecimals,\n      );\n\n      // Format with the calculated decimal places\n      formatted = _formatWithThreshold(\n        formattedValue,\n        rangeConfig.threshold ?? 0.01,\n        {\n          currency,\n          minimumFractionDigits: decimals,\n          maximumFractionDigits: decimals,\n        },\n      );\n    } else {\n      // Standard decimal-based formatting (existing logic)\n      const minDecimals =\n        options?.minimumDecimals ?? rangeConfig.minimumDecimals;\n      const maxDecimals =\n        options?.maximumDecimals ?? rangeConfig.maximumDecimals;\n\n      // Use custom formatting if provided\n      if (rangeConfig.customFormat) {\n        formatted = rangeConfig.customFormat(\n          value,\n          options?.locale ?? 'en-US',\n          currency,\n        );\n      } else {\n        // Use standard formatting with threshold\n        formatted = _formatWithThreshold(value, rangeConfig.threshold ?? 0.01, {\n          currency,\n          minimumFractionDigits: minDecimals,\n          maximumFractionDigits: maxDecimals,\n        });\n      }\n    }\n  } else {\n    // Fallback if no range matches (shouldn't happen with proper default config)\n    const fallbackMin = options?.minimumDecimals ?? 2;\n    const fallbackMax = options?.maximumDecimals ?? 2;\n    formatted = _formatWithThreshold(value, 0.01, {\n      currency,\n      minimumFractionDigits: fallbackMin,\n      maximumFractionDigits: fallbackMax,\n    });\n  }\n\n  // Post-process: strip trailing zeros unless explicitly disabled\n  // Priority: explicit options.stripTrailingZeros false > rangeConfig > options default > true\n  // If options.stripTrailingZeros is explicitly false, skip stripping entirely\n  if (options?.stripTrailingZeros === false) {\n    return formatted;\n  }\n\n  // Otherwise check range config or default to true\n  const shouldStrip =\n    rangeConfig?.stripTrailingZeros ?? options?.stripTrailingZeros ?? true;\n\n  if (shouldStrip) {\n    // Check if fiat-style stripping is enabled (only strips .00)\n    const useFiatStyle = rangeConfig?.fiatStyleStripping ?? false;\n\n    if (useFiatStyle) {\n      // Fiat-style: Only strip .00 (no meaningful decimals), preserve 2-decimal format\n      // Examples: $1,250.00 → $1,250 | $1,000.10 → $1,000.10 | $13.40 → $13.40\n      return formatted.replace(/\\.00$/u, '');\n    }\n    // Standard: Strip all trailing zeros after decimal point\n    // Examples: $1,250.00 → $1,250 | $100.0 → $100 | $10.5 → $10.5 | $1.234 → $1.234\n    return formatted.replace(/(\\.\\d*?)0+$/u, '$1').replace(/\\.$/u, '');\n  }\n\n  return formatted;\n};\n\n/**\n * Formats position size with variable decimal precision based on magnitude or asset-specific decimals\n * Removes trailing zeros to match task requirements\n *\n * @param size - Raw position size value\n * @param szDecimals - Optional asset-specific decimal precision from Hyperliquid metadata (e.g., BTC=5, ETH=4, DOGE=1)\n * @returns Format varies by size or uses asset-specific decimals, with trailing zeros removed:\n * If szDecimals provided: Uses exact decimals (e.g., 0.00009 BTC with szDecimals=5 => \"0.00009\")\n * Otherwise falls back to magnitude-based logic:\n * - Size < 0.01: Up to 6 decimals (e.g., \"0.00009\" not \"0.000090\")\n * - Size < 1: Up to 4 decimals (e.g., \"0.0024\" not \"0.002400\")\n * - Size >= 1: Up to 2 decimals (e.g., \"44\" not \"44.00\")\n * @example formatPositionSize(0.00009, 5) => \"0.00009\" (uses szDecimals)\n * @example formatPositionSize(44.00, 1) => \"44\" (uses szDecimals, trailing zeros removed)\n * @example formatPositionSize(0.0024) => \"0.0024\" (no szDecimals, uses magnitude logic)\n * @example formatPositionSize(44.00) => \"44\" (no szDecimals, uses magnitude logic)\n */\nexport const formatPositionSize = (\n  size: string | number,\n  szDecimals?: number,\n): string => {\n  const value = typeof size === 'string' ? parseFloat(size) : size;\n\n  if (isNaN(value) || value === 0) {\n    return '0';\n  }\n\n  // Use asset-specific decimals if provided (Hyperliquid metadata)\n  if (szDecimals !== undefined) {\n    return value.toFixed(szDecimals).replace(/\\.?0+$/u, '');\n  }\n\n  // Fallback: magnitude-based decimal logic for backwards compatibility\n  const abs = Math.abs(value);\n  let formatted: string;\n\n  if (abs < 0.01) {\n    // For very small numbers, use more decimal places\n    formatted = value.toFixed(6);\n  } else if (abs < 1) {\n    // For small numbers, use 4 decimal places\n    formatted = value.toFixed(4);\n  } else {\n    // For normal numbers, use 2 decimal places\n    formatted = value.toFixed(2);\n  }\n\n  // Remove trailing zeros and unnecessary decimal point\n  return formatted.replace(/\\.?0+$/u, '');\n};\n\n/**\n * Formats a PnL (Profit and Loss) value with sign prefix\n *\n * @param pnl - Raw numeric PnL value (positive for profit, negative for loss)\n * @returns Format: \"+$X,XXX.XX\" or \"-$X,XXX.XX\" (always shows sign, 2 decimals)\n * @example formatPnl(1234.56) => \"+$1,234.56\"\n * @example formatPnl(-500) => \"-$500.00\"\n * @example formatPnl(0) => \"+$0.00\"\n */\nexport const formatPnl = (pnl: string | number): string => {\n  const value = typeof pnl === 'string' ? parseFloat(pnl) : pnl;\n\n  if (isNaN(value)) {\n    return PERPS_CONSTANTS.ZeroAmountDetailedDisplay;\n  }\n\n  const formatted = _formatCurrency(Math.abs(value), 'USD', {\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  });\n\n  return value >= 0 ? `+${formatted}` : `-${formatted}`;\n};\n\n/**\n * Formats a percentage value with sign prefix\n *\n * @param value - Raw percentage value (e.g., 5.25 for 5.25%, not 0.0525)\n * @param decimals - Number of decimal places to show (default: 2)\n * @returns Format: \"+X.XX%\" or \"-X.XX%\" (always shows sign, 2 decimals)\n * @example formatPercentage(5.25) => \"+5.25%\"\n * @example formatPercentage(-2.75) => \"-2.75%\"\n * @example formatPercentage(0) => \"+0.00%\"\n */\nexport const formatPercentage = (\n  value: string | number,\n  decimals: number = 2,\n): string => {\n  const parsed = typeof value === 'string' ? parseFloat(value) : value;\n\n  if (isNaN(parsed)) {\n    return '0.00%';\n  }\n\n  return `${parsed >= 0 ? '+' : ''}${parsed.toFixed(decimals)}%`;\n};\n\n/**\n * Formats funding rate for display\n *\n * @param value - Raw funding rate value (decimal, not percentage)\n * @param options - Optional formatting options\n * @param options.showZero - Whether to return zero display value for zero/undefined (default: true)\n * @returns Formatted funding rate as percentage string\n * @example formatFundingRate(0.0005) => \"0.0500%\"\n * @example formatFundingRate(-0.0001) => \"-0.0100%\"\n * @example formatFundingRate(undefined) => \"0.0000%\"\n */\nexport const formatFundingRate = (\n  value?: number | null,\n  options?: { showZero?: boolean },\n): string => {\n  const showZero = options?.showZero ?? true;\n\n  if (value === undefined || value === null) {\n    return showZero ? FUNDING_RATE_CONFIG.ZeroDisplay : '';\n  }\n\n  const percentage = value * FUNDING_RATE_CONFIG.PercentageMultiplier;\n  const formatted = percentage.toFixed(FUNDING_RATE_CONFIG.Decimals);\n\n  // Check if the result is effectively zero\n  if (showZero && parseFloat(formatted) === 0) {\n    return FUNDING_RATE_CONFIG.ZeroDisplay;\n  }\n\n  return `${formatted}%`;\n};\n"]}