@farm.js/core 0.1.48 → 0.1.49

package/dist/{chunk-YSPMY4B7.cjs → chunk-C5S457CK.cjs}

@@ -28,10 +28,12 @@ var _chunkPEHL3IZLcjs = require('./chunk-PEHL3IZL.cjs');
 
 
 
-var _chunkC2R5RVLAcjs = require('./chunk-C2R5RVLA.cjs');
 
 
-var _chunkZGS3ZDF7cjs = require('./chunk-ZGS3ZDF7.cjs');
+var _chunkVCKGOXFIcjs = require('./chunk-VCKGOXFI.cjs');
+
+
+var _chunkNPPT4RWFcjs = require('./chunk-NPPT4RWF.cjs');
 
 
 
@@ -248,7 +250,7 @@ var _chunkJYT7AN37cjs = require('./chunk-JYT7AN37.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkJLS6ZLFMcjs = require('./chunk-JLS6ZLFM.cjs');
+var _chunkJ5VCA45Kcjs = require('./chunk-J5VCA45K.cjs');
 
 
 
@@ -1919,8 +1921,8 @@ var RouteManager = class {
       )
     );
     this.orderedLayouts = Array.from(this.layouts.values()).sort(
-      (left, right) => _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, left.pattern) - _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, right.pattern)
-    ).map((entry) => ({ entry, groupScope: _chunkC2R5RVLAcjs.getRouteGroupScope.call(void 0, entry.pattern) }));
+      (left, right) => _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, left.pattern) - _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, right.pattern)
+    ).map((entry) => ({ entry, groupScope: _chunkVCKGOXFIcjs.getRouteGroupScope.call(void 0, entry.pattern) }));
     for (const slot of this.routeSlots.values()) {
       if (!this.routeSlotOwnerSegments.has(slot.ownerPattern)) {
         this.routeSlotOwnerSegments.set(
@@ -2232,15 +2234,15 @@ var RouteManager = class {
     enforceFarmIsolatedHydrationRouteBudget(
       layoutEntries.map(({ entry, metadata }) => ({
         pattern: entry.pattern,
-        depth: _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, entry.pattern),
+        depth: _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, entry.pattern),
         metadata
       })),
       routeEntries.map(({ entry, metadata }) => ({
         pattern: getRouteEntryDirectory(entry),
-        depth: _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, getRouteEntryDirectory(entry)),
+        depth: _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, getRouteEntryDirectory(entry)),
         metadata
       })),
-      _chunkC2R5RVLAcjs.routeBoundaryCoversDirectory
+      _chunkVCKGOXFIcjs.routeBoundaryCoversDirectory
     );
     for (const { entry, metadata } of [...layoutEntries, ...routeEntries]) {
       if (!metadata.costGuardExceeded) continue;
@@ -2259,7 +2261,7 @@ var RouteManager = class {
     const routes = routeEntries.map(({ entry, metadata }) => {
       const programmaticPage = this.programmaticPages.get(entry.modulePath);
       const layoutShouldHydrate = layoutEntries.some(
-        ({ entry: layout, metadata: layoutMetadata }) => layoutMetadata.shouldHydrate && _chunkC2R5RVLAcjs.routeBoundaryCoversDirectory.call(void 0, layout.pattern, getRouteEntryDirectory(entry))
+        ({ entry: layout, metadata: layoutMetadata }) => layoutMetadata.shouldHydrate && _chunkVCKGOXFIcjs.routeBoundaryCoversDirectory.call(void 0, layout.pattern, getRouteEntryDirectory(entry))
       );
       return {
         pattern: entry.pattern,
@@ -2276,7 +2278,7 @@ var RouteManager = class {
           }))
         } : {},
         ...usesFarmServerTree(metadata) ? { serverTree: true } : {},
-        renderPlan: _chunkC2R5RVLAcjs.createFarmRouteRenderPlan.call(void 0, {
+        renderPlan: _chunkVCKGOXFIcjs.createFarmRouteRenderPlan.call(void 0, {
           pageShouldHydrate: metadata.shouldHydrate,
           layoutShouldHydrate,
           islandStrategy: metadata.islandStrategy
@@ -2292,7 +2294,7 @@ var RouteManager = class {
         }))
       };
     });
-    const treeLayoutPatterns = islandsMode ? _chunkC2R5RVLAcjs.getFarmServerTreeLayoutPatterns.call(void 0, 
+    const treeLayoutPatterns = islandsMode ? _chunkVCKGOXFIcjs.getFarmServerTreeLayoutPatterns.call(void 0, 
       layoutEntries.map(({ entry, metadata }) => ({
         pattern: entry.pattern,
         shouldHydrate: metadata.shouldHydrate,
@@ -2471,7 +2473,7 @@ var RouteManager = class {
    */
   createRoutePattern(route) {
     if (route.segments.length === 0) return "/";
-    return "/" + route.segments.map(_chunkC2R5RVLAcjs.formatRouteSegment).join("/");
+    return "/" + route.segments.map(_chunkVCKGOXFIcjs.formatRouteSegment).join("/");
   }
   registerPageRoute(entry) {
     _chunkYTVSWXEZcjs.assertUniqueRouteParameters.call(void 0, entry.pattern);
@@ -2565,7 +2567,7 @@ var RouteManager = class {
       for (const file of files) {
         const route = _chunkXN2MB4QZcjs.parseRoutePath.call(void 0, file);
         const modulePath = path4.default.join(appDir, file);
-        const pattern = _chunkC2R5RVLAcjs.createRouteDirectoryPattern.call(void 0, route);
+        const pattern = _chunkVCKGOXFIcjs.createRouteDirectoryPattern.call(void 0, route);
         const existing = target.get(pattern);
         if (_optionalChain([existing, 'optionalAccess', _136 => _136.sourceRoot]) === source.root) {
           throw new Error(
@@ -2587,7 +2589,7 @@ var RouteManager = class {
       const modulePath = path4.default.join(appDir, file);
       const pattern = this.createRoutePattern(slot.route);
       const ownerPattern = this.createRoutePattern(slot.ownerRoute);
-      const ownerDirectory = _chunkC2R5RVLAcjs.createRouteDirectoryPattern.call(void 0, slot.ownerRoute);
+      const ownerDirectory = _chunkVCKGOXFIcjs.createRouteDirectoryPattern.call(void 0, slot.ownerRoute);
       const key = `${ownerPattern}:${slot.name}:${slot.interception ? "intercept" : "slot"}:${slot.fallback ? "default" : pattern}`;
       const existing = this.routeSlots.get(key);
       if (_optionalChain([existing, 'optionalAccess', _137 => _137.sourceRoot]) === source.root) {
@@ -2704,7 +2706,7 @@ var RouteManager = class {
         }
         if (definition.kind === "layout") {
           const route = _chunkE7QOEV5Zcjs.parseProgrammaticRoutePath.call(void 0, definition.path, "layout");
-          const pattern = _chunkC2R5RVLAcjs.createRouteDirectoryPattern.call(void 0, route);
+          const pattern = _chunkVCKGOXFIcjs.createRouteDirectoryPattern.call(void 0, route);
           const existing = this.layouts.get(pattern);
           if (_optionalChain([existing, 'optionalAccess', _141 => _141.sourceRoot]) === source.root) {
             throw new Error(
@@ -2751,7 +2753,7 @@ var RouteManager = class {
     const matchingLayouts = [];
     for (const { entry, groupScope } of this.orderedLayouts) {
       if (!_chunkXN2MB4QZcjs.matchRoutePrefixParts.call(void 0, pathnameParts, entry.route.segments)) continue;
-      if (groupScope !== null && !_chunkC2R5RVLAcjs.isInRouteGroupScope.call(void 0, route && getRouteEntryDirectory(route), groupScope)) {
+      if (groupScope !== null && !_chunkVCKGOXFIcjs.isInRouteGroupScope.call(void 0, route && getRouteEntryDirectory(route), groupScope)) {
         continue;
       }
       matchingLayouts.push(entry);
@@ -2832,14 +2834,14 @@ var RouteManager = class {
     let page = route;
     for (const boundaryEntry of boundaries.values()) {
       if (!_chunkXN2MB4QZcjs.matchRoutePrefix.call(void 0, normalizedPath, boundaryEntry.route.segments)) continue;
-      const groupScope = _chunkC2R5RVLAcjs.getRouteGroupScope.call(void 0, boundaryEntry.pattern);
+      const groupScope = _chunkVCKGOXFIcjs.getRouteGroupScope.call(void 0, boundaryEntry.pattern);
       if (groupScope !== null) {
         if (page === void 0) page = this.matchPageRoute(_chunkXN2MB4QZcjs.splitRoutePath.call(void 0, normalizedPath));
-        if (!_chunkC2R5RVLAcjs.isInRouteGroupScope.call(void 0, page && getRouteEntryDirectory(page), groupScope)) continue;
+        if (!_chunkVCKGOXFIcjs.isInRouteGroupScope.call(void 0, page && getRouteEntryDirectory(page), groupScope)) continue;
       }
       const depth = boundaryEntry.route.segments.length;
       const bestDepth = _nullishCoalesce(_optionalChain([bestMatch, 'optionalAccess', _145 => _145.route, 'access', _146 => _146.segments, 'access', _147 => _147.length]), () => ( -1));
-      if (!bestMatch || depth > bestDepth || depth === bestDepth && _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, boundaryEntry.pattern) > _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, bestMatch.pattern)) {
+      if (!bestMatch || depth > bestDepth || depth === bestDepth && _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, boundaryEntry.pattern) > _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, bestMatch.pattern)) {
         bestMatch = boundaryEntry;
       }
     }
@@ -2953,7 +2955,7 @@ var RouteManager = class {
   }
 };
 function getPageDirectoryField(route, pattern) {
-  const directory = _chunkC2R5RVLAcjs.createRouteDirectoryPattern.call(void 0, route);
+  const directory = _chunkVCKGOXFIcjs.createRouteDirectoryPattern.call(void 0, route);
   return directory === pattern ? {} : { directory };
 }
 function interpolateRedirectDestination(destination, params) {
@@ -4552,7 +4554,7 @@ function appendResponseVary(res, value) {
 function renderI18nAlternateLinks(requestPath, snapshot, options) {
   if (snapshot.routing === "none") return "";
   const url = new URL(requestPath, "http://farm.local");
-  return _chunkC2R5RVLAcjs.renderFarmLocaleAlternateLinks.call(void 0, url.pathname, snapshot, options);
+  return _chunkVCKGOXFIcjs.renderFarmLocaleAlternateLinks.call(void 0, url.pathname, snapshot, options);
 }
 var PPR_REFRESH_MAX_ATTEMPTS = 3;
 function createPPRRefreshScript() {
@@ -4568,7 +4570,7 @@ function rendererRenderOptions() {
 }
 var FARM_DEV_EARLY_CLIENT_SCRIPT = `<script type="module" async src="/@farm/client.js"></script>`;
 function createDocumentFooter(options) {
-  return `</div>
+  return `${options.closeRoot === false ? "" : "</div>"}
   ${options.suspenseRevealFallback}
   ${options.refreshPPR ? createPPRRefreshScript() : ""}
   ${options.deferredHydrationScript || ""}
@@ -5882,7 +5884,7 @@ var ServerRenderer = class {
         }
       }
       _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, { type: "render.error", route: pathname, error });
-      const errorStatus = _chunkC2R5RVLAcjs.resolveDefaultErrorStatus.call(void 0, error);
+      const errorStatus = _chunkVCKGOXFIcjs.resolveDefaultErrorStatus.call(void 0, error);
       if (pprRefreshRoute) {
         _chunkEVIWKPJVcjs.emitFarmEvent.call(void 0, {
           type: "ppr.refresh.error",
@@ -6110,7 +6112,7 @@ var ServerRenderer = class {
         origin: url.origin,
         readMarkdown: llmsContext.markdown
       }) : value;
-      const response = _chunkC2R5RVLAcjs.createFarmMetadataRouteResponse.call(void 0, match.metadata.kind, body, routeModule, {
+      const response = _chunkVCKGOXFIcjs.createFarmMetadataRouteResponse.call(void 0, match.metadata.kind, body, routeModule, {
         method,
         request: request2
       });
@@ -6146,7 +6148,7 @@ var ServerRenderer = class {
       }) : context.defaults;
       await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, 
         res,
-        _chunkC2R5RVLAcjs.createFarmMetadataRouteResponse.call(void 0, 
+        _chunkVCKGOXFIcjs.createFarmMetadataRouteResponse.call(void 0, 
           kind,
           body,
           { revalidate: config.revalidate },
@@ -6181,7 +6183,7 @@ var ServerRenderer = class {
       });
       await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, 
         res,
-        _chunkC2R5RVLAcjs.createFarmMetadataRouteResponse.call(void 0, "robots", robots, {}, { method: req.method })
+        _chunkVCKGOXFIcjs.createFarmMetadataRouteResponse.call(void 0, "robots", robots, {}, { method: req.method })
       );
     } catch (error) {
       _chunkXN2MB4QZcjs.logger.error(`Generated robots.txt failed: ${error}`);
@@ -6225,7 +6227,7 @@ var ServerRenderer = class {
       });
       await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, 
         res,
-        _chunkC2R5RVLAcjs.createFarmMetadataRouteResponse.call(void 0, "sitemap", sitemap, {}, { method: req.method })
+        _chunkVCKGOXFIcjs.createFarmMetadataRouteResponse.call(void 0, "sitemap", sitemap, {}, { method: req.method })
       );
     } catch (error) {
       _chunkXN2MB4QZcjs.logger.error(`Generated sitemap.xml failed: ${error}`);
@@ -6254,7 +6256,7 @@ var ServerRenderer = class {
   getAgentListedRoutes() {
     const guards = { config: this.config, middlewareRoutes: _nullishCoalesce(_optionalChain([this, 'access', _253 => _253.middlewareRoutes, 'optionalCall', _254 => _254()]), () => ( [])) };
     return [...this.routeManager.getRoutes()].filter(
-      ([pattern]) => !pattern.includes("[") && !_chunkC2R5RVLAcjs.farmPathGuardCoversPage.call(void 0, guards, pattern)
+      ([pattern]) => !pattern.includes("[") && !_chunkVCKGOXFIcjs.farmPathGuardCoversPage.call(void 0, guards, pattern)
     );
   }
   /**
@@ -6268,7 +6270,7 @@ var ServerRenderer = class {
     if (this.routeManager.matchRoute(_chunkSBABQKPTcjs.FARM_DEFAULT_MCP_PATH).route) return void 0;
     _nullishCoalesce(this.defaultMCPServer, () => ( (this.defaultMCPServer = _chunkSBABQKPTcjs.createFarmDefaultMCPServer.call(void 0, 
       readAppPackageIdentity(this.config.root),
-      _chunkJLS6ZLFMcjs.FARM_VERSION
+      _chunkJ5VCA45Kcjs.FARM_VERSION
     ))));
     return _chunkSBABQKPTcjs.resolveFarmDefaultMCPServer.call(void 0, this.defaultMCPServer);
   }
@@ -6350,7 +6352,7 @@ var ServerRenderer = class {
         pages,
         config,
         rootMetadata,
-        mcp: _optionalChain([this, 'access', _266 => _266.config, 'access', _267 => _267.agent, 'optionalAccess', _268 => _268.aiCatalog]) === false ? [] : _chunkZGS3ZDF7cjs.listFarmMCPLlmsTxtLinks.call(void 0, origin, {
+        mcp: _optionalChain([this, 'access', _266 => _266.config, 'access', _267 => _267.agent, 'optionalAccess', _268 => _268.aiCatalog]) === false ? [] : _chunkNPPT4RWFcjs.listFarmMCPLlmsTxtLinks.call(void 0, origin, {
           basePath: this.config.basePath,
           apiServerBasePath: _chunkB5BBTPJQcjs.resolveFarmAPIServerBasePath.call(void 0, 
             _chunkIWFV5ZEDcjs.normalizeFarmAPIConfig.call(void 0, 
@@ -6652,19 +6654,19 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
         i18nSnapshot,
         this.getI18nAlternateOptions(req, req.__FARM_METADATA__)
       ) : "";
-      const themeDocument = _chunkC2R5RVLAcjs.createFarmThemeDocumentParts.call(void 0, 
+      const themeDocument = _chunkVCKGOXFIcjs.createFarmThemeDocumentParts.call(void 0, 
         this.config.theme,
         this.config.basePath,
         _chunk4ZJ5C7UJcjs.getTheme.call(void 0, )
       );
       themeDocument.head = farmScripts(themeDocument.head);
-      const fullDocument = _chunkC2R5RVLAcjs.extractFarmFullDocument.call(void 0, content);
+      const fullDocument = _chunkVCKGOXFIcjs.extractFarmFullDocument.call(void 0, content);
       let html;
       if (fullDocument) {
         const shouldReplaceLayoutTitle = hasExplicitTitle || rendererHasTitle;
-        const documentHtml = shouldReplaceLayoutTitle ? _chunkC2R5RVLAcjs.removeFarmDocumentTitles.call(void 0, fullDocument) : fullDocument;
-        const effectiveRendererHead = hasExplicitTitle ? _chunkC2R5RVLAcjs.removeFarmDocumentTitles.call(void 0, rendererHead) : rendererHead;
-        html = _chunkC2R5RVLAcjs.composeFarmFullDocument.call(void 0, documentHtml, {
+        const documentHtml = shouldReplaceLayoutTitle ? _chunkVCKGOXFIcjs.removeFarmDocumentTitles.call(void 0, fullDocument) : fullDocument;
+        const effectiveRendererHead = hasExplicitTitle ? _chunkVCKGOXFIcjs.removeFarmDocumentTitles.call(void 0, rendererHead) : rendererHead;
+        html = _chunkVCKGOXFIcjs.composeFarmFullDocument.call(void 0, documentHtml, {
           fallbackIcon: !hasFavicon,
           viewport: viewportTags,
           htmlAttributes: `${i18nSnapshot ? ` lang="${escapeHtmlAttribute2(i18nSnapshot.locale)}" dir="${escapeHtmlAttribute2(i18nSnapshot.direction)}"` : ""}${themeDocument.attributes}`,
@@ -6770,7 +6772,8 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
   async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
     const renderToPipeableStream = this.rendererRuntime.renderToPipeableStream;
     const fullDocumentRouteKey = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
-    if (!renderToPipeableStream || _chunkWJFFPXCVcjs._isFarmMarkdownPageCheck.call(void 0, _optionalChain([req, 'access', _293 => _293.headers, 'optionalAccess', _294 => _294[_chunkWJFFPXCVcjs.FARM_MARKDOWN_PAGE_CHECK_HEADER]])) || fullDocumentRoutes.has(fullDocumentRouteKey) || await this.rootLayoutRendersDocument()) {
+    const streamDocument = fullDocumentRoutes.has(fullDocumentRouteKey) || await this.rootLayoutRendersDocument();
+    if (!renderToPipeableStream || _chunkWJFFPXCVcjs._isFarmMarkdownPageCheck.call(void 0, _optionalChain([req, 'access', _293 => _293.headers, 'optionalAccess', _294 => _294[_chunkWJFFPXCVcjs.FARM_MARKDOWN_PAGE_CHECK_HEADER]])) || streamDocument && (options.captureStaticShell || !_chunkRD623KW4cjs.isReactRenderer.call(void 0, this.config.renderer))) {
       return this.renderBufferedSSR(element, req, res, clearMiddlewareData, options);
     }
     return new Promise((resolve3, reject) => {
@@ -6882,6 +6885,7 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
         title,
         tags: metaTags,
         hasFavicon,
+        hasExplicitTitle,
         viewport: viewportTags
       } = _chunk6IOZPJ3Icjs.renderMetadataHead.call(void 0, req.__FARM_METADATA__, {
         pathname: getFarmMetadataPathname(req),
@@ -6894,7 +6898,7 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
         this.getI18nAlternateOptions(req, req.__FARM_METADATA__)
       ) : "";
       const fontHead = renderFarmFontDevHead(this.config.root || process.cwd());
-      const themeDocument = _chunkC2R5RVLAcjs.createFarmThemeDocumentParts.call(void 0, 
+      const themeDocument = _chunkVCKGOXFIcjs.createFarmThemeDocumentParts.call(void 0, 
         this.config.theme,
         this.config.basePath,
         _chunk4ZJ5C7UJcjs.getTheme.call(void 0, )
@@ -6947,25 +6951,70 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
 <body class="">${earlyClient ? `
   ${FARM_DEV_EARLY_CLIENT_SCRIPT}` : ""}
   <div id="root">`;
-          const securedShell = stampDocumentHTML(shell);
-          htmlParts.push(securedShell);
-          _optionalChain([staticShellParts, 'optionalAccess', _300 => _300.push, 'call', _301 => _301(securedShell)]);
+          const securedShell = streamDocument ? "" : stampDocumentHTML(shell);
+          if (securedShell) {
+            htmlParts.push(securedShell);
+            _optionalChain([staticShellParts, 'optionalAccess', _300 => _300.push, 'call', _301 => _301(securedShell)]);
+          }
+          const withEarlyClient = (document) => earlyClient ? {
+            ...document,
+            html: document.html.replace(
+              /<body\b[^>]*>/i,
+              (open) => `${open}
+  ${stampDocumentHTML(FARM_DEV_EARLY_CLIENT_SCRIPT)}`
+            )
+          } : document;
+          const documentTransform = streamDocument ? _chunkVCKGOXFIcjs.createFarmStreamedDocumentTransform.call(void 0, 
+            (opening) => withEarlyClient(
+              _chunkVCKGOXFIcjs.openFarmStreamedDocument.call(void 0, 
+                hasExplicitTitle ? _chunkVCKGOXFIcjs.removeFarmDocumentTitles.call(void 0, opening) : opening,
+                {
+                  fallbackIcon: !hasFavicon,
+                  viewport: viewportTags,
+                  htmlAttributes: `${i18nSnapshot ? ` lang="${escapeHtmlAttribute2(i18nSnapshot.locale)}" dir="${escapeHtmlAttribute2(i18nSnapshot.direction)}"` : ""}${themeDocument.attributes}`,
+                  replaceHtmlAttributes: [
+                    ...i18nSnapshot ? ["lang", "dir"] : [],
+                    ...themeDocument.attributes ? ["data-theme"] : []
+                  ],
+                  headAssets: stampDocumentHTML(
+                    [
+                      themeDocument.head,
+                      `<meta name="farm-deployment-id" content="${escapeHtmlAttribute2(deploymentId)}">`,
+                      hasExplicitTitle ? `<title>${title}</title>` : "",
+                      metaTags,
+                      i18nAlternateTags,
+                      fontHead,
+                      globalStylesheetLink,
+                      ...devStyleLinks,
+                      `<script type="module" src="/@vite/client"></script>`,
+                      propsScript,
+                      hydrationClickQueueScript
+                    ].filter(Boolean).join("\n  ")
+                  ),
+                  // The footer follows the streamed body.
+                  bodyFooter: ""
+                }
+              )
+            ),
+            stampDocumentHTML(shell)
+          ) : void 0;
           let firstChunk = true;
           let checkedFullDocument = false;
           let documentPrefix = "";
           const cspNonceRewriter = cspNonce ? _chunk6JHZPB52cjs.createFarmCspNonceRewriter.call(void 0, cspNonce) : void 0;
           const cspStreamDecoder = cspNonceRewriter ? new TextDecoder() : void 0;
-          const recordRenderedChunk = (chunkText) => {
-            if (!chunkText) return;
-            if (!checkedFullDocument) {
-              documentPrefix += chunkText;
-              const prefix = _chunkC2R5RVLAcjs.classifyFarmDocumentPrefix.call(void 0, documentPrefix);
+          const recordRenderedChunk = (chunkText, renderedText = chunkText) => {
+            if (!checkedFullDocument && renderedText) {
+              documentPrefix += renderedText;
+              const prefix = _chunkVCKGOXFIcjs.classifyFarmDocumentPrefix.call(void 0, documentPrefix);
               if (prefix !== "pending") {
                 checkedFullDocument = true;
                 documentPrefix = "";
                 if (prefix === "document") fullDocumentRoutes.add(fullDocumentRouteKey);
+                else fullDocumentRoutes.delete(fullDocumentRouteKey);
               }
             }
+            if (!chunkText) return;
             htmlParts.push(chunkText);
             if (staticShellParts && findStaticShellBoundary && !staticShellClosed) {
               const dynamicIndex = findStaticShellBoundary(chunkText);
@@ -6991,12 +7040,16 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
               }
               const chunkText = Buffer.isBuffer(chunk) ? cspStreamDecoder ? cspStreamDecoder.decode(chunk, { stream: true }) : chunk.toString() : String(chunk);
               const securedChunkText = cspNonceRewriter ? cspNonceRewriter.write(chunkText) : chunkText;
-              recordRenderedChunk(securedChunkText);
+              const outputText = documentTransform ? documentTransform.write(securedChunkText) : securedChunkText;
+              recordRenderedChunk(outputText, securedChunkText);
               const onWrite = () => {
                 if (typeof res.flush === "function") res.flush();
                 callback();
               };
-              if (cspNonceRewriter) res.write(securedChunkText, onWrite);
+              if (documentTransform) {
+                if (outputText) res.write(outputText, onWrite);
+                else callback();
+              } else if (cspNonceRewriter) res.write(securedChunkText, onWrite);
               else res.write(chunk, encoding, onWrite);
             },
             final: (callback) => {
@@ -7005,7 +7058,8 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
                 lateNavigationError = null;
                 createLateNavigationRecovery(navigationError).then(
                   (recovery) => {
-                    const secured = filterDocumentHTML(recovery);
+                    const filtered = filterDocumentHTML(recovery);
+                    const secured = documentTransform ? documentTransform.write(filtered) : filtered;
                     htmlParts.push(secured);
                     res.write(secured);
                     finishStream(callback);
@@ -7022,16 +7076,24 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
           });
           const finishStream = (callback) => {
             if (cspNonceRewriter) {
-              const tail = cspNonceRewriter.write(cspStreamDecoder.decode(), true);
-              recordRenderedChunk(tail);
+              const rewritten = cspNonceRewriter.write(cspStreamDecoder.decode(), true);
+              const tail = documentTransform ? documentTransform.write(rewritten) : rewritten;
+              recordRenderedChunk(tail, rewritten);
               if (tail) res.write(tail);
             }
+            const documentEnd = _optionalChain([documentTransform, 'optionalAccess', _304 => _304.end, 'call', _305 => _305()]);
+            if (_optionalChain([documentEnd, 'optionalAccess', _306 => _306.text])) {
+              recordRenderedChunk(documentEnd.text, "");
+              res.write(documentEnd.text);
+            }
             const suspenseRevealFallback = `<script>(function(){function moveFragment(srcId,placeholderId){var src=document.getElementById(srcId),ph=document.getElementById(placeholderId);if(!src||!ph||!ph.parentNode)return false;while(src.firstChild)ph.parentNode.insertBefore(src.firstChild,ph);ph.parentNode.removeChild(ph);if(src.parentNode)src.parentNode.removeChild(src);return true}function revealBoundary(boundaryId,sectionId){var boundary=document.getElementById(boundaryId),section=document.getElementById(sectionId);if(!boundary||!section||!boundary.parentNode)return false;var start=boundary.previousSibling;if(!start||start.nodeType!==8)return false;var parent=boundary.parentNode;var node=boundary;var depth=0;while(node){if(node.nodeType===8){var data=node.data;if(data==="/$"||data==="/&"){if(depth===0)break;depth--;}else if(data==="$"||data==="$?"||data==="$~"||data==="$!"||data==="&"){depth++;}}var next=node.nextSibling;parent.removeChild(node);node=next;}while(section.firstChild)parent.insertBefore(section.firstChild,node);if(section.parentNode)section.parentNode.removeChild(section);start.data="$";return true}var tries=0;var timer=setInterval(function(){var changed=false;document.querySelectorAll('div[id^="S:"]').forEach(function(section){var suffix=section.id.slice(2);changed=moveFragment('S:'+suffix,'P:'+suffix)||changed;});document.querySelectorAll('template[id^="B:"]').forEach(function(boundary){var suffix=boundary.id.slice(2);changed=revealBoundary('B:'+suffix,'S:'+suffix)||changed;});tries++;if(tries>80||(!document.querySelector('template[id^="B:"]')&&!document.querySelector('template[id^="P:"]'))){clearInterval(timer);}},50);})();</script>`;
             const footer = stampDocumentHTML(
               createDocumentFooter({
                 suspenseRevealFallback,
                 deferredHydrationScript: createDeferredHydrationScript(deferredProps.records),
-                earlyClient
+                earlyClient,
+                // A full document: Farm's #root closes only where Farm opened it.
+                ..._optionalChain([documentEnd, 'optionalAccess', _307 => _307.document]) ? { closeRoot: documentEnd.rootOpened } : {}
               })
             );
             htmlParts.push(footer);
@@ -7135,7 +7197,7 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
     return await this.routeManager.loadRouteModule(notFoundPath);
   }
   async loadNotFoundComponent() {
-    return await _asyncNullishCoalesce(await _asyncOptionalChain([(await this.loadNotFoundModule()), 'optionalAccess', async _304 => _304.default]), async () => ( null));
+    return await _asyncNullishCoalesce(await _asyncOptionalChain([(await this.loadNotFoundModule()), 'optionalAccess', async _308 => _308.default]), async () => ( null));
   }
   /** The not-found document's head: layout and not-found metadata, as production renders it. */
   async notFoundMetadataHead(layoutModule, notFoundModule) {
@@ -7158,13 +7220,13 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
    */
   async createLateNavigationRecoveryHTML(req, error) {
     if (_chunk7JUIK547cjs.isFarmRedirectError.call(void 0, error)) {
-      return _chunkC2R5RVLAcjs.createLateRedirectRecovery.call(void 0, 
+      return _chunkVCKGOXFIcjs.createLateRedirectRecovery.call(void 0, 
         this.localizeRedirectUrl(_chunk7JUIK547cjs.getFarmRedirectError.call(void 0, error).url),
         this.getCspNonce(req) || ""
       );
     }
     const pathname = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, {
-      trustProxy: _optionalChain([this, 'access', _305 => _305.config, 'access', _306 => _306.server, 'optionalAccess', _307 => _307.trustProxy])
+      trustProxy: _optionalChain([this, 'access', _309 => _309.config, 'access', _310 => _310.server, 'optionalAccess', _311 => _311.trustProxy])
     }).pathname;
     let content = this.defaultNotFoundContent();
     const NotFoundComponent = await this.loadNotFoundComponent();
@@ -7180,12 +7242,12 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
         _chunkXN2MB4QZcjs.logger.warn(`not-found page could not render outside its layout, using Farm's: ${error2}`);
       }
     }
-    return _chunkC2R5RVLAcjs.createLateNotFoundRecovery.call(void 0, content, this.getCspNonce(req) || "");
+    return _chunkVCKGOXFIcjs.createLateNotFoundRecovery.call(void 0, content, this.getCspNonce(req) || "");
   }
   async render404(req, res) {
     res.statusCode = 404;
     const pathname = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, {
-      trustProxy: _optionalChain([this, 'access', _308 => _308.config, 'access', _309 => _309.server, 'optionalAccess', _310 => _310.trustProxy])
+      trustProxy: _optionalChain([this, 'access', _312 => _312.config, 'access', _313 => _313.server, 'optionalAccess', _314 => _314.trustProxy])
     }).pathname;
     const acceptHeader = req.headers.accept;
     const accept = Array.isArray(acceptHeader) ? acceptHeader.join(",") : acceptHeader;
@@ -7213,9 +7275,9 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
       );
       if (notFoundPath) {
         const notFoundModule = await this.loadNotFoundModule();
-        const NotFoundComponent = _nullishCoalesce(_optionalChain([notFoundModule, 'optionalAccess', _311 => _311.default]), () => ( null));
+        const NotFoundComponent = _nullishCoalesce(_optionalChain([notFoundModule, 'optionalAccess', _315 => _315.default]), () => ( null));
         if (NotFoundComponent) {
-          const LayoutComponent = _nullishCoalesce(_optionalChain([layoutModule, 'optionalAccess', _312 => _312.default]), () => ( null));
+          const LayoutComponent = _nullishCoalesce(_optionalChain([layoutModule, 'optionalAccess', _316 => _316.default]), () => ( null));
           let element = this.rendererRuntime.createElement(NotFoundComponent, { pathname });
           if (LayoutComponent) {
             element = this.rendererRuntime.createElement(LayoutComponent, {
@@ -7255,23 +7317,23 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
     res.statusCode = statusCode;
     const isDev = process.env.NODE_ENV === "development";
     const requestUrl = _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, {
-      trustProxy: _optionalChain([this, 'access', _313 => _313.config, 'access', _314 => _314.server, 'optionalAccess', _315 => _315.trustProxy])
+      trustProxy: _optionalChain([this, 'access', _317 => _317.config, 'access', _318 => _318.server, 'optionalAccess', _319 => _319.trustProxy])
     });
     const diagnostics = isDev ? createDefaultErrorDiagnostics(error, this.config.root || process.cwd()) : void 0;
-    const statusText = _chunkC2R5RVLAcjs.getDefaultErrorStatusText.call(void 0, statusCode);
+    const statusText = _chunkVCKGOXFIcjs.getDefaultErrorStatusText.call(void 0, statusCode);
     const content = this.stampFarmScripts(
       req,
-      _chunkC2R5RVLAcjs.createDefaultErrorMarkup.call(void 0, {
+      _chunkVCKGOXFIcjs.createDefaultErrorMarkup.call(void 0, {
         statusCode,
         statusText,
         requestPath: requestUrl.pathname,
         method: req.method || "GET",
-        message: _optionalChain([diagnostics, 'optionalAccess', _316 => _316.message]),
-        errorName: _optionalChain([diagnostics, 'optionalAccess', _317 => _317.name]),
-        stack: _optionalChain([diagnostics, 'optionalAccess', _318 => _318.stack]),
-        sourceFrame: _optionalChain([diagnostics, 'optionalAccess', _319 => _319.sourceFrame]),
+        message: _optionalChain([diagnostics, 'optionalAccess', _320 => _320.message]),
+        errorName: _optionalChain([diagnostics, 'optionalAccess', _321 => _321.name]),
+        stack: _optionalChain([diagnostics, 'optionalAccess', _322 => _322.stack]),
+        sourceFrame: _optionalChain([diagnostics, 'optionalAccess', _323 => _323.sourceFrame]),
         development: isDev,
-        farmVersion: _chunkJLS6ZLFMcjs.FARM_VERSION,
+        farmVersion: _chunkJ5VCA45Kcjs.FARM_VERSION,
         nodeVersion: process.version,
         mode: isDev ? "development" : "production"
       })
@@ -7297,8 +7359,8 @@ window.__FARM_I18N__ = ${_chunkRVGLYMJMcjs.getFarmI18nClientSnapshot.call(void 0
    */
   getI18nAlternateOptions(req, metadata) {
     return {
-      metadataBase: _optionalChain([metadata, 'optionalAccess', _320 => _320.metadataBase]),
-      origin: req ? _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, { trustProxy: _optionalChain([this, 'access', _321 => _321.config, 'access', _322 => _322.server, 'optionalAccess', _323 => _323.trustProxy]) }).origin : void 0
+      metadataBase: _optionalChain([metadata, 'optionalAccess', _324 => _324.metadataBase]),
+      origin: req ? _chunkHNAISJFDcjs.resolveFarmRequestURL.call(void 0, req, { trustProxy: _optionalChain([this, 'access', _325 => _325.config, 'access', _326 => _326.server, 'optionalAccess', _327 => _327.trustProxy]) }).origin : void 0
     };
   }
   createFullHTML(content, isClientComponent = false, requestPath = "/", metadataHead, alternates = {}) {
@@ -7317,20 +7379,20 @@ ${i18nSnapshot ? `window.__FARM_I18N__ = ${serializeInlineValue(i18nSnapshot)};`
       this.getI18nAlternateOptions(alternates.req, alternates.metadata)
     ) : "";
     const fontHead = renderFarmFontDevHead(this.config.root || process.cwd());
-    const themeDocument = _chunkC2R5RVLAcjs.createFarmThemeDocumentParts.call(void 0, 
+    const themeDocument = _chunkVCKGOXFIcjs.createFarmThemeDocumentParts.call(void 0, 
       this.config.theme,
       this.config.basePath,
       _chunk4ZJ5C7UJcjs.getTheme.call(void 0, )
     );
     themeDocument.head = farmScripts(themeDocument.head);
     const rendererHydrationScript = farmScripts(
-      _optionalChain([this, 'access', _324 => _324.rendererRuntime, 'access', _325 => _325.generateHydrationScript, 'optionalCall', _326 => _326()]) || ""
+      _optionalChain([this, 'access', _328 => _328.rendererRuntime, 'access', _329 => _329.generateHydrationScript, 'optionalCall', _330 => _330()]) || ""
     );
-    const viewportTags = _chunk6IOZPJ3Icjs.renderViewportHead.call(void 0, _optionalChain([alternates, 'access', _327 => _327.metadata, 'optionalAccess', _328 => _328.viewport]));
-    const fullDocument = _chunkC2R5RVLAcjs.extractFarmFullDocument.call(void 0, content);
+    const viewportTags = _chunk6IOZPJ3Icjs.renderViewportHead.call(void 0, _optionalChain([alternates, 'access', _331 => _331.metadata, 'optionalAccess', _332 => _332.viewport]));
+    const fullDocument = _chunkVCKGOXFIcjs.extractFarmFullDocument.call(void 0, content);
     if (fullDocument) {
-      return _chunkC2R5RVLAcjs.composeFarmFullDocument.call(void 0, 
-        metadataHead ? _chunkC2R5RVLAcjs.removeFarmDocumentTitles.call(void 0, fullDocument) : fullDocument,
+      return _chunkVCKGOXFIcjs.composeFarmFullDocument.call(void 0, 
+        metadataHead ? _chunkVCKGOXFIcjs.removeFarmDocumentTitles.call(void 0, fullDocument) : fullDocument,
         {
           fallbackIcon: !metadataHead,
           viewport: viewportTags,
@@ -7356,7 +7418,7 @@ ${i18nSnapshot ? `window.__FARM_I18N__ = ${serializeInlineValue(i18nSnapshot)};`
       );
     }
     return `<!DOCTYPE html>
-<html lang="${escapeHtmlAttribute2(_optionalChain([i18nSnapshot, 'optionalAccess', _329 => _329.locale]) || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
+<html lang="${escapeHtmlAttribute2(_optionalChain([i18nSnapshot, 'optionalAccess', _333 => _333.locale]) || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
 <head>
   ${themeDocument.head}
   <meta charset="utf-8">
@@ -7398,7 +7460,7 @@ ${clientScript}
     res.setHeader(_chunkE552H232cjs.FARM_DEPLOYMENT_ID_HEADER, deploymentId);
     if ((req.method || "GET").toUpperCase() !== "GET") return;
     const forwardedProto = req.headers["x-forwarded-proto"];
-    const isSecure = _optionalChain([(Array.isArray(forwardedProto) ? forwardedProto[0] : forwardedProto), 'optionalAccess', _330 => _330.split, 'call', _331 => _331(","), 'access', _332 => _332[0], 'optionalAccess', _333 => _333.trim, 'call', _334 => _334()]) === "https" || Boolean(_optionalChain([req, 'access', _335 => _335.socket, 'optionalAccess', _336 => _336.encrypted]));
+    const isSecure = _optionalChain([(Array.isArray(forwardedProto) ? forwardedProto[0] : forwardedProto), 'optionalAccess', _334 => _334.split, 'call', _335 => _335(","), 'access', _336 => _336[0], 'optionalAccess', _337 => _337.trim, 'call', _338 => _338()]) === "https" || Boolean(_optionalChain([req, 'access', _339 => _339.socket, 'optionalAccess', _340 => _340.encrypted]));
     const cookie = _chunkE552H232cjs.createFarmDeploymentCookie.call(void 0, deploymentId, this.config.basePath || "/", isSecure);
     const existing = res.getHeader("Set-Cookie");
     if (Array.isArray(existing)) {
@@ -7526,10 +7588,10 @@ var FarmApp = class {
       env: config.env || { server: {}, public: {} },
       suppressLintOnLink: _nullishCoalesce(config.suppressLintOnLink, () => ( false)),
       experimental: {
-        serverComponents: _nullishCoalesce(_optionalChain([config, 'access', _337 => _337.experimental, 'optionalAccess', _338 => _338.serverComponents]), () => ( false)),
-        serverActions: _nullishCoalesce(_optionalChain([config, 'access', _339 => _339.experimental, 'optionalAccess', _340 => _340.serverActions]), () => ( false)),
-        isolatedClientHydration: _nullishCoalesce(_optionalChain([config, 'access', _341 => _341.experimental, 'optionalAccess', _342 => _342.isolatedClientHydration]), () => ( "off")),
-        ppr: _nullishCoalesce(_optionalChain([config, 'access', _343 => _343.experimental, 'optionalAccess', _344 => _344.ppr]), () => ( false)),
+        serverComponents: _nullishCoalesce(_optionalChain([config, 'access', _341 => _341.experimental, 'optionalAccess', _342 => _342.serverComponents]), () => ( false)),
+        serverActions: _nullishCoalesce(_optionalChain([config, 'access', _343 => _343.experimental, 'optionalAccess', _344 => _344.serverActions]), () => ( false)),
+        isolatedClientHydration: _nullishCoalesce(_optionalChain([config, 'access', _345 => _345.experimental, 'optionalAccess', _346 => _346.isolatedClientHydration]), () => ( "off")),
+        ppr: _nullishCoalesce(_optionalChain([config, 'access', _347 => _347.experimental, 'optionalAccess', _348 => _348.ppr]), () => ( false)),
         ...config.experimental
       },
       agent: _nullishCoalesce(config.agent, () => ( {})),
@@ -7576,7 +7638,7 @@ function isResolvedAuthConfig(value) {
   );
 }
 function normalizeFarmAppAPIConfig(config) {
-  if (typeof _optionalChain([config, 'optionalAccess', _345 => _345.baseURL]) === "function" || typeof _optionalChain([config, 'optionalAccess', _346 => _346.basePath]) === "function") {
+  if (typeof _optionalChain([config, 'optionalAccess', _349 => _349.baseURL]) === "function" || typeof _optionalChain([config, 'optionalAccess', _350 => _350.basePath]) === "function") {
     throw new Error(
       "Farm API config resolver functions must be processed with resolveConfig() before creating a FarmApp."
     );
@@ -7591,7 +7653,7 @@ function createFarmApp(config, viteServer) {
 var SHARP_INSTALL_HINT = _chunkKORZ6PREcjs.formatOptionalPeerInstallHint.call(void 0, "sharp", "optimize images");
 var CLOUDFLARE_IMAGE_PRESETS = /* @__PURE__ */ new Set(["cloudflare", "cloudflare-pages", "cloudflare-module"]);
 function resolveFarmImageProviderForRuntime(images, options) {
-  const provider = _nullishCoalesce(_optionalChain([images, 'optionalAccess', _347 => _347.provider]), () => ( "auto"));
+  const provider = _nullishCoalesce(_optionalChain([images, 'optionalAccess', _351 => _351.provider]), () => ( "auto"));
   if (provider === "none") return images;
   const usesSharp = options.dev ? true : provider === "node" || provider === "auto" && !CLOUDFLARE_IMAGE_PRESETS.has(options.preset || "");
   if (!usesSharp || _chunkKORZ6PREcjs.isOptionalPeerInstalled.call(void 0, options.root, "sharp")) return images;
@@ -7720,9 +7782,9 @@ function staticValue(node) {
   }
 }
 function property(object, name) {
-  return _optionalChain([object, 'access', _348 => _348.properties, 'access', _349 => _349.find, 'call', _350 => _350(
+  return _optionalChain([object, 'access', _352 => _352.properties, 'access', _353 => _353.find, 'call', _354 => _354(
     (entry) => entry.type === "Property" && !entry.computed && (entry.key.name === name || entry.key.value === name)
-  ), 'optionalAccess', _351 => _351.value]);
+  ), 'optionalAccess', _355 => _355.value]);
 }
 function toolFromObject(object) {
   const name = staticValue(property(object, "name"));
@@ -7768,7 +7830,7 @@ function findFarmWebMCPTools(code, filename = "module.tsx") {
     if (statement.type !== "ImportDeclaration" || statement.source.value !== WEBMCP_CLIENT)
       continue;
     for (const specifier of statement.specifiers) {
-      const imported = _nullishCoalesce(_optionalChain([specifier, 'access', _352 => _352.imported, 'optionalAccess', _353 => _353.name]), () => ( _optionalChain([specifier, 'access', _354 => _354.imported, 'optionalAccess', _355 => _355.value])));
+      const imported = _nullishCoalesce(_optionalChain([specifier, 'access', _356 => _356.imported, 'optionalAccess', _357 => _357.name]), () => ( _optionalChain([specifier, 'access', _358 => _358.imported, 'optionalAccess', _359 => _359.value])));
       if (specifier.type === "ImportSpecifier" && DEFINERS.has(imported))
         locals.set(specifier.local.name, imported);
     }
@@ -7784,7 +7846,7 @@ function findFarmWebMCPTools(code, filename = "module.tsx") {
       const [argument] = current.arguments;
       if (definer && argument) {
         const objects = definer === "registerWebMCPTools" ? argument.type === "ArrayExpression" ? argument.elements.filter(
-          (element) => _optionalChain([element, 'optionalAccess', _356 => _356.type]) === "ObjectExpression"
+          (element) => _optionalChain([element, 'optionalAccess', _360 => _360.type]) === "ObjectExpression"
         ) : [] : argument.type === "ObjectExpression" ? [argument] : [];
         for (const object of objects) {
           const tool = toolFromObject(object);
@@ -7863,7 +7925,7 @@ function resolveFarmAppClientEntry(root = process.cwd(), srcDir = "src") {
   return void 0;
 }
 function resolveFarmClientPlugins(plugins, _root) {
-  if (!_optionalChain([plugins, 'optionalAccess', _357 => _357.length])) return [];
+  if (!_optionalChain([plugins, 'optionalAccess', _361 => _361.length])) return [];
   return plugins.flatMap((plugin) => {
     if (!plugin.client) return [];
     assertClientLifecycle(plugin.client, plugin.name);
@@ -7940,7 +8002,7 @@ function assertLifecycleObject(value, pluginName, location, allowedKeys) {
       throw new TypeError(`Client plugin "${pluginName}" has an unknown ${location}.${key} option`);
     }
     const descriptor = Object.getOwnPropertyDescriptor(value, key);
-    if (!_optionalChain([descriptor, 'optionalAccess', _358 => _358.enumerable])) {
+    if (!_optionalChain([descriptor, 'optionalAccess', _362 => _362.enumerable])) {
       throw new TypeError(`Client plugin "${pluginName}" ${location}.${key} must be enumerable`);
     }
     if (!("value" in descriptor)) {
@@ -8058,7 +8120,7 @@ function assertPublicData(value, pluginName) {
         throwPublicDataError(pluginName, pathSegments, "cannot contain symbol keys");
       }
       const descriptor = Object.getOwnPropertyDescriptor(current, key);
-      if (!_optionalChain([descriptor, 'optionalAccess', _359 => _359.enumerable])) {
+      if (!_optionalChain([descriptor, 'optionalAccess', _363 => _363.enumerable])) {
         throwPublicDataError(
           pluginName,
           [...pathSegments, key],
@@ -8099,8 +8161,8 @@ function isArrayIndex(key) {
 
 var ADAPTER_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mts", "mjs"];
 function resolveFarmClientCacheAdapterEntry(root, cache2) {
-  const client = _optionalChain([cache2, 'optionalAccess', _360 => _360.client]);
-  const adapter = _optionalChain([client, 'optionalAccess', _361 => _361.adapter]);
+  const client = _optionalChain([cache2, 'optionalAccess', _364 => _364.client]);
+  const adapter = _optionalChain([client, 'optionalAccess', _365 => _365.adapter]);
   if (adapter === void 0) return void 0;
   if (typeof adapter !== "string" || adapter.trim().length === 0) {
     throw new Error(
@@ -8115,8 +8177,8 @@ function resolveFarmClientCacheAdapterEntry(root, cache2) {
     );
   }
   const options = {};
-  if (_optionalChain([client, 'optionalAccess', _362 => _362.version]) !== void 0) options.version = client.version;
-  if (_optionalChain([client, 'optionalAccess', _363 => _363.flushDelayMs]) !== void 0) options.flushDelayMs = client.flushDelayMs;
+  if (_optionalChain([client, 'optionalAccess', _366 => _366.version]) !== void 0) options.version = client.version;
+  if (_optionalChain([client, 'optionalAccess', _367 => _367.flushDelayMs]) !== void 0) options.flushDelayMs = client.flushDelayMs;
   return { importPath: found.replace(/\\/g, "/"), options };
 }
 function resolveAdapterFile(resolved) {
@@ -8316,7 +8378,7 @@ function redactFarmDocsClientConfig(code, filename) {
     const current = node;
     if (current.type === "Property") {
       const name = propertyKeyName(current);
-      const valueType = _optionalChain([current, 'access', _364 => _364.value, 'optionalAccess', _365 => _365.type]);
+      const valueType = _optionalChain([current, 'access', _368 => _368.value, 'optionalAccess', _369 => _369.type]);
       const credential = name !== void 0 && (name.toLowerCase() === "headers" || _chunkSM2SYWARcjs.isSecretDocsConfigKey.call(void 0, name) && valueType !== "ObjectExpression" && valueType !== "ArrayExpression");
       if (name && credential) {
         edits.push(
@@ -8356,7 +8418,7 @@ function farmDocsClientConfigPlugin(configModule) {
     name: "farm:docs-client-config",
     enforce: "pre",
     transform(code, id, options) {
-      if (_optionalChain([options, 'optionalAccess', _366 => _366.ssr]) || !isFarmDocsClientConfigModule(id, configModule)) return null;
+      if (_optionalChain([options, 'optionalAccess', _370 => _370.ssr]) || !isFarmDocsClientConfigModule(id, configModule)) return null;
       const redacted = redactFarmDocsClientConfig(code, id.split("?")[0]);
       return redacted === null ? null : { code: redacted, map: null };
     }
@@ -8387,7 +8449,7 @@ var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
 ];
 function getFarmClientOptimizeDepsInclude(renderer) {
   return Array.from(
-    /* @__PURE__ */ new Set([...FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE, ..._optionalChain([renderer, 'optionalAccess', _367 => _367.optimizeDeps]) || []])
+    /* @__PURE__ */ new Set([...FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE, ..._optionalChain([renderer, 'optionalAccess', _371 => _371.optimizeDeps]) || []])
   );
 }
 function createFarmClientOptimizeDepsEntries(projectRoot, appDirectories) {
@@ -8410,7 +8472,7 @@ function createFarmClientOptimizeDepsConfig(entries, renderer) {
     // Farm's HTML boots through a virtual module and imports route UI lazily.
     // Explicit entries let Vite finish that crawl before a navigation can
     // rotate the optimizer hash underneath a hydrated React runtime.
-    ..._optionalChain([entries, 'optionalAccess', _368 => _368.length]) ? { entries: [...entries] } : {}
+    ..._optionalChain([entries, 'optionalAccess', _372 => _372.length]) ? { entries: [...entries] } : {}
   };
 }
 function createFarmSourceAlias(projectRoot, srcDir = "src") {
@@ -8436,8 +8498,8 @@ function mergeAlias(farmValue, userValue) {
   return [...normalize(userValue), ...normalize(farmValue)];
 }
 function mergeFarmViteConfig(farmConfig, userConfig = {}) {
-  const noDiscovery = _nullishCoalesce(_optionalChain([userConfig, 'access', _369 => _369.optimizeDeps, 'optionalAccess', _370 => _370.noDiscovery]), () => ( _optionalChain([farmConfig, 'access', _371 => _371.optimizeDeps, 'optionalAccess', _372 => _372.noDiscovery])));
-  const holdUntilCrawlEnd = _nullishCoalesce(_optionalChain([userConfig, 'access', _373 => _373.optimizeDeps, 'optionalAccess', _374 => _374.holdUntilCrawlEnd]), () => ( (_optionalChain([userConfig, 'access', _375 => _375.optimizeDeps, 'optionalAccess', _376 => _376.noDiscovery]) === true ? false : _optionalChain([farmConfig, 'access', _377 => _377.optimizeDeps, 'optionalAccess', _378 => _378.holdUntilCrawlEnd]))));
+  const noDiscovery = _nullishCoalesce(_optionalChain([userConfig, 'access', _373 => _373.optimizeDeps, 'optionalAccess', _374 => _374.noDiscovery]), () => ( _optionalChain([farmConfig, 'access', _375 => _375.optimizeDeps, 'optionalAccess', _376 => _376.noDiscovery])));
+  const holdUntilCrawlEnd = _nullishCoalesce(_optionalChain([userConfig, 'access', _377 => _377.optimizeDeps, 'optionalAccess', _378 => _378.holdUntilCrawlEnd]), () => ( (_optionalChain([userConfig, 'access', _379 => _379.optimizeDeps, 'optionalAccess', _380 => _380.noDiscovery]) === true ? false : _optionalChain([farmConfig, 'access', _381 => _381.optimizeDeps, 'optionalAccess', _382 => _382.holdUntilCrawlEnd]))));
   return {
     ...farmConfig,
     ...userConfig,
@@ -8449,9 +8511,9 @@ function mergeFarmViteConfig(farmConfig, userConfig = {}) {
     resolve: {
       ...farmConfig.resolve,
       ...userConfig.resolve,
-      alias: mergeAlias(_optionalChain([farmConfig, 'access', _379 => _379.resolve, 'optionalAccess', _380 => _380.alias]), _optionalChain([userConfig, 'access', _381 => _381.resolve, 'optionalAccess', _382 => _382.alias])),
+      alias: mergeAlias(_optionalChain([farmConfig, 'access', _383 => _383.resolve, 'optionalAccess', _384 => _384.alias]), _optionalChain([userConfig, 'access', _385 => _385.resolve, 'optionalAccess', _386 => _386.alias])),
       dedupe: Array.from(
-        /* @__PURE__ */ new Set([..._optionalChain([farmConfig, 'access', _383 => _383.resolve, 'optionalAccess', _384 => _384.dedupe]) || [], ..._optionalChain([userConfig, 'access', _385 => _385.resolve, 'optionalAccess', _386 => _386.dedupe]) || []])
+        /* @__PURE__ */ new Set([..._optionalChain([farmConfig, 'access', _387 => _387.resolve, 'optionalAccess', _388 => _388.dedupe]) || [], ..._optionalChain([userConfig, 'access', _389 => _389.resolve, 'optionalAccess', _390 => _390.dedupe]) || []])
       )
     },
     optimizeDeps: {
@@ -8461,21 +8523,21 @@ function mergeFarmViteConfig(farmConfig, userConfig = {}) {
       holdUntilCrawlEnd,
       include: Array.from(
         /* @__PURE__ */ new Set([
-          ..._optionalChain([farmConfig, 'access', _387 => _387.optimizeDeps, 'optionalAccess', _388 => _388.include]) || [],
-          ..._optionalChain([userConfig, 'access', _389 => _389.optimizeDeps, 'optionalAccess', _390 => _390.include]) || []
+          ..._optionalChain([farmConfig, 'access', _391 => _391.optimizeDeps, 'optionalAccess', _392 => _392.include]) || [],
+          ..._optionalChain([userConfig, 'access', _393 => _393.optimizeDeps, 'optionalAccess', _394 => _394.include]) || []
         ])
       ),
       exclude: Array.from(
         /* @__PURE__ */ new Set([
-          ..._optionalChain([farmConfig, 'access', _391 => _391.optimizeDeps, 'optionalAccess', _392 => _392.exclude]) || [],
-          ..._optionalChain([userConfig, 'access', _393 => _393.optimizeDeps, 'optionalAccess', _394 => _394.exclude]) || []
+          ..._optionalChain([farmConfig, 'access', _395 => _395.optimizeDeps, 'optionalAccess', _396 => _396.exclude]) || [],
+          ..._optionalChain([userConfig, 'access', _397 => _397.optimizeDeps, 'optionalAccess', _398 => _398.exclude]) || []
         ])
       )
     },
     ssr: {
       ...farmConfig.ssr,
       ...userConfig.ssr,
-      noExternal: mergeNoExternal(_optionalChain([farmConfig, 'access', _395 => _395.ssr, 'optionalAccess', _396 => _396.noExternal]), _optionalChain([userConfig, 'access', _397 => _397.ssr, 'optionalAccess', _398 => _398.noExternal]))
+      noExternal: mergeNoExternal(_optionalChain([farmConfig, 'access', _399 => _399.ssr, 'optionalAccess', _400 => _400.noExternal]), _optionalChain([userConfig, 'access', _401 => _401.ssr, 'optionalAccess', _402 => _402.noExternal]))
     }
   };
 }
@@ -8527,7 +8589,7 @@ function mergeFarmProductionViteConfig(farmConfig, userConfig = {}) {
       ...farmConfig.build,
       rollupOptions: {
         ...userBundlerOptions,
-        ..._optionalChain([farmConfig, 'access', _399 => _399.build, 'optionalAccess', _400 => _400.rollupOptions])
+        ..._optionalChain([farmConfig, 'access', _403 => _403.build, 'optionalAccess', _404 => _404.rollupOptions])
       }
     },
     css: farmConfig.css || userCss ? { ...farmConfig.css, ...userCss } : void 0,
@@ -8535,7 +8597,7 @@ function mergeFarmProductionViteConfig(farmConfig, userConfig = {}) {
     esbuild: typeof userEsbuild === "object" && farmConfig.esbuild !== false ? { ...userEsbuild, ...farmConfig.esbuild } : _nullishCoalesce(farmConfig.esbuild, () => ( userEsbuild)),
     ssr: {
       ...merged.ssr,
-      external: mergeExternal(_optionalChain([farmConfig, 'access', _401 => _401.ssr, 'optionalAccess', _402 => _402.external]), _optionalChain([userConfig, 'access', _403 => _403.ssr, 'optionalAccess', _404 => _404.external]))
+      external: mergeExternal(_optionalChain([farmConfig, 'access', _405 => _405.ssr, 'optionalAccess', _406 => _406.external]), _optionalChain([userConfig, 'access', _407 => _407.ssr, 'optionalAccess', _408 => _408.external]))
     }
   };
 }