@alessiofrittoli/react-hooks 1.1.0 → 2.0.0

package/dist/browser-api/storage/useSessionStorage.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/browser-api/storage/useStorage.ts","../../../src/browser-api/storage/useSessionStorage.ts"],"names":["useStorage","key","initialValue","type","readValue","useCallback","LocalStorage","SessionStorage","storedValue","setStoredValue","useState","setValue","value","valueToStore","useEffect","useSessionStorage"],"mappings":"6MAcO,IAAMA,CAAAA,CAAa,CACzBC,CAAAA,CACAC,EACAC,CAA+B,CAAA,OAAA,GACO,CAEtC,IAAMC,CAAYC,CAAAA,WAAAA,CAAa,KAC5BF,CAAS,GAAA,OAAA,CAAUG,YAAeC,CAAAA,cAAAA,EAClC,GAAQN,CAAAA,CAAI,GAAKC,CACjB,CAAA,CAAEC,CAAMF,CAAAA,CAAAA,CAAKC,CAAa,CAAE,EAQzB,CAAEM,CAAAA,CAAaC,CAAe,CAAA,CAAIC,QAAoBR,CAAAA,CAAa,CAQnES,CAAAA,CAAAA,CAAWN,WAAiCO,CAAAA,CAAAA,EAAS,CAE1DH,CAAAA,CAAgBD,CAAe,EAAA,CAC9B,IAAMK,CAAeD,CAAAA,CAAAA,YAAiB,QAAWA,CAAAA,CAAAA,CAAOJ,CAAY,CAAA,CAAII,EAEvE,OACA,CAAA,OAAO,MAAW,CAAA,GAAA,EAClBT,CAAS,GAAA,OAAA,CAAUG,aAAeC,cACjC,EAAA,GAAA,CAAKN,CAAKY,CAAAA,CAAa,CAElBA,CAAAA,CACR,CAAE,EAGH,CAAA,CAAG,CAAEV,CAAAA,CAAMF,CAAI,CAAE,EAEjB,OAAAa,SAAAA,CAAW,IAAM,CAChBL,CAAgBL,CAAAA,CAAAA,EAAY,EAC7B,CAAA,CAAG,CAAEA,CAAU,CAAE,CAAA,CAEV,CAAEI,CAAaG,CAAAA,CAAS,CAChC,CAAA,CCpDaI,IAAAA,CAAAA,CAAoB,CAChCd,CAAAA,CACAC,CACIF,GAAAA,CAAAA,CAAYC,CAAKC,CAAAA,CAAAA,CAAc,SAAU","file":"useSessionStorage.mjs","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { LocalStorage } from '@alessiofrittoli/web-utils/storage/LocalStorage'\nimport { SessionStorage } from '@alessiofrittoli/web-utils/storage/SessionStorage'\n\ntype Value<T>\t\t= T | undefined | null\ntype SetValue<T>\t= React.Dispatch<React.SetStateAction<T>>\n\n/**\n * Easly handle Local or Session Storage State.\n * \n * @param\tkey\t\t\t\tThe storage item key.\n * @param\tinitialValue\tThe storage item initial value.\n * @param\ttype\t\t\t( Optional ) The storage API to use. Default: `local`.\n */\nexport const useStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T,\n\ttype\t\t\t: 'local' | 'session' = 'local'\n): [ Value<T>, SetValue<Value<T>> ] => {\n\n\tconst readValue = useCallback( () => (\n\t\t( type === 'local' ? LocalStorage : SessionStorage )\n\t\t\t.get<T>( key ) ?? initialValue\n\t), [ type, key, initialValue ] )\n\n\n\t/**\n\t * State to store our value.\n\t * Pass initial state function to useState so logic is only executed once.\n\t * \n\t */\n\tconst [ storedValue, setStoredValue ] = useState<Value<T>>( initialValue )\n\n\t/**\n\t * Return a wrapped version of useState's setter function that\n\t * persists the new value to localStorage | sessionStorage.\n\t * \n\t * @param value The SetStateAction value.\n\t */\n\tconst setValue = useCallback<SetValue<Value<T>>>( value => {\n\n\t\tsetStoredValue( storedValue => {\n\t\t\tconst valueToStore = value instanceof Function ? value( storedValue ) : value\n\t\n\t\t\t;(\n\t\t\t\ttypeof window !== 'undefined' &&\n\t\t\t\ttype === 'local' ? LocalStorage : SessionStorage\n\t\t\t).set( key, valueToStore )\n\n\t\t\treturn valueToStore\n\t\t} )\n\n\n\t}, [ type, key ] )\n\n\tuseEffect( () => {\n\t\tsetStoredValue( readValue() )\n\t}, [ readValue ] )\n\n\treturn [ storedValue, setValue ]\n}","import { useStorage } from './useStorage'\n\n/**\n * useSessionStorage hook.\n * \n * @param\tkey\t\t\t\tThe session item key.\n * @param\tinitialValue\tThe session item initial value.\n */\nexport const useSessionStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T\n) => useStorage( key, initialValue, 'session' )"]}

package/dist/browser-api/storage/useStorage.d.mts

@@ -1,12 +0,0 @@
-type Value<T> = T | undefined | null;
-type SetValue<T> = React.Dispatch<React.SetStateAction<T>>;
-/**
- * Easly handle Local or Session Storage State.
- *
- * @param	key				The storage item key.
- * @param	initialValue	The storage item initial value.
- * @param	type			( Optional ) The storage API to use. Default: `local`.
- */
-declare const useStorage: <T = string>(key: string, initialValue?: T, type?: "local" | "session") => [Value<T>, SetValue<Value<T>>];
-
-export { useStorage };

package/dist/browser-api/storage/useStorage.d.ts

@@ -1,12 +0,0 @@
-type Value<T> = T | undefined | null;
-type SetValue<T> = React.Dispatch<React.SetStateAction<T>>;
-/**
- * Easly handle Local or Session Storage State.
- *
- * @param	key				The storage item key.
- * @param	initialValue	The storage item initial value.
- * @param	type			( Optional ) The storage API to use. Default: `local`.
- */
-declare const useStorage: <T = string>(key: string, initialValue?: T, type?: "local" | "session") => [Value<T>, SetValue<Value<T>>];
-
-export { useStorage };

package/dist/browser-api/storage/useStorage.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react'),LocalStorage=require('@alessiofrittoli/web-utils/storage/LocalStorage'),SessionStorage=require('@alessiofrittoli/web-utils/storage/SessionStorage');var w=(e,o,t="local")=>{let s=react.useCallback(()=>(t==="local"?LocalStorage.LocalStorage:SessionStorage.SessionStorage).get(e)??o,[t,e,o]),[S,l]=react.useState(o),T=react.useCallback(a=>{l(V=>{let n=a instanceof Function?a(V):a;return (typeof window<"u"&&t==="local"?LocalStorage.LocalStorage:SessionStorage.SessionStorage).set(e,n),n});},[t,e]);return react.useEffect(()=>{l(s());},[s]),[S,T]};exports.useStorage=w;//# sourceMappingURL=useStorage.js.map
-//# sourceMappingURL=useStorage.js.map

package/dist/browser-api/storage/useStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/browser-api/storage/useStorage.ts"],"names":["useStorage","key","initialValue","type","readValue","useCallback","LocalStorage","SessionStorage","storedValue","setStoredValue","useState","setValue","value","valueToStore","useEffect"],"mappings":"4LAcaA,IAAAA,CAAAA,CAAa,CACzBC,CACAC,CAAAA,CAAAA,CACAC,CAA+B,CAAA,OAAA,GACO,CAEtC,IAAMC,EAAYC,iBAAa,CAAA,IAAA,CAC5BF,IAAS,OAAUG,CAAAA,yBAAAA,CAAeC,+BAClC,GAAQN,CAAAA,CAAI,CAAKC,EAAAA,CAAAA,CACjB,CAAEC,CAAAA,CAAMF,EAAKC,CAAa,CAAE,EAQzB,CAAEM,CAAAA,CAAaC,CAAe,CAAIC,CAAAA,cAAAA,CAAoBR,CAAa,CAAA,CAQnES,CAAWN,CAAAA,iBAAAA,CAAiCO,GAAS,CAE1DH,CAAAA,CAAgBD,GAAe,CAC9B,IAAMK,EAAeD,CAAiB,YAAA,QAAA,CAAWA,CAAOJ,CAAAA,CAAY,CAAII,CAAAA,CAAAA,CAEvE,QACA,OAAO,MAAA,CAAW,KAClBT,CAAS,GAAA,OAAA,CAAUG,0BAAeC,6BACjC,EAAA,GAAA,CAAKN,CAAKY,CAAAA,CAAa,CAElBA,CAAAA,CACR,CAAE,EAGH,CAAA,CAAG,CAAEV,CAAMF,CAAAA,CAAI,CAAE,CAEjB,CAAA,OAAAa,eAAW,CAAA,IAAM,CAChBL,CAAAA,CAAgBL,GAAY,EAC7B,EAAG,CAAEA,CAAU,CAAE,CAEV,CAAA,CAAEI,CAAaG,CAAAA,CAAS,CAChC","file":"useStorage.js","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { LocalStorage } from '@alessiofrittoli/web-utils/storage/LocalStorage'\nimport { SessionStorage } from '@alessiofrittoli/web-utils/storage/SessionStorage'\n\ntype Value<T>\t\t= T | undefined | null\ntype SetValue<T>\t= React.Dispatch<React.SetStateAction<T>>\n\n/**\n * Easly handle Local or Session Storage State.\n * \n * @param\tkey\t\t\t\tThe storage item key.\n * @param\tinitialValue\tThe storage item initial value.\n * @param\ttype\t\t\t( Optional ) The storage API to use. Default: `local`.\n */\nexport const useStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T,\n\ttype\t\t\t: 'local' | 'session' = 'local'\n): [ Value<T>, SetValue<Value<T>> ] => {\n\n\tconst readValue = useCallback( () => (\n\t\t( type === 'local' ? LocalStorage : SessionStorage )\n\t\t\t.get<T>( key ) ?? initialValue\n\t), [ type, key, initialValue ] )\n\n\n\t/**\n\t * State to store our value.\n\t * Pass initial state function to useState so logic is only executed once.\n\t * \n\t */\n\tconst [ storedValue, setStoredValue ] = useState<Value<T>>( initialValue )\n\n\t/**\n\t * Return a wrapped version of useState's setter function that\n\t * persists the new value to localStorage | sessionStorage.\n\t * \n\t * @param value The SetStateAction value.\n\t */\n\tconst setValue = useCallback<SetValue<Value<T>>>( value => {\n\n\t\tsetStoredValue( storedValue => {\n\t\t\tconst valueToStore = value instanceof Function ? value( storedValue ) : value\n\t\n\t\t\t;(\n\t\t\t\ttypeof window !== 'undefined' &&\n\t\t\t\ttype === 'local' ? LocalStorage : SessionStorage\n\t\t\t).set( key, valueToStore )\n\n\t\t\treturn valueToStore\n\t\t} )\n\n\n\t}, [ type, key ] )\n\n\tuseEffect( () => {\n\t\tsetStoredValue( readValue() )\n\t}, [ readValue ] )\n\n\treturn [ storedValue, setValue ]\n}"]}

package/dist/browser-api/storage/useStorage.mjs

@@ -1,2 +0,0 @@
-import {useCallback,useState,useEffect}from'react';import {LocalStorage}from'@alessiofrittoli/web-utils/storage/LocalStorage';import {SessionStorage}from'@alessiofrittoli/web-utils/storage/SessionStorage';var R=(e,o,t="local")=>{let s=useCallback(()=>(t==="local"?LocalStorage:SessionStorage).get(e)??o,[t,e,o]),[S,l]=useState(o),T=useCallback(a=>{l(V=>{let n=a instanceof Function?a(V):a;return (typeof window<"u"&&t==="local"?LocalStorage:SessionStorage).set(e,n),n});},[t,e]);return useEffect(()=>{l(s());},[s]),[S,T]};export{R as useStorage};//# sourceMappingURL=useStorage.mjs.map
-//# sourceMappingURL=useStorage.mjs.map

package/dist/browser-api/storage/useStorage.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/browser-api/storage/useStorage.ts"],"names":["useStorage","key","initialValue","type","readValue","useCallback","LocalStorage","SessionStorage","storedValue","setStoredValue","useState","setValue","value","valueToStore","useEffect"],"mappings":"6MAcaA,IAAAA,CAAAA,CAAa,CACzBC,CACAC,CAAAA,CAAAA,CACAC,CAA+B,CAAA,OAAA,GACO,CAEtC,IAAMC,EAAYC,WAAa,CAAA,IAAA,CAC5BF,IAAS,OAAUG,CAAAA,YAAAA,CAAeC,gBAClC,GAAQN,CAAAA,CAAI,CAAKC,EAAAA,CAAAA,CACjB,CAAEC,CAAAA,CAAMF,EAAKC,CAAa,CAAE,EAQzB,CAAEM,CAAAA,CAAaC,CAAe,CAAIC,CAAAA,QAAAA,CAAoBR,CAAa,CAAA,CAQnES,CAAWN,CAAAA,WAAAA,CAAiCO,GAAS,CAE1DH,CAAAA,CAAgBD,GAAe,CAC9B,IAAMK,EAAeD,CAAiB,YAAA,QAAA,CAAWA,CAAOJ,CAAAA,CAAY,CAAII,CAAAA,CAAAA,CAEvE,QACA,OAAO,MAAA,CAAW,KAClBT,CAAS,GAAA,OAAA,CAAUG,aAAeC,cACjC,EAAA,GAAA,CAAKN,CAAKY,CAAAA,CAAa,CAElBA,CAAAA,CACR,CAAE,EAGH,CAAA,CAAG,CAAEV,CAAMF,CAAAA,CAAI,CAAE,CAEjB,CAAA,OAAAa,SAAW,CAAA,IAAM,CAChBL,CAAAA,CAAgBL,GAAY,EAC7B,EAAG,CAAEA,CAAU,CAAE,CAEV,CAAA,CAAEI,CAAaG,CAAAA,CAAS,CAChC","file":"useStorage.mjs","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { LocalStorage } from '@alessiofrittoli/web-utils/storage/LocalStorage'\nimport { SessionStorage } from '@alessiofrittoli/web-utils/storage/SessionStorage'\n\ntype Value<T>\t\t= T | undefined | null\ntype SetValue<T>\t= React.Dispatch<React.SetStateAction<T>>\n\n/**\n * Easly handle Local or Session Storage State.\n * \n * @param\tkey\t\t\t\tThe storage item key.\n * @param\tinitialValue\tThe storage item initial value.\n * @param\ttype\t\t\t( Optional ) The storage API to use. Default: `local`.\n */\nexport const useStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T,\n\ttype\t\t\t: 'local' | 'session' = 'local'\n): [ Value<T>, SetValue<Value<T>> ] => {\n\n\tconst readValue = useCallback( () => (\n\t\t( type === 'local' ? LocalStorage : SessionStorage )\n\t\t\t.get<T>( key ) ?? initialValue\n\t), [ type, key, initialValue ] )\n\n\n\t/**\n\t * State to store our value.\n\t * Pass initial state function to useState so logic is only executed once.\n\t * \n\t */\n\tconst [ storedValue, setStoredValue ] = useState<Value<T>>( initialValue )\n\n\t/**\n\t * Return a wrapped version of useState's setter function that\n\t * persists the new value to localStorage | sessionStorage.\n\t * \n\t * @param value The SetStateAction value.\n\t */\n\tconst setValue = useCallback<SetValue<Value<T>>>( value => {\n\n\t\tsetStoredValue( storedValue => {\n\t\t\tconst valueToStore = value instanceof Function ? value( storedValue ) : value\n\t\n\t\t\t;(\n\t\t\t\ttypeof window !== 'undefined' &&\n\t\t\t\ttype === 'local' ? LocalStorage : SessionStorage\n\t\t\t).set( key, valueToStore )\n\n\t\t\treturn valueToStore\n\t\t} )\n\n\n\t}, [ type, key ] )\n\n\tuseEffect( () => {\n\t\tsetStoredValue( readValue() )\n\t}, [ readValue ] )\n\n\treturn [ storedValue, setValue ]\n}"]}

package/dist/browser-api/useIsPortrait.d.mts

@@ -1,10 +0,0 @@
-/**
- * Check if device is portrait oriented.
- *
- * State get updated when device orientation changes.
- *
- * @returns	`true` if the device is portrait oriented, `false` otherwise.
- */
-declare const useIsPortrait: () => boolean;
-
-export { useIsPortrait };

package/dist/browser-api/useIsPortrait.d.ts

@@ -1,10 +0,0 @@
-/**
- * Check if device is portrait oriented.
- *
- * State get updated when device orientation changes.
- *
- * @returns	`true` if the device is portrait oriented, `false` otherwise.
- */
-declare const useIsPortrait: () => boolean;
-
-export { useIsPortrait };

package/dist/browser-api/useIsPortrait.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react'),browserApi=require('@alessiofrittoli/web-utils/browser-api'),device=require('@alessiofrittoli/web-utils/device');var o=e=>{let[s,i]=react.useState(browserApi.getMediaMatches(e)),t=react.useCallback(()=>i(browserApi.getMediaMatches(e)),[e]);return react.useEffect(()=>{let a=window.matchMedia(e);return t(),a.addEventListener("change",t),()=>{a.removeEventListener("change",t);}},[e,t]),s};var v=()=>o(device.portraitMediaQuery);exports.useIsPortrait=v;//# sourceMappingURL=useIsPortrait.js.map
-//# sourceMappingURL=useIsPortrait.js.map

package/dist/browser-api/useIsPortrait.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/browser-api/useMediaQuery.ts","../../src/browser-api/useIsPortrait.ts"],"names":["useMediaQuery","query","matches","setMatches","useState","getMediaMatches","matchMediaChangeHandler","useCallback","useEffect","matchMedia","useIsPortrait","portraitMediaQuery"],"mappings":"yJAYO,IAAMA,CAAAA,CAAkBC,CAAmB,EAAA,CAEjD,GAAM,CAAEC,CAAAA,CAASC,CAAW,CAAA,CAAIC,eAAUC,0BAAiBJ,CAAAA,CAAM,CAAE,CAAA,CAC7DK,EAA0BC,iBAAa,CAAA,IAAMJ,CAAYE,CAAAA,0BAAAA,CAAiBJ,CAAM,CAAE,CAAA,CAAG,CAAEA,CAAM,CAAE,EAGrG,OAAAO,eAAAA,CAAW,IAAM,CAEhB,IAAMC,CAAa,CAAA,MAAA,CAAO,UAAYR,CAAAA,CAAM,EAE5C,OAAAK,CAAAA,EAEAG,CAAAA,CAAAA,CAAW,iBAAkB,QAAUH,CAAAA,CAAwB,EAExD,IAAM,CACZG,EAAW,mBAAqB,CAAA,QAAA,CAAUH,CAAwB,EACnE,CAED,CAAG,CAAA,CAAEL,CAAOK,CAAAA,CAAwB,CAAE,CAE/BJ,CAAAA,CAER,CCjCA,KASaQ,CAAgB,CAAA,IAAMV,EAAeW,yBAAmB","file":"useIsPortrait.js","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}","import { useMediaQuery } from './useMediaQuery'\nimport { portraitMediaQuery } from '@alessiofrittoli/web-utils/device'\n\n/**\n * Check if device is portrait oriented.\n * \n * State get updated when device orientation changes.\n *\n * @returns\t`true` if the device is portrait oriented, `false` otherwise.\n */\nexport const useIsPortrait = () => useMediaQuery( portraitMediaQuery )"]}

package/dist/browser-api/useIsPortrait.mjs

@@ -1,2 +0,0 @@
-import {useState,useCallback,useEffect}from'react';import {getMediaMatches}from'@alessiofrittoli/web-utils/browser-api';import {portraitMediaQuery}from'@alessiofrittoli/web-utils/device';var o=e=>{let[s,i]=useState(getMediaMatches(e)),t=useCallback(()=>i(getMediaMatches(e)),[e]);return useEffect(()=>{let a=window.matchMedia(e);return t(),a.addEventListener("change",t),()=>{a.removeEventListener("change",t);}},[e,t]),s};var E=()=>o(portraitMediaQuery);export{E as useIsPortrait};//# sourceMappingURL=useIsPortrait.mjs.map
-//# sourceMappingURL=useIsPortrait.mjs.map

package/dist/browser-api/useIsPortrait.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/browser-api/useMediaQuery.ts","../../src/browser-api/useIsPortrait.ts"],"names":["useMediaQuery","query","matches","setMatches","useState","getMediaMatches","matchMediaChangeHandler","useCallback","useEffect","matchMedia","useIsPortrait","portraitMediaQuery"],"mappings":"2LAYO,IAAMA,CAAAA,CAAkBC,CAAmB,EAAA,CAEjD,GAAM,CAAEC,CAAAA,CAASC,CAAW,CAAA,CAAIC,SAAUC,eAAiBJ,CAAAA,CAAM,CAAE,CAAA,CAC7DK,EAA0BC,WAAa,CAAA,IAAMJ,CAAYE,CAAAA,eAAAA,CAAiBJ,CAAM,CAAE,CAAA,CAAG,CAAEA,CAAM,CAAE,EAGrG,OAAAO,SAAAA,CAAW,IAAM,CAEhB,IAAMC,CAAa,CAAA,MAAA,CAAO,UAAYR,CAAAA,CAAM,EAE5C,OAAAK,CAAAA,EAEAG,CAAAA,CAAAA,CAAW,iBAAkB,QAAUH,CAAAA,CAAwB,EAExD,IAAM,CACZG,EAAW,mBAAqB,CAAA,QAAA,CAAUH,CAAwB,EACnE,CAED,CAAG,CAAA,CAAEL,CAAOK,CAAAA,CAAwB,CAAE,CAE/BJ,CAAAA,CAER,CCjCA,KASaQ,CAAgB,CAAA,IAAMV,EAAeW,kBAAmB","file":"useIsPortrait.mjs","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}","import { useMediaQuery } from './useMediaQuery'\nimport { portraitMediaQuery } from '@alessiofrittoli/web-utils/device'\n\n/**\n * Check if device is portrait oriented.\n * \n * State get updated when device orientation changes.\n *\n * @returns\t`true` if the device is portrait oriented, `false` otherwise.\n */\nexport const useIsPortrait = () => useMediaQuery( portraitMediaQuery )"]}

package/dist/browser-api/useMediaQuery.d.mts

@@ -1,11 +0,0 @@
-/**
- * Get Document Media matches and listen for changes.
- *
- * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)
- *
- * @param	query A string specifying the media query to parse into a `MediaQueryList`.
- * @returns	A boolean value that returns `true` if the document currently matches the media query list, or `false` if not.
- */
-declare const useMediaQuery: (query: string) => boolean;
-
-export { useMediaQuery };

package/dist/browser-api/useMediaQuery.d.ts

@@ -1,11 +0,0 @@
-/**
- * Get Document Media matches and listen for changes.
- *
- * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)
- *
- * @param	query A string specifying the media query to parse into a `MediaQueryList`.
- * @returns	A boolean value that returns `true` if the document currently matches the media query list, or `false` if not.
- */
-declare const useMediaQuery: (query: string) => boolean;
-
-export { useMediaQuery };

package/dist/browser-api/useMediaQuery.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react'),browserApi=require('@alessiofrittoli/web-utils/browser-api');var M=e=>{let[s,c]=react.useState(browserApi.getMediaMatches(e)),t=react.useCallback(()=>c(browserApi.getMediaMatches(e)),[e]);return react.useEffect(()=>{let a=window.matchMedia(e);return t(),a.addEventListener("change",t),()=>{a.removeEventListener("change",t);}},[e,t]),s};exports.useMediaQuery=M;//# sourceMappingURL=useMediaQuery.js.map
-//# sourceMappingURL=useMediaQuery.js.map

package/dist/browser-api/useMediaQuery.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/browser-api/useMediaQuery.ts"],"names":["useMediaQuery","query","matches","setMatches","useState","getMediaMatches","matchMediaChangeHandler","useCallback","useEffect","matchMedia"],"mappings":"qGAYaA,IAAAA,CAAAA,CAAkBC,GAAmB,CAEjD,GAAM,CAAEC,CAAAA,CAASC,CAAW,CAAA,CAAIC,cAAUC,CAAAA,0BAAAA,CAAiBJ,CAAM,CAAE,CAAA,CAC7DK,CAA0BC,CAAAA,iBAAAA,CAAa,IAAMJ,CAAAA,CAAYE,0BAAiBJ,CAAAA,CAAM,CAAE,CAAG,CAAA,CAAEA,CAAM,CAAE,CAGrG,CAAA,OAAAO,eAAW,CAAA,IAAM,CAEhB,IAAMC,CAAAA,CAAa,MAAO,CAAA,UAAA,CAAYR,CAAM,CAAA,CAE5C,OAAAK,CAAAA,GAEAG,CAAW,CAAA,gBAAA,CAAkB,QAAUH,CAAAA,CAAwB,CAExD,CAAA,IAAM,CACZG,CAAAA,CAAW,oBAAqB,QAAUH,CAAAA,CAAwB,EACnE,CAED,EAAG,CAAEL,CAAAA,CAAOK,CAAwB,CAAE,EAE/BJ,CAER","file":"useMediaQuery.js","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}"]}

package/dist/browser-api/useMediaQuery.mjs

@@ -1,2 +0,0 @@
-import {useState,useCallback,useEffect}from'react';import {getMediaMatches}from'@alessiofrittoli/web-utils/browser-api';var g=e=>{let[s,c]=useState(getMediaMatches(e)),t=useCallback(()=>c(getMediaMatches(e)),[e]);return useEffect(()=>{let a=window.matchMedia(e);return t(),a.addEventListener("change",t),()=>{a.removeEventListener("change",t);}},[e,t]),s};export{g as useMediaQuery};//# sourceMappingURL=useMediaQuery.mjs.map
-//# sourceMappingURL=useMediaQuery.mjs.map

package/dist/browser-api/useMediaQuery.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/browser-api/useMediaQuery.ts"],"names":["useMediaQuery","query","matches","setMatches","useState","getMediaMatches","matchMediaChangeHandler","useCallback","useEffect","matchMedia"],"mappings":"wHAYaA,IAAAA,CAAAA,CAAkBC,GAAmB,CAEjD,GAAM,CAAEC,CAAAA,CAASC,CAAW,CAAA,CAAIC,QAAUC,CAAAA,eAAAA,CAAiBJ,CAAM,CAAE,CAAA,CAC7DK,CAA0BC,CAAAA,WAAAA,CAAa,IAAMJ,CAAAA,CAAYE,eAAiBJ,CAAAA,CAAM,CAAE,CAAG,CAAA,CAAEA,CAAM,CAAE,CAGrG,CAAA,OAAAO,SAAW,CAAA,IAAM,CAEhB,IAAMC,CAAAA,CAAa,MAAO,CAAA,UAAA,CAAYR,CAAM,CAAA,CAE5C,OAAAK,CAAAA,GAEAG,CAAW,CAAA,gBAAA,CAAkB,QAAUH,CAAAA,CAAwB,CAExD,CAAA,IAAM,CACZG,CAAAA,CAAW,oBAAqB,QAAUH,CAAAA,CAAwB,EACnE,CAED,EAAG,CAAEL,CAAAA,CAAOK,CAAwB,CAAE,EAE/BJ,CAER","file":"useMediaQuery.mjs","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}"]}

package/dist/dom-api/index.d.mts

@@ -1,2 +0,0 @@
-export { useFocusTrap } from './useFocusTrap.mjs';
-export { useScrollBlock } from './useScrollBlock.mjs';

package/dist/dom-api/index.d.ts

@@ -1,2 +0,0 @@
-export { useFocusTrap } from './useFocusTrap.js';
-export { useScrollBlock } from './useScrollBlock.js';

package/dist/dom-api/index.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react'),dom=require('@alessiofrittoli/web-utils/dom');var b=["input","select","textarea","button","[href]",'[tabindex]:not([tabindex="-1"])'].join(", "),k=e=>{let[r,o]=react.useState(false),c=react.useRef(null),i=react.useCallback(n=>{c.current=document.activeElement;let t=n||e?.current||false;if(t)return o(t)},[e]),p=react.useCallback(()=>{c.current?.focus(),o(false);},[]);return react.useEffect(()=>{if(!r)return;let n=t=>{if(t.key!=="Tab")return;let s=Array.from(r.querySelectorAll(b)),l=s.at(0),u=s.at(-1);if(!t.shiftKey){document.activeElement===u&&(t.preventDefault(),l?.focus());return}document.activeElement===l&&(t.preventDefault(),u?.focus());};return document.addEventListener("keydown",n),()=>{document.removeEventListener("keydown",n);}},[r]),[i,p]};var x=e=>{let r=react.useCallback(()=>dom.blockScroll(e?.current||void 0),[e]),o=react.useCallback(()=>dom.restoreScroll(e?.current||void 0),[e]);return [r,o]};exports.useFocusTrap=k;exports.useScrollBlock=x;//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/dom-api/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useFocusTrap.ts","../../src/dom-api/useScrollBlock.ts"],"names":["focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","useState","lastActiveElement","useRef","setFocusTrap","useCallback","onDemandTarget","restoreFocusTrap","useEffect","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement","useScrollBlock","blockScroll","blockScrollHandler","restoreScroll","restoreScrollHandler"],"mappings":"sFAKMA,IAAAA,CAAAA,CAAoB,CACzB,OAAS,CAAA,QAAA,CAAU,WACnB,QAAU,CAAA,QAAA,CAAU,iCACrB,CAAE,CAAA,IAAA,CAAM,IAAK,CAAA,CAaAC,CACZC,CAAAA,CAAAA,EACiD,CAEjD,GAAM,CAAEC,EAAWC,CAAqB,CAAA,CACvCC,eAA+B,KAAM,CAAA,CAGhCC,CAAoBC,CAAAA,YAAAA,CAAqB,IAAK,CAAA,CAM9CC,EAAeC,iBAA2BC,CAAAA,CAAAA,EAAkB,CAEjEJ,CAAkB,CAAA,OAAA,CAAU,SAAS,aACrC,CAAA,IAAMH,CAAeO,CAAAA,CAAAA,EAAkBR,CAAQ,EAAA,OAAA,EAAW,MAE1D,GAAOC,CAAAA,CAEP,OAAOC,CAAsBD,CAAAA,CAAU,CAExC,CAAG,CAAA,CAAED,CAAO,CAAE,CAMRS,CAAAA,CAAAA,CAAmBF,kBAA+B,IAAM,CAE7DH,EAAkB,OAAS,EAAA,KAAA,GAC3BF,CAAsB,CAAA,KAAM,EAE7B,CAAA,CAAG,EAAG,EAGN,OAAAQ,eAAAA,CAAW,IAAM,CAEhB,GAAK,CAAET,CAAY,CAAA,OAEnB,IAAMU,CAAAA,CAAmBC,CAA0B,EAAA,CAElD,GAAKA,CAAM,CAAA,GAAA,GAAQ,MAAQ,OAE3B,IAAMC,EAAqB,KAAM,CAAA,IAAA,CAAMZ,CAAU,CAAA,gBAAA,CAA+BH,CAAkB,CAAE,EACnGgB,CAAwBD,CAAAA,CAAAA,CAAkB,GAAI,CAAE,CAAA,CAChDE,EAAuBF,CAAkB,CAAA,EAAA,CAAI,EAAG,CAAA,CAEjD,GAAK,CAAED,EAAM,QAAW,CAAA,CAKlB,SAAS,aAAkBG,GAAAA,CAAAA,GAC/BH,EAAM,cAAe,EAAA,CACrBE,CAAuB,EAAA,KAAA,EAExB,CAAA,CAAA,MACD,CAQK,QAAS,CAAA,aAAA,GAAkBA,IAC/BF,CAAM,CAAA,cAAA,GACNG,CAAsB,EAAA,KAAA,EAGxB,EAAA,CAAA,CAEA,OAAS,QAAA,CAAA,gBAAA,CAAkB,UAAWJ,CAAe,CAAA,CAE9C,IAAM,CACZ,QAAA,CAAS,oBAAqB,SAAWA,CAAAA,CAAe,EACzD,CAED,CAAG,CAAA,CAAEV,CAAU,CAAE,CAAA,CAEV,CAAEK,CAAcG,CAAAA,CAAiB,CAEzC,EC7FO,IAAMO,EAAmBhB,CAAkD,EAAA,CAMjF,IAAMiB,CAAAA,CAAcV,iBACnB,CAAA,IAAMW,gBAAoBlB,CAAQ,EAAA,OAAA,EAAW,MAAU,CAAG,CAAA,CAAEA,CAAO,CACpE,CAAA,CAOMmB,CAAgBZ,CAAAA,iBAAAA,CACrB,IAAMa,iBAAAA,CAAsBpB,GAAQ,OAAW,EAAA,MAAU,CAAG,CAAA,CAAEA,CAAO,CACtE,EAGA,OAAO,CAAEiB,CAAaE,CAAAA,CAAc,CAErC","file":"index.js","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}","import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}"]}

package/dist/dom-api/index.mjs

@@ -1,2 +0,0 @@
-import {useState,useRef,useCallback,useEffect}from'react';import {blockScroll,restoreScroll}from'@alessiofrittoli/web-utils/dom';var S=["input","select","textarea","button","[href]",'[tabindex]:not([tabindex="-1"])'].join(", "),H=e=>{let[r,o]=useState(false),c=useRef(null),p=useCallback(n=>{c.current=document.activeElement;let t=n||e?.current||false;if(t)return o(t)},[e]),d=useCallback(()=>{c.current?.focus(),o(false);},[]);return useEffect(()=>{if(!r)return;let n=t=>{if(t.key!=="Tab")return;let s=Array.from(r.querySelectorAll(S)),l=s.at(0),u=s.at(-1);if(!t.shiftKey){document.activeElement===u&&(t.preventDefault(),l?.focus());return}document.activeElement===l&&(t.preventDefault(),u?.focus());};return document.addEventListener("keydown",n),()=>{document.removeEventListener("keydown",n);}},[r]),[p,d]};var M=e=>{let r=useCallback(()=>blockScroll(e?.current||void 0),[e]),o=useCallback(()=>restoreScroll(e?.current||void 0),[e]);return [r,o]};export{H as useFocusTrap,M as useScrollBlock};//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/dom-api/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useFocusTrap.ts","../../src/dom-api/useScrollBlock.ts"],"names":["focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","useState","lastActiveElement","useRef","setFocusTrap","useCallback","onDemandTarget","restoreFocusTrap","useEffect","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement","useScrollBlock","blockScroll","blockScrollHandler","restoreScroll","restoreScrollHandler"],"mappings":"iIAKMA,IAAAA,CAAAA,CAAoB,CACzB,OAAS,CAAA,QAAA,CAAU,WACnB,QAAU,CAAA,QAAA,CAAU,iCACrB,CAAE,CAAA,IAAA,CAAM,IAAK,CAAA,CAaAC,CACZC,CAAAA,CAAAA,EACiD,CAEjD,GAAM,CAAEC,EAAWC,CAAqB,CAAA,CACvCC,SAA+B,KAAM,CAAA,CAGhCC,CAAoBC,CAAAA,MAAAA,CAAqB,IAAK,CAAA,CAM9CC,EAAeC,WAA2BC,CAAAA,CAAAA,EAAkB,CAEjEJ,CAAkB,CAAA,OAAA,CAAU,SAAS,aACrC,CAAA,IAAMH,CAAeO,CAAAA,CAAAA,EAAkBR,CAAQ,EAAA,OAAA,EAAW,MAE1D,GAAOC,CAAAA,CAEP,OAAOC,CAAsBD,CAAAA,CAAU,CAExC,CAAG,CAAA,CAAED,CAAO,CAAE,CAMRS,CAAAA,CAAAA,CAAmBF,YAA+B,IAAM,CAE7DH,EAAkB,OAAS,EAAA,KAAA,GAC3BF,CAAsB,CAAA,KAAM,EAE7B,CAAA,CAAG,EAAG,EAGN,OAAAQ,SAAAA,CAAW,IAAM,CAEhB,GAAK,CAAET,CAAY,CAAA,OAEnB,IAAMU,CAAAA,CAAmBC,CAA0B,EAAA,CAElD,GAAKA,CAAM,CAAA,GAAA,GAAQ,MAAQ,OAE3B,IAAMC,EAAqB,KAAM,CAAA,IAAA,CAAMZ,CAAU,CAAA,gBAAA,CAA+BH,CAAkB,CAAE,EACnGgB,CAAwBD,CAAAA,CAAAA,CAAkB,GAAI,CAAE,CAAA,CAChDE,EAAuBF,CAAkB,CAAA,EAAA,CAAI,EAAG,CAAA,CAEjD,GAAK,CAAED,EAAM,QAAW,CAAA,CAKlB,SAAS,aAAkBG,GAAAA,CAAAA,GAC/BH,EAAM,cAAe,EAAA,CACrBE,CAAuB,EAAA,KAAA,EAExB,CAAA,CAAA,MACD,CAQK,QAAS,CAAA,aAAA,GAAkBA,IAC/BF,CAAM,CAAA,cAAA,GACNG,CAAsB,EAAA,KAAA,EAGxB,EAAA,CAAA,CAEA,OAAS,QAAA,CAAA,gBAAA,CAAkB,UAAWJ,CAAe,CAAA,CAE9C,IAAM,CACZ,QAAA,CAAS,oBAAqB,SAAWA,CAAAA,CAAe,EACzD,CAED,CAAG,CAAA,CAAEV,CAAU,CAAE,CAAA,CAEV,CAAEK,CAAcG,CAAAA,CAAiB,CAEzC,EC7FO,IAAMO,EAAmBhB,CAAkD,EAAA,CAMjF,IAAMiB,CAAAA,CAAcV,WACnB,CAAA,IAAMW,YAAoBlB,CAAQ,EAAA,OAAA,EAAW,MAAU,CAAG,CAAA,CAAEA,CAAO,CACpE,CAAA,CAOMmB,CAAgBZ,CAAAA,WAAAA,CACrB,IAAMa,aAAAA,CAAsBpB,GAAQ,OAAW,EAAA,MAAU,CAAG,CAAA,CAAEA,CAAO,CACtE,EAGA,OAAO,CAAEiB,CAAaE,CAAAA,CAAc,CAErC","file":"index.mjs","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}","import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}"]}

package/dist/dom-api/useFocusTrap.d.mts

@@ -1,15 +0,0 @@
-type SetFocusTrap = (target?: HTMLElement) => void;
-type RestoreFocusTrap = () => void;
-/**
- * Trap focus inside the given HTML Element.
- *
- * @param target (Optional) The target HTMLElement React RefObject to trap focus within.
- * 					If no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.
- *
- * @returns A tuple containing:
- * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.
- * - `restoreFocusTrap`: A function to restore the previous focus state.
- */
-declare const useFocusTrap: (target?: React.RefObject<HTMLElement | null>) => readonly [SetFocusTrap, RestoreFocusTrap];
-
-export { useFocusTrap };

package/dist/dom-api/useFocusTrap.d.ts

@@ -1,15 +0,0 @@
-type SetFocusTrap = (target?: HTMLElement) => void;
-type RestoreFocusTrap = () => void;
-/**
- * Trap focus inside the given HTML Element.
- *
- * @param target (Optional) The target HTMLElement React RefObject to trap focus within.
- * 					If no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.
- *
- * @returns A tuple containing:
- * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.
- * - `restoreFocusTrap`: A function to restore the previous focus state.
- */
-declare const useFocusTrap: (target?: React.RefObject<HTMLElement | null>) => readonly [SetFocusTrap, RestoreFocusTrap];
-
-export { useFocusTrap };

package/dist/dom-api/useFocusTrap.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react');var E=["input","select","textarea","button","[href]",'[tabindex]:not([tabindex="-1"])'].join(", "),b=n=>{let[r,o]=react.useState(false),s=react.useRef(null),f=react.useCallback(t=>{s.current=document.activeElement;let e=t||n?.current||false;if(e)return o(e)},[n]),i=react.useCallback(()=>{s.current?.focus(),o(false);},[]);return react.useEffect(()=>{if(!r)return;let t=e=>{if(e.key!=="Tab")return;let c=Array.from(r.querySelectorAll(E)),u=c.at(0),a=c.at(-1);if(!e.shiftKey){document.activeElement===a&&(e.preventDefault(),u?.focus());return}document.activeElement===u&&(e.preventDefault(),a?.focus());};return document.addEventListener("keydown",t),()=>{document.removeEventListener("keydown",t);}},[r]),[f,i]};exports.useFocusTrap=b;//# sourceMappingURL=useFocusTrap.js.map
-//# sourceMappingURL=useFocusTrap.js.map

package/dist/dom-api/useFocusTrap.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useFocusTrap.ts"],"names":["focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","useState","lastActiveElement","useRef","setFocusTrap","useCallback","onDemandTarget","restoreFocusTrap","useEffect","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement"],"mappings":"wCAKA,IAAMA,EAAoB,CACzB,OAAA,CAAS,QAAU,CAAA,UAAA,CACnB,SAAU,QAAU,CAAA,iCACrB,CAAE,CAAA,IAAA,CAAM,IAAK,CAaAC,CAAAA,CAAAA,CACZC,CACiD,EAAA,CAEjD,GAAM,CAAEC,CAAAA,CAAWC,CAAqB,CAAA,CACvCC,eAA+B,KAAM,CAAA,CAGhCC,EAAoBC,YAAqB,CAAA,IAAK,EAM9CC,CAAeC,CAAAA,iBAAAA,CAA2BC,CAAkB,EAAA,CAEjEJ,EAAkB,OAAU,CAAA,QAAA,CAAS,aACrC,CAAA,IAAMH,EAAeO,CAAkBR,EAAAA,CAAAA,EAAQ,OAAW,EAAA,KAAA,CAE1D,GAAOC,CAEP,CAAA,OAAOC,CAAsBD,CAAAA,CAAU,CAExC,CAAG,CAAA,CAAED,CAAO,CAAE,EAMRS,CAAmBF,CAAAA,iBAAAA,CAA+B,IAAM,CAE7DH,EAAkB,OAAS,EAAA,KAAA,EAC3BF,CAAAA,CAAAA,CAAsB,KAAM,EAE7B,CAAA,CAAG,EAAG,CAAA,CAGN,OAAAQ,eAAW,CAAA,IAAM,CAEhB,GAAK,CAAET,CAAY,CAAA,OAEnB,IAAMU,CAAAA,CAAmBC,GAA0B,CAElD,GAAKA,CAAM,CAAA,GAAA,GAAQ,MAAQ,OAE3B,IAAMC,CAAqB,CAAA,KAAA,CAAM,KAAMZ,CAAU,CAAA,gBAAA,CAA+BH,CAAkB,CAAE,EACnGgB,CAAwBD,CAAAA,CAAAA,CAAkB,EAAI,CAAA,CAAE,EAChDE,CAAuBF,CAAAA,CAAAA,CAAkB,EAAI,CAAA,EAAG,EAEjD,GAAK,CAAED,EAAM,QAAW,CAAA,CAKlB,SAAS,aAAkBG,GAAAA,CAAAA,GAC/BH,CAAM,CAAA,cAAA,GACNE,CAAuB,EAAA,KAAA,EAExB,CAAA,CAAA,MACD,CAQK,QAAS,CAAA,aAAA,GAAkBA,CAC/BF,GAAAA,CAAAA,CAAM,gBACNG,CAAAA,CAAAA,EAAsB,KAAM,EAAA,EAG9B,EAEA,OAAS,QAAA,CAAA,gBAAA,CAAkB,SAAWJ,CAAAA,CAAe,EAE9C,IAAM,CACZ,QAAS,CAAA,mBAAA,CAAqB,UAAWA,CAAe,EACzD,CAED,CAAA,CAAG,CAAEV,CAAU,CAAE,EAEV,CAAEK,CAAAA,CAAcG,CAAiB,CAEzC","file":"useFocusTrap.js","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}"]}

package/dist/dom-api/useFocusTrap.mjs

@@ -1,2 +0,0 @@
-import {useState,useRef,useCallback,useEffect}from'react';var E=["input","select","textarea","button","[href]",'[tabindex]:not([tabindex="-1"])'].join(", "),y=n=>{let[r,o]=useState(false),s=useRef(null),f=useCallback(t=>{s.current=document.activeElement;let e=t||n?.current||false;if(e)return o(e)},[n]),i=useCallback(()=>{s.current?.focus(),o(false);},[]);return useEffect(()=>{if(!r)return;let t=e=>{if(e.key!=="Tab")return;let c=Array.from(r.querySelectorAll(E)),u=c.at(0),a=c.at(-1);if(!e.shiftKey){document.activeElement===a&&(e.preventDefault(),u?.focus());return}document.activeElement===u&&(e.preventDefault(),a?.focus());};return document.addEventListener("keydown",t),()=>{document.removeEventListener("keydown",t);}},[r]),[f,i]};export{y as useFocusTrap};//# sourceMappingURL=useFocusTrap.mjs.map
-//# sourceMappingURL=useFocusTrap.mjs.map

package/dist/dom-api/useFocusTrap.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useFocusTrap.ts"],"names":["focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","useState","lastActiveElement","useRef","setFocusTrap","useCallback","onDemandTarget","restoreFocusTrap","useEffect","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement"],"mappings":"0DAKA,IAAMA,EAAoB,CACzB,OAAA,CAAS,QAAU,CAAA,UAAA,CACnB,SAAU,QAAU,CAAA,iCACrB,CAAE,CAAA,IAAA,CAAM,IAAK,CAaAC,CAAAA,CAAAA,CACZC,CACiD,EAAA,CAEjD,GAAM,CAAEC,CAAAA,CAAWC,CAAqB,CAAA,CACvCC,SAA+B,KAAM,CAAA,CAGhCC,EAAoBC,MAAqB,CAAA,IAAK,EAM9CC,CAAeC,CAAAA,WAAAA,CAA2BC,CAAkB,EAAA,CAEjEJ,EAAkB,OAAU,CAAA,QAAA,CAAS,aACrC,CAAA,IAAMH,EAAeO,CAAkBR,EAAAA,CAAAA,EAAQ,OAAW,EAAA,KAAA,CAE1D,GAAOC,CAEP,CAAA,OAAOC,CAAsBD,CAAAA,CAAU,CAExC,CAAG,CAAA,CAAED,CAAO,CAAE,EAMRS,CAAmBF,CAAAA,WAAAA,CAA+B,IAAM,CAE7DH,EAAkB,OAAS,EAAA,KAAA,EAC3BF,CAAAA,CAAAA,CAAsB,KAAM,EAE7B,CAAA,CAAG,EAAG,CAAA,CAGN,OAAAQ,SAAW,CAAA,IAAM,CAEhB,GAAK,CAAET,CAAY,CAAA,OAEnB,IAAMU,CAAAA,CAAmBC,GAA0B,CAElD,GAAKA,CAAM,CAAA,GAAA,GAAQ,MAAQ,OAE3B,IAAMC,CAAqB,CAAA,KAAA,CAAM,KAAMZ,CAAU,CAAA,gBAAA,CAA+BH,CAAkB,CAAE,EACnGgB,CAAwBD,CAAAA,CAAAA,CAAkB,EAAI,CAAA,CAAE,EAChDE,CAAuBF,CAAAA,CAAAA,CAAkB,EAAI,CAAA,EAAG,EAEjD,GAAK,CAAED,EAAM,QAAW,CAAA,CAKlB,SAAS,aAAkBG,GAAAA,CAAAA,GAC/BH,CAAM,CAAA,cAAA,GACNE,CAAuB,EAAA,KAAA,EAExB,CAAA,CAAA,MACD,CAQK,QAAS,CAAA,aAAA,GAAkBA,CAC/BF,GAAAA,CAAAA,CAAM,gBACNG,CAAAA,CAAAA,EAAsB,KAAM,EAAA,EAG9B,EAEA,OAAS,QAAA,CAAA,gBAAA,CAAkB,SAAWJ,CAAAA,CAAe,EAE9C,IAAM,CACZ,QAAS,CAAA,mBAAA,CAAqB,UAAWA,CAAe,EACzD,CAED,CAAA,CAAG,CAAEV,CAAU,CAAE,EAEV,CAAEK,CAAAA,CAAcG,CAAiB,CAEzC","file":"useFocusTrap.mjs","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}"]}

package/dist/dom-api/useScrollBlock.d.mts

@@ -1,8 +0,0 @@
-/**
- * Prevent Element overflow.
- *
- * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.
- */
-declare const useScrollBlock: (target?: React.RefObject<HTMLElement | null>) => readonly [() => void, () => void];
-
-export { useScrollBlock };

package/dist/dom-api/useScrollBlock.d.ts

@@ -1,8 +0,0 @@
-/**
- * Prevent Element overflow.
- *
- * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.
- */
-declare const useScrollBlock: (target?: React.RefObject<HTMLElement | null>) => readonly [() => void, () => void];
-
-export { useScrollBlock };

package/dist/dom-api/useScrollBlock.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react'),dom=require('@alessiofrittoli/web-utils/dom');var S=l=>{let r=react.useCallback(()=>dom.blockScroll(l?.current||void 0),[l]),c=react.useCallback(()=>dom.restoreScroll(l?.current||void 0),[l]);return [r,c]};exports.useScrollBlock=S;//# sourceMappingURL=useScrollBlock.js.map
-//# sourceMappingURL=useScrollBlock.js.map

package/dist/dom-api/useScrollBlock.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useScrollBlock.ts"],"names":["useScrollBlock","target","blockScroll","useCallback","blockScrollHandler","restoreScroll","restoreScrollHandler"],"mappings":"0FAYaA,CAAmBC,CAAAA,CAAAA,EAAkD,CAMjF,IAAMC,CAAAA,CAAcC,kBACnB,IAAMC,eAAAA,CAAoBH,GAAQ,OAAW,EAAA,MAAU,CAAG,CAAA,CAAEA,CAAO,CACpE,CAAA,CAOMI,EAAgBF,iBACrB,CAAA,IAAMG,kBAAsBL,CAAQ,EAAA,OAAA,EAAW,MAAU,CAAG,CAAA,CAAEA,CAAO,CACtE,CAAA,CAGA,OAAO,CAAEC,CAAAA,CAAaG,CAAc,CAErC","file":"useScrollBlock.js","sourcesContent":["import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}"]}

package/dist/dom-api/useScrollBlock.mjs

@@ -1,2 +0,0 @@
-import {useCallback}from'react';import {blockScroll,restoreScroll}from'@alessiofrittoli/web-utils/dom';var d=l=>{let r=useCallback(()=>blockScroll(l?.current||void 0),[l]),c=useCallback(()=>restoreScroll(l?.current||void 0),[l]);return [r,c]};export{d as useScrollBlock};//# sourceMappingURL=useScrollBlock.mjs.map
-//# sourceMappingURL=useScrollBlock.mjs.map

package/dist/dom-api/useScrollBlock.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/dom-api/useScrollBlock.ts"],"names":["useScrollBlock","target","blockScroll","useCallback","blockScrollHandler","restoreScroll","restoreScrollHandler"],"mappings":"2GAYaA,CAAmBC,CAAAA,CAAAA,EAAkD,CAMjF,IAAMC,CAAAA,CAAcC,YACnB,IAAMC,WAAAA,CAAoBH,GAAQ,OAAW,EAAA,MAAU,CAAG,CAAA,CAAEA,CAAO,CACpE,CAAA,CAOMI,EAAgBF,WACrB,CAAA,IAAMG,cAAsBL,CAAQ,EAAA,OAAA,EAAW,MAAU,CAAG,CAAA,CAAEA,CAAO,CACtE,CAAA,CAGA,OAAO,CAAEC,CAAAA,CAAaG,CAAc,CAErC","file":"useScrollBlock.mjs","sourcesContent":["import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}"]}

package/dist/eslint.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/eslint.ts"],"names":["config"],"mappings":"aAWO,IAAMA,EAA8B,CAC1C,WAAA,CAAa,CACZ,CACC,MAAO,CACN,6BAAA,CAA+B,CAC9B,MAAA,CACA,CACC,eAAiB,CAAA,mBAClB,CACD,CACD,CACD,CACD,CACD","file":"eslint.js","sourcesContent":["import type { Linter } from 'eslint'\n\ninterface ESLintConfiguration\n{\n\trecommended: Linter.Config[]\n}\n\n\n/**\n * [`@alessiofrittoli/react-hooks`](https://npmjs.com/package/@alessiofrittoli/react-hooks) Recommended ESLint configurations.\n */\nexport const config: ESLintConfiguration = {\n\trecommended: [\n\t\t{\n\t\t\trules: {\n\t\t\t\t'react-hooks/exhaustive-deps': [\n\t\t\t\t\t'warn',\n\t\t\t\t\t{\n\t\t\t\t\t\tadditionalHooks: '(useUpdateEffect)',\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t]\n}"]}

package/dist/eslint.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/eslint.ts"],"names":["config"],"mappings":"AAWO,IAAMA,EAA8B,CAC1C,WAAA,CAAa,CACZ,CACC,MAAO,CACN,6BAAA,CAA+B,CAC9B,MAAA,CACA,CACC,eAAiB,CAAA,mBAClB,CACD,CACD,CACD,CACD,CACD","file":"eslint.mjs","sourcesContent":["import type { Linter } from 'eslint'\n\ninterface ESLintConfiguration\n{\n\trecommended: Linter.Config[]\n}\n\n\n/**\n * [`@alessiofrittoli/react-hooks`](https://npmjs.com/package/@alessiofrittoli/react-hooks) Recommended ESLint configurations.\n */\nexport const config: ESLintConfiguration = {\n\trecommended: [\n\t\t{\n\t\t\trules: {\n\t\t\t\t'react-hooks/exhaustive-deps': [\n\t\t\t\t\t'warn',\n\t\t\t\t\t{\n\t\t\t\t\t\tadditionalHooks: '(useUpdateEffect)',\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}\n\t\t}\n\t]\n}"]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/browser-api/storage/useStorage.ts","../src/browser-api/storage/useLocalStorage.ts","../src/browser-api/storage/useSessionStorage.ts","../src/browser-api/useMediaQuery.ts","../src/browser-api/useIsPortrait.ts","../src/dom-api/useFocusTrap.ts","../src/dom-api/useScrollBlock.ts","../src/misc/useIsClient.ts","../src/misc/useIsFirstRender.ts","../src/misc/useUpdateEffect.ts"],"names":["useStorage","key","initialValue","type","readValue","useCallback","LocalStorage","SessionStorage","storedValue","setStoredValue","useState","setValue","value","valueToStore","useEffect","useLocalStorage","useSessionStorage","useMediaQuery","query","matches","setMatches","getMediaMatches","matchMediaChangeHandler","matchMedia","useIsPortrait","portraitMediaQuery","focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","lastActiveElement","useRef","setFocusTrap","onDemandTarget","restoreFocusTrap","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement","useScrollBlock","blockScroll","blockScrollHandler","restoreScroll","restoreScrollHandler","useIsClient","isClient","setClient","useIsFirstRender","isFirst","useUpdateEffect","effect","deps"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { LocalStorage } from '@alessiofrittoli/web-utils/storage/LocalStorage'\nimport { SessionStorage } from '@alessiofrittoli/web-utils/storage/SessionStorage'\n\ntype Value<T>\t\t= T | undefined | null\ntype SetValue<T>\t= React.Dispatch<React.SetStateAction<T>>\n\n/**\n * Easly handle Local or Session Storage State.\n * \n * @param\tkey\t\t\t\tThe storage item key.\n * @param\tinitialValue\tThe storage item initial value.\n * @param\ttype\t\t\t( Optional ) The storage API to use. Default: `local`.\n */\nexport const useStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T,\n\ttype\t\t\t: 'local' | 'session' = 'local'\n): [ Value<T>, SetValue<Value<T>> ] => {\n\n\tconst readValue = useCallback( () => (\n\t\t( type === 'local' ? LocalStorage : SessionStorage )\n\t\t\t.get<T>( key ) ?? initialValue\n\t), [ type, key, initialValue ] )\n\n\n\t/**\n\t * State to store our value.\n\t * Pass initial state function to useState so logic is only executed once.\n\t * \n\t */\n\tconst [ storedValue, setStoredValue ] = useState<Value<T>>( initialValue )\n\n\t/**\n\t * Return a wrapped version of useState's setter function that\n\t * persists the new value to localStorage | sessionStorage.\n\t * \n\t * @param value The SetStateAction value.\n\t */\n\tconst setValue = useCallback<SetValue<Value<T>>>( value => {\n\n\t\tsetStoredValue( storedValue => {\n\t\t\tconst valueToStore = value instanceof Function ? value( storedValue ) : value\n\t\n\t\t\t;(\n\t\t\t\ttypeof window !== 'undefined' &&\n\t\t\t\ttype === 'local' ? LocalStorage : SessionStorage\n\t\t\t).set( key, valueToStore )\n\n\t\t\treturn valueToStore\n\t\t} )\n\n\n\t}, [ type, key ] )\n\n\tuseEffect( () => {\n\t\tsetStoredValue( readValue() )\n\t}, [ readValue ] )\n\n\treturn [ storedValue, setValue ]\n}","import { useStorage } from './useStorage'\n\n/**\n * useLocalStorage hook.\n * \n * @param\tkey\t\t\t\tThe local storage item key.\n * @param\tinitialValue\tThe local storage item initial value.\n */\nexport const useLocalStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T\n) => useStorage( key, initialValue, 'local' )","import { useStorage } from './useStorage'\n\n/**\n * useSessionStorage hook.\n * \n * @param\tkey\t\t\t\tThe session item key.\n * @param\tinitialValue\tThe session item initial value.\n */\nexport const useSessionStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T\n) => useStorage( key, initialValue, 'session' )","import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}","import { useMediaQuery } from './useMediaQuery'\nimport { portraitMediaQuery } from '@alessiofrittoli/web-utils/device'\n\n/**\n * Check if device is portrait oriented.\n * \n * State get updated when device orientation changes.\n *\n * @returns\t`true` if the device is portrait oriented, `false` otherwise.\n */\nexport const useIsPortrait = () => useMediaQuery( portraitMediaQuery )","import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}","import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}","import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}","import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}","import { useEffect } from 'react'\nimport { useIsFirstRender } from './useIsFirstRender'\n\n\n/**\n * Modified version of `useEffect` that skips the first render.\n *\n * @param\teffect\tImperative function that can return a cleanup function.\n * @param\tdeps\tIf present, effect will only activate if the values in the list change.\n */\nexport const useUpdateEffect = (\n\teffect\t: React.EffectCallback,\n\tdeps?\t: React.DependencyList,\n) => {\n\n\tconst isFirst = useIsFirstRender()\n\n\tuseEffect( () => {\n\t\tif ( ! isFirst ) return effect()\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t}, deps )\n\t\n}"]}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/browser-api/storage/useStorage.ts","../src/browser-api/storage/useLocalStorage.ts","../src/browser-api/storage/useSessionStorage.ts","../src/browser-api/useMediaQuery.ts","../src/browser-api/useIsPortrait.ts","../src/dom-api/useFocusTrap.ts","../src/dom-api/useScrollBlock.ts","../src/misc/useIsClient.ts","../src/misc/useIsFirstRender.ts","../src/misc/useUpdateEffect.ts"],"names":["useStorage","key","initialValue","type","readValue","useCallback","LocalStorage","SessionStorage","storedValue","setStoredValue","useState","setValue","value","valueToStore","useEffect","useLocalStorage","useSessionStorage","useMediaQuery","query","matches","setMatches","getMediaMatches","matchMediaChangeHandler","matchMedia","useIsPortrait","portraitMediaQuery","focusableSelector","useFocusTrap","target","focusTrap","setFocusTrapDispatch","lastActiveElement","useRef","setFocusTrap","onDemandTarget","restoreFocusTrap","keyDownHandler","event","focusableElements","firstFocusableElement","lastFocusableElement","useScrollBlock","blockScroll","blockScrollHandler","restoreScroll","restoreScrollHandler","useIsClient","isClient","setClient","useIsFirstRender","isFirst","useUpdateEffect","effect","deps"],"mappings":"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","file":"index.mjs","sourcesContent":["import { useCallback, useEffect, useState } from 'react'\nimport { LocalStorage } from '@alessiofrittoli/web-utils/storage/LocalStorage'\nimport { SessionStorage } from '@alessiofrittoli/web-utils/storage/SessionStorage'\n\ntype Value<T>\t\t= T | undefined | null\ntype SetValue<T>\t= React.Dispatch<React.SetStateAction<T>>\n\n/**\n * Easly handle Local or Session Storage State.\n * \n * @param\tkey\t\t\t\tThe storage item key.\n * @param\tinitialValue\tThe storage item initial value.\n * @param\ttype\t\t\t( Optional ) The storage API to use. Default: `local`.\n */\nexport const useStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T,\n\ttype\t\t\t: 'local' | 'session' = 'local'\n): [ Value<T>, SetValue<Value<T>> ] => {\n\n\tconst readValue = useCallback( () => (\n\t\t( type === 'local' ? LocalStorage : SessionStorage )\n\t\t\t.get<T>( key ) ?? initialValue\n\t), [ type, key, initialValue ] )\n\n\n\t/**\n\t * State to store our value.\n\t * Pass initial state function to useState so logic is only executed once.\n\t * \n\t */\n\tconst [ storedValue, setStoredValue ] = useState<Value<T>>( initialValue )\n\n\t/**\n\t * Return a wrapped version of useState's setter function that\n\t * persists the new value to localStorage | sessionStorage.\n\t * \n\t * @param value The SetStateAction value.\n\t */\n\tconst setValue = useCallback<SetValue<Value<T>>>( value => {\n\n\t\tsetStoredValue( storedValue => {\n\t\t\tconst valueToStore = value instanceof Function ? value( storedValue ) : value\n\t\n\t\t\t;(\n\t\t\t\ttypeof window !== 'undefined' &&\n\t\t\t\ttype === 'local' ? LocalStorage : SessionStorage\n\t\t\t).set( key, valueToStore )\n\n\t\t\treturn valueToStore\n\t\t} )\n\n\n\t}, [ type, key ] )\n\n\tuseEffect( () => {\n\t\tsetStoredValue( readValue() )\n\t}, [ readValue ] )\n\n\treturn [ storedValue, setValue ]\n}","import { useStorage } from './useStorage'\n\n/**\n * useLocalStorage hook.\n * \n * @param\tkey\t\t\t\tThe local storage item key.\n * @param\tinitialValue\tThe local storage item initial value.\n */\nexport const useLocalStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T\n) => useStorage( key, initialValue, 'local' )","import { useStorage } from './useStorage'\n\n/**\n * useSessionStorage hook.\n * \n * @param\tkey\t\t\t\tThe session item key.\n * @param\tinitialValue\tThe session item initial value.\n */\nexport const useSessionStorage = <T = string>(\n\tkey\t\t\t\t: string,\n\tinitialValue?\t: T\n) => useStorage( key, initialValue, 'session' )","import { useCallback, useEffect, useState } from 'react'\nimport { getMediaMatches } from '@alessiofrittoli/web-utils/browser-api'\n\n\n/**\n * Get Document Media matches and listen for changes.\n *\n * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia)\n *\n * @param\tquery A string specifying the media query to parse into a `MediaQueryList`.\n * @returns\tA boolean value that returns `true` if the document currently matches the media query list, or `false` if not.\n */\nexport const useMediaQuery = ( query: string ) => {\n\n\tconst [ matches, setMatches ]\t= useState( getMediaMatches( query ) )\n\tconst matchMediaChangeHandler\t= useCallback( () => setMatches( getMediaMatches( query ) ), [ query ] )\n\n\n\tuseEffect( () => {\n\n\t\tconst matchMedia = window.matchMedia( query )\n\t\t// Triggered at the first client-side load\n\t\tmatchMediaChangeHandler()\n\t\t// Listen matchMedia\n\t\tmatchMedia.addEventListener( 'change', matchMediaChangeHandler )\n\n\t\treturn () => {\n\t\t\tmatchMedia.removeEventListener( 'change', matchMediaChangeHandler )\n\t\t}\n\n\t}, [ query, matchMediaChangeHandler ] )\n\n\treturn matches\n\t\n}","import { useMediaQuery } from './useMediaQuery'\nimport { portraitMediaQuery } from '@alessiofrittoli/web-utils/device'\n\n/**\n * Check if device is portrait oriented.\n * \n * State get updated when device orientation changes.\n *\n * @returns\t`true` if the device is portrait oriented, `false` otherwise.\n */\nexport const useIsPortrait = () => useMediaQuery( portraitMediaQuery )","import { useCallback, useEffect, useRef, useState } from 'react'\n\ntype SetFocusTrap = ( target?: HTMLElement ) => void\ntype RestoreFocusTrap = () => void\n\nconst focusableSelector = [\n\t'input', 'select', 'textarea',\n\t'button', '[href]', '[tabindex]:not([tabindex=\"-1\"])',\n].join( ', ' )\n\n\n/**\n * Trap focus inside the given HTML Element.\n * \n * @param target (Optional) The target HTMLElement React RefObject to trap focus within.\n * \t\t\t\t\tIf no target is given, you must provide the target HTMLElement when calling `setFocusTrap`.\n * \n * @returns A tuple containing:\n * - `setFocusTrap`: A function to enable the focus trap. Optionally accept an HTMLElement as target.\n * - `restoreFocusTrap`: A function to restore the previous focus state.\n */\nexport const useFocusTrap = (\n\ttarget?: React.RefObject<HTMLElement | null>\n): readonly [ SetFocusTrap, RestoreFocusTrap ] => {\n\n\tconst [ focusTrap, setFocusTrapDispatch ] = (\n\t\tuseState<HTMLElement | false>( false )\n\t)\n\n\tconst lastActiveElement = useRef<HTMLElement>( null )\n\t\n\t/**\n\t * Enable the focus trap.\n\t * \n\t */\n\tconst setFocusTrap = useCallback<SetFocusTrap>( onDemandTarget => {\n\n\t\tlastActiveElement.current\t= document.activeElement as HTMLElement\n\t\tconst focusTrap\t\t\t\t= onDemandTarget || target?.current || false\n\t\t\n\t\tif ( ! focusTrap ) return\n\n\t\treturn setFocusTrapDispatch( focusTrap )\n\t\n\t}, [ target ] )\n\n\n\t/**\n\t * Restore the focus to the latest Document active Element.\n\t */\n\tconst restoreFocusTrap = useCallback<RestoreFocusTrap>( () => {\n\n\t\tlastActiveElement.current?.focus()\n\t\tsetFocusTrapDispatch( false )\n\t\n\t}, [] )\n\n\t\n\tuseEffect( () => {\n\n\t\tif ( ! focusTrap ) return\n\n\t\tconst keyDownHandler = ( event: KeyboardEvent ) => {\n\n\t\t\tif ( event.key !== 'Tab' ) return\n\n\t\t\tconst focusableElements\t\t= Array.from( focusTrap.querySelectorAll<HTMLElement>( focusableSelector ) ),\n\t\t\t\tfirstFocusableElement\t= focusableElements.at( 0 ),\n\t\t\t\tlastFocusableElement\t= focusableElements.at( -1 );\n\n\t\t\tif ( ! event.shiftKey ) {\n\t\t\t\t/**\n\t\t\t\t * Focust the firs element if\n\t\t\t\t * focusing forward and the current focused element is the last one.\n\t\t\t\t */\n\t\t\t\tif ( document.activeElement === lastFocusableElement ) {\n\t\t\t\t\tevent.preventDefault()\n\t\t\t\t\tfirstFocusableElement?.focus()\n\t\t\t\t}\n\t\t\t\treturn\n\t\t\t}\n\n\n\t\t\t/**\n\t\t\t * Focus the last focusable element if\n\t\t\t * focusing backward and the current focused element is the first one.\n\t\t\t * \n\t\t\t */\n\t\t\tif ( document.activeElement === firstFocusableElement ) {\n\t\t\t\tevent.preventDefault()\n\t\t\t\tlastFocusableElement?.focus()\n\t\t\t}\n\n\t\t}\n\n\t\tdocument.addEventListener( 'keydown', keyDownHandler );\n\t\n\t\treturn () => {\n\t\t\tdocument.removeEventListener( 'keydown', keyDownHandler );\n\t\t}\n\n\t}, [ focusTrap ] )\n\n\treturn [ setFocusTrap, restoreFocusTrap ]\n\n}","import { useCallback } from 'react'\nimport {\n\tblockScroll as blockScrollHandler,\n\trestoreScroll as restoreScrollHandler\n} from '@alessiofrittoli/web-utils/dom'\n\n\n/**\n * Prevent Element overflow.\n * \n * @param target (Optional) The React RefObject target HTMLElement. Default: `Document.documentElement`.\n */\nexport const useScrollBlock = ( target?: React.RefObject<HTMLElement | null> ) => {\n\t\n\t/**\n\t * Block scroll.\n\t * \n\t */\n\tconst blockScroll = useCallback(\n\t\t() => blockScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\n\t/**\n\t * Restore scroll.\n\t * \n\t */\n\tconst restoreScroll = useCallback(\n\t\t() => restoreScrollHandler( target?.current || undefined ), [ target ]\n\t)\n\n\t\n\treturn [ blockScroll, restoreScroll ] as const\n\n}","import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}","import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}","import { useEffect } from 'react'\nimport { useIsFirstRender } from './useIsFirstRender'\n\n\n/**\n * Modified version of `useEffect` that skips the first render.\n *\n * @param\teffect\tImperative function that can return a cleanup function.\n * @param\tdeps\tIf present, effect will only activate if the values in the list change.\n */\nexport const useUpdateEffect = (\n\teffect\t: React.EffectCallback,\n\tdeps?\t: React.DependencyList,\n) => {\n\n\tconst isFirst = useIsFirstRender()\n\n\tuseEffect( () => {\n\t\tif ( ! isFirst ) return effect()\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t}, deps )\n\t\n}"]}

package/dist/misc/index.d.mts

@@ -1,3 +0,0 @@
-export { useIsClient } from './useIsClient.mjs';
-export { useIsFirstRender } from './useIsFirstRender.mjs';
-export { useUpdateEffect } from './useUpdateEffect.mjs';

package/dist/misc/index.d.ts

@@ -1,3 +0,0 @@
-export { useIsClient } from './useIsClient.js';
-export { useIsFirstRender } from './useIsFirstRender.js';
-export { useUpdateEffect } from './useUpdateEffect.js';

package/dist/misc/index.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react');var p=()=>{let[e,t]=react.useState(false);return react.useEffect(()=>t(true),[]),e};var s=()=>{let e=react.useRef(true);return e.current?(e.current=false,true):e.current};var E=(e,t)=>{let o=s();react.useEffect(()=>{if(!o)return e()},t);};exports.useIsClient=p;exports.useIsFirstRender=s;exports.useUpdateEffect=E;//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/misc/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsClient.ts","../../src/misc/useIsFirstRender.ts","../../src/misc/useUpdateEffect.ts"],"names":["useIsClient","isClient","setClient","useState","useEffect","useIsFirstRender","isFirst","useRef","useUpdateEffect","effect","deps"],"mappings":"4CAOaA,CAAc,CAAA,IAAM,CAEhC,GAAM,CAAEC,CAAUC,CAAAA,CAAU,CAAIC,CAAAA,cAAAA,CAAU,KAAM,CAEhD,CAAA,OAAAC,eAAW,CAAA,IAAMF,EAAW,IAAK,CAAA,CAAG,EAAG,EAEhCD,CAER,ECPO,IAAMI,CAAmB,CAAA,IAAM,CAErC,IAAMC,CAAAA,CAAUC,YAAQ,CAAA,IAAK,EAE7B,OAAKD,CAAAA,CAAQ,OACZA,EAAAA,CAAAA,CAAQ,QAAU,KAEX,CAAA,IAAA,EAGDA,CAAQ,CAAA,OAEhB,MCVaE,CAAkB,CAAA,CAC9BC,CACAC,CAAAA,CAAAA,GACI,CAEJ,IAAMJ,CAAAA,CAAUD,CAAiB,EAAA,CAEjCD,gBAAW,IAAM,CAChB,GAAK,CAAEE,EAAU,OAAOG,CAAAA,EAEzB,CAAA,CAAGC,CAAK,EAET","file":"index.js","sourcesContent":["import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}","import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}","import { useEffect } from 'react'\nimport { useIsFirstRender } from './useIsFirstRender'\n\n\n/**\n * Modified version of `useEffect` that skips the first render.\n *\n * @param\teffect\tImperative function that can return a cleanup function.\n * @param\tdeps\tIf present, effect will only activate if the values in the list change.\n */\nexport const useUpdateEffect = (\n\teffect\t: React.EffectCallback,\n\tdeps?\t: React.DependencyList,\n) => {\n\n\tconst isFirst = useIsFirstRender()\n\n\tuseEffect( () => {\n\t\tif ( ! isFirst ) return effect()\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t}, deps )\n\t\n}"]}

package/dist/misc/index.mjs

@@ -1,2 +0,0 @@
-import {useState,useEffect,useRef}from'react';var m=()=>{let[e,t]=useState(false);return useEffect(()=>t(true),[]),e};var o=()=>{let e=useRef(true);return e.current?(e.current=false,true):e.current};var F=(e,t)=>{let f=o();useEffect(()=>{if(!f)return e()},t);};export{m as useIsClient,o as useIsFirstRender,F as useUpdateEffect};//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/misc/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsClient.ts","../../src/misc/useIsFirstRender.ts","../../src/misc/useUpdateEffect.ts"],"names":["useIsClient","isClient","setClient","useState","useEffect","useIsFirstRender","isFirst","useRef","useUpdateEffect","effect","deps"],"mappings":"kDAOaA,CAAc,CAAA,IAAM,CAEhC,GAAM,CAAEC,CAAUC,CAAAA,CAAU,CAAIC,CAAAA,QAAAA,CAAU,KAAM,CAEhD,CAAA,OAAAC,SAAW,CAAA,IAAMF,EAAW,IAAK,CAAA,CAAG,EAAG,EAEhCD,CAER,ECPO,IAAMI,CAAmB,CAAA,IAAM,CAErC,IAAMC,CAAAA,CAAUC,MAAQ,CAAA,IAAK,EAE7B,OAAKD,CAAAA,CAAQ,OACZA,EAAAA,CAAAA,CAAQ,QAAU,KAEX,CAAA,IAAA,EAGDA,CAAQ,CAAA,OAEhB,MCVaE,CAAkB,CAAA,CAC9BC,CACAC,CAAAA,CAAAA,GACI,CAEJ,IAAMJ,CAAAA,CAAUD,CAAiB,EAAA,CAEjCD,UAAW,IAAM,CAChB,GAAK,CAAEE,EAAU,OAAOG,CAAAA,EAEzB,CAAA,CAAGC,CAAK,EAET","file":"index.mjs","sourcesContent":["import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}","import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}","import { useEffect } from 'react'\nimport { useIsFirstRender } from './useIsFirstRender'\n\n\n/**\n * Modified version of `useEffect` that skips the first render.\n *\n * @param\teffect\tImperative function that can return a cleanup function.\n * @param\tdeps\tIf present, effect will only activate if the values in the list change.\n */\nexport const useUpdateEffect = (\n\teffect\t: React.EffectCallback,\n\tdeps?\t: React.DependencyList,\n) => {\n\n\tconst isFirst = useIsFirstRender()\n\n\tuseEffect( () => {\n\t\tif ( ! isFirst ) return effect()\n\t\t// eslint-disable-next-line react-hooks/exhaustive-deps\n\t}, deps )\n\t\n}"]}

package/dist/misc/useIsClient.d.mts

@@ -1,8 +0,0 @@
-/**
- * Check if the React Hook or Component where this hook is executed is running in a browser environment.
- *
- * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.
- */
-declare const useIsClient: () => boolean;
-
-export { useIsClient };

package/dist/misc/useIsClient.d.ts

@@ -1,8 +0,0 @@
-/**
- * Check if the React Hook or Component where this hook is executed is running in a browser environment.
- *
- * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.
- */
-declare const useIsClient: () => boolean;
-
-export { useIsClient };

package/dist/misc/useIsClient.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react');var o=()=>{let[e,t]=react.useState(false);return react.useEffect(()=>t(true),[]),e};exports.useIsClient=o;//# sourceMappingURL=useIsClient.js.map
-//# sourceMappingURL=useIsClient.js.map

package/dist/misc/useIsClient.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsClient.ts"],"names":["useIsClient","isClient","setClient","useState","useEffect"],"mappings":"wCAOaA,IAAAA,CAAAA,CAAc,IAAM,CAEhC,GAAM,CAAEC,CAAUC,CAAAA,CAAU,EAAIC,cAAU,CAAA,KAAM,CAEhD,CAAA,OAAAC,eAAW,CAAA,IAAMF,CAAW,CAAA,IAAK,CAAG,CAAA,EAAG,CAAA,CAEhCD,CAER","file":"useIsClient.js","sourcesContent":["import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}"]}

package/dist/misc/useIsClient.mjs

@@ -1,2 +0,0 @@
-import {useState,useEffect}from'react';var u=()=>{let[e,t]=useState(false);return useEffect(()=>t(true),[]),e};export{u as useIsClient};//# sourceMappingURL=useIsClient.mjs.map
-//# sourceMappingURL=useIsClient.mjs.map

package/dist/misc/useIsClient.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsClient.ts"],"names":["useIsClient","isClient","setClient","useState","useEffect"],"mappings":"uCAOaA,IAAAA,CAAAA,CAAc,IAAM,CAEhC,GAAM,CAAEC,CAAUC,CAAAA,CAAU,EAAIC,QAAU,CAAA,KAAM,CAEhD,CAAA,OAAAC,SAAW,CAAA,IAAMF,CAAW,CAAA,IAAK,CAAG,CAAA,EAAG,CAAA,CAEhCD,CAER","file":"useIsClient.mjs","sourcesContent":["import { useEffect, useState } from 'react'\n\n/**\n * Check if the React Hook or Component where this hook is executed is running in a browser environment.\n * \n * @returns `true` if the React Hook or Component is running in a browser environment, `false` otherwise.\n */\nexport const useIsClient = () => {\n\n\tconst [ isClient, setClient ] = useState( false )\n\n\tuseEffect( () => setClient( true ), [] )\n\n\treturn isClient\n\n}"]}

package/dist/misc/useIsFirstRender.d.mts

@@ -1,9 +0,0 @@
-/**
- * Check if is first React Hook/Component render.
- *
- * @returns `true` at the mount time, then always `false`.
- * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.
- */
-declare const useIsFirstRender: () => boolean;
-
-export { useIsFirstRender };

package/dist/misc/useIsFirstRender.d.ts

@@ -1,9 +0,0 @@
-/**
- * Check if is first React Hook/Component render.
- *
- * @returns `true` at the mount time, then always `false`.
- * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.
- */
-declare const useIsFirstRender: () => boolean;
-
-export { useIsFirstRender };

package/dist/misc/useIsFirstRender.js

@@ -1,2 +0,0 @@
-'use strict';var react=require('react');var u=()=>{let r=react.useRef(true);return r.current?(r.current=false,true):r.current};exports.useIsFirstRender=u;//# sourceMappingURL=useIsFirstRender.js.map
-//# sourceMappingURL=useIsFirstRender.js.map

package/dist/misc/useIsFirstRender.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsFirstRender.ts"],"names":["useIsFirstRender","isFirst","useRef"],"mappings":"wCAQO,IAAMA,EAAmB,IAAM,CAErC,IAAMC,CAAUC,CAAAA,YAAAA,CAAQ,IAAK,CAE7B,CAAA,OAAKD,EAAQ,OACZA,EAAAA,CAAAA,CAAQ,QAAU,KAEX,CAAA,IAAA,EAGDA,EAAQ,OAEhB","file":"useIsFirstRender.js","sourcesContent":["import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}"]}

package/dist/misc/useIsFirstRender.mjs

@@ -1,2 +0,0 @@
-import {useRef}from'react';var n=()=>{let r=useRef(true);return r.current?(r.current=false,true):r.current};export{n as useIsFirstRender};//# sourceMappingURL=useIsFirstRender.mjs.map
-//# sourceMappingURL=useIsFirstRender.mjs.map

package/dist/misc/useIsFirstRender.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/misc/useIsFirstRender.ts"],"names":["useIsFirstRender","isFirst","useRef"],"mappings":"2BAQO,IAAMA,EAAmB,IAAM,CAErC,IAAMC,CAAUC,CAAAA,MAAAA,CAAQ,IAAK,CAE7B,CAAA,OAAKD,EAAQ,OACZA,EAAAA,CAAAA,CAAQ,QAAU,KAEX,CAAA,IAAA,EAGDA,EAAQ,OAEhB","file":"useIsFirstRender.mjs","sourcesContent":["import { useRef } from 'react'\n\n/**\n * Check if is first React Hook/Component render.\n * \n * @returns `true` at the mount time, then always `false`.\n * - Note that if the React Hook/Component has no state updates, `useIsFirstRender` will always return `true`.\n */\nexport const useIsFirstRender = () => {\n\n\tconst isFirst = useRef( true )\n\n\tif ( isFirst.current ) {\n\t\tisFirst.current = false\n\n\t\treturn true\n\t}\n\n\treturn isFirst.current\n\t\n}"]}

package/dist/misc/usePagination.d.mts

@@ -1,12 +0,0 @@
-import * as _alessiofrittoli_math_utils_helpers from '@alessiofrittoli/math-utils/helpers';
-import { PaginateOptions } from '@alessiofrittoli/math-utils/helpers';
-
-/**
- * Get pagination informations based on the given options.
- *
- * @param options An object defining pagination input data. See {@link PaginateOptions} for more information.
- * @returns A memoized object containing pagination informations based on the given options.
- */
-declare const usePagination: (options?: PaginateOptions) => _alessiofrittoli_math_utils_helpers.Pagination;
-
-export { usePagination };

package/dist/misc/usePagination.d.ts

@@ -1,12 +0,0 @@
-import * as _alessiofrittoli_math_utils_helpers from '@alessiofrittoli/math-utils/helpers';
-import { PaginateOptions } from '@alessiofrittoli/math-utils/helpers';
-
-/**
- * Get pagination informations based on the given options.
- *
- * @param options An object defining pagination input data. See {@link PaginateOptions} for more information.
- * @returns A memoized object containing pagination informations based on the given options.
- */
-declare const usePagination: (options?: PaginateOptions) => _alessiofrittoli_math_utils_helpers.Pagination;
-
-export { usePagination };