eai-frontend-components 2.0.19 → 2.0.20

package/dist/index.js

@@ -698,28 +698,98 @@ const HoverCardTrigger = HoverCardPrimitive__namespace.Trigger;
 const HoverCardContent = React__namespace.forwardRef(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (jsxRuntime.jsx(HoverCardPrimitive__namespace.Content, { ref: ref, align: align, sideOffset: sideOffset, className: cn('z-50 w-auto mr-20 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-1 data-[side=top]:slide-in-from-bottom-2', className), ...props })));
 HoverCardContent.displayName = HoverCardPrimitive__namespace.Content.displayName;
 
+/**
+ * Modify function for phone number input mask.
+ * Automatically adjusts between landline and mobile phone formats.
+ *
+ * @param value - Current input value
+ * @param data - New input data
+ * @param selectionStart - Cursor start position
+ * @param selectionEnd - Cursor end position
+ * @returns Mask configuration object
+ */
 const modifyPhone = ({ value, data, selectionStart, selectionEnd }) => {
     const _value = value.slice(0, selectionStart) + (data ?? '') + value.slice(selectionEnd);
     _value ? _value.replace(/[\D]+/g, '').length : 0;
     return maskPhone(_value);
 };
+/**
+ * Creates a phone number mask based on the input length.
+ * - Landline: (XX) XXXX-XXXX
+ * - Mobile: (XX) X XXXX-XXXX
+ *
+ * @param value - Phone number string (can be null)
+ * @returns Mask configuration object with pattern and replacement rules
+ *
+ * @example
+ * ```tsx
+ * const mask = maskPhone('11987654321');
+ * // Returns: { mask: '(__) _ ____-____', replacement: { _: /\d/ } }
+ * ```
+ */
 function maskPhone(value) {
     const len = value ? value.replace(/[\D]+/g, '').length : 0;
     if (len > 10)
         return { mask: '(__) _ ____-____', replacement: { _: /\d/ } };
     return { mask: '(__) ____-_____', replacement: { _: /\d/ } };
 }
+/**
+ * Modify function for CPF/CNPJ input mask.
+ * Automatically switches between CPF and CNPJ formats based on input length.
+ *
+ * @param value - Current input value
+ * @param data - New input data
+ * @param selectionStart - Cursor start position
+ * @param selectionEnd - Cursor end position
+ * @returns Mask configuration object
+ */
 const modifyCpfCnpj = ({ value, data, selectionStart, selectionEnd }) => {
     const _value = value.slice(0, selectionStart) + (data ?? '') + value.slice(selectionEnd);
     _value ? _value.replace(/[\D]+/g, '').length : 0;
     return maskCpfCnpj(_value);
 };
+/**
+ * Creates a CPF or CNPJ mask based on the input length.
+ * - CPF: XXX.XXX.XXX-XX (up to 11 digits)
+ * - CNPJ: XX.XXX.XXX/XXXX-XX (12+ digits)
+ *
+ * @param value - CPF/CNPJ string (can be null)
+ * @returns Mask configuration object with pattern and replacement rules
+ *
+ * @example
+ * ```tsx
+ * const cpfMask = maskCpfCnpj('12345678901');
+ * // Returns: { mask: '___.___.___-___', replacement: { _: /\d/ } }
+ *
+ * const cnpjMask = maskCpfCnpj('12345678000195');
+ * // Returns: { mask: '__.___.___/____-__', replacement: { _: /\d/ } }
+ * ```
+ */
 function maskCpfCnpj(value) {
     const len = value ? value.replace(/[\D]+/g, '').length : 0;
     if (len > 11)
         return { mask: '__.___.___/____-__', replacement: { _: /\d/ } };
     return { mask: '___.___.___-___', replacement: { _: /\d/ } };
 }
+/**
+ * Removes all non-numeric characters from a string.
+ * Useful for extracting only digits from masked inputs.
+ *
+ * @param value - String with potential mask characters
+ * @returns String containing only numeric characters
+ *
+ * @example
+ * ```tsx
+ * const cleaned = removeMaskNumber('(11) 9 8765-4321');
+ * // Returns: '11987654321'
+ *
+ * const cleanCpf = removeMaskNumber('123.456.789-01');
+ * // Returns: '12345678901'
+ * ```
+ */
+const removeMaskNumber = (value) => {
+    return value?.replace(/\D/g, '');
+};
 
 // PHONE
 function formatPhone(telefone, removerCountryCode = true) {
@@ -3665,8 +3735,11 @@ exports.getFirstDayOfCurrentMonth = getFirstDayOfCurrentMonth;
 exports.getTailwindColorShades = getTailwindColorShades;
 exports.invertDate = invertDate;
 exports.isUUIDv4 = isUUIDv4;
+exports.maskCpfCnpj = maskCpfCnpj;
+exports.maskPhone = maskPhone;
 exports.modifyCpfCnpj = modifyCpfCnpj;
 exports.modifyPhone = modifyPhone;
+exports.removeMaskNumber = removeMaskNumber;
 exports.replaceThemeTailwindColors = replaceThemeTailwindColors;
 exports.roundNumber = roundNumber;
 exports.stringDateToDate = stringDateToDate;