@aweebit/react-essentials 0.8.1 → 0.10.0

package/README.md

@@ -2,29 +2,15 @@
 
 [![NPM Version](https://img.shields.io/npm/v/%40aweebit%2Freact-essentials)](https://www.npmjs.com/package/@aweebit/react-essentials)
 
-### Requirements
-
-- React ≥ 18
-- TypeScript ≥ 5.4
-
-### Functions
-
 - [useEventListener()](#useeventlistener)
-- [useForceUpdate()](#useforceupdate)
 - [useReducerWithDeps()](#usereducerwithdeps)
 - [useStateWithDeps()](#usestatewithdeps)
 - [createSafeContext()](#createsafecontext)
 
-### Types
+### Requirements
 
-- [UseEventListener](#useeventlistener-1)
-- [UseEventListenerWithImplicitWindowTarget](#useeventlistenerwithimplicitwindowtarget)
-- [UseEventListenerWithExplicitTarget](#useeventlistenerwithexplicittarget)
-- [UseEventListenerWithAnyExplicitTarget](#useeventlistenerwithanyexplicittarget)
-- [UseEventListenerWithImplicitWindowTargetArgs](#useeventlistenerwithimplicitwindowtargetargs)
-- [UseEventListenerWithExplicitTargetArgs](#useeventlistenerwithexplicittargetargs)
-- [RestrictedContext](#restrictedcontext)
-- [SafeContext](#safecontext)
+- React ≥ 18
+- TypeScript ≥ 5.4
 
 ## useEventListener
 
@@ -32,7 +18,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.10.0/src/hooks/useEventListener.ts#L135)
 
 Adds `handler` as a listener for the event `eventName` of `target` with the
 provided `options` applied
@@ -73,78 +59,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 +69,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.10.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 +212,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.10.0/src/hooks/useStateWithDeps.ts#L62)
 
 `useState` hook with an additional dependency array `deps` that resets the
 state to `initialState` when dependencies change
@@ -427,10 +341,12 @@ Dependencies that reset the state to `initialState`
 ```ts
 function createSafeContext<T>(): <DisplayName>(
   displayName,
-) => SafeContext<DisplayName, T>;
+) => { [K in `${string}Context`]: Context<T> } & {
+  [K in `use${string}`]: () => 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:62](https://github.com/aweebit/react-essentials/blob/v0.10.0/src/misc/createSafeContext.ts#L62)
 
 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,
@@ -516,7 +432,7 @@ A function that accepts a single string argument `displayName` (e.g.
   current context value if one was provided, or throws an error otherwise
 
 ```ts
-<DisplayName>(displayName): SafeContext<DisplayName, T>;
+<DisplayName>(displayName): { [K in `${string}Context`]: Context<T> } & { [K in `use${string}`]: () => T };
 ```
 
 #### Type Parameters
@@ -565,11 +481,7 @@ A function that accepts a single string argument `displayName` (e.g.
 
 #### Returns
 
-[`SafeContext`](#safecontext)\<`DisplayName`, `T`\>
-
-### See
-
-[`SafeContext`](#safecontext)
+``{ [K in `${string}Context`]: Context<T> }`` & ``{ [K in `use${string}`]: () => T }``
 
 ---
 
@@ -581,7 +493,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.10.0/src/hooks/useEventListener.ts#L12)
 
 The type of [`useEventListener`](#useeventlistener-1)
 
@@ -600,7 +512,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.10.0/src/hooks/useEventListener.ts#L21)
 
 ### Type Parameters
 
@@ -668,7 +580,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.10.0/src/hooks/useEventListener.ts#L32)
 
 ### See
 
@@ -685,7 +597,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.10.0/src/hooks/useEventListener.ts#L44)
 
 ### Type Parameters
 
@@ -693,7 +605,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 +613,6 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 
 `Target` _extends_ `EventTarget`
 
-</td>
-<td>
-
-&hyphen;
-
 </td>
 </tr>
 <tr>
@@ -714,11 +620,6 @@ Defined in: [hooks/useEventListener.ts:44](https://github.com/aweebit/react-esse
 
 `EventMap`
 
-</td>
-<td>
-
-`Record`\<`string`, `Event`\>
-
 </td>
 </tr>
 </tbody>
@@ -789,11 +690,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.10.0/src/hooks/useEventListener.ts#L56)
 
 ### See
 
@@ -814,7 +717,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.10.0/src/hooks/useEventListener.ts#L64)
 
 ### Type Parameters
 
@@ -859,7 +762,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.10.0/src/hooks/useEventListener.ts#L78)
 
 ### Type Parameters
 
@@ -897,95 +800,3 @@ Defined in: [hooks/useEventListener.ts:78](https://github.com/aweebit/react-esse
 ### See
 
 [`useEventListener`](#useeventlistener-1)
-
----
-
-## RestrictedContext
-
-```ts
-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:18](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/misc/createSafeContext.ts#L18)
-
-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
-
-<table>
-<thead>
-<tr>
-<th>Type Parameter</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>
-
-`T`
-
-</td>
-</tr>
-</tbody>
-</table>
-
-### See
-
-[`createSafeContext`](#createsafecontext)
-
----
-
-## SafeContext
-
-```ts
-type SafeContext<DisplayName, T> = {
-  [K in `${DisplayName}Context`]: RestrictedContext<T>;
-} & { [K in `use${DisplayName}`]: () => T };
-```
-
-Defined in: [misc/createSafeContext.ts:30](https://github.com/aweebit/react-essentials/blob/v0.8.1/src/misc/createSafeContext.ts#L30)
-
-The return type of [`createSafeContext`](#createsafecontext)
-
-### Type Parameters
-
-<table>
-<thead>
-<tr>
-<th>Type Parameter</th>
-</tr>
-</thead>
-<tbody>
-<tr>
-<td>
-
-`DisplayName` _extends_ `string`
-
-</td>
-</tr>
-<tr>
-<td>
-
-`T`
-
-</td>
-</tr>
-</tbody>
-</table>
-
-### See
-
-[`createSafeContext`](#createsafecontext),
-[`RestrictedContext`](#restrictedcontext)

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,33 +1,5 @@
-import { type Context, type Provider } from 'react';
+import { type Context } from 'react';
 import type { ArgumentFallback } from '../utils.js';
-/**
- * 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
- * {@linkcode createSafeContext} should be used instead)
- *
- * @see
- * {@linkcode createSafeContext}
- */
-export type RestrictedContext<T> = Context<T> extends Provider<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,
@@ -83,9 +55,6 @@ export type SafeContext<DisplayName extends string, T> = {
  * - ``` `${displayName}Context` ``` (e.g. `DirectionContext`): the context
  * - ``` `use${displayName}` ``` (e.g. `useDirection`): a hook that returns the
  *   current context value if one was provided, or throws an error otherwise
- *
- * @see
- * {@linkcode SafeContext}
  */
-export declare function createSafeContext<T = never>(): <DisplayName extends string>(displayName: [T] extends [never] ? never : ArgumentFallback<DisplayName, never, string>) => SafeContext<DisplayName, T>;
+export declare function createSafeContext<T = never>(): <DisplayName extends string>(displayName: [T] extends [never] ? never : ArgumentFallback<DisplayName, never, string>) => { [K in `${DisplayName}Context`]: Context<T>; } & { [K in `use${DisplayName}`]: () => T; };
 //# sourceMappingURL=createSafeContext.d.ts.map

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,EAA6B,MAAM,OAAO,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;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,GAAG,CAAC,IAAI,GAAG,WAAW,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAE,GAAG,GACjD,CAAC,IAAI,MAAM,WAAW,EAAE,GAAG,MAAM,CAAC,GACpC,CAsBF"}

package/dist/misc/createSafeContext.js

@@ -55,9 +55,6 @@ const moValueSymbol = Symbol('noValue');
  * - ``` `${displayName}Context` ``` (e.g. `DirectionContext`): the context
  * - ``` `use${displayName}` ``` (e.g. `useDirection`): a hook that returns the
  *   current context value if one was provided, or throws an error otherwise
- *
- * @see
- * {@linkcode SafeContext}
  */
 export function createSafeContext() {
     return (displayName) => {

package/dist/misc/createSafeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSafeContext.js","sourceRoot":"","sources":["../../src/misc/createSafeContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAG/E,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAgCxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CACL,WAEgD,EACnB,EAAE;QAC/B,MAAM,WAAW,GAAG,GAAG,WAA0B,SAAkB,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,WAA0B,EAAW,CAAC;QAE7D,MAAM,OAAO,GAAG,aAAa,CAA2B,aAAa,CAAC,CAAC;QACvE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAElC,OAAO;YACL,CAAC,WAAW,CAAC,EAAE,OAA+B;YAC9C,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClC,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW,qBAAqB,CAAC,CAAC;gBAC1D,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SAKF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createSafeContext.js","sourceRoot":"","sources":["../../src/misc/createSafeContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGhE,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CACL,WAEgD,EAGhD,EAAE;QACF,MAAM,WAAW,GAAG,GAAG,WAA0B,SAAkB,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,WAA0B,EAAW,CAAC;QAE7D,MAAM,OAAO,GAAG,aAAa,CAA2B,aAAa,CAAC,CAAC;QACvE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAElC,OAAO;YACL,CAAC,WAAW,CAAC,EAAE,OAAqB;YACpC,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE;gBACf,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;gBAClC,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW,qBAAqB,CAAC,CAAC;gBAC1D,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;SAKF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aweebit/react-essentials",
-  "version": "0.8.1",
+  "version": "0.10.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

@@ -1,38 +1,8 @@
-import { type Context, type Provider, createContext, useContext } from 'react';
+import { type Context, createContext, useContext } from 'react';
 import type { ArgumentFallback } from '../utils.js';
 
 const moValueSymbol = Symbol('noValue');
 
-/**
- * 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
- * {@linkcode createSafeContext} should be used instead)
- *
- * @see
- * {@linkcode createSafeContext}
- */
-// The type is conditional so that both React 18 and 19 are correctly supported.
-// The code duplication is necessary for the type to be displayed correctly by
-// TypeDoc.
-export type RestrictedContext<T> =
-  Context<T> extends Provider<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,
@@ -88,16 +58,15 @@ export type SafeContext<DisplayName extends string, T> = {
  * - ``` `${displayName}Context` ``` (e.g. `DirectionContext`): the context
  * - ``` `use${displayName}` ``` (e.g. `useDirection`): a hook that returns the
  *   current context value if one was provided, or throws an error otherwise
- *
- * @see
- * {@linkcode SafeContext}
  */
 export function createSafeContext<T = never>() {
   return <DisplayName extends string>(
     displayName: [T] extends [never]
       ? never
       : ArgumentFallback<DisplayName, never, string>,
-  ): SafeContext<DisplayName, T> => {
+  ): { [K in `${DisplayName}Context`]: Context<T> } & {
+    [K in `use${DisplayName}`]: () => T;
+  } => {
     const contextName = `${displayName as DisplayName}Context` as const;
     const hookName = `use${displayName as DisplayName}` as const;
 
@@ -105,7 +74,7 @@ export function createSafeContext<T = never>() {
     Context.displayName = contextName;
 
     return {
-      [contextName]: Context as RestrictedContext<T>,
+      [contextName]: Context as Context<T>,
       [hookName]: () => {
         const value = useContext(Context);
         if (value === moValueSymbol) {
@@ -114,7 +83,7 @@ export function createSafeContext<T = never>() {
         return value;
       },
     } as {
-      [K in typeof contextName]: RestrictedContext<T>;
+      [K in typeof contextName]: Context<T>;
     } & {
       [K in typeof hookName]: () => T;
     };

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];
-}