Merge branch 'experimental' of https://github.com/uidotdev/usehooks into experimental

Author: tylermcginnis

index.d.ts

@@ -128,21 +128,34 @@ declare module "@uidotdev/usehooks" {
     (value: string) => Promise<void>
   ];
 
+  export function useContinuousRetry(
+    callback: () => any,
+    interval?: number,
+    options?: {
+      maxRetries?: number
+    }): boolean;
+
+  export function useCountdown(endTime: number, options: {
+    interval: number,
+    onComplete: () => any,
+    onTick: () => any
+  }): number;
+
   export function useCounter(
     startingValue?: number,
     options?: {
       min?: number;
       max?: number;
     }
   ): [
-    number,
-    {
-      increment: () => void;
-      decrement: () => void;
-      set: (nextCount: number) => void;
-      reset: () => void;
-    }
-  ];
+      number,
+      {
+        increment: () => void;
+        decrement: () => void;
+        set: (nextCount: number) => void;
+        reset: () => void;
+      }
+    ];
 
   export function useDebounce<T>(value: T, delay: number): T;
 
@@ -153,8 +166,25 @@ declare module "@uidotdev/usehooks" {
 
   export function useDocumentTitle(title: string): void;
 
+  export function useEventListener(
+    target: React.MutableRefObject<Element> | Element,
+    eventName: string,
+    handler: (Event) => any,
+    options?: {
+      capture?: boolean,
+      passive?: boolean,
+      once?: boolean
+    }): void;
+
   export function useFavicon(url: string): void;
 
+  export function useFetch(
+    url: string,
+    options?: {}): {
+      error: Error | undefined,
+      data: any | undefined
+    }
+
   export function useGeolocation(options?: PositionOptions): GeolocationState;
 
   export function useHistoryState<T>(initialPresent?: T): HistoryState<T>;
@@ -170,10 +200,29 @@ declare module "@uidotdev/usehooks" {
     options?: IntersectionObserverInit
   ): [React.MutableRefObject<T>, IntersectionObserverEntry | null];
 
+  export function useInterval(cb: () => any, ms: number): () => void;
+
+  export function useIntervalWhen(
+    cb: () => any,
+    options: {
+      ms: number,
+      when: boolean,
+      startImmediately?: boolean
+    }): () => void;
+
   export function useIsClient(): boolean;
 
   export function useIsFirstRender(): boolean;
 
+  export function useKeyPress(
+    key: string,
+    cb: (Event) => any,
+    options?: {
+      event?: string,
+      target?: Element | Window,
+      eventOptions?: {}
+    }): void;
+
   export function useList<T>(defaultList?: T[]): [T[], CustomList<T>];
 
   export function useLocalStorage<T>(
@@ -183,6 +232,8 @@ declare module "@uidotdev/usehooks" {
 
   export function useLockBodyScroll(): void;
 
+  export function useLogger(name: string, ...rest: any[]): void;
+
   export function useLongPress(
     callback: (e: Event) => void,
     options?: LongPressOptions
@@ -214,12 +265,19 @@ declare module "@uidotdev/usehooks" {
     type: string;
   };
 
+  export function usePageLeave(cb: () => any): void;
+
   export function usePreferredLanguage(): string;
 
   export function usePrevious<T>(newValue: T): T;
 
   export function useQueue<T>(initialValue?: T[]): CustomQueue<T>;
 
+  export function useRandomInterval(cb: () => any, options: {
+    minDelay: number,
+    maxDelay: number
+  }): () => void;
+
   export function useRenderCount(): number;
 
   export function useRenderInfo(name?: string): RenderInfo | undefined;
@@ -242,6 +300,8 @@ declare module "@uidotdev/usehooks" {
 
   export function useThrottle<T>(value: T, delay: number): T;
 
+  export function useTimeout(cb: () => any, ms: number): () => void;
+
   export function useToggle(
     initialValue?: boolean
   ): [boolean, (newValue?: boolean) => void];

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@uidotdev/usehooks",
-  "version": "2.1.1-experimental.1",
+  "version": "2.3.1-experimental.1",
   "description": "A collection of modern, server-safe React hooks – from the ui.dev team",
   "type": "module",
   "repository": "uidotdev/usehooks",