@farm.js/core 0.1.0-beta.46 → 0.1.0-beta.48

package/dist/internal/client-runtime.mjs

@@ -1,12 +1,12 @@
 import {
   createClientPluginManager,
   installChunkErrorRecovery
-} from "../chunk-W2O6SKJU.mjs";
+} from "../chunk-3P63LWDM.mjs";
 import {
   searchParamsToObject
 } from "../chunk-4DCGM2BW.mjs";
 import "../chunk-FXG2PS27.mjs";
-import "../chunk-LGCIIMFR.mjs";
+import "../chunk-NKIHYEWC.mjs";
 import {
   __name
 } from "../chunk-CGILA3WO.mjs";

package/dist/plugin.cjs

@@ -15620,6 +15620,57 @@ __name(safeGlobFiles, "safeGlobFiles");
 // src/server/renderer.ts
 var fs3 = __toESM(require("fs"));
 var path11 = __toESM(require("path"));
+
+// src/server/full-document.ts
+function stripContentsWrappers(markup) {
+  let out = markup.replace(/^\s+/, "");
+  const opener = /^<div\b[^>]*style="display\s*:\s*contents"[^>]*>/i;
+  let match;
+  while (match = opener.exec(out)) {
+    out = out.slice(match[0].length).replace(/^\s+/, "");
+  }
+  return out;
+}
+__name(stripContentsWrappers, "stripContentsWrappers");
+function extractFarmFullDocument(markup) {
+  const inner = stripContentsWrappers(markup);
+  if (!/^<!doctype/i.test(inner) && !/^<html[\s>]/i.test(inner)) return null;
+  const start = markup.search(/<!doctype|<html[\s>]/i);
+  const closeIndex = markup.toLowerCase().lastIndexOf("</html>");
+  if (start < 0 || closeIndex < 0) return null;
+  return markup.slice(start, closeIndex + "</html>".length);
+}
+__name(extractFarmFullDocument, "extractFarmFullDocument");
+function opensFarmFullDocument(markup) {
+  const inner = stripContentsWrappers(markup);
+  return /^<!doctype/i.test(inner) || /^<html[\s>]/i.test(inner);
+}
+__name(opensFarmFullDocument, "opensFarmFullDocument");
+function composeFarmFullDocument(documentHtml, assets) {
+  let html = documentHtml;
+  if (assets.htmlAttributes) {
+    html = html.replace(
+      /<html\b([^>]*)>/i,
+      (_match, attrs) => `<html${attrs}${assets.htmlAttributes}>`
+    );
+  }
+  if (!/\sid=["']root["']/i.test(html)) {
+    html = html.replace(/<body\b([^>]*)>/i, '<body$1><div id="root">').replace(/<\/body>/i, "</div></body>");
+  }
+  if (assets.headAssets) {
+    html = html.replace(/<\/head>/i, () => `  ${assets.headAssets}
+</head>`);
+  }
+  if (assets.bodyFooter) {
+    html = html.replace(/<\/body>/i, () => `  ${assets.bodyFooter}
+</body>`);
+  }
+  return /^\s*<!doctype/i.test(html) ? html : `<!DOCTYPE html>
+${html}`;
+}
+__name(composeFarmFullDocument, "composeFarmFullDocument");
+
+// src/server/renderer.ts
 var import_stream = require("stream");
 
 // src/middleware/server.ts
@@ -18970,7 +19021,7 @@ _setFarmThemeServerSnapshotResolver(() => {
 });
 
 // package.json
-var version = "0.1.0-beta.46";
+var version = "0.1.0-beta.48";
 
 // src/version.ts
 var FARM_VERSION = version;
@@ -19079,6 +19130,16 @@ function warnSuppressedAsyncHydrationOnce(modulePath) {
   );
 }
 __name(warnSuppressedAsyncHydrationOnce, "warnSuppressedAsyncHydrationOnce");
+var fullDocumentRoutes = /* @__PURE__ */ new Set();
+var warnedFullDocumentLayout = false;
+function warnFarmFullDocumentLayout() {
+  if (warnedFullDocumentLayout) return;
+  warnedFullDocumentLayout = true;
+  logger.warn(
+    `A root layout returned a full <html> document. Farm.js owns the document shell, so a layout should return a fragment (its children) \u2014 like the docs example \u2014 and let the framework provide <html>/<head>/<body>. The document has been composed into the response, but returning a fragment avoids the ambiguity and keeps dev and production identical.`
+  );
+}
+__name(warnFarmFullDocumentLayout, "warnFarmFullDocumentLayout");
 function hasRequestHeader(req, name2) {
   const value = req.headers[name2.toLowerCase()];
   return Array.isArray(value) ? value.length > 0 : Boolean(value);
@@ -20532,7 +20593,27 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
         this.config.basePath,
         getTheme()
       );
-      const html = `<!DOCTYPE html>
+      const fullDocument = extractFarmFullDocument(content);
+      let html;
+      if (fullDocument) {
+        warnFarmFullDocumentLayout();
+        html = composeFarmFullDocument(fullDocument, {
+          htmlAttributes: `${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}`,
+          headAssets: [
+            themeDocument.head,
+            `<meta name="farm-deployment-id" content="${escapeHtmlAttribute2(deploymentId)}">`,
+            metaTags,
+            alternateTags,
+            renderFarmFontDevHead(this.config.root || process.cwd()),
+            `<link rel="stylesheet" href="/src/app/globals.css">`,
+            `<script type="module" src="/@vite/client"></script>`,
+            rendererHydrationScript,
+            bootstrapScript
+          ].filter(Boolean).join("\n  "),
+          bodyFooter: [deferredScript, `<script type="module" src="/@farm/client.js"></script>`].filter(Boolean).join("\n  ")
+        });
+      } else {
+        html = `<!DOCTYPE html>
 <html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
 <head>
   ${themeDocument.head}
@@ -20553,6 +20634,7 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
   <script type="module" src="/@farm/client.js"></script>
 </body>
 </html>`;
+      }
       emitFarmEvent({
         type: "render.stream.shellReady",
         route,
@@ -20575,7 +20657,8 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
   }
   async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
     const renderToPipeableStream2 = this.rendererRuntime.renderToPipeableStream;
-    if (!renderToPipeableStream2) {
+    const fullDocumentRouteKey = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
+    if (!renderToPipeableStream2 || fullDocumentRoutes.has(fullDocumentRouteKey)) {
       return this.renderBufferedSSR(element, req, res, clearMiddlewareData, options);
     }
     return new Promise((resolve8, reject) => {
@@ -20722,6 +20805,7 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
           htmlParts.push(shell);
           staticShellParts?.push(shell);
           let firstChunk = true;
+          let checkedFullDocument = false;
           const writableStream = new import_stream.Writable({
             write(chunk, encoding, callback) {
               if (firstChunk && process.env.FARM_VERBOSE) {
@@ -20729,6 +20813,13 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(
                 firstChunk = false;
               }
               const chunkText = Buffer.isBuffer(chunk) ? chunk.toString() : String(chunk);
+              if (!checkedFullDocument) {
+                checkedFullDocument = true;
+                if (opensFarmFullDocument(chunkText)) {
+                  fullDocumentRoutes.add(fullDocumentRouteKey);
+                  warnFarmFullDocumentLayout();
+                }
+              }
               htmlParts.push(chunkText);
               if (staticShellParts && !staticShellClosed) {
                 const dynamicIndex = findPPRDynamicChunkIndex(chunkText);
@@ -20927,6 +21018,24 @@ ${i18nSnapshot ? `window.__FARM_I18N__ = ${serializeInlineValue2(i18nSnapshot)};
       getTheme()
     );
     const rendererHydrationScript = this.rendererRuntime.generateHydrationScript?.() || "";
+    const fullDocument = extractFarmFullDocument(content);
+    if (fullDocument) {
+      warnFarmFullDocumentLayout();
+      return composeFarmFullDocument(fullDocument, {
+        htmlAttributes: `${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}`,
+        headAssets: [
+          themeDocument.head,
+          `<meta name="farm-deployment-id" content="${escapeHtmlAttribute2(this.getDeploymentId())}">`,
+          alternateLinks,
+          fontHead,
+          `<link rel="stylesheet" href="/src/app/globals.css" />`,
+          `<script type="module" src="/@vite/client"></script>`,
+          rendererHydrationScript,
+          integrationManifestScript
+        ].filter(Boolean).join("\n  "),
+        bodyFooter: clientScript.trim()
+      });
+    }
     return `<!DOCTYPE html>
 <html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
 <head>