feat(watchPausable): deprecate watchPausable (#5040)

Author: ilyaliao

packages/shared/watchPausable/index.md

@@ -7,6 +7,10 @@ alias: pausableWatch
 
 Pausable watch
 
+::: info
+This function will be removed in future version.
+:::
+
 ::: tip
 
 [Pausable Watcher](https://vuejs.org/api/reactivity-core.html#watch) has been added to Vue [since 3.5](https://github.com/vuejs/core/pull/9651), use `const { stop, pause, resume } = watch(watchSource, callback)` instead.

packages/shared/watchPausable/index.ts

@@ -10,6 +10,9 @@ export interface WatchPausableReturn extends Pausable {
 
 export type WatchPausableOptions<Immediate> = WatchWithFilterOptions<Immediate> & PausableFilterOptions
 
+/**
+ * @deprecated This function will be removed in future version.
+ */
 export function watchPausable<T extends Readonly<WatchSource<unknown>[]>, Immediate extends Readonly<boolean> = false>(sources: [...T], cb: WatchCallback<MapSources<T>, MapOldSources<T, Immediate>>, options?: WatchPausableOptions<Immediate>): WatchPausableReturn
 export function watchPausable<T, Immediate extends Readonly<boolean> = false>(source: WatchSource<T>, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchPausableOptions<Immediate>): WatchPausableReturn
 export function watchPausable<T extends object, Immediate extends Readonly<boolean> = false>(source: T, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchPausableOptions<Immediate>): WatchPausableReturn