[core] Use router specific Link components

docs/data/toolpad/core/components/page-container/CustomPageContainer.js

@@ -42,6 +42,7 @@ function Content({ router }) {
 
 Content.propTypes = {
   router: PropTypes.shape({
+    Link: PropTypes.func,
     navigate: PropTypes.func.isRequired,
     pathname: PropTypes.string.isRequired,
     searchParams: PropTypes.instanceOf(URLSearchParams).isRequired,

docs/pages/toolpad/core/api/app-provider.json

@@ -22,7 +22,7 @@
     "router": {
       "type": {
         "name": "shape",
-        "description": "{ navigate: func, pathname: string, searchParams: URLSearchParams }"
+        "description": "{ Link?: func, navigate: func, pathname: string, searchParams: URLSearchParams }"
       },
       "default": "null"
     },

packages/toolpad-core/src/AppProvider/AppProvider.tsx

@@ -10,6 +10,7 @@ import {
   RouterContext,
   WindowContext,
 } from '../shared/context';
+import type { LinkProps } from '../shared/Link';
 import { AppThemeProvider } from './AppThemeProvider';
 
 export interface NavigateOptions {
@@ -27,6 +28,7 @@ export interface Router {
   pathname: string;
   searchParams: URLSearchParams;
   navigate: Navigate;
+  Link?: React.ComponentType<LinkProps>;
 }
 
 export interface Branding {
@@ -242,6 +244,7 @@ AppProvider.propTypes /* remove-proptypes */ = {
    * @default null
    */
   router: PropTypes.shape({
+    Link: PropTypes.func,
     navigate: PropTypes.func.isRequired,
     pathname: PropTypes.string.isRequired,
     searchParams: PropTypes.instanceOf(URLSearchParams).isRequired,

packages/toolpad-core/src/nextjs/NextAppProvider.test.tsx

@@ -24,6 +24,8 @@ vi.mock('next/router', () => ({ useRouter: () => null }));
 
 vi.mock('next/compat/router', () => ({ useRouter: () => null }));
 
+vi.mock('next/link', () => ({ default: () => null }));
+
 interface RouterTestProps {
   children: React.ReactNode;
 }

packages/toolpad-core/src/nextjs/NextAppProviderApp.tsx

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import Link from 'next/link';
 import { usePathname, useSearchParams, useRouter } from 'next/navigation';
 import { AppProvider } from '../AppProvider';
 import type { AppProviderProps, Navigate, Router } from '../AppProvider';
@@ -29,6 +30,7 @@ export function NextAppProviderApp(props: AppProviderProps) {
       pathname,
       searchParams,
       navigate,
+      Link,
     }),
     [pathname, navigate, searchParams],
   );

packages/toolpad-core/src/nextjs/NextAppProviderPages.tsx

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import Link from 'next/link';
 import { asArray } from '@toolpad/utils/collections';
 import { useRouter } from 'next/router';
 import { AppProvider } from '../AppProvider';
@@ -41,6 +42,7 @@ export function NextAppProviderPages(props: AppProviderProps) {
       pathname,
       searchParams,
       navigate,
+      Link,
     }),
     [navigate, pathname, searchParams],
   );

packages/toolpad-core/src/react-router/ReactRouterAppProvider.tsx

@@ -1,7 +1,13 @@
 'use client';
 import * as React from 'react';
-import { useSearchParams, useLocation, useNavigate } from 'react-router';
+import { useSearchParams, useLocation, useNavigate, Link as ReactRouterLink } from 'react-router';
 import { AppProvider, type AppProviderProps, Navigate, Router } from '../AppProvider/AppProvider';
+import { LinkProps } from '../shared/Link';
+
+const Link = React.forwardRef<HTMLAnchorElement, LinkProps>((props, ref) => {
+  const { href, ...rest } = props;
+  return <ReactRouterLink ref={ref} to={href} {...rest} />;
+});
 
 function ReactRouterAppProvider(props: AppProviderProps) {
   const { pathname } = useLocation();
@@ -26,6 +32,7 @@ function ReactRouterAppProvider(props: AppProviderProps) {
       pathname,
       searchParams,
       navigate: navigateImpl,
+      Link,
     }),
     [pathname, searchParams, navigateImpl],
   );

packages/toolpad-core/src/shared/Link.tsx

@@ -5,12 +5,13 @@ import { RouterContext } from './context';
  * @ignore - internal component.
  */
 
-export interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+export interface DefaultLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
   history?: 'auto' | 'push' | 'replace';
+  href: string;
 }
 
-export const Link = React.forwardRef(function Link(
-  props: LinkProps,
+export const DefaultLink = React.forwardRef(function Link(
+  props: DefaultLinkProps,
   ref: React.ForwardedRef<HTMLAnchorElement>,
 ) {
   const { children, href, onClick, history, ...rest } = props;
@@ -34,3 +35,23 @@ export const Link = React.forwardRef(function Link(
     </a>
   );
 });
+
+export interface LinkProps {
+  href: string;
+  children: React.ReactNode;
+  onClick?: React.MouseEventHandler<HTMLAnchorElement>;
+  style?: React.CSSProperties;
+}
+
+export const Link = React.forwardRef(function Link(
+  props: LinkProps,
+  ref: React.ForwardedRef<HTMLAnchorElement>,
+) {
+  const routerContext = React.useContext(RouterContext);
+  const LinkComponent = routerContext?.Link ?? DefaultLink;
+  return (
+    <LinkComponent ref={ref} {...props}>
+      {props.children}
+    </LinkComponent>
+  );
+});