@buzola/router 0.0.3 → 0.0.4

package/dist/react/index.d.ts

@@ -1,12 +1,12 @@
-export { BuzolaProvider } from './provider';
-export type { BuzolaProviderProps } from './provider';
-export { Outlet } from './outlet';
-export type { OutletProps } from './outlet';
-export { Link } from './link';
-export type { LinkProps } from './link';
-export { ErrorBoundary } from './error-boundary';
-export { useBlocker, useInvalidate, useNavigate, useNavigationState, useParams, useRoute, useRouter, useRouterState, useSearchParams } from './hooks';
-export type { BlockerState } from './hooks';
-export { RouteContext, RouterContext } from './context';
-export type { RouteContextValue } from './context';
+export { BuzolaProvider } from './provider.js';
+export type { BuzolaProviderProps, MiddlewareComponent, MiddlewareProps } from './provider.js';
+export { Outlet } from './outlet.js';
+export type { OutletProps } from './outlet.js';
+export { Link } from './link.js';
+export type { LinkProps } from './link.js';
+export { ErrorBoundary } from './error-boundary.js';
+export { useBlocker, useInvalidate, useNavigate, useNavigationState, useParams, useRoute, useRouter, useRouterState, useSearchParams, } from './hooks.js';
+export type { BlockerState } from './hooks.js';
+export { RouteContext, RouterContext } from './context.js';
+export type { RouteContextValue } from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACrJ,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE9F,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

package/dist/react/index.js

@@ -1,7 +1,7 @@
-export { BuzolaProvider } from './provider';
-export { Outlet } from './outlet';
-export { Link } from './link';
-export { ErrorBoundary } from './error-boundary';
-export { useBlocker, useInvalidate, useNavigate, useNavigationState, useParams, useRoute, useRouter, useRouterState, useSearchParams } from './hooks';
-export { RouteContext, RouterContext } from './context';
+export { BuzolaProvider } from './provider.js';
+export { Outlet } from './outlet.js';
+export { Link } from './link.js';
+export { ErrorBoundary } from './error-boundary.js';
+export { useBlocker, useInvalidate, useNavigate, useNavigationState, useParams, useRoute, useRouter, useRouterState, useSearchParams, } from './hooks.js';
+export { RouteContext, RouterContext } from './context.js';
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGrJ,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EACN,UAAU,EACV,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,cAAc,EACd,eAAe,GACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/react/link.d.ts

@@ -18,6 +18,11 @@ type LinkPropsBase = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'>
      * When `false`, `data-active` is also set when the current path starts with the link target.
      */
     activeExact?: boolean;
+    /**
+     * Render as child element instead of `<a>`.
+     * When `true`, clones the single child element and merges `href`, `onClick`, and `data-active` props into it.
+     */
+    asChild?: boolean;
 };
 export type LinkProps<P extends RegisteredPage = RegisteredPage> = [keyof EffectivePageParams<P>] extends [never] ? LinkPropsBase & {
     to: P;

package/dist/react/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/react/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAK9F,KAAK,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IAClF,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9G,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAEzC,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC9F,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAE5D;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAoDtF"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/react/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAK9F,KAAK,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IAClF,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC9G,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAEzC,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,GAC9F,aAAa,GAAG;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAAE,CAAA;AAE5D;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CA+DtF"}

package/dist/react/link.js

@@ -10,7 +10,7 @@ import { useRouter, useRouterState } from './hooks.js';
  * Sets `data-active` attribute when the link target matches the current URL.
  */
 export function Link(props) {
-    const { to, params, replace, state, viewTransition, resetScroll, activeExact = true, onClick, children, ...rest } = props;
+    const { to, params, replace, state, viewTransition, resetScroll, activeExact = true, asChild, onClick, children, ...rest } = props;
     const router = useRouter();
     const routerState = useRouterState();
     const href = router.buildPagePath(to, params);
@@ -33,6 +33,15 @@ export function Link(props) {
             router.navigateToPage(to, params, { replace, state, viewTransition, resetScroll });
         }
     }, [onClick, needsProgrammaticNav, router, to, params, replace, state, viewTransition, resetScroll]);
+    if (asChild) {
+        const child = React.Children.only(children);
+        return React.cloneElement(child, {
+            href,
+            onClick: handleClick,
+            'data-active': isActive ? '' : undefined,
+            ...rest,
+        });
+    }
     return (_jsx("a", { href: href, onClick: handleClick, "data-active": isActive ? '' : undefined, ...rest, children: children }));
 }
 //# sourceMappingURL=link.js.map

package/dist/react/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/react/link.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAE1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA8BtD;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAA2B,KAAmB;IACjE,MAAM,EACL,EAAE,EACF,MAAM,EACN,OAAO,EACP,KAAK,EACL,cAAc,EACd,WAAW,EACX,WAAW,GAAG,IAAI,EAClB,OAAO,EACP,QAAQ,EACR,GAAG,IAAI,EACP,GAAG,KAAwE,CAAA;IAE5E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,oBAAoB,GAAG,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,cAAc,IAAI,WAAW,KAAK,KAAK,CAAA;IAEtG,2DAA2D;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,WAAW,KAAK,UAAU,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,KAAK,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,CAAA;IAC/E,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,CAAA;IAEtD,MAAM,WAAW,GAAG,WAAW,CAC9B,CAAC,CAAsC,EAAE,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QACZ,IAAI,CAAC,CAAC,gBAAgB;YAAE,OAAM;QAE9B,gDAAgD;QAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAM;QAE9E,IAAI,oBAAoB,EAAE,CAAC;YAC1B,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB,MAAM,CAAC,cAAc,CACpB,EAAE,EACF,MAAM,EACN,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAqB,CAClE,CAAA;QACF,CAAC;IACF,CAAC,EACD,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,CAChG,CAAA;IAED,OAAO,CACN,YAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,iBAAe,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAM,IAAI,YACnF,QAAQ,GACN,CACJ,CAAA;AACF,CAAC"}
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/react/link.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAE1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAmCtD;;;;;;;GAOG;AACH,MAAM,UAAU,IAAI,CAA2B,KAAmB;IACjE,MAAM,EACL,EAAE,EACF,MAAM,EACN,OAAO,EACP,KAAK,EACL,cAAc,EACd,WAAW,EACX,WAAW,GAAG,IAAI,EAClB,OAAO,EACP,OAAO,EACP,QAAQ,EACR,GAAG,IAAI,EACP,GAAG,KAAwE,CAAA;IAE5E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;IAEpC,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,oBAAoB,GAAG,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,cAAc,IAAI,WAAW,KAAK,KAAK,CAAA;IAEtG,2DAA2D;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,WAAW,KAAK,UAAU,CAAA;IAC1C,MAAM,QAAQ,GAAG,UAAU,KAAK,GAAG,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,CAAA;IAC/E,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,CAAA;IAEtD,MAAM,WAAW,GAAG,WAAW,CAC9B,CAAC,CAAsC,EAAE,EAAE;QAC1C,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;QACZ,IAAI,CAAC,CAAC,gBAAgB;YAAE,OAAM;QAE9B,gDAAgD;QAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ;YAAE,OAAM;QAE9E,IAAI,oBAAoB,EAAE,CAAC;YAC1B,CAAC,CAAC,cAAc,EAAE,CAAA;YAClB,MAAM,CAAC,cAAc,CACpB,EAAE,EACF,MAAM,EACN,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAqB,CAClE,CAAA;QACF,CAAC;IACF,CAAC,EACD,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,CAChG,CAAA;IAED,IAAI,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAA4B,CAAA;QACtE,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE;YAChC,IAAI;YACJ,OAAO,EAAE,WAAW;YACpB,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;YACxC,GAAG,IAAI;SACP,CAAC,CAAA;IACH,CAAC;IAED,OAAO,CACN,YAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,iBAAe,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAM,IAAI,YACnF,QAAQ,GACN,CACJ,CAAA;AACF,CAAC"}

package/dist/react/outlet.d.ts

@@ -4,10 +4,12 @@ export interface OutletProps {
     fallback?: React.ReactNode;
     /** Fallback to show when a route component throws an error. */
     errorFallback?: React.ReactNode | ((error: Error) => React.ReactNode);
+    /** Content to show when no route matches. Defaults to a built-in 404 page. Pass `null` to render nothing. */
+    notFound?: React.ReactNode;
 }
 /**
  * Renders the component for the current depth in the route match chain.
  * Each Outlet increments the depth and renders the next matched route's component.
  */
-export declare function Outlet({ fallback, errorFallback }: OutletProps): React.ReactElement | null;
+export declare function Outlet({ fallback, errorFallback, notFound }: OutletProps): React.ReactElement | null;
 //# sourceMappingURL=outlet.d.ts.map

package/dist/react/outlet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAA;AAIrD,MAAM,WAAW,WAAW;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;CACrE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmD1F"}
+{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAA;AA4BrD,MAAM,WAAW,WAAW;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;IACrE,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAwDpG"}

package/dist/react/outlet.js

@@ -2,11 +2,29 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import React, { Suspense, use, useMemo } from 'react';
 import { RouteContext } from './context.js';
 import { ErrorBoundary } from './error-boundary.js';
+const isDev = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production';
+function DefaultNotFound() {
+    return React.createElement('div', {
+        style: { fontFamily: 'system-ui, sans-serif', padding: '2rem', maxWidth: '600px', margin: '0 auto' },
+    }, isDev
+        ? [
+            React.createElement('h1', { key: 'h' }, '404 — Page Not Found'),
+            React.createElement('p', { key: 'p1' }, `No route matches "${typeof window !== 'undefined' ? window.location.pathname : ''}".`),
+            React.createElement('p', {
+                key: 'p2',
+                style: { color: '#666', fontSize: '0.9rem' },
+            }, 'To handle this, add a _404.tsx catch-all route or pass a notFound prop to <Outlet />.'),
+        ]
+        : [
+            React.createElement('h1', { key: 'h' }, '404'),
+            React.createElement('p', { key: 'p' }, 'Page not found.'),
+        ]);
+}
 /**
  * Renders the component for the current depth in the route match chain.
  * Each Outlet increments the depth and renders the next matched route's component.
  */
-export function Outlet({ fallback, errorFallback }) {
+export function Outlet({ fallback, errorFallback, notFound }) {
     const routeContext = use(RouteContext);
     if (!routeContext) {
         throw new Error('<Outlet /> must be used within a <BuzolaProvider>');
@@ -38,6 +56,12 @@ export function Outlet({ fallback, errorFallback }) {
         };
     }, [state, depth, effectiveDepth, matches, match, routeContext.params]);
     if (!match) {
+        // At root depth with no matches — show 404
+        if (depth === 0 && matches.length === 0) {
+            if (notFound === null)
+                return null;
+            return (notFound ?? React.createElement(DefaultNotFound, null));
+        }
         return null;
     }
     const Component = match.node.component;

package/dist/react/outlet.js.map

@@ -1 +1 @@
-{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,EAAE,YAAY,EAA0B,MAAM,cAAc,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AASnD;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAe;IAC9D,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,CAAA;IACtC,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,CAAA;IAE9C,yEAAyE;IACzE,2DAA2D;IAC3D,IAAI,cAAc,GAAG,KAAK,CAAA;IAC1B,IAAI,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACnC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,cAAc,EAAE,CAAA;QAChB,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAA2B,GAAG,EAAE;QAC1D,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,gEAAgE;QAChE,IAAI,YAAY,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAA;QAC7C,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChB,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;YACzD,CAAC;QACF,CAAC;QACD,OAAO;YACN,KAAK;YACL,KAAK,EAAE,cAAc,GAAG,CAAC;YACzB,OAAO;YACP,MAAM,EAAE,YAAY;SACpB,CAAA;IACF,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IAEvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAU,CAAA;IAEvC,OAAO,CACN,KAAC,aAAa,IAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,YAC9D,KAAC,QAAQ,IAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI,YAClC,WAAW,IAAI,CACf,KAAC,YAAY,IAAC,KAAK,EAAE,WAAW,YAC/B,KAAC,SAAS,KAAG,GACC,CACf,GACS,GACI,CAChB,CAAA;AACF,CAAC"}
+{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../src/react/outlet.tsx"],"names":[],"mappings":"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"}

package/dist/react/provider.d.ts

@@ -1,8 +1,21 @@
 import React from 'react';
 import { Router } from '../engine/router.js';
-import type { RouteNode } from '../engine/types.js';
+import type { RouteMatch, RouteNode } from '../engine/types.js';
+/** Props passed to the middleware component. */
+export interface MiddlewareProps {
+    /** Merged params from all matched routes. */
+    params: Record<string, string>;
+    /** All route matches from root to leaf. */
+    matches: RouteMatch[];
+    /** The rendered route tree to wrap. */
+    children: React.ReactNode;
+}
+/** Middleware component that wraps the entire router output. */
+export type MiddlewareComponent = React.ComponentType<MiddlewareProps>;
 export type BuzolaProviderProps = {
     children?: React.ReactNode;
+    /** Global middleware that wraps the rendered route tree. Has access to all matched params. */
+    middleware?: MiddlewareComponent;
 } & ({
     router: Router;
     routes?: never;
@@ -18,5 +31,5 @@ export type BuzolaProviderProps = {
  * Root provider for Buzola router.
  * Subscribes to router state and provides context to the React tree.
  */
-export declare function BuzolaProvider({ routes, children, ...props }: BuzolaProviderProps): React.ReactElement;
+export declare function BuzolaProvider({ routes, children, middleware: Middleware, ...props }: BuzolaProviderProps): React.ReactElement;
 //# sourceMappingURL=provider.d.ts.map

package/dist/react/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwE,MAAM,OAAO,CAAA;AAE5F,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAInD,MAAM,MAAM,mBAAmB,GAC5B;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,GACC,CACC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,GAClF;IACD,MAAM,CAAC,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,CACD,CAAA;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAkCtG"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8E,MAAM,OAAO,CAAA;AAElG,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAI/D,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,uCAAuC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AAED,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC,CAAA;AAEtE,MAAM,MAAM,mBAAmB,GAC5B;IACD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,8FAA8F;IAC9F,UAAU,CAAC,EAAE,mBAAmB,CAAA;CAChC,GACC,CACC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,GAClF;IACD,MAAM,CAAC,EAAE,KAAK,CAAA;IACd,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC,CACD,CAAA;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CA+C9H"}

package/dist/react/provider.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import React, { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';
+import React, { useCallback, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from 'react';
 import { createBrowserNavigationAdapter } from '../engine/navigation-adapter.js';
 import { Router } from '../engine/router.js';
 import { RouteContext, RouterContext } from './context.js';
@@ -8,7 +8,7 @@ import { Outlet } from './outlet.js';
  * Root provider for Buzola router.
  * Subscribes to router state and provides context to the React tree.
  */
-export function BuzolaProvider({ routes, children, ...props }) {
+export function BuzolaProvider({ routes, children, middleware: Middleware, ...props }) {
     const routerRef = useRef(props.router);
     if (!routerRef.current) {
         routerRef.current = new Router({
@@ -23,7 +23,7 @@ export function BuzolaProvider({ routes, children, ...props }) {
     const getSnapshot = useCallback(() => router.getState(), [router]);
     const state = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
     // Start navigation interception
-    useEffect(() => {
+    useLayoutEffect(() => {
         return router.start();
     }, [router]);
     const routeContextValue = useMemo(() => ({
@@ -32,6 +32,17 @@ export function BuzolaProvider({ routes, children, ...props }) {
         matches: state.matches,
         params: {},
     }), [state]);
-    return (_jsx(RouterContext, { value: router, children: _jsx(RouteContext, { value: routeContextValue, children: children ?? _jsx(Outlet, {}) }) }));
+    // Merge params from all matches for middleware
+    const allParams = useMemo(() => {
+        let merged = {};
+        for (const match of state.matches) {
+            merged = { ...merged, ...match.params };
+        }
+        return merged;
+    }, [state.matches]);
+    const content = children ?? _jsx(Outlet, {});
+    return (_jsx(RouterContext, { value: router, children: _jsx(RouteContext, { value: routeContextValue, children: Middleware
+                ? _jsx(Middleware, { params: allParams, matches: state.matches, children: content })
+                : content }) }));
 }
 //# sourceMappingURL=provider.js.map

package/dist/react/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,OAAO,EAAE,YAAY,EAA0B,aAAa,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAgBpC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAuB;IACjF,MAAM,SAAS,GAAG,MAAM,CAAqB,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1D,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACxB,SAAS,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC;YAC9B,MAAM,EAAE,MAAO;YACf,OAAO,EAAE,8BAA8B,EAAE;YACzC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,YAAY,EAAE,KAAK,CAAC,YAAY;SAChC,CAAC,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;IAChC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,EAAc,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;IAEvE,gCAAgC;IAChC,SAAS,CAAC,GAAG,EAAE;QACd,OAAO,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,MAAM,iBAAiB,GAAG,OAAO,CAAoB,GAAG,EAAE,CAAC,CAAC;QAC3D,KAAK;QACL,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,EAAE;KACV,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEZ,OAAO,CACN,KAAC,aAAa,IAAC,KAAK,EAAE,MAAM,YAC3B,KAAC,YAAY,IAAC,KAAK,EAAE,iBAAiB,YACpC,QAAQ,IAAI,KAAC,MAAM,KAAG,GACT,GACA,CAChB,CAAA;AACF,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAClG,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,OAAO,EAAE,YAAY,EAA0B,aAAa,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AA+BpC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,EAAuB;IACzG,MAAM,SAAS,GAAG,MAAM,CAAqB,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1D,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACxB,SAAS,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC;YAC9B,MAAM,EAAE,MAAO;YACf,OAAO,EAAE,8BAA8B,EAAE;YACzC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,YAAY,EAAE,KAAK,CAAC,YAAY;SAChC,CAAC,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAA;IAChC,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,EAAc,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;IAEvE,gCAAgC;IAChC,eAAe,CAAC,GAAG,EAAE;QACpB,OAAO,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,MAAM,iBAAiB,GAAG,OAAO,CAAoB,GAAG,EAAE,CAAC,CAAC;QAC3D,KAAK;QACL,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,EAAE;KACV,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEZ,+CAA+C;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,IAAI,MAAM,GAA2B,EAAE,CAAA;QACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAA;QACxC,CAAC;QACD,OAAO,MAAM,CAAA;IACd,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAEnB,MAAM,OAAO,GAAG,QAAQ,IAAI,KAAC,MAAM,KAAG,CAAA;IAEtC,OAAO,CACN,KAAC,aAAa,IAAC,KAAK,EAAE,MAAM,YAC3B,KAAC,YAAY,IAAC,KAAK,EAAE,iBAAiB,YACpC,UAAU;gBACV,CAAC,CAAC,KAAC,UAAU,IAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,YAAG,OAAO,GAAc;gBAC/E,CAAC,CAAC,OAAO,GACI,GACA,CAChB,CAAA;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@buzola/router",
-	"version": "0.0.3",
+	"version": "0.0.4",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -29,9 +29,12 @@
 		"react": "^18.0.0 || ^19.0.0"
 	},
 	"devDependencies": {
-		"react": "^19.0.0",
-		"@types/react": "^19.0.0",
+		"@testing-library/dom": "^10.4.1",
+		"@testing-library/react": "^16.3.2",
 		"@types/bun": "latest",
+		"@types/react": "^19.0.0",
+		"happy-dom": "^20.8.3",
+		"react": "^19.0.0",
 		"typescript": "^5.7.0"
 	}
 }

package/src/__tests__/create-page.test.ts

@@ -1,11 +1,11 @@
 import { describe, expect, it } from 'bun:test'
 import { createElement } from 'react'
-import { createPage } from '../define/create-page'
-import { createMemoryNavigationAdapter } from '../engine/navigation-adapter'
-import { buildRouteTree } from '../engine/route-tree'
-import { Router } from '../engine/router'
-import { s } from '../engine/schema'
-import type { RouteConfig, StandardSchema } from '../engine/types'
+import { BuzolaRedirect, createPage, redirect } from '../define/create-page.js'
+import { createMemoryNavigationAdapter } from '../engine/navigation-adapter.js'
+import { buildRouteTree } from '../engine/route-tree.js'
+import { Router } from '../engine/router.js'
+import { s } from '../engine/schema.js'
+import type { RouteConfig, StandardSchema } from '../engine/types.js'
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -586,3 +586,39 @@ describe('navigate with extra params (integration)', () => {
 		expect(state.location.searchParams.get('tab')).toBe('posts')
 	})
 })
+
+describe('redirect()', () => {
+	it('returns a BuzolaRedirect instance', () => {
+		const r = redirect('LoginPage' as any)
+		expect(r).toBeInstanceOf(BuzolaRedirect)
+		expect(r.pageId).toBe('LoginPage')
+	})
+
+	it('stores params on the redirect', () => {
+		const r = redirect('UserPage' as any, { userId: '123' } as any)
+		expect(r).toBeInstanceOf(BuzolaRedirect)
+		expect(r.pageId).toBe('UserPage')
+		expect(r.params).toEqual({ userId: '123' })
+	})
+
+	it('loader receives redirect in context', async () => {
+		let receivedRedirect: unknown
+		const page = createPage()
+			.loader(async ({ redirect: r }) => {
+				receivedRedirect = r
+				return {}
+			})
+			.render(() => null)
+
+		expect(typeof receivedRedirect).toBe('undefined') // not called yet — component not rendered
+		// Verify the type is correct by checking the function signature
+		expect(page.__buzolaPage).toBe(true)
+	})
+
+	it('redirect() result is recognized as BuzolaRedirect', () => {
+		const r = redirect('DashboardPage' as any)
+		expect(r instanceof BuzolaRedirect).toBe(true)
+		expect(r.__buzolaRedirect).toBe(true)
+		expect(r.pageId).toBe('DashboardPage')
+	})
+})

package/src/__tests__/loader-cache.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from 'bun:test'
+import { LoaderCache } from '../engine/loader-cache.js'
+
+describe('LoaderCache', () => {
+	it('stores and retrieves values', () => {
+		const cache = new LoaderCache(10)
+		cache.set('a', 1)
+		expect(cache.get('a')).toBe(1)
+	})
+
+	it('returns undefined for missing keys', () => {
+		const cache = new LoaderCache(10)
+		expect(cache.get('missing')).toBeUndefined()
+	})
+
+	it('has() returns true for existing keys', () => {
+		const cache = new LoaderCache(10)
+		cache.set('a', 1)
+		expect(cache.has('a')).toBe(true)
+		expect(cache.has('b')).toBe(false)
+	})
+
+	it('delete() removes entries', () => {
+		const cache = new LoaderCache(10)
+		cache.set('a', 1)
+		cache.delete('a')
+		expect(cache.has('a')).toBe(false)
+		expect(cache.size).toBe(0)
+	})
+
+	it('tracks size correctly', () => {
+		const cache = new LoaderCache(10)
+		expect(cache.size).toBe(0)
+		cache.set('a', 1)
+		cache.set('b', 2)
+		expect(cache.size).toBe(2)
+		cache.delete('a')
+		expect(cache.size).toBe(1)
+	})
+
+	it('clear() removes all entries', () => {
+		const cache = new LoaderCache(10)
+		cache.set('a', 1)
+		cache.set('b', 2)
+		cache.clear()
+		expect(cache.size).toBe(0)
+		expect(cache.has('a')).toBe(false)
+	})
+
+	// ─── LRU eviction ────────────────────────────────────────────────────────
+
+	it('evicts oldest entry when exceeding maxSize', () => {
+		const cache = new LoaderCache(2)
+		cache.set('a', 1)
+		cache.set('b', 2)
+		cache.set('c', 3)
+
+		expect(cache.has('a')).toBe(false)
+		expect(cache.get('b')).toBe(2)
+		expect(cache.get('c')).toBe(3)
+		expect(cache.size).toBe(2)
+	})
+
+	it('evicts multiple entries when needed', () => {
+		const cache = new LoaderCache(1)
+		cache.set('a', 1)
+		cache.set('b', 2)
+
+		expect(cache.has('a')).toBe(false)
+		expect(cache.get('b')).toBe(2)
+		expect(cache.size).toBe(1)
+	})
+
+	it('get() refreshes LRU order', () => {
+		const cache = new LoaderCache(2)
+		cache.set('a', 1)
+		cache.set('b', 2)
+
+		// Access 'a' to move it to most recent
+		cache.get('a')
+
+		// Now 'b' is the oldest, should be evicted
+		cache.set('c', 3)
+		expect(cache.has('b')).toBe(false)
+		expect(cache.get('a')).toBe(1)
+		expect(cache.get('c')).toBe(3)
+	})
+
+	it('set() on existing key updates value and refreshes LRU order', () => {
+		const cache = new LoaderCache(2)
+		cache.set('a', 1)
+		cache.set('b', 2)
+
+		// Update 'a' — should move to most recent
+		cache.set('a', 10)
+
+		// Now 'b' is the oldest
+		cache.set('c', 3)
+		expect(cache.has('b')).toBe(false)
+		expect(cache.get('a')).toBe(10)
+		expect(cache.get('c')).toBe(3)
+	})
+
+	it('maxSize of 0 keeps no entries', () => {
+		const cache = new LoaderCache(0)
+		cache.set('a', 1)
+		expect(cache.size).toBe(0)
+		expect(cache.has('a')).toBe(false)
+	})
+
+	it('exposes maxSize', () => {
+		const cache = new LoaderCache(5)
+		expect(cache.maxSize).toBe(5)
+	})
+})

package/src/__tests__/matcher.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'bun:test'
-import { matchRoutes } from '../engine/matcher'
-import { buildRouteTree } from '../engine/route-tree'
-import type { RouteConfig } from '../engine/types'
+import { matchRoutes } from '../engine/matcher.js'
+import { buildRouteTree } from '../engine/route-tree.js'
+import type { RouteConfig } from '../engine/types.js'
 
 function dummyComponent() {
 	return null