@cedarjs/router 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cedar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# Redwood Router
+
+This is the built-in router for Redwood apps. It takes inspiration from Ruby on Rails, React Router, and Reach Router, but is very opinionated in its own way.
+
+Redwood Router (RR) is designed to list all routes in a single file, with limited nesting. We prefer this design, as it makes it very easy to track which routes map to which pages.
+
+## Package Leads
+
+- [@mojombo](https://github.com/mojombo)
+- [@tobbe](https://github.com/tobbe)
+- [@jtoar](https://github.com/jtoar)
+
+## Docs (and Features)
+
+For the complete documentation, see:
+
+- [RR Doc](https://deploy-preview-848--redwoodjs.netlify.app/docs/redwood-router)
+
+Features include:
+
+- Private routes
+- Prerendered routes
+- Sets of routes
+- Navigation and History
+- [Accessibility](https://redwoodjs.com/docs/accessibility)
+- and more...
+
+## Contributing
+
+Want to make RR even better? Contributions are welcome!
+
+A great way to get started is looking through these open issues:
+
+- [Current RR GitHub Issues](https://github.com/redwoodjs/redwood/issues?q=is%3Aopen+is%3Aissue+label%3Atopic%2Frouter)
+
+If you have questions, you can reach out to the package leads or ask for help in the "Contributors" channels on either [Redwood Discord](https://discord.gg/redwoodjs) or [Redwood Forums](https://community.redwoodjs.com/).

package/dist/ActivePageContext.d.ts

@@ -0,0 +1,15 @@
+import type { LocationContextType } from './location.js';
+export type LoadingState = 'PRE_SHOW' | 'SHOW_LOADING' | 'DONE';
+export type LoadingStateRecord = Record<string, {
+    specName: string;
+    state: LoadingState;
+    page: React.ComponentType<unknown>;
+    location: LocationContextType;
+} | undefined>;
+interface ActivePageState {
+    loadingState: LoadingStateRecord;
+}
+export declare const ActivePageContextProvider: import("react").Provider<ActivePageState | undefined>;
+export declare const useActivePageContext: () => ActivePageState;
+export {};
+//# sourceMappingURL=ActivePageContext.d.ts.map

package/dist/ActivePageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivePageContext.d.ts","sourceRoot":"","sources":["../src/ActivePageContext.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAExD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CACrC,MAAM,EACJ;IACE,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IAClC,QAAQ,EAAE,mBAAmB,CAAA;CAC9B,GACD,SAAS,CACZ,CAAA;AAED,UAAU,eAAe;IACvB,YAAY,EAAE,kBAAkB,CAAA;CACjC;AAID,eAAO,MAAM,yBAAyB,uDAA6B,CAAA;AAEnE,eAAO,MAAM,oBAAoB,uBAUhC,CAAA"}

package/dist/ActivePageContext.js

@@ -0,0 +1,17 @@
+import { useContext } from "react";
+import { createNamedContext } from "./createNamedContext.js";
+const ActivePageContext = createNamedContext("ActivePage");
+const ActivePageContextProvider = ActivePageContext.Provider;
+const useActivePageContext = () => {
+  const activePageContext = useContext(ActivePageContext);
+  if (!activePageContext) {
+    throw new Error(
+      "useActivePageContext must be used within a ActivePageContext provider"
+    );
+  }
+  return activePageContext;
+};
+export {
+  ActivePageContextProvider,
+  useActivePageContext
+};

package/dist/AuthenticatedRoute.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { GeneratedRoutesMap } from './analyzeRoutes.js';
+interface AuthenticatedRouteProps {
+    children: React.ReactNode | Thenable<React.ReactNode>;
+    roles?: string | string[];
+    unauthenticated: keyof GeneratedRoutesMap;
+    whileLoadingAuth?: () => React.ReactElement | null;
+}
+export declare const AuthenticatedRoute: React.FC<AuthenticatedRouteProps>;
+export {};
+//# sourceMappingURL=AuthenticatedRoute.d.ts.map

package/dist/AuthenticatedRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthenticatedRoute.d.ts","sourceRoot":"","sources":["../src/AuthenticatedRoute.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAK5D,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACrD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,eAAe,EAAE,MAAM,kBAAkB,CAAA;IACzC,gBAAgB,CAAC,EAAE,MAAM,KAAK,CAAC,YAAY,GAAG,IAAI,CAAA;CACnD;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA6DhE,CAAA"}

package/dist/AuthenticatedRoute.js

@@ -0,0 +1,49 @@
+import React, { useCallback } from "react";
+import { namedRoutes } from "./namedRoutes.js";
+import { Redirect } from "./redirect.js";
+import { useRouterState } from "./router-context.js";
+const AuthenticatedRoute = ({
+  unauthenticated,
+  roles,
+  whileLoadingAuth,
+  children
+}) => {
+  const routerState = useRouterState();
+  const {
+    loading: authLoading,
+    isAuthenticated,
+    hasRole
+  } = routerState.useAuth();
+  const unauthorized = useCallback(() => {
+    return !(isAuthenticated && (!roles || hasRole(roles)));
+  }, [isAuthenticated, roles, hasRole]);
+  if (unauthorized()) {
+    if (authLoading) {
+      return whileLoadingAuth?.() || null;
+    } else {
+      const currentLocation = globalThis.location.pathname + encodeURIComponent(globalThis.location.search);
+      const generatedRoutesMap = namedRoutes;
+      if (!generatedRoutesMap[unauthenticated]) {
+        throw new Error(`We could not find a route named ${unauthenticated}`);
+      }
+      let unauthenticatedPath;
+      try {
+        unauthenticatedPath = generatedRoutesMap[unauthenticated]();
+      } catch (e) {
+        if (e instanceof Error && /Missing parameter .* for route/.test(e.message)) {
+          throw new Error(
+            `Redirecting to route "${unauthenticated}" would require route parameters, which currently is not supported. Please choose a different route`
+          );
+        }
+        throw new Error(
+          `Could not redirect to the route named ${unauthenticated}`
+        );
+      }
+      return /* @__PURE__ */ React.createElement(Redirect, { to: `${unauthenticatedPath}?redirectTo=${currentLocation}` });
+    }
+  }
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, children);
+};
+export {
+  AuthenticatedRoute
+};

package/dist/PageLoadingContext.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export interface PageLoadingContextInterface {
+    loading: boolean;
+    setPageLoadingContext: (loading: boolean) => void;
+    delay?: number;
+}
+interface Props {
+    children: React.ReactNode;
+    delay?: number;
+}
+export declare const PageLoadingContextProvider: React.FC<Props>;
+export declare const usePageLoadingContext: () => PageLoadingContextInterface;
+export {};
+//# sourceMappingURL=PageLoadingContext.d.ts.map

package/dist/PageLoadingContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageLoadingContext.d.ts","sourceRoot":"","sources":["../src/PageLoadingContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAA;AAInD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAA;IAChB,qBAAqB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAKD,UAAU,KAAK;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,eAAO,MAAM,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAatD,CAAA;AAED,eAAO,MAAM,qBAAqB,mCAUjC,CAAA"}

package/dist/PageLoadingContext.js

@@ -0,0 +1,29 @@
+import React, { useContext, useState } from "react";
+import { createNamedContext } from "./createNamedContext.js";
+const PageLoadingContext = createNamedContext("PageLoading");
+const PageLoadingContextProvider = ({
+  children,
+  delay = 1e3
+}) => {
+  const [loading, setPageLoadingContext] = useState(false);
+  return /* @__PURE__ */ React.createElement(
+    PageLoadingContext.Provider,
+    {
+      value: { loading, setPageLoadingContext, delay }
+    },
+    children
+  );
+};
+const usePageLoadingContext = () => {
+  const pageLoadingContext = useContext(PageLoadingContext);
+  if (!pageLoadingContext) {
+    throw new Error(
+      "usePageLoadingContext must be used within a PageLoadingContext provider"
+    );
+  }
+  return pageLoadingContext;
+};
+export {
+  PageLoadingContextProvider,
+  usePageLoadingContext
+};

package/dist/Route.d.ts

@@ -0,0 +1,32 @@
+import type { ReactElement } from 'react';
+import type { PageType } from './page.js';
+export type RenderMode = 'stream' | 'html';
+export interface RedirectRouteProps {
+    redirect: string;
+    path: string;
+    name?: string;
+}
+export interface NotFoundRouteProps {
+    notfound: boolean;
+    page: PageType;
+    prerender?: boolean;
+    renderMode?: RenderMode;
+}
+export interface RouteProps {
+    path: string;
+    page: PageType;
+    name: string;
+    prerender?: boolean;
+    renderMode?: RenderMode;
+    whileLoadingPage?: () => ReactElement | null;
+}
+export type InternalRouteProps = Partial<RouteProps & RedirectRouteProps & NotFoundRouteProps>;
+/**
+ * Route is now a "virtual" component
+ * it is actually never rendered. All the page loading logic happens in active-route-loader
+ * and all the validation happens within utility functions called from the Router
+ */
+export declare function Route(props: RouteProps): JSX.Element;
+export declare function Route(props: RedirectRouteProps): JSX.Element;
+export declare function Route(props: NotFoundRouteProps): JSX.Element;
+//# sourceMappingURL=Route.d.ts.map

package/dist/Route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../src/Route.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,CAAA;CAC7C;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,UAAU,GAAG,kBAAkB,GAAG,kBAAkB,CACrD,CAAA;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,CAAA;AACrD,wBAAgB,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAAA;AAC7D,wBAAgB,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,GAAG,CAAC,OAAO,CAAA"}

package/dist/Route.js

@@ -0,0 +1,7 @@
+import React from "react";
+function Route(_props) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null);
+}
+export {
+  Route
+};

package/dist/Set.d.ts

@@ -0,0 +1,58 @@
+import type { ReactElement, ReactNode } from 'react';
+import React from 'react';
+export type WrapperType<WTProps> = (props: Omit<WTProps, 'wrap' | 'children'> & {
+    children: ReactNode;
+}) => ReactElement | null;
+type SetProps<P> = P & {
+    /**
+     * P is the interface for the props that are forwarded to the wrapper
+     * components. TypeScript will most likely infer this for you, but if you
+     * need to you can specify it yourself in your JSX like so:
+     *   <Set<{theme: string}> wrap={ThemableLayout} theme="dark">
+     */
+    wrap?: WrapperType<P> | WrapperType<P>[];
+    /**
+     *`Routes` nested in a `<Set>` with `private` specified require
+     * authentication. When a user is not authenticated and attempts to visit
+     * the wrapped route they will be redirected to `unauthenticated` route.
+     *
+     * @deprecated Please use `<PrivateSet>` instead
+     */
+    private?: boolean;
+    /**
+     * The page name where a user will be redirected when not authenticated
+     *
+     * @deprecated Please use `<PrivateSet>` instead and specify this prop there
+     */
+    unauthenticated?: string;
+    /**
+     * Route is permitted when authenticated and user has any of the provided
+     * roles such as "admin" or ["admin", "editor"]
+     */
+    roles?: string | string[];
+    /** Prerender all pages in the set */
+    prerender?: boolean;
+    children: ReactNode;
+    /** Loading state for auth to distinguish with whileLoading */
+    whileLoadingAuth?: () => ReactElement | null;
+    whileLoadingPage?: () => ReactElement | null;
+};
+/**
+ * TypeScript will often infer the type of the props you can forward to the
+ * wrappers for you, but if you need to you can specify it yourself in your
+ * JSX like so:
+ *   <Set<{theme: string}> wrap={ThemeableLayout} theme="dark">
+ */
+export declare function Set<WrapperProps>(props: SetProps<WrapperProps>): React.JSX.Element;
+type PrivateSetProps<P> = P & Omit<SetProps<P>, 'private' | 'unauthenticated'> & {
+    /** The page name where a user will be redirected when not authenticated */
+    unauthenticated: string;
+};
+/** @deprecated Please use `<PrivateSet>` instead */
+export declare function Private<WrapperProps>(props: PrivateSetProps<WrapperProps>): React.JSX.Element;
+export declare function PrivateSet<WrapperProps>(props: PrivateSetProps<WrapperProps>): React.JSX.Element;
+export declare const isSetNode: (node: ReactNode) => node is ReactElement<SetProps<any>>;
+export declare const isPrivateSetNode: (node: ReactNode) => node is ReactElement<PrivateSetProps<unknown>>;
+export declare const isPrivateNode: (node: ReactNode) => node is ReactElement<SetProps<any>>;
+export {};
+//# sourceMappingURL=Set.d.ts.map

package/dist/Set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Set.d.ts","sourceRoot":"","sources":["../src/Set.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACpD,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI,CACjC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAC1C,QAAQ,EAAE,SAAS,CAAA;CACpB,KACE,YAAY,GAAG,IAAI,CAAA;AAExB,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,CAAA;IAC5C,gBAAgB,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,CAAA;CAC7C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,qBAI9D;AAED,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,iBAAiB,CAAC,GAAG;IACjD,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAEH,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,eAAe,CAAC,YAAY,CAAC,qBAIzE;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,KAAK,EAAE,eAAe,CAAC,YAAY,CAAC,qBAI5E;AAED,eAAO,MAAM,SAAS,SACd,SAAS,KACd,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAOpC,CAAA;AAED,eAAO,MAAM,gBAAgB,SACrB,SAAS,KACd,IAAI,IAAI,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,CAE/C,CAAA;AAGD,eAAO,MAAM,aAAa,SAClB,SAAS,KACd,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAEpC,CAAA"}

package/dist/Set.js

@@ -0,0 +1,28 @@
+import React from "react";
+function Set(props) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, props.children);
+}
+function Private(props) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, props.children);
+}
+function PrivateSet(props) {
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, props.children);
+}
+const isSetNode = (node) => {
+  return React.isValidElement(node) && (node.type === Set || node.type === PrivateSet || node.type === Private) && // Don't even bother including Sets without children. They're useless.
+  node.props.children;
+};
+const isPrivateSetNode = (node) => {
+  return React.isValidElement(node) && node.type === PrivateSet;
+};
+const isPrivateNode = (node) => {
+  return React.isValidElement(node) && node.type === Private;
+};
+export {
+  Private,
+  PrivateSet,
+  Set,
+  isPrivateNode,
+  isPrivateSetNode,
+  isSetNode
+};

package/dist/a11yUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * gets the announcement for the new page.
+ * called in one of active-route-loader's `useEffect`.
+ *
+ * the order of priority is:
+ * 1. RouteAnnouncement (the most specific one)
+ * 2. h1
+ * 3. document.title
+ * 4. location.pathname
+ */
+export declare const getAnnouncement: () => string;
+export declare const getFocus: () => HTMLElement | null;
+export declare const resetFocus: () => void;
+//# sourceMappingURL=a11yUtils.d.ts.map

package/dist/a11yUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11yUtils.d.ts","sourceRoot":"","sources":["../src/a11yUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,cAkB3B,CAAA;AAED,eAAO,MAAM,QAAQ,0BAapB,CAAA;AAGD,eAAO,MAAM,UAAU,YAItB,CAAA"}

package/dist/a11yUtils.js

@@ -0,0 +1,35 @@
+const getAnnouncement = () => {
+  const routeAnnouncement = globalThis?.document.querySelectorAll(
+    "[data-redwood-route-announcement]"
+  )?.[0];
+  if (routeAnnouncement?.textContent) {
+    return routeAnnouncement.textContent;
+  }
+  const pageHeading = globalThis?.document.querySelector(`h1`);
+  if (pageHeading?.textContent) {
+    return pageHeading.textContent;
+  }
+  if (globalThis?.document.title) {
+    return document.title;
+  }
+  return `new page at ${globalThis?.location.pathname}`;
+};
+const getFocus = () => {
+  const routeFocus = globalThis?.document.querySelectorAll(
+    "[data-redwood-route-focus]"
+  )?.[0];
+  if (!routeFocus?.children.length || routeFocus.children[0].tabIndex < 0) {
+    return null;
+  }
+  return routeFocus.children[0];
+};
+const resetFocus = () => {
+  globalThis?.document.body.setAttribute("tabindex", "-1");
+  globalThis?.document.body.focus();
+  globalThis?.document.body.removeAttribute("tabindex");
+};
+export {
+  getAnnouncement,
+  getFocus,
+  resetFocus
+};

package/dist/active-route-loader.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { Spec } from './page.js';
+interface Props {
+    path: string;
+    spec: Spec;
+    params?: Record<string, string>;
+    whileLoadingPage?: () => React.ReactNode | null;
+    children?: React.ReactNode;
+}
+export declare const ActiveRouteLoader: ({ spec, params, whileLoadingPage, }: Props) => React.JSX.Element;
+export {};
+//# sourceMappingURL=active-route-loader.d.ts.map

package/dist/active-route-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-route-loader.d.ts","sourceRoot":"","sources":["../src/active-route-loader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAG1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIrC,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAiCD,eAAO,MAAM,iBAAiB,wCAI3B,KAAK,sBAmEP,CAAA"}

package/dist/active-route-loader.js

@@ -0,0 +1,82 @@
+import React, { Suspense, useEffect, useRef } from "react";
+import { getAnnouncement, getFocus, resetFocus } from "./a11yUtils.js";
+import { usePageLoadingContext } from "./PageLoadingContext.js";
+import { inIframe } from "./util.js";
+let isPrerendered = false;
+if (typeof window !== "undefined") {
+  const redwoodAppElement = document.getElementById("redwood-app");
+  if (redwoodAppElement && redwoodAppElement.children.length > 0) {
+    isPrerendered = true;
+  }
+}
+let firstLoad = true;
+const Fallback = ({ children }) => {
+  const { loading, setPageLoadingContext, delay } = usePageLoadingContext();
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      setPageLoadingContext(true);
+    }, delay);
+    return () => {
+      clearTimeout(timer);
+      setPageLoadingContext(false);
+    };
+  }, [delay, setPageLoadingContext]);
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, loading ? children : null);
+};
+const ActiveRouteLoader = ({
+  spec,
+  params,
+  whileLoadingPage
+}) => {
+  const announcementRef = useRef(null);
+  const usePrerenderLoader = (
+    // Prerendering doesn't work with Streaming/SSR yet. So we disable it.
+    !globalThis.RWJS_EXP_STREAMING_SSR && (globalThis.__REDWOOD__PRERENDERING || isPrerendered && firstLoad)
+  );
+  const LazyRouteComponent = usePrerenderLoader ? spec.prerenderLoader(spec.name).default : spec.LazyComponent;
+  if (firstLoad) {
+    firstLoad = false;
+  }
+  useEffect(() => {
+    if (inIframe()) {
+      return;
+    }
+    if (announcementRef.current) {
+      announcementRef.current.innerText = getAnnouncement();
+    }
+    const routeFocus = getFocus();
+    if (!routeFocus) {
+      resetFocus();
+    } else {
+      routeFocus.focus();
+    }
+  }, [spec, params]);
+  if (params) {
+    delete params["ref"];
+    delete params["key"];
+  }
+  return /* @__PURE__ */ React.createElement(Suspense, { fallback: /* @__PURE__ */ React.createElement(Fallback, null, whileLoadingPage?.()) }, /* @__PURE__ */ React.createElement(LazyRouteComponent, { ...params }), /* @__PURE__ */ React.createElement(
+    "div",
+    {
+      id: "redwood-announcer",
+      style: {
+        position: "absolute",
+        top: 0,
+        width: 1,
+        height: 1,
+        padding: 0,
+        overflow: "hidden",
+        clip: "rect(0, 0, 0, 0)",
+        whiteSpace: "nowrap",
+        border: 0
+      },
+      role: "alert",
+      "aria-live": "assertive",
+      "aria-atomic": "true",
+      ref: announcementRef
+    }
+  ));
+};
+export {
+  ActiveRouteLoader
+};

package/dist/analyzeRoutes.d.ts

@@ -0,0 +1,44 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { PageType } from './page.js';
+import { type ParamType } from './util.js';
+type WhileLoadingPage = () => ReactElement | null;
+export type GeneratedRoutesMap = {
+    [key: string]: (args?: Record<string | number, string | number | boolean>) => string;
+};
+export type Wrappers = ((props: any) => ReactNode)[];
+interface Set {
+    id: string;
+    wrappers: Wrappers;
+    isPrivate: boolean;
+    props: {
+        private?: boolean;
+        [key: string]: unknown;
+    };
+}
+type RoutePath = string;
+/**
+ * This is essentially the same as RouteProps
+ * but it allows for page and redirect to be null or undefined
+ * Keeping the shape consistent makes it easier to use
+ */
+interface AnalyzedRoute {
+    path: RoutePath;
+    name: string | null;
+    whileLoadingPage?: WhileLoadingPage;
+    page: PageType | null;
+    redirect: string | null;
+    sets: Set[];
+}
+interface AnalyzeRoutesOptions {
+    currentPathName: string;
+    userParamTypes?: Record<string, ParamType>;
+}
+export declare function analyzeRoutes(children: ReactNode, { currentPathName, userParamTypes }: AnalyzeRoutesOptions): {
+    pathRouteMap: Record<string, AnalyzedRoute>;
+    namedRoutesMap: GeneratedRoutesMap;
+    hasRootRoute: boolean;
+    NotFoundPage: PageType | undefined;
+    activeRoutePath: string | undefined;
+};
+export {};
+//# sourceMappingURL=analyzeRoutes.d.ts.map

package/dist/analyzeRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeRoutes.d.ts","sourceRoot":"","sources":["../src/analyzeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAQzC,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,WAAW,CAAA;AAElB,KAAK,gBAAgB,GAAG,MAAM,YAAY,GAAG,IAAI,CAAA;AAIjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,CACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,KACtD,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,EAAE,CAAA;AAEpD,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED,KAAK,SAAS,GAAG,MAAM,CAAA;AAEvB;;;;GAIG;AACH,UAAU,aAAa;IACrB,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AAED,UAAU,oBAAoB;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAC3C;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,EACnB,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,oBAAoB;;;;;;EA6K1D"}