snapshot of https://github.com/TanStack/query.git (main, 2026-09-16; blobs > 131072B omitted)

docs/framework/lit/reference/functions/useMutationState.md

@@ -0,0 +1,73 @@
+---
+id: useMutationState
+title: useMutationState
+---
+
+```ts
+function useMutationState<TResult>(
+   host,
+   options,
+queryClient?): MutationStateAccessor<TResult>;
+```
+
+Defined in: [packages/lit-query/src/useMutationState.ts:192](https://github.com/TanStack/query/blob/main/packages/lit-query/src/useMutationState.ts#L192)
+
+Creates a Lit reactive controller that selects state from matching mutations
+in the mutation cache.
+
+When `options.filters` is a function, it is re-read during host updates so
+the selection can follow reactive host state. If `queryClient` is omitted,
+the controller resolves the client from the nearest connected
+`QueryClientProvider`.
+
+## Type Parameters
+
+### TResult
+
+`TResult` = [`MutationState`](../interfaces/MutationState.md)\<`unknown`, `unknown`, `unknown`, `unknown`\>
+
+## Parameters
+
+### host
+
+`ReactiveControllerHost`
+
+The Lit reactive controller host that owns the mutation cache
+subscription.
+
+### options
+
+[`MutationStateOptions`](../type-aliases/MutationStateOptions.md)\<`TResult`\> = `{}`
+
+Mutation state filters and optional selector.
+
+### queryClient?
+
+[`QueryClient`](../classes/QueryClient.md)
+
+Optional explicit query client. Provide this for
+controllers that should not resolve a client from Lit context.
+
+## Returns
+
+[`MutationStateAccessor`](../type-aliases/MutationStateAccessor.md)\<`TResult`\>
+
+An accessor for the selected mutation state array.
+
+## Example
+
+```ts
+import { LitElement, html } from 'lit'
+import { useMutationState } from '@tanstack/lit-query'
+
+class PendingUploads extends LitElement {
+  private readonly uploads = useMutationState(this, {
+    filters: { mutationKey: ['upload'], status: 'pending' },
+    select: (mutation) => mutation.state.variables as File,
+  })
+
+  render() {
+    return html`<span>${this.uploads().length} uploads pending</span>`
+  }
+}
+```