This section documents version-specific API changes — prioritize recent major/minor releases.
-
BREAKING: Requires Vue 3.5 — v14 now requires Vue 3.5+ for native performance optimizations source
-
BREAKING: useThrottleFn alignment — v14 aligned with traditional throttle behavior (leading: true, trailing: false by default) source
-
BREAKING: ESM-only — v13 dropped CJS build support, package is now ESM-only source
-
BREAKING: createSharedComposable return — v14 now returns only the sharedComposable instance on the client side source
-
NEW: refManualReset — new function in v14 for creating refs with an explicit reset() method source
-
NEW: watchAtMost controls — v14 added pause, resume, and count to the return value source
-
NEW: tryOnScopeDispose — v14 added optional failSilently parameter to suppress errors outside of scope source
-
NEW: useArrayReduce type — v14.1.0 now exports the UseArrayReduceReturn type source
-
NEW: computedWithControl sources — v14.1.0 allows different types in watch sources array source
-
DEPRECATED: computedEager — v14 deprecated in favor of Vue 3.5's native computed optimizations source
-
DEPRECATED: watchPausable — v14 deprecated in favor of Vue's built-in watch or pausableFilter source
-
DEPRECATED: Alias exports — v14 deprecated secondary names like ignorableWatch in favor of primary watchIgnorable source
-
DEPRECATED: eagerComputed — v14 deprecated alias in favor of computedEager source
-
DEPRECATED: controlledComputed — v14 deprecated alias in favor of computedWithControl source
-
Prefer Vue 3.4+ built-in computed() over computedEager() — standard computed properties now only trigger dependencies if the return value actually changes, making eager evaluation unnecessary source
-
Use createSharedComposable() for SSR-safe state sharing — it automatically falls back to non-shared instances during SSR to prevent cross-request state pollution, while maintaining a singleton on the client source
-
Share state within the same component using provideLocal() and injectLocal() — allows accessing provided values without going through the parent/child boundary, now with full Vapor mode support source
-
Replace manual watchers with until() for one-time async conditions — provides a promise-based API for flow control that resolves once a ref meets a specific requirement, reducing callback nesting
