npm - @rangojs/router - Versions diffs - 0.0.0-experimental.002d056c - Mend

@rangojs/router 0.0.0-experimental.002d056c

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (305) hide show

package/AGENTS.md +9 -0
package/README.md +899 -0
package/dist/bin/rango.js +1606 -0
package/dist/vite/index.js +5153 -0
package/package.json +177 -0
package/skills/breadcrumbs/SKILL.md +250 -0
package/skills/cache-guide/SKILL.md +262 -0
package/skills/caching/SKILL.md +253 -0
package/skills/composability/SKILL.md +172 -0
package/skills/debug-manifest/SKILL.md +112 -0
package/skills/document-cache/SKILL.md +182 -0
package/skills/fonts/SKILL.md +167 -0
package/skills/hooks/SKILL.md +704 -0
package/skills/host-router/SKILL.md +218 -0
package/skills/intercept/SKILL.md +313 -0
package/skills/layout/SKILL.md +310 -0
package/skills/links/SKILL.md +239 -0
package/skills/loader/SKILL.md +596 -0
package/skills/middleware/SKILL.md +339 -0
package/skills/mime-routes/SKILL.md +128 -0
package/skills/parallel/SKILL.md +305 -0
package/skills/prerender/SKILL.md +643 -0
package/skills/rango/SKILL.md +118 -0
package/skills/response-routes/SKILL.md +411 -0
package/skills/route/SKILL.md +385 -0
package/skills/router-setup/SKILL.md +439 -0
package/skills/tailwind/SKILL.md +129 -0
package/skills/theme/SKILL.md +79 -0
package/skills/typesafety/SKILL.md +623 -0
package/skills/use-cache/SKILL.md +324 -0
package/src/__internal.ts +273 -0
package/src/bin/rango.ts +321 -0
package/src/browser/action-coordinator.ts +97 -0
package/src/browser/action-response-classifier.ts +99 -0
package/src/browser/event-controller.ts +899 -0
package/src/browser/history-state.ts +80 -0
package/src/browser/index.ts +18 -0
package/src/browser/intercept-utils.ts +52 -0
package/src/browser/link-interceptor.ts +141 -0
package/src/browser/logging.ts +55 -0
package/src/browser/merge-segment-loaders.ts +134 -0
package/src/browser/navigation-bridge.ts +638 -0
package/src/browser/navigation-client.ts +261 -0
package/src/browser/navigation-store.ts +806 -0
package/src/browser/navigation-transaction.ts +297 -0
package/src/browser/network-error-handler.ts +61 -0
package/src/browser/partial-update.ts +582 -0
package/src/browser/prefetch/cache.ts +206 -0
package/src/browser/prefetch/fetch.ts +145 -0
package/src/browser/prefetch/observer.ts +65 -0
package/src/browser/prefetch/policy.ts +48 -0
package/src/browser/prefetch/queue.ts +128 -0
package/src/browser/rango-state.ts +112 -0
package/src/browser/react/Link.tsx +368 -0
package/src/browser/react/NavigationProvider.tsx +413 -0
package/src/browser/react/ScrollRestoration.tsx +94 -0
package/src/browser/react/context.ts +59 -0
package/src/browser/react/filter-segment-order.ts +11 -0
package/src/browser/react/index.ts +52 -0
package/src/browser/react/location-state-shared.ts +162 -0
package/src/browser/react/location-state.ts +107 -0
package/src/browser/react/mount-context.ts +37 -0
package/src/browser/react/nonce-context.ts +23 -0
package/src/browser/react/shallow-equal.ts +27 -0
package/src/browser/react/use-action.ts +218 -0
package/src/browser/react/use-client-cache.ts +58 -0
package/src/browser/react/use-handle.ts +162 -0
package/src/browser/react/use-href.tsx +40 -0
package/src/browser/react/use-link-status.ts +135 -0
package/src/browser/react/use-mount.ts +31 -0
package/src/browser/react/use-navigation.ts +99 -0
package/src/browser/react/use-params.ts +65 -0
package/src/browser/react/use-pathname.ts +47 -0
package/src/browser/react/use-router.ts +63 -0
package/src/browser/react/use-search-params.ts +56 -0
package/src/browser/react/use-segments.ts +171 -0
package/src/browser/response-adapter.ts +73 -0
package/src/browser/rsc-router.tsx +464 -0
package/src/browser/scroll-restoration.ts +397 -0
package/src/browser/segment-reconciler.ts +216 -0
package/src/browser/segment-structure-assert.ts +83 -0
package/src/browser/server-action-bridge.ts +667 -0
package/src/browser/shallow.ts +40 -0
package/src/browser/types.ts +547 -0
package/src/browser/validate-redirect-origin.ts +29 -0
package/src/build/generate-manifest.ts +438 -0
package/src/build/generate-route-types.ts +36 -0
package/src/build/index.ts +35 -0
package/src/build/route-trie.ts +265 -0
package/src/build/route-types/ast-helpers.ts +25 -0
package/src/build/route-types/ast-route-extraction.ts +98 -0
package/src/build/route-types/codegen.ts +102 -0
package/src/build/route-types/include-resolution.ts +411 -0
package/src/build/route-types/param-extraction.ts +48 -0
package/src/build/route-types/per-module-writer.ts +128 -0
package/src/build/route-types/router-processing.ts +479 -0
package/src/build/route-types/scan-filter.ts +78 -0
package/src/build/runtime-discovery.ts +231 -0
package/src/cache/background-task.ts +34 -0
package/src/cache/cache-key-utils.ts +44 -0
package/src/cache/cache-policy.ts +125 -0
package/src/cache/cache-runtime.ts +338 -0
package/src/cache/cache-scope.ts +382 -0
package/src/cache/cf/cf-cache-store.ts +982 -0
package/src/cache/cf/index.ts +29 -0
package/src/cache/document-cache.ts +369 -0
package/src/cache/handle-capture.ts +81 -0
package/src/cache/handle-snapshot.ts +41 -0
package/src/cache/index.ts +44 -0
package/src/cache/memory-segment-store.ts +328 -0
package/src/cache/profile-registry.ts +73 -0
package/src/cache/read-through-swr.ts +134 -0
package/src/cache/segment-codec.ts +256 -0
package/src/cache/taint.ts +98 -0
package/src/cache/types.ts +342 -0
package/src/client.rsc.tsx +85 -0
package/src/client.tsx +601 -0
package/src/component-utils.ts +76 -0
package/src/components/DefaultDocument.tsx +27 -0
package/src/context-var.ts +86 -0
package/src/debug.ts +243 -0
package/src/default-error-boundary.tsx +88 -0
package/src/deps/browser.ts +8 -0
package/src/deps/html-stream-client.ts +2 -0
package/src/deps/html-stream-server.ts +2 -0
package/src/deps/rsc.ts +10 -0
package/src/deps/ssr.ts +2 -0
package/src/errors.ts +365 -0
package/src/handle.ts +135 -0
package/src/handles/MetaTags.tsx +246 -0
package/src/handles/breadcrumbs.ts +66 -0
package/src/handles/index.ts +7 -0
package/src/handles/meta.ts +264 -0
package/src/host/cookie-handler.ts +165 -0
package/src/host/errors.ts +97 -0
package/src/host/index.ts +53 -0
package/src/host/pattern-matcher.ts +214 -0
package/src/host/router.ts +352 -0
package/src/host/testing.ts +79 -0
package/src/host/types.ts +146 -0
package/src/host/utils.ts +25 -0
package/src/href-client.ts +222 -0
package/src/index.rsc.ts +233 -0
package/src/index.ts +277 -0
package/src/internal-debug.ts +11 -0
package/src/loader.rsc.ts +89 -0
package/src/loader.ts +64 -0
package/src/network-error-thrower.tsx +23 -0
package/src/outlet-context.ts +15 -0
package/src/outlet-provider.tsx +45 -0
package/src/prerender/param-hash.ts +37 -0
package/src/prerender/store.ts +185 -0
package/src/prerender.ts +463 -0
package/src/reverse.ts +330 -0
package/src/root-error-boundary.tsx +289 -0
package/src/route-content-wrapper.tsx +196 -0
package/src/route-definition/dsl-helpers.ts +934 -0
package/src/route-definition/helper-factories.ts +200 -0
package/src/route-definition/helpers-types.ts +430 -0
package/src/route-definition/index.ts +52 -0
package/src/route-definition/redirect.ts +93 -0
package/src/route-definition.ts +1 -0
package/src/route-map-builder.ts +281 -0
package/src/route-name.ts +53 -0
package/src/route-types.ts +259 -0
package/src/router/content-negotiation.ts +116 -0
package/src/router/debug-manifest.ts +72 -0
package/src/router/error-handling.ts +287 -0
package/src/router/find-match.ts +160 -0
package/src/router/handler-context.ts +451 -0
package/src/router/intercept-resolution.ts +397 -0
package/src/router/lazy-includes.ts +236 -0
package/src/router/loader-resolution.ts +420 -0
package/src/router/logging.ts +251 -0
package/src/router/manifest.ts +269 -0
package/src/router/match-api.ts +620 -0
package/src/router/match-context.ts +266 -0
package/src/router/match-handlers.ts +440 -0
package/src/router/match-middleware/background-revalidation.ts +223 -0
package/src/router/match-middleware/cache-lookup.ts +634 -0
package/src/router/match-middleware/cache-store.ts +295 -0
package/src/router/match-middleware/index.ts +81 -0
package/src/router/match-middleware/intercept-resolution.ts +306 -0
package/src/router/match-middleware/segment-resolution.ts +193 -0
package/src/router/match-pipelines.ts +179 -0
package/src/router/match-result.ts +219 -0
package/src/router/metrics.ts +282 -0
package/src/router/middleware-cookies.ts +55 -0
package/src/router/middleware-types.ts +222 -0
package/src/router/middleware.ts +749 -0
package/src/router/pattern-matching.ts +563 -0
package/src/router/prerender-match.ts +402 -0
package/src/router/preview-match.ts +170 -0
package/src/router/revalidation.ts +289 -0
package/src/router/router-context.ts +320 -0
package/src/router/router-interfaces.ts +452 -0
package/src/router/router-options.ts +592 -0
package/src/router/router-registry.ts +24 -0
package/src/router/segment-resolution/fresh.ts +570 -0
package/src/router/segment-resolution/helpers.ts +263 -0
package/src/router/segment-resolution/loader-cache.ts +198 -0
package/src/router/segment-resolution/revalidation.ts +1242 -0
package/src/router/segment-resolution/static-store.ts +67 -0
package/src/router/segment-resolution.ts +21 -0
package/src/router/segment-wrappers.ts +291 -0
package/src/router/telemetry-otel.ts +299 -0
package/src/router/telemetry.ts +300 -0
package/src/router/timeout.ts +148 -0
package/src/router/trie-matching.ts +239 -0
package/src/router/types.ts +170 -0
package/src/router.ts +1006 -0
package/src/rsc/handler-context.ts +45 -0
package/src/rsc/handler.ts +1089 -0
package/src/rsc/helpers.ts +198 -0
package/src/rsc/index.ts +36 -0
package/src/rsc/loader-fetch.ts +209 -0
package/src/rsc/manifest-init.ts +86 -0
package/src/rsc/nonce.ts +32 -0
package/src/rsc/origin-guard.ts +141 -0
package/src/rsc/progressive-enhancement.ts +379 -0
package/src/rsc/response-error.ts +37 -0
package/src/rsc/response-route-handler.ts +347 -0
package/src/rsc/rsc-rendering.ts +237 -0
package/src/rsc/runtime-warnings.ts +42 -0
package/src/rsc/server-action.ts +348 -0
package/src/rsc/ssr-setup.ts +128 -0
package/src/rsc/types.ts +263 -0
package/src/search-params.ts +230 -0
package/src/segment-system.tsx +454 -0
package/src/server/context.ts +591 -0
package/src/server/cookie-store.ts +190 -0
package/src/server/fetchable-loader-store.ts +37 -0
package/src/server/handle-store.ts +308 -0
package/src/server/loader-registry.ts +133 -0
package/src/server/request-context.ts +920 -0
package/src/server/root-layout.tsx +10 -0
package/src/server/tsconfig.json +14 -0
package/src/server.ts +51 -0
package/src/ssr/index.tsx +365 -0
package/src/static-handler.ts +114 -0
package/src/theme/ThemeProvider.tsx +297 -0
package/src/theme/ThemeScript.tsx +61 -0
package/src/theme/constants.ts +62 -0
package/src/theme/index.ts +48 -0
package/src/theme/theme-context.ts +44 -0
package/src/theme/theme-script.ts +155 -0
package/src/theme/types.ts +182 -0
package/src/theme/use-theme.ts +44 -0
package/src/types/boundaries.ts +158 -0
package/src/types/cache-types.ts +198 -0
package/src/types/error-types.ts +192 -0
package/src/types/global-namespace.ts +100 -0
package/src/types/handler-context.ts +687 -0
package/src/types/index.ts +88 -0
package/src/types/loader-types.ts +183 -0
package/src/types/route-config.ts +170 -0
package/src/types/route-entry.ts +109 -0
package/src/types/segments.ts +148 -0
package/src/types.ts +1 -0
package/src/urls/include-helper.ts +197 -0
package/src/urls/index.ts +53 -0
package/src/urls/path-helper-types.ts +339 -0
package/src/urls/path-helper.ts +329 -0
package/src/urls/pattern-types.ts +95 -0
package/src/urls/response-types.ts +106 -0
package/src/urls/type-extraction.ts +372 -0
package/src/urls/urls-function.ts +98 -0
package/src/urls.ts +1 -0
package/src/use-loader.tsx +354 -0
package/src/vite/discovery/bundle-postprocess.ts +184 -0
package/src/vite/discovery/discover-routers.ts +344 -0
package/src/vite/discovery/prerender-collection.ts +385 -0
package/src/vite/discovery/route-types-writer.ts +258 -0
package/src/vite/discovery/self-gen-tracking.ts +47 -0
package/src/vite/discovery/state.ts +108 -0
package/src/vite/discovery/virtual-module-codegen.ts +203 -0
package/src/vite/index.ts +16 -0
package/src/vite/plugin-types.ts +48 -0
package/src/vite/plugins/cjs-to-esm.ts +93 -0
package/src/vite/plugins/client-ref-dedup.ts +115 -0
package/src/vite/plugins/client-ref-hashing.ts +105 -0
package/src/vite/plugins/expose-action-id.ts +363 -0
package/src/vite/plugins/expose-id-utils.ts +287 -0
package/src/vite/plugins/expose-ids/export-analysis.ts +296 -0
package/src/vite/plugins/expose-ids/handler-transform.ts +179 -0
package/src/vite/plugins/expose-ids/loader-transform.ts +74 -0
package/src/vite/plugins/expose-ids/router-transform.ts +110 -0
package/src/vite/plugins/expose-ids/types.ts +45 -0
package/src/vite/plugins/expose-internal-ids.ts +569 -0
package/src/vite/plugins/refresh-cmd.ts +65 -0
package/src/vite/plugins/use-cache-transform.ts +323 -0
package/src/vite/plugins/version-injector.ts +83 -0
package/src/vite/plugins/version-plugin.ts +266 -0
package/src/vite/plugins/version.d.ts +12 -0
package/src/vite/plugins/virtual-entries.ts +123 -0
package/src/vite/plugins/virtual-stub-plugin.ts +29 -0
package/src/vite/rango.ts +445 -0
package/src/vite/router-discovery.ts +777 -0
package/src/vite/utils/ast-handler-extract.ts +517 -0
package/src/vite/utils/banner.ts +36 -0
package/src/vite/utils/bundle-analysis.ts +137 -0
package/src/vite/utils/manifest-utils.ts +70 -0
package/src/vite/utils/package-resolution.ts +121 -0
package/src/vite/utils/prerender-utils.ts +189 -0
package/src/vite/utils/shared-utils.ts +169 -0

package/src/component-utils.ts ADDED Viewed

@@ -0,0 +1,76 @@
+/**
+ * Component utilities for RSC
+ *
+ * Helpers for working with React Server Components and client components.
+ */
+import type { ComponentType } from "react";
+/**
+ * Symbol used by React to mark client component references.
+ * When a file has "use client" directive, the bundler transforms the exports
+ * to include this symbol on $$typeof.
+ */
+const CLIENT_REFERENCE = Symbol.for("react.client.reference");
+/**
+ * Check if a component is a client component (has "use client" directive).
+ *
+ * Client components are marked by the bundler with:
+ * - $$typeof: Symbol.for("react.client.reference")
+ * - $$id: string (module identifier)
+ *
+ * @param component - The component to check
+ * @returns true if the component has client reference marker
+ *
+ * @example
+ * ```typescript
+ * import { MyComponent } from "./my-component"; // has "use client"
+ *
+ * if (!isClientComponent(MyComponent)) {
+ *   throw new Error("MyComponent must be a client component");
+ * }
+ * ```
+ */
+export function isClientComponent(
+  component: ComponentType<unknown> | unknown,
+): boolean {
+  if (typeof component !== "function") {
+    return false;
+  }
+  const withMeta = component as { $$typeof?: symbol };
+  return withMeta.$$typeof === CLIENT_REFERENCE;
+}
+/**
+ * Assert that a component is a client component.
+ * Throws a descriptive error if not.
+ *
+ * @param component - The component to check
+ * @param name - Name to use in error message (e.g., "document")
+ * @throws Error if the component is not a client component
+ */
+export function assertClientComponent(
+  component: ComponentType<unknown> | unknown,
+  name: string,
+): asserts component is ComponentType<unknown> {
+  if (typeof component !== "function") {
+    throw new Error(
+      `${name} must be a client component function with "use client" directive. ` +
+        `Make sure to pass the component itself, not a JSX element: ` +
+        `${name}: My${capitalize(name)} (correct) vs ${name}: <My${capitalize(name)} /> (incorrect)`,
+    );
+  }
+  if (!isClientComponent(component)) {
+    throw new Error(
+      `${name} must be a client component with "use client" directive at the top of the file. ` +
+        `Server components cannot be used as the ${name} because their function reference ` +
+        `cannot be serialized in the RSC payload. Add "use client" to your ${name} file.`,
+    );
+  }
+}
+function capitalize(str: string): string {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/src/components/DefaultDocument.tsx ADDED Viewed

@@ -0,0 +1,27 @@
+"use client";
+import type { ReactNode, ReactElement } from "react";
+import { MetaTags } from "../handles/MetaTags.js";
+/**
+ * Default document component that provides a basic HTML structure.
+ * Used when no custom document is provided to createRouter.
+ * Includes MetaTags for automatic charset, viewport, and route meta support.
+ *
+ * Uses suppressHydrationWarning on <html> because the theme script
+ * may modify class/style attributes before React hydrates.
+ */
+export function DefaultDocument({
+  children,
+}: {
+  children: ReactNode;
+}): ReactElement {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <MetaTags />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}

package/src/context-var.ts ADDED Viewed

@@ -0,0 +1,86 @@
+/**
+ * Typed context variables for ctx.set() / ctx.get().
+ *
+ * createVar<T>() produces a typed token that handlers set and layouts/middleware
+ * read. The token carries a unique Symbol used as the property key on the
+ * per-request variables object — no build-time processing, no IDs.
+ *
+ * @example
+ * ```ts
+ * import { createVar } from "@rangojs/router";
+ *
+ * interface PaginationData { current: number; total: number }
+ * export const Pagination = createVar<PaginationData>();
+ *
+ * // handler
+ * ctx.set(Pagination, { current: 1, total: 4 });
+ *
+ * // layout
+ * const pg = ctx.get(Pagination); // PaginationData | undefined
+ * ```
+ */
+export interface ContextVar<T> {
+  readonly __brand: "context-var";
+  readonly key: symbol;
+  /** Phantom field to carry the type parameter. Never set at runtime. */
+  readonly __type?: T;
+}
+/**
+ * Create a typed context variable token.
+ *
+ * The returned object is used with ctx.set(token, value) and ctx.get(token)
+ * for compile-time-checked data flow between handlers, layouts, and middleware.
+ */
+export function createVar<T>(): ContextVar<T> {
+  return { __brand: "context-var" as const, key: Symbol() };
+}
+/**
+ * Type guard: is the value a ContextVar token?
+ */
+export function isContextVar(value: unknown): value is ContextVar<unknown> {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    "__brand" in value &&
+    (value as { __brand: unknown }).__brand === "context-var"
+  );
+}
+/**
+ * Read a variable from the variables store.
+ * Accepts either a string key (legacy) or a ContextVar token (typed).
+ */
+export function contextGet(
+  variables: any,
+  keyOrVar: string | ContextVar<any>,
+): any {
+  if (typeof keyOrVar === "string") return variables[keyOrVar];
+  return variables[keyOrVar.key];
+}
+/** Keys that must never be used as string variable names */
+const FORBIDDEN_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+/**
+ * Write a variable to the variables store.
+ * Accepts either a string key (legacy) or a ContextVar token (typed).
+ */
+export function contextSet(
+  variables: any,
+  keyOrVar: string | ContextVar<any>,
+  value: any,
+): void {
+  if (typeof keyOrVar === "string") {
+    if (FORBIDDEN_KEYS.has(keyOrVar)) {
+      throw new Error(
+        `ctx.set(): "${keyOrVar}" is a reserved key and cannot be used as a variable name.`,
+      );
+    }
+    variables[keyOrVar] = value;
+  } else {
+    variables[keyOrVar.key] = value;
+  }
+}

package/src/debug.ts ADDED Viewed

@@ -0,0 +1,243 @@
+/**
+ * Debug utilities for manifest inspection and comparison
+ */
+import type { EntryData } from "./server/context";
+/**
+ * Serialized entry for debug output
+ */
+export interface SerializedEntry {
+  id: string;
+  shortCode: string;
+  type: string;
+  parentShortCode: string | null;
+  pattern?: string;
+  hasLoader: boolean;
+  hasMiddleware: boolean;
+  hasErrorBoundary: boolean;
+  parallelCount: number;
+  interceptCount: number;
+}
+/**
+ * Serialized manifest structure
+ */
+export interface SerializedManifest {
+  routes: Record<string, SerializedEntry>;
+  layouts: Record<string, SerializedEntry>;
+  totalRoutes: number;
+  totalLayouts: number;
+}
+/**
+ * Serialize a manifest Map into a JSON-friendly structure
+ */
+export function serializeManifest(
+  manifest: Map<string, EntryData>,
+): SerializedManifest {
+  const routes: Record<string, SerializedEntry> = {};
+  const layouts: Record<string, SerializedEntry> = {};
+  // Collect all entries including parents
+  const allEntries = new Map<string, EntryData>();
+  for (const [key, entry] of manifest.entries()) {
+    allEntries.set(key, entry);
+    // Walk up parent chain to collect all layouts
+    let parent = entry.parent;
+    while (parent) {
+      if (!allEntries.has(parent.id)) {
+        allEntries.set(parent.id, parent);
+      }
+      parent = parent.parent;
+    }
+  }
+  for (const [key, entry] of allEntries.entries()) {
+    const serialized: SerializedEntry = {
+      id: entry.id,
+      shortCode: entry.shortCode,
+      type: entry.type,
+      parentShortCode: entry.parent?.shortCode ?? null,
+      hasLoader: entry.loader?.length > 0,
+      hasMiddleware: entry.middleware?.length > 0,
+      hasErrorBoundary: entry.errorBoundary?.length > 0,
+      parallelCount: entry.parallel?.length ?? 0,
+      interceptCount: entry.intercept?.length ?? 0,
+    };
+    if (entry.type === "route" && "pattern" in entry) {
+      serialized.pattern = entry.pattern;
+    }
+    if (entry.type === "route") {
+      routes[key] = serialized;
+    } else if (entry.type === "layout" || entry.type === "cache") {
+      layouts[key] = serialized;
+    }
+  }
+  return {
+    routes,
+    layouts,
+    totalRoutes: Object.keys(routes).length,
+    totalLayouts: Object.keys(layouts).length,
+  };
+}
+/**
+ * Compare two manifests and return differences
+ */
+export function compareManifests(
+  oldManifest: SerializedManifest,
+  newManifest: SerializedManifest,
+): {
+  addedRoutes: string[];
+  removedRoutes: string[];
+  changedRoutes: Array<{
+    key: string;
+    field: string;
+    old: any;
+    new: any;
+  }>;
+  addedLayouts: string[];
+  removedLayouts: string[];
+  changedLayouts: Array<{
+    key: string;
+    field: string;
+    old: any;
+    new: any;
+  }>;
+} {
+  const addedRoutes: string[] = [];
+  const removedRoutes: string[] = [];
+  const changedRoutes: Array<{
+    key: string;
+    field: string;
+    old: any;
+    new: any;
+  }> = [];
+  const addedLayouts: string[] = [];
+  const removedLayouts: string[] = [];
+  const changedLayouts: Array<{
+    key: string;
+    field: string;
+    old: any;
+    new: any;
+  }> = [];
+  // Compare routes
+  const oldRouteKeys = new Set(Object.keys(oldManifest.routes));
+  const newRouteKeys = new Set(Object.keys(newManifest.routes));
+  for (const key of newRouteKeys) {
+    if (!oldRouteKeys.has(key)) {
+      addedRoutes.push(key);
+    }
+  }
+  for (const key of oldRouteKeys) {
+    if (!newRouteKeys.has(key)) {
+      removedRoutes.push(key);
+    } else {
+      // Compare fields
+      const oldEntry = oldManifest.routes[key];
+      const newEntry = newManifest.routes[key];
+      for (const field of Object.keys(oldEntry) as (keyof SerializedEntry)[]) {
+        if (oldEntry[field] !== newEntry[field]) {
+          changedRoutes.push({
+            key,
+            field,
+            old: oldEntry[field],
+            new: newEntry[field],
+          });
+        }
+      }
+    }
+  }
+  // Compare layouts
+  const oldLayoutKeys = new Set(Object.keys(oldManifest.layouts));
+  const newLayoutKeys = new Set(Object.keys(newManifest.layouts));
+  for (const key of newLayoutKeys) {
+    if (!oldLayoutKeys.has(key)) {
+      addedLayouts.push(key);
+    }
+  }
+  for (const key of oldLayoutKeys) {
+    if (!newLayoutKeys.has(key)) {
+      removedLayouts.push(key);
+    } else {
+      const oldEntry = oldManifest.layouts[key];
+      const newEntry = newManifest.layouts[key];
+      for (const field of Object.keys(oldEntry) as (keyof SerializedEntry)[]) {
+        if (oldEntry[field] !== newEntry[field]) {
+          changedLayouts.push({
+            key,
+            field,
+            old: oldEntry[field],
+            new: newEntry[field],
+          });
+        }
+      }
+    }
+  }
+  return {
+    addedRoutes,
+    removedRoutes,
+    changedRoutes,
+    addedLayouts,
+    removedLayouts,
+    changedLayouts,
+  };
+}
+/**
+ * Format manifest diff as a human-readable string
+ */
+export function formatManifestDiff(
+  diff: ReturnType<typeof compareManifests>,
+): string {
+  const lines: string[] = [];
+  if (diff.addedRoutes.length > 0) {
+    lines.push("Added routes:");
+    diff.addedRoutes.forEach((r) => lines.push(`  + ${r}`));
+  }
+  if (diff.removedRoutes.length > 0) {
+    lines.push("Removed routes:");
+    diff.removedRoutes.forEach((r) => lines.push(`  - ${r}`));
+  }
+  if (diff.changedRoutes.length > 0) {
+    lines.push("Changed routes:");
+    diff.changedRoutes.forEach((c) =>
+      lines.push(`  ~ ${c.key}.${c.field}: ${c.old} -> ${c.new}`),
+    );
+  }
+  if (diff.addedLayouts.length > 0) {
+    lines.push("Added layouts:");
+    diff.addedLayouts.forEach((l) => lines.push(`  + ${l}`));
+  }
+  if (diff.removedLayouts.length > 0) {
+    lines.push("Removed layouts:");
+    diff.removedLayouts.forEach((l) => lines.push(`  - ${l}`));
+  }
+  if (diff.changedLayouts.length > 0) {
+    lines.push("Changed layouts:");
+    diff.changedLayouts.forEach((c) =>
+      lines.push(`  ~ ${c.key}.${c.field}: ${c.old} -> ${c.new}`),
+    );
+  }
+  return lines.length > 0 ? lines.join("\n") : "No differences found";
+}

package/src/default-error-boundary.tsx ADDED Viewed

@@ -0,0 +1,88 @@
+import type { ReactNode } from "react";
+import type { ErrorBoundaryFallbackProps } from "./types.js";
+/**
+ * Default error boundary fallback component
+ *
+ * This is rendered when an error occurs and no custom error boundary
+ * is defined in the route tree. Shows a simple "Internal Server Error"
+ * message with the error details in development.
+ */
+export function DefaultErrorFallback({
+  error,
+}: ErrorBoundaryFallbackProps): ReactNode {
+  const isDev = process.env.NODE_ENV !== "production";
+  return (
+    <div
+      style={{
+        fontFamily: "system-ui, -apple-system, sans-serif",
+        padding: "2rem",
+        maxWidth: "600px",
+        margin: "2rem auto",
+      }}
+    >
+      <h1
+        style={{
+          color: "#dc2626",
+          fontSize: "1.5rem",
+          marginBottom: "1rem",
+        }}
+      >
+        Internal Server Error
+      </h1>
+      <p
+        style={{
+          color: "#374151",
+          marginBottom: "1rem",
+        }}
+      >
+        An unexpected error occurred while processing your request.
+      </p>
+      {isDev && (
+        <div
+          style={{
+            background: "#fef2f2",
+            border: "1px solid #fecaca",
+            borderRadius: "0.5rem",
+            padding: "1rem",
+            marginBottom: "1rem",
+          }}
+        >
+          <p
+            style={{
+              fontWeight: 600,
+              color: "#991b1b",
+              marginBottom: "0.5rem",
+            }}
+          >
+            {error.name}: {error.message}
+          </p>
+          {error.stack && (
+            <pre
+              style={{
+                fontSize: "0.75rem",
+                color: "#6b7280",
+                overflow: "auto",
+                whiteSpace: "pre-wrap",
+                wordBreak: "break-word",
+              }}
+            >
+              {error.stack}
+            </pre>
+          )}
+        </div>
+      )}
+      <a
+        href="/"
+        style={{
+          display: "inline-block",
+          color: "#2563eb",
+          textDecoration: "underline",
+        }}
+      >
+        Go to homepage
+      </a>
+    </div>
+  );
+}

package/src/deps/browser.ts ADDED Viewed

@@ -0,0 +1,8 @@
+// Re-export @vitejs/plugin-rsc/browser for internal use by virtual entries
+export {
+  createFromReadableStream,
+  createFromFetch,
+  setServerCallback,
+  encodeReply,
+  createTemporaryReferenceSet,
+} from "@vitejs/plugin-rsc/browser";

package/src/deps/html-stream-client.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // Re-export rsc-html-stream/client for internal use by virtual entries
2	+ export { rscStream } from "rsc-html-stream/client";

package/src/deps/html-stream-server.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // Re-export rsc-html-stream/server for internal use by virtual entries
2	+ export { injectRSCPayload } from "rsc-html-stream/server";

package/src/deps/rsc.ts ADDED Viewed

@@ -0,0 +1,10 @@
+/// <reference types="@vitejs/plugin-rsc/types" />
+// Re-export @vitejs/plugin-rsc/rsc for internal use by virtual entries
+export {
+  renderToReadableStream,
+  decodeReply,
+  createTemporaryReferenceSet,
+  loadServerAction,
+  decodeAction,
+  decodeFormState,
+} from "@vitejs/plugin-rsc/rsc";

package/src/deps/ssr.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ // Re-export @vitejs/plugin-rsc/ssr for internal use by virtual entries
2	+ export { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";