fix(vue-query): export queryOptions support types (#11042)

Re-export the helper types that the public queryOptions signature depends
on but that were unreachable from the package roots: ShallowOption and
MaybeRefOrGetter from @tanstack/vue-query, and QueryBehavior, RetryValue,
RetryDelayValue from @tanstack/query-core. The declaration-emit / name
collision core of #11042 was already fixed by #11224; this completes the
remaining unexported-supporting-types part.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: ousamabenyounes

.changeset/export-queryoptions-support-types.md

@@ -0,0 +1,13 @@
+---
+'@tanstack/query-core': patch
+'@tanstack/vue-query': patch
+---
+
+fix(vue-query): export the helper types referenced by `queryOptions`
+
+Re-export from the package roots the supporting types that the public
+`queryOptions` signature depends on but that were previously unreachable:
+`ShallowOption` and `MaybeRefOrGetter` from `@tanstack/vue-query`, and
+`QueryBehavior`, `RetryValue` and `RetryDelayValue` from `@tanstack/query-core`.
+This lets downstream libraries name the inferred `queryOptions` return type in
+their emitted declarations (#11042).

packages/query-core/src/__tests__/publicTypeExports.test-d.ts

@@ -0,0 +1,13 @@
+import { describe, expectTypeOf, it } from 'vitest'
+import type { QueryBehavior, RetryDelayValue, RetryValue } from '..'
+
+// Regression for #11042: the types referenced by the public `queryOptions`
+// signature must be reachable from the package root, otherwise downstream
+// declaration emit cannot name them.
+describe('public type exports', () => {
+  it('re-exports retry and behavior helper types from the package root', () => {
+    expectTypeOf<RetryValue<Error>>().not.toBeNever()
+    expectTypeOf<RetryDelayValue<Error>>().not.toBeNever()
+    expectTypeOf<QueryBehavior>().not.toBeNever()
+  })
+})

packages/query-core/src/index.ts

@@ -23,6 +23,8 @@ export type { QueryCacheNotifyEvent } from './queryCache'
 export { QueryClient } from './queryClient'
 export { QueryObserver } from './queryObserver'
 export { CancelledError, isCancelledError } from './retryer'
+export type { RetryDelayValue, RetryValue } from './retryer'
+export type { QueryBehavior } from './query'
 export {
   timeoutManager,
   type ManagedTimerId,

packages/vue-query/src/__tests__/publicTypeExports.test-d.ts

@@ -0,0 +1,12 @@
+import { describe, expectTypeOf, it } from 'vitest'
+import type { MaybeRefOrGetter, ShallowOption } from '..'
+
+// Regression for #11042: the vue-query helper types referenced by the public
+// `queryOptions` signature must be reachable from the package root so that
+// downstream declaration emit can name them.
+describe('public type exports', () => {
+  it('re-exports vue-query helper types from the package root', () => {
+    expectTypeOf<ShallowOption>().not.toBeNever()
+    expectTypeOf<MaybeRefOrGetter<number>>().not.toBeNever()
+  })
+})

packages/vue-query/src/index.ts

@@ -39,7 +39,7 @@ export type {
   UseInfiniteQueryReturnType,
 } from './useInfiniteQuery'
 export type { UseMutationOptions, UseMutationReturnType } from './useMutation'
-export type { MutationOptions } from './types'
+export type { MaybeRefOrGetter, MutationOptions, ShallowOption } from './types'
 export type { UseQueriesOptions, UseQueriesResults } from './useQueries'
 export type {
   MutationStateOptions,