@tanstack/react-router 0.0.1-beta.24 → 0.0.1-beta.240

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tanstack/react-router",
   "author": "Tanner Linsley",
-  "version": "0.0.1-beta.24",
+  "version": "0.0.1-beta.240",
   "license": "MIT",
   "repository": "tanstack/router",
-  "homepage": "https://tanstack.com/router/",
+  "homepage": "https://tanstack.com/router",
   "description": "",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -12,7 +12,6 @@
   "keywords": [
     "react",
     "location",
-    "@tanstack/react-router",
     "router",
     "routing",
     "async",
@@ -24,7 +23,7 @@
     "url": "https://github.com/sponsors/tannerlinsley"
   },
   "module": "build/esm/index.js",
-  "main": "build/cjs/react-router/src/index.js",
+  "main": "build/cjs/index.js",
   "browser": "build/umd/index.production.js",
   "types": "build/types/index.d.ts",
   "engines": {
@@ -41,11 +40,13 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.16.7",
-    "@tanstack/router-core": "0.0.1-beta.24",
-    "use-sync-external-store": "^1.2.0"
+    "@tanstack/react-store": "^0.2.1",
+    "@tanstack/store": "^0.1.3",
+    "tiny-invariant": "^1.3.1",
+    "tiny-warning": "^1.0.3",
+    "@tanstack/history": "0.0.1-beta.240"
   },
-  "devDependencies": {
-    "@types/use-sync-external-store": "^0.0.3",
-    "babel-plugin-transform-async-to-promises": "^0.8.18"
+  "scripts": {
+    "build": "rollup --config rollup.config.js"
   }
-}
+}

package/src/CatchBoundary.tsx

@@ -0,0 +1,98 @@
+import * as React from 'react'
+
+export function CatchBoundary(props: {
+  resetKey: string
+  children: any
+  errorComponent?: any
+  onCatch: (error: any) => void
+}) {
+  const errorComponent = props.errorComponent ?? ErrorComponent
+
+  return (
+    <CatchBoundaryImpl
+      resetKey={props.resetKey}
+      onCatch={props.onCatch}
+      children={({ error }) => {
+        if (error) {
+          return React.createElement(errorComponent, {
+            error,
+          })
+        }
+
+        return props.children
+      }}
+    />
+  )
+}
+
+export class CatchBoundaryImpl extends React.Component<{
+  resetKey: string
+  children: (props: { error: any; reset: () => void }) => any
+  onCatch?: (error: any) => void
+}> {
+  state = { error: null } as any
+  static getDerivedStateFromError(error: any) {
+    return { error }
+  }
+  componentDidUpdate(
+    prevProps: Readonly<{
+      resetKey: string
+      children: (props: { error: any; reset: () => void }) => any
+      onCatch?: ((error: any, info: any) => void) | undefined
+    }>,
+    prevState: any,
+  ): void {
+    if (prevState.error && prevProps.resetKey !== this.props.resetKey) {
+      this.setState({ error: null })
+    }
+  }
+  componentDidCatch(error: any) {
+    console.error(error)
+    this.props.onCatch?.(error)
+  }
+  render() {
+    return this.props.children(this.state)
+  }
+}
+
+export function ErrorComponent({ error }: { error: any }) {
+  const [show, setShow] = React.useState(process.env.NODE_ENV !== 'production')
+
+  return (
+    <div style={{ padding: '.5rem', maxWidth: '100%' }}>
+      <div style={{ display: 'flex', alignItems: 'center', gap: '.5rem' }}>
+        <strong style={{ fontSize: '1rem' }}>Something went wrong!</strong>
+        <button
+          style={{
+            appearance: 'none',
+            fontSize: '.6em',
+            border: '1px solid currentColor',
+            padding: '.1rem .2rem',
+            fontWeight: 'bold',
+            borderRadius: '.25rem',
+          }}
+          onClick={() => setShow((d) => !d)}
+        >
+          {show ? 'Hide Error' : 'Show Error'}
+        </button>
+      </div>
+      <div style={{ height: '.25rem' }} />
+      {show ? (
+        <div>
+          <pre
+            style={{
+              fontSize: '.7em',
+              border: '1px solid red',
+              borderRadius: '.25rem',
+              padding: '.3rem',
+              color: 'red',
+              overflow: 'auto',
+            }}
+          >
+            {error.message ? <code>{error.message}</code> : null}
+          </pre>
+        </div>
+      ) : null}
+    </div>
+  )
+}

package/src/Matches.tsx

@@ -0,0 +1,401 @@
+import * as React from 'react'
+import invariant from 'tiny-invariant'
+import warning from 'tiny-warning'
+import { CatchBoundary, ErrorComponent } from './CatchBoundary'
+import { useRouter, useRouterState } from './RouterProvider'
+import { ResolveRelativePath, ToOptions } from './link'
+import { AnyRoute, ReactNode, rootRouteId } from './route'
+import {
+  FullSearchSchema,
+  ParseRoute,
+  RouteById,
+  RouteByPath,
+  RouteIds,
+  RoutePaths,
+} from './routeInfo'
+import { RegisteredRouter } from './router'
+import { NoInfer, StrictOrFrom, pick } from './utils'
+
+export interface RouteMatch<
+  TRouteTree extends AnyRoute = AnyRoute,
+  TRouteId extends RouteIds<TRouteTree> = ParseRoute<TRouteTree>['id'],
+> {
+  id: string
+  routeId: TRouteId
+  pathname: string
+  params: RouteById<TRouteTree, TRouteId>['types']['allParams']
+  status: 'pending' | 'success' | 'error'
+  isFetching: boolean
+  showPending: boolean
+  invalid: boolean
+  error: unknown
+  paramsError: unknown
+  searchError: unknown
+  updatedAt: number
+  loadPromise?: Promise<void>
+  loaderData?: RouteById<TRouteTree, TRouteId>['types']['loaderData']
+  __resolveLoadPromise?: () => void
+  context: RouteById<TRouteTree, TRouteId>['types']['allContext']
+  search: FullSearchSchema<TRouteTree> &
+    RouteById<TRouteTree, TRouteId>['types']['fullSearchSchema']
+  fetchedAt: number
+  shouldReloadDeps: any
+  abortController: AbortController
+  cause: 'enter' | 'stay'
+}
+
+export type AnyRouteMatch = RouteMatch<any>
+
+export function Matches() {
+  const router = useRouter()
+  const routerState = useRouterState()
+  const matches = routerState.pendingMatches?.some((d) => d.showPending)
+    ? routerState.pendingMatches
+    : routerState.matches
+  const locationKey = routerState.resolvedLocation.state.key
+  const route = router.routesById[rootRouteId]!
+
+  const errorComponent = React.useCallback(
+    (props: any) => {
+      return React.createElement(ErrorComponent, {
+        ...props,
+        useMatch: route.useMatch,
+        useRouteContext: route.useRouteContext,
+        useSearch: route.useSearch,
+        useParams: route.useParams,
+      })
+    },
+    [route],
+  )
+
+  return (
+    <matchesContext.Provider value={matches}>
+      <CatchBoundary
+        resetKey={locationKey}
+        errorComponent={errorComponent}
+        onCatch={() => {
+          warning(
+            false,
+            `Error in router! Consider setting an 'errorComponent' in your RootRoute! 👍`,
+          )
+        }}
+      >
+        {matches.length ? <Match matches={matches} /> : null}
+      </CatchBoundary>
+    </matchesContext.Provider>
+  )
+}
+
+function SafeFragment(props: any) {
+  return <>{props.children}</>
+}
+
+export function Match({ matches }: { matches: RouteMatch[] }) {
+  const { options, routesById } = useRouter()
+  const match = matches[0]!
+  const routeId = match?.routeId
+  const route = routesById[routeId]!
+  const router = useRouter()
+  const locationKey = useRouterState().resolvedLocation.state?.key
+
+  const PendingComponent = (route.options.pendingComponent ??
+    options.defaultPendingComponent) as any
+
+  const pendingElement = PendingComponent
+    ? React.createElement(PendingComponent, {
+        useMatch: route.useMatch,
+        useRouteContext: route.useRouteContext,
+        useSearch: route.useSearch,
+        useParams: route.useParams,
+      })
+    : undefined
+
+  const routeErrorComponent =
+    route.options.errorComponent ??
+    options.defaultErrorComponent ??
+    ErrorComponent
+
+  const ResolvedSuspenseBoundary =
+    route.options.wrapInSuspense ?? pendingElement
+      ? React.Suspense
+      : SafeFragment
+
+  const errorComponent = routeErrorComponent
+    ? React.useCallback(
+        (props: any) => {
+          return React.createElement(routeErrorComponent, {
+            ...props,
+            useMatch: route.useMatch,
+            useRouteContext: route.useRouteContext,
+            useSearch: route.useSearch,
+            useParams: route.useParams,
+          })
+        },
+        [route],
+      )
+    : undefined
+
+  const ResolvedCatchBoundary = errorComponent ? CatchBoundary : SafeFragment
+
+  return (
+    <matchesContext.Provider value={matches}>
+      <ResolvedSuspenseBoundary fallback={pendingElement}>
+        <ResolvedCatchBoundary
+          resetKey={locationKey}
+          errorComponent={errorComponent}
+          onCatch={() => {
+            warning(false, `Error in route match: ${match.id}`)
+          }}
+        >
+          <MatchInner match={match} pendingElement={pendingElement} />
+        </ResolvedCatchBoundary>
+      </ResolvedSuspenseBoundary>
+    </matchesContext.Provider>
+  )
+}
+function MatchInner({
+  match,
+  pendingElement,
+}: {
+  match: RouteMatch
+  pendingElement: any
+}): any {
+  const { options, routesById } = useRouter()
+  const route = routesById[match.routeId]!
+
+  if (match.status === 'error') {
+    throw match.error
+  }
+
+  if (match.status === 'pending') {
+    if (match.showPending) {
+      return pendingElement || null
+    }
+    throw match.loadPromise
+  }
+
+  if (match.status === 'success') {
+    let comp = route.options.component ?? options.defaultComponent
+
+    if (comp) {
+      return React.createElement(comp, {
+        useMatch: route.useMatch,
+        useRouteContext: route.useRouteContext as any,
+        useSearch: route.useSearch,
+        useParams: route.useParams as any,
+        useLoaderData: route.useLoaderData,
+      })
+    }
+
+    return <Outlet />
+  }
+
+  invariant(
+    false,
+    'Idle routeMatch status encountered during rendering! You should never see this. File an issue!',
+  )
+}
+
+export function Outlet() {
+  const matches = React.useContext(matchesContext).slice(1)
+
+  if (!matches[0]) {
+    return null
+  }
+
+  return <Match matches={matches} />
+}
+
+export interface MatchRouteOptions {
+  pending?: boolean
+  caseSensitive?: boolean
+  includeSearch?: boolean
+  fuzzy?: boolean
+}
+
+export type MakeUseMatchRouteOptions<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+  TFrom extends RoutePaths<TRouteTree> = '/',
+  TTo extends string = '',
+  TMaskFrom extends RoutePaths<TRouteTree> = '/',
+  TMaskTo extends string = '',
+> = ToOptions<AnyRoute, TFrom, TTo, TMaskFrom, TMaskTo> & MatchRouteOptions
+
+export function useMatchRoute<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+>() {
+  const { matchRoute } = useRouter()
+
+  return React.useCallback(
+    <
+      TFrom extends RoutePaths<TRouteTree> = '/',
+      TTo extends string = '',
+      TMaskFrom extends RoutePaths<TRouteTree> = '/',
+      TMaskTo extends string = '',
+      TResolved extends string = ResolveRelativePath<TFrom, NoInfer<TTo>>,
+    >(
+      opts: MakeUseMatchRouteOptions<
+        TRouteTree,
+        TFrom,
+        TTo,
+        TMaskFrom,
+        TMaskTo
+      >,
+    ): false | RouteById<TRouteTree, TResolved>['types']['allParams'] => {
+      const { pending, caseSensitive, ...rest } = opts
+
+      return matchRoute(rest as any, {
+        pending,
+        caseSensitive,
+      })
+    },
+    [],
+  )
+}
+
+export type MakeMatchRouteOptions<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+  TFrom extends RoutePaths<TRouteTree> = '/',
+  TTo extends string = '',
+  TMaskFrom extends RoutePaths<TRouteTree> = '/',
+  TMaskTo extends string = '',
+> = ToOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo> &
+  MatchRouteOptions & {
+    // If a function is passed as a child, it will be given the `isActive` boolean to aid in further styling on the element it returns
+    children?:
+      | ((
+          params?: RouteByPath<
+            TRouteTree,
+            ResolveRelativePath<TFrom, NoInfer<TTo>>
+          >['types']['allParams'],
+        ) => ReactNode)
+      | React.ReactNode
+  }
+
+export function MatchRoute<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+  TFrom extends RoutePaths<TRouteTree> = '/',
+  TTo extends string = '',
+  TMaskFrom extends RoutePaths<TRouteTree> = '/',
+  TMaskTo extends string = '',
+>(
+  props: MakeMatchRouteOptions<TRouteTree, TFrom, TTo, TMaskFrom, TMaskTo>,
+): any {
+  const matchRoute = useMatchRoute()
+  const params = matchRoute(props as any)
+
+  if (typeof props.children === 'function') {
+    return (props.children as any)(params)
+  }
+
+  return !!params ? props.children : null
+}
+
+export function useMatch<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+  TFrom extends RouteIds<TRouteTree> = RouteIds<TRouteTree>,
+  TStrict extends boolean = true,
+  TRouteMatchState = RouteMatch<TRouteTree, TFrom>,
+  TSelected = TRouteMatchState,
+>(
+  opts: StrictOrFrom<TFrom> & {
+    select?: (match: TRouteMatchState) => TSelected
+  },
+): TStrict extends true ? TSelected : TSelected | undefined {
+  const nearestMatch = React.useContext(matchesContext)[0]!
+  const nearestMatchRouteId = nearestMatch?.routeId
+
+  const matchRouteId = useRouterState({
+    select: (state) => {
+      const matches = state.pendingMatches?.some((d) => d.showPending)
+        ? state.pendingMatches
+        : state.matches
+
+      const match = opts?.from
+        ? matches.find((d) => d.routeId === opts?.from)
+        : matches.find((d) => d.id === nearestMatch.id)
+
+      return match!.routeId
+    },
+  })
+
+  if (opts?.strict ?? true) {
+    invariant(
+      nearestMatchRouteId == matchRouteId,
+      `useMatch("${
+        matchRouteId as string
+      }") is being called in a component that is meant to render the '${nearestMatchRouteId}' route. Did you mean to 'useMatch("${
+        matchRouteId as string
+      }", { strict: false })' or 'useRoute("${
+        matchRouteId as string
+      }")' instead?`,
+    )
+  }
+
+  const matchSelection = useRouterState({
+    select: (state) => {
+      const matches = state.pendingMatches?.some((d) => d.showPending)
+        ? state.pendingMatches
+        : state.matches
+
+      const match = opts?.from
+        ? matches.find((d) => d.routeId === opts?.from)
+        : matches.find((d) => d.id === nearestMatch.id)
+
+      invariant(
+        match,
+        `Could not find ${
+          opts?.from
+            ? `an active match from "${opts.from}"`
+            : 'a nearest match!'
+        }`,
+      )
+
+      return opts?.select ? opts.select(match as any) : match
+    },
+  })
+
+  return matchSelection as any
+}
+
+export const matchesContext = React.createContext<RouteMatch[]>(null!)
+
+export function useMatches<T = RouteMatch[]>(opts?: {
+  select?: (matches: RouteMatch[]) => T
+}): T {
+  const contextMatches = React.useContext(matchesContext)
+
+  return useRouterState({
+    select: (state) => {
+      let matches = state.pendingMatches?.some((d) => d.showPending)
+        ? state.pendingMatches
+        : state.matches
+
+      matches = matches.slice(
+        matches.findIndex((d) => d.id === contextMatches[0]?.id),
+      )
+      return opts?.select ? opts.select(matches) : (matches as T)
+    },
+  })
+}
+
+export function useLoaderData<
+  TRouteTree extends AnyRoute = RegisteredRouter['routeTree'],
+  TFrom extends RouteIds<TRouteTree> = RouteIds<TRouteTree>,
+  TStrict extends boolean = true,
+  TRouteMatch extends RouteMatch<TRouteTree, TFrom> = RouteMatch<
+    TRouteTree,
+    TFrom
+  >,
+  TSelected = TRouteMatch['loaderData'],
+>(
+  opts: StrictOrFrom<TFrom> & {
+    select?: (match: TRouteMatch) => TSelected
+  },
+): TStrict extends true ? TSelected : TSelected | undefined {
+  const match = useMatch({ ...opts, select: undefined })!
+
+  return typeof opts.select === 'function'
+    ? opts.select(match?.loaderData)
+    : match?.loaderData
+}