@farm.js/core 0.1.45 → 0.1.47

package/dist/{chunk-I5IO3ASU.cjs → chunk-2DZFF7F7.cjs}

@@ -11,7 +11,7 @@ var _chunkCGR525MJcjs = require('./chunk-CGR525MJ.cjs');
 
 
 
-var _chunkKVN3YEFFcjs = require('./chunk-KVN3YEFF.cjs');
+var _chunkNFME7OKZcjs = require('./chunk-NFME7OKZ.cjs');
 
 
 
@@ -82,7 +82,7 @@ var _chunk2SJ4RQ6Pcjs = require('./chunk-2SJ4RQ6P.cjs');
 
 
 
-var _chunkSIVK2SRRcjs = require('./chunk-SIVK2SRR.cjs');
+var _chunkQ5F32A26cjs = require('./chunk-Q5F32A26.cjs');
 
 
 var _chunk45QJHGZMcjs = require('./chunk-45QJHGZM.cjs');
@@ -109,7 +109,7 @@ var _chunk3XEMGDBFcjs = require('./chunk-3XEMGDBF.cjs');
 
 
 
-var _chunkUN4B2TXCcjs = require('./chunk-UN4B2TXC.cjs');
+var _chunkXIZO5VDAcjs = require('./chunk-XIZO5VDA.cjs');
 
 
 var _chunkTI7UANHIcjs = require('./chunk-TI7UANHI.cjs');
@@ -224,7 +224,7 @@ var _chunk5QIKR7RRcjs = require('./chunk-5QIKR7RR.cjs');
 var _chunkKNBBQHO2cjs = require('./chunk-KNBBQHO2.cjs');
 
 
-var _chunk2DZOABRKcjs = require('./chunk-2DZOABRK.cjs');
+var _chunkOF4TXHM4cjs = require('./chunk-OF4TXHM4.cjs');
 
 
 var _chunkC5GUTBZKcjs = require('./chunk-C5GUTBZK.cjs');
@@ -1965,7 +1965,7 @@ async function mergeBuiltFontCss(outputDir, fontCssSource) {
   }
   const normalizedFontCss = typeof fontCss === "string" ? fontCss : Buffer.from(fontCss).toString("utf8");
   await fs4.writeFile(fontCssPath, normalizedFontCss);
-  await fs4.writeFile(clientCssPath, _chunkSIVK2SRRcjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
+  await fs4.writeFile(clientCssPath, _chunkQ5F32A26cjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, mergeBuiltFontCss, "mergeBuiltFontCss");
 var _IncompleteClientBuildOutputError = class _IncompleteClientBuildOutputError extends Error {
@@ -2015,7 +2015,7 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
   const key = `${_path2.default.resolve(root)}\0${mode}\0${options.asyncOwnerIslands === true}\0${options.serverOwners === true}\0${_path2.default.resolve(modulePath)}`;
   let plan = cache.get(key);
   if (!plan) {
-    plan = _chunkSIVK2SRRcjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
+    plan = _chunkQ5F32A26cjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
     cache.set(key, plan);
   }
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
@@ -2044,14 +2044,14 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       `[Farm.js] isolated hydration kept route-wide because integration provider "${unsupportedIntegrationProvider.name}" does not declare supportsIsolatedHydration: true.`
     );
   }
-  const isolatedMode = _chunkSIVK2SRRcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+  const isolatedMode = _chunkQ5F32A26cjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
     _optionalChain([config, 'access', _39 => _39.experimental, 'optionalAccess', _40 => _40.isolatedClientHydration]),
     {
       serverComponents: _chunkPDU4P2ICcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _41 => _41.experimental, 'optionalAccess', _42 => _42.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const planOptions = _chunkSIVK2SRRcjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const planOptions = _chunkQ5F32A26cjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
@@ -2102,7 +2102,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       };
     }
   });
-  const layoutAppliesToRoute = _chunkUN4B2TXCcjs.routeBoundaryCoversDirectory;
+  const layoutAppliesToRoute = _chunkXIZO5VDAcjs.routeBoundaryCoversDirectory;
   const routeDirectory = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (route) => _nullishCoalesce(route.directory, () => ( route.pattern)), "routeDirectory");
   const adapterOwnsDocsRuntime = Boolean(
     _chunkPSV6XKPOcjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _45 => _45.docs, 'optionalAccess', _46 => _46.enabled]) && _optionalChain([config, 'access', _47 => _47.docs, 'access', _48 => _48.adapter, 'optionalAccess', _49 => _49.server]) && config.docs.adapter.react
@@ -2113,7 +2113,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   ), "isAdapterDocsRoute");
   const syntheticDocsEntry = _optionalChain([config, 'access', _52 => _52.docs, 'optionalAccess', _53 => _53.enabled]) && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
   const syntheticDocsPatterns = syntheticDocsEntry ? syntheticDocsEntry === "/" ? ["/", "/[...slug]"] : [syntheticDocsEntry, `${syntheticDocsEntry}/[...slug]`] : [];
-  const markdownPagePlan = _chunkSIVK2SRRcjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkQ5F32A26cjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunkOHY2ZWUGcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunkOHY2ZWUGcjs.resolveMdxConfig.call(void 0, config.mdx), root),
     root,
     isolatedMode,
@@ -2129,7 +2129,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       pagePlanOptions
     )
   }));
-  _chunkSIVK2SRRcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkQ5F32A26cjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     clientLayouts.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -2138,7 +2138,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     [
       ...routePlans.map(({ route, metadata }) => ({
         pattern: routeDirectory(route),
-        depth: _chunkUN4B2TXCcjs.getRouteDirectoryDepth.call(void 0, routeDirectory(route)),
+        depth: _chunkXIZO5VDAcjs.getRouteDirectoryDepth.call(void 0, routeDirectory(route)),
         metadata
       })),
       ...syntheticDocsPatterns.map((pattern) => ({
@@ -2161,7 +2161,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   for (const layout of clientLayouts) {
     const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || Boolean(adapterDocsEntry && layoutAppliesToRoute(layout.pattern, adapterDocsEntry));
     if (matchesBuiltRoute && layout.suppressedAsyncHydration) {
-      _chunk5QIKR7RRcjs.logger.warn(`\u26A0\uFE0F  ${_chunkSIVK2SRRcjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
+      _chunk5QIKR7RRcjs.logger.warn(`\u26A0\uFE0F  ${_chunkQ5F32A26cjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
     }
   }
   if (isolatedMode === "analyze") {
@@ -2185,7 +2185,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       );
       if (metadata.suppressedAsyncHydration) {
         _chunk5QIKR7RRcjs.logger.warn(
-          `\u26A0\uFE0F  ${_chunkSIVK2SRRcjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
+          `\u26A0\uFE0F  ${_chunkQ5F32A26cjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
         );
       }
       if (metadata.shouldHydrate || metadata.hasIsolatedClientBoundaries || applicableClientLayouts.length > 0) {
@@ -2210,7 +2210,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             ...applicableClientLayouts.filter((layout) => layout.hasIsolatedClientBoundaries).flatMap((layout) => layout.isolatedBoundaries)
           ],
           // The server renders a server tree only below a hydrating layout.
-          ..._chunkSIVK2SRRcjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
+          ..._chunkQ5F32A26cjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
         });
         _chunk5QIKR7RRcjs.logger.info(`\u{1F4F1} Found hydratable route: ${route.pattern} -> ${route.modulePath}`);
       }
@@ -2246,7 +2246,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   }
   const clientRouteSlots = routeSlots.filter((slot) => {
     try {
-      return _chunkSIVK2SRRcjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
+      return _chunkQ5F32A26cjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
     } catch (error) {
       _chunk5QIKR7RRcjs.logger.warn(`\u26A0\uFE0F  Could not inspect route slot ${slot.modulePath}: ${error}`);
       return false;
@@ -2276,7 +2276,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     config.trailingSlash,
     _chunkB6XAA7V6cjs.getIntegrationProviders.call(void 0, config.integrations),
     config.basePath,
-    _chunkSIVK2SRRcjs.generateClientCachePersistenceCode.call(void 0, _chunkSIVK2SRRcjs.resolveFarmClientCacheAdapterEntry.call(void 0, root, config.cache)),
+    _chunkQ5F32A26cjs.generateClientCachePersistenceCode.call(void 0, _chunkQ5F32A26cjs.resolveFarmClientCacheAdapterEntry.call(void 0, root, config.cache)),
     adapterOwnsDocsRuntime ? _chunkCY2ZQ5C6cjs.getFarmDocsAdapterConfigModule.call(void 0, config.docs) : void 0,
     _chunkPDU4P2ICcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _59 => _59.experimental, 'optionalAccess', _60 => _60.serverComponents])) === "islands"
   );
@@ -2365,7 +2365,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         }
       },
       plugins: [
-        _chunkSIVK2SRRcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkQ5F32A26cjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         createFarmPrivateClientSourcemapsPlugin({
           outDir: _path2.default.join(_path2.default.dirname(outputDir), FARM_CLIENT_SOURCEMAPS_DIR)
         }),
@@ -2390,7 +2390,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
         farmServerOnlyEntriesPlugin(),
-        _chunkSIVK2SRRcjs.farmDocsClientConfigPlugin.call(void 0, 
+        _chunkQ5F32A26cjs.farmDocsClientConfigPlugin.call(void 0, 
           adapterOwnsDocsRuntime ? _chunkCY2ZQ5C6cjs.getFarmDocsAdapterConfigModule.call(void 0, config.docs) : void 0
         ),
         // Plugin to redirect @farm.js/core imports to client-only exports
@@ -2452,7 +2452,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       } : void 0,
       // Ensure React is bundled for client
       resolve: {
-        alias: _chunkSIVK2SRRcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkQ5F32A26cjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       // Optimize dependencies - exclude server-side code from client bundle
@@ -2465,7 +2465,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ]
       }
     };
-    await viteBuild(_chunkSIVK2SRRcjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
+    await viteBuild(_chunkQ5F32A26cjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
     await mergeBuiltFontCss(outputDir);
     await validateClientBuildOutput(root, srcDir, outputDir);
   } finally {
@@ -3260,7 +3260,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
   direction: {}
 }, plugins = [], renderer = _chunkPSV6XKPOcjs.REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule, islandValues = false) {
   const toImportPath = /* @__PURE__ */ _chunkS3JO3N4Hcjs.__name.call(void 0, (targetPath) => targetPath.replace(/\\/g, "/"), "toImportPath");
-  const clientPluginEntry = _chunkSIVK2SRRcjs.generateFarmClientPluginEntryCode.call(void 0, 
+  const clientPluginEntry = _chunkQ5F32A26cjs.generateFarmClientPluginEntryCode.call(void 0, 
     plugins,
     root,
     srcDir,
@@ -3271,7 +3271,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
 import { createRoot, hydrateRoot } from "react-dom/client";` : appSetupPath ? `import React, { createRoot, hydrateRoot, configureApp as __farmConfigureApp } from ${JSON.stringify(renderer.client)};
 import __farmAppSetup from ${JSON.stringify(_chunk5QIKR7RRcjs.toPosixPath.call(void 0, appSetupPath))};
 __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
-  const providerClientCode = _chunkSIVK2SRRcjs.generateFarmIntegrationProviderClientCode.call(void 0, 
+  const providerClientCode = _chunkQ5F32A26cjs.generateFarmIntegrationProviderClientCode.call(void 0, 
     integrationProviders,
     root,
     _nullishCoalesce(renderer.componentExtensions, () => ( []))
@@ -3283,12 +3283,12 @@ __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot
   const hydratingLayoutPatterns = layoutRoutes.filter((layout) => layout.shouldHydrate).map((layout) => layout.pattern);
   layoutRoutes.forEach((layout, index) => {
     const relativePath = toImportPath(layout.modulePath);
-    const rendersOnClient = !layout.hasIsolatedClientBoundaries && hydratingLayoutPatterns.some((pattern) => _chunkKVN3YEFFcjs.layoutsCanCoverSamePage.call(void 0, layout.pattern, pattern));
+    const rendersOnClient = !layout.hasIsolatedClientBoundaries && hydratingLayoutPatterns.some((pattern) => _chunkNFME7OKZcjs.layoutsCanCoverSamePage.call(void 0, layout.pattern, pattern));
     if (rendersOnClient) {
       layoutImportStatements.push(`import Layout${index} from "${relativePath}";`);
     }
-    const groupScope = _chunkUN4B2TXCcjs.getRouteGroupScope.call(void 0, layout.pattern);
-    const groupFields = groupScope ? `, urlPattern: ${JSON.stringify(_chunkUN4B2TXCcjs.stripRouteGroups.call(void 0, layout.pattern))}, groupScope: ${JSON.stringify(groupScope)}` : "";
+    const groupScope = _chunkXIZO5VDAcjs.getRouteGroupScope.call(void 0, layout.pattern);
+    const groupFields = groupScope ? `, urlPattern: ${JSON.stringify(_chunkXIZO5VDAcjs.stripRouteGroups.call(void 0, layout.pattern))}, groupScope: ${JSON.stringify(groupScope)}` : "";
     layoutRegistrations.push(
       `  { pattern: ${JSON.stringify(layout.pattern)}${groupFields}, Component: ${rendersOnClient ? `Layout${index}` : "null"}, shouldHydrate: ${JSON.stringify(layout.shouldHydrate)}, islandStrategy: ${JSON.stringify(layout.islandStrategy)} }`
     );
@@ -3585,7 +3585,7 @@ void farmClientRuntime.start();
 spaRouter.initializeHistory();
 window.__FARM_SPA_ROUTER__ = spaRouter;
 
-void hydrateFarmDocsAdapterRuntime();
+${islandValues ? "void farmDocumentParsed().then(hydrateFarmDocsAdapterRuntime);" : "void hydrateFarmDocsAdapterRuntime();"}
 
 window.addEventListener("beforeunload", function(event) {
   if (spaRouter.shouldBlockUnload()) {
@@ -3791,7 +3791,7 @@ function hasHydratableLayout(pathname) {
   });
 }
 
-${_chunkSIVK2SRRcjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
+${_chunkQ5F32A26cjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
 // Wrap a page element with applicable layouts
 function wrapWithLayouts(pageElement, pathname, params) {
   const layouts = getApplicableLayouts(pathname);
@@ -4123,19 +4123,37 @@ function resetReactRoot() {
   isHydrated = false;
 }
 
-// Hydrate client components
+${islandValues ? `// Islands mode starts the client while the body streams (an async entry): a page of islands
+// hydrates them as they arrive; anything else waits for the whole document.
+function farmDocumentParsed() {
+  if (document.readyState !== "loading") return Promise.resolve();
+  return new Promise(function(resolve) {
+    document.addEventListener("DOMContentLoaded", function() { resolve(); }, { once: true });
+  });
+}
+
+` : ""}// Hydrate client components
 async function hydrate() {
   await window.__FARM_PPR_REFRESH_PROMISE__;
   // A PPR refresh that is still retrying must not replace DOM once hydration starts.
   window.__FARM_PPR_HYDRATING__ = true;
   await farmClientRuntime.start();
 
+  const pathname = window.location.pathname;
+  const matched = matchRoute(pathname);
+  ${islandValues ? `if (
+    !matched ||
+    !matched.route.hasIsolatedClientBoundaries ||
+    matched.route.pageShouldHydrate ||
+    hasHydratableLayout(pathname)
+  ) {
+    await farmDocumentParsed();
+  }` : ""}
+
   if (await hydrateFarmDocsAdapterRuntime()) {
     return;
   }
 
-  const pathname = window.location.pathname;
-  const matched = matchRoute(pathname);
   hydrateInitialRouteSlots();
 
   if (!matched) {
@@ -4938,7 +4956,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   }
   const middlewareRoutes = await discoverMiddlewareRoutes(appDirs);
   const instrumentationPath = _chunkKCMTCM6Icjs.resolveFarmInstrumentationFile.call(void 0, root, config.srcDir || "src");
-  const notFoundPath = _chunkSIVK2SRRcjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
+  const notFoundPath = _chunkQ5F32A26cjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
   if (notFoundPath) _chunk5QIKR7RRcjs.logger.info(`\u{1F4CB} Found custom 404 page: ${notFoundPath}`);
   layoutRoutes.sort((a, b) => {
     const depthA = a.pattern.split("/").filter(Boolean).length;
@@ -4960,7 +4978,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   );
   const hasObservabilityHandler = !!config.observability && typeof config.observability === "object" && "onEvent" in config.observability;
   const hasMdxComponentConfig = Boolean(_optionalChain([config, 'access', _67 => _67.mdx, 'optionalAccess', _68 => _68.components]));
-  const hasMiddlewareConfig = _chunkUN4B2TXCcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
+  const hasMiddlewareConfig = _chunkXIZO5VDAcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
   const hasRouteContextConfig = _chunkLPE3ED4Rcjs.hasCustomFarmRouteContext.call(void 0, config);
   const hasServerRuntimePlugins = hasFarmServerRuntimePlugins(config);
   const hasPluginRoutes = hasFarmPluginRoutes(config);
@@ -5144,7 +5162,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _79 => _79.env, 'optionalAccess', _80 => _80.public]) || {})
       },
       plugins: [
-        _chunkSIVK2SRRcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkQ5F32A26cjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
@@ -5197,7 +5215,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       resolve: {
         alias: [
           ...shouldAliasReactServerToWebBuild(config.renderer, preset) ? [createFarmReactWebServerAlias(hasReactDomEdgeServerBuild(root))] : [],
-          ...Object.entries(_chunkSIVK2SRRcjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
+          ...Object.entries(_chunkQ5F32A26cjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
             ([find, replacement]) => ({ find, replacement })
           )
         ],
@@ -5205,7 +5223,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         dedupe: [...config.renderer.dedupe || []]
       }
     };
-    await viteBuild(_chunkSIVK2SRRcjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
+    await viteBuild(_chunkQ5F32A26cjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
   } finally {
     if (postcssConfigDir) {
       try {
@@ -5253,7 +5271,7 @@ function getFarmDocsGuardedPaths(config, middlewareRoutes) {
     config: { middleware: config.middleware, integrations: config.integrations },
     middlewareRoutes
   };
-  return _chunkMY5PZYADcjs.discoverFarmDocsPages.call(void 0, contentDir, config.docs).flatMap((page) => [page.href, _chunkMY5PZYADcjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunkUN4B2TXCcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
+  return _chunkMY5PZYADcjs.discoverFarmDocsPages.call(void 0, contentDir, config.docs).flatMap((page) => [page.href, _chunkMY5PZYADcjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunkXIZO5VDAcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
 }
 _chunkS3JO3N4Hcjs.__name.call(void 0, getFarmDocsGuardedPaths, "getFarmDocsGuardedPaths");
 function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
@@ -5655,7 +5673,7 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
   const hasGeneratedMetadataImages = metadataImageRoutes.some(
     (image) => image.sourceType === "module"
   );
-  const hasMiddlewareRuntime = middlewareRoutes.length > 0 || _chunkUN4B2TXCcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
+  const hasMiddlewareRuntime = middlewareRoutes.length > 0 || _chunkXIZO5VDAcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
   const farmDocsFontAssets = _optionalChain([config, 'access', _108 => _108.docs, 'optionalAccess', _109 => _109.enabled]) ? _chunkHREOKQWTcjs.toFarmDocsPublicFontAssets.call(void 0, _chunkHREOKQWTcjs.resolveFarmDocsFontAssets.call(void 0, config.root)) : [];
   const integrationProviders = _chunkB6XAA7V6cjs.getIntegrationProviders.call(void 0, config.integrations);
   const renderedIntegrationProviders = integrationProviders.filter(
@@ -5666,7 +5684,7 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
       `Integration provider components are not supported by the "${config.renderer.name}" renderer.`
     );
   }
-  const providerServerModules = _chunkSIVK2SRRcjs.generateFarmIntegrationProviderServerModules.call(void 0, 
+  const providerServerModules = _chunkQ5F32A26cjs.generateFarmIntegrationProviderServerModules.call(void 0, 
     renderedIntegrationProviders,
     config.root,
     _nullishCoalesce(config.renderer.componentExtensions, () => ( []))
@@ -5686,14 +5704,14 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
   const unsupportedIntegrationProvider = renderedIntegrationProviders.find(
     (provider) => provider.supportsIsolatedHydration !== true
   );
-  const isolatedHydrationMode = _chunkSIVK2SRRcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+  const isolatedHydrationMode = _chunkQ5F32A26cjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
     _optionalChain([config, 'access', _112 => _112.experimental, 'optionalAccess', _113 => _113.isolatedClientHydration]),
     {
       serverComponents: _chunkPDU4P2ICcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _114 => _114.experimental, 'optionalAccess', _115 => _115.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const hydrationPlanOptions = _chunkSIVK2SRRcjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const hydrationPlanOptions = _chunkQ5F32A26cjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
@@ -5711,7 +5729,7 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
       hydrationPlanOptions
     )
   }));
-  const markdownPagePlan = _chunkSIVK2SRRcjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkQ5F32A26cjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunkOHY2ZWUGcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunkOHY2ZWUGcjs.resolveMdxConfig.call(void 0, config.mdx), config.root),
     config.root,
     isolatedHydrationMode,
@@ -5729,7 +5747,7 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
       )
     ])
   );
-  _chunkSIVK2SRRcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkQ5F32A26cjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     layoutHydrationPlans.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -5738,10 +5756,10 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
     pageRoutes.map((route) => ({
       // Compared by directory so a grouped layout applies only inside its group.
       pattern: _nullishCoalesce(route.directory, () => ( route.pattern)),
-      depth: _chunkUN4B2TXCcjs.getRouteDirectoryDepth.call(void 0, _nullishCoalesce(route.directory, () => ( route.pattern))),
+      depth: _chunkXIZO5VDAcjs.getRouteDirectoryDepth.call(void 0, _nullishCoalesce(route.directory, () => ( route.pattern))),
       metadata: pageHydrationPlans.get(route.modulePath)
     })),
-    _chunkUN4B2TXCcjs.routeBoundaryCoversDirectory
+    _chunkXIZO5VDAcjs.routeBoundaryCoversDirectory
   );
   const providerServerImports = [
     providerServerModules.hasClerkProvider ? `import { ClerkProvider as FarmClerkProvider } from "@clerk/react";` : "",
@@ -5803,7 +5821,7 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
     module: ${varName},
     shouldHydrate: ${JSON.stringify(clientMetadata.shouldHydrate)},${clientMetadata.shouldHydrate ? `
     clientModule: ${JSON.stringify(_chunk5QIKR7RRcjs.toViteModuleId.call(void 0, route.modulePath, config.root))},` : ""}
-    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkSIVK2SRRcjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
+    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkQ5F32A26cjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
     rendering: ${JSON.stringify(renderingDirective)},` : ""}
     ${route.source !== void 0 ? `markdownSource: {
       source: ${JSON.stringify(route.source)},
@@ -5860,12 +5878,12 @@ function renderFarmRouteServerTree(element, extra) { return element; }`;
     errorImports.push(
       `import * as ${varName} from ${toVirtualEntryImportSpecifier(errorRoute.modulePath)};`
     );
-    const groupScope = _chunkUN4B2TXCcjs.getRouteGroupScope.call(void 0, errorRoute.pattern);
+    const groupScope = _chunkXIZO5VDAcjs.getRouteGroupScope.call(void 0, errorRoute.pattern);
     errorRegistrations.push(`
   {
-    pattern: ${JSON.stringify(_chunkUN4B2TXCcjs.stripRouteGroups.call(void 0, errorRoute.pattern))},${groupScope ? `
+    pattern: ${JSON.stringify(_chunkXIZO5VDAcjs.stripRouteGroups.call(void 0, errorRoute.pattern))},${groupScope ? `
     groupScope: ${JSON.stringify(groupScope)},
-    directoryDepth: ${_chunkUN4B2TXCcjs.getRouteDirectoryDepth.call(void 0, errorRoute.pattern)},` : ""}
+    directoryDepth: ${_chunkXIZO5VDAcjs.getRouteDirectoryDepth.call(void 0, errorRoute.pattern)},` : ""}
     module: ${varName},
   }`);
   });
@@ -6061,7 +6079,7 @@ import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
   const integrationRuntimeImport = integrationRuntimeExports.length ? `import { ${integrationRuntimeExports.join(", ")} } from "@farm.js/core/integrations";` : "";
   const instrumentationImport = instrumentationPath ? `import * as FarmInstrumentationModule from ${toVirtualEntryImportSpecifier(instrumentationPath)};` : "";
   const nativeAuth = generateNativeAuthIntegrationSource(config.auth);
-  const nativeMCP = _chunkKVN3YEFFcjs.generateNativeMCPPluginSource.call(void 0, config.mcp);
+  const nativeMCP = _chunkNFME7OKZcjs.generateNativeMCPPluginSource.call(void 0, config.mcp);
   const integrationImports = `
 ${configModulePath ? `import * as FarmUserConfigModule from ${toVirtualEntryImportSpecifier(configModulePath)};` : ""}
 ${layerConfigImports}
@@ -6069,7 +6087,7 @@ ${integrationRuntimeImport}
 ${nativeAuth.importSource}
 ${nativeMCP.importSource}
 `;
-  const imageRuntime = _chunkSIVK2SRRcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkQ5F32A26cjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
   const imageRuntimeImport = imageRuntime === "none" ? "" : `import { _withFarmImageSourceClientAddress, createCloudflareImageTransformer, createFarmImageHandler } from "@farm.js/core/image/server";`;
   const imageNodeRuntimeImport = imageRuntime === "node" ? `import { createNodeImageFetcher, createNodeImageUrlValidator, createSharpImageTransformer } from "@farm.js/core/image/sharp";` : "";
   const apiHandlerCode = apiRoutes.length > 0 ? `
@@ -6248,7 +6266,7 @@ const farmResolvedRuntimeConfig = Object.assign({}, ...farmRuntimeConfigs);
 
 function FarmDefault404Page() {
   return React.createElement(React.Fragment, null,
-    React.createElement("style", null, ${JSON.stringify(_chunkSIVK2SRRcjs.DEFAULT_NOT_FOUND_STYLES)}),
+    React.createElement("style", null, ${JSON.stringify(_chunkQ5F32A26cjs.DEFAULT_NOT_FOUND_STYLES)}),
     React.createElement("main", {
       className: "farm-default-not-found",
       "aria-labelledby": "farm-default-not-found-title",
@@ -6551,12 +6569,12 @@ function fetchFarmInnerRequest(request, context) {
 }
 const farmLocalAPIBasePath = ${JSON.stringify(_chunkKNBBQHO2cjs.resolveFarmAPIServerBasePath.call(void 0, config.api))};
 const farmOpenAPIReference = ${JSON.stringify(openAPIReference)};
-${_optionalChain([config, 'access', _147 => _147.agent, 'optionalAccess', _148 => _148.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkUN4B2TXCcjs.resolveFarmApiCatalogInput.call(void 0, config))};
+${_optionalChain([config, 'access', _147 => _147.agent, 'optionalAccess', _148 => _148.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkXIZO5VDAcjs.resolveFarmApiCatalogInput.call(void 0, config))};
 ` : ""}${_optionalChain([config, 'access', _149 => _149.agent, 'optionalAccess', _150 => _150.manifest]) !== false ? `const farmAppManifestInput = ${JSON.stringify(
-    _chunkUN4B2TXCcjs.resolveFarmAppManifestInput.call(void 0, config, {
+    _chunkXIZO5VDAcjs.resolveFarmAppManifestInput.call(void 0, config, {
       build: config.deploymentId,
-      packages: _chunkSIVK2SRRcjs.resolveFarmAppPackages.call(void 0, config.root),
-      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkSIVK2SRRcjs.collectFarmWebMCPTools.call(void 0, config.root, config.srcDir) : []
+      packages: _chunkQ5F32A26cjs.resolveFarmAppPackages.call(void 0, config.root),
+      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkQ5F32A26cjs.collectFarmWebMCPTools.call(void 0, config.root, config.srcDir) : []
     })
   )};
 ${servesDefaultMCP ? "farmAppManifestInput.defaultMCP = getFarmDefaultMCPServer;\n" : ""}// A guard written for an MCP server's path keeps its tools out of the public view.
@@ -6678,8 +6696,9 @@ function renderFarmRendererHydrationScript() {
     : "";
 }
 
-function renderFarmClientEntryScript() {
-  return stampFarmCspNonce('<script type="module" src="/__farm_client_js_src__"></script>');
+function renderFarmClientEntryScript(early) {
+  // An early entry runs as soon as it loads, while the body still streams.
+  return stampFarmCspNonce('<script type="module"' + (early ? ' async' : '') + ' src="/__farm_client_js_src__"></script>');
 }
 
 // Renderer options for the response being rendered: its CSP nonce, which the
@@ -7020,6 +7039,73 @@ function createFarmDocumentStream(contentStream, prefix, suffix, onComplete) {
   });
 }
 
+// Streams a layout's own <html> document. React's output is held until the opening <body>, so
+// Farm's head assets go into the document's head (openDocument); the body then streams through.
+// The closing </body></html> React writes with its shell is held back: Suspense content React
+// streams later belongs inside the body, before Farm's footer (closeDocument) and the closing tags.
+function createFarmFullDocumentStream(contentStream, openDocument, closeDocument, onComplete) {
+  const encoder = new TextEncoder();
+  const decoder = new TextDecoder();
+  const reader = contentStream.getReader();
+  // The footer renders after the handler returned, outside its async scope.
+  const cspNonce = _resolveCurrentCspNonce();
+  let opening = "";
+  let opened = false;
+  let rootOpened = false;
+  let closing = false;
+  return new ReadableStream({
+    async pull(controller) {
+      try {
+        for (;;) {
+          const result = await reader.read();
+          let text = result.done ? decoder.decode() : decoder.decode(result.value, { stream: true });
+          if (!opened) {
+            opening += text;
+            if (!result.done && !/<body\\b[^>]*>/i.test(opening)) continue;
+            opened = true;
+            text = opening;
+            opening = "";
+            const closeAt = text.search(/<\\/body>/i);
+            const head = closeAt >= 0 ? text.slice(0, closeAt) : text;
+            const rest = closeAt >= 0 ? text.slice(closeAt) : "";
+            // ensureFarmDocumentRoot opens #root unless the layout's body already does.
+            rootOpened = !/<body\\b[^>]*>\\s*<div\\b[^>]*\\sid=["']root["']/i.test(head);
+            text = openDocument(head) + rest;
+          }
+          if (!closing) {
+            const closeAt = text.search(/<\\/body>/i);
+            if (closeAt >= 0) {
+              closing = true;
+              // Drop the closing tags and Farm's wrapper divs around the document; keep what React
+              // wrote after them.
+              text = text.slice(0, closeAt) +
+                text.slice(closeAt).replace(/^<\\/body>\\s*(?:<\\/html>)?(?:\\s*<\\/div>)*/i, "");
+            }
+          }
+          if (result.done) {
+            const footer = await _runWithFarmCspNonce(cspNonce, function() {
+              return closeDocument(rootOpened);
+            });
+            controller.enqueue(encoder.encode(text + footer + "</body>\\n</html>"));
+            if (onComplete) onComplete();
+            controller.close();
+            return;
+          }
+          if (text) {
+            controller.enqueue(encoder.encode(text));
+            return;
+          }
+        }
+      } catch (error) {
+        controller.error(error);
+      }
+    },
+    cancel(reason) {
+      return reader.cancel(reason);
+    },
+  });
+}
+
 function stripFarmDocumentWrappers(markup) {
   return peelFarmDocumentPrefix(markup).inner;
 }
@@ -7031,7 +7117,7 @@ function peelFarmDocumentPrefix(markup) {
   let inner = markup.replace(/^\\s+/, "");
   let hoisted = "";
   const wrapper = /^<div\\b[^>]*style=["']display\\s*:\\s*contents;?\\s*["'][^>]*>/i;
-  const hoistable = /${_chunkUN4B2TXCcjs.HOISTED_HEAD_ELEMENT.source}/i;
+  const hoistable = /${_chunkXIZO5VDAcjs.HOISTED_HEAD_ELEMENT.source}/i;
   let match;
   while ((match = wrapper.exec(inner) || hoistable.exec(inner))) {
     if (!/^<div/i.test(match[0])) hoisted += match[0];
@@ -7562,7 +7648,7 @@ function createFarmAgentRobotsResponse(request) {
 // a route guard.
 const farmAgentGuardedPages = new Set(${JSON.stringify(
     pageRoutes.map((route) => route.pattern).filter(
-      (pattern) => !pattern.includes("[") && _chunkUN4B2TXCcjs.farmPathGuardCoversPage.call(void 0, 
+      (pattern) => !pattern.includes("[") && _chunkXIZO5VDAcjs.farmPathGuardCoversPage.call(void 0, 
         {
           config: { middleware: config.middleware, integrations: config.integrations },
           middlewareRoutes
@@ -7609,7 +7695,7 @@ ${servesDefaultMCP ? `// agent.mcp: the default read-only MCP server at /mcp, as
 // aside for a page route that answers /mcp and for any MCP server published or
 // registered at runtime, such as the docs engine's.
 const farmDefaultMCPServer = ${JSON.stringify(
-    _chunkBMOBTMDRcjs.createFarmDefaultMCPServer.call(void 0, readFarmAppPackageIdentity(config.root), _chunk2DZOABRKcjs.FARM_VERSION)
+    _chunkBMOBTMDRcjs.createFarmDefaultMCPServer.call(void 0, readFarmAppPackageIdentity(config.root), _chunkOF4TXHM4cjs.FARM_VERSION)
   )};
 let farmDefaultMCPRouteFree;
 function getFarmDefaultMCPServer() {
@@ -8646,7 +8732,7 @@ ${hasServerRuntimeIntegrations ? `
   // agent.manifest: /.well-known/farmjs.json (and 0.1.34's /.well-known/farmjs), the app's
   // public manifest, the same document for every request.
   if (
-    [${JSON.stringify(_chunkUN4B2TXCcjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkUN4B2TXCcjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
+    [${JSON.stringify(_chunkXIZO5VDAcjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkXIZO5VDAcjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
       normalizeRuntimePath(routePathname),
     )
   ) {
@@ -8658,7 +8744,7 @@ ${hasServerRuntimeIntegrations ? `
   ` : ""}
   ${_optionalChain([config, 'access', _167 => _167.agent, 'optionalAccess', _168 => _168.apiCatalog]) ? `
   // agent.apiCatalog: list the OpenAPI and MCP surfaces at the RFC 9727 path.
-  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkUN4B2TXCcjs.FARM_API_CATALOG_PATH)}) {
+  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkXIZO5VDAcjs.FARM_API_CATALOG_PATH)}) {
     return applyProductionMiddlewareHeaders(
       createFarmApiCatalogResponse(request.method, farmApiCatalogInput, request),
       middlewareHeaders,
@@ -9306,15 +9392,60 @@ ${hasServerRuntimeIntegrations ? `
         const initialHtml = html !== undefined ? html : renderedPage.shellHtml || "";
         const hasFullDocument = opensFarmFullDocument(initialHtml);
 
-        // Stream a suspended body as soon as React's shell is ready. Full-document
-        // layouts, localized documents, and cacheable PPR shells still use the
-        // buffered path because they require whole-document transformation, and so
-        // does the anonymous check behind a page's Markdown source: there, a
-        // redirect() under a loading boundary must still decide the status.
+        const rendererHead = renderedPage.head || "";
+        const rendererHasTitle = /<title[\\s>]/i.test(rendererHead);
+        // First <title> wins: the fallback framework title yields to a
+        // renderer-emitted one; explicit metadata titles still come first.
+        const suppressDefaultTitle =
+          !renderedMetadata.hasExplicitTitle && rendererHasTitle;
+        // A layout's own <html> document with Farm's head assets merged in and the #root the client
+        // hydrates opening its body: the whole document, or a streamed one's opening.
+        const composeFarmFullDocument = function(markup) {
+          let composed = addFarmFallbackIcon(
+            ensureFarmDocumentRoot(ensureFarmDocumentHead(markup)),
+            hasFavicon,
+          );
+          composed = composed
+            // Inject CSS link after opening head tag or first meta tag
+            .replace(/<head([^>]*)>/i, function(match, attrs) { return '<head' + attrs + '>\\n  <link rel="stylesheet" href="/__farm_client_css_href__">' + renderFarmClientModulePreloads(composed, route.clientModule); })
+            .replace(/<\\/head>/i, () => renderFarmRendererHydrationScript() + '\\n</head>')
+            // Explicit metadata wins over renderer and layout titles. Without
+            // explicit metadata, a renderer title wins over the layout title.
+            .replace(/<head([^>]*)>([\\s\\S]*?)<\\/head>/i, (match, attrs, headContent) => {
+              const hasAuthoritativeTitle = renderedMetadata.hasExplicitTitle || rendererHasTitle;
+              let nextHeadContent = hasAuthoritativeTitle
+                ? headContent.replace(/<title\\b[^>]*>[\\s\\S]*?<\\/title>\\s*/gi, "")
+                : headContent;
+              if (renderedMetadata.hasExplicitTitle) {
+                nextHeadContent += "\\n  <title>" + title + "</title>";
+              }
+              if (metaTags) nextHeadContent += metaTags;
+              // Renderer-emitted head markup (e.g. <svelte:head>). Function
+              // replacement below keeps $-sequences literal.
+              const effectiveRendererHead = renderedMetadata.hasExplicitTitle
+                ? rendererHead.replace(/<title\\b[^>]*>[\\s\\S]*?<\\/title>\\s*/gi, "")
+                : rendererHead;
+              if (effectiveRendererHead) nextHeadContent += "\\n  " + effectiveRendererHead;
+              return nextHeadContent === headContent
+                ? match
+                : "<head" + attrs + ">" + nextHeadContent + "\\n</head>";
+            });
+          // Last, so the charset (and the viewport, unless the layout wrote one) open the head.
+          composed = ensureFarmDocumentMeta(composed, viewportTags);
+          if (!composed.trim().startsWith('<!DOCTYPE')) {
+            composed = '<!DOCTYPE html>\\n' + composed;
+          }
+          return composed;
+        };
+
+        // Stream a suspended body as soon as React's shell is ready, a layout's own <html> document
+        // included. Localized documents and cacheable PPR shells still use the buffered path
+        // because they require whole-document transformation, and so does the anonymous check
+        // behind a page's Markdown source: there, a redirect() under a loading boundary must still
+        // decide the status.
         if (
           pageStatus === 200 &&
           renderedPage.stream &&
-          !hasFullDocument &&
           !farmI18nSnapshot &&
           !pprCacheKey &&
           !_isFarmMarkdownPageCheck(request.headers.get(FARM_MARKDOWN_PAGE_CHECK_HEADER))
@@ -9324,6 +9455,18 @@ ${hasServerRuntimeIntegrations ? `
             farmResolvedRuntimeConfig.basePath,
             getFarmTheme(request)
           );
+          // The page's client data and entry. Islands mode starts the client while the body streams
+          // (an async entry right after <body>), so islands that arrive early hydrate before slow
+          // Suspense content resolves; other modes keep them at the end.
+          const farmClientScripts = function(early) {
+            return '  ' + renderFarmClientBootstrapScript(
+              pageProps.__farmCanonicalPath,
+              routeSlotPayload,
+              clientPageProps
+            ) + '\\n' +
+              '  ' + renderFarmClientEntryScript(early) + '\\n';
+          };
+          const farmEarlyClientScripts = ${farmIslandsMode ? "farmClientScripts(true)" : '""'};
           const streamPrefix = '<!DOCTYPE html>\\n<html lang="en">\\n<head>\\n' +
             farmThemeDocument.head + '\\n' +
             '  <meta charset="utf-8">\\n' +
@@ -9333,33 +9476,25 @@ ${hasServerRuntimeIntegrations ? `
             '  <link rel="stylesheet" href="/__farm_client_css_href__">\\n' +
             '  <link rel="modulepreload" href="/__farm_client_js_src__">' + renderFarmClientModulePreloads(null, route.clientModule) + '\\n' +
             renderFarmRendererHydrationScript() + '\\n' +
-            '</head>\\n<body>\\n  <div id="root">';
+            '</head>\\n<body>\\n' + farmEarlyClientScripts + '  <div id="root">';
           const streamSuffix = '</div>\\n' +
-            '  ' + renderFarmClientBootstrapScript(
-              pageProps.__farmCanonicalPath,
-              routeSlotPayload,
-              clientPageProps
-            ) + '\\n' +
-            '  ' + renderFarmClientEntryScript() + '\\n' +
+            (farmEarlyClientScripts ? '' : farmClientScripts()) +
             '</body>\\n</html>';
           const themedStreamPrefix = streamPrefix.replace(
             '<html lang="en">',
             () => '<html lang="en"' + farmThemeDocument.attributes + '>'
           );
-          const streamedDocument = createFarmDocumentStream(
-            renderedPage.stream,
-            themedStreamPrefix,
-            async function() {
+          const lateNavigationRecovery = async function() {
               // A redirect()/notFound() after the 200 shell went out can only
               // be recovered in the document.
               const lateNavigationError = renderedPage.streamErrors.find(function(error) {
                 return isFarmRedirectError(error) || isFarmNotFoundError(error);
               });
-              if (!lateNavigationError) return streamSuffix;
+              if (!lateNavigationError) return "";
               if (isFarmRedirectError(lateNavigationError)) {
                 return createLateRedirectRecovery(
                   getFarmRedirectError(lateNavigationError).url
-                ) + streamSuffix;
+                );
               }
               try {
                 return createLateNotFoundRecovery(
@@ -9367,7 +9502,7 @@ ${hasServerRuntimeIntegrations ? `
                     wrapWithFarmIntegrationProviders(createFarmNotFoundElement(pathname)),
                     getFarmRendererRenderOptions()
                   )
-                ) + streamSuffix;
+                );
               } catch (error) {
                 // The layouts are already in the shell; a not-found page that
                 // needs their context cannot render alone, so use Farm's.
@@ -9377,10 +9512,10 @@ ${hasServerRuntimeIntegrations ? `
                     React.createElement(FarmDefault404Page),
                     getFarmRendererRenderOptions()
                   )
-                ) + streamSuffix;
+                );
               }
-            },
-            function() {
+            };
+          const onStreamComplete = function() {
               if (pprBypassReason === "refresh") {
                 emitFarmEvent({
                   type: "ppr.refresh.complete",
@@ -9395,8 +9530,43 @@ ${hasServerRuntimeIntegrations ? `
                 status: pageStatus,
                 durationMs: Date.now() - requestStartTime,
               });
-            }
-          );
+            };
+          const streamedDocument = hasFullDocument
+            ? createFarmFullDocumentStream(
+                renderedPage.stream,
+                function(opening) {
+                  // Farm's wrappers and the head elements React hoisted ahead of the layout's <html>.
+                  const peeled = peelFarmDocumentPrefix(opening);
+                  const start = opening.search(/<!doctype|<html[\\s>]/i);
+                  return applyFarmThemeDocument(
+                    composeFarmFullDocument(
+                      restoreFarmHoistedHead(opening.slice(Math.max(start, 0)), peeled.hoisted)
+                    // The client entry arrives last: fetch it while the body streams.
+                    ).replace(/<\\/head>/i, function() {
+                      return '  <link rel="modulepreload" href="/__farm_client_js_src__">\\n</head>';
+                    }).replace(/<body\\b[^>]*>/i, function(open) {
+                      return open + (farmEarlyClientScripts ? '\\n' + farmEarlyClientScripts : '');
+                    }),
+                    farmThemeConfig,
+                    farmResolvedRuntimeConfig.basePath,
+                    getFarmTheme(request)
+                  );
+                },
+                async function(rootOpened) {
+                  return (await lateNavigationRecovery()) +
+                    (rootOpened ? '</div>\\n' : '') +
+                    (farmEarlyClientScripts ? '' : farmClientScripts());
+                },
+                onStreamComplete
+              )
+            : createFarmDocumentStream(
+                renderedPage.stream,
+                themedStreamPrefix,
+                async function() {
+                  return (await lateNavigationRecovery()) + streamSuffix;
+                },
+                onStreamComplete
+              );
           return applyProductionMiddlewareHeaders(farmOwnedResponse(streamedDocument, {
             status: pageStatus,
             headers: { ...responseHeaders, "x-farm-preload-streaming": "1" },
@@ -9410,44 +9580,10 @@ ${hasServerRuntimeIntegrations ? `
           }
         }
         
-        const rendererHead = renderedPage.head || "";
-        const rendererHasTitle = /<title[\\s>]/i.test(rendererHead);
-        // First <title> wins: the fallback framework title yields to a
-        // renderer-emitted one; explicit metadata titles still come first.
-        const suppressDefaultTitle =
-          !renderedMetadata.hasExplicitTitle && rendererHasTitle;
         let fullHtml;
         if (hasFullDocument) {
           // Layout provides full HTML structure - inject CSS and client script
-          html = addFarmFallbackIcon(
-            ensureFarmDocumentRoot(ensureFarmDocumentHead(extractFarmFullDocument(html) || html)),
-            hasFavicon,
-          );
-          fullHtml = html
-            // Inject CSS link after opening head tag or first meta tag
-            .replace(/<head([^>]*)>/i, function(match, attrs) { return '<head' + attrs + '>\\n  <link rel="stylesheet" href="/__farm_client_css_href__">' + renderFarmClientModulePreloads(html, route.clientModule); })
-            .replace(/<\\/head>/i, () => renderFarmRendererHydrationScript() + '\\n</head>')
-            // Explicit metadata wins over renderer and layout titles. Without
-            // explicit metadata, a renderer title wins over the layout title.
-            .replace(/<head([^>]*)>([\\s\\S]*?)<\\/head>/i, (match, attrs, headContent) => {
-              const hasAuthoritativeTitle = renderedMetadata.hasExplicitTitle || rendererHasTitle;
-              let nextHeadContent = hasAuthoritativeTitle
-                ? headContent.replace(/<title\\b[^>]*>[\\s\\S]*?<\\/title>\\s*/gi, "")
-                : headContent;
-              if (renderedMetadata.hasExplicitTitle) {
-                nextHeadContent += "\\n  <title>" + title + "</title>";
-              }
-              if (metaTags) nextHeadContent += metaTags;
-              // Renderer-emitted head markup (e.g. <svelte:head>). Function
-              // replacement below keeps $-sequences literal.
-              const effectiveRendererHead = renderedMetadata.hasExplicitTitle
-                ? rendererHead.replace(/<title\\b[^>]*>[\\s\\S]*?<\\/title>\\s*/gi, "")
-                : rendererHead;
-              if (effectiveRendererHead) nextHeadContent += "\\n  " + effectiveRendererHead;
-              return nextHeadContent === headContent
-                ? match
-                : "<head" + attrs + ">" + nextHeadContent + "\\n</head>";
-            })
+          fullHtml = composeFarmFullDocument(extractFarmFullDocument(html) || html)
             // Inject client script before closing body tag. Function replacement:
             // serialized page props may contain $-sequences ($&, $', $$) that a
             // string replacement would expand into surrounding document markup,
@@ -9461,14 +9597,6 @@ ${hasServerRuntimeIntegrations ? `
               ) + '\\n' +
                 '  ' + renderFarmClientEntryScript() + '\\n</body>',
             );
-          
-          // Last, so the charset (and the viewport, unless the layout wrote one) open the head.
-          fullHtml = ensureFarmDocumentMeta(fullHtml, viewportTags);
-
-          // Add DOCTYPE if not present
-          if (!fullHtml.trim().startsWith('<!DOCTYPE')) {
-            fullHtml = '<!DOCTYPE html>\\n' + fullHtml;
-          }
         } else {
           // No layout with full document - wrap in HTML structure
           fullHtml = \`<!DOCTYPE html>
@@ -10109,8 +10237,8 @@ function getPhysicalPrerenderBypassReason(options) {
   if (rewriteSources.some((source) => middlewarePatternMatches(source, pathname))) {
     return "rewrite";
   }
-  if (_chunkUN4B2TXCcjs.appMiddlewareMayHandlePath.call(void 0, middlewareRoutes, pathname)) return "app middleware";
-  if (_chunkUN4B2TXCcjs.configMiddlewareMayHandlePath.call(void 0, config.middleware, pathname)) return "configured middleware";
+  if (_chunkXIZO5VDAcjs.appMiddlewareMayHandlePath.call(void 0, middlewareRoutes, pathname)) return "app middleware";
+  if (_chunkXIZO5VDAcjs.configMiddlewareMayHandlePath.call(void 0, config.middleware, pathname)) return "configured middleware";
   if (_chunkLPE3ED4Rcjs.hasCustomFarmRouteContext.call(void 0, config)) return "request context";
   if (farmServerRuntimePluginsMayHandlePath(config, pathname)) return "server runtime plugin";
   const manifestEntry = getManifestPageEntry(routeRuntimeManifest, pathname);
@@ -10149,7 +10277,7 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const outputDir = _chunkLPE3ED4Rcjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
   const runtimeServerOutputDir = isVercel ? _path2.default.join(outputDir, "functions", "__nitro.func") : _path2.default.join(outputDir, "server");
   const ssrOutputDir = _path2.default.join(root, distDir, "ssr");
-  const imageRuntime = _chunkSIVK2SRRcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkQ5F32A26cjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
   );
@@ -11011,7 +11139,7 @@ async function stageSharpRuntime(config, root, distDir, fs4, preset) {
   try {
     await copyPackage("sharp", sharpRequire);
     if (!copiedPackages.has("sharp")) {
-      throw new Error(`Farm image optimization requires sharp. ${_chunkSIVK2SRRcjs.SHARP_INSTALL_HINT}`);
+      throw new Error(`Farm image optimization requires sharp. ${_chunkQ5F32A26cjs.SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
     await fs4.rm(stageDir, { recursive: true, force: true });
@@ -11312,7 +11440,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     };
     config = {
       ...config,
-      images: _chunkSIVK2SRRcjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
+      images: _chunkQ5F32A26cjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
         root: targets.root,
         preset: targets.preset
       })
@@ -11340,7 +11468,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
       root,
       rendererBuild.signal
     );
-    const farmApp = _chunkSIVK2SRRcjs.createFarmApp.call(void 0, config, projectModuleServer);
+    const farmApp = _chunkQ5F32A26cjs.createFarmApp.call(void 0, config, projectModuleServer);
     await farmApp.initialize();
     const routeManager = farmApp.getRouteManager();
     const serverRenderer = farmApp.getServerRenderer();
@@ -11447,7 +11575,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
     ssr: true,
     buildLifetime
   });
-  const viteConfig = _chunkSIVK2SRRcjs.mergeFarmViteConfig.call(void 0, 
+  const viteConfig = _chunkQ5F32A26cjs.mergeFarmViteConfig.call(void 0, 
     {
       root,
       appType: "custom",
@@ -11459,7 +11587,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
       },
       plugins: [
         ...rendererVitePlugins,
-        _chunkSIVK2SRRcjs.farmFontImportsPlugin.call(void 0, {
+        _chunkQ5F32A26cjs.farmFontImportsPlugin.call(void 0, {
           root,
           basePath: config.basePath,
           publicDir: config.publicDir
@@ -11471,7 +11599,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
         hmr: false
       },
       resolve: {
-        alias: _chunkSIVK2SRRcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkQ5F32A26cjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       optimizeDeps: {