Helper Functions

import { formatCurrency } from '@/utils/formatters';

formatCurrency(1234.56); // "$1,234.56"
formatCurrency(1234.56, { currency: 'EUR', locale: 'de-DE' }); // "1.234,56 €"
formatCurrency(1234.5, { decimals: 0 }); // "$1,235"

import { formatDate } from '@/utils/formatters';

const date = new Date('2024-03-15T14:30:00Z');

formatDate(date); // "Mar 15, 2024"
formatDate(date, 'long'); // "March 15, 2024"
formatDate(date, 'short', { includeTime: true }); // "3/15/24, 2:30 PM"
formatDate(date, 'YYYY-MM-DD'); // "2024-03-15"
formatDate(date, 'medium', { locale: 'fr-FR' }); // "15 mars 2024"

import { formatFileSize } from '@/utils/formatters';

formatFileSize(1024); // "1.00 KB"
formatFileSize(1536, 0); // "2 KB"
formatFileSize(1048576); // "1.00 MB"
formatFileSize(1234567890); // "1.15 GB"

import { formatPhoneNumber } from '@/utils/formatters';

formatPhoneNumber('5551234567'); // "(555) 123-4567"
formatPhoneNumber('5551234567', 'US'); // "(555) 123-4567"
formatPhoneNumber('2079460123', 'GB'); // "020 7946 0123"

import { validateEmail } from '@/utils/validators';

validateEmail('user@example.com'); // true
validateEmail('invalid.email'); // false
validateEmail('user@domain'); // false

import { validatePassword } from '@/utils/validators';

validatePassword('Pass123!');
// { isValid: true, errors: [], strength: 'strong' }

validatePassword('weak');
// { 
//   isValid: false, 
//   errors: ['Must be at least 8 characters', 'Must contain a number'],
//   strength: 'weak'
// }

validatePassword('simple123', { requireSpecialChars: false });
// { isValid: true, errors: [], strength: 'medium' }

import { validateURL } from '@/utils/validators';

validateURL('https://example.com'); // true
validateURL('not-a-url'); // false
validateURL('ftp://files.com', { allowedProtocols: ['ftp'] }); // true

import { debounce } from '@/utils/helpers';

const handleSearch = debounce((query: string) => {
  console.log('Searching for:', query);
}, 500);

// Only executes once after 500ms of no calls
handleSearch('a');
handleSearch('ab');
handleSearch('abc'); // Only this will execute

// Cancel pending execution
handleSearch.cancel();

import { throttle } from '@/utils/helpers';

const handleScroll = throttle(() => {
  console.log('Scroll position:', window.scrollY);
}, 200);

window.addEventListener('scroll', handleScroll);

import { deepClone } from '@/utils/helpers';

const original = { name: 'John', address: { city: 'NYC' } };
const cloned = deepClone(original);

cloned.address.city = 'LA';
console.log(original.address.city); // "NYC" (unchanged)

import { groupBy } from '@/utils/helpers';

const users = [
  { name: 'Alice', role: 'admin' },
  { name: 'Bob', role: 'user' },
  { name: 'Charlie', role: 'admin' }
];

const byRole = groupBy(users, 'role');
// {
//   admin: [{ name: 'Alice', role: 'admin' }, { name: 'Charlie', role: 'admin' }],
//   user: [{ name: 'Bob', role: 'user' }]
// }

const byFirstLetter = groupBy(users, user => user.name[0]);
// {
//   A: [{ name: 'Alice', role: 'admin' }],
//   B: [{ name: 'Bob', role: 'user' }],
//   C: [{ name: 'Charlie', role: 'admin' }]
// }

import { sortBy } from '@/utils/helpers';

const products = [
  { name: 'Phone', price: 699 },
  { name: 'Laptop', price: 1299 },
  { name: 'Tablet', price: 499 }
];

const byPrice = sortBy(products, 'price');
// [{ name: 'Tablet', price: 499 }, { name: 'Phone', price: 699 }, ...]

const byPriceDesc = sortBy(products, 'price', 'desc');
// [{ name: 'Laptop', price: 1299 }, { name: 'Phone', price: 699 }, ...]

const byName = sortBy(products, p => p.name.toLowerCase());

import { truncate } from '@/utils/helpers';

truncate('Hello World', 8); // "Hello..."
truncate('Hello', 10); // "Hello"
truncate('Hello World', 8, '…'); // "Hello W…"

import { capitalize } from '@/utils/helpers';

capitalize('hello world'); // "Hello world"
capitalize('HELLO'); // "Hello"

import { slugify } from '@/utils/helpers';

slugify('Hello World!'); // "hello-world"
slugify('React & TypeScript'); // "react-typescript"
slugify('  Multiple   Spaces  '); // "multiple-spaces"