vueuse · antfu · Sep 16, 2025 · Aug 14, 2025
diff --git a/packages/core/computedAsync/index.ts b/packages/core/computedAsync/index.ts
@@ -1,4 +1,4 @@
-import type { Fn } from '@vueuse/shared'
+import type { Fn, WatchOptionFlush } from '@vueuse/shared'
 import type { ComputedRef, Ref } from 'vue'
 import { noop } from '@vueuse/shared'
 import {
@@ -44,7 +44,7 @@ export interface AsyncComputedOptions<Lazy = boolean> {
    * It works in the same way as the flush option in watch and watch effect in vue reactivity
    * @default 'pre'
    */
-  flush?: 'pre' | 'post' | 'sync'
+  flush?: WatchOptionFlush
 
   /**
    * Callback when error is caught.

diff --git a/packages/core/useRefHistory/index.md b/packages/core/useRefHistory/index.md
@@ -127,7 +127,7 @@ const refHistory = useRefHistory(target, {
 refHistory.clear() // explicitly clear all the history
 ```
 
-### History Flush Timing
+### History WatchOptionFlush Timing
 
 From [Vue's documentation](https://vuejs.org/guide/essentials/watchers.html#callback-flush-timing): Vue's reactivity system buffers invalidated effects and flush them asynchronously to avoid unnecessary duplicate invocation when there are many state mutations happening in the same "tick".
 

diff --git a/packages/core/useRefHistory/index.ts b/packages/core/useRefHistory/index.ts
@@ -1,4 +1,4 @@
-import type { ConfigurableEventFilter, Fn } from '@vueuse/shared'
+import type { ConfigurableEventFilter, Fn, WatchOptionFlush } from '@vueuse/shared'
 import type { Ref } from 'vue'
 import type { CloneFn } from '../useCloned'
 import type { UseManualRefHistoryReturn } from '../useManualRefHistory'
@@ -23,7 +23,7 @@ export interface UseRefHistoryOptions<Raw, Serialized = Raw> extends Configurabl
    *
    * @default 'pre'
    */
-  flush?: 'pre' | 'post' | 'sync'
+  flush?: WatchOptionFlush
 
   /**
    * Maximum number of history to be kept. Default to unlimited.

diff --git a/packages/shared/syncRefs/index.md b/packages/shared/syncRefs/index.md
@@ -59,7 +59,7 @@ export interface SyncRefOptions {
    *
    * @default 'sync'
    */
-  flush?: WatchOptions['flush']
+  flush?: WatchOptionFlush
   /**
    * Watch deeply
    *

diff --git a/packages/shared/until/index.ts b/packages/shared/until/index.ts
@@ -1,5 +1,5 @@
 import type { MaybeRefOrGetter, WatchOptions, WatchSource } from 'vue'
-import type { ElementOf, ShallowUnwrapRef } from '../utils'
+import type { ElementOf, ShallowUnwrapRef, WatchOptionFlush } from '../utils'
 import { isRef, nextTick, toValue, watch } from 'vue'
 import { promiseTimeout } from '../utils'
 
@@ -24,7 +24,7 @@ export interface UntilToMatchOptions {
    *
    * @default 'sync'
    */
-  flush?: WatchOptions['flush']
+  flush?: WatchOptionFlush
 
   /**
    * `deep` option for internal watch

diff --git a/packages/shared/utils/types.ts b/packages/shared/utils/types.ts
@@ -111,13 +111,15 @@ export interface Stoppable<StartFnArgs extends any[] = any[]> {
   start: (...args: StartFnArgs) => void
 }
 
+export type WatchOptionFlush = WatchOptions['flush']
+
 export interface ConfigurableFlush {
   /**
    * Timing for monitoring changes, refer to WatchOptions for more details
    *
    * @default 'pre'
    */
-  flush?: WatchOptions['flush']
+  flush?: WatchOptionFlush
 }
 
 export interface ConfigurableFlushSync {
@@ -127,7 +129,7 @@ export interface ConfigurableFlushSync {
    *
    * @default 'sync'
    */
-  flush?: WatchOptions['flush']
+  flush?: WatchOptionFlush
 }
 
 // Internal Types

diff --git a/packages/shared/watchIgnorable/index.md b/packages/shared/watchIgnorable/index.md
@@ -41,7 +41,7 @@ source.value = 'logged'
 await nextTick() // logs: Changed to logged!
 ```
 
-## Flush timing
+## WatchOptionFlush timing
 
 `watchIgnorable` accepts the same options as `watch` and uses the same defaults.
 So, by default the composable works using `flush: 'pre'`.