docs: deprecate useLatest, recommend useLatestRef

docs/useLatest.md

@@ -4,6 +4,8 @@ React state hook that returns the latest state as described in the [React hooks
 
 This is mostly useful to get access to the latest value of some props or state inside an asynchronous callback, instead of that value at the time the callback was created from.
 
+Note: This hook updates the ref value during rendering, and is therefore potentially unsafe. Use `useLatestRef()` if you want to safely access the latest value. For more information, see "Pitfall" section of [React `useRef()` docs](https://react.dev/reference/react/useRef).
+
 ## Usage
 
 ```jsx

src/useLatest.ts

@@ -1,5 +1,8 @@
 import { useRef } from 'react';
 
+/**
+ * @deprecated Use `useLatestRef` instead
+ */
 const useLatest = <T>(value: T): { readonly current: T } => {
   const ref = useRef(value);
   ref.current = value;