Merge branch 'main' into fix/vue-query-useBaseQuery-prevent-dual-error-propagation

Author: sukvvon

.changeset/config.json

@@ -8,7 +8,36 @@
   "access": "public",
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
-  "fixed": [],
+  "fixed": [
+    [
+      "@tanstack/angular-query-experimental",
+      "@tanstack/angular-query-persist-client",
+      "@tanstack/eslint-plugin-query",
+      "@tanstack/preact-query",
+      "@tanstack/preact-query-devtools",
+      "@tanstack/preact-query-persist-client",
+      "@tanstack/query-async-storage-persister",
+      "@tanstack/query-broadcast-client-experimental",
+      "@tanstack/query-core",
+      "@tanstack/query-devtools",
+      "@tanstack/query-persist-client-core",
+      "@tanstack/query-sync-storage-persister",
+      "@tanstack/react-query",
+      "@tanstack/react-query-devtools",
+      "@tanstack/react-query-next-experimental",
+      "@tanstack/react-query-persist-client",
+      "@tanstack/solid-query",
+      "@tanstack/solid-query-devtools",
+      "@tanstack/solid-query-persist-client",
+      "@tanstack/vue-query"
+    ],
+    [
+      "@tanstack/vue-query-devtools",
+      "@tanstack/svelte-query",
+      "@tanstack/svelte-query-devtools",
+      "@tanstack/svelte-query-persist-client"
+    ]
+  ],
   "linked": [],
   "ignore": [],
   "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {

.github/renovate.json

@@ -25,14 +25,13 @@
     "react-dom",
     "tsup",
     "typescript",
-    "typescript50",
-    "typescript51",
-    "typescript52",
-    "typescript53",
     "typescript54",
     "typescript55",
     "typescript56",
     "typescript57",
+    "typescript58",
+    "typescript59",
+    "typescript60",
     "vue",
     "vue-tsc",
     "vue2",

.github/workflows/autofix.yml

@@ -3,7 +3,7 @@ name: autofix.ci # needed to securely identify the workflow
 on:
   pull_request:
   push:
-    branches: [main, alpha, beta, rc, v4]
+    branches: [main, 'v[0-9]', '*-pre', '*-maint']
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.number || github.ref }}
@@ -18,11 +18,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6.0.1
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v6.0.2
       - name: Setup Tools
-        uses: tanstack/config/.github/setup@main
+        uses: TanStack/config/.github/setup@main
       - name: Fix formatting
         run: pnpm run format
       - name: Apply fixes

.github/workflows/detect-agent.yml

@@ -0,0 +1,19 @@
+name: Detect Agent
+
+on:
+  pull_request_target:
+    types: [opened]
+  workflow_dispatch: {}
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  detect:
+    if: github.event_name != 'workflow_dispatch'
+    uses: bombshell-dev/automation/.github/workflows/detect-agent.yml@a1553cebd9318d416f6a8e9f38f363b6aaa19c72
+
+  backfill:
+    if: github.event_name == 'workflow_dispatch'
+    uses: bombshell-dev/automation/.github/workflows/detect-agent-backfill.yml@a1553cebd9318d416f6a8e9f38f363b6aaa19c72

.github/workflows/labeler.yml

@@ -1,17 +1,19 @@
 name: Labeler
 
 on:
-  - pull_request_target
+  pull_request_target:
 
 permissions:
   contents: read
   pull-requests: write
 
 jobs:
   labeler:
+    name: Labeler
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/labeler@v5.0.0
+      - name: Labeler
+        uses: actions/labeler@v6.0.1
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           configuration-path: labeler-config.yml

.github/workflows/pr.yml

@@ -13,20 +13,21 @@ env:
 permissions:
   contents: read
   pull-requests: write
+  issues: write
 
 jobs:
   test:
     name: Test
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
         with:
           fetch-depth: 0
       - name: Start Nx Agents
         run: npx nx-cloud start-ci-run --distribute-on=".nx/workflows/dynamic-changesets.yaml"
       - name: Setup Tools
-        uses: tanstack/config/.github/setup@main
+        uses: TanStack/config/.github/setup@main
       - name: Get base and head commits for `nx affected`
         uses: nrwl/nx-set-shas@v4.4.0
         with:
@@ -41,11 +42,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6.0.1
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v6.0.2
       - name: Setup Tools
-        uses: tanstack/config/.github/setup@main
+        uses: TanStack/config/.github/setup@main
       - name: Build Packages
         run: pnpm run build:all
       - name: Publish Previews
@@ -65,10 +64,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6.0.1
-        with:
-          fetch-depth: 0
+        uses: actions/checkout@v6.0.2
       - name: Check Provenance
         uses: danielroe/provenance-action@v0.1.1
         with:
           fail-on-downgrade: true
+  version-preview:
+    name: Version Preview
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+      - name: Setup Tools
+        uses: TanStack/config/.github/setup@main
+      - name: Changeset Preview
+        uses: TanStack/config/.github/changeset-preview@main

.github/workflows/release.yml

@@ -2,13 +2,11 @@ name: Release
 
 on:
   push:
-    branches: [main, alpha, beta, rc, v4]
-  repository_dispatch:
-    types: [release]
+    branches: [main, 'v[0-9]', '*-pre', '*-maint']
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.event.number || github.ref }}
-  cancel-in-progress: true
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
 
 env:
   NX_CLOUD_ACCESS_TOKEN: ${{ secrets.NX_CLOUD_ACCESS_TOKEN }}
@@ -21,54 +19,43 @@ permissions:
 jobs:
   release:
     name: Release
-    if: github.repository_owner == 'TanStack'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6.0.1
+        uses: actions/checkout@v6.0.2
         with:
           fetch-depth: 0
-      - name: Start Nx Agents
-        run: npx nx-cloud start-ci-run --distribute-on=".nx/workflows/dynamic-changesets.yaml"
       - name: Setup Tools
-        uses: tanstack/config/.github/setup@main
-      - name: Run Tests
-        run: pnpm run test:ci
-      - name: Stop Nx Agents
-        if: ${{ always() }}
-        run: npx nx-cloud stop-all-agents
-      # - name: Check for Changesets marked as major
-      #   id: major
-      #   run: |
-      #     echo "found=false" >> $GITHUB_OUTPUT
-      #     regex="(major)"
-      #     shopt -s nullglob
-      #     for file in .changeset/*.md; do
-      #       if [[ $(cat $file) =~ $regex ]]; then
-      #         echo "found=true" >> $GITHUB_OUTPUT
-      #       fi
-      #     done
-      - name: Run Changesets (version or publish)
+        uses: TanStack/config/.github/setup@main
+      - name: Run Build
+        run: pnpm run build:all
+      - name: Determine dist-tag
+        id: dist-tag
+        run: |
+          BRANCH="${GITHUB_REF_NAME}"
+          if [[ "$BRANCH" == *-pre ]]; then
+            echo "prerelease=true" >> "$GITHUB_OUTPUT"
+            echo "tag=pre" >> "$GITHUB_OUTPUT"
+          elif [[ "$BRANCH" == *-maint ]]; then
+            echo "tag=maint" >> "$GITHUB_OUTPUT"
+          elif [[ "$BRANCH" =~ ^v[0-9]+$ ]]; then
+            echo "tag=$BRANCH" >> "$GITHUB_OUTPUT"
+          else
+            echo "latest=true" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Create Release Pull Request or Publish
         id: changesets
-        uses: changesets/action@v1.5.3
+        uses: changesets/action@v1
         with:
           version: pnpm run changeset:version
-          publish: pnpm run changeset:publish
-          commit: 'ci: Version Packages'
+          publish: pnpm run changeset:publish ${{ steps.dist-tag.outputs.tag && format('--tag {0}', steps.dist-tag.outputs.tag) }}
           title: 'ci: Version Packages'
+          commit: 'ci: changeset release'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      # - name: Auto-merge Changesets PR
-      #   if: steps.changesets.outputs.hasChangesets == 'true' && steps.major.outputs.found == 'false'
-      #   run: |
-      #     gh pr merge --squash "$PR_NUMBER"
-      #     gh api --method POST /repos/$REPO/dispatches -f 'event_type=release'
-      #   env:
-      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      #     REPO: ${{ github.repository }}
-      #     PR_NUMBER: ${{ steps.changesets.outputs.pullRequestNumber }}
-      - name: Comment on PRs about release
+      - name: Create GitHub Release
         if: steps.changesets.outputs.published == 'true'
-        uses: tanstack/config/.github/comment-on-release@main
-        with:
-          published-packages: ${{ steps.changesets.outputs.publishedPackages }}
+        run: node scripts/create-github-release.mjs ${{ steps.dist-tag.outputs.prerelease == 'true' && '--prerelease' }} ${{ steps.dist-tag.outputs.latest == 'true' && '--latest' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

docs/community-resources.md

@@ -133,7 +133,7 @@ others:
     {
       title: 'Hey API',
       url: 'https://heyapi.dev/openapi-ts/plugins/tanstack-query',
-      description: 'The OpenAPI to TypeScript codegen. Generate clients, SDKs, validators, and more.',
+      description: 'OpenAPI to TypeScript codegen. Production-ready SDKs, Zod schemas, TanStack Query hooks, and 20+ plugins. Used by Vercel, OpenCode, and PayPal.',
     },
     {
       title: 'Kubb',
@@ -175,6 +175,11 @@ others:
       url: 'https://github.com/rametta/rapini',
       description: '🥬 OpenAPI to React Query (or SWR) & Axios',
     },
+    {
+      title: 'React Query Visualizer',
+      url: 'https://marketplace.visualstudio.com/items?itemName=fe-dudu.react-query-visualizer',
+      description: 'VS Code extension for TanStack Query (React Query): visualize query keys, cache invalidation/refetch flows, and file impact graph',
+    },
     {
       title: 'Tanstack Query Visualizer',
       url: 'https://tanstack-query-visualizer.sofi.coop/',

docs/config.json

@@ -246,6 +246,10 @@
               "label": "Window Focus Refetching",
               "to": "framework/react/guides/window-focus-refetching"
             },
+            {
+              "label": "Polling",
+              "to": "framework/react/guides/polling"
+            },
             {
               "label": "Disabling/Pausing Queries",
               "to": "framework/react/guides/disabling-queries"
@@ -399,6 +403,10 @@
               "label": "Window Focus Refetching",
               "to": "framework/solid/guides/window-focus-refetching"
             },
+            {
+              "label": "Polling",
+              "to": "framework/solid/guides/polling"
+            },
             {
               "label": "Disabling/Pausing Queries",
               "to": "framework/solid/guides/disabling-queries"
@@ -536,6 +544,10 @@
               "label": "Window Focus Refetching",
               "to": "framework/vue/guides/window-focus-refetching"
             },
+            {
+              "label": "Polling",
+              "to": "framework/vue/guides/polling"
+            },
             {
               "label": "Disabling/Pausing Queries",
               "to": "framework/vue/guides/disabling-queries"
@@ -913,6 +925,10 @@
           "label": "onlineManager",
           "to": "reference/onlineManager"
         },
+        {
+          "label": "environmentManager",
+          "to": "reference/environmentManager"
+        },
         {
           "label": "notifyManager",
           "to": "reference/notifyManager"
@@ -1051,6 +1067,18 @@
               "label": "infiniteQueryOptions",
               "to": "framework/vue/reference/infiniteQueryOptions"
             },
+            {
+              "label": "mutationOptions",
+              "to": "framework/vue/reference/mutationOptions"
+            },
+            {
+              "label": "usePrefetchQuery",
+              "to": "framework/vue/reference/usePrefetchQuery"
+            },
+            {
+              "label": "usePrefetchInfiniteQuery",
+              "to": "framework/vue/reference/usePrefetchInfiniteQuery"
+            },
             {
               "label": "hydration",
               "to": "framework/vue/reference/hydration"
@@ -1096,6 +1124,10 @@
               "label": "infiniteQueryOptions",
               "to": "framework/solid/reference/infiniteQueryOptions"
             },
+            {
+              "label": "mutationOptions",
+              "to": "framework/solid/reference/mutationOptions"
+            },
             {
               "label": "hydration",
               "to": "framework/solid/reference/hydration"
@@ -1249,7 +1281,7 @@
             },
             {
               "label": "hydration",
-              "to": "framework/react/reference/functions/HydrationBoundary"
+              "to": "framework/preact/reference/functions/HydrationBoundary"
             }
           ]
         }
@@ -1289,6 +1321,10 @@
         {
           "label": "Mutation Property Order",
           "to": "eslint/mutation-property-order"
+        },
+        {
+          "label": "Prefer Query Options",
+          "to": "eslint/prefer-query-options"
         }
       ]
     },