@siberiacancode/reactuse 0.3.0 → 0.3.1

package/dist/cjs/hooks/useUrlSearchParam/useUrlSearchParam.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("react"),l="reactuse-url-search-params-event",d=(n="history")=>{const{search:i,hash:r}=window.location;let s="";if(n==="history"&&(s=i),n==="hash-params"&&(s=r.replace(/^#/,"")),n==="hash"){const t=r.indexOf("?");s=~t?r.slice(t):""}return new URLSearchParams(s)},g=(n,i)=>{const r=n.toString(),{search:s,hash:t}=window.location;if(i==="history")return`${r?`?${r}`:""}${t}`;if(i==="hash-params")return`${s}${r?`#${r}`:""}`;if(i==="hash"){const o=t.indexOf("?"),h=o>-1?t.slice(0,o):t;return`${s}${h}${r?`?${r}`:""}`}throw new Error("Invalid mode")},p=()=>window.dispatchEvent(new Event(l)),z=(n,i)=>{const r=typeof i=="object"&&i&&("serializer"in i||"deserializer"in i||"initialValue"in i||"mode"in i||"write"in i)?i:void 0,s=r?r?.initialValue:i,{mode:t="history",write:o="replace"}=r??{};if(typeof window>"u")return{value:s,remove:()=>{},set:()=>{}};const h=e=>r?.serializer?r.serializer(e):typeof e=="string"?e:JSON.stringify(e),S=e=>{if(r?.deserializer)return r.deserializer(e);if(!(e==="undefined"||e==="null"))try{return JSON.parse(e)}catch{return e}},u=(e,a,c,v="replace")=>{const f=d(c),$=a!==void 0?h?h(a):String(a):"";a===void 0?f.delete(e):f.set(e,$);const E=g(f,c);v==="replace"&&window.history.replaceState({},"",E),v==="push"&&window.history.pushState({},"",E),p()},[m,w]=P.useState(()=>{const a=d(t).get(n);return a===null&&s!==void 0?(u(n,s,t,o),s):a?S(a):void 0}),y=(e,a)=>{u(n,e,t,a?.write??o),w(e)},U=e=>{u(n,void 0,t,e?.write??o),w(void 0)};return P.useEffect(()=>{const e=()=>{const c=d(t).get(n);w(c?S(c):void 0)};return window.addEventListener(l,e),window.addEventListener("popstate",e),t!=="history"&&window.addEventListener("hashchange",e),()=>{window.removeEventListener(l,e),window.removeEventListener("popstate",e),t!=="history"&&window.removeEventListener("hashchange",e)}},[n,t]),{value:m,remove:U,set:y}};exports.URL_SEARCH_PARAMS_EVENT=l;exports.createQueryString=g;exports.dispatchUrlSearchParamsEvent=p;exports.getUrlSearchParams=d;exports.useUrlSearchParam=z;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("react"),l="reactuse-url-search-params-event",d=(n="history")=>{const{search:i,hash:r}=window.location;let s="";if(n==="history"&&(s=i),n==="hash-params"&&(s=r.replace(/^#/,"")),n==="hash"){const t=r.indexOf("?");s=~t?r.slice(t):""}return new URLSearchParams(s)},g=(n,i)=>{const r=n.toString(),{search:s,hash:t}=window.location;if(i==="history")return`${r?`?${r}`:""}${t}`;if(i==="hash-params")return`${s}${r?`#${r}`:""}`;if(i==="hash"){const o=t.indexOf("?"),h=o>-1?t.slice(0,o):t;return`${s}${h}${r?`?${r}`:""}`}throw new Error("Invalid mode")},p=()=>window.dispatchEvent(new Event(l)),z=(n,i)=>{const r=typeof i=="object"&&i&&("serializer"in i||"deserializer"in i||"initialValue"in i||"mode"in i||"write"in i)?i:void 0,s=r?r?.initialValue:i,{mode:t="history",write:o="replace"}=r??{};if(typeof window>"u")return{value:s,remove:()=>{},set:()=>{}};const h=e=>r?.serializer?r.serializer(e):typeof e=="string"?e:JSON.stringify(e),f=e=>{if(r?.deserializer)return r.deserializer(e);if(!(e==="undefined"||e==="null"))try{return JSON.parse(e)}catch{return e}},u=(e,a,c,v="replace")=>{const S=d(c);if(a===void 0)S.delete(e);else{const $=h?h(a):String(a);S.set(e,$)}const E=g(S,c);v==="replace"&&window.history.replaceState({},"",E),v==="push"&&window.history.pushState({},"",E),p()},[m,w]=P.useState(()=>{const a=d(t).get(n);return a===null&&s!==void 0?(u(n,s,t,o),s):a?f(a):void 0}),y=(e,a)=>{u(n,e,t,a?.write??o),w(e)},U=e=>{u(n,void 0,t,e?.write??o),w(void 0)};return P.useEffect(()=>{const e=()=>{const c=d(t).get(n);w(c?f(c):void 0)};return window.addEventListener(l,e),window.addEventListener("popstate",e),t!=="history"&&window.addEventListener("hashchange",e),()=>{window.removeEventListener(l,e),window.removeEventListener("popstate",e),t!=="history"&&window.removeEventListener("hashchange",e)}},[n,t]),{value:m,remove:U,set:y}};exports.URL_SEARCH_PARAMS_EVENT=l;exports.createQueryString=g;exports.dispatchUrlSearchParamsEvent=p;exports.getUrlSearchParams=d;exports.useUrlSearchParam=z;
 //# sourceMappingURL=useUrlSearchParam.cjs.map

package/dist/cjs/hooks/useUrlSearchParam/useUrlSearchParam.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useUrlSearchParam.cjs","sources":["../../../../src/hooks/useUrlSearchParam/useUrlSearchParam.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The url search params mode type */\nexport type UrlSearchParamMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search param options type */\nexport interface UseUrlSearchParamOptions<Value> {\n  /** The initial value of the search param */\n  initialValue?: Value;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamMode;\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n  /** The deserializer function to be invoked */\n  deserializer?: (value: string) => Value;\n  /** The serializer function to be invoked */\n  serializer?: (value: Value) => string;\n}\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsActionOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/** The use url search param return type */\nexport interface UseUrlSearchParamReturn<Value> {\n  /** Current search param value */\n  value: Value | undefined;\n  /** Function to remove the search param */\n  remove: (options?: UseUrlSearchParamsActionOptions) => void;\n  /** Function to update search param */\n  set: (value: Value, options?: UseUrlSearchParamsActionOptions) => void;\n}\n\nexport const URL_SEARCH_PARAMS_EVENT = 'reactuse-url-search-params-event';\n\nexport const getUrlSearchParams = (mode: UrlSearchParamMode = 'history') => {\n  const { search, hash } = window.location;\n\n  let path = '';\n\n  if (mode === 'history') path = search;\n  if (mode === 'hash-params') path = hash.replace(/^#/, '');\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    path = ~index ? hash.slice(index) : '';\n  }\n\n  return new URLSearchParams(path);\n};\n\nexport const createQueryString = (searchParams: URLSearchParams, mode: UrlSearchParamMode) => {\n  const searchParamsString = searchParams.toString();\n  const { search, hash } = window.location;\n\n  if (mode === 'history') return `${searchParamsString ? `?${searchParamsString}` : ''}${hash}`;\n  if (mode === 'hash-params')\n    return `${search}${searchParamsString ? `#${searchParamsString}` : ''}`;\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    const base = index > -1 ? hash.slice(0, index) : hash;\n    return `${search}${base}${searchParamsString ? `?${searchParamsString}` : ''}`;\n  }\n\n  throw new Error('Invalid mode');\n};\n\nexport const dispatchUrlSearchParamsEvent = () =>\n  window.dispatchEvent(new Event(URL_SEARCH_PARAMS_EVENT));\n\nexport interface UseUrlSearchParam {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamOptions<Value> & { initialValue: Value }\n  ): UseUrlSearchParamReturn<Value>;\n\n  <Value>(\n    key: string,\n    options?: UseUrlSearchParamOptions<Value>\n  ): UseUrlSearchParamReturn<Value | undefined>;\n\n  <Value>(key: string, initialValue: Value): UseUrlSearchParamReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParam\n * @description - Hook that provides reactive URLSearchParams for a single key\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {UseUrlSearchParamOptions<Value> & { initialValue: Value }} options The options object with required initialValue\n * @param {Value} options.initialValue The initial value for the url param\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', { initialValue: 1 });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {Value} [initialValue] The initial value for the url param\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', 1);\n */\nexport const useUrlSearchParam = (<Value>(key: string, params?: any) => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : undefined\n  ) as UseUrlSearchParamOptions<Value>;\n\n  const initialValue = (options ? options?.initialValue : params) as Value;\n  const { mode = 'history', write: writeMode = 'replace' } = options ?? {};\n\n  if (typeof window === 'undefined') {\n    return {\n      value: initialValue,\n      remove: () => {},\n      set: () => {}\n    } as UseUrlSearchParamReturn<Value>;\n  }\n\n  const serializer = (value: Value) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined' || value === 'null') return undefined as unknown as Value;\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value;\n    }\n  };\n\n  const setUrlSearchParam = (\n    key: string,\n    value: Value | undefined,\n    mode: UrlSearchParamMode,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const searchParams = getUrlSearchParams(mode);\n    const serializedValue =\n      value !== undefined ? (serializer ? serializer(value) : String(value)) : '';\n\n    if (value === undefined) {\n      searchParams.delete(key);\n    } else {\n      searchParams.set(key, serializedValue);\n    }\n\n    const query = createQueryString(searchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    dispatchUrlSearchParamsEvent();\n  };\n\n  const [value, setValue] = useState<Value | undefined>(() => {\n    const searchParams = getUrlSearchParams(mode);\n    const currentValue = searchParams.get(key);\n\n    if (currentValue === null && initialValue !== undefined) {\n      setUrlSearchParam(key, initialValue, mode, writeMode);\n      return initialValue;\n    }\n\n    return currentValue ? deserializer(currentValue) : undefined;\n  });\n\n  const set = (value: Value, options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, value, mode, options?.write ?? writeMode);\n    setValue(value);\n  };\n\n  const remove = (options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, undefined, mode, options?.write ?? writeMode);\n    setValue(undefined);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      const newValue = searchParams.get(key);\n      setValue(newValue ? deserializer(newValue) : undefined);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') {\n      window.addEventListener('hashchange', onParamsChange);\n    }\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') {\n        window.removeEventListener('hashchange', onParamsChange);\n      }\n    };\n  }, [key, mode]);\n\n  return {\n    value,\n    remove,\n    set\n  };\n}) as UseUrlSearchParam;\n"],"names":["URL_SEARCH_PARAMS_EVENT","getUrlSearchParams","mode","search","hash","path","index","createQueryString","searchParams","searchParamsString","base","dispatchUrlSearchParamsEvent","useUrlSearchParam","key","params","options","initialValue","writeMode","serializer","value","deserializer","setUrlSearchParam","write","serializedValue","query","setValue","useState","currentValue","set","remove","useEffect","onParamsChange","newValue"],"mappings":"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"}
+{"version":3,"file":"useUrlSearchParam.cjs","sources":["../../../../src/hooks/useUrlSearchParam/useUrlSearchParam.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The url search params mode type */\nexport type UrlSearchParamMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search param options type */\nexport interface UseUrlSearchParamOptions<Value> {\n  /** The initial value of the search param */\n  initialValue?: Value;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamMode;\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n  /** The deserializer function to be invoked */\n  deserializer?: (value: string) => Value;\n  /** The serializer function to be invoked */\n  serializer?: (value: Value) => string;\n}\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsActionOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/** The use url search param return type */\nexport interface UseUrlSearchParamReturn<Value> {\n  /** Current search param value */\n  value: Value | undefined;\n  /** Function to remove the search param */\n  remove: (options?: UseUrlSearchParamsActionOptions) => void;\n  /** Function to update search param */\n  set: (value: Value, options?: UseUrlSearchParamsActionOptions) => void;\n}\n\nexport const URL_SEARCH_PARAMS_EVENT = 'reactuse-url-search-params-event';\n\nexport const getUrlSearchParams = (mode: UrlSearchParamMode = 'history') => {\n  const { search, hash } = window.location;\n\n  let path = '';\n\n  if (mode === 'history') path = search;\n  if (mode === 'hash-params') path = hash.replace(/^#/, '');\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    path = ~index ? hash.slice(index) : '';\n  }\n\n  return new URLSearchParams(path);\n};\n\nexport const createQueryString = (searchParams: URLSearchParams, mode: UrlSearchParamMode) => {\n  const searchParamsString = searchParams.toString();\n  const { search, hash } = window.location;\n\n  if (mode === 'history') return `${searchParamsString ? `?${searchParamsString}` : ''}${hash}`;\n  if (mode === 'hash-params')\n    return `${search}${searchParamsString ? `#${searchParamsString}` : ''}`;\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    const base = index > -1 ? hash.slice(0, index) : hash;\n    return `${search}${base}${searchParamsString ? `?${searchParamsString}` : ''}`;\n  }\n\n  throw new Error('Invalid mode');\n};\n\nexport const dispatchUrlSearchParamsEvent = () =>\n  window.dispatchEvent(new Event(URL_SEARCH_PARAMS_EVENT));\n\nexport interface UseUrlSearchParam {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamOptions<Value> & { initialValue: Value }\n  ): UseUrlSearchParamReturn<Value>;\n\n  <Value>(\n    key: string,\n    options?: UseUrlSearchParamOptions<Value>\n  ): UseUrlSearchParamReturn<Value | undefined>;\n\n  <Value>(key: string, initialValue: Value): UseUrlSearchParamReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParam\n * @description - Hook that provides reactive URLSearchParams for a single key\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {UseUrlSearchParamOptions<Value> & { initialValue: Value }} options The options object with required initialValue\n * @param {Value} options.initialValue The initial value for the url param\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', { initialValue: 1 });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {Value} [initialValue] The initial value for the url param\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', 1);\n */\nexport const useUrlSearchParam = (<Value>(key: string, params?: any) => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : undefined\n  ) as UseUrlSearchParamOptions<Value>;\n\n  const initialValue = (options ? options?.initialValue : params) as Value;\n  const { mode = 'history', write: writeMode = 'replace' } = options ?? {};\n\n  if (typeof window === 'undefined') {\n    return {\n      value: initialValue,\n      remove: () => {},\n      set: () => {}\n    } as UseUrlSearchParamReturn<Value>;\n  }\n\n  const serializer = (value: Value) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined' || value === 'null') return undefined as unknown as Value;\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value;\n    }\n  };\n\n  const setUrlSearchParam = (\n    key: string,\n    value: Value | undefined,\n    mode: UrlSearchParamMode,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = getUrlSearchParams(mode);\n\n    if (value === undefined) {\n      urlSearchParams.delete(key);\n    } else {\n      const serializedValue = serializer ? serializer(value) : String(value);\n      urlSearchParams.set(key, serializedValue);\n    }\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    dispatchUrlSearchParamsEvent();\n  };\n\n  const [value, setValue] = useState<Value | undefined>(() => {\n    const urlSearchParams = getUrlSearchParams(mode);\n    const currentValue = urlSearchParams.get(key);\n\n    if (currentValue === null && initialValue !== undefined) {\n      setUrlSearchParam(key, initialValue, mode, writeMode);\n      return initialValue;\n    }\n\n    return currentValue ? deserializer(currentValue) : undefined;\n  });\n\n  const set = (value: Value, options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, value, mode, options?.write ?? writeMode);\n    setValue(value);\n  };\n\n  const remove = (options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, undefined, mode, options?.write ?? writeMode);\n    setValue(undefined);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const urlSearchParams = getUrlSearchParams(mode);\n      const newValue = urlSearchParams.get(key);\n      setValue(newValue ? deserializer(newValue) : undefined);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') {\n      window.addEventListener('hashchange', onParamsChange);\n    }\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') {\n        window.removeEventListener('hashchange', onParamsChange);\n      }\n    };\n  }, [key, mode]);\n\n  return {\n    value,\n    remove,\n    set\n  };\n}) as UseUrlSearchParam;\n"],"names":["URL_SEARCH_PARAMS_EVENT","getUrlSearchParams","mode","search","hash","path","index","createQueryString","searchParams","searchParamsString","base","dispatchUrlSearchParamsEvent","useUrlSearchParam","key","params","options","initialValue","writeMode","serializer","value","deserializer","setUrlSearchParam","write","urlSearchParams","serializedValue","query","setValue","useState","currentValue","set","remove","useEffect","onParamsChange","newValue"],"mappings":"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"}

package/dist/cjs/hooks/useUrlSearchParams/useUrlSearchParams.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("react"),n=require("../useUrlSearchParam/useUrlSearchParam.cjs"),L=t=>{const i=typeof t=="object"&&t&&("serializer"in t||"deserializer"in t||"initialValue"in t||"mode"in t||"write"in t)?t:{},u=i?i?.initialValue:t,{mode:s="history",write:d="replace"}=i,l=e=>i?.serializer?i.serializer(e):typeof e=="string"?e:JSON.stringify(e),U=e=>{if(i?.deserializer)return i.deserializer(e);if(e!=="undefined")try{return JSON.parse(e)}catch{return e}},S=(e,r,a="replace")=>{const o=new URLSearchParams;Object.entries(r).forEach(([y,h])=>{Array.isArray(h)?h.forEach(m=>o.set(y,l(m))):o.set(y,l(h))});const P=n.createQueryString(o,e);return a==="replace"&&window.history.replaceState({},"",P),a==="push"&&window.history.pushState({},"",P),o},c=e=>typeof e=="string"?c(new URLSearchParams(e)):e instanceof URLSearchParams?Array.from(e.entries()).reduce((r,[a,o])=>(r[a]=U(o),r),{}):e,[f,w]=E.useState(()=>{if(typeof window>"u")return u??{};const e=n.getUrlSearchParams(s),r={...u&&c(u),...c(e)};return S(s,r,d),r}),g=(e,r)=>{const a=S(s,{...f,...e},r?.write??d);w(c(a)),n.dispatchUrlSearchParamsEvent()};return E.useEffect(()=>{const e=()=>{const r=n.getUrlSearchParams(s);w(c(r))};return window.addEventListener(n.URL_SEARCH_PARAMS_EVENT,e),window.addEventListener("popstate",e),s!=="history"&&window.addEventListener("hashchange",e),()=>{window.removeEventListener(n.URL_SEARCH_PARAMS_EVENT,e),window.removeEventListener("popstate",e),s!=="history"&&window.removeEventListener("hashchange",e)}},[s]),{value:f,set:g}};exports.createQueryString=n.createQueryString;exports.dispatchUrlSearchParamsEvent=n.dispatchUrlSearchParamsEvent;exports.getUrlSearchParams=n.getUrlSearchParams;exports.useUrlSearchParams=L;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react"),t=require("../useUrlSearchParam/useUrlSearchParam.cjs"),v=i=>{const n=typeof i=="object"&&i&&("serializer"in i||"deserializer"in i||"initialValue"in i||"mode"in i||"write"in i)?i:{},u=n?n?.initialValue:i,{mode:s="history",write:d="replace"}=n,h=e=>n?.serializer?n.serializer(e):typeof e=="string"?e:JSON.stringify(e),E=e=>{if(n?.deserializer)return n.deserializer(e);if(e!=="undefined")try{return JSON.parse(e)}catch{return e}},S=(e,r,a="replace")=>{const o=t.getUrlSearchParams(e);Object.entries(r).forEach(([g,l])=>{if(l===void 0)o.delete(g);else{const m=h?h(l):String(l);o.set(g,m)}});const P=t.createQueryString(o,e);return a==="replace"&&window.history.replaceState({},"",P),a==="push"&&window.history.pushState({},"",P),t.dispatchUrlSearchParamsEvent(),o},c=e=>typeof e=="string"?c(new URLSearchParams(e)):e instanceof URLSearchParams?Array.from(e.entries()).reduce((r,[a,o])=>(r[a]=E(o),r),{}):e,[f,w]=y.useState(()=>{if(typeof window>"u")return u??{};const e=t.getUrlSearchParams(s),r={...u&&c(u),...c(e)};return S(s,r,d),r}),U=(e,r)=>{const a=S(s,{...f,...e},r?.write??d);w(c(a))};return y.useEffect(()=>{const e=()=>{const r=t.getUrlSearchParams(s);w(c(r))};return window.addEventListener(t.URL_SEARCH_PARAMS_EVENT,e),window.addEventListener("popstate",e),s!=="history"&&window.addEventListener("hashchange",e),()=>{window.removeEventListener(t.URL_SEARCH_PARAMS_EVENT,e),window.removeEventListener("popstate",e),s!=="history"&&window.removeEventListener("hashchange",e)}},[s]),{value:f,set:U}};exports.createQueryString=t.createQueryString;exports.dispatchUrlSearchParamsEvent=t.dispatchUrlSearchParamsEvent;exports.getUrlSearchParams=t.getUrlSearchParams;exports.useUrlSearchParams=v;
 //# sourceMappingURL=useUrlSearchParams.cjs.map

package/dist/cjs/hooks/useUrlSearchParams/useUrlSearchParams.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useUrlSearchParams.cjs","sources":["../../../../src/hooks/useUrlSearchParams/useUrlSearchParams.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport {\n  createQueryString,\n  dispatchUrlSearchParamsEvent,\n  getUrlSearchParams,\n  URL_SEARCH_PARAMS_EVENT\n} from '../useUrlSearchParam/useUrlSearchParam';\n\n/** The url params type */\nexport type UrlParams = Record<string, any>;\n\n/** The url search params mod */\nexport type UrlSearchParamsMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsSetOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/* The use search params initial value type */\nexport type UseUrlSearchParamsInitialValue<Value> = (() => Value) | Value;\n\n/** The use url search params options type */\nexport interface UseUrlSearchParamsOptions<Value> {\n  /* The initial value of the url search params */\n  initialValue?: UseUrlSearchParamsInitialValue<string | URLSearchParams | Value>;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamsMode;\n  /** The mode to use for writing to the URL  */\n  write?: 'push' | 'replace';\n  /* The deserializer function to be invoked */\n  deserializer?: (value: string) => Value[keyof Value];\n  /* The serializer function to be invoked */\n  serializer?: (value: Value[keyof Value]) => string;\n}\n\n/** The use url search params return type */\nexport interface UseUrlSearchParamsReturn<Value> {\n  /** The value of the url search params */\n  value: Value;\n  /** The set function */\n  set: (value: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => void;\n}\n\nexport interface UseUrlSearchParams {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamsOptions<Value> & {\n      initialValue: UseUrlSearchParamsInitialValue<Value>;\n    }\n  ): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(options?: UseUrlSearchParamsOptions<Value>): UseUrlSearchParamsReturn<Value | undefined>;\n\n  <Value>(initialValue: UseUrlSearchParamsInitialValue<Value>): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamsReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParams\n * @description - Hook that provides reactive URLSearchParams\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsOptions<Value> & { initialValue: UseUrlSearchParamsInitialValue<Value> }} options The options object with required initialValue\n * @param {UseUrlSearchParamsInitialValue<Value>} [options.initialValue] The initial value for the url params\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value[keyof Value]) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value[keyof Value]} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ initialValue: { page: 1 } });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsInitialValue<Value>} [initialValue] The initial value for the url params\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ page: 1 });\n */\nexport const useUrlSearchParams = (<Value extends UrlParams>(\n  params: any\n): UseUrlSearchParamsReturn<Value> => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : {}\n  ) as UseUrlSearchParamsOptions<Value>;\n  const initialValue = (\n    options ? options?.initialValue : params\n  ) as UseUrlSearchParamsInitialValue<Value>;\n\n  const { mode = 'history', write: writeMode = 'replace' } = options;\n\n  const serializer = (value: Value[keyof Value]) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined') return undefined as unknown as Value[keyof Value];\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value[keyof Value];\n    }\n  };\n\n  const setUrlSearchParams = <Value extends UrlParams>(\n    mode: UrlSearchParamsMode,\n    value: Partial<Value>,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = new URLSearchParams();\n\n    Object.entries(value).forEach(([key, param]) => {\n      if (Array.isArray(param)) {\n        param.forEach((value) => urlSearchParams.set(key, serializer(value)));\n      } else {\n        urlSearchParams.set(key, serializer(param));\n      }\n    });\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    return urlSearchParams;\n  };\n\n  const getParsedUrlSearchParams = (searchParams: string | UrlParams | URLSearchParams) => {\n    if (typeof searchParams === 'string') {\n      return getParsedUrlSearchParams(new URLSearchParams(searchParams));\n    }\n\n    if (searchParams instanceof URLSearchParams) {\n      return Array.from(searchParams.entries()).reduce(\n        (acc, [key, value]) => {\n          acc[key] = deserializer(value);\n          return acc;\n        },\n        {} as Record<string, any>\n      );\n    }\n\n    return searchParams;\n  };\n\n  const [value, setValue] = useState<Value>(() => {\n    if (typeof window === 'undefined') return (initialValue ?? {}) as Value;\n\n    const urlSearchParams = getUrlSearchParams(mode);\n    const value = {\n      ...(initialValue && getParsedUrlSearchParams(initialValue)),\n      ...getParsedUrlSearchParams(urlSearchParams)\n    } as Value;\n\n    setUrlSearchParams(mode, value, writeMode);\n\n    return value;\n  });\n\n  const set = (params: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => {\n    const searchParams = setUrlSearchParams(\n      mode,\n      { ...value, ...params },\n      options?.write ?? writeMode\n    );\n    setValue(getParsedUrlSearchParams(searchParams) as Value);\n    dispatchUrlSearchParamsEvent();\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      setValue(getParsedUrlSearchParams(searchParams) as Value);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') window.addEventListener('hashchange', onParamsChange);\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') window.removeEventListener('hashchange', onParamsChange);\n    };\n  }, [mode]);\n\n  return {\n    value,\n    set\n  };\n}) as UseUrlSearchParams;\n\nexport { createQueryString, dispatchUrlSearchParamsEvent, getUrlSearchParams };\n"],"names":["useUrlSearchParams","params","options","initialValue","mode","writeMode","serializer","value","deserializer","setUrlSearchParams","write","urlSearchParams","key","param","query","createQueryString","getParsedUrlSearchParams","searchParams","acc","setValue","useState","getUrlSearchParams","set","dispatchUrlSearchParamsEvent","useEffect","onParamsChange","URL_SEARCH_PARAMS_EVENT"],"mappings":"iKAwFaA,EACXC,GACoC,CACpC,MAAMC,EACJ,OAAOD,GAAW,UAClBA,IACC,eAAgBA,GACf,iBAAkBA,GAClB,iBAAkBA,GAClB,SAAUA,GACV,UAAWA,GACTA,EACA,CAAA,EAEAE,EACJD,EAAUA,GAAS,aAAeD,EAG9B,CAAE,KAAAG,EAAO,UAAW,MAAOC,EAAY,WAAcH,EAErDI,EAAcC,GACdL,GAAS,WAAmBA,EAAQ,WAAWK,CAAK,EACpD,OAAOA,GAAU,SAAiBA,EAC/B,KAAK,UAAUA,CAAK,EAGvBC,EAAgBD,GAAkB,CACtC,GAAIL,GAAS,aAAc,OAAOA,EAAQ,aAAaK,CAAK,EAC5D,GAAIA,IAAU,YAEd,GAAI,CACF,OAAO,KAAK,MAAMA,CAAK,CAAA,MACjB,CACN,OAAOA,CAAA,CACT,EAGIE,EAAqB,CACzBL,EACAG,EACAG,EAA4B,YACzB,CACH,MAAMC,EAAkB,IAAI,gBAE5B,OAAO,QAAQJ,CAAK,EAAE,QAAQ,CAAC,CAACK,EAAKC,CAAK,IAAM,CAC1C,MAAM,QAAQA,CAAK,EACrBA,EAAM,QAASN,GAAUI,EAAgB,IAAIC,EAAKN,EAAWC,CAAK,CAAC,CAAC,EAEpEI,EAAgB,IAAIC,EAAKN,EAAWO,CAAK,CAAC,CAC5C,CACD,EAED,MAAMC,EAAQC,EAAAA,kBAAkBJ,EAAiBP,CAAI,EACrD,OAAIM,IAAU,WAAW,OAAO,QAAQ,aAAa,CAAA,EAAI,GAAII,CAAK,EAC9DJ,IAAU,QAAQ,OAAO,QAAQ,UAAU,CAAA,EAAI,GAAII,CAAK,EAErDH,CAAA,EAGHK,EAA4BC,GAC5B,OAAOA,GAAiB,SACnBD,EAAyB,IAAI,gBAAgBC,CAAY,CAAC,EAG/DA,aAAwB,gBACnB,MAAM,KAAKA,EAAa,QAAA,CAAS,EAAE,OACxC,CAACC,EAAK,CAACN,EAAKL,CAAK,KACfW,EAAIN,CAAG,EAAIJ,EAAaD,CAAK,EACtBW,GAET,CAAA,CAAC,EAIED,EAGH,CAACV,EAAOY,CAAQ,EAAIC,EAAAA,SAAgB,IAAM,CAC9C,GAAI,OAAO,OAAW,IAAa,OAAQjB,GAAgB,CAAA,EAE3D,MAAMQ,EAAkBU,EAAAA,mBAAmBjB,CAAI,EACzCG,EAAQ,CACZ,GAAIJ,GAAgBa,EAAyBb,CAAY,EACzD,GAAGa,EAAyBL,CAAe,CAAA,EAG7C,OAAAF,EAAmBL,EAAMG,EAAOF,CAAS,EAElCE,CAAA,CACR,EAEKe,EAAM,CAACrB,EAAwBC,IAA2C,CAC9E,MAAMe,EAAeR,EACnBL,EACA,CAAE,GAAGG,EAAO,GAAGN,CAAAA,EACfC,GAAS,OAASG,CAAA,EAEpBc,EAASH,EAAyBC,CAAY,CAAU,EACxDM,+BAAA,CAA6B,EAG/BC,OAAAA,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAiB,IAAM,CAC3B,MAAMR,EAAeI,EAAAA,mBAAmBjB,CAAI,EAC5Ce,EAASH,EAAyBC,CAAY,CAAU,CAAA,EAG1D,cAAO,iBAAiBS,EAAAA,wBAAyBD,CAAc,EAC/D,OAAO,iBAAiB,WAAYA,CAAc,EAC9CrB,IAAS,WAAW,OAAO,iBAAiB,aAAcqB,CAAc,EAErE,IAAM,CACX,OAAO,oBAAoBC,EAAAA,wBAAyBD,CAAc,EAClE,OAAO,oBAAoB,WAAYA,CAAc,EACjDrB,IAAS,WAAW,OAAO,oBAAoB,aAAcqB,CAAc,CAAA,CACjF,EACC,CAACrB,CAAI,CAAC,EAEF,CACL,MAAAG,EACA,IAAAe,CAAA,CAEJ"}
+{"version":3,"file":"useUrlSearchParams.cjs","sources":["../../../../src/hooks/useUrlSearchParams/useUrlSearchParams.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport {\n  createQueryString,\n  dispatchUrlSearchParamsEvent,\n  getUrlSearchParams,\n  URL_SEARCH_PARAMS_EVENT\n} from '../useUrlSearchParam/useUrlSearchParam';\n\n/** The url params type */\nexport type UrlParams = Record<string, any>;\n\n/** The url search params mod */\nexport type UrlSearchParamsMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsSetOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/* The use search params initial value type */\nexport type UseUrlSearchParamsInitialValue<Value> = (() => Value) | Value;\n\n/** The use url search params options type */\nexport interface UseUrlSearchParamsOptions<Value> {\n  /* The initial value of the url search params */\n  initialValue?: UseUrlSearchParamsInitialValue<string | URLSearchParams | Value>;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamsMode;\n  /** The mode to use for writing to the URL  */\n  write?: 'push' | 'replace';\n  /* The deserializer function to be invoked */\n  deserializer?: (value: string) => Value[keyof Value];\n  /* The serializer function to be invoked */\n  serializer?: (value: Value[keyof Value]) => string;\n}\n\n/** The use url search params return type */\nexport interface UseUrlSearchParamsReturn<Value> {\n  /** The value of the url search params */\n  value: Value;\n  /** The set function */\n  set: (value: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => void;\n}\n\nexport interface UseUrlSearchParams {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamsOptions<Value> & {\n      initialValue: UseUrlSearchParamsInitialValue<Value>;\n    }\n  ): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(options?: UseUrlSearchParamsOptions<Value>): UseUrlSearchParamsReturn<Value | undefined>;\n\n  <Value>(initialValue: UseUrlSearchParamsInitialValue<Value>): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamsReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParams\n * @description - Hook that provides reactive URLSearchParams\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsOptions<Value> & { initialValue: UseUrlSearchParamsInitialValue<Value> }} options The options object with required initialValue\n * @param {UseUrlSearchParamsInitialValue<Value>} [options.initialValue] The initial value for the url params\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value[keyof Value]) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value[keyof Value]} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ initialValue: { page: 1 } });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsInitialValue<Value>} [initialValue] The initial value for the url params\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ page: 1 });\n */\nexport const useUrlSearchParams = (<Value extends UrlParams>(\n  params: any\n): UseUrlSearchParamsReturn<Value> => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : {}\n  ) as UseUrlSearchParamsOptions<Value>;\n  const initialValue = (\n    options ? options?.initialValue : params\n  ) as UseUrlSearchParamsInitialValue<Value>;\n\n  const { mode = 'history', write: writeMode = 'replace' } = options;\n\n  const serializer = (value: Value[keyof Value]) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined') return undefined as unknown as Value[keyof Value];\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value[keyof Value];\n    }\n  };\n\n  const setUrlSearchParams = <Value extends UrlParams>(\n    mode: UrlSearchParamsMode,\n    value: Partial<Value>,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = getUrlSearchParams(mode);\n\n    Object.entries(value).forEach(([key, param]) => {\n      if (param === undefined) {\n        urlSearchParams.delete(key);\n      } else {\n        const serializedValue = serializer ? serializer(param) : String(param);\n        urlSearchParams.set(key, serializedValue);\n      }\n    });\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n    dispatchUrlSearchParamsEvent();\n\n    return urlSearchParams;\n  };\n\n  const getParsedUrlSearchParams = (searchParams: string | UrlParams | URLSearchParams) => {\n    if (typeof searchParams === 'string') {\n      return getParsedUrlSearchParams(new URLSearchParams(searchParams));\n    }\n\n    if (searchParams instanceof URLSearchParams) {\n      return Array.from(searchParams.entries()).reduce(\n        (acc, [key, value]) => {\n          acc[key] = deserializer(value);\n          return acc;\n        },\n        {} as Record<string, any>\n      );\n    }\n\n    return searchParams;\n  };\n\n  const [value, setValue] = useState<Value>(() => {\n    if (typeof window === 'undefined') return (initialValue ?? {}) as Value;\n\n    const urlSearchParams = getUrlSearchParams(mode);\n    const value = {\n      ...(initialValue && getParsedUrlSearchParams(initialValue)),\n      ...getParsedUrlSearchParams(urlSearchParams)\n    } as Value;\n\n    setUrlSearchParams(mode, value, writeMode);\n\n    return value;\n  });\n\n  const set = (params: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => {\n    const searchParams = setUrlSearchParams(\n      mode,\n      { ...value, ...params },\n      options?.write ?? writeMode\n    );\n    setValue(getParsedUrlSearchParams(searchParams) as Value);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      setValue(getParsedUrlSearchParams(searchParams) as Value);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') window.addEventListener('hashchange', onParamsChange);\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') window.removeEventListener('hashchange', onParamsChange);\n    };\n  }, [mode]);\n\n  return {\n    value,\n    set\n  };\n}) as UseUrlSearchParams;\n\nexport { createQueryString, dispatchUrlSearchParamsEvent, getUrlSearchParams };\n"],"names":["useUrlSearchParams","params","options","initialValue","mode","writeMode","serializer","value","deserializer","setUrlSearchParams","write","urlSearchParams","getUrlSearchParams","key","param","serializedValue","query","createQueryString","dispatchUrlSearchParamsEvent","getParsedUrlSearchParams","searchParams","acc","setValue","useState","set","useEffect","onParamsChange","URL_SEARCH_PARAMS_EVENT"],"mappings":"iKAwFaA,EACXC,GACoC,CACpC,MAAMC,EACJ,OAAOD,GAAW,UAClBA,IACC,eAAgBA,GACf,iBAAkBA,GAClB,iBAAkBA,GAClB,SAAUA,GACV,UAAWA,GACTA,EACA,CAAA,EAEAE,EACJD,EAAUA,GAAS,aAAeD,EAG9B,CAAE,KAAAG,EAAO,UAAW,MAAOC,EAAY,WAAcH,EAErDI,EAAcC,GACdL,GAAS,WAAmBA,EAAQ,WAAWK,CAAK,EACpD,OAAOA,GAAU,SAAiBA,EAC/B,KAAK,UAAUA,CAAK,EAGvBC,EAAgBD,GAAkB,CACtC,GAAIL,GAAS,aAAc,OAAOA,EAAQ,aAAaK,CAAK,EAC5D,GAAIA,IAAU,YAEd,GAAI,CACF,OAAO,KAAK,MAAMA,CAAK,CAAA,MACjB,CACN,OAAOA,CAAA,CACT,EAGIE,EAAqB,CACzBL,EACAG,EACAG,EAA4B,YACzB,CACH,MAAMC,EAAkBC,EAAAA,mBAAmBR,CAAI,EAE/C,OAAO,QAAQG,CAAK,EAAE,QAAQ,CAAC,CAACM,EAAKC,CAAK,IAAM,CAC9C,GAAIA,IAAU,OACZH,EAAgB,OAAOE,CAAG,MACrB,CACL,MAAME,EAAkBT,EAAaA,EAAWQ,CAAK,EAAI,OAAOA,CAAK,EACrEH,EAAgB,IAAIE,EAAKE,CAAe,CAAA,CAC1C,CACD,EAED,MAAMC,EAAQC,EAAAA,kBAAkBN,EAAiBP,CAAI,EACrD,OAAIM,IAAU,WAAW,OAAO,QAAQ,aAAa,CAAA,EAAI,GAAIM,CAAK,EAC9DN,IAAU,QAAQ,OAAO,QAAQ,UAAU,CAAA,EAAI,GAAIM,CAAK,EAC5DE,+BAAA,EAEOP,CAAA,EAGHQ,EAA4BC,GAC5B,OAAOA,GAAiB,SACnBD,EAAyB,IAAI,gBAAgBC,CAAY,CAAC,EAG/DA,aAAwB,gBACnB,MAAM,KAAKA,EAAa,QAAA,CAAS,EAAE,OACxC,CAACC,EAAK,CAACR,EAAKN,CAAK,KACfc,EAAIR,CAAG,EAAIL,EAAaD,CAAK,EACtBc,GAET,CAAA,CAAC,EAIED,EAGH,CAACb,EAAOe,CAAQ,EAAIC,EAAAA,SAAgB,IAAM,CAC9C,GAAI,OAAO,OAAW,IAAa,OAAQpB,GAAgB,CAAA,EAE3D,MAAMQ,EAAkBC,EAAAA,mBAAmBR,CAAI,EACzCG,EAAQ,CACZ,GAAIJ,GAAgBgB,EAAyBhB,CAAY,EACzD,GAAGgB,EAAyBR,CAAe,CAAA,EAG7C,OAAAF,EAAmBL,EAAMG,EAAOF,CAAS,EAElCE,CAAA,CACR,EAEKiB,EAAM,CAACvB,EAAwBC,IAA2C,CAC9E,MAAMkB,EAAeX,EACnBL,EACA,CAAE,GAAGG,EAAO,GAAGN,CAAAA,EACfC,GAAS,OAASG,CAAA,EAEpBiB,EAASH,EAAyBC,CAAY,CAAU,CAAA,EAG1DK,OAAAA,EAAAA,UAAU,IAAM,CACd,MAAMC,EAAiB,IAAM,CAC3B,MAAMN,EAAeR,EAAAA,mBAAmBR,CAAI,EAC5CkB,EAASH,EAAyBC,CAAY,CAAU,CAAA,EAG1D,cAAO,iBAAiBO,EAAAA,wBAAyBD,CAAc,EAC/D,OAAO,iBAAiB,WAAYA,CAAc,EAC9CtB,IAAS,WAAW,OAAO,iBAAiB,aAAcsB,CAAc,EAErE,IAAM,CACX,OAAO,oBAAoBC,EAAAA,wBAAyBD,CAAc,EAClE,OAAO,oBAAoB,WAAYA,CAAc,EACjDtB,IAAS,WAAW,OAAO,oBAAoB,aAAcsB,CAAc,CAAA,CACjF,EACC,CAACtB,CAAI,CAAC,EAEF,CACL,MAAAG,EACA,IAAAiB,CAAA,CAEJ"}

package/dist/esm/hooks/useUrlSearchParam/useUrlSearchParam.mjs

@@ -1,5 +1,5 @@
 import { useState as $, useEffect as y } from "react";
-const u = "reactuse-url-search-params-event", f = (n = "history") => {
+const f = "reactuse-url-search-params-event", w = (n = "history") => {
   const { search: i, hash: r } = window.location;
   let s = "";
   if (n === "history" && (s = i), n === "hash-params" && (s = r.replace(/^#/, "")), n === "hash") {
@@ -17,7 +17,7 @@ const u = "reactuse-url-search-params-event", f = (n = "history") => {
     return `${s}${h}${r ? `?${r}` : ""}`;
   }
   throw new Error("Invalid mode");
-}, L = () => window.dispatchEvent(new Event(u)), U = (n, i) => {
+}, L = () => window.dispatchEvent(new Event(f)), U = (n, i) => {
   const r = typeof i == "object" && i && ("serializer" in i || "deserializer" in i || "initialValue" in i || "mode" in i || "write" in i) ? i : void 0, s = r ? r?.initialValue : i, { mode: t = "history", write: a = "replace" } = r ?? {};
   if (typeof window > "u")
     return {
@@ -27,7 +27,7 @@ const u = "reactuse-url-search-params-event", f = (n = "history") => {
       set: () => {
       }
     };
-  const h = (e) => r?.serializer ? r.serializer(e) : typeof e == "string" ? e : JSON.stringify(e), p = (e) => {
+  const h = (e) => r?.serializer ? r.serializer(e) : typeof e == "string" ? e : JSON.stringify(e), S = (e) => {
     if (r?.deserializer) return r.deserializer(e);
     if (!(e === "undefined" || e === "null"))
       try {
@@ -35,26 +35,31 @@ const u = "reactuse-url-search-params-event", f = (n = "history") => {
       } catch {
         return e;
       }
-  }, d = (e, o, c, v = "replace") => {
-    const l = f(c), m = o !== void 0 ? h ? h(o) : String(o) : "";
-    o === void 0 ? l.delete(e) : l.set(e, m);
-    const S = z(l, c);
-    v === "replace" && window.history.replaceState({}, "", S), v === "push" && window.history.pushState({}, "", S), L();
-  }, [E, w] = $(() => {
-    const o = f(t).get(n);
-    return o === null && s !== void 0 ? (d(n, s, t, a), s) : o ? p(o) : void 0;
+  }, d = (e, o, c, p = "replace") => {
+    const u = w(c);
+    if (o === void 0)
+      u.delete(e);
+    else {
+      const m = h ? h(o) : String(o);
+      u.set(e, m);
+    }
+    const v = z(u, c);
+    p === "replace" && window.history.replaceState({}, "", v), p === "push" && window.history.pushState({}, "", v), L();
+  }, [E, l] = $(() => {
+    const o = w(t).get(n);
+    return o === null && s !== void 0 ? (d(n, s, t, a), s) : o ? S(o) : void 0;
   }), P = (e, o) => {
-    d(n, e, t, o?.write ?? a), w(e);
+    d(n, e, t, o?.write ?? a), l(e);
   }, g = (e) => {
-    d(n, void 0, t, e?.write ?? a), w(void 0);
+    d(n, void 0, t, e?.write ?? a), l(void 0);
   };
   return y(() => {
     const e = () => {
-      const c = f(t).get(n);
-      w(c ? p(c) : void 0);
+      const c = w(t).get(n);
+      l(c ? S(c) : void 0);
     };
-    return window.addEventListener(u, e), window.addEventListener("popstate", e), t !== "history" && window.addEventListener("hashchange", e), () => {
-      window.removeEventListener(u, e), window.removeEventListener("popstate", e), t !== "history" && window.removeEventListener("hashchange", e);
+    return window.addEventListener(f, e), window.addEventListener("popstate", e), t !== "history" && window.addEventListener("hashchange", e), () => {
+      window.removeEventListener(f, e), window.removeEventListener("popstate", e), t !== "history" && window.removeEventListener("hashchange", e);
     };
   }, [n, t]), {
     value: E,
@@ -63,10 +68,10 @@ const u = "reactuse-url-search-params-event", f = (n = "history") => {
   };
 };
 export {
-  u as URL_SEARCH_PARAMS_EVENT,
+  f as URL_SEARCH_PARAMS_EVENT,
   z as createQueryString,
   L as dispatchUrlSearchParamsEvent,
-  f as getUrlSearchParams,
+  w as getUrlSearchParams,
   U as useUrlSearchParam
 };
 //# sourceMappingURL=useUrlSearchParam.mjs.map

package/dist/esm/hooks/useUrlSearchParam/useUrlSearchParam.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useUrlSearchParam.mjs","sources":["../../../../src/hooks/useUrlSearchParam/useUrlSearchParam.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The url search params mode type */\nexport type UrlSearchParamMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search param options type */\nexport interface UseUrlSearchParamOptions<Value> {\n  /** The initial value of the search param */\n  initialValue?: Value;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamMode;\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n  /** The deserializer function to be invoked */\n  deserializer?: (value: string) => Value;\n  /** The serializer function to be invoked */\n  serializer?: (value: Value) => string;\n}\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsActionOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/** The use url search param return type */\nexport interface UseUrlSearchParamReturn<Value> {\n  /** Current search param value */\n  value: Value | undefined;\n  /** Function to remove the search param */\n  remove: (options?: UseUrlSearchParamsActionOptions) => void;\n  /** Function to update search param */\n  set: (value: Value, options?: UseUrlSearchParamsActionOptions) => void;\n}\n\nexport const URL_SEARCH_PARAMS_EVENT = 'reactuse-url-search-params-event';\n\nexport const getUrlSearchParams = (mode: UrlSearchParamMode = 'history') => {\n  const { search, hash } = window.location;\n\n  let path = '';\n\n  if (mode === 'history') path = search;\n  if (mode === 'hash-params') path = hash.replace(/^#/, '');\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    path = ~index ? hash.slice(index) : '';\n  }\n\n  return new URLSearchParams(path);\n};\n\nexport const createQueryString = (searchParams: URLSearchParams, mode: UrlSearchParamMode) => {\n  const searchParamsString = searchParams.toString();\n  const { search, hash } = window.location;\n\n  if (mode === 'history') return `${searchParamsString ? `?${searchParamsString}` : ''}${hash}`;\n  if (mode === 'hash-params')\n    return `${search}${searchParamsString ? `#${searchParamsString}` : ''}`;\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    const base = index > -1 ? hash.slice(0, index) : hash;\n    return `${search}${base}${searchParamsString ? `?${searchParamsString}` : ''}`;\n  }\n\n  throw new Error('Invalid mode');\n};\n\nexport const dispatchUrlSearchParamsEvent = () =>\n  window.dispatchEvent(new Event(URL_SEARCH_PARAMS_EVENT));\n\nexport interface UseUrlSearchParam {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamOptions<Value> & { initialValue: Value }\n  ): UseUrlSearchParamReturn<Value>;\n\n  <Value>(\n    key: string,\n    options?: UseUrlSearchParamOptions<Value>\n  ): UseUrlSearchParamReturn<Value | undefined>;\n\n  <Value>(key: string, initialValue: Value): UseUrlSearchParamReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParam\n * @description - Hook that provides reactive URLSearchParams for a single key\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {UseUrlSearchParamOptions<Value> & { initialValue: Value }} options The options object with required initialValue\n * @param {Value} options.initialValue The initial value for the url param\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', { initialValue: 1 });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {Value} [initialValue] The initial value for the url param\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', 1);\n */\nexport const useUrlSearchParam = (<Value>(key: string, params?: any) => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : undefined\n  ) as UseUrlSearchParamOptions<Value>;\n\n  const initialValue = (options ? options?.initialValue : params) as Value;\n  const { mode = 'history', write: writeMode = 'replace' } = options ?? {};\n\n  if (typeof window === 'undefined') {\n    return {\n      value: initialValue,\n      remove: () => {},\n      set: () => {}\n    } as UseUrlSearchParamReturn<Value>;\n  }\n\n  const serializer = (value: Value) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined' || value === 'null') return undefined as unknown as Value;\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value;\n    }\n  };\n\n  const setUrlSearchParam = (\n    key: string,\n    value: Value | undefined,\n    mode: UrlSearchParamMode,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const searchParams = getUrlSearchParams(mode);\n    const serializedValue =\n      value !== undefined ? (serializer ? serializer(value) : String(value)) : '';\n\n    if (value === undefined) {\n      searchParams.delete(key);\n    } else {\n      searchParams.set(key, serializedValue);\n    }\n\n    const query = createQueryString(searchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    dispatchUrlSearchParamsEvent();\n  };\n\n  const [value, setValue] = useState<Value | undefined>(() => {\n    const searchParams = getUrlSearchParams(mode);\n    const currentValue = searchParams.get(key);\n\n    if (currentValue === null && initialValue !== undefined) {\n      setUrlSearchParam(key, initialValue, mode, writeMode);\n      return initialValue;\n    }\n\n    return currentValue ? deserializer(currentValue) : undefined;\n  });\n\n  const set = (value: Value, options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, value, mode, options?.write ?? writeMode);\n    setValue(value);\n  };\n\n  const remove = (options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, undefined, mode, options?.write ?? writeMode);\n    setValue(undefined);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      const newValue = searchParams.get(key);\n      setValue(newValue ? deserializer(newValue) : undefined);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') {\n      window.addEventListener('hashchange', onParamsChange);\n    }\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') {\n        window.removeEventListener('hashchange', onParamsChange);\n      }\n    };\n  }, [key, mode]);\n\n  return {\n    value,\n    remove,\n    set\n  };\n}) as UseUrlSearchParam;\n"],"names":["URL_SEARCH_PARAMS_EVENT","getUrlSearchParams","mode","search","hash","path","index","createQueryString","searchParams","searchParamsString","base","dispatchUrlSearchParamsEvent","useUrlSearchParam","key","params","options","initialValue","writeMode","serializer","value","deserializer","setUrlSearchParam","write","serializedValue","query","setValue","useState","currentValue","set","remove","useEffect","onParamsChange","newValue"],"mappings":"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"}
+{"version":3,"file":"useUrlSearchParam.mjs","sources":["../../../../src/hooks/useUrlSearchParam/useUrlSearchParam.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/** The url search params mode type */\nexport type UrlSearchParamMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search param options type */\nexport interface UseUrlSearchParamOptions<Value> {\n  /** The initial value of the search param */\n  initialValue?: Value;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamMode;\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n  /** The deserializer function to be invoked */\n  deserializer?: (value: string) => Value;\n  /** The serializer function to be invoked */\n  serializer?: (value: Value) => string;\n}\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsActionOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/** The use url search param return type */\nexport interface UseUrlSearchParamReturn<Value> {\n  /** Current search param value */\n  value: Value | undefined;\n  /** Function to remove the search param */\n  remove: (options?: UseUrlSearchParamsActionOptions) => void;\n  /** Function to update search param */\n  set: (value: Value, options?: UseUrlSearchParamsActionOptions) => void;\n}\n\nexport const URL_SEARCH_PARAMS_EVENT = 'reactuse-url-search-params-event';\n\nexport const getUrlSearchParams = (mode: UrlSearchParamMode = 'history') => {\n  const { search, hash } = window.location;\n\n  let path = '';\n\n  if (mode === 'history') path = search;\n  if (mode === 'hash-params') path = hash.replace(/^#/, '');\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    path = ~index ? hash.slice(index) : '';\n  }\n\n  return new URLSearchParams(path);\n};\n\nexport const createQueryString = (searchParams: URLSearchParams, mode: UrlSearchParamMode) => {\n  const searchParamsString = searchParams.toString();\n  const { search, hash } = window.location;\n\n  if (mode === 'history') return `${searchParamsString ? `?${searchParamsString}` : ''}${hash}`;\n  if (mode === 'hash-params')\n    return `${search}${searchParamsString ? `#${searchParamsString}` : ''}`;\n  if (mode === 'hash') {\n    const index = hash.indexOf('?');\n    const base = index > -1 ? hash.slice(0, index) : hash;\n    return `${search}${base}${searchParamsString ? `?${searchParamsString}` : ''}`;\n  }\n\n  throw new Error('Invalid mode');\n};\n\nexport const dispatchUrlSearchParamsEvent = () =>\n  window.dispatchEvent(new Event(URL_SEARCH_PARAMS_EVENT));\n\nexport interface UseUrlSearchParam {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamOptions<Value> & { initialValue: Value }\n  ): UseUrlSearchParamReturn<Value>;\n\n  <Value>(\n    key: string,\n    options?: UseUrlSearchParamOptions<Value>\n  ): UseUrlSearchParamReturn<Value | undefined>;\n\n  <Value>(key: string, initialValue: Value): UseUrlSearchParamReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParam\n * @description - Hook that provides reactive URLSearchParams for a single key\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {UseUrlSearchParamOptions<Value> & { initialValue: Value }} options The options object with required initialValue\n * @param {Value} options.initialValue The initial value for the url param\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', { initialValue: 1 });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {string} key The key of the url param\n * @param {Value} [initialValue] The initial value for the url param\n * @returns {UseUrlSearchParamReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParam('page', 1);\n */\nexport const useUrlSearchParam = (<Value>(key: string, params?: any) => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : undefined\n  ) as UseUrlSearchParamOptions<Value>;\n\n  const initialValue = (options ? options?.initialValue : params) as Value;\n  const { mode = 'history', write: writeMode = 'replace' } = options ?? {};\n\n  if (typeof window === 'undefined') {\n    return {\n      value: initialValue,\n      remove: () => {},\n      set: () => {}\n    } as UseUrlSearchParamReturn<Value>;\n  }\n\n  const serializer = (value: Value) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined' || value === 'null') return undefined as unknown as Value;\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value;\n    }\n  };\n\n  const setUrlSearchParam = (\n    key: string,\n    value: Value | undefined,\n    mode: UrlSearchParamMode,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = getUrlSearchParams(mode);\n\n    if (value === undefined) {\n      urlSearchParams.delete(key);\n    } else {\n      const serializedValue = serializer ? serializer(value) : String(value);\n      urlSearchParams.set(key, serializedValue);\n    }\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    dispatchUrlSearchParamsEvent();\n  };\n\n  const [value, setValue] = useState<Value | undefined>(() => {\n    const urlSearchParams = getUrlSearchParams(mode);\n    const currentValue = urlSearchParams.get(key);\n\n    if (currentValue === null && initialValue !== undefined) {\n      setUrlSearchParam(key, initialValue, mode, writeMode);\n      return initialValue;\n    }\n\n    return currentValue ? deserializer(currentValue) : undefined;\n  });\n\n  const set = (value: Value, options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, value, mode, options?.write ?? writeMode);\n    setValue(value);\n  };\n\n  const remove = (options?: UseUrlSearchParamsActionOptions) => {\n    setUrlSearchParam(key, undefined, mode, options?.write ?? writeMode);\n    setValue(undefined);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const urlSearchParams = getUrlSearchParams(mode);\n      const newValue = urlSearchParams.get(key);\n      setValue(newValue ? deserializer(newValue) : undefined);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') {\n      window.addEventListener('hashchange', onParamsChange);\n    }\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') {\n        window.removeEventListener('hashchange', onParamsChange);\n      }\n    };\n  }, [key, mode]);\n\n  return {\n    value,\n    remove,\n    set\n  };\n}) as UseUrlSearchParam;\n"],"names":["URL_SEARCH_PARAMS_EVENT","getUrlSearchParams","mode","search","hash","path","index","createQueryString","searchParams","searchParamsString","base","dispatchUrlSearchParamsEvent","useUrlSearchParam","key","params","options","initialValue","writeMode","serializer","value","deserializer","setUrlSearchParam","write","urlSearchParams","serializedValue","query","setValue","useState","currentValue","set","remove","useEffect","onParamsChange","newValue"],"mappings":"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"}

package/dist/esm/hooks/useUrlSearchParams/useUrlSearchParams.mjs

@@ -1,8 +1,8 @@
-import { useState as m, useEffect as U } from "react";
-import { getUrlSearchParams as E, URL_SEARCH_PARAMS_EVENT as P, createQueryString as z, dispatchUrlSearchParamsEvent as v } from "../useUrlSearchParam/useUrlSearchParam.mjs";
-const V = (t) => {
-  const n = typeof t == "object" && t && ("serializer" in t || "deserializer" in t || "initialValue" in t || "mode" in t || "write" in t) ? t : {}, c = n ? n?.initialValue : t, { mode: i = "history", write: u = "replace" } = n, f = (e) => n?.serializer ? n.serializer(e) : typeof e == "string" ? e : JSON.stringify(e), p = (e) => {
-    if (n?.deserializer) return n.deserializer(e);
+import { useState as L, useEffect as v } from "react";
+import { getUrlSearchParams as u, URL_SEARCH_PARAMS_EVENT as g, createQueryString as U, dispatchUrlSearchParamsEvent as m } from "../useUrlSearchParam/useUrlSearchParam.mjs";
+const A = (t) => {
+  const i = typeof t == "object" && t && ("serializer" in t || "deserializer" in t || "initialValue" in t || "mode" in t || "write" in t) ? t : {}, c = i ? i?.initialValue : t, { mode: n = "history", write: f = "replace" } = i, l = (e) => i?.serializer ? i.serializer(e) : typeof e == "string" ? e : JSON.stringify(e), p = (e) => {
+    if (i?.deserializer) return i.deserializer(e);
     if (e !== "undefined")
       try {
         return JSON.parse(e);
@@ -10,47 +10,52 @@ const V = (t) => {
         return e;
       }
   }, h = (e, r, s = "replace") => {
-    const o = new URLSearchParams();
-    Object.entries(r).forEach(([y, d]) => {
-      Array.isArray(d) ? d.forEach((g) => o.set(y, f(g))) : o.set(y, f(d));
+    const o = u(e);
+    Object.entries(r).forEach(([E, d]) => {
+      if (d === void 0)
+        o.delete(E);
+      else {
+        const z = l ? l(d) : String(d);
+        o.set(E, z);
+      }
     });
-    const S = z(o, e);
-    return s === "replace" && window.history.replaceState({}, "", S), s === "push" && window.history.pushState({}, "", S), o;
+    const y = U(o, e);
+    return s === "replace" && window.history.replaceState({}, "", y), s === "push" && window.history.pushState({}, "", y), m(), o;
   }, a = (e) => typeof e == "string" ? a(new URLSearchParams(e)) : e instanceof URLSearchParams ? Array.from(e.entries()).reduce(
     (r, [s, o]) => (r[s] = p(o), r),
     {}
-  ) : e, [l, w] = m(() => {
+  ) : e, [w, S] = L(() => {
     if (typeof window > "u") return c ?? {};
-    const e = E(i), r = {
+    const e = u(n), r = {
       ...c && a(c),
       ...a(e)
     };
-    return h(i, r, u), r;
-  }), L = (e, r) => {
+    return h(n, r, f), r;
+  }), P = (e, r) => {
     const s = h(
-      i,
-      { ...l, ...e },
-      r?.write ?? u
+      n,
+      { ...w, ...e },
+      r?.write ?? f
     );
-    w(a(s)), v();
+    S(a(s));
   };
-  return U(() => {
+  return v(() => {
     const e = () => {
-      const r = E(i);
-      w(a(r));
+      const r = u(n);
+      S(a(r));
     };
-    return window.addEventListener(P, e), window.addEventListener("popstate", e), i !== "history" && window.addEventListener("hashchange", e), () => {
-      window.removeEventListener(P, e), window.removeEventListener("popstate", e), i !== "history" && window.removeEventListener("hashchange", e);
+    return window.addEventListener(g, e), window.addEventListener("popstate", e), n !== "history" && window.addEventListener("hashchange", e), () => {
+      window.removeEventListener(g, e), window.removeEventListener("popstate", e), n !== "history" && window.removeEventListener("hashchange", e);
     };
-  }, [i]), {
-    value: l,
-    set: L
+  }, [n]), {
+    value: w,
+    set: P
   };
 };
 export {
-  z as createQueryString,
-  v as dispatchUrlSearchParamsEvent,
-  E as getUrlSearchParams,
-  V as useUrlSearchParams
+  U as createQueryString,
+  m as dispatchUrlSearchParamsEvent,
+  u as getUrlSearchParams,
+  A as useUrlSearchParams
 };
 //# sourceMappingURL=useUrlSearchParams.mjs.map

package/dist/esm/hooks/useUrlSearchParams/useUrlSearchParams.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useUrlSearchParams.mjs","sources":["../../../../src/hooks/useUrlSearchParams/useUrlSearchParams.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport {\n  createQueryString,\n  dispatchUrlSearchParamsEvent,\n  getUrlSearchParams,\n  URL_SEARCH_PARAMS_EVENT\n} from '../useUrlSearchParam/useUrlSearchParam';\n\n/** The url params type */\nexport type UrlParams = Record<string, any>;\n\n/** The url search params mod */\nexport type UrlSearchParamsMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsSetOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/* The use search params initial value type */\nexport type UseUrlSearchParamsInitialValue<Value> = (() => Value) | Value;\n\n/** The use url search params options type */\nexport interface UseUrlSearchParamsOptions<Value> {\n  /* The initial value of the url search params */\n  initialValue?: UseUrlSearchParamsInitialValue<string | URLSearchParams | Value>;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamsMode;\n  /** The mode to use for writing to the URL  */\n  write?: 'push' | 'replace';\n  /* The deserializer function to be invoked */\n  deserializer?: (value: string) => Value[keyof Value];\n  /* The serializer function to be invoked */\n  serializer?: (value: Value[keyof Value]) => string;\n}\n\n/** The use url search params return type */\nexport interface UseUrlSearchParamsReturn<Value> {\n  /** The value of the url search params */\n  value: Value;\n  /** The set function */\n  set: (value: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => void;\n}\n\nexport interface UseUrlSearchParams {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamsOptions<Value> & {\n      initialValue: UseUrlSearchParamsInitialValue<Value>;\n    }\n  ): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(options?: UseUrlSearchParamsOptions<Value>): UseUrlSearchParamsReturn<Value | undefined>;\n\n  <Value>(initialValue: UseUrlSearchParamsInitialValue<Value>): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamsReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParams\n * @description - Hook that provides reactive URLSearchParams\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsOptions<Value> & { initialValue: UseUrlSearchParamsInitialValue<Value> }} options The options object with required initialValue\n * @param {UseUrlSearchParamsInitialValue<Value>} [options.initialValue] The initial value for the url params\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value[keyof Value]) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value[keyof Value]} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ initialValue: { page: 1 } });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsInitialValue<Value>} [initialValue] The initial value for the url params\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ page: 1 });\n */\nexport const useUrlSearchParams = (<Value extends UrlParams>(\n  params: any\n): UseUrlSearchParamsReturn<Value> => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : {}\n  ) as UseUrlSearchParamsOptions<Value>;\n  const initialValue = (\n    options ? options?.initialValue : params\n  ) as UseUrlSearchParamsInitialValue<Value>;\n\n  const { mode = 'history', write: writeMode = 'replace' } = options;\n\n  const serializer = (value: Value[keyof Value]) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined') return undefined as unknown as Value[keyof Value];\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value[keyof Value];\n    }\n  };\n\n  const setUrlSearchParams = <Value extends UrlParams>(\n    mode: UrlSearchParamsMode,\n    value: Partial<Value>,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = new URLSearchParams();\n\n    Object.entries(value).forEach(([key, param]) => {\n      if (Array.isArray(param)) {\n        param.forEach((value) => urlSearchParams.set(key, serializer(value)));\n      } else {\n        urlSearchParams.set(key, serializer(param));\n      }\n    });\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n\n    return urlSearchParams;\n  };\n\n  const getParsedUrlSearchParams = (searchParams: string | UrlParams | URLSearchParams) => {\n    if (typeof searchParams === 'string') {\n      return getParsedUrlSearchParams(new URLSearchParams(searchParams));\n    }\n\n    if (searchParams instanceof URLSearchParams) {\n      return Array.from(searchParams.entries()).reduce(\n        (acc, [key, value]) => {\n          acc[key] = deserializer(value);\n          return acc;\n        },\n        {} as Record<string, any>\n      );\n    }\n\n    return searchParams;\n  };\n\n  const [value, setValue] = useState<Value>(() => {\n    if (typeof window === 'undefined') return (initialValue ?? {}) as Value;\n\n    const urlSearchParams = getUrlSearchParams(mode);\n    const value = {\n      ...(initialValue && getParsedUrlSearchParams(initialValue)),\n      ...getParsedUrlSearchParams(urlSearchParams)\n    } as Value;\n\n    setUrlSearchParams(mode, value, writeMode);\n\n    return value;\n  });\n\n  const set = (params: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => {\n    const searchParams = setUrlSearchParams(\n      mode,\n      { ...value, ...params },\n      options?.write ?? writeMode\n    );\n    setValue(getParsedUrlSearchParams(searchParams) as Value);\n    dispatchUrlSearchParamsEvent();\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      setValue(getParsedUrlSearchParams(searchParams) as Value);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') window.addEventListener('hashchange', onParamsChange);\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') window.removeEventListener('hashchange', onParamsChange);\n    };\n  }, [mode]);\n\n  return {\n    value,\n    set\n  };\n}) as UseUrlSearchParams;\n\nexport { createQueryString, dispatchUrlSearchParamsEvent, getUrlSearchParams };\n"],"names":["useUrlSearchParams","params","options","initialValue","mode","writeMode","serializer","value","deserializer","setUrlSearchParams","write","urlSearchParams","key","param","query","createQueryString","getParsedUrlSearchParams","searchParams","acc","setValue","useState","getUrlSearchParams","set","dispatchUrlSearchParamsEvent","useEffect","onParamsChange","URL_SEARCH_PARAMS_EVENT"],"mappings":";;AAwFO,MAAMA,IAAsB,CACjCC,MACoC;AACpC,QAAMC,IACJ,OAAOD,KAAW,YAClBA,MACC,gBAAgBA,KACf,kBAAkBA,KAClB,kBAAkBA,KAClB,UAAUA,KACV,WAAWA,KACTA,IACA,CAAA,GAEAE,IACJD,IAAUA,GAAS,eAAeD,GAG9B,EAAE,MAAAG,IAAO,WAAW,OAAOC,IAAY,cAAcH,GAErDI,IAAa,CAACC,MACdL,GAAS,aAAmBA,EAAQ,WAAWK,CAAK,IACpD,OAAOA,KAAU,WAAiBA,IAC/B,KAAK,UAAUA,CAAK,GAGvBC,IAAe,CAACD,MAAkB;AACtC,QAAIL,GAAS,aAAc,QAAOA,EAAQ,aAAaK,CAAK;AAC5D,QAAIA,MAAU;AAEd,UAAI;AACF,eAAO,KAAK,MAAMA,CAAK;AAAA,MAAA,QACjB;AACN,eAAOA;AAAAA,MAAA;AAAA,EACT,GAGIE,IAAqB,CACzBL,GACAG,GACAG,IAA4B,cACzB;AACH,UAAMC,IAAkB,IAAI,gBAAA;AAE5B,WAAO,QAAQJ,CAAK,EAAE,QAAQ,CAAC,CAACK,GAAKC,CAAK,MAAM;AAC9C,MAAI,MAAM,QAAQA,CAAK,IACrBA,EAAM,QAAQ,CAACN,MAAUI,EAAgB,IAAIC,GAAKN,EAAWC,CAAK,CAAC,CAAC,IAEpEI,EAAgB,IAAIC,GAAKN,EAAWO,CAAK,CAAC;AAAA,IAC5C,CACD;AAED,UAAMC,IAAQC,EAAkBJ,GAAiBP,CAAI;AACrD,WAAIM,MAAU,aAAW,OAAO,QAAQ,aAAa,CAAA,GAAI,IAAII,CAAK,GAC9DJ,MAAU,UAAQ,OAAO,QAAQ,UAAU,CAAA,GAAI,IAAII,CAAK,GAErDH;AAAA,EAAA,GAGHK,IAA2B,CAACC,MAC5B,OAAOA,KAAiB,WACnBD,EAAyB,IAAI,gBAAgBC,CAAY,CAAC,IAG/DA,aAAwB,kBACnB,MAAM,KAAKA,EAAa,QAAA,CAAS,EAAE;AAAA,IACxC,CAACC,GAAK,CAACN,GAAKL,CAAK,OACfW,EAAIN,CAAG,IAAIJ,EAAaD,CAAK,GACtBW;AAAA,IAET,CAAA;AAAA,EAAC,IAIED,GAGH,CAACV,GAAOY,CAAQ,IAAIC,EAAgB,MAAM;AAC9C,QAAI,OAAO,SAAW,IAAa,QAAQjB,KAAgB,CAAA;AAE3D,UAAMQ,IAAkBU,EAAmBjB,CAAI,GACzCG,IAAQ;AAAA,MACZ,GAAIJ,KAAgBa,EAAyBb,CAAY;AAAA,MACzD,GAAGa,EAAyBL,CAAe;AAAA,IAAA;AAG7C,WAAAF,EAAmBL,GAAMG,GAAOF,CAAS,GAElCE;AAAAA,EAAA,CACR,GAEKe,IAAM,CAACrB,GAAwBC,MAA2C;AAC9E,UAAMe,IAAeR;AAAA,MACnBL;AAAA,MACA,EAAE,GAAGG,GAAO,GAAGN,EAAAA;AAAAA,MACfC,GAAS,SAASG;AAAA,IAAA;AAEpB,IAAAc,EAASH,EAAyBC,CAAY,CAAU,GACxDM,EAAA;AAAA,EAA6B;AAG/B,SAAAC,EAAU,MAAM;AACd,UAAMC,IAAiB,MAAM;AAC3B,YAAMR,IAAeI,EAAmBjB,CAAI;AAC5C,MAAAe,EAASH,EAAyBC,CAAY,CAAU;AAAA,IAAA;AAG1D,kBAAO,iBAAiBS,GAAyBD,CAAc,GAC/D,OAAO,iBAAiB,YAAYA,CAAc,GAC9CrB,MAAS,aAAW,OAAO,iBAAiB,cAAcqB,CAAc,GAErE,MAAM;AACX,aAAO,oBAAoBC,GAAyBD,CAAc,GAClE,OAAO,oBAAoB,YAAYA,CAAc,GACjDrB,MAAS,aAAW,OAAO,oBAAoB,cAAcqB,CAAc;AAAA,IAAA;AAAA,EACjF,GACC,CAACrB,CAAI,CAAC,GAEF;AAAA,IACL,OAAAG;AAAA,IACA,KAAAe;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useUrlSearchParams.mjs","sources":["../../../../src/hooks/useUrlSearchParams/useUrlSearchParams.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport {\n  createQueryString,\n  dispatchUrlSearchParamsEvent,\n  getUrlSearchParams,\n  URL_SEARCH_PARAMS_EVENT\n} from '../useUrlSearchParam/useUrlSearchParam';\n\n/** The url params type */\nexport type UrlParams = Record<string, any>;\n\n/** The url search params mod */\nexport type UrlSearchParamsMode = 'hash-params' | 'hash' | 'history';\n\n/** The use url search params set options type */\nexport interface UseUrlSearchParamsSetOptions {\n  /** The mode to use for writing to the URL */\n  write?: 'push' | 'replace';\n}\n\n/* The use search params initial value type */\nexport type UseUrlSearchParamsInitialValue<Value> = (() => Value) | Value;\n\n/** The use url search params options type */\nexport interface UseUrlSearchParamsOptions<Value> {\n  /* The initial value of the url search params */\n  initialValue?: UseUrlSearchParamsInitialValue<string | URLSearchParams | Value>;\n  /** The mode to use for writing to the URL */\n  mode?: UrlSearchParamsMode;\n  /** The mode to use for writing to the URL  */\n  write?: 'push' | 'replace';\n  /* The deserializer function to be invoked */\n  deserializer?: (value: string) => Value[keyof Value];\n  /* The serializer function to be invoked */\n  serializer?: (value: Value[keyof Value]) => string;\n}\n\n/** The use url search params return type */\nexport interface UseUrlSearchParamsReturn<Value> {\n  /** The value of the url search params */\n  value: Value;\n  /** The set function */\n  set: (value: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => void;\n}\n\nexport interface UseUrlSearchParams {\n  <Value>(\n    key: string,\n    options: UseUrlSearchParamsOptions<Value> & {\n      initialValue: UseUrlSearchParamsInitialValue<Value>;\n    }\n  ): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(options?: UseUrlSearchParamsOptions<Value>): UseUrlSearchParamsReturn<Value | undefined>;\n\n  <Value>(initialValue: UseUrlSearchParamsInitialValue<Value>): UseUrlSearchParamsReturn<Value>;\n\n  <Value>(key: string): UseUrlSearchParamsReturn<Value | undefined>;\n}\n\n/**\n * @name useUrlSearchParams\n * @description - Hook that provides reactive URLSearchParams\n * @category State\n * @usage high\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsOptions<Value> & { initialValue: UseUrlSearchParamsInitialValue<Value> }} options The options object with required initialValue\n * @param {UseUrlSearchParamsInitialValue<Value>} [options.initialValue] The initial value for the url params\n * @param {UrlSearchParamsMode} [options.mode='history'] The mode to use for the URL ('history' | 'hash-params' | 'hash')\n * @param {'push' | 'replace'} [options.write='replace'] The mode to use for writing to the URL\n * @param {(value: Value[keyof Value]) => string} [options.serializer] Custom serializer function to convert value to string\n * @param {(value: string) => Value[keyof Value]} [options.deserializer] Custom deserializer function to convert string to value\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ initialValue: { page: 1 } });\n *\n * @overload\n * @template Value The type of the url param values\n * @param {UseUrlSearchParamsInitialValue<Value>} [initialValue] The initial value for the url params\n * @returns {UseUrlSearchParamsReturn<Value>} The object with value and function for change value\n *\n * @example\n * const { value, set } = useUrlSearchParams({ page: 1 });\n */\nexport const useUrlSearchParams = (<Value extends UrlParams>(\n  params: any\n): UseUrlSearchParamsReturn<Value> => {\n  const options = (\n    typeof params === 'object' &&\n    params &&\n    ('serializer' in params ||\n      'deserializer' in params ||\n      'initialValue' in params ||\n      'mode' in params ||\n      'write' in params)\n      ? params\n      : {}\n  ) as UseUrlSearchParamsOptions<Value>;\n  const initialValue = (\n    options ? options?.initialValue : params\n  ) as UseUrlSearchParamsInitialValue<Value>;\n\n  const { mode = 'history', write: writeMode = 'replace' } = options;\n\n  const serializer = (value: Value[keyof Value]) => {\n    if (options?.serializer) return options.serializer(value);\n    if (typeof value === 'string') return value;\n    return JSON.stringify(value);\n  };\n\n  const deserializer = (value: string) => {\n    if (options?.deserializer) return options.deserializer(value);\n    if (value === 'undefined') return undefined as unknown as Value[keyof Value];\n\n    try {\n      return JSON.parse(value) as Value;\n    } catch {\n      return value as Value[keyof Value];\n    }\n  };\n\n  const setUrlSearchParams = <Value extends UrlParams>(\n    mode: UrlSearchParamsMode,\n    value: Partial<Value>,\n    write: 'push' | 'replace' = 'replace'\n  ) => {\n    const urlSearchParams = getUrlSearchParams(mode);\n\n    Object.entries(value).forEach(([key, param]) => {\n      if (param === undefined) {\n        urlSearchParams.delete(key);\n      } else {\n        const serializedValue = serializer ? serializer(param) : String(param);\n        urlSearchParams.set(key, serializedValue);\n      }\n    });\n\n    const query = createQueryString(urlSearchParams, mode);\n    if (write === 'replace') window.history.replaceState({}, '', query);\n    if (write === 'push') window.history.pushState({}, '', query);\n    dispatchUrlSearchParamsEvent();\n\n    return urlSearchParams;\n  };\n\n  const getParsedUrlSearchParams = (searchParams: string | UrlParams | URLSearchParams) => {\n    if (typeof searchParams === 'string') {\n      return getParsedUrlSearchParams(new URLSearchParams(searchParams));\n    }\n\n    if (searchParams instanceof URLSearchParams) {\n      return Array.from(searchParams.entries()).reduce(\n        (acc, [key, value]) => {\n          acc[key] = deserializer(value);\n          return acc;\n        },\n        {} as Record<string, any>\n      );\n    }\n\n    return searchParams;\n  };\n\n  const [value, setValue] = useState<Value>(() => {\n    if (typeof window === 'undefined') return (initialValue ?? {}) as Value;\n\n    const urlSearchParams = getUrlSearchParams(mode);\n    const value = {\n      ...(initialValue && getParsedUrlSearchParams(initialValue)),\n      ...getParsedUrlSearchParams(urlSearchParams)\n    } as Value;\n\n    setUrlSearchParams(mode, value, writeMode);\n\n    return value;\n  });\n\n  const set = (params: Partial<Value>, options?: UseUrlSearchParamsSetOptions) => {\n    const searchParams = setUrlSearchParams(\n      mode,\n      { ...value, ...params },\n      options?.write ?? writeMode\n    );\n    setValue(getParsedUrlSearchParams(searchParams) as Value);\n  };\n\n  useEffect(() => {\n    const onParamsChange = () => {\n      const searchParams = getUrlSearchParams(mode);\n      setValue(getParsedUrlSearchParams(searchParams) as Value);\n    };\n\n    window.addEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n    window.addEventListener('popstate', onParamsChange);\n    if (mode !== 'history') window.addEventListener('hashchange', onParamsChange);\n\n    return () => {\n      window.removeEventListener(URL_SEARCH_PARAMS_EVENT, onParamsChange);\n      window.removeEventListener('popstate', onParamsChange);\n      if (mode !== 'history') window.removeEventListener('hashchange', onParamsChange);\n    };\n  }, [mode]);\n\n  return {\n    value,\n    set\n  };\n}) as UseUrlSearchParams;\n\nexport { createQueryString, dispatchUrlSearchParamsEvent, getUrlSearchParams };\n"],"names":["useUrlSearchParams","params","options","initialValue","mode","writeMode","serializer","value","deserializer","setUrlSearchParams","write","urlSearchParams","getUrlSearchParams","key","param","serializedValue","query","createQueryString","dispatchUrlSearchParamsEvent","getParsedUrlSearchParams","searchParams","acc","setValue","useState","set","useEffect","onParamsChange","URL_SEARCH_PARAMS_EVENT"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siberiacancode/reactuse",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "The ultimate collection of react hooks",
   "author": {
     "name": "SIBERIA CAN CODE 🧊",