You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					173 lines
				
				6.5 KiB
			
		
		
			
		
	
	
					173 lines
				
				6.5 KiB
			| 
											3 years ago
										 | import * as React from "react"; | ||
|  | import type { Location, ParamParseKey, Params, Path, PathMatch, PathPattern, Router as RemixRouter, To } from "@remix-run/router"; | ||
|  | import { Action as NavigationType } from "@remix-run/router"; | ||
|  | import type { NavigateOptions, RouteContextObject, RouteMatch, RouteObject, RelativeRoutingType } from "./context"; | ||
|  | /** | ||
|  |  * Returns the full href for the given "to" value. This is useful for building | ||
|  |  * custom links that are also accessible and preserve right-click behavior. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-href
 | ||
|  |  */ | ||
|  | export declare function useHref(to: To, { relative }?: { | ||
|  |     relative?: RelativeRoutingType; | ||
|  | }): string; | ||
|  | /** | ||
|  |  * Returns true if this component is a descendant of a <Router>. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-in-router-context
 | ||
|  |  */ | ||
|  | export declare function useInRouterContext(): boolean; | ||
|  | /** | ||
|  |  * Returns the current location object, which represents the current URL in web | ||
|  |  * browsers. | ||
|  |  * | ||
|  |  * Note: If you're using this it may mean you're doing some of your own | ||
|  |  * "routing" in your app, and we'd like to know what your use case is. We may | ||
|  |  * be able to provide something higher-level to better suit your needs. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-location
 | ||
|  |  */ | ||
|  | export declare function useLocation(): Location; | ||
|  | /** | ||
|  |  * Returns the current navigation action which describes how the router came to | ||
|  |  * the current location, either by a pop, push, or replace on the history stack. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-navigation-type
 | ||
|  |  */ | ||
|  | export declare function useNavigationType(): NavigationType; | ||
|  | /** | ||
|  |  * Returns a PathMatch object if the given pattern matches the current URL. | ||
|  |  * This is useful for components that need to know "active" state, e.g. | ||
|  |  * <NavLink>. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-match
 | ||
|  |  */ | ||
|  | export declare function useMatch<ParamKey extends ParamParseKey<Path>, Path extends string>(pattern: PathPattern<Path> | Path): PathMatch<ParamKey> | null; | ||
|  | /** | ||
|  |  * The interface for the navigate() function returned from useNavigate(). | ||
|  |  */ | ||
|  | export interface NavigateFunction { | ||
|  |     (to: To, options?: NavigateOptions): void; | ||
|  |     (delta: number): void; | ||
|  | } | ||
|  | /** | ||
|  |  * Returns an imperative method for changing the location. Used by <Link>s, but | ||
|  |  * may also be used by other elements to change the location. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-navigate
 | ||
|  |  */ | ||
|  | export declare function useNavigate(): NavigateFunction; | ||
|  | /** | ||
|  |  * Returns the context (if provided) for the child route at this level of the route | ||
|  |  * hierarchy. | ||
|  |  * @see https://reactrouter.com/hooks/use-outlet-context
 | ||
|  |  */ | ||
|  | export declare function useOutletContext<Context = unknown>(): Context; | ||
|  | /** | ||
|  |  * Returns the element for the child route at this level of the route | ||
|  |  * hierarchy. Used internally by <Outlet> to render child routes. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-outlet
 | ||
|  |  */ | ||
|  | export declare function useOutlet(context?: unknown): React.ReactElement | null; | ||
|  | /** | ||
|  |  * Returns an object of key/value pairs of the dynamic params from the current | ||
|  |  * URL that were matched by the route path. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-params
 | ||
|  |  */ | ||
|  | export declare function useParams<ParamsOrKey extends string | Record<string, string | undefined> = string>(): Readonly<[ | ||
|  |     ParamsOrKey | ||
|  | ] extends [string] ? Params<ParamsOrKey> : Partial<ParamsOrKey>>; | ||
|  | /** | ||
|  |  * Resolves the pathname of the given `to` value against the current location. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-resolved-path
 | ||
|  |  */ | ||
|  | export declare function useResolvedPath(to: To, { relative }?: { | ||
|  |     relative?: RelativeRoutingType; | ||
|  | }): Path; | ||
|  | /** | ||
|  |  * Returns the element of the route that matched the current location, prepared | ||
|  |  * with the correct context to render the remainder of the route tree. Route | ||
|  |  * elements in the tree must render an <Outlet> to render their child route's | ||
|  |  * element. | ||
|  |  * | ||
|  |  * @see https://reactrouter.com/hooks/use-routes
 | ||
|  |  */ | ||
|  | export declare function useRoutes(routes: RouteObject[], locationArg?: Partial<Location> | string): React.ReactElement | null; | ||
|  | declare type RenderErrorBoundaryProps = React.PropsWithChildren<{ | ||
|  |     location: Location; | ||
|  |     error: any; | ||
|  |     component: React.ReactNode; | ||
|  |     routeContext: RouteContextObject; | ||
|  | }>; | ||
|  | declare type RenderErrorBoundaryState = { | ||
|  |     location: Location; | ||
|  |     error: any; | ||
|  | }; | ||
|  | export declare class RenderErrorBoundary extends React.Component<RenderErrorBoundaryProps, RenderErrorBoundaryState> { | ||
|  |     constructor(props: RenderErrorBoundaryProps); | ||
|  |     static getDerivedStateFromError(error: any): { | ||
|  |         error: any; | ||
|  |     }; | ||
|  |     static getDerivedStateFromProps(props: RenderErrorBoundaryProps, state: RenderErrorBoundaryState): { | ||
|  |         error: any; | ||
|  |         location: Location; | ||
|  |     }; | ||
|  |     componentDidCatch(error: any, errorInfo: any): void; | ||
|  |     render(): string | number | boolean | React.ReactFragment | JSX.Element | null | undefined; | ||
|  | } | ||
|  | export declare function _renderMatches(matches: RouteMatch[] | null, parentMatches?: RouteMatch[], dataRouterState?: RemixRouter["state"]): React.ReactElement | null; | ||
|  | /** | ||
|  |  * Returns the current navigation, defaulting to an "idle" navigation when | ||
|  |  * no navigation is in progress | ||
|  |  */ | ||
|  | export declare function useNavigation(): import("@remix-run/router").Navigation; | ||
|  | /** | ||
|  |  * Returns a revalidate function for manually triggering revalidation, as well | ||
|  |  * as the current state of any manual revalidations | ||
|  |  */ | ||
|  | export declare function useRevalidator(): { | ||
|  |     revalidate: () => void; | ||
|  |     state: import("@remix-run/router").RevalidationState; | ||
|  | }; | ||
|  | /** | ||
|  |  * Returns the active route matches, useful for accessing loaderData for | ||
|  |  * parent/child routes or the route "handle" property | ||
|  |  */ | ||
|  | export declare function useMatches(): { | ||
|  |     id: string; | ||
|  |     pathname: string; | ||
|  |     params: Params<string>; | ||
|  |     data: unknown; | ||
|  |     handle: unknown; | ||
|  | }[]; | ||
|  | /** | ||
|  |  * Returns the loader data for the nearest ancestor Route loader | ||
|  |  */ | ||
|  | export declare function useLoaderData(): unknown; | ||
|  | /** | ||
|  |  * Returns the loaderData for the given routeId | ||
|  |  */ | ||
|  | export declare function useRouteLoaderData(routeId: string): unknown; | ||
|  | /** | ||
|  |  * Returns the action data for the nearest ancestor Route action | ||
|  |  */ | ||
|  | export declare function useActionData(): unknown; | ||
|  | /** | ||
|  |  * Returns the nearest ancestor Route error, which could be a loader/action | ||
|  |  * error or a render error.  This is intended to be called from your | ||
|  |  * errorElement to display a proper error message. | ||
|  |  */ | ||
|  | export declare function useRouteError(): unknown; | ||
|  | /** | ||
|  |  * Returns the happy-path data from the nearest ancestor <Await /> value | ||
|  |  */ | ||
|  | export declare function useAsyncValue(): unknown; | ||
|  | /** | ||
|  |  * Returns the error from the nearest ancestor <Await /> value | ||
|  |  */ | ||
|  | export declare function useAsyncError(): unknown; | ||
|  | export {}; |