v14.0.0

Compare Source

🚨 Breaking Changes

• Migrate to tsdown, move dist files - by @​9romise and Anthony Fu in #​5004 (a2e2c)
• Deprecate alias exports in favor of original function names - by @​9romise in #​5009 (e5f74)
• Requires Vue 3.5 - by @​antfu (fe458)
• components: Refactor components and make them consistent - by @​ilyaliao in #​4912 (8c521)
• computedAsync: Default to flush: sync - by @​ferferga in #​4752 (573bf)
• createSharedComposable: Return only the sharedComposable on client side - by @​9romise in #​4997 (73aad)
• firebase: Upgrade to firebase v12 - by @​antfu (8cb0b)
• nuxt: Use Nuxt v4 kit - by @​antfu (070fc)
• shared: Drop some deprecated apis - by @​9romise in #​5010 (971b2)
• useClipboard: Use readonly() instead of type assertion Computed - by @​9romise in #​5081 (67812)
• useSwipe: Remove isPassiveEventSupported - by @​pkc918 in #​4886 (620a9)
• useThrottleFn: Align with traditional throttle behavior - by @​IceMooncake and @​ilyaliao in #​4923 (cefd2)

🚀 Features

• computedEager: Deprecate computedEager - by @​ilyaliao in #​5034 (26a7d)
• onClickOutside: Allow the value of target to be a getter - by @​keeplearning66 in #​5098 (7133c)
• onLongPress: Allow function as value in delay - by @​keeplearning66 in #​4979 (415f3)
• refManualReset: New function - by @​phk422, @​OrbisK, @​ilyaliao and Anthony Fu in #​4644 (81bb3)
• useAsyncState: Allow initial value to be a ref - by @​43081j in #​4992 (e38e8)
• useIdle: Implement Stoppable interface - by @​dpbs-715 and Anthony Fu in #​5068 (3f96a)
• useTextSelection: Set initial value for use text selection - by @​kevinluo201 in #​5092 (dbb3e)
• useTransition: Add support for custom interpolator functions - by @​scottbedard and Anthony Fu in #​5011 (cf905)
• watch: Update watch return typo in watchExtractedObservable, watchDebounced, watchDeep, watchImmediate, watchOnce, watchThrottled and watchWithFilter - by @​ArthurDarkstone in #​4896 (b8102)
• watchAtMost: Add pause and resume to return value - by @​ArthurDarkstone in #​4897 (d3176)
• watchPausable: Deprecate watchPausable - by @​ilyaliao in #​5040 (4a28b)

🐞 Bug Fixes

• Update return type of createReusableTemplate and createTemplateP... - by @​ArthurDarkstone in #​4962 (5fd3a)
• Update return types for createTemplatePromise, useMagicKeys, use... - by @​ArthurDarkstone in #​4963 (554b7)
• Update parameter types to use ComponentInternalInstance in lifec... - by @​ArthurDarkstone in #​5060 (a49a3)
• integrations: Use relative import in component.ts - by @​9romise in #​5025 (d5bcd)
• shared: Support provideLocal/injectLocal in vapor mode - by @​ZKunZhang and Zhaokun Zhang in #​5050 (51872)
• tryOnScopeDispose: Add optional failSilently parameter and updat... - by @​ArthurDarkstone and @​ilyaliao in #​5061 (a4862)
• types: Update type casting for watch functions to use WatchSource - by @​ArthurDarkstone in #​4966 (00a72)
• useAsyncState: Track latest execution to avoid newer results being replaced by outdated ones - by @​andreww2012 in #​5047 (3e6cb)
• useFullscreen: Specify return types for request, exit, and enabl... - by @​ArthurDarkstone in #​4965 (8ac73)
• useMagicKeys: Clearing of other keys after releasing alt - by @​NoiseFan in #​5037 (3f113)
• useShare: Improve the accuracy of sharing logic - by @​ArthurDarkstone in #​5048 (61e1b)
• useUrlSearchParams: Restore proper history and navigation behavior - by @​yosong-github and @​ilyaliao in #​4969 (1cff4)
• useUserMedia: Add deep watch to constraints - by @​babu-ch and @​ilyaliao in #​5046 (4b3e9)

View changes on GitHub

v13.9.0

Compare Source

🚀 Features

• onLongPress: Allow function as value in delay - by @​keeplearning66 in #​4979 (415f3)
• useAsyncState: Allow initial value to be a ref - by @​43081j in #​4992 (e38e8)

🐞 Bug Fixes

• types: Update type casting for watch functions to use WatchSource - by @​ArthurDarkstone in #​4966 (00a72)
• useUrlSearchParams: Restore proper history and navigation behavior - by @​yosong-github and @​ilyaliao in #​4969 (1cff4)

View changes on GitHub

v13.8.0

Compare Source

🚀 Features

• useEventSource: Add serializer - by @​imddc and @​ilyaliao in #​4953 (64651)

🏎 Performance

• docs: Replace twoslash with own function for comparing js snippet - by @​serkodev in #​4977 (909fd)
• usePointer: Use shallowRef for better performance - by @​broBinChen and xiaobin in #​4980 (ce09e)
• usePreferredLanguages: Use shallowRef for better performance - by @​ilyaliao in #​4973 (361c8)

View changes on GitHub

v13.7.0

Compare Source

🚨 Breaking Changes

• useAsyncState: Set globalThis.reportError as default onError - by @​kalu5 in #​4951 (f6e88)

🚀 Features

• computedAsync: Use globalThis.reportError as default onError - by @​babu-ch in #​4943 (226a2)
• useClipboardItems: Expose read() - by @​OrbisK in #​4954 (d03b2)
• useDevicePixelRatio: Improve types - by @​doyuli in #​4927 (1b3d4)
• useSpeechSynthesisOptions: Add option onBoundary - by @​pkc918 in #​4960 (c0dca)
• useTimeAgoIntl: Add useTimaAgoIntl - by @​northword and Anthony Fu in #​4821 (81815)

🐞 Bug Fixes

• ci: Avoid duplicate nr update execution in docs:build - by @​serkodev in #​4925 (a73ee)
• useAnimate: Respect immediate: false with conditionally rendered elements - by @​curtgrimes in #​4947 (90c7f)
• useGamepad: Correct type assertion for vibrationActuator - by @​ArthurDarkstone in #​4964 (c5277)
• useStorage: Make sure to always read data if new value is undefined - by @​OrbisK in #​4957 (22116)

🏎 Performance

• twoslash: Optimize twoslash cache - by @​doyuli in #​4939 (93064)
• useMutationObserver: Watch ref directly - by @​VividLemon in #​4940 (01cd9)

View changes on GitHub

v13.6.0

Compare Source

🚀 Features

• Mark templateRef as deprecated - by @​ilyaliao in #​4894 (0271e)
• useFileDialog: Add MaybRef to multiple, accept, capture, reset, and directory - by @​hunterwilhelm, Anthony Fu and @​antfu in #​4813 (a44bd)
• useFocusTrap: Expose updateContainerElements for dynamic contai... - by @​PeikyLiu and @​ilyaliao in #​4849 (3d5e5)
• useIDBKeyval: Add options.serializer - by @​matthewjumpsoffbuildings, @​OrbisK and @​43081j in #​4781 (bb831)
• useStorageAsync: Add onReady option and Promise return - by @​asika32764, Fernando Fernández, @​OrbisK and Anthony Fu in #​4158 (3a2df)
• useTransition: Support custom window - by @​byronogis and Anthony Fu in #​4850 (a75f4)

🐞 Bug Fixes

• onClickOutside: The order of overload signatures - by @​whiteyebrw, @​ilyaliao and Anthony Fu in #​4839 (d5812)
• types: Use Vue's native MaybeRef and MaybeRefOrGetter instead - by @​RYGRIT in #​4913 (2d179)
• useDraggable: Add capture prop to component - by @​wgh970312 in #​4911 (547f8)
• useMagicKeys: Prevent incorrect clearing of other keys after releasing shift - by @​keeplearning66 in #​4916 (d7f28)
• useMouseInElement: Correctly update elementX and elementY - by @​cszhjh and @​ilyaliao in #​4846 (cf02b)
• useVirtualList: Resolve invalid watch source - by @​cszhjh and @​OrbisK in #​4857 (d2381)

View changes on GitHub

v13.5.0

Compare Source

🚀 Features

• useSpeechSynthesis: Add reactivity for volume - by @​whiteyebrw in #​4837 (4d125)

🐞 Bug Fixes

• useCookie: Update universal-cookie range to ^7 || ^8 #​4834

View changes on GitHub

v13.4.0

Compare Source

🚀 Features

• shared: Introduce TimerHandle for setTimeout type - by @​ilyaliao in #​4801 (319d8)
• useAsyncState: Add executeImmediate with the same type as the promise fn - by @​davidglezz in #​4716 (82740)
• useEventSource: Added lastEventId for named events - by @​whiteyebrw in #​4791 (f6f0b)
• useFetch: Support for custom abort reason - by @​doyuli in #​4820 (44c0b)
• useRefHistory: Add shouldCommit - by @​JonathanSchndr, Anthony Fu and Robin in #​4471 (18acf)
• useUrlSearchParams: Add a stringify option for users to provide stringify logic - by @​mingXta, Robin and Anthony Fu in #​4773 (6a523)

🐞 Bug Fixes

• computedWithControl: Allow deeply watching source - by @​MetRonnie and Anthony Fu in #​4786 (ffc1a)
• useDevicesList: Check for device availability before requesting permissions - by @​ilyaliao in #​4818 (c424f)
• useEventListener: Improve types - by @​ArthurDarkstone, liliang18 and @​Alfred-Skyblue in #​4787 (6f565)
• useIdle: Changed the reset call when the initial value is true - by @​whiteyebrw in #​4800 (c6469)
• useMouseInElement: Fixing the issue where target element updates were not considered. - by @​Codfisher and bgm.cod in #​4782 (04af9)
• useScreenSafeArea: Сhanged initial value update - by @​whiteyebrw in #​4789 (ae573)
• useScriptTag: Support passing nonce - by @​1-dilikelei and 董梁玮 in #​4753 (57370)
• useScroll: Use mutationObserver to update arrivedState when the DOM is changed - by @​andylou0102, AndyLuo, Robin and Anthony Fu in #​4433 (135d5)
• watchIgnorable: Add and export types - by @​ArthurDarkstone, liliang18 and Robin in #​4809 (0e10e)

🏎 Performance

• computedWithControl: Optimize with shallowRef - by @​broBinChen and binge_c-admin in #​4826 (2c91a)

View changes on GitHub

v13.3.0

Compare Source

🚀 Features

• useNow: Expose immediate option - by @​scottbedard in #​4768 (44660)

🐞 Bug Fixes

• asyncComputed: Fix types for AsyncComputedOptions - by @​antfu (217cc)
• useFetch: Use globalThis.fetch when defaultWindow.fetch not exist - by @​Groupguanfang, Naily and @​OrbisK in #​4765 (bf354)
• useSortable: Fix type misalignment - by @​michaelcozzolino in #​4760 (16692)

View changes on GitHub

v13.2.0

Compare Source

🚀 Features

• computedAsync: Add option to control watcher's flush timing - by @​ferferga in #​4746 (b1bc8)
• useFileDialog: Allow custom input element for file dialog - by @​ishakhorski in #​4679 (0ea16)
• useScroll: Add missing measure documentation - by @​Matkolit and Mateusz Kołodziej in #​4727 (dd98a)
• useStyleTag: Support passing nonce - by @​1-dilikelei and 董梁玮 in #​4749 (fa2c0)
• watchOnce: Use vue's native once behaviour - by @​ferferga in #​4750 (08f7d)

🐞 Bug Fixes

• Allow vertical scroll in usePointerSwipe - by @​2nofa11 in #​4637 and #​4720 (d3ed6)
• Always mount listeners in useStorage - by @​43081j in #​4730 (65a99)
• UseArrayFindReturn: Missing template type - by @​michaelcozzolino in #​4715 (43903)
• computedAsync: Return ComputedRef<T> type when lazy: true - by @​ferferga in #​4751 (b1718)
• docs: Grammar in /packages/nuxt/README.md - by @​neeko-cat in #​4701 (44b40)
• fromEvent: Fix type error of element reference - by @​ywenhao and @​antfu in #​4728 (94fea)
• onClickOutside: Workaround for iOS - by @​ferferga in #​4735 (1c60c)
• useElementSize: Component type warning - by @​menghany in #​4722 (9889f)
• useEventSource: Add missing data generic - by @​OrbisK in #​4726 (a969e)
• useFullscreen: Get the correct initial state while mounted - by @​ben-lau and liubaobin in #​4745 (09cbd)
• useMagicKeys: Correctly clear current pressed keys when releasing Shift - by @​Kedlingar and Skstud5 in #​4731 (ab7ac)

View changes on GitHub

v13.1.0

Compare Source

🚀 Features

• shared: Ensure return types exists - by @​OrbisK in #​4659 (c1d6e)
• useSortable: Add possibility to use it with Component ref - by @​michaelcozzolino in #​4684 (15917)

🐞 Bug Fixes

• docs: Blog moved to different domain - by @​th1m0 in #​4663 (72c9a)
• nuxt: Don't require @vueuse/core installed at root - by @​danielroe in #​4698 (17a46)
• tryOnMounted: Pass target to getLifeCycleTarget - by @​Eazash in #​4685 (16551)
• useDropZone: Allow passing document as target - by @​osbre in #​4681 (21fa6)

View changes on GitHub

v13.0.0

Compare Source

🚨 Breaking Changes

• Drop CJS build, now it's ESM-only - by @​antfu in #​4581 (5e046)

View changes on GitHub

v12.8.2

Compare Source

🐞 Bug Fixes

• types: Wrong import path - by @​antfu (3f5da)

View changes on GitHub

v12.8.1

Compare Source

🐞 Bug Fixes

• useEventSource: Remove readonly to not be breaking - by @​OrbisK in #​4645 (79fcb)

View changes on GitHub

v12.8.0

Compare Source

🚀 Features

• nuxt: Support wider Nuxt range - by @​antfu (c478e)
• types: Deprecate MaybeRef and MaybeRefOrGetter in favor of Vue's native - by @​ilyaliao and @​antfu in #​4636 (7432f)
• useCached: Add options.deepRefs - by @​OrbisK and @​antfu in #​4591 (9afee)
• useWebSocket: Pass the retried to the autoReconnect.retries - by @​9romise and @​OrbisK in #​4604 (73e6d)

🐞 Bug Fixes

• onStartTyping: Incorrect accepted valid characters - by @​Bernard-Borg in #​4616 (58a3b)
• useAnimate: Correct condition for updating keyframes - by @​Mrlilili and liyan1 in #​4619 (e8665)
• useClipboard: Unhandled rejection on read permission prompt - by @​Vitalis11 in #​4615 (a54c4)
• useCssVar: Update variable when initial - by @​ilyaliao in #​4641 (d680f)
• useDeviceList: AudioInputs doesn't update if camera permission is granted - by @​Nikitatopodin and Никита Быковский in #​4559 (f9685)
• useScroll: Handle negative scroll values - by @​ilyaliao and eavlee in #​4613 (4b7ab)
• useWebSocket: Don't call close() on pongTimeout if connection al... - by @​Azurency in #​4608 (9ba07)

View changes on GitHub

v12.7.0

Compare Source

🚀 Features

• useRafFn: Add once option - by @​btea in #​4583 (3041e)

🐞 Bug Fixes

• useFetch: Partial overwrite when {combination: 'overwrite'} - by @​pkc918 and @​antfu in #​4430 (3ca0d)
• useTextareaAutosize: Improve resize handling with requestAnimationFrame - by @​ilyaliao, Robin and @​antfu in #​4557 (e1a7e)

View changes on GitHub

v12.6.1

Compare Source

No significant changes

View changes on GitHub

v12.6.0

Compare Source

🚀 Features

• createReusableTemplate: Explicit props - by @​antfu in #​4535 (18031)
• onClickOutside: Add controls - by @​sibbng and @​antfu in #​4537 (ab116)
• useDateFormat: Add z...zzzz for timezone information - by @​OrbisK in #​4553 (cd6d7)
• useElementVisibility: Add once options - by @​ilyaliao in #​4577 (f2f94)
• useTimtoutFn,useTimeoutPoll: Align behavior - by @​ilyaliao in #​4543 (64c53)
• watchPausable: Add options.initialState to control the initial active value - by @​OrbisK in #​4533 (ceb56)

🐞 Bug Fixes

• createEventHook: Type check for multiple arguments - by @​isimehmeti and @​ilyaliao in #​4555 (636b8)
• nuxt: Check if packages exist in any layer - by @​dgrayvold in #​4571 (45e5c)
• reactiveComputed: Computed fn should be ComputedGetter - by @​OrbisK in #​4528 (bea31)
• useAnimate: Clear animate when element is gone - by @​babu-ch in #​4579 (1a934)
• useCountdown: start() should accept a custom initial value - by @​ralacerda in #​4554 (93591)
• useCssVar: New Behavior - by @​ilyaliao and OrbisK in #​4500 (d5dd8)
• useMouse: Check for MouseEvent instead of Touch to work with FF - by @​OrbisK and @​antfu in #​4457 (ce9e5)
• useSpeechRecognition: Improve start and stop method behavior - by @​ilyaliao in #​4565 (4f104)

View changes on GitHub

v12.5.0

Compare Source

🚀 Features

• More passive event handlers - by @​ferferga in #​4484 (eddbf)
• Use useEventListener where it was not being used - by @​ferferga in #​4479 (c6c6e)
• useClipboard: Should fall back to legacy clipboard when read/write fails - by @​OrbisK in #​4512 (01acd)
• useCountdown: New function - by @​rtugeek, @​huang-julien, Anthony Fu and @​antfu in #​4125 (69ced)
• useEventListener: Make all parameters arrayable and reactive - by @​ferferga in #​4486 (caf08)
• useFetch: Add parameters to the afterFetch and onFetchError - by @​tolking and Anthony Fu in #​4499 (98a83)
• useFileDialog: Add initialFiles option - by @​EvgenyWas in #​4509 (8a8d6)

🐞 Bug Fixes

• debounceFilter: Invoke on maxWait with the latest invoker - by @​43081j and @​OrbisK in #​4497 (48e0a)
• useMagicKeys: Fix key order issue on first use - by @​babu-ch in #​4505 (b6947)
• useVirtualList: Allow readonly arrays as input - by @​RebeccaStevens in #​4504 (f3cc7)

View changes on GitHub

v12.4.0

Compare Source

🚀 Features

• Use passive event handlers everywhere is possible - by @​ferferga and @​antfu in #​4477 (dd316)
• useCloned: Return isModified - by @​pkc918 and @​antfu in #​4470 (6018c)
• useStorage: Make storage key reactive - by @​EvgenyWas and @​antfu in #​4464 (eb679)

🐞 Bug Fixes

• useBluetooth: IsConnected state not changed when disconnected - by @​ilyaliao, @​antfu and @​ferferga in #​4460 (fcc6e)

View changes on GitHub

v12.3.0

Compare Source

🚀 Features

• onElementRemoval: New function, refactor useActiveElement useElementHover - by @​ben-lau and @​antfu in #​4410 (08cf5)
• router: Support partial transform - by @​alexchexes and @​antfu in #​4426 (bba3f)
• toArray: New utility function - by @​coderwhytop and @​antfu in #​4432 (021d0)
• toValue: Deprecate toValue from @vueuse/shared in favor of Vue's native - by @​antfu (59f75)
• useElementBounding: Added directive for vElementBounding - by @​pkc918 in #​4436 (67a9c)
• useMouseInElement: Added directive for vMouseInElement - by @​pkc918 in #​4438 (34be5)
• useMousePressed: Add onPressed and onReleased as options - by @​OrbisK in #​4425 (a123a)
• useToNumber: method support custom function - by @​btea and @​antfu in #​4441 (635bb)
• useWindowScroll: Use useScroll under the hood - by @​OrbisK and @​antfu in #​4424 (a033e)

🐞 Bug Fixes

• useAxios: Narrow type of data when initialValue is provided - by @​huang-julien and @​antfu in #​4419 (8502f)
• useClipboard,useClipboardItems: Avoid running "copied" timeout during initialization - by @​Ingramz in #​4299 (6860f)
• useDropZone: Validate all file types individually when dropping multiple files - by @​LouisMazel in #​4325 (b01cf)
• useFocusWithin: Correctly track the state when switching the focus of elements in the same container - by @​ben-lau in #​4394 (3ca0d)
• useRouteQuery: Differentiate undefined and null when writing value - by @​aa-ndrej and @​antfu in #​4382 [(0cc45)</