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
						
					
					
				| 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 {};
 |