feat: zodmint/tanstack-query adapter (v2.6.0)

- mockQueryClient() — pre-populate QueryClient cache synchronously
- mockQueryFn() — queryFn replacement for use inside useQuery
- mockInfiniteQueryClient() — infinite query cache with v5 page shape
- Framework-agnostic: @tanstack/query-core only, works with React/Vue/Svelte/Solid
- 12 new tests, 546 total passing

Author: gonll

CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to zodmint are documented here. This project follows [Keep a
 
 ---
 
+## [2.6.0] - 2026-06-03
+
+### Added
+- **`zodmint/tanstack-query`** — new sub-entry for pre-populating `QueryClient` cache in tests. Framework-agnostic: imports only from `@tanstack/query-core`, works with React, Vue, Svelte, and Solid.
+  - `mockQueryClient(entries, defaultOptions?)` — creates a `QueryClient` with synchronously pre-populated cache via `setQueryData`. Applies test-friendly defaults (`retry: false`, `staleTime: Infinity`, `gcTime: Infinity`). Each entry maps a query key array to a Zod schema plus optional `MockOptions`.
+  - `mockQueryFn(schema, options?)` — returns a `queryFn`-compatible function for use directly inside `useQuery`. Useful when you want zodmint data without bypassing the query lifecycle.
+  - `mockInfiniteQueryClient(entries, defaultOptions?)` — same as `mockQueryClient` but produces TanStack Query v5 infinite data shape (`{ pages: [items[]], pageParams: [undefined] }`). Configurable `pageSize` per entry.
+- `@tanstack/query-core >= 5.0.0` added as optional peer dependency.
+
+---
+
 ## [2.5.1] - 2026-06-03
 
 ### Fixed

README.md

@@ -1292,6 +1292,68 @@ Control mapping:
 
 ---
 
+### TanStack Query — `zodmint/tanstack-query`
+
+zodmint ships a `zodmint/tanstack-query` sub-entry for pre-populating a `QueryClient` cache in tests. No network, no `fetch` mock, no MSW — the data is injected directly into the cache before your component renders.
+
+Works with any TanStack Query framework adapter (React, Vue, Svelte, Solid) — imports only from `@tanstack/query-core`.
+
+```bash
+npm install @tanstack/query-core
+```
+
+```typescript
+import { mockQueryClient } from "zodmint/tanstack-query";
+```
+
+**`mockQueryClient(entries, defaultOptions?)`** — creates a `QueryClient` with synchronously pre-populated cache:
+
+```typescript
+const client = mockQueryClient([
+  { queryKey: ["user", "1"], schema: UserSchema, options: { seed: 1 } },
+  { queryKey: ["posts"],     schema: z.array(PostSchema) },
+]);
+
+// In a React test (vitest + @testing-library/react):
+render(
+  <QueryClientProvider client={client}>
+    <UserProfile userId="1" />
+  </QueryClientProvider>
+);
+// component renders immediately with valid data — no fetch, no loading state
+```
+
+The client has test-friendly defaults applied automatically: `retry: false`, `staleTime: Infinity`, `gcTime: Infinity`. Override via the second argument:
+
+```typescript
+const client = mockQueryClient(entries, { defaultOptions: { queries: { retry: 2 } } });
+```
+
+**`mockQueryFn(schema, options?)`** — returns a `queryFn`-compatible function for use directly inside `useQuery`:
+
+```typescript
+const { result } = renderHook(() =>
+  useQuery({
+    queryKey: ["user", "1"],
+    queryFn: mockQueryFn(UserSchema, { seed: 42 }),
+  })
+);
+// result.current.data is a valid User, same value on every run
+```
+
+**`mockInfiniteQueryClient(entries, defaultOptions?)`** — same as `mockQueryClient` but produces the TanStack Query v5 infinite data shape:
+
+```typescript
+const client = mockInfiniteQueryClient([
+  { queryKey: ["feed"], schema: PostSchema, pageSize: 10 },
+]);
+
+const feed = client.getQueryData(["feed"]);
+// { pages: [Post[10]], pageParams: [undefined] }
+```
+
+---
+
 ## Prior art
 
 zodmint was built with an eye on the existing ecosystem. Three libraries were studied for orientation:

examples/17-tanstack-query.ts

@@ -0,0 +1,35 @@
+// 17-tanstack-query.ts — zodmint/tanstack-query: pre-populate QueryClient cache for tests
+import { z } from "zod";
+import { mockQueryClient, mockQueryFn, mockInfiniteQueryClient } from "../src/tanstack-query.js";
+
+const UserSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string(),
+  email: z.string().email(),
+});
+
+const PostSchema = z.object({
+  id: z.string().uuid(),
+  title: z.string(),
+  userId: z.string().uuid(),
+});
+
+// Pre-populate cache — no network, no fetch mock needed
+const client = mockQueryClient([
+  { queryKey: ["user", "1"], schema: UserSchema, options: { seed: 1 } },
+  { queryKey: ["posts"],     schema: z.array(PostSchema), options: { seed: 2 } },
+]);
+
+console.log("user:", client.getQueryData(["user", "1"]));
+console.log("posts:", client.getQueryData(["posts"]));
+
+// queryFn replacement — use inside useQuery in tests
+const queryFn = mockQueryFn(UserSchema, { seed: 42 });
+console.log("queryFn result:", queryFn());
+
+// Infinite query
+const infiniteClient = mockInfiniteQueryClient([
+  { queryKey: ["feed"], schema: PostSchema, pageSize: 3 },
+]);
+const feed = infiniteClient.getQueryData(["feed"]) as { pages: unknown[][]; pageParams: unknown[] };
+console.log("pages:", feed.pages.length, "items per page:", feed.pages[0].length);

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "zodmint",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "TypeScript-first schema-valid test fixture generator for Zod schemas",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -36,6 +36,11 @@
       "types": "./dist/storybook.d.ts",
       "import": "./dist/storybook.js",
       "require": "./dist/storybook.cjs"
+    },
+    "./tanstack-query": {
+      "types": "./dist/tanstack-query.d.ts",
+      "import": "./dist/tanstack-query.js",
+      "require": "./dist/tanstack-query.cjs"
     }
   },
   "bin": {
@@ -67,7 +72,8 @@
     "drizzle-orm": ">=0.29.0",
     "fast-check": ">=3.0.0",
     "msw": ">=2.0.0",
-    "zod": ">=3.23.0"
+    "zod": ">=3.23.0",
+    "@tanstack/query-core": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "@prisma/client": {
@@ -81,9 +87,13 @@
     },
     "msw": {
       "optional": true
+    },
+    "@tanstack/query-core": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@tanstack/query-core": "^5.101.0",
     "@types/node": "^20.0.0",
     "fast-check": "^3.22.0",
     "msw": "^2.14.6",
@@ -133,7 +143,7 @@
     "url": "https://github.com/gonll/zodmint.git"
   },
   "homepage": "https://github.com/gonll/zodmint#readme",
-    "bugs": {
+  "bugs": {
     "url": "https://github.com/gonll/zodmint/issues"
   }
 }