@fluojs/react 0.1.0 → 0.2.0

package/dist/decorators.d.ts

@@ -56,11 +56,11 @@ export declare function Router(basePath?: string): ClassDecoratorLike;
  * `:param` placeholders only. The optional `options` value is metadata for future
  * render integrations; it does not create a React-owned matcher or `routes: []` table.
  *
- * @param path Route path relative to the containing `@Router(...)` base path.
- * @param options Optional render-facing metadata for the future React rendering layer.
+ * @param path Relative route path; omission or `undefined` uses `''`, preserving the `@Router(...)` prefix.
+ * @param options Optional render-facing metadata. Omission keeps the metadata's `options` property absent.
  * @returns A method decorator that writes HTTP `GET` metadata plus React path metadata.
  */
-export declare function Path(path: string, options?: ReactPathOptions): MethodDecoratorLike;
+export declare function Path(path?: string, options?: ReactPathOptions): MethodDecoratorLike;
 /**
  * Reads React router marker metadata from a router class.
  *

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAIxD,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;AACjG,KAAK,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;AACzD,KAAK,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAC3H,KAAK,kBAAkB,GAAG,wBAAwB,GAAG,sBAAsB,CAAC;AAC5E,KAAK,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAQ/E;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC,CAAC;AA4IF;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,QAAQ,SAAK,GAAG,kBAAkB,CAgBxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAsBlF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAI7F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,QAAQ,EACrB,WAAW,EAAE,mBAAmB,GAC/B,iBAAiB,GAAG,SAAS,CAK/B"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQxD,KAAK,wBAAwB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC1F,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAC;AACjG,KAAK,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;AACzD,KAAK,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAC3H,KAAK,kBAAkB,GAAG,wBAAwB,GAAG,sBAAsB,CAAC;AAC5E,KAAK,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAS/E;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC,CAAC;AA4IF;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,QAAQ,SAAK,GAAG,kBAAkB,CAgBxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAgC/E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAI7F;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,QAAQ,EACrB,WAAW,EAAE,mBAAmB,GAC/B,iBAAiB,GAAG,SAAS,CAK/B"}

package/dist/decorators.js

@@ -1,7 +1,11 @@
 import { getStandardMetadataBag } from '@fluojs/core/internal';
-import { Controller, Get } from '@fluojs/http';
+import { Controller, Get } from '@fluojs/http/portable';
+import { defineLegacyRuntimeRouteInspectionMetadata, defineStandardRuntimeRouteInspectionMetadata } from '@fluojs/runtime/internal';
 const reactRouterMetadataKey = Symbol.for('fluo.react.router');
 const reactPathMetadataKey = Symbol.for('fluo.react.path');
+const reactPageInspectionMetadata = Object.freeze({
+  kind: 'react-page'
+});
 const legacyRouterMetadataStore = new WeakMap();
 const legacyPathMetadataStore = new WeakMap();
 
@@ -150,21 +154,23 @@ export function Router(basePath = '') {
  * `:param` placeholders only. The optional `options` value is metadata for future
  * render integrations; it does not create a React-owned matcher or `routes: []` table.
  *
- * @param path Route path relative to the containing `@Router(...)` base path.
- * @param options Optional render-facing metadata for the future React rendering layer.
+ * @param path Relative route path; omission or `undefined` uses `''`, preserving the `@Router(...)` prefix.
+ * @param options Optional render-facing metadata. Omission keeps the metadata's `options` property absent.
  * @returns A method decorator that writes HTTP `GET` metadata plus React path metadata.
  */
-export function Path(path, options) {
+export function Path(path = '', options) {
   const httpDecorator = Get(path);
   const metadata = createReactPathMetadata(path, options);
   const decorator = (valueOrTarget, contextOrPropertyKey, descriptor) => {
     Reflect.apply(httpDecorator, undefined, [valueOrTarget, contextOrPropertyKey, descriptor]);
     if (isStandardMethodDecoratorContext(contextOrPropertyKey)) {
       defineStandardReactPathMetadata(contextOrPropertyKey.metadata, contextOrPropertyKey.name, metadata);
+      defineStandardRuntimeRouteInspectionMetadata(contextOrPropertyKey.metadata, contextOrPropertyKey.name, reactPageInspectionMetadata);
       return;
     }
     if (isMetadataPropertyKey(contextOrPropertyKey)) {
       defineLegacyReactPathMetadata(valueOrTarget, contextOrPropertyKey, metadata);
+      defineLegacyRuntimeRouteInspectionMetadata(valueOrTarget, contextOrPropertyKey, reactPageInspectionMetadata);
     }
   };
   return decorator;

package/dist/diagnostics.d.ts

@@ -0,0 +1,110 @@
+import { FluoError } from '@fluojs/core';
+import type { FrameworkRequest, RequestContext } from '@fluojs/http/portable';
+/** Stable machine-readable phases for the React SSR request lifecycle. */
+export declare const REACT_SSR_DIAGNOSTIC_PHASES: {
+    readonly httpPipeline: "http-pipeline";
+    readonly postShellRecoverable: "post-shell-recoverable";
+    readonly preCommitShell: "pre-commit-shell";
+    readonly requestAbort: "request-abort";
+};
+/** Stable machine-readable codes emitted by React SSR diagnostics. */
+export declare const REACT_SSR_DIAGNOSTIC_CODES: {
+    readonly httpPipelineFailure: "react-ssr-http-pipeline-failure";
+    readonly missingPageRenderer: "react-ssr-missing-page-renderer";
+    readonly postShellRecoverableError: "react-ssr-post-shell-recoverable-error";
+    readonly preCommitShellFailure: "react-ssr-pre-commit-shell-failure";
+    readonly requestAbort: "react-ssr-request-abort";
+};
+/** Machine-readable React SSR lifecycle phase. */
+export type ReactSsrDiagnosticPhase = (typeof REACT_SSR_DIAGNOSTIC_PHASES)[keyof typeof REACT_SSR_DIAGNOSTIC_PHASES];
+/** Machine-readable React SSR diagnostic code. */
+export type ReactSsrDiagnosticCode = (typeof REACT_SSR_DIAGNOSTIC_CODES)[keyof typeof REACT_SSR_DIAGNOSTIC_CODES];
+/** Structured diagnostic emitted while a React page request is processed. */
+export type ReactSsrDiagnostic = {
+    /** Stable machine-readable diagnostic code. */
+    readonly code: ReactSsrDiagnosticCode;
+    /** Original failure reported at this lifecycle boundary. */
+    readonly error: unknown;
+    /** Stable lifecycle phase associated with the failure. */
+    readonly phase: ReactSsrDiagnosticPhase;
+    /** Active framework request. */
+    readonly request: FrameworkRequest;
+    /** Adapter-provided request id, when available. */
+    readonly requestId?: string;
+};
+/** Application callback for observing structured React SSR diagnostics. */
+export type ReactSsrDiagnosticHandler = (diagnostic: ReactSsrDiagnostic) => void;
+/** Options for creating a typed React SSR diagnostic error. */
+export type ReactSsrDiagnosticErrorOptions = {
+    /** Stable machine-readable diagnostic code. */
+    readonly code: ReactSsrDiagnosticCode;
+    /** Original failure, when one exists. */
+    readonly cause?: unknown;
+    /** Stable lifecycle phase associated with the failure. */
+    readonly phase: ReactSsrDiagnosticPhase;
+};
+/** Typed React SSR failure carrying stable code and phase metadata. */
+export declare class ReactSsrDiagnosticError extends FluoError {
+    /** Stable machine-readable diagnostic code for this failure. */
+    readonly code: ReactSsrDiagnosticCode;
+    /** Stable lifecycle phase associated with this failure. */
+    readonly phase: ReactSsrDiagnosticPhase;
+    /**
+     * Creates a typed React SSR lifecycle failure.
+     *
+     * @param message Actionable human-readable failure description.
+     * @param options Stable code, phase, and optional original failure.
+     */
+    constructor(message: string, options: ReactSsrDiagnosticErrorOptions);
+}
+type ReactSsrDiagnosticMarker = {
+    readonly code: ReactSsrDiagnosticCode;
+    readonly error: unknown;
+    readonly phase: ReactSsrDiagnosticPhase;
+};
+/**
+ * Stores the module diagnostic handler on the active request context.
+ *
+ * @param context Request context that owns the render lifecycle.
+ * @param handler Module diagnostic handler, when configured.
+ */
+export declare function bindReactSsrDiagnosticHandler(context: RequestContext, handler: ReactSsrDiagnosticHandler | undefined): void;
+/**
+ * Reads the module diagnostic handler from a render request context.
+ *
+ * @param context Render context that may carry request metadata.
+ * @returns The request-local diagnostic handler, when one exists.
+ */
+export declare function readReactSsrDiagnosticHandler(context: object): ReactSsrDiagnosticHandler | undefined;
+/**
+ * Associates a diagnostic classification with an error without changing its identity.
+ *
+ * @param context Render context that owns the request-local marker.
+ * @param error Original lifecycle failure.
+ * @param marker Stable code and phase retained for the request error boundary.
+ */
+export declare function markReactSsrDiagnostic(context: object, error: unknown, marker: ReactSsrDiagnosticMarker): void;
+/**
+ * Reads and consumes the diagnostic classification associated with an error.
+ *
+ * @param context Request context that owns the request-local marker.
+ * @param error Original lifecycle failure.
+ * @returns The retained classification, when one exists.
+ */
+export declare function readReactSsrDiagnosticMarker(context: object, error: unknown): ReactSsrDiagnosticMarker | undefined;
+/**
+ * Creates a structured diagnostic snapshot for an SSR lifecycle event.
+ *
+ * @param diagnostic Diagnostic values observed at the active request boundary.
+ * @returns A request-safe diagnostic object.
+ */
+export declare function createReactSsrDiagnostic(diagnostic: ReactSsrDiagnostic): ReactSsrDiagnostic;
+/**
+ * Reports an SSR diagnostic without allowing observer failures to replace the request outcome.
+ *
+ * @param handler Application diagnostic observer, when configured.
+ * @param diagnostic Structured lifecycle event to report.
+ */
+export declare function reportReactSsrDiagnostic(handler: ReactSsrDiagnosticHandler | undefined, diagnostic: ReactSsrDiagnostic): void;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE9E,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B;;;;;CAK9B,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,0BAA0B;;;;;;CAM7B,CAAC;AAEX,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,gCAAgC;IAChC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG,CAAC,UAAU,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEjF,+DAA+D;AAC/D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;CACzC,CAAC;AAEF,uEAAuE;AACvE,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,gEAAgE;IAChE,SAAkB,IAAI,EAAE,sBAAsB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IAExC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,8BAA8B;CAU1C;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;CACzC,CAAC;AA4BF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAC7C,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,yBAAyB,GAAG,SAAS,CAYvC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,wBAAwB,GAC/B,IAAI,CAUN;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,SAAS,CAYtC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAQpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GAAG,SAAS,EAC9C,UAAU,EAAE,kBAAkB,GAC7B,IAAI,CAYN"}

package/dist/diagnostics.js

@@ -0,0 +1,180 @@
+import { FluoError } from '@fluojs/core';
+/** Stable machine-readable phases for the React SSR request lifecycle. */
+export const REACT_SSR_DIAGNOSTIC_PHASES = {
+  httpPipeline: 'http-pipeline',
+  postShellRecoverable: 'post-shell-recoverable',
+  preCommitShell: 'pre-commit-shell',
+  requestAbort: 'request-abort'
+};
+
+/** Stable machine-readable codes emitted by React SSR diagnostics. */
+export const REACT_SSR_DIAGNOSTIC_CODES = {
+  httpPipelineFailure: 'react-ssr-http-pipeline-failure',
+  missingPageRenderer: 'react-ssr-missing-page-renderer',
+  postShellRecoverableError: 'react-ssr-post-shell-recoverable-error',
+  preCommitShellFailure: 'react-ssr-pre-commit-shell-failure',
+  requestAbort: 'react-ssr-request-abort'
+};
+
+/** Machine-readable React SSR lifecycle phase. */
+
+/** Machine-readable React SSR diagnostic code. */
+
+/** Structured diagnostic emitted while a React page request is processed. */
+
+/** Application callback for observing structured React SSR diagnostics. */
+
+/** Options for creating a typed React SSR diagnostic error. */
+
+/** Typed React SSR failure carrying stable code and phase metadata. */
+export class ReactSsrDiagnosticError extends FluoError {
+  /** Stable machine-readable diagnostic code for this failure. */
+  code;
+  /** Stable lifecycle phase associated with this failure. */
+  phase;
+
+  /**
+   * Creates a typed React SSR lifecycle failure.
+   *
+   * @param message Actionable human-readable failure description.
+   * @param options Stable code, phase, and optional original failure.
+   */
+  constructor(message, options) {
+    super(message, {
+      code: options.code,
+      ...(options.cause === undefined ? {} : {
+        cause: options.cause
+      }),
+      meta: {
+        phase: options.phase
+      }
+    });
+    this.code = options.code;
+    this.phase = options.phase;
+  }
+}
+const diagnosticHandlerKey = Symbol.for('fluo.react.ssrDiagnosticHandler');
+const diagnosticMarkerKey = Symbol.for('fluo.react.ssrDiagnosticMarker');
+class ReactSsrDiagnosticMarkerStore {
+  markers = new WeakMap();
+  set(error, marker) {
+    this.markers.set(error, marker);
+  }
+  take(error) {
+    const marker = this.markers.get(error);
+    this.markers.delete(error);
+    return marker;
+  }
+}
+function isDiagnosticMarkerKey(value) {
+  return typeof value === 'object' && value !== null || typeof value === 'function';
+}
+function readReactSsrDiagnosticMetadata(context) {
+  const metadata = Reflect.get(context, 'metadata');
+  return typeof metadata === 'object' && metadata !== null ? metadata : undefined;
+}
+
+/**
+ * Stores the module diagnostic handler on the active request context.
+ *
+ * @param context Request context that owns the render lifecycle.
+ * @param handler Module diagnostic handler, when configured.
+ */
+export function bindReactSsrDiagnosticHandler(context, handler) {
+  if (handler === undefined) {
+    delete context.metadata[diagnosticHandlerKey];
+    return;
+  }
+  context.metadata[diagnosticHandlerKey] = handler;
+}
+
+/**
+ * Reads the module diagnostic handler from a render request context.
+ *
+ * @param context Render context that may carry request metadata.
+ * @returns The request-local diagnostic handler, when one exists.
+ */
+export function readReactSsrDiagnosticHandler(context) {
+  const metadata = readReactSsrDiagnosticMetadata(context);
+  if (metadata === undefined) {
+    return undefined;
+  }
+  const handler = Reflect.get(metadata, diagnosticHandlerKey);
+  if (typeof handler !== 'function') {
+    return undefined;
+  }
+  return diagnostic => Reflect.apply(handler, undefined, [diagnostic]);
+}
+
+/**
+ * Associates a diagnostic classification with an error without changing its identity.
+ *
+ * @param context Render context that owns the request-local marker.
+ * @param error Original lifecycle failure.
+ * @param marker Stable code and phase retained for the request error boundary.
+ */
+export function markReactSsrDiagnostic(context, error, marker) {
+  const metadata = readReactSsrDiagnosticMetadata(context);
+  if (metadata !== undefined && isDiagnosticMarkerKey(error)) {
+    const state = Reflect.get(metadata, diagnosticMarkerKey);
+    const store = state instanceof ReactSsrDiagnosticMarkerStore ? state : new ReactSsrDiagnosticMarkerStore();
+    store.set(error, marker);
+    Reflect.set(metadata, diagnosticMarkerKey, store);
+  }
+}
+
+/**
+ * Reads and consumes the diagnostic classification associated with an error.
+ *
+ * @param context Request context that owns the request-local marker.
+ * @param error Original lifecycle failure.
+ * @returns The retained classification, when one exists.
+ */
+export function readReactSsrDiagnosticMarker(context, error) {
+  const metadata = readReactSsrDiagnosticMetadata(context);
+  if (metadata === undefined || !isDiagnosticMarkerKey(error)) {
+    return undefined;
+  }
+  const state = Reflect.get(metadata, diagnosticMarkerKey);
+  if (!(state instanceof ReactSsrDiagnosticMarkerStore)) {
+    return undefined;
+  }
+  return state.take(error);
+}
+
+/**
+ * Creates a structured diagnostic snapshot for an SSR lifecycle event.
+ *
+ * @param diagnostic Diagnostic values observed at the active request boundary.
+ * @returns A request-safe diagnostic object.
+ */
+export function createReactSsrDiagnostic(diagnostic) {
+  return {
+    code: diagnostic.code,
+    error: diagnostic.error,
+    phase: diagnostic.phase,
+    request: diagnostic.request,
+    ...(diagnostic.requestId === undefined ? {} : {
+      requestId: diagnostic.requestId
+    })
+  };
+}
+
+/**
+ * Reports an SSR diagnostic without allowing observer failures to replace the request outcome.
+ *
+ * @param handler Application diagnostic observer, when configured.
+ * @param diagnostic Structured lifecycle event to report.
+ */
+export function reportReactSsrDiagnostic(handler, diagnostic) {
+  if (handler === undefined) {
+    return;
+  }
+  try {
+    handler(diagnostic);
+  } catch (error) {
+    if (error instanceof Error) {
+      return;
+    }
+  }
+}

package/dist/error-representation.d.ts

@@ -0,0 +1,28 @@
+import type { MaybePromise } from '@fluojs/core';
+import type { HtmlErrorRepresentationProvider, HttpErrorRepresentationContext } from '@fluojs/http/portable';
+import { type ReactReadableStreamRenderer } from './render.js';
+import type { ReactServerEntry } from './server-entry.js';
+/** Application callback that creates one React error document after HTTP classifies the outcome. */
+export type ReactErrorDocumentRenderer = (context: HttpErrorRepresentationContext) => MaybePromise<ReactServerEntry>;
+/** Options for adapting an application React document renderer to the HTTP HTML provider seam. */
+export type ReactErrorRepresentationProviderOptions = {
+    /** Optional route/application constraint evaluated by the HTTP dispatcher before rendering. */
+    readonly canRender?: HtmlErrorRepresentationProvider['canRender'];
+    /** Creates the complete React document for the already-classified HTTP outcome. */
+    readonly renderDocument: ReactErrorDocumentRenderer;
+    /** Optional Web Streams renderer override used by custom integrations and tests. */
+    readonly renderToReadableStream?: ReactReadableStreamRenderer;
+};
+/**
+ * Adapts an application-owned React document renderer to HTTP error representation negotiation.
+ *
+ * @remarks
+ * Rendering is fully buffered before the HTTP dispatcher applies status, headers,
+ * or commit. `ReactServerEntry.status` and `ReactServerEntry.headers` are ignored,
+ * and this helper never performs matching or consults page render policies.
+ *
+ * @param options Application document renderer and optional availability/rendering hooks.
+ * @returns An HTTP HTML provider registered through `errorRepresentation.html`.
+ */
+export declare function createReactErrorRepresentationProvider(options: ReactErrorRepresentationProviderOptions): HtmlErrorRepresentationProvider;
+//# sourceMappingURL=error-representation.d.ts.map

package/dist/error-representation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-representation.d.ts","sourceRoot":"","sources":["../src/error-representation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,oGAAoG;AACpG,MAAM,MAAM,0BAA0B,GAAG,CACvC,OAAO,EAAE,8BAA8B,KACpC,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAEpC,kGAAkG;AAClG,MAAM,MAAM,uCAAuC,GAAG;IACpD,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,CAAC,EAAE,+BAA+B,CAAC,WAAW,CAAC,CAAC;IAClE,mFAAmF;IACnF,QAAQ,CAAC,cAAc,EAAE,0BAA0B,CAAC;IACpD,oFAAoF;IACpF,QAAQ,CAAC,sBAAsB,CAAC,EAAE,2BAA2B,CAAC;CAC/D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,uCAAuC,GAC/C,+BAA+B,CAUjC"}

package/dist/error-representation.js

@@ -0,0 +1,28 @@
+import { renderReactServerEntryToBytes } from './render.js';
+
+/** Application callback that creates one React error document after HTTP classifies the outcome. */
+
+/** Options for adapting an application React document renderer to the HTTP HTML provider seam. */
+
+/**
+ * Adapts an application-owned React document renderer to HTTP error representation negotiation.
+ *
+ * @remarks
+ * Rendering is fully buffered before the HTTP dispatcher applies status, headers,
+ * or commit. `ReactServerEntry.status` and `ReactServerEntry.headers` are ignored,
+ * and this helper never performs matching or consults page render policies.
+ *
+ * @param options Application document renderer and optional availability/rendering hooks.
+ * @returns An HTTP HTML provider registered through `errorRepresentation.html`.
+ */
+export function createReactErrorRepresentationProvider(options) {
+  return {
+    ...(options.canRender === undefined ? {} : {
+      canRender: options.canRender
+    }),
+    async render(context) {
+      const entry = await options.renderDocument(context);
+      return options.renderToReadableStream === undefined ? renderReactServerEntryToBytes(entry, context) : renderReactServerEntryToBytes(entry, context, options.renderToReadableStream);
+    }
+  };
+}

package/dist/experimental/rsc-flight-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsc-flight-response.d.ts","sourceRoot":"","sources":["../../src/experimental/rsc-flight-response.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,0BAA0B,EAChC,MAAM,gBAAgB,CAAC;AA6ExB;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAarB"}
+{"version":3,"file":"rsc-flight-response.d.ts","sourceRoot":"","sources":["../../src/experimental/rsc-flight-response.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,0BAA0B,EAChC,MAAM,gBAAgB,CAAC;AAqExB;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAWrB"}

package/dist/experimental/rsc-flight-response.js

@@ -1,6 +1,6 @@
+import { registerFrameworkResponseWriter } from '@fluojs/http/internal';
 import { collectReadableStream, pipeReadableStream, throwIfReactRequestAborted } from '../render-stream.js';
 import { REACT_RSC_FLIGHT_CONTENT_TYPE } from './rsc-types.js';
-const responseWriterKey = Symbol.for('fluo.http.responseWriter');
 function cloneHeaders(headers) {
   const snapshot = {};
   for (const [name, value] of Object.entries(headers ?? {})) {
@@ -68,9 +68,5 @@ export function createReactFlightResponse(payload, options = {}) {
       status: options.status
     } : {})
   };
-  Object.defineProperty(entry, responseWriterKey, {
-    enumerable: false,
-    value: context => writeReactFlightResponse(entry, context)
-  });
-  return entry;
+  return registerFrameworkResponseWriter(entry, context => writeReactFlightResponse(entry, context));
 }

package/dist/experimental/server-functions-server.js

@@ -1,4 +1,4 @@
-import { HttpException } from '@fluojs/http';
+import { HttpException } from '@fluojs/http/portable';
 import { createReactServerFunctionRegistryConfiguration } from './server-functions-configuration.js';
 import { ReactServerFunctionConfigurationError } from './server-functions-errors.js';
 import { createReactServerFunctionReferenceSigner } from './server-functions-reference.js';

package/dist/experimental/server-functions-types.d.ts

@@ -1,5 +1,5 @@
 import type { MaybePromise } from '@fluojs/core';
-import type { RequestContext } from '@fluojs/http';
+import type { RequestContext } from '@fluojs/http/portable';
 /** Header required on experimental Server Function POST requests to force a non-simple request. */
 export declare const REACT_SERVER_FUNCTION_REQUEST_HEADER = "x-fluo-react-action";
 /** Stable error codes emitted by the experimental Server Function transport boundary. */

package/dist/experimental/server-functions-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-functions-types.d.ts","sourceRoot":"","sources":["../../src/experimental/server-functions-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server-functions-types.d.ts","sourceRoot":"","sources":["../../src/experimental/server-functions-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,mGAAmG;AACnG,eAAO,MAAM,oCAAoC,wBAAwB,CAAC;AAE1E,yFAAyF;AACzF,eAAO,MAAM,iCAAiC;;;;;;;;;;CAUpC,CAAC;AAEX,mFAAmF;AACnF,MAAM,MAAM,4BAA4B,GACtC,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,OAAO,iCAAiC,CAAC,CAAC;AAE7F,8EAA8E;AAC9E,MAAM,MAAM,wBAAwB,GAChC,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,wBAAwB,EAAE,GACnC;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAA;CAAE,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,MAAM,4BAA4B,GAAG;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,0BAA0B,GAAG,CACvC,IAAI,EAAE,SAAS,wBAAwB,EAAE,EACzC,OAAO,EAAE,cAAc,KACpB,YAAY,CAAC,wBAAwB,CAAC,CAAC;AAE5C,4EAA4E;AAC5E,MAAM,MAAM,kCAAkC,GAAG;IAC/C,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC;IACvE,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,GAAG;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACtF;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACpF,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/F,+EAA+E;AAC/E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;CAClD,CAAC;AAEF,oGAAoG;AACpG,MAAM,MAAM,yBAAyB,GAAG,CACtC,GAAG,IAAI,EAAE,SAAS,wBAAwB,EAAE,KACzC,OAAO,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,22 @@
-export { Path, Router, getReactPathMetadata, getReactRouterMetadata, } from './decorators.js';
 export type { ReactPathMetadata, ReactPathOptions, ReactRouterMetadata } from './decorators.js';
-export { ReactModule } from './module.js';
+export { getReactPathMetadata, getReactRouterMetadata, Path, Router, } from './decorators.js';
+export type { ReactSsrDiagnostic, ReactSsrDiagnosticCode, ReactSsrDiagnosticErrorOptions, ReactSsrDiagnosticHandler, ReactSsrDiagnosticPhase, } from './diagnostics.js';
+export { REACT_SSR_DIAGNOSTIC_CODES, REACT_SSR_DIAGNOSTIC_PHASES, ReactSsrDiagnosticError, } from './diagnostics.js';
+export type { ReactErrorDocumentRenderer, ReactErrorRepresentationProviderOptions, } from './error-representation.js';
+export { createReactErrorRepresentationProvider } from './error-representation.js';
 export type { ReactModuleOptions } from './module.js';
+export { ReactModule } from './module.js';
+export type { ReactPageCatalogEntry } from './page-catalog.js';
+export { createReactPageCatalog } from './page-catalog.js';
+export type { ReactPageLink, ReactPageMeta, ReactPageMetadata, ReactPageMetadataContext, ReactPageMetadataFactory, } from './page-metadata.js';
+export { createReactPageMetadataElements, PageMetadata, resolveReactPageMetadata, } from './page-metadata.js';
+export type { ReactPageRenderer } from './page-renderer.js';
+export { REACT_PAGE_RENDERER } from './page-renderer.js';
+export type { ReactReadableStream, ReactReadableStreamRenderer, ReactReadableStreamRenderOptions, ReactRenderContext, RenderReactResponseOptions, } from './render.js';
 export { renderReactResponse } from './render.js';
-export type { ReactReadableStream, ReactReadableStreamRenderOptions, ReactReadableStreamRenderer, ReactRenderContext, RenderReactResponseOptions, } from './render.js';
-export { createReactServerEntry } from './server-entry.js';
+export type { ReactPageLayout, ReactPageLayoutProps, ReactRenderPolicies, ReactRenderPolicyDiagnosticCode, ReactSuspenseFallback, ReactSuspenseFallbackProps, } from './render-policy.js';
+export { getReactRenderPolicies, PageLayout, REACT_RENDER_POLICY_DIAGNOSTIC_CODES, ReactRenderPolicyConfigurationError, SuspenseFallback, } from './render-policy.js';
 export type { ReactAssetMap, ReactBootstrapAsset, ReactBootstrapScriptDescriptor, ReactRecoverableErrorContext, ReactRecoverableErrorHandler, ReactServerEntry, ReactServerEntryHeaders, ReactServerEntryOptions, } from './server-entry.js';
+export { createReactServerEntry } from './server-entry.js';
 export type { ReactScaffoldPhase } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,mBAAmB,EACnB,gCAAgC,EAChC,2BAA2B,EAC3B,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,IAAI,EACJ,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,0BAA0B,EAC1B,uCAAuC,GACxC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,YAAY,EACZ,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,+BAA+B,EAC/B,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,oCAAoC,EACpC,mCAAmC,EACnC,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,10 @@
-export { Path, Router, getReactPathMetadata, getReactRouterMetadata } from './decorators.js';
+export { getReactPathMetadata, getReactRouterMetadata, Path, Router } from './decorators.js';
+export { REACT_SSR_DIAGNOSTIC_CODES, REACT_SSR_DIAGNOSTIC_PHASES, ReactSsrDiagnosticError } from './diagnostics.js';
+export { createReactErrorRepresentationProvider } from './error-representation.js';
 export { ReactModule } from './module.js';
+export { createReactPageCatalog } from './page-catalog.js';
+export { createReactPageMetadataElements, PageMetadata, resolveReactPageMetadata } from './page-metadata.js';
+export { REACT_PAGE_RENDERER } from './page-renderer.js';
 export { renderReactResponse } from './render.js';
+export { getReactRenderPolicies, PageLayout, REACT_RENDER_POLICY_DIAGNOSTIC_CODES, ReactRenderPolicyConfigurationError, SuspenseFallback } from './render-policy.js';
 export { createReactServerEntry } from './server-entry.js';

package/dist/module.d.ts

@@ -1,7 +1,9 @@
 import { type Constructor, type Token } from '@fluojs/core';
 import type { Provider } from '@fluojs/di';
-import type { MiddlewareLike } from '@fluojs/http';
-import { type ModuleType } from '@fluojs/runtime';
+import type { MiddlewareLike } from '@fluojs/http/portable';
+import { type ModuleType } from '@fluojs/runtime/internal';
+import type { ReactSsrDiagnosticHandler } from './diagnostics.js';
+import { type ReactPageRenderer } from './page-renderer.js';
 /**
  * Options for registering React routers through the fluo module graph.
  */
@@ -14,8 +16,12 @@ export type ReactModuleOptions = {
     readonly imports?: readonly ModuleType[];
     /** Module-level middleware applied by the existing HTTP dispatcher to this module's routes. */
     readonly middleware?: readonly MiddlewareLike[];
+    /** Application callback for stable phase-aware React SSR diagnostics. */
+    readonly onDiagnostic?: ReactSsrDiagnosticHandler;
     /** Providers local to this dynamic React module and visible to registered routers. */
     readonly providers?: readonly Provider[];
+    /** Application callback that composes page elements into existing React server entries. */
+    readonly renderPage?: ReactPageRenderer;
 };
 /**
  * Runtime-neutral module facade for registering React routers in fluo applications.

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBACa,WAAW;IACtB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;CAaxD"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAU,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIjF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAClD,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBACa,WAAW;IACtB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;CA2CxD"}

package/dist/module.js

@@ -5,7 +5,10 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
 import { Module } from '@fluojs/core';
-import { defineModule } from '@fluojs/runtime';
+import { defineModule } from '@fluojs/runtime/internal';
+import { REACT_PAGE_RENDERER } from './page-renderer.js';
+import { createReactPageResultMiddleware } from './page-result.js';
+import { validateReactRenderPolicyControllers } from './render-policy.js';
 
 /**
  * Options for registering React routers through the fluo module graph.
@@ -34,19 +37,39 @@ class ReactModule {
    */
   static forRoot(options) {
     class ReactRootModule extends _ReactModule {}
+    const pageRendererProvider = options.renderPage === undefined ? undefined : {
+      provide: REACT_PAGE_RENDERER,
+      useValue: options.renderPage
+    };
+    const renderPolicyValidatorProvider = {
+      provide: Symbol('fluo.react.render-policy-validator'),
+      useValue: {
+        onModuleInit() {
+          validateReactRenderPolicyControllers(options.controllers, options.renderPage !== undefined);
+        }
+      }
+    };
+    const exports = [...(options.exports ?? []), ...(pageRendererProvider === undefined ? [] : [REACT_PAGE_RENDERER])];
+    const providers = [...(options.providers ?? []), renderPolicyValidatorProvider, ...(pageRendererProvider === undefined ? [] : [pageRendererProvider])];
+    const middleware = [createReactPageResultMiddleware({
+      ...(options.onDiagnostic === undefined ? {} : {
+        onDiagnostic: options.onDiagnostic
+      }),
+      ...(options.renderPage === undefined ? {} : {
+        renderPage: options.renderPage
+      })
+    }), ...(options.middleware ?? [])];
     const definition = {
       controllers: [...options.controllers],
-      ...(options.exports ? {
-        exports: [...options.exports]
+      ...(exports.length > 0 ? {
+        exports
       } : {}),
       ...(options.imports ? {
         imports: [...options.imports]
       } : {}),
-      ...(options.middleware ? {
-        middleware: [...options.middleware]
-      } : {}),
-      ...(options.providers ? {
-        providers: [...options.providers]
+      middleware,
+      ...(providers.length > 0 ? {
+        providers
       } : {})
     };
     return defineModule(ReactRootModule, definition);