@farm.js/core 0.1.18 → 0.1.20

package/dist/{chunk-NZ2JVBT2.mjs → chunk-GZ3ZPTQV.mjs}

@@ -1,9 +1,9 @@
 import {
   useRouter
-} from "./chunk-A7T6345N.mjs";
+} from "./chunk-5UX4C5QI.mjs";
 import {
   getRouter
-} from "./chunk-RKQVJN2O.mjs";
+} from "./chunk-JIKGGIOL.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-4RB44K6Z.mjs";

package/dist/{chunk-DHDVMXYK.mjs → chunk-HALDNTIV.mjs}

@@ -7,6 +7,28 @@ import {
   __name
 } from "./chunk-LPEX4YW6.mjs";
 
+// src/schema-sql-identifiers.ts
+var POSTGRES_IDENTIFIER_BYTES = 63;
+function fitSqlIndexName(dialect, name) {
+  if (dialect !== "postgres") return name;
+  const encoder = new TextEncoder();
+  const bytes = encoder.encode(name);
+  if (bytes.length <= POSTGRES_IDENTIFIER_BYTES) return name;
+  let hash = 2166136261;
+  for (const byte of bytes) hash = Math.imul(hash ^ byte, 16777619);
+  const suffix = `_${(hash >>> 0).toString(16).padStart(8, "0")}`;
+  let prefix = "";
+  let length = 0;
+  for (const character of name) {
+    const size = encoder.encode(character).length;
+    if (length + size > POSTGRES_IDENTIFIER_BYTES - suffix.length) break;
+    prefix += character;
+    length += size;
+  }
+  return prefix + suffix;
+}
+__name(fitSqlIndexName, "fitSqlIndexName");
+
 // src/schema-sql.ts
 function describeSchemaReference(model, fieldKey) {
   const field = model.model.fields[fieldKey];
@@ -155,14 +177,17 @@ function collectSchemaIndexes(model, dialect) {
       continue;
     }
     definitions.push({
-      name: `${model.modelName}_${field.name}_idx`,
+      name: fitSqlIndexName(dialect, `${model.modelName}_${field.name}_idx`),
       columns: [quoteSqlIdentifier(dialect, field.name)],
       unique: false
     });
   }
   for (const constraint of model.model.constraints || []) {
     definitions.push({
-      name: constraint.name || `${model.modelName}_${constraint.fields.map((fieldKey) => model.model.fields[fieldKey]?.name || fieldKey).join("_")}_${constraint.type}`,
+      name: fitSqlIndexName(
+        dialect,
+        constraint.name || `${model.modelName}_${constraint.fields.map((fieldKey) => model.model.fields[fieldKey]?.name || fieldKey).join("_")}_${constraint.type}`
+      ),
       columns: constraint.fields.map(
         (fieldKey) => quoteSqlIdentifier(dialect, model.model.fields[fieldKey]?.name || fieldKey)
       ),
@@ -473,11 +498,12 @@ async function planSchemaMigration(models, dialect, executor) {
         continue;
       }
       const columns = index.columns.map((column) => quoteSqlIdentifier(dialect, column)).join(", ");
+      const name = fitSqlIndexName(dialect, index.name);
       upgrades.push({
         kind: "index",
         table: model.modelName,
-        target: index.name,
-        sql: `CREATE INDEX${dialect === "mysql" ? "" : " IF NOT EXISTS"} ${quoteSqlIdentifier(dialect, index.name)} ON ${quoteTableName(dialect, model.modelName)} (${columns});`
+        target: name,
+        sql: `CREATE INDEX${dialect === "mysql" ? "" : " IF NOT EXISTS"} ${quoteSqlIdentifier(dialect, name)} ON ${quoteTableName(dialect, model.modelName)} (${columns});`
       });
     }
     const entry = {

package/dist/{chunk-5QOEPUYE.mjs → chunk-HSDL2AUR.mjs}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-TVGP4BBZ.mjs";
 import {
   farmAcceptQuality
-} from "./chunk-SXHV42UQ.mjs";
+} from "./chunk-OFEY6KHO.mjs";
 import {
   matchesFarmIfNoneMatch
 } from "./chunk-XF7Q24PF.mjs";

package/dist/{chunk-BSTRERPP.cjs → chunk-I5YBCWQ6.cjs}

@@ -1,6 +1,6 @@
 "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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } 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 _chunkE2BMSZ2Wcjs = require('./chunk-E2BMSZ2W.cjs');
+var _chunkAH7HOAQ3cjs = require('./chunk-AH7HOAQ3.cjs');
 
 
 var _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
@@ -11,7 +11,7 @@ var _path = require('path'); var _path2 = _interopRequireDefault(_path);
 var _url = require('url');
 async function createFarmMarkdownRouteModuleFromFile(filePath, options = {}) {
   const source = await _promises.readFile.call(void 0, filePath, "utf8");
-  return _chunkE2BMSZ2Wcjs.createFarmMarkdownRouteModule.call(void 0, {
+  return _chunkAH7HOAQ3cjs.createFarmMarkdownRouteModule.call(void 0, {
     source,
     filePath,
     components: options.components,

package/dist/{chunk-TYQUSXUG.cjs → chunk-ISTFC3MZ.cjs}

@@ -2,7 +2,7 @@
 
 
 
-var _chunkTWGMSEHXcjs = require('./chunk-TWGMSEHX.cjs');
+var _chunkBBVSJVBZcjs = require('./chunk-BBVSJVBZ.cjs');
 
 
 var _chunkI57LW5VZcjs = require('./chunk-I57LW5VZ.cjs');
@@ -63,11 +63,11 @@ function collectFarmLlmsTxtPages(sources, options) {
   for (const source of sources) {
     const path = source.pattern;
     if (path.includes("[") || pages.has(path)) continue;
-    if (include.length && !include.some((pattern) => _chunkTWGMSEHXcjs.matchesFarmMarkdownRoutePattern.call(void 0, pattern, path))) {
+    if (include.length && !include.some((pattern) => _chunkBBVSJVBZcjs.matchesFarmMarkdownRoutePattern.call(void 0, pattern, path))) {
       continue;
     }
-    if (exclude.some((pattern) => _chunkTWGMSEHXcjs.matchesFarmMarkdownRoutePattern.call(void 0, pattern, path))) continue;
-    const target = _chunkTWGMSEHXcjs.isFarmMarkdownMirrorExposed.call(void 0, options.markdown, path) ? _chunkTWGMSEHXcjs.getFarmMarkdownMirrorPath.call(void 0, path) : path;
+    if (exclude.some((pattern) => _chunkBBVSJVBZcjs.matchesFarmMarkdownRoutePattern.call(void 0, pattern, path))) continue;
+    const target = _chunkBBVSJVBZcjs.isFarmMarkdownMirrorExposed.call(void 0, options.markdown, path) ? _chunkBBVSJVBZcjs.getFarmMarkdownMirrorPath.call(void 0, path) : path;
     const description = readMetadataString(source.metadata, "description");
     pages.set(path, {
       path,

package/dist/{chunk-RKQVJN2O.mjs → chunk-JIKGGIOL.mjs}

@@ -16,7 +16,7 @@ import {
   FARM_METADATA_ATTRIBUTE,
   renderMetadataHead,
   resolveMetadataTitle
-} from "./chunk-YS3TRKCG.mjs";
+} from "./chunk-2M435BUE.mjs";
 import {
   createFarmDeploymentMismatchError,
   createFarmDeploymentRequestHeaders,

package/dist/{chunk-GYKJCFTS.mjs → chunk-K6MG3SEG.mjs}

@@ -6,12 +6,12 @@ import {
   parseRouteSlotFile,
   resolveRouteRenderingConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-EN7WTEAY.mjs";
+} from "./chunk-NRS46D4L.mjs";
 import {
   collectSchemaExtensions,
   declareSchemaTables,
   readSchemaTables
-} from "./chunk-DHDVMXYK.mjs";
+} from "./chunk-HALDNTIV.mjs";
 import {
   resolveSchemaModels
 } from "./chunk-ZMSZZXOR.mjs";
@@ -24,7 +24,7 @@ import {
   getDefaultErrorStatusText,
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus
-} from "./chunk-76DG3LF3.mjs";
+} from "./chunk-PGQBL5DN.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
@@ -48,6 +48,10 @@ import {
   _setDefaultFarmThemeConfig,
   getTheme
 } from "./chunk-WBIH66JK.mjs";
+import {
+  generateFarmDocsAdapterClientRuntime,
+  getFarmDocsAdapterConfigModule
+} from "./chunk-VVBO3QH7.mjs";
 import {
   resolveFarmDocsFontAssets,
   toFarmDocsPublicFontAssets
@@ -65,7 +69,7 @@ import {
 } from "./chunk-JBSVKMC5.mjs";
 import {
   normalizeRouteRules
-} from "./chunk-7WPA7GBZ.mjs";
+} from "./chunk-GHFS7RUB.mjs";
 import {
   getFarmAppDirectories,
   getFarmLayerAliases,
@@ -99,7 +103,7 @@ import {
   resolveFarmLlmsTxtConfig,
   resolveFarmPerformanceConfig,
   resolveFarmSecurityConfig
-} from "./chunk-ZCNJKLA2.mjs";
+} from "./chunk-7BC6GAL7.mjs";
 import {
   getPublicFarmImageConfig,
   resolveFarmImageConfig
@@ -117,12 +121,12 @@ import {
 import {
   createFarmMarkdownRouteModuleFromFile,
   loadFarmMdxComponents
-} from "./chunk-XWAYMDLB.mjs";
+} from "./chunk-MVUREHPN.mjs";
 import {
   createFarmMarkdownSourceResponse,
   isFarmMarkdownPageFile,
   normalizeFarmMarkdownRoutePath
-} from "./chunk-6VQIKZZO.mjs";
+} from "./chunk-N255VYFP.mjs";
 import {
   resolveFarmMdxComponentsModulePath,
   resolveMdxConfig
@@ -136,7 +140,7 @@ import {
   getFarmMarkdownMirrorPath,
   resolveMarkdownConfig,
   resolveMarkdownMirrorTarget
-} from "./chunk-SXHV42UQ.mjs";
+} from "./chunk-OFEY6KHO.mjs";
 import {
   resolveWorkflowsConfig
 } from "./chunk-EGJDUF4Q.mjs";
@@ -162,7 +166,7 @@ import {
 } from "./chunk-JLCQGPXE.mjs";
 import {
   MiddlewareManager
-} from "./chunk-57J3Y7Y3.mjs";
+} from "./chunk-TIKNUAU7.mjs";
 import {
   _clearCurrentMiddlewareContext,
   _clearCurrentMiddlewareData,
@@ -177,11 +181,11 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteManager
-} from "./chunk-ATERBVHQ.mjs";
+} from "./chunk-CQHFU55R.mjs";
 import {
   findProgrammaticRouteFiles,
   loadProgrammaticRouteManifests
-} from "./chunk-BNGS6KJ6.mjs";
+} from "./chunk-YOYF2E4U.mjs";
 import {
   _runWithFarmI18nRequest,
   _setDefaultFarmI18nRuntime,
@@ -208,7 +212,7 @@ import {
   normalizeFarmRouteRuntimeConfig,
   resolveFarmRouteRuleRuntimeConfig,
   resolveFarmRouteRuntimeConfig
-} from "./chunk-FS7FLPOG.mjs";
+} from "./chunk-2J7W2WND.mjs";
 import {
   clearRequestContext,
   copyRequestContext,
@@ -227,8 +231,10 @@ import {
   createCliColors
 } from "./chunk-I2BHUNBU.mjs";
 import {
+  invalidateFailedFarmDevModules,
+  loadFarmDevModule,
   toFileModuleUrl
-} from "./chunk-7GNWGLWB.mjs";
+} from "./chunk-43FMW62B.mjs";
 import {
   isFarmI18nCatalogFile,
   resolveFarmI18nConfig,
@@ -258,7 +264,7 @@ import {
 } from "./chunk-Z2RZJZIZ.mjs";
 import {
   FARM_VERSION
-} from "./chunk-3XG26Z3J.mjs";
+} from "./chunk-F7E2AZKQ.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -277,7 +283,7 @@ import {
   mergeMetadata,
   renderMetadataHead,
   resolveFarmNotFoundMetadata
-} from "./chunk-YS3TRKCG.mjs";
+} from "./chunk-2M435BUE.mjs";
 import {
   FARM_DEPLOYMENT_ID_HEADER,
   createFarmDeploymentCookie,
@@ -2388,7 +2394,7 @@ var _RouteManager = class _RouteManager {
         const mdxConfig = resolveMdxConfig(this.config.mdx);
         const components = await loadFarmMdxComponents(mdxConfig, {
           root: this.config.root,
-          loadModule: this.viteServer ? (componentModulePath) => this.viteServer.ssrLoadModule(componentModulePath) : void 0
+          loadModule: this.viteServer ? (componentModulePath) => loadFarmDevModule(this.viteServer, componentModulePath) : void 0
         });
         return await createFarmMarkdownRouteModuleFromFile(modulePath, {
           components,
@@ -2396,7 +2402,7 @@ var _RouteManager = class _RouteManager {
         });
       }
       if (this.viteServer) {
-        const module = await this.viteServer.ssrLoadModule(modulePath);
+        const module = await loadFarmDevModule(this.viteServer, modulePath);
         return module;
       } else {
         const module = await import(
@@ -2421,7 +2427,7 @@ var _RouteManager = class _RouteManager {
         return createLayoutModuleFromProgrammaticLayout(programmaticLayout);
       }
       if (this.viteServer) {
-        const module = await this.viteServer.ssrLoadModule(modulePath);
+        const module = await loadFarmDevModule(this.viteServer, modulePath);
         return module;
       } else {
         const module = await import(
@@ -2695,7 +2701,7 @@ var _RouteManager = class _RouteManager {
   async loadProgrammaticRoutesModule(filePath) {
     if (this.viteServer) {
       const viteRoot = this.viteServer.config?.root || this.config.root || process.cwd();
-      return await this.viteServer.ssrLoadModule(toViteModuleId(filePath, viteRoot));
+      return await loadFarmDevModule(this.viteServer, toViteModuleId(filePath, viteRoot));
     }
     return await import(
       /* @vite-ignore */
@@ -3012,18 +3018,29 @@ function collectDevStylesheetUrls(modules, alreadyLinked = ALREADY_LINKED) {
 __name(collectDevStylesheetUrls, "collectDevStylesheetUrls");
 
 // src/server/full-document.ts
-function stripContentsWrappers(markup) {
-  let out = markup.replace(/^\s+/, "");
-  const opener = /^<div\b[^>]*style="display\s*:\s*contents"[^>]*>/i;
+var CONTENTS_WRAPPER = /^<div\b[^>]*style="display\s*:\s*contents"[^>]*>/i;
+var HOISTED_HEAD_ELEMENT = /^(?:<(?:meta|link|base)\b[^>]*>|<title\b[^>]*>[\s\S]*?<\/title>)/i;
+function peelDocumentPrefix(markup) {
+  let inner = markup.replace(/^\s+/, "");
+  let hoisted = "";
   let match;
-  while (match = opener.exec(out)) {
-    out = out.slice(match[0].length).replace(/^\s+/, "");
+  while (match = CONTENTS_WRAPPER.exec(inner) ?? HOISTED_HEAD_ELEMENT.exec(inner)) {
+    if (!/^<div/i.test(match[0])) hoisted += match[0];
+    inner = inner.slice(match[0].length).replace(/^\s+/, "");
   }
-  return out;
+  return { inner, hoisted };
 }
-__name(stripContentsWrappers, "stripContentsWrappers");
+__name(peelDocumentPrefix, "peelDocumentPrefix");
+function restoreHoistedHead(document, hoisted) {
+  if (!hoisted) return document;
+  if (/<head[\s>]/i.test(document)) {
+    return document.replace(/<head\b[^>]*>/i, (open) => open + hoisted);
+  }
+  return document.replace(/<html\b[^>]*>/i, (open) => `${open}<head>${hoisted}</head>`);
+}
+__name(restoreHoistedHead, "restoreHoistedHead");
 function extractFarmFullDocument(markup) {
-  const inner = stripContentsWrappers(markup);
+  const { inner, hoisted } = peelDocumentPrefix(markup);
   if (!/^<!doctype/i.test(inner) && !/^<html[\s>]/i.test(inner)) return null;
   const start = markup.search(/<!doctype|<html[\s>]/i);
   const lower = markup.toLowerCase();
@@ -3041,14 +3058,15 @@ function extractFarmFullDocument(markup) {
   if (streamedTail) {
     document = document.replace(/<\/body>/i, () => `${streamedTail}</body>`);
   }
-  return document;
+  return restoreHoistedHead(document, hoisted);
 }
 __name(extractFarmFullDocument, "extractFarmFullDocument");
-function opensFarmFullDocument(markup) {
-  const inner = stripContentsWrappers(markup);
-  return /^<!doctype/i.test(inner) || /^<html[\s>]/i.test(inner);
+function classifyFarmDocumentPrefix(markup) {
+  const { inner } = peelDocumentPrefix(markup);
+  if (/^<!doctype/i.test(inner) || /^<html[\s>]/i.test(inner)) return "document";
+  return inner === "" ? "pending" : "fragment";
 }
-__name(opensFarmFullDocument, "opensFarmFullDocument");
+__name(classifyFarmDocumentPrefix, "classifyFarmDocumentPrefix");
 function ensureFarmDocumentHead(markup) {
   if (/<head[\s>]/i.test(markup)) return markup;
   return markup.replace(/<html([^>]*)>/i, (_match, attributes) => {
@@ -4601,6 +4619,7 @@ function warnSuppressedAsyncHydrationOnce(modulePath, reason) {
 }
 __name(warnSuppressedAsyncHydrationOnce, "warnSuppressedAsyncHydrationOnce");
 var fullDocumentRoutes = /* @__PURE__ */ new Set();
+var documentLayouts = /* @__PURE__ */ new WeakMap();
 function hasRequestHeader(req, name) {
   const value = req.headers[name.toLowerCase()];
   return Array.isArray(value) ? value.length > 0 : Boolean(value);
@@ -4791,7 +4810,7 @@ var _ServerRenderer = class _ServerRenderer {
     if (this.config.notFound?.component?.trim()) {
       resolveFarmNotFoundComponentPath(this.config, getFarmAppDirectories(this.config));
     }
-    const loaded = isReactRenderer(this.config.renderer) ? await import("./renderer/react/server.mjs") : this.viteServer ? await this.viteServer.ssrLoadModule(this.config.renderer.server) : await import(pathToFileURL2(
+    const loaded = isReactRenderer(this.config.renderer) ? await import("./renderer/react/server.mjs") : this.viteServer ? await loadFarmDevModule(this.viteServer, this.config.renderer.server) : await import(pathToFileURL2(
       resolveFarmRendererModule(
         this.config.root || process.cwd(),
         this.config.renderer.server
@@ -5903,7 +5922,7 @@ var _ServerRenderer = class _ServerRenderer {
             path9.resolve(this.config.root, provider.component.module),
             this.config.root
           ) : provider.component.module;
-          const providerModule = this.viteServer ? await this.viteServer.ssrLoadModule(providerModuleId) : await importRuntimeModule(
+          const providerModule = this.viteServer ? await loadFarmDevModule(this.viteServer, providerModuleId) : await importRuntimeModule(
             provider.component.module.startsWith(".") ? pathToFileURL2(path9.resolve(this.config.root, provider.component.module)).href : provider.component.module
           );
           ProviderComponent = providerModule[provider.component.export || "default"];
@@ -6530,10 +6549,43 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
       clearMiddlewareData?.();
     }
   }
+  /**
+   * Whether the root layout returns its own `<html>` document, checked as the client's layout
+   * boundary checks it: call a plain synchronous layout and look at what it returns. Knowing
+   * this up front keeps a route's first request on the buffered path too; a layout this cannot
+   * call (async, a class, or one using hooks) falls back to detection from the stream.
+   */
+  async rootLayoutRendersDocument() {
+    if (typeof this.routeManager.getLayouts !== "function") return false;
+    const rootLayout = this.routeManager.getLayouts().get("/");
+    if (!rootLayout) return false;
+    try {
+      const Layout = (await this.routeManager.loadLayoutModule(rootLayout.modulePath)).default;
+      if (typeof Layout !== "function" || Layout.prototype?.isReactComponent || Layout.constructor?.name === "AsyncFunction") {
+        return false;
+      }
+      const cached = documentLayouts.get(Layout);
+      if (cached !== void 0) return cached;
+      let rendersDocument = false;
+      try {
+        const rendered = Layout({
+          children: null,
+          params: {}
+        });
+        rendersDocument = this.rendererRuntime.isValidElement(rendered) && rendered.type === "html";
+      } catch {
+        rendersDocument = false;
+      }
+      documentLayouts.set(Layout, rendersDocument);
+      return rendersDocument;
+    } catch {
+      return false;
+    }
+  }
   async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
     const renderToPipeableStream = this.rendererRuntime.renderToPipeableStream;
     const fullDocumentRouteKey = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
-    if (!renderToPipeableStream || fullDocumentRoutes.has(fullDocumentRouteKey)) {
+    if (!renderToPipeableStream || fullDocumentRoutes.has(fullDocumentRouteKey) || await this.rootLayoutRendersDocument()) {
       return this.renderBufferedSSR(element, req, res, clearMiddlewareData, options);
     }
     return new Promise((resolve5, reject) => {
@@ -6709,14 +6761,18 @@ window.__FARM_I18N__ = ${getFarmI18nClientSnapshot() ? serializeInlineValue(getF
           staticShellParts?.push(securedShell);
           let firstChunk = true;
           let checkedFullDocument = false;
+          let documentPrefix = "";
           const cspNonceRewriter = cspNonce ? createFarmCspNonceRewriter(cspNonce) : void 0;
           const cspStreamDecoder = cspNonceRewriter ? new TextDecoder() : void 0;
           const recordRenderedChunk = /* @__PURE__ */ __name((chunkText) => {
             if (!chunkText) return;
             if (!checkedFullDocument) {
-              checkedFullDocument = true;
-              if (opensFarmFullDocument(chunkText)) {
-                fullDocumentRoutes.add(fullDocumentRouteKey);
+              documentPrefix += chunkText;
+              const prefix = classifyFarmDocumentPrefix(documentPrefix);
+              if (prefix !== "pending") {
+                checkedFullDocument = true;
+                documentPrefix = "";
+                if (prefix === "document") fullDocumentRoutes.add(fullDocumentRouteKey);
               }
             }
             htmlParts.push(chunkText);
@@ -9179,33 +9235,6 @@ function mergeFarmProductionViteConfig(farmConfig, userConfig = {}) {
 }
 __name(mergeFarmProductionViteConfig, "mergeFarmProductionViteConfig");
 
-// src/docs/adapter-client.ts
-function generateFarmDocsAdapterClientRuntime(reactModule) {
-  if (!reactModule) {
-    return `
-async function hydrateFarmDocsAdapterRuntime() {
-  return false;
-}
-`;
-  }
-  return `
-async function hydrateFarmDocsAdapterRuntime() {
-  const runtime = window.__FARM_DOCS_ADAPTER__;
-  if (!runtime) return false;
-  const FarmDocsAdapterReact = await import(${JSON.stringify(reactModule)});
-  if (typeof FarmDocsAdapterReact.hydrateFarmDocs !== "function") {
-    throw new Error("The configured Farm docs adapter does not export hydrateFarmDocs().");
-  }
-  FarmDocsAdapterReact.hydrateFarmDocs({
-    config: runtime.config || {},
-    data: runtime.data,
-  });
-  return true;
-}
-`;
-}
-__name(generateFarmDocsAdapterClientRuntime, "generateFarmDocsAdapterClientRuntime");
-
 // src/theme/vite.ts
 var FARM_DARK_VARIANT = '@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));';
 function createFarmThemeCssPlugin(input, basePath = "/") {
@@ -9324,7 +9353,7 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-UFVTMQX5.mjs");
+  return import("./devtools-MTB5SA2B.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
@@ -9941,6 +9970,9 @@ function farmPlugin(options = {}, initialPluginManager) {
         // directory the production client build emits.
         ...options.publicDir ? { publicDir: options.publicDir } : {},
         define: getEnvDefines(options, configEnv),
+        // Keep development module ownership explicit; the RSC plugin adds its
+        // environment only when enabled. Production environment setup is unchanged.
+        ...!isBuild ? { environments: { client: {}, ssr: {} } } : {},
         resolve: {
           alias: { ...layerAliases, ...sourceAlias }
         },
@@ -10069,10 +10101,16 @@ function farmPlugin(options = {}, initialPluginManager) {
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
       );
-      const isPageFile = /* @__PURE__ */ __name((file) => {
+      const routeModuleExtensions = /* @__PURE__ */ new Set([
+        ...resolveFarmComponentExtensions(farmConfig.renderer.componentExtensions),
+        ".md",
+        ".mdx"
+      ]);
+      const isRouteModuleFile = /* @__PURE__ */ __name((file) => {
         const normalized = file.replace(/\\/g, "/");
-        return appDirSlugs.some((appDir) => normalized.startsWith(`${appDir}/`)) && /page\.(ts|tsx|js|jsx|md|mdx)$/.test(normalized);
-      }, "isPageFile");
+        const match = /\/(?:page|layout|loading|error)(\.[^./]+)$/.exec(normalized);
+        return appDirSlugs.some((appDir) => normalized.startsWith(`${appDir}/`)) && !!match && routeModuleExtensions.has(match[1].toLowerCase());
+      }, "isRouteModuleFile");
       const isApiRouteFile = /* @__PURE__ */ __name((file) => {
         const normalized = file.replace(/\\/g, "/");
         return appDirSlugs.some((appDir) => normalized.startsWith(`${appDir}/api/`)) && /route\.(ts|tsx|js|jsx)$/.test(normalized);
@@ -10123,11 +10161,14 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "scheduleTypeArtifactGen");
       ["add", "change", "unlink"].forEach((ev) => {
         server.watcher.on(ev, (file) => {
+          if (ev === "add") {
+            invalidateFailedFarmDevModules(server);
+          }
           const normalizedFile = file.replace(/\\/g, "/");
           const configChanged = isFarmConfigFile(file, farmConfig.root) || layerConfigFiles.has(normalizedFile);
           const programmaticRouteChanged = isProgrammaticRouteFile(file) || isProgrammaticRouteSourceFile(file) && (ev === "unlink" || fileContainsProgrammaticPageRoute(file));
           const typeArtifacts = configChanged ? ALL_TYPE_ARTIFACTS : {
-            routes: ev !== "change" && isPageFile(file) || programmaticRouteChanged,
+            routes: ev !== "change" && isRouteModuleFile(file) || programmaticRouteChanged,
             api: isApiRouteFile(file) || programmaticRouteChanged,
             env: false,
             images: false,
@@ -10201,14 +10242,14 @@ function farmPlugin(options = {}, initialPluginManager) {
         discoveredWorkflows = await discoverFarmWorkflows(
           { ...farmConfig, workflows: workflowConfig },
           {
-            loadModule: /* @__PURE__ */ __name(async (filePath) => server.ssrLoadModule(filePath), "loadModule")
+            loadModule: /* @__PURE__ */ __name(async (filePath) => loadFarmDevModule(server, filePath), "loadModule")
           }
         );
         if (discoveredWorkflows.length > 0) {
           workflowHandler = createFarmWorkflowRequestHandler({
             workflows: discoveredWorkflows,
             config: workflowConfig,
-            loadModule: /* @__PURE__ */ __name(async (workflow) => server.ssrLoadModule(workflow.filePath), "loadModule"),
+            loadModule: /* @__PURE__ */ __name(async (workflow) => loadFarmDevModule(server, workflow.filePath), "loadModule"),
             server: farmConfig.server
           });
           logger.success(`\u2705 Discovered ${discoveredWorkflows.length} Farm workflow task(s)`);
@@ -10282,16 +10323,14 @@ function farmPlugin(options = {}, initialPluginManager) {
           farmConfig.srcDir
         ),
         loadModule: /* @__PURE__ */ __name(async (specifier) => {
-          const resolved = await server.pluginContainer.resolveId(specifier, void 0, {
-            ssr: true
-          });
+          const resolved = await server.environments.ssr.pluginContainer.resolveId(specifier);
           if (specifier === farmConfig.docs.adapter?.server && resolved?.id) {
             return import(
               /* @vite-ignore */
               pathToFileURL3(resolved.id).href
             );
           }
-          return server.ssrLoadModule(resolved?.id ?? specifier);
+          return loadFarmDevModule(server, resolved?.id ?? specifier);
         }, "loadModule")
       }) : farmDocsDevRuntime.createFarmDocsHandler(farmConfig.docs, {
         root: farmConfig.root,
@@ -10329,7 +10368,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         }
         const docsRenderer = resolveFarmRenderer((farmApp?.getConfig() ?? options).renderer);
         const [rendererRuntime, layoutModules] = await Promise.all([
-          isReactRenderer(docsRenderer) ? import("./renderer/react/server.mjs") : server.ssrLoadModule(docsRenderer.server),
+          isReactRenderer(docsRenderer) ? import("./renderer/react/server.mjs") : loadFarmDevModule(server, docsRenderer.server),
           Promise.all(
             layoutEntries.map((layout) => routeManager.loadLayoutModule(layout.modulePath))
           )
@@ -11573,7 +11612,8 @@ ${generatedDevIndicatorsClientRuntime}`,
           resolvedConfig?.basePath ?? "/",
           generateClientCachePersistenceCode(
             resolveFarmClientCacheAdapterEntry(root, resolvedConfig?.cache)
-          )
+          ),
+          isReactRenderer(renderer) ? getFarmDocsAdapterConfigModule(docs) : void 0
         );
       }
       if (id === "/@farm/server") {
@@ -11739,7 +11779,7 @@ export const manifest = getManifest();
       );
       return;
     }` : "";
-        const hmrCode = !shouldEmitFarmClientRootHmr(currentConfig.renderer) ? "" : `
+        const hmrCode = transformOptions?.ssr || !shouldEmitFarmClientRootHmr(currentConfig.renderer) ? "" : `
 if (import.meta.hot) {
   import.meta.hot.accept((newModule) => {
     ${isolatedHmrUpdate}
@@ -12384,7 +12424,7 @@ function parseRouteModuleSchema2(schema, value, label, routePath) {
   }
 }
 __name(parseRouteModuleSchema2, "parseRouteModuleSchema");
-function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/", clientCachePersistence = { imports: "", init: "" }) {
+function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule) {
   const providerClientCode = generateFarmIntegrationProviderClientCode(
     integrationProviders,
     root,
@@ -12399,7 +12439,10 @@ function generateClientCode(integrationProviders = [], documentNavigationMatcher
   const rendererClientImports = isReactRenderer(renderer) ? `import React from 'react'
 import { hydrateRoot, createRoot } from 'react-dom/client'` : `import React, { hydrateRoot, createRoot } from ${JSON.stringify(renderer.client)}`;
   const isolatedHydrationImport = isolatedHydrationEnabled ? `import { createFarmIsolatedHydrationRuntime, createFarmServerPageBoundary, wrapFarmIsolatedClientGraph } from '@farm.js/core/internal/isolated-boundary'` : "";
-  const docsAdapterImportBlock = generateFarmDocsAdapterClientRuntime(docsAdapterReact);
+  const docsAdapterImportBlock = generateFarmDocsAdapterClientRuntime(
+    docsAdapterReact,
+    docsConfigModule
+  );
   const isolatedHydrationRuntime = isolatedHydrationEnabled ? `const farmIsolatedHydrationRuntime = createFarmIsolatedHydrationRuntime({
   ReactRuntime: React,
   hydrateRoot,
@@ -14197,7 +14240,6 @@ export {
   createFarmSourceAlias,
   mergeFarmViteConfig,
   mergeFarmProductionViteConfig,
-  generateFarmDocsAdapterClientRuntime,
   createFarmThemeCssPlugin,
   farmI18nClientBridgePlugin,
   farmServerOnlyEntriesPlugin,

package/dist/{chunk-OXSIH4D6.cjs → chunk-KNPRCKXK.cjs}

@@ -55,6 +55,11 @@ function mergeMetadataTitle(base, next) {
     return parentTemplate ? applyTitleTemplate(parentTemplate, next) : next;
   }
   if (!isRecord(next)) return next;
+  const absoluteTitle = normalizeContent(next.absolute);
+  if (absoluteTitle) {
+    const { absolute: _absolute, ...rest } = next;
+    return { ...rest, default: absoluteTitle };
+  }
   const defaultTitle = _nullishCoalesce(normalizeContent(next.default), () => ( resolveMetadataTitle(base)));
   return {
     ...next,
@@ -372,7 +377,7 @@ _chunkS3JO3N4Hcjs.__name.call(void 0, hasMetadataImages, "hasMetadataImages");
 function resolveMetadataTitle(title) {
   if (typeof title === "string") return title;
   if (isRecord(title)) {
-    return normalizeContent(title.default);
+    return _nullishCoalesce(normalizeContent(title.absolute), () => ( normalizeContent(title.default)));
   }
   return void 0;
 }