@farm.js/core 0.1.15 → 0.1.17

package/dist/vite.cjs

@@ -31,6 +31,255 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// src/utils/runtime-env.ts
+function getFarmRuntimeBindings() {
+  const runtimeBindings = globalThis.__env__;
+  return runtimeBindings && typeof runtimeBindings === "object" ? runtimeBindings : void 0;
+}
+function readFarmEnvironmentValue(name2) {
+  const runtimeValue = getFarmRuntimeBindings()?.[name2];
+  if (typeof runtimeValue === "string") return runtimeValue;
+  return typeof process !== "undefined" ? process.env?.[name2] : void 0;
+}
+function isFarmDeployedRuntime() {
+  if (getFarmRuntimeBindings()) return true;
+  return readFarmEnvironmentValue("NODE_ENV") === "production";
+}
+var init_runtime_env = __esm({
+  "src/utils/runtime-env.ts"() {
+    "use strict";
+    __name(getFarmRuntimeBindings, "getFarmRuntimeBindings");
+    __name(readFarmEnvironmentValue, "readFarmEnvironmentValue");
+    __name(isFarmDeployedRuntime, "isFarmDeployedRuntime");
+  }
+});
+
+// src/env.ts
+function createBundledEnv(env2, source = getProcessEnv()) {
+  const resolved = normalizeResolvedEnv(env2 ?? {});
+  const server = {};
+  const runtime3 = {};
+  for (const [key, value] of Object.entries(resolved.server)) {
+    const raw = source[key];
+    const type = getRuntimeEnvType(value);
+    if (raw !== void 0 && isSameEnvValue(coerceRuntimeEnvValue(raw, type), value)) {
+      runtime3[key] = type;
+    } else {
+      server[key] = value;
+    }
+  }
+  return {
+    server,
+    public: resolved.public,
+    ...Object.keys(runtime3).length > 0 ? { runtime: { server: runtime3 } } : {}
+  };
+}
+function createEnvProxy(scope) {
+  return new Proxy(
+    {},
+    {
+      get(_target, property) {
+        if (typeof property === "symbol") {
+          return void 0;
+        }
+        const env2 = getEnvScope(scope);
+        return scope === "server" ? readServerEnvKey(env2, property) : env2[property];
+      },
+      ownKeys() {
+        return Reflect.ownKeys(getEnvScope(scope));
+      },
+      getOwnPropertyDescriptor(_target, property) {
+        const env2 = getEnvScope(scope);
+        if (!(property in env2)) {
+          return void 0;
+        }
+        return {
+          enumerable: true,
+          configurable: true,
+          value: env2[property]
+        };
+      },
+      has(_target, property) {
+        return property in getEnvScope(scope);
+      }
+    }
+  );
+}
+function getEnvScope(scope) {
+  const env2 = getCurrentEnv();
+  if (scope === "server") {
+    assertServerEnvAccess();
+    readRuntimeServerEnv(env2);
+  }
+  return env2[scope] || {};
+}
+function readServerEnvKey(server, key) {
+  const value = server[key];
+  if (value === void 0) {
+    const state = getCurrentEnv()[FARM_ENV_RUNTIME_SYMBOL];
+    if (state && key in state.pending && !state.warned.has(key)) {
+      state.warned.add(key);
+      console.warn(
+        `[Farm] Server env "${key}" was set when this app was built but is not set where the server runs, so it reads as undefined. Farm reads server env at runtime and does not store it in the build output; set "${key}" in the server's environment.`
+      );
+    }
+  }
+  return value;
+}
+function readRuntimeServerEnv(env2) {
+  const state = env2[FARM_ENV_RUNTIME_SYMBOL];
+  if (!state) return;
+  for (const [key, type] of Object.entries(state.pending)) {
+    const raw = readFarmEnvironmentValue(key);
+    if (raw === void 0) continue;
+    env2.server[key] = coerceRuntimeEnvValue(raw, type);
+    delete state.pending[key];
+  }
+}
+function getRuntimeEnvType(value) {
+  if (typeof value === "number") return "number";
+  if (typeof value === "boolean") return "boolean";
+  if (value !== null && typeof value === "object" && !(value instanceof Date)) return "json";
+  return "string";
+}
+function coerceRuntimeEnvValue(raw, type) {
+  if (type === "number") {
+    const value = Number(raw);
+    return raw.trim() !== "" && Number.isFinite(value) ? value : raw;
+  }
+  if (type === "boolean") {
+    if (/^(true|1)$/i.test(raw.trim())) return true;
+    if (/^(false|0|)$/i.test(raw.trim())) return false;
+    return raw;
+  }
+  if (type === "json") {
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+  return raw;
+}
+function isSameEnvValue(left, right) {
+  if (Object.is(left, right)) return true;
+  if (Array.isArray(left) || Array.isArray(right)) {
+    return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((item, index) => isSameEnvValue(item, right[index]));
+  }
+  if (!isPlainObject(left) || !isPlainObject(right)) return false;
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every(
+    (key) => Object.prototype.hasOwnProperty.call(right, key) && isSameEnvValue(left[key], right[key])
+  );
+}
+function isPlainObject(value) {
+  if (!value || typeof value !== "object") return false;
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function prepareEnv(env2) {
+  const normalized = normalizeResolvedEnv(env2);
+  const runtime3 = env2.runtime?.server;
+  if (!isRecord(runtime3) || Object.keys(runtime3).length === 0) return normalized;
+  const prepared = { server: { ...normalized.server }, public: normalized.public };
+  Object.defineProperty(prepared, FARM_ENV_RUNTIME_SYMBOL, {
+    value: {
+      pending: { ...runtime3 },
+      warned: /* @__PURE__ */ new Set()
+    },
+    enumerable: false
+  });
+  return prepared;
+}
+function assertServerEnvAccess() {
+  if (typeof window !== "undefined") {
+    throw new Error("Farm server env is not available in the browser. Use publicEnv.");
+  }
+}
+function getInitialEnv() {
+  const injectedEnv = getInjectedEnv();
+  if (injectedEnv) {
+    return injectedEnv;
+  }
+  if (typeof window === "undefined" && farmEnvGlobal[FARM_ENV_SYMBOL]) {
+    return normalizeResolvedEnv(farmEnvGlobal[FARM_ENV_SYMBOL]);
+  }
+  return {
+    server: {},
+    public: getInjectedPublicEnv()
+  };
+}
+function getCurrentEnv() {
+  if (typeof window === "undefined" && farmEnvGlobal[FARM_ENV_SYMBOL]) {
+    return farmEnvGlobal[FARM_ENV_SYMBOL];
+  }
+  return currentEnv;
+}
+function getInjectedEnv() {
+  try {
+    if (typeof __FARM_ENV__ !== "undefined" && __FARM_ENV__) {
+      return prepareEnv(__FARM_ENV__);
+    }
+  } catch {
+  }
+  return null;
+}
+function getInjectedPublicEnv() {
+  try {
+    if (typeof __FARM_PUBLIC_ENV__ !== "undefined" && __FARM_PUBLIC_ENV__) {
+      return __FARM_PUBLIC_ENV__;
+    }
+  } catch {
+  }
+  return {};
+}
+function normalizeResolvedEnv(env2) {
+  return {
+    server: isRecord(env2.server) ? env2.server : {},
+    public: isRecord(env2.public) ? env2.public : {}
+  };
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function getProcessEnv() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env;
+  }
+  return {};
+}
+var FARM_ENV_SYMBOL, FARM_ENV_RUNTIME_SYMBOL, farmEnvGlobal, currentEnv, env, publicEnv;
+var init_env = __esm({
+  "src/env.ts"() {
+    "use strict";
+    init_runtime_env();
+    FARM_ENV_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env");
+    FARM_ENV_RUNTIME_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env.runtime");
+    farmEnvGlobal = globalThis;
+    currentEnv = getInitialEnv();
+    __name(createBundledEnv, "createBundledEnv");
+    env = createEnvProxy("server");
+    publicEnv = createEnvProxy("public");
+    __name(createEnvProxy, "createEnvProxy");
+    __name(getEnvScope, "getEnvScope");
+    __name(readServerEnvKey, "readServerEnvKey");
+    __name(readRuntimeServerEnv, "readRuntimeServerEnv");
+    __name(getRuntimeEnvType, "getRuntimeEnvType");
+    __name(coerceRuntimeEnvValue, "coerceRuntimeEnvValue");
+    __name(isSameEnvValue, "isSameEnvValue");
+    __name(isPlainObject, "isPlainObject");
+    __name(prepareEnv, "prepareEnv");
+    __name(assertServerEnvAccess, "assertServerEnvAccess");
+    __name(getInitialEnv, "getInitialEnv");
+    __name(getCurrentEnv, "getCurrentEnv");
+    __name(getInjectedEnv, "getInjectedEnv");
+    __name(getInjectedPublicEnv, "getInjectedPublicEnv");
+    __name(normalizeResolvedEnv, "normalizeResolvedEnv");
+    __name(isRecord, "isRecord");
+    __name(getProcessEnv, "getProcessEnv");
+  }
+});
+
 // src/app-markdown-config.ts
 function resolveMdxConfig(config) {
   return {
@@ -152,8 +401,16 @@ async function createMarkdownMirrorResponse(options) {
   if (!hasMarkdownExtension) {
     headersOut.set("Vary", "Accept");
   }
+  for (const token of pageResponse.headers.get("vary")?.split(",") ?? []) {
+    const name2 = token.trim();
+    if (name2 && name2.toLowerCase() !== "accept") appendHeaderToken(headersOut, "Vary", name2);
+  }
+  const pageCacheControl = pageResponse.headers.get("cache-control");
   const cache = target.route?.cache ?? options.config?.cache ?? false;
-  headersOut.set("Cache-Control", createMarkdownCacheHeader(cache));
+  headersOut.set(
+    "Cache-Control",
+    pageCacheControl && isPrivateCacheControl(pageCacheControl) ? pageCacheControl : createMarkdownCacheHeader(cache)
+  );
   return new Response(options.request.method === "HEAD" ? null : markdown, {
     status: pageResponse.status,
     headers: headersOut
@@ -304,6 +561,17 @@ function isFarmMarkdownMirrorExposed(config, pathname) {
 function matchesFarmMarkdownRoutePattern(pattern, pathname) {
   return routeMatches(pattern, pathname);
 }
+function appendHeaderToken(headers, name2, token) {
+  const current = headers.get(name2);
+  if (!current) {
+    headers.set(name2, token);
+    return;
+  }
+  const tokens = current.split(",").map((value) => value.trim().toLowerCase());
+  if (!tokens.includes(token.toLowerCase())) {
+    headers.set(name2, `${current}, ${token}`);
+  }
+}
 function findExposedMarkdownRoute(config, pathname) {
   if (config.expose === true) {
     return null;
@@ -335,6 +603,12 @@ function isHtmlResponse(response) {
   const contentType = response.headers.get("content-type") ?? "";
   return contentType.includes("text/html");
 }
+function isPrivateCacheControl(value) {
+  return value.split(",").some((directive) => {
+    const name2 = directive.split("=", 1)[0].trim().toLowerCase();
+    return name2 === "private" || name2 === "no-store";
+  });
+}
 function createMarkdownCacheHeader(cache) {
   if (cache === false || cache <= 0) {
     return "no-store";
@@ -487,9 +761,11 @@ var init_markdown = __esm({
     __name(getFarmMarkdownAlternatePath, "getFarmMarkdownAlternatePath");
     __name(isFarmMarkdownMirrorExposed, "isFarmMarkdownMirrorExposed");
     __name(matchesFarmMarkdownRoutePattern, "matchesFarmMarkdownRoutePattern");
+    __name(appendHeaderToken, "appendHeaderToken");
     __name(findExposedMarkdownRoute, "findExposedMarkdownRoute");
     __name(routeMatches, "routeMatches");
     __name(isHtmlResponse, "isHtmlResponse");
+    __name(isPrivateCacheControl, "isPrivateCacheControl");
     __name(createMarkdownCacheHeader, "createMarkdownCacheHeader");
     __name(extractHtmlTitle, "extractHtmlTitle");
     __name(extractHtmlBody, "extractHtmlBody");
@@ -1193,29 +1469,6 @@ var init_secret_compare = __esm({
   }
 });
 
-// src/utils/runtime-env.ts
-function getFarmRuntimeBindings() {
-  const runtimeBindings = globalThis.__env__;
-  return runtimeBindings && typeof runtimeBindings === "object" ? runtimeBindings : void 0;
-}
-function readFarmEnvironmentValue(name2) {
-  const runtimeValue = getFarmRuntimeBindings()?.[name2];
-  if (typeof runtimeValue === "string") return runtimeValue;
-  return typeof process !== "undefined" ? process.env?.[name2] : void 0;
-}
-function isFarmDeployedRuntime() {
-  if (getFarmRuntimeBindings()) return true;
-  return readFarmEnvironmentValue("NODE_ENV") === "production";
-}
-var init_runtime_env = __esm({
-  "src/utils/runtime-env.ts"() {
-    "use strict";
-    __name(getFarmRuntimeBindings, "getFarmRuntimeBindings");
-    __name(readFarmEnvironmentValue, "readFarmEnvironmentValue");
-    __name(isFarmDeployedRuntime, "isFarmDeployedRuntime");
-  }
-});
-
 // src/utils/decode.ts
 function decodeRouteSegment(segment) {
   try {
@@ -4470,7 +4723,7 @@ function mergeFarmLayerConfig(base, override) {
       output[key] = mergeConfigListResolvers(output[key], value);
       continue;
     }
-    if (isPlainObject(output[key]) && isPlainObject(value)) {
+    if (isPlainObject2(output[key]) && isPlainObject2(value)) {
       output[key] = mergePlainObjects(output[key], value);
       continue;
     }
@@ -4482,7 +4735,7 @@ function mergePlainObjects(base, override) {
   const output = { ...base };
   for (const [key, value] of Object.entries(override)) {
     if (value === void 0) continue;
-    output[key] = isPlainObject(output[key]) && isPlainObject(value) ? mergePlainObjects(output[key], value) : value;
+    output[key] = isPlainObject2(output[key]) && isPlainObject2(value) ? mergePlainObjects(output[key], value) : value;
   }
   return output;
 }
@@ -4497,7 +4750,7 @@ function toArray(value) {
   if (value === void 0 || value === null) return [];
   return Array.isArray(value) ? value : [value];
 }
-function isPlainObject(value) {
+function isPlainObject2(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const prototype = Object.getPrototypeOf(value);
   return prototype === Object.prototype || prototype === null;
@@ -4574,7 +4827,7 @@ var init_layers = __esm({
     __name(mergeConfigListResolvers, "mergeConfigListResolvers");
     __name(resolveConfigList, "resolveConfigList");
     __name(toArray, "toArray");
-    __name(isPlainObject, "isPlainObject");
+    __name(isPlainObject2, "isPlainObject");
     __name(isPathLayerSource, "isPathLayerSource");
     __name(normalizeRealPath, "normalizeRealPath");
   }
@@ -5359,6 +5612,8 @@ var init_cache = __esm({
       constructor(config = {}) {
         this.entries = /* @__PURE__ */ new Map();
         this.inflight = /* @__PURE__ */ new Map();
+        /** Local entries by tag, so tag counts and pruning never scan unrelated entries. */
+        this.entriesByTag = /* @__PURE__ */ new Map();
         this.invalidatedTagVersions = /* @__PURE__ */ new Map();
         this.activeGenerations = /* @__PURE__ */ new Set();
         this.version = 0;
@@ -5377,6 +5632,7 @@ var init_cache = __esm({
       configure(config = {}) {
         this.generation++;
         this.entries.clear();
+        this.entriesByTag.clear();
         this.inflight.clear();
         this.invalidatedTagVersions.clear();
         this.activeGenerations.clear();
@@ -5543,14 +5799,12 @@ var init_cache = __esm({
         return entry;
       }
       delete(key) {
-        const deleted = this.entries.delete(key);
-        if (deleted) this.pruneInvalidatedTagVersions();
+        const deleted = this.deleteLocalEntry(key);
         emitFarmEvent({ type: "cache.delete", key, deleted });
         return deleted;
       }
       async deleteAsync(key) {
-        const deleted = this.entries.delete(key);
-        if (deleted) this.pruneInvalidatedTagVersions();
+        const deleted = this.deleteLocalEntry(key);
         if (this.adapter) {
           await this.adapter.delete(this.createAdapterKey(key));
         }
@@ -5561,6 +5815,7 @@ var init_cache = __esm({
         const count = this.entries.size;
         this.generation++;
         this.entries.clear();
+        this.entriesByTag.clear();
         this.inflight.clear();
         this.invalidatedTagVersions.clear();
         this.activeGenerations.clear();
@@ -5646,23 +5901,32 @@ var init_cache = __esm({
           return cached.value;
         }
         const inflight = this.inflight.get(key);
-        if (inflight) {
+        if (inflight && !this.wasInvalidatedSince(inflight.tags, inflight.startVersion)) {
           emitFarmEvent({ type: "cache.dedupe", key });
-          return inflight;
+          return inflight.promise;
         }
         const tags = Array.from(normalizeCacheOptionsTags(options));
         const generation = this.generation;
+        const startVersion = this.version;
         const promise = this.fillCacheEntry(key, producer, options, tags, generation).catch((error) => {
           emitFarmEvent({ type: "cache.error", key, operation: "set", error });
           throw error;
         }).finally(() => {
-          if (this.inflight.get(key) === promise) {
+          if (this.inflight.get(key)?.promise === promise) {
             this.inflight.delete(key);
           }
         });
-        this.inflight.set(key, promise);
+        this.inflight.set(key, { promise, tags, startVersion });
         return promise;
       }
+      /** A fill that started before one of its tags was invalidated cannot satisfy later readers. */
+      wasInvalidatedSince(tags, version2) {
+        for (const tag of tags) {
+          const invalidatedVersion = this.invalidatedTagVersions.get(tag);
+          if (invalidatedVersion !== void 0 && invalidatedVersion > version2) return true;
+        }
+        return false;
+      }
       async fillCacheEntry(key, producer, options, tags, generation) {
         const adapter = this.adapter;
         const namespace = this.namespace;
@@ -5703,7 +5967,7 @@ var init_cache = __esm({
           return value;
         } finally {
           this.activeGenerations.delete(activeGeneration);
-          this.pruneInvalidatedTagVersions();
+          this.pruneInvalidatedTagVersions(activeGeneration.tags);
           if (leaseToken && adapter?.releaseLease) {
             try {
               await adapter.releaseLease(leaseKey, leaseToken);
@@ -5748,18 +6012,9 @@ var init_cache = __esm({
         }
         return void 0;
       }
-      countEntriesForTag(tag) {
-        let count = 0;
-        for (const entry of this.entries.values()) {
-          if (entry.tags.has(tag)) {
-            count++;
-          }
-        }
-        return count;
-      }
       countEntriesForTags(tags) {
         let count = 0;
-        for (const entry of this.entries.values()) {
+        for (const entry of this.entriesByTag.get(tags[0]) ?? []) {
           if (tags.every((tag) => entry.tags.has(tag))) {
             count++;
           }
@@ -5767,10 +6022,10 @@ var init_cache = __esm({
         return count;
       }
       invalidateTag(normalizedTag) {
-        const count = this.countEntriesForTag(normalizedTag);
+        const count = this.entriesByTag.get(normalizedTag)?.size ?? 0;
         this.invalidatedTagVersions.delete(normalizedTag);
         this.invalidatedTagVersions.set(normalizedTag, ++this.version);
-        this.pruneInvalidatedTagVersions();
+        this.pruneInvalidatedTagVersions([normalizedTag]);
         return count;
       }
       toPublicEntry(entry) {
@@ -5800,19 +6055,51 @@ var init_cache = __esm({
         this.entries.set(key, entry);
       }
       storeLocalEntry(entry) {
-        this.entries.delete(entry.key);
+        const removed = [];
+        const replaced = this.detachLocalEntry(entry.key);
+        if (replaced) removed.push(replaced);
         this.entries.set(entry.key, entry);
+        for (const tag of entry.tags) {
+          let tagged = this.entriesByTag.get(tag);
+          if (!tagged) this.entriesByTag.set(tag, tagged = /* @__PURE__ */ new Set());
+          tagged.add(entry);
+        }
         while (this.entries.size > this.maxEntries) {
           const oldestKey = this.entries.keys().next().value;
           if (oldestKey === void 0) break;
-          this.entries.delete(oldestKey);
+          removed.push(this.detachLocalEntry(oldestKey));
         }
-        this.pruneInvalidatedTagVersions();
+        for (const removedEntry of removed) this.pruneInvalidatedTagVersions(removedEntry.tags);
+      }
+      deleteLocalEntry(key) {
+        const entry = this.detachLocalEntry(key);
+        if (!entry) return false;
+        this.pruneInvalidatedTagVersions(entry.tags);
+        return true;
       }
-      pruneInvalidatedTagVersions() {
-        tags: for (const [tag, invalidatedVersion] of this.invalidatedTagVersions) {
-          for (const entry of this.entries.values()) {
-            if (entry.tags.has(tag) && entry.createdVersion < invalidatedVersion) continue tags;
+      detachLocalEntry(key) {
+        const entry = this.entries.get(key);
+        if (!entry) return void 0;
+        this.entries.delete(key);
+        for (const tag of entry.tags) {
+          const tagged = this.entriesByTag.get(tag);
+          if (!tagged) continue;
+          tagged.delete(entry);
+          if (tagged.size === 0) this.entriesByTag.delete(tag);
+        }
+        return entry;
+      }
+      /**
+       * Drop invalidation versions that no local entry or active fill can be stale against.
+       * Callers pass only the tags whose dependents just changed, so the cost is bounded by
+       * the entries sharing those tags rather than by the whole cache.
+       */
+      pruneInvalidatedTagVersions(tags) {
+        tags: for (const tag of tags) {
+          const invalidatedVersion = this.invalidatedTagVersions.get(tag);
+          if (invalidatedVersion === void 0) continue;
+          for (const entry of this.entriesByTag.get(tag) ?? []) {
+            if (entry.createdVersion < invalidatedVersion) continue tags;
           }
           for (const generation of this.activeGenerations) {
             if (generation.tags.has(tag) && generation.createdVersion < invalidatedVersion)
@@ -6207,6 +6494,7 @@ function createProgrammaticPageComponent(route, rendererRuntime) {
     }
     return rendererRuntime.createElement(...args);
   }, "createElement");
+  const markFunctionComponent = /* @__PURE__ */ __name((component) => rendererRuntime?.markFunctionComponent?.(component) ?? component, "markFunctionComponent");
   const Component = route.component;
   if (route.pending) {
     const PendingComponent = route.pending;
@@ -6228,7 +6516,9 @@ function createProgrammaticPageComponent(route, rendererRuntime) {
         throw error;
       }
     }, "FarmProgrammaticPageContent");
-    const PageContent = FarmProgrammaticPageContent2;
+    const PageContent = markFunctionComponent(
+      FarmProgrammaticPageContent2
+    );
     const FarmProgrammaticPage = /* @__PURE__ */ __name(function FarmProgrammaticPage2(props) {
       return createElement2(
         rendererRuntime.Suspense,
@@ -6238,7 +6528,7 @@ function createProgrammaticPageComponent(route, rendererRuntime) {
         createElement2(PageContent, props)
       );
     }, "FarmProgrammaticPage");
-    return FarmProgrammaticPage;
+    return markFunctionComponent(FarmProgrammaticPage);
   }
   const FarmProgrammaticPageContent = /* @__PURE__ */ __name(async function FarmProgrammaticPageContent2(props) {
     try {
@@ -6257,7 +6547,7 @@ function createProgrammaticPageComponent(route, rendererRuntime) {
       throw error;
     }
   }, "FarmProgrammaticPageContent");
-  return FarmProgrammaticPageContent;
+  return markFunctionComponent(FarmProgrammaticPageContent);
 }
 function readProgrammaticRouteProps(route, props, resources) {
   if (isProgrammaticRoutePropsResolved(props)) {
@@ -8942,7 +9232,7 @@ function serializeFarmLlmsTxt(value) {
     return value.endsWith("\n") ? value : `${value}
 `;
   }
-  if (!isRecord2(value)) {
+  if (!isRecord3(value)) {
     throw new TypeError("llms.ts must return llms.txt text, an llms.txt object, or a Response");
   }
   const title = requireText(value.title, "llms.ts must return a non-empty title");
@@ -8955,7 +9245,7 @@ function serializeFarmLlmsTxt(value) {
   if (summary?.trim()) blocks.push(`> ${toSingleLine(summary)}`);
   if (details?.trim()) blocks.push(details.trim());
   for (const [sectionIndex, section] of (value.sections ?? []).entries()) {
-    if (!isRecord2(section)) {
+    if (!isRecord3(section)) {
       throw new TypeError(`llms.ts section ${sectionIndex} must be an object`);
     }
     const sectionTitle = requireText(
@@ -8967,7 +9257,7 @@ function serializeFarmLlmsTxt(value) {
     }
     const links = section.links.map((link, linkIndex) => {
       const where = `llms.ts section "${sectionTitle}" link ${linkIndex}`;
-      if (!isRecord2(link)) throw new TypeError(`${where} must be an object`);
+      if (!isRecord3(link)) throw new TypeError(`${where} must be an object`);
       const linkTitle = requireText(link.title, `${where} must include a non-empty title`);
       const url = requireText(link.url, `${where} must include a non-empty url`);
       const description = optionalText(link.description, `${where} description must be a string`);
@@ -9053,10 +9343,10 @@ async function mapWithConcurrency(items, limit, run) {
   return results;
 }
 function readMetadataTitle(metadata) {
-  if (!isRecord2(metadata)) return void 0;
+  if (!isRecord3(metadata)) return void 0;
   const { title } = metadata;
   if (typeof title === "string") return title.trim() || void 0;
-  if (isRecord2(title)) {
+  if (isRecord3(title)) {
     for (const key of ["absolute", "default"]) {
       const value = title[key];
       if (typeof value === "string" && value.trim()) return value.trim();
@@ -9065,7 +9355,7 @@ function readMetadataTitle(metadata) {
   return void 0;
 }
 function readMetadataString(metadata, key) {
-  if (!isRecord2(metadata)) return void 0;
+  if (!isRecord3(metadata)) return void 0;
   const value = metadata[key];
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
@@ -9097,7 +9387,7 @@ function optionalText(value, message) {
   if (typeof value !== "string") throw new TypeError(message);
   return value;
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
 var init_llms_txt = __esm({
@@ -9123,7 +9413,7 @@ var init_llms_txt = __esm({
     __name(escapeLinkUrl, "escapeLinkUrl");
     __name(requireText, "requireText");
     __name(optionalText, "optionalText");
-    __name(isRecord2, "isRecord");
+    __name(isRecord3, "isRecord");
   }
 });
 
@@ -10346,116 +10636,6 @@ var init_config3 = __esm({
   }
 });
 
-// src/env.ts
-function createEnvProxy(scope) {
-  return new Proxy(
-    {},
-    {
-      get(_target, property) {
-        if (typeof property === "symbol") {
-          return void 0;
-        }
-        const env2 = getEnvScope(scope);
-        return env2[property];
-      },
-      ownKeys() {
-        return Reflect.ownKeys(getEnvScope(scope));
-      },
-      getOwnPropertyDescriptor(_target, property) {
-        const env2 = getEnvScope(scope);
-        if (!(property in env2)) {
-          return void 0;
-        }
-        return {
-          enumerable: true,
-          configurable: true,
-          value: env2[property]
-        };
-      },
-      has(_target, property) {
-        return property in getEnvScope(scope);
-      }
-    }
-  );
-}
-function getEnvScope(scope) {
-  if (scope === "server") {
-    assertServerEnvAccess();
-  }
-  return getCurrentEnv()[scope] || {};
-}
-function assertServerEnvAccess() {
-  if (typeof window !== "undefined") {
-    throw new Error("Farm server env is not available in the browser. Use publicEnv.");
-  }
-}
-function getInitialEnv() {
-  const injectedEnv = getInjectedEnv();
-  if (injectedEnv) {
-    return injectedEnv;
-  }
-  if (typeof window === "undefined" && farmEnvGlobal[FARM_ENV_SYMBOL]) {
-    return normalizeResolvedEnv(farmEnvGlobal[FARM_ENV_SYMBOL]);
-  }
-  return {
-    server: {},
-    public: getInjectedPublicEnv()
-  };
-}
-function getCurrentEnv() {
-  if (typeof window === "undefined" && farmEnvGlobal[FARM_ENV_SYMBOL]) {
-    return farmEnvGlobal[FARM_ENV_SYMBOL];
-  }
-  return currentEnv;
-}
-function getInjectedEnv() {
-  try {
-    if (typeof __FARM_ENV__ !== "undefined" && __FARM_ENV__) {
-      return normalizeResolvedEnv(__FARM_ENV__);
-    }
-  } catch {
-  }
-  return null;
-}
-function getInjectedPublicEnv() {
-  try {
-    if (typeof __FARM_PUBLIC_ENV__ !== "undefined" && __FARM_PUBLIC_ENV__) {
-      return __FARM_PUBLIC_ENV__;
-    }
-  } catch {
-  }
-  return {};
-}
-function normalizeResolvedEnv(env2) {
-  return {
-    server: isRecord4(env2.server) ? env2.server : {},
-    public: isRecord4(env2.public) ? env2.public : {}
-  };
-}
-function isRecord4(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}
-var FARM_ENV_SYMBOL, farmEnvGlobal, currentEnv, env, publicEnv;
-var init_env = __esm({
-  "src/env.ts"() {
-    "use strict";
-    FARM_ENV_SYMBOL = /* @__PURE__ */ Symbol.for("farm.env");
-    farmEnvGlobal = globalThis;
-    currentEnv = getInitialEnv();
-    env = createEnvProxy("server");
-    publicEnv = createEnvProxy("public");
-    __name(createEnvProxy, "createEnvProxy");
-    __name(getEnvScope, "getEnvScope");
-    __name(assertServerEnvAccess, "assertServerEnvAccess");
-    __name(getInitialEnv, "getInitialEnv");
-    __name(getCurrentEnv, "getCurrentEnv");
-    __name(getInjectedEnv, "getInjectedEnv");
-    __name(getInjectedPublicEnv, "getInjectedPublicEnv");
-    __name(normalizeResolvedEnv, "normalizeResolvedEnv");
-    __name(isRecord4, "isRecord");
-  }
-});
-
 // src/plugin-dependencies.ts
 function pluginShortName(name2) {
   return name2.slice(Math.max(name2.lastIndexOf(":"), name2.lastIndexOf("/")) + 1);
@@ -13465,6 +13645,7 @@ function createFarmDocsHandler(docs, options) {
     if (!isFarmDocsRequest(docs, request2)) return null;
     const page2 = loadPage(contentDir, docs, request2);
     if (!page2) return null;
+    const negotiatesAccept = !requestUrl.pathname.endsWith(".md");
     if (shouldReturnMarkdown(request2)) {
       const origin = new URL(request2.url).origin;
       return omitFarmDocsHeadBody(
@@ -13479,7 +13660,8 @@ function createFarmDocsHandler(docs, options) {
             status: 200,
             headers: {
               "Content-Type": "text/markdown; charset=utf-8",
-              "Cache-Control": "public, max-age=60"
+              "Cache-Control": "public, max-age=60",
+              ...negotiatesAccept ? { Vary: "Accept" } : {}
             }
           }
         )
@@ -13509,6 +13691,7 @@ function createFarmDocsHandler(docs, options) {
           headers: {
             "Content-Type": "text/html; charset=utf-8",
             "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+            Vary: "Accept",
             ...fontPreloadHeader ? { Link: fontPreloadHeader } : {}
           }
         }
@@ -17453,6 +17636,7 @@ __export(vite_exports, {
   withFarmRequestTracing: () => withFarmRequestTracing
 });
 module.exports = __toCommonJS(vite_exports);
+init_env();
 
 // src/app.ts
 init_app_markdown_config();
@@ -19467,7 +19651,7 @@ function resolveImportedModule(importerPath, specifier, root) {
     return { path: resolveImportedModuleSourcePath(importerPath, specifier, root), local: true };
   }
   const aliased = resolveProjectAliasSourcePath(specifier, root);
-  if (aliased !== void 0) return { path: aliased, local: true };
+  if (aliased) return { path: aliased, local: true };
   return { path: resolvePackageModuleSourcePath(importerPath, specifier, root), local: false };
 }
 __name(resolveImportedModule, "resolveImportedModule");
@@ -19483,11 +19667,12 @@ function resolveProjectAliasSourcePath(specifier, root) {
     if (!match || alias.prefix.length > match.alias.prefix.length) match = { alias, captured };
   }
   if (!match) return void 0;
-  return resolveSourceCandidate(
+  const resolved = resolveSourceCandidate(
     match.alias.targets.map(
       (target) => import_path4.default.normalize(match.alias.wildcard ? target.replace("*", match.captured) : target)
     )
   );
+  return resolved && /\.d\.[cm]?ts$/.test(resolved) ? null : resolved;
 }
 __name(resolveProjectAliasSourcePath, "resolveProjectAliasSourcePath");
 function matchProjectImportAlias(alias, specifier) {
@@ -19894,6 +20079,7 @@ __name(readAltText, "readAltText");
 // src/routing/route-manager.ts
 init_route_runtime();
 init_routing();
+init_base_path();
 
 // src/redirect-query.ts
 function appendFarmRedirectQuery(destination, search) {
@@ -20970,7 +21156,7 @@ var _RouteManager = class _RouteManager {
   }
   toRoutePathname(pathname) {
     const i18n = this.getI18nConfig();
-    return i18n ? stripFarmLocaleFromPathname(pathname, i18n) : pathname;
+    return i18n ? stripFarmLocaleFromPathname(pathname, i18n) : stripFarmBasePath(pathname, this.config.basePath);
   }
   localizeRedirectDestination(destination, locale) {
     if (!locale || !destination.startsWith("/") || destination.startsWith("//")) {
@@ -21470,11 +21656,11 @@ function mergeMetadata(base, next) {
 __name(mergeMetadata, "mergeMetadata");
 function mergeMetadataTitle(base, next) {
   if (next === void 0) return base;
-  const parentTemplate = isRecord(base) ? normalizeContent(base.template) : void 0;
+  const parentTemplate = isRecord2(base) ? normalizeContent(base.template) : void 0;
   if (typeof next === "string") {
     return parentTemplate ? applyTitleTemplate(parentTemplate, next) : next;
   }
-  if (!isRecord(next)) return next;
+  if (!isRecord2(next)) return next;
   const defaultTitle = normalizeContent(next.default) ?? resolveMetadataTitle(base);
   return {
     ...next,
@@ -21525,8 +21711,8 @@ __name(addMetadataImageReference, "addMetadataImageReference");
 var MARKDOWN_MIME_TYPE = "text/markdown";
 function addMetadataMarkdownAlternate(metadata, href) {
   if (!href) return metadata;
-  const alternates = isRecord(metadata.alternates) ? metadata.alternates : {};
-  const types = isRecord(alternates.types) ? alternates.types : {};
+  const alternates = isRecord2(metadata.alternates) ? metadata.alternates : {};
+  const types = isRecord2(alternates.types) ? alternates.types : {};
   if (Object.keys(types).some((type) => type.toLowerCase() === MARKDOWN_MIME_TYPE)) {
     return metadata;
   }
@@ -21559,26 +21745,26 @@ function renderMetadataHead(metadata, options = {}) {
   appendMetaName(tags, "creator", resolvedMetadata.creator);
   appendMetaName(tags, "publisher", resolvedMetadata.publisher);
   appendMetaName(tags, "robots", normalizeRobots(resolvedMetadata.robots));
-  if (isRecord(resolvedMetadata.robots)) {
+  if (isRecord2(resolvedMetadata.robots)) {
     appendMetaName(tags, "googlebot", normalizeRobots(resolvedMetadata.robots.googleBot));
   }
   const alternates = resolvedMetadata.alternates;
-  const explicitCanonical = isRecord(alternates) ? alternates.canonical : void 0;
+  const explicitCanonical = isRecord2(alternates) ? alternates.canonical : void 0;
   const canonicalHref = explicitCanonical != null ? resolveMetadataUrl(explicitCanonical, metadataBase) : options.pathname ? resolveMetadataUrl(sanitizeSelfCanonicalPathname(options.pathname), metadataBase) : void 0;
   if (canonicalHref) {
     appendLink(tags, "canonical", canonicalHref);
   }
-  if (isRecord(alternates) && isRecord(alternates.languages)) {
+  if (isRecord2(alternates) && isRecord2(alternates.languages)) {
     for (const [language, href] of Object.entries(alternates.languages)) {
       appendLink(tags, "alternate", resolveMetadataUrl(href, metadataBase), {
         hreflang: language
       });
     }
   }
-  if (isRecord(alternates) && isRecord(alternates.types)) {
+  if (isRecord2(alternates) && isRecord2(alternates.types)) {
     for (const [type, value] of Object.entries(alternates.types)) {
       for (const entry of normalizeArray(value)) {
-        const link = isRecord(entry) ? entry : { url: entry };
+        const link = isRecord2(entry) ? entry : { url: entry };
         appendLink(tags, "alternate", resolveMetadataUrl(link.url, metadataBase), {
           type,
           title: link.title
@@ -21602,14 +21788,14 @@ function renderMetadataHead(metadata, options = {}) {
     const jsonLdConfig = options.jsonLd === true ? {} : options.jsonLd;
     const jsonLdScript = renderFarmAgentJsonLd(jsonLdConfig, {
       metadataBase,
-      siteName: isRecord(resolvedMetadata.openGraph) ? normalizeContent(resolvedMetadata.openGraph.siteName) : void 0,
+      siteName: isRecord2(resolvedMetadata.openGraph) ? normalizeContent(resolvedMetadata.openGraph.siteName) : void 0,
       title: explicitTitle,
       description: normalizeContent(resolvedMetadata.description)
     });
     if (jsonLdScript) tags.push(jsonLdScript);
   }
   for (const entry of normalizeArray(resolvedMetadata.jsonLd)) {
-    if (!isRecord(entry)) continue;
+    if (!isRecord2(entry)) continue;
     tags.push(
       `<script type="application/ld+json" ${FARM_METADATA_ATTRIBUTE}>${serializeJsonLd(entry)}</script>`
     );
@@ -21624,7 +21810,7 @@ function renderMetadataHead(metadata, options = {}) {
 }
 __name(renderMetadataHead, "renderMetadataHead");
 function mergeNestedMetadata(base, next) {
-  if (isRecord(base) && isRecord(next)) {
+  if (isRecord2(base) && isRecord2(next)) {
     return {
       ...base,
       ...next
@@ -21634,7 +21820,7 @@ function mergeNestedMetadata(base, next) {
 }
 __name(mergeNestedMetadata, "mergeNestedMetadata");
 function appendOpenGraph(tags, openGraph, metadataBase) {
-  if (!isRecord(openGraph)) return;
+  if (!isRecord2(openGraph)) return;
   appendMetaProperty(tags, "og:title", openGraph.title);
   appendMetaProperty(tags, "og:description", openGraph.description);
   appendMetaProperty(tags, "og:url", resolveMetadataUrl(openGraph.url, metadataBase));
@@ -21666,7 +21852,7 @@ function appendOpenGraph(tags, openGraph, metadataBase) {
 }
 __name(appendOpenGraph, "appendOpenGraph");
 function appendTwitter(tags, twitter, metadataBase) {
-  if (!isRecord(twitter)) return;
+  if (!isRecord2(twitter)) return;
   appendMetaName(tags, "twitter:card", twitter.card);
   appendMetaName(tags, "twitter:site", twitter.site);
   appendMetaName(tags, "twitter:creator", twitter.creator);
@@ -21679,7 +21865,7 @@ function appendTwitter(tags, twitter, metadataBase) {
 }
 __name(appendTwitter, "appendTwitter");
 function appendNamedMetaRecord(tags, record) {
-  if (!isRecord(record)) return;
+  if (!isRecord2(record)) return;
   for (const [name2, value] of Object.entries(record)) {
     for (const content of normalizeArray(value)) {
       appendMetaName(tags, name2, content, true);
@@ -21694,7 +21880,7 @@ function appendIcons(tags, icons, metadataBase) {
     appendLink(tags, "icon", resolveMetadataUrl(icons, metadataBase));
     return tags.length > initialTagCount2;
   }
-  if (!isRecord(icons)) return false;
+  if (!isRecord2(icons)) return false;
   const initialTagCount = tags.length;
   appendIconList(tags, "icon", icons.icon, metadataBase);
   appendIconList(tags, "shortcut icon", icons.shortcut, metadataBase);
@@ -21709,7 +21895,7 @@ function appendIconList(tags, rel, value, metadataBase) {
       appendLink(tags, rel, resolveMetadataUrl(icon2, metadataBase));
       continue;
     }
-    if (!isRecord(icon2)) continue;
+    if (!isRecord2(icon2)) continue;
     appendLink(tags, rel, resolveMetadataUrl(icon2.url, metadataBase), {
       sizes: icon2.sizes,
       type: icon2.type
@@ -21740,7 +21926,7 @@ var VERIFICATION_META_NAMES = [
   ["yandex", "yandex-verification"]
 ];
 function appendVerification(tags, verification) {
-  if (!isRecord(verification)) return;
+  if (!isRecord2(verification)) return;
   for (const [key, name2] of VERIFICATION_META_NAMES) {
     for (const token of normalizeArray(verification[key])) {
       appendMetaName(tags, name2, token);
@@ -21766,7 +21952,7 @@ function normalizeMetadataImages(value, metadataBase) {
     if (typeof item === "string") {
       return { url: resolveMetadataUrl(item, metadataBase) || item };
     }
-    if (!isRecord(item)) return null;
+    if (!isRecord2(item)) return null;
     const rawUrl = item.url || item.src;
     const url = resolveMetadataUrl(rawUrl, metadataBase);
     if (!url) return null;
@@ -21791,7 +21977,7 @@ function hasMetadataImages(value) {
 __name(hasMetadataImages, "hasMetadataImages");
 function resolveMetadataTitle(title) {
   if (typeof title === "string") return title;
-  if (isRecord(title)) {
+  if (isRecord2(title)) {
     return normalizeContent(title.default);
   }
   return void 0;
@@ -21811,7 +21997,7 @@ var ROBOTS_VALUES = [
 ];
 function normalizeRobots(robots) {
   if (typeof robots === "string") return robots;
-  if (!isRecord(robots)) return void 0;
+  if (!isRecord2(robots)) return void 0;
   const values = [];
   if (typeof robots.index === "boolean") values.push(robots.index ? "index" : "noindex");
   if (typeof robots.follow === "boolean") values.push(robots.follow ? "follow" : "nofollow");
@@ -21872,10 +22058,10 @@ function normalizeContent(value) {
   return void 0;
 }
 __name(normalizeContent, "normalizeContent");
-function isRecord(value) {
+function isRecord2(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
-__name(isRecord, "isRecord");
+__name(isRecord2, "isRecord");
 function escapeText(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
@@ -22159,7 +22345,7 @@ async function readFarmI18nCatalogs(config) {
 }
 __name(readFarmI18nCatalogs, "readFarmI18nCatalogs");
 function flattenFarmI18nCatalog(input, source = "i18n catalog") {
-  if (!isPlainObject2(input)) {
+  if (!isPlainObject3(input)) {
     throw new Error(`${source} must contain a JSON object at its root.`);
   }
   const output = {};
@@ -22173,7 +22359,7 @@ function flattenFarmI18nCatalog(input, source = "i18n catalog") {
       output[key] = value;
       return;
     }
-    if (!isPlainObject2(value)) {
+    if (!isPlainObject3(value)) {
       const key = segments.join(".") || "<root>";
       throw new Error(`${source} message "${key}" must be a string or nested object.`);
     }
@@ -22273,10 +22459,10 @@ function sameSignature(expected, actual) {
   return JSON.stringify(expectedEntries) === JSON.stringify(actualEntries);
 }
 __name(sameSignature, "sameSignature");
-function isPlainObject2(value) {
+function isPlainObject3(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-__name(isPlainObject2, "isPlainObject");
+__name(isPlainObject3, "isPlainObject");
 function messageOf(error) {
   return error instanceof Error ? error.message : String(error);
 }
@@ -23919,10 +24105,10 @@ function isResponse2(value) {
   ));
 }
 __name(isResponse2, "isResponse");
-function isRecord3(value) {
+function isRecord4(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-__name(isRecord3, "isRecord");
+__name(isRecord4, "isRecord");
 function resolveCacheControl2(revalidate) {
   if (revalidate === false) {
     return "public, max-age=31536000, immutable";
@@ -23942,7 +24128,7 @@ function serializeSitemap(value) {
     throw new TypeError("sitemap.ts must return an array or a Response");
   }
   const entries = value.map((candidate, index) => {
-    if (!isRecord3(candidate) || typeof candidate.url !== "string" || !candidate.url) {
+    if (!isRecord4(candidate) || typeof candidate.url !== "string" || !candidate.url) {
       throw new TypeError(`sitemap.ts entry ${index} must include a non-empty url`);
     }
     return candidate;
@@ -23984,7 +24170,7 @@ function toArray2(value) {
 }
 __name(toArray2, "toArray");
 function serializeRobots(value) {
-  if (!isRecord3(value)) {
+  if (!isRecord4(value)) {
     throw new TypeError("robots.ts must return a robots object or a Response");
   }
   const robots = value;
@@ -23993,7 +24179,7 @@ function serializeRobots(value) {
     throw new TypeError("robots.ts must return at least one rule");
   }
   const sections = rules.map((rule, index) => {
-    if (!isRecord3(rule)) {
+    if (!isRecord4(rule)) {
       throw new TypeError(`robots.ts rule ${index} must be an object`);
     }
     const userAgents = toArray2(rule.userAgent).filter(
@@ -24017,7 +24203,7 @@ function serializeRobots(value) {
 }
 __name(serializeRobots, "serializeRobots");
 function serializeManifest(value) {
-  if (!isRecord3(value)) {
+  if (!isRecord4(value)) {
     throw new TypeError("manifest.ts must return a manifest object or a Response");
   }
   return `${JSON.stringify(value, null, 2)}
@@ -25079,7 +25265,7 @@ _setFarmThemeServerSnapshotResolver(() => {
 });
 
 // package.json
-var version = "0.1.15";
+var version = "0.1.17";
 
 // src/version.ts
 var FARM_VERSION = version;
@@ -25369,7 +25555,7 @@ function createPPRRefreshScript() {
 __name(createPPRRefreshScript, "createPPRRefreshScript");
 function createPreHydrationClickQueueScript() {
   const selector = JSON.stringify(FARM_ISLAND_REPLAYABLE_SELECTOR);
-  return `<script>(function(){if(window.__FARM_PREHYDRATION_CLICK_QUEUE__)return;var queue=[];window.__FARM_PREHYDRATION_CLICK_QUEUE__=queue;window.__FARM_HYDRATED__=false;document.documentElement.dataset.farmHydrated="false";function isModified(event){return !!(event.metaKey||event.altKey||event.ctrlKey||event.shiftKey)}function inHydrated(node){return !!(node&&node.closest&&node.closest('[data-farm-island-hydrated="true"]'))}function closestQueuedTarget(target){while(target&&target!==document.documentElement){if(target.matches&&target.matches(${selector}))return target;target=target.parentElement}return null}function announce(target,kind){document.dispatchEvent(new CustomEvent("farm:island-interaction",{detail:{target:target,kind:kind||null}}))}function hold(event,target,kind){if(queue.some(function(item){return item.target===target}))return;queue.push({target:target,kind:kind,createdAt:Date.now()});announce(target,kind);event.preventDefault();event.stopImmediatePropagation()}document.addEventListener("click",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented||event.button!==0||isModified(event))return;var target=closestQueuedTarget(event.target);if(!target||target.closest&&target.closest("a[href]")||inHydrated(target))return;hold(event,target,"click")},true);document.addEventListener("submit",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented)return;var form=event.target;if(!form||form.nodeName!=="FORM"||inHydrated(form))return;hold(event,form,"submit")},true);function observe(event){if(window.__FARM_HYDRATED__)return;var target=event.target;if(!(target&&target.closest)||inHydrated(target))return;announce(target,null)}document.addEventListener("pointerdown",observe,true);document.addEventListener("focusin",observe,true);})();</script>`;
+  return `<script>(function(){if(window.__FARM_PREHYDRATION_CLICK_QUEUE__)return;var queue=[];window.__FARM_PREHYDRATION_CLICK_QUEUE__=queue;window.__FARM_HYDRATED__=false;document.documentElement.dataset.farmHydrated="false";function isModified(event){return !!(event.metaKey||event.altKey||event.ctrlKey||event.shiftKey)}function inHydrated(node){return !!(node&&node.closest&&node.closest('[data-farm-island-hydrated="true"]'))}function closestQueuedTarget(target){while(target&&target!==document.documentElement){if(target.matches&&target.matches(${selector}))return target;target=target.parentElement}return null}function announce(target,kind){document.dispatchEvent(new CustomEvent("farm:island-interaction",{detail:{target:target,kind:kind||null}}))}function hold(event,target,kind){if(!queue.some(function(item){return item.target===target})){queue.push({target:target,kind:kind,createdAt:Date.now()});announce(target,kind)}event.preventDefault();event.stopImmediatePropagation()}document.addEventListener("click",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented||event.button!==0||isModified(event))return;var target=closestQueuedTarget(event.target);if(!target||target.closest&&target.closest("a[href]")||inHydrated(target))return;hold(event,target,"click")},true);document.addEventListener("submit",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented)return;var form=event.target;if(!form||form.nodeName!=="FORM"||inHydrated(form))return;hold(event,form,"submit")},true);function observe(event){if(window.__FARM_HYDRATED__)return;var target=event.target;if(!(target&&target.closest)||inHydrated(target))return;announce(target,null)}document.addEventListener("pointerdown",observe,true);document.addEventListener("focusin",observe,true);})();</script>`;
 }
 __name(createPreHydrationClickQueueScript, "createPreHydrationClickQueueScript");
 function createDocumentFooter(options) {
@@ -28729,7 +28915,7 @@ function createEndpoint(pathOrOptions, optionsOrHandler, maybeHandler) {
     wrappedHandler
   );
   endpoint.__path = path39 || void 0;
-  endpoint.__method = options.method || "GET";
+  endpoint.__method = options.method || (path39 ? "GET" : void 0);
   endpoint.__autoPath = !path39;
   endpoint.__handler = wrappedHandler;
   endpoint.__farmInvoke = (ctx) => runEndpointMiddleware(middleware, ctx, handler, error, options.invalidates);
@@ -30317,7 +30503,7 @@ function parseColonParam(segment) {
   };
 }
 __name(parseColonParam, "parseColonParam");
-function compilePathPattern(pattern) {
+function compilePathPattern(pattern, trailingSlash = false) {
   const params = [];
   const segments = pattern.split("/").filter(Boolean);
   if (segments.length === 0) {
@@ -30353,11 +30539,18 @@ function compilePathPattern(pattern) {
   });
   return {
     kind: "path",
-    regex: new RegExp(`^${parts.join("")}$`),
+    regex: new RegExp(`^${parts.join("")}${trailingSlash ? "/?" : ""}$`),
     params
   };
 }
 __name(compilePathPattern, "compilePathPattern");
+function compileMatcherPattern(pattern) {
+  if (typeof pattern === "string" && pattern !== "*" && !pattern.endsWith("(.*)")) {
+    return compilePathPattern(pattern, true);
+  }
+  return compilePattern(pattern);
+}
+__name(compileMatcherPattern, "compileMatcherPattern");
 function compilePattern(pattern) {
   if (pattern instanceof RegExp) {
     return { kind: "regexp", regex: pattern };
@@ -30377,7 +30570,7 @@ __name(compilePattern, "compilePattern");
 function compileMiddlewareConfig(config) {
   const compiled = {
     matcher: config.matcher ? toMatcherList(config.matcher).map(
-      (matcher) => typeof matcher === "function" ? matcher : compilePattern(matcher)
+      (matcher) => typeof matcher === "function" ? matcher : compileMatcherPattern(matcher)
     ) : void 0,
     exclude: config.exclude?.map(compilePattern)
   };
@@ -31643,6 +31836,7 @@ __name(collectLegacyTypeArtifacts, "collectLegacyTypeArtifacts");
 // src/vite.ts
 init_routes_shared();
 init_markdown();
+init_base_path();
 init_llms_txt();
 init_agent_crawlers();
 init_response();
@@ -33092,7 +33286,7 @@ function getEnvDefines(config, configEnv) {
     )
   };
   if (configEnv?.isSsrBuild) {
-    defines.__FARM_ENV__ = JSON.stringify(getFullEnvDefine(config));
+    defines.__FARM_ENV__ = JSON.stringify(createBundledEnv(getFullEnvDefine(config)));
   }
   return defines;
 }
@@ -33369,8 +33563,8 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "emitPluginError");
       farmApp = new FarmApp(
         {
-          root: server.config.root,
-          ...options
+          ...options,
+          root: resolveDevelopmentRoot(options.root, server.config.root)
         },
         server
       );
@@ -33957,7 +34151,8 @@ window.__FARM_MANIFEST__ = ${inlineValue({
               () => middlewareManager.execute(req, res)
             );
           }, "runAppMiddlewareForContentRoute");
-          if (openAPIManager && options.openapi?.specRoute && requestPathname === options.openapi.specRoute) {
+          const openAPIRequestPathname = openAPIManager ? stripFarmBasePath(requestPathname, farmConfig.basePath) : requestPathname;
+          if (openAPIManager && options.openapi?.specRoute && openAPIRequestPathname === options.openapi.specRoute) {
             if (await runAppMiddlewareForContentRoute()) return;
             if (requestMethod !== "GET" && requestMethod !== "HEAD") {
               res.statusCode = 405;
@@ -33974,7 +34169,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             res.end(requestMethod === "HEAD" ? void 0 : body);
             return;
           }
-          if (openAPIManager && requestPathname === options.openapi?.route) {
+          if (openAPIManager && openAPIRequestPathname === options.openapi?.route) {
             if (await runAppMiddlewareForContentRoute()) return;
             const docsHandler = openAPIManager.getDocsRouteHandler(parsedRequestUrl.origin);
             return docsHandler(req, res);
@@ -34452,6 +34647,21 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 headers: request2.headers,
                 signal: request2.signal
               });
+              let middlewareMap = /* @__PURE__ */ new Map();
+              let middlewareContext = /* @__PURE__ */ new Map();
+              if (middlewareManager?.hasMiddleware()) {
+                const targetNodeRequest = createPageDataMiddlewareRequest(req, targetRequestUrl);
+                const handled = await runFarmMiddlewareWithNavigation(
+                  farmApp.getServerRenderer(),
+                  targetRequest,
+                  targetNodeRequest,
+                  res,
+                  () => middlewareManager.execute(targetNodeRequest, res)
+                );
+                if (handled) return;
+                middlewareMap = targetNodeRequest.__FARM_MIDDLEWARE_DATA__ ?? middlewareMap;
+                middlewareContext = targetNodeRequest.__FARM_MIDDLEWARE_CONTEXT__ ?? middlewareContext;
+              }
               await farmApp.getServerRenderer().runWithRequestContext(targetRequest, async () => {
                 const routeManager3 = farmApp.getRouteManager();
                 if (pm) {
@@ -34525,7 +34735,8 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                     {
                       params,
                       searchParams: Promise.resolve(searchParams),
-                      path: targetUrl.pathname
+                      path: targetUrl.pathname,
+                      middleware: middlewareMap.size > 0 ? { data: middlewareMap } : void 0
                     },
                     routeContext
                   ),
@@ -34613,27 +34824,34 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   parseFarmLayoutChainHeader(request2.headers.get("x-farm-layout-chain")),
                   destinationLayoutPatterns
                 );
-                const fragmentHtml = await farmApp.getServerRenderer().renderNavigationFragment({
-                  PageComponent: routeModule.default,
-                  LoadingComponent: loadingModule?.default,
-                  pageProps: routeProps,
-                  params,
-                  layouts: layouts.map((layout2, index) => ({
-                    pattern: layout2.pattern,
-                    module: layoutModules[index]
-                  })),
-                  layoutStartIndex,
-                  slots: routeSlots.map((slot) => ({
-                    name: slot.name,
-                    ownerPattern: slot.ownerPattern,
-                    containerId: slot.containerId,
-                    module: slot.renderModule,
-                    props: slot.props
-                  })),
-                  pageShouldHydrate: shouldHydrate,
-                  layoutShouldHydrate: shouldHydrateLayout,
-                  islandStrategy: hydrationIslandStrategy
-                });
+                const renderer = farmApp.getServerRenderer();
+                const fragmentHtml = await _runWithMiddlewareData(
+                  middlewareMap,
+                  () => _runWithMiddlewareContext(
+                    middlewareContext,
+                    () => renderer.renderNavigationFragment({
+                      PageComponent: routeModule.default,
+                      LoadingComponent: loadingModule?.default,
+                      pageProps: routeProps,
+                      params,
+                      layouts: layouts.map((layout2, index) => ({
+                        pattern: layout2.pattern,
+                        module: layoutModules[index]
+                      })),
+                      layoutStartIndex,
+                      slots: routeSlots.map((slot) => ({
+                        name: slot.name,
+                        ownerPattern: slot.ownerPattern,
+                        containerId: slot.containerId,
+                        module: slot.renderModule,
+                        props: slot.props
+                      })),
+                      pageShouldHydrate: shouldHydrate,
+                      layoutShouldHydrate: shouldHydrateLayout,
+                      islandStrategy: hydrationIslandStrategy
+                    })
+                  )
+                );
                 const pageData = {
                   props: {
                     params: routeProps.params,
@@ -34643,7 +34861,9 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                     ...routeProps.__farmCanonicalPath ? {
                       __farmCanonicalPath: routeProps.__farmCanonicalPath
                     } : {},
-                    ...routeProps.__farmRoutePropsResolved ? { __farmRoutePropsResolved: true } : {}
+                    ...routeProps.__farmRoutePropsResolved ? { __farmRoutePropsResolved: true } : {},
+                    // The same serialized shape a full load embeds in __FARM_PROPS__.
+                    ...middlewareMap.size > 0 ? { middleware: { data: Object.fromEntries(middlewareMap) } } : {}
                   },
                   canonicalPath: routeProps.__farmCanonicalPath,
                   modulePath: toUrlPath(route.modulePath),
@@ -35393,6 +35613,26 @@ function runFarmMiddlewareWithNavigation(renderer, middlewareRequest, req, res,
   });
 }
 __name(runFarmMiddlewareWithNavigation, "runFarmMiddlewareWithNavigation");
+function createPageDataMiddlewareRequest(req, target) {
+  const targetNodeRequest = Object.create(req);
+  targetNodeRequest.url = `${target.pathname}${target.search}`;
+  targetNodeRequest.originalUrl = targetNodeRequest.url;
+  targetNodeRequest.method = "GET";
+  return targetNodeRequest;
+}
+__name(createPageDataMiddlewareRequest, "createPageDataMiddlewareRequest");
+function resolveDevelopmentRoot(farmRoot, viteRoot) {
+  if (!farmRoot) return viteRoot;
+  if (path38.resolve(farmRoot) === path38.resolve(viteRoot)) return farmRoot;
+  try {
+    if (fs14.realpathSync(farmRoot) === fs14.realpathSync(viteRoot)) {
+      return path38.resolve(viteRoot);
+    }
+  } catch {
+  }
+  return farmRoot;
+}
+__name(resolveDevelopmentRoot, "resolveDevelopmentRoot");
 function isFarmClientVirtualId(id) {
   const pathname = id.split("?", 1)[0];
   return pathname === "/@farm/client" || pathname === "/@farm/client.js";
@@ -35408,16 +35648,18 @@ function generateProgrammaticRouteModule(moduleId, root, renderer = REACT_RENDER
     return generateProgrammaticApiRouteModule(parsed.routePath, routeFile);
   }
   return `
-import {
-  createElement as __farmCreateElement,
-  Suspense as __farmSuspense,
-} from ${JSON.stringify(renderer.server)};
+import * as __farmRendererRuntime from ${JSON.stringify(renderer.server)};
 import {
   createLayoutModuleFromProgrammaticLayout as __farmCreateLayoutRouteModule,
   createRouteModuleFromProgrammaticPage as __farmCreatePageRouteModule,
 } from "@farm.js/core/routes";
 import * as __farmRoutesModule from ${JSON.stringify(routeFile)};
 
+const __farmCreateElement = __farmRendererRuntime.createElement;
+const __farmSuspense = __farmRendererRuntime.Suspense;
+// Optional hook: only renderers that need it export markFunctionComponent.
+const __farmMarkFunctionComponent = Reflect.get(__farmRendererRuntime, "markFunctionComponent");
+
 const __farmIsRouteDefinition = (value) => (
   value &&
   typeof value === "object" &&
@@ -35471,6 +35713,7 @@ const __farmRouteModule = __farmRoute.kind === "layout"
   : __farmCreatePageRouteModule(__farmRoute, {
       createElement: __farmCreateElement,
       Suspense: __farmSuspense,
+      markFunctionComponent: __farmMarkFunctionComponent,
     });
 
 export const metadata = __farmRouteModule.metadata;
@@ -37080,6 +37323,11 @@ async function hydrate() {
       pendingPageHydrationController = hydrationController;
       await hydrateFarmIsolatedClientBoundaries(rootContainer, hydrationController.signal);
       if (hydrationController.signal.aborted) return;
+      // The rest of the document is static server HTML with nothing to hydrate, so
+      // stop holding its clicks and submits once the load-strategy islands are live.
+      // Deferred islands capture their own interactions, and held targets outside an
+      // island are not replayed into DOM no client code owns.
+      markFarmHydrated();
       return;
     }` : ""}
     if (!shouldHydrate) {