eddev 2.0.0-beta.9 → 2.0.0-beta.91

package/dist/app/lib/routing/components/BackButton.js

@@ -0,0 +1,47 @@
+import { useMemo } from "react";
+import { useRoute } from "../hooks/useRoute";
+import { useRouter } from "../hooks/useRouter";
+import { useRouterState } from "../hooks/useRouterState";
+import { getLinkHandlerMode } from "../utils";
+/**
+ * Display a back button that will navigate to the previous page in the router's history.
+ *
+ * This will allow you to render a back button on the condition that the back button will not send the user to a different website.
+ */
+export function BackButton(props) {
+    const router = useRouter();
+    const prevRoute = useRouterState((state) => state.history[state.history.length - 2]);
+    const contextRoute = useRoute();
+    const activeRoute = useRouterState((state) => state.activeRoute);
+    const route = props.mode === "global" ? activeRoute : contextRoute;
+    const backAction = useMemo(() => {
+        if (prevRoute && (!props.filter || props.filter(prevRoute))) {
+            return (e) => {
+                const { mode } = getLinkHandlerMode(e, prevRoute.uri);
+                if (mode === "navigate") {
+                    e.preventDefault();
+                    history.back();
+                    // history.length
+                }
+                else if (mode === "ignore") {
+                    e.preventDefault();
+                }
+            };
+        }
+        else if (props.fallbackHref) {
+            return (e) => {
+                const { mode } = getLinkHandlerMode(e, props.fallbackHref);
+                if (mode === "navigate") {
+                    e.preventDefault();
+                    router.navigate(props.fallbackHref);
+                }
+                else if (mode === "ignore") {
+                    e.preventDefault();
+                }
+            };
+        }
+    }, [route, props.filter, props.fallbackHref]);
+    if (backAction) {
+        return props.render ? props.render({ route: prevRoute, onClick: backAction }) : null;
+    }
+}

package/dist/app/lib/routing/components/BrowserRouter.d.ts

@@ -1,4 +1,7 @@
 import { PropsWithChildren } from "react";
-type Props = PropsWithChildren<{}>;
+import { type RouterAPI } from "../types.js";
+type Props = PropsWithChildren<{
+    routerRef?: React.MutableRefObject<RouterAPI | null>;
+}>;
 export declare function BrowserRouter(props: Props): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/app/lib/routing/components/BrowserRouter.js

@@ -1,11 +1,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState, useTransition } from "react";
-import { isRelative, parseURL, resolveURL } from "ufo";
-import { RouterContext, RouterStateContext } from "../context";
-import { RouteLoader } from "../loader";
-import { getLinkHandlerMode, normalizeRoute, parseQuery, stringifyRouteLink } from "../utils";
-import { AppRenderer } from "./RouteRenderer";
+import { isEqual, isRelative, parseURL, resolveURL } from "ufo";
+import { clientMetaTags, RouterContext, RouterStateContext } from "../context.js";
+import { $routeMetaStore } from "../hooks/useRouteMeta.js";
+import { RouteLoader } from "../loader.js";
+import { getLinkHandlerMode, getRouteMeta, isSamePathname, normalizeRoute, parseQuery, stringifyRouteLink, } from "../utils.js";
+import { AppRenderer } from "./RouteRenderer.js";
+// Create a global RouteLoader instance
 const loader = new RouteLoader();
+// Create a unique ID for each history entry
+let historyStamp = String(new Date().getTime());
+let historyIndex = 0;
+function getHistoryId() {
+    return historyStamp + historyIndex++;
+}
+// Set up the initial route data
 let initialRoute;
 let initialRouteHydrated = false;
 if (env.client && !env.admin) {
@@ -23,7 +32,10 @@ if (env.client && !env.admin) {
         search: "",
         query: {},
         view: initialData.view,
+        meta: getRouteMeta(initialData),
     });
+    history.replaceState(historyStateForRoute(initialRoute), "", document.location.href);
+    $routeMetaStore.data = getRouteMeta(initialData);
 }
 function parseHrefPath(url) {
     if (isRelative(url)) {
@@ -54,14 +66,9 @@ function historyStateForRoute(route) {
         state: route.returnState,
     };
 }
-let index = 0;
-function getHistoryId() {
-    return String(index++);
-}
 let lastRouterState = null;
 export function BrowserRouter(props) {
     const pendingRoute = useRef(null);
-    // const [activeRoute, setActiveRoute] = useState<RouteState>(initialRoute)
     const [transitioning, startTransition] = useTransition();
     const [routerState, setRouterState] = useState(() => ({
         activeRoute: initialRoute,
@@ -79,6 +86,16 @@ export function BrowserRouter(props) {
                 ...state,
                 ...update,
             };
+            if (state?.activeRoute?.meta?.tags) {
+                if (env.serverless) {
+                    clientMetaTags.setMetaTags(state.activeRoute.meta.tags ?? []);
+                }
+                else {
+                    const title = state.activeRoute.meta.tags.find((tag) => tag.tagName === "title")?.inner;
+                    if (title)
+                        document.title = title;
+                }
+            }
             setRouterState(state);
         };
         const internals = {
@@ -181,11 +198,20 @@ export function BrowserRouter(props) {
             });
             if (cancelled)
                 return;
-            const data = await loader.loadRouteData(parseHrefPath(args.url));
-            if (!data.view) {
-                console.error("No `view` property in route data");
-                return;
-            }
+            const data = await loader.loadRouteData(parseHrefPath(args.url)).catch((err) => {
+                emitEvent({ type: "error", error: err, critical: true });
+                return {
+                    view: "_error",
+                    viewType: "react",
+                    appData: loader.appData,
+                    viewData: {
+                        data: {
+                            code: 500,
+                            error: err,
+                        },
+                    },
+                };
+            });
             const lazyComponent = loader.getRouteComponent(data.view);
             if (!lazyComponent) {
                 console.error(`No component found for view: ${data.view}`);
@@ -196,11 +222,12 @@ export function BrowserRouter(props) {
                     hash: link.hash,
                     search: "",
                     query: link.query,
-                    pathname: link.pathname,
+                    pathname: data.canonical ?? link.pathname,
                     view: data.view,
                     props: data.viewData?.data ?? {},
                     component: lazyComponent,
                     returnState: args.restoreState ?? {},
+                    meta: getRouteMeta(data),
                 });
             setState({
                 pendingRoute: route,
@@ -229,6 +256,7 @@ export function BrowserRouter(props) {
                     lastRoute: currentRoute,
                     link,
                 });
+                $routeMetaStore.data = route.meta;
             };
             startTransition(() => {
                 pendingRoute.current = route;
@@ -247,6 +275,9 @@ export function BrowserRouter(props) {
                     goingBack: false,
                 });
             },
+            getState() {
+                return state;
+            },
             replaceHash(hash) {
                 replaceRoute({
                     ...getActiveRoute(),
@@ -257,6 +288,7 @@ export function BrowserRouter(props) {
                 replaceRoute({
                     ...getActiveRoute(),
                     query,
+                    returnState: captureState(),
                 });
             },
             async prefetch(url) {
@@ -265,7 +297,7 @@ export function BrowserRouter(props) {
                     if (loader.hasRouteData(link.pathname))
                         return;
                     emitEvent({ type: "preload:start", currentRoute: getActiveRoute(), link });
-                    const data = await loader.loadRouteData(link.pathname).then((data) => {
+                    await loader.loadRouteData(link.pathname).then((data) => {
                         emitEvent({ type: "preload:data-ready", currentRoute: getActiveRoute(), link, data });
                     });
                 }
@@ -297,8 +329,8 @@ export function BrowserRouter(props) {
                     subscribers.delete(fn);
                 };
             },
-            handleClickEvent(e, originalHref) {
-                const { mode, href } = getLinkHandlerMode(e, originalHref);
+            handleClickEvent(e, originalHref, preferBack) {
+                const { mode, href } = getLinkHandlerMode(e, originalHref, state.activeRoute);
                 if (mode === "ignore") {
                     e.preventDefault();
                     return;
@@ -308,10 +340,53 @@ export function BrowserRouter(props) {
                 }
                 else if (mode === "navigate" && href) {
                     e.preventDefault();
+                    if (preferBack) {
+                        const lastState = state.history.length > 1 && state.history[state.history.length - 2];
+                        if (lastState) {
+                            const doesMatch = preferBack === "exact" ? isEqual(href, lastState.uri) : isSamePathname(href, lastState.uri);
+                            if (doesMatch) {
+                                history.back();
+                                return;
+                            }
+                        }
+                    }
                     api.navigate(href);
                 }
             },
             emitEvent,
+            restoreRoute(route) {
+                const stack = state.history;
+                // Is the route in our history stack? (going back)
+                const index = stack.findIndex((item) => item.id === route.id);
+                if (index >= 0) {
+                    return doRouteTransition({
+                        url: route.uri,
+                        route,
+                        goingBack: true,
+                        history: stack.slice(0, index),
+                        restoreState: route.returnState,
+                        shouldPush: false,
+                    });
+                }
+                // Is the route in our history _cache_? (probably going forward)
+                if (historyCache.has(route.id)) {
+                    return doRouteTransition({
+                        url: route.uri,
+                        route,
+                        goingBack: false,
+                        history: stack,
+                        restoreState: route.returnState,
+                        shouldPush: false,
+                    });
+                }
+                return doRouteTransition({
+                    url: route.uri,
+                    goingBack: false,
+                    history: stack,
+                    restoreState: route.returnState,
+                    shouldPush: false,
+                });
+            },
         };
         return {
             api,
@@ -340,6 +415,7 @@ export function BrowserRouter(props) {
         // Handle popState
         // const router = useRouterStore.getState()
         const onPopState = (e) => {
+            // console.log("Popped", e.state)
             internals.poppedState?.(document.location.href, e.state ?? {});
         };
         window.addEventListener("popstate", onPopState);

package/dist/app/lib/routing/components/ClientOnly.d.ts

@@ -8,5 +8,5 @@ type Props = PropsWithChildren<{
  *
  * The optional 'fallback' prop can be used to show a loading state or placeholder content while the client bundle is loading.
  */
-export declare function ClientOnly(props: Props): string | number | boolean | import("react/jsx-runtime").JSX.Element | Iterable<import("react").ReactNode> | null;
+export declare function ClientOnly(props: Props): string | number | boolean | Iterable<import("react").ReactNode> | import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/app/lib/routing/components/ClientOnly.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Fragment } from "react";
-import { useIsSSR } from "../hooks/useIsSSR";
+import { useIsSSR } from "../hooks/useIsSSR.js";
 /**
  * Renders children, but only on the client.
  *

package/dist/app/lib/routing/components/Link.d.ts

@@ -3,6 +3,7 @@ type Props<T extends ElementType = "a"> = NoInfer<Omit<ComponentPropsWithRef<T>,
     href?: string | null;
     target?: string | null;
     as?: T;
+    preferBack?: boolean | "exact";
 };
 export declare const Link: <T extends ElementType = "a">(props: Props<T>) => ReactElement;
 /**

package/dist/app/lib/routing/components/Link.js

@@ -1,13 +1,13 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef, useMemo } from "react";
 import { parseURL, resolveURL, withoutTrailingSlash } from "ufo";
-import { useIsSSR } from "../hooks/useIsSSR";
-import { useRouter } from "../hooks/useRouter";
-import { isSameOrigin } from "../utils";
-import { useRoute } from "../hooks/useRoute";
-import { useRouterState } from "../hooks/useRouterState";
-export const Link = forwardRef((props, ref) => {
-    const Comp = props.as || "a";
+import { useIsSSR } from "../hooks/useIsSSR.js";
+import { useRouter } from "../hooks/useRouter.js";
+import { addTrailingSlash, isSameOrigin } from "../utils.js";
+import { useRoute } from "../hooks/useRoute.js";
+import { useRouterState } from "../hooks/useRouterState.js";
+export const Link = forwardRef(({ preferBack, as, ...props }, ref) => {
+    const Comp = as || "a";
     if (env.admin) {
         return (_jsx(Comp, { ref: ref, ...props, href: props.href ?? undefined, onClick: (e) => {
                 props.onClick?.(e);
@@ -15,17 +15,16 @@ export const Link = forwardRef((props, ref) => {
             } }));
     }
     else {
-        const preload = useRouter((r) => r.preload);
-        const handleClickEvent = useRouter((r) => r.handleClickEvent);
+        const router = useRouter();
         const state = useLinkState(props.href ?? "");
-        return (_jsx(Comp, { ref: ref, "data-active": state.active ?? undefined, "data-child-active": state.childActive ?? undefined, "data-pending": state.pending ?? undefined, ...props, href: props.href ?? undefined, onMouseEnter: (e) => {
+        return (_jsx(Comp, { ref: ref, "data-active": state.active ?? undefined, "data-child-active": state.childActive ?? undefined, "data-pending": state.pending ?? undefined, ...props, href: addTrailingSlash(props.href), onMouseEnter: (e) => {
                 if (props.onMouseEnter) {
                     props.onMouseEnter(e);
                 }
-                preload(props.href);
+                router.preload(props.href);
             }, onClick: (e) => {
                 props.onClick?.(e);
-                handleClickEvent(e, props.href ?? undefined);
+                router.handleClickEvent(e, props.href ?? undefined, preferBack);
             } }));
     }
 });

package/dist/app/lib/routing/components/RouteRenderer.d.ts

@@ -1,4 +1,4 @@
-import { RouteState } from "../types";
+import { RouteState } from "../types.js";
 export declare const AppRenderer: import("react").MemoExoticComponent<() => import("react/jsx-runtime").JSX.Element>;
 export declare function MainRoute(): import("react/jsx-runtime").JSX.Element;
 export declare function RouteDisplay(props: {

package/dist/app/lib/routing/components/RouteRenderer.js

@@ -1,15 +1,16 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { memo, Suspense, useMemo } from "react";
-import { RouteItemContext } from "../context";
-import { useRouter } from "../hooks/useRouter";
-import { useRouterState } from "../hooks/useRouterState";
+import { memo, useMemo } from "react";
+import { RouteErrorBoundary } from "../../../utils/RouteErrorBoundary.js";
+import { RouteItemContext } from "../context.js";
+import { useRouter } from "../hooks/useRouter.js";
+import { useRouterState } from "../hooks/useRouterState.js";
 export const AppRenderer = memo(() => {
     const { appData, appComponent: AppComponent } = useRouter().loader;
     const { activeRoute } = useRouterState();
     const app = useMemo(() => {
         return (_jsx(AppComponent, { ...appData, children: _jsx(MainRoute, {}) }));
     }, [AppComponent, appData]);
-    return (_jsx(Suspense, { children: _jsx(RouteItemContext.Provider, { value: activeRoute, children: app }) }));
+    return _jsx(RouteItemContext.Provider, { value: activeRoute, children: app });
 });
 export function MainRoute() {
     const activeRoute = useRouterState((s) => s.activeRoute);
@@ -22,7 +23,7 @@ export function RouteDisplay(props) {
     }
     return useMemo(() => {
         let child = !!Component && _jsx(Component, { ...props.route.props });
-        return _jsx(RouteItemContext.Provider, { value: props.route, children: child });
+        return (_jsx(RouteErrorBoundary, { route: props.route, children: _jsx(RouteItemContext.Provider, { value: props.route, children: child }) }));
     }, [Component, props.route, props.route]);
 }
 RouteDisplay.displayName = "RouteDisplay";

package/dist/app/lib/routing/components/SSRRouter.d.ts

@@ -1,6 +1,6 @@
 import { PropsWithChildren } from "react";
-import { RouteLoader } from "../loader";
-import { RouteState } from "../types";
+import { RouteLoader } from "../loader.js";
+import { RouteState } from "../types.js";
 type Props = PropsWithChildren<{
     route: RouteState;
     loader: RouteLoader;

package/dist/app/lib/routing/components/SSRRouter.js

@@ -1,14 +1,13 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { Suspense } from "react";
-import { RouterContext, RouterStateContext } from "../context";
-import { useRouter } from "../hooks/useRouter";
-import { useRouterState } from "../hooks/useRouterState";
-import { AppRenderer } from "./RouteRenderer";
+import { RouterContext, RouterStateContext } from "../context.js";
+import { useRouter } from "../hooks/useRouter.js";
+import { useRouterState } from "../hooks/useRouterState.js";
+import { AppRenderer } from "./RouteRenderer.js";
 export function SSRRouter(props) {
     const router = useRouter();
     const routerState = useRouterState();
     router.loader = props.loader;
     routerState.history = [props.route];
     routerState.activeRoute = props.route;
-    return (_jsx(Suspense, { children: _jsx(RouterContext.Provider, { value: router, children: _jsx(RouterStateContext.Provider, { value: routerState, children: _jsx(AppRenderer, {}) }) }) }));
+    return (_jsx(RouterContext.Provider, { value: router, children: _jsx(RouterStateContext.Provider, { value: routerState, children: _jsx(AppRenderer, {}) }) }));
 }

package/dist/app/lib/routing/components/ScrollRestoration.js

@@ -1,4 +1,4 @@
-import { useRouterEvents } from "../hooks/useRouterEvents";
+import { useRouterEvents } from "../hooks/useRouterEvents.js";
 /**
  * Enables scroll restoration when navigation backwards, as well as resetting scroll position when navigating forwards.
  */
@@ -11,7 +11,10 @@ export function ScrollRestoration(props) {
         }));
     useRouterEvents((event) => {
         if (event.type === "navigate:changed") {
-            // console.log("Changed! Restoring scroll", event.currentRoute)
+            // If the pathname and search term are the same, then we're on the same page
+            const isSameRoute = event.currentRoute.pathname === event.lastRoute.pathname && event.currentRoute.search === event.lastRoute.search;
+            if (isSameRoute)
+                return;
             if (event.currentRoute.returnState) {
                 restore({
                     top: event.currentRoute.returnState.scrollTop ?? 0,

package/dist/app/lib/routing/context.d.ts

@@ -1,5 +1,8 @@
-import { Context } from "react";
-import { RouterAPI, RouterAPIState } from "./types";
-export declare const RouterContext: Context<RouterAPI>;
-export declare const RouterStateContext: Context<RouterAPIState>;
-export declare const RouteItemContext: Context<import("./types").TypedRouteState<"_unknown", {}>>;
+import { RouteMetaTag, RouterAPI, RouterAPIState } from "./types.js";
+export declare const RouterContext: import("react").Context<RouterAPI>;
+export declare const RouterStateContext: import("react").Context<RouterAPIState>;
+export declare const RouteItemContext: import("react").Context<import("./types.js").TypedRouteState<"_unknown", {}>>;
+export declare const clientMetaTags: {
+    tags: null | RouteMetaTag[];
+    setMetaTags(tags: RouteMetaTag[]): void;
+};

package/dist/app/lib/routing/context.js

@@ -1,5 +1,6 @@
 import { createContext } from "react";
-import { RouteLoader } from "./loader";
+import { RouteLoader } from "./loader.js";
+import { proxy } from "valtio";
 const NOOP_ROUTE = {
     component: () => null,
     id: "initial",
@@ -12,6 +13,7 @@ const NOOP_ROUTE = {
     search: "",
     query: {},
     returnState: undefined,
+    meta: {},
 };
 export const RouterContext = createContext({
     loader: new RouteLoader(),
@@ -25,6 +27,10 @@ export const RouterContext = createContext({
     replaceQuery(query) { },
     handleClickEvent(e, originalHref) { },
     emitEvent(event) { },
+    getState() {
+        return null;
+    },
+    restoreRoute(route) { },
 });
 export const RouterStateContext = createContext({
     history: [NOOP_ROUTE],
@@ -32,98 +38,9 @@ export const RouterStateContext = createContext({
     blockers: [],
 });
 export const RouteItemContext = createContext(NOOP_ROUTE);
-// type StoreHook<State> = <Slice = State>(
-//   selector?: (state: State) => Slice,
-//   areEqual?: (a: Slice, b: Slice) => boolean,
-// ) => Slice
-// type Store<T> = {
-//   subscribe(sub: (value: T) => void): () => void
-//   value: T
-//   update(next: T): void
-// }
-// function createStore<T>(initial: T): Store<T> {
-//   let value = initial
-//   const subscribers = new Set<(value: T) => void>()
-//   return {
-//     subscribe(sub: (value: T) => void) {
-//       subscribers.add(sub)
-//       return () => {
-//         subscribers.delete(sub)
-//       }
-//     },
-//     get value() {
-//       return value
-//     },
-//     update(nextValue: T) {
-//       value = nextValue
-//       if (subscribers.size) {
-//         console.log("UPDATE", value)
-//         startTransition(() => {
-//           for (let sub of subscribers) {
-//             sub(value)
-//           }
-//         })
-//       }
-//     },
-//   }
-// }
-// export function createStoreHook<T>(store: Store<T>): StoreHook<T> {
-//   const hook = (selector: any) => {
-//     const get = () => (selector ? selector(store.value) : store.value)
-//     return useSyncExternalStore(store.subscribe, get, get)
-//   }
-//   return hook as StoreHook<T>
-// }
-// export function createStoreContextHook<T>(ctx: Context<Store<T>>): StoreHook<T> {
-//   const hook = (selector: any) => {
-//     const store = useContext(ctx)
-//     const get = () => (selector ? selector(store.value) : store.value)
-//     return useSyncExternalStore(store.subscribe, get, get)
-//   }
-//   return hook as StoreHook<T>
-// }
-// export const RouterContext = createContext<Store<RouterAPI>>(null!)
-// export const RouterStateContext = createContext<Store<RouterAPIState>>(null!)
-// export const RouteContext = createContext<Store<RouteState>>(null!)
-// const NOOP_ROUTE: RouteState = {
-//   component: () => null,
-//   id: "initial",
-//   hash: "",
-//   key: "initial",
-//   pathname: "",
-//   props: {},
-//   uri: "",
-//   view: "_unknown",
-//   search: "",
-//   query: {},
-//   returnState: undefined,
-// }
-// export const createRouteItemStore = (initial?: RouteState) => {
-//   return createStore<RouteState>(initial ?? NOOP_ROUTE)
-// }
-// export function createRouterAPIStore(initial?: RouterAPI) {
-//   return createStore<RouterAPI>(
-//     initial ?? {
-//       loader: new RouteLoader(),
-//       async navigate(url) {},
-//       async prefetch(url) {},
-//       async preload(url) {},
-//       subscribe(fn) {
-//         return () => {}
-//       },
-//       replaceHash(hash) {},
-//       replaceQuery(query) {},
-//       handleClickEvent(e, originalHref) {},
-//       emitEvent(event) {},
-//     },
-//   )
-// }
-// export function createRouterStateStore(initial?: RouterAPIState) {
-//   return createStore<RouterAPIState>(
-//     initial ?? {
-//       history: [],
-//       activeRoute: NOOP_ROUTE,
-//       blockers: [],
-//     },
-//   )
-// }
+export const clientMetaTags = proxy({
+    tags: null,
+    setMetaTags(tags) {
+        clientMetaTags.tags = tags;
+    },
+});

package/dist/app/lib/routing/hooks/useRestorableState.d.ts

@@ -1,5 +1,6 @@
+import { Dispatch } from "react";
 /**
  * Works exactly like useState, but allows back and forward navigation to restore the previous state.
  * You must pass a unique ID as an additional first parameter to ensure the state is restored correctly.
  */
-export declare function useRestorableState<T>(key: string, fallback?: T): any[];
+export declare function useRestorableState<T>(key: string, fallback: T): [T, Dispatch<T>];

package/dist/app/lib/routing/hooks/useRestorableState.js

@@ -1,5 +1,6 @@
 import { useState } from "react";
-import { useRoute, useRouterEvents } from "..";
+import { useRouterEvents } from "./useRouterEvents.js";
+import { useRoute } from "./useRoute.js";
 /**
  * Works exactly like useState, but allows back and forward navigation to restore the previous state.
  * You must pass a unique ID as an additional first parameter to ensure the state is restored correctly.

package/dist/app/lib/routing/hooks/useRoute.d.ts

@@ -1,2 +1,17 @@
-import { RouteState } from "../types";
+import type { RouteState } from "../types.js";
+/**
+ * Returns the current route object.
+ *
+ * In most circumstances, this will be the active top-level route.
+ *
+ * In cases where manual rendering of routes is taking place, such as during page transitions or in some modal cases.
+ *
+ * @returns The current route
+ */
 export declare function useRoute(): RouteState;
+/**
+ * Returns the current route, if it matches the specified view, otherwise null.
+ */
+export declare function useViewRoute<V extends keyof ViewProps>(view: V): Extract<RouteState, {
+    view: V;
+}> | null;

package/dist/app/lib/routing/hooks/useRoute.js

@@ -1,5 +1,26 @@
 import { useContext } from "react";
-import { RouteItemContext } from "../context";
+import { RouteItemContext } from "../context.js";
+/**
+ * Returns the current route object.
+ *
+ * In most circumstances, this will be the active top-level route.
+ *
+ * In cases where manual rendering of routes is taking place, such as during page transitions or in some modal cases.
+ *
+ * @returns The current route
+ */
 export function useRoute() {
     return useContext(RouteItemContext);
 }
+/**
+ * Returns the current route, if it matches the specified view, otherwise null.
+ */
+export function useViewRoute(view) {
+    const route = useContext(RouteItemContext);
+    if (route.view === view) {
+        return route;
+    }
+    else {
+        return null;
+    }
+}

package/dist/app/lib/routing/hooks/useRouteMeta.d.ts

@@ -0,0 +1,5 @@
+import { RouteMeta } from "../types";
+export declare const $routeMetaStore: {
+    data: RouteMeta;
+};
+export declare function useRouteMeta(): RouteMeta;

package/dist/app/lib/routing/hooks/useRouteMeta.js

@@ -0,0 +1,9 @@
+import { proxy, useSnapshot } from "valtio";
+export const $routeMetaStore = proxy({
+    data: {},
+});
+export function useRouteMeta() {
+    return useSnapshot($routeMetaStore, {
+        sync: true,
+    }).data;
+}