use-good-hooks 1.0.42 → 1.0.43

package/README.md

@@ -608,6 +608,28 @@ const DelayedComponent = () => {
 - `setLate`: A function to update the state after the specified delay. It can also accept a second boolean argument to update the state immediately.
 - `cancel`: A function to cancel a pending state update.
 
+### `useUnmount`
+
+Runs a callback when the component unmounts for real. React's Strict Mode simulates an unmount right after mount (cleanup, then setup again on the same instance); a plain `useEffect` cleanup fires there too, which aborts in-flight requests or tears down subscriptions that the remount never rebuilds. `useUnmount` defers the callback by one microtask and cancels it if the effect is set up again, so only the real unmount reaches it. The latest callback is always the one called.
+
+```typescript
+import useUnmount from 'use-good-hooks/use-unmount';
+
+const Subscriber = ({ channel }) => {
+  const controller = useRef(new AbortController());
+
+  useUnmount(() => {
+    controller.current.abort();
+  });
+
+  return <p>Listening to {channel}</p>;
+};
+```
+
+#### Parameters
+
+- `fn`: The callback to run on unmount. It is called once, one microtask after the real unmount, and never on a Strict Mode remount.
+
 ## 🧪 Running Tests
 
 This library is thoroughly tested with Vitest and React Testing Library. To run the tests:

package/dist/use-unmount.d.ts

@@ -0,0 +1,4 @@
+declare const useUnmount: (fn: () => void) => void;
+export default useUnmount;
+
+export { }

package/dist/use-unmount.js

@@ -0,0 +1,14 @@
+import { useRef as u, useEffect as n } from "react";
+const s = (e) => {
+  const t = u(e), r = u(!1);
+  n(() => {
+    t.current = e;
+  }, [e]), n(() => (r.current = !1, () => {
+    r.current = !0, queueMicrotask(() => {
+      r.current && t.current();
+    });
+  }), []);
+};
+export {
+  s as default
+};

package/package.json

@@ -50,5 +50,5 @@
 		"test:coverage": "vitest --coverage --run",
 		"test:watch": "vitest"
 	},
-	"version": "1.0.42"
+	"version": "1.0.43"
 }