@farm.js/core 0.1.0-beta.0

package/dist/chunk-TU4YJICB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/spa-router.ts","../src/client/router.ts"],"sourcesContent":["\"use client\";\n\nimport { readDeferredDataResponse } from \"../deferred\";\nimport {\n  createFarmDeploymentMismatchError,\n  createFarmDeploymentRequestHeaders,\n  isFarmDeploymentMismatchResponse,\n} from \"../deployment\";\nimport type { FarmClientNavigationSession, FarmClientPluginManager } from \"./plugin\";\nimport { _hydrateFarmI18n, isFarmLocaleChangeHref } from \"../i18n/client-runtime\";\nimport type { FarmI18nClientSnapshot } from \"../i18n/types\";\n\n/**\n * Farm.js SPA Router\n *\n * Provides client-side navigation without full page reloads.\n * Features:\n * - Prefetch on viewport intersection\n * - Prefetch on hover\n * - Page caching\n * - History API integration\n * - Scroll restoration\n */\n\ninterface PageData {\n  props: Record<string, any>;\n  modulePath: string;\n  canonicalPath?: string;\n  isClientComponent?: boolean;\n  shouldHydrate?: boolean;\n  metadata?: {\n    title?: string;\n    description?: string;\n  };\n  layoutModules?: string[];\n  i18n?: FarmI18nClientSnapshot;\n}\n\nexport interface RouterOptions {\n  prefetchTimeout?: number;\n  cacheMaxAge?: number;\n  scrollRestoration?: boolean;\n  shouldUseDocumentNavigation?: (pathname: string) => boolean;\n  deploymentId?: string;\n}\n\ninterface CacheEntry {\n  data: PageData;\n  timestamp: number;\n}\n\nexport interface FarmNavigationBlockerContext {\n  from: string;\n  to: string;\n  action: \"push\" | \"replace\" | \"pop\";\n}\n\nexport type FarmNavigationBlocker = (\n  context: FarmNavigationBlockerContext,\n) => boolean | void | Promise<boolean | void>;\n\nexport type FarmViewTransitionMode = boolean | \"auto\";\n\nexport interface FarmNavigateOptions {\n  replace?: boolean;\n  scroll?: boolean;\n  state?: unknown;\n  viewTransition?: FarmViewTransitionMode;\n}\n\nexport interface FarmNavigationLocation {\n  href: string;\n  pathname: string;\n  search: string;\n  hash: string;\n}\n\nexport interface FarmNavigationState {\n  state: \"idle\" | \"loading\";\n  pending: boolean;\n  from: string | null;\n  to: FarmNavigationLocation | null;\n  action: FarmNavigationBlockerContext[\"action\"] | null;\n  startedAt: number | null;\n}\n\nexport type FarmNavigationListener = (state: FarmNavigationState) => void;\n\nconst FARM_PAGE_STATE_KEY = \"__farmPageState\";\nconst IDLE_NAVIGATION_STATE: FarmNavigationState = {\n  state: \"idle\",\n  pending: false,\n  from: null,\n  to: null,\n  action: null,\n  startedAt: null,\n};\n\n// Global router instance\nlet routerInstance: SPARouter | null = null;\n\nexport class SPARouter {\n  private cache: Map<string, CacheEntry> = new Map();\n  private prefetchingUrls: Set<string> = new Set();\n  private observers: Map<Element, IntersectionObserver> = new Map();\n  private blockers: Set<FarmNavigationBlocker> = new Set();\n  private navigationListeners: Set<FarmNavigationListener> = new Set();\n  private navigationState: FarmNavigationState = IDLE_NAVIGATION_STATE;\n  private scrollElements: Map<string, HTMLElement> = new Map();\n  private options: Required<Omit<RouterOptions, \"deploymentId\">> &\n    Pick<RouterOptions, \"deploymentId\">;\n  private onNavigate?: (data: PageData) => Promise<void>;\n  private clientPlugins?: Pick<\n    FarmClientPluginManager,\n    | \"beginNavigation\"\n    | \"markNavigationLoaded\"\n    | \"resolveNavigation\"\n    | \"scheduleNavigationRendered\"\n    | \"failNavigation\"\n  >;\n\n  constructor(options: RouterOptions = {}) {\n    this.options = {\n      prefetchTimeout: options.prefetchTimeout ?? 100,\n      cacheMaxAge: options.cacheMaxAge ?? 30000, // 30 seconds\n      scrollRestoration: options.scrollRestoration ?? true,\n      shouldUseDocumentNavigation: options.shouldUseDocumentNavigation ?? (() => false),\n      deploymentId: options.deploymentId ?? readBrowserDeploymentId(),\n    };\n\n    if (typeof window !== \"undefined\") {\n      // Listen for popstate (back/forward navigation)\n      window.addEventListener(\"popstate\", this.handlePopState.bind(this));\n\n      // Save scroll position before unload\n      window.addEventListener(\"beforeunload\", (event) => {\n        if (this.blockers.size > 0) {\n          event.preventDefault();\n          event.returnValue = \"\";\n        }\n        this.saveScrollPosition(window.location.pathname);\n      });\n    }\n  }\n\n  /**\n   * Set the navigation handler that updates React\n   */\n  setNavigationHandler(handler: (data: PageData) => Promise<void>) {\n    this.onNavigate = handler;\n  }\n\n  /**\n   * Connect Farm's browser plugin lifecycle to SPA navigation.\n   */\n  setClientPluginManager(manager: FarmClientPluginManager) {\n    this.clientPlugins = manager;\n  }\n\n  /**\n   * Navigate to a new URL\n   */\n  async navigate(href: string, options: FarmNavigateOptions = {}): Promise<void> {\n    const { replace = false, scroll = true, state, viewTransition = false } = options;\n\n    // Parse the URL\n    const url = new URL(href, window.location.origin);\n    const pathname = url.pathname;\n    const search = url.search;\n    const fullPath = pathname + search;\n\n    if (\n      isFarmLocaleChangeHref(url.toString()) ||\n      this.options.shouldUseDocumentNavigation(pathname)\n    ) {\n      if (replace) window.location.replace(url.toString());\n      else window.location.assign(url.toString());\n      return;\n    }\n\n    // Same page navigation - just update hash/scroll\n    if (pathname === window.location.pathname && search === window.location.search) {\n      if (url.hash) {\n        window.location.hash = url.hash;\n      }\n      return;\n    }\n\n    const from = window.location.pathname + window.location.search;\n    if (\n      await this.shouldBlockNavigation({ from, to: fullPath, action: replace ? \"replace\" : \"push\" })\n    ) {\n      return;\n    }\n\n    // Save current scroll position\n    if (this.options.scrollRestoration) {\n      this.saveScrollPosition(window.location.pathname);\n    }\n\n    this.startNavigation({\n      from,\n      to: createNavigationLocation(url),\n      action: replace ? \"replace\" : \"push\",\n    });\n\n    let clientNavigation: FarmClientNavigationSession | undefined;\n    try {\n      clientNavigation = await this.clientPlugins?.beginNavigation({\n        from,\n        to: url,\n        action: replace ? \"replace\" : \"push\",\n      });\n\n      // Fetch page data (from cache or server)\n      const pageData = await this.fetchPageData(fullPath);\n      if (clientNavigation) {\n        await this.clientPlugins?.markNavigationLoaded(clientNavigation, pageData);\n      }\n\n      if (pageData.isClientComponent === false) {\n        this.finishNavigation();\n        window.location.assign(pageData.canonicalPath || fullPath);\n        return;\n      }\n\n      await this.runViewTransition(viewTransition, () =>\n        this.commitNavigation({\n          fullPath,\n          pageData,\n          pathname,\n          replace,\n          scroll,\n          state,\n          url,\n        }),\n      );\n\n      if (clientNavigation) {\n        await this.clientPlugins?.resolveNavigation(clientNavigation);\n        void this.clientPlugins?.scheduleNavigationRendered(clientNavigation);\n      }\n      this.finishNavigation();\n    } catch (error) {\n      if (clientNavigation) {\n        await this.clientPlugins?.failNavigation(clientNavigation, error);\n      }\n      this.finishNavigation();\n      console.error(\"[Farm.js] Navigation error:\", error);\n      // Fall back to full page navigation\n      window.location.href = href;\n    }\n  }\n\n  /**\n   * Prefetch a URL\n   */\n  async prefetch(href: string): Promise<void> {\n    if (isFarmLocaleChangeHref(href)) return;\n    const url = new URL(href, window.location.origin);\n    const fullPath = url.pathname + url.search;\n\n    // Skip if already prefetching or cached\n    if (this.prefetchingUrls.has(fullPath)) return;\n    if (this.isCached(fullPath)) return;\n\n    this.prefetchingUrls.add(fullPath);\n\n    try {\n      await this.fetchPageData(fullPath, false);\n    } catch (error) {\n      console.warn(\"[Farm.js] Prefetch failed:\", href, error);\n    } finally {\n      this.prefetchingUrls.delete(fullPath);\n    }\n  }\n\n  /**\n   * Observe an element for viewport intersection (prefetch when visible)\n   */\n  observeForPrefetch(element: HTMLAnchorElement): void {\n    if (typeof IntersectionObserver === \"undefined\") return;\n\n    const href = element.getAttribute(\"href\");\n    if (!href || this.isExternalUrl(href)) return;\n\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            // Delay prefetch slightly to avoid prefetching during scroll\n            setTimeout(() => {\n              this.prefetch(href);\n            }, this.options.prefetchTimeout);\n\n            // Stop observing after first intersection\n            observer.unobserve(element);\n            this.observers.delete(element);\n          }\n        }\n      },\n      { rootMargin: \"200px\" }, // Start prefetching when 200px from viewport\n    );\n\n    observer.observe(element);\n    this.observers.set(element, observer);\n  }\n\n  /**\n   * Stop observing an element\n   */\n  unobserveForPrefetch(element: HTMLAnchorElement): void {\n    const observer = this.observers.get(element);\n    if (observer) {\n      observer.unobserve(element);\n      this.observers.delete(element);\n    }\n  }\n\n  addBlocker(blocker: FarmNavigationBlocker): () => void {\n    this.blockers.add(blocker);\n    return () => {\n      this.blockers.delete(blocker);\n    };\n  }\n\n  getNavigationState(): FarmNavigationState {\n    return this.navigationState;\n  }\n\n  subscribeNavigation(listener: FarmNavigationListener): () => void {\n    this.navigationListeners.add(listener);\n    listener(this.navigationState);\n    return () => {\n      this.navigationListeners.delete(listener);\n    };\n  }\n\n  registerScrollElement(key: string, element: HTMLElement): () => void {\n    this.scrollElements.set(key, element);\n    this.restoreScrollElement(window.location.pathname, key, element);\n    return () => {\n      if (this.scrollElements.get(key) === element) {\n        this.scrollElements.delete(key);\n      }\n    };\n  }\n\n  pushState(state: unknown, href?: string): void {\n    this.writePageState(\"push\", state, href);\n  }\n\n  replaceState(state: unknown, href?: string): void {\n    this.writePageState(\"replace\", state, href);\n  }\n\n  private async commitNavigation(options: {\n    fullPath: string;\n    pageData: PageData;\n    pathname: string;\n    replace: boolean;\n    scroll: boolean;\n    state: unknown;\n    url: URL;\n  }): Promise<void> {\n    const historyPath = options.pageData.canonicalPath || options.fullPath;\n    const historyState = createHistoryState(historyPath, options.state);\n    if (options.replace) {\n      window.history.replaceState(historyState, \"\", historyPath);\n    } else {\n      window.history.pushState(historyState, \"\", historyPath);\n    }\n\n    if (options.pageData.metadata?.title) {\n      document.title = options.pageData.metadata.title;\n    }\n\n    if (options.pageData.metadata?.description) {\n      let metaDesc = document.querySelector('meta[name=\"description\"]');\n      if (!metaDesc) {\n        metaDesc = document.createElement(\"meta\");\n        metaDesc.setAttribute(\"name\", \"description\");\n        document.head.appendChild(metaDesc);\n      }\n      metaDesc.setAttribute(\"content\", options.pageData.metadata.description);\n    }\n\n    _hydrateFarmI18n(options.pageData.i18n);\n\n    if (this.onNavigate) {\n      await this.onNavigate(options.pageData);\n    }\n\n    if (options.scroll) {\n      if (options.url.hash) {\n        const element = document.querySelector(options.url.hash);\n        if (element) {\n          element.scrollIntoView();\n        }\n      } else {\n        window.scrollTo(0, 0);\n      }\n    } else if (this.options.scrollRestoration) {\n      this.restoreScrollPosition(options.pathname);\n    }\n  }\n\n  private async runViewTransition(\n    mode: FarmViewTransitionMode,\n    callback: () => Promise<void>,\n  ): Promise<void> {\n    if (!mode || typeof document === \"undefined\") {\n      await callback();\n      return;\n    }\n\n    const startViewTransition = (document as any).startViewTransition;\n    if (typeof startViewTransition !== \"function\") {\n      await callback();\n      return;\n    }\n\n    const transition = startViewTransition.call(document, () => callback());\n    const updateDone = transition?.updateCallbackDone || transition?.ready;\n    if (updateDone && typeof updateDone.then === \"function\") {\n      await updateDone;\n    }\n    transition?.finished?.catch?.(() => undefined);\n  }\n\n  /**\n   * Fetch page data from cache or server\n   */\n  private async fetchPageData(path: string, recover = true): Promise<PageData> {\n    // Check cache first\n    const cached = this.cache.get(path);\n    if (cached && Date.now() - cached.timestamp < this.options.cacheMaxAge) {\n      return cached.data;\n    }\n\n    // Fetch from server\n    const response = await fetch(`/__farm/page-data?path=${encodeURIComponent(path)}`, {\n      headers: createFarmDeploymentRequestHeaders(this.options.deploymentId, {\n        Accept: \"application/x-farm-deferred+json, application/json\",\n        \"X-Farm-SPA\": \"1\",\n      }),\n    });\n\n    if (isFarmDeploymentMismatchResponse(response, this.options.deploymentId)) {\n      const error = createFarmDeploymentMismatchError(\n        response,\n        this.options.deploymentId || \"unknown\",\n      );\n      dispatchDeploymentMismatch(error);\n      if (recover) {\n        window.location.assign(path);\n      }\n      throw error;\n    }\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch page data: ${response.status}`);\n    }\n\n    const data = await readDeferredDataResponse<PageData>(response);\n\n    // Cache the result\n    this.cache.set(path, {\n      data,\n      timestamp: Date.now(),\n    });\n\n    return data;\n  }\n\n  /**\n   * Handle browser back/forward navigation\n   */\n  private async handlePopState(event: PopStateEvent): Promise<void> {\n    if (document.documentElement.dataset.farmDocsRuntime === \"true\") return;\n\n    const path = window.location.pathname + window.location.search;\n\n    if (\n      await this.shouldBlockNavigation({\n        from: event.state?.path || path,\n        to: path,\n        action: \"pop\",\n      })\n    ) {\n      return;\n    }\n\n    this.startNavigation({\n      from: event.state?.path || path,\n      to: createNavigationLocation(new URL(window.location.href)),\n      action: \"pop\",\n    });\n\n    let clientNavigation: FarmClientNavigationSession | undefined;\n    try {\n      clientNavigation = await this.clientPlugins?.beginNavigation({\n        from: null,\n        to: window.location.href,\n        action: \"pop\",\n      });\n      const pageData = await this.fetchPageData(path);\n      if (clientNavigation) {\n        await this.clientPlugins?.markNavigationLoaded(clientNavigation, pageData);\n      }\n\n      // Update document title\n      if (pageData.metadata?.title) {\n        document.title = pageData.metadata.title;\n      }\n\n      _hydrateFarmI18n(pageData.i18n);\n\n      // Call the navigation handler to update React\n      if (this.onNavigate) {\n        await this.onNavigate(pageData);\n      }\n\n      // Restore scroll position\n      if (this.options.scrollRestoration) {\n        this.restoreScrollPosition(window.location.pathname);\n      }\n\n      if (clientNavigation) {\n        await this.clientPlugins?.resolveNavigation(clientNavigation);\n        void this.clientPlugins?.scheduleNavigationRendered(clientNavigation);\n      }\n      this.finishNavigation();\n    } catch (error) {\n      if (clientNavigation) {\n        await this.clientPlugins?.failNavigation(clientNavigation, error);\n      }\n      this.finishNavigation();\n      console.error(\"[Farm.js] Popstate navigation error:\", error);\n      // Reload the page as fallback\n      window.location.reload();\n    }\n  }\n\n  /**\n   * Check if URL is cached\n   */\n  private isCached(path: string): boolean {\n    const cached = this.cache.get(path);\n    return cached !== undefined && Date.now() - cached.timestamp < this.options.cacheMaxAge;\n  }\n\n  /**\n   * Check if URL is external\n   */\n  private isExternalUrl(href: string): boolean {\n    return href.startsWith(\"http://\") || href.startsWith(\"https://\") || href.startsWith(\"//\");\n  }\n\n  private async shouldBlockNavigation(context: FarmNavigationBlockerContext): Promise<boolean> {\n    for (const blocker of this.blockers) {\n      if (await blocker(context)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  private startNavigation(options: {\n    from: string;\n    to: FarmNavigationLocation;\n    action: FarmNavigationBlockerContext[\"action\"];\n  }): void {\n    this.setNavigationState({\n      state: \"loading\",\n      pending: true,\n      from: options.from,\n      to: options.to,\n      action: options.action,\n      startedAt: Date.now(),\n    });\n  }\n\n  private finishNavigation(): void {\n    this.setNavigationState(IDLE_NAVIGATION_STATE);\n  }\n\n  private setNavigationState(state: FarmNavigationState): void {\n    this.navigationState = state;\n    for (const listener of this.navigationListeners) {\n      listener(state);\n    }\n  }\n\n  private writePageState(action: \"push\" | \"replace\", state: unknown, href?: string): void {\n    if (typeof window === \"undefined\") return;\n\n    const url = href ? new URL(href, window.location.origin).toString() : window.location.href;\n    const nextState = createHistoryState(\n      new URL(url).pathname + new URL(url).search,\n      state,\n      window.history.state,\n    );\n\n    if (action === \"replace\") {\n      window.history.replaceState(nextState, \"\", url);\n    } else {\n      window.history.pushState(nextState, \"\", url);\n    }\n\n    window.dispatchEvent(new PopStateEvent(\"popstate\", { state: nextState }));\n  }\n\n  /**\n   * Save scroll position for a path\n   */\n  private saveScrollPosition(path: string): void {\n    try {\n      sessionStorage.setItem(\n        `farm-scroll-${path}`,\n        JSON.stringify({ x: window.scrollX, y: window.scrollY }),\n      );\n      for (const [key, element] of this.scrollElements) {\n        sessionStorage.setItem(\n          getScrollElementStorageKey(path, key),\n          JSON.stringify({ x: element.scrollLeft, y: element.scrollTop }),\n        );\n      }\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  /**\n   * Restore scroll position for a path\n   */\n  private restoreScrollPosition(path: string): void {\n    try {\n      const saved = sessionStorage.getItem(`farm-scroll-${path}`);\n      if (saved) {\n        const { x, y } = JSON.parse(saved);\n        setTimeout(() => window.scrollTo(x, y), 0);\n      }\n      for (const [key, element] of this.scrollElements) {\n        this.restoreScrollElement(path, key, element);\n      }\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  private restoreScrollElement(path: string, key: string, element: HTMLElement): void {\n    try {\n      const saved = sessionStorage.getItem(getScrollElementStorageKey(path, key));\n      if (!saved) return;\n      const { x, y } = JSON.parse(saved);\n      setTimeout(() => {\n        element.scrollLeft = x;\n        element.scrollTop = y;\n      }, 0);\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  /**\n   * Clear the page cache\n   */\n  clearCache(): void {\n    this.cache.clear();\n  }\n}\n\nfunction readBrowserDeploymentId(): string | undefined {\n  if (typeof window === \"undefined\") return undefined;\n\n  const runtimeId = (window as Window & { __FARM_DEPLOYMENT_ID__?: unknown })\n    .__FARM_DEPLOYMENT_ID__;\n  if (typeof runtimeId === \"string\" && runtimeId) return runtimeId;\n\n  return document.querySelector<HTMLMetaElement>('meta[name=\"farm-deployment-id\"]')?.content;\n}\n\nfunction dispatchDeploymentMismatch(error: Error): void {\n  if (typeof window === \"undefined\" || typeof CustomEvent === \"undefined\") return;\n  window.dispatchEvent(new CustomEvent(\"farm:deployment-mismatch\", { detail: error }));\n}\n\n/**\n * Get or create the global router instance\n */\nexport function getRouter(): SPARouter {\n  if (typeof window === \"undefined\") {\n    // Return a no-op router for SSR\n    return new SPARouter();\n  }\n\n  const installedRouter = (window as any).__FARM_SPA_ROUTER__ as SPARouter | undefined;\n  if (installedRouter) {\n    routerInstance = installedRouter;\n    return installedRouter;\n  }\n\n  if (!routerInstance) {\n    routerInstance = new SPARouter();\n  }\n\n  return routerInstance;\n}\n\n/**\n * Navigate to a URL using the SPA router\n */\nexport function navigateTo(href: string, options?: FarmNavigateOptions): Promise<void> {\n  return getRouter().navigate(href, options);\n}\n\n/**\n * Prefetch a URL\n */\nexport function prefetch(href: string): Promise<void> {\n  return getRouter().prefetch(href);\n}\n\nexport function pushState(state: unknown, href?: string): void {\n  getRouter().pushState(state, href);\n}\n\nexport function replaceState(state: unknown, href?: string): void {\n  getRouter().replaceState(state, href);\n}\n\nexport function readPageState<TState = unknown>(): TState | null {\n  if (typeof window === \"undefined\") return null;\n  const state = window.history.state;\n  if (!state || typeof state !== \"object\") return null;\n  return ((state as Record<string, unknown>)[FARM_PAGE_STATE_KEY] as TState | undefined) ?? null;\n}\n\nfunction createHistoryState(path: string, pageState: unknown, currentState?: unknown) {\n  const base =\n    currentState && typeof currentState === \"object\" ? { ...(currentState as object) } : {};\n  return {\n    ...base,\n    path,\n    [FARM_PAGE_STATE_KEY]: pageState,\n  };\n}\n\nfunction createNavigationLocation(url: URL): FarmNavigationLocation {\n  return {\n    href: url.href,\n    pathname: url.pathname,\n    search: url.search,\n    hash: url.hash,\n  };\n}\n\nfunction getScrollElementStorageKey(path: string, key: string): string {\n  return `farm-scroll-${path}:${key}`;\n}\n","import { useEffect, useMemo, useRef, useState, type RefObject } from \"react\";\nimport { createFarmRouter, type FarmRouter, type FarmRouterRouteInput } from \"../router\";\nimport {\n  getRouter as getSPARouter,\n  readPageState,\n  type FarmNavigationBlockerContext,\n  type FarmNavigationState,\n} from \"./spa-router\";\nimport { getFarmI18nClientState } from \"../i18n/client-runtime\";\nimport { stripFarmLocaleFromPathname } from \"../i18n/routing\";\n\ninterface RouterState {\n  pathname: string;\n  searchParams: URLSearchParams;\n  params: Record<string, string>;\n  pageState: unknown;\n}\n\nexport interface UseRouterOptions {\n  basePath?: string;\n  routes?: FarmRouterRouteInput[];\n}\n\nexport interface UseBlockerOptions {\n  when: boolean | ((context: FarmNavigationBlockerContext) => boolean);\n  message?: string;\n  shouldBlock?: (\n    context: FarmNavigationBlockerContext,\n  ) => boolean | Promise<boolean>;\n}\n\nexport interface UseBlockerReturn {\n  active: boolean;\n}\n\n/**\n * Hook for accessing router state and navigation\n */\nexport function useRouter(options: UseRouterOptions = {}) {\n  const basePath = options.basePath || \"\";\n  const routes = options.routes;\n  const routeKey =\n    routes?.map((route) => (typeof route === \"string\" ? route : route.path)).join(\"\\n\") || \"\";\n  const routeMatcher = useMemo(\n    () => (routeKey ? createFarmRouter(routeKey.split(\"\\n\")) : null),\n    [routeKey],\n  );\n  const [state, setState] = useState<RouterState>(() => {\n    return readRouterState(basePath, routeMatcher);\n  });\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const handlePopState = () => {\n      setState(readRouterState(basePath, routeMatcher));\n    };\n\n    handlePopState();\n    window.addEventListener(\"popstate\", handlePopState);\n    return () => window.removeEventListener(\"popstate\", handlePopState);\n  }, [basePath, routeMatcher]);\n\n  const push = (href: string) => {\n    if (typeof window === \"undefined\") return;\n\n    const url = href.startsWith(\"/\") ? basePath + href : href;\n    window.history.pushState(null, \"\", url);\n    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n  };\n\n  const replace = (href: string) => {\n    if (typeof window === \"undefined\") return;\n\n    const url = href.startsWith(\"/\") ? basePath + href : href;\n    window.history.replaceState(null, \"\", url);\n    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n  };\n\n  const pushState = <TState,>(pageState: TState, href?: string) => {\n    if (typeof window === \"undefined\") return;\n    getSPARouter().pushState(pageState, resolveClientHref(href, basePath));\n  };\n\n  const replaceState = <TState,>(pageState: TState, href?: string) => {\n    if (typeof window === \"undefined\") return;\n    getSPARouter().replaceState(pageState, resolveClientHref(href, basePath));\n  };\n\n  const back = () => {\n    if (typeof window !== \"undefined\") {\n      window.history.back();\n    }\n  };\n\n  const forward = () => {\n    if (typeof window !== \"undefined\") {\n      window.history.forward();\n    }\n  };\n\n  return {\n    ...state,\n    push,\n    replace,\n    pushState,\n    replaceState,\n    back,\n    forward,\n  };\n}\n\nexport function usePageState<TState = unknown>(): TState | null {\n  const [state, setState] = useState<TState | null>(() => readPageState<TState>());\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const handlePopState = () => {\n      setState(readPageState<TState>());\n    };\n\n    handlePopState();\n    window.addEventListener(\"popstate\", handlePopState);\n    return () => window.removeEventListener(\"popstate\", handlePopState);\n  }, []);\n\n  return state;\n}\n\nexport function useNavigation(): FarmNavigationState {\n  const [state, setState] = useState<FarmNavigationState>(() =>\n    getSPARouter().getNavigationState(),\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n    return getSPARouter().subscribeNavigation(setState);\n  }, []);\n\n  return state;\n}\n\nexport function useBlocker(options: UseBlockerOptions): UseBlockerReturn {\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const active = Boolean(options.when);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\" || !active) {\n      return;\n    }\n\n    return getSPARouter().addBlocker(async (context) => {\n      const current = optionsRef.current;\n      const when =\n        typeof current.when === \"function\" ? current.when(context) : current.when;\n\n      if (!when) return false;\n\n      if (current.shouldBlock && !(await current.shouldBlock(context))) {\n        return false;\n      }\n\n      if (current.message && typeof window.confirm === \"function\") {\n        return !window.confirm(current.message);\n      }\n\n      return true;\n    });\n  }, [active]);\n\n  return { active };\n}\n\nexport function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(\n  key: string,\n): RefObject<TElement> {\n  const ref = useRef<TElement>(null);\n\n  useEffect(() => {\n    const element = ref.current;\n    if (!element) return;\n    return getSPARouter().registerScrollElement(key, element);\n  }, [key]);\n\n  return ref;\n}\n\nfunction readRouterState(basePath: string, routeMatcher: FarmRouter | null): RouterState {\n  if (typeof window === \"undefined\") {\n    return {\n      pathname: \"/\",\n      searchParams: new URLSearchParams(),\n      params: {},\n      pageState: null,\n    };\n  }\n\n  const url = new URL(window.location.href);\n  const pathname = normalizeClientPathname(url.pathname, basePath);\n  const i18n = getFarmI18nClientState();\n  const routePathname = i18n ? stripFarmLocaleFromPathname(pathname, i18n) : pathname;\n  return {\n    pathname,\n    searchParams: url.searchParams,\n    params: routeMatcher?.match(routePathname)?.params || {},\n    pageState: readPageState(),\n  };\n}\n\nfunction normalizeClientPathname(pathname: string, basePath: string) {\n  const normalizedBase = basePath.replace(/\\/+$/, \"\");\n  const isUnderBase =\n    normalizedBase && (pathname === normalizedBase || pathname.startsWith(`${normalizedBase}/`));\n  const withoutBase = isUnderBase ? pathname.slice(normalizedBase.length) || \"/\" : pathname;\n  return withoutBase || \"/\";\n}\n\nfunction resolveClientHref(href: string | undefined, basePath: string): string | undefined {\n  if (!href) return undefined;\n  return href.startsWith(\"/\") ? basePath + href : href;\n}\n"],"mappings":"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","names":["pushState","replaceState"]}

package/dist/chunk-TXCFGOHW.mjs

@@ -0,0 +1,42 @@
+import {
+  __name
+} from "./chunk-CGILA3WO.mjs";
+
+// src/cache-invalidation.ts
+var FARM_CACHE_INVALIDATION_STATE = /* @__PURE__ */ Symbol.for("farm.cacheInvalidationState");
+var globalState = globalThis;
+function getFarmCacheInvalidationState() {
+  return globalState[FARM_CACHE_INVALIDATION_STATE] ?? (globalState[FARM_CACHE_INVALIDATION_STATE] = {
+    listeners: /* @__PURE__ */ new Set()
+  });
+}
+__name(getFarmCacheInvalidationState, "getFarmCacheInvalidationState");
+function notifyFarmCacheInvalidation(key) {
+  if (typeof key !== "string" || key.length === 0) return;
+  for (const listener of getFarmCacheInvalidationState().listeners) {
+    listener(key);
+  }
+}
+__name(notifyFarmCacheInvalidation, "notifyFarmCacheInvalidation");
+function applyFarmCacheInvalidations(keys) {
+  if (!Array.isArray(keys)) return;
+  for (const key of keys) {
+    if (typeof key === "string") {
+      notifyFarmCacheInvalidation(key);
+    }
+  }
+}
+__name(applyFarmCacheInvalidations, "applyFarmCacheInvalidations");
+function subscribeFarmCacheInvalidation(listener) {
+  const state = getFarmCacheInvalidationState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+__name(subscribeFarmCacheInvalidation, "subscribeFarmCacheInvalidation");
+
+export {
+  notifyFarmCacheInvalidation,
+  applyFarmCacheInvalidations,
+  subscribeFarmCacheInvalidation
+};
+//# sourceMappingURL=chunk-TXCFGOHW.mjs.map

package/dist/chunk-TXCFGOHW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache-invalidation.ts"],"sourcesContent":["export type FarmCacheInvalidationListener = (key: string) => void;\n\ntype FarmCacheInvalidationState = {\n  listeners: Set<FarmCacheInvalidationListener>;\n};\n\nconst FARM_CACHE_INVALIDATION_STATE = Symbol.for(\"farm.cacheInvalidationState\");\nconst globalState = globalThis as typeof globalThis & {\n  [FARM_CACHE_INVALIDATION_STATE]?: FarmCacheInvalidationState;\n};\n\nfunction getFarmCacheInvalidationState(): FarmCacheInvalidationState {\n  return (globalState[FARM_CACHE_INVALIDATION_STATE] ??= {\n    listeners: new Set(),\n  });\n}\n\nexport function notifyFarmCacheInvalidation(key: string): void {\n  if (typeof key !== \"string\" || key.length === 0) return;\n\n  for (const listener of getFarmCacheInvalidationState().listeners) {\n    listener(key);\n  }\n}\n\nexport function applyFarmCacheInvalidations(keys: unknown): void {\n  if (!Array.isArray(keys)) return;\n\n  for (const key of keys) {\n    if (typeof key === \"string\") {\n      notifyFarmCacheInvalidation(key);\n    }\n  }\n}\n\nexport function subscribeFarmCacheInvalidation(\n  listener: FarmCacheInvalidationListener,\n): () => void {\n  const state = getFarmCacheInvalidationState();\n  state.listeners.add(listener);\n  return () => state.listeners.delete(listener);\n}\n"],"mappings":";;;;;AAMA,IAAM,gCAAgC,uBAAO,IAAI,6BAA6B;AAC9E,IAAM,cAAc;AAIpB,SAAS,gCAA4D;AACnE,SAAQ,4FAA+C;AAAA,IACrD,WAAW,oBAAI,IAAI;AAAA,EACrB;AACF;AAJS;AAMF,SAAS,4BAA4B,KAAmB;AAC7D,MAAI,OAAO,QAAQ,YAAY,IAAI,WAAW,EAAG;AAEjD,aAAW,YAAY,8BAA8B,EAAE,WAAW;AAChE,aAAS,GAAG;AAAA,EACd;AACF;AANgB;AAQT,SAAS,4BAA4B,MAAqB;AAC/D,MAAI,CAAC,MAAM,QAAQ,IAAI,EAAG;AAE1B,aAAW,OAAO,MAAM;AACtB,QAAI,OAAO,QAAQ,UAAU;AAC3B,kCAA4B,GAAG;AAAA,IACjC;AAAA,EACF;AACF;AARgB;AAUT,SAAS,+BACd,UACY;AACZ,QAAM,QAAQ,8BAA8B;AAC5C,QAAM,UAAU,IAAI,QAAQ;AAC5B,SAAO,MAAM,MAAM,UAAU,OAAO,QAAQ;AAC9C;AANgB;","names":[]}

package/dist/chunk-UHE2TTLK.mjs

@@ -0,0 +1,466 @@
+import {
+  resolveEnv,
+  setEnv
+} from "./chunk-RSKVYESE.mjs";
+import {
+  loadFarmConfigFile,
+  resolveFarmLayers
+} from "./chunk-74YTBPTY.mjs";
+import {
+  resolveFarmDevtoolsConfig
+} from "./chunk-7MABZJIM.mjs";
+import {
+  normalizeRouteRules,
+  routeRulesToHeaders,
+  routeRulesToRedirects
+} from "./chunk-OYXO65LI.mjs";
+import {
+  resolveFarmImageConfig
+} from "./chunk-GY2STC2S.mjs";
+import {
+  resolveMarkdownConfig
+} from "./chunk-LLC7BNXW.mjs";
+import {
+  resolveMdxConfig
+} from "./chunk-S2XHZS7W.mjs";
+import {
+  resolveWorkflowsConfig
+} from "./chunk-Y2OJJD7R.mjs";
+import {
+  resolveCronConfig
+} from "./chunk-UREJA4GZ.mjs";
+import {
+  resolveServerActionsConfig
+} from "./chunk-AGS7UJ52.mjs";
+import {
+  resolveIntegrationPlugins
+} from "./chunk-K4667E2Q.mjs";
+import {
+  resolveFarmI18nConfig
+} from "./chunk-FQYDHKKU.mjs";
+import {
+  normalizeFarmDeploymentId
+} from "./chunk-B232I2GP.mjs";
+import {
+  __name
+} from "./chunk-CGILA3WO.mjs";
+
+// src/config.ts
+import path from "path";
+var FARM_RESOLVED_CUSTOM_CONTEXT = /* @__PURE__ */ Symbol.for("farm.resolvedCustomContext");
+function hasCustomFarmRouteContext(config) {
+  return config[FARM_RESOLVED_CUSTOM_CONTEXT] === true;
+}
+__name(hasCustomFarmRouteContext, "hasCustomFarmRouteContext");
+function normalizeDeployTarget(target) {
+  if (!target) return void 0;
+  if (target === "cloudflare-pages" || target === "cloudflare_pages") return "cloudflare";
+  if (target === "node-server" || target === "nitro") return "node";
+  return target;
+}
+__name(normalizeDeployTarget, "normalizeDeployTarget");
+function getPresetForDeployTarget(target) {
+  switch (normalizeDeployTarget(target)) {
+    case "vercel":
+      return "vercel";
+    case "cloudflare":
+      return "cloudflare-pages";
+    case "netlify":
+      return "netlify";
+    case "node":
+      return "node-server";
+    default:
+      return void 0;
+  }
+}
+__name(getPresetForDeployTarget, "getPresetForDeployTarget");
+function getDeployTargetForPreset(preset) {
+  if (!preset) return void 0;
+  if (preset === "vercel" || preset === "vercel-edge") return "vercel";
+  if (preset === "cloudflare" || preset === "cloudflare-pages" || preset === "cloudflare-module") {
+    return "cloudflare";
+  }
+  if (preset === "netlify" || preset === "netlify-edge") return "netlify";
+  if (preset === "node-server") return "node";
+  return void 0;
+}
+__name(getDeployTargetForPreset, "getDeployTargetForPreset");
+function getDefaultDeployOutputDir(target, preset, distDir) {
+  const normalizedTarget = normalizeDeployTarget(target) || getDeployTargetForPreset(preset);
+  if (normalizedTarget === "vercel") return ".vercel/output";
+  return `${distDir}/.output`;
+}
+__name(getDefaultDeployOutputDir, "getDefaultDeployOutputDir");
+function resolveDeployOutputPath(root, outputDir) {
+  return path.isAbsolute(outputDir) ? outputDir : path.join(root, outputDir);
+}
+__name(resolveDeployOutputPath, "resolveDeployOutputPath");
+function resolveDeployConfig(config, overrides = {}) {
+  const deploy = config.deploy || {};
+  const distDir = config.distDir || ".farm";
+  const target = normalizeDeployTarget(overrides.target || deploy.target);
+  const preset = overrides.preset || deploy.preset || config.preset || getPresetForDeployTarget(target) || "node-server";
+  const resolvedTarget = target || getDeployTargetForPreset(preset);
+  const platformOutput = resolvedTarget === "vercel" ? deploy.vercel?.outputDirectory : resolvedTarget === "cloudflare" ? deploy.cloudflare?.outputDir : resolvedTarget === "netlify" ? deploy.netlify?.outputDir : void 0;
+  const outputDir = overrides.outputDir || deploy.outputDir || deploy.output || platformOutput || getDefaultDeployOutputDir(resolvedTarget, preset, distDir);
+  return {
+    ...deploy,
+    target: resolvedTarget,
+    preset,
+    outputDir
+  };
+}
+__name(resolveDeployConfig, "resolveDeployConfig");
+function resolveMigrationsConfig(migrations) {
+  if (!migrations) return { commands: [] };
+  if (Array.isArray(migrations)) return { commands: migrations };
+  return { commands: migrations.commands || [] };
+}
+__name(resolveMigrationsConfig, "resolveMigrationsConfig");
+var DOCS_CONFIG_FILENAMES = [
+  "docs.config.ts",
+  "docs.config.tsx",
+  "docs.config.mts",
+  "docs.config.cts",
+  "docs.config.js",
+  "docs.config.jsx",
+  "docs.config.mjs",
+  "docs.config.cjs",
+  "docs.json"
+];
+function normalizeDocsRoute(value, fallback = "/docs") {
+  const raw = (value || fallback).trim();
+  if (!raw || raw === "/") return "/";
+  const normalized = raw.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\/?/, "/").replace(/\/+$/, "");
+  return normalized || "/";
+}
+__name(normalizeDocsRoute, "normalizeDocsRoute");
+function docsRouteToEntry(route) {
+  const entry = route.replace(/^\/+/, "").replace(/\/+$/, "");
+  return entry || "docs";
+}
+__name(docsRouteToEntry, "docsRouteToEntry");
+function normalizeDocsContentDir(value) {
+  if (!value) return void 0;
+  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+  return normalized || void 0;
+}
+__name(normalizeDocsContentDir, "normalizeDocsContentDir");
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function cloneSerializable(value, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null) return null;
+  const valueType = typeof value;
+  if (valueType === "string" || valueType === "number" || valueType === "boolean") {
+    return value;
+  }
+  if (valueType === "undefined" || valueType === "function" || valueType === "symbol") {
+    return void 0;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => cloneSerializable(item, seen)).filter((item) => item !== void 0);
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (isRecord(value)) {
+    if (seen.has(value)) return void 0;
+    seen.add(value);
+    const output = {};
+    for (const [key, nestedValue] of Object.entries(value)) {
+      const clonedValue = cloneSerializable(nestedValue, seen);
+      if (clonedValue !== void 0) {
+        output[key] = clonedValue;
+      }
+    }
+    return output;
+  }
+  return void 0;
+}
+__name(cloneSerializable, "cloneSerializable");
+function sanitizeDocsConfig(config) {
+  return cloneSerializable(config) || {};
+}
+__name(sanitizeDocsConfig, "sanitizeDocsConfig");
+async function findDocsConfigPath(rootDir, configPath) {
+  const { existsSync } = await import("fs");
+  const root = path.resolve(rootDir || process.cwd());
+  if (configPath) {
+    const resolvedPath = path.isAbsolute(configPath) ? configPath : path.join(root, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`Could not find docs config at ${configPath}.`);
+    }
+    return path.resolve(resolvedPath);
+  }
+  for (const filename of DOCS_CONFIG_FILENAMES) {
+    const resolvedPath = path.join(root, filename);
+    if (existsSync(resolvedPath)) {
+      return resolvedPath;
+    }
+  }
+  return void 0;
+}
+__name(findDocsConfigPath, "findDocsConfigPath");
+async function loadDocsConfig(rootDir, configPath) {
+  const fs = await import("fs/promises");
+  const { pathToFileURL } = await import("url");
+  const root = path.resolve(rootDir || process.cwd());
+  const resolvedPath = await findDocsConfigPath(root, configPath);
+  if (!resolvedPath) return void 0;
+  try {
+    if (resolvedPath.endsWith(".json")) {
+      const content = await fs.readFile(resolvedPath, "utf8");
+      return { config: JSON.parse(content), configPath: resolvedPath };
+    }
+    const { build } = await import("esbuild");
+    const configCacheDir = path.join(root, ".farm", ".config-loader");
+    await fs.mkdir(configCacheDir, { recursive: true });
+    const modulePath = path.join(
+      configCacheDir,
+      `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
+    );
+    await build({
+      absWorkingDir: root,
+      entryPoints: [resolvedPath],
+      outfile: modulePath,
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      target: `node${process.versions.node.split(".")[0]}`,
+      packages: "external",
+      jsx: "automatic",
+      logLevel: "silent",
+      sourcemap: "inline"
+    });
+    const moduleUrl = pathToFileURL(modulePath).href + `?t=${Date.now()}`;
+    let importedConfig;
+    try {
+      importedConfig = await import(
+        /* @vite-ignore */
+        moduleUrl
+      );
+    } finally {
+      await fs.unlink(modulePath).catch(() => void 0);
+    }
+    return {
+      config: importedConfig.default || importedConfig,
+      configPath: resolvedPath
+    };
+  } catch (error) {
+    const relativePath = path.relative(root, resolvedPath) || resolvedPath;
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to load docs config from ${relativePath}: ${message}`);
+  }
+}
+__name(loadDocsConfig, "loadDocsConfig");
+async function resolveDocsConfig(userDocs, options = {}) {
+  const root = options.root || process.cwd();
+  if (userDocs === false) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const docsOptions = isRecord(userDocs) ? userDocs : {};
+  if (docsOptions.enabled === false) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const loadedConfig = await loadDocsConfig(root, docsOptions.configPath);
+  const hasExplicitDocsConfig = userDocs === true || isRecord(userDocs);
+  if (!hasExplicitDocsConfig && !loadedConfig) {
+    return {
+      enabled: false,
+      entry: "/docs",
+      config: { entry: "docs", docsPath: "/docs" }
+    };
+  }
+  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const directDocsConfig = sanitizeDocsConfig({
+    ...docsOptions,
+    enabled: void 0,
+    config: void 0,
+    configPath: void 0
+  });
+  const loadedDocsConfig = sanitizeDocsConfig(loadedConfig?.config || {});
+  const mergedDocsConfig = {
+    ...loadedDocsConfig,
+    ...inlineDocsConfig,
+    ...directDocsConfig
+  };
+  const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
+  const configuredDocsPath = typeof mergedDocsConfig.docsPath === "string" ? mergedDocsConfig.docsPath : void 0;
+  const configuredEntry = typeof mergedDocsConfig.entry === "string" ? mergedDocsConfig.entry : void 0;
+  const entryRoute = normalizeDocsRoute(
+    configuredDocsPath || explicitRoute || (configuredEntry ? `/${configuredEntry}` : void 0)
+  );
+  const docsEntry = explicitRoute && explicitRoute.startsWith("/") ? docsRouteToEntry(explicitRoute) : docsRouteToEntry(configuredEntry || entryRoute);
+  const contentDir = normalizeDocsContentDir(docsOptions.contentDir || mergedDocsConfig.contentDir);
+  return {
+    enabled: true,
+    entry: entryRoute,
+    contentDir,
+    configPath: loadedConfig?.configPath,
+    config: {
+      ...mergedDocsConfig,
+      entry: docsEntry,
+      docsPath: entryRoute,
+      ...contentDir ? { contentDir } : {}
+    }
+  };
+}
+__name(resolveDocsConfig, "resolveDocsConfig");
+async function resolveConfig(userConfig, mode) {
+  const projectRoot = userConfig.root || process.cwd();
+  const layerResolution = await resolveFarmLayers(userConfig, {
+    root: projectRoot,
+    mode
+  });
+  userConfig = layerResolution.config;
+  const redirects = typeof userConfig.redirects === "function" ? await userConfig.redirects() : userConfig.redirects || [];
+  const rewrites = typeof userConfig.rewrites === "function" ? await userConfig.rewrites() : userConfig.rewrites || [];
+  const headers = typeof userConfig.headers === "function" ? await userConfig.headers() : userConfig.headers || [];
+  const routeRules = normalizeRouteRules(userConfig.routeRules);
+  const routeRuleRedirects = routeRulesToRedirects(routeRules);
+  const routeRuleHeaders = routeRulesToHeaders(routeRules);
+  const deploy = resolveDeployConfig(userConfig);
+  const root = userConfig.root || process.cwd();
+  const srcDir = userConfig.srcDir || "src";
+  const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
+  const md = resolveMarkdownConfig(userConfig.md);
+  const mdx = resolveMdxConfig(userConfig.mdx);
+  const env = resolveEnv(userConfig.env, process.env);
+  setEnv(env);
+  const generateBuildId = userConfig.generateBuildId || (() => `build-${Date.now()}`);
+  const deploymentId = normalizeFarmDeploymentId(
+    userConfig.deploymentId || process.env.FARM_DEPLOYMENT_ID || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CF_PAGES_COMMIT_SHA || (mode === "production" ? await generateBuildId() : "development")
+  );
+  const resolved = {
+    [FARM_RESOLVED_CUSTOM_CONTEXT]: typeof userConfig.context === "function",
+    root,
+    srcDir,
+    extends: userConfig.extends || [],
+    layers: layerResolution.layers,
+    outDir: userConfig.outDir || "dist",
+    basePath: userConfig.basePath || "/",
+    preset: deploy.preset || "node-server",
+    deploy,
+    docs,
+    md,
+    mdx,
+    migrations: resolveMigrationsConfig(userConfig.migrations),
+    cron: resolveCronConfig(userConfig.cron),
+    workflows: resolveWorkflowsConfig(userConfig.workflows),
+    observability: userConfig.observability ?? false,
+    devtools: resolveFarmDevtoolsConfig(userConfig.devtools, mode),
+    storage: userConfig.storage || {},
+    suppressLintOnLink: userConfig.suppressLintOnLink ?? false,
+    experimental: {
+      serverComponents: false,
+      serverActions: false,
+      ...userConfig.experimental
+    },
+    plugins: [...resolveIntegrationPlugins(userConfig.integrations), ...userConfig.plugins || []],
+    integrations: userConfig.integrations || {},
+    trailingSlash: userConfig.trailingSlash ?? false,
+    redirects: /* @__PURE__ */ __name(() => [...redirects, ...routeRuleRedirects], "redirects"),
+    rewrites: /* @__PURE__ */ __name(() => rewrites, "rewrites"),
+    headers: /* @__PURE__ */ __name(() => [...headers, ...routeRuleHeaders], "headers"),
+    routeRules,
+    images: resolveFarmImageConfig(userConfig.images),
+    publicDir: userConfig.publicDir || "public",
+    i18n: resolveFarmI18nConfig(userConfig.i18n, { root, mode }),
+    openapi: {
+      enabled: false,
+      route: "/docs/reference",
+      title: "API Documentation",
+      description: "Auto-generated API documentation",
+      version: "1.0.0",
+      servers: [{ url: "http://localhost:3000", description: "Development server" }],
+      ...userConfig.openapi
+    },
+    middleware: userConfig.middleware || {},
+    notFound: userConfig.notFound || {},
+    context: userConfig.context || (() => void 0),
+    serverActions: resolveServerActionsConfig(userConfig.serverActions),
+    deploymentId,
+    output: userConfig.output || "standalone",
+    distDir: userConfig.distDir || ".farm",
+    generateBuildId,
+    compress: userConfig.compress ?? true,
+    devIndicators: {
+      buildActivity: true,
+      buildActivityPosition: "bottom-right",
+      ...userConfig.devIndicators
+    },
+    serverRuntimeConfig: userConfig.serverRuntimeConfig || {},
+    publicRuntimeConfig: userConfig.publicRuntimeConfig || {},
+    env,
+    typescript: {
+      tsconfigPath: "tsconfig.json",
+      ignoreBuildErrors: false,
+      ...userConfig.typescript
+    },
+    vite: typeof userConfig.vite === "function" ? userConfig.vite({}) : userConfig.vite || {}
+  };
+  return resolved;
+}
+__name(resolveConfig, "resolveConfig");
+async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
+  const { existsSync } = await import("fs");
+  const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
+  const root = rootDir || process.cwd();
+  const loadedEnv = loadEnv(mode, root, "");
+  for (const [key, value] of Object.entries(loadedEnv)) {
+    if (process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+  const searchPaths = [
+    configPath,
+    "farm.config.ts",
+    "farm.config.mts",
+    "farm.config.js",
+    "farm.config.mjs",
+    "config.ts",
+    "config.mts",
+    "config.js",
+    "config.mjs"
+  ].filter(Boolean);
+  for (const relativePath of searchPaths) {
+    try {
+      const absolutePath = relativePath.startsWith("/") ? relativePath : path.join(root, relativePath);
+      const normalizedPath = path.resolve(absolutePath);
+      if (!existsSync(normalizedPath)) {
+        continue;
+      }
+      const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
+      return loadedConfig.root === void 0 ? { ...loadedConfig, root } : loadedConfig;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to load config from ${relativePath}: ${message}`);
+    }
+  }
+  return void 0;
+}
+__name(loadConfig, "loadConfig");
+
+export {
+  hasCustomFarmRouteContext,
+  normalizeDeployTarget,
+  getPresetForDeployTarget,
+  getDeployTargetForPreset,
+  resolveDeployOutputPath,
+  resolveDeployConfig,
+  resolveMigrationsConfig,
+  resolveDocsConfig,
+  resolveConfig,
+  loadConfig
+};
+//# sourceMappingURL=chunk-UHE2TTLK.mjs.map