@alepha/react 0.14.2 → 0.14.4

package/src/router/constants/PAGE_PRELOAD_KEY.ts

@@ -0,0 +1,6 @@
+/**
+ * Symbol key for SSR module preloading path.
+ * Using Symbol.for() allows the Vite plugin to inject this at build time.
+ * @internal
+ */
+export const PAGE_PRELOAD_KEY = Symbol.for("alepha.page.preload");

package/src/router/errors/Redirection.ts

@@ -10,7 +10,7 @@ import { AlephaError } from "alepha";
  * import { Redirection } from "@alepha/react";
  *
  * const MyPage = $page({
- *   resolve: async () => {
+ *   loader: async () => {
  *    if (needRedirect) {
  *      throw new Redirection("/new-path");
  *    }

package/src/router/index.shared.ts

@@ -6,6 +6,7 @@ export { default as NestedView } from "./components/NestedView.tsx";
 export type *  from "./components/NestedView.tsx";
 export { default as NotFound } from "./components/NotFound.tsx";
 export type * from "./components/NotFound.tsx";
+export * from "./constants/PAGE_PRELOAD_KEY.ts";
 export * from "./contexts/RouterLayerContext.ts";
 export * from "./primitives/$page.ts";
 export * from "./errors/Redirection.ts";

package/src/router/index.ts

@@ -7,6 +7,8 @@ import { AlephaServer, type ServerRequest } from "alepha/server";
 import type { ReactNode } from "react";
 import type { ReactHydrationState } from "./providers/ReactBrowserProvider.ts";
 import { ReactServerProvider } from "./providers/ReactServerProvider.ts";
+import { ReactServerTemplateProvider } from "./providers/ReactServerTemplateProvider.ts";
+import { SSRManifestProvider } from "./providers/SSRManifestProvider.ts";
 import { ReactPageServerService } from "./services/ReactPageServerService.ts";
 import { AlephaServerCache } from "alepha/server/cache";
 import { AlephaServerLinks } from "alepha/server/links";
@@ -19,6 +21,8 @@ export * from "./index.shared.ts";
 export * from "./providers/ReactPageProvider.ts";
 export * from "./providers/ReactBrowserProvider.ts";
 export * from "./providers/ReactServerProvider.ts";
+export * from "./providers/ReactServerTemplateProvider.ts";
+export * from "./providers/SSRManifestProvider.ts";
 
 // ---------------------------------------------------------------------------------------------------------------------
 
@@ -46,6 +50,9 @@ declare module "alepha" {
     // -----------------------------------------------------------------------------------------------------------------
     /**
      * Fires when the React application is being rendered on the browser.
+     *
+     * Note: this one is not really necessary, it's a hack because we need to isolate renderer from server code in order
+     * to avoid including react-dom/client in server bundles.
      */
     "react:browser:render": {
       root: HTMLElement;
@@ -94,7 +101,7 @@ declare module "alepha" {
  * - URL pattern matching with parameters (e.g., `/users/:id`)
  * - Nested routing with parent-child relationships
  * - Type-safe URL parameter and query string validation
- * - Server-side data fetching with the `resolve` function
+ * - Server-side data fetching with the `loader` function
  * - Lazy loading and code splitting
  * - Page animations and error handling
  *
@@ -107,7 +114,12 @@ export const AlephaReactRouter = $module({
   services: [
     ReactPageProvider,
     ReactPageService,
-    ReactRouter, ReactServerProvider, ReactPageServerService],
+    ReactRouter,
+    ReactServerProvider,
+    ReactServerTemplateProvider,
+    SSRManifestProvider,
+    ReactPageServerService,
+  ],
   register: (alepha) =>
     alepha
       .with(AlephaReact)
@@ -119,6 +131,8 @@ export const AlephaReactRouter = $module({
         provide: ReactPageService,
         use: ReactPageServerService,
       })
+      .with(SSRManifestProvider)
+      .with(ReactServerTemplateProvider)
       .with(ReactServerProvider)
       .with(ReactPageProvider)
       .with(ReactRouter),