@tanstack/react-router 0.0.1-beta.20 → 0.0.1-beta.21

package/build/stats-html.html

@@ -4014,7 +4014,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.production.js","children":[{"uid":"877b-59","name":"\u0000rollupPluginBabelHelpers.js"},{"name":"packages","children":[{"name":"router-core/build/esm/index.js","uid":"877b-61"},{"name":"react-router/src/index.tsx","uid":"877b-63"}]}]}],"isRoot":true},"nodeParts":{"877b-59":{"renderedLength":798,"gzipLength":366,"brotliLength":0,"mainUid":"877b-58"},"877b-61":{"renderedLength":75162,"gzipLength":15777,"brotliLength":0,"mainUid":"877b-60"},"877b-63":{"renderedLength":12237,"gzipLength":3143,"brotliLength":0,"mainUid":"877b-62"}},"nodeMetas":{"877b-58":{"id":"\u0000rollupPluginBabelHelpers.js","moduleParts":{"index.production.js":"877b-59"},"imported":[],"importedBy":[{"uid":"877b-62"}]},"877b-60":{"id":"/packages/router-core/build/esm/index.js","moduleParts":{"index.production.js":"877b-61"},"imported":[],"importedBy":[{"uid":"877b-62"}]},"877b-62":{"id":"/packages/react-router/src/index.tsx","moduleParts":{"index.production.js":"877b-63"},"imported":[{"uid":"877b-58"},{"uid":"877b-64"},{"uid":"877b-65"},{"uid":"877b-60"}],"importedBy":[],"isEntry":true},"877b-64":{"id":"react","moduleParts":{},"imported":[],"importedBy":[{"uid":"877b-62"}],"isExternal":true},"877b-65":{"id":"use-sync-external-store/shim","moduleParts":{},"imported":[],"importedBy":[{"uid":"877b-62"}],"isExternal":true}},"env":{"rollup":"2.77.2"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.production.js","children":[{"uid":"d45b-59","name":"\u0000rollupPluginBabelHelpers.js"},{"name":"packages","children":[{"name":"router-core/build/esm/index.js","uid":"d45b-61"},{"name":"react-router/src/index.tsx","uid":"d45b-63"}]}]}],"isRoot":true},"nodeParts":{"d45b-59":{"renderedLength":798,"gzipLength":366,"brotliLength":0,"mainUid":"d45b-58"},"d45b-61":{"renderedLength":75162,"gzipLength":15777,"brotliLength":0,"mainUid":"d45b-60"},"d45b-63":{"renderedLength":12795,"gzipLength":3210,"brotliLength":0,"mainUid":"d45b-62"}},"nodeMetas":{"d45b-58":{"id":"\u0000rollupPluginBabelHelpers.js","moduleParts":{"index.production.js":"d45b-59"},"imported":[],"importedBy":[{"uid":"d45b-62"}]},"d45b-60":{"id":"/packages/router-core/build/esm/index.js","moduleParts":{"index.production.js":"d45b-61"},"imported":[],"importedBy":[{"uid":"d45b-62"}]},"d45b-62":{"id":"/packages/react-router/src/index.tsx","moduleParts":{"index.production.js":"d45b-63"},"imported":[{"uid":"d45b-58"},{"uid":"d45b-64"},{"uid":"d45b-65"},{"uid":"d45b-60"}],"importedBy":[],"isEntry":true},"d45b-64":{"id":"react","moduleParts":{},"imported":[],"importedBy":[{"uid":"d45b-62"}],"isExternal":true},"d45b-65":{"id":"use-sync-external-store/shim","moduleParts":{},"imported":[],"importedBy":[{"uid":"d45b-62"}],"isExternal":true}},"env":{"rollup":"2.77.2"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/build/stats-react.json

@@ -7,7 +7,7 @@
         "name": "index.production.js",
         "children": [
           {
-            "uid": "877b-67",
+            "uid": "d45b-67",
             "name": "\u0000rollupPluginBabelHelpers.js"
           },
           {
@@ -15,11 +15,11 @@
             "children": [
               {
                 "name": "router-core/build/esm/index.js",
-                "uid": "877b-69"
+                "uid": "d45b-69"
               },
               {
                 "name": "react-router/src/index.tsx",
-                "uid": "877b-71"
+                "uid": "d45b-71"
               }
             ]
           }
@@ -29,90 +29,90 @@
     "isRoot": true
   },
   "nodeParts": {
-    "877b-67": {
+    "d45b-67": {
       "renderedLength": 798,
       "gzipLength": 366,
       "brotliLength": 0,
-      "mainUid": "877b-66"
+      "mainUid": "d45b-66"
     },
-    "877b-69": {
+    "d45b-69": {
       "renderedLength": 75162,
       "gzipLength": 15777,
       "brotliLength": 0,
-      "mainUid": "877b-68"
+      "mainUid": "d45b-68"
     },
-    "877b-71": {
-      "renderedLength": 12237,
-      "gzipLength": 3143,
+    "d45b-71": {
+      "renderedLength": 12795,
+      "gzipLength": 3210,
       "brotliLength": 0,
-      "mainUid": "877b-70"
+      "mainUid": "d45b-70"
     }
   },
   "nodeMetas": {
-    "877b-66": {
+    "d45b-66": {
       "id": "\u0000rollupPluginBabelHelpers.js",
       "moduleParts": {
-        "index.production.js": "877b-67"
+        "index.production.js": "d45b-67"
       },
       "imported": [],
       "importedBy": [
         {
-          "uid": "877b-70"
+          "uid": "d45b-70"
         }
       ]
     },
-    "877b-68": {
+    "d45b-68": {
       "id": "/packages/router-core/build/esm/index.js",
       "moduleParts": {
-        "index.production.js": "877b-69"
+        "index.production.js": "d45b-69"
       },
       "imported": [],
       "importedBy": [
         {
-          "uid": "877b-70"
+          "uid": "d45b-70"
         }
       ]
     },
-    "877b-70": {
+    "d45b-70": {
       "id": "/packages/react-router/src/index.tsx",
       "moduleParts": {
-        "index.production.js": "877b-71"
+        "index.production.js": "d45b-71"
       },
       "imported": [
         {
-          "uid": "877b-66"
+          "uid": "d45b-66"
         },
         {
-          "uid": "877b-72"
+          "uid": "d45b-72"
         },
         {
-          "uid": "877b-73"
+          "uid": "d45b-73"
         },
         {
-          "uid": "877b-68"
+          "uid": "d45b-68"
         }
       ],
       "importedBy": [],
       "isEntry": true
     },
-    "877b-72": {
+    "d45b-72": {
       "id": "react",
       "moduleParts": {},
       "imported": [],
       "importedBy": [
         {
-          "uid": "877b-70"
+          "uid": "d45b-70"
         }
       ],
       "isExternal": true
     },
-    "877b-73": {
+    "d45b-73": {
       "id": "use-sync-external-store/shim",
       "moduleParts": {},
       "imported": [],
       "importedBy": [
         {
-          "uid": "877b-70"
+          "uid": "d45b-70"
         }
       ],
       "isExternal": true

package/build/types/index.d.ts

@@ -9,15 +9,15 @@
  * @license MIT
  */
 import * as React from 'react';
-import { AnyRouteConfig, RouteConfig, AnyAllRouteInfo, AllRouteInfo, RouterState, RouteMatch, ToOptions, MatchRouteOptions, RouteInfoByPath, ResolveRelativePath, NoInfer, DefaultAllRouteInfo, AnyRouteInfo, RouteInfo, CheckId, ToIdOption, ValidFromPath, LinkOptions, Router, RouterOptions } from '@tanstack/router-core';
+import { AnyRouteConfig, RouteConfig, AnyAllRouteInfo, AllRouteInfo, RouterState, RouteMatch, RouteInfo, DefaultAllRouteInfo, AnyRouteInfo, ResolveRelativePath, NoInfer, CheckId, ToIdOption, Router, ValidFromPath, ToOptions, MatchRouteOptions, RouteInfoByPath, RouterOptions, Route, LinkOptions } from '@tanstack/router-core';
 export * from '@tanstack/router-core';
 
 interface RegisterRouter {
 }
-type ResolvedRouter = RegisterRouter extends {
+type RegisteredRouter = RegisterRouter extends {
     router: Router<infer TRouteConfig, infer TAllRouteInfo>;
 } ? Router<TRouteConfig, TAllRouteInfo> : Router;
-type ResolvedAllRouteInfo = RegisterRouter extends {
+type RegisteredAllRouteInfo = RegisterRouter extends {
     router: Router<infer TRouteConfig, infer TAllRouteInfo>;
 } ? TAllRouteInfo : AnyAllRouteInfo;
 type SyncRouteComponent = (props?: {}) => JSX.Element | React.ReactNode;
@@ -27,6 +27,19 @@ type RouteComponent = SyncRouteComponent & {
 declare function lazy(importer: () => Promise<{
     default: SyncRouteComponent;
 }>): RouteComponent;
+type LinkPropsOptions<TAllRouteInfo extends AnyAllRouteInfo, TFrom extends ValidFromPath<TAllRouteInfo>, TTo extends string> = LinkOptions<TAllRouteInfo, TFrom, TTo> & {
+    activeProps?: React.AnchorHTMLAttributes<HTMLAnchorElement> | (() => React.AnchorHTMLAttributes<HTMLAnchorElement>);
+    inactiveProps?: React.AnchorHTMLAttributes<HTMLAnchorElement> | (() => React.AnchorHTMLAttributes<HTMLAnchorElement>);
+};
+type MakeMatchRouteOptions<TAllRouteInfo extends AnyAllRouteInfo, TFrom extends ValidFromPath<TAllRouteInfo>, TTo extends string> = ToOptions<TAllRouteInfo, TFrom, TTo> & MatchRouteOptions & {
+    children?: React.ReactNode | ((params: RouteInfoByPath<TAllRouteInfo, ResolveRelativePath<TFrom, NoInfer<TTo>>>['allParams']) => React.ReactNode);
+};
+type MakeLinkPropsOptions<TAllRouteInfo extends AnyAllRouteInfo, TFrom extends ValidFromPath<TAllRouteInfo>, TTo extends string> = LinkPropsOptions<TAllRouteInfo, TFrom, TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement>;
+type MakeLinkOptions<TAllRouteInfo extends AnyAllRouteInfo, TFrom extends ValidFromPath<TAllRouteInfo>, TTo extends string> = LinkPropsOptions<TAllRouteInfo, TFrom, TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement> & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
+    children?: React.ReactNode | ((state: {
+        isActive: boolean;
+    }) => React.ReactNode);
+};
 declare module '@tanstack/router-core' {
     interface FrameworkGenerics {
         Component: RouteComponent;
@@ -34,51 +47,32 @@ declare module '@tanstack/router-core' {
     interface Router<TRouteConfig extends AnyRouteConfig = RouteConfig, TAllRouteInfo extends AnyAllRouteInfo = AllRouteInfo<TRouteConfig>> {
         useState: () => RouterState;
         useRoute: <TId extends keyof TAllRouteInfo['routeInfoById']>(routeId: TId) => Route<TAllRouteInfo, TAllRouteInfo['routeInfoById'][TId]>;
-        useMatch: <TId extends keyof TAllRouteInfo['routeInfoById'], TStrict extends true | false = true>(routeId: TId, opts?: {
+        useNearestMatch: () => RouteMatch<TAllRouteInfo, RouteInfo>;
+        useMatch: <TId extends keyof TAllRouteInfo['routeInfoById'], TStrict extends boolean = true>(routeId: TId, opts?: {
             strict?: TStrict;
         }) => TStrict extends true ? RouteMatch<TAllRouteInfo, TAllRouteInfo['routeInfoById'][TId]> : RouteMatch<TAllRouteInfo, TAllRouteInfo['routeInfoById'][TId]> | undefined;
-        linkProps: <TTo extends string = '.'>(props: LinkPropsOptions<TAllRouteInfo, '/', TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement>) => React.AnchorHTMLAttributes<HTMLAnchorElement>;
-        Link: <TTo extends string = '.'>(props: LinkPropsOptions<TAllRouteInfo, '/', TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement> & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
-            children?: React.ReactNode | ((state: {
-                isActive: boolean;
-            }) => React.ReactNode);
-        }) => JSX.Element;
-        MatchRoute: <TTo extends string = '.'>(props: ToOptions<TAllRouteInfo, '/', TTo> & MatchRouteOptions & {
-            children?: React.ReactNode | ((params: RouteInfoByPath<TAllRouteInfo, ResolveRelativePath<'/', NoInfer<TTo>>>['allParams']) => React.ReactNode);
-        }) => JSX.Element;
+        linkProps: <TTo extends string = '.'>(props: MakeLinkPropsOptions<TAllRouteInfo, '/', TTo>) => React.AnchorHTMLAttributes<HTMLAnchorElement>;
+        Link: <TTo extends string = '.'>(props: MakeLinkOptions<TAllRouteInfo, '/', TTo>) => JSX.Element;
+        MatchRoute: <TTo extends string = '.'>(props: MakeMatchRouteOptions<TAllRouteInfo, '/', TTo>) => JSX.Element;
     }
     interface Route<TAllRouteInfo extends AnyAllRouteInfo = DefaultAllRouteInfo, TRouteInfo extends AnyRouteInfo = RouteInfo> {
         useRoute: <TTo extends string = '.', TResolved extends string = ResolveRelativePath<TRouteInfo['id'], NoInfer<TTo>>>(routeId: CheckId<TAllRouteInfo, TResolved, ToIdOption<TAllRouteInfo, TRouteInfo['id'], TTo>>, opts?: {
             strict?: boolean;
         }) => Route<TAllRouteInfo, TAllRouteInfo['routeInfoById'][TResolved]>;
-        linkProps: <TTo extends string = '.'>(props: LinkPropsOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement>) => React.AnchorHTMLAttributes<HTMLAnchorElement>;
-        Link: <TTo extends string = '.'>(props: LinkPropsOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement> & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
-            children?: React.ReactNode | ((state: {
-                isActive: boolean;
-            }) => React.ReactNode);
-        }) => JSX.Element;
-        MatchRoute: <TTo extends string = '.'>(props: ToOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo> & MatchRouteOptions & {
-            children?: React.ReactNode | ((params: RouteInfoByPath<TAllRouteInfo, ResolveRelativePath<TRouteInfo['fullPath'], NoInfer<TTo>>>['allParams']) => React.ReactNode);
-        }) => JSX.Element;
+        linkProps: <TTo extends string = '.'>(props: MakeLinkPropsOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo>) => React.AnchorHTMLAttributes<HTMLAnchorElement>;
+        Link: <TTo extends string = '.'>(props: MakeLinkOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo>) => JSX.Element;
+        MatchRoute: <TTo extends string = '.'>(props: MakeMatchRouteOptions<TAllRouteInfo, TRouteInfo['fullPath'], TTo>) => JSX.Element;
     }
 }
-type LinkPropsOptions<TAllRouteInfo extends AnyAllRouteInfo = DefaultAllRouteInfo, TFrom extends ValidFromPath<TAllRouteInfo> = '/', TTo extends string = '.'> = LinkOptions<TAllRouteInfo, TFrom, TTo> & {
-    activeProps?: React.AnchorHTMLAttributes<HTMLAnchorElement> | (() => React.AnchorHTMLAttributes<HTMLAnchorElement>);
-    inactiveProps?: React.AnchorHTMLAttributes<HTMLAnchorElement> | (() => React.AnchorHTMLAttributes<HTMLAnchorElement>);
-};
 type PromptProps = {
     message: string;
     when?: boolean | any;
     children?: React.ReactNode;
 };
-declare function Link<TTo extends string = '.'>(props: LinkPropsOptions<ResolvedAllRouteInfo, '/', TTo> & React.AnchorHTMLAttributes<HTMLAnchorElement> & Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
-    children?: React.ReactNode | ((state: {
-        isActive: boolean;
-    }) => React.ReactNode);
-}): JSX.Element;
+declare function Link<TTo extends string = '.'>(props: MakeLinkOptions<RegisteredAllRouteInfo, '/', TTo>): JSX.Element;
 declare const matchesContext: React.Context<RouteMatch<DefaultAllRouteInfo, RouteInfo<string, string, string, string, {}, {}, {}, unknown, unknown, {}, {}, {}, {}, Record<never, string>, {}>>[]>;
 declare const routerContext: React.Context<{
-    router: ResolvedRouter;
+    router: RegisteredRouter;
 }>;
 type MatchesProviderProps = {
     value: RouteMatch[];
@@ -91,11 +85,15 @@ type RouterProps<TRouteConfig extends AnyRouteConfig = RouteConfig, TAllRouteInf
     children?: React.ReactNode;
 };
 declare function RouterProvider<TRouteConfig extends AnyRouteConfig = RouteConfig, TAllRouteInfo extends AnyAllRouteInfo = DefaultAllRouteInfo>({ children, router, ...rest }: RouterProps<TRouteConfig, TAllRouteInfo>): JSX.Element;
-declare function useRouter(): ResolvedRouter;
+declare function useRouter(): RegisteredRouter;
 declare function useMatches(): RouteMatch[];
-declare function useMatch<TId extends keyof ResolvedAllRouteInfo['routeInfoById'], TStrict extends true | false = true>(routeId: TId, opts?: {
+declare function useMatch<TId extends keyof RegisteredAllRouteInfo['routeInfoById'], TStrict extends boolean = true>(routeId: TId, opts?: {
     strict?: TStrict;
-}): TStrict extends true ? RouteMatch<ResolvedAllRouteInfo, ResolvedAllRouteInfo['routeInfoById'][TId]> : RouteMatch<ResolvedAllRouteInfo, ResolvedAllRouteInfo['routeInfoById'][TId]> | undefined;
+}): TStrict extends true ? RouteMatch<RegisteredAllRouteInfo, RegisteredAllRouteInfo['routeInfoById'][TId]> : RouteMatch<RegisteredAllRouteInfo, RegisteredAllRouteInfo['routeInfoById'][TId]> | undefined;
+declare function useNearestMatch(): RouteMatch<RegisteredAllRouteInfo, RouteInfo>;
+declare function useRoute<TId extends keyof RegisteredAllRouteInfo['routeInfoById']>(routeId: TId): Route<RegisteredAllRouteInfo, RegisteredAllRouteInfo['routeInfoById'][TId]>;
+declare function linkProps<TTo extends string = '.'>(props: MakeLinkPropsOptions<RegisteredAllRouteInfo, '/', TTo>): React.AnchorHTMLAttributes<HTMLAnchorElement>;
+declare function MatchRoute<TTo extends string = '.'>(props: MakeMatchRouteOptions<RegisteredAllRouteInfo, '/', TTo>): JSX.Element;
 declare function Outlet(): JSX.Element | null;
 declare function DefaultErrorBoundary({ error }: {
     error: any;
@@ -103,4 +101,4 @@ declare function DefaultErrorBoundary({ error }: {
 declare function usePrompt(message: string, when: boolean | any): void;
 declare function Prompt({ message, when, children }: PromptProps): React.ReactNode;
 
-export { DefaultErrorBoundary, Link, MatchesProvider, MatchesProviderProps, Outlet, Prompt, PromptProps, RegisterRouter, ResolvedAllRouteInfo, ResolvedRouter, RouteComponent, RouterProps, RouterProvider, SyncRouteComponent, createReactRouter, lazy, matchesContext, routerContext, useMatch, useMatches, usePrompt, useRouter };
+export { DefaultErrorBoundary, Link, MatchRoute, MatchesProvider, MatchesProviderProps, Outlet, Prompt, PromptProps, RegisterRouter, RegisteredAllRouteInfo, RegisteredRouter, RouteComponent, RouterProps, RouterProvider, SyncRouteComponent, createReactRouter, lazy, linkProps, matchesContext, routerContext, useMatch, useMatches, useNearestMatch, usePrompt, useRoute, useRouter };

package/build/umd/index.development.js

@@ -2778,6 +2778,25 @@
     const router = useRouter();
     return router.useMatch(routeId, opts);
   }
+  function useNearestMatch() {
+    var _useMatches2;
+
+    const runtimeMatch = (_useMatches2 = useMatches()) == null ? void 0 : _useMatches2[0];
+    invariant(runtimeMatch, "Could not find a nearest match!");
+    return runtimeMatch;
+  }
+  function useRoute(routeId) {
+    const router = useRouter();
+    return router.useRoute(routeId);
+  }
+  function linkProps(props) {
+    const router = useRouter();
+    return router.linkProps(props);
+  }
+  function MatchRoute(props) {
+    const router = useRouter();
+    return /*#__PURE__*/React__namespace.createElement(router.MatchRoute, props);
+  }
   function Outlet() {
     var _ref3, _match$__$pendingComp, _match$__$errorCompon;
 
@@ -2898,6 +2917,7 @@
 
   exports.DefaultErrorBoundary = DefaultErrorBoundary;
   exports.Link = Link;
+  exports.MatchRoute = MatchRoute;
   exports.MatchesProvider = MatchesProvider;
   exports.Outlet = Outlet;
   exports.Prompt = Prompt;
@@ -2921,6 +2941,7 @@
   exports.joinPaths = joinPaths;
   exports.last = last;
   exports.lazy = lazy;
+  exports.linkProps = linkProps;
   exports.matchByPath = matchByPath;
   exports.matchPathname = matchPathname;
   exports.matchesContext = matchesContext;
@@ -2937,7 +2958,9 @@
   exports.trimPathRight = trimPathRight;
   exports.useMatch = useMatch;
   exports.useMatches = useMatches;
+  exports.useNearestMatch = useNearestMatch;
   exports.usePrompt = usePrompt;
+  exports.useRoute = useRoute;
   exports.useRouter = useRouter;
   exports.warning = warning;