vue-query: stop shadowing core filter types

[spaansba]

I’m building a wrapper around Vue Query and want to type filters for removeQueries using the same type it accepts:

type RemoveQueryFilters = QueryFilters

I would expect to import QueryFilters from @tanstack/vue-query. Currently, that name refers to the Vue-specific useIsFetching filters instead of Core’s generic QueryFilters.

Could we rename the Vue-specific types, allowing the core types to be re-exported normally? This would avoid importing @tanstack/query-core directly in wrapper packages.

I tested this locally. The type tests, relevant runtime tests, and package build pass.

Happy to open a PR

[mmaxjr]

I can reproduce the naming conflict from the exports.

@tanstack/vue-query first does:

export * from '@tanstack/query-core'

but later exports:

export type { QueryFilters } from './useIsFetching'

and useIsFetching.ts defines that as:

export type QueryFilters = MaybeRefDeep<QF> | (() => MaybeRefDeep<QF>)

So the Vue package is shadowing the core QueryFilters export with a Vue-specific wrapper type. For wrapper/library authors this is a bit surprising, because removeQueries is a QueryClient API and the natural type to import is the core filter shape.

A backwards-compatible path might be:

1. Add a Vue-specific export, for example:

export type UseIsFetchingQueryFilters = MaybeRefDeep<CoreQueryFilters> | (() => MaybeRefDeep<CoreQueryFilters>)

2. Update useIsFetching to use that name internally.
3. Re-export the core QueryFilters normally from @tanstack/query-core.
4. Keep the old Vue QueryFilters name as a deprecated alias for one major/minor cycle if the project wants to avoid an abrupt type-level break.

That would make this import work as expected:

import type { QueryFilters } from '@tanstack/vue-query'

while still keeping the Vue composable-specific filter type available under a name that describes where the extra MaybeRefDeep | function behavior comes from.

I think this is worth a PR, especially if it includes a type test that imports QueryFilters from @tanstack/vue-query and uses it with queryClient.removeQueries(...), plus a separate type test for the Vue-specific useIsFetching filters.

[spaansba]

#11287

[mmaxjr]

Nice, thanks for opening the PR.