@mandujs/core 0.54.18 → 0.54.19

package/src/runtime/page-render-response.ts

@@ -11,6 +11,13 @@ export interface InlineClientHydrationTarget {
   src: string;
   priority: NonNullable<HydrationConfig["priority"]>;
   component: unknown;
+  /**
+   * Compatibility path for pre-F42 route-level client modules where the
+   * client component is hidden behind a server wrapper. Disabled by default
+   * because it invokes user function components outside React's renderer.
+   */
+  legacyRuntimeScan?: boolean;
+  sourceFile?: string;
 }
 
 export interface PageRenderResponseOptions {
@@ -125,7 +132,8 @@ async function resolveAndWrapInlineClientHydration(
     };
   }
 
-  if (typeof type === "function" && !isClassComponent(type)) {
+  if (target.legacyRuntimeScan && typeof type === "function" && !isClassComponent(type)) {
+    warnLegacyRuntimePartialScan(target);
     const rendered = await renderFunctionComponentForInlineHydration(
       type,
       element.props ?? {},
@@ -152,6 +160,20 @@ async function resolveAndWrapInlineClientHydration(
   return { node: cloned, didWrap: resolvedChildren.didWrap };
 }
 
+const warnedLegacyRuntimePartialScanRoutes = new Set<string>();
+
+function warnLegacyRuntimePartialScan(target: InlineClientHydrationTarget): void {
+  if (warnedLegacyRuntimePartialScanRoutes.has(target.routeId)) return;
+  warnedLegacyRuntimePartialScanRoutes.add(target.routeId);
+
+  const file = target.sourceFile ? ` file="${target.sourceFile}"` : "";
+  console.warn(
+    `[MANDU_LEGACY_RUNTIME_PARTIAL_SCAN] route="${target.routeId}"${file}: ` +
+    "runtime client component discovery is running under the compatibility flag. " +
+    "Migrate this route to compiler-owned client boundaries so SSR does not invoke user components during discovery.",
+  );
+}
+
 function isAsyncFunctionComponent(type: Function): boolean {
   return !type.prototype?.isReactComponent &&
     (type as { constructor?: { name?: string } }).constructor?.name === "AsyncFunction";

package/src/runtime/server.ts

@@ -1117,9 +1117,11 @@ function createDefaultAppFactory(registry: ServerRegistry) {
 async function resolveInlineClientHydrationTarget(
   route: {
     id: string;
+    componentModule?: string;
     clientModule?: string;
     clientExportName?: string;
     hydration?: HydrationConfig;
+    boundaries?: unknown[];
   },
   rootDir: string,
   src: string,
@@ -1127,6 +1129,14 @@ async function resolveInlineClientHydrationTarget(
   if (!route.clientModule || !src) {
     return undefined;
   }
+  if (route.boundaries && route.boundaries.length > 0) {
+    return undefined;
+  }
+
+  const legacyRuntimeScan = process.env.MANDU_LEGACY_RUNTIME_PARTIAL_SCAN === "1";
+  if (!legacyRuntimeScan) {
+    return undefined;
+  }
 
   try {
     const module = await import(path.join(rootDir, route.clientModule));
@@ -1139,6 +1149,8 @@ async function resolveInlineClientHydrationTarget(
       src,
       priority: route.hydration?.priority ?? "visible",
       component,
+      legacyRuntimeScan,
+      sourceFile: route.componentModule ?? route.clientModule,
     };
   } catch (error) {
     console.warn(
@@ -2112,8 +2124,10 @@ async function renderPageSSR(
     errorModule?: string;
     loadingModule?: string;
     notFoundModule?: string;
+    componentModule?: string;
     clientModule?: string;
     clientExportName?: string;
+    boundaries?: unknown[];
   },
   params: Record<string, string>,
   loaderData: unknown,