Skip to content

Upgrading @vueuse/nuxt 13 to 14

Breaking13.9.0 → 14.4.0Breaking9Platform1Deprecated3New32Changed7Fixed62Other7

BreakingUpgrade verdict

9 breaking changes and a platform requirement change.

  • computedAsync now updates synchronously by default instead of on a later tick.
  • Some previously deprecated shared APIs have been removed.
  • useSwipe no longer exposes the isPassiveEventSupported helper.
  • The package is now built with a different tool, so the built files live in new locations.
Top 5 of 13 that need code or config changes

Installs 34 packages in all (was 51).

Breaking9
Changes computedAsync to default to flush: sync.
computedAsyncflush
Drops some deprecated APIs from shared.
Removes isPassiveEventSupported from useSwipe.
useSwipeisPassiveEventSupported
Migrates to tsdown and moves dist files.
tsdown
Deprecates alias exports in favor of original function names.
Refactors components and makes them consistent.
Makes createSharedComposable return only the sharedComposable on the client side.
createSharedComposable
Changes useClipboard to use readonly() instead of a Computed type assertion.
useClipboardreadonly()Computed
Aligns useThrottleFn with traditional throttle behavior.
useThrottleFn
Platform1
Allows vue-router 5 as a peer dependency.
vue-router
Deprecated3
Deprecates the embedded ResizeObserverSize types.
ResizeObserverSize
Deprecates computedEager.
computedEager
Deprecates watchPausable.
watchPausable

Generated by DepDelta from published .d.ts files. Not mixed with prose notes.

  • removed: interface NuxtConfig
  • removed: interface NuxtOptions
  • removed: property NuxtConfig.vueuse?: VueUseNuxtOptions
  • removed: property NuxtOptions.vueuse?: VueUseNuxtOptions
  • added: const default: import('@nuxt/schema').NuxtModule<VueUseNuxtOptions, VueUseNuxtOptions, false>
  • added: interface VueUseNuxtOptions
  • added: property VueUseNuxtOptions.autoImports?: boolean
  • added: property VueUseNuxtOptions.ssrHandlers?: boolean
  • added: type ModuleOptions = VueUseNuxtOptions
  • added: export { ModuleOptions } from './module'
  • added: export { VueUseNuxtOptions } from './module'
  • added: export { default } from './module'
  • removed: const default: _nuxt_schema.NuxtModule<VueUseNuxtOptions, VueUseNuxtOptions, false>
  • removed: declare module '@nuxt/schema'
  • removed: interface VueUseNuxtOptions
  • removed: property VueUseNuxtOptions.autoImports?: boolean
  • removed: property VueUseNuxtOptions.ssrHandlers?: boolean