use-mask-input 3.7.1 → 3.7.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [3.6.0](https://github.com/eduardoborges/use-mask-input/compare/3.5.2...3.6.0) (2026-01-13)
 
+## 3.7.2
+
+### Patch Changes
+
+- e1618a5: optimize masking logic in useHookFormMask and related components with memoization
+- ea0f089: enhance withMask function to support caching of callbacks based on masks and options
+
 ## 3.7.1
 
 ### Patch Changes

package/README.md

@@ -2,7 +2,7 @@
   <h1>🥸 use-mask-input</h1>
   <h4>A React Hook for building elegant and simple input masks.</h4>
 
-  ![npm](https://img.shields.io/npm/v/use-mask-input) ![npm package minimized gzipped size (select exports)](https://img.shields.io/bundlejs/size/use-mask-input?color=green-light) ![npm](https://img.shields.io/npm/dw/use-mask-input)
+  ![npm](https://img.shields.io/npm/v/use-mask-input) ![npm package minimized gzipped size (select exports)](https://img.shields.io/bundlejs/size/use-mask-input?color=green-light) ![npm](https://img.shields.io/npm/dw/use-mask-input) [![codecov](https://codecov.io/gh/eduardoborges/use-mask-input/branch/main/graph/badge.svg?token=8ORAOAUZTP)](https://codecov.io/gh/eduardoborges/use-mask-input)
 </div>
 
 ## [Full Documentation](http://use-mask-input.eduardoborges.dev) | [Sponsor this project](https://github.com/eduardoborges?tab=sponsors)

package/dist/antd.cjs

@@ -1,37 +1,38 @@
 'use strict';
 
-var chunk4Y2DTPBL_cjs = require('./chunk-4Y2DTPBL.cjs');
+var chunkNIHSNNRR_cjs = require('./chunk-NIHSNNRR.cjs');
 var react = require('react');
 
-// src/antd/useHookFormMaskAntd.ts
 function useHookFormMaskAntd(registerFn) {
-  return (fieldName, mask, options) => {
-    if (!registerFn) throw new Error("registerFn is required");
-    const registerReturn = registerFn(fieldName, options);
-    const { ref } = registerReturn;
-    const refWithMask = (inputRef) => {
-      const element = inputRef ? chunk4Y2DTPBL_cjs.resolveInputRef(inputRef.input) : null;
-      if (element) chunk4Y2DTPBL_cjs.applyMaskToElement(element, mask, options);
-      if (ref) ref(element);
+  return react.useMemo(() => {
+    const refCache = /* @__PURE__ */ new Map();
+    return (fieldName, mask, options) => {
+      if (!registerFn) throw new Error("registerFn is required");
+      const registerReturn = registerFn(fieldName, options);
+      const { ref } = registerReturn;
+      const cacheKey = chunkNIHSNNRR_cjs.makeMaskCacheKey(fieldName, mask);
+      if (!refCache.has(cacheKey)) {
+        const refWithMask = (inputRef) => {
+          const element = inputRef ? chunkNIHSNNRR_cjs.resolveInputRef(inputRef.input) : null;
+          if (element) chunkNIHSNNRR_cjs.applyMaskToElement(element, mask, options);
+          if (ref) ref(element);
+        };
+        refCache.set(cacheKey, refWithMask);
+      }
+      const result = {
+        ...registerReturn,
+        ref: refCache.get(cacheKey)
+      };
+      chunkNIHSNNRR_cjs.setPrevRef(result, ref);
+      return result;
     };
-    const result = {
-      ...registerReturn,
-      ref: refWithMask
-    };
-    Object.defineProperty(result, "prevRef", {
-      value: ref,
-      enumerable: false,
-      writable: true,
-      configurable: true
-    });
-    return result;
-  };
+  }, [registerFn]);
 }
 function useMaskInputAntd(props) {
   const { mask, register, options } = props;
   const ref = react.useRef(null);
   const maskInput = react.useMemo(
-    () => chunk4Y2DTPBL_cjs.isServer_default ? null : chunk4Y2DTPBL_cjs.createMaskInstance(mask, options),
+    () => chunkNIHSNNRR_cjs.isServer_default ? null : chunkNIHSNNRR_cjs.createMaskInstance(mask, options),
     [mask, options]
   );
   const refCallback = react.useCallback((input) => {
@@ -39,22 +40,22 @@ function useMaskInputAntd(props) {
       ref.current = null;
       return;
     }
-    ref.current = chunk4Y2DTPBL_cjs.resolveInputRef(input.input);
+    ref.current = chunkNIHSNNRR_cjs.resolveInputRef(input.input);
   }, []);
   react.useEffect(() => {
-    if (chunk4Y2DTPBL_cjs.isServer_default || !ref.current) return;
-    if (!chunk4Y2DTPBL_cjs.isHTMLElement(ref.current)) {
+    if (chunkNIHSNNRR_cjs.isServer_default || !ref.current) return;
+    if (!chunkNIHSNNRR_cjs.isHTMLElement(ref.current)) {
       return;
     }
-    const inputElement = chunk4Y2DTPBL_cjs.findInputElement(ref.current);
-    if (maskInput && inputElement && chunk4Y2DTPBL_cjs.isHTMLElement(inputElement)) {
+    const inputElement = chunkNIHSNNRR_cjs.findInputElement(ref.current);
+    if (maskInput && inputElement && chunkNIHSNNRR_cjs.isHTMLElement(inputElement)) {
       maskInput.mask(inputElement);
     }
-    if (register && chunk4Y2DTPBL_cjs.isHTMLElement(ref.current)) {
+    if (register && chunkNIHSNNRR_cjs.isHTMLElement(ref.current)) {
       register(ref.current);
     }
   }, [mask, register, options, maskInput]);
-  if (chunk4Y2DTPBL_cjs.isServer_default) {
+  if (chunkNIHSNNRR_cjs.isServer_default) {
     return () => {
     };
   }

package/dist/antd.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/antd/useHookFormMaskAntd.ts","../src/antd/useMaskInputAntd.ts"],"names":["resolveInputRef","applyMaskToElement","useRef","useMemo","isServer_default","createMaskInstance","useCallback","useEffect","isHTMLElement","findInputElement"],"mappings":";;;;;;AA0Be,SAAR,oBAEL,UAAA,EAAgC;AAChC,EAAA,OAAO,CAAC,SAAA,EAAoB,IAAA,EAAY,OAAA,KACuB;AAC7D,IAAA,IAAI,CAAC,UAAA,EAAY,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAEzD,IAAA,MAAM,cAAA,GAAiB,UAAA,CAAW,SAAA,EAAW,OAAkB,CAAA;AAC/D,IAAA,MAAM,EAAE,KAAI,GAAI,cAAA;AAEhB,IAAA,MAAM,WAAA,GAA4C,CAAC,QAAA,KAAa;AAC9D,MAAA,MAAM,OAAA,GAAU,QAAA,GAAWA,iCAAA,CAAgB,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA;AAC7D,MAAA,IAAI,OAAA,EAASC,oCAAA,CAAmB,OAAA,EAAS,IAAA,EAAM,OAAkB,CAAA;AACjE,MAAA,IAAI,GAAA,MAAS,OAAO,CAAA;AAAA,IACtB,CAAA;AAEA,IAAA,MAAM,MAAA,GAAS;AAAA,MACb,GAAG,cAAA;AAAA,MACH,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,SAAA,EAAW;AAAA,MACvC,KAAA,EAAO,GAAA;AAAA,MACP,UAAA,EAAY,KAAA;AAAA,MACZ,QAAA,EAAU,IAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA;AAED,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;ACxBe,SAAR,iBAAkC,KAAA,EAE/B;AACR,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAQ,GAAI,KAAA;AACpC,EAAA,MAAM,GAAA,GAAMC,aAAwB,IAAI,CAAA;AACxC,EAAA,MAAM,SAAA,GAAYC,aAAA;AAAA,IAChB,MAAOC,kCAAA,GAAW,IAAA,GAAOC,oCAAA,CAAmB,MAAM,OAAO,CAAA;AAAA,IACzD,CAAC,MAAM,OAAO;AAAA,GAChB;AAEA,EAAA,MAAM,WAAA,GAAcC,iBAAA,CAAY,CAAC,KAAA,KAA2B;AAC1D,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,GAAA,CAAI,OAAA,GAAU,IAAA;AACd,MAAA;AAAA,IACF;AAEA,IAAA,GAAA,CAAI,OAAA,GAAUN,iCAAA,CAAgB,KAAA,CAAM,KAAK,CAAA;AAAA,EAC3C,CAAA,EAAG,EAAE,CAAA;AAEL,EAAAO,eAAA,CAAU,MAAM;AACd,IAAA,IAAIH,kCAAA,IAAY,CAAC,GAAA,CAAI,OAAA,EAAS;AAE9B,IAAA,IAAI,CAACI,+BAAA,CAAc,GAAA,CAAI,OAAO,CAAA,EAAG;AAC/B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,YAAA,GAAeC,kCAAA,CAAiB,GAAA,CAAI,OAAO,CAAA;AAEjD,IAAA,IAAI,SAAA,IAAa,YAAA,IAAgBD,+BAAA,CAAc,YAAY,CAAA,EAAG;AAC5D,MAAA,SAAA,CAAU,KAAK,YAAY,CAAA;AAAA,IAC7B;AAEA,IAAA,IAAI,QAAA,IAAYA,+BAAA,CAAc,GAAA,CAAI,OAAO,CAAA,EAAG;AAC1C,MAAA,QAAA,CAAS,IAAI,OAAO,CAAA;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,SAAS,CAAC,CAAA;AAEvC,EAAA,IAAIJ,kCAAA,EAAU;AACZ,IAAA,OAAO,MAAY;AAAA,IAEnB,CAAA;AAAA,EACF;AAEA,EAAA,OAAO,WAAA;AACT","file":"antd.cjs","sourcesContent":["import { applyMaskToElement, resolveInputRef } from '../core';\n\nimport type { InputRef } from 'antd';\nimport type { RefCallback } from 'react';\nimport type {\n  FieldValues, Path,\n  RegisterOptions,\n  UseFormRegister,\n} from 'react-hook-form';\n\nimport type { Mask, Options, UseHookFormMaskReturn } from '../types';\n\nexport type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<\n  UseHookFormMaskReturn<T>,\n  'ref'\n> & { ref: RefCallback<InputRef | null> };\n\n/**\n * Ant Design version of useHookFormMask.\n * Creates a masked register that works with Ant Design Input (ref receives InputRef).\n *\n * @template T - The form data type\n * @template D - The register options type\n * @param registerFn - The register function from useForm hook\n * @returns A function that registers a field with mask support for Ant Design Input\n */\nexport default function useHookFormMaskAntd<\n  T extends FieldValues, D extends RegisterOptions,\n>(registerFn: UseFormRegister<T>) {\n  return (fieldName: Path<T>, mask: Mask, options?: (\n    D & Options) | Options | D): UseHookFormMaskAntdReturn<T> => {\n    if (!registerFn) throw new Error('registerFn is required');\n\n    const registerReturn = registerFn(fieldName, options as Options);\n    const { ref } = registerReturn as UseHookFormMaskReturn<T>;\n\n    const refWithMask: RefCallback<InputRef | null> = (inputRef) => {\n      const element = inputRef ? resolveInputRef(inputRef.input) : null;\n      if (element) applyMaskToElement(element, mask, options as Options);\n      if (ref) ref(element);\n    };\n\n    const result = {\n      ...registerReturn,\n      ref: refWithMask,\n    } as UseHookFormMaskAntdReturn<T>;\n\n    Object.defineProperty(result, 'prevRef', {\n      value: ref,\n      enumerable: false,\n      writable: true,\n      configurable: true,\n    });\n\n    return result;\n  };\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport {\n  createMaskInstance, findInputElement, isHTMLElement, resolveInputRef,\n} from '../core';\nimport isServer from '../utils/isServer';\n\nimport type { InputRef } from 'antd';\n\nimport type { Mask, Options } from '../types';\n\ninterface UseMaskInputOptions {\n  mask: Mask;\n  register?: (element: HTMLElement) => void;\n  options?: Options;\n}\n\n/**\n * React hook for applying input masks to form elements.\n * Works with Ant Design and other wrapped components too.\n *\n * @param props - Configuration object\n * @param props.mask - The mask pattern to apply\n * @param props.register - Optional callback that receives the element\n * @param props.options - Optional mask configuration options\n * @returns A ref callback function to attach to the input element\n */\nexport default function useMaskInputAntd(props: UseMaskInputOptions): (\n  input: InputRef | null\n) => void {\n  const { mask, register, options } = props;\n  const ref = useRef<InputRef | null>(null);\n  const maskInput = useMemo(\n    () => (isServer ? null : createMaskInstance(mask, options)),\n    [mask, options],\n  );\n\n  const refCallback = useCallback((input: InputRef | null) => {\n    if (!input) {\n      ref.current = null;\n      return;\n    }\n\n    ref.current = resolveInputRef(input.input) as unknown as InputRef;\n  }, []);\n\n  useEffect(() => {\n    if (isServer || !ref.current) return;\n\n    if (!isHTMLElement(ref.current)) {\n      return;\n    }\n\n    const inputElement = findInputElement(ref.current);\n\n    if (maskInput && inputElement && isHTMLElement(inputElement)) {\n      maskInput.mask(inputElement);\n    }\n\n    if (register && isHTMLElement(ref.current)) {\n      register(ref.current);\n    }\n  }, [mask, register, options, maskInput]);\n\n  if (isServer) {\n    return (): void => {\n      // server doesn't have dom, so just do nothing\n    };\n  }\n\n  return refCallback;\n}\n"]}
+{"version":3,"sources":["../src/antd/useHookFormMaskAntd.ts","../src/antd/useMaskInputAntd.ts"],"names":["useMemo","makeMaskCacheKey","resolveInputRef","applyMaskToElement","setPrevRef","useRef","isServer_default","createMaskInstance","useCallback","useEffect","isHTMLElement","findInputElement"],"mappings":"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","file":"antd.cjs","sourcesContent":["import { useMemo } from 'react';\n\nimport { applyMaskToElement, resolveInputRef } from '../core';\nimport { makeMaskCacheKey, setPrevRef } from '../utils';\n\nimport type { InputRef } from 'antd';\nimport type { RefCallback } from 'react';\nimport type {\n  FieldValues, Path,\n  RegisterOptions,\n  UseFormRegister,\n} from 'react-hook-form';\n\nimport type { Mask, Options, UseHookFormMaskReturn } from '../types';\n\nexport type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<\n  UseHookFormMaskReturn<T>,\n  'ref'\n> & { ref: RefCallback<InputRef | null> };\n\n/**\n * Ant Design version of useHookFormMask.\n * Creates a masked register that works with Ant Design Input (ref receives InputRef).\n *\n * @template T - The form data type\n * @template D - The register options type\n * @param registerFn - The register function from useForm hook\n * @returns A function that registers a field with mask support for Ant Design Input\n */\nexport default function useHookFormMaskAntd<\n  T extends FieldValues, D extends RegisterOptions,\n>(registerFn: UseFormRegister<T>): ((fieldName: Path<T>, mask: Mask, options?: (\n  D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>) {\n  //\n  return useMemo(() => {\n    const refCache = new Map<string, RefCallback<InputRef | null>>();\n\n    return (fieldName: Path<T>, mask: Mask, options?: (\n      D & Options) | Options | D): UseHookFormMaskAntdReturn<T> => {\n      if (!registerFn) throw new Error('registerFn is required');\n\n      const registerReturn = registerFn(fieldName, options as Options);\n      const { ref } = registerReturn as UseHookFormMaskReturn<T>;\n\n      const cacheKey = makeMaskCacheKey(fieldName, mask);\n\n      if (!refCache.has(cacheKey)) {\n        const refWithMask: RefCallback<InputRef | null> = (inputRef) => {\n          const element = inputRef ? resolveInputRef(inputRef.input) : null;\n          if (element) applyMaskToElement(element, mask, options as Options);\n          if (ref) ref(element);\n        };\n        refCache.set(cacheKey, refWithMask);\n      }\n\n      const result = {\n        ...registerReturn,\n        ref: refCache.get(cacheKey),\n      } as UseHookFormMaskAntdReturn<T>;\n\n      setPrevRef(result, ref);\n\n      return result;\n    };\n  }, [registerFn]);\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport {\n  createMaskInstance, findInputElement, isHTMLElement, resolveInputRef,\n} from '../core';\nimport isServer from '../utils/isServer';\n\nimport type { InputRef } from 'antd';\n\nimport type { Mask, Options } from '../types';\n\ninterface UseMaskInputOptions {\n  mask: Mask;\n  register?: (element: HTMLElement) => void;\n  options?: Options;\n}\n\n/**\n * React hook for applying input masks to form elements.\n * Works with Ant Design and other wrapped components too.\n *\n * @param props - Configuration object\n * @param props.mask - The mask pattern to apply\n * @param props.register - Optional callback that receives the element\n * @param props.options - Optional mask configuration options\n * @returns A ref callback function to attach to the input element\n */\nexport default function useMaskInputAntd(props: UseMaskInputOptions): (\n  input: InputRef | null\n) => void {\n  const { mask, register, options } = props;\n  const ref = useRef<InputRef | null>(null);\n  const maskInput = useMemo(\n    () => (isServer ? null : createMaskInstance(mask, options)),\n    [mask, options],\n  );\n\n  const refCallback = useCallback((input: InputRef | null) => {\n    if (!input) {\n      ref.current = null;\n      return;\n    }\n\n    ref.current = resolveInputRef(input.input) as unknown as InputRef;\n  }, []);\n\n  useEffect(() => {\n    if (isServer || !ref.current) return;\n\n    if (!isHTMLElement(ref.current)) {\n      return;\n    }\n\n    const inputElement = findInputElement(ref.current);\n\n    if (maskInput && inputElement && isHTMLElement(inputElement)) {\n      maskInput.mask(inputElement);\n    }\n\n    if (register && isHTMLElement(ref.current)) {\n      register(ref.current);\n    }\n  }, [mask, register, options, maskInput]);\n\n  if (isServer) {\n    return (): void => {\n      // server doesn't have dom, so just do nothing\n    };\n  }\n\n  return refCallback;\n}\n"]}

package/dist/antd.d.cts

@@ -15,7 +15,7 @@ type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<UseHookFormMaskRetu
  * @param registerFn - The register function from useForm hook
  * @returns A function that registers a field with mask support for Ant Design Input
  */
-declare function useHookFormMaskAntd<T extends FieldValues, D extends RegisterOptions>(registerFn: UseFormRegister<T>): (fieldName: Path<T>, mask: Mask, options?: (D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>;
+declare function useHookFormMaskAntd<T extends FieldValues, D extends RegisterOptions>(registerFn: UseFormRegister<T>): ((fieldName: Path<T>, mask: Mask, options?: (D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>);
 
 interface UseMaskInputOptions {
     mask: Mask;

package/dist/antd.d.ts

@@ -15,7 +15,7 @@ type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<UseHookFormMaskRetu
  * @param registerFn - The register function from useForm hook
  * @returns A function that registers a field with mask support for Ant Design Input
  */
-declare function useHookFormMaskAntd<T extends FieldValues, D extends RegisterOptions>(registerFn: UseFormRegister<T>): (fieldName: Path<T>, mask: Mask, options?: (D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>;
+declare function useHookFormMaskAntd<T extends FieldValues, D extends RegisterOptions>(registerFn: UseFormRegister<T>): ((fieldName: Path<T>, mask: Mask, options?: (D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>);
 
 interface UseMaskInputOptions {
     mask: Mask;

package/dist/antd.js

@@ -1,29 +1,30 @@
-import { isServer_default, createMaskInstance, resolveInputRef, isHTMLElement, findInputElement, applyMaskToElement } from './chunk-JGOZSJMW.js';
-import { useRef, useMemo, useCallback, useEffect } from 'react';
+import { makeMaskCacheKey, setPrevRef, isServer_default, createMaskInstance, resolveInputRef, isHTMLElement, findInputElement, applyMaskToElement } from './chunk-FDD3PKBM.js';
+import { useMemo, useRef, useCallback, useEffect } from 'react';
 
-// src/antd/useHookFormMaskAntd.ts
 function useHookFormMaskAntd(registerFn) {
-  return (fieldName, mask, options) => {
-    if (!registerFn) throw new Error("registerFn is required");
-    const registerReturn = registerFn(fieldName, options);
-    const { ref } = registerReturn;
-    const refWithMask = (inputRef) => {
-      const element = inputRef ? resolveInputRef(inputRef.input) : null;
-      if (element) applyMaskToElement(element, mask, options);
-      if (ref) ref(element);
+  return useMemo(() => {
+    const refCache = /* @__PURE__ */ new Map();
+    return (fieldName, mask, options) => {
+      if (!registerFn) throw new Error("registerFn is required");
+      const registerReturn = registerFn(fieldName, options);
+      const { ref } = registerReturn;
+      const cacheKey = makeMaskCacheKey(fieldName, mask);
+      if (!refCache.has(cacheKey)) {
+        const refWithMask = (inputRef) => {
+          const element = inputRef ? resolveInputRef(inputRef.input) : null;
+          if (element) applyMaskToElement(element, mask, options);
+          if (ref) ref(element);
+        };
+        refCache.set(cacheKey, refWithMask);
+      }
+      const result = {
+        ...registerReturn,
+        ref: refCache.get(cacheKey)
+      };
+      setPrevRef(result, ref);
+      return result;
     };
-    const result = {
-      ...registerReturn,
-      ref: refWithMask
-    };
-    Object.defineProperty(result, "prevRef", {
-      value: ref,
-      enumerable: false,
-      writable: true,
-      configurable: true
-    });
-    return result;
-  };
+  }, [registerFn]);
 }
 function useMaskInputAntd(props) {
   const { mask, register, options } = props;

package/dist/antd.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/antd/useHookFormMaskAntd.ts","../src/antd/useMaskInputAntd.ts"],"names":[],"mappings":";;;;AA0Be,SAAR,oBAEL,UAAA,EAAgC;AAChC,EAAA,OAAO,CAAC,SAAA,EAAoB,IAAA,EAAY,OAAA,KACuB;AAC7D,IAAA,IAAI,CAAC,UAAA,EAAY,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAEzD,IAAA,MAAM,cAAA,GAAiB,UAAA,CAAW,SAAA,EAAW,OAAkB,CAAA;AAC/D,IAAA,MAAM,EAAE,KAAI,GAAI,cAAA;AAEhB,IAAA,MAAM,WAAA,GAA4C,CAAC,QAAA,KAAa;AAC9D,MAAA,MAAM,OAAA,GAAU,QAAA,GAAW,eAAA,CAAgB,QAAA,CAAS,KAAK,CAAA,GAAI,IAAA;AAC7D,MAAA,IAAI,OAAA,EAAS,kBAAA,CAAmB,OAAA,EAAS,IAAA,EAAM,OAAkB,CAAA;AACjE,MAAA,IAAI,GAAA,MAAS,OAAO,CAAA;AAAA,IACtB,CAAA;AAEA,IAAA,MAAM,MAAA,GAAS;AAAA,MACb,GAAG,cAAA;AAAA,MACH,GAAA,EAAK;AAAA,KACP;AAEA,IAAA,MAAA,CAAO,cAAA,CAAe,QAAQ,SAAA,EAAW;AAAA,MACvC,KAAA,EAAO,GAAA;AAAA,MACP,UAAA,EAAY,KAAA;AAAA,MACZ,QAAA,EAAU,IAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA;AAED,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;ACxBe,SAAR,iBAAkC,KAAA,EAE/B;AACR,EAAA,MAAM,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAQ,GAAI,KAAA;AACpC,EAAA,MAAM,GAAA,GAAM,OAAwB,IAAI,CAAA;AACxC,EAAA,MAAM,SAAA,GAAY,OAAA;AAAA,IAChB,MAAO,gBAAA,GAAW,IAAA,GAAO,kBAAA,CAAmB,MAAM,OAAO,CAAA;AAAA,IACzD,CAAC,MAAM,OAAO;AAAA,GAChB;AAEA,EAAA,MAAM,WAAA,GAAc,WAAA,CAAY,CAAC,KAAA,KAA2B;AAC1D,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,GAAA,CAAI,OAAA,GAAU,IAAA;AACd,MAAA;AAAA,IACF;AAEA,IAAA,GAAA,CAAI,OAAA,GAAU,eAAA,CAAgB,KAAA,CAAM,KAAK,CAAA;AAAA,EAC3C,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,gBAAA,IAAY,CAAC,GAAA,CAAI,OAAA,EAAS;AAE9B,IAAA,IAAI,CAAC,aAAA,CAAc,GAAA,CAAI,OAAO,CAAA,EAAG;AAC/B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,YAAA,GAAe,gBAAA,CAAiB,GAAA,CAAI,OAAO,CAAA;AAEjD,IAAA,IAAI,SAAA,IAAa,YAAA,IAAgB,aAAA,CAAc,YAAY,CAAA,EAAG;AAC5D,MAAA,SAAA,CAAU,KAAK,YAAY,CAAA;AAAA,IAC7B;AAEA,IAAA,IAAI,QAAA,IAAY,aAAA,CAAc,GAAA,CAAI,OAAO,CAAA,EAAG;AAC1C,MAAA,QAAA,CAAS,IAAI,OAAO,CAAA;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,SAAS,CAAC,CAAA;AAEvC,EAAA,IAAI,gBAAA,EAAU;AACZ,IAAA,OAAO,MAAY;AAAA,IAEnB,CAAA;AAAA,EACF;AAEA,EAAA,OAAO,WAAA;AACT","file":"antd.js","sourcesContent":["import { applyMaskToElement, resolveInputRef } from '../core';\n\nimport type { InputRef } from 'antd';\nimport type { RefCallback } from 'react';\nimport type {\n  FieldValues, Path,\n  RegisterOptions,\n  UseFormRegister,\n} from 'react-hook-form';\n\nimport type { Mask, Options, UseHookFormMaskReturn } from '../types';\n\nexport type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<\n  UseHookFormMaskReturn<T>,\n  'ref'\n> & { ref: RefCallback<InputRef | null> };\n\n/**\n * Ant Design version of useHookFormMask.\n * Creates a masked register that works with Ant Design Input (ref receives InputRef).\n *\n * @template T - The form data type\n * @template D - The register options type\n * @param registerFn - The register function from useForm hook\n * @returns A function that registers a field with mask support for Ant Design Input\n */\nexport default function useHookFormMaskAntd<\n  T extends FieldValues, D extends RegisterOptions,\n>(registerFn: UseFormRegister<T>) {\n  return (fieldName: Path<T>, mask: Mask, options?: (\n    D & Options) | Options | D): UseHookFormMaskAntdReturn<T> => {\n    if (!registerFn) throw new Error('registerFn is required');\n\n    const registerReturn = registerFn(fieldName, options as Options);\n    const { ref } = registerReturn as UseHookFormMaskReturn<T>;\n\n    const refWithMask: RefCallback<InputRef | null> = (inputRef) => {\n      const element = inputRef ? resolveInputRef(inputRef.input) : null;\n      if (element) applyMaskToElement(element, mask, options as Options);\n      if (ref) ref(element);\n    };\n\n    const result = {\n      ...registerReturn,\n      ref: refWithMask,\n    } as UseHookFormMaskAntdReturn<T>;\n\n    Object.defineProperty(result, 'prevRef', {\n      value: ref,\n      enumerable: false,\n      writable: true,\n      configurable: true,\n    });\n\n    return result;\n  };\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport {\n  createMaskInstance, findInputElement, isHTMLElement, resolveInputRef,\n} from '../core';\nimport isServer from '../utils/isServer';\n\nimport type { InputRef } from 'antd';\n\nimport type { Mask, Options } from '../types';\n\ninterface UseMaskInputOptions {\n  mask: Mask;\n  register?: (element: HTMLElement) => void;\n  options?: Options;\n}\n\n/**\n * React hook for applying input masks to form elements.\n * Works with Ant Design and other wrapped components too.\n *\n * @param props - Configuration object\n * @param props.mask - The mask pattern to apply\n * @param props.register - Optional callback that receives the element\n * @param props.options - Optional mask configuration options\n * @returns A ref callback function to attach to the input element\n */\nexport default function useMaskInputAntd(props: UseMaskInputOptions): (\n  input: InputRef | null\n) => void {\n  const { mask, register, options } = props;\n  const ref = useRef<InputRef | null>(null);\n  const maskInput = useMemo(\n    () => (isServer ? null : createMaskInstance(mask, options)),\n    [mask, options],\n  );\n\n  const refCallback = useCallback((input: InputRef | null) => {\n    if (!input) {\n      ref.current = null;\n      return;\n    }\n\n    ref.current = resolveInputRef(input.input) as unknown as InputRef;\n  }, []);\n\n  useEffect(() => {\n    if (isServer || !ref.current) return;\n\n    if (!isHTMLElement(ref.current)) {\n      return;\n    }\n\n    const inputElement = findInputElement(ref.current);\n\n    if (maskInput && inputElement && isHTMLElement(inputElement)) {\n      maskInput.mask(inputElement);\n    }\n\n    if (register && isHTMLElement(ref.current)) {\n      register(ref.current);\n    }\n  }, [mask, register, options, maskInput]);\n\n  if (isServer) {\n    return (): void => {\n      // server doesn't have dom, so just do nothing\n    };\n  }\n\n  return refCallback;\n}\n"]}
+{"version":3,"sources":["../src/antd/useHookFormMaskAntd.ts","../src/antd/useMaskInputAntd.ts"],"names":["useMemo"],"mappings":"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","file":"antd.js","sourcesContent":["import { useMemo } from 'react';\n\nimport { applyMaskToElement, resolveInputRef } from '../core';\nimport { makeMaskCacheKey, setPrevRef } from '../utils';\n\nimport type { InputRef } from 'antd';\nimport type { RefCallback } from 'react';\nimport type {\n  FieldValues, Path,\n  RegisterOptions,\n  UseFormRegister,\n} from 'react-hook-form';\n\nimport type { Mask, Options, UseHookFormMaskReturn } from '../types';\n\nexport type UseHookFormMaskAntdReturn<T extends FieldValues> = Omit<\n  UseHookFormMaskReturn<T>,\n  'ref'\n> & { ref: RefCallback<InputRef | null> };\n\n/**\n * Ant Design version of useHookFormMask.\n * Creates a masked register that works with Ant Design Input (ref receives InputRef).\n *\n * @template T - The form data type\n * @template D - The register options type\n * @param registerFn - The register function from useForm hook\n * @returns A function that registers a field with mask support for Ant Design Input\n */\nexport default function useHookFormMaskAntd<\n  T extends FieldValues, D extends RegisterOptions,\n>(registerFn: UseFormRegister<T>): ((fieldName: Path<T>, mask: Mask, options?: (\n  D & Options) | Options | D) => UseHookFormMaskAntdReturn<T>) {\n  //\n  return useMemo(() => {\n    const refCache = new Map<string, RefCallback<InputRef | null>>();\n\n    return (fieldName: Path<T>, mask: Mask, options?: (\n      D & Options) | Options | D): UseHookFormMaskAntdReturn<T> => {\n      if (!registerFn) throw new Error('registerFn is required');\n\n      const registerReturn = registerFn(fieldName, options as Options);\n      const { ref } = registerReturn as UseHookFormMaskReturn<T>;\n\n      const cacheKey = makeMaskCacheKey(fieldName, mask);\n\n      if (!refCache.has(cacheKey)) {\n        const refWithMask: RefCallback<InputRef | null> = (inputRef) => {\n          const element = inputRef ? resolveInputRef(inputRef.input) : null;\n          if (element) applyMaskToElement(element, mask, options as Options);\n          if (ref) ref(element);\n        };\n        refCache.set(cacheKey, refWithMask);\n      }\n\n      const result = {\n        ...registerReturn,\n        ref: refCache.get(cacheKey),\n      } as UseHookFormMaskAntdReturn<T>;\n\n      setPrevRef(result, ref);\n\n      return result;\n    };\n  }, [registerFn]);\n}\n","import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport {\n  createMaskInstance, findInputElement, isHTMLElement, resolveInputRef,\n} from '../core';\nimport isServer from '../utils/isServer';\n\nimport type { InputRef } from 'antd';\n\nimport type { Mask, Options } from '../types';\n\ninterface UseMaskInputOptions {\n  mask: Mask;\n  register?: (element: HTMLElement) => void;\n  options?: Options;\n}\n\n/**\n * React hook for applying input masks to form elements.\n * Works with Ant Design and other wrapped components too.\n *\n * @param props - Configuration object\n * @param props.mask - The mask pattern to apply\n * @param props.register - Optional callback that receives the element\n * @param props.options - Optional mask configuration options\n * @returns A ref callback function to attach to the input element\n */\nexport default function useMaskInputAntd(props: UseMaskInputOptions): (\n  input: InputRef | null\n) => void {\n  const { mask, register, options } = props;\n  const ref = useRef<InputRef | null>(null);\n  const maskInput = useMemo(\n    () => (isServer ? null : createMaskInstance(mask, options)),\n    [mask, options],\n  );\n\n  const refCallback = useCallback((input: InputRef | null) => {\n    if (!input) {\n      ref.current = null;\n      return;\n    }\n\n    ref.current = resolveInputRef(input.input) as unknown as InputRef;\n  }, []);\n\n  useEffect(() => {\n    if (isServer || !ref.current) return;\n\n    if (!isHTMLElement(ref.current)) {\n      return;\n    }\n\n    const inputElement = findInputElement(ref.current);\n\n    if (maskInput && inputElement && isHTMLElement(inputElement)) {\n      maskInput.mask(inputElement);\n    }\n\n    if (register && isHTMLElement(ref.current)) {\n      register(ref.current);\n    }\n  }, [mask, register, options, maskInput]);\n\n  if (isServer) {\n    return (): void => {\n      // server doesn't have dom, so just do nothing\n    };\n  }\n\n  return refCallback;\n}\n"]}

package/dist/{chunk-JGOZSJMW.js → chunk-FDD3PKBM.js}

@@ -3736,6 +3736,7 @@ var ALIAS_MASKS = {
     placeholder: "0,00",
     displayFormat: "currency",
     radixPoint: ",",
+    groupSeparator: ".",
     autoUnmask: true
   },
   cpf: { mask: "999.999.999-99", placeholder: "___.___.___-__" },
@@ -3795,6 +3796,19 @@ function interopDefaultSync(module) {
   return module;
 }
 
+// src/utils/maskHelpers.ts
+function makeMaskCacheKey(fieldName, mask) {
+  return `${fieldName}:${Array.isArray(mask) ? mask.join(",") : String(mask)}`;
+}
+function setPrevRef(result, ref) {
+  Object.defineProperty(result, "prevRef", {
+    value: ref,
+    enumerable: false,
+    writable: true,
+    configurable: true
+  });
+}
+
 // src/core/maskEngine.ts
 var import_inputmask = __toESM(require_inputmask(), 1);
 function createMaskInstance(mask, options) {
@@ -3824,6 +3838,6 @@ inputmask/dist/inputmask.js:
   (*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE *)
 */
 
-export { __toESM, applyMaskToElement, createMaskInstance, findInputElement, flow, getMaskOptions, interopDefaultSync, isHTMLElement, isServer_default, require_inputmask, resolveInputRef };
-//# sourceMappingURL=chunk-JGOZSJMW.js.map
-//# sourceMappingURL=chunk-JGOZSJMW.js.map
+export { __toESM, applyMaskToElement, createMaskInstance, findInputElement, flow, getMaskOptions, interopDefaultSync, isHTMLElement, isServer_default, makeMaskCacheKey, require_inputmask, resolveInputRef, setPrevRef };
+//# sourceMappingURL=chunk-FDD3PKBM.js.map
+//# sourceMappingURL=chunk-FDD3PKBM.js.map