docs: add some categories to comments for eventual grouping

Author: jquense

src/useCallbackRef.ts

@@ -21,6 +21,8 @@ import { useState } from 'react'
  *
  * return <div ref={attachRef} />
  * ```
+ *
+ * @category refs
  */
 export default function useCallbackRef<TValue = unknown>(): [
   TValue | null,

src/useImmediateUpdateEffect.ts

@@ -14,6 +14,8 @@ import useStableMemo from './useStableMemo'
  *     setValue(value)
  *   }, [value])
  * ```
+ *
+ * @category effects
  */
 function useImmediateUpdateEffect(effect: () => void, deps: DependencyList) {
   const firstRef = useRef(true)

src/useIsomorphicEffect.ts

@@ -14,5 +14,7 @@ const isDOM = typeof document !== 'undefined'
  * Only useful to avoid the console warning.
  *
  * PREFER `useEffect` UNLESS YOU KNOW WHAT YOU ARE DOING.
+ *
+ * @category effects
  */
 export default isDOM || isReactNative ? useLayoutEffect : useEffect

src/useMergedRefs.ts

@@ -33,6 +33,7 @@ export function mergeRefs<T>(refA?: Ref<T> | null, refB?: Ref<T> | null) {
  *
  * @param refA A Callback or mutable Ref
  * @param refB A Callback or mutable Ref
+ * @category refs
  */
 function useMergedRefs<T>(refA?: Ref<T> | null, refB?: Ref<T> | null) {
   return useMemo(() => mergeRefs(refA, refB), [refA, refB])

src/useUpdatedRef.ts

@@ -4,6 +4,7 @@ import { useRef } from 'react'
  * Returns a ref that is immediately updated with the new value
  *
  * @param value The Ref value
+ * @category refs
  */
 export default function useUpdatedRef<T>(value: T) {
   const valueRef = useRef<T>(value)

src/useWillUnmount.ts

@@ -5,6 +5,7 @@ import { useEffect } from 'react'
  * Attach a callback that fires when a component unmounts
  *
  * @param fn Handler to run when the component unmounts
+ * @category effects
  */
 export default function useWillUnmount(fn: () => void) {
   const onUnmount = useUpdatedRef(fn)

test/useImmediateUpdateEffect.test.tsx

@@ -2,7 +2,7 @@ import useImmediateUpdateEffect from '../src/useImmediateUpdateEffect'
 import { renderHook } from './helpers'
 
 describe('useImmediateUpdateEffect', () => {
-  it('should return a function that returns mount state', () => {
+  it('should run update after value changes', () => {
     const spy = jest.fn()
 
     const [, wrapper] = renderHook(