@primereact/hooks 11.0.0-alpha.4 → 11.0.0-alpha.5

package/index.d.ts

@@ -2,6 +2,8 @@ export * from './use-attr-selector';
 export * from './use-controlled-state';
 export * from './use-event-listener';
 export * from './use-id';
+export * from './use-key-filter';
+export * from './use-mask';
 export * from './use-match-media';
 export * from './use-mount-effect';
 export * from './use-previous';

package/index.mjs

@@ -1,2 +1,2 @@
-var h=Object.defineProperty;var b=Object.getOwnPropertySymbols;var A=Object.prototype.hasOwnProperty,H=Object.prototype.propertyIsEnumerable;var M=(e,t,n)=>t in e?h(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,y=(e,t)=>{for(var n in t||(t={}))A.call(t,n)&&M(e,n,t[n]);if(b)for(var n of b(t))H.call(t,n)&&M(e,n,t[n]);return e};import*as T from"react";function _(e=""){let t=T.useId();return T.useMemo(()=>`${e}${t.replaceAll(/:|«|»/g,"")}`.trim().toLowerCase(),[t,e])}import{resolve as $}from"@primeuix/utils";import*as v from"react";function j({value:e,defaultValue:t,onChange:n}){let[r,o]=v.useState(t!=null?t:e),s=e!==void 0,u=s?e:r,f=v.useCallback(a=>{let[d,i]=$(a,u,s);n==null||n(i),s||o(d)},[u,s,n]);return[u,f,s]}import{getTargetElement as U,isNotEmpty as I}from"@primeuix/utils";import*as c from"react";import*as g from"react";function P(e){let t=g.useRef(null);return g.useEffect(()=>(t.current=e,()=>{t.current=null}),[e]),t.current}function G({target:e="document",type:t,listener:n,options:r,when:o=!0}){let s=c.useRef(null),u=c.useRef(null),f=P(n),a=P(r),d=(l={})=>{let{target:R}=l;I(R)&&(i(),(l.when||o)&&(s.current=U(R))),!u.current&&s.current&&(u.current=E=>n&&n(E),s.current.addEventListener(t,u.current,r))},i=()=>{var l;u.current&&((l=s.current)==null||l.removeEventListener(t,u.current,r),u.current=null)},k=()=>{i(),f=null,a=null},w=c.useCallback(()=>{o?s.current=U(e):(i(),s.current=null)},[e,o]);return c.useEffect(()=>()=>{k()},[]),c.useEffect(()=>{w()},[w]),c.useEffect(()=>{let l=`${f}`!=`${n}`,R=a!==r,E=u.current;E&&(l||R)?(i(),o&&d()):E||k()},[n,r,o]),[d,i]}import*as p from"react";function K(e){let t=p.useId(),[n,r]=p.useState(e||`pr_id_${t.replaceAll(/:|«|»/g,"")}`);return p.useEffect(()=>{r(e||`pr_id_${t.replaceAll(/:|«|»/g,"")}`)},[e,t]),n}import*as m from"react";function X(e,t=!0){let[n,r]=m.useState(!1),o=m.useRef(null),s=a=>r(a.matches),u=()=>{var a;return(a=o.current)==null?void 0:a.addEventListener("change",s)},f=()=>{var a;return((a=o.current)==null?void 0:a.removeEventListener("change",s))&&(o.current=null)};return m.useEffect(()=>(t&&(o.current=window.matchMedia(e),r(o.current.matches),u()),()=>{f()}),[e,t]),n}import*as L from"react";function Z(e){let t=L.useRef(!1);L.useEffect(()=>{t.current||(t.current=!0,e==null||e())},[])}import*as C from"react";function ee(e={},t={}){return C.useMemo(()=>{let n={props:y({},t),attrs:{}};return Object.entries(e).forEach(([r,o])=>{r in t?n.props[r]=o:n.attrs[r]=o}),n},[e,t])}import*as O from"react";function re(e){O.useEffect(()=>()=>{e==null||e()},[])}import*as x from"react";function se(e,t){let n=x.useRef(!1);x.useEffect(()=>{if(!n.current){n.current=!0;return}return e==null?void 0:e()},t)}import*as S from"react";function ae(){return S.useCallback(t=>{document.startViewTransition?document.startViewTransition(()=>{t()}):t()},[])}export{_ as useAttrSelector,j as useControlledState,G as useEventListener,K as useId,X as useMatchMedia,Z as useMountEffect,P as usePrevious,ee as useProps,re as useUnmountEffect,se as useUpdateEffect,ae as useViewTransition};
+var ve=Object.defineProperty;var W=Object.getOwnPropertySymbols;var be=Object.prototype.hasOwnProperty,Te=Object.prototype.propertyIsEnumerable;var X=(u,s,c)=>s in u?ve(u,s,{enumerable:!0,configurable:!0,writable:!0,value:c}):u[s]=c,Y=(u,s)=>{for(var c in s||(s={}))be.call(s,c)&&X(u,c,s[c]);if(W)for(var c of W(s))Te.call(s,c)&&X(u,c,s[c]);return u};import*as S from"react";function xe(u=""){let s=S.useId();return S.useMemo(()=>`${u}${s.replaceAll(/:|«|»/g,"")}`.trim().toLowerCase(),[s,u])}import{resolve as Me}from"@primeuix/utils";import*as F from"react";function He({value:u,defaultValue:s,onChange:c}){let[p,m]=F.useState(s!=null?s:u),d=u!==void 0,R=d?u:p,o=F.useCallback(l=>{let[f,a]=Me(l,R,d);c==null||c(a),d||m(f)},[R,d,c]);return[R,o,d]}import{getTargetElement as ee,isNotEmpty as he}from"@primeuix/utils";import*as L from"react";import*as D from"react";function N(u){let s=D.useRef(null);return D.useEffect(()=>(s.current=u,()=>{s.current=null}),[u]),s.current}function Ue({target:u="document",type:s,listener:c,options:p,when:m=!0}){let d=L.useRef(null),R=L.useRef(null),o=N(c),l=N(p),f=(v={})=>{let{target:I}=v;he(I)&&(a(),(v.when||m)&&(d.current=ee(I))),!R.current&&d.current&&(R.current=h=>c&&c(h),d.current.addEventListener(s,R.current,p))},a=()=>{var v;R.current&&((v=d.current)==null||v.removeEventListener(s,R.current,p),R.current=null)},g=()=>{a(),o=null,l=null},b=L.useCallback(()=>{m?d.current=ee(u):(a(),d.current=null)},[u,m]);return L.useEffect(()=>()=>{g()},[]),L.useEffect(()=>{b()},[b]),L.useEffect(()=>{let v=`${o}`!=`${c}`,I=l!==p,h=R.current;h&&(v||I)?(a(),m&&f()):h||g()},[c,p,m]),[f,a]}import*as K from"react";function Oe(u){let s=K.useId(),[c,p]=K.useState(u||`pr_id_${s.replaceAll(/:|«|»/g,"")}`);return K.useEffect(()=>{p(u||`pr_id_${s.replaceAll(/:|«|»/g,"")}`)},[u,s]),c}import{isAndroid as te}from"@primeuix/utils";function De(u){let{pattern:s=/./,validateOnly:c=!1}=u,p={pint:/[\d]/,int:/[\d-]/,pnum:/[\d.]/,money:/[\d.\s,]/,num:/[\d-.]/,hex:/[0-9a-f]/i,email:/[a-z0-9_.-@]/i,alpha:/[a-z_]/i,alphanum:/[a-z0-9_]/},m=()=>typeof s=="string"?p[s]:s,d=a=>{c||!te()||l(a,a.data)},R=a=>{c||te()||a.ctrlKey||a.altKey||a.metaKey||l(a,a.key)},o=a=>{if(c)return;let g=m();[...a.clipboardData.getData("text")].forEach(v=>{if(!g.test(v))return a.preventDefault(),!1})},l=(a,g)=>{if(g==null||!(g.length<=2))return;m().test(g)||a.preventDefault()};return{onBeforeInput:d,onKeyPress:R,onPaste:o,validate:a=>{let g=a.target.value,b=!0,v=m();return g&&!v.test(g)&&(b=!1),b}}}import{useMountEffect as Le}from"@primereact/hooks";import{getUserAgent as $}from"@primeuix/utils";import*as T from"react";function je(u){let{mask:s,unmask:c,slotChar:p="_",autoClear:m=!0,readOnly:d=!1,onMaskChange:R,target:o}=u,l=T.useRef(0),f=T.useRef([]),a=T.useRef([]),g=T.useRef(null),b=T.useRef(0),v=T.useRef(!1),I=T.useRef(!1),h=T.useRef(null),C=T.useRef(null),ue=T.useRef(0),_=T.useRef(null),A=T.useRef(null),z=T.useRef(null),oe=e=>{"isComposing"in e&&e.isComposing||(v.current?de():Q(e))},ae=e=>{var y;if(d)return;let t=e.code,r,n,i,E=/iphone/i.test($());if(A.current=o==null?void 0:o.value,t==="Backspace"||t==="Delete"||E&&t==="Escape"){if(r=M(),!r)return;n=r.begin,i=r.end,i-n===0&&(n=t!=="Delete"?pe(n):i=H(n-1),i=t==="Delete"?H(i):i),O(n,i),J(n,i-1),x(e.target.value),e.preventDefault()}else t==="Enter"?(o.blur(),x(e.target.value)):t==="Escape"&&(o&&(o.value=(y=h.current)!=null?y:""),M(0,k()),x(e.target.value),e.preventDefault())},ce=e=>{var y;if(d)return;let t=e.code,r=M(),n,i,E;r&&(e.ctrlKey||e.altKey||e.metaKey||e.shiftKey||e.key==="CapsLock"||e.key==="Escape"||e.key==="Tab"||(t&&t!=="Enter"&&(r.end-r.begin!==0&&(O(r.begin,r.end),J(r.begin,r.end-1)),n=H(r.begin-1),n<l.current&&(i=e.key,(y=f.current[n])!=null&&y.test(i)&&(me(n),a.current[n]=i,P(),E=H(n),/android/i.test($())?setTimeout(()=>{M(E)},0):M(E))),e.preventDefault()),x(e.target.value)))},ie=()=>{if(!d)if(_.current&&clearTimeout(_.current),I.current=!0,h.current=o.value,!o.value||o.value===g.current)requestAnimationFrame(()=>{o===document.activeElement&&M(0,0)});else{let e=k();_.current=setTimeout(()=>{o===document.activeElement&&(P(),e===(s==null?void 0:s.replace("?","").length)?M(0,e):M(e))},10)}},le=e=>{if(I.current=!1,k(),x(e.target.value),o.value!==h.current){let t=new Event("change",{bubbles:!0,cancelable:!1});o.dispatchEvent(t)}},fe=e=>{Q(e)},M=(e,t)=>{var i,E;let r=0,n=0;return typeof e=="number"?(r=e,n=typeof t=="number"?t:r,o.setSelectionRange(r,n)):o&&(r=(i=o.selectionStart)!=null?i:0,n=(E=o.selectionEnd)!=null?E:0),{begin:r,end:n}},w=e=>e<p.length?p.charAt(e):p.charAt(0),H=e=>{for(;++e<l.current&&!f.current[e];);return e},pe=e=>{for(;--e>=0&&!f.current[e];);return e},J=(e,t)=>{var i,E;let r,n;if(!(e<0)){for(r=e,n=H(t);r<l.current;r++)if(f.current[r]){if(n<l.current&&((i=f.current[r])!=null&&i.test(a.current[n])))a.current[r]=a.current[n],a.current[n]=w(n);else break;n=H(n)}P(),M(Math.max((E=C.current)!=null?E:0,e))}},me=e=>{var E;let t,r,n,i;for(t=e,r=w(e);t<l.current;t++)if(f.current[t])if(n=H(t),i=a.current[t],a.current[t]=r,n<l.current&&((E=f.current[n])!=null&&E.test(i)))r=i;else break},de=()=>{var r;let e=o.value,t=M();if(t)if(A.current&&A.current.length&&A.current.length>e.length){for(k(!0);t.begin>0&&!f.current[t.begin-1];)t.begin--;if(t.begin===0)for(;t.begin<((r=C.current)!=null?r:0)&&!f.current[t.begin];)t.begin++;M(t.begin,t.begin)}else{for(k(!0);t.begin<l.current&&!f.current[t.begin];)t.begin++;M(t.begin,t.begin)}},O=(e,t)=>{let r;for(r=e;r<t&&r<l.current;r++)f.current[r]&&(a.current[r]=w(r))},P=()=>{o&&(o.value=a.current.join(""))},k=(e=!1)=>{var y,j,Z,q;let t=o.value,r=-1,n,i,E;for(n=0,E=0;n<l.current;n++){let G=f.current[n];if(G!==null){for(a.current[n]=w(n);E++<((y=t==null?void 0:t.length)!=null?y:0);)if(i=(j=t==null?void 0:t.charAt(E-1))!=null?j:"",G.test(i)){a.current[n]=i,r=n;break}if(E>((Z=t==null?void 0:t.length)!=null?Z:0)){O(n+1,l.current);break}}else a.current[n]===(t==null?void 0:t.charAt(E))&&E++,n<b.current&&(r=n)}return e?P():r+1<b.current?m||a.current.join("")===g.current?(o.value&&(o.value=""),O(0,l.current)):P():(P(),o&&(o.value=o.value.substring(0,r+1))),b.current?n:(q=C.current)!=null?q:0},Q=e=>{let t=e.type==="paste";if(d||t)return;let r=k(!0);M(r),x(e.target.value)},Ee=e=>{let t=[],r=e.split("");for(let n=0;n<r.length;n++){let i=r[n];f.current[n]&&i!==w(n)&&t.push(i)}return t.join("")},x=e=>{if(z.current===e)return;let t=c?Ee(e):e,r=g.current!==t?t:"";z.current=e,o&&(o.value=r),R&&R({value:r})},Re=(e=!0)=>{o&&(o.value==null?(o.value="",e&&x("")):(k(),setTimeout(()=>{o&&(P(),k(),e&&x(o.value))},10)),h.current=o.value)},ge=()=>{f.current=[],b.current=s?s.length:0,l.current=s?s.length:0,C.current=null;let e={9:"[0-9]",a:"[A-Za-z]","*":"[A-Za-z0-9]"},t=$();v.current=/chrome/i.test(t)&&/android/i.test(t);let r=s?s.split(""):"";for(let n=0;n<r.length;n++){let i=r[n];i==="?"?(l.current--,b.current=n):e[i]?(f.current.push(new RegExp(e[i])),C.current===null&&(C.current=f.current.length-1),n<b.current&&(ue.current=f.current.length-1)):f.current.push(null)}a.current=[];for(let n=0;n<r.length;n++){let i=r[n];i!=="?"&&(e[i]?a.current.push(w(n)):a.current.push(i))}g.current=a.current.join(""),Re(!1)};return Le(()=>{ge()}),{onMaskInput:oe,onMaskKeyDown:ae,onMaskKeyPress:ce,onMaskFocus:ie,onMaskBlur:le,onMaskPaste:fe}}import*as U from"react";function $e(u,s=!0){let[c,p]=U.useState(!1),m=U.useRef(null),d=l=>p(l.matches),R=()=>{var l;return(l=m.current)==null?void 0:l.addEventListener("change",d)},o=()=>{var l;return((l=m.current)==null?void 0:l.removeEventListener("change",d))&&(m.current=null)};return U.useEffect(()=>(s&&(m.current=window.matchMedia(u),p(m.current.matches),R()),()=>{o()}),[u,s]),c}import*as V from"react";function Je(u){let s=V.useRef(!1);V.useEffect(()=>{s.current||(s.current=!0,u==null||u())},[])}import*as ne from"react";function Ze(u={},s={}){return ne.useMemo(()=>{let c={props:Y({},s),attrs:{}};return Object.entries(u).forEach(([p,m])=>{p in s?c.props[p]=m:c.attrs[p]=m}),c},[u,s])}import*as re from"react";function We(u){re.useEffect(()=>()=>{u==null||u()},[])}import*as B from"react";function Ye(u,s){let c=B.useRef(!1);B.useEffect(()=>{if(!c.current){c.current=!0;return}return u==null?void 0:u()},s)}import*as se from"react";function tt(){return se.useCallback(s=>{document.startViewTransition?document.startViewTransition(()=>{s()}):s()},[])}export{xe as useAttrSelector,He as useControlledState,Ue as useEventListener,Oe as useId,De as useKeyFilter,je as useMask,$e as useMatchMedia,Je as useMountEffect,N as usePrevious,Ze as useProps,We as useUnmountEffect,Ye as useUpdateEffect,tt as useViewTransition};
 //# sourceMappingURL=index.mjs.map

package/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/use-attr-selector/index.ts","../src/use-controlled-state/index.ts","../src/use-event-listener/index.ts","../src/use-previous/index.ts","../src/use-id/index.ts","../src/use-match-media/index.ts","../src/use-mount-effect/index.ts","../src/use-props/index.ts","../src/use-unmount-effect/index.ts","../src/use-update-effect/index.ts","../src/use-view-transition/index.ts"],"sourcesContent":["import * as React from 'react';\n\n/**\n * Generates a unique attribute selector based on the provided prefix.\n *\n * @param prefix - The prefix to prepend to the generated selector.\n * @returns A unique string combining the prefix and the selector.\n *\n * @example\n * ```ts\n * const selector = useAttrSelector('foo');\n * console.log(selector); // e.g., 'foo0'\n * ```\n */\nexport function useAttrSelector(prefix: string = ''): string {\n    const id = React.useId();\n\n    return React.useMemo(() => `${prefix}${id.replaceAll(/:|«|»/g, '')}`.trim().toLowerCase(), [id, prefix]);\n}\n","import { resolve } from '@primeuix/utils';\nimport * as React from 'react';\n\n/**\n * The options for the `useControlledState` hook.\n */\nexport interface UseControlledStateOptions<T = unknown, E = unknown> {\n    /**\n     * The value of the controlled state.\n     */\n    value?: T | undefined;\n    /**\n     * The default value of the uncontrolled state.\n     */\n    defaultValue?: T | undefined;\n    /**\n     * Callback function that is called when the value changes.\n     */\n    onChange?: (newValue: E) => void;\n}\n\n/**\n * The return type of the `useControlledState` hook.\n * A tuple containing the current value and a function to update it.\n */\nexport type UseControlledStateReturnType<T = unknown> = [T | undefined, (inValue: unknown | ((prev?: T) => unknown)) => void, boolean];\n\n/**\n * A custom hook that manages controlled and uncontrolled state.\n *\n * @param {UseControlledStateOptions} options - The options for the controlled state.\n * @returns A tuple containing the current value and a function to update it.\n *\n * @example\n * ```tsx\n * const ControlledComponent = () => {\n *    const [controlledValue, setControlledValue] = React.useState('');\n *\n *    const [value, setValue] = useControlledState({\n *        value: controlledValue,\n *        defaultValue: 'initial value',\n *        onChange: (newValue) => {\n *           setControlledValue(newValue);\n *        }\n *    });\n *\n *   return <Component value={value} onChange={(e) => setValue(e.target.value)} />;\n * };\n * ```\n */\nexport function useControlledState<T = unknown, E = T>({ value, defaultValue, onChange }: UseControlledStateOptions<T, E>): UseControlledStateReturnType<T | undefined> {\n    const [valueState, setValueState] = React.useState<T | undefined>(defaultValue ?? value);\n\n    const isControlled = value !== undefined;\n    const computedValue = isControlled ? (value as T) : valueState;\n\n    const setValue = React.useCallback(\n        (inValue: unknown | ((prev?: T) => unknown)) => {\n            // @todo - update resolve to accept multiple parameters\n            const [newValue, onChangeParam] = resolve(inValue, computedValue, isControlled) as [T, E];\n\n            onChange?.(onChangeParam);\n\n            if (!isControlled) {\n                setValueState(newValue);\n            }\n        },\n        [computedValue, isControlled, onChange]\n    );\n\n    return [computedValue, setValue, isControlled];\n}\n","import { getTargetElement, isNotEmpty } from '@primeuix/utils';\nimport * as React from 'react';\nimport { usePrevious } from '../use-previous';\n\n/**\n * The options for the `useEventListener` hook.\n */\nexport interface UseEventListenerOptions<T = keyof HTMLElementEventMap> {\n    /**\n     * The target element to bind the event listener to.\n     * @default 'document'\n     */\n    target?: 'document' | 'window' | 'body' | HTMLElement | (() => HTMLElement) | React.Ref<HTMLElement> | string | null;\n    /**\n     * The event type to listen for.\n     */\n    type: T | string;\n    /**\n     * The event listener callback.\n     */\n    listener: EventListener;\n    /**\n     * The event listener options\n     */\n    options?: AddEventListenerOptions | boolean;\n    /**\n     * A boolean indicating whether the event listener should be active.\n     */\n    when?: boolean;\n}\n\n/**\n * The return type of the `useEventListener` hook.\n * A tuple containing functions;\n * 1. `bind` function is used to bind the event listener.\n * 2. `unbind` function is used to unbind the event listener.\n */\nexport type UseEventListenerReturnType = [(options?: Partial<Omit<UseEventListenerOptions, 'target'>> & { target?: UseEventListenerOptions['target'] | Document | null }) => void, () => void];\n\n/**\n * Listens for the specified event type on the target element.\n *\n * @param {UseEventListenerOptions} options - The options for the event listener.\n * @returns A tuple containing functions;\n * 1. `bind` function is used to bind the event listener.\n * 2. `unbind` function is used to unbind the event listener.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const [bind, unbind] = useEventListener({\n *         target: 'document',\n *         type: 'click',\n *         listener: (event) => {\n *             console.log(event);\n *         },\n *         when: true\n *     });\n *\n *     return <div>Click me</div>;\n * };\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const [bind, unbind] = useEventListener({\n *         target: () => document.querySelector('.element'),\n *         type: 'mouseover',\n *         listener: (event) => {\n *             console.log(event);\n *         }\n *     });\n *\n *     return <div>MouseOver to `.element`</div>;\n * };\n * ```\n */\nexport function useEventListener({ target = 'document', type, listener, options, when = true }: UseEventListenerOptions): UseEventListenerReturnType {\n    const targetRef = React.useRef<HTMLElement | null>(null);\n    const listenerRef = React.useRef<EventListener | null>(null);\n    let prevListener = usePrevious(listener);\n    let prevOptions = usePrevious(options);\n\n    const bind = (bindOptions: Partial<Omit<UseEventListenerOptions, 'target'>> & { target?: UseEventListenerOptions['target'] | Document | null } = {}) => {\n        const { target: bindTarget } = bindOptions;\n\n        if (isNotEmpty(bindTarget)) {\n            unbind();\n\n            if (bindOptions.when || when) {\n                targetRef.current = getTargetElement(bindTarget) as HTMLElement;\n            }\n        }\n\n        if (!listenerRef.current && targetRef.current) {\n            listenerRef.current = (event: Event) => listener && listener(event);\n            targetRef.current.addEventListener(type, listenerRef.current, options);\n        }\n    };\n\n    const unbind = () => {\n        if (listenerRef.current) {\n            targetRef.current?.removeEventListener(type, listenerRef.current, options);\n            listenerRef.current = null;\n        }\n    };\n\n    const dispose = () => {\n        unbind();\n        // Prevent memory leak by releasing\n        prevListener = null;\n        prevOptions = null;\n    };\n\n    const updateTarget = React.useCallback(() => {\n        if (when) {\n            targetRef.current = getTargetElement(target) as HTMLElement;\n        } else {\n            unbind();\n            targetRef.current = null;\n        }\n    }, [target, when]);\n\n    React.useEffect(() => {\n        return () => {\n            dispose();\n        };\n    }, []);\n\n    React.useEffect(() => {\n        updateTarget();\n    }, [updateTarget]);\n\n    React.useEffect(() => {\n        const listenerChanged = `${prevListener}` !== `${listener}`;\n        const optionsChanged = prevOptions !== options;\n        const listenerExists = listenerRef.current;\n\n        if (listenerExists && (listenerChanged || optionsChanged)) {\n            unbind();\n\n            if (when) {\n                bind();\n            }\n        } else if (!listenerExists) {\n            dispose();\n        }\n    }, [listener, options, when]);\n\n    return [bind, unbind];\n}\n","import * as React from 'react';\n\n/**\n * Returns the previous value of the provided value.\n *\n * @param value - The value to track.\n * @returns The previous value of the provided value.\n *\n * @example\n * ```tsx\n * const [count, setCount] = React.useState(5);\n * const prevCount = usePrevious(count);\n *\n * console.log(prevCount); // undefined\n *\n * setCount(10);\n *\n * console.log(prevCount); // 5\n * ```\n */\nexport function usePrevious<T>(value: T): T | null | undefined {\n    const ref = React.useRef<T | null>(null);\n\n    React.useEffect(() => {\n        ref.current = value;\n\n        return () => {\n            ref.current = null;\n        };\n    }, [value]);\n\n    return ref.current;\n}\n","import * as React from 'react';\n\n/**\n * Generates a unique identifier.\n *\n * @param initialValue Optional initial value for the ID.\n * @returns The generated or provided ID.\n *\n * @example\n * ```tsx\n * const id = useId('foo');\n * console.log(id); // 'foo'\n * ```\n *\n * @example\n * ```tsx\n * const defaultId = useId();\n * console.log(defaultId); // e.g., 'pr_id_0'\n * ```\n */\nexport function useId(initialValue?: string): string {\n    const idx = React.useId();\n    const [idState, setIdState] = React.useState<string>(initialValue || `pr_id_${idx.replaceAll(/:|«|»/g, '')}`);\n\n    React.useEffect(() => {\n        setIdState(initialValue || `pr_id_${idx.replaceAll(/:|«|»/g, '')}`);\n    }, [initialValue, idx]);\n\n    return idState;\n}\n","import * as React from 'react';\n\n/**\n * Listens for the specified media query.\n *\n * @param query - The media query to match.\n * @param when - A boolean indicating whether the media query should be active.\n * @returns A boolean indicating whether the media query matches.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const isMobile = useMatchMedia('(max-width: 768px)');\n *\n *     return <div>{isMobile ? 'Mobile' : 'Desktop'}</div>;\n * };\n */\nexport function useMatchMedia(query: string, when: boolean = true): boolean {\n    const [matches, setMatches] = React.useState(false);\n    const matchMedia = React.useRef<MediaQueryList | null>(null);\n\n    const handleChange = (event: MediaQueryListEvent) => setMatches(event.matches);\n    const bind = () => matchMedia.current?.addEventListener('change', handleChange);\n    const unbind = () => matchMedia.current?.removeEventListener('change', handleChange) && (matchMedia.current = null);\n\n    React.useEffect(() => {\n        if (when) {\n            matchMedia.current = window.matchMedia(query);\n            setMatches(matchMedia.current.matches);\n\n            bind();\n        }\n\n        return () => {\n            unbind();\n        };\n    }, [query, when]);\n\n    return matches;\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs a mount effect only once.\n * This is similar to `useEffect`, but it only runs on mount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @returns {void}\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *     useMountEffect(() => {\n *         console.log('Mounted');\n *     });\n * };\n * ```\n */\nexport function useMountEffect(effect: React.EffectCallback): void {\n    const mounted = React.useRef<boolean>(false);\n\n    React.useEffect(() => {\n        if (!mounted.current) {\n            mounted.current = true;\n\n            effect?.();\n        }\n    }, []);\n}\n","import * as React from 'react';\n\n/**\n * Used to merge and differentiate incoming props with the default props.\n * - Keys that exist in both `props1` and `props2` are placed in `props`, with values from `props1`.\n * - Keys that exist in `props1` but not in `props2` are placed in `attrs`.\n *\n * @template P1 The type of the incoming set of props.\n * @template P2 The type of the default set of props.\n *\n * @param props1 The incoming set of props (e.g., user-defined or dynamic props).\n * @param props2 The default set of props (e.g., default props).\n * @returns An object containing:\n *   - `props`: A new object containing keys that exist in both `props1` and `props2`, using values from `props1`.\n *   - `attrs`: A new object containing keys that exist only in `props1`, excluding any keys from `props2`.\n *\n * @example\n * ```ts\n * const { props, attrs } = useProps({ id: 'foo', className: 'bar' }, { className: 'baz' });\n *\n * console.log(props); // { className: 'bar' }\n * console.log(attrs); // { id: 'foo' }\n * ```\n */\nexport function useProps<P1, P2>(props1: P1 = {} as P1, props2: P2 = {} as P2) {\n    type Props = Pick<P1 & P2, keyof P2>;\n    type Attrs = Omit<P1, keyof P2>;\n    type Result = { props: Props; attrs: Attrs };\n\n    return React.useMemo(() => {\n        const result: Result = { props: { ...props2 } as Props, attrs: {} as Attrs };\n\n        Object.entries(props1 as Record<string, unknown>).forEach(([key, value]) => {\n            if (key in (props2 as Record<string, unknown>)) {\n                (result.props as Record<string, unknown>)[key] = value;\n            } else {\n                (result.attrs as Record<string, unknown>)[key] = value;\n            }\n        });\n\n        return result;\n    }, [props1, props2]);\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs an unmount effect only once.\n * This is similar to `useEffect`, but it only runs on unmount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @returns {void}\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     useUnmountEffect(() => {\n *         console.log('Unmounted');\n *     });\n * };\n * ```\n */\nexport function useUnmountEffect(effect: React.EffectCallback): void {\n    React.useEffect(() => {\n        return () => {\n            effect?.();\n        };\n    }, []);\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs an update effect whenever dependencies change.\n * This is similar to `useEffect`, but it does not run on mount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @param {React.DependencyList} dependencies the dependencies\n * @returns {void}\n *\n * @example\n * ```tsx\n * const Component = ({ value }) => {\n *     useUpdateEffect(() => {\n *         console.log('Updated');\n *     }, [value]);\n * };\n * ```\n */\nexport function useUpdateEffect(effect: React.EffectCallback, dependencies?: React.DependencyList): void {\n    const mounted = React.useRef<boolean>(false);\n\n    React.useEffect(() => {\n        if (!mounted.current) {\n            mounted.current = true;\n\n            return;\n        }\n\n        return effect?.();\n    }, dependencies);\n}\n","import * as React from 'react';\n\n/**\n * Starts a view transition.\n *\n * @returns A function that starts a view transition.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const startTransition = useViewTransition();\n *\n *     const handleClick = () => {\n *         startTransition(() => {\n *             // Perform some work\n *         });\n *     };\n *\n *     return <button onClick={handleClick}>Click me</button>;\n * };\n */\nexport function useViewTransition() {\n    const startTransition = React.useCallback((callback: () => void) => {\n        if (document.startViewTransition) {\n            document.startViewTransition(() => {\n                callback();\n            });\n        } else {\n            callback();\n        }\n    }, []);\n\n    return startTransition;\n}\n"],"mappings":"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","names":["React","useAttrSelector","prefix","id","resolve","React","useControlledState","value","defaultValue","onChange","valueState","setValueState","isControlled","computedValue","setValue","inValue","newValue","onChangeParam","getTargetElement","isNotEmpty","React","React","usePrevious","value","ref","useEventListener","target","type","listener","options","when","targetRef","listenerRef","prevListener","usePrevious","prevOptions","bind","bindOptions","bindTarget","isNotEmpty","unbind","getTargetElement","event","_a","dispose","updateTarget","listenerChanged","optionsChanged","listenerExists","React","useId","initialValue","idx","idState","setIdState","React","useMatchMedia","query","when","matches","setMatches","matchMedia","handleChange","event","bind","_a","unbind","React","useMountEffect","effect","mounted","React","useProps","props1","props2","result","__spreadValues","key","value","React","useUnmountEffect","effect","React","useUpdateEffect","effect","dependencies","mounted","React","useViewTransition","callback"]}
+{"version":3,"sources":["../src/use-attr-selector/index.ts","../src/use-controlled-state/index.ts","../src/use-event-listener/index.ts","../src/use-previous/index.ts","../src/use-id/index.ts","../src/use-key-filter/index.ts","../src/use-mask/index.ts","../src/use-match-media/index.ts","../src/use-mount-effect/index.ts","../src/use-props/index.ts","../src/use-unmount-effect/index.ts","../src/use-update-effect/index.ts","../src/use-view-transition/index.ts"],"sourcesContent":["import * as React from 'react';\n\n/**\n * Generates a unique attribute selector based on the provided prefix.\n *\n * @param prefix - The prefix to prepend to the generated selector.\n * @returns A unique string combining the prefix and the selector.\n *\n * @example\n * ```ts\n * const selector = useAttrSelector('foo');\n * console.log(selector); // e.g., 'foo0'\n * ```\n */\nexport function useAttrSelector(prefix: string = ''): string {\n    const id = React.useId();\n\n    return React.useMemo(() => `${prefix}${id.replaceAll(/:|«|»/g, '')}`.trim().toLowerCase(), [id, prefix]);\n}\n","import { resolve } from '@primeuix/utils';\nimport * as React from 'react';\n\n/**\n * The options for the `useControlledState` hook.\n */\nexport interface UseControlledStateOptions<T = unknown, E = unknown> {\n    /**\n     * The value of the controlled state.\n     */\n    value?: T | undefined;\n    /**\n     * The default value of the uncontrolled state.\n     */\n    defaultValue?: T | undefined;\n    /**\n     * Callback function that is called when the value changes.\n     */\n    onChange?: (newValue: E) => void;\n}\n\n/**\n * The return type of the `useControlledState` hook.\n * A tuple containing the current value and a function to update it.\n */\nexport type UseControlledStateReturnType<T = unknown> = [T | undefined, (inValue: unknown | ((prev?: T) => unknown)) => void, boolean];\n\n/**\n * A custom hook that manages controlled and uncontrolled state.\n *\n * @param {UseControlledStateOptions} options - The options for the controlled state.\n * @returns A tuple containing the current value and a function to update it.\n *\n * @example\n * ```tsx\n * const ControlledComponent = () => {\n *    const [controlledValue, setControlledValue] = React.useState('');\n *\n *    const [value, setValue] = useControlledState({\n *        value: controlledValue,\n *        defaultValue: 'initial value',\n *        onChange: (newValue) => {\n *           setControlledValue(newValue);\n *        }\n *    });\n *\n *   return <Component value={value} onChange={(e) => setValue(e.target.value)} />;\n * };\n * ```\n */\nexport function useControlledState<T = unknown, E = T>({ value, defaultValue, onChange }: UseControlledStateOptions<T, E>): UseControlledStateReturnType<T | undefined> {\n    const [valueState, setValueState] = React.useState<T | undefined>(defaultValue ?? value);\n\n    const isControlled = value !== undefined;\n    const computedValue = isControlled ? (value as T) : valueState;\n\n    const setValue = React.useCallback(\n        (inValue: unknown | ((prev?: T) => unknown)) => {\n            // @todo - update resolve to accept multiple parameters\n            const [newValue, onChangeParam] = resolve(inValue, computedValue, isControlled) as [T, E];\n\n            onChange?.(onChangeParam);\n\n            if (!isControlled) {\n                setValueState(newValue);\n            }\n        },\n        [computedValue, isControlled, onChange]\n    );\n\n    return [computedValue, setValue, isControlled];\n}\n","import { getTargetElement, isNotEmpty } from '@primeuix/utils';\nimport * as React from 'react';\nimport { usePrevious } from '../use-previous';\n\n/**\n * The options for the `useEventListener` hook.\n */\nexport interface UseEventListenerOptions<T = keyof HTMLElementEventMap> {\n    /**\n     * The target element to bind the event listener to.\n     * @default 'document'\n     */\n    target?: 'document' | 'window' | 'body' | HTMLElement | (() => HTMLElement) | React.Ref<HTMLElement> | string | null;\n    /**\n     * The event type to listen for.\n     */\n    type: T | string;\n    /**\n     * The event listener callback.\n     */\n    listener: EventListener;\n    /**\n     * The event listener options\n     */\n    options?: AddEventListenerOptions | boolean;\n    /**\n     * A boolean indicating whether the event listener should be active.\n     */\n    when?: boolean;\n}\n\n/**\n * The return type of the `useEventListener` hook.\n * A tuple containing functions;\n * 1. `bind` function is used to bind the event listener.\n * 2. `unbind` function is used to unbind the event listener.\n */\nexport type UseEventListenerReturnType = [(options?: Partial<Omit<UseEventListenerOptions, 'target'>> & { target?: UseEventListenerOptions['target'] | Document | null }) => void, () => void];\n\n/**\n * Listens for the specified event type on the target element.\n *\n * @param {UseEventListenerOptions} options - The options for the event listener.\n * @returns A tuple containing functions;\n * 1. `bind` function is used to bind the event listener.\n * 2. `unbind` function is used to unbind the event listener.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const [bind, unbind] = useEventListener({\n *         target: 'document',\n *         type: 'click',\n *         listener: (event) => {\n *             console.log(event);\n *         },\n *         when: true\n *     });\n *\n *     return <div>Click me</div>;\n * };\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const [bind, unbind] = useEventListener({\n *         target: () => document.querySelector('.element'),\n *         type: 'mouseover',\n *         listener: (event) => {\n *             console.log(event);\n *         }\n *     });\n *\n *     return <div>MouseOver to `.element`</div>;\n * };\n * ```\n */\nexport function useEventListener({ target = 'document', type, listener, options, when = true }: UseEventListenerOptions): UseEventListenerReturnType {\n    const targetRef = React.useRef<HTMLElement | null>(null);\n    const listenerRef = React.useRef<EventListener | null>(null);\n    let prevListener = usePrevious(listener);\n    let prevOptions = usePrevious(options);\n\n    const bind = (bindOptions: Partial<Omit<UseEventListenerOptions, 'target'>> & { target?: UseEventListenerOptions['target'] | Document | null } = {}) => {\n        const { target: bindTarget } = bindOptions;\n\n        if (isNotEmpty(bindTarget)) {\n            unbind();\n\n            if (bindOptions.when || when) {\n                targetRef.current = getTargetElement(bindTarget) as HTMLElement;\n            }\n        }\n\n        if (!listenerRef.current && targetRef.current) {\n            listenerRef.current = (event: Event) => listener && listener(event);\n            targetRef.current.addEventListener(type, listenerRef.current, options);\n        }\n    };\n\n    const unbind = () => {\n        if (listenerRef.current) {\n            targetRef.current?.removeEventListener(type, listenerRef.current, options);\n            listenerRef.current = null;\n        }\n    };\n\n    const dispose = () => {\n        unbind();\n        // Prevent memory leak by releasing\n        prevListener = null;\n        prevOptions = null;\n    };\n\n    const updateTarget = React.useCallback(() => {\n        if (when) {\n            targetRef.current = getTargetElement(target) as HTMLElement;\n        } else {\n            unbind();\n            targetRef.current = null;\n        }\n    }, [target, when]);\n\n    React.useEffect(() => {\n        return () => {\n            dispose();\n        };\n    }, []);\n\n    React.useEffect(() => {\n        updateTarget();\n    }, [updateTarget]);\n\n    React.useEffect(() => {\n        const listenerChanged = `${prevListener}` !== `${listener}`;\n        const optionsChanged = prevOptions !== options;\n        const listenerExists = listenerRef.current;\n\n        if (listenerExists && (listenerChanged || optionsChanged)) {\n            unbind();\n\n            if (when) {\n                bind();\n            }\n        } else if (!listenerExists) {\n            dispose();\n        }\n    }, [listener, options, when]);\n\n    return [bind, unbind];\n}\n","import * as React from 'react';\n\n/**\n * Returns the previous value of the provided value.\n *\n * @param value - The value to track.\n * @returns The previous value of the provided value.\n *\n * @example\n * ```tsx\n * const [count, setCount] = React.useState(5);\n * const prevCount = usePrevious(count);\n *\n * console.log(prevCount); // undefined\n *\n * setCount(10);\n *\n * console.log(prevCount); // 5\n * ```\n */\nexport function usePrevious<T>(value: T): T | null | undefined {\n    const ref = React.useRef<T | null>(null);\n\n    React.useEffect(() => {\n        ref.current = value;\n\n        return () => {\n            ref.current = null;\n        };\n    }, [value]);\n\n    return ref.current;\n}\n","import * as React from 'react';\n\n/**\n * Generates a unique identifier.\n *\n * @param initialValue Optional initial value for the ID.\n * @returns The generated or provided ID.\n *\n * @example\n * ```tsx\n * const id = useId('foo');\n * console.log(id); // 'foo'\n * ```\n *\n * @example\n * ```tsx\n * const defaultId = useId();\n * console.log(defaultId); // e.g., 'pr_id_0'\n * ```\n */\nexport function useId(initialValue?: string): string {\n    const idx = React.useId();\n    const [idState, setIdState] = React.useState<string>(initialValue || `pr_id_${idx.replaceAll(/:|«|»/g, '')}`);\n\n    React.useEffect(() => {\n        setIdState(initialValue || `pr_id_${idx.replaceAll(/:|«|»/g, '')}`);\n    }, [initialValue, idx]);\n\n    return idState;\n}\n","import { isAndroid } from '@primeuix/utils';\n\n/**\n * The options for the `useKeyFilter` hook.\n */\nexport interface UseKeyFilterOptions {\n    /**\n     * Sets the pattern for key filtering.\n     * @default /./\n     */\n    pattern?: 'pint' | 'int' | 'pnum' | 'money' | 'num' | 'hex' | 'email' | 'alpha' | 'alphanum' | RegExp;\n    /**\n     * When enabled, instead of blocking keys, input is validated internally to test against the regular expression.\n     * @default false\n     */\n    validateOnly?: boolean;\n}\n\nexport interface UseKeyFilterExposes {\n    /**\n     * Handles input events for key filter.\n     * Processes character input and composition events while applying the filter pattern.\n     * @param event - The form or composition event from the input element\n     */\n    onBeforeInput: (event: React.CompositionEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keypress events for character input validation.\n     * Validates and places characters according to the filter pattern.\n     * @param event - The keyboard event from the input element\n     */\n    onKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles paste events for clipboard content insertion.\n     * Processes pasted content according to the mask pattern.\n     * @param event - The clipboard event from the input element\n     */\n    onPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;\n    /**\n     * Validates the current input value against the filter pattern.\n     * @param event - The form event from the input element\n     * @returns true if the value matches the pattern, false otherwise\n     */\n    validate: (event: React.FormEvent<HTMLInputElement>) => boolean;\n}\n\nexport function useKeyFilter(options: UseKeyFilterOptions): UseKeyFilterExposes {\n    const { pattern = /./, validateOnly = false } = options;\n\n    const DEFAULT_MASKS = {\n        pint: /[\\d]/,\n        int: /[\\d-]/,\n        pnum: /[\\d.]/,\n        money: /[\\d.\\s,]/,\n        num: /[\\d-.]/,\n        hex: /[0-9a-f]/i,\n        email: /[a-z0-9_.-@]/i,\n        alpha: /[a-z_]/i,\n        alphanum: /[a-z0-9_]/\n    };\n\n    const getRegex = (): RegExp => {\n        return typeof pattern === 'string' ? DEFAULT_MASKS[pattern] : pattern;\n    };\n\n    const onBeforeInput = (event: React.CompositionEvent<HTMLInputElement>) => {\n        // android devices must use beforeinput https://stackoverflow.com/questions/36753548/keycode-on-android-is-always-229\n        if (validateOnly || !isAndroid()) {\n            return;\n        }\n\n        validateKey(event, event.data);\n    };\n\n    const onKeyPress = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        // non android devices use keydown\n        if (validateOnly || isAndroid()) {\n            return;\n        }\n\n        if (event.ctrlKey || event.altKey || event.metaKey) {\n            return;\n        }\n\n        validateKey(event, event.key);\n    };\n\n    const onPaste = (event: React.ClipboardEvent<HTMLInputElement>) => {\n        if (validateOnly) {\n            return;\n        }\n\n        const regex = getRegex();\n        const clipboard = event.clipboardData.getData('text');\n\n        // loop over each letter pasted and if any fail prevent the paste\n        [...clipboard].forEach((c) => {\n            if (!regex.test(c)) {\n                event.preventDefault();\n\n                return false;\n            }\n        });\n    };\n\n    const validateKey = (event: React.CompositionEvent<HTMLInputElement> | React.KeyboardEvent<HTMLInputElement>, key: string) => {\n        if (key === null || key === undefined) {\n            return;\n        }\n\n        // some AZERTY keys come in with 2 chars like ´ç if Dead key is pressed first\n        const isPrintableKey = key.length <= 2;\n\n        if (!isPrintableKey) {\n            return;\n        }\n\n        const regex = getRegex();\n\n        if (!regex.test(key)) {\n            event.preventDefault();\n        }\n    };\n\n    const validate = (event: React.FormEvent<HTMLInputElement>) => {\n        const value = (event.target as HTMLInputElement).value;\n        let validatePattern = true;\n\n        const regex = getRegex();\n\n        if (value && !regex.test(value)) {\n            validatePattern = false;\n        }\n\n        return validatePattern;\n    };\n\n    return {\n        onBeforeInput,\n        onKeyPress,\n        onPaste,\n        validate\n    };\n}\n","import { useMountEffect } from '@primereact/hooks';\nimport { getUserAgent } from '@primeuix/utils';\nimport * as React from 'react';\n\n/**\n * Event fired when the component's state changes.\n */\nexport interface UseMaskChangeEvent {\n    /**\n     * The value of the component.\n     */\n    value: string | undefined;\n}\n\n/**\n * The options for the `useMask` hook.\n */\nexport interface UseMaskOptions {\n    /**\n     * Mask pattern.\n     */\n    mask: string;\n    /**\n     * Defines if model sets the raw unmasked value to bound value or the formatted mask value.\n     * @default false\n     */\n    unmask?: string;\n    /**\n     * Placeholder character in mask, default is underscore.\n     * @default _\n     */\n    slotChar?: string;\n    /**\n     * Clears the incomplete value on blur.\n     * @default true\n     */\n    autoClear?: boolean;\n    /**\n     * Whether the components are clickable or not.\n     * @default false\n     */\n    readOnly?: boolean;\n    /**\n     * Callback function that is called when the value is changed.\n     * @param event The event that triggered the change.\n     * @param event.value The value of the component.\n     * @returns void\n     */\n    onMaskChange?: (event: UseMaskChangeEvent) => void;\n    /**\n     * Reference to the mask element.\n     */\n    target: HTMLInputElement;\n}\n\nexport interface UseMaskExposes {\n    /**\n     * Handles input events for the masked input field.\n     * Processes character input and composition events while applying the mask pattern.\n     * @param event - The form or composition event from the input element\n     */\n    onMaskInput: (event: React.FormEvent<HTMLInputElement> | React.CompositionEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keydown events for special key operations.\n     * Manages backspace, delete, escape, and enter key behaviors.\n     * @param event - The keyboard event from the input element\n     */\n    onMaskKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keypress events for character input validation.\n     * Validates and places characters according to the mask pattern.\n     * @param event - The keyboard event from the input element\n     */\n    onMaskKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles focus events when the input gains focus.\n     * Initializes the mask display and sets the cursor position.\n     * @param event - The focus event from the input element\n     */\n    onMaskFocus: (event: React.FocusEvent<HTMLInputElement>) => void;\n    /**\n     * Handles blur events when the input loses focus.\n     * Validates the final value and triggers change events if needed.\n     * @param event - The focus event from the input element\n     */\n    onMaskBlur: (event: React.FocusEvent<HTMLInputElement>) => void;\n    /**\n     * Handles paste events for clipboard content insertion.\n     * Processes pasted content according to the mask pattern.\n     * @param event - The clipboard event from the input element\n     */\n    onMaskPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;\n}\n\n/**\n * useMask hook is used to enter input in a certain format such as numeric, date, currency, email and phone.\n *\n * @param {UseMaskOptions} options - The options for the mask.\n * @returns {UseMaskExposes} - The exposed methods for the mask.\n *\n * @example\n * ```tsx\n * const { onMaskInput, onMaskKeyDown, onMaskKeyPress, onMaskFocus, onMaskBlur, onMaskPaste } = useMask({\n *        mask: '99/99/9999',\n *        onMaskChange: (event: UseMaskChangeEvent) => setValue(event.value ?? ''),\n *        target: ref\n *    });\n *\n *    return (\n *       <div className=\"card flex justify-center\">\n *           <InputText ref={ref} value={value} placeholder=\"99/99/9999\" onInput={onMaskInput} onKeyDown={onMaskKeyDown} onKeyPress={onMaskKeyPress} onFocus={onMaskFocus} onBlur={onMaskBlur} onPaste={onMaskPaste} />\n *       </div>\n *    );\n */\nexport function useMask(options: UseMaskOptions): UseMaskExposes {\n    const { mask, unmask, slotChar = '_', autoClear = true, readOnly = false, onMaskChange, target } = options;\n\n    const len = React.useRef(0);\n    const tests = React.useRef<Array<RegExp | null>>([]);\n    const buffer = React.useRef<string[]>([]);\n    const defaultBuffer = React.useRef<string | null>(null);\n    const partialPosition = React.useRef<number>(0);\n    const androidChrome = React.useRef(false);\n    const focus = React.useRef(false);\n    const focusText = React.useRef<string | null>(null);\n    const firstNonMaskPos = React.useRef<number | null>(null);\n    const lastRequiredNonMaskPos = React.useRef<number>(0);\n    const caretTimeoutId = React.useRef<NodeJS.Timeout | null>(null);\n    const oldVal = React.useRef<string | null>(null);\n    const currentVal = React.useRef<string | null>(null);\n\n    const onMaskInput = (event: React.FormEvent<HTMLInputElement> | React.CompositionEvent<HTMLInputElement>) => {\n        // Check if the event is part of a text composition process (e.g., for Asian languages).\n        // If event.isComposing is true, it means the user is still composing text and the input is not finalized.\n        if ('isComposing' in event && event.isComposing) {\n            return;\n        }\n\n        if (androidChrome.current) handleAndroidInput();\n        else handleInputChange(event);\n    };\n\n    const onMaskKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        if (readOnly) {\n            return;\n        }\n\n        const k = event.code;\n        let pos, begin, end;\n        const iPhone = /iphone/i.test(getUserAgent());\n\n        oldVal.current = target?.value as string;\n\n        //backspace, delete, and escape get special treatment\n        if (k === 'Backspace' || k === 'Delete' || (iPhone && k === 'Escape')) {\n            pos = caret();\n\n            if (!pos) {\n                return;\n            }\n\n            begin = pos.begin;\n            end = pos.end;\n\n            if (end - begin === 0) {\n                begin = k !== 'Delete' ? seekPrev(begin) : (end = seekNext(begin - 1));\n                end = k === 'Delete' ? seekNext(end) : end;\n            }\n\n            clearBuffer(begin, end);\n            shiftL(begin, end - 1);\n            updateModelValue((event.target as HTMLInputElement).value);\n\n            event.preventDefault();\n        } else if (k === 'Enter') {\n            // enter\n            target.blur();\n            updateModelValue((event.target as HTMLInputElement).value);\n        } else if (k === 'Escape') {\n            // escape\n            if (target) {\n                target.value = focusText.current ?? '';\n            }\n\n            caret(0, checkVal());\n            updateModelValue((event.target as HTMLInputElement).value);\n            event.preventDefault();\n        }\n    };\n\n    const onMaskKeyPress = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        if (readOnly) {\n            return;\n        }\n\n        const k = event.code,\n            pos = caret();\n        let p: number, c: string, next: number;\n\n        if (!pos) {\n            return;\n        }\n\n        if (event.ctrlKey || event.altKey || event.metaKey || event.shiftKey || event.key === 'CapsLock' || event.key === 'Escape' || event.key === 'Tab') {\n            //Ignore\n            return;\n        } else if (k && k !== 'Enter') {\n            if (pos.end - pos.begin !== 0) {\n                clearBuffer(pos.begin, pos.end);\n                shiftL(pos.begin, pos.end - 1);\n            }\n\n            p = seekNext(pos.begin - 1);\n\n            if (p < len.current) {\n                c = event.key;\n\n                if (tests.current[p]?.test(c)) {\n                    shiftR(p);\n\n                    buffer.current[p] = c;\n                    writeBuffer();\n                    next = seekNext(p);\n\n                    if (/android/i.test(getUserAgent())) {\n                        //Path for CSP Violation on FireFox OS 1.1\n                        const proxy = () => {\n                            caret(next);\n                        };\n\n                        setTimeout(proxy, 0);\n                    } else {\n                        caret(next);\n                    }\n                }\n            }\n\n            event.preventDefault();\n        }\n\n        updateModelValue((event.target as HTMLInputElement).value);\n    };\n\n    const onMaskFocus = () => {\n        if (readOnly) {\n            return;\n        }\n\n        if (caretTimeoutId.current) {\n            clearTimeout(caretTimeoutId.current as NodeJS.Timeout);\n        }\n\n        focus.current = true;\n        focusText.current = target.value as string;\n\n        if (!target.value || target.value === defaultBuffer.current) {\n            requestAnimationFrame(() => {\n                if (target === document.activeElement) {\n                    caret(0, 0);\n                }\n            });\n        } else {\n            const pos = checkVal();\n\n            caretTimeoutId.current = setTimeout(() => {\n                if (target !== document.activeElement) {\n                    return;\n                }\n\n                writeBuffer();\n\n                if (pos === mask?.replace('?', '').length) {\n                    caret(0, pos);\n                } else {\n                    caret(pos);\n                }\n            }, 10);\n        }\n    };\n\n    const onMaskBlur = (event: React.FocusEvent<HTMLInputElement>) => {\n        focus.current = false;\n        checkVal();\n        updateModelValue(event.target.value);\n\n        if (target.value !== focusText.current) {\n            const e = new Event('change', { bubbles: true, cancelable: false });\n\n            target.dispatchEvent(e);\n        }\n    };\n\n    const onMaskPaste = (event: React.ClipboardEvent<HTMLInputElement>) => {\n        handleInputChange(event);\n    };\n\n    const caret = (first?: number, last?: number): { begin: number; end: number } | undefined => {\n        let begin = 0,\n            end = 0;\n\n        if (typeof first === 'number') {\n            begin = first;\n            end = typeof last === 'number' ? last : begin;\n\n            target.setSelectionRange(begin, end);\n        } else {\n            if (target) {\n                begin = target.selectionStart ?? 0;\n                end = target.selectionEnd ?? 0;\n            }\n        }\n\n        return { begin, end };\n    };\n\n    const getPlaceholder = (i: number) => {\n        if (i < slotChar.length) {\n            return slotChar.charAt(i);\n        }\n\n        return slotChar.charAt(0);\n    };\n\n    const seekNext = (pos: number) => {\n        while (++pos < len.current && !tests.current[pos]);\n\n        return pos;\n    };\n\n    const seekPrev = (pos: number) => {\n        while (--pos >= 0 && !tests.current[pos]);\n\n        return pos;\n    };\n\n    const shiftL = (begin: number, end: number) => {\n        let i, j;\n\n        if (begin < 0) {\n            return;\n        }\n\n        for (i = begin, j = seekNext(end); i < len.current; i++) {\n            if (tests.current[i]) {\n                if (j < len.current && tests.current[i]?.test(buffer.current[j])) {\n                    buffer.current[i] = buffer.current[j];\n                    buffer.current[j] = getPlaceholder(j);\n                } else {\n                    break;\n                }\n\n                j = seekNext(j);\n            }\n        }\n\n        writeBuffer();\n        caret(Math.max(firstNonMaskPos.current ?? 0, begin));\n    };\n\n    const shiftR = (pos: number) => {\n        let i, c, j, t;\n\n        for (i = pos, c = getPlaceholder(pos); i < len.current; i++) {\n            if (tests.current[i]) {\n                j = seekNext(i);\n                t = buffer.current[i];\n                buffer.current[i] = c;\n\n                if (j < len.current && tests.current[j]?.test(t)) {\n                    c = t;\n                } else {\n                    break;\n                }\n            }\n        }\n    };\n\n    const handleAndroidInput = () => {\n        const curVal = target.value as string;\n        const pos = caret();\n\n        if (!pos) {\n            return;\n        }\n\n        if (oldVal.current && oldVal.current.length && oldVal.current.length > curVal.length) {\n            // a deletion or backspace happened\n            checkVal(true);\n            while (pos.begin > 0 && !tests.current[pos.begin - 1]) pos.begin--;\n\n            if (pos.begin === 0) {\n                while (pos.begin < (firstNonMaskPos.current ?? 0) && !tests.current[pos.begin]) pos.begin++;\n            }\n\n            caret(pos.begin, pos.begin);\n        } else {\n            checkVal(true);\n            while (pos.begin < len.current && !tests.current[pos.begin]) pos.begin++;\n\n            caret(pos.begin, pos.begin);\n        }\n    };\n\n    const clearBuffer = (start: number, end: number) => {\n        let i;\n\n        for (i = start; i < end && i < len.current; i++) {\n            if (tests.current[i]) {\n                buffer.current[i] = getPlaceholder(i);\n            }\n        }\n    };\n\n    const writeBuffer = () => {\n        if (target) {\n            target.value = buffer.current.join('');\n        }\n    };\n\n    const checkVal = (allow = false): number => {\n        //try to place characters where they belong\n        const test = target.value;\n        let lastMatch = -1,\n            i,\n            c,\n            pos;\n\n        for (i = 0, pos = 0; i < len.current; i++) {\n            const currentTest = tests.current[i];\n\n            if (currentTest !== null) {\n                buffer.current[i] = getPlaceholder(i);\n\n                while (pos++ < (test?.length ?? 0)) {\n                    c = test?.charAt(pos - 1) ?? '';\n\n                    if (currentTest.test(c)) {\n                        buffer.current[i] = c;\n                        lastMatch = i;\n                        break;\n                    }\n                }\n\n                if (pos > (test?.length ?? 0)) {\n                    clearBuffer(i + 1, len.current);\n                    break;\n                }\n            } else {\n                if (buffer.current[i] === test?.charAt(pos)) {\n                    pos++;\n                }\n\n                if (i < partialPosition.current) {\n                    lastMatch = i;\n                }\n            }\n        }\n\n        if (allow) {\n            writeBuffer();\n        } else if (lastMatch + 1 < partialPosition.current) {\n            if (autoClear || buffer.current.join('') === defaultBuffer.current) {\n                // Invalid value. Remove it and replace it with the\n                // mask, which is the default behavior.\n                if (target.value) {\n                    target.value = '';\n                }\n\n                clearBuffer(0, len.current);\n            } else {\n                // Invalid value, but we opt to show the value to the\n                // user and allow them to correct their mistake.\n                writeBuffer();\n            }\n        } else {\n            writeBuffer();\n\n            if (target) {\n                target.value = target.value.substring(0, lastMatch + 1);\n            }\n        }\n\n        return partialPosition.current ? i : (firstNonMaskPos.current ?? 0);\n    };\n\n    const handleInputChange = (event: React.FormEvent<HTMLInputElement> | React.ClipboardEvent<HTMLInputElement>) => {\n        const isPasteEvent = event.type === 'paste';\n\n        if (readOnly || isPasteEvent) {\n            return;\n        }\n\n        const pos = checkVal(true);\n\n        caret(pos);\n        updateModelValue((event.target as HTMLInputElement).value);\n    };\n\n    const unmaskValue = (value: string) => {\n        const unmaskedBuffer = [];\n        const thisbuffer = value.split('');\n\n        for (let i = 0; i < thisbuffer.length; i++) {\n            const c = thisbuffer[i];\n\n            if (tests.current[i] && c !== getPlaceholder(i)) {\n                unmaskedBuffer.push(c);\n            }\n        }\n\n        return unmaskedBuffer.join('');\n    };\n\n    const updateModelValue = (value: string) => {\n        if (currentVal.current === value) return;\n\n        const val = unmask ? unmaskValue(value) : value;\n        const finalValue = defaultBuffer.current !== val ? val : '';\n\n        currentVal.current = value;\n\n        if (target) {\n            target.value = finalValue;\n        }\n\n        // Call the onMaskChange callback to update React state\n        if (onMaskChange) {\n            onMaskChange({ value: finalValue });\n        }\n    };\n\n    const updateValue = (updateModel = true) => {\n        if (target) {\n            if (target.value == null) {\n                target.value = '';\n\n                if (updateModel) {\n                    updateModelValue('');\n                }\n            } else {\n                checkVal();\n\n                setTimeout(() => {\n                    if (target) {\n                        writeBuffer();\n                        checkVal();\n\n                        if (updateModel) updateModelValue(target.value);\n                    }\n                }, 10);\n            }\n\n            focusText.current = target.value;\n        }\n    };\n\n    const initMask = () => {\n        tests.current = [];\n        partialPosition.current = mask ? mask.length : 0;\n        len.current = mask ? mask.length : 0;\n        firstNonMaskPos.current = null;\n        const defs = {\n            9: '[0-9]',\n            a: '[A-Za-z]',\n            '*': '[A-Za-z0-9]'\n        } as Record<string, string>;\n\n        const ua = getUserAgent();\n\n        androidChrome.current = /chrome/i.test(ua) && /android/i.test(ua);\n\n        const maskTokens = mask ? mask.split('') : '';\n\n        for (let i = 0; i < maskTokens.length; i++) {\n            const c = maskTokens[i];\n\n            if (c === '?') {\n                len.current--;\n                partialPosition.current = i;\n            } else if (defs[c]) {\n                tests.current.push(new RegExp(defs[c]));\n\n                if (firstNonMaskPos.current === null) {\n                    firstNonMaskPos.current = tests.current.length - 1;\n                }\n\n                if (i < partialPosition.current) {\n                    lastRequiredNonMaskPos.current = tests.current.length - 1;\n                }\n            } else {\n                tests.current.push(null);\n            }\n        }\n\n        buffer.current = [];\n\n        for (let i = 0; i < maskTokens.length; i++) {\n            const c = maskTokens[i];\n\n            if (c !== '?') {\n                if (defs[c]) buffer.current.push(getPlaceholder(i));\n                else buffer.current.push(c);\n            }\n        }\n\n        defaultBuffer.current = buffer.current.join('');\n\n        updateValue(false);\n    };\n\n    useMountEffect(() => {\n        initMask();\n    });\n\n    return {\n        onMaskInput,\n        onMaskKeyDown,\n        onMaskKeyPress,\n        onMaskFocus,\n        onMaskBlur,\n        onMaskPaste\n    };\n}\n","import * as React from 'react';\n\n/**\n * Listens for the specified media query.\n *\n * @param query - The media query to match.\n * @param when - A boolean indicating whether the media query should be active.\n * @returns A boolean indicating whether the media query matches.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const isMobile = useMatchMedia('(max-width: 768px)');\n *\n *     return <div>{isMobile ? 'Mobile' : 'Desktop'}</div>;\n * };\n */\nexport function useMatchMedia(query: string, when: boolean = true): boolean {\n    const [matches, setMatches] = React.useState(false);\n    const matchMedia = React.useRef<MediaQueryList | null>(null);\n\n    const handleChange = (event: MediaQueryListEvent) => setMatches(event.matches);\n    const bind = () => matchMedia.current?.addEventListener('change', handleChange);\n    const unbind = () => matchMedia.current?.removeEventListener('change', handleChange) && (matchMedia.current = null);\n\n    React.useEffect(() => {\n        if (when) {\n            matchMedia.current = window.matchMedia(query);\n            setMatches(matchMedia.current.matches);\n\n            bind();\n        }\n\n        return () => {\n            unbind();\n        };\n    }, [query, when]);\n\n    return matches;\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs a mount effect only once.\n * This is similar to `useEffect`, but it only runs on mount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @returns {void}\n *\n * @example\n * ```tsx\n * const MyComponent = () => {\n *     useMountEffect(() => {\n *         console.log('Mounted');\n *     });\n * };\n * ```\n */\nexport function useMountEffect(effect: React.EffectCallback): void {\n    const mounted = React.useRef<boolean>(false);\n\n    React.useEffect(() => {\n        if (!mounted.current) {\n            mounted.current = true;\n\n            effect?.();\n        }\n    }, []);\n}\n","import * as React from 'react';\n\n/**\n * Used to merge and differentiate incoming props with the default props.\n * - Keys that exist in both `props1` and `props2` are placed in `props`, with values from `props1`.\n * - Keys that exist in `props1` but not in `props2` are placed in `attrs`.\n *\n * @template P1 The type of the incoming set of props.\n * @template P2 The type of the default set of props.\n *\n * @param props1 The incoming set of props (e.g., user-defined or dynamic props).\n * @param props2 The default set of props (e.g., default props).\n * @returns An object containing:\n *   - `props`: A new object containing keys that exist in both `props1` and `props2`, using values from `props1`.\n *   - `attrs`: A new object containing keys that exist only in `props1`, excluding any keys from `props2`.\n *\n * @example\n * ```ts\n * const { props, attrs } = useProps({ id: 'foo', className: 'bar' }, { className: 'baz' });\n *\n * console.log(props); // { className: 'bar' }\n * console.log(attrs); // { id: 'foo' }\n * ```\n */\nexport function useProps<P1, P2>(props1: P1 = {} as P1, props2: P2 = {} as P2) {\n    type Props = Pick<P1 & P2, keyof P2>;\n    type Attrs = Omit<P1, keyof P2>;\n    type Result = { props: Props; attrs: Attrs };\n\n    return React.useMemo(() => {\n        const result: Result = { props: { ...props2 } as Props, attrs: {} as Attrs };\n\n        Object.entries(props1 as Record<string, unknown>).forEach(([key, value]) => {\n            if (key in (props2 as Record<string, unknown>)) {\n                (result.props as Record<string, unknown>)[key] = value;\n            } else {\n                (result.attrs as Record<string, unknown>)[key] = value;\n            }\n        });\n\n        return result;\n    }, [props1, props2]);\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs an unmount effect only once.\n * This is similar to `useEffect`, but it only runs on unmount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @returns {void}\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     useUnmountEffect(() => {\n *         console.log('Unmounted');\n *     });\n * };\n * ```\n */\nexport function useUnmountEffect(effect: React.EffectCallback): void {\n    React.useEffect(() => {\n        return () => {\n            effect?.();\n        };\n    }, []);\n}\n","import * as React from 'react';\n\n/**\n * Custom hook that runs an update effect whenever dependencies change.\n * This is similar to `useEffect`, but it does not run on mount.\n *\n * @param {React.EffectCallback} effect the callback function\n * @param {React.DependencyList} dependencies the dependencies\n * @returns {void}\n *\n * @example\n * ```tsx\n * const Component = ({ value }) => {\n *     useUpdateEffect(() => {\n *         console.log('Updated');\n *     }, [value]);\n * };\n * ```\n */\nexport function useUpdateEffect(effect: React.EffectCallback, dependencies?: React.DependencyList): void {\n    const mounted = React.useRef<boolean>(false);\n\n    React.useEffect(() => {\n        if (!mounted.current) {\n            mounted.current = true;\n\n            return;\n        }\n\n        return effect?.();\n    }, dependencies);\n}\n","import * as React from 'react';\n\n/**\n * Starts a view transition.\n *\n * @returns A function that starts a view transition.\n *\n * @example\n * ```tsx\n * const Component = () => {\n *     const startTransition = useViewTransition();\n *\n *     const handleClick = () => {\n *         startTransition(() => {\n *             // Perform some work\n *         });\n *     };\n *\n *     return <button onClick={handleClick}>Click me</button>;\n * };\n */\nexport function useViewTransition() {\n    const startTransition = React.useCallback((callback: () => void) => {\n        if (document.startViewTransition) {\n            document.startViewTransition(() => {\n                callback();\n            });\n        } else {\n            callback();\n        }\n    }, []);\n\n    return startTransition;\n}\n"],"mappings":"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","names":["React","useAttrSelector","prefix","id","resolve","React","useControlledState","value","defaultValue","onChange","valueState","setValueState","isControlled","computedValue","setValue","inValue","newValue","onChangeParam","getTargetElement","isNotEmpty","React","React","usePrevious","value","ref","useEventListener","target","type","listener","options","when","targetRef","listenerRef","prevListener","usePrevious","prevOptions","bind","bindOptions","bindTarget","isNotEmpty","unbind","getTargetElement","event","_a","dispose","updateTarget","listenerChanged","optionsChanged","listenerExists","React","useId","initialValue","idx","idState","setIdState","isAndroid","useKeyFilter","options","pattern","validateOnly","DEFAULT_MASKS","getRegex","onBeforeInput","event","validateKey","onKeyPress","onPaste","regex","c","key","value","validatePattern","useMountEffect","getUserAgent","React","useMask","options","mask","unmask","slotChar","autoClear","readOnly","onMaskChange","target","len","tests","buffer","defaultBuffer","partialPosition","androidChrome","focus","focusText","firstNonMaskPos","lastRequiredNonMaskPos","caretTimeoutId","oldVal","currentVal","onMaskInput","event","handleAndroidInput","handleInputChange","onMaskKeyDown","_a","k","pos","begin","end","iPhone","caret","seekPrev","seekNext","clearBuffer","shiftL","updateModelValue","checkVal","onMaskKeyPress","p","c","next","shiftR","writeBuffer","onMaskFocus","onMaskBlur","e","onMaskPaste","first","last","_b","getPlaceholder","i","j","t","curVal","start","allow","_c","_d","test","lastMatch","currentTest","isPasteEvent","unmaskValue","value","unmaskedBuffer","thisbuffer","val","finalValue","updateValue","updateModel","initMask","defs","ua","maskTokens","React","useMatchMedia","query","when","matches","setMatches","matchMedia","handleChange","event","bind","_a","unbind","React","useMountEffect","effect","mounted","React","useProps","props1","props2","result","__spreadValues","key","value","React","useUnmountEffect","effect","React","useUpdateEffect","effect","dependencies","mounted","React","useViewTransition","callback"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primereact/hooks",
-  "version": "11.0.0-alpha.4",
+  "version": "11.0.0-alpha.5",
   "author": "PrimeTek Informatics",
   "description": "",
   "homepage": "https://primereact.org/",

package/use-key-filter/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The options for the `useKeyFilter` hook.
+ */
+export interface UseKeyFilterOptions {
+    /**
+     * Sets the pattern for key filtering.
+     * @default /./
+     */
+    pattern?: 'pint' | 'int' | 'pnum' | 'money' | 'num' | 'hex' | 'email' | 'alpha' | 'alphanum' | RegExp;
+    /**
+     * When enabled, instead of blocking keys, input is validated internally to test against the regular expression.
+     * @default false
+     */
+    validateOnly?: boolean;
+}
+export interface UseKeyFilterExposes {
+    /**
+     * Handles input events for key filter.
+     * Processes character input and composition events while applying the filter pattern.
+     * @param event - The form or composition event from the input element
+     */
+    onBeforeInput: (event: React.CompositionEvent<HTMLInputElement>) => void;
+    /**
+     * Handles keypress events for character input validation.
+     * Validates and places characters according to the filter pattern.
+     * @param event - The keyboard event from the input element
+     */
+    onKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    /**
+     * Handles paste events for clipboard content insertion.
+     * Processes pasted content according to the mask pattern.
+     * @param event - The clipboard event from the input element
+     */
+    onPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;
+    /**
+     * Validates the current input value against the filter pattern.
+     * @param event - The form event from the input element
+     * @returns true if the value matches the pattern, false otherwise
+     */
+    validate: (event: React.FormEvent<HTMLInputElement>) => boolean;
+}
+export declare function useKeyFilter(options: UseKeyFilterOptions): UseKeyFilterExposes;

package/use-key-filter/index.mjs

@@ -0,0 +1,2 @@
+import{isAndroid as s}from"@primeuix/utils";function v(p){let{pattern:r=/./,validateOnly:o=!1}=p,u={pint:/[\d]/,int:/[\d-]/,pnum:/[\d.]/,money:/[\d.\s,]/,num:/[\d-.]/,hex:/[0-9a-f]/i,email:/[a-z0-9_.-@]/i,alpha:/[a-z_]/i,alphanum:/[a-z0-9_]/},i=()=>typeof r=="string"?u[r]:r,c=e=>{o||!s()||l(e,e.data)},m=e=>{o||s()||e.ctrlKey||e.altKey||e.metaKey||l(e,e.key)},d=e=>{if(o)return;let t=i();[...e.clipboardData.getData("text")].forEach(a=>{if(!t.test(a))return e.preventDefault(),!1})},l=(e,t)=>{if(t==null||!(t.length<=2))return;i().test(t)||e.preventDefault()};return{onBeforeInput:c,onKeyPress:m,onPaste:d,validate:e=>{let t=e.target.value,n=!0,a=i();return t&&!a.test(t)&&(n=!1),n}}}export{v as useKeyFilter};
+//# sourceMappingURL=index.mjs.map

package/use-key-filter/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/use-key-filter/index.ts"],"sourcesContent":["import { isAndroid } from '@primeuix/utils';\n\n/**\n * The options for the `useKeyFilter` hook.\n */\nexport interface UseKeyFilterOptions {\n    /**\n     * Sets the pattern for key filtering.\n     * @default /./\n     */\n    pattern?: 'pint' | 'int' | 'pnum' | 'money' | 'num' | 'hex' | 'email' | 'alpha' | 'alphanum' | RegExp;\n    /**\n     * When enabled, instead of blocking keys, input is validated internally to test against the regular expression.\n     * @default false\n     */\n    validateOnly?: boolean;\n}\n\nexport interface UseKeyFilterExposes {\n    /**\n     * Handles input events for key filter.\n     * Processes character input and composition events while applying the filter pattern.\n     * @param event - The form or composition event from the input element\n     */\n    onBeforeInput: (event: React.CompositionEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keypress events for character input validation.\n     * Validates and places characters according to the filter pattern.\n     * @param event - The keyboard event from the input element\n     */\n    onKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles paste events for clipboard content insertion.\n     * Processes pasted content according to the mask pattern.\n     * @param event - The clipboard event from the input element\n     */\n    onPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;\n    /**\n     * Validates the current input value against the filter pattern.\n     * @param event - The form event from the input element\n     * @returns true if the value matches the pattern, false otherwise\n     */\n    validate: (event: React.FormEvent<HTMLInputElement>) => boolean;\n}\n\nexport function useKeyFilter(options: UseKeyFilterOptions): UseKeyFilterExposes {\n    const { pattern = /./, validateOnly = false } = options;\n\n    const DEFAULT_MASKS = {\n        pint: /[\\d]/,\n        int: /[\\d-]/,\n        pnum: /[\\d.]/,\n        money: /[\\d.\\s,]/,\n        num: /[\\d-.]/,\n        hex: /[0-9a-f]/i,\n        email: /[a-z0-9_.-@]/i,\n        alpha: /[a-z_]/i,\n        alphanum: /[a-z0-9_]/\n    };\n\n    const getRegex = (): RegExp => {\n        return typeof pattern === 'string' ? DEFAULT_MASKS[pattern] : pattern;\n    };\n\n    const onBeforeInput = (event: React.CompositionEvent<HTMLInputElement>) => {\n        // android devices must use beforeinput https://stackoverflow.com/questions/36753548/keycode-on-android-is-always-229\n        if (validateOnly || !isAndroid()) {\n            return;\n        }\n\n        validateKey(event, event.data);\n    };\n\n    const onKeyPress = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        // non android devices use keydown\n        if (validateOnly || isAndroid()) {\n            return;\n        }\n\n        if (event.ctrlKey || event.altKey || event.metaKey) {\n            return;\n        }\n\n        validateKey(event, event.key);\n    };\n\n    const onPaste = (event: React.ClipboardEvent<HTMLInputElement>) => {\n        if (validateOnly) {\n            return;\n        }\n\n        const regex = getRegex();\n        const clipboard = event.clipboardData.getData('text');\n\n        // loop over each letter pasted and if any fail prevent the paste\n        [...clipboard].forEach((c) => {\n            if (!regex.test(c)) {\n                event.preventDefault();\n\n                return false;\n            }\n        });\n    };\n\n    const validateKey = (event: React.CompositionEvent<HTMLInputElement> | React.KeyboardEvent<HTMLInputElement>, key: string) => {\n        if (key === null || key === undefined) {\n            return;\n        }\n\n        // some AZERTY keys come in with 2 chars like ´ç if Dead key is pressed first\n        const isPrintableKey = key.length <= 2;\n\n        if (!isPrintableKey) {\n            return;\n        }\n\n        const regex = getRegex();\n\n        if (!regex.test(key)) {\n            event.preventDefault();\n        }\n    };\n\n    const validate = (event: React.FormEvent<HTMLInputElement>) => {\n        const value = (event.target as HTMLInputElement).value;\n        let validatePattern = true;\n\n        const regex = getRegex();\n\n        if (value && !regex.test(value)) {\n            validatePattern = false;\n        }\n\n        return validatePattern;\n    };\n\n    return {\n        onBeforeInput,\n        onKeyPress,\n        onPaste,\n        validate\n    };\n}\n"],"mappings":"AAAA,OAAS,aAAAA,MAAiB,kBA6CnB,SAASC,EAAaC,EAAmD,CAC5E,GAAM,CAAE,QAAAC,EAAU,IAAK,aAAAC,EAAe,EAAM,EAAIF,EAE1CG,EAAgB,CAClB,KAAM,OACN,IAAK,QACL,KAAM,QACN,MAAO,WACP,IAAK,SACL,IAAK,YACL,MAAO,gBACP,MAAO,UACP,SAAU,WACd,EAEMC,EAAW,IACN,OAAOH,GAAY,SAAWE,EAAcF,CAAO,EAAIA,EAG5DI,EAAiBC,GAAoD,CAEnEJ,GAAgB,CAACJ,EAAU,GAI/BS,EAAYD,EAAOA,EAAM,IAAI,CACjC,EAEME,EAAcF,GAAiD,CAE7DJ,GAAgBJ,EAAU,GAI1BQ,EAAM,SAAWA,EAAM,QAAUA,EAAM,SAI3CC,EAAYD,EAAOA,EAAM,GAAG,CAChC,EAEMG,EAAWH,GAAkD,CAC/D,GAAIJ,EACA,OAGJ,IAAMQ,EAAQN,EAAS,EAIvB,CAAC,GAHiBE,EAAM,cAAc,QAAQ,MAAM,CAGvC,EAAE,QAASK,GAAM,CAC1B,GAAI,CAACD,EAAM,KAAKC,CAAC,EACb,OAAAL,EAAM,eAAe,EAEd,EAEf,CAAC,CACL,EAEMC,EAAc,CAACD,EAAyFM,IAAgB,CAQ1H,GAPIA,GAAQ,MAOR,EAFmBA,EAAI,QAAU,GAGjC,OAGUR,EAAS,EAEZ,KAAKQ,CAAG,GACfN,EAAM,eAAe,CAE7B,EAeA,MAAO,CACH,cAAAD,EACA,WAAAG,EACA,QAAAC,EACA,SAjBcH,GAA6C,CAC3D,IAAMO,EAASP,EAAM,OAA4B,MAC7CQ,EAAkB,GAEhBJ,EAAQN,EAAS,EAEvB,OAAIS,GAAS,CAACH,EAAM,KAAKG,CAAK,IAC1BC,EAAkB,IAGfA,CACX,CAOA,CACJ","names":["isAndroid","useKeyFilter","options","pattern","validateOnly","DEFAULT_MASKS","getRegex","onBeforeInput","event","validateKey","onKeyPress","onPaste","regex","c","key","value","validatePattern"]}

package/use-mask/index.d.ts

@@ -0,0 +1,109 @@
+import * as React from 'react';
+/**
+ * Event fired when the component's state changes.
+ */
+export interface UseMaskChangeEvent {
+    /**
+     * The value of the component.
+     */
+    value: string | undefined;
+}
+/**
+ * The options for the `useMask` hook.
+ */
+export interface UseMaskOptions {
+    /**
+     * Mask pattern.
+     */
+    mask: string;
+    /**
+     * Defines if model sets the raw unmasked value to bound value or the formatted mask value.
+     * @default false
+     */
+    unmask?: string;
+    /**
+     * Placeholder character in mask, default is underscore.
+     * @default _
+     */
+    slotChar?: string;
+    /**
+     * Clears the incomplete value on blur.
+     * @default true
+     */
+    autoClear?: boolean;
+    /**
+     * Whether the components are clickable or not.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Callback function that is called when the value is changed.
+     * @param event The event that triggered the change.
+     * @param event.value The value of the component.
+     * @returns void
+     */
+    onMaskChange?: (event: UseMaskChangeEvent) => void;
+    /**
+     * Reference to the mask element.
+     */
+    target: HTMLInputElement;
+}
+export interface UseMaskExposes {
+    /**
+     * Handles input events for the masked input field.
+     * Processes character input and composition events while applying the mask pattern.
+     * @param event - The form or composition event from the input element
+     */
+    onMaskInput: (event: React.FormEvent<HTMLInputElement> | React.CompositionEvent<HTMLInputElement>) => void;
+    /**
+     * Handles keydown events for special key operations.
+     * Manages backspace, delete, escape, and enter key behaviors.
+     * @param event - The keyboard event from the input element
+     */
+    onMaskKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    /**
+     * Handles keypress events for character input validation.
+     * Validates and places characters according to the mask pattern.
+     * @param event - The keyboard event from the input element
+     */
+    onMaskKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    /**
+     * Handles focus events when the input gains focus.
+     * Initializes the mask display and sets the cursor position.
+     * @param event - The focus event from the input element
+     */
+    onMaskFocus: (event: React.FocusEvent<HTMLInputElement>) => void;
+    /**
+     * Handles blur events when the input loses focus.
+     * Validates the final value and triggers change events if needed.
+     * @param event - The focus event from the input element
+     */
+    onMaskBlur: (event: React.FocusEvent<HTMLInputElement>) => void;
+    /**
+     * Handles paste events for clipboard content insertion.
+     * Processes pasted content according to the mask pattern.
+     * @param event - The clipboard event from the input element
+     */
+    onMaskPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;
+}
+/**
+ * useMask hook is used to enter input in a certain format such as numeric, date, currency, email and phone.
+ *
+ * @param {UseMaskOptions} options - The options for the mask.
+ * @returns {UseMaskExposes} - The exposed methods for the mask.
+ *
+ * @example
+ * ```tsx
+ * const { onMaskInput, onMaskKeyDown, onMaskKeyPress, onMaskFocus, onMaskBlur, onMaskPaste } = useMask({
+ *        mask: '99/99/9999',
+ *        onMaskChange: (event: UseMaskChangeEvent) => setValue(event.value ?? ''),
+ *        target: ref
+ *    });
+ *
+ *    return (
+ *       <div className="card flex justify-center">
+ *           <InputText ref={ref} value={value} placeholder="99/99/9999" onInput={onMaskInput} onKeyDown={onMaskKeyDown} onKeyPress={onMaskKeyPress} onFocus={onMaskFocus} onBlur={onMaskBlur} onPaste={onMaskPaste} />
+ *       </div>
+ *    );
+ */
+export declare function useMask(options: UseMaskOptions): UseMaskExposes;

package/use-mask/index.mjs

@@ -0,0 +1,2 @@
+import{useMountEffect as te}from"@primereact/hooks";import{getUserAgent as x}from"@primeuix/utils";import*as i from"react";function ue(j){let{mask:m,unmask:N,slotChar:L="_",autoClear:O=!0,readOnly:v=!1,onMaskChange:K,target:s}=j,o=i.useRef(0),a=i.useRef([]),l=i.useRef([]),k=i.useRef(null),h=i.useRef(0),w=i.useRef(!1),P=i.useRef(!1),T=i.useRef(null),M=i.useRef(null),S=i.useRef(0),H=i.useRef(null),I=i.useRef(null),A=i.useRef(null),q=e=>{"isComposing"in e&&e.isComposing||(w.current?X():D(e))},z=e=>{var b;if(v)return;let t=e.code,r,n,u,c=/iphone/i.test(x());if(I.current=s==null?void 0:s.value,t==="Backspace"||t==="Delete"||c&&t==="Escape"){if(r=f(),!r)return;n=r.begin,u=r.end,u-n===0&&(n=t!=="Delete"?Q(n):u=d(n-1),u=t==="Delete"?d(u):u),y(n,u),F(n,u-1),g(e.target.value),e.preventDefault()}else t==="Enter"?(s.blur(),g(e.target.value)):t==="Escape"&&(s&&(s.value=(b=T.current)!=null?b:""),f(0,p()),g(e.target.value),e.preventDefault())},J=e=>{var b;if(v)return;let t=e.code,r=f(),n,u,c;r&&(e.ctrlKey||e.altKey||e.metaKey||e.shiftKey||e.key==="CapsLock"||e.key==="Escape"||e.key==="Tab"||(t&&t!=="Enter"&&(r.end-r.begin!==0&&(y(r.begin,r.end),F(r.begin,r.end-1)),n=d(r.begin-1),n<o.current&&(u=e.key,(b=a.current[n])!=null&&b.test(u)&&(W(n),l.current[n]=u,E(),c=d(n),/android/i.test(x())?setTimeout(()=>{f(c)},0):f(c))),e.preventDefault()),g(e.target.value)))},Z=()=>{if(!v)if(H.current&&clearTimeout(H.current),P.current=!0,T.current=s.value,!s.value||s.value===k.current)requestAnimationFrame(()=>{s===document.activeElement&&f(0,0)});else{let e=p();H.current=setTimeout(()=>{s===document.activeElement&&(E(),e===(m==null?void 0:m.replace("?","").length)?f(0,e):f(e))},10)}},_=e=>{if(P.current=!1,p(),g(e.target.value),s.value!==T.current){let t=new Event("change",{bubbles:!0,cancelable:!1});s.dispatchEvent(t)}},G=e=>{D(e)},f=(e,t)=>{var u,c;let r=0,n=0;return typeof e=="number"?(r=e,n=typeof t=="number"?t:r,s.setSelectionRange(r,n)):s&&(r=(u=s.selectionStart)!=null?u:0,n=(c=s.selectionEnd)!=null?c:0),{begin:r,end:n}},R=e=>e<L.length?L.charAt(e):L.charAt(0),d=e=>{for(;++e<o.current&&!a.current[e];);return e},Q=e=>{for(;--e>=0&&!a.current[e];);return e},F=(e,t)=>{var u,c;let r,n;if(!(e<0)){for(r=e,n=d(t);r<o.current;r++)if(a.current[r]){if(n<o.current&&((u=a.current[r])!=null&&u.test(l.current[n])))l.current[r]=l.current[n],l.current[n]=R(n);else break;n=d(n)}E(),f(Math.max((c=M.current)!=null?c:0,e))}},W=e=>{var c;let t,r,n,u;for(t=e,r=R(e);t<o.current;t++)if(a.current[t])if(n=d(t),u=l.current[t],l.current[t]=r,n<o.current&&((c=a.current[n])!=null&&c.test(u)))r=u;else break},X=()=>{var r;let e=s.value,t=f();if(t)if(I.current&&I.current.length&&I.current.length>e.length){for(p(!0);t.begin>0&&!a.current[t.begin-1];)t.begin--;if(t.begin===0)for(;t.begin<((r=M.current)!=null?r:0)&&!a.current[t.begin];)t.begin++;f(t.begin,t.begin)}else{for(p(!0);t.begin<o.current&&!a.current[t.begin];)t.begin++;f(t.begin,t.begin)}},y=(e,t)=>{let r;for(r=e;r<t&&r<o.current;r++)a.current[r]&&(l.current[r]=R(r))},E=()=>{s&&(s.value=l.current.join(""))},p=(e=!1)=>{var b,C,V,B;let t=s.value,r=-1,n,u,c;for(n=0,c=0;n<o.current;n++){let U=a.current[n];if(U!==null){for(l.current[n]=R(n);c++<((b=t==null?void 0:t.length)!=null?b:0);)if(u=(C=t==null?void 0:t.charAt(c-1))!=null?C:"",U.test(u)){l.current[n]=u,r=n;break}if(c>((V=t==null?void 0:t.length)!=null?V:0)){y(n+1,o.current);break}}else l.current[n]===(t==null?void 0:t.charAt(c))&&c++,n<h.current&&(r=n)}return e?E():r+1<h.current?O||l.current.join("")===k.current?(s.value&&(s.value=""),y(0,o.current)):E():(E(),s&&(s.value=s.value.substring(0,r+1))),h.current?n:(B=M.current)!=null?B:0},D=e=>{let t=e.type==="paste";if(v||t)return;let r=p(!0);f(r),g(e.target.value)},Y=e=>{let t=[],r=e.split("");for(let n=0;n<r.length;n++){let u=r[n];a.current[n]&&u!==R(n)&&t.push(u)}return t.join("")},g=e=>{if(A.current===e)return;let t=N?Y(e):e,r=k.current!==t?t:"";A.current=e,s&&(s.value=r),K&&K({value:r})},$=(e=!0)=>{s&&(s.value==null?(s.value="",e&&g("")):(p(),setTimeout(()=>{s&&(E(),p(),e&&g(s.value))},10)),T.current=s.value)},ee=()=>{a.current=[],h.current=m?m.length:0,o.current=m?m.length:0,M.current=null;let e={9:"[0-9]",a:"[A-Za-z]","*":"[A-Za-z0-9]"},t=x();w.current=/chrome/i.test(t)&&/android/i.test(t);let r=m?m.split(""):"";for(let n=0;n<r.length;n++){let u=r[n];u==="?"?(o.current--,h.current=n):e[u]?(a.current.push(new RegExp(e[u])),M.current===null&&(M.current=a.current.length-1),n<h.current&&(S.current=a.current.length-1)):a.current.push(null)}l.current=[];for(let n=0;n<r.length;n++){let u=r[n];u!=="?"&&(e[u]?l.current.push(R(n)):l.current.push(u))}k.current=l.current.join(""),$(!1)};return te(()=>{ee()}),{onMaskInput:q,onMaskKeyDown:z,onMaskKeyPress:J,onMaskFocus:Z,onMaskBlur:_,onMaskPaste:G}}export{ue as useMask};
+//# sourceMappingURL=index.mjs.map

package/use-mask/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/use-mask/index.ts"],"sourcesContent":["import { useMountEffect } from '@primereact/hooks';\nimport { getUserAgent } from '@primeuix/utils';\nimport * as React from 'react';\n\n/**\n * Event fired when the component's state changes.\n */\nexport interface UseMaskChangeEvent {\n    /**\n     * The value of the component.\n     */\n    value: string | undefined;\n}\n\n/**\n * The options for the `useMask` hook.\n */\nexport interface UseMaskOptions {\n    /**\n     * Mask pattern.\n     */\n    mask: string;\n    /**\n     * Defines if model sets the raw unmasked value to bound value or the formatted mask value.\n     * @default false\n     */\n    unmask?: string;\n    /**\n     * Placeholder character in mask, default is underscore.\n     * @default _\n     */\n    slotChar?: string;\n    /**\n     * Clears the incomplete value on blur.\n     * @default true\n     */\n    autoClear?: boolean;\n    /**\n     * Whether the components are clickable or not.\n     * @default false\n     */\n    readOnly?: boolean;\n    /**\n     * Callback function that is called when the value is changed.\n     * @param event The event that triggered the change.\n     * @param event.value The value of the component.\n     * @returns void\n     */\n    onMaskChange?: (event: UseMaskChangeEvent) => void;\n    /**\n     * Reference to the mask element.\n     */\n    target: HTMLInputElement;\n}\n\nexport interface UseMaskExposes {\n    /**\n     * Handles input events for the masked input field.\n     * Processes character input and composition events while applying the mask pattern.\n     * @param event - The form or composition event from the input element\n     */\n    onMaskInput: (event: React.FormEvent<HTMLInputElement> | React.CompositionEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keydown events for special key operations.\n     * Manages backspace, delete, escape, and enter key behaviors.\n     * @param event - The keyboard event from the input element\n     */\n    onMaskKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles keypress events for character input validation.\n     * Validates and places characters according to the mask pattern.\n     * @param event - The keyboard event from the input element\n     */\n    onMaskKeyPress: (event: React.KeyboardEvent<HTMLInputElement>) => void;\n    /**\n     * Handles focus events when the input gains focus.\n     * Initializes the mask display and sets the cursor position.\n     * @param event - The focus event from the input element\n     */\n    onMaskFocus: (event: React.FocusEvent<HTMLInputElement>) => void;\n    /**\n     * Handles blur events when the input loses focus.\n     * Validates the final value and triggers change events if needed.\n     * @param event - The focus event from the input element\n     */\n    onMaskBlur: (event: React.FocusEvent<HTMLInputElement>) => void;\n    /**\n     * Handles paste events for clipboard content insertion.\n     * Processes pasted content according to the mask pattern.\n     * @param event - The clipboard event from the input element\n     */\n    onMaskPaste: (event: React.ClipboardEvent<HTMLInputElement>) => void;\n}\n\n/**\n * useMask hook is used to enter input in a certain format such as numeric, date, currency, email and phone.\n *\n * @param {UseMaskOptions} options - The options for the mask.\n * @returns {UseMaskExposes} - The exposed methods for the mask.\n *\n * @example\n * ```tsx\n * const { onMaskInput, onMaskKeyDown, onMaskKeyPress, onMaskFocus, onMaskBlur, onMaskPaste } = useMask({\n *        mask: '99/99/9999',\n *        onMaskChange: (event: UseMaskChangeEvent) => setValue(event.value ?? ''),\n *        target: ref\n *    });\n *\n *    return (\n *       <div className=\"card flex justify-center\">\n *           <InputText ref={ref} value={value} placeholder=\"99/99/9999\" onInput={onMaskInput} onKeyDown={onMaskKeyDown} onKeyPress={onMaskKeyPress} onFocus={onMaskFocus} onBlur={onMaskBlur} onPaste={onMaskPaste} />\n *       </div>\n *    );\n */\nexport function useMask(options: UseMaskOptions): UseMaskExposes {\n    const { mask, unmask, slotChar = '_', autoClear = true, readOnly = false, onMaskChange, target } = options;\n\n    const len = React.useRef(0);\n    const tests = React.useRef<Array<RegExp | null>>([]);\n    const buffer = React.useRef<string[]>([]);\n    const defaultBuffer = React.useRef<string | null>(null);\n    const partialPosition = React.useRef<number>(0);\n    const androidChrome = React.useRef(false);\n    const focus = React.useRef(false);\n    const focusText = React.useRef<string | null>(null);\n    const firstNonMaskPos = React.useRef<number | null>(null);\n    const lastRequiredNonMaskPos = React.useRef<number>(0);\n    const caretTimeoutId = React.useRef<NodeJS.Timeout | null>(null);\n    const oldVal = React.useRef<string | null>(null);\n    const currentVal = React.useRef<string | null>(null);\n\n    const onMaskInput = (event: React.FormEvent<HTMLInputElement> | React.CompositionEvent<HTMLInputElement>) => {\n        // Check if the event is part of a text composition process (e.g., for Asian languages).\n        // If event.isComposing is true, it means the user is still composing text and the input is not finalized.\n        if ('isComposing' in event && event.isComposing) {\n            return;\n        }\n\n        if (androidChrome.current) handleAndroidInput();\n        else handleInputChange(event);\n    };\n\n    const onMaskKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        if (readOnly) {\n            return;\n        }\n\n        const k = event.code;\n        let pos, begin, end;\n        const iPhone = /iphone/i.test(getUserAgent());\n\n        oldVal.current = target?.value as string;\n\n        //backspace, delete, and escape get special treatment\n        if (k === 'Backspace' || k === 'Delete' || (iPhone && k === 'Escape')) {\n            pos = caret();\n\n            if (!pos) {\n                return;\n            }\n\n            begin = pos.begin;\n            end = pos.end;\n\n            if (end - begin === 0) {\n                begin = k !== 'Delete' ? seekPrev(begin) : (end = seekNext(begin - 1));\n                end = k === 'Delete' ? seekNext(end) : end;\n            }\n\n            clearBuffer(begin, end);\n            shiftL(begin, end - 1);\n            updateModelValue((event.target as HTMLInputElement).value);\n\n            event.preventDefault();\n        } else if (k === 'Enter') {\n            // enter\n            target.blur();\n            updateModelValue((event.target as HTMLInputElement).value);\n        } else if (k === 'Escape') {\n            // escape\n            if (target) {\n                target.value = focusText.current ?? '';\n            }\n\n            caret(0, checkVal());\n            updateModelValue((event.target as HTMLInputElement).value);\n            event.preventDefault();\n        }\n    };\n\n    const onMaskKeyPress = (event: React.KeyboardEvent<HTMLInputElement>) => {\n        if (readOnly) {\n            return;\n        }\n\n        const k = event.code,\n            pos = caret();\n        let p: number, c: string, next: number;\n\n        if (!pos) {\n            return;\n        }\n\n        if (event.ctrlKey || event.altKey || event.metaKey || event.shiftKey || event.key === 'CapsLock' || event.key === 'Escape' || event.key === 'Tab') {\n            //Ignore\n            return;\n        } else if (k && k !== 'Enter') {\n            if (pos.end - pos.begin !== 0) {\n                clearBuffer(pos.begin, pos.end);\n                shiftL(pos.begin, pos.end - 1);\n            }\n\n            p = seekNext(pos.begin - 1);\n\n            if (p < len.current) {\n                c = event.key;\n\n                if (tests.current[p]?.test(c)) {\n                    shiftR(p);\n\n                    buffer.current[p] = c;\n                    writeBuffer();\n                    next = seekNext(p);\n\n                    if (/android/i.test(getUserAgent())) {\n                        //Path for CSP Violation on FireFox OS 1.1\n                        const proxy = () => {\n                            caret(next);\n                        };\n\n                        setTimeout(proxy, 0);\n                    } else {\n                        caret(next);\n                    }\n                }\n            }\n\n            event.preventDefault();\n        }\n\n        updateModelValue((event.target as HTMLInputElement).value);\n    };\n\n    const onMaskFocus = () => {\n        if (readOnly) {\n            return;\n        }\n\n        if (caretTimeoutId.current) {\n            clearTimeout(caretTimeoutId.current as NodeJS.Timeout);\n        }\n\n        focus.current = true;\n        focusText.current = target.value as string;\n\n        if (!target.value || target.value === defaultBuffer.current) {\n            requestAnimationFrame(() => {\n                if (target === document.activeElement) {\n                    caret(0, 0);\n                }\n            });\n        } else {\n            const pos = checkVal();\n\n            caretTimeoutId.current = setTimeout(() => {\n                if (target !== document.activeElement) {\n                    return;\n                }\n\n                writeBuffer();\n\n                if (pos === mask?.replace('?', '').length) {\n                    caret(0, pos);\n                } else {\n                    caret(pos);\n                }\n            }, 10);\n        }\n    };\n\n    const onMaskBlur = (event: React.FocusEvent<HTMLInputElement>) => {\n        focus.current = false;\n        checkVal();\n        updateModelValue(event.target.value);\n\n        if (target.value !== focusText.current) {\n            const e = new Event('change', { bubbles: true, cancelable: false });\n\n            target.dispatchEvent(e);\n        }\n    };\n\n    const onMaskPaste = (event: React.ClipboardEvent<HTMLInputElement>) => {\n        handleInputChange(event);\n    };\n\n    const caret = (first?: number, last?: number): { begin: number; end: number } | undefined => {\n        let begin = 0,\n            end = 0;\n\n        if (typeof first === 'number') {\n            begin = first;\n            end = typeof last === 'number' ? last : begin;\n\n            target.setSelectionRange(begin, end);\n        } else {\n            if (target) {\n                begin = target.selectionStart ?? 0;\n                end = target.selectionEnd ?? 0;\n            }\n        }\n\n        return { begin, end };\n    };\n\n    const getPlaceholder = (i: number) => {\n        if (i < slotChar.length) {\n            return slotChar.charAt(i);\n        }\n\n        return slotChar.charAt(0);\n    };\n\n    const seekNext = (pos: number) => {\n        while (++pos < len.current && !tests.current[pos]);\n\n        return pos;\n    };\n\n    const seekPrev = (pos: number) => {\n        while (--pos >= 0 && !tests.current[pos]);\n\n        return pos;\n    };\n\n    const shiftL = (begin: number, end: number) => {\n        let i, j;\n\n        if (begin < 0) {\n            return;\n        }\n\n        for (i = begin, j = seekNext(end); i < len.current; i++) {\n            if (tests.current[i]) {\n                if (j < len.current && tests.current[i]?.test(buffer.current[j])) {\n                    buffer.current[i] = buffer.current[j];\n                    buffer.current[j] = getPlaceholder(j);\n                } else {\n                    break;\n                }\n\n                j = seekNext(j);\n            }\n        }\n\n        writeBuffer();\n        caret(Math.max(firstNonMaskPos.current ?? 0, begin));\n    };\n\n    const shiftR = (pos: number) => {\n        let i, c, j, t;\n\n        for (i = pos, c = getPlaceholder(pos); i < len.current; i++) {\n            if (tests.current[i]) {\n                j = seekNext(i);\n                t = buffer.current[i];\n                buffer.current[i] = c;\n\n                if (j < len.current && tests.current[j]?.test(t)) {\n                    c = t;\n                } else {\n                    break;\n                }\n            }\n        }\n    };\n\n    const handleAndroidInput = () => {\n        const curVal = target.value as string;\n        const pos = caret();\n\n        if (!pos) {\n            return;\n        }\n\n        if (oldVal.current && oldVal.current.length && oldVal.current.length > curVal.length) {\n            // a deletion or backspace happened\n            checkVal(true);\n            while (pos.begin > 0 && !tests.current[pos.begin - 1]) pos.begin--;\n\n            if (pos.begin === 0) {\n                while (pos.begin < (firstNonMaskPos.current ?? 0) && !tests.current[pos.begin]) pos.begin++;\n            }\n\n            caret(pos.begin, pos.begin);\n        } else {\n            checkVal(true);\n            while (pos.begin < len.current && !tests.current[pos.begin]) pos.begin++;\n\n            caret(pos.begin, pos.begin);\n        }\n    };\n\n    const clearBuffer = (start: number, end: number) => {\n        let i;\n\n        for (i = start; i < end && i < len.current; i++) {\n            if (tests.current[i]) {\n                buffer.current[i] = getPlaceholder(i);\n            }\n        }\n    };\n\n    const writeBuffer = () => {\n        if (target) {\n            target.value = buffer.current.join('');\n        }\n    };\n\n    const checkVal = (allow = false): number => {\n        //try to place characters where they belong\n        const test = target.value;\n        let lastMatch = -1,\n            i,\n            c,\n            pos;\n\n        for (i = 0, pos = 0; i < len.current; i++) {\n            const currentTest = tests.current[i];\n\n            if (currentTest !== null) {\n                buffer.current[i] = getPlaceholder(i);\n\n                while (pos++ < (test?.length ?? 0)) {\n                    c = test?.charAt(pos - 1) ?? '';\n\n                    if (currentTest.test(c)) {\n                        buffer.current[i] = c;\n                        lastMatch = i;\n                        break;\n                    }\n                }\n\n                if (pos > (test?.length ?? 0)) {\n                    clearBuffer(i + 1, len.current);\n                    break;\n                }\n            } else {\n                if (buffer.current[i] === test?.charAt(pos)) {\n                    pos++;\n                }\n\n                if (i < partialPosition.current) {\n                    lastMatch = i;\n                }\n            }\n        }\n\n        if (allow) {\n            writeBuffer();\n        } else if (lastMatch + 1 < partialPosition.current) {\n            if (autoClear || buffer.current.join('') === defaultBuffer.current) {\n                // Invalid value. Remove it and replace it with the\n                // mask, which is the default behavior.\n                if (target.value) {\n                    target.value = '';\n                }\n\n                clearBuffer(0, len.current);\n            } else {\n                // Invalid value, but we opt to show the value to the\n                // user and allow them to correct their mistake.\n                writeBuffer();\n            }\n        } else {\n            writeBuffer();\n\n            if (target) {\n                target.value = target.value.substring(0, lastMatch + 1);\n            }\n        }\n\n        return partialPosition.current ? i : (firstNonMaskPos.current ?? 0);\n    };\n\n    const handleInputChange = (event: React.FormEvent<HTMLInputElement> | React.ClipboardEvent<HTMLInputElement>) => {\n        const isPasteEvent = event.type === 'paste';\n\n        if (readOnly || isPasteEvent) {\n            return;\n        }\n\n        const pos = checkVal(true);\n\n        caret(pos);\n        updateModelValue((event.target as HTMLInputElement).value);\n    };\n\n    const unmaskValue = (value: string) => {\n        const unmaskedBuffer = [];\n        const thisbuffer = value.split('');\n\n        for (let i = 0; i < thisbuffer.length; i++) {\n            const c = thisbuffer[i];\n\n            if (tests.current[i] && c !== getPlaceholder(i)) {\n                unmaskedBuffer.push(c);\n            }\n        }\n\n        return unmaskedBuffer.join('');\n    };\n\n    const updateModelValue = (value: string) => {\n        if (currentVal.current === value) return;\n\n        const val = unmask ? unmaskValue(value) : value;\n        const finalValue = defaultBuffer.current !== val ? val : '';\n\n        currentVal.current = value;\n\n        if (target) {\n            target.value = finalValue;\n        }\n\n        // Call the onMaskChange callback to update React state\n        if (onMaskChange) {\n            onMaskChange({ value: finalValue });\n        }\n    };\n\n    const updateValue = (updateModel = true) => {\n        if (target) {\n            if (target.value == null) {\n                target.value = '';\n\n                if (updateModel) {\n                    updateModelValue('');\n                }\n            } else {\n                checkVal();\n\n                setTimeout(() => {\n                    if (target) {\n                        writeBuffer();\n                        checkVal();\n\n                        if (updateModel) updateModelValue(target.value);\n                    }\n                }, 10);\n            }\n\n            focusText.current = target.value;\n        }\n    };\n\n    const initMask = () => {\n        tests.current = [];\n        partialPosition.current = mask ? mask.length : 0;\n        len.current = mask ? mask.length : 0;\n        firstNonMaskPos.current = null;\n        const defs = {\n            9: '[0-9]',\n            a: '[A-Za-z]',\n            '*': '[A-Za-z0-9]'\n        } as Record<string, string>;\n\n        const ua = getUserAgent();\n\n        androidChrome.current = /chrome/i.test(ua) && /android/i.test(ua);\n\n        const maskTokens = mask ? mask.split('') : '';\n\n        for (let i = 0; i < maskTokens.length; i++) {\n            const c = maskTokens[i];\n\n            if (c === '?') {\n                len.current--;\n                partialPosition.current = i;\n            } else if (defs[c]) {\n                tests.current.push(new RegExp(defs[c]));\n\n                if (firstNonMaskPos.current === null) {\n                    firstNonMaskPos.current = tests.current.length - 1;\n                }\n\n                if (i < partialPosition.current) {\n                    lastRequiredNonMaskPos.current = tests.current.length - 1;\n                }\n            } else {\n                tests.current.push(null);\n            }\n        }\n\n        buffer.current = [];\n\n        for (let i = 0; i < maskTokens.length; i++) {\n            const c = maskTokens[i];\n\n            if (c !== '?') {\n                if (defs[c]) buffer.current.push(getPlaceholder(i));\n                else buffer.current.push(c);\n            }\n        }\n\n        defaultBuffer.current = buffer.current.join('');\n\n        updateValue(false);\n    };\n\n    useMountEffect(() => {\n        initMask();\n    });\n\n    return {\n        onMaskInput,\n        onMaskKeyDown,\n        onMaskKeyPress,\n        onMaskFocus,\n        onMaskBlur,\n        onMaskPaste\n    };\n}\n"],"mappings":"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","names":["useMountEffect","getUserAgent","React","useMask","options","mask","unmask","slotChar","autoClear","readOnly","onMaskChange","target","len","tests","buffer","defaultBuffer","partialPosition","androidChrome","focus","focusText","firstNonMaskPos","lastRequiredNonMaskPos","caretTimeoutId","oldVal","currentVal","onMaskInput","event","handleAndroidInput","handleInputChange","onMaskKeyDown","_a","k","pos","begin","end","iPhone","caret","seekPrev","seekNext","clearBuffer","shiftL","updateModelValue","checkVal","onMaskKeyPress","p","c","next","shiftR","writeBuffer","onMaskFocus","onMaskBlur","e","onMaskPaste","first","last","_b","getPlaceholder","i","j","t","curVal","start","allow","_c","_d","test","lastMatch","currentTest","isPasteEvent","unmaskValue","value","unmaskedBuffer","thisbuffer","val","finalValue","updateValue","updateModel","initMask","defs","ua","maskTokens"]}