@farm.js/core 0.1.48 → 0.1.50

package/dist/{chunk-SSNN55Q6.cjs → chunk-IQXGHGZF.cjs}

@@ -15,7 +15,7 @@ var _chunkJHXJBNLYcjs = require('./chunk-JHXJBNLY.cjs');
 
 
 
-var _chunk5566GNEGcjs = require('./chunk-5566GNEG.cjs');
+var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
 
 
 var _chunk6XQSPIN6cjs = require('./chunk-6XQSPIN6.cjs');
@@ -128,10 +128,10 @@ function createFarmWorkflowRequestHandler(options) {
     try {
       payload = await readWorkflowPayload(
         request,
-        _chunk5566GNEGcjs.resolveFarmServerConfig.call(void 0, options.server).bodySizeLimit
+        _chunkLIFUPCXWcjs.resolveFarmServerConfig.call(void 0, options.server).bodySizeLimit
       );
     } catch (error) {
-      const response = _chunk5566GNEGcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
+      const response = _chunkLIFUPCXWcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
       if (response) return response;
       if (error instanceof SyntaxError) {
         return Response.json({ error: "Invalid workflow request body." }, { status: 400 });
@@ -210,7 +210,7 @@ async function prepareFarmWorkflowsForNitro(config) {
     createNitroWorkflowHTTPHandler(
       workflowConfig,
       workflows,
-      _chunk5566GNEGcjs.resolveFarmServerConfig.call(void 0, config.server)
+      _chunkLIFUPCXWcjs.resolveFarmServerConfig.call(void 0, config.server)
     ),
     "utf8"
   );
@@ -561,7 +561,7 @@ async function readWorkflowPayload(request, bodySizeLimit) {
   if (request.method === "GET" || request.method === "HEAD") {
     return _chunkJHXJBNLYcjs.searchParamsToObject.call(void 0, url.searchParams);
   }
-  const bytes = await _chunk5566GNEGcjs.readFarmRequestBody.call(void 0, request, bodySizeLimit);
+  const bytes = await _chunkLIFUPCXWcjs.readFarmRequestBody.call(void 0, request, bodySizeLimit);
   const text = new TextDecoder().decode(bytes);
   if (!text) return {};
   const contentType = (request.headers.get("content-type") || "").split(";", 1)[0].trim().toLowerCase();

package/dist/{chunk-ZSIGEHSE.cjs → chunk-IUBDMDZZ.cjs}

@@ -1,14 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkSYW346ZNcjs = require('./chunk-SYW346ZN.cjs');
 
+var _chunk3ATXWZPHcjs = require('./chunk-3ATXWZPH.cjs');
 
-var _chunkQISW423Scjs = require('./chunk-QISW423S.cjs');
+
+var _chunkSYW346ZNcjs = require('./chunk-SYW346ZN.cjs');
 
 
 var _chunkGBMWLDCCcjs = require('./chunk-GBMWLDCC.cjs');
 
 
+var _chunkQISW423Scjs = require('./chunk-QISW423S.cjs');
+
+
 
 
 
@@ -22,29 +26,17 @@ var _chunkGSVJ3IIFcjs = require('./chunk-GSVJ3IIF.cjs');
 var _chunk5YPBFMBNcjs = require('./chunk-5YPBFMBN.cjs');
 
 
-var _chunkRD623KW4cjs = require('./chunk-RD623KW4.cjs');
-
-
 
 var _chunk5Y2P454Ocjs = require('./chunk-5Y2P454O.cjs');
 
 
-var _chunkJ2ZEVDEKcjs = require('./chunk-J2ZEVDEK.cjs');
-
-
-var _chunkJZMZKABScjs = require('./chunk-JZMZKABS.cjs');
-
-
 var _chunkBBPDJGCUcjs = require('./chunk-BBPDJGCU.cjs');
 
 
 var _chunk5C7XMKQ4cjs = require('./chunk-5C7XMKQ4.cjs');
 
-
-var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
-
 // src/ssg.ts
-var _fs = require('fs'); var fs = _interopRequireWildcard(_fs); var fs2 = _interopRequireWildcard(_fs);
+var _fs = require('fs'); var fs = _interopRequireWildcard(_fs);
 var _promises = require('fs/promises');
 var REQUEST_API_LABELS = /* @__PURE__ */ new Map([
   ["cookies", "request cookies"],
@@ -511,163 +503,13 @@ function matchSSGPage(urlPath, ssgPages) {
   return ssgPages.find((page) => page.urlPath === normalizedPath);
 }
 
-// src/routing/generate-route-types.ts
-var _path = require('path'); var path = _interopRequireWildcard(_path); var path3 = _interopRequireWildcard(_path);
-
-function routeSegmentsToTsTypeLiteral(segments) {
-  if (segments.length === 0) return '"/"';
-  const hasDynamic = segments.some((s) => s.startsWith("["));
-  if (!hasDynamic) return JSON.stringify("/" + segments.join("/"));
-  const parts = segments.map((s) => {
-    if (s.startsWith("[[...") || s.startsWith("[...")) return "${string}";
-    if (s.startsWith("[")) return "${string}";
-    return s;
-  });
-  return "`/" + parts.join("/") + "`";
-}
-function routePatternToTsTypeLiterals(pattern) {
-  if (pattern === "/") return ['"/"'];
-  let variants = [[]];
-  for (const segment of pattern.slice(1).split("/").filter(Boolean)) {
-    if (segment.startsWith("[[...") && segment.endsWith("]]")) {
-      variants = variants.flatMap((parts) => [parts, [...parts, segment]]);
-    } else {
-      variants = variants.map((parts) => [...parts, segment]);
-    }
-  }
-  return variants.map(routeSegmentsToTsTypeLiteral);
-}
-function routePatternToRouteLiteral(pattern) {
-  return JSON.stringify(pattern);
-}
-function renderTypeUnion(values) {
-  return values.length <= 1 ? values[0] || "never" : `
-  | ${values.join("\n  | ")}`;
-}
-function renderTypeAlias(name, value) {
-  return `export type ${name} =${value.startsWith("\n") ? "" : " "}${value};`;
-}
-function createRoutePattern(route) {
-  if (route.segments.length === 0) return "/";
-  return "/" + route.segments.map((seg) => {
-    if (!seg.isDynamic) return seg.segment;
-    if (seg.isCatchAll) return seg.isOptional ? `[[...${seg.segment}]]` : `[...${seg.segment}]`;
-    return `[${seg.segment}]`;
-  }).join("/");
-}
-var DEFAULT_OUT_FILE = "farm-routes.d.ts";
-async function generateRouteTypes(options) {
-  const root = path.resolve(options.root);
-  const srcDir = options.srcDir || "src";
-  const outFile = options.outFile || DEFAULT_OUT_FILE;
-  const outPath = path.isAbsolute(outFile) ? outFile : path.join(root, srcDir, outFile);
-  const content = await createRouteTypeDeclarations(options, outPath);
-  fs.mkdirSync(path.dirname(outPath), { recursive: true });
-  _chunk5YPBFMBNcjs.writeFileIfChanged.call(void 0, outPath, content);
-  return outPath;
-}
-async function createRouteTypeDeclarations(options, outPath) {
-  const { root, srcDir = "src", extraRoutes = [], suppressLintOnLink = false } = options;
-  const sourceRoots = _nullishCoalesce(options.sourceRoots, () => ( [{ name: "project", root, srcDir, layer: false }]));
-  const componentExtensions = _chunkRD623KW4cjs.resolveFarmComponentExtensions.call(void 0, options.componentExtensions).map(
-    (extension) => extension.slice(1)
-  );
-  const patterns = /* @__PURE__ */ new Set();
-  const routeModulePatterns = /* @__PURE__ */ new Set();
-  const glob = await import("fast-glob");
-  for (const source of sourceRoots) {
-    const appDir = path.join(source.root, source.srcDir, "app");
-    if (fs.existsSync(appDir)) {
-      const routeModuleFiles = await glob.default(
-        `**/{page,layout,loading,error}.{${componentExtensions.join(",")},md,mdx}`,
-        {
-          cwd: appDir,
-          absolute: false
-        }
-      );
-      for (const file of routeModuleFiles) {
-        if (_chunkJ2ZEVDEKcjs.parseRouteSlotFile.call(void 0, file)) continue;
-        const route = _chunkXN2MB4QZcjs.parseRoutePath.call(void 0, file);
-        const pattern = createRoutePattern(route);
-        routeModulePatterns.add(pattern);
-        if (route.type === "page") {
-          patterns.add(pattern);
-        }
-      }
-    }
-    for (const route of await _chunkJZMZKABScjs.discoverProgrammaticRoutePaths.call(void 0, source.root, source.srcDir)) {
-      patterns.add(route);
-      routeModulePatterns.add(route);
-    }
-  }
-  for (const route of extraRoutes) {
-    if (route.startsWith("/")) {
-      patterns.add(route);
-      routeModulePatterns.add(route);
-    }
-  }
-  const sortedPatterns = Array.from(patterns).sort();
-  const typeLiterals = Array.from(new Set(sortedPatterns.flatMap(routePatternToTsTypeLiterals)));
-  const patternLiterals = sortedPatterns.map(routePatternToRouteLiteral);
-  const routeModulePatternLiterals = Array.from(routeModulePatterns).sort().map(routePatternToRouteLiteral);
-  const routePathType = suppressLintOnLink ? "string" : renderTypeUnion(typeLiterals);
-  const routePatternType = suppressLintOnLink ? "string" : renderTypeUnion(patternLiterals);
-  const routeModulePatternType = renderTypeUnion(routeModulePatternLiterals);
-  const routeTypesImportPath = `./${path.basename(outPath).replace(/\.d\.ts$/, "")}`;
-  const linkAugmentationBlock = suppressLintOnLink ? "" : `
-declare module "@farm.js/core/client" {
-  interface LinkDefaultRoute {
-    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
-    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
-  }
-}
-
-declare module "@farm.js/core" {
-  interface LinkDefaultRoute {
-    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
-    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
-  }
-  // Ensure root import ("@farm.js/core") uses the same typed Link signature as client entry.
-  const Link: typeof import("@farm.js/core/client").Link;
-}
-
-// Internal declaration path used by @farm.js/core root type re-exports.
-declare module "@farm.js/core/dist/client.js" {
-  interface LinkDefaultRoute {
-    _: import(${JSON.stringify(routeTypesImportPath)}).RoutePath;
-    pattern: import(${JSON.stringify(routeTypesImportPath)}).RoutePattern;
-  }
-}
-`;
-  const routeModuleAugmentationBlock = `
-declare global {
-  namespace FarmJS {
-    interface RouteRegistry {
-      pattern: import(${JSON.stringify(routeTypesImportPath)}).RouteModulePattern;
-    }
-  }
-}
-`;
-  const content = `/**
- * Auto-generated route types from src/app.
- * Link href and route component props are typed automatically from generated declarations.
- * Regenerated on dev start and when routes change.
- * Set suppressLintOnLink: true in farm.config.ts to accept any string on Link href.
- */
-${renderTypeAlias("RoutePath", routePathType)}
-${renderTypeAlias("RoutePattern", routePatternType)}
-${renderTypeAlias("RouteModulePattern", routeModulePatternType)}${linkAugmentationBlock}${routeModuleAugmentationBlock}
-`;
-  return content;
-}
-
 // src/image-types.ts
 
-
+var _path = require('path'); var path2 = _interopRequireWildcard(_path);
 var FARM_STATIC_IMAGE_EXTENSIONS = ["avif", "gif", "jpeg", "jpg", "png", "webp"];
 function generateFarmImageTypes(options) {
-  const outputPath = options.outFile ? path.default.resolve(options.root, options.outFile) : path.default.join(options.root, options.srcDir || "src", "farm-images.d.ts");
-  _fs.mkdirSync.call(void 0, path.default.dirname(outputPath), { recursive: true });
+  const outputPath = options.outFile ? path2.default.resolve(options.root, options.outFile) : path2.default.join(options.root, options.srcDir || "src", "farm-images.d.ts");
+  _fs.mkdirSync.call(void 0, path2.default.dirname(outputPath), { recursive: true });
   _chunk5YPBFMBNcjs.writeFileIfChanged.call(void 0, outputPath, createFarmImageTypeDeclarations());
   return outputPath;
 }
@@ -768,10 +610,10 @@ var CONFIG_FILENAMES = [
   "config.cjs"
 ];
 function createContentTypeDeclarations(options, outPath) {
-  const root = path3.resolve(options.root);
+  const root = path2.resolve(options.root);
   const projectConfig = findConfigPath(root, options.configPath);
   const configPaths = [
-    ...(_nullishCoalesce(options.layerConfigPaths, () => ( []))).filter((value) => fs2.existsSync(value)),
+    ...(_nullishCoalesce(options.layerConfigPaths, () => ( []))).filter((value) => fs.existsSync(value)),
     ...projectConfig ? [projectConfig] : []
   ];
   if (configPaths.length === 0) return createEmptyContentTypes();
@@ -839,17 +681,17 @@ export {};
 }
 function findConfigPath(root, configPath) {
   if (configPath) {
-    const resolvedPath = path3.isAbsolute(configPath) ? configPath : path3.join(root, configPath);
-    return fs2.existsSync(resolvedPath) ? resolvedPath : null;
+    const resolvedPath = path2.isAbsolute(configPath) ? configPath : path2.join(root, configPath);
+    return fs.existsSync(resolvedPath) ? resolvedPath : null;
   }
   for (const filename of CONFIG_FILENAMES) {
-    const resolvedPath = path3.join(root, filename);
-    if (fs2.existsSync(resolvedPath)) return resolvedPath;
+    const resolvedPath = path2.join(root, filename);
+    if (fs.existsSync(resolvedPath)) return resolvedPath;
   }
   return null;
 }
 function toTypeImportPath(outPath, targetPath) {
-  const relativePath = path3.relative(path3.dirname(outPath), targetPath).replace(/\\/g, "/").replace(/\.(tsx?|jsx?|mjs|cjs|mts|cts)$/, "");
+  const relativePath = path2.relative(path2.dirname(outPath), targetPath).replace(/\\/g, "/").replace(/\.(tsx?|jsx?|mjs|cjs|mts|cts)$/, "");
   return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 }
 
@@ -950,7 +792,7 @@ async function generateFarmTypeArtifacts(options) {
       componentExtensions: options.componentExtensions,
       sourceRoots
     };
-    unifiedSections.push(await createRouteTypeDeclarations(routeOptions, unifiedTypesPath));
+    unifiedSections.push(await _chunk3ATXWZPHcjs.createRouteTypeDeclarations.call(void 0, routeOptions, unifiedTypesPath));
     result.routeTypesPath = unifiedTypesPath;
   } else if (shouldGenerateRoutes) {
     const routeOptions = {
@@ -964,11 +806,11 @@ async function generateFarmTypeArtifacts(options) {
     };
     if (options.check) {
       const routeTypesPath = resolveGeneratedPath(root, srcDir, options.routeTypesOutFile);
-      const content = await createRouteTypeDeclarations(routeOptions, routeTypesPath);
+      const content = await _chunk3ATXWZPHcjs.createRouteTypeDeclarations.call(void 0, routeOptions, routeTypesPath);
       checkGeneratedFile(routeTypesPath, content, result.stalePaths);
       result.routeTypesPath = routeTypesPath;
     } else {
-      result.routeTypesPath = await generateRouteTypes(routeOptions);
+      result.routeTypesPath = await _chunk3ATXWZPHcjs.generateRouteTypes.call(void 0, routeOptions);
     }
   }
   if (shouldGenerateApi) {
@@ -1177,5 +1019,4 @@ function collectLegacyTypeArtifacts(root, srcDir, stalePaths) {
 
 
 
-
-exports.resolveRouteRenderingConfig = resolveRouteRenderingConfig; exports.resolveRouteRenderingConfigFromFile = resolveRouteRenderingConfigFromFile; exports.analyzeStaticRouteCandidate = analyzeStaticRouteCandidate; exports.findRequestBoundSourceBlockers = findRequestBoundSourceBlockers; exports.parseRouteRenderingDirective = parseRouteRenderingDirective; exports.readRouteRenderingDirectiveFromFile = readRouteRenderingDirectiveFromFile; exports.collectSSGPages = collectSSGPages; exports.isSSGModule = isSSGModule; exports.hasISR = hasISR; exports.getRevalidateInterval = getRevalidateInterval; exports.hasPPR = hasPPR; exports.generateSSGManifest = generateSSGManifest; exports.matchSSGPage = matchSSGPage; exports.generateRouteTypes = generateRouteTypes; exports.generateFarmImageTypes = generateFarmImageTypes; exports.createFarmImageTypeDeclarations = createFarmImageTypeDeclarations; exports.generateFarmI18nTypes = generateFarmI18nTypes; exports.generateFarmTypeArtifacts = generateFarmTypeArtifacts;
+exports.resolveRouteRenderingConfig = resolveRouteRenderingConfig; exports.resolveRouteRenderingConfigFromFile = resolveRouteRenderingConfigFromFile; exports.analyzeStaticRouteCandidate = analyzeStaticRouteCandidate; exports.findRequestBoundSourceBlockers = findRequestBoundSourceBlockers; exports.parseRouteRenderingDirective = parseRouteRenderingDirective; exports.readRouteRenderingDirectiveFromFile = readRouteRenderingDirectiveFromFile; exports.collectSSGPages = collectSSGPages; exports.isSSGModule = isSSGModule; exports.hasISR = hasISR; exports.getRevalidateInterval = getRevalidateInterval; exports.hasPPR = hasPPR; exports.generateSSGManifest = generateSSGManifest; exports.matchSSGPage = matchSSGPage; exports.generateFarmImageTypes = generateFarmImageTypes; exports.createFarmImageTypeDeclarations = createFarmImageTypeDeclarations; exports.generateFarmI18nTypes = generateFarmI18nTypes; exports.generateFarmTypeArtifacts = generateFarmTypeArtifacts;

package/dist/{chunk-TQWGOQ7O.mjs → chunk-IWJKJDNW.mjs}

@@ -2,16 +2,20 @@ import {
   collectSSGPages,
   matchSSGPage,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-HNAUK3SC.mjs";
+} from "./chunk-SHJJM6OG.mjs";
 import {
   createFarmMetadataImageResponse
-} from "./chunk-GBPDSUFE.mjs";
+} from "./chunk-OZK2DS44.mjs";
+import {
+  resolveFarmPlatform
+} from "./chunk-SMUW7UST.mjs";
 import {
   classifyFarmDocumentPrefix,
   composeFarmFullDocument,
   createDefaultErrorMarkup,
   createFarmMetadataRouteResponse,
   createFarmRouteRenderPlan,
+  createFarmStreamedDocumentTransform,
   createFarmThemeDocumentParts,
   createLateNotFoundRecovery,
   createLateRedirectRecovery,
@@ -24,14 +28,15 @@ import {
   getRouteDirectoryDepth,
   getRouteGroupScope,
   isInRouteGroupScope,
+  openFarmStreamedDocument,
   removeFarmDocumentTitles,
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus,
   routeBoundaryCoversDirectory
-} from "./chunk-NIPKC4DA.mjs";
+} from "./chunk-ZIBIE7AH.mjs";
 import {
   listFarmMCPLlmsTxtLinks
-} from "./chunk-NRFUVDTH.mjs";
+} from "./chunk-JJOWY3XD.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   collectFarmDefaultMCPPages,
@@ -46,7 +51,7 @@ import {
 } from "./chunk-A4PWGL46.mjs";
 import {
   handleFarmFormActionRequest
-} from "./chunk-MJ6IC4K2.mjs";
+} from "./chunk-OTOOJIUB.mjs";
 import {
   FARM_ISLAND_REPLAYABLE_SELECTOR,
   isFarmIslandStrategy
@@ -56,6 +61,13 @@ import {
   mergeProgrammaticClientRoutes,
   resolveProgrammaticClientRoutes
 } from "./chunk-C5JXCUKR.mjs";
+import {
+  createFarmMarkdownRouteModuleFromFile,
+  loadFarmMdxComponents
+} from "./chunk-YVJV7Q2X.mjs";
+import {
+  isFarmMarkdownPageFile
+} from "./chunk-GW4YUIHW.mjs";
 import {
   _setDefaultFarmThemeConfig,
   getTheme
@@ -116,29 +128,22 @@ import {
   getFarmAppDirectories,
   getFarmSourceRoots
 } from "./chunk-52Y3C3HG.mjs";
+import {
+  resolveFarmMdxComponentsModulePath,
+  resolveMdxConfig
+} from "./chunk-UIJOLBUL.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-ATHPRVP2.mjs";
+} from "./chunk-5V4KZOZO.mjs";
 import {
   resolveCronConfig
 } from "./chunk-UCQ52TJY.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-JOHXK4BB.mjs";
+} from "./chunk-BW6SCVYX.mjs";
 import {
   resolveFarmThemeConfig
 } from "./chunk-YWPNIYUP.mjs";
-import {
-  createFarmMarkdownRouteModuleFromFile,
-  loadFarmMdxComponents
-} from "./chunk-YVJV7Q2X.mjs";
-import {
-  isFarmMarkdownPageFile
-} from "./chunk-GW4YUIHW.mjs";
-import {
-  resolveFarmMdxComponentsModulePath,
-  resolveMdxConfig
-} from "./chunk-UIJOLBUL.mjs";
 import {
   FARM_MARKDOWN_CONTENT_TYPE,
   FARM_MARKDOWN_PAGE_CHECK_HEADER,
@@ -159,7 +164,7 @@ import {
   getIntegrationProviders,
   getRegisteredIntegrationAPIManifest,
   isFarmIntegrationProviderComponentReference
-} from "./chunk-NW2BKDVT.mjs";
+} from "./chunk-HHFMECFO.mjs";
 import {
   createRouteSlotContainerId,
   parseRouteSlotFile
@@ -208,7 +213,7 @@ import {
 } from "./chunk-VHIXGZYH.mjs";
 import {
   loadFarmDevModule
-} from "./chunk-JUMPFVMK.mjs";
+} from "./chunk-TUOO6IK3.mjs";
 import {
   resolveFarmI18nConfig
 } from "./chunk-MU5V7XHL.mjs";
@@ -239,7 +244,7 @@ import {
 import {
   matchesFarmIfNoneMatch,
   resolveFarmServerConfig
-} from "./chunk-C6U66WWF.mjs";
+} from "./chunk-GFT5AHAT.mjs";
 import {
   getRequestContextSnapshot
 } from "./chunk-D2LCAV6L.mjs";
@@ -248,7 +253,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-HRLYO2XJ.mjs";
+} from "./chunk-2VCC3GVC.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -4565,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 || ""}
@@ -6767,7 +6772,8 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
   async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
     const renderToPipeableStream = this.rendererRuntime.renderToPipeableStream;
     const fullDocumentRouteKey = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
-    if (!renderToPipeableStream || _isFarmMarkdownPageCheck(req.headers?.[FARM_MARKDOWN_PAGE_CHECK_HEADER]) || fullDocumentRoutes.has(fullDocumentRouteKey) || await this.rootLayoutRendersDocument()) {
+    const streamDocument = fullDocumentRoutes.has(fullDocumentRouteKey) || await this.rootLayoutRendersDocument();
+    if (!renderToPipeableStream || _isFarmMarkdownPageCheck(req.headers?.[FARM_MARKDOWN_PAGE_CHECK_HEADER]) || streamDocument && (options.captureStaticShell || !isReactRenderer(this.config.renderer))) {
       return this.renderBufferedSSR(element, req, res, clearMiddlewareData, options);
     }
     return new Promise((resolve3, reject) => {
@@ -6879,6 +6885,7 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
         title,
         tags: metaTags,
         hasFavicon,
+        hasExplicitTitle,
         viewport: viewportTags
       } = renderMetadataHead(req.__FARM_METADATA__, {
         pathname: getFarmMetadataPathname(req),
@@ -6944,25 +6951,70 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
 <body class="">${earlyClient ? `
   ${FARM_DEV_EARLY_CLIENT_SCRIPT}` : ""}
   <div id="root">`;
-          const securedShell = stampDocumentHTML(shell);
-          htmlParts.push(securedShell);
-          staticShellParts?.push(securedShell);
+          const securedShell = streamDocument ? "" : stampDocumentHTML(shell);
+          if (securedShell) {
+            htmlParts.push(securedShell);
+            staticShellParts?.push(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 ? createFarmStreamedDocumentTransform(
+            (opening) => withEarlyClient(
+              openFarmStreamedDocument(
+                hasExplicitTitle ? removeFarmDocumentTitles(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 ? createFarmCspNonceRewriter(cspNonce) : void 0;
           const cspStreamDecoder = cspNonceRewriter ? new TextDecoder() : void 0;
-          const recordRenderedChunk = (chunkText) => {
-            if (!chunkText) return;
-            if (!checkedFullDocument) {
-              documentPrefix += chunkText;
+          const recordRenderedChunk = (chunkText, renderedText = chunkText) => {
+            if (!checkedFullDocument && renderedText) {
+              documentPrefix += renderedText;
               const prefix = classifyFarmDocumentPrefix(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);
@@ -6988,12 +7040,16 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
               }
               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) => {
@@ -7002,7 +7058,8 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
                 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);
@@ -7019,16 +7076,24 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
           });
           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 = documentTransform?.end();
+            if (documentEnd?.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.
+                ...documentEnd?.document ? { closeRoot: documentEnd.rootOpened } : {}
               })
             );
             htmlParts.push(footer);
@@ -7850,6 +7915,12 @@ var CLIENT_KEYS = [
 ];
 var HYDRATION_KEYS = ["before", "after"];
 var NAVIGATION_KEYS = ["before", "loaded", "resolved", "rendered", "error"];
+var MOBILE_SHELL_CLIENT_IMPORT = 'import { farmMobileShellClient as __farmMobileShellClient } from "@farm.js/core/internal/client-runtime";';
+var MOBILE_SHELL_CLIENT_REGISTRATION = `  {
+    name: "farm:mobile-shell",
+    enforce: "pre",
+    definition: __farmMobileShellClient,
+  }`;
 var APP_CLIENT_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mts", "mjs"];
 function resolveFarmAppClientEntry(root = process.cwd(), srcDir = "src") {
   const sourceRoot = path13.resolve(root, srcDir);
@@ -7879,15 +7950,20 @@ function resolveFarmClientPlugins(plugins, _root) {
 function generateFarmClientPluginEntryCode(plugins, root, srcDir = "src", appPublicData) {
   const resolved = resolveFarmClientPlugins(plugins, root);
   const appClientEntry = root ? resolveFarmAppClientEntry(root, srcDir) : void 0;
-  const imports = appClientEntry ? `import farmAppClientDefinition from ${JSON.stringify(appClientEntry.replace(/\\/g, "/"))};` : "";
-  const serializedPlugins = resolved.map(
-    (plugin) => `  {
+  const appImport = appClientEntry ? `import farmAppClientDefinition from ${JSON.stringify(appClientEntry.replace(/\\/g, "/"))};` : "";
+  const mobileShell = resolveFarmPlatform() === "mobile";
+  const imports = mobileShell ? [MOBILE_SHELL_CLIENT_IMPORT, appImport].filter(Boolean).join("\n") : appImport;
+  const serializedPlugins = mobileShell ? [MOBILE_SHELL_CLIENT_REGISTRATION] : [];
+  serializedPlugins.push(
+    ...resolved.map(
+      (plugin) => `  {
     name: ${JSON.stringify(plugin.name)},
     version: ${serializeOptionalString(plugin.version)},
     enforce: ${serializeOptionalString(plugin.enforce)},
     definition: ${serializeClientLifecycle(plugin.definition, plugin.name)},
     public: ${serializePublicData(plugin.publicData)},
   }`
+    )
   );
   if (appClientEntry) {
     assertPublicData(appPublicData, "farm:app-client");