+
+{props.description}
+ + ); +} + +render(
+
+
+
+Hooks for fetching, caching and updating asynchronous data in React
+
+
+ 
+
+ 
+
+
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+ 
+
+
+Enjoy this library? Try the entire [TanStack](https://tanstack.com)! [TanStack Table](https://github.com/TanStack/table), [TanStack Router](https://github.com/tanstack/router), [TanStack Virtual](https://github.com/tanstack/virtual), [React Charts](https://github.com/TanStack/react-charts), [React Ranger](https://github.com/TanStack/ranger)
+
+## Visit [tanstack.com/query](https://tanstack.com/query) for docs, guides, API and more!
+
+## Quick Features
+
+- Transport/protocol/backend agnostic data fetching (REST, GraphQL, promises, whatever!)
+- Auto Caching + Refetching (stale-while-revalidate, Window Refocus, Polling/Realtime)
+- Parallel + Dependent Queries
+- Mutations + Reactive Query Refetching
+- Multi-layer Cache + Automatic Garbage Collection
+- Paginated + Cursor-based Queries
+- Load-More + Infinite Scroll Queries w/ Scroll Recovery
+- Request Cancellation
+- [React Suspense](https://react.dev/reference/react/Suspense) + Fetch-As-You-Render Query Prefetching
+- Dedicated Devtools
+
+### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
+
+
diff --git a/packages/preact-query/eslint.config.js b/packages/preact-query/eslint.config.js
new file mode 100644
index 0000000000..edacda9938
--- /dev/null
+++ b/packages/preact-query/eslint.config.js
@@ -0,0 +1,29 @@
+// @ts-check
+
+import pluginReact from '@eslint-react/eslint-plugin'
+import reactHooks from 'eslint-plugin-react-hooks'
+import rootConfig from './root.eslint.config.js'
+
+export default [
+ ...rootConfig,
+ // @ts-expect-error wtf
+ ...reactHooks.configs['recommended-latest'],
+ {
+ files: ['**/*.{ts,tsx}'],
+ ...pluginReact.configs.recommended,
+ rules: {
+ '@eslint-react/no-context-provider': 'off', // We need to be React 18 compatible
+ 'react-hooks/exhaustive-deps': 'error',
+ 'react-hooks/rules-of-hooks': 'error',
+ 'react-hooks/unsupported-syntax': 'error',
+ 'react-hooks/incompatible-library': 'error',
+ },
+ },
+ {
+ files: ['**/__tests__/**'],
+ rules: {
+ '@eslint-react/dom/no-missing-button-type': 'off',
+ '@typescript-eslint/no-unnecessary-condition': 'off',
+ },
+ },
+]
diff --git a/packages/preact-query/package.json b/packages/preact-query/package.json
new file mode 100644
index 0000000000..05ea1368b6
--- /dev/null
+++ b/packages/preact-query/package.json
@@ -0,0 +1,87 @@
+{
+ "name": "@tanstack/preact-query",
+ "version": "5.90.11",
+ "description": "Hooks for managing, caching and syncing asynchronous and remote data in preact",
+ "author": "tannerlinsley",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/TanStack/query.git",
+ "directory": "packages/preact-query"
+ },
+ "homepage": "https://tanstack.com/query",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/tannerlinsley"
+ },
+ "scripts": {
+ "clean": "premove ./build ./coverage ./dist-ts",
+ "compile": "tsc --build",
+ "test:eslint": "eslint --concurrency=auto ./src",
+ "test:types": "npm-run-all --serial test:types:*",
+ "test:types:ts50": "node ../../node_modules/typescript50/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts51": "node ../../node_modules/typescript51/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts52": "node ../../node_modules/typescript52/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts53": "node ../../node_modules/typescript53/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts54": "node ../../node_modules/typescript54/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts55": "node ../../node_modules/typescript55/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts56": "node ../../node_modules/typescript56/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:ts57": "node ../../node_modules/typescript57/lib/tsc.js --build tsconfig.legacy.json",
+ "test:types:tscurrent": "tsc --build",
+ "test:lib": "vitest",
+ "test:lib:dev": "pnpm run test:lib --watch",
+ "test:build": "publint --strict && attw --pack",
+ "build": "pnpm build:tsup && pnpm build:codemods",
+ "build:tsup": "tsup --tsconfig tsconfig.prod.json",
+ "build:codemods": "cpy ../query-codemods/* ./build/codemods"
+ },
+ "type": "module",
+ "types": "build/legacy/index.d.ts",
+ "main": "build/legacy/index.cjs",
+ "module": "build/legacy/index.js",
+ "react-native": "src/index.ts",
+ "exports": {
+ ".": {
+ "@tanstack/custom-condition": "./src/index.ts",
+ "import": {
+ "types": "./build/modern/index.d.ts",
+ "default": "./build/modern/index.js"
+ },
+ "require": {
+ "types": "./build/modern/index.d.cts",
+ "default": "./build/modern/index.cjs"
+ }
+ },
+ "./package.json": "./package.json"
+ },
+ "sideEffects": false,
+ "files": [
+ "build",
+ "src",
+ "!src/__tests__",
+ "!build/codemods/node_modules",
+ "!build/codemods/vite.config.ts",
+ "!build/codemods/**/__testfixtures__",
+ "!build/codemods/**/__tests__"
+ ],
+ "dependencies": {
+ "@tanstack/query-core": "workspace:*"
+ },
+ "devDependencies": {
+ "@tanstack/query-persist-client-core": "workspace:*",
+ "@tanstack/query-test-utils": "workspace:*",
+ "@testing-library/react": "^16.1.0",
+ "@testing-library/react-render-stream": "^2.0.0",
+ "@types/react": "^19.0.1",
+ "@types/react-dom": "^19.0.2",
+ "@vitejs/plugin-react": "^4.3.4",
+ "cpy-cli": "^5.0.0",
+ "npm-run-all2": "^5.0.0",
+ "react": "^19.0.0",
+ "react-dom": "^19.0.0",
+ "react-error-boundary": "^4.1.2"
+ },
+ "peerDependencies": {
+ "react": "^18 || ^19"
+ }
+}
diff --git a/packages/preact-query/root.eslint.config.js b/packages/preact-query/root.eslint.config.js
new file mode 100644
index 0000000000..8b07108d25
--- /dev/null
+++ b/packages/preact-query/root.eslint.config.js
@@ -0,0 +1,56 @@
+// @ts-check
+
+// @ts-ignore Needed due to moduleResolution Node vs Bundler
+import { tanstackConfig } from '@tanstack/eslint-config'
+import pluginCspell from '@cspell/eslint-plugin'
+import vitest from '@vitest/eslint-plugin'
+
+export default [
+ ...tanstackConfig,
+ {
+ name: 'tanstack/temp',
+ plugins: {
+ cspell: pluginCspell,
+ },
+ rules: {
+ 'cspell/spellchecker': [
+ 'warn',
+ {
+ cspell: {
+ words: [
+ 'Promisable', // Our public interface
+ 'TSES', // @typescript-eslint package's interface
+ 'codemod', // We support our codemod
+ 'combinate', // Library name
+ 'datatag', // Query options tagging
+ 'extralight', // Our public interface
+ 'jscodeshift',
+ 'refetches', // Query refetch operations
+ 'retryer', // Our public interface
+ 'solidjs', // Our target framework
+ 'tabular-nums', // https://developer.mozilla.org/en-US/docs/Web/CSS/font-variant-numeric
+ 'tanstack', // Our package scope
+ 'todos', // Too general word to be caught as error
+ 'tsqd', // Our public interface (TanStack Query Devtools shorthand)
+ 'tsup', // We use tsup as builder
+ 'typecheck', // Field of vite.config.ts
+ 'vue-demi', // dependency of @tanstack/vue-query
+ 'ɵkind', // Angular specific
+ 'ɵproviders', // Angular specific
+ ],
+ },
+ },
+ ],
+ '@typescript-eslint/no-empty-function': 'off',
+ '@typescript-eslint/no-unsafe-function-type': 'off',
+ 'no-case-declarations': 'off',
+ 'prefer-const': 'off',
+ },
+ },
+ {
+ files: ['**/*.spec.ts*', '**/*.test.ts*', '**/*.test-d.ts*'],
+ plugins: { vitest },
+ rules: vitest.configs.recommended.rules,
+ settings: { vitest: { typecheck: true } },
+ },
+]
diff --git a/packages/preact-query/root.tsup.config.js b/packages/preact-query/root.tsup.config.js
new file mode 100644
index 0000000000..28fd7edde9
--- /dev/null
+++ b/packages/preact-query/root.tsup.config.js
@@ -0,0 +1,39 @@
+// @ts-check
+
+import { esbuildPluginFilePathExtensions } from 'esbuild-plugin-file-path-extensions'
+
+/**
+ * @param {Object} opts - Options for building configurations.
+ * @param {string[]} opts.entry - The entry array.
+ * @returns {import('tsup').Options}
+ */
+export function modernConfig(opts) {
+ return {
+ entry: opts.entry,
+ format: ['cjs', 'esm'],
+ target: ['chrome91', 'firefox90', 'edge91', 'safari15', 'ios15', 'opera77'],
+ outDir: 'build/modern',
+ dts: true,
+ sourcemap: true,
+ clean: true,
+ esbuildPlugins: [esbuildPluginFilePathExtensions({ esmExtension: 'js' })],
+ }
+}
+
+/**
+ * @param {Object} opts - Options for building configurations.
+ * @param {string[]} opts.entry - The entry array.
+ * @returns {import('tsup').Options}
+ */
+export function legacyConfig(opts) {
+ return {
+ entry: opts.entry,
+ format: ['cjs', 'esm'],
+ target: ['es2020', 'node16'],
+ outDir: 'build/legacy',
+ dts: true,
+ sourcemap: true,
+ clean: true,
+ esbuildPlugins: [esbuildPluginFilePathExtensions({ esmExtension: 'js' })],
+ }
+}
diff --git a/packages/preact-query/src/HydrationBoundary.tsx b/packages/preact-query/src/HydrationBoundary.tsx
new file mode 100644
index 0000000000..901c8e9686
--- /dev/null
+++ b/packages/preact-query/src/HydrationBoundary.tsx
@@ -0,0 +1,111 @@
+'use client'
+import * as React from 'react'
+
+import { hydrate } from '@tanstack/query-core'
+import { useQueryClient } from './QueryClientProvider'
+import type {
+ DehydratedState,
+ HydrateOptions,
+ OmitKeyof,
+ QueryClient,
+} from '@tanstack/query-core'
+
+export interface HydrationBoundaryProps {
+ state: DehydratedState | null | undefined
+ options?: OmitKeyofItem: {item}
+ ))} +Item: {item}
+ ))} +Item: {item}
+ ))} +