@farm.js/core 0.1.0-beta.80 → 0.1.0-beta.81

package/dist/client.d.mts

@@ -7,8 +7,8 @@ export { UseServerQueryOptions, UseServerQueryResult, useServerQuery } from './s
 export { F as FarmIntegrationAPI, e as FarmIntegrationAPIBodyFormat, f as FarmIntegrationAPIMethod, a as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, b as api, d as defineIntegrationAPI, c as defineIntegrationAPIOperation, i as endpoint } from './config-C0N_7HJ6.mjs';
 export { UseThemeResult, useTheme } from './theme/client.mjs';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.mjs';
-import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-BM-OHflh.mjs';
-export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-BM-OHflh.mjs';
+import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-Cr39oWnX.mjs';
+export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-Cr39oWnX.mjs';
 import { b as FarmI18nLocale } from './types-mP6R6CzS.mjs';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery-lnQFzcQP.mjs';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-De0vQG45.mjs';
@@ -22,8 +22,8 @@ import './server-query.mjs';
 import './env.mjs';
 import './types-DQnyD3VD.mjs';
 import './island-CfGru1MO.mjs';
-import './render-plan-HL0ChBbH.mjs';
-import './client-plugins-BtfLE4dW.mjs';
+import './render-plan-D3TuPEmY.mjs';
+import './client-plugins-HizW0gLc.mjs';
 import './renderer.mjs';
 import 'http';
 import './types-D1A6-XvH.mjs';

package/dist/client.d.ts

@@ -7,8 +7,8 @@ export { UseServerQueryOptions, UseServerQueryResult, useServerQuery } from './s
 export { F as FarmIntegrationAPI, e as FarmIntegrationAPIBodyFormat, f as FarmIntegrationAPIMethod, a as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, b as api, d as defineIntegrationAPI, c as defineIntegrationAPIOperation, i as endpoint } from './config-B6GcJfNA.js';
 export { UseThemeResult, useTheme } from './theme/client.js';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.js';
-import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-DMKCWHT5.js';
-export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-DMKCWHT5.js';
+import { i as FarmViewTransitionMode, e as FarmNavigationBlockerContext, F as FarmNavigationState } from './spa-router-C7RwU8o-.js';
+export { a as FarmNavigateOptions, d as FarmNavigationBlocker, f as FarmNavigationListener, h as FarmNavigationLocation, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, b as pushState, r as readPageState, c as replaceState } from './spa-router-C7RwU8o-.js';
 import { b as FarmI18nLocale } from './types-mP6R6CzS.js';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery-lnQFzcQP.js';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-De0vQG45.js';
@@ -22,8 +22,8 @@ import './server-query.js';
 import './env.js';
 import './types-DQnyD3VD.js';
 import './island-CfGru1MO.js';
-import './render-plan-DZ0LA8wX.js';
-import './client-plugins-C4me5UPd.js';
+import './render-plan-C62oFdVD.js';
+import './client-plugins-w_b1wA8e.js';
 import './renderer.js';
 import 'http';
 import './types-D1A6-XvH.js';

package/dist/client.mjs

@@ -16,7 +16,7 @@ import {
   usePageState,
   useRouter,
   useScrollRestoration
-} from "./chunk-DBG42367.mjs";
+} from "./chunk-CVCIL6KH.mjs";
 import {
   useTheme
 } from "./chunk-CHITERV2.mjs";
@@ -53,7 +53,7 @@ import {
   pushState,
   readPageState,
   replaceState
-} from "./chunk-3HIATXA4.mjs";
+} from "./chunk-XSUYR4Q3.mjs";
 import "./chunk-EUUCXDW6.mjs";
 import "./chunk-JIT7GXDP.mjs";
 import "./chunk-6Q7GEEA7.mjs";
@@ -63,7 +63,7 @@ import {
   createClientPluginManager,
   installChunkErrorRecovery,
   isChunkLoadError
-} from "./chunk-3UGGCJT5.mjs";
+} from "./chunk-HSCQGINR.mjs";
 import "./chunk-RCNUKRBF.mjs";
 import "./chunk-GQVQESLY.mjs";
 import {
@@ -84,7 +84,7 @@ import "./chunk-RBRLLZL5.mjs";
 import "./chunk-WZ5QFROO.mjs";
 import "./chunk-ZRBCBOEX.mjs";
 import "./chunk-FXG2PS27.mjs";
-import "./chunk-OEI62POE.mjs";
+import "./chunk-6NV2RJSZ.mjs";
 import "./chunk-44ZCFSKE.mjs";
 import "./chunk-CGILA3WO.mjs";
 export {

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { a5 as FarmUserConfig } from './client-plugins-BtfLE4dW.mjs';
+import { a5 as FarmUserConfig } from './client-plugins-HizW0gLc.mjs';
 import './lifecycle-De0vQG45.mjs';
 import './renderer.mjs';
 import 'http';

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { a5 as FarmUserConfig } from './client-plugins-C4me5UPd.js';
+import { a5 as FarmUserConfig } from './client-plugins-w_b1wA8e.js';
 import './lifecycle-De0vQG45.js';
 import './renderer.js';
 import 'http';

package/dist/index.cjs

@@ -15912,7 +15912,7 @@ var init_server3 = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.80";
+    version = "0.1.0-beta.81";
   }
 });
 
@@ -30114,6 +30114,7 @@ var init_image_sharp = __esm({
 // src/vite.ts
 var vite_exports = {};
 __export(vite_exports, {
+  createFarmNodeRequestAbortSignal: () => createFarmNodeRequestAbortSignal,
   defineConfig: () => defineConfig2,
   farmI18nClientBridgePlugin: () => farmI18nClientBridgePlugin,
   farmPlugin: () => farmPlugin,
@@ -30187,7 +30188,7 @@ function getPublicEnvDefine(config) {
   }
   return publicEnv2;
 }
-function createRequestFromNodeRequest(req, url) {
+function createRequestFromNodeRequest(req, url, signal) {
   const headers2 = new Headers();
   for (const [key, value] of Object.entries(req.headers)) {
     if (Array.isArray(value)) {
@@ -30198,9 +30199,36 @@ function createRequestFromNodeRequest(req, url) {
   }
   return new Request(url.toString(), {
     method: req.method || "GET",
-    headers: headers2
+    headers: headers2,
+    signal
   });
 }
+function createFarmNodeRequestAbortSignal(req, res) {
+  const controller = new AbortController();
+  let disposed = false;
+  const dispose = /* @__PURE__ */ __name(() => {
+    if (disposed) return;
+    disposed = true;
+    req.off("aborted", abort);
+    res.off("close", abortOnEarlyClose);
+    res.off("finish", dispose);
+    controller.signal.removeEventListener("abort", dispose);
+  }, "dispose");
+  const abort = /* @__PURE__ */ __name(() => controller.abort(), "abort");
+  const abortOnEarlyClose = /* @__PURE__ */ __name(() => {
+    if (!res.writableEnded) abort();
+    dispose();
+  }, "abortOnEarlyClose");
+  if (req.aborted) {
+    controller.abort();
+    return controller.signal;
+  }
+  req.once("aborted", abort);
+  res.once("close", abortOnEarlyClose);
+  res.once("finish", dispose);
+  controller.signal.addEventListener("abort", dispose, { once: true });
+  return controller.signal;
+}
 function withFarmRequestTracing(handler) {
   const middleware2 = _withAfterNodeMiddleware(handler);
   return (req, res, next) => {
@@ -31468,7 +31496,11 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             const urlObj = new URL(req.url, `http://${req.headers.host || "localhost:3000"}`);
             const targetPath = urlObj.searchParams.get("path") || "/";
             try {
-              const request = createRequestFromNodeRequest(req, urlObj);
+              const request = createRequestFromNodeRequest(
+                req,
+                urlObj,
+                createFarmNodeRequestAbortSignal(req, res)
+              );
               const deploymentMismatch = getFarmDeploymentMismatch(
                 request,
                 farmConfig.deploymentId
@@ -31483,7 +31515,8 @@ window.__FARM_MANIFEST__ = ${inlineValue({
               const targetRequestUrl = new URL(targetPath, request.url);
               const targetRequest = new Request(targetRequestUrl, {
                 method: "GET",
-                headers: request.headers
+                headers: request.headers,
+                signal: request.signal
               });
               await farmApp.getServerRenderer().runWithRequestContext(targetRequest, async () => {
                 const routeManager3 = farmApp.getRouteManager();
@@ -31562,7 +31595,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 const targetUrl = new URL(targetPath, "http://localhost");
                 const searchParams = searchParamsToObject(targetUrl.searchParams);
                 const routeContext = await resolveFarmRouteContext(farmApp.getConfig(), {
-                  request,
+                  request: targetRequest,
                   params,
                   search: searchParams,
                   path: targetUrl.pathname
@@ -31586,7 +31619,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                       (entry) => entry.name === slot.name && entry.ownerPattern === slot.ownerPattern && entry.pattern === slot.route.pattern
                     ) ?? getClientModuleMetadata(slot.route.modulePath, server.config.root);
                     const slotContext = await resolveFarmRouteContext(farmApp.getConfig(), {
-                      request,
+                      request: targetRequest,
                       params: slot.params,
                       search: searchParams,
                       path: targetUrl.pathname
@@ -34527,6 +34560,7 @@ async function mountFarmDocsSearch() {
     __name(renderFarmI18nStaticHead, "renderFarmI18nStaticHead");
     __name(getPublicEnvDefine, "getPublicEnvDefine");
     __name(createRequestFromNodeRequest, "createRequestFromNodeRequest");
+    __name(createFarmNodeRequestAbortSignal, "createFarmNodeRequestAbortSignal");
     __name(withFarmRequestTracing, "withFarmRequestTracing");
     __name(toRequestBody, "toRequestBody");
     __name(applyWebRequestToNodeRequest, "applyWebRequestToNodeRequest");
@@ -43442,6 +43476,7 @@ __name(generateRuntimePathMatcherSource, "generateRuntimePathMatcherSource");
 function generateUniversalRouterStateProperties() {
   return `
   blockers: new Set(),
+  unloadBlockers: new Map(),
   navigationListeners: new Set(),
   navigationState: IDLE_NAVIGATION_STATE,
   navigationSequence: 0,
@@ -43485,9 +43520,20 @@ function generateUniversalRouterStateProperties() {
     return () => this.navigationListeners.delete(listener);
   },
 
-  addBlocker: function(blocker) {
+  addBlocker: function(blocker, shouldBlockUnload) {
     this.blockers.add(blocker);
-    return () => this.blockers.delete(blocker);
+    this.unloadBlockers.set(blocker, shouldBlockUnload || (() => {
+      const result = blocker({ from: this.currentPath, to: this.currentPath, action: "replace" });
+      if (result && typeof result.then === "function") {
+        result.catch(() => undefined);
+        return true;
+      }
+      return result === true;
+    }));
+    return () => {
+      this.blockers.delete(blocker);
+      this.unloadBlockers.delete(blocker);
+    };
   },
 
   shouldBlockNavigation: async function(context) {
@@ -43497,6 +43543,17 @@ function generateUniversalRouterStateProperties() {
     return false;
   },
 
+  shouldBlockUnload: function() {
+    for (const blocker of this.blockers) {
+      try {
+        if (this.unloadBlockers.get(blocker)?.()) return true;
+      } catch {
+        return true;
+      }
+    }
+    return false;
+  },
+
   handlePopState: function(event) {
     if (document.documentElement.dataset.farmDocsRuntime === "true") return;
     return this.navigate(window.location.href, {
@@ -43587,17 +43644,10 @@ function generateUniversalRouterStateProperties() {
 
   writePageState: function(action, state, href) {
     const url = new URL(href || window.location.href, window.location.origin);
-    this.writeHistoryEntry(action, url.pathname + url.search, state, url);
-    // Announce on the dedicated history channel; a synthetic popstate would
-    // be treated as back/forward by the popstate listener below and trigger
-    // a full navigation for a shallow page-state write. The bundled client
-    // hooks subscribe to this event via subscribeHistoryChange.
-    window.dispatchEvent(
-      new CustomEvent("farm:historychange", { detail: { kind: "page-state" } }),
-    );
+    this.writeHistoryEntry(action, url.pathname + url.search, state, url, "page-state");
   },
 
-  writeHistoryEntry: function(action, path, pageState, url) {
+  writeHistoryEntry: function(action, path, pageState, url, changeKind = "url-search") {
     if (action === "pop") return;
     const nextState = createHistoryState(path, pageState, window.history.state);
     const nextIndex = this.currentHistoryIndex == null
@@ -43610,6 +43660,11 @@ function generateUniversalRouterStateProperties() {
     else window.history.pushState(nextState, "", url);
     this.currentHistoryIndex = nextIndex;
     this.currentHistoryState = nextState;
+    // Announce programmatic history writes without synthesizing popstate,
+    // which the router reserves for real back/forward navigation.
+    window.dispatchEvent(
+      new CustomEvent("farm:historychange", { detail: { kind: changeKind } }),
+    );
   },
 
   registerScrollElement: function(key, element) {
@@ -43808,12 +43863,14 @@ ${generateUniversalRouterStateProperties()}
     const url = new URL(href, window.location.origin);
     if (isFarmExternalNavigationURL(url, window.location.origin)) {
       this.cancelActiveNavigation();
-      window.location.href = href;
+      if (options.replace || options.action === "replace") window.location.replace(href);
+      else window.location.href = href;
       return;
     }
     if (isFarmDocsPath(url.pathname)) {
       this.cancelActiveNavigation();
-      window.location.href = href;
+      if (options.replace || options.action === "replace") window.location.replace(href);
+      else window.location.href = href;
       return;
     }
 
@@ -43975,6 +44032,7 @@ ${generateUniversalRouterStateProperties()}
   prefetch: function(href) {
     const url = new URL(href, window.location.origin);
     if (isFarmExternalNavigationURL(url, window.location.origin)) return;
+    if (isFarmDocsPath(url.pathname)) return;
     
     const pathname = url.pathname + url.search;
     if (this.prefetchCache.has(pathname)) return;
@@ -44038,7 +44096,7 @@ window.__FARM_SPA_ROUTER__ = spaRouter;
 void hydrateFarmDocsAdapterRuntime();
 
 window.addEventListener("beforeunload", function(event) {
-  if (spaRouter.blockers.size > 0) {
+  if (spaRouter.shouldBlockUnload()) {
     event.preventDefault();
     event.returnValue = "";
   }
@@ -44661,12 +44719,14 @@ ${generateUniversalRouterStateProperties()}
     const url = new URL(href, window.location.origin);
     if (isFarmExternalNavigationURL(url, window.location.origin)) {
       this.cancelActiveNavigation();
-      window.location.href = href;
+      if (options.replace || options.action === "replace") window.location.replace(href);
+      else window.location.href = href;
       return;
     }
     if (isFarmDocsPath(url.pathname)) {
       this.cancelActiveNavigation();
-      window.location.href = href;
+      if (options.replace || options.action === "replace") window.location.replace(href);
+      else window.location.href = href;
       return;
     }
 
@@ -45003,6 +45063,7 @@ ${generateUniversalRouterStateProperties()}
   prefetch: function(href) {
     const url = new URL(href, window.location.origin);
     if (isFarmExternalNavigationURL(url, window.location.origin)) return;
+    if (isFarmDocsPath(url.pathname)) return;
     
     const pathname = url.pathname + url.search;
     const interceptFrom = this.currentPath;
@@ -45062,7 +45123,7 @@ spaRouter.initializeHistory();
 window.__FARM_SPA_ROUTER__ = spaRouter;
 
 window.addEventListener("beforeunload", function(event) {
-  if (spaRouter.blockers.size > 0) {
+  if (spaRouter.shouldBlockUnload()) {
     event.preventDefault();
     event.returnValue = "";
   }
@@ -50921,6 +50982,14 @@ init_deferred();
 
 // src/client/history-sync.ts
 var FARM_HISTORY_CHANGE_EVENT = "farm:historychange";
+function dispatchHistoryChange(kind) {
+  window.dispatchEvent(
+    new CustomEvent(FARM_HISTORY_CHANGE_EVENT, {
+      detail: { kind }
+    })
+  );
+}
+__name(dispatchHistoryChange, "dispatchHistoryChange");
 function notifyHistoryChange(kind) {
   if (typeof window === "undefined") return;
   setTimeout(() => {
@@ -50928,14 +50997,15 @@ function notifyHistoryChange(kind) {
       window.dispatchEvent(new PopStateEvent("popstate"));
       return;
     }
-    window.dispatchEvent(
-      new CustomEvent(FARM_HISTORY_CHANGE_EVENT, {
-        detail: { kind }
-      })
-    );
+    dispatchHistoryChange(kind);
   }, 0);
 }
 __name(notifyHistoryChange, "notifyHistoryChange");
+function notifyRouterHistoryChange() {
+  if (typeof window === "undefined") return;
+  setTimeout(() => dispatchHistoryChange("url-search"), 0);
+}
+__name(notifyRouterHistoryChange, "notifyRouterHistoryChange");
 function subscribeHistoryChange(listener) {
   if (typeof window === "undefined") return () => {
   };
@@ -51003,6 +51073,7 @@ var _SPARouter = class _SPARouter {
     this.prefetchingUrls = /* @__PURE__ */ new Set();
     this.observers = /* @__PURE__ */ new Map();
     this.blockers = /* @__PURE__ */ new Set();
+    this.unloadBlockers = /* @__PURE__ */ new Map();
     this.navigationListeners = /* @__PURE__ */ new Set();
     this.navigationState = IDLE_NAVIGATION_STATE;
     this.currentHistoryPath = null;
@@ -51014,7 +51085,7 @@ var _SPARouter = class _SPARouter {
       void this.handlePopState(event);
     }, "onPopState");
     this.onBeforeUnload = /* @__PURE__ */ __name((event) => {
-      if (this.blockers.size > 0) {
+      if (this.shouldBlockUnload()) {
         event.preventDefault();
         event.returnValue = "";
       }
@@ -51192,6 +51263,7 @@ var _SPARouter = class _SPARouter {
     if (isFarmLocaleChangeHref(href)) return;
     const url = new URL(href, window.location.origin);
     if (isFarmExternalNavigationURL(url, window.location.origin)) return;
+    if (this.options.shouldUseDocumentNavigation(url.pathname)) return;
     const fullPath = url.pathname + url.search;
     const interceptFrom = window.location.pathname + window.location.search;
     if (this.prefetchingUrls.has(fullPath)) return;
@@ -51240,10 +51312,15 @@ var _SPARouter = class _SPARouter {
       this.observers.delete(element);
     }
   }
-  addBlocker(blocker) {
+  addBlocker(blocker, shouldBlockUnload2) {
     this.blockers.add(blocker);
+    this.unloadBlockers.set(
+      blocker,
+      shouldBlockUnload2 ?? (() => this.evaluateBlockerForUnload(blocker))
+    );
     return () => {
       this.blockers.delete(blocker);
+      this.unloadBlockers.delete(blocker);
     };
   }
   getNavigationState() {
@@ -51272,11 +51349,16 @@ var _SPARouter = class _SPARouter {
     this.writePageState("replace", state, href);
   }
   async commitNavigation(options) {
-    const historyPath = options.pageData.canonicalPath || options.fullPath;
+    const historyUrl = new URL(
+      options.pageData.canonicalPath || options.fullPath,
+      window.location.origin
+    );
+    historyUrl.hash = options.url.hash;
+    const historyPath = historyUrl.pathname + historyUrl.search + historyUrl.hash;
     const historyState = createHistoryState(
       historyPath,
       options.state,
-      void 0,
+      options.replace ? window.history.state : void 0,
       options.pageData.interception?.from ?? null
     );
     const nextHistoryIndex = this.currentHistoryIndex == null ? null : options.replace ? this.currentHistoryIndex : this.currentHistoryIndex + 1;
@@ -51290,18 +51372,8 @@ var _SPARouter = class _SPARouter {
     }
     this.currentHistoryIndex = nextHistoryIndex;
     this.currentHistoryPath = new URL(historyPath, window.location.origin).pathname + new URL(historyPath, window.location.origin).search;
-    if (options.pageData.metadata?.title) {
-      document.title = options.pageData.metadata.title;
-    }
-    if (options.pageData.metadata?.description) {
-      let metaDesc = document.querySelector('meta[name="description"]');
-      if (!metaDesc) {
-        metaDesc = document.createElement("meta");
-        metaDesc.setAttribute("name", "description");
-        document.head.appendChild(metaDesc);
-      }
-      metaDesc.setAttribute("content", options.pageData.metadata.description);
-    }
+    notifyRouterHistoryChange();
+    this.updateDocumentMetadata(options.pageData.metadata);
     _hydrateFarmI18n(options.pageData.i18n);
     if (this.onNavigate) {
       await this.onNavigate(options.pageData);
@@ -51451,9 +51523,7 @@ var _SPARouter = class _SPARouter {
         await this.clientPlugins?.markNavigationLoaded(clientNavigation, pageData);
       }
       if (!this.isCurrentNavigation(navigation, clientNavigation)) return;
-      if (pageData.metadata?.title) {
-        document.title = pageData.metadata.title;
-      }
+      this.updateDocumentMetadata(pageData.metadata);
       _hydrateFarmI18n(pageData.i18n);
       if (this.onNavigate) {
         await this.onNavigate(pageData);
@@ -51497,6 +51567,39 @@ var _SPARouter = class _SPARouter {
     }
     return false;
   }
+  evaluateBlockerForUnload(blocker) {
+    const path41 = window.location.pathname + window.location.search;
+    const result = blocker({ from: path41, to: path41, action: "replace" });
+    if (result && typeof result !== "boolean") {
+      void result.catch(() => void 0);
+      return true;
+    }
+    return result === true;
+  }
+  shouldBlockUnload() {
+    for (const blocker of this.blockers) {
+      try {
+        if (this.unloadBlockers.get(blocker)?.()) return true;
+      } catch {
+        return true;
+      }
+    }
+    return false;
+  }
+  updateDocumentMetadata(metadata) {
+    document.title = metadata?.title || "Farm.js App";
+    let description = document.querySelector('meta[name="description"]');
+    if (!metadata?.description) {
+      description?.remove();
+      return;
+    }
+    if (!description) {
+      description = document.createElement("meta");
+      description.setAttribute("name", "description");
+      document.head.appendChild(description);
+    }
+    description.setAttribute("content", metadata.description);
+  }
   startNavigation(options) {
     this.activeNavigation?.controller.abort("superseded");
     const navigation = {
@@ -51699,6 +51802,26 @@ __name(getScrollElementStorageKey, "getScrollElementStorageKey");
 init_request_bridge();
 init_routing();
 init_base_path();
+function shouldBlockUnload(options) {
+  const path41 = window.location.pathname + window.location.search;
+  const context2 = {
+    from: path41,
+    to: path41,
+    action: "replace"
+  };
+  const when = typeof options.when === "function" ? options.when(context2) : options.when;
+  if (!when) return false;
+  if (!options.shouldBlock) return true;
+  try {
+    const result = options.shouldBlock(context2);
+    if (typeof result === "boolean") return result;
+    void result.catch(() => void 0);
+    return true;
+  } catch {
+    return true;
+  }
+}
+__name(shouldBlockUnload, "shouldBlockUnload");
 function navigateViaRouter(href, basePath, replace) {
   if (typeof window === "undefined") return;
   const url = applyFarmBasePath(href, basePath);
@@ -51802,18 +51925,21 @@ function useBlocker(options) {
     if (typeof window === "undefined" || !active) {
       return;
     }
-    return getRouter2().addBlocker(async (context2) => {
-      const current = optionsRef.current;
-      const when = typeof current.when === "function" ? current.when(context2) : current.when;
-      if (!when) return false;
-      if (current.shouldBlock && !await current.shouldBlock(context2)) {
-        return false;
-      }
-      if (current.message && typeof window.confirm === "function") {
-        return !window.confirm(current.message);
-      }
-      return true;
-    });
+    return getRouter2().addBlocker(
+      async (context2) => {
+        const current = optionsRef.current;
+        const when = typeof current.when === "function" ? current.when(context2) : current.when;
+        if (!when) return false;
+        if (current.shouldBlock && !await current.shouldBlock(context2)) {
+          return false;
+        }
+        if (current.message && typeof window.confirm === "function") {
+          return !window.confirm(current.message);
+        }
+        return true;
+      },
+      () => shouldBlockUnload(optionsRef.current)
+    );
   }, [active]);
   return { active };
 }