Skip to content
Source
Sign inSign up
TanStack/router
Open History to see the last commit

useSearch.tsx

75 lines1.7 KB

1import { useMatch } from './useMatch'
2import type { Accessor } from 'solid-js'
3import type {
4 AnyRouter,
5 RegisteredRouter,
6 ResolveUseSearch,
7 StrictOrFrom,
8 ThrowConstraint,
9 ThrowOrOptional,
10 UseSearchResult,
11} from '@tanstack/router-core'
12​
13export interface UseSearchBaseOptions<
14 TRouter extends AnyRouter,
15 TFrom,
16 TStrict extends boolean,
17 TThrow extends boolean,
18 TSelected,
19> {
20 select?: (state: ResolveUseSearch<TRouter, TFrom, TStrict>) => TSelected
21 shouldThrow?: TThrow
23​
24export type UseSearchOptions<
25 TRouter extends AnyRouter,
26 TFrom,
27 TStrict extends boolean,
28 TThrow extends boolean,
29 TSelected,
30> = StrictOrFrom<TRouter, TFrom, TStrict> &
31 UseSearchBaseOptions<TRouter, TFrom, TStrict, TThrow, TSelected>
32​
33export type UseSearchRoute<out TFrom> = <
34 TRouter extends AnyRouter = RegisteredRouter,
35 TSelected = unknown,
36 TThrow extends boolean = true,
37>(
38 opts?: UseSearchBaseOptions<
39 TRouter,
40 TFrom,
41 /* TStrict */ true,
42 TThrow,
43 TSelected
44 >,
45) => Accessor<
46 ThrowOrOptional<UseSearchResult<TRouter, TFrom, true, TSelected>, TThrow>
48​
49export function useSearch<
50 TRouter extends AnyRouter = RegisteredRouter,
51 const TFrom extends string | undefined = undefined,
52 TStrict extends boolean = true,
53 TThrow extends boolean = true,
54 TSelected = unknown,
55>(
56 opts: UseSearchOptions<
57 TRouter,
58 TFrom,
59 TStrict,
60 ThrowConstraint<TStrict, TThrow>,
61 TSelected
62 >,
63): Accessor<
64 ThrowOrOptional<UseSearchResult<TRouter, TFrom, TStrict, TSelected>, TThrow>
65> {
66 return useMatch({
67 from: opts.from!,
68 strict: opts.strict,
69 shouldThrow: opts.shouldThrow,
70 select: (match) => {
71 const search = match.search
72 return opts.select ? opts.select(search) : search
73 },
74 }) as any