chore(solid-query): update docs (#8942)

Author: birkskyum

docs/framework/solid/overview.md

@@ -73,13 +73,13 @@ In the example below, you can see Solid Query in its most basic and simple form
 ```tsx
 import { ErrorBoundary, Suspense } from 'solid-js'
 import {
-  createQuery,
+  useQuery,
   QueryClient,
   QueryClientProvider,
 } from '@tanstack/solid-query'
 
 function App() {
-  const repositoryQuery = createQuery(() => ({
+  const repositoryQuery = useQuery(() => ({
     queryKey: ['TanStack Query'],
     queryFn: async () => {
       const result = await fetch('https://api.github.com/repos/TanStack/query')

docs/framework/solid/quick-start.md

@@ -11,14 +11,14 @@ The `@tanstack/solid-query` package provides a 1st-class API for using TanStack
 import {
   QueryClient,
   QueryClientProvider,
-  createQuery,
+  useQuery,
 } from '@tanstack/solid-query'
 import { Switch, Match, For } from 'solid-js'
 
 const queryClient = new QueryClient()
 
 function Example() {
-  const query = createQuery(() => ({
+  const query = useQuery(() => ({
     queryKey: ['todos'],
     queryFn: fetchTodos,
   }))
@@ -53,7 +53,7 @@ function App() {
 
 Solid Query offers useful primitives and functions that will make managing server state in SolidJS apps easier.
 
-- `createQuery`
+- `useQuery`
 - `createQueries`
 - `createInfiniteQueries`
 - `createMutation`
@@ -67,7 +67,7 @@ Solid Query offers useful primitives and functions that will make managing serve
 
 Solid Query offers an API similar to React Query, but there are some key differences to be mindful of.
 
-- Arguments to `solid-query` primitives (like `createQuery`, `createMutation`, `useIsFetching`) listed above are functions, so that they can be tracked in a reactive scope.
+- Arguments to `solid-query` primitives (like `useQuery`, `createMutation`, `useIsFetching`) listed above are functions, so that they can be tracked in a reactive scope.
 
 ```tsx
 // ❌ react version
@@ -77,7 +77,7 @@ useQuery({
 })
 
 // ✅ solid version
-createQuery(() => ({
+useQuery(() => ({
   queryKey: ['todos', todo],
   queryFn: fetchTodos,
 }))
@@ -89,7 +89,7 @@ createQuery(() => ({
 import { For, Suspense } from 'solid-js'
 
 function Example() {
-  const query = createQuery(() => ({
+  const query = useQuery(() => ({
     queryKey: ['todos'],
     queryFn: fetchTodos,
   }))
@@ -112,7 +112,7 @@ function Example() {
 import {
   QueryClient,
   QueryClientProvider,
-  createQuery,
+  useQuery,
 } from '@tanstack/solid-query'
 import { Match, Switch } from 'solid-js'
 
@@ -137,7 +137,7 @@ function Example() {
   // })
 
   // ✅ solid version -- does not support destructuring outside reactive context
-  const query = createQuery(() => ({
+  const query = useQuery(() => ({
     queryKey: ['repoData'],
     queryFn: () =>
       fetch('https://api.github.com/repos/tannerlinsley/react-query').then(
@@ -170,7 +170,7 @@ function Example() {
 import {
   QueryClient,
   QueryClientProvider,
-  createQuery,
+  useQuery,
 } from '@tanstack/solid-query'
 import { createSignal, For } from 'solid-js'
 
@@ -182,13 +182,13 @@ function Example() {
 
   // ✅ passing a signal directly is safe and observers update
   // automatically when the value of a signal changes
-  const todosQuery = createQuery(() => ({
+  const todosQuery = useQuery(() => ({
     queryKey: ['todos'],
     queryFn: fetchTodos,
     enabled: enabled(),
   }))
 
-  const todoDetailsQuery = createQuery(() => ({
+  const todoDetailsQuery = useQuery(() => ({
     queryKey: ['todo', todo()],
     queryFn: fetchTodo,
     enabled: todo() > 0,

docs/framework/solid/typescript.md

@@ -17,9 +17,9 @@ Things to keep in mind:
 Types in Solid Query generally flow through very well so that you don't have to provide type annotations for yourself
 
 ```tsx
-import { createQuery } from '@tanstack/solid-query'
+import { useQuery } from '@tanstack/solid-query'
 
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['number'],
   queryFn: () => Promise.resolve(5),
 }))
@@ -31,9 +31,9 @@ query.data
 [typescript playground](https://www.typescriptlang.org/play/?#code/JYWwDg9gTgLgBAbzgYygUwIYzQRQK5pQCecAvnAGZQQhwDkAAjBgHYDOzyA1gPRsQAbYABMAtAEcCxOgFgAUPOQR28SYRIBeFOiy4pRABQGAlHA0A+OAYTy4duGuIBpNEQBccANp0WeEACNCOgBdABo4W3tHIgAxFg8TM0sABWoQYDY0ADp0fgEANzQDAFZjeVJjMoU5aKzhLAx5Hh57OAA9AH55brkgA)
 
 ```tsx
-import { createQuery } from '@tanstack/solid-query'
+import { useQuery } from '@tanstack/solid-query'
 
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['test'],
   queryFn: () => Promise.resolve(5),
   select: (data) => data.toString(),
@@ -51,7 +51,7 @@ This works best if your `queryFn` has a well-defined returned type. Keep in mind
 const fetchGroups = (): Promise<Group[]> =>
   axios.get('/groups').then((response) => response.data)
 
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['groups'],
   queryFn: fetchGroups,
 }))
@@ -67,7 +67,7 @@ query.data
 Solid Query uses a [discriminated union type](https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes-func.html#discriminated-unions) for the query result, discriminated by the `status` field and the derived status boolean flags. This will allow you to check for e.g. `success` status to make `data` defined:
 
 ```tsx
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['number'],
   queryFn: () => Promise.resolve(5),
 }))
@@ -85,7 +85,7 @@ if (query.isSuccess) {
 The type for error defaults to `Error`, because that is what most users expect.
 
 ```tsx
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['groups'],
   queryFn: fetchGroups,
 }))
@@ -99,7 +99,7 @@ query.error
 If you want to throw a custom error, or something that isn't an `Error` at all, you can specify the type of the error field:
 
 ```tsx
-const query = createQuery<Group[], string>(() => ({
+const query = useQuery<Group[], string>(() => ({
   queryKey: ['groups'],
   queryFn: fetchGroups,
 }))
@@ -113,7 +113,7 @@ However, this has the drawback that type inference for all other generics of `us
 ```tsx
 import axios from 'axios'
 
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['groups'],
   queryFn: fetchGroups,
 }))
@@ -142,7 +142,7 @@ declare module '@tanstack/solid-query' {
   }
 }
 
-const query = createQuery(() => ({
+const query = useQuery(() => ({
   queryKey: ['groups'],
   queryFn: fetchGroups,
 }))
@@ -153,7 +153,7 @@ query.error
 
 ## Registering global `Meta`
 
-Similarly to registering a [global error type](#registering-a-global-error) you can also register a global `Meta` type. This ensures the optional `meta` field on [queries](../createQuery) and [mutations](../createMutation) stays consistent and is type-safe. Note that the registered type must extend `Record<string, unknown>` so that `meta` remains an object.
+Similarly to registering a [global error type](#registering-a-global-error) you can also register a global `Meta` type. This ensures the optional `meta` field on [queries](../useQuery) and [mutations](../createMutation) stays consistent and is type-safe. Note that the registered type must extend `Record<string, unknown>` so that `meta` remains an object.
 
 ```ts
 import '@tanstack/solid-query'
@@ -172,7 +172,7 @@ declare module '@tanstack/solid-query' {
 
 ## Typing Query Options
 
-If you inline query options into `createQuery`, you'll get automatic type inference. However, you might want to extract the query options into a separate function to share them between `createQuery` and e.g. `prefetchQuery`. In that case, you'd lose type inference. To get it back, you can use `queryOptions` helper:
+If you inline query options into `useQuery`, you'll get automatic type inference. However, you might want to extract the query options into a separate function to share them between `useQuery` and e.g. `prefetchQuery`. In that case, you'd lose type inference. To get it back, you can use `queryOptions` helper:
 
 ```ts
 import { queryOptions } from '@tanstack/solid-query'
@@ -185,7 +185,7 @@ function groupOptions() {
   })
 }
 
-createQuery(groupOptions)
+useQuery(groupOptions)
 queryClient.prefetchQuery(groupOptions())
 ```