@brcarddev/frontend-commons 1.0.2

package/src/utils/index.ts

@@ -0,0 +1,14 @@
+export * from '@/utils/api';
+export * from '@/utils/array';
+export * from '@/utils/clipboard';
+export * from '@/utils/cn';
+export * from '@/utils/color-utils';
+export * from '@/utils/countries';
+export * from '@/utils/currency';
+export * from '@/utils/date';
+export * from '@/utils/file';
+export * from '@/utils/get-initials';
+export * from '@/utils/masks';
+export * from '@/utils/render-highlighted-text';
+export * from '@/utils/string';
+export * from '@/utils/video';

package/src/utils/masks/index.ts

@@ -0,0 +1 @@
+export * from './masks';

package/src/utils/masks/masks.ts

@@ -0,0 +1,180 @@
+export type MaskType = keyof typeof MASKS;
+
+export type RegexType = keyof typeof REGEX_PATTERNS;
+
+export const MASK_HELPERS = {
+  removeMask: (value: string): string => {
+    return value.replace(/\D/g, '');
+  },
+
+  applyMask: (value: string, mask: string): string => {
+    const cleanValue = value.replace(/\D/g, '');
+    let maskedValue = '';
+    let valueIndex = 0;
+
+    for (let i = 0; i < mask.length && valueIndex < cleanValue.length; i++) {
+      if (mask[i] === '_') {
+        maskedValue += cleanValue[valueIndex];
+        valueIndex++;
+      } else {
+        maskedValue += mask[i];
+      }
+    }
+
+    return maskedValue;
+  },
+
+  isValidCPF: (cpf: string): boolean => {
+    const numbers = cpf.replace(/\D/g, '');
+
+    if (numbers.length !== 11 || /^(\d)\1{10}$/.test(numbers)) {
+      return false;
+    }
+
+    let sum = 0;
+
+    for (let i = 0; i < 9; i++) {
+      sum += parseInt(numbers[i]) * (10 - i);
+    }
+
+    let remainder = (sum * 10) % 11;
+
+    if (remainder === 10 || remainder === 11) remainder = 0;
+
+    if (remainder !== parseInt(numbers[9])) return false;
+
+    sum = 0;
+
+    for (let i = 0; i < 10; i++) {
+      sum += parseInt(numbers[i]) * (11 - i);
+    }
+
+    remainder = (sum * 10) % 11;
+
+    if (remainder === 10 || remainder === 11) remainder = 0;
+
+    return remainder === parseInt(numbers[10]);
+  },
+
+  isValidCNPJ: (cnpj: string): boolean => {
+    const numbers = cnpj.replace(/\D/g, '');
+
+    if (numbers.length !== 14 || /^(\d)\1{13}$/.test(numbers)) {
+      return false;
+    }
+
+    const weights1 = [ 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2 ];
+    const weights2 = [ 6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2 ];
+
+    let sum = 0;
+
+    for (let i = 0; i < 12; i++) {
+      sum += parseInt(numbers[i]) * weights1[i];
+    }
+
+    let remainder = sum % 11;
+    const digit1 = remainder < 2 ? 0 : 11 - remainder;
+
+    if (digit1 !== parseInt(numbers[12])) return false;
+
+    sum = 0;
+
+    for (let i = 0; i < 13; i++) {
+      sum += parseInt(numbers[i]) * weights2[i];
+    }
+
+    remainder = sum % 11;
+    const digit2 = remainder < 2 ? 0 : 11 - remainder;
+
+    return digit2 === parseInt(numbers[13]);
+  },
+
+  isValidEmail: (email: string): boolean => {
+    return REGEX_PATTERNS.EMAIL.test(email);
+  },
+
+  formatCurrency: (value: number, locale = 'pt-BR', currency = 'BRL'): string => {
+    return new Intl.NumberFormat(locale, {
+      style: 'currency',
+      currency,
+    }).format(value);
+  },
+
+  formatPhone: (phone: string): string => {
+    const numbers = phone.replace(/\D/g, '');
+
+    if (numbers.length === 11) {
+      return MASK_HELPERS.applyMask(numbers, MASKS.PHONE_MOBILE);
+    } else if (numbers.length === 10) {
+      return MASK_HELPERS.applyMask(numbers, MASKS.PHONE_BR_FIXED);
+    }
+
+    return phone;
+  },
+
+  formatCEP: (cep: string): string => {
+    const numbers = cep.replace(/\D/g, '');
+    return MASK_HELPERS.applyMask(numbers, MASKS.CEP);
+  },
+
+  formatCPF: (cpf: string): string => {
+    const numbers = cpf.replace(/\D/g, '');
+    return MASK_HELPERS.applyMask(numbers, MASKS.CPF);
+  },
+
+  formatCNPJ: (cnpj: string): string => {
+    const numbers = cnpj.replace(/\D/g, '');
+    return MASK_HELPERS.applyMask(numbers, MASKS.CNPJ);
+  },
+};
+
+export const MASKS = {
+  CPF: '___.___.___-__',
+  CNPJ: '__.___.___/____-__',
+  RG: '__.___.___-_',
+  PIS: '___._____.__-_',
+  TITULO_ELEITOR: '____.___.____',
+  CNH: '___________',
+
+  PHONE_BR: '(__) _____-____',
+  PHONE_BR_FIXED: '(__) ____-____',
+  PHONE_MOBILE: '(__) _ ____-____',
+  WHATSAPP: '(__) _ ____-____',
+
+  CEP: '_____-___',
+
+  CREDIT_CARD: '____ ____ ____ ____',
+  CREDIT_CARD_EXPIRY: '__/__',
+  CREDIT_CARD_CVV: '___',
+  BANK_ACCOUNT: '______-_',
+  BANK_AGENCY: '____-_',
+  PIX_PHONE: '(__) _ ____-____',
+
+  DATE_BR: '__/__/____',
+  DATE_US: '__/__/____',
+  TIME: '__:__',
+  TIME_FULL: '__:__:__',
+  DATETIME_BR: '__/__/____ __:__',
+
+  CURRENCY_BR: 'R$ ___.___.___,__',
+  PERCENTAGE: '___%',
+  WEIGHT: '___,__ kg',
+  HEIGHT: '_,__ m',
+  DISTANCE_KM: '___,__ km',
+
+  ISBN: '___-__-_____-__-_',
+  PASSPORT_BR: '__ ______',
+  VEHICLE_PLATE_OLD: '___-____',
+  VEHICLE_PLATE_MERCOSUL: '_______',
+};
+
+export const REGEX_PATTERNS = {
+  CPF: /^\d{3}\.\d{3}\.\d{3}-\d{2}$/,
+  CNPJ: /^\d{2}\.\d{3}\.\d{3}\/\d{4}-\d{2}$/,
+  PHONE_BR: /^\(\d{2}\) \d{4,5}-\d{4}$/,
+  CEP: /^\d{5}-\d{3}$/,
+  EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+  CREDIT_CARD: /^\d{4} \d{4} \d{4} \d{4}$/,
+  DATE_BR: /^\d{2}\/\d{2}\/\d{4}$/,
+  TIME: /^\d{2}:\d{2}$/,
+};

package/src/utils/render-highlighted-text/index.ts

@@ -0,0 +1 @@
+export * from './render-highlighted-text';

package/src/utils/render-highlighted-text/render-highlighted-text.tsx

@@ -0,0 +1,25 @@
+const escapeRegExpForLiteralMatch = (text: string): string => {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+};
+
+export const renderHighlightedText = (label: string, queryText: string): React.ReactNode => {
+  const normalizedQuery = (queryText || '').trim();
+
+  if (!normalizedQuery) return label;
+
+  try {
+    const pattern = new RegExp(`(${escapeRegExpForLiteralMatch(normalizedQuery)})`, 'ig');
+    const segments = label.split(pattern);
+
+    return segments.map((segment, index) => {
+      if (!segment) return null;
+
+      const isMatchSegment = index % 2 === 1;
+      return isMatchSegment
+        ? <span key={index} className="text-primary">{segment}</span>
+        : <span key={index}>{segment}</span>;
+    });
+  } catch {
+    return label;
+  }
+};

package/src/utils/string/index.ts

@@ -0,0 +1 @@
+export * from './string';

package/src/utils/string/string.test.ts

@@ -0,0 +1,171 @@
+import { describe, it, expect } from 'vitest';
+
+import {
+  normalizeCurrency,
+  toCapitalize,
+  keepOnlyNumber,
+  convertTextToNumbers,
+  isValidCPF,
+  isValidPhone,
+  isValidCNPJ,
+  isValidDocument,
+  isValidName,
+  isValidEmail,
+  stringToNumber,
+  removeInitialSlash,
+} from './string';
+
+describe('String Utils', () => {
+  describe('normalizeCurrency', () => {
+    it('should normalize currency string with spaces and special characters', () => {
+      expect(normalizeCurrency('R$ 1.234,56')).toBe('R$ 1.234,56');
+      expect(normalizeCurrency('R$\u00A01.234,56')).toBe('R$ 1.234,56');
+      expect(normalizeCurrency('  R$ 1.234,56  ')).toBe('R$ 1.234,56');
+    });
+  });
+
+  describe('toCapitalize', () => {
+    it('should capitalize first letter of each word', () => {
+      expect(toCapitalize('john doe')).toBe('John Doe');
+      expect(toCapitalize('JOHN DOE')).toBe('John Doe');
+      expect(toCapitalize('john DOE')).toBe('John Doe');
+    });
+
+    it('should handle single word', () => {
+      expect(toCapitalize('john')).toBe('John');
+    });
+
+    it('should handle empty string', () => {
+      expect(toCapitalize('')).toBe('');
+    });
+  });
+
+  describe('keepOnlyNumber', () => {
+    it('should remove all non-numeric characters', () => {
+      expect(keepOnlyNumber('123-456.789')).toBe('123456789');
+      expect(keepOnlyNumber('abc123def456')).toBe('123456');
+      expect(keepOnlyNumber('(11) 98765-4321')).toBe('11987654321');
+    });
+
+    it('should return empty string for non-numeric input', () => {
+      expect(keepOnlyNumber('abc')).toBe('');
+    });
+  });
+
+  describe('convertTextToNumbers', () => {
+    it('should convert string to array of numbers', () => {
+      expect(convertTextToNumbers('123')).toEqual([ 1, 2, 3 ]);
+      expect(convertTextToNumbers('0')).toEqual([ 0 ]);
+    });
+
+    it('should handle empty string', () => {
+      expect(convertTextToNumbers('')).toEqual([]);
+    });
+  });
+
+  describe('isValidCPF', () => {
+    it('should validate correct CPF', () => {
+      expect(isValidCPF('529.982.247-25')).toBe(true);
+      expect(isValidCPF('52998224725')).toBe(true);
+    });
+
+    it('should reject invalid CPF', () => {
+      expect(isValidCPF('123.456.789-00')).toBe(false);
+      expect(isValidCPF('111.111.111-11')).toBe(false);
+      expect(isValidCPF('123')).toBe(false);
+    });
+  });
+
+  describe('isValidPhone', () => {
+    it('should validate correct phone numbers', () => {
+      expect(isValidPhone('(11) 98765-4321')).toBe(true);
+      expect(isValidPhone('11987654321')).toBe(true);
+      expect(isValidPhone('(11) 3765-4321')).toBe(true);
+    });
+
+    it('should reject invalid phone numbers', () => {
+      expect(isValidPhone('123')).toBe(false);
+      expect(isValidPhone('(00) 98765-4321')).toBe(false);
+      expect(isValidPhone('(11) 12345-6789')).toBe(false);
+    });
+  });
+
+  describe('isValidCNPJ', () => {
+    it('should validate correct CNPJ', () => {
+      expect(isValidCNPJ('12.345.678/0001-95')).toBe(true);
+      expect(isValidCNPJ('12345678000195')).toBe(true);
+    });
+
+    it('should reject invalid CNPJ', () => {
+      expect(isValidCNPJ('11.111.111/1111-11')).toBe(false);
+      expect(isValidCNPJ('123')).toBe(false);
+      expect(isValidCNPJ('00000000000000')).toBe(false);
+    });
+  });
+
+  describe('isValidDocument', () => {
+    it('should validate correct CPF and CNPJ', () => {
+      expect(isValidDocument('529.982.247-25')).toBe(true);
+      expect(isValidDocument('12.345.678/0001-95')).toBe(true);
+    });
+
+    it('should reject invalid documents', () => {
+      expect(isValidDocument('123.456.789-00')).toBe(false);
+      expect(isValidDocument('11.111.111/1111-11')).toBe(false);
+      expect(isValidDocument('123')).toBe(false);
+    });
+  });
+
+  describe('isValidName', () => {
+    it('should validate correct names', () => {
+      expect(isValidName('John Doe')).toBe(true);
+      expect(isValidName('João Silva')).toBe(true);
+      expect(isValidName('Maria José')).toBe(true);
+    });
+
+    it('should reject invalid names', () => {
+      expect(isValidName('John123')).toBe(false);
+      expect(isValidName('John@Doe')).toBe(false);
+      expect(isValidName('')).toBe(false);
+    });
+  });
+
+  describe('isValidEmail', () => {
+    it('should validate correct emails', () => {
+      expect(isValidEmail('john.doe@example.com')).toBe(true);
+      expect(isValidEmail('john+doe@example.com')).toBe(true);
+      expect(isValidEmail('john_doe@example.co.uk')).toBe(true);
+    });
+
+    it('should reject invalid emails', () => {
+      expect(isValidEmail('john@')).toBe(false);
+      expect(isValidEmail('@example.com')).toBe(false);
+      expect(isValidEmail('john@example')).toBe(false);
+      expect(isValidEmail('')).toBe(false);
+    });
+  });
+
+  describe('stringToNumber', () => {
+    it('should convert string with comma to number format', () => {
+      expect(stringToNumber('1234,56')).toBe('1,234.56');
+      expect(stringToNumber('0,00')).toBe('0.00');
+    });
+
+    it('should handle invalid input', () => {
+      expect(stringToNumber('abc')).toBe('abc');
+      expect(stringToNumber('')).toBe('');
+    });
+  });
+
+  describe('removeInitialSlash', () => {
+    it('should remove initial slash from string', () => {
+      expect(removeInitialSlash('/path')).toBe('path');
+      expect(removeInitialSlash('/path/to/file')).toBe('path/to/file');
+    });
+
+    it('should not modify string without initial slash', () => {
+      expect(removeInitialSlash('path')).toBe('path');
+      expect(removeInitialSlash('')).toBe('');
+    });
+  });
+});

package/src/utils/string/string.ts

@@ -0,0 +1,155 @@
+export const capitalizeFirst = (value: string) => {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+};
+
+export function convertTextToNumbers (text: string): number[] {
+  return text.split('').map((char) => +char);
+}
+
+export const isValidCNPJ = (cnpj: string) => {
+  cnpj = cnpj.replace(/\D/g, '');
+
+  if (cnpjCheckInvalid(cnpj)) {
+    const numberValue = cnpj.toString().slice(0, -2);
+    const [ dv1, dv2 ] = cnpj.toString().slice(-2);
+
+    if (checkCNPJDV(numberValue, dv1) && checkCNPJDV(numberValue + dv1, dv2)) {
+      return true;
+    } else {
+      return false;
+    }
+  } else {
+    return false;
+  }
+};
+
+export function isValidCPF (text: string): boolean {
+  const document = text.replace(/[^\d]+/g, '');
+
+  if (document.length !== 11 || !!document.match(/(\d)\1{10}/)) return false;
+
+  const digits = convertTextToNumbers(document);
+
+  const rest = (count: number): number => {
+    const restSum = digits.slice(0, count - 12).reduce((total, el, i) => total + el * (count - i), 0);
+
+    return ((restSum * 10) % 11) % 10;
+  };
+
+  return rest(10) === digits[9] && rest(11) === digits[10];
+}
+
+export function isValidDocument (text: string): boolean {
+  return isValidCPF(text) || isValidCNPJ(text);
+}
+
+export function isValidEmail (email: string): boolean {
+  const emailRegex =
+    /^([a-zA-Z0-9+._-]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z-0-9]+\.)+[a-zA-Z]{2,}))$/;
+
+  return emailRegex.test(email);
+}
+
+const checkCNPJDV = (numberParam: string, dv: string) => {
+  const check = numberParam
+    .split('')
+    .reverse()
+    .map((item, i) => ((i % 8) + 2) * parseInt(item, 10))
+    .reduce((x, y) => x + y);
+
+  let result = check % 11;
+
+  if (result < 2) {
+    result = 0;
+  } else {
+    result = 11 - result;
+  }
+
+  return result.toString() === dv;
+};
+
+const cnpjCheckInvalid = (numberParam: string) => {
+  const cnpj = numberParam.toString();
+
+  if (
+    cnpj === '00000000000000' ||
+    cnpj === '11111111111111' ||
+    cnpj === '22222222222222' ||
+    cnpj === '33333333333333' ||
+    cnpj === '44444444444444' ||
+    cnpj === '55555555555555' ||
+    cnpj === '66666666666666' ||
+    cnpj === '77777777777777' ||
+    cnpj === '88888888888888' ||
+    cnpj === '99999999999999' ||
+    cnpj.length !== 14
+  ) {
+    return false;
+  } else {
+    return true;
+  }
+};
+
+export function isValidName (name: string): boolean {
+  const nameRegex: RegExp = /^[a-zA-ZÀ-ú\s]+$/;
+
+  return nameRegex.test(name);
+}
+
+export function isValidPhone (phone: string): boolean {
+  phone = phone.replace(/\D/g, '');
+
+  if (!(phone.length >= 10 && phone.length <= 11)) return false;
+
+  if (phone.length == 11 && parseInt(phone.substring(2, 3)) != 9) return false;
+
+  for (let n = 0; n < 10; n++) {
+    if (phone == new Array(11).join(n.toString()) || phone == new Array(12).join(n.toString())) return false;
+  }
+
+  const dddCodes = [
+    11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 24, 27, 28, 31, 32, 33, 34, 35, 37, 38, 41, 42, 43, 44, 45, 46, 47, 48,
+    49, 51, 53, 54, 55, 61, 62, 64, 63, 65, 66, 67, 68, 69, 71, 73, 74, 75, 77, 79, 81, 82, 83, 84, 85, 86, 87, 88, 89,
+    91, 92, 93, 94, 95, 96, 97, 98, 99,
+  ];
+
+  if (dddCodes.indexOf(parseInt(phone.substring(0, 2))) == -1) return false;
+
+  if (new Date().getFullYear() < 2017) return true;
+
+  if (phone.length == 10 && [ 2, 3, 4, 5, 7 ].indexOf(parseInt(phone.substring(2, 3))) == -1) return false;
+
+  return true;
+}
+
+export function keepOnlyNumber (text: string): string {
+  return text.replace(/\D/g, '');
+}
+
+export function normalizeCurrency(str: string) {
+  return str.replace(/\s/g, ' ').replace(/\u00A0/g, ' ').normalize('NFKC').trim();
+}
+
+export function removeInitialSlash (text: string): string {
+  return text.replace(/^\//, '');
+}
+
+export function stringToNumber (value: string): string {
+  const numericValue = parseFloat(value.replace(',', '.'));
+
+  if (!isNaN(numericValue)) {
+    value = numericValue.toLocaleString('en-US', {
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2,
+    });
+  }
+
+  return value;
+}
+
+export function toCapitalize (text: string): string {
+  return text
+    .split(' ')
+    .map((word) => word.charAt(0).toUpperCase().concat(word.substring(1).toLowerCase()))
+    .join(' ');
+}

package/src/utils/video/index.ts

@@ -0,0 +1 @@
+export * from './video';

package/src/utils/video/video.ts

@@ -0,0 +1,9 @@
+export const getYouTubeEmbedUrl = (url: string): string => {
+  try {
+    const urlObj = new URL(url);
+    const videoId = urlObj.searchParams.get('v');
+    return videoId ? `https://www.youtube.com/embed/${videoId}` : url;
+  } catch {
+    return url;
+  }
+};

package/src/vite-env.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="vite/client" />
+declare module '*.svg';
+declare module '*.png';