@rangojs/router 0.26.1 → 0.26.2

package/dist/bin/rango.js

@@ -1644,7 +1644,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@rangojs/router",
-      version: "0.26.1",
+      version: "0.26.2",
       description: "Django-inspired RSC router with composable URL patterns",
       keywords: [
         "react",

package/dist/types/router/loader-resolution.d.ts

@@ -42,13 +42,16 @@ export type LoaderErrorCallback = (error: unknown, context: {
  *   This has a simplified signature for internal use - the caller (typically
  *   wrapLoaderPromise in router.ts) is responsible for bridging to the full
  *   OnErrorCallback with complete request context (request, url, env, etc.).
+ * @param useDefaultErrorBoundary - An `ssr: false` loader on a document or
+ *   capture render: an error with no declared boundary gets
+ *   `DefaultErrorFallback` and a 500 (it would otherwise reject the tree).
  */
 export declare function wrapLoaderWithErrorHandling<T>(promise: Promise<T>, entry: EntryData, segmentId: string, pathname: string, findNearestErrorBoundary: (entry: EntryData | null) => ReactNode | ErrorBoundaryHandler | null, createErrorInfo: (error: unknown, segmentId: string, segmentType: ErrorInfo["segmentType"]) => ErrorInfo, onError?: LoaderErrorCallback, notFoundDeps?: {
     findNearestNotFoundBoundary: (entry: EntryData | null) => ReactNode | NotFoundBoundaryHandler | null;
     notFoundComponent?: ReactNode | ((props: {
         pathname: string;
     }) => ReactNode);
-}): Promise<LoaderDataResult<T>>;
+}, useDefaultErrorBoundary?: boolean): Promise<LoaderDataResult<T>>;
 /**
  * Set up the use() method on handler context to access loaders and handles.
  *

package/dist/types/router/types.d.ts

@@ -25,7 +25,9 @@ export interface SegmentResolutionDeps<TEnv = any> {
         env?: TEnv;
         isPartial?: boolean;
         requestStartTime?: number;
-    }) => Promise<LoaderDataResult<T>>;
+    }, 
+    /** An `ssr: false` loader on a document or capture render. */
+    useDefaultErrorBoundary?: boolean) => Promise<LoaderDataResult<T>>;
     trackHandler: <T>(promise: Promise<T>, errorContext?: {
         segmentId?: string;
         segmentType?: string;

package/dist/vite/index.js

@@ -7077,7 +7077,7 @@ function resolveVersionsFrom(table, routerId2) {
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.26.1",
+  version: "0.26.2",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rangojs/router",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "description": "Django-inspired RSC router with composable URL patterns",
   "keywords": [
     "react",

package/skills/loader/SKILL.md

@@ -995,6 +995,15 @@ runs, so a `useLoader` in a layout above every Suspense boundary is safe. On a
 during the shell capture refuses the capture (warned once per key): that URL
 gets no shell, and its renders deliver the signal as above.
 
+A flagged loader that throws (anything but `notFound()` or `redirect()`) is
+resolved the same way: its route's `errorBoundary()` renders at the owning
+segment, else `createRouter({ defaultErrorBoundary })`, else the router's
+default error boundary (the "Internal Server Error" page) with a 500, as a
+handler that throws does; a declared `errorBoundary()` or
+`defaultErrorBoundary` answers 200 here. Layouts above it stay. On a `ppr` shell HIT whose
+run throws, the baked content shows first and the boundary replaces it at
+hydration, after React reports a hydration mismatch.
+
 Session/auth gates belong in middleware (they are request-shaped, not
 data-shaped, and middleware CAN emit a real pre-stream 302). Data-dependent
 "this slug moved / does not exist" belongs in the loader.

package/skills/ppr/SKILL.md

@@ -926,9 +926,10 @@ by a navigation alone carries no pins, and its replay runs these loaders fresh.
   fill the holes — and the recorded baked paths are overlaid onto the fresh
   result, so the payload matches the prelude while the nested promises stream
   fresh. A fresh rejection skips the overlay and goes to the loader's error
-  boundary: on a document HIT the payload then carries the error where the
-  HTML has the baked value, and React renders that part again on the client
-  (one hydration mismatch, the one known residual of a HIT). Give it its own cache,
+  boundary (the route's `errorBoundary()`, else the router's default one): on
+  a document HIT the payload then carries the error where the HTML has the
+  baked value, and React renders that part again on the client (one
+  hydration mismatch, the one known residual of a HIT). Give it its own cache,
   `loader(Def, { ssr: false }, () => [cache({ ttl })])`, so that run reads
   through the loader cache.
 

package/skills/router-setup/SKILL.md

@@ -130,7 +130,7 @@ interface RangoOptions<TEnv> {
   id?: string; // Router id; namespaces build output and route maps. Auto-generated.
 
   // --- Fallbacks and errors ---
-  defaultErrorBoundary?: ReactNode | ErrorBoundaryHandler; // When no errorBoundary() matches
+  defaultErrorBoundary?: ReactNode | ErrorBoundaryHandler; // When no errorBoundary() matches; unset: the built-in "Internal Server Error" page
   defaultNotFoundBoundary?: ReactNode | NotFoundBoundaryHandler; // When no notFoundBoundary() matches
   notFound?: ReactNode | ((props: { pathname: string }) => ReactNode); // 404 page
   onError?: OnErrorCallback<TEnv>; // Logging/reporting hook; cannot change the response

package/src/router/loader-resolution.ts

@@ -55,6 +55,7 @@ import {
 } from "../server/handle-store.js";
 import { getFetchableLoader } from "../server/fetchable-loader-store.js";
 import { _getRequestContext } from "../server/request-context.js";
+import { DefaultErrorFallback } from "../default-error-boundary.js";
 import { defineRewrittenFrom } from "../server/rewrite-trail.js";
 import {
   firstUnitCandidate,
@@ -154,6 +155,9 @@ function pushHandleValue(
  *   This has a simplified signature for internal use - the caller (typically
  *   wrapLoaderPromise in router.ts) is responsible for bridging to the full
  *   OnErrorCallback with complete request context (request, url, env, etc.).
+ * @param useDefaultErrorBoundary - An `ssr: false` loader on a document or
+ *   capture render: an error with no declared boundary gets
+ *   `DefaultErrorFallback` and a 500 (it would otherwise reject the tree).
  */
 export function wrapLoaderWithErrorHandling<T>(
   promise: Promise<T>,
@@ -177,13 +181,15 @@ export function wrapLoaderWithErrorHandling<T>(
       | ReactNode
       | ((props: { pathname: string }) => ReactNode);
   },
+  useDefaultErrorBoundary?: boolean,
 ): Promise<LoaderDataResult<T>> {
   // Extract the trailing token from segmentId (format: "<shortCode>D<i>.<loaderId>").
   // The token is the loader's $$id (hash#export in prod, pathfrag#export in dev),
   // not a clean display name.
   const loaderName = segmentId.split(".").pop() || "unknown";
   // Captured now: the rejection can settle outside the request's ALS frame.
-  const renderErrors = _getRequestContext()?._renderErrors;
+  const requestContext = _getRequestContext();
+  const renderErrors = requestContext?._renderErrors;
 
   return Promise.resolve(promise)
     .then(
@@ -286,7 +292,9 @@ export function wrapLoaderWithErrorHandling<T>(
       renderErrors?.push(error);
 
       // Find nearest error boundary
-      const fallback = findNearestErrorBoundary(entry);
+      const declared = findNearestErrorBoundary(entry);
+      const fallback =
+        declared ?? (useDefaultErrorBoundary ? DefaultErrorFallback : null);
 
       // Create error info
       const errorInfo = createErrorInfo(error, segmentId, "loader");
@@ -341,6 +349,8 @@ export function wrapLoaderWithErrorHandling<T>(
         segmentId,
         message: errorInfo.message,
       });
+      // The default boundary answers 500, as in catchSegmentError.
+      if (!declared) requestContext?._setStatus(500);
 
       return {
         __loaderResult: true,

package/src/router/segment-resolution/fresh.ts

@@ -184,6 +184,7 @@ export async function resolveLoaders<TEnv>(
           segmentId,
           ctx.pathname,
           errorContext,
+          loaderEntry.awaitBeforeFlush,
         ),
         belongsToRoute,
       };
@@ -235,6 +236,7 @@ export async function resolveLoaders<TEnv>(
       segmentId,
       ctx.pathname,
       errorContext,
+      loaderEntry.awaitBeforeFlush,
     );
     return { wrapped, segmentId };
   });

package/src/router/types.ts

@@ -49,6 +49,8 @@ export interface SegmentResolutionDeps<TEnv = any> {
       isPartial?: boolean;
       requestStartTime?: number;
     },
+    /** An `ssr: false` loader on a document or capture render. */
+    useDefaultErrorBoundary?: boolean,
   ) => Promise<LoaderDataResult<T>>;
   trackHandler: <T>(
     promise: Promise<T>,

package/src/router.ts

@@ -531,6 +531,7 @@ export function createRouter<TEnv = any>(
       isPartial?: boolean;
       requestStartTime?: number;
     },
+    useDefaultErrorBoundary?: boolean,
   ): Promise<LoaderDataResult<T>> {
     const loaderStart = telemetrySink ? performance.now() : 0;
     const loaderRequestId = telemetrySink
@@ -600,6 +601,7 @@ export function createRouter<TEnv = any>(
         findNearestNotFoundBoundary,
         notFoundComponent: notFound,
       },
+      useDefaultErrorBoundary,
     );
 
     // Emit loader.end after the promise settles (fire-and-forget)