@nestjs-ssr/react 0.3.4 → 0.3.5

package/dist/client.d.mts

@@ -1,7 +1,7 @@
-export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CGT9woWe.mjs';
+export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CVC9DHcL.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { R as RenderContext } from './render-response.interface-CxbuKGnV.mjs';
+export { R as RenderContext } from './render-response.interface-ClWJXKL4.mjs';
 
 /**
  * Provider component for navigation state.

package/dist/client.d.ts

@@ -1,7 +1,7 @@
-export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-05ODF4zW.js';
+export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-DChgHhL9.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { R as RenderContext } from './render-response.interface-CxbuKGnV.js';
+export { R as RenderContext } from './render-response.interface-ClWJXKL4.js';
 
 /**
  * Provider component for navigation state.

package/dist/client.js

@@ -28,11 +28,31 @@ function updatePageContext(context) {
   setPageContextState?.(context);
 }
 __name(updatePageContext, "updatePageContext");
+var segmentSetters = /* @__PURE__ */ new Set();
+function registerSegmentSetter(setter) {
+  segmentSetters.add(setter);
+}
+__name(registerSegmentSetter, "registerSegmentSetter");
+function unregisterSegmentSetter(setter) {
+  segmentSetters.delete(setter);
+}
+__name(unregisterSegmentSetter, "unregisterSegmentSetter");
+function broadcastToSegments(context) {
+  segmentSetters.forEach((setter) => setter(context));
+}
+__name(broadcastToSegments, "broadcastToSegments");
 function PageContextProvider({ context: initialContext, children, isSegment = false }) {
   const [context, setContext] = React2.useState(initialContext);
   React2.useEffect(() => {
     if (!isSegment) {
-      registerPageContextState(setContext);
+      registerPageContextState((newContext) => {
+        setContext(newContext);
+        broadcastToSegments(newContext);
+      });
+      return void 0;
+    } else {
+      registerSegmentSetter(setContext);
+      return () => unregisterSegmentSetter(setContext);
     }
   }, [
     isSegment
@@ -239,7 +259,7 @@ var useHeader = defaultHooks.useHeader;
 var useCookies = defaultHooks.useCookies;
 var useCookie = defaultHooks.useCookie;
 var rootRegistry = /* @__PURE__ */ new WeakMap();
-function hydrateSegment(outlet, componentName, props) {
+function hydrateSegment(outlet, componentName, props, layouts) {
   const modules = window.__MODULES__;
   if (!modules) {
     console.warn("[navigation] Module registry not available for segment hydration. Make sure entry-client.tsx exports window.__MODULES__.");
@@ -254,10 +274,11 @@ function hydrateSegment(outlet, componentName, props) {
     return;
   }
   const context = window.__CONTEXT__ || {};
+  const composedElement = composeWithLayouts(ViewComponent, props, layouts || [], context, modules);
   const element = /* @__PURE__ */ React2__default.default.createElement(PageContextProvider, {
     context,
     isSegment: true
-  }, /* @__PURE__ */ React2__default.default.createElement(ViewComponent, props));
+  }, composedElement);
   let wrapper = outlet.querySelector("[data-segment-root]");
   if (wrapper) {
     const existingRoot = rootRegistry.get(wrapper);
@@ -275,6 +296,27 @@ function hydrateSegment(outlet, componentName, props) {
   rootRegistry.set(wrapper, root);
 }
 __name(hydrateSegment, "hydrateSegment");
+function composeWithLayouts(ViewComponent, props, layouts, context, modules) {
+  let result = /* @__PURE__ */ React2__default.default.createElement(ViewComponent, props);
+  for (let i = layouts.length - 1; i >= 0; i--) {
+    const { name: layoutName, props: layoutProps } = layouts[i];
+    const Layout = resolveComponent(layoutName, modules);
+    if (!Layout) {
+      console.warn(`[navigation] Layout "${layoutName}" not found for hydration`);
+      continue;
+    }
+    result = /* @__PURE__ */ React2__default.default.createElement("div", {
+      "data-layout": layoutName
+    }, /* @__PURE__ */ React2__default.default.createElement(Layout, {
+      context,
+      layoutProps
+    }, /* @__PURE__ */ React2__default.default.createElement("div", {
+      "data-outlet": layoutName
+    }, result)));
+  }
+  return result;
+}
+__name(composeWithLayouts, "composeWithLayouts");
 function resolveComponent(name, modules) {
   const componentMap = Object.entries(modules).filter(([path, module]) => {
     const filename = path.split("/").pop();
@@ -342,8 +384,12 @@ async function navigate(url, options = {}) {
       return;
     }
     const outlet = await swapContent(response.html, response.swapTarget);
+    if (response.context) {
+      updatePageContext(response.context);
+      window.__CONTEXT__ = response.context;
+    }
     if (outlet) {
-      hydrateSegment(outlet, response.componentName, response.props);
+      hydrateSegment(outlet, response.componentName, response.props, response.layouts);
     }
     if (replace) {
       history.replaceState({
@@ -354,10 +400,6 @@ async function navigate(url, options = {}) {
         url
       }, "", url);
     }
-    if (response.context) {
-      updatePageContext(response.context);
-      window.__CONTEXT__ = response.context;
-    }
     if (response.head) {
       updateHead(response.head);
     }

package/dist/client.mjs

@@ -22,11 +22,31 @@ function updatePageContext(context) {
   setPageContextState?.(context);
 }
 __name(updatePageContext, "updatePageContext");
+var segmentSetters = /* @__PURE__ */ new Set();
+function registerSegmentSetter(setter) {
+  segmentSetters.add(setter);
+}
+__name(registerSegmentSetter, "registerSegmentSetter");
+function unregisterSegmentSetter(setter) {
+  segmentSetters.delete(setter);
+}
+__name(unregisterSegmentSetter, "unregisterSegmentSetter");
+function broadcastToSegments(context) {
+  segmentSetters.forEach((setter) => setter(context));
+}
+__name(broadcastToSegments, "broadcastToSegments");
 function PageContextProvider({ context: initialContext, children, isSegment = false }) {
   const [context, setContext] = useState(initialContext);
   useEffect(() => {
     if (!isSegment) {
-      registerPageContextState(setContext);
+      registerPageContextState((newContext) => {
+        setContext(newContext);
+        broadcastToSegments(newContext);
+      });
+      return void 0;
+    } else {
+      registerSegmentSetter(setContext);
+      return () => unregisterSegmentSetter(setContext);
     }
   }, [
     isSegment
@@ -233,7 +253,7 @@ var useHeader = defaultHooks.useHeader;
 var useCookies = defaultHooks.useCookies;
 var useCookie = defaultHooks.useCookie;
 var rootRegistry = /* @__PURE__ */ new WeakMap();
-function hydrateSegment(outlet, componentName, props) {
+function hydrateSegment(outlet, componentName, props, layouts) {
   const modules = window.__MODULES__;
   if (!modules) {
     console.warn("[navigation] Module registry not available for segment hydration. Make sure entry-client.tsx exports window.__MODULES__.");
@@ -248,10 +268,11 @@ function hydrateSegment(outlet, componentName, props) {
     return;
   }
   const context = window.__CONTEXT__ || {};
+  const composedElement = composeWithLayouts(ViewComponent, props, layouts || [], context, modules);
   const element = /* @__PURE__ */ React2.createElement(PageContextProvider, {
     context,
     isSegment: true
-  }, /* @__PURE__ */ React2.createElement(ViewComponent, props));
+  }, composedElement);
   let wrapper = outlet.querySelector("[data-segment-root]");
   if (wrapper) {
     const existingRoot = rootRegistry.get(wrapper);
@@ -269,6 +290,27 @@ function hydrateSegment(outlet, componentName, props) {
   rootRegistry.set(wrapper, root);
 }
 __name(hydrateSegment, "hydrateSegment");
+function composeWithLayouts(ViewComponent, props, layouts, context, modules) {
+  let result = /* @__PURE__ */ React2.createElement(ViewComponent, props);
+  for (let i = layouts.length - 1; i >= 0; i--) {
+    const { name: layoutName, props: layoutProps } = layouts[i];
+    const Layout = resolveComponent(layoutName, modules);
+    if (!Layout) {
+      console.warn(`[navigation] Layout "${layoutName}" not found for hydration`);
+      continue;
+    }
+    result = /* @__PURE__ */ React2.createElement("div", {
+      "data-layout": layoutName
+    }, /* @__PURE__ */ React2.createElement(Layout, {
+      context,
+      layoutProps
+    }, /* @__PURE__ */ React2.createElement("div", {
+      "data-outlet": layoutName
+    }, result)));
+  }
+  return result;
+}
+__name(composeWithLayouts, "composeWithLayouts");
 function resolveComponent(name, modules) {
   const componentMap = Object.entries(modules).filter(([path, module]) => {
     const filename = path.split("/").pop();
@@ -336,8 +378,12 @@ async function navigate(url, options = {}) {
       return;
     }
     const outlet = await swapContent(response.html, response.swapTarget);
+    if (response.context) {
+      updatePageContext(response.context);
+      window.__CONTEXT__ = response.context;
+    }
     if (outlet) {
-      hydrateSegment(outlet, response.componentName, response.props);
+      hydrateSegment(outlet, response.componentName, response.props, response.layouts);
     }
     if (replace) {
       history.replaceState({
@@ -348,10 +394,6 @@ async function navigate(url, options = {}) {
         url
       }, "", url);
     }
-    if (response.context) {
-      updatePageContext(response.context);
-      window.__CONTEXT__ = response.context;
-    }
     if (response.head) {
       updateHead(response.head);
     }

package/dist/{index-DdE--mA2.d.mts → index-CiYcz-1T.d.mts}

@@ -1,12 +1,45 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { H as HeadData, R as RenderContext } from './render-response.interface-CxbuKGnV.mjs';
+import { Request, Response } from 'express';
+import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.mjs';
 import { ViteDevServer } from 'vite';
-import { Response } from 'express';
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * Custom context properties that can be added via context factory.
+ * Allows any properties to be merged into RenderContext.
+ */
+type CustomContextProperties = Record<string, unknown>;
+/**
+ * Context factory function signature
+ * Called for each request to build custom context properties
+ *
+ * @param params - Object containing the Express request
+ * @returns Custom context properties to merge into RenderContext (sync or async)
+ *
+ * @example
+ * ```typescript
+ * // Simple: pass user from Passport
+ * context: ({ req }) => ({ user: req.user })
+ *
+ * // With CLS
+ * context: ({ req }) => ({
+ *   user: req.user,
+ *   tenant: cls.get('tenant'),
+ * })
+ *
+ * // Async with services
+ * context: async ({ req }) => ({
+ *   user: req.user,
+ *   permissions: await permissionService.getForUser(req.user),
+ * })
+ * ```
+ */
+type ContextFactory = (params: {
+    req: Request;
+}) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
  */
@@ -173,6 +206,52 @@ interface RenderConfig {
      * ```
      */
     allowedCookies?: string[];
+    /**
+     * Context factory function to enrich RenderContext with custom properties
+     *
+     * This is called for each request and the result is merged into the base
+     * RenderContext (url, path, query, params, method, headers, cookies).
+     *
+     * Use this to add user data, feature flags, tenant info, or any other
+     * request-scoped data that should be available in React components via usePageContext().
+     *
+     * Similar to @nestjs/graphql context option - you choose how to get the data:
+     * - From request object (req.user from Passport)
+     * - From CLS (nestjs-cls)
+     * - From request-scoped services
+     *
+     * @example
+     * ```typescript
+     * // Simple: pass user from Passport JWT strategy
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *   }),
+     * })
+     *
+     * // With nestjs-cls
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *     tenant: cls.get('tenant'),
+     *     featureFlags: cls.get('featureFlags'),
+     *   }),
+     * })
+     *
+     * // Async with services (use forRootAsync)
+     * RenderModule.forRootAsync({
+     *   imports: [PermissionModule],
+     *   inject: [PermissionService],
+     *   useFactory: (permissionService: PermissionService) => ({
+     *     context: async ({ req }) => ({
+     *       user: req.user,
+     *       permissions: await permissionService.getForUser(req.user),
+     *     }),
+     *   }),
+     * })
+     * ```
+     */
+    context?: ContextFactory;
 }
 /**
  * Template parts for streaming SSR
@@ -206,6 +285,11 @@ interface SegmentResponse {
     componentName: string;
     /** Page context for updating hooks (path, params, query, etc.) */
     context?: RenderContext;
+    /** Layouts below the swap target that need to be composed on client */
+    layouts?: Array<{
+        name: string;
+        props?: any;
+    }>;
 }
 
 declare class RenderModule {
@@ -555,7 +639,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private renderService;
     private allowedHeaders?;
     private allowedCookies?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined);
+    private contextFactory?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -606,4 +691,4 @@ declare function ErrorPageDevelopment({ error, viewPath, phase, }: ErrorPageDeve
  */
 declare function ErrorPageProduction(): react_jsx_runtime.JSX.Element;
 
-export { ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };
+export { type ContextFactory as C, ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };

package/dist/{index-BzOLOiIZ.d.ts → index-Dq2qZSge.d.ts}

@@ -1,12 +1,45 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { H as HeadData, R as RenderContext } from './render-response.interface-CxbuKGnV.js';
+import { Request, Response } from 'express';
+import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.js';
 import { ViteDevServer } from 'vite';
-import { Response } from 'express';
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * Custom context properties that can be added via context factory.
+ * Allows any properties to be merged into RenderContext.
+ */
+type CustomContextProperties = Record<string, unknown>;
+/**
+ * Context factory function signature
+ * Called for each request to build custom context properties
+ *
+ * @param params - Object containing the Express request
+ * @returns Custom context properties to merge into RenderContext (sync or async)
+ *
+ * @example
+ * ```typescript
+ * // Simple: pass user from Passport
+ * context: ({ req }) => ({ user: req.user })
+ *
+ * // With CLS
+ * context: ({ req }) => ({
+ *   user: req.user,
+ *   tenant: cls.get('tenant'),
+ * })
+ *
+ * // Async with services
+ * context: async ({ req }) => ({
+ *   user: req.user,
+ *   permissions: await permissionService.getForUser(req.user),
+ * })
+ * ```
+ */
+type ContextFactory = (params: {
+    req: Request;
+}) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
  */
@@ -173,6 +206,52 @@ interface RenderConfig {
      * ```
      */
     allowedCookies?: string[];
+    /**
+     * Context factory function to enrich RenderContext with custom properties
+     *
+     * This is called for each request and the result is merged into the base
+     * RenderContext (url, path, query, params, method, headers, cookies).
+     *
+     * Use this to add user data, feature flags, tenant info, or any other
+     * request-scoped data that should be available in React components via usePageContext().
+     *
+     * Similar to @nestjs/graphql context option - you choose how to get the data:
+     * - From request object (req.user from Passport)
+     * - From CLS (nestjs-cls)
+     * - From request-scoped services
+     *
+     * @example
+     * ```typescript
+     * // Simple: pass user from Passport JWT strategy
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *   }),
+     * })
+     *
+     * // With nestjs-cls
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *     tenant: cls.get('tenant'),
+     *     featureFlags: cls.get('featureFlags'),
+     *   }),
+     * })
+     *
+     * // Async with services (use forRootAsync)
+     * RenderModule.forRootAsync({
+     *   imports: [PermissionModule],
+     *   inject: [PermissionService],
+     *   useFactory: (permissionService: PermissionService) => ({
+     *     context: async ({ req }) => ({
+     *       user: req.user,
+     *       permissions: await permissionService.getForUser(req.user),
+     *     }),
+     *   }),
+     * })
+     * ```
+     */
+    context?: ContextFactory;
 }
 /**
  * Template parts for streaming SSR
@@ -206,6 +285,11 @@ interface SegmentResponse {
     componentName: string;
     /** Page context for updating hooks (path, params, query, etc.) */
     context?: RenderContext;
+    /** Layouts below the swap target that need to be composed on client */
+    layouts?: Array<{
+        name: string;
+        props?: any;
+    }>;
 }
 
 declare class RenderModule {
@@ -555,7 +639,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private renderService;
     private allowedHeaders?;
     private allowedCookies?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined);
+    private contextFactory?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -606,4 +691,4 @@ declare function ErrorPageDevelopment({ error, viewPath, phase, }: ErrorPageDeve
  */
 declare function ErrorPageProduction(): react_jsx_runtime.JSX.Element;
 
-export { ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };
+export { type ContextFactory as C, ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-DdE--mA2.mjs';
+export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-CiYcz-1T.mjs';
 import React, { ComponentType, ReactNode } from 'react';
-import { P as PageProps } from './use-page-context-CGT9woWe.mjs';
-export { a as PageContextProvider, c as createSSRHooks, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CGT9woWe.mjs';
-import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-CxbuKGnV.mjs';
+import { P as PageProps } from './use-page-context-CVC9DHcL.mjs';
+export { a as PageContextProvider, c as createSSRHooks, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CVC9DHcL.mjs';
+import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.mjs';
 import '@nestjs/common';
-import 'vite';
 import 'express';
+import 'vite';
 import '@nestjs/core';
 import 'rxjs';
 import 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-BzOLOiIZ.js';
+export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-Dq2qZSge.js';
 import React, { ComponentType, ReactNode } from 'react';
-import { P as PageProps } from './use-page-context-05ODF4zW.js';
-export { a as PageContextProvider, c as createSSRHooks, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-05ODF4zW.js';
-import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-CxbuKGnV.js';
+import { P as PageProps } from './use-page-context-DChgHhL9.js';
+export { a as PageContextProvider, c as createSSRHooks, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-DChgHhL9.js';
+import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.js';
 import '@nestjs/common';
-import 'vite';
 import 'express';
+import 'vite';
 import '@nestjs/core';
 import 'rxjs';
 import 'react/jsx-runtime';

package/dist/index.js

@@ -315,9 +315,13 @@ var StringRenderer = class _StringRenderer {
         throw new Error("Server bundle not found in manifest. Run `pnpm build:server` to generate the server bundle.");
       }
     }
-    const { data: pageData, __context: pageContext } = data;
+    const { data: pageData, __context: pageContext, __layouts: layouts } = data;
     const html = await renderModule.renderSegment(viewComponent, data);
     const componentName = viewComponent.displayName || viewComponent.name || "Component";
+    const layoutMetadata = layouts ? layouts.map((l) => ({
+      name: l.layout.displayName || l.layout.name || "default",
+      props: l.props
+    })) : [];
     if (context.isDevelopment) {
       const duration = Date.now() - startTime;
       this.logger.log(`[SSR] ${componentName} segment rendered in ${duration}ms`);
@@ -328,7 +332,8 @@ var StringRenderer = class _StringRenderer {
       props: pageData,
       swapTarget,
       componentName,
-      context: pageContext
+      context: pageContext,
+      layouts: layoutMetadata
     };
   }
 };
@@ -1097,11 +1102,13 @@ exports.RenderInterceptor = class RenderInterceptor {
   renderService;
   allowedHeaders;
   allowedCookies;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies) {
+  contextFactory;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
+    this.contextFactory = contextFactory;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1241,6 +1248,14 @@ exports.RenderInterceptor = class RenderInterceptor {
           renderContext.cookies = cookies;
         }
       }
+      if (this.contextFactory) {
+        const customContext = await this.contextFactory({
+          req: request
+        });
+        if (customContext) {
+          Object.assign(renderContext, customContext);
+        }
+      }
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
@@ -1287,12 +1302,15 @@ exports.RenderInterceptor = _ts_decorate6([
   _ts_param3(2, common.Inject("ALLOWED_HEADERS")),
   _ts_param3(3, common.Optional()),
   _ts_param3(3, common.Inject("ALLOWED_COOKIES")),
+  _ts_param3(4, common.Optional()),
+  _ts_param3(4, common.Inject("CONTEXT_FACTORY")),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
     typeof core.Reflector === "undefined" ? Object : core.Reflector,
     typeof exports.RenderService === "undefined" ? Object : exports.RenderService,
     Array,
-    Array
+    Array,
+    typeof ContextFactory === "undefined" ? Object : ContextFactory
   ])
 ], exports.RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1536,6 +1554,12 @@ exports.RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    if (config?.context) {
+      providers.push({
+        provide: "CONTEXT_FACTORY",
+        useValue: config.context
+      });
+    }
     return {
       global: true,
       module: _RenderModule,
@@ -1654,6 +1678,13 @@ exports.RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "CONTEXT_FACTORY",
+        useFactory: /* @__PURE__ */ __name((config) => config?.context, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {
@@ -1716,9 +1747,28 @@ var PageContext = getOrCreateContext();
 function registerPageContextState(setter) {
 }
 __name(registerPageContextState, "registerPageContextState");
+var segmentSetters = /* @__PURE__ */ new Set();
+function registerSegmentSetter(setter) {
+  segmentSetters.add(setter);
+}
+__name(registerSegmentSetter, "registerSegmentSetter");
+function unregisterSegmentSetter(setter) {
+  segmentSetters.delete(setter);
+}
+__name(unregisterSegmentSetter, "unregisterSegmentSetter");
+function broadcastToSegments(context) {
+  segmentSetters.forEach((setter) => setter(context));
+}
+__name(broadcastToSegments, "broadcastToSegments");
 function PageContextProvider({ context: initialContext, children, isSegment = false }) {
   const [context, setContext] = React2.useState(initialContext);
   React2.useEffect(() => {
+    if (!isSegment) {
+      return void 0;
+    } else {
+      registerSegmentSetter(setContext);
+      return () => unregisterSegmentSetter(setContext);
+    }
   }, [
     isSegment
   ]);