Skip to main content

ChangeLog

1.0.0 (September 18 ,2022)​

Core​

  • Initial public release

1.0.2 (September 20 ,2022)​

Core​

  • add useActiveElement
  • add useDraggable

1.0.3 (September 20 ,2022)​

Core​

  • add useElemenBounding hook

1.0.4 (September 22 ,2022)​

Core​

  • add useElementVisibility hook
  • add useWindowsFocus hook

1.0.5 (September 24 ,2022)​

Core​

  • add useWindowScroll
  • add useWindowSize

1.0.6(September 24 ,2022)​

Core​

  • fix useWindowScroll error

1.0.7(September 28, 2022)​

Core​

  • add useClickOutside
  • add useClipboard
  • add useCycleList
  • refactor(useMediaQuery): rewrite with uses

1.1.2(Jan 20, 2023)​

Core​

  • add useFocus

1.1.3(Jan 21, 2023)​

Core​

  • add useControlled

2.0.0(March 4, 2023)​

Core​

  • fixed some ssr error
  • add useScrollIntoView
  • add useSticky
  • add useReducedMotion

2.0.1(March 4, 2023)​

Core​

  • fixed some ssr error
  • fixed some test

2.2.0(March 8, 2023)​

Core​

  • fixed some ssr error
  • fixed some test

2.2.2(March 10, 2023)​

Core​

  • add test for useActiveElement
  • fix bug in useDarkMode
  • add Option ignoreDefault in useLocalStorage and useSessionStorage

2.2.3(March 14, 2023)​

Core​

  • fix bug in useDarkMode
  • delete option ignoreDefault in useLocalStorage and useSessionStorage
  • add option csrData in useLocalStorage and useSessionStorage

2.2.4(March 30, 2023)​

Core​

  • add useCountDown Hook

2.2.5(April 6, 2023)​

Core​

  • add useSupported
  • add useTextSelection
  • add useEyeDropper

2.2.6(May 8, 2023)​

Core​

  • fix esm import error

2.2.9(Jul 6, 2023)​

Core​

  • add useSetState
  • add useMeasure

3.0.0(Jul 7, 2023)​

Core​

Breaking Change​

  • Dynamic dom element passing parameters is now supported

3.0.1(Jul 18, 2023)​

Core​

  • useMediaDevices support request permissons, and change return result to array.

3.0.2(Jul 18, 2023)​

Core​

  • fix useMediaDevices in firefox.

3.0.3(Jul 18, 2023)​

Core​

  • fix useMediaDevices when create default value;

4.0.0(Ju1 22, 2023)​

Core​

Breaking Changes​

  • options are now consider reference immutable.

4.0.1(Ju1 26, 2023)​

Core​

  • fix useClickOutside.

4.0.3(Ju1 26, 2023)​

Core​

  • fix useElementVisibility
  • fix external deps

4.0.6(Aug 27, 2023)​

Core​

  • feat: add useHover hook

4.0.7(Sep 3, 2023)​

Core​

  • feat: add useCssVar, useScreenSafeArea

4.0.8(Sep 21, 2023)​

Core​

  • usePermission: Do not fail on Safari 15

  • move types package to devDeps

4.0.9(Oct 07, 2023)​

Core​

  • feat: add useWebNotification

4.0.10(Oct 08, 2023)​

Core​

  • feat: add useLocationSelector

4.0.11(Jan 09, 2024)​

Core​

  • perf: reduce useWindowSize re-render

5.0.0(Feb 05, 2024)​

Website​

  • New website
  • Use comments when generating the types of APIs.

Breaking Change​

  • Element target support dropped
  • For a complex object passed in, adopt deep comparison when used in an effect.
  • Delete useControlled and useVirtualList

5.0.1(Feb 22, 2024)​

Core​

  • fix(useLocalStorage): remove defaultValue in deps

5.0.2(Feb 22, 2024)​

Core​

  • fix(useDraggable): remove max call effect.

5.0.3(Feb 22, 2024)​

Core​

  • feat(useDraggable): add container boundary

5.0.4(Feb 22, 2024)​

Core​

  • fix(useLocalStorage): use useDeepCompareEffect

5.0.5(Feb 22, 2024)​

Core​

  • feat(useDraggable): improve boundary for scroll container

5.0.6(Feb 28, 2024)​

Core​

  • feat(useDraggable): support mannual set position

5.0.7(March 01, 2024)​

Core​

  • restore target element
  • feat(useClickOutSide): support enable prop

5.0.8(March 12, 2024)​

Core​

  • fix(useWindowScroll): ssr error

5.0.9(March 17, 2024)​

Core​

  • add usePlatform
  • add useMobileLandscape

5.0.10(March 17, 2024)​

Core​

  • add deps in usePlatform useCallback

5.0.11(April 12, 2024)​

Core​

  • Fixed the issue where useOnceEffect does not execute the cleanup function

5.0.12(April 28, 2024)​

Core​

  • support Pauseble with useInterval

5.0.13(April 29, 2024)​

Core​

  • useFileDialog: add files return in open
  • docs: fix search

5.0.14(May 17, 2024)​

Core​

  • fix(useLocalStorage): remove extra render caused by diff default value

5.0.15(June 05, 2024)​

Core​

  • feat: add useDisclosure
  • feat: add useEventSource
  • feat: add useControlled

5.0.16(July 15, 2024)​

Core​

  • feat: add useMergedRefs

5.0.17(July 16, 2024)​

Core​

  • feat: add use polyfill

5.0.18(July 17, 2024)​

Core​

  • fix: add useGeolocation navigator support check

5.0.19(July 25, 2024)​

Core​

  • feat: add usePreferredLanguages
  • feat: add useBroadcastChannel
  • feat: add useDevicePixelRatio
  • feat: add useElementByPoint
  • feat: add useQRCode
  • fix next.js import error: SyntaxError: Named export 'a' not found. The requested module './index-client-Qon46B4S.js' is a CommonJS module, which may not support all module.exports as named exports.. which caused by use client with bunchee;

5.0.20(Aug 12, 2024)​

  • fix(useActiveElement): add init state

5.0.21(Aug 16, 2024)​

  • feat(useLocalStorage): deprecated effectStorageValue, rename to mountStorageValue. add listenToStorageChanges option, default to true

5.0.23(Nov 11, 2024)​

  • feat: add useFetchEventSource

6.0.0(Dec 20, 2024)​

Breaking Changes​

Modified the runtime behavior of the following hooks to ensure concurrent mode safety:

  • useActiveElement
  • useCustomCompareEffect
  • useDarkMode
  • useLatest
  • usePrevious
  • useMouse

Warning: These changes will affect your applications. Using unstable references as prop parameters in these hooks may trigger infinite React re-renders, since these props are now included in the hooks' dependency arrays.

All DOM parameter passing now requires a stable reference. When using SSR mode, you might commonly pass functions like () => window. Make sure to extract these functions to the outer scope to maintain a stable reference, for example:

If you're passing DOM parameters using refs, you don't need to worry about this issue since refs always maintain stable references.

// Don't do this:
function Component() {
  useHook(() => window)
}

// Do this instead:
const getWindow = () => window
function Component() {
  useHook(getWindow)
}

Chore​

List React19 as Dependency.

6.0.2(May 06, 2025)​

Core​

  • fix(react native): Property 'document' doesn't exist.

6.0.3(May 23, 2025)​

Core​

  • fix(useEventSource): improve EventSource connection handling

6.0.4(Jul 02, 2025)​

Core​

  • fix(useClipboard): immediately access clipboard

6.0.5(Jul 03, 2025)​

Core​

  • fix(useClipboard): add document focus check
ads via Carbon Billing infrastructure that scales with your team, without slowing you down. Try Metronome today.
ads via Carbon