eai-frontend-components 2.0.63 → 2.0.65

package/dist/lib/help/date-utils.d.ts

@@ -0,0 +1,9 @@
+export declare const getFirstDayOfCurrentMonth: () => Date;
+export declare const getFirstDayOf90DaysAgo: () => Date;
+export declare const stringToDate: (dateString: string, separator?: string) => Date | undefined;
+export declare const aYearAgo: () => Date;
+export declare const invertDate: (date: string, separator?: string) => string;
+export declare const addDaysToToday: (days: number) => Date;
+export declare const isValidDate: (date: Date | undefined) => date is Date;
+export declare const isDateRangeValid: (startDate: Date, endDate: Date, maxDays?: number) => boolean;
+//# sourceMappingURL=date-utils.d.ts.map

package/dist/lib/help/date-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/help/date-utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,QAAO,IAG5C,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,IAGzC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,YAAW,MAAY,KAAG,IAAI,GAAG,SAwCjF,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,IAK3B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,YAAW,MAAY,KAAG,MAIlE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,IAI7C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,GAAG,SAAS,KAAG,IAAI,IAAI,IAE5D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,WAAW,IAAI,EAAE,SAAS,IAAI,EAAE,UAAS,MAAW,KAAG,OAIvF,CAAC"}

package/dist/lib/help/date-utils.js

@@ -0,0 +1,65 @@
+export const getFirstDayOfCurrentMonth = () => {
+    const now = new Date();
+    return new Date(now.getFullYear(), now.getMonth(), 1);
+};
+export const getFirstDayOf90DaysAgo = () => {
+    const now = new Date();
+    return new Date(now.getFullYear(), now.getMonth() - 3, 1);
+};
+export const stringToDate = (dateString, separator = '/') => {
+    if (!dateString)
+        return undefined;
+    const dateParts = dateString.split(separator);
+    if (dateParts.length !== 3)
+        return undefined;
+    const day = parseInt(dateParts[0], 10);
+    const month = parseInt(dateParts[1], 10);
+    const year = parseInt(dateParts[2], 10);
+    // Validar se os valores são números válidos
+    if (Number.isNaN(day) || Number.isNaN(month) || Number.isNaN(year)) {
+        return undefined;
+    }
+    // Validar mês (1-12)
+    if (month < 1 || month > 12) {
+        return undefined;
+    }
+    // Validar ano
+    if (year < 1900 || year > 2100) {
+        return undefined;
+    }
+    // Validar dia dentro do mês
+    const daysInMonth = new Date(year, month, 0).getDate();
+    if (day < 1 || day > daysInMonth) {
+        return undefined;
+    }
+    // JavaScript usa meses zero-based (0-11)
+    const date = new Date(year, month - 1, day);
+    // Verificação adicional: garantir que a data criada corresponde aos valores fornecidos
+    if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
+        return undefined;
+    }
+    return date;
+};
+export const aYearAgo = () => {
+    const aYearAgo = new Date();
+    aYearAgo.setFullYear(aYearAgo.getFullYear() - 1);
+    return aYearAgo;
+};
+export const invertDate = (date, separator = '/') => {
+    if (!date)
+        return '';
+    return date.split(separator).reverse().join('-');
+};
+export const addDaysToToday = (days) => {
+    const date = new Date();
+    date.setDate(date.getDate() + days);
+    return date;
+};
+export const isValidDate = (date) => {
+    return date instanceof Date && !Number.isNaN(date.getTime());
+};
+export const isDateRangeValid = (startDate, endDate, maxDays = 90) => {
+    const diffInMs = endDate.getTime() - startDate.getTime();
+    const diffInDays = diffInMs / (1000 * 60 * 60 * 24);
+    return diffInDays <= maxDays;
+};

package/dist/lib/help/download.d.ts

@@ -0,0 +1,2 @@
+export declare const downloadWithServiceWorker: (urlDownload: string, fileName: string) => Promise<void>;
+//# sourceMappingURL=download.d.ts.map

package/dist/lib/help/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/lib/help/download.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,GAAU,aAAa,MAAM,EAAE,UAAU,MAAM,kBAyBpF,CAAC"}

package/dist/lib/help/download.js

@@ -0,0 +1,26 @@
+import { toast } from '@/components/ui/use-toast';
+export const downloadWithServiceWorker = async (urlDownload, fileName) => {
+    try {
+        const response = await fetch(urlDownload);
+        if (!response.ok) {
+            throw new Error('Erro ao fazer o download');
+        }
+        const blob = await response.blob();
+        const url = window.URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = fileName;
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        window.URL.revokeObjectURL(url);
+    }
+    catch (error) {
+        toast({
+            title: 'Erro ao fazer o download',
+            description: error instanceof Error ? error.message : 'Tente novamente mais tarde.',
+            variant: 'destructive',
+        });
+        console.error(error);
+    }
+};

package/dist/lib/help/format.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Formats a phone number string with proper mask.
+ * Automatically detects landline vs mobile format.
+ *
+ * @param telefone - Raw phone number string
+ * @param removeDDD - Whether to remove DDD (area code) from the formatted output
+ * @param removeCountryCode - Whether to remove country code (55) if present
+ * @returns Formatted phone number string
+ *
+ * @example
+ * ```tsx
+ * formatPhone('11987654321') // '(11) 9 8765-4321'
+ * formatPhone('1134567890')  // '(11) 3456-7890'
+ * formatPhone('11987654321', true) // '9 8765-4321'
+ * ```
+ */
+export declare function formatPhone(telefone: string, removeDDD?: boolean, removeCountryCode?: boolean): string;
+/**
+ * Formats a CPF or CNPJ string with proper mask.
+ * Automatically detects CPF vs CNPJ format based on length.
+ *
+ * @param cpfCnpj - Raw CPF/CNPJ string
+ * @returns Formatted CPF/CNPJ string
+ *
+ * @example
+ * ```tsx
+ * formatCpfCnpj('12345678901')    // '123.456.789-01'
+ * formatCpfCnpj('12345678000195') // '12.345.678/0001-95'
+ * ```
+ */
+export declare function formatCpfCnpj(cpfCnpj?: string): string;
+/**
+ * Formats a date to Brazilian format (DD/MM/YYYY).
+ *
+ * @param date - Date string, Date object, or undefined
+ * @param separator - Date separator (default: '/')
+ * @returns Formatted date string in Brazilian format
+ *
+ * @example
+ * ```tsx
+ * formatDate('2023-12-25')      // '25/12/2023'
+ * formatDate(new Date())        // '13/10/2025'
+ * ```
+ */
+export declare const formatDate: (date: string | Date | undefined, _separator?: string) => string;
+export declare const formatDateTime: (date: Date | undefined, returnSeconds?: boolean) => string;
+export declare function formatDateCalendar(date: Date | undefined): string;
+export declare function stringDateToDate(date: string | undefined, separator?: string): Date | undefined;
+export declare const roundNumber: (value: number, fractionDigits?: number) => number;
+export declare const stringToNumber: (value: string | undefined) => number;
+declare enum InternetAmountUnity {
+    iauMegabyte = 0,
+    iauGigabyte = 1,
+    UNRECOGNIZED = -1
+}
+export declare const convertInternetToDisplay: (internet: number, unit: InternetAmountUnity) => string;
+export declare const convertMbToGb: (value: number) => number;
+export declare const convertGbToMb: (value: number) => number;
+export declare const convertSecondsToMinutes: (value: number) => number;
+export declare const convertBytesToMB: (bytes: number) => number;
+export declare const convertMonthToDays: (months: number) => number;
+export declare const convertDaysToMonth: (days: number) => number;
+export declare const formatNumber: (value: number) => string;
+/**
+ * Formats a number with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted decimal string
+ *
+ * @example
+ * ```tsx
+ * formatDecimal(1234.56)   // '1.234,56'
+ * formatDecimal(1000.1, 1) // '1.000,1'
+ * ```
+ */
+export declare const formatDecimal: (value: number, decimalPlaces?: number) => string;
+/**
+ * Formats a number as percentage with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * ```tsx
+ * formatPercent(15.5)    // '% 15,50'
+ * formatPercent(100, 0)  // '% 100'
+ * ```
+ */
+export declare const formatPercent: (value: number, decimalPlaces?: number) => string;
+/**
+ * Formats a number as Brazilian currency (BRL).
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```tsx
+ * formatCurrency(1234.56)  // 'R$ 1.234,56'
+ * formatCurrency(1000, 0)  // 'R$ 1.000'
+ * ```
+ */
+export declare const formatCurrency: (value: number, decimalPlaces?: number) => string;
+export declare const isInvalidCurrencyValue: (rawValue: string | undefined) => boolean;
+/**
+ * Formats an MSISDN (mobile phone number) to display format.
+ *
+ * @param value - Raw MSISDN string
+ * @returns Formatted MSISDN string
+ *
+ * @example
+ * ```tsx
+ * formatMsisdn('5511987654321') // '(11) 98765-4321'
+ * ```
+ */
+export declare function formatMsisdn(value?: string): string;
+/**
+ * Formats a CEP (Brazilian postal code) with proper mask.
+ *
+ * @param cep - Raw CEP string
+ * @returns Formatted CEP string (XXXXX-XXX)
+ *
+ * @example
+ * ```tsx
+ * formatCEP('01234567') // '01234-567'
+ * formatCEP('12345')    // '12345'
+ * ```
+ */
+export declare function formatCEP(cep?: string): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/help/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/lib/help/format.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,EAAE,iBAAiB,UAAO,UAoBxF;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtD;AAeD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,aAAY,MAAY,WAMnF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,GAAG,SAAS,EAAE,gBAAe,OAAe,KAAG,MAQvF,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAQjE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,GAAE,MAAY,GAAG,IAAI,GAAG,SAAS,CAOpG;AAGD,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,iBAAgB,MAAU,KAAG,MAEvE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAQ1D,CAAC;AAEF,aAAK,mBAAmB;IACvB,WAAW,IAAI;IACf,WAAW,IAAI;IACf,YAAY,KAAK;CACjB;AAED,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,MAAM,mBAAmB,KAAG,MAUtF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,WAE1C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,WAE1C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,MAEvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAGhD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,MAEnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAEjD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAMzC,CAAC;AAGF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,gBAAe,MAAU,WAMrE,CAAC;AAGF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,gBAAe,MAAU,WAErE,CAAC;AAGF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,gBAAe,MAAU,WAOtE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,GAAG,SAAS,KAAG,OAMrE,CAAC;AAGF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAGvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,UAOrC"}

package/dist/lib/help/format.js

@@ -0,0 +1,268 @@
+import { format } from '@react-input/mask';
+import { maskCpfCnpj, maskPhone } from '../../components/ui/masks';
+// PHONE
+/**
+ * Formats a phone number string with proper mask.
+ * Automatically detects landline vs mobile format.
+ *
+ * @param telefone - Raw phone number string
+ * @param removeDDD - Whether to remove DDD (area code) from the formatted output
+ * @param removeCountryCode - Whether to remove country code (55) if present
+ * @returns Formatted phone number string
+ *
+ * @example
+ * ```tsx
+ * formatPhone('11987654321') // '(11) 9 8765-4321'
+ * formatPhone('1134567890')  // '(11) 3456-7890'
+ * formatPhone('11987654321', true) // '9 8765-4321'
+ * ```
+ */
+export function formatPhone(telefone, removeDDD = false, removeCountryCode = true) {
+    if (!telefone)
+        return '';
+    let numberPhone = telefone.replace(/\D/g, '');
+    // Remover código do país apenas se ele começar com '55'
+    if (removeCountryCode && numberPhone.startsWith('55')) {
+        numberPhone = numberPhone.substring(2);
+    }
+    // Se removeDDD for true, remover os dois primeiros dígitos (DDD)
+    if (removeDDD && numberPhone.length >= 10) {
+        const phoneWithoutDDD = numberPhone.substring(2);
+        // Aplicar máscara sem DDD
+        const isMobile = phoneWithoutDDD.length === 9;
+        const mask = isMobile ? { mask: '_ ____-____', replacement: { _: /\d/ } } : { mask: '____-_____', replacement: { _: /\d/ } };
+        return format(phoneWithoutDDD, mask);
+    }
+    return format(numberPhone, maskPhone(numberPhone));
+}
+// CPF/CNPJ
+/**
+ * Formats a CPF or CNPJ string with proper mask.
+ * Automatically detects CPF vs CNPJ format based on length.
+ *
+ * @param cpfCnpj - Raw CPF/CNPJ string
+ * @returns Formatted CPF/CNPJ string
+ *
+ * @example
+ * ```tsx
+ * formatCpfCnpj('12345678901')    // '123.456.789-01'
+ * formatCpfCnpj('12345678000195') // '12.345.678/0001-95'
+ * ```
+ */
+export function formatCpfCnpj(cpfCnpj) {
+    if (!cpfCnpj)
+        return '';
+    const numberCpfCnpj = cpfCnpj.replace(/\D/g, '');
+    return format(numberCpfCnpj, maskCpfCnpj(numberCpfCnpj));
+}
+// DATE
+function getDay(date) {
+    return date.getDate().toString().padStart(2, '0');
+}
+function getMonth(date) {
+    return (date.getMonth() + 1).toString().padStart(2, '0');
+}
+function getYear(date) {
+    return date.getFullYear().toString();
+}
+/**
+ * Formats a date to Brazilian format (DD/MM/YYYY).
+ *
+ * @param date - Date string, Date object, or undefined
+ * @param separator - Date separator (default: '/')
+ * @returns Formatted date string in Brazilian format
+ *
+ * @example
+ * ```tsx
+ * formatDate('2023-12-25')      // '25/12/2023'
+ * formatDate(new Date())        // '13/10/2025'
+ * ```
+ */
+export const formatDate = (date, _separator = '/') => {
+    if (!date)
+        return '';
+    const d = new Date(date);
+    return d.toLocaleDateString('pt-BR');
+};
+export const formatDateTime = (date, returnSeconds = false) => {
+    if (!date)
+        return '';
+    const hours = date.getHours().toString().padStart(2, '0');
+    const minutes = date.getMinutes().toString().padStart(2, '0');
+    const seconds = returnSeconds ? `:${date.getSeconds().toString().padStart(2, '0')}` : '';
+    return `${formatDate(date)} ${hours}:${minutes}${seconds}`;
+};
+export function formatDateCalendar(date) {
+    if (!date)
+        return '';
+    const day = getDay(date);
+    const month = getMonth(date);
+    const year = getYear(date);
+    return `${year}-${month}-${day}`;
+}
+export function stringDateToDate(date, separator = '/') {
+    if (!date)
+        return undefined;
+    const [day, month, year] = date.split(separator).map(Number);
+    // new Date(ano, mês-1, dia) interpreta a data no fuso horário local
+    return new Date(year, month - 1, day);
+}
+// NUMBER
+export const roundNumber = (value, fractionDigits = 2) => {
+    return Number(value.toFixed(fractionDigits));
+};
+export const stringToNumber = (value) => {
+    if (!value)
+        return 0;
+    const numericValue = value
+        .replace(/[^\d,-]/g, '')
+        .replace(/\./g, '')
+        .replace(',', '.');
+    return Number.parseFloat(numericValue);
+};
+var InternetAmountUnity;
+(function (InternetAmountUnity) {
+    InternetAmountUnity[InternetAmountUnity["iauMegabyte"] = 0] = "iauMegabyte";
+    InternetAmountUnity[InternetAmountUnity["iauGigabyte"] = 1] = "iauGigabyte";
+    InternetAmountUnity[InternetAmountUnity["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+})(InternetAmountUnity || (InternetAmountUnity = {}));
+export const convertInternetToDisplay = (internet, unit) => {
+    if (internet === 0) {
+        return '';
+    }
+    const internetInMB = unit === InternetAmountUnity.iauGigabyte ? convertGbToMb(internet) : internet;
+    if (internetInMB > 1023) {
+        return `${convertMbToGb(roundNumber(internetInMB))} GB`;
+    }
+    return `${roundNumber(internetInMB)} MB`;
+};
+export const convertMbToGb = (value) => {
+    return value > 0 ? roundNumber(value / 1024) : 0;
+};
+export const convertGbToMb = (value) => {
+    return value > 0 ? roundNumber(value * 1024) : 0;
+};
+export const convertSecondsToMinutes = (value) => {
+    return value > 0 ? roundNumber(value / 60) : 0;
+};
+export const convertBytesToMB = (bytes) => {
+    if (!bytes || Number.isNaN(bytes))
+        return 0;
+    return roundNumber(bytes / (1024 * 1024));
+};
+export const convertMonthToDays = (months) => {
+    return months > 0 ? months * 30 : 0;
+};
+export const convertDaysToMonth = (days) => {
+    return days > 0 ? roundNumber(days / 30) : 0;
+};
+// NUMBER
+export const formatNumber = (value) => {
+    return value.toLocaleString('pt-BR', {
+        style: 'decimal',
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 0,
+    });
+};
+// DECIMAL
+/**
+ * Formats a number with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted decimal string
+ *
+ * @example
+ * ```tsx
+ * formatDecimal(1234.56)   // '1.234,56'
+ * formatDecimal(1000.1, 1) // '1.000,1'
+ * ```
+ */
+export const formatDecimal = (value, decimalPlaces = 2) => {
+    return value.toLocaleString('pt-BR', {
+        style: 'decimal',
+        minimumFractionDigits: decimalPlaces,
+        maximumFractionDigits: decimalPlaces,
+    });
+};
+// PERCENT
+/**
+ * Formats a number as percentage with Brazilian decimal format.
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted percentage string
+ *
+ * @example
+ * ```tsx
+ * formatPercent(15.5)    // '% 15,50'
+ * formatPercent(100, 0)  // '% 100'
+ * ```
+ */
+export const formatPercent = (value, decimalPlaces = 2) => {
+    return `% ${formatDecimal(value, decimalPlaces)}`;
+};
+// CURRENCY
+/**
+ * Formats a number as Brazilian currency (BRL).
+ *
+ * @param value - Numeric value to format
+ * @param decimalPlaces - Number of decimal places (default: 2)
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```tsx
+ * formatCurrency(1234.56)  // 'R$ 1.234,56'
+ * formatCurrency(1000, 0)  // 'R$ 1.000'
+ * ```
+ */
+export const formatCurrency = (value, decimalPlaces = 2) => {
+    return value.toLocaleString('pt-BR', {
+        style: 'currency',
+        currency: 'BRL',
+        minimumFractionDigits: decimalPlaces,
+        maximumFractionDigits: decimalPlaces,
+    });
+};
+export const isInvalidCurrencyValue = (rawValue) => {
+    if (!rawValue || rawValue.trim() === '')
+        return true;
+    const numericValue = stringToNumber(rawValue);
+    return Number.isNaN(numericValue) || numericValue <= 0;
+};
+// OTHERS
+/**
+ * Formats an MSISDN (mobile phone number) to display format.
+ *
+ * @param value - Raw MSISDN string
+ * @returns Formatted MSISDN string
+ *
+ * @example
+ * ```tsx
+ * formatMsisdn('5511987654321') // '(11) 98765-4321'
+ * ```
+ */
+export function formatMsisdn(value = '') {
+    const msisdn = value.replace(/\D/g, '');
+    return `(${msisdn.slice(2, 4)}) ${msisdn.slice(4, 9)}-${msisdn.slice(9)}`;
+}
+/**
+ * Formats a CEP (Brazilian postal code) with proper mask.
+ *
+ * @param cep - Raw CEP string
+ * @returns Formatted CEP string (XXXXX-XXX)
+ *
+ * @example
+ * ```tsx
+ * formatCEP('01234567') // '01234-567'
+ * formatCEP('12345')    // '12345'
+ * ```
+ */
+export function formatCEP(cep) {
+    if (!cep)
+        return '';
+    return cep
+        .replace(/\D/g, '')
+        .replace(/(\d{5})(\d)/, '$1-$2')
+        .replace(/(-\d{3})\d+?$/, '$1');
+}