feat: Preact Adapter (#9935)

* initial setup -- duplicated + package.json edited

* simple preact updations

* missed a React.ReactNode

* testing grunt work (preact library + other small issues + ErrorBoundary custom implementation)

* missed a few

* Adds ErrorBoundary (from react-error-boundary, but scaled down for preact) -- fixes a lot of tests, which expect react-related functionality

* useSuspenseQueries left -- removed the useQuery.promise tests

* forgot the console logs

* useSuspenseQueries 2 resolved; tests done

* ci: apply automated fixes

* fix: example

* fix: configs should be symlinks

* fix: sync versions for npm-run-all2

* ref: re-sync runall2

* ref: go back to 5.0.0

* ref: remove changelog

* react-query -> preact-query

* remove use client directive + added the useSyncExternalStore (decoupled from compat)

* remove the react remnants

* generate docs

* typescript eslint

* docs

* vite config fix

* docs now reference react docs (most of them atleast)

* code-rabbit issues addressed

* <div/> lol

* fix: docs

* ci: apply automated fixes

* fix: lockfile

* fix: duplicated versions

* lockfile (I cooked or am I cooked)

* ci: apply automated fixes

* Making small edits to fix versioning, warnings, and lock

* unhandled error compat

* Fixing CI

* Fixed the CI errors

* ci: apply automated fixes

* Prettier format

* Update changeset for Preact Adapter feature

---------

Co-authored-by: TkDodo <office@dorfmeister.cc>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: 3 people

.changeset/olive-rats-yawn.md

@@ -0,0 +1,5 @@
+---
+"@tanstack/preact-query": minor
+---
+
+feat: Preact Adapter

docs/config.json

@@ -167,6 +167,31 @@
               "to": "framework/angular/zoneless"
             }
           ]
+        },
+        {
+          "label": "preact",
+          "children": [
+            {
+              "label": "Overview",
+              "to": "framework/preact/overview"
+            },
+            {
+              "label": "Installation",
+              "to": "framework/preact/installation"
+            },
+            {
+              "label": "Quick Start",
+              "to": "framework/preact/quick-start"
+            },
+            {
+              "label": "TypeScript",
+              "to": "framework/preact/typescript"
+            },
+            {
+              "label": "GraphQL",
+              "to": "framework/preact/graphql"
+            }
+          ]
         }
       ]
     },
@@ -717,6 +742,131 @@
               "to": "framework/angular/guides/does-this-replace-client-state"
             }
           ]
+        },
+        {
+          "label": "preact",
+          "children": [
+            {
+              "label": "Important Defaults",
+              "to": "framework/preact/guides/important-defaults"
+            },
+            {
+              "label": "Queries",
+              "to": "framework/preact/guides/queries"
+            },
+            {
+              "label": "Query Keys",
+              "to": "framework/preact/guides/query-keys"
+            },
+            {
+              "label": "Query Functions",
+              "to": "framework/preact/guides/query-functions"
+            },
+            {
+              "label": "Query Options",
+              "to": "framework/preact/guides/query-options"
+            },
+            {
+              "label": "Network Mode",
+              "to": "framework/preact/guides/network-mode"
+            },
+            {
+              "label": "Parallel Queries",
+              "to": "framework/preact/guides/parallel-queries"
+            },
+            {
+              "label": "Dependent Queries",
+              "to": "framework/preact/guides/dependent-queries"
+            },
+            {
+              "label": "Background Fetching Indicators",
+              "to": "framework/preact/guides/background-fetching-indicators"
+            },
+            {
+              "label": "Window Focus Refetching",
+              "to": "framework/preact/guides/window-focus-refetching"
+            },
+            {
+              "label": "Disabling/Pausing Queries",
+              "to": "framework/preact/guides/disabling-queries"
+            },
+            {
+              "label": "Query Retries",
+              "to": "framework/preact/guides/query-retries"
+            },
+            {
+              "label": "Paginated Queries",
+              "to": "framework/preact/guides/paginated-queries"
+            },
+            {
+              "label": "Infinite Queries",
+              "to": "framework/preact/guides/infinite-queries"
+            },
+            {
+              "label": "Initial Query Data",
+              "to": "framework/preact/guides/initial-query-data"
+            },
+            {
+              "label": "Placeholder Query Data",
+              "to": "framework/preact/guides/placeholder-query-data"
+            },
+            {
+              "label": "Mutations",
+              "to": "framework/preact/guides/mutations"
+            },
+            {
+              "label": "Query Invalidation",
+              "to": "framework/preact/guides/query-invalidation"
+            },
+            {
+              "label": "Invalidation from Mutations",
+              "to": "framework/preact/guides/invalidations-from-mutations"
+            },
+            {
+              "label": "Updates from Mutation Responses",
+              "to": "framework/preact/guides/updates-from-mutation-responses"
+            },
+            {
+              "label": "Optimistic Updates",
+              "to": "framework/preact/guides/optimistic-updates"
+            },
+            {
+              "label": "Query Cancellation",
+              "to": "framework/preact/guides/query-cancellation"
+            },
+            {
+              "label": "Scroll Restoration",
+              "to": "framework/preact/guides/scroll-restoration"
+            },
+            {
+              "label": "Filters",
+              "to": "framework/preact/guides/filters"
+            },
+            {
+              "label": "Performance & Request Waterfalls",
+              "to": "framework/preact/guides/request-waterfalls"
+            },
+            {
+              "label": "Prefetching & Router Integration",
+              "to": "framework/preact/guides/prefetching"
+            },
+            {
+              "label": "Caching",
+              "to": "framework/preact/guides/caching"
+            },
+            {
+              "label": "Render Optimizations",
+              "to": "framework/preact/guides/render-optimizations"
+            },
+            {
+              "label": "Default Query Fn",
+              "to": "framework/preact/guides/default-query-function"
+            },
+            {
+              "label": "Does this replace [Redux, MobX, etc]?",
+              "to": "framework/preact/guides/does-this-replace-client-state"
+            }
+          ]
         }
       ]
     },
@@ -1009,6 +1159,91 @@
               "to": "framework/angular/reference/functions/injectMutation"
             }
           ]
+        },
+        {
+          "label": "preact",
+          "children": [
+            {
+              "label": "useQuery",
+              "to": "framework/preact/reference/functions/useQuery"
+            },
+            {
+              "label": "useQueries",
+              "to": "framework/preact/reference/functions/useQueries"
+            },
+            {
+              "label": "useInfiniteQuery",
+              "to": "framework/preact/reference/functions/useInfiniteQuery"
+            },
+            {
+              "label": "useMutation",
+              "to": "framework/preact/reference/functions/useMutation"
+            },
+            {
+              "label": "useIsFetching",
+              "to": "framework/preact/reference/functions/useIsFetching"
+            },
+            {
+              "label": "useIsMutating",
+              "to": "framework/preact/reference/functions/useIsMutating"
+            },
+            {
+              "label": "useMutationState",
+              "to": "framework/preact/reference/functions/useMutationState"
+            },
+            {
+              "label": "useSuspenseQuery",
+              "to": "framework/preact/reference/functions/useSuspenseQuery"
+            },
+            {
+              "label": "useSuspenseInfiniteQuery",
+              "to": "framework/preact/reference/functions/useSuspenseInfiniteQuery"
+            },
+            {
+              "label": "useSuspenseQueries",
+              "to": "framework/preact/reference/functions/useSuspenseQueries"
+            },
+            {
+              "label": "QueryClientProvider",
+              "to": "framework/preact/reference/functions/QueryClientProvider"
+            },
+            {
+              "label": "useQueryClient",
+              "to": "framework/preact/reference/functions/useQueryClient"
+            },
+            {
+              "label": "queryOptions",
+              "to": "framework/preact/reference/functions/queryOptions"
+            },
+            {
+              "label": "infiniteQueryOptions",
+              "to": "framework/preact/reference/functions/infiniteQueryOptions"
+            },
+            {
+              "label": "mutationOptions",
+              "to": "framework/preact/reference/functions/mutationOptions"
+            },
+            {
+              "label": "usePrefetchQuery",
+              "to": "framework/preact/reference/functions/usePrefetchQuery"
+            },
+            {
+              "label": "usePrefetchInfiniteQuery",
+              "to": "framework/preact/reference/functions/usePrefetchInfiniteQuery"
+            },
+            {
+              "label": "QueryErrorResetBoundary",
+              "to": "framework/preact/reference/functions/QueryErrorResetBoundary"
+            },
+            {
+              "label": "useQueryErrorResetBoundary",
+              "to": "framework/preact/reference/functions/useQueryErrorResetBoundary"
+            },
+            {
+              "label": "hydration",
+              "to": "framework/react/reference/functions/HydrationBoundary"
+            }
+          ]
         }
       ]
     },

docs/framework/angular/guides/infinite-queries.md

@@ -51,18 +51,20 @@ export class Example {
 ```angular-html
 <div>
   @if (query.isPending()) {
-  <p>Loading...</p>
+    <p>Loading...</p>
   } @else if (query.isError()) {
-  <span>Error: {{ query?.error().message }}</span>
-  } @else { @for (page of query?.data().pages; track $index) { @for (project of
-  page.data; track project.id) {
-  <p>{{ project.name }} {{ project.id }}</p>
-  } }
-  <div>
-    <button (click)="query.fetchNextPage()" [disabled]="nextButtonDisabled()">
-      {{ nextButtonText() }}
-    </button>
-  </div>
+    <span>Error: {{ query?.error().message }}</span>
+  } @else {
+    @for (page of query?.data().pages; track $index) {
+      @for (project of page.data; track project.id) {
+        <p>{{ project.name }} {{ project.id }}</p>
+      }
+    }
+    <div>
+      <button (click)="query.fetchNextPage()" [disabled]="nextButtonDisabled()">
+        {{ nextButtonText() }}
+      </button>
+    </div>
   }
 </div>
 ```

docs/framework/angular/overview.md

@@ -84,7 +84,7 @@ import { lastValueFrom } from 'rxjs'
       <strong>✨ {{ data.stargazers_count }}</strong>
       <strong>🍴 {{ data.forks_count }}</strong>
     }
-  `
+  `,
 })
 export class SimpleExampleComponent {
   http = inject(HttpClient)

docs/framework/angular/quick-start.md

@@ -51,7 +51,7 @@ import { lastValueFrom } from 'rxjs'
 import {
   injectMutation,
   injectQuery,
-  QueryClient
+  QueryClient,
 } from '@tanstack/angular-query-experimental'
 
 @Component({

docs/framework/angular/typescript.md

@@ -78,7 +78,7 @@ class MyComponent {
   template: `
     @if (query.isSuccess()) {
       @let data = query.data();
-      //    ^? data: number
+      // ^? data: number
     }
   `,
 })
@@ -104,7 +104,7 @@ class MyComponent {
 class MyComponent {
   query = injectQuery(() => ({
     queryKey: ['groups'],
-    queryFn: fetchGroups
+    queryFn: fetchGroups,
   }))
 }
 ```

docs/framework/preact/graphql.md

@@ -0,0 +1,6 @@
+---
+id: graphql
+title: GraphQL
+ref: docs/framework/react/graphql.md
+replace: { 'React': 'Preact', 'react-query': 'preact-query' }
+---

docs/framework/preact/guides/background-fetching-indicators.md

@@ -0,0 +1,6 @@
+---
+id: background-fetching-indicators
+title: Background Fetching Indicators
+ref: docs/framework/react/guides/background-fetching-indicators.md
+replace: { 'React': 'Preact', 'react-query': 'preact-query' }
+---

docs/framework/preact/guides/caching.md

@@ -0,0 +1,6 @@
+---
+id: caching
+title: Caching Examples
+ref: docs/framework/react/guides/caching.md
+replace: { 'React': 'Preact', 'react-query': 'preact-query' }
+---

docs/framework/preact/guides/default-query-function.md

@@ -0,0 +1,6 @@
+---
+id: default-query-function
+title: Default Query Function
+ref: docs/framework/react/guides/default-query-function.md
+replace: { 'React': 'Preact', 'react-query': 'preact-query' }
+---