UNPKG

react-router/dist/index.js

Version:
49.8 kBJavaScriptView Raw
1/**
* React Router v6.11.2
*
* Copyright (c) Remix Software Inc.
*
* This source code is licensed under the MIT license found in the
* LICENSE.md file in the root directory of this source tree.
*
* @license MIT
*/
11import * as React from 'react';
12import { UNSAFE_invariant, joinPaths, matchPath, UNSAFE_getPathContributingMatches, UNSAFE_warning, resolveTo, parsePath, matchRoutes, Action, isRouteErrorResponse, createMemoryHistory, stripBasename, AbortedDeferredError, createRouter } from '@remix-run/router';
13export { AbortedDeferredError, Action as NavigationType, createPath, defer, generatePath, isRouteErrorResponse, json, matchPath, matchRoutes, parsePath, redirect, resolvePath } from '@remix-run/router';
14
15function _extends() {
_extends = Object.assign ? Object.assign.bind() : function (target) {
  for (var i = 1; i < arguments.length; i++) {
    var source = arguments[i];
19
    for (var key in source) {
      if (Object.prototype.hasOwnProperty.call(source, key)) {
        target[key] = source[key];
      }
    }
  }
26
  return target;
};
return _extends.apply(this, arguments);
30}
31
32const DataRouterContext = /*#__PURE__*/React.createContext(null);
33
34if (process.env.NODE_ENV !== "production") {
DataRouterContext.displayName = "DataRouter";
36}
37
38const DataRouterStateContext = /*#__PURE__*/React.createContext(null);
39
40if (process.env.NODE_ENV !== "production") {
DataRouterStateContext.displayName = "DataRouterState";
42}
43
44const AwaitContext = /*#__PURE__*/React.createContext(null);
45
46if (process.env.NODE_ENV !== "production") {
AwaitContext.displayName = "Await";
48}
49
50const NavigationContext = /*#__PURE__*/React.createContext(null);
51
52if (process.env.NODE_ENV !== "production") {
NavigationContext.displayName = "Navigation";
54}
55
56const LocationContext = /*#__PURE__*/React.createContext(null);
57
58if (process.env.NODE_ENV !== "production") {
LocationContext.displayName = "Location";
60}
61
62const RouteContext = /*#__PURE__*/React.createContext({
outlet: null,
matches: [],
isDataRoute: false
66});
67
68if (process.env.NODE_ENV !== "production") {
RouteContext.displayName = "Route";
70}
71
72const RouteErrorContext = /*#__PURE__*/React.createContext(null);
73
74if (process.env.NODE_ENV !== "production") {
RouteErrorContext.displayName = "RouteError";
76}
77
78/**
* 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
*/
84
85function useHref(to, _temp) {
let {
  relative
} = _temp === void 0 ? {} : _temp;
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
// router loaded. We can help them understand how to avoid that.
"useHref() may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
let {
  basename,
  navigator
} = React.useContext(NavigationContext);
let {
  hash,
  pathname,
  search
} = useResolvedPath(to, {
  relative
});
let joinedPathname = pathname; // If we're operating within a basename, prepend it to the pathname prior
// to creating the href.  If this is a root navigation, then just use the raw
// basename which allows the basename to have full control over the presence
// of a trailing slash on root links
107
if (basename !== "/") {
  joinedPathname = pathname === "/" ? basename : joinPaths([basename, pathname]);
}
111
return navigator.createHref({
  pathname: joinedPathname,
  search,
  hash
});
117}
118/**
* Returns true if this component is a descendant of a <Router>.
*
* @see https://reactrouter.com/hooks/use-in-router-context
*/
123
124function useInRouterContext() {
return React.useContext(LocationContext) != null;
126}
127/**
* 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
*/
137
138function useLocation() {
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
// router loaded. We can help them understand how to avoid that.
"useLocation() may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
return React.useContext(LocationContext).location;
143}
144/**
* 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
*/
150
151function useNavigationType() {
return React.useContext(LocationContext).navigationType;
153}
154/**
* 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
*/
161
162function useMatch(pattern) {
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
// router loaded. We can help them understand how to avoid that.
"useMatch() may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
let {
  pathname
} = useLocation();
return React.useMemo(() => matchPath(pattern, pathname), [pathname, pattern]);
170}
171/**
* The interface for the navigate() function returned from useNavigate().
*/
174
175const navigateEffectWarning = "You should call navigate() in a React.useEffect(), not when " + "your component is first rendered."; // Mute warnings for calls to useNavigate in SSR environments
176
177function useIsomorphicLayoutEffect(cb) {
let isStatic = React.useContext(NavigationContext).static;
179
if (!isStatic) {
  // We should be able to get rid of this once react 18.3 is released
  // See: https://github.com/facebook/react/pull/26395
  // eslint-disable-next-line react-hooks/rules-of-hooks
  React.useLayoutEffect(cb);
}
186}
187/**
* 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
*/
193
194
195function useNavigate() {
let {
  isDataRoute
} = React.useContext(RouteContext); // Conditional usage is OK here because the usage of a data router is static
// eslint-disable-next-line react-hooks/rules-of-hooks
200
return isDataRoute ? useNavigateStable() : useNavigateUnstable();
202}
203
204function useNavigateUnstable() {
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
// router loaded. We can help them understand how to avoid that.
"useNavigate() may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
let dataRouterContext = React.useContext(DataRouterContext);
let {
  basename,
  navigator
} = React.useContext(NavigationContext);
let {
  matches
} = React.useContext(RouteContext);
let {
  pathname: locationPathname
} = useLocation();
let routePathnamesJson = JSON.stringify(UNSAFE_getPathContributingMatches(matches).map(match => match.pathnameBase));
let activeRef = React.useRef(false);
useIsomorphicLayoutEffect(() => {
  activeRef.current = true;
});
let navigate = React.useCallback(function (to, options) {
  if (options === void 0) {
    options = {};
  }
228
  process.env.NODE_ENV !== "production" ? UNSAFE_warning(activeRef.current, navigateEffectWarning) : void 0; // Short circuit here since if this happens on first render the navigate
  // is useless because we haven't wired up our history listener yet
231
  if (!activeRef.current) return;
233
  if (typeof to === "number") {
    navigator.go(to);
    return;
  }
238
  let path = resolveTo(to, JSON.parse(routePathnamesJson), locationPathname, options.relative === "path"); // If we're operating within a basename, prepend it to the pathname prior
  // to handing off to history (but only if we're not in a data router,
  // otherwise it'll prepend the basename inside of the router).
  // If this is a root navigation, then we navigate to the raw basename
  // which allows the basename to have full control over the presence of a
  // trailing slash on root links
245
  if (dataRouterContext == null && basename !== "/") {
    path.pathname = path.pathname === "/" ? basename : joinPaths([basename, path.pathname]);
  }
249
  (!!options.replace ? navigator.replace : navigator.push)(path, options.state, options);
}, [basename, navigator, routePathnamesJson, locationPathname, dataRouterContext]);
return navigate;
253}
254
255const OutletContext = /*#__PURE__*/React.createContext(null);
256/**
* Returns the context (if provided) for the child route at this level of the route
* hierarchy.
* @see https://reactrouter.com/hooks/use-outlet-context
*/
261
262function useOutletContext() {
return React.useContext(OutletContext);
264}
265/**
* 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
*/
271
272function useOutlet(context) {
let outlet = React.useContext(RouteContext).outlet;
274
if (outlet) {
  return /*#__PURE__*/React.createElement(OutletContext.Provider, {
    value: context
  }, outlet);
}
280
return outlet;
282}
283/**
* 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
*/
289
290function useParams() {
let {
  matches
} = React.useContext(RouteContext);
let routeMatch = matches[matches.length - 1];
return routeMatch ? routeMatch.params : {};
296}
297/**
* Resolves the pathname of the given `to` value against the current location.
*
* @see https://reactrouter.com/hooks/use-resolved-path
*/
302
303function useResolvedPath(to, _temp2) {
let {
  relative
} = _temp2 === void 0 ? {} : _temp2;
let {
  matches
} = React.useContext(RouteContext);
let {
  pathname: locationPathname
} = useLocation();
let routePathnamesJson = JSON.stringify(UNSAFE_getPathContributingMatches(matches).map(match => match.pathnameBase));
return React.useMemo(() => resolveTo(to, JSON.parse(routePathnamesJson), locationPathname, relative === "path"), [to, routePathnamesJson, locationPathname, relative]);
315}
316/**
* 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
*/
324
325function useRoutes(routes, locationArg) {
return useRoutesImpl(routes, locationArg);
327} // Internal implementation with accept optional param for RouterProvider usage
328
329function useRoutesImpl(routes, locationArg, dataRouterState) {
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
// router loaded. We can help them understand how to avoid that.
"useRoutes() may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
let {
  navigator
} = React.useContext(NavigationContext);
let {
  matches: parentMatches
} = React.useContext(RouteContext);
let routeMatch = parentMatches[parentMatches.length - 1];
let parentParams = routeMatch ? routeMatch.params : {};
let parentPathname = routeMatch ? routeMatch.pathname : "/";
let parentPathnameBase = routeMatch ? routeMatch.pathnameBase : "/";
let parentRoute = routeMatch && routeMatch.route;
344
if (process.env.NODE_ENV !== "production") {
  // You won't get a warning about 2 different <Routes> under a <Route>
  // without a trailing *, but this is a best-effort warning anyway since we
  // cannot even give the warning unless they land at the parent route.
  //
  // Example:
  //
  // <Routes>
  //   {/* This route path MUST end with /* because otherwise
  //       it will never match /blog/post/123 */}
  //   <Route path="blog" element={<Blog />} />
  //   <Route path="blog/feed" element={<BlogFeed />} />
  // </Routes>
  //
  // function Blog() {
  //   return (
  //     <Routes>
  //       <Route path="post/:id" element={<Post />} />
  //     </Routes>
  //   );
  // }
  let parentPath = parentRoute && parentRoute.path || "";
  warningOnce(parentPathname, !parentRoute || parentPath.endsWith("*"), "You rendered descendant <Routes> (or called `useRoutes()`) at " + ("\"" + parentPathname + "\" (under <Route path=\"" + parentPath + "\">) but the ") + "parent route path has no trailing \"*\". This means if you navigate " + "deeper, the parent won't match anymore and therefore the child " + "routes will never render.\n\n" + ("Please change the parent <Route path=\"" + parentPath + "\"> to <Route ") + ("path=\"" + (parentPath === "/" ? "*" : parentPath + "/*") + "\">."));
}
369
let locationFromContext = useLocation();
let location;
372
if (locationArg) {
  var _parsedLocationArg$pa;
375
  let parsedLocationArg = typeof locationArg === "string" ? parsePath(locationArg) : locationArg;
  !(parentPathnameBase === "/" || ((_parsedLocationArg$pa = parsedLocationArg.pathname) == null ? void 0 : _parsedLocationArg$pa.startsWith(parentPathnameBase))) ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "When overriding the location using `<Routes location>` or `useRoutes(routes, location)`, " + "the location pathname must begin with the portion of the URL pathname that was " + ("matched by all parent routes. The current pathname base is \"" + parentPathnameBase + "\" ") + ("but pathname \"" + parsedLocationArg.pathname + "\" was given in the `location` prop.")) : UNSAFE_invariant(false) : void 0;
  location = parsedLocationArg;
} else {
  location = locationFromContext;
}
382
let pathname = location.pathname || "/";
let remainingPathname = parentPathnameBase === "/" ? pathname : pathname.slice(parentPathnameBase.length) || "/";
let matches = matchRoutes(routes, {
  pathname: remainingPathname
});
388
if (process.env.NODE_ENV !== "production") {
  process.env.NODE_ENV !== "production" ? UNSAFE_warning(parentRoute || matches != null, "No routes matched location \"" + location.pathname + location.search + location.hash + "\" ") : void 0;
  process.env.NODE_ENV !== "production" ? UNSAFE_warning(matches == null || matches[matches.length - 1].route.element !== undefined || matches[matches.length - 1].route.Component !== undefined, "Matched leaf route at location \"" + location.pathname + location.search + location.hash + "\" " + "does not have an element or Component. This means it will render an <Outlet /> with a " + "null value by default resulting in an \"empty\" page.") : void 0;
}
393
let renderedMatches = _renderMatches(matches && matches.map(match => Object.assign({}, match, {
  params: Object.assign({}, parentParams, match.params),
  pathname: joinPaths([parentPathnameBase, // Re-encode pathnames that were decoded inside matchRoutes
  navigator.encodeLocation ? navigator.encodeLocation(match.pathname).pathname : match.pathname]),
  pathnameBase: match.pathnameBase === "/" ? parentPathnameBase : joinPaths([parentPathnameBase, // Re-encode pathnames that were decoded inside matchRoutes
  navigator.encodeLocation ? navigator.encodeLocation(match.pathnameBase).pathname : match.pathnameBase])
})), parentMatches, dataRouterState); // When a user passes in a `locationArg`, the associated routes need to
// be wrapped in a new `LocationContext.Provider` in order for `useLocation`
// to use the scoped location instead of the global location.
403
404
if (locationArg && renderedMatches) {
  return /*#__PURE__*/React.createElement(LocationContext.Provider, {
    value: {
      location: _extends({
        pathname: "/",
        search: "",
        hash: "",
        state: null,
        key: "default"
      }, location),
      navigationType: Action.Pop
    }
  }, renderedMatches);
}
419
return renderedMatches;
421}
422
423function DefaultErrorComponent() {
let error = useRouteError();
let message = isRouteErrorResponse(error) ? error.status + " " + error.statusText : error instanceof Error ? error.message : JSON.stringify(error);
let stack = error instanceof Error ? error.stack : null;
let lightgrey = "rgba(200,200,200, 0.5)";
let preStyles = {
  padding: "0.5rem",
  backgroundColor: lightgrey
};
let codeStyles = {
  padding: "2px 4px",
  backgroundColor: lightgrey
};
let devInfo = null;
437
if (process.env.NODE_ENV !== "production") {
  console.error("Error handled by React Router default ErrorBoundary:", error);
  devInfo = /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("p", null, "\uD83D\uDCBF Hey developer \uD83D\uDC4B"), /*#__PURE__*/React.createElement("p", null, "You can provide a way better UX than this when your app throws errors by providing your own ", /*#__PURE__*/React.createElement("code", {
    style: codeStyles
  }, "ErrorBoundary"), " or", " ", /*#__PURE__*/React.createElement("code", {
    style: codeStyles
  }, "errorElement"), " prop on your route."));
}
446
return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("h2", null, "Unexpected Application Error!"), /*#__PURE__*/React.createElement("h3", {
  style: {
    fontStyle: "italic"
  }
}, message), stack ? /*#__PURE__*/React.createElement("pre", {
  style: preStyles
}, stack) : null, devInfo);
454}
455
456const defaultErrorElement = /*#__PURE__*/React.createElement(DefaultErrorComponent, null);
457class RenderErrorBoundary extends React.Component {
constructor(props) {
  super(props);
  this.state = {
    location: props.location,
    revalidation: props.revalidation,
    error: props.error
  };
}
466
static getDerivedStateFromError(error) {
  return {
    error: error
  };
}
472
static getDerivedStateFromProps(props, state) {
  // When we get into an error state, the user will likely click "back" to the
  // previous page that didn't have an error. Because this wraps the entire
  // application, that will have no effect--the error page continues to display.
  // This gives us a mechanism to recover from the error when the location changes.
  //
  // Whether we're in an error state or not, we update the location in state
  // so that when we are in an error state, it gets reset when a new location
  // comes in and the user recovers from the error.
  if (state.location !== props.location || state.revalidation !== "idle" && props.revalidation === "idle") {
    return {
      error: props.error,
      location: props.location,
      revalidation: props.revalidation
    };
  } // If we're not changing locations, preserve the location but still surface
  // any new errors that may come through. We retain the existing error, we do
  // this because the error provided from the app state may be cleared without
  // the location changing.
492
493
  return {
    error: props.error || state.error,
    location: state.location,
    revalidation: props.revalidation || state.revalidation
  };
}
500
componentDidCatch(error, errorInfo) {
  console.error("React Router caught the following error during render", error, errorInfo);
}
504
render() {
  return this.state.error ? /*#__PURE__*/React.createElement(RouteContext.Provider, {
    value: this.props.routeContext
  }, /*#__PURE__*/React.createElement(RouteErrorContext.Provider, {
    value: this.state.error,
    children: this.props.component
  })) : this.props.children;
}
513
514}
515
516function RenderedRoute(_ref) {
let {
  routeContext,
  match,
  children
} = _ref;
let dataRouterContext = React.useContext(DataRouterContext); // Track how deep we got in our render pass to emulate SSR componentDidCatch
// in a DataStaticRouter
524
if (dataRouterContext && dataRouterContext.static && dataRouterContext.staticContext && (match.route.errorElement || match.route.ErrorBoundary)) {
  dataRouterContext.staticContext._deepestRenderedBoundaryId = match.route.id;
}
528
return /*#__PURE__*/React.createElement(RouteContext.Provider, {
  value: routeContext
}, children);
532}
533
534function _renderMatches(matches, parentMatches, dataRouterState) {
var _dataRouterState2;
536
if (parentMatches === void 0) {
  parentMatches = [];
}
540
if (dataRouterState === void 0) {
  dataRouterState = null;
}
544
if (matches == null) {
  var _dataRouterState;
547
  if ((_dataRouterState = dataRouterState) != null && _dataRouterState.errors) {
    // Don't bail if we have data router errors so we can render them in the
    // boundary.  Use the pre-matched (or shimmed) matches
    matches = dataRouterState.matches;
  } else {
    return null;
  }
}
556
let renderedMatches = matches; // If we have data errors, trim matches to the highest error boundary
558
let errors = (_dataRouterState2 = dataRouterState) == null ? void 0 : _dataRouterState2.errors;
560
if (errors != null) {
  let errorIndex = renderedMatches.findIndex(m => m.route.id && (errors == null ? void 0 : errors[m.route.id]));
  !(errorIndex >= 0) ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "Could not find a matching route for errors on route IDs: " + Object.keys(errors).join(",")) : UNSAFE_invariant(false) : void 0;
  renderedMatches = renderedMatches.slice(0, Math.min(renderedMatches.length, errorIndex + 1));
}
566
return renderedMatches.reduceRight((outlet, match, index) => {
  let error = match.route.id ? errors == null ? void 0 : errors[match.route.id] : null; // Only data routers handle errors
569
  let errorElement = null;
571
  if (dataRouterState) {
    errorElement = match.route.errorElement || defaultErrorElement;
  }
575
  let matches = parentMatches.concat(renderedMatches.slice(0, index + 1));
577
  let getChildren = () => {
    let children;
580
    if (error) {
      children = errorElement;
    } else if (match.route.Component) {
      // Note: This is a de-optimized path since React won't re-use the
      // ReactElement since it's identity changes with each new
      // React.createElement call.  We keep this so folks can use
      // `<Route Component={...}>` in `<Routes>` but generally `Component`
      // usage is only advised in `RouterProvider` when we can convert it to
      // `element` ahead of time.
      children = /*#__PURE__*/React.createElement(match.route.Component, null);
    } else if (match.route.element) {
      children = match.route.element;
    } else {
      children = outlet;
    }
596
    return /*#__PURE__*/React.createElement(RenderedRoute, {
      match: match,
      routeContext: {
        outlet,
        matches,
        isDataRoute: dataRouterState != null
      },
      children: children
    });
  }; // Only wrap in an error boundary within data router usages when we have an
  // ErrorBoundary/errorElement on this route.  Otherwise let it bubble up to
  // an ancestor ErrorBoundary/errorElement
609
610
  return dataRouterState && (match.route.ErrorBoundary || match.route.errorElement || index === 0) ? /*#__PURE__*/React.createElement(RenderErrorBoundary, {
    location: dataRouterState.location,
    revalidation: dataRouterState.revalidation,
    component: errorElement,
    error: error,
    children: getChildren(),
    routeContext: {
      outlet: null,
      matches,
      isDataRoute: true
    }
  }) : getChildren();
}, null);
624}
625var DataRouterHook;
626
627(function (DataRouterHook) {
DataRouterHook["UseBlocker"] = "useBlocker";
DataRouterHook["UseRevalidator"] = "useRevalidator";
DataRouterHook["UseNavigateStable"] = "useNavigate";
631})(DataRouterHook || (DataRouterHook = {}));
632
633var DataRouterStateHook;
634
635(function (DataRouterStateHook) {
DataRouterStateHook["UseBlocker"] = "useBlocker";
DataRouterStateHook["UseLoaderData"] = "useLoaderData";
DataRouterStateHook["UseActionData"] = "useActionData";
DataRouterStateHook["UseRouteError"] = "useRouteError";
DataRouterStateHook["UseNavigation"] = "useNavigation";
DataRouterStateHook["UseRouteLoaderData"] = "useRouteLoaderData";
DataRouterStateHook["UseMatches"] = "useMatches";
DataRouterStateHook["UseRevalidator"] = "useRevalidator";
DataRouterStateHook["UseNavigateStable"] = "useNavigate";
DataRouterStateHook["UseRouteId"] = "useRouteId";
646})(DataRouterStateHook || (DataRouterStateHook = {}));
647
648function getDataRouterConsoleError(hookName) {
return hookName + " must be used within a data router.  See https://reactrouter.com/routers/picking-a-router.";
650}
651
652function useDataRouterContext(hookName) {
let ctx = React.useContext(DataRouterContext);
!ctx ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, getDataRouterConsoleError(hookName)) : UNSAFE_invariant(false) : void 0;
return ctx;
656}
657
658function useDataRouterState(hookName) {
let state = React.useContext(DataRouterStateContext);
!state ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, getDataRouterConsoleError(hookName)) : UNSAFE_invariant(false) : void 0;
return state;
662}
663
664function useRouteContext(hookName) {
let route = React.useContext(RouteContext);
!route ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, getDataRouterConsoleError(hookName)) : UNSAFE_invariant(false) : void 0;
return route;
668} // Internal version with hookName-aware debugging
669
670
671function useCurrentRouteId(hookName) {
let route = useRouteContext(hookName);
let thisRoute = route.matches[route.matches.length - 1];
!thisRoute.route.id ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, hookName + " can only be used on routes that contain a unique \"id\"") : UNSAFE_invariant(false) : void 0;
return thisRoute.route.id;
676}
677/**
* Returns the ID for the nearest contextual route
*/
680
681
682function useRouteId() {
return useCurrentRouteId(DataRouterStateHook.UseRouteId);
684}
685/**
* Returns the current navigation, defaulting to an "idle" navigation when
* no navigation is in progress
*/
689
690function useNavigation() {
let state = useDataRouterState(DataRouterStateHook.UseNavigation);
return state.navigation;
693}
694/**
* Returns a revalidate function for manually triggering revalidation, as well
* as the current state of any manual revalidations
*/
698
699function useRevalidator() {
let dataRouterContext = useDataRouterContext(DataRouterHook.UseRevalidator);
let state = useDataRouterState(DataRouterStateHook.UseRevalidator);
return {
  revalidate: dataRouterContext.router.revalidate,
  state: state.revalidation
};
706}
707/**
* Returns the active route matches, useful for accessing loaderData for
* parent/child routes or the route "handle" property
*/
711
712function useMatches() {
let {
  matches,
  loaderData
} = useDataRouterState(DataRouterStateHook.UseMatches);
return React.useMemo(() => matches.map(match => {
  let {
    pathname,
    params
  } = match; // Note: This structure matches that created by createUseMatchesMatch
  // in the @remix-run/router , so if you change this please also change
  // that :)  Eventually we'll DRY this up
724
  return {
    id: match.route.id,
    pathname,
    params,
    data: loaderData[match.route.id],
    handle: match.route.handle
  };
}), [matches, loaderData]);
733}
734/**
* Returns the loader data for the nearest ancestor Route loader
*/
737
738function useLoaderData() {
let state = useDataRouterState(DataRouterStateHook.UseLoaderData);
let routeId = useCurrentRouteId(DataRouterStateHook.UseLoaderData);
741
if (state.errors && state.errors[routeId] != null) {
  console.error("You cannot `useLoaderData` in an errorElement (routeId: " + routeId + ")");
  return undefined;
}
746
return state.loaderData[routeId];
748}
749/**
* Returns the loaderData for the given routeId
*/
752
753function useRouteLoaderData(routeId) {
let state = useDataRouterState(DataRouterStateHook.UseRouteLoaderData);
return state.loaderData[routeId];
756}
757/**
* Returns the action data for the nearest ancestor Route action
*/
760
761function useActionData() {
let state = useDataRouterState(DataRouterStateHook.UseActionData);
let route = React.useContext(RouteContext);
!route ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "useActionData must be used inside a RouteContext") : UNSAFE_invariant(false) : void 0;
return Object.values((state == null ? void 0 : state.actionData) || {})[0];
766}
767/**
* 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
* ErrorBoundary/errorElement to display a proper error message.
*/
772
773function useRouteError() {
var _state$errors;
775
let error = React.useContext(RouteErrorContext);
let state = useDataRouterState(DataRouterStateHook.UseRouteError);
let routeId = useCurrentRouteId(DataRouterStateHook.UseRouteError); // If this was a render error, we put it in a RouteError context inside
// of RenderErrorBoundary
780
if (error) {
  return error;
} // Otherwise look for errors from our data router state
784
785
return (_state$errors = state.errors) == null ? void 0 : _state$errors[routeId];
787}
788/**
* Returns the happy-path data from the nearest ancestor <Await /> value
*/
791
792function useAsyncValue() {
let value = React.useContext(AwaitContext);
return value == null ? void 0 : value._data;
795}
796/**
* Returns the error from the nearest ancestor <Await /> value
*/
799
800function useAsyncError() {
let value = React.useContext(AwaitContext);
return value == null ? void 0 : value._error;
803}
804let blockerId = 0;
805/**
* Allow the application to block navigations within the SPA and present the
* user a confirmation dialog to confirm the navigation.  Mostly used to avoid
* using half-filled form data.  This does not handle hard-reloads or
* cross-origin navigations.
*/
811
812function useBlocker(shouldBlock) {
let {
  router
} = useDataRouterContext(DataRouterHook.UseBlocker);
let state = useDataRouterState(DataRouterStateHook.UseBlocker);
let [blockerKey] = React.useState(() => String(++blockerId));
let blockerFunction = React.useCallback(args => {
  return typeof shouldBlock === "function" ? !!shouldBlock(args) : !!shouldBlock;
}, [shouldBlock]);
let blocker = router.getBlocker(blockerKey, blockerFunction); // Cleanup on unmount
822
React.useEffect(() => () => router.deleteBlocker(blockerKey), [router, blockerKey]); // Prefer the blocker from state since DataRouterContext is memoized so this
// ensures we update on blocker state updates
825
return state.blockers.get(blockerKey) || blocker;
827}
828/**
* Stable version of useNavigate that is used when we are in the context of
* a RouterProvider.
*/
832
833function useNavigateStable() {
let {
  router
} = useDataRouterContext(DataRouterHook.UseNavigateStable);
let id = useCurrentRouteId(DataRouterStateHook.UseNavigateStable);
let activeRef = React.useRef(false);
useIsomorphicLayoutEffect(() => {
  activeRef.current = true;
});
let navigate = React.useCallback(function (to, options) {
  if (options === void 0) {
    options = {};
  }
846
  process.env.NODE_ENV !== "production" ? UNSAFE_warning(activeRef.current, navigateEffectWarning) : void 0; // Short circuit here since if this happens on first render the navigate
  // is useless because we haven't wired up our router subscriber yet
849
  if (!activeRef.current) return;
851
  if (typeof to === "number") {
    router.navigate(to);
  } else {
    router.navigate(to, _extends({
      fromRouteId: id
    }, options));
  }
}, [router, id]);
return navigate;
861}
862
863const alreadyWarned = {};
864
865function warningOnce(key, cond, message) {
if (!cond && !alreadyWarned[key]) {
  alreadyWarned[key] = true;
  process.env.NODE_ENV !== "production" ? UNSAFE_warning(false, message) : void 0;
}
870}
871
872/**
* Given a Remix Router instance, render the appropriate UI
*/
875function RouterProvider(_ref) {
let {
  fallbackElement,
  router
} = _ref;
// Need to use a layout effect here so we are subscribed early enough to
// pick up on any render-driven redirects/navigations (useEffect/<Navigate>)
let [state, setState] = React.useState(router.state);
React.useLayoutEffect(() => router.subscribe(setState), [router, setState]);
let navigator = React.useMemo(() => {
  return {
    createHref: router.createHref,
    encodeLocation: router.encodeLocation,
    go: n => router.navigate(n),
    push: (to, state, opts) => router.navigate(to, {
      state,
      preventScrollReset: opts == null ? void 0 : opts.preventScrollReset
    }),
    replace: (to, state, opts) => router.navigate(to, {
      replace: true,
      state,
      preventScrollReset: opts == null ? void 0 : opts.preventScrollReset
    })
  };
}, [router]);
let basename = router.basename || "/";
let dataRouterContext = React.useMemo(() => ({
  router,
  navigator,
  static: false,
  basename
}), [router, navigator, basename]); // The fragment and {null} here are important!  We need them to keep React 18's
// useId happy when we are server-rendering since we may have a <script> here
// containing the hydrated server-side staticContext (from StaticRouterProvider).
// useId relies on the component tree structure to generate deterministic id's
// so we need to ensure it remains the same on the client even though
// we don't need the <script> tag
912
return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(DataRouterContext.Provider, {
  value: dataRouterContext
}, /*#__PURE__*/React.createElement(DataRouterStateContext.Provider, {
  value: state
}, /*#__PURE__*/React.createElement(Router, {
  basename: router.basename,
  location: router.state.location,
  navigationType: router.state.historyAction,
  navigator: navigator
}, router.state.initialized ? /*#__PURE__*/React.createElement(DataRoutes, {
  routes: router.routes,
  state: state
}) : fallbackElement))), null);
926}
927
928function DataRoutes(_ref2) {
let {
  routes,
  state
} = _ref2;
return useRoutesImpl(routes, undefined, state);
934}
935
936/**
* A <Router> that stores all entries in memory.
*
* @see https://reactrouter.com/router-components/memory-router
*/
941function MemoryRouter(_ref3) {
let {
  basename,
  children,
  initialEntries,
  initialIndex
} = _ref3;
let historyRef = React.useRef();
949
if (historyRef.current == null) {
  historyRef.current = createMemoryHistory({
    initialEntries,
    initialIndex,
    v5Compat: true
  });
}
957
let history = historyRef.current;
let [state, setState] = React.useState({
  action: history.action,
  location: history.location
});
React.useLayoutEffect(() => history.listen(setState), [history]);
return /*#__PURE__*/React.createElement(Router, {
  basename: basename,
  children: children,
  location: state.location,
  navigationType: state.action,
  navigator: history
});
971}
972
973/**
* Changes the current location.
*
* Note: This API is mostly useful in React.Component subclasses that are not
* able to use hooks. In functional components, we recommend you use the
* `useNavigate` hook instead.
*
* @see https://reactrouter.com/components/navigate
*/
982function Navigate(_ref4) {
let {
  to,
  replace,
  state,
  relative
} = _ref4;
!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of
// the router loaded. We can help them understand how to avoid that.
"<Navigate> may be used only in the context of a <Router> component.") : UNSAFE_invariant(false) : void 0;
process.env.NODE_ENV !== "production" ? UNSAFE_warning(!React.useContext(NavigationContext).static, "<Navigate> must not be used on the initial render in a <StaticRouter>. " + "This is a no-op, but you should modify your code so the <Navigate> is " + "only ever rendered in response to some user interaction or state change.") : void 0;
let {
  matches
} = React.useContext(RouteContext);
let {
  pathname: locationPathname
} = useLocation();
let navigate = useNavigate(); // Resolve the path outside of the effect so that when effects run twice in
// StrictMode they navigate to the same place
1001
let path = resolveTo(to, UNSAFE_getPathContributingMatches(matches).map(match => match.pathnameBase), locationPathname, relative === "path");
let jsonPath = JSON.stringify(path);
React.useEffect(() => navigate(JSON.parse(jsonPath), {
  replace,
  state,
  relative
}), [navigate, jsonPath, relative, replace, state]);
return null;
1010}
1011
1012/**
* Renders the child route's element, if there is one.
*
* @see https://reactrouter.com/components/outlet
*/
1017function Outlet(props) {
return useOutlet(props.context);
1019}
1020
1021/**
* Declares an element that should be rendered at a certain URL path.
*
* @see https://reactrouter.com/components/route
*/
1026function Route(_props) {
process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "A <Route> is only ever to be used as the child of <Routes> element, " + "never rendered directly. Please wrap your <Route> in a <Routes>.") : UNSAFE_invariant(false) ;
1028}
1029
1030/**
* Provides location context for the rest of the app.
*
* Note: You usually won't render a <Router> directly. Instead, you'll render a
* router that is more specific to your environment such as a <BrowserRouter>
* in web browsers or a <StaticRouter> for server rendering.
*
* @see https://reactrouter.com/router-components/router
*/
1039function Router(_ref5) {
let {
  basename: basenameProp = "/",
  children = null,
  location: locationProp,
  navigationType = Action.Pop,
  navigator,
  static: staticProp = false
} = _ref5;
!!useInRouterContext() ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "You cannot render a <Router> inside another <Router>." + " You should never have more than one in your app.") : UNSAFE_invariant(false) : void 0; // Preserve trailing slashes on basename, so we can let the user control
// the enforcement of trailing slashes throughout the app
1050
let basename = basenameProp.replace(/^\/*/, "/");
let navigationContext = React.useMemo(() => ({
  basename,
  navigator,
  static: staticProp
}), [basename, navigator, staticProp]);
1057
if (typeof locationProp === "string") {
  locationProp = parsePath(locationProp);
}
1061
let {
  pathname = "/",
  search = "",
  hash = "",
  state = null,
  key = "default"
} = locationProp;
let locationContext = React.useMemo(() => {
  let trailingPathname = stripBasename(pathname, basename);
1071
  if (trailingPathname == null) {
    return null;
  }
1075
  return {
    location: {
      pathname: trailingPathname,
      search,
      hash,
      state,
      key
    },
    navigationType
  };
}, [basename, pathname, search, hash, state, key, navigationType]);
process.env.NODE_ENV !== "production" ? UNSAFE_warning(locationContext != null, "<Router basename=\"" + basename + "\"> is not able to match the URL " + ("\"" + pathname + search + hash + "\" because it does not start with the ") + "basename, so the <Router> won't render anything.") : void 0;
1088
if (locationContext == null) {
  return null;
}
1092
return /*#__PURE__*/React.createElement(NavigationContext.Provider, {
  value: navigationContext
}, /*#__PURE__*/React.createElement(LocationContext.Provider, {
  children: children,
  value: locationContext
}));
1099}
1100
1101/**
* A container for a nested tree of <Route> elements that renders the branch
* that best matches the current location.
*
* @see https://reactrouter.com/components/routes
*/
1107function Routes(_ref6) {
let {
  children,
  location
} = _ref6;
return useRoutes(createRoutesFromChildren(children), location);
1113}
1114
1115/**
* Component to use for rendering lazily loaded data from returning defer()
* in a loader function
*/
1119function Await(_ref7) {
let {
  children,
  errorElement,
  resolve
} = _ref7;
return /*#__PURE__*/React.createElement(AwaitErrorBoundary, {
  resolve: resolve,
  errorElement: errorElement
}, /*#__PURE__*/React.createElement(ResolveAwait, null, children));
1129}
1130var AwaitRenderStatus;
1131
1132(function (AwaitRenderStatus) {
AwaitRenderStatus[AwaitRenderStatus["pending"] = 0] = "pending";
AwaitRenderStatus[AwaitRenderStatus["success"] = 1] = "success";
AwaitRenderStatus[AwaitRenderStatus["error"] = 2] = "error";
1136})(AwaitRenderStatus || (AwaitRenderStatus = {}));
1137
1138const neverSettledPromise = new Promise(() => {});
1139
1140class AwaitErrorBoundary extends React.Component {
constructor(props) {
  super(props);
  this.state = {
    error: null
  };
}
1147
static getDerivedStateFromError(error) {
  return {
    error
  };
}
1153
componentDidCatch(error, errorInfo) {
  console.error("<Await> caught the following error during render", error, errorInfo);
}
1157
render() {
  let {
    children,
    errorElement,
    resolve
  } = this.props;
  let promise = null;
  let status = AwaitRenderStatus.pending;
1166
  if (!(resolve instanceof Promise)) {
    // Didn't get a promise - provide as a resolved promise
    status = AwaitRenderStatus.success;
    promise = Promise.resolve();
    Object.defineProperty(promise, "_tracked", {
      get: () => true
    });
    Object.defineProperty(promise, "_data", {
      get: () => resolve
    });
  } else if (this.state.error) {
    // Caught a render error, provide it as a rejected promise
    status = AwaitRenderStatus.error;
    let renderError = this.state.error;
    promise = Promise.reject().catch(() => {}); // Avoid unhandled rejection warnings
1182
    Object.defineProperty(promise, "_tracked", {
      get: () => true
    });
    Object.defineProperty(promise, "_error", {
      get: () => renderError
    });
  } else if (resolve._tracked) {
    // Already tracked promise - check contents
    promise = resolve;
    status = promise._error !== undefined ? AwaitRenderStatus.error : promise._data !== undefined ? AwaitRenderStatus.success : AwaitRenderStatus.pending;
  } else {
    // Raw (untracked) promise - track it
    status = AwaitRenderStatus.pending;
    Object.defineProperty(resolve, "_tracked", {
      get: () => true
    });
    promise = resolve.then(data => Object.defineProperty(resolve, "_data", {
      get: () => data
    }), error => Object.defineProperty(resolve, "_error", {
      get: () => error
    }));
  }
1205
  if (status === AwaitRenderStatus.error && promise._error instanceof AbortedDeferredError) {
    // Freeze the UI by throwing a never resolved promise
    throw neverSettledPromise;
  }
1210
  if (status === AwaitRenderStatus.error && !errorElement) {
    // No errorElement, throw to the nearest route-level error boundary
    throw promise._error;
  }
1215
  if (status === AwaitRenderStatus.error) {
    // Render via our errorElement
    return /*#__PURE__*/React.createElement(AwaitContext.Provider, {
      value: promise,
      children: errorElement
    });
  }
1223
  if (status === AwaitRenderStatus.success) {
    // Render children with resolved value
    return /*#__PURE__*/React.createElement(AwaitContext.Provider, {
      value: promise,
      children: children
    });
  } // Throw to the suspense boundary
1231
1232
  throw promise;
}
1235
1236}
1237/**
* @private
* Indirection to leverage useAsyncValue for a render-prop API on <Await>
*/
1241
1242
1243function ResolveAwait(_ref8) {
let {
  children
} = _ref8;
let data = useAsyncValue();
let toRender = typeof children === "function" ? children(data) : children;
return /*#__PURE__*/React.createElement(React.Fragment, null, toRender);
1250} ///////////////////////////////////////////////////////////////////////////////
1251// UTILS
1252///////////////////////////////////////////////////////////////////////////////
1253
1254/**
* Creates a route config from a React "children" object, which is usually
* either a `<Route>` element or an array of them. Used internally by
* `<Routes>` to create a route config from its children.
*
* @see https://reactrouter.com/utils/create-routes-from-children
*/
1261
1262
1263function createRoutesFromChildren(children, parentPath) {
if (parentPath === void 0) {
  parentPath = [];
}
1267
let routes = [];
React.Children.forEach(children, (element, index) => {
  if (! /*#__PURE__*/React.isValidElement(element)) {
    // Ignore non-elements. This allows people to more easily inline
    // conditionals in their route config.
    return;
  }
1275
  let treePath = [...parentPath, index];
1277
  if (element.type === React.Fragment) {
    // Transparently support React.Fragment and its children.
    routes.push.apply(routes, createRoutesFromChildren(element.props.children, treePath));
    return;
  }
1283
  !(element.type === Route) ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "[" + (typeof element.type === "string" ? element.type : element.type.name) + "] is not a <Route> component. All component children of <Routes> must be a <Route> or <React.Fragment>") : UNSAFE_invariant(false) : void 0;
  !(!element.props.index || !element.props.children) ? process.env.NODE_ENV !== "production" ? UNSAFE_invariant(false, "An index route cannot have child routes.") : UNSAFE_invariant(false) : void 0;
  let route = {
    id: element.props.id || treePath.join("-"),
    caseSensitive: element.props.caseSensitive,
    element: element.props.element,
    Component: element.props.Component,
    index: element.props.index,
    path: element.props.path,
    loader: element.props.loader,
    action: element.props.action,
    errorElement: element.props.errorElement,
    ErrorBoundary: element.props.ErrorBoundary,
    hasErrorBoundary: element.props.ErrorBoundary != null || element.props.errorElement != null,
    shouldRevalidate: element.props.shouldRevalidate,
    handle: element.props.handle,
    lazy: element.props.lazy
  };
1302
  if (element.props.children) {
    route.children = createRoutesFromChildren(element.props.children, treePath);
  }
1306
  routes.push(route);
});
return routes;
1310}
1311/**
* Renders the result of `matchRoutes()` into a React element.
*/
1314
1315function renderMatches(matches) {
return _renderMatches(matches);
1317}
1318
1319function mapRouteProperties(route) {
let updates = {
  // Note: this check also occurs in createRoutesFromChildren so update
  // there if you change this -- please and thank you!
  hasErrorBoundary: route.ErrorBoundary != null || route.errorElement != null
};
1325
if (route.Component) {
  if (process.env.NODE_ENV !== "production") {
    if (route.element) {
      process.env.NODE_ENV !== "production" ? UNSAFE_warning(false, "You should not include both `Component` and `element` on your route - " + "`Component` will be used.") : void 0;
    }
  }
1332
  Object.assign(updates, {
    element: /*#__PURE__*/React.createElement(route.Component),
    Component: undefined
  });
}
1338
if (route.ErrorBoundary) {
  if (process.env.NODE_ENV !== "production") {
    if (route.errorElement) {
      process.env.NODE_ENV !== "production" ? UNSAFE_warning(false, "You should not include both `ErrorBoundary` and `errorElement` on your route - " + "`ErrorBoundary` will be used.") : void 0;
    }
  }
1345
  Object.assign(updates, {
    errorElement: /*#__PURE__*/React.createElement(route.ErrorBoundary),
    ErrorBoundary: undefined
  });
}
1351
return updates;
1353}
1354
1355function createMemoryRouter(routes, opts) {
return createRouter({
  basename: opts == null ? void 0 : opts.basename,
  future: _extends({}, opts == null ? void 0 : opts.future, {
    v7_prependBasename: true
  }),
  history: createMemoryHistory({
    initialEntries: opts == null ? void 0 : opts.initialEntries,
    initialIndex: opts == null ? void 0 : opts.initialIndex
  }),
  hydrationData: opts == null ? void 0 : opts.hydrationData,
  routes,
  mapRouteProperties
}).initialize();
1369} ///////////////////////////////////////////////////////////////////////////////
1370
1371export { Await, MemoryRouter, Navigate, Outlet, Route, Router, RouterProvider, Routes, DataRouterContext as UNSAFE_DataRouterContext, DataRouterStateContext as UNSAFE_DataRouterStateContext, LocationContext as UNSAFE_LocationContext, NavigationContext as UNSAFE_NavigationContext, RouteContext as UNSAFE_RouteContext, mapRouteProperties as UNSAFE_mapRouteProperties, useRouteId as UNSAFE_useRouteId, useRoutesImpl as UNSAFE_useRoutesImpl, createMemoryRouter, createRoutesFromChildren, createRoutesFromChildren as createRoutesFromElements, renderMatches, useBlocker as unstable_useBlocker, useActionData, useAsyncError, useAsyncValue, useHref, useInRouterContext, useLoaderData, useLocation, useMatch, useMatches, useNavigate, useNavigation, useNavigationType, useOutlet, useOutletContext, useParams, useResolvedPath, useRevalidator, useRouteError, useRouteLoaderData, useRoutes };
1372//# sourceMappingURL=index.js.map
1	`/**`
2	`* React Router v6.11.2`
3	`*`
4	`* Copyright (c) Remix Software Inc.`
5	`*`
6	`* This source code is licensed under the MIT license found in the`
7	`* LICENSE.md file in the root directory of this source tree.`
8	`*`
9	`* @license MIT`
10	`*/`
11	`import * as React from 'react';`
12	`import { UNSAFE_invariant, joinPaths, matchPath, UNSAFE_getPathContributingMatches, UNSAFE_warning, resolveTo, parsePath, matchRoutes, Action, isRouteErrorResponse, createMemoryHistory, stripBasename, AbortedDeferredError, createRouter } from '@remix-run/router';`
13	`export { AbortedDeferredError, Action as NavigationType, createPath, defer, generatePath, isRouteErrorResponse, json, matchPath, matchRoutes, parsePath, redirect, resolvePath } from '@remix-run/router';`
14
15	`function _extends() {`
16	`_extends = Object.assign ? Object.assign.bind() : function (target) {`
17	`for (var i = 1; i < arguments.length; i++) {`
18	`var source = arguments[i];`
19
20	`for (var key in source) {`
21	`if (Object.prototype.hasOwnProperty.call(source, key)) {`
22	`target[key] = source[key];`
23	`}`
24	`}`
25	`}`
26
27	`return target;`
28	`};`
29	`return _extends.apply(this, arguments);`
30	`}`
31
32	`const DataRouterContext = /#__PURE__/React.createContext(null);`
33
34	`if (process.env.NODE_ENV !== "production") {`
35	`DataRouterContext.displayName = "DataRouter";`
36	`}`
37
38	`const DataRouterStateContext = /#__PURE__/React.createContext(null);`
39
40	`if (process.env.NODE_ENV !== "production") {`