@aweebit/react-essentials 0.8.1 → 0.9.0

package/README.md

@@ -10,7 +10,6 @@
 ### Functions
 
 - [useEventListener()](#useeventlistener)
-- [useForceUpdate()](#useforceupdate)
 - [useReducerWithDeps()](#usereducerwithdeps)
 - [useStateWithDeps()](#usestatewithdeps)
 - [createSafeContext()](#createsafecontext)
@@ -18,12 +17,6 @@
 ### Types
 
 - [UseEventListener](#useeventlistener-1)
-- [UseEventListenerWithImplicitWindowTarget](#useeventlistenerwithimplicitwindowtarget)
-- [UseEventListenerWithExplicitTarget](#useeventlistenerwithexplicittarget)
-- [UseEventListenerWithAnyExplicitTarget](#useeventlistenerwithanyexplicittarget)
-- [UseEventListenerWithImplicitWindowTargetArgs](#useeventlistenerwithimplicitwindowtargetargs)
-- [UseEventListenerWithExplicitTargetArgs](#useeventlistenerwithexplicittargetargs)
-- [RestrictedContext](#restrictedcontext)
 - [SafeContext](#safecontext)
 
 ## useEventListener
@@ -32,7 +25,7 @@
 const useEventListener: UseEventListener;
 ```
 
-Defined in: [hooks/useEventListener.ts:135](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L135)
+Defined in: [hooks/useEventListener.ts:135](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L135)
 
 Adds `handler` as a listener for the event `eventName` of `target` with the
 provided `options` applied
@@ -73,78 +66,6 @@ useEventListener(buttonRef, 'click', () => console.log('click'));
 
 ---
 
-## ~~useForceUpdate()~~
-
-```ts
-function useForceUpdate(callback?): [() => void, bigint];
-```
-
-Defined in: [hooks/useForceUpdate.ts:37](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useForceUpdate.ts#L37)
-
-Enables you to imperatively trigger re-rendering of components
-
-This hook is designed in the most general way possible in order to cover all
-imaginable use cases.
-
-### Deprecated
-
-This hook encourages patterns that are unsafe in Concurrent React.
-For details and ideas on how to get rid of it, please check the discussion at
-https://www.reddit.com/r/react/comments/1nqcsri/comment/ng76cv5/.
-
-### Parameters
-
-<table>
-<thead>
-<tr>
-<th>Parameter</th>
-<th>Type</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>
-
-`callback?`
-
-</td>
-<td>
-
-() => `void`
-
-</td>
-<td>
-
-An optional callback function to call during renders that
-were triggered with `forceUpdate()`
-
-Can be used for conditionally calling state setters when state needs to be
-reset. That is legal and better than using effects (see
-[You Might Not Need an Effect \> Adjusting some state when a prop changes](https://react.dev/learn/-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes)),
-but can often be avoided by using [`useStateWithDeps`](#usestatewithdeps) or
-[`useReducerWithDeps`](#usereducerwithdeps).
-
-Important: the callback function is called once per render, not once per
-`forceUpdate` call! If React batches `forceUpdate` calls, then it will only
-be called once.
-
-</td>
-</tr>
-</tbody>
-</table>
-
-### Returns
-
-\[() => `void`, `bigint`\]
-
-An array with the following two elements:
-
-1. A `forceUpdate` function that triggers a re-render
-2. The number of times `forceUpdate` has been called so far
-
----
-
 ## useReducerWithDeps()
 
 ```ts
@@ -155,7 +76,7 @@ function useReducerWithDeps<S, A>(
 ): [S, ActionDispatch<A>];
 ```
 
-Defined in: [hooks/useReducerWithDeps.ts:59](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useReducerWithDeps.ts#L59)
+Defined in: [hooks/useReducerWithDeps.ts:59](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useReducerWithDeps.ts#L59)
 
 `useReducer` hook with an additional dependency array `deps` that resets the
 state to `initialState` when dependencies change
@@ -298,7 +219,7 @@ function useStateWithDeps<S>(
 ): [S, Dispatch<SetStateAction<S>>];
 ```
 
-Defined in: [hooks/useStateWithDeps.ts:62](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useStateWithDeps.ts#L62)
+Defined in: [hooks/useStateWithDeps.ts:62](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useStateWithDeps.ts#L62)
 
 `useState` hook with an additional dependency array `deps` that resets the
 state to `initialState` when dependencies change
@@ -430,7 +351,7 @@ function createSafeContext<T>(): <DisplayName>(
 ) => SafeContext<DisplayName, T>;
 ```
 
-Defined in: [misc/createSafeContext.ts:95](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/misc/createSafeContext.ts#L95)
+Defined in: [misc/createSafeContext.ts:95](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/misc/createSafeContext.ts#L95)
 
 For a given type `T`, returns a function that produces both a context of that
 type and a hook that returns the current context value if one was provided,
@@ -581,7 +502,7 @@ type UseEventListener = UseEventListenerWithImplicitWindowTarget &
   UseEventListenerWithAnyExplicitTarget;
 ```
 
-Defined in: [hooks/useEventListener.ts:12](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L12)
+Defined in: [hooks/useEventListener.ts:12](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L12)
 
 The type of [`useEventListener`](#useeventlistener-1)
 
@@ -600,7 +521,7 @@ The type of [`useEventListener`](#useeventlistener-1)
 type UseEventListenerWithImplicitWindowTarget = <K>(...args) => void;
 ```
 
-Defined in: [hooks/useEventListener.ts:21](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L21)
+Defined in: [hooks/useEventListener.ts:21](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L21)
 
 ### Type Parameters
 
@@ -668,7 +589,7 @@ type UseEventListenerWithExplicitGlobalTarget =
     UseEventListenerWithExplicitTarget<MathMLElement, MathMLElementEventMap>;
 ```
 
-Defined in: [hooks/useEventListener.ts:32](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L32)
+Defined in: [hooks/useEventListener.ts:32](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L32)
 
 ### See
 
@@ -685,7 +606,7 @@ type UseEventListenerWithExplicitTarget<Target, EventMap> = <T, K>(
 ) => void;
 ```
 
-Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L44)
+Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L44)
 
 ### Type Parameters
 
@@ -693,7 +614,6 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 <thead>
 <tr>
 <th>Type Parameter</th>
-<th>Default type</th>
 </tr>
 </thead>
 <tbody>
@@ -702,11 +622,6 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 
 `Target` _extends_ `EventTarget`
 
-</td>
-<td>
-
-&hyphen;
-
 </td>
 </tr>
 <tr>
@@ -714,11 +629,6 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 
 `EventMap`
 
-</td>
-<td>
-
-`Record`\<`string`, `Event`\>
-
 </td>
 </tr>
 </tbody>
@@ -789,11 +699,13 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 ## UseEventListenerWithAnyExplicitTarget
 
 ```ts
-type UseEventListenerWithAnyExplicitTarget =
-  UseEventListenerWithExplicitTarget<EventTarget>;
+type UseEventListenerWithAnyExplicitTarget = UseEventListenerWithExplicitTarget<
+  EventTarget,
+  Record<string, Event>
+>;
 ```
 
-Defined in: [hooks/useEventListener.ts:56](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L56)
+Defined in: [hooks/useEventListener.ts:56](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L56)
 
 ### See
 
@@ -814,7 +726,7 @@ type UseEventListenerWithImplicitWindowTargetArgs<K> =
     : never;
 ```
 
-Defined in: [hooks/useEventListener.ts:64](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L64)
+Defined in: [hooks/useEventListener.ts:64](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L64)
 
 ### Type Parameters
 
@@ -859,7 +771,7 @@ type UseEventListenerWithExplicitTargetArgs<EventMap, T, K> = [
 ];
 ```
 
-Defined in: [hooks/useEventListener.ts:78](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/hooks/useEventListener.ts#L78)
+Defined in: [hooks/useEventListener.ts:78](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/hooks/useEventListener.ts#L78)
 
 ### Type Parameters
 
@@ -900,27 +812,17 @@ Defined in: [hooks/useEventListener.ts:78](https://github.com/aweebit/react-esse
 
 ---
 
-## RestrictedContext
+## SafeContext
 
 ```ts
-type RestrictedContext<T> =
-  Context<T> extends Provider<T>
-    ? {
-        Provider: Provider<T>;
-        displayName: string;
-      } & Provider<T>
-    : {
-        Provider: Provider<T>;
-        displayName: string;
-      };
+type SafeContext<DisplayName, T> = {
+  [K in `${DisplayName}Context`]: RestrictedContext<T>;
+} & { [K in `use${DisplayName}`]: () => T };
 ```
 
-Defined in: [misc/createSafeContext.ts:18](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/misc/createSafeContext.ts#L18)
+Defined in: [misc/createSafeContext.ts:13](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/misc/createSafeContext.ts#L13)
 
-A React context with a required `displayName` and the obsolete `Consumer`
-property purposefully omitted so that it is impossible to pass the context
-as an argument to `useContext` or `use` (the hook produced with
-[`createSafeContext`](#createsafecontext) should be used instead)
+The return type of [`createSafeContext`](#createsafecontext)
 
 ### Type Parameters
 
@@ -934,6 +836,13 @@ as an argument to `useContext` or `use` (the hook produced with
 <tr>
 <td>
 
+`DisplayName` _extends_ `string`
+
+</td>
+</tr>
+<tr>
+<td>
+
 `T`
 
 </td>
@@ -943,21 +852,32 @@ as an argument to `useContext` or `use` (the hook produced with
 
 ### See
 
-[`createSafeContext`](#createsafecontext)
+[`createSafeContext`](#createsafecontext),
+[`RestrictedContext`](#restrictedcontext)
 
 ---
 
-## SafeContext
+## RestrictedContext
 
 ```ts
-type SafeContext<DisplayName, T> = {
-  [K in `${DisplayName}Context`]: RestrictedContext<T>;
-} & { [K in `use${DisplayName}`]: () => T };
+type RestrictedContext<T> =
+  Context<T> extends Provider<T>
+    ? {
+        Provider: Provider<T>;
+        displayName: string;
+      } & Provider<T>
+    : {
+        Provider: Provider<T>;
+        displayName: string;
+      };
 ```
 
-Defined in: [misc/createSafeContext.ts:30](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/misc/createSafeContext.ts#L30)
+Defined in: [misc/createSafeContext.ts:31](https://github.com/aweebit/react-essentials/blob/v0.9.0/src/misc/createSafeContext.ts#L31)
 
-The return type of [`createSafeContext`](#createsafecontext)
+A React context with a required `displayName` and the obsolete `Consumer`
+property purposefully omitted so that it is impossible to pass the context
+as an argument to `useContext` or `use` (the hook produced with
+[`createSafeContext`](#createsafecontext) should be used instead)
 
 ### Type Parameters
 
@@ -971,13 +891,6 @@ The return type of [`createSafeContext`](#createsafecontext)
 <tr>
 <td>
 
-`DisplayName` _extends_ `string`
-
-</td>
-</tr>
-<tr>
-<td>
-
 `T`
 
 </td>
@@ -987,5 +900,4 @@ The return type of [`createSafeContext`](#createsafecontext)
 
 ### See
 
-[`createSafeContext`](#createsafecontext),
-[`RestrictedContext`](#restrictedcontext)
+[`createSafeContext`](#createsafecontext)

package/dist/hooks/index.d.ts

@@ -1,5 +1,4 @@
 export * from './useEventListener.js';
-export * from './useForceUpdate.js';
 export * from './useReducerWithDeps.js';
 export * from './useStateWithDeps.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/hooks/index.js

@@ -1,5 +1,4 @@
 export * from './useEventListener.js';
-export * from './useForceUpdate.js';
 export * from './useReducerWithDeps.js';
 export * from './useStateWithDeps.js';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/hooks/useEventListener.d.ts

@@ -26,13 +26,13 @@ export type UseEventListenerWithExplicitGlobalTarget = UseEventListenerWithExpli
  * {@linkcode useEventListener},
  * {@linkcode UseEventListenerWithExplicitTargetArgs}
  */
-export type UseEventListenerWithExplicitTarget<Target extends EventTarget, EventMap = Record<string, Event>> = <T extends Target, K extends keyof EventMap>(...args: UseEventListenerWithExplicitTargetArgs<EventMap, T, K>) => void;
+export type UseEventListenerWithExplicitTarget<Target extends EventTarget, EventMap> = <T extends Target, K extends keyof EventMap>(...args: UseEventListenerWithExplicitTargetArgs<EventMap, T, K>) => void;
 /**
  * @see
  * {@linkcode useEventListener},
  * {@linkcode UseEventListenerWithExplicitTarget}
  */
-export type UseEventListenerWithAnyExplicitTarget = UseEventListenerWithExplicitTarget<EventTarget>;
+export type UseEventListenerWithAnyExplicitTarget = UseEventListenerWithExplicitTarget<EventTarget, Record<string, Event>>;
 /**
  * @see
  * {@linkcode useEventListener},

package/dist/hooks/useEventListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEventListener.d.ts","sourceRoot":"","sources":["../../src/hooks/useEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,wCAAwC,GACrE,wCAAwC,GACxC,qCAAqC,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,wCAAwC,GAAG,CACrD,CAAC,SAAS,MAAM,cAAc,EAE9B,GAAG,IAAI,EAAE,4CAA4C,CAAC,CAAC,CAAC,KACrD,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,wCAAwC,GAClD,kCAAkC,CAAC,MAAM,EAAE,cAAc,CAAC,GACxD,kCAAkC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC9D,kCAAkC,CAAC,WAAW,EAAE,mBAAmB,CAAC,GACpE,kCAAkC,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAClE,kCAAkC,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,CAC5C,MAAM,SAAS,WAAW,EAC1B,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC9B,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,QAAQ,EAC7C,GAAG,IAAI,EAAE,sCAAsC,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,KAC5D,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,qCAAqC,GAC/C,kCAAkC,CAAC,WAAW,CAAC,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,4CAA4C,CACtD,CAAC,SAAS,MAAM,cAAc,IAE9B,sCAAsC,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS;IACxE,OAAO;IACP,GAAG,MAAM,IAAI;CACd,GACG,IAAI,GACJ,KAAK,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,sCAAsC,CAChD,QAAQ,EACR,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,MAAM,QAAQ,IACtB;IACF,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;QAAE,gBAAgB,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,GAAG,IAAI;IAChE,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI;IACvD,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,GAAG,SAAS;CACxD,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAoDV,CAAC"}
+{"version":3,"file":"useEventListener.d.ts","sourceRoot":"","sources":["../../src/hooks/useEventListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,wCAAwC,GACrE,wCAAwC,GACxC,qCAAqC,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,wCAAwC,GAAG,CACrD,CAAC,SAAS,MAAM,cAAc,EAE9B,GAAG,IAAI,EAAE,4CAA4C,CAAC,CAAC,CAAC,KACrD,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,wCAAwC,GAClD,kCAAkC,CAAC,MAAM,EAAE,cAAc,CAAC,GACxD,kCAAkC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC9D,kCAAkC,CAAC,WAAW,EAAE,mBAAmB,CAAC,GACpE,kCAAkC,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAClE,kCAAkC,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,CAC5C,MAAM,SAAS,WAAW,EAC1B,QAAQ,IACN,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,QAAQ,EAC7C,GAAG,IAAI,EAAE,sCAAsC,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,KAC5D,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,qCAAqC,GAC/C,kCAAkC,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,4CAA4C,CACtD,CAAC,SAAS,MAAM,cAAc,IAE9B,sCAAsC,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS;IACxE,OAAO;IACP,GAAG,MAAM,IAAI;CACd,GACG,IAAI,GACJ,KAAK,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,sCAAsC,CAChD,QAAQ,EACR,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,MAAM,QAAQ,IACtB;IACF,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;QAAE,gBAAgB,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,GAAG,IAAI;IAChE,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI;IACvD,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,GAAG,SAAS;CACxD,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAoDV,CAAC"}

package/dist/misc/createSafeContext.d.ts

@@ -1,5 +1,17 @@
 import { type Context, type Provider } from 'react';
 import type { ArgumentFallback } from '../utils.js';
+/**
+ * The return type of {@linkcode createSafeContext}
+ *
+ * @see
+ * {@linkcode createSafeContext},
+ * {@linkcode RestrictedContext}
+ */
+export type SafeContext<DisplayName extends string, T> = {
+    [K in `${DisplayName}Context`]: RestrictedContext<T>;
+} & {
+    [K in `use${DisplayName}`]: () => T;
+};
 /**
  * A React context with a required `displayName` and the obsolete `Consumer`
  * property purposefully omitted so that it is impossible to pass the context
@@ -16,18 +28,6 @@ export type RestrictedContext<T> = Context<T> extends Provider<T> ? {
     Provider: Provider<T>;
     displayName: string;
 };
-/**
- * The return type of {@linkcode createSafeContext}
- *
- * @see
- * {@linkcode createSafeContext},
- * {@linkcode RestrictedContext}
- */
-export type SafeContext<DisplayName extends string, T> = {
-    [K in `${DisplayName}Context`]: RestrictedContext<T>;
-} & {
-    [K in `use${DisplayName}`]: () => T;
-};
 /**
  * For a given type `T`, returns a function that produces both a context of that
  * type and a hook that returns the current context value if one was provided,

package/dist/misc/createSafeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSafeContext.d.ts","sourceRoot":"","sources":["../../src/misc/createSafeContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,OAAO,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;;;;GAQG;AAIH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC7B,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAC1B;IAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAC5D;IAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,WAAW,SAAS,MAAM,EAAE,CAAC,IAAI;KACtD,CAAC,IAAI,GAAG,WAAW,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC;CACrD,GAAG;KACD,CAAC,IAAI,MAAM,WAAW,EAAE,GAAG,MAAM,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,KAAK,MACjC,WAAW,SAAS,MAAM,EAChC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC5B,KAAK,GACL,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,KAC/C,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAsB/B"}
+{"version":3,"file":"createSafeContext.d.ts","sourceRoot":"","sources":["../../src/misc/createSafeContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAA6B,MAAM,OAAO,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,WAAW,SAAS,MAAM,EAAE,CAAC,IAAI;KACtD,CAAC,IAAI,GAAG,WAAW,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC;CACrD,GAAG;KACD,CAAC,IAAI,MAAM,WAAW,EAAE,GAAG,MAAM,CAAC;CACpC,CAAC;AAEF;;;;;;;;GAQG;AAIH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC7B,OAAO,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,GAC1B;IAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAC5D;IAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,KAAK,MACjC,WAAW,SAAS,MAAM,EAChC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC5B,KAAK,GACL,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,KAC/C,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAsB/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aweebit/react-essentials",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "repository": "github:aweebit/react-essentials",
   "main": "dist/index.js",

package/src/hooks/index.ts

@@ -1,4 +1,3 @@
 export * from './useEventListener.js';
-export * from './useForceUpdate.js';
 export * from './useReducerWithDeps.js';
 export * from './useStateWithDeps.js';

package/src/hooks/useEventListener.ts

@@ -43,7 +43,7 @@ export type UseEventListenerWithExplicitGlobalTarget =
  */
 export type UseEventListenerWithExplicitTarget<
   Target extends EventTarget,
-  EventMap = Record<string, Event>,
+  EventMap,
 > = <T extends Target, K extends keyof EventMap>(
   ...args: UseEventListenerWithExplicitTargetArgs<EventMap, T, K>
 ) => void;
@@ -54,7 +54,7 @@ export type UseEventListenerWithExplicitTarget<
  * {@linkcode UseEventListenerWithExplicitTarget}
  */
 export type UseEventListenerWithAnyExplicitTarget =
-  UseEventListenerWithExplicitTarget<EventTarget>;
+  UseEventListenerWithExplicitTarget<EventTarget, Record<string, Event>>;
 
 /**
  * @see

package/src/misc/createSafeContext.ts

@@ -3,6 +3,19 @@ import type { ArgumentFallback } from '../utils.js';
 
 const moValueSymbol = Symbol('noValue');
 
+/**
+ * The return type of {@linkcode createSafeContext}
+ *
+ * @see
+ * {@linkcode createSafeContext},
+ * {@linkcode RestrictedContext}
+ */
+export type SafeContext<DisplayName extends string, T> = {
+  [K in `${DisplayName}Context`]: RestrictedContext<T>;
+} & {
+  [K in `use${DisplayName}`]: () => T;
+};
+
 /**
  * A React context with a required `displayName` and the obsolete `Consumer`
  * property purposefully omitted so that it is impossible to pass the context
@@ -20,19 +33,6 @@ export type RestrictedContext<T> =
     ? { Provider: Provider<T>; displayName: string } & Provider<T>
     : { Provider: Provider<T>; displayName: string };
 
-/**
- * The return type of {@linkcode createSafeContext}
- *
- * @see
- * {@linkcode createSafeContext},
- * {@linkcode RestrictedContext}
- */
-export type SafeContext<DisplayName extends string, T> = {
-  [K in `${DisplayName}Context`]: RestrictedContext<T>;
-} & {
-  [K in `use${DisplayName}`]: () => T;
-};
-
 /**
  * For a given type `T`, returns a function that produces both a context of that
  * type and a hook that returns the current context value if one was provided,

package/dist/hooks/useForceUpdate.d.ts

@@ -1,31 +0,0 @@
-/**
- * Enables you to imperatively trigger re-rendering of components
- *
- * This hook is designed in the most general way possible in order to cover all
- * imaginable use cases.
- *
- * @deprecated
- * This hook encourages patterns that are unsafe in Concurrent React.
- * For details and ideas on how to get rid of it, please check the discussion at
- * https://www.reddit.com/r/react/comments/1nqcsri/comment/ng76cv5/.
- *
- * @param callback An optional callback function to call during renders that
- * were triggered with `forceUpdate()`
- *
- * Can be used for conditionally calling state setters when state needs to be
- * reset. That is legal and better than using effects (see
- * {@link https://react.dev/learn/-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes You Might Not Need an Effect > Adjusting some state when a prop changes}),
- * but can often be avoided by using {@linkcode useStateWithDeps} or
- * {@linkcode useReducerWithDeps}.
- *
- * Important: the callback function is called once per render, not once per
- * `forceUpdate` call! If React batches `forceUpdate` calls, then it will only
- * be called once.
- *
- * @returns An array with the following two elements:
- *
- * 1. A `forceUpdate` function that triggers a re-render
- * 2. The number of times `forceUpdate` has been called so far
- */
-export declare function useForceUpdate(callback?: () => void): [() => void, bigint];
-//# sourceMappingURL=useForceUpdate.d.ts.map

package/dist/hooks/useForceUpdate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useForceUpdate.d.ts","sourceRoot":"","sources":["../../src/hooks/useForceUpdate.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,CAAC,CAU1E"}

package/dist/hooks/useForceUpdate.js

@@ -1,43 +0,0 @@
-import { useReducer, useRef } from 'react';
-/* eslint-enable */
-/**
- * Enables you to imperatively trigger re-rendering of components
- *
- * This hook is designed in the most general way possible in order to cover all
- * imaginable use cases.
- *
- * @deprecated
- * This hook encourages patterns that are unsafe in Concurrent React.
- * For details and ideas on how to get rid of it, please check the discussion at
- * https://www.reddit.com/r/react/comments/1nqcsri/comment/ng76cv5/.
- *
- * @param callback An optional callback function to call during renders that
- * were triggered with `forceUpdate()`
- *
- * Can be used for conditionally calling state setters when state needs to be
- * reset. That is legal and better than using effects (see
- * {@link https://react.dev/learn/-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes You Might Not Need an Effect > Adjusting some state when a prop changes}),
- * but can often be avoided by using {@linkcode useStateWithDeps} or
- * {@linkcode useReducerWithDeps}.
- *
- * Important: the callback function is called once per render, not once per
- * `forceUpdate` call! If React batches `forceUpdate` calls, then it will only
- * be called once.
- *
- * @returns An array with the following two elements:
- *
- * 1. A `forceUpdate` function that triggers a re-render
- * 2. The number of times `forceUpdate` has been called so far
- */
-export function useForceUpdate(callback) {
-    // It is very unlikely that the number of updates will exceed
-    // Number.MAX_SAFE_INTEGER, but not impossible. That is why we use bigints.
-    const [updateCount, forceUpdate] = useReducer((prev) => prev + 1n, 0n);
-    const updateCountRef = useRef(updateCount);
-    if (updateCount !== updateCountRef.current) {
-        updateCountRef.current = updateCount;
-        callback?.();
-    }
-    return [forceUpdate, updateCount];
-}
-//# sourceMappingURL=useForceUpdate.js.map

package/dist/hooks/useForceUpdate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useForceUpdate.js","sourceRoot":"","sources":["../../src/hooks/useForceUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAK3C,mBAAmB;AAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,cAAc,CAAC,QAAqB;IAClD,6DAA6D;IAC7D,2EAA2E;IAC3E,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,WAAW,KAAK,cAAc,CAAC,OAAO,EAAE,CAAC;QAC3C,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;QACrC,QAAQ,EAAE,EAAE,CAAC;IACf,CAAC;IACD,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/src/hooks/useForceUpdate.ts

@@ -1,47 +0,0 @@
-import { useReducer, useRef } from 'react';
-
-/* eslint-disable */
-import type { useStateWithDeps } from './useStateWithDeps.js';
-import type { useReducerWithDeps } from './useReducerWithDeps.js';
-/* eslint-enable */
-
-/**
- * Enables you to imperatively trigger re-rendering of components
- *
- * This hook is designed in the most general way possible in order to cover all
- * imaginable use cases.
- *
- * @deprecated
- * This hook encourages patterns that are unsafe in Concurrent React.
- * For details and ideas on how to get rid of it, please check the discussion at
- * https://www.reddit.com/r/react/comments/1nqcsri/comment/ng76cv5/.
- *
- * @param callback An optional callback function to call during renders that
- * were triggered with `forceUpdate()`
- *
- * Can be used for conditionally calling state setters when state needs to be
- * reset. That is legal and better than using effects (see
- * {@link https://react.dev/learn/-might-not-need-an-effect#adjusting-some-state-when-a-prop-changes You Might Not Need an Effect > Adjusting some state when a prop changes}),
- * but can often be avoided by using {@linkcode useStateWithDeps} or
- * {@linkcode useReducerWithDeps}.
- *
- * Important: the callback function is called once per render, not once per
- * `forceUpdate` call! If React batches `forceUpdate` calls, then it will only
- * be called once.
- *
- * @returns An array with the following two elements:
- *
- * 1. A `forceUpdate` function that triggers a re-render
- * 2. The number of times `forceUpdate` has been called so far
- */
-export function useForceUpdate(callback?: () => void): [() => void, bigint] {
-  // It is very unlikely that the number of updates will exceed
-  // Number.MAX_SAFE_INTEGER, but not impossible. That is why we use bigints.
-  const [updateCount, forceUpdate] = useReducer((prev) => prev + 1n, 0n);
-  const updateCountRef = useRef(updateCount);
-  if (updateCount !== updateCountRef.current) {
-    updateCountRef.current = updateCount;
-    callback?.();
-  }
-  return [forceUpdate, updateCount];
-}