react-router 6.27.0 → 6.28.0

package/dist/umd/react-router.development.js

@@ -1,5 +1,5 @@
 /**
- * React Router v6.27.0
+ * React Router v6.28.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -99,7 +99,7 @@
    * 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
+   * @see https://reactrouter.com/v6/hooks/use-href
    */
   function useHref(to, _temp) {
     let {
@@ -138,7 +138,7 @@
   /**
    * Returns true if this component is a descendant of a `<Router>`.
    *
-   * @see https://reactrouter.com/hooks/use-in-router-context
+   * @see https://reactrouter.com/v6/hooks/use-in-router-context
    */
   function useInRouterContext() {
     return React__namespace.useContext(LocationContext) != null;
@@ -152,7 +152,7 @@
    * "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
+   * @see https://reactrouter.com/v6/hooks/use-location
    */
   function useLocation() {
     !useInRouterContext() ? router.UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
@@ -165,7 +165,7 @@
    * 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
+   * @see https://reactrouter.com/v6/hooks/use-navigation-type
    */
   function useNavigationType() {
     return React__namespace.useContext(LocationContext).navigationType;
@@ -176,7 +176,7 @@
    * This is useful for components that need to know "active" state, e.g.
    * `<NavLink>`.
    *
-   * @see https://reactrouter.com/hooks/use-match
+   * @see https://reactrouter.com/v6/hooks/use-match
    */
   function useMatch(pattern) {
     !useInRouterContext() ? router.UNSAFE_invariant(false, // TODO: This error is probably because they somehow have 2 versions of the
@@ -209,7 +209,7 @@
    * 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
+   * @see https://reactrouter.com/v6/hooks/use-navigate
    */
   function useNavigate() {
     let {
@@ -273,7 +273,7 @@
   /**
    * Returns the context (if provided) for the child route at this level of the route
    * hierarchy.
-   * @see https://reactrouter.com/hooks/use-outlet-context
+   * @see https://reactrouter.com/v6/hooks/use-outlet-context
    */
   function useOutletContext() {
     return React__namespace.useContext(OutletContext);
@@ -283,7 +283,7 @@
    * 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
+   * @see https://reactrouter.com/v6/hooks/use-outlet
    */
   function useOutlet(context) {
     let outlet = React__namespace.useContext(RouteContext).outlet;
@@ -299,7 +299,7 @@
    * 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
+   * @see https://reactrouter.com/v6/hooks/use-params
    */
   function useParams() {
     let {
@@ -312,7 +312,7 @@
   /**
    * Resolves the pathname of the given `to` value against the current location.
    *
-   * @see https://reactrouter.com/hooks/use-resolved-path
+   * @see https://reactrouter.com/v6/hooks/use-resolved-path
    */
   function useResolvedPath(to, _temp2) {
     let {
@@ -337,7 +337,7 @@
    * elements in the tree must render an `<Outlet>` to render their child route's
    * element.
    *
-   * @see https://reactrouter.com/hooks/use-routes
+   * @see https://reactrouter.com/v6/hooks/use-routes
    */
   function useRoutes(routes, locationArg) {
     return useRoutesImpl(routes, locationArg);
@@ -712,7 +712,7 @@
     return DataRouterStateHook;
   }(DataRouterStateHook || {});
   function getDataRouterConsoleError(hookName) {
-    return hookName + " must be used within a data router.  See https://reactrouter.com/routers/picking-a-router.";
+    return hookName + " must be used within a data router.  See https://reactrouter.com/v6/routers/picking-a-router.";
   }
   function useDataRouterContext(hookName) {
     let ctx = React__namespace.useContext(DataRouterContext);
@@ -942,14 +942,45 @@
     }, [router$1, id]);
     return navigate;
   }
-  const alreadyWarned = {};
+  const alreadyWarned$1 = {};
   function warningOnce(key, cond, message) {
-    if (!cond && !alreadyWarned[key]) {
-      alreadyWarned[key] = true;
+    if (!cond && !alreadyWarned$1[key]) {
+      alreadyWarned$1[key] = true;
       router.UNSAFE_warning(false, message) ;
     }
   }
 
+  const alreadyWarned = {};
+  function warnOnce(key, message) {
+    if (!alreadyWarned[message]) {
+      alreadyWarned[message] = true;
+      console.warn(message);
+    }
+  }
+  const logDeprecation = (flag, msg, link) => warnOnce(flag, "\u26A0\uFE0F React Router Future Flag Warning: " + msg + ". " + ("You can use the `" + flag + "` future flag to opt-in early. ") + ("For more information, see " + link + "."));
+  function logV6DeprecationWarnings(renderFuture, routerFuture) {
+    if (!(renderFuture != null && renderFuture.v7_startTransition)) {
+      logDeprecation("v7_startTransition", "React Router will begin wrapping state updates in `React.startTransition` in v7", "https://reactrouter.com/v6/upgrading/future#v7_starttransition");
+    }
+    if (!(renderFuture != null && renderFuture.v7_relativeSplatPath) && (!routerFuture || !routerFuture.v7_relativeSplatPath)) {
+      logDeprecation("v7_relativeSplatPath", "Relative route resolution within Splat routes is changing in v7", "https://reactrouter.com/v6/upgrading/future#v7_relativesplatpath");
+    }
+    if (routerFuture) {
+      if (!routerFuture.v7_fetcherPersist) {
+        logDeprecation("v7_fetcherPersist", "The persistence behavior of fetchers is changing in v7", "https://reactrouter.com/v6/upgrading/future#v7_fetcherpersist");
+      }
+      if (!routerFuture.v7_normalizeFormMethod) {
+        logDeprecation("v7_normalizeFormMethod", "Casing of `formMethod` fields is being normalized to uppercase in v7", "https://reactrouter.com/v6/upgrading/future#v7_normalizeformmethod");
+      }
+      if (!routerFuture.v7_partialHydration) {
+        logDeprecation("v7_partialHydration", "`RouterProvider` hydration behavior is changing in v7", "https://reactrouter.com/v6/upgrading/future#v7_partialhydration");
+      }
+      if (!routerFuture.v7_skipActionErrorRevalidation) {
+        logDeprecation("v7_skipActionErrorRevalidation", "The revalidation behavior after 4xx/5xx `action` responses is changing in v7", "https://reactrouter.com/v6/upgrading/future#v7_skipactionerrorrevalidation");
+      }
+    }
+  }
+
   /**
     Webpack + React 17 fails to compile on any of the following because webpack
     complains that `startTransition` doesn't exist in `React`:
@@ -1026,6 +1057,7 @@
       static: false,
       basename
     }), [router$1, navigator, basename]);
+    React__namespace.useEffect(() => logV6DeprecationWarnings(future, router$1.future), [router$1, future]);
 
     // 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
@@ -1062,7 +1094,7 @@
   /**
    * A `<Router>` that stores all entries in memory.
    *
-   * @see https://reactrouter.com/router-components/memory-router
+   * @see https://reactrouter.com/v6/router-components/memory-router
    */
   function MemoryRouter(_ref3) {
     let {
@@ -1092,6 +1124,7 @@
       v7_startTransition && startTransitionImpl ? startTransitionImpl(() => setStateImpl(newState)) : setStateImpl(newState);
     }, [setStateImpl, v7_startTransition]);
     React__namespace.useLayoutEffect(() => history.listen(setState), [history, setState]);
+    React__namespace.useEffect(() => logV6DeprecationWarnings(future), [future]);
     return /*#__PURE__*/React__namespace.createElement(Router, {
       basename: basename,
       children: children,
@@ -1108,7 +1141,7 @@
    * able to use hooks. In functional components, we recommend you use the
    * `useNavigate` hook instead.
    *
-   * @see https://reactrouter.com/components/navigate
+   * @see https://reactrouter.com/v6/components/navigate
    */
   function Navigate(_ref4) {
     let {
@@ -1147,7 +1180,7 @@
   /**
    * Renders the child route's element, if there is one.
    *
-   * @see https://reactrouter.com/components/outlet
+   * @see https://reactrouter.com/v6/components/outlet
    */
   function Outlet(props) {
     return useOutlet(props.context);
@@ -1155,7 +1188,7 @@
   /**
    * Declares an element that should be rendered at a certain URL path.
    *
-   * @see https://reactrouter.com/components/route
+   * @see https://reactrouter.com/v6/components/route
    */
   function Route(_props) {
     router.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>.")  ;
@@ -1167,7 +1200,7 @@
    * 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
+   * @see https://reactrouter.com/v6/router-components/router
    */
   function Router(_ref5) {
     let {
@@ -1233,7 +1266,7 @@
    * 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
+   * @see https://reactrouter.com/v6/components/routes
    */
   function Routes(_ref6) {
     let {
@@ -1374,7 +1407,7 @@
    * 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
+   * @see https://reactrouter.com/v6/utils/create-routes-from-children
    */
   function createRoutesFromChildren(children, parentPath) {
     if (parentPath === void 0) {
@@ -1554,6 +1587,7 @@
   exports.UNSAFE_LocationContext = LocationContext;
   exports.UNSAFE_NavigationContext = NavigationContext;
   exports.UNSAFE_RouteContext = RouteContext;
+  exports.UNSAFE_logV6DeprecationWarnings = logV6DeprecationWarnings;
   exports.UNSAFE_mapRouteProperties = mapRouteProperties;
   exports.UNSAFE_useRouteId = useRouteId;
   exports.UNSAFE_useRoutesImpl = useRoutesImpl;