docs(vue-query): add JSDoc and generate reference docs with TypeDoc

docs/config.json

@@ -1294,60 +1294,168 @@
           "label": "vue",
           "children": [
             {
-              "label": "useQuery",
-              "to": "framework/vue/reference/useQuery"
+              "label": "Vue Reference",
+              "to": "framework/vue/reference/index"
             },
             {
-              "label": "useQueries",
-              "to": "framework/vue/reference/useQueries"
+              "label": "Functions / useQuery",
+              "to": "framework/vue/reference/functions/useQuery"
+            },
+            {
+              "label": "Functions / useQueries",
+              "to": "framework/vue/reference/functions/useQueries"
+            },
+            {
+              "label": "Functions / useInfiniteQuery",
+              "to": "framework/vue/reference/functions/useInfiniteQuery"
+            },
+            {
+              "label": "Functions / useMutation",
+              "to": "framework/vue/reference/functions/useMutation"
+            },
+            {
+              "label": "Functions / useIsFetching",
+              "to": "framework/vue/reference/functions/useIsFetching"
+            },
+            {
+              "label": "Functions / useIsMutating",
+              "to": "framework/vue/reference/functions/useIsMutating"
+            },
+            {
+              "label": "Functions / useMutationState",
+              "to": "framework/vue/reference/functions/useMutationState"
+            },
+            {
+              "label": "Functions / useQueryClient",
+              "to": "framework/vue/reference/functions/useQueryClient"
+            },
+            {
+              "label": "Functions / queryOptions",
+              "to": "framework/vue/reference/functions/queryOptions"
+            },
+            {
+              "label": "Functions / infiniteQueryOptions",
+              "to": "framework/vue/reference/functions/infiniteQueryOptions"
+            },
+            {
+              "label": "Functions / mutationOptions",
+              "to": "framework/vue/reference/functions/mutationOptions"
+            },
+            {
+              "label": "Functions / usePrefetchQuery",
+              "to": "framework/vue/reference/functions/usePrefetchQuery"
+            },
+            {
+              "label": "Functions / usePrefetchInfiniteQuery",
+              "to": "framework/vue/reference/functions/usePrefetchInfiniteQuery"
+            },
+            {
+              "label": "Classes / MutationCache",
+              "to": "framework/vue/reference/classes/MutationCache"
+            },
+            {
+              "label": "Classes / QueryCache",
+              "to": "framework/vue/reference/classes/QueryCache"
+            },
+            {
+              "label": "Classes / QueryClient",
+              "to": "framework/vue/reference/classes/QueryClient"
+            },
+            {
+              "label": "Types / DefinedInitialDataInfiniteOptions",
+              "to": "framework/vue/reference/type-aliases/DefinedInitialDataInfiniteOptions"
+            },
+            {
+              "label": "Types / DefinedInitialQueryOptions",
+              "to": "framework/vue/reference/type-aliases/DefinedInitialQueryOptions"
+            },
+            {
+              "label": "Types / DefinedInitialQueryOptionsWithDataTag",
+              "to": "framework/vue/reference/type-aliases/DefinedInitialQueryOptionsWithDataTag"
+            },
+            {
+              "label": "Types / MutationFilters",
+              "to": "framework/vue/reference/type-aliases/MutationFilters"
+            },
+            {
+              "label": "Types / MutationOptions",
+              "to": "framework/vue/reference/type-aliases/MutationOptions"
+            },
+            {
+              "label": "Types / MutationStateOptions",
+              "to": "framework/vue/reference/type-aliases/MutationStateOptions"
+            },
+            {
+              "label": "Types / QueryFilters",
+              "to": "framework/vue/reference/type-aliases/QueryFilters"
+            },
+            {
+              "label": "Types / QueryOptions",
+              "to": "framework/vue/reference/type-aliases/QueryOptions"
             },
             {
-              "label": "useInfiniteQuery",
-              "to": "framework/vue/reference/useInfiniteQuery"
+              "label": "Types / UndefinedInitialDataInfiniteOptions",
+              "to": "framework/vue/reference/type-aliases/UndefinedInitialDataInfiniteOptions"
             },
             {
-              "label": "useMutation",
-              "to": "framework/vue/reference/useMutation"
+              "label": "Types / UndefinedInitialQueryOptions",
+              "to": "framework/vue/reference/type-aliases/UndefinedInitialQueryOptions"
             },
             {
-              "label": "useIsFetching",
-              "to": "framework/vue/reference/useIsFetching"
+              "label": "Types / UndefinedInitialQueryOptionsWithDataTag",
+              "to": "framework/vue/reference/type-aliases/UndefinedInitialQueryOptionsWithDataTag"
             },
             {
-              "label": "useIsMutating",
-              "to": "framework/vue/reference/useIsMutating"
+              "label": "Types / UseInfiniteQueryOptions",
+              "to": "framework/vue/reference/type-aliases/UseInfiniteQueryOptions"
             },
             {
-              "label": "useMutationState",
-              "to": "framework/vue/reference/useMutationState"
+              "label": "Types / UseInfiniteQueryReturnType",
+              "to": "framework/vue/reference/type-aliases/UseInfiniteQueryReturnType"
             },
             {
-              "label": "useQueryClient",
-              "to": "framework/vue/reference/useQueryClient"
+              "label": "Types / UseMutationOptions",
+              "to": "framework/vue/reference/type-aliases/UseMutationOptions"
             },
             {
-              "label": "queryOptions",
-              "to": "framework/vue/reference/queryOptions"
+              "label": "Types / UseMutationReturnType",
+              "to": "framework/vue/reference/type-aliases/UseMutationReturnType"
             },
             {
-              "label": "infiniteQueryOptions",
-              "to": "framework/vue/reference/infiniteQueryOptions"
+              "label": "Types / UsePrefetchInfiniteQueryOptions",
+              "to": "framework/vue/reference/type-aliases/UsePrefetchInfiniteQueryOptions"
             },
             {
-              "label": "mutationOptions",
-              "to": "framework/vue/reference/mutationOptions"
+              "label": "Types / UsePrefetchQueryOptions",
+              "to": "framework/vue/reference/type-aliases/UsePrefetchQueryOptions"
+            },
+            {
+              "label": "Types / UseQueriesOptions",
+              "to": "framework/vue/reference/type-aliases/UseQueriesOptions"
+            },
+            {
+              "label": "Types / UseQueriesResults",
+              "to": "framework/vue/reference/type-aliases/UseQueriesResults"
+            },
+            {
+              "label": "Types / UseQueryDefinedReturnType",
+              "to": "framework/vue/reference/type-aliases/UseQueryDefinedReturnType"
+            },
+            {
+              "label": "Types / UseQueryOptions",
+              "to": "framework/vue/reference/type-aliases/UseQueryOptions"
             },
             {
-              "label": "usePrefetchQuery",
-              "to": "framework/vue/reference/usePrefetchQuery"
+              "label": "Types / UseQueryReturnType",
+              "to": "framework/vue/reference/type-aliases/UseQueryReturnType"
             },
             {
-              "label": "usePrefetchInfiniteQuery",
-              "to": "framework/vue/reference/usePrefetchInfiniteQuery"
+              "label": "Types / VueQueryPluginOptions",
+              "to": "framework/vue/reference/type-aliases/VueQueryPluginOptions"
             },
             {
-              "label": "hydration",
-              "to": "framework/vue/reference/hydration"
+              "label": "Variables / VueQueryPlugin",
+              "to": "framework/vue/reference/variables/VueQueryPlugin"
             }
           ]
         },

docs/framework/vue/guides/ssr.md

@@ -256,4 +256,23 @@ On the server, `gcTime` defaults to `Infinity` which disables manual garbage col
 
 To clear the cache after it is not needed and to lower memory consumption, you can add a call to [`queryClient.clear()`](../../../reference/QueryClient/#queryclientclear) after the request is handled and dehydrated state has been sent to the client.
 
+## `dehydrate`/`hydrate` options
+
+`dehydrate` and `hydrate` are re-exported from `@tanstack/query-core`, so they're available directly from `@tanstack/vue-query` — as used throughout this guide.
+
+`dehydrate(client, options?)` accepts a `DehydrateOptions` object:
+
+- `shouldDehydrateMutation: (mutation) => boolean` — whether to dehydrate a given mutation. Called for each mutation in the cache; defaults to only including paused mutations. To extend the default behavior instead of replacing it, import and call `defaultShouldDehydrateMutation` as part of your return statement.
+- `shouldDehydrateQuery: (query) => boolean` — whether to dehydrate a given query. Called for each query in the cache; defaults to only including successful queries (see [above](#only-successful-queries-are-included-in-dehydration)). Extend it the same way, with `defaultShouldDehydrateQuery`.
+- `serializeData?: (data) => any` — transforms (serializes) data during dehydration.
+- `shouldRedactErrors?: (error) => boolean` — only applies to queries still `pending` at dehydration time, whose promise is dehydrated too: decides whether to redact the error if that promise later rejects. Defaults to redacting all such errors. Does **not** apply to `query.state.error` on already-settled queries — that error is included in the dehydrated state as-is, so sanitize it yourself via `shouldDehydrateQuery` if it may contain sensitive data.
+
+`hydrate(client, dehydratedState, options?)` accepts a `HydrateOptions` object:
+
+- `defaultOptions.mutations` — default mutation options for the hydrated mutations.
+- `defaultOptions.queries` — default query options for the hydrated queries.
+- `defaultOptions.deserializeData?: (data) => any` — transforms (deserializes) data before it's put into the cache.
+
+One caveat with `hydrate`: if a query being hydrated already exists in the cache, it's only overwritten when the incoming data is newer than what's already there — otherwise it's silently skipped.
+
 Alternatively, you can set a smaller `gcTime`.

docs/framework/vue/overview.md

@@ -11,6 +11,6 @@ replace: { 'React': 'Vue', 'react-query': 'vue-query' }
 
 ## You talked me into it, so what now?
 
-- Learn Vue Query at your own pace with our amazingly thorough [Walkthrough Guide](./installation) and [API Reference](./reference/useQuery)
+- Learn Vue Query at your own pace with our amazingly thorough [Walkthrough Guide](./installation) and [API Reference](./reference/functions/useQuery)
 
 [//]: # 'Materials'

docs/framework/vue/reactivity.md

@@ -155,7 +155,7 @@ export function useUserProjects(userId: MaybeRef<string>) {
 }
 ```
 
-More details on this option can be found on the [useQuery reference](./reference/useQuery.md) page.
+More details on this option can be found on the [useQuery reference](./reference/functions/useQuery.md) page.
 
 ## Immutability
 

docs/framework/vue/reference/classes/MutationCache.md

@@ -0,0 +1,113 @@
+---
+id: MutationCache
+title: MutationCache
+---
+
+Defined in: [vue-query/src/mutationCache.ts:15](https://github.com/TanStack/query/blob/main/packages/vue-query/src/mutationCache.ts#L15)
+
+Vue-aware subclass of `@tanstack/query-core`'s `MutationCache`. `find`/`findAll` also accept a
+MaybeRefDeep filters object, so `ref`s can be passed directly without unwrapping. Access it via
+`queryClient.getMutationCache()` — `QueryClient` constructs one of these by default.
+
+## Extends
+
+- `MutationCache`
+
+## Constructors
+
+### Constructor
+
+```ts
+new MutationCache(config?): MutationCache;
+```
+
+Defined in: query-core/dist-ts/src/mutationCache.d.ts:47
+
+#### Parameters
+
+##### config?
+
+`MutationCacheConfig`
+
+#### Returns
+
+`MutationCache`
+
+#### Inherited from
+
+```ts
+MC.constructor
+```
+
+## Methods
+
+### find()
+
+```ts
+find<TData, TError, TVariables, TOnMutateResult>(filters): 
+  | Mutation<TData, TError, TVariables, TOnMutateResult>
+  | undefined;
+```
+
+Defined in: [vue-query/src/mutationCache.ts:16](https://github.com/TanStack/query/blob/main/packages/vue-query/src/mutationCache.ts#L16)
+
+#### Type Parameters
+
+##### TData
+
+`TData` = `unknown`
+
+##### TError
+
+`TError` = `Error`
+
+##### TVariables
+
+`TVariables` = `any`
+
+##### TOnMutateResult
+
+`TOnMutateResult` = `unknown`
+
+#### Parameters
+
+##### filters
+
+`MaybeRefDeep`\<`MutationFilters`\<`unknown`, `Error`, `unknown`, `unknown`\>\>
+
+#### Returns
+
+  \| `Mutation`\<`TData`, `TError`, `TVariables`, `TOnMutateResult`\>
+  \| `undefined`
+
+#### Overrides
+
+```ts
+MC.find
+```
+
+***
+
+### findAll()
+
+```ts
+findAll(filters): Mutation<unknown, Error, unknown, unknown>[];
+```
+
+Defined in: [vue-query/src/mutationCache.ts:27](https://github.com/TanStack/query/blob/main/packages/vue-query/src/mutationCache.ts#L27)
+
+#### Parameters
+
+##### filters
+
+`MaybeRefDeep`\<`MutationFilters`\<`unknown`, `Error`, `unknown`, `unknown`\>\> = `{}`
+
+#### Returns
+
+`Mutation`\<`unknown`, `Error`, `unknown`, `unknown`\>[]
+
+#### Overrides
+
+```ts
+MC.findAll
+```