Merge remote-tracking branch 'origin/main' into refactor/resolveValueOrFunction

Author: braden-w

.github/labeler.yml

@@ -3,10 +3,15 @@ name: Labeler
 on:
   - pull_request_target
 
+permissions:
+  contents: read
+  pull-requests: write
+
 jobs:
-  triage:
+  labeler:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/labeler@v4.3.0
+      - uses: actions/labeler@v5.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
+          configuration-path: labeler-config.yml

.github/workflows/labeler.yml

@@ -65,7 +65,7 @@ jobs:
         run: |
           echo "COMMIT_SHA=${{ github.event.pull_request.head.sha || github.sha }}" >> $GITHUB_ENV
       - name: Preview Bundle Size
-        uses: marocchino/sticky-pull-request-comment@52423e01640425a022ef5fd42c6fb5f633a02728
+        uses: marocchino/sticky-pull-request-comment@28d58c4b5a5eae3bbe45348c3990dcbc2ffcdc69
         with:
           message: |
             Sizes for commit ${{ env.COMMIT_SHA }}:

.github/workflows/pr.yml

@@ -1 +1 @@
-24.2.0
+24.4.1

.nvmrc

@@ -14,6 +14,8 @@ If you are here to suggest a feature, first create an issue if it does not alrea
 
 ## Development
 
+_TanStack/query uses **symlink-based** configuration files. For smooth development in a local environment, we recommend developing in an environment that supports symlinks(ex: Linux, macOS, Windows Subsystem for Linux / WSL)._
+
 If you have been assigned to fix an issue or develop a new feature, please follow these steps to get started:
 
 - Fork this repository.

CONTRIBUTING.md

@@ -459,7 +459,7 @@
             },
             {
               "label": "Does this replace state managers?",
-              "to": "framework/angular/guides/does-this-replace-client-state"
+              "to": "framework/solid/guides/does-this-replace-client-state"
             }
           ]
         },
@@ -819,6 +819,10 @@
               "label": "infiniteQueryOptions",
               "to": "framework/react/reference/infiniteQueryOptions"
             },
+            {
+              "label": "mutationOptions",
+              "to": "framework/react/reference/mutationOptions"
+            },
             {
               "label": "usePrefetchQuery",
               "to": "framework/react/reference/usePrefetchQuery"

docs/config.json

@@ -10,7 +10,6 @@ Out of the box, TanStack Query is configured with **aggressive but sane** defaul
 > To change this behavior, you can configure your queries both globally and per-query using the `staleTime` option. Specifying a longer `staleTime` means queries will not refetch their data as often
 
 - A Query that has a `staleTime` set is considered **fresh** until that `staleTime` has elapsed.
-
   - set `staleTime` to e.g. `2 * 60 * 1000` to make sure data is read from the cache, without triggering any kinds of refetches, for 2 minutes, or until the Query is [invalidated manually](../query-invalidation.md).
   - set `staleTime` to `Infinity` to never trigger a refetch until the Query is [invalidated manually](../query-invalidation.md).
   - set `staleTime` to `'static'` to **never** trigger a refetch, even if the Query is [invalidated manually](../query-invalidation.md).

docs/framework/react/guides/important-defaults.md

@@ -60,7 +60,7 @@ If the mutation errors, the item will also disappear. But we could continue to s
 
 ### If the mutation and the query don't live in the same component
 
-This approach works very well if the mutation and the query live in the same component, However, you also get access to all mutations in other components via the dedicated `useMutationState` hook. It is best combined with a `mutationKey`:
+This approach works very well if the mutation and the query live in the same component. However, you also get access to all mutations in other components via the dedicated `useMutationState` hook. It is best combined with a `mutationKey`:
 
 [//]: # 'ExampleUI4'
 

docs/framework/react/guides/optimistic-updates.md

@@ -53,7 +53,11 @@ function Todos() {
 
   return (
     <div>
-      <ul>{query.data?.map((todo) => <li key={todo.id}>{todo.title}</li>)}</ul>
+      <ul>
+        {query.data?.map((todo) => (
+          <li key={todo.id}>{todo.title}</li>
+        ))}
+      </ul>
 
       <button
         onClick={() => {

docs/framework/react/quick-start.md

@@ -0,0 +1,15 @@
+---
+id: mutationOptions
+title: mutationOptions
+---
+
+```tsx
+mutationOptions({
+  mutationFn,
+  ...options,
+})
+```
+
+**Options**
+
+You can generally pass everything to `mutationOptions` that you can also pass to [`useMutation`](../useMutation.md).