@siberiacancode/reactuse 0.3.12 → 0.3.14

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      : undefined\n  ) as UseUrlSearchParamsOptions<Value> | undefined;\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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"}
+{"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 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      : undefined\n  ) as\n    | (UseUrlSearchParamsOptions<Value> & {\n        initialValue?: UseUrlSearchParamsInitialValue<Value>;\n      })\n    | undefined;\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/dist/esm/hooks/useVirtualKeyboard/useVirtualKeyboard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useVirtualKeyboard.mjs","sources":["../../../../src/hooks/useVirtualKeyboard/useVirtualKeyboard.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\ndeclare global {\n  interface Navigator {\n    virtualKeyboard?: {\n      boundingRect: DOMRect;\n      overlaysContent: boolean;\n      show: () => void;\n      hide: () => void;\n      addEventListener: (type: 'geometrychange', listener: EventListener) => void;\n      removeEventListener: (type: 'geometrychange', listener: EventListener) => void;\n    };\n  }\n}\n\n/** The use virtual keyboard return type */\nexport interface UseVirtualKeyboardReturn {\n  /** Whether the virtual keyboard is currently open */\n  opened: boolean;\n  /** Whether the VirtualKeyboard API is supported */\n  supported: boolean;\n  /** Change the overlays content */\n  changeOverlaysContent: (overlaysContent: boolean) => void;\n  /** Hide the virtual keyboard */\n  hide: () => void;\n  /** Show the virtual keyboard */\n  show: () => void;\n}\n\n/**\n * @name useVirtualKeyboard\n * @description - Hook that manages virtual keyboard state\n * @category Browser\n * @usage low\n *\n * @browserapi VirtualKeyboard https://developer.mozilla.org/en-US/docs/Web/API/VirtualKeyboard\n *\n * @warning - This hook has a fallback for virtual keyboard detection. If the virtual keyboard is not supported, the methods will not work.\n *\n * @param {boolean} [initialValue=false] The initial state value for keyboard visibility\n * @returns {UseVirtualKeyboardReturn} An object containing keyboard state and control methods\n *\n * @example\n * const { opened, show, hide, supported, changeOverlaysContent } = useVirtualKeyboard();\n */\nexport const useVirtualKeyboard = (initialValue = false): UseVirtualKeyboardReturn => {\n  const supported =\n    (typeof window !== 'undefined' && 'visualViewport' in window) ||\n    (typeof navigator !== 'undefined' && 'virtualKeyboard' in navigator);\n\n  const [opened, setOpened] = useState(initialValue);\n\n  const hide = () => {\n    if (!navigator.virtualKeyboard) return;\n    navigator.virtualKeyboard.hide();\n    setOpened(false);\n  };\n\n  const show = () => {\n    if (!navigator.virtualKeyboard) return;\n    navigator.virtualKeyboard.show();\n    setOpened(true);\n  };\n\n  const changeOverlaysContent = (overlaysContent: boolean) => {\n    if (!navigator.virtualKeyboard) return;\n    navigator.virtualKeyboard.overlaysContent = overlaysContent;\n  };\n\n  useEffect(() => {\n    if (!supported) return;\n\n    const onResize = () => setOpened(window.screen.height - 300 > window.visualViewport!.height);\n\n    const onGeometryChange = (event: Event) => {\n      const { height } = (event.target as any).boundingRect as DOMRect;\n      setOpened(height > 0);\n    };\n\n    if (navigator.virtualKeyboard) navigator.virtualKeyboard.overlaysContent = true;\n\n    navigator.virtualKeyboard &&\n      navigator.virtualKeyboard.addEventListener('geometrychange', onGeometryChange);\n    window.visualViewport && window.visualViewport.addEventListener('resize', onResize);\n\n    return () => {\n      navigator.virtualKeyboard &&\n        navigator.virtualKeyboard.removeEventListener('geometrychange', onGeometryChange);\n      window.visualViewport && window.visualViewport.removeEventListener('resize', onResize);\n    };\n  }, []);\n\n  return {\n    opened,\n    show,\n    hide,\n    changeOverlaysContent,\n    supported\n  };\n};\n"],"names":["useVirtualKeyboard","initialValue","supported","opened","setOpened","useState","hide","show","changeOverlaysContent","overlaysContent","useEffect","onResize","onGeometryChange","event","height"],"mappings":";AA6CO,MAAMA,IAAqB,CAACC,IAAe,OAAoC;AACpF,QAAMC,IACH,OAAO,SAAW,OAAe,oBAAoB,UACrD,OAAO,YAAc,OAAe,qBAAqB,WAEtD,CAACC,GAAQC,CAAS,IAAIC,EAASJ,CAAY,GAE3CK,IAAO,MAAM;AACjB,IAAK,UAAU,oBACf,UAAU,gBAAgB,KAAA,GAC1BF,EAAU,EAAK;AAAA,EAAA,GAGXG,IAAO,MAAM;AACjB,IAAK,UAAU,oBACf,UAAU,gBAAgB,KAAA,GAC1BH,EAAU,EAAI;AAAA,EAAA,GAGVI,IAAwB,CAACC,MAA6B;AAC1D,IAAK,UAAU,oBACf,UAAU,gBAAgB,kBAAkBA;AAAA,EAAA;AAG9C,SAAAC,EAAU,MAAM;AACd,QAAI,CAACR,EAAW;AAEhB,UAAMS,IAAW,MAAMP,EAAU,OAAO,OAAO,SAAS,MAAM,OAAO,eAAgB,MAAM,GAErFQ,IAAmB,CAACC,MAAiB;AACzC,YAAM,EAAE,QAAAC,EAAA,IAAYD,EAAM,OAAe;AACzC,MAAAT,EAAUU,IAAS,CAAC;AAAA,IAAA;AAGtB,WAAI,UAAU,oBAAiB,UAAU,gBAAgB,kBAAkB,KAE3E,UAAU,mBACR,UAAU,gBAAgB,iBAAiB,kBAAkBF,CAAgB,GAC/E,OAAO,kBAAkB,OAAO,eAAe,iBAAiB,UAAUD,CAAQ,GAE3E,MAAM;AACX,gBAAU,mBACR,UAAU,gBAAgB,oBAAoB,kBAAkBC,CAAgB,GAClF,OAAO,kBAAkB,OAAO,eAAe,oBAAoB,UAAUD,CAAQ;AAAA,IAAA;AAAA,EACvF,GACC,EAAE,GAEE;AAAA,IACL,QAAAR;AAAA,IACA,MAAAI;AAAA,IACA,MAAAD;AAAA,IACA,uBAAAE;AAAA,IACA,WAAAN;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useVirtualKeyboard.mjs","sources":["../../../../src/hooks/useVirtualKeyboard/useVirtualKeyboard.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\ndeclare global {\r\n  interface Navigator {\r\n    virtualKeyboard?: {\r\n      boundingRect: DOMRect;\r\n      overlaysContent: boolean;\r\n      show: () => void;\r\n      hide: () => void;\r\n      addEventListener: (type: 'geometrychange', listener: EventListener) => void;\r\n      removeEventListener: (type: 'geometrychange', listener: EventListener) => void;\r\n    };\r\n  }\r\n}\r\n\r\n/** The use virtual keyboard return type */\r\nexport interface UseVirtualKeyboardReturn {\r\n  /** Whether the virtual keyboard is currently open */\r\n  opened: boolean;\r\n  /** Whether the VirtualKeyboard API is supported */\r\n  supported: boolean;\r\n  /** Change the overlays content */\r\n  changeOverlaysContent: (overlaysContent: boolean) => void;\r\n  /** Hide the virtual keyboard */\r\n  hide: () => void;\r\n  /** Show the virtual keyboard */\r\n  show: () => void;\r\n}\r\n\r\n/**\r\n * @name useVirtualKeyboard\r\n * @description - Hook that manages virtual keyboard state\r\n * @category Browser\r\n * @usage low\r\n *\r\n * @browserapi VirtualKeyboard https://developer.mozilla.org/en-US/docs/Web/API/VirtualKeyboard\r\n *\r\n * @warning - This hook has a fallback for virtual keyboard detection. If the virtual keyboard is not supported, the methods will not work.\r\n *\r\n * @param {boolean} [initialValue=false] The initial state value for keyboard visibility\r\n * @returns {UseVirtualKeyboardReturn} An object containing keyboard state and control methods\r\n *\r\n * @example\r\n * const { opened, show, hide, supported, changeOverlaysContent } = useVirtualKeyboard();\r\n */\r\nexport const useVirtualKeyboard = (initialValue = false): UseVirtualKeyboardReturn => {\r\n  const supported =\r\n    (typeof window !== 'undefined' && 'visualViewport' in window) ||\r\n    (typeof navigator !== 'undefined' && 'virtualKeyboard' in navigator);\r\n\r\n  const [opened, setOpened] = useState(initialValue);\r\n\r\n  const hide = () => {\r\n    if (!navigator.virtualKeyboard) return;\r\n    navigator.virtualKeyboard.hide();\r\n    setOpened(false);\r\n  };\r\n\r\n  const show = () => {\r\n    if (!navigator.virtualKeyboard) return;\r\n    navigator.virtualKeyboard.show();\r\n    setOpened(true);\r\n  };\r\n\r\n  const changeOverlaysContent = (overlaysContent: boolean) => {\r\n    if (!navigator.virtualKeyboard) return;\r\n    navigator.virtualKeyboard.overlaysContent = overlaysContent;\r\n  };\r\n\r\n  useEffect(() => {\r\n    if (!supported) return;\r\n\r\n    const onResize = () => setOpened(window.screen.height - 300 > window.visualViewport!.height);\r\n\r\n    const onGeometryChange = (event: Event) => {\r\n      const { height } = (event.target as any).boundingRect as DOMRect;\r\n      setOpened(height > 0);\r\n    };\r\n\r\n    if (navigator.virtualKeyboard) navigator.virtualKeyboard.overlaysContent = true;\r\n\r\n    navigator.virtualKeyboard &&\r\n      navigator.virtualKeyboard.addEventListener('geometrychange', onGeometryChange);\r\n    window.visualViewport && window.visualViewport.addEventListener('resize', onResize);\r\n\r\n    return () => {\r\n      navigator.virtualKeyboard &&\r\n        navigator.virtualKeyboard.removeEventListener('geometrychange', onGeometryChange);\r\n      window.visualViewport && window.visualViewport.removeEventListener('resize', onResize);\r\n    };\r\n  }, []);\r\n\r\n  return {\r\n    opened,\r\n    show,\r\n    hide,\r\n    changeOverlaysContent,\r\n    supported\r\n  };\r\n};\r\n"],"names":["useVirtualKeyboard","initialValue","supported","opened","setOpened","useState","hide","show","changeOverlaysContent","overlaysContent","useEffect","onResize","onGeometryChange","event","height"],"mappings":";AA6CO,MAAMA,IAAqB,CAACC,IAAe,OAAoC;AACpF,QAAMC,IACH,OAAO,SAAW,OAAe,oBAAoB,UACrD,OAAO,YAAc,OAAe,qBAAqB,WAEtD,CAACC,GAAQC,CAAS,IAAIC,EAASJ,CAAY,GAE3CK,IAAO,MAAM;AACjB,IAAK,UAAU,oBACf,UAAU,gBAAgB,KAAA,GAC1BF,EAAU,EAAK;AAAA,EAAA,GAGXG,IAAO,MAAM;AACjB,IAAK,UAAU,oBACf,UAAU,gBAAgB,KAAA,GAC1BH,EAAU,EAAI;AAAA,EAAA,GAGVI,IAAwB,CAACC,MAA6B;AAC1D,IAAK,UAAU,oBACf,UAAU,gBAAgB,kBAAkBA;AAAA,EAAA;AAG9C,SAAAC,EAAU,MAAM;AACd,QAAI,CAACR,EAAW;AAEhB,UAAMS,IAAW,MAAMP,EAAU,OAAO,OAAO,SAAS,MAAM,OAAO,eAAgB,MAAM,GAErFQ,IAAmB,CAACC,MAAiB;AACzC,YAAM,EAAE,QAAAC,EAAA,IAAYD,EAAM,OAAe;AACzC,MAAAT,EAAUU,IAAS,CAAC;AAAA,IAAA;AAGtB,WAAI,UAAU,oBAAiB,UAAU,gBAAgB,kBAAkB,KAE3E,UAAU,mBACR,UAAU,gBAAgB,iBAAiB,kBAAkBF,CAAgB,GAC/E,OAAO,kBAAkB,OAAO,eAAe,iBAAiB,UAAUD,CAAQ,GAE3E,MAAM;AACX,gBAAU,mBACR,UAAU,gBAAgB,oBAAoB,kBAAkBC,CAAgB,GAClF,OAAO,kBAAkB,OAAO,eAAe,oBAAoB,UAAUD,CAAQ;AAAA,IAAA;AAAA,EACvF,GACC,EAAE,GAEE;AAAA,IACL,QAAAR;AAAA,IACA,MAAAI;AAAA,IACA,MAAAD;AAAA,IACA,uBAAAE;AAAA,IACA,WAAAN;AAAA,EAAA;AAEJ;"}

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

@@ -1 +1 @@
-{"version":3,"file":"useVisibility.mjs","sources":["../../../../src/hooks/useVisibility/useVisibility.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport type { HookTarget } from '@/utils/helpers';\n\nimport { isTarget } from '@/utils/helpers';\n\nimport type { StateRef } from '../useRefState/useRefState';\n\nimport { useRefState } from '../useRefState/useRefState';\n\n/** The visibility callback type */\nexport type UseVisibilityCallback = (\n  entry: IntersectionObserverEntry,\n  observer: IntersectionObserver\n) => void;\n\n/** The visibility options type */\nexport interface UseVisibilityOptions extends Omit<IntersectionObserverInit, 'root'> {\n  /** The enabled state of the intersection */\n  enabled?: boolean;\n  /** The callback to execute when intersection is detected */\n  onChange?: UseVisibilityCallback;\n  /** The root element to observe */\n  root?: HookTarget;\n}\n\n/** The intersection observer return type */\nexport interface UseVisibilityReturn {\n  /** The intersection observer entry */\n  entry?: IntersectionObserverEntry;\n  /** The intersection observer in view */\n  inView: boolean;\n  /** The intersection observer instance */\n  observer?: IntersectionObserver;\n}\n\nexport interface UseVisibility {\n  <Target extends Element>(\n    options?: UseVisibilityOptions,\n    target?: never\n  ): UseVisibilityReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, options?: UseVisibilityOptions): UseVisibilityReturn;\n\n  <Target extends Element>(\n    callback: UseVisibilityCallback,\n    target?: never\n  ): UseVisibilityReturn & { ref: StateRef<Target> };\n\n  (target: HookTarget, callback: UseVisibilityCallback): UseVisibilityReturn;\n}\n\n/**\n * @name useVisibility\n * @description - Hook that gives you visibility observer state\n * @category Sensors\n * @usage medium\n *\n * @browserapi IntersectionObserver https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver\n *\n * @overload\n * @param {HookTarget} target The target element to detect intersection\n * @param {boolean} [options.enabled=true] The Intersection options\n * @param {((entries: IntersectionEntry[], observer: Intersection) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\n * @param {HookTarget} [options.root=document] The root element to observe\n * @returns {UseVisibilityReturn} An object containing the state\n *\n * @example\n * const { ref, entries, observer } = useVisibility();\n *\n * @overload\n * @template Target The target element\n * @param {boolean} [options.enabled=true] The Intersection options\n * @param {((entries: IntersectionEntry[], observer: Intersection) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\n * @param {HookTarget} [options.root=document] The root element to observe\n * @returns {UseVisibilityReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { entries, observer } = useVisibility(ref);\n *\n * @overload\n * @template Target The target element\n * @param {UseVisibilityCallback} callback The callback to execute when intersection is detected\n * @returns {UseVisibilityReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\n *\n * @example\n * const { ref, entries, observer } = useVisibility(() => console.log('callback'));\n *\n * @overload\n * @param {UseVisibilityCallback} callback The callback to execute when intersection is detected\n * @param {HookTarget} target The target element to detect intersection\n * @returns {UseVisibilityReturn} An object containing the state\n *\n * @example\n * const { entries, observer } = useVisibility(ref, () => console.log('callback'));\n */\nexport const useVisibility = ((...params: any[]) => {\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\n\n  const options = (\n    target\n      ? typeof params[1] === 'object'\n        ? params[1]\n        : { onChange: params[1] }\n      : typeof params[0] === 'object'\n        ? params[0]\n        : { onChange: params[0] }\n  ) as UseVisibilityOptions | undefined;\n\n  const callback = options?.onChange;\n  const enabled = options?.enabled ?? true;\n\n  const [observer, setObserver] = useState<IntersectionObserver>();\n  const [entry, setEntry] = useState<IntersectionObserverEntry>();\n  const inView = entry?.isIntersecting ?? false;\n\n  const internalRef = useRefState<Element>();\n  const internalCallbackRef = useRef(callback);\n  internalCallbackRef.current = callback;\n\n  useEffect(() => {\n    if (!enabled || (!target && !internalRef.state)) return;\n\n    const element = target ? isTarget.getElement(target) : internalRef.current;\n    if (!element) return;\n\n    const observer = new IntersectionObserver(\n      (entries: IntersectionObserverEntry[], observer: IntersectionObserver) => {\n        const firstEntry = entries[0];\n        if (firstEntry) {\n          setEntry(firstEntry);\n          internalCallbackRef.current?.(firstEntry, observer);\n        }\n      },\n      {\n        ...options,\n        root: options?.root ? (isTarget.getElement(options.root) as Document | Element) : document\n      }\n    );\n\n    setObserver(observer);\n    observer.observe(element as Element);\n\n    return () => {\n      observer.disconnect();\n    };\n  }, [\n    target && isTarget.getRawElement(target),\n    internalRef.state,\n    options?.rootMargin,\n    options?.threshold,\n    options?.root,\n    enabled\n  ]);\n\n  if (target) return { observer, entry, inView };\n  return {\n    observer,\n    ref: internalRef,\n    entry,\n    inView\n  };\n}) as UseVisibility;\n"],"names":["useVisibility","params","target","isTarget","options","callback","enabled","observer","setObserver","useState","entry","setEntry","inView","internalRef","useRefState","internalCallbackRef","useRef","useEffect","element","entries","firstEntry"],"mappings":";;;AAgGO,MAAMA,KAAiB,IAAIC,MAAkB;AAClD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,IACtB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,GAGtBI,IAAWD,GAAS,UACpBE,IAAUF,GAAS,WAAW,IAE9B,CAACG,GAAUC,CAAW,IAAIC,EAAA,GAC1B,CAACC,GAAOC,CAAQ,IAAIF,EAAA,GACpBG,IAASF,GAAO,kBAAkB,IAElCG,IAAcC,EAAA,GACdC,IAAsBC,EAAOX,CAAQ;AAsC3C,SArCAU,EAAoB,UAAUV,GAE9BY,EAAU,MAAM;AACd,QAAI,CAACX,KAAY,CAACJ,KAAU,CAACW,EAAY,MAAQ;AAEjD,UAAMK,IAAUhB,IAASC,EAAS,WAAWD,CAAM,IAAIW,EAAY;AACnE,QAAI,CAACK,EAAS;AAEd,UAAMX,IAAW,IAAI;AAAA,MACnB,CAACY,GAAsCZ,MAAmC;AACxE,cAAMa,IAAaD,EAAQ,CAAC;AAC5B,QAAIC,MACFT,EAASS,CAAU,GACnBL,EAAoB,UAAUK,GAAYb,CAAQ;AAAA,MACpD;AAAA,MAEF;AAAA,QACE,GAAGH;AAAA,QACH,MAAMA,GAAS,OAAQD,EAAS,WAAWC,EAAQ,IAAI,IAA2B;AAAA,MAAA;AAAA,IACpF;AAGF,WAAAI,EAAYD,CAAQ,GACpBA,EAAS,QAAQW,CAAkB,GAE5B,MAAM;AACXX,MAAAA,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC;AAAA,IACDL,KAAUC,EAAS,cAAcD,CAAM;AAAA,IACvCW,EAAY;AAAA,IACZT,GAAS;AAAA,IACTA,GAAS;AAAA,IACTA,GAAS;AAAA,IACTE;AAAA,EAAA,CACD,GAEGJ,IAAe,EAAE,UAAAK,GAAU,OAAAG,GAAO,QAAAE,EAAA,IAC/B;AAAA,IACL,UAAAL;AAAA,IACA,KAAKM;AAAA,IACL,OAAAH;AAAA,IACA,QAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useVisibility.mjs","sources":["../../../../src/hooks/useVisibility/useVisibility.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\r\n\r\nimport type { HookTarget } from '@/utils/helpers';\r\n\r\nimport { isTarget } from '@/utils/helpers';\r\n\r\nimport type { StateRef } from '../useRefState/useRefState';\r\n\r\nimport { useRefState } from '../useRefState/useRefState';\r\n\r\n/** The visibility callback type */\r\nexport type UseVisibilityCallback = (\r\n  entry: IntersectionObserverEntry,\r\n  observer: IntersectionObserver\r\n) => void;\r\n\r\n/** The visibility options type */\r\nexport interface UseVisibilityOptions extends Omit<IntersectionObserverInit, 'root'> {\r\n  /** The enabled state of the intersection */\r\n  enabled?: boolean;\r\n  /** The callback to execute when intersection is detected */\r\n  onChange?: UseVisibilityCallback;\r\n  /** The root element to observe */\r\n  root?: HookTarget;\r\n}\r\n\r\n/** The intersection observer return type */\r\nexport interface UseVisibilityReturn {\r\n  /** The intersection observer entry */\r\n  entry?: IntersectionObserverEntry;\r\n  /** The intersection observer in view */\r\n  inView: boolean;\r\n  /** The intersection observer instance */\r\n  observer?: IntersectionObserver;\r\n}\r\n\r\nexport interface UseVisibility {\r\n  <Target extends Element>(\r\n    options?: UseVisibilityOptions,\r\n    target?: never\r\n  ): UseVisibilityReturn & { ref: StateRef<Target> };\r\n\r\n  (target: HookTarget, options?: UseVisibilityOptions): UseVisibilityReturn;\r\n\r\n  <Target extends Element>(\r\n    callback: UseVisibilityCallback,\r\n    target?: never\r\n  ): UseVisibilityReturn & { ref: StateRef<Target> };\r\n\r\n  (target: HookTarget, callback: UseVisibilityCallback): UseVisibilityReturn;\r\n}\r\n\r\n/**\r\n * @name useVisibility\r\n * @description - Hook that gives you visibility observer state\r\n * @category Sensors\r\n * @usage medium\r\n *\r\n * @browserapi IntersectionObserver https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver\r\n *\r\n * @overload\r\n * @param {HookTarget} target The target element to detect intersection\r\n * @param {boolean} [options.enabled=true] The Intersection options\r\n * @param {((entries: IntersectionEntry[], observer: Intersection) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\r\n * @param {HookTarget} [options.root=document] The root element to observe\r\n * @returns {UseVisibilityReturn} An object containing the state\r\n *\r\n * @example\r\n * const { ref, entries, observer } = useVisibility();\r\n *\r\n * @overload\r\n * @template Target The target element\r\n * @param {boolean} [options.enabled=true] The Intersection options\r\n * @param {((entries: IntersectionEntry[], observer: Intersection) => void) | undefined} [options.onChange] The callback to execute when intersection is detected\r\n * @param {HookTarget} [options.root=document] The root element to observe\r\n * @returns {UseVisibilityReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\r\n *\r\n * @example\r\n * const { entries, observer } = useVisibility(ref);\r\n *\r\n * @overload\r\n * @template Target The target element\r\n * @param {UseVisibilityCallback} callback The callback to execute when intersection is detected\r\n * @returns {UseVisibilityReturn & { ref: StateRef<Target> }} A React ref to attach to the target element\r\n *\r\n * @example\r\n * const { ref, entries, observer } = useVisibility(() => console.log('callback'));\r\n *\r\n * @overload\r\n * @param {UseVisibilityCallback} callback The callback to execute when intersection is detected\r\n * @param {HookTarget} target The target element to detect intersection\r\n * @returns {UseVisibilityReturn} An object containing the state\r\n *\r\n * @example\r\n * const { entries, observer } = useVisibility(ref, () => console.log('callback'));\r\n */\r\nexport const useVisibility = ((...params: any[]) => {\r\n  const target = (isTarget(params[0]) ? params[0] : undefined) as HookTarget | undefined;\r\n\r\n  const options = (\r\n    target\r\n      ? typeof params[1] === 'object'\r\n        ? params[1]\r\n        : { onChange: params[1] }\r\n      : typeof params[0] === 'object'\r\n        ? params[0]\r\n        : { onChange: params[0] }\r\n  ) as UseVisibilityOptions | undefined;\r\n\r\n  const callback = options?.onChange;\r\n  const enabled = options?.enabled ?? true;\r\n\r\n  const [observer, setObserver] = useState<IntersectionObserver>();\r\n  const [entry, setEntry] = useState<IntersectionObserverEntry>();\r\n  const inView = entry?.isIntersecting ?? false;\r\n\r\n  const internalRef = useRefState<Element>();\r\n  const internalCallbackRef = useRef(callback);\r\n  internalCallbackRef.current = callback;\r\n\r\n  useEffect(() => {\r\n    if (!enabled || (!target && !internalRef.state)) return;\r\n\r\n    const element = target ? isTarget.getElement(target) : internalRef.current;\r\n    if (!element) return;\r\n\r\n    const observer = new IntersectionObserver(\r\n      (entries: IntersectionObserverEntry[], observer: IntersectionObserver) => {\r\n        const firstEntry = entries[0];\r\n        if (firstEntry) {\r\n          setEntry(firstEntry);\r\n          internalCallbackRef.current?.(firstEntry, observer);\r\n        }\r\n      },\r\n      {\r\n        ...options,\r\n        root: options?.root ? (isTarget.getElement(options.root) as Document | Element) : document\r\n      }\r\n    );\r\n\r\n    setObserver(observer);\r\n    observer.observe(element as Element);\r\n\r\n    return () => {\r\n      observer.disconnect();\r\n    };\r\n  }, [\r\n    target && isTarget.getRawElement(target),\r\n    internalRef.state,\r\n    options?.rootMargin,\r\n    options?.threshold,\r\n    options?.root,\r\n    enabled\r\n  ]);\r\n\r\n  if (target) return { observer, entry, inView };\r\n  return {\r\n    observer,\r\n    ref: internalRef,\r\n    entry,\r\n    inView\r\n  };\r\n}) as UseVisibility;\r\n"],"names":["useVisibility","params","target","isTarget","options","callback","enabled","observer","setObserver","useState","entry","setEntry","inView","internalRef","useRefState","internalCallbackRef","useRef","useEffect","element","entries","firstEntry"],"mappings":";;;AAgGO,MAAMA,KAAiB,IAAIC,MAAkB;AAClD,QAAMC,IAAUC,EAASF,EAAO,CAAC,CAAC,IAAIA,EAAO,CAAC,IAAI,QAE5CG,IACJF,IACI,OAAOD,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,IACtB,OAAOA,EAAO,CAAC,KAAM,WACnBA,EAAO,CAAC,IACR,EAAE,UAAUA,EAAO,CAAC,EAAA,GAGtBI,IAAWD,GAAS,UACpBE,IAAUF,GAAS,WAAW,IAE9B,CAACG,GAAUC,CAAW,IAAIC,EAAA,GAC1B,CAACC,GAAOC,CAAQ,IAAIF,EAAA,GACpBG,IAASF,GAAO,kBAAkB,IAElCG,IAAcC,EAAA,GACdC,IAAsBC,EAAOX,CAAQ;AAsC3C,SArCAU,EAAoB,UAAUV,GAE9BY,EAAU,MAAM;AACd,QAAI,CAACX,KAAY,CAACJ,KAAU,CAACW,EAAY,MAAQ;AAEjD,UAAMK,IAAUhB,IAASC,EAAS,WAAWD,CAAM,IAAIW,EAAY;AACnE,QAAI,CAACK,EAAS;AAEd,UAAMX,IAAW,IAAI;AAAA,MACnB,CAACY,GAAsCZ,MAAmC;AACxE,cAAMa,IAAaD,EAAQ,CAAC;AAC5B,QAAIC,MACFT,EAASS,CAAU,GACnBL,EAAoB,UAAUK,GAAYb,CAAQ;AAAA,MACpD;AAAA,MAEF;AAAA,QACE,GAAGH;AAAA,QACH,MAAMA,GAAS,OAAQD,EAAS,WAAWC,EAAQ,IAAI,IAA2B;AAAA,MAAA;AAAA,IACpF;AAGF,WAAAI,EAAYD,CAAQ,GACpBA,EAAS,QAAQW,CAAkB,GAE5B,MAAM;AACXX,MAAAA,EAAS,WAAA;AAAA,IAAW;AAAA,EACtB,GACC;AAAA,IACDL,KAAUC,EAAS,cAAcD,CAAM;AAAA,IACvCW,EAAY;AAAA,IACZT,GAAS;AAAA,IACTA,GAAS;AAAA,IACTA,GAAS;AAAA,IACTE;AAAA,EAAA,CACD,GAEGJ,IAAe,EAAE,UAAAK,GAAU,OAAAG,GAAO,QAAAE,EAAA,IAC/B;AAAA,IACL,UAAAL;AAAA,IACA,KAAKM;AAAA,IACL,OAAAH;AAAA,IACA,QAAAE;AAAA,EAAA;AAEJ;"}

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

@@ -1 +1 @@
-{"version":3,"file":"useWakeLock.mjs","sources":["../../../../src/hooks/useWakeLock/useWakeLock.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\n/** The use wake lock options type */\nexport interface UseWakeLockOptions {\n  /** Determines if the wake lock should be automatically reacquired when the document becomes visible. */\n  immediately?: boolean;\n  /** A string specifying the screen wake lock type. */\n  type?: WakeLockType;\n}\n\n/** The use wake lock return type */\nexport interface UseWakeLockReturn {\n  /** Indicates if the wake lock is currently active. */\n  active: boolean;\n  /** Indicates if the Wake Lock API is supported in the current environment. */\n  supported: boolean;\n  /** Function to release the wake lock. */\n  release: () => Promise<void>;\n  /** Function to request the wake lock. */\n  request: () => Promise<void>;\n}\n\n/**\n * @name useWakeLock\n * @description - Hook that provides a wake lock functionality\n * @category Browser\n * @usage low\n *\n * @browserapi navigator.wakeLock https://developer.mozilla.org/en-US/docs/Web/API/WakeLock\n *\n * @param {immediately} [options] Configuration options for the hook.\n * @returns {UseWakeLockReturn} An object containing the wake lock state and control methods.\n *\n * @example\n * const { supported, active, request, release } = useWakeLock();\n */\nexport const useWakeLock = (options?: UseWakeLockOptions): UseWakeLockReturn => {\n  const supported =\n    typeof navigator !== 'undefined' && 'wakeLock' in navigator && !!navigator.wakeLock;\n\n  const [active, setActive] = useState(false);\n  const sentinel = useRef<WakeLockSentinel>(undefined);\n\n  const immediately = options?.immediately ?? false;\n  const type = options?.type ?? 'screen';\n\n  const request = async (type?: WakeLockType) => {\n    if (!supported) return;\n\n    sentinel.current = await navigator.wakeLock.request(type ?? options?.type);\n    sentinel.current.addEventListener('release', () => {\n      setActive(false);\n      sentinel.current = undefined;\n    });\n\n    setActive(true);\n  };\n\n  const release = async () => {\n    if (!supported || !sentinel.current) return;\n\n    await sentinel.current.release();\n    sentinel.current = undefined;\n    setActive(false);\n  };\n\n  useEffect(() => {\n    if (!supported || !immediately || document.visibilityState !== 'visible' || type !== 'screen')\n      return;\n\n    const onVisibilityChange = async () => {\n      await release();\n      await request(type);\n    };\n\n    document.addEventListener('visibilitychange', onVisibilityChange);\n    return () => {\n      document.removeEventListener('visibilitychange', onVisibilityChange);\n    };\n  }, [type]);\n\n  return { supported, active, request, release };\n};\n"],"names":["useWakeLock","options","supported","active","setActive","useState","sentinel","useRef","immediately","type","request","release","useEffect","onVisibilityChange"],"mappings":";AAoCO,MAAMA,IAAc,CAACC,MAAoD;AAC9E,QAAMC,IACJ,OAAO,YAAc,OAAe,cAAc,aAAa,CAAC,CAAC,UAAU,UAEvE,CAACC,GAAQC,CAAS,IAAIC,EAAS,EAAK,GACpCC,IAAWC,EAAyB,MAAS,GAE7CC,IAAcP,GAAS,eAAe,IACtCQ,IAAOR,GAAS,QAAQ,UAExBS,IAAU,OAAOD,MAAwB;AAC7C,IAAKP,MAELI,EAAS,UAAU,MAAM,UAAU,SAAS,QAAQG,KAAQR,GAAS,IAAI,GACzEK,EAAS,QAAQ,iBAAiB,WAAW,MAAM;AACjD,MAAAF,EAAU,EAAK,GACfE,EAAS,UAAU;AAAA,IAAA,CACpB,GAEDF,EAAU,EAAI;AAAA,EAAA,GAGVO,IAAU,YAAY;AAC1B,IAAI,CAACT,KAAa,CAACI,EAAS,YAE5B,MAAMA,EAAS,QAAQ,QAAA,GACvBA,EAAS,UAAU,QACnBF,EAAU,EAAK;AAAA,EAAA;AAGjB,SAAAQ,EAAU,MAAM;AACd,QAAI,CAACV,KAAa,CAACM,KAAe,SAAS,oBAAoB,aAAaC,MAAS;AACnF;AAEF,UAAMI,IAAqB,YAAY;AACrC,YAAMF,EAAA,GACN,MAAMD,EAAQD,CAAI;AAAA,IAAA;AAGpB,oBAAS,iBAAiB,oBAAoBI,CAAkB,GACzD,MAAM;AACX,eAAS,oBAAoB,oBAAoBA,CAAkB;AAAA,IAAA;AAAA,EACrE,GACC,CAACJ,CAAI,CAAC,GAEF,EAAE,WAAAP,GAAW,QAAAC,GAAQ,SAAAO,GAAS,SAAAC,EAAA;AACvC;"}
+{"version":3,"file":"useWakeLock.mjs","sources":["../../../../src/hooks/useWakeLock/useWakeLock.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\r\n\r\n/** The use wake lock options type */\r\nexport interface UseWakeLockOptions {\r\n  /** Determines if the wake lock should be automatically reacquired when the document becomes visible. */\r\n  immediately?: boolean;\r\n  /** A string specifying the screen wake lock type. */\r\n  type?: WakeLockType;\r\n}\r\n\r\n/** The use wake lock return type */\r\nexport interface UseWakeLockReturn {\r\n  /** Indicates if the wake lock is currently active. */\r\n  active: boolean;\r\n  /** Indicates if the Wake Lock API is supported in the current environment. */\r\n  supported: boolean;\r\n  /** Function to release the wake lock. */\r\n  release: () => Promise<void>;\r\n  /** Function to request the wake lock. */\r\n  request: () => Promise<void>;\r\n}\r\n\r\n/**\r\n * @name useWakeLock\r\n * @description - Hook that provides a wake lock functionality\r\n * @category Browser\r\n * @usage low\r\n *\r\n * @browserapi navigator.wakeLock https://developer.mozilla.org/en-US/docs/Web/API/WakeLock\r\n *\r\n * @param {immediately} [options] Configuration options for the hook.\r\n * @returns {UseWakeLockReturn} An object containing the wake lock state and control methods.\r\n *\r\n * @example\r\n * const { supported, active, request, release } = useWakeLock();\r\n */\r\nexport const useWakeLock = (options?: UseWakeLockOptions): UseWakeLockReturn => {\r\n  const supported =\r\n    typeof navigator !== 'undefined' && 'wakeLock' in navigator && !!navigator.wakeLock;\r\n\r\n  const [active, setActive] = useState(false);\r\n  const sentinel = useRef<WakeLockSentinel>(undefined);\r\n\r\n  const immediately = options?.immediately ?? false;\r\n  const type = options?.type ?? 'screen';\r\n\r\n  const request = async (type?: WakeLockType) => {\r\n    if (!supported) return;\r\n\r\n    sentinel.current = await navigator.wakeLock.request(type ?? options?.type);\r\n    sentinel.current.addEventListener('release', () => {\r\n      setActive(false);\r\n      sentinel.current = undefined;\r\n    });\r\n\r\n    setActive(true);\r\n  };\r\n\r\n  const release = async () => {\r\n    if (!supported || !sentinel.current) return;\r\n\r\n    await sentinel.current.release();\r\n    sentinel.current = undefined;\r\n    setActive(false);\r\n  };\r\n\r\n  useEffect(() => {\r\n    if (!supported || !immediately || document.visibilityState !== 'visible' || type !== 'screen')\r\n      return;\r\n\r\n    const onVisibilityChange = async () => {\r\n      await release();\r\n      await request(type);\r\n    };\r\n\r\n    document.addEventListener('visibilitychange', onVisibilityChange);\r\n    return () => {\r\n      document.removeEventListener('visibilitychange', onVisibilityChange);\r\n    };\r\n  }, [type]);\r\n\r\n  return { supported, active, request, release };\r\n};\r\n"],"names":["useWakeLock","options","supported","active","setActive","useState","sentinel","useRef","immediately","type","request","release","useEffect","onVisibilityChange"],"mappings":";AAoCO,MAAMA,IAAc,CAACC,MAAoD;AAC9E,QAAMC,IACJ,OAAO,YAAc,OAAe,cAAc,aAAa,CAAC,CAAC,UAAU,UAEvE,CAACC,GAAQC,CAAS,IAAIC,EAAS,EAAK,GACpCC,IAAWC,EAAyB,MAAS,GAE7CC,IAAcP,GAAS,eAAe,IACtCQ,IAAOR,GAAS,QAAQ,UAExBS,IAAU,OAAOD,MAAwB;AAC7C,IAAKP,MAELI,EAAS,UAAU,MAAM,UAAU,SAAS,QAAQG,KAAQR,GAAS,IAAI,GACzEK,EAAS,QAAQ,iBAAiB,WAAW,MAAM;AACjD,MAAAF,EAAU,EAAK,GACfE,EAAS,UAAU;AAAA,IAAA,CACpB,GAEDF,EAAU,EAAI;AAAA,EAAA,GAGVO,IAAU,YAAY;AAC1B,IAAI,CAACT,KAAa,CAACI,EAAS,YAE5B,MAAMA,EAAS,QAAQ,QAAA,GACvBA,EAAS,UAAU,QACnBF,EAAU,EAAK;AAAA,EAAA;AAGjB,SAAAQ,EAAU,MAAM;AACd,QAAI,CAACV,KAAa,CAACM,KAAe,SAAS,oBAAoB,aAAaC,MAAS;AACnF;AAEF,UAAMI,IAAqB,YAAY;AACrC,YAAMF,EAAA,GACN,MAAMD,EAAQD,CAAI;AAAA,IAAA;AAGpB,oBAAS,iBAAiB,oBAAoBI,CAAkB,GACzD,MAAM;AACX,eAAS,oBAAoB,oBAAoBA,CAAkB;AAAA,IAAA;AAAA,EACrE,GACC,CAACJ,CAAI,CAAC,GAEF,EAAE,WAAAP,GAAW,QAAAC,GAAQ,SAAAO,GAAS,SAAAC,EAAA;AACvC;"}

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

@@ -1 +1 @@
-{"version":3,"file":"useWebSocket.mjs","sources":["../../../../src/hooks/useWebSocket/useWebSocket.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\n\nimport { getRetry } from '@/utils/helpers';\n\nimport { useEvent } from '../useEvent/useEvent';\n\n/** The use web socket url type */\nexport type UseWebSocketUrl = (() => string) | string;\n\n/** The use web socket options type */\nexport interface UseWebSocketOptions {\n  /** The list of protocols to use */\n  protocols?: Array<'soap' | 'wasm'>;\n  /** The number of times to retry the connection */\n  retry?: boolean | number;\n  /** The callback function that is called when the WebSocket connection is established */\n  onConnected?: (webSocket: WebSocket) => void;\n  /** The callback function that is called when the WebSocket connection is closed */\n  onDisconnected?: (event: CloseEvent, webSocket: WebSocket) => void;\n  /** The callback function that is called when an error occurs */\n  onError?: (event: Event, webSocket: WebSocket) => void;\n  /** The callback function that is called when a message is received */\n  onMessage?: (event: MessageEvent, webSocket: WebSocket) => void;\n}\n\nexport type UseWebSocketStatus = 'connected' | 'connecting' | 'disconnected' | 'failed';\n\n/** The use web socket return type */\nexport interface UseWebSocketReturn {\n  /** The WebSocket client */\n  client?: WebSocket;\n  /** The close function */\n  close: WebSocket['close'];\n  /** The send function */\n  send: WebSocket['send'];\n  /** The status of the WebSocket connection */\n  status: UseWebSocketStatus;\n  /** The open function */\n  open: () => void;\n}\n\n/**\n * @name useWebSocket\n * @description - Hook that connects to a WebSocket server and handles incoming and outgoing messages\n * @category Browser\n * @usage medium\n *\n * @browserapi WebSocket https://developer.mozilla.org/en-US/docs/Web/API/WebSocket\n *\n * @param {UseWebSocketUrl} url The URL of the WebSocket server\n * @param {(webSocket: WebSocket) => void} [options.onConnected] The callback function that is called when the WebSocket connection is established\n * @param {(event: CloseEvent, webSocket: WebSocket) => void} [options.onDisconnected] The callback function that is called when the WebSocket connection is closed\n * @param {(event: Event, webSocket: WebSocket) => void} [options.onError] The callback function that is called when an error occurs\n * @param {(event: MessageEvent, webSocket: WebSocket) => void} [options.onMessage] The callback function that is called when a message is received\n * @param {boolean | number} [options.retry] The number of times to retry the connection\n * @param {Array<'soap' | 'wasm'>} [options.protocols] The list of protocols to use\n * @returns {UseWebSocketReturn} An object with the status, close, send, open, and ws properties\n *\n * @example\n * const { status, close, send, open, client } = useWebSocket('url');\n */\nexport const useWebSocket = (\n  url: UseWebSocketUrl,\n  options?: UseWebSocketOptions\n): UseWebSocketReturn => {\n  const webSocketRef = useRef<WebSocket>(undefined);\n  const retryCountRef = useRef(options?.retry ? getRetry(options.retry) : 0);\n  const explicityCloseRef = useRef(false);\n\n  const [status, setStatus] = useState<UseWebSocketStatus>('connecting');\n\n  const send = (data: string | ArrayBufferLike | ArrayBufferView | Blob) =>\n    webSocketRef.current?.send(data);\n\n  const close = () => {\n    explicityCloseRef.current = true;\n    webSocketRef.current?.close();\n  };\n\n  const init = useEvent(() => {\n    webSocketRef.current = new WebSocket(\n      typeof url === 'function' ? url() : url,\n      options?.protocols\n    );\n    setStatus('connecting');\n\n    const webSocket = webSocketRef.current;\n    if (!webSocket) return;\n\n    webSocket.onopen = () => {\n      setStatus('connected');\n      options?.onConnected?.(webSocket);\n    };\n\n    webSocket.onerror = (event) => {\n      setStatus('failed');\n      options?.onError?.(event, webSocket);\n    };\n\n    webSocket.onmessage = (event) => options?.onMessage?.(event, webSocket);\n\n    webSocket.onclose = (event) => {\n      setStatus('disconnected');\n      options?.onDisconnected?.(event, webSocket);\n      if (explicityCloseRef.current) return;\n\n      if (retryCountRef.current > 0) {\n        retryCountRef.current -= 1;\n        return init();\n      }\n      retryCountRef.current = options?.retry ? getRetry(options.retry) : 0;\n    };\n  });\n\n  useEffect(() => {\n    init();\n\n    return () => {\n      if (!webSocketRef.current) return;\n      webSocketRef.current.close();\n      webSocketRef.current = undefined;\n    };\n  }, [url]);\n\n  const open = () => {\n    explicityCloseRef.current = false;\n    init();\n  };\n\n  return { client: webSocketRef.current, close, open, send, status };\n};\n"],"names":["useWebSocket","url","options","webSocketRef","useRef","retryCountRef","getRetry","explicityCloseRef","status","setStatus","useState","send","data","close","init","useEvent","webSocket","event","useEffect","open"],"mappings":";;;AA6DO,MAAMA,IAAe,CAC1BC,GACAC,MACuB;AACvB,QAAMC,IAAeC,EAAkB,MAAS,GAC1CC,IAAgBD,EAAOF,GAAS,QAAQI,EAASJ,EAAQ,KAAK,IAAI,CAAC,GACnEK,IAAoBH,EAAO,EAAK,GAEhC,CAACI,GAAQC,CAAS,IAAIC,EAA6B,YAAY,GAE/DC,IAAO,CAACC,MACZT,EAAa,SAAS,KAAKS,CAAI,GAE3BC,IAAQ,MAAM;AAClB,IAAAN,EAAkB,UAAU,IAC5BJ,EAAa,SAAS,MAAA;AAAA,EAAM,GAGxBW,IAAOC,EAAS,MAAM;AAC1B,IAAAZ,EAAa,UAAU,IAAI;AAAA,MACzB,OAAOF,KAAQ,aAAaA,EAAA,IAAQA;AAAA,MACpCC,GAAS;AAAA,IAAA,GAEXO,EAAU,YAAY;AAEtB,UAAMO,IAAYb,EAAa;AAC/B,IAAKa,MAELA,EAAU,SAAS,MAAM;AACvB,MAAAP,EAAU,WAAW,GACrBP,GAAS,cAAcc,CAAS;AAAA,IAAA,GAGlCA,EAAU,UAAU,CAACC,MAAU;AAC7B,MAAAR,EAAU,QAAQ,GAClBP,GAAS,UAAUe,GAAOD,CAAS;AAAA,IAAA,GAGrCA,EAAU,YAAY,CAACC,MAAUf,GAAS,YAAYe,GAAOD,CAAS,GAEtEA,EAAU,UAAU,CAACC,MAAU;AAG7B,UAFAR,EAAU,cAAc,GACxBP,GAAS,iBAAiBe,GAAOD,CAAS,GACtC,CAAAT,EAAkB,SAEtB;AAAA,YAAIF,EAAc,UAAU;AAC1B,iBAAAA,EAAc,WAAW,GAClBS,EAAA;AAET,QAAAT,EAAc,UAAUH,GAAS,QAAQI,EAASJ,EAAQ,KAAK,IAAI;AAAA;AAAA,IAAA;AAAA,EACrE,CACD;AAED,EAAAgB,EAAU,OACRJ,EAAA,GAEO,MAAM;AACX,IAAKX,EAAa,YAClBA,EAAa,QAAQ,MAAA,GACrBA,EAAa,UAAU;AAAA,EAAA,IAExB,CAACF,CAAG,CAAC;AAER,QAAMkB,IAAO,MAAM;AACjB,IAAAZ,EAAkB,UAAU,IAC5BO,EAAA;AAAA,EAAK;AAGP,SAAO,EAAE,QAAQX,EAAa,SAAS,OAAAU,GAAO,MAAAM,GAAM,MAAAR,GAAM,QAAAH,EAAA;AAC5D;"}
+{"version":3,"file":"useWebSocket.mjs","sources":["../../../../src/hooks/useWebSocket/useWebSocket.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\r\n\r\nimport { getRetry } from '@/utils/helpers';\r\n\r\nimport { useEvent } from '../useEvent/useEvent';\r\n\r\n/** The use web socket url type */\r\nexport type UseWebSocketUrl = (() => string) | string;\r\n\r\n/** The use web socket options type */\r\nexport interface UseWebSocketOptions {\r\n  /** The list of protocols to use */\r\n  protocols?: Array<'soap' | 'wasm'>;\r\n  /** The number of times to retry the connection */\r\n  retry?: boolean | number;\r\n  /** The callback function that is called when the WebSocket connection is established */\r\n  onConnected?: (webSocket: WebSocket) => void;\r\n  /** The callback function that is called when the WebSocket connection is closed */\r\n  onDisconnected?: (event: CloseEvent, webSocket: WebSocket) => void;\r\n  /** The callback function that is called when an error occurs */\r\n  onError?: (event: Event, webSocket: WebSocket) => void;\r\n  /** The callback function that is called when a message is received */\r\n  onMessage?: (event: MessageEvent, webSocket: WebSocket) => void;\r\n}\r\n\r\nexport type UseWebSocketStatus = 'connected' | 'connecting' | 'disconnected' | 'failed';\r\n\r\n/** The use web socket return type */\r\nexport interface UseWebSocketReturn {\r\n  /** The WebSocket client */\r\n  client?: WebSocket;\r\n  /** The close function */\r\n  close: WebSocket['close'];\r\n  /** The send function */\r\n  send: WebSocket['send'];\r\n  /** The status of the WebSocket connection */\r\n  status: UseWebSocketStatus;\r\n  /** The open function */\r\n  open: () => void;\r\n}\r\n\r\n/**\r\n * @name useWebSocket\r\n * @description - Hook that connects to a WebSocket server and handles incoming and outgoing messages\r\n * @category Browser\r\n * @usage medium\r\n *\r\n * @browserapi WebSocket https://developer.mozilla.org/en-US/docs/Web/API/WebSocket\r\n *\r\n * @param {UseWebSocketUrl} url The URL of the WebSocket server\r\n * @param {(webSocket: WebSocket) => void} [options.onConnected] The callback function that is called when the WebSocket connection is established\r\n * @param {(event: CloseEvent, webSocket: WebSocket) => void} [options.onDisconnected] The callback function that is called when the WebSocket connection is closed\r\n * @param {(event: Event, webSocket: WebSocket) => void} [options.onError] The callback function that is called when an error occurs\r\n * @param {(event: MessageEvent, webSocket: WebSocket) => void} [options.onMessage] The callback function that is called when a message is received\r\n * @param {boolean | number} [options.retry] The number of times to retry the connection\r\n * @param {Array<'soap' | 'wasm'>} [options.protocols] The list of protocols to use\r\n * @returns {UseWebSocketReturn} An object with the status, close, send, open, and ws properties\r\n *\r\n * @example\r\n * const { status, close, send, open, client } = useWebSocket('url');\r\n */\r\nexport const useWebSocket = (\r\n  url: UseWebSocketUrl,\r\n  options?: UseWebSocketOptions\r\n): UseWebSocketReturn => {\r\n  const webSocketRef = useRef<WebSocket>(undefined);\r\n  const retryCountRef = useRef(options?.retry ? getRetry(options.retry) : 0);\r\n  const explicityCloseRef = useRef(false);\r\n\r\n  const [status, setStatus] = useState<UseWebSocketStatus>('connecting');\r\n\r\n  const send = (data: string | ArrayBufferLike | ArrayBufferView | Blob) =>\r\n    webSocketRef.current?.send(data);\r\n\r\n  const close = () => {\r\n    explicityCloseRef.current = true;\r\n    webSocketRef.current?.close();\r\n  };\r\n\r\n  const init = useEvent(() => {\r\n    webSocketRef.current = new WebSocket(\r\n      typeof url === 'function' ? url() : url,\r\n      options?.protocols\r\n    );\r\n    setStatus('connecting');\r\n\r\n    const webSocket = webSocketRef.current;\r\n    if (!webSocket) return;\r\n\r\n    webSocket.onopen = () => {\r\n      setStatus('connected');\r\n      options?.onConnected?.(webSocket);\r\n    };\r\n\r\n    webSocket.onerror = (event) => {\r\n      setStatus('failed');\r\n      options?.onError?.(event, webSocket);\r\n    };\r\n\r\n    webSocket.onmessage = (event) => options?.onMessage?.(event, webSocket);\r\n\r\n    webSocket.onclose = (event) => {\r\n      setStatus('disconnected');\r\n      options?.onDisconnected?.(event, webSocket);\r\n      if (explicityCloseRef.current) return;\r\n\r\n      if (retryCountRef.current > 0) {\r\n        retryCountRef.current -= 1;\r\n        return init();\r\n      }\r\n      retryCountRef.current = options?.retry ? getRetry(options.retry) : 0;\r\n    };\r\n  });\r\n\r\n  useEffect(() => {\r\n    init();\r\n\r\n    return () => {\r\n      if (!webSocketRef.current) return;\r\n      webSocketRef.current.close();\r\n      webSocketRef.current = undefined;\r\n    };\r\n  }, [url]);\r\n\r\n  const open = () => {\r\n    explicityCloseRef.current = false;\r\n    init();\r\n  };\r\n\r\n  return { client: webSocketRef.current, close, open, send, status };\r\n};\r\n"],"names":["useWebSocket","url","options","webSocketRef","useRef","retryCountRef","getRetry","explicityCloseRef","status","setStatus","useState","send","data","close","init","useEvent","webSocket","event","useEffect","open"],"mappings":";;;AA6DO,MAAMA,IAAe,CAC1BC,GACAC,MACuB;AACvB,QAAMC,IAAeC,EAAkB,MAAS,GAC1CC,IAAgBD,EAAOF,GAAS,QAAQI,EAASJ,EAAQ,KAAK,IAAI,CAAC,GACnEK,IAAoBH,EAAO,EAAK,GAEhC,CAACI,GAAQC,CAAS,IAAIC,EAA6B,YAAY,GAE/DC,IAAO,CAACC,MACZT,EAAa,SAAS,KAAKS,CAAI,GAE3BC,IAAQ,MAAM;AAClB,IAAAN,EAAkB,UAAU,IAC5BJ,EAAa,SAAS,MAAA;AAAA,EAAM,GAGxBW,IAAOC,EAAS,MAAM;AAC1B,IAAAZ,EAAa,UAAU,IAAI;AAAA,MACzB,OAAOF,KAAQ,aAAaA,EAAA,IAAQA;AAAA,MACpCC,GAAS;AAAA,IAAA,GAEXO,EAAU,YAAY;AAEtB,UAAMO,IAAYb,EAAa;AAC/B,IAAKa,MAELA,EAAU,SAAS,MAAM;AACvB,MAAAP,EAAU,WAAW,GACrBP,GAAS,cAAcc,CAAS;AAAA,IAAA,GAGlCA,EAAU,UAAU,CAACC,MAAU;AAC7B,MAAAR,EAAU,QAAQ,GAClBP,GAAS,UAAUe,GAAOD,CAAS;AAAA,IAAA,GAGrCA,EAAU,YAAY,CAACC,MAAUf,GAAS,YAAYe,GAAOD,CAAS,GAEtEA,EAAU,UAAU,CAACC,MAAU;AAG7B,UAFAR,EAAU,cAAc,GACxBP,GAAS,iBAAiBe,GAAOD,CAAS,GACtC,CAAAT,EAAkB,SAEtB;AAAA,YAAIF,EAAc,UAAU;AAC1B,iBAAAA,EAAc,WAAW,GAClBS,EAAA;AAET,QAAAT,EAAc,UAAUH,GAAS,QAAQI,EAASJ,EAAQ,KAAK,IAAI;AAAA;AAAA,IAAA;AAAA,EACrE,CACD;AAED,EAAAgB,EAAU,OACRJ,EAAA,GAEO,MAAM;AACX,IAAKX,EAAa,YAClBA,EAAa,QAAQ,MAAA,GACrBA,EAAa,UAAU;AAAA,EAAA,IAExB,CAACF,CAAG,CAAC;AAER,QAAMkB,IAAO,MAAM;AACjB,IAAAZ,EAAkB,UAAU,IAC5BO,EAAA;AAAA,EAAK;AAGP,SAAO,EAAE,QAAQX,EAAa,SAAS,OAAAU,GAAO,MAAAM,GAAM,MAAAR,GAAM,QAAAH,EAAA;AAC5D;"}