utils.js

// Utils Module - Pure utility functions for formatting and common operations
// No dependencies on state - these are pure functions

const UtilsModule = (function() {
  'use strict';

  // ==================== CURRENCY FORMATTING ====================

  /**
   * Format currency based on display settings
   * @param {number} value - The value to format
   * @param {boolean} includeSign - Whether to include +/- sign
   * @param {Object} displaySettings - Settings object with useCommas and useAbbreviated
   * @returns {string} Formatted currency string
   */
  function formatCurrency(value, includeSign = false, displaySettings = null) {
    // Get settings from StateModule if not provided
    const settings = displaySettings || (typeof StateModule !== 'undefined' ? StateModule.getDisplaySettings() : { useCommas: true, useAbbreviated: false });

    const absValue = Math.abs(value);
    const sign = includeSign ? (value >= 0 ? '+' : '-') : (value < 0 ? '-' : '');
    const displayValue = absValue;

    let formatted;
    if (settings.useAbbreviated) {
      if (displayValue >= 1000000) {
        formatted = `${(displayValue / 1000000).toFixed(2)}M`;
      } else if (displayValue >= 1000) {
        formatted = `${(displayValue / 1000).toFixed(2)}K`;
      } else {
        formatted = displayValue.toFixed(2);
      }
    } else if (settings.useCommas) {
      formatted = displayValue.toLocaleString('en-US', { minimumFractionDigits: 2, maximumFractionDigits: 2 });
    } else {
      formatted = displayValue.toFixed(2);
    }

    return `${sign}$${formatted}`;
  }

  /**
   * Format currency for chart display (simple format, always with commas)
   * @param {number} value - The value to format
   * @returns {string} Formatted currency string
   */
  function formatCurrencySimple(value) {
    return value.toLocaleString('en-US', {
      style: 'currency',
      currency: 'USD',
      minimumFractionDigits: 2,
      maximumFractionDigits: 2
    });
  }

  /**
   * Format a percentage value with sign
   * @param {number} value - The percentage value
   * @param {number} decimals - Number of decimal places
   * @returns {string} Formatted percentage string
   */
  function formatPercent(value, decimals = 2) {
    if (value === null || value === undefined || isNaN(value)) return '--';
    const sign = value >= 0 ? '+' : '';
    return `${sign}${value.toFixed(decimals)}%`;
  }

  // ==================== DATE UTILITIES ====================

  /**
   * Get date from 7 days ago in YYYY-MM-DD format for X search
   * @returns {string} Date string in YYYY-MM-DD format
   */
  function getXSearchSinceDate() {
    const now = new Date();
    const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
    const year = weekAgo.getFullYear();
    const month = String(weekAgo.getMonth() + 1).padStart(2, '0');
    const day = String(weekAgo.getDate()).padStart(2, '0');
    return `${year}-${month}-${day}`;
  }

  /**
   * Get human-readable date label (Today, Tomorrow, or formatted date)
   * @param {number|string} timestamp - Date timestamp or string
   * @returns {string} Human-readable date label
   */
  function getDateLabel(timestamp) {
    const date = new Date(timestamp);
    const now = new Date();
    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
    const eventDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
    const diffDays = Math.round((eventDate - today) / (24 * 60 * 60 * 1000));

    if (diffDays === 0) return 'Today';
    if (diffDays === 1) return 'Tomorrow';
    if (diffDays < 7) return date.toLocaleDateString('en-US', { weekday: 'long' });

    return date.toLocaleDateString('en-US', {
      weekday: 'short',
      month: 'short',
      day: 'numeric'
    });
  }

  /**
   * Get days until a given date
   * @param {number|string} timestamp - Date timestamp or string
   * @returns {number} Number of days until the date
   */
  function getDaysUntil(timestamp) {
    const now = new Date();
    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
    const eventDate = new Date(timestamp);
    const eventDay = new Date(eventDate.getFullYear(), eventDate.getMonth(), eventDate.getDate());
    return Math.round((eventDay - today) / (24 * 60 * 60 * 1000));
  }

  /**
   * Format a timestamp for last updated display
   * @param {number} timestamp - Timestamp in milliseconds
   * @returns {string} Formatted time string
   */
  function formatLastUpdated(timestamp) {
    const date = new Date(timestamp);
    return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
  }

  // ==================== NAME CLEANING ====================

  /**
   * Clean asset name for X search - removes pair suffixes for crypto and corporate suffixes for stocks
   * @param {string} name - The asset name
   * @param {string} ticker - The ticker symbol
   * @returns {string} Cleaned name for search
   */
  function cleanNameForXSearch(name, ticker) {
    let cleanedName = name;

    // Check if it's a crypto ticker (ends with -USD)
    if (ticker && ticker.endsWith('-USD')) {
      // Remove "USD" suffix from name (e.g., "Solana USD" -> "Solana")
      cleanedName = cleanedName.replace(/\s+USD$/i, '');
    } else {
      // For stocks, remove common corporate suffixes
      cleanedName = cleanedName
        .replace(/,?\s*(Inc\.?|Incorporated|Corp\.?|Corporation|Ltd\.?|Limited|LLC|PLC|Co\.?|Company|Holdings?|Group|Technologies|International|Enterprises?|Solutions?|Services?|Systems?)(\s|$)+/gi, ' ')
        .trim();
    }

    return cleanedName.trim();
  }

  // ==================== CASH UTILITIES ====================

  /**
   * Check if query matches cash keywords
   * @param {string} query - The search query
   * @returns {boolean} True if query is a cash keyword
   */
  function isCashQuery(query) {
    const CASH_KEYWORDS = (typeof ConfigModule !== 'undefined')
      ? ConfigModule.CASH_KEYWORDS
      : ['cash', 'usd', 'dollars', 'dollar', '$'];

    const lowerQuery = query.toLowerCase().trim();
    return CASH_KEYWORDS.some(keyword => keyword === lowerQuery || lowerQuery.startsWith(keyword));
  }

  /**
   * Get cash search result object
   * @returns {Object} Cash search result
   */
  function getCashSearchResult() {
    const CASH_TICKER = (typeof ConfigModule !== 'undefined') ? ConfigModule.CASH_TICKER : 'CASH';
    return {
      symbol: CASH_TICKER,
      name: 'US Dollars (Cash)',
      type: 'CASH',
      exchange: '',
      isCash: true
    };
  }

  // ==================== EVENT UTILITIES ====================

  /**
   * Get event icon name based on event type (returns Lucide icon name)
   * @param {string} type - Event type
   * @returns {string} Lucide icon name
   */
  function getEventIcon(type) {
    switch (type) {
      case 'earnings': return 'calendar';
      case 'dividend': return 'coins';
      case 'ex-dividend': return 'alert-triangle';
      case 'split': return 'scissors';
      case 'economic_release': return 'bar-chart-3';
      case 'fomc_decision': return 'landmark';
      case 'fomc_minutes': return 'file-text';
      default: return 'bell';
    }
  }

  // ==================== ERROR DISPLAY ====================

  /**
   * Show error message to user
   * @param {string} message - Error message to display
   */
  function showError(message) {
    const existingError = document.querySelector('.error-message');
    if (existingError) {
      existingError.remove();
    }

    const errorDiv = document.createElement('div');
    errorDiv.className = 'error-message';
    errorDiv.textContent = message;

    const addStockDiv = document.querySelector('.add-stock');
    if (addStockDiv && addStockDiv.parentNode) {
      addStockDiv.parentNode.insertBefore(errorDiv, addStockDiv.nextSibling);
    }

    setTimeout(() => {
      errorDiv.remove();
    }, 3000);
  }

  // ==================== PUBLIC API ====================

  return {
    // Currency formatting
    formatCurrency,
    formatCurrencySimple,
    formatPercent,

    // Date utilities
    getXSearchSinceDate,
    getDateLabel,
    getDaysUntil,
    formatLastUpdated,

    // Name cleaning
    cleanNameForXSearch,

    // Cash utilities
    isCashQuery,
    getCashSearchResult,

    // Event utilities
    getEventIcon,

    // Error display
    showError
  };
})();