veryfront 0.1.1233 → 0.1.1234

package/esm/_dnt.shims.js

@@ -1,14 +1,29 @@
-import { Deno as dntShimDeno } from "@deno/shim-deno";
 const dntNativeDeno = globalThis.Deno;
 // Prefer the host runtime's own Deno. The `@deno/shim-deno` fallback exists
 // for Node and Bun; under Deno it shadows working native APIs with node:net
 // reimplementations that throw (e.g. Deno.listen reads `server._handle.fd`,
 // which is null on Deno's node compatibility layer).
+//
+// It loads lazily so Deno never resolves it at all. The esm transform
+// rewrites the bare specifier to an absolute file:// bundle, and Deno
+// refuses to prepare that graph node when node_modules is unmanaged, which
+// is what `deno install -g` produces (`nodeModulesDir: "manual"`). A static
+// import therefore failed every request with "Loading unprepared module"
+// naming a bundle that was present on disk, on the one runtime that never
+// reads the value.
 export const Deno = typeof dntNativeDeno?.version?.deno === "string"
     ? dntNativeDeno
-    : dntShimDeno;
-import { crypto } from "@deno/shim-crypto";
-export { crypto } from "@deno/shim-crypto";
+    : (await import("@deno/shim-deno")).Deno;
+const dntNativeCrypto = globalThis.crypto;
+// Web Crypto is a global on every runtime the framework supports (Deno,
+// Node 19+, Bun), so `@deno/shim-crypto` is a fallback for runtimes that no
+// longer exist in practice. It loads lazily for the same reason the Deno
+// shim does: the esm transform rewrites the bare specifier to an absolute
+// file:// bundle, and Deno cannot prepare that graph node when node_modules
+// is unmanaged.
+export const crypto = dntNativeCrypto !== undefined
+    ? dntNativeCrypto
+    : (await import("@deno/shim-crypto")).crypto;
 const dntGlobals = {
     Deno,
     crypto,

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1233",
+    "version": "0.1.1234",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/html/hydration-script-builder/hydration-runtime.generated.js

@@ -6,4 +6,4 @@
  * `deno task generate` to regenerate.
  * @module
  */
-export const HYDRATION_RUNTIME_BUNDLE = '// src/html/hydration-script-builder/runtime/main.ts\nimport * as React from "react";\nimport { createRoot } from "react-dom/client";\nimport { RouterProvider, useRouter as useRouterFromModule } from "veryfront/router";\nimport * as RouterRuntime from "veryfront/router";\nimport { PageContextProvider } from "veryfront/context";\n\n// src/routing/flatten-route-params.ts\nfunction flattenRouteParams(params) {\n  if (!params) return {};\n  const flat = {};\n  for (const [key, value] of Object.entries(params)) {\n    if (value === void 0) continue;\n    flat[key] = Array.isArray(value) ? value.join("/") : value;\n  }\n  return flat;\n}\n\n// src/html/hydration-script-builder/runtime/shared.ts\nfunction moduleServerUrl(window) {\n  return window.location.origin + "/_vf_modules";\n}\nfunction createLogging(window) {\n  const DEBUG = Boolean(\n    window.__VERYFRONT_DEBUG__ || new URLSearchParams(window.location.search).has("vf_debug")\n  );\n  const log = DEBUG ? console.log.bind(console, "[Veryfront]") : () => {\n  };\n  const logError = console.error.bind(console, "[Veryfront]");\n  function logBackgroundFetchFailure(reason, path, error) {\n    const message = error?.message ?? String(error);\n    log(reason + " failed:", path, message);\n  }\n  const perfTimers = /* @__PURE__ */ new Map();\n  const perfStart = DEBUG ? (label) => {\n    perfTimers.set(label, performance.now());\n  } : () => {\n  };\n  const perfEnd = DEBUG ? (label) => {\n    const start = perfTimers.get(label);\n    if (start === void 0) return 0;\n    const duration = performance.now() - start;\n    perfTimers.delete(label);\n    console.log(\n      "[Veryfront Perf] %c" + label + ": %c" + duration.toFixed(2) + "ms",\n      "color: #888",\n      duration > 100 ? "color: #f00; font-weight: bold" : "color: #0a0"\n    );\n    return duration;\n  } : () => 0;\n  return { DEBUG, log, logError, logBackgroundFetchFailure, perfStart, perfEnd };\n}\nfunction isAbortError(error) {\n  return error?.name === "AbortError";\n}\nfunction resolveDocumentNavigationUrl(target, origin) {\n  try {\n    const url = new URL(target, origin);\n    if (url.protocol === "http:" || url.protocol === "https:") return url.href;\n  } catch (_) {\n  }\n  return null;\n}\nfunction getDocumentNonce(document2) {\n  const element = document2.querySelector("script[nonce], style[nonce], link[nonce]");\n  if (!element) return void 0;\n  return element.nonce || element.getAttribute("nonce") || void 0;\n}\n\n// src/html/hydration-data-element.ts\nvar HYDRATION_DATA_ELEMENT_ID = "veryfront-hydration-data";\nfunction findServerHydrationDataElement(document2) {\n  try {\n    const matches = [...document2.querySelectorAll(`[id="${HYDRATION_DATA_ELEMENT_ID}"]`)];\n    if (matches.length !== 1) return null;\n    const body = document2.body;\n    if (!body) return null;\n    const element = matches[0];\n    if (body.firstElementChild !== element && element.parentElement !== body) return null;\n    if (element.tagName?.toLowerCase() !== "script") return null;\n    if (element.getAttribute("type")?.trim().toLowerCase() !== "application/json") return null;\n    return element;\n  } catch {\n    return null;\n  }\n}\n\n// src/html/hydration-script-builder/runtime/hydration-data.ts\nfunction readInitialHydrationData(document2) {\n  try {\n    const element = findServerHydrationDataElement(document2);\n    return JSON.parse(element && element.textContent ? element.textContent : "{}") || {};\n  } catch (_) {\n    return {};\n  }\n}\nfunction readDocumentDependencyPinningCacheKey(initialHydrationData2) {\n  return typeof initialHydrationData2.dependencyPinningCacheKey === "string" && initialHydrationData2.dependencyPinningCacheKey.startsWith("on:") ? initialHydrationData2.dependencyPinningCacheKey : null;\n}\n\n// src/html/hydration-script-builder/runtime/snapshot-modules.ts\nvar RECOVERY_STATE_KEY = "__VF_DEPENDENCY_SNAPSHOT_RECOVERY_STARTED__";\nasync function isDependencySnapshotConflictResponse(response) {\n  if (!response || response.status !== 409) return false;\n  try {\n    const clone = response.clone?.() ?? response;\n    const body = (await clone.text?.() ?? "").trim();\n    return body === "Unknown dependency snapshot" || body === "export default null; // Unknown dependency snapshot";\n  } catch (_) {\n    return false;\n  }\n}\nfunction createSnapshotModuleImporter(deps) {\n  async function recoverFromSnapshotBoundModuleFailure(moduleUrl, allowDocumentReload = true) {\n    try {\n      const parsedUrl = new URL(moduleUrl, "http://veryfront.local");\n      const snapshotKeys = parsedUrl.searchParams.getAll("pins");\n      const pathMatch = parsedUrl.pathname.match(\n        /^\\/_vf_modules\\/_pins\\/([^/]+)(?:\\/|$)/\n      );\n      if (pathMatch) {\n        try {\n          snapshotKeys.push(decodeURIComponent(pathMatch[1]));\n        } catch (_) {\n          return false;\n        }\n      }\n      if (snapshotKeys.length !== 1 || !/^on:[A-Za-z0-9._-]+$/.test(snapshotKeys[0])) return false;\n      const response = await deps.fetchModule(moduleUrl, { cache: "no-store" });\n      if (!await isDependencySnapshotConflictResponse(response)) return false;\n      if (!allowDocumentReload) return true;\n      if (deps.recoveryState[RECOVERY_STATE_KEY] === true) return true;\n      deps.recoveryState[RECOVERY_STATE_KEY] = true;\n      try {\n        deps.reloadDocument();\n      } catch (_) {\n        delete deps.recoveryState[RECOVERY_STATE_KEY];\n        return false;\n      }\n      return true;\n    } catch (_) {\n      return false;\n    }\n  }\n  async function importSnapshotBoundModule(moduleUrl, allowDocumentReload = true) {\n    try {\n      return await deps.importModule(moduleUrl);\n    } catch (error) {\n      const snapshotConflict = await recoverFromSnapshotBoundModuleFailure(\n        moduleUrl,\n        allowDocumentReload\n      );\n      if (snapshotConflict && !allowDocumentReload) {\n        const conflictError = new Error(\n          "Dependency snapshot is unavailable during speculative module prefetch"\n        );\n        conflictError.name = "DependencySnapshotConflictError";\n        conflictError.dependencySnapshotConflict = true;\n        conflictError.cause = error;\n        throw conflictError;\n      }\n      throw error;\n    }\n  }\n  return { importSnapshotBoundModule, recoverFromSnapshotBoundModuleFailure };\n}\nfunction isDependencySnapshotConflict(error) {\n  return Boolean(error?.dependencySnapshotConflict);\n}\n\n// src/utils/version-constant.ts\nvar VERSION = "0.1.1233";\n\n// src/html/hydration-script-builder/runtime/module-urls.ts\nfunction appendQueryParam(url, key, value) {\n  return url + (url.includes("?") ? "&" : "?") + key + "=" + value;\n}\nfunction appendDependencyPinningVersion(url, moduleData) {\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  if (typeof pinKey !== "string" || !pinKey.startsWith("on:")) return url;\n  const hashIndex = url.indexOf("#");\n  const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";\n  const withoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;\n  const queryIndex = withoutHash.indexOf("?");\n  const base = queryIndex >= 0 ? withoutHash.slice(0, queryIndex) : withoutHash;\n  const params = new URLSearchParams(queryIndex >= 0 ? withoutHash.slice(queryIndex + 1) : "");\n  const modulePrefix = "/_vf_modules/";\n  const prefixIndex = base.indexOf(modulePrefix);\n  const origin = prefixIndex >= 0 ? base.slice(0, prefixIndex) : "";\n  if (prefixIndex >= 0 && (origin === "" || /^https?:\\/\\/[^/]+$/i.test(origin))) {\n    const pathStart = prefixIndex + modulePrefix.length;\n    let modulePath = base.slice(pathStart);\n    if (modulePath.startsWith("_pins/")) {\n      const existingKeyEnd = modulePath.indexOf("/", "_pins/".length);\n      const encodedExistingKey = existingKeyEnd < 0 ? modulePath.slice("_pins/".length) : modulePath.slice("_pins/".length, existingKeyEnd);\n      let existingKey;\n      try {\n        existingKey = decodeURIComponent(encodedExistingKey);\n      } catch {\n        existingKey = void 0;\n      }\n      if (existingKey && /^on:[A-Za-z0-9._-]+$/.test(existingKey)) {\n        if (existingKeyEnd < 0) return url;\n        modulePath = modulePath.slice(existingKeyEnd + 1);\n      }\n    }\n    params.delete("pins");\n    const query = params.toString();\n    return base.slice(0, pathStart) + "_pins/" + encodeURIComponent(pinKey) + "/" + modulePath + (query ? "?" + query : "") + hash;\n  }\n  params.set("pins", pinKey);\n  return base + "?" + params.toString() + hash;\n}\nfunction componentCacheKey(path, moduleData) {\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  return typeof pinKey === "string" && pinKey.startsWith("on:") ? path + "|vf_pins|" + pinKey : path;\n}\nfunction normalizeReleaseAssetModulePath(path) {\n  return String(path || "").replace(/^\\/?_vf_modules\\//, "").replace(/^\\/+/, "").replace(/[?#].*$/, "");\n}\nfunction buildPinnedRscModuleUrl(path, moduleData) {\n  let moduleUrl = "/_veryfront/rsc/module?rel=" + encodeURIComponent(path);\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  if (typeof pinKey === "string" && pinKey.startsWith("on:")) {\n    moduleUrl += "&pins=" + encodeURIComponent(pinKey);\n  }\n  return moduleUrl;\n}\nfunction buildPageDataEndpoint(path, origin) {\n  const targetUrl = new URL(path, origin);\n  const normalizedPath = targetUrl.pathname === "/" ? "" : targetUrl.pathname.replace(/^\\//, "");\n  const endpointUrl = new URL(\n    "/_veryfront/page-data/" + normalizedPath + ".json",\n    origin\n  );\n  endpointUrl.search = targetUrl.search;\n  return endpointUrl.pathname + endpointUrl.search;\n}\nfunction pageDataCacheIdentity(path, documentDependencyPinningCacheKey2) {\n  return documentDependencyPinningCacheKey2 ? documentDependencyPinningCacheKey2 + "|path:" + path : path;\n}\nfunction assertPageDataMatchesDocumentSnapshot(path, data, documentDependencyPinningCacheKey2) {\n  if (!documentDependencyPinningCacheKey2) return data;\n  if (data && data.dependencyPinningCacheKey === documentDependencyPinningCacheKey2) {\n    return data;\n  }\n  const error = new Error("Page data dependency snapshot does not match the document");\n  error.status = 409;\n  error.dependencySnapshotMismatch = true;\n  error.path = path;\n  throw error;\n}\n\n// src/html/hydration-script-builder/runtime/component-loader.ts\nvar VERYFRONT_RUNTIME_VERSION = VERSION;\nfunction createComponentLoader(deps) {\n  const { window, moduleServerUrl: moduleServerUrl2 } = deps;\n  const { DEBUG, log, logError } = deps.logging;\n  const componentCache = /* @__PURE__ */ new Map();\n  const loadingPromises = /* @__PURE__ */ new Map();\n  let releaseId = null;\n  let releaseAssetModules = null;\n  let studioEmbed = false;\n  let hmrRefreshTimestamp = null;\n  function clearComponentCache(path) {\n    if (!path) {\n      componentCache.clear();\n      loadingPromises.clear();\n      log("Cleared all component caches");\n      return;\n    }\n    for (const key of componentCache.keys()) {\n      if (key === path || key.startsWith(path + "|vf_pins|")) {\n        componentCache.delete(key);\n      }\n    }\n    for (const key of loadingPromises.keys()) {\n      if (key === path || key.startsWith(path + "|vf_pins|")) {\n        loadingPromises.delete(key);\n      }\n    }\n    log("Cleared component cache for:", path);\n  }\n  function setReleaseId(value) {\n    releaseId = typeof value === "string" && value ? value : null;\n    window.__veryfrontReleaseId = releaseId;\n  }\n  function appendReleaseModuleVersion(url) {\n    if (!releaseId || url.includes("vf_release=")) return url;\n    let versionedUrl = appendQueryParam(url, "vf_release", encodeURIComponent(releaseId));\n    versionedUrl = appendQueryParam(\n      versionedUrl,\n      "vf_runtime",\n      encodeURIComponent(VERYFRONT_RUNTIME_VERSION)\n    );\n    return versionedUrl;\n  }\n  function setReleaseAssetModules(value) {\n    releaseAssetModules = value && typeof value === "object" && !Array.isArray(value) ? value : null;\n    window.__veryfrontReleaseAssetModules = releaseAssetModules;\n  }\n  function resolveReleaseAssetModuleUrl(path) {\n    if (!releaseAssetModules || studioEmbed || hmrRefreshTimestamp) return null;\n    const key = normalizeReleaseAssetModulePath(path);\n    if (releaseAssetModules[key]) return releaseAssetModules[key];\n    const withoutExt = key.replace(/\\.(tsx|ts|jsx|mdx|js|mjs)$/, "");\n    const extensions = [".tsx", ".ts", ".jsx", ".mdx", ".js"];\n    for (const ext of extensions) {\n      const candidate = withoutExt + ext;\n      if (releaseAssetModules[candidate]) return releaseAssetModules[candidate];\n    }\n    return null;\n  }\n  function pathToModuleUrl(path, embedInStudio, moduleData) {\n    const releaseAssetUrl = resolveReleaseAssetModuleUrl(path);\n    if (releaseAssetUrl) return releaseAssetUrl;\n    const pattern = /(pages|components|app|lib|layouts|shared|features)\\/(.+)\\.(tsx|ts|jsx|mdx)$/;\n    const match = path.match(new RegExp("/" + pattern.source)) || path.match(new RegExp("^" + pattern.source));\n    let url;\n    if (match) {\n      url = moduleServerUrl2 + "/" + match[1] + "/" + match[2] + ".js";\n    } else {\n      const hasKnownExt = /\\.(tsx|ts|jsx|mdx|js|mjs)$/.test(path);\n      url = moduleServerUrl2 + "/" + (hasKnownExt ? path.replace(/\\.(tsx|ts|jsx|mdx)$/, ".js") : path + ".js");\n    }\n    if (embedInStudio) url = appendQueryParam(url, "studio_embed", "true");\n    if (hmrRefreshTimestamp) url = appendQueryParam(url, "t", hmrRefreshTimestamp);\n    if (!embedInStudio && !hmrRefreshTimestamp) url = appendReleaseModuleVersion(url);\n    url = appendDependencyPinningVersion(url, moduleData);\n    return url;\n  }\n  function setStudioEmbed(value) {\n    studioEmbed = value;\n    window.__veryfrontStudioEmbed = value;\n  }\n  function setHMRRefreshTimestamp(timestamp) {\n    hmrRefreshTimestamp = timestamp;\n    window.__veryfrontHMRRefreshTimestamp = timestamp;\n  }\n  async function loadComponent(path, moduleData, options = {}) {\n    if (!path) return null;\n    const cacheKey = componentCacheKey(path, moduleData);\n    if (componentCache.has(cacheKey)) {\n      log("Component cached:", path);\n      return componentCache.get(cacheKey);\n    }\n    const existingPromise = loadingPromises.get(cacheKey);\n    if (existingPromise) return existingPromise;\n    const loadPromise = (async () => {\n      try {\n        const moduleUrl = pathToModuleUrl(path, studioEmbed, moduleData);\n        const start = DEBUG ? performance.now() : 0;\n        log("Loading component:", moduleUrl);\n        const module = await deps.snapshotModules.importSnapshotBoundModule(\n          moduleUrl,\n          options.allowDocumentReload !== false\n        );\n        const component = module.MDXLayout || module.MainLayout || module.default || module;\n        if (DEBUG) {\n          const duration = performance.now() - start;\n          console.log(\n            "[Veryfront Perf] %cimport:" + path.split("/").pop() + ": %c" + duration.toFixed(2) + "ms",\n            "color: #888",\n            duration > 50 ? "color: #f00; font-weight: bold" : "color: #0a0"\n          );\n        }\n        componentCache.set(cacheKey, component);\n        return component;\n      } catch (error) {\n        if (isDependencySnapshotConflict(error)) throw error;\n        logError("Failed to load component:", path, error);\n        return null;\n      } finally {\n        loadingPromises.delete(cacheKey);\n      }\n    })();\n    loadingPromises.set(cacheKey, loadPromise);\n    return loadPromise;\n  }\n  return {\n    loadComponent,\n    pathToModuleUrl,\n    clearComponentCache,\n    setStudioEmbed,\n    setReleaseId,\n    setReleaseAssetModules,\n    setHMRRefreshTimestamp\n  };\n}\n\n// src/html/hydration-script-builder/runtime/route-timing.ts\nvar MAX_ROUTE_TIMINGS = 100;\nvar MAX_SERVER_TIMING_LENGTH = 1024;\nfunction routeTimingNow() {\n  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();\n}\nfunction sanitizeServerTimingMetricName(name) {\n  return String(name || "").trim().replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 128);\n}\nfunction sanitizeServerTimingHeader(value) {\n  if (!value) return null;\n  const metrics = [];\n  const printable = String(value).replace(/[^\\x20-\\x7E]/g, " ").trim();\n  if (!printable) return null;\n  for (const item of printable.split(",")) {\n    const segments = item.split(";").map((segment) => segment.trim()).filter(Boolean);\n    const name = sanitizeServerTimingMetricName(segments[0]);\n    if (!name) continue;\n    for (const segment of segments.slice(1)) {\n      const [key, rawValue = ""] = segment.split("=");\n      if ((key ?? "").trim().toLowerCase() !== "dur") continue;\n      const duration = Number(rawValue.trim().replace(/^"|"$/g, ""));\n      if (!Number.isFinite(duration) || duration < 0) continue;\n      metrics.push(name + ";dur=" + (Math.round(duration * 100) / 100).toFixed(2));\n      break;\n    }\n  }\n  const sanitized = metrics.join(", ");\n  return sanitized ? sanitized.slice(0, MAX_SERVER_TIMING_LENGTH) : null;\n}\nfunction parseServerTimingMetrics(value) {\n  const header = sanitizeServerTimingHeader(value);\n  if (!header) return null;\n  const metrics = {};\n  for (const item of header.split(",")) {\n    const segments = item.split(";").map((segment) => segment.trim()).filter(Boolean);\n    const name = sanitizeServerTimingMetricName(segments[0]);\n    if (!name) continue;\n    for (const segment of segments.slice(1)) {\n      const [key, rawValue = ""] = segment.split("=");\n      if ((key ?? "").trim().toLowerCase() !== "dur") continue;\n      const duration = Number(rawValue.trim().replace(/^"|"$/g, ""));\n      if (Number.isFinite(duration) && duration >= 0) {\n        metrics[name] = Math.round(duration * 100) / 100;\n      }\n    }\n  }\n  return Object.keys(metrics).length ? metrics : null;\n}\nfunction readResponseServerTiming(response) {\n  try {\n    return sanitizeServerTimingHeader(response.headers?.get("server-timing"));\n  } catch (_) {\n    return null;\n  }\n}\nfunction roundRouteTimingValue(value) {\n  return Math.round(value * 100) / 100;\n}\nfunction extractResourceTiming(entry) {\n  const fields = [\n    "startTime",\n    "requestStart",\n    "responseStart",\n    "responseEnd",\n    "duration",\n    "transferSize",\n    "encodedBodySize",\n    "decodedBodySize"\n  ];\n  const timing = {};\n  for (const field of fields) {\n    const value = entry?.[field];\n    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {\n      timing[field] = roundRouteTimingValue(value);\n    }\n  }\n  return Object.keys(timing).length ? timing : null;\n}\nfunction createRouteTimingRecorder(window, logging2) {\n  const { log } = logging2;\n  function emitRouteTiming(phase, path, startedAt, detail = {}) {\n    const entry = {\n      phase,\n      path,\n      duration: Math.max(0, routeTimingNow() - startedAt),\n      timestamp: Date.now(),\n      ...detail\n    };\n    const timings = Array.isArray(window.__veryfrontRouteTimings) ? window.__veryfrontRouteTimings : [];\n    timings.push(entry);\n    if (timings.length > MAX_ROUTE_TIMINGS) {\n      timings.splice(0, timings.length - MAX_ROUTE_TIMINGS);\n    }\n    window.__veryfrontRouteTimings = timings;\n    try {\n      window.dispatchEvent(new CustomEvent("veryfront:route-timing", { detail: entry }));\n    } catch (_) {\n    }\n    log("Route timing:", entry);\n    return entry;\n  }\n  function getPageDataResourceTiming(endpoint, fetchStartedAt) {\n    try {\n      if (typeof performance === "undefined" || typeof performance.getEntriesByName !== "function") {\n        return null;\n      }\n      const href = new URL(endpoint, window.location.href).href;\n      const entries = performance.getEntriesByName(href, "resource");\n      if (!entries.length) return null;\n      for (let index = entries.length - 1; index >= 0; index--) {\n        const entry = entries[index];\n        const responseEnd = entry?.responseEnd;\n        if (typeof responseEnd === "number" && Number.isFinite(responseEnd) && responseEnd + 1 >= fetchStartedAt) {\n          return extractResourceTiming(entry);\n        }\n      }\n      return null;\n    } catch (_) {\n      return null;\n    }\n  }\n  function buildPageDataTimingDetail(response, endpoint, fetchStartedAt, source) {\n    const detail = { source, status: response.status };\n    const serverTiming = readResponseServerTiming(response);\n    if (serverTiming) {\n      detail.serverTiming = serverTiming;\n      const serverTimingMetrics = parseServerTimingMetrics(serverTiming);\n      if (serverTimingMetrics) detail.serverTimingMetrics = serverTimingMetrics;\n    }\n    const resourceTiming = getPageDataResourceTiming(response.url || endpoint, fetchStartedAt);\n    if (resourceTiming) detail.resourceTiming = resourceTiming;\n    return detail;\n  }\n  return { emitRouteTiming, buildPageDataTimingDetail };\n}\n\n// src/html/managed-head-protocol.ts\nvar HEAD_PROVENANCE_ATTRIBUTE = "data-vf-head";\nvar HEAD_LEGACY_MANAGED_ATTRIBUTE = "data-veryfront-managed";\nvar HEAD_CONTENT_HASH_ATTRIBUTE = "data-vf-hash";\nvar HEAD_REACT_MANAGED_ATTRIBUTE = "data-vf-react-head";\nvar HEAD_REACT_OWNER_ATTRIBUTE = "data-vf-react-head-owner";\nvar HEAD_ROUTE_MANAGED_ATTRIBUTE = "data-vf-route-head";\nvar HEAD_SERVER_COMMIT_ATTRIBUTE = "data-vf-server-head-commit";\nvar HEAD_SHELL_PROVENANCE_ATTRIBUTE = "data-vf-shell-head";\nvar HEAD_SSR_PAYLOAD_ATTRIBUTE = "data-vf-ssr-head";\nvar MAX_MANAGED_HEAD_BYTES = 2 * 1024 * 1024;\nvar MAX_MANAGED_HEAD_PAYLOAD_BYTES = MAX_MANAGED_HEAD_BYTES * 2;\nvar SINGLETON_META_KEYS = /* @__PURE__ */ new Set([\n  "description",\n  "robots",\n  "viewport",\n  "referrer",\n  "color-scheme",\n  "application-name",\n  "generator",\n  "og:title",\n  "og:description",\n  "og:url",\n  "og:type",\n  "og:site_name",\n  "og:locale",\n  "twitter:card",\n  "twitter:site",\n  "twitter:creator",\n  "twitter:title",\n  "twitter:description",\n  "twitter:image",\n  "twitter:image:alt"\n]);\nvar SINGLETON_LINK_RELS = /* @__PURE__ */ new Set([\n  "canonical",\n  "manifest",\n  "amphtml"\n]);\nvar MAX_HEAD_ATTRIBUTE_VALUE_BYTES = 64 * 1024;\nvar MAX_HEAD_ATTRIBUTE_BYTES = 1024 * 1024;\nvar MAX_HEAD_CONTENT_BYTES = 1024 * 1024;\nvar headTextEncoder = new TextEncoder();\nvar BOOLEAN_HEAD_ATTRIBUTES = /* @__PURE__ */ new Set([\n  "async",\n  "defer",\n  "disabled",\n  "itemscope",\n  "nomodule"\n]);\nfunction isHeadFrameworkAttribute(name) {\n  switch (name.toLowerCase()) {\n    case HEAD_PROVENANCE_ATTRIBUTE:\n    case HEAD_LEGACY_MANAGED_ATTRIBUTE:\n    case HEAD_CONTENT_HASH_ATTRIBUTE:\n    case HEAD_REACT_MANAGED_ATTRIBUTE:\n    case HEAD_REACT_OWNER_ATTRIBUTE:\n    case HEAD_ROUTE_MANAGED_ATTRIBUTE:\n    case HEAD_SERVER_COMMIT_ATTRIBUTE:\n    case HEAD_SHELL_PROVENANCE_ATTRIBUTE:\n    case HEAD_SSR_PAYLOAD_ATTRIBUTE:\n      return true;\n    default:\n      return false;\n  }\n}\nfunction normalizeHeadIdentityValue(value) {\n  const normalized = value?.trim().toLowerCase();\n  return normalized || void 0;\n}\nfunction readOwnString(record, key) {\n  try {\n    const descriptor = Reflect.getOwnPropertyDescriptor(record, key);\n    return descriptor && !descriptor.get && !descriptor.set && "value" in descriptor && typeof descriptor.value === "string" ? descriptor.value : void 0;\n  } catch {\n    return void 0;\n  }\n}\nfunction headMetaSingletonKeyFromRecord(meta) {\n  if (readOwnString(meta, "charset") !== void 0) return "meta:charset";\n  const key = normalizeHeadIdentityValue(\n    readOwnString(meta, "property") ?? readOwnString(meta, "name")\n  );\n  if (!key) return void 0;\n  if (key === "theme-color") {\n    return `meta:theme-color:${readOwnString(meta, "media")?.trim() ?? ""}`;\n  }\n  return SINGLETON_META_KEYS.has(key) ? `meta:${key}` : void 0;\n}\nfunction headLinkSingletonKeyFromRecord(link) {\n  const rel = normalizeHeadIdentityValue(readOwnString(link, "rel"));\n  return rel && SINGLETON_LINK_RELS.has(rel) ? `link:${rel}` : void 0;\n}\n\n// src/html/client-head-manager.ts\nvar HEAD_MANAGER_STATE_SYMBOL = /* @__PURE__ */ Symbol.for(\n  "veryfront.client-head-manager.v2"\n);\nvar CROSS_PAGE_PRESERVED_SINGLETON_KEYS = /* @__PURE__ */ new Set([\n  "meta:viewport",\n  "link:manifest"\n]);\nfunction getClientHeadManagerState() {\n  const globalState = globalThis;\n  return globalState[HEAD_MANAGER_STATE_SYMBOL] ?? (globalState[HEAD_MANAGER_STATE_SYMBOL] = {\n    documents: /* @__PURE__ */ new WeakMap()\n  });\n}\nfunction readElementAttributes(element) {\n  const attributes = [];\n  for (const attribute of element.attributes) {\n    const name = attribute.name.toLowerCase();\n    if (isHeadFrameworkAttribute(name)) continue;\n    const nonce = name === "nonce" && "nonce" in element ? element.nonce : "";\n    const value = BOOLEAN_HEAD_ATTRIBUTES.has(name) ? "" : nonce || attribute.value;\n    attributes.push([name, value]);\n  }\n  return attributes.sort(([left], [right]) => left.localeCompare(right));\n}\nfunction elementSingletonKey(element) {\n  const tagName = element.tagName.toLowerCase();\n  if (tagName === "title") return "title";\n  const attributes = Object.fromEntries(readElementAttributes(element));\n  if (tagName === "meta") return headMetaSingletonKeyFromRecord(attributes);\n  if (tagName === "link") return headLinkSingletonKeyFromRecord(attributes);\n  return void 0;\n}\nfunction promoteToShellHeadBaseline(element) {\n  for (const attribute of [...element.attributes]) {\n    if (isHeadFrameworkAttribute(attribute.name)) {\n      element.removeAttribute(attribute.name);\n    }\n  }\n  element.setAttribute(HEAD_SHELL_PROVENANCE_ATTRIBUTE, "true");\n}\nfunction isCrossPagePreservedSingleton(element, singletonKey = elementSingletonKey(element)) {\n  return element.parentElement !== null && singletonKey !== void 0 && CROSS_PAGE_PRESERVED_SINGLETON_KEYS.has(singletonKey);\n}\nfunction isFrameworkOwnedHeadElement(element) {\n  return element.getAttribute(HEAD_PROVENANCE_ATTRIBUTE) === "true" || element.getAttribute(HEAD_REACT_MANAGED_ATTRIBUTE) === "true" || element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1" || element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true" || element.getAttribute(HEAD_SHELL_PROVENANCE_ATTRIBUTE) === "true";\n}\nfunction retireFrameworkHeadElement(element) {\n  if (isCrossPagePreservedSingleton(element)) {\n    promoteToShellHeadBaseline(element);\n    return;\n  }\n  element.remove();\n}\nfunction retireClientHeadOwnership(targetDocument) {\n  const manager = getClientHeadManagerState().documents.get(targetDocument);\n  if (manager) {\n    manager.retire();\n    return;\n  }\n  for (const element of [...targetDocument.head?.children ?? []]) {\n    if (isFrameworkOwnedHeadElement(element)) retireFrameworkHeadElement(element);\n  }\n}\n\n// src/html/client-route-head.ts\nfunction updateRouteTitle(title, targetDocument = document) {\n  if (typeof title !== "string" || !title) return;\n  const titles = [...targetDocument.head.querySelectorAll("title")];\n  if (titles.some((element) => element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1")) {\n    return;\n  }\n  let titleElement = titles.find(\n    (element) => element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true"\n  );\n  for (const element of titles) {\n    if (element !== titleElement) element.remove();\n  }\n  if (!titleElement) {\n    titleElement = targetDocument.createElement("title");\n    titleElement.setAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE, "true");\n    targetDocument.head.appendChild(titleElement);\n  }\n  titleElement.textContent = title;\n}\nfunction updateRouteMetaTag(targetDocument, selector, attributeName, attributeValue, content) {\n  const matches = [...targetDocument.head.querySelectorAll(selector)];\n  if (matches.some((element) => element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1")) {\n    return;\n  }\n  let metaTag = matches.find(\n    (element) => element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true"\n  );\n  if (!metaTag) {\n    metaTag = targetDocument.createElement("meta");\n    metaTag.setAttribute(attributeName, attributeValue);\n    metaTag.setAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE, "true");\n    targetDocument.head.appendChild(metaTag);\n  }\n  metaTag.setAttribute("content", content);\n}\nfunction updateRouteMetaTags(metadata, targetDocument = document) {\n  if (typeof metadata.description === "string" && metadata.description) {\n    updateRouteMetaTag(\n      targetDocument,\n      \'meta[name="description"]\',\n      "name",\n      "description",\n      metadata.description\n    );\n  }\n  if (typeof metadata.ogTitle === "string" && metadata.ogTitle) {\n    updateRouteMetaTag(\n      targetDocument,\n      \'meta[property="og:title"]\',\n      "property",\n      "og:title",\n      metadata.ogTitle\n    );\n  }\n}\nfunction handoffClientRouteMetadata(metadata, targetDocument = document) {\n  const retainedTitle = targetDocument.title;\n  retireClientHeadOwnership(targetDocument);\n  updateRouteTitle(\n    typeof metadata.title === "string" && metadata.title ? metadata.title : retainedTitle,\n    targetDocument\n  );\n  updateRouteMetaTags(metadata, targetDocument);\n}\n\n// src/html/hydration-script-builder/runtime/router.ts\nvar FETCH_TIMEOUT_MS = 1e4;\nvar MAX_RETRIES = 2;\nvar MAX_CACHE_SIZE = 50;\nvar CACHE_TTL_MS = 5 * 60 * 1e3;\nvar BACKGROUND_REFRESH_INTERVAL_MS = 30 * 1e3;\nvar PREFETCH_DELAY_MS = 100;\nvar MAX_PREFETCH_PATHS = 100;\nvar IDLE_PREFETCH_DELAY_MS = 1200;\nvar IDLE_PREFETCH_MAX_LINKS = 4;\nvar VIEWPORT_PREFETCH_MAX_LINKS = 8;\nvar PAGE_DATA_PREFETCH_CONCURRENCY = 2;\nvar VIEWPORT_PREFETCH_ROOT_MARGIN = "200px";\nvar MAX_SCROLL_POSITIONS = 100;\nfunction createRouterRuntime(deps) {\n  const { env: env2, logging: logging2, routeTiming: routeTiming2, componentLoader: componentLoader2, snapshotModules: snapshotModules2 } = deps;\n  const { window, document: document2, React: React2, RouterProvider: RouterProvider2, PageContextProvider: PageContextProvider2 } = env2;\n  const { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = env2;\n  const { log, logError, logBackgroundFetchFailure, perfStart, perfEnd } = logging2;\n  const { emitRouteTiming, buildPageDataTimingDetail } = routeTiming2;\n  const { loadComponent } = componentLoader2;\n  const documentPinKey = deps.documentDependencyPinningCacheKey;\n  let hydrationResolve;\n  let hydrationReject;\n  const hydrationPromise = new Promise((resolve, reject) => {\n    hydrationResolve = resolve;\n    hydrationReject = reject;\n  });\n  let hydrationCompleted = false;\n  let hydrationFailed = false;\n  function signalHydrationComplete() {\n    hydrationCompleted = true;\n    hydrationResolve();\n    log("Hydration complete signal received");\n  }\n  function signalHydrationFailed(error) {\n    hydrationFailed = true;\n    hydrationReject(error);\n    logError("Hydration failed signal received:", error);\n  }\n  window.__veryfrontHydrationComplete = signalHydrationComplete;\n  window.__veryfrontHydrationFailed = signalHydrationFailed;\n  function pageDataCacheIdentity2(path) {\n    return pageDataCacheIdentity(path, documentPinKey);\n  }\n  function navigateDocument(target) {\n    const safeUrl = resolveDocumentNavigationUrl(target, window.location.origin);\n    if (safeUrl) {\n      window.location.href = safeUrl;\n      return;\n    }\n    logError("Refusing an unsafe document navigation:", target);\n    window.location.reload();\n  }\n  let clientBuildVersion = null;\n  function checkVersionMismatch(newVersion) {\n    if (!clientBuildVersion) {\n      clientBuildVersion = newVersion;\n      log("Build version initialized:", newVersion);\n      return false;\n    }\n    if (newVersion.serverStart !== clientBuildVersion.serverStart) {\n      log("Server restarted, reloading...", {\n        old: clientBuildVersion.serverStart,\n        new: newVersion.serverStart\n      });\n      return true;\n    }\n    if (newVersion.framework !== clientBuildVersion.framework) {\n      log("Framework version changed, reloading...", {\n        old: clientBuildVersion.framework,\n        new: newVersion.framework\n      });\n      return true;\n    }\n    if (newVersion.projectUpdated && clientBuildVersion.projectUpdated && newVersion.projectUpdated !== clientBuildVersion.projectUpdated) {\n      log("Project content updated, reloading...", {\n        old: clientBuildVersion.projectUpdated,\n        new: newVersion.projectUpdated\n      });\n      return true;\n    }\n    return false;\n  }\n  const pageDataCache = /* @__PURE__ */ new Map();\n  const pendingPageDataFetches = /* @__PURE__ */ new Map();\n  const backgroundRefreshTimestamps = /* @__PURE__ */ new Map();\n  function getCachedPageData(path) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const entry = pageDataCache.get(cacheIdentity);\n    if (!entry) return null;\n    if (Date.now() - entry.timestamp < CACHE_TTL_MS) return entry.data;\n    pageDataCache.delete(cacheIdentity);\n    backgroundRefreshTimestamps.delete(cacheIdentity);\n    return null;\n  }\n  function setCachedPageData(path, data) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    if (pageDataCache.size >= MAX_CACHE_SIZE) {\n      const oldest = pageDataCache.keys().next().value;\n      if (oldest) {\n        pageDataCache.delete(oldest);\n        backgroundRefreshTimestamps.delete(oldest);\n      }\n    }\n    pageDataCache.set(cacheIdentity, { data, timestamp: Date.now() });\n  }\n  const scrollPositions = /* @__PURE__ */ new Map();\n  function saveScrollPosition(path) {\n    if (scrollPositions.size >= MAX_SCROLL_POSITIONS) {\n      const oldest = scrollPositions.keys().next().value;\n      if (oldest) scrollPositions.delete(oldest);\n    }\n    scrollPositions.set(path, window.scrollY);\n  }\n  function restoreScrollPosition(path) {\n    const savedY = scrollPositions.get(path);\n    if (savedY === void 0) return false;\n    requestAnimationFrame(() => window.scrollTo(0, savedY));\n    return true;\n  }\n  let progressBar = null;\n  let progressTimeout = null;\n  function showNavigationProgress() {\n    if (!progressBar) {\n      progressBar = document2.createElement("div");\n      progressBar.id = "vf-nav-progress";\n      progressBar.style.cssText = "position:fixed;top:0;left:0;height:3px;width:0;background:linear-gradient(90deg,#0066ff,#00aaff);z-index:99999;transition:width 0.3s ease-out,opacity 0.2s;opacity:1;";\n      document2.body.prepend(progressBar);\n    }\n    progressBar.style.opacity = "1";\n    progressBar.style.width = "30%";\n    progressTimeout = setTimeout2(() => {\n      if (progressBar?.style) progressBar.style.width = "70%";\n    }, 300);\n    document2.body.setAttribute("aria-busy", "true");\n  }\n  function hideNavigationProgress() {\n    if (progressTimeout) {\n      clearTimeout2(progressTimeout);\n      progressTimeout = null;\n    }\n    if (progressBar) {\n      progressBar.style.width = "100%";\n      setTimeout2(() => {\n        if (!progressBar) return;\n        progressBar.style.opacity = "0";\n        setTimeout2(() => {\n          if (progressBar) progressBar.style.width = "0";\n        }, 200);\n      }, 150);\n    }\n    document2.body.removeAttribute("aria-busy");\n  }\n  let currentAbortController = null;\n  function sleep(ms) {\n    return new Promise((resolve) => setTimeout2(resolve, ms));\n  }\n  async function fetchWithRetry(url, options, maxRetries = MAX_RETRIES) {\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const callerSignal = options.signal;\n      const abortFromCaller = () => controller.abort();\n      if (callerSignal?.aborted) controller.abort();\n      callerSignal?.addEventListener("abort", abortFromCaller, { once: true });\n      const timeout = setTimeout2(() => controller.abort(), FETCH_TIMEOUT_MS);\n      try {\n        const response = await env2.fetch(url, { ...options, signal: controller.signal });\n        clearTimeout2(timeout);\n        callerSignal?.removeEventListener("abort", abortFromCaller);\n        if (response.ok) return response;\n        if (response.status >= 500 && attempt < maxRetries) {\n          log("Server error, retrying...", response.status);\n          await sleep(Math.pow(2, attempt) * 500);\n          continue;\n        }\n        return response;\n      } catch (error) {\n        clearTimeout2(timeout);\n        callerSignal?.removeEventListener("abort", abortFromCaller);\n        if (error.name === "AbortError" && callerSignal?.aborted) throw error;\n        if (attempt === maxRetries) throw error;\n        log("Fetch failed, retrying...", error.message);\n        await sleep(Math.pow(2, attempt) * 500);\n      }\n    }\n    throw new Error("Failed to fetch page data");\n  }\n  async function fetchPageDataFresh(path, signal, options = {}) {\n    const {\n      triggerReloadOnVersionMismatch = false,\n      recordRouteTiming = false,\n      timingSource = "network"\n    } = options;\n    const endpoint = buildPageDataEndpoint(path, window.location.origin);\n    const startedAt = recordRouteTiming ? routeTimingNow() : 0;\n    log("Fetching page data:", path);\n    perfStart("fetch:" + path);\n    const headers = options.prefetch ? { "X-Veryfront-Prefetch": "1" } : { "X-Veryfront-Navigation": "spa" };\n    if (documentPinKey) {\n      headers["X-Veryfront-Dependency-Pins"] = documentPinKey;\n    }\n    const response = await fetchWithRetry(endpoint, {\n      headers,\n      signal\n    }, options.prefetch ? 0 : MAX_RETRIES);\n    if (!response.ok) {\n      perfEnd("fetch:" + path);\n      if (recordRouteTiming) {\n        emitRouteTiming(\n          "page-data",\n          path,\n          startedAt,\n          buildPageDataTimingDetail(response, endpoint, startedAt, timingSource)\n        );\n      }\n      const error = new Error("Failed to fetch page data: " + response.status);\n      error.status = response.status;\n      throw error;\n    }\n    perfStart("parse:" + path);\n    const data = assertPageDataMatchesDocumentSnapshot(\n      path,\n      await response.json(),\n      documentPinKey\n    );\n    perfEnd("parse:" + path);\n    perfEnd("fetch:" + path);\n    if (recordRouteTiming) {\n      emitRouteTiming(\n        "page-data",\n        path,\n        startedAt,\n        buildPageDataTimingDetail(response, endpoint, startedAt, timingSource)\n      );\n    }\n    if (triggerReloadOnVersionMismatch) {\n      const checkedData = handlePageDataVersionMismatch(path, data);\n      if (checkedData !== data) return checkedData;\n    }\n    setCachedPageData(path, data);\n    return data;\n  }\n  function handlePageDataVersionMismatch(path, data) {\n    if (data.buildVersion && checkVersionMismatch(data.buildVersion)) {\n      log("Version mismatch detected, performing full page reload to:", path);\n      navigateDocument(path);\n      return new Promise(() => {\n      });\n    }\n    return data;\n  }\n  function startPageDataFetch(path, signal, options = {}) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const request = fetchPageDataFresh(path, signal, options).finally(() => {\n      if (options.trackPending !== false && pendingPageDataFetches.get(cacheIdentity) === request) {\n        pendingPageDataFetches.delete(cacheIdentity);\n      }\n    });\n    if (options.trackPending !== false) {\n      pendingPageDataFetches.set(cacheIdentity, request);\n    }\n    return request;\n  }\n  function fetchPageDataDeduped(path) {\n    const pending = pendingPageDataFetches.get(pageDataCacheIdentity2(path));\n    if (pending) return pending;\n    return startPageDataFetch(path, null);\n  }\n  function refreshPageDataInBackground(path) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const lastRefreshAt = backgroundRefreshTimestamps.get(cacheIdentity) || 0;\n    const now = Date.now();\n    if (now - lastRefreshAt < BACKGROUND_REFRESH_INTERVAL_MS) return;\n    backgroundRefreshTimestamps.set(cacheIdentity, now);\n    fetchPageDataDeduped(path).catch((error) => {\n      logBackgroundFetchFailure("Stale page data refresh", path, error);\n    });\n  }\n  async function fetchPageDataForNavigation(path, signal) {\n    const startedAt = routeTimingNow();\n    const cached = getCachedPageData(path);\n    if (cached) {\n      log("Using cached page data:", path);\n      refreshPageDataInBackground(path);\n      emitRouteTiming("page-data", path, startedAt, { source: "cache" });\n      return cached;\n    }\n    const pending = pendingPageDataFetches.get(pageDataCacheIdentity2(path));\n    if (pending) {\n      log("Reusing pending page data fetch for navigation:", path);\n      const data = await pending;\n      emitRouteTiming("page-data", path, startedAt, { source: "deduped" });\n      return handlePageDataVersionMismatch(path, data);\n    }\n    return startPageDataFetch(path, signal, {\n      triggerReloadOnVersionMismatch: true,\n      recordRouteTiming: true,\n      timingSource: "network"\n    });\n  }\n  function fetchPageDataForPrefetch(path, signal) {\n    if (getCachedPageData(path)) return Promise.resolve();\n    return startPageDataFetch(path, signal, { prefetch: true, trackPending: false }).then((data) => preloadModulesForPageData(data, path)).catch((error) => {\n      if (!isAbortError(error)) {\n        logBackgroundFetchFailure("Page data prefetch", path, error);\n      }\n      throw error;\n    });\n  }\n  let currentPath = window.location.pathname;\n  let isNavigating = false;\n  async function navigateSPA(href, historyMode = "push", restoreScroll = false) {\n    currentAbortController?.abort();\n    if (isNavigating) return;\n    isNavigating = true;\n    const [navigationPath] = href.split("#");\n    removeQueuedPrefetch(navigationPath || href);\n    abortActiveSpeculativePrefetches();\n    currentAbortController = new AbortController();\n    const signal = currentAbortController.signal;\n    const navigationStartedAt = routeTimingNow();\n    showNavigationProgress();\n    perfStart("nav:total:" + href);\n    try {\n      log("SPA navigating to:", href);\n      saveScrollPosition(currentPath);\n      const [path, hash] = href.split("#");\n      const targetPath = path || currentPath;\n      perfStart("nav:fetchData:" + href);\n      const pageData = await fetchPageDataForNavigation(targetPath, signal);\n      perfEnd("nav:fetchData:" + href);\n      if (signal.aborted) return;\n      if (pageData && pageData.redirect && typeof pageData.redirect.destination === "string") {\n        const redirectUrl = resolveDocumentNavigationUrl(\n          pageData.redirect.destination,\n          window.location.origin\n        );\n        if (redirectUrl) {\n          log("SPA navigation redirect -> " + redirectUrl);\n          window.location.href = redirectUrl;\n          return;\n        }\n      }\n      if (historyMode === "push") {\n        window.history.pushState({ pageData, scrollY: 0 }, "", href);\n      } else if (historyMode === "replace") {\n        window.history.replaceState({ pageData, scrollY: 0 }, "", href);\n      }\n      currentPath = targetPath;\n      router.pathname = targetPath;\n      router.query = Object.fromEntries(new URLSearchParams(window.location.search));\n      router.params = flattenRouteParams(pageData.params);\n      perfStart("nav:render:" + href);\n      await renderPageFromData(pageData, targetPath);\n      perfEnd("nav:render:" + href);\n      if (restoreScroll) {\n        restoreScrollPosition(targetPath);\n      } else if (hash) {\n        requestAnimationFrame(() => {\n          const target = document2.getElementById(hash);\n          if (target) {\n            target.scrollIntoView({ behavior: "smooth" });\n            return;\n          }\n          window.scrollTo(0, 0);\n        });\n      } else {\n        window.scrollTo(0, 0);\n      }\n      hideNavigationProgress();\n      perfEnd("nav:total:" + href);\n      emitRouteTiming("total", targetPath, navigationStartedAt, {\n        href,\n        historyMode,\n        restoreScroll\n      });\n      log("SPA navigation complete");\n    } catch (error) {\n      hideNavigationProgress();\n      if (error.name === "AbortError") {\n        log("Navigation aborted");\n        return;\n      }\n      logError("SPA navigation failed:", error.message);\n      if (error.status === 404) {\n        logError("Page not found:", href);\n      }\n      navigateDocument(href);\n    } finally {\n      isNavigating = false;\n      currentAbortController = null;\n      processPageDataPrefetchQueue();\n    }\n  }\n  async function loadPageDataComponent(pageData, path, options = {}) {\n    if (!pageData.isolatedClientPage) return loadComponent(path, pageData, options);\n    const moduleUrl = buildPinnedRscModuleUrl(path, pageData);\n    const module = await snapshotModules2.importSnapshotBoundModule(\n      moduleUrl,\n      options.allowDocumentReload !== false\n    );\n    return module.MDXLayout || module.MainLayout || module.default || module;\n  }\n  async function renderPageFromData(pageData, targetPath) {\n    if (pageData.requiresFullDocumentNavigation) {\n      throw new Error("Server layout requires full document navigation");\n    }\n    if (window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(pageData.releaseId || null);\n    }\n    if (window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(pageData.releaseAssetModules || null);\n    }\n    perfStart("render:loadAll");\n    const allPaths = getPageDataModulePaths(pageData);\n    const modulesStartedAt = routeTimingNow();\n    const components = await Promise.all(\n      allPaths.map((path) => loadPageDataComponent(pageData, path))\n    );\n    emitRouteTiming("modules", targetPath, modulesStartedAt, { count: allPaths.length });\n    perfEnd("render:loadAll");\n    const [PageComponent, ...rest] = components;\n    const ErrorComponent = pageData.errorPath ? rest.pop() : null;\n    const AppComponent = pageData.appPath ? rest.pop() : null;\n    const LayoutComponents = rest;\n    if (!PageComponent) {\n      throw new Error("Failed to load page component: " + pageData.pagePath);\n    }\n    handoffClientRouteMetadata(\n      pageData.frontmatter ?? {},\n      document2\n    );\n    if (pageData.css) {\n      const existingStyle = document2.getElementById("veryfront-spa-css");\n      if (existingStyle) {\n        existingStyle.textContent = pageData.css;\n      } else {\n        const styleEl = document2.createElement("style");\n        const nonce = getDocumentNonce(document2);\n        if (nonce) styleEl.setAttribute("nonce", nonce);\n        styleEl.id = "veryfront-spa-css";\n        styleEl.textContent = pageData.css;\n        document2.head.appendChild(styleEl);\n      }\n      log("Injected CSS for SPA navigation", { cssLength: pageData.css.length });\n    } else if (pageData.cssAction === "clear") {\n      const existingStyle = document2.getElementById("veryfront-spa-css");\n      if (existingStyle) {\n        existingStyle.remove();\n        log("Cleared SPA CSS for release stylesheet navigation");\n      }\n    }\n    const normalizedParams = flattenRouteParams(pageData.params);\n    let tree = React2.createElement(PageComponent, {\n      ...pageData.props,\n      params: normalizedParams\n    });\n    if (pageData.layouts?.length) {\n      for (let i = pageData.layouts.length - 1; i >= 0; i--) {\n        const layout = pageData.layouts[i];\n        const LayoutComponent = LayoutComponents[i];\n        if (!LayoutComponent || !layout) continue;\n        const layoutProps = pageData.layoutProps?.[layout.path] || {};\n        tree = React2.createElement(LayoutComponent, { ...layoutProps, children: tree });\n      }\n    }\n    if (AppComponent) {\n      tree = React2.createElement(AppComponent, { children: tree });\n      log("Wrapped with App component for SPA navigation");\n    }\n    if (ErrorComponent) {\n      class AppRouterErrorBoundary extends React2.Component {\n        constructor(props) {\n          super(props);\n          this.state = { hasError: false, error: null };\n        }\n        static getDerivedStateFromError(error) {\n          return { hasError: true, error };\n        }\n        render() {\n          if (this.state.hasError) {\n            return React2.createElement(ErrorComponent, {\n              error: this.state.error,\n              reset: () => this.setState({ hasError: false, error: null })\n            });\n          }\n          return this.props.children;\n        }\n      }\n      tree = React2.createElement(AppRouterErrorBoundary, null, tree);\n    }\n    const headingsArray = pageData.headings || [];\n    const pageContext = {\n      slug: pageData.slug || "",\n      path: pageData.pagePath || targetPath,\n      params: normalizedParams,\n      query: Object.fromEntries(new URLSearchParams(window.location.search)),\n      frontmatter: pageData.frontmatter || {},\n      data: pageData.props || {},\n      headings: headingsArray,\n      mdxHeadings: headingsArray\n    };\n    tree = React2.createElement(PageContextProvider2, { pageContext, children: tree });\n    tree = React2.createElement(RouterProvider2, { router, children: tree });\n    const container = pageData.isolatedClientPage ? document2.getElementById("veryfront-page-island") : document2.getElementById("root");\n    if (!hydrationCompleted && !hydrationFailed) {\n      log("Waiting for hydration to complete before SPA render...");\n      try {\n        await Promise.race([\n          hydrationPromise,\n          new Promise(\n            (_, reject) => setTimeout2(() => reject(new Error("Hydration timeout")), 1e4)\n          )\n        ]);\n      } catch (waitError) {\n        log("Hydration wait failed:", waitError.message);\n      }\n    }\n    if (container?.__reactRoot) {\n      perfStart("render:reactRender");\n      container.__reactRoot.render(tree);\n      perfEnd("render:reactRender");\n      log("Page re-rendered via SPA");\n      scheduleRoutePrefetchRefresh();\n      return;\n    }\n    if (hydrationFailed) {\n      throw new Error(\n        "React root not found - hydration failed, falling back to full page navigation"\n      );\n    }\n    throw new Error("React root not found");\n  }\n  let prefetchTimeout = null;\n  let currentHoverLink = null;\n  let routePrefetchRefreshPending = false;\n  let viewportPrefetchObserver = null;\n  const observedPrefetchLinks = /* @__PURE__ */ new WeakSet();\n  const prefetchedPaths = /* @__PURE__ */ new Set();\n  const inFlightPrefetches = /* @__PURE__ */ new Set();\n  const queuedPrefetchPaths = /* @__PURE__ */ new Set();\n  const pageDataPrefetchQueue = [];\n  const activePageDataPrefetchControllers = /* @__PURE__ */ new Map();\n  function cancelScheduledPrefetch() {\n    if (prefetchTimeout) {\n      clearTimeout2(prefetchTimeout);\n      prefetchTimeout = null;\n    }\n    currentHoverLink = null;\n  }\n  function getPageDataModulePaths(pageData) {\n    const layoutPaths = (pageData.layouts || []).map((l) => l.path).filter(Boolean);\n    const allPaths = [pageData.pagePath, ...layoutPaths].filter(Boolean);\n    if (pageData.appPath) allPaths.push(pageData.appPath);\n    if (pageData.errorPath) allPaths.push(pageData.errorPath);\n    return allPaths;\n  }\n  function getCurrentRouteHref() {\n    return window.location.pathname + window.location.search;\n  }\n  function getInternalRouteHrefFromLink(link) {\n    if (!link || link.target === "_blank" || link.hasAttribute("download") || link.getAttribute("data-prefetch") === "false") {\n      return null;\n    }\n    const href = link.getAttribute("href");\n    if (!href || href.startsWith("#") || href.startsWith("//") || !href.startsWith("/")) {\n      return null;\n    }\n    try {\n      const url = new URL(href, window.location.origin);\n      if (url.origin !== window.location.origin) return null;\n      const routeHref = url.pathname + url.search;\n      return routeHref === getCurrentRouteHref() ? null : routeHref;\n    } catch (_) {\n      return null;\n    }\n  }\n  function getEligiblePrefetchLinks(limit) {\n    const links = [];\n    const seenHrefs = /* @__PURE__ */ new Set();\n    for (const link of document2.querySelectorAll("a[href]")) {\n      const href = getInternalRouteHrefFromLink(link);\n      if (!href || seenHrefs.has(href)) continue;\n      seenHrefs.add(href);\n      links.push({ link, href });\n      if (links.length >= limit) break;\n    }\n    return links;\n  }\n  async function preloadModulesForPageData(pageData, path) {\n    if (!pageData || pageData.requiresFullDocumentNavigation) return;\n    if (pageData.releaseId && window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(pageData.releaseId);\n    }\n    if (pageData.releaseAssetModules && window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(pageData.releaseAssetModules);\n    }\n    const modulePaths = getPageDataModulePaths(pageData);\n    if (modulePaths.length === 0) return;\n    try {\n      await Promise.all(\n        modulePaths.map(\n          (modulePath) => loadPageDataComponent(pageData, modulePath, { allowDocumentReload: false })\n        )\n      );\n    } catch (error) {\n      if (isDependencySnapshotConflict(error)) {\n        const cacheIdentity = pageDataCacheIdentity2(path);\n        pageDataCache.delete(cacheIdentity);\n        backgroundRefreshTimestamps.delete(cacheIdentity);\n        prefetchedPaths.delete(path);\n        throw error;\n      }\n      logBackgroundFetchFailure("Module prefetch", path, error);\n    }\n  }\n  function removeQueuedPrefetch(path) {\n    queuedPrefetchPaths.delete(path);\n    for (let i = pageDataPrefetchQueue.length - 1; i >= 0; i--) {\n      if (pageDataPrefetchQueue[i] === path) pageDataPrefetchQueue.splice(i, 1);\n    }\n  }\n  function abortActiveSpeculativePrefetches() {\n    for (const controller of activePageDataPrefetchControllers.values()) {\n      controller.abort();\n    }\n  }\n  function processPageDataPrefetchQueue() {\n    if (isNavigating) return;\n    while (activePageDataPrefetchControllers.size < PAGE_DATA_PREFETCH_CONCURRENCY && pageDataPrefetchQueue.length > 0) {\n      const href = pageDataPrefetchQueue.shift();\n      queuedPrefetchPaths.delete(href);\n      if (prefetchedPaths.has(href) || inFlightPrefetches.has(href) || getCachedPageData(href)) {\n        continue;\n      }\n      if (prefetchedPaths.size >= MAX_PREFETCH_PATHS) {\n        const oldest = prefetchedPaths.values().next().value;\n        if (oldest) prefetchedPaths.delete(oldest);\n      }\n      const controller = new AbortController();\n      prefetchedPaths.add(href);\n      inFlightPrefetches.add(href);\n      activePageDataPrefetchControllers.set(href, controller);\n      fetchPageDataForPrefetch(href, controller.signal).catch((error) => {\n        prefetchedPaths.delete(href);\n        if (isDependencySnapshotConflict(error)) {\n          logBackgroundFetchFailure("Module prefetch", href, error);\n        }\n      }).finally(() => {\n        inFlightPrefetches.delete(href);\n        activePageDataPrefetchControllers.delete(href);\n        processPageDataPrefetchQueue();\n      });\n    }\n  }\n  function prefetchPage(href) {\n    if (isNavigating) return;\n    if (prefetchedPaths.has(href) || inFlightPrefetches.has(href) || queuedPrefetchPaths.has(href)) return;\n    const cachedPageData = getCachedPageData(href);\n    if (cachedPageData) {\n      preloadModulesForPageData(cachedPageData, href).catch((error) => {\n        logBackgroundFetchFailure("Module prefetch", href, error);\n      });\n      return;\n    }\n    queuedPrefetchPaths.add(href);\n    pageDataPrefetchQueue.push(href);\n    processPageDataPrefetchQueue();\n  }\n  function prefetchEligibleRouteLinks(limit) {\n    for (const { href } of getEligiblePrefetchLinks(limit)) {\n      prefetchPage(href);\n    }\n  }\n  function ensureViewportPrefetchObserver() {\n    if (viewportPrefetchObserver || typeof IntersectionObserver !== "function") {\n      return viewportPrefetchObserver;\n    }\n    viewportPrefetchObserver = new IntersectionObserver((entries) => {\n      for (const entry of entries) {\n        if (!entry.isIntersecting) continue;\n        viewportPrefetchObserver?.unobserve(entry.target);\n        const href = getInternalRouteHrefFromLink(\n          entry.target\n        );\n        if (href) prefetchPage(href);\n      }\n    }, { rootMargin: VIEWPORT_PREFETCH_ROOT_MARGIN });\n    return viewportPrefetchObserver;\n  }\n  function observeViewportPrefetchLinks() {\n    const observer = ensureViewportPrefetchObserver();\n    if (!observer) return;\n    for (const { link } of getEligiblePrefetchLinks(VIEWPORT_PREFETCH_MAX_LINKS)) {\n      if (observedPrefetchLinks.has(link)) continue;\n      observedPrefetchLinks.add(link);\n      observer.observe(link);\n    }\n  }\n  function runRoutePrefetchRefresh() {\n    routePrefetchRefreshPending = false;\n    prefetchEligibleRouteLinks(IDLE_PREFETCH_MAX_LINKS);\n    observeViewportPrefetchLinks();\n  }\n  function scheduleRoutePrefetchRefresh() {\n    if (routePrefetchRefreshPending) return;\n    routePrefetchRefreshPending = true;\n    setTimeout2(() => {\n      if (typeof requestIdleCallback === "function") {\n        requestIdleCallback(runRoutePrefetchRefresh, { timeout: IDLE_PREFETCH_DELAY_MS });\n        return;\n      }\n      runRoutePrefetchRefresh();\n    }, IDLE_PREFETCH_DELAY_MS);\n  }\n  const router = {\n    domain: window.location.origin,\n    path: window.location.pathname,\n    push: (path) => {\n      void navigateSPA(path, "push");\n    },\n    replace: (path) => {\n      void navigateSPA(path, "replace");\n    },\n    back: () => {\n      window.history.back();\n    },\n    forward: () => {\n      window.history.forward();\n    },\n    prefetch: (path) => {\n      prefetchPage(path);\n    },\n    pathname: window.location.pathname,\n    query: Object.fromEntries(new URLSearchParams(window.location.search)),\n    // Seed route params from the hydration data (issue #2741). Catch-all\n    // segments arrive as arrays and are joined so no path info is lost.\n    params: flattenRouteParams(deps.initialHydrationData.params || {}),\n    isPreview: false,\n    isMounted: true,\n    navigate: (path) => navigateSPA(path, "push"),\n    reload: () => window.location.reload()\n  };\n  window.__veryfrontRouter = router;\n  if (deps.navigationStoreUsesRegistryFallback) {\n    log("Router runtime does not export getNavigationStore; using shared v1 registry fallback");\n  }\n  if (typeof deps.getNavigationStore === "function") {\n    deps.getNavigationStore().setNavigator((href, options) => {\n      const mode = options && options.history;\n      const historyMode = mode === "replace" ? "replace" : mode === "none" ? "none" : "push";\n      return navigateSPA(href, historyMode);\n    });\n  }\n  window.addEventListener("popstate", async (e) => {\n    const path = window.location.pathname;\n    log("Popstate:", path);\n    saveScrollPosition(currentPath);\n    if (!e.state?.pageData) {\n      await navigateSPA(path, "none", true);\n      return;\n    }\n    showNavigationProgress();\n    try {\n      currentPath = path;\n      router.pathname = path;\n      router.query = Object.fromEntries(new URLSearchParams(window.location.search));\n      router.params = flattenRouteParams(e.state.pageData.params);\n      await renderPageFromData(e.state.pageData, path);\n      restoreScrollPosition(path);\n      hideNavigationProgress();\n    } catch (error) {\n      hideNavigationProgress();\n      logError("Popstate render failed:", error.message);\n      window.location.reload();\n    }\n  });\n  document2.addEventListener("click", (e) => {\n    const link = e.target?.closest("a[href]");\n    if (!link) return;\n    const href = link.getAttribute("href");\n    if (!href) return;\n    if (href.startsWith("#")) {\n      const target = document2.getElementById(href.slice(1));\n      if (!target) return;\n      e.preventDefault();\n      target.scrollIntoView({ behavior: "smooth" });\n      window.history.pushState(null, "", href);\n      return;\n    }\n    if (link.target === "_blank" || link.hasAttribute("download") || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || !href.startsWith("/") || href.startsWith("//")) {\n      return;\n    }\n    e.preventDefault();\n    cancelScheduledPrefetch();\n    void navigateSPA(href, "push");\n  });\n  document2.addEventListener(\n    "mouseenter",\n    (e) => {\n      if (!e.target || typeof e.target.closest !== "function") return;\n      const link = e.target.closest("a[href]");\n      if (!link) return;\n      const href = getInternalRouteHrefFromLink(link);\n      if (!href) return;\n      if (currentHoverLink === link) return;\n      if (prefetchTimeout) {\n        clearTimeout2(prefetchTimeout);\n        prefetchTimeout = null;\n      }\n      currentHoverLink = link;\n      prefetchTimeout = setTimeout2(() => {\n        prefetchPage(href);\n        prefetchTimeout = null;\n      }, PREFETCH_DELAY_MS);\n    },\n    true\n  );\n  document2.addEventListener(\n    "mouseleave",\n    (e) => {\n      if (!e.target || typeof e.target.closest !== "function") return;\n      const relatedTarget = e.relatedTarget;\n      if (currentHoverLink && relatedTarget && currentHoverLink.contains(relatedTarget)) return;\n      cancelScheduledPrefetch();\n    },\n    true\n  );\n  if (document2.readyState === "loading") {\n    document2.addEventListener("DOMContentLoaded", scheduleRoutePrefetchRefresh, { once: true });\n  } else {\n    scheduleRoutePrefetchRefresh();\n  }\n  window.useRouter = () => {\n    try {\n      return env2.useRouterFromModule();\n    } catch (_) {\n      return window.__veryfrontRouter;\n    }\n  };\n  return {\n    router,\n    navigateSPA,\n    renderPageFromData,\n    prefetchPage,\n    signalHydrationComplete,\n    signalHydrationFailed\n  };\n}\n\n// src/html/hydration-script-builder/runtime/renderer.ts\nfunction isModuleNotFoundError(error) {\n  if (!error) return false;\n  if (error instanceof SyntaxError) return false;\n  const message = String(error.message || error);\n  return /(?:dynamically imported module|Importing a module script failed|Failed to load module script)/i.test(message);\n}\nfunction preferReachedModuleError(earlier, later) {\n  if (!earlier) return later;\n  if (!later) return earlier;\n  if (isModuleNotFoundError(earlier) && !isModuleNotFoundError(later)) return later;\n  return earlier;\n}\nasync function loadPageModuleWithIndexFallback(basePath, pageSlug, pageModuleError, importModule) {\n  try {\n    return await importModule(basePath + ".js");\n  } catch (error) {\n    const routeError = preferReachedModuleError(pageModuleError, error);\n    if (pageSlug === "index" || pageSlug.endsWith("/index")) throw routeError;\n    try {\n      return await importModule(basePath + "/index.js");\n    } catch (indexError) {\n      throw preferReachedModuleError(routeError, indexError);\n    }\n  }\n}\nfunction isAppRouterPath(path, appRouterRoot) {\n  const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n  return normalizedPath === appRouterRoot || normalizedPath.startsWith(appRouterRoot + "/");\n}\nfunction isRootAppLayoutPath(path, appRouterRoot) {\n  const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n  const pathWithoutExtension = normalizedPath.replace(/\\.(?:tsx|jsx|ts|js)$/, "");\n  return pathWithoutExtension === appRouterRoot + "/layout";\n}\nfunction unwrapAppRouterDocumentLayout(LayoutComponent, React2) {\n  return function AppRouterDocumentLayout(props) {\n    const element = LayoutComponent(props);\n    const asElement = element;\n    if (!React2.isValidElement(element) || asElement.type !== "html") {\n      return element;\n    }\n    const body = React2.Children.toArray(asElement.props?.children).find(\n      (child) => React2.isValidElement(child) && child.type === "body"\n    );\n    return body?.props?.children ?? props.children;\n  };\n}\nfunction createHydrationRenderer(deps) {\n  const { env: env2, logging: logging2, componentLoader: componentLoader2, snapshotModules: snapshotModules2, moduleServerUrl: moduleServerUrl2 } = deps;\n  const { window, document: document2, React: React2, RouterProvider: RouterProvider2, PageContextProvider: PageContextProvider2 } = env2;\n  const { DEBUG, log, logError } = logging2;\n  const { loadComponent, pathToModuleUrl } = componentLoader2;\n  const { importSnapshotBoundModule } = snapshotModules2;\n  async function renderPage(pathname) {\n    const resolvedPathname = (() => {\n      const input = typeof pathname === "string" ? pathname : window.location.pathname;\n      try {\n        return new URL(input, window.location.origin).pathname || "/";\n      } catch (_) {\n        const [pathOnly] = String(input || "/").split(/[?#]/);\n        return pathOnly || "/";\n      }\n    })();\n    const dataScript = findServerHydrationDataElement(document2);\n    if (!dataScript) {\n      logError("Hydration data not found");\n      return;\n    }\n    let data = {};\n    try {\n      data = JSON.parse(dataScript.textContent || "{}");\n    } catch (parseError) {\n      logError("Failed to parse hydration data:", parseError);\n      return;\n    }\n    log("Hydration data:", data);\n    if (data.studioEmbed && window.__veryfrontSetStudioEmbed) {\n      window.__veryfrontSetStudioEmbed(true);\n    }\n    if (window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(data.releaseId || null);\n    }\n    if (data.releaseAssetModules && window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(data.releaseAssetModules);\n    }\n    try {\n      let pageModule;\n      const pagePath = typeof data.pagePath === "string" ? data.pagePath : "";\n      const normalizedPagePath = pagePath.replace(/^\\/+/, "");\n      const normalizedAppRouterRoot = typeof data.appRouterRoot === "string" && data.appRouterRoot.replace(/^\\/+|\\/+$/g, "") ? data.appRouterRoot.replace(/^\\/+|\\/+$/g, "") : "app";\n      const hasReleaseAssetModules = data.releaseAssetModules && Object.keys(data.releaseAssetModules).length > 0;\n      const shouldRenderRscClientPage = data.clientModuleStrategy === "rsc-module" && !hasReleaseAssetModules && isAppRouterPath(normalizedPagePath, normalizedAppRouterRoot);\n      const isolatedClientPage = data.isolatedClientPage === true;\n      const loadHydrationComponent = async (path, preferRscModule) => {\n        const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n        if (preferRscModule && isAppRouterPath(normalizedPath, normalizedAppRouterRoot)) {\n          const moduleUrl = buildPinnedRscModuleUrl(path, data);\n          log("Loading App Router component from RSC module:", moduleUrl);\n          const module = await importSnapshotBoundModule(moduleUrl);\n          return module.default || module;\n        }\n        return loadComponent(path, data);\n      };\n      let pageModuleError = null;\n      if (data.pagePath) {\n        const moduleUrl = shouldRenderRscClientPage ? buildPinnedRscModuleUrl(data.pagePath, data) : pathToModuleUrl(data.pagePath, data.studioEmbed, data);\n        log("Loading page from hydration data:", moduleUrl);\n        try {\n          pageModule = await importSnapshotBoundModule(moduleUrl);\n        } catch (error) {\n          pageModuleError = error;\n          logError("Failed to load page from hydration data:", error);\n        }\n      }\n      if (!pageModule) {\n        const pageSlug = resolvedPathname === "/" ? "index" : resolvedPathname.slice(1);\n        log("Falling back to Pages Router pattern:", pageSlug);\n        const prefix = pageSlug.startsWith("@/") ? "" : "/pages";\n        const basePath = moduleServerUrl2 + prefix + "/" + pageSlug;\n        pageModule = await loadPageModuleWithIndexFallback(\n          basePath,\n          pageSlug,\n          pageModuleError,\n          (moduleUrl) => importSnapshotBoundModule(appendDependencyPinningVersion(moduleUrl, data))\n        );\n      }\n      if (!pageModule) {\n        logError("Page module failed to load");\n        return;\n      }\n      const PageComponent = pageModule.default || pageModule;\n      if (!PageComponent) {\n        logError("Page component not found");\n        return;\n      }\n      const normalizedParams = flattenRouteParams(data.params);\n      const pageProps = { ...data.props || {}, params: normalizedParams };\n      let tree = React2.createElement(PageComponent, pageProps);\n      const layouts = data.layouts;\n      if (layouts?.length) {\n        for (let i = layouts.length - 1; i >= 0; i--) {\n          const layout = layouts[i];\n          if (!layout) continue;\n          const LayoutComponent = await loadHydrationComponent(\n            layout.path,\n            shouldRenderRscClientPage\n          );\n          if (LayoutComponent) {\n            const WrappedLayoutComponent = shouldRenderRscClientPage && isRootAppLayoutPath(layout.path, normalizedAppRouterRoot) ? unwrapAppRouterDocumentLayout(LayoutComponent, React2) : LayoutComponent;\n            const layoutProps = data.layoutProps?.[layout.path] || {};\n            tree = React2.createElement(\n              WrappedLayoutComponent,\n              { ...layoutProps, children: tree }\n            );\n          }\n        }\n      }\n      if (data.appPath && !isolatedClientPage) {\n        const AppComponent = await loadHydrationComponent(data.appPath, shouldRenderRscClientPage);\n        if (AppComponent) {\n          tree = React2.createElement(AppComponent, { children: tree });\n        }\n      }\n      if (data.errorPath) {\n        const ErrorComponent = await loadHydrationComponent(\n          data.errorPath,\n          shouldRenderRscClientPage\n        );\n        if (ErrorComponent) {\n          class AppRouterErrorBoundary extends React2.Component {\n            constructor(props) {\n              super(props);\n              this.state = { hasError: false, error: null };\n            }\n            static getDerivedStateFromError(error) {\n              return { hasError: true, error };\n            }\n            render() {\n              if (this.state.hasError) {\n                return React2.createElement(ErrorComponent, {\n                  error: this.state.error,\n                  reset: () => this.setState({ hasError: false, error: null })\n                });\n              }\n              return this.props.children;\n            }\n          }\n          tree = React2.createElement(AppRouterErrorBoundary, null, tree);\n        }\n      }\n      const headings = data.headings || [];\n      const pageContext = {\n        slug: data.slug || "",\n        path: data.pagePath || resolvedPathname,\n        params: normalizedParams,\n        query: Object.fromEntries(new URLSearchParams(window.location.search)),\n        frontmatter: data.frontmatter || {},\n        data: data.props || {},\n        headings,\n        mdxHeadings: headings\n        // Alias for backwards compatibility\n      };\n      tree = React2.createElement(PageContextProvider2, { pageContext, children: tree });\n      tree = React2.createElement(RouterProvider2, { router: deps.router, children: tree });\n      const container = isolatedClientPage ? document2.getElementById("veryfront-page-island") : document2.getElementById("root");\n      if (!container) {\n        if (isolatedClientPage) {\n          throw new Error("Isolated client page root not found");\n        }\n        return;\n      }\n      if (container.__reactRoot) {\n        container.__reactRoot.render(tree);\n        log("Page re-rendered");\n        return;\n      }\n      if (shouldRenderRscClientPage) {\n        container.__reactRoot = env2.createRoot(container);\n        container.__reactRoot.render(tree);\n        log("Client-side React app rendered successfully");\n      } else {\n        const { hydrateRoot } = await import("react-dom/client");\n        const options = {\n          identifierPrefix: "vf",\n          onRecoverableError: (error) => {\n            if (data.dev && DEBUG) {\n              log("Hydration mismatch (suppressed):", error.message);\n            }\n          }\n        };\n        container.__reactRoot = hydrateRoot(container, tree, options);\n        log("Client-side React app hydrated successfully");\n      }\n      if (window.__veryfrontHydrationComplete) {\n        window.__veryfrontHydrationComplete();\n      }\n    } catch (error) {\n      logError("Client initialization error:", error);\n      if (window.__veryfrontHydrationFailed) {\n        window.__veryfrontHydrationFailed(error);\n      }\n    }\n  }\n  function start() {\n    window.__veryfrontRenderPage = renderPage;\n    void renderPage(window.location.pathname);\n    const initialDataScript = findServerHydrationDataElement(document2);\n    if (initialDataScript) {\n      try {\n        const pageData = JSON.parse(initialDataScript.textContent || "{}");\n        if (pageData.pagePath) {\n          window.history.replaceState({ pageData, scrollY: 0 }, "", window.location.href);\n          log("Stored initial page data in history state");\n        }\n      } catch (_) {\n      }\n    }\n  }\n  return { renderPage, start };\n}\n\n// src/html/hydration-script-builder/runtime/navigation-store.ts\nvar NAVIGATION_STORE_REGISTRY_KEY = "veryfront.navigation.store.v1";\nfunction resolveNavigationStore(RouterRuntime2) {\n  const usesRegistryFallback2 = typeof RouterRuntime2.getNavigationStore !== "function";\n  if (!usesRegistryFallback2) {\n    return {\n      usesRegistryFallback: usesRegistryFallback2,\n      getNavigationStore: RouterRuntime2.getNavigationStore\n    };\n  }\n  return {\n    usesRegistryFallback: usesRegistryFallback2,\n    getNavigationStore: () => {\n      const storeKey = Symbol.for(NAVIGATION_STORE_REGISTRY_KEY);\n      const registry = globalThis;\n      const existing = registry[storeKey];\n      if (existing) return existing;\n      const listeners = /* @__PURE__ */ new Set();\n      let navigator = null;\n      const store = {\n        subscribe(listener) {\n          listeners.add(listener);\n          return () => listeners.delete(listener);\n        },\n        getHref() {\n          const loc = globalThis.location;\n          return loc ? loc.pathname + loc.search + loc.hash : "/";\n        },\n        notify() {\n          for (const listener of [...listeners]) {\n            try {\n              listener();\n            } catch {\n            }\n          }\n        },\n        navigate(href, options) {\n          if (navigator) return navigator(href, options);\n          globalThis.location?.assign(href);\n          return Promise.resolve();\n        },\n        setNavigator(next) {\n          navigator = next;\n        }\n      };\n      registry[storeKey] = store;\n      return store;\n    }\n  };\n}\n\n// src/html/hydration-script-builder/runtime/main.ts\nvar runtimeWindow = globalThis;\nvar runtimeDocument = globalThis.document;\nvar env = {\n  window: runtimeWindow,\n  document: runtimeDocument,\n  fetch: (url, init) => fetch(url, init),\n  React,\n  RouterProvider,\n  PageContextProvider,\n  createRoot: (container) => createRoot(container),\n  importModule: (moduleUrl) => import(moduleUrl),\n  useRouterFromModule,\n  setTimeout: (handler, timeout) => setTimeout(handler, timeout),\n  clearTimeout: (id) => clearTimeout(id)\n};\nvar logging = createLogging(runtimeWindow);\nvar initialHydrationData = readInitialHydrationData(runtimeDocument);\nvar documentDependencyPinningCacheKey = readDocumentDependencyPinningCacheKey(\n  initialHydrationData\n);\nvar routeTiming = createRouteTimingRecorder(runtimeWindow, logging);\nvar snapshotModules = createSnapshotModuleImporter({\n  importModule: env.importModule,\n  fetchModule: env.fetch,\n  reloadDocument: () => runtimeWindow.location.reload(),\n  recoveryState: runtimeWindow\n});\nvar componentLoader = createComponentLoader({\n  window: runtimeWindow,\n  logging,\n  moduleServerUrl: moduleServerUrl(runtimeWindow),\n  snapshotModules\n});\nruntimeWindow.__veryfrontClearComponentCache = componentLoader.clearComponentCache;\nruntimeWindow.__veryfrontSetStudioEmbed = componentLoader.setStudioEmbed;\nruntimeWindow.__veryfrontSetReleaseId = componentLoader.setReleaseId;\nruntimeWindow.__veryfrontSetReleaseAssetModules = componentLoader.setReleaseAssetModules;\nruntimeWindow.__veryfrontSetHMRRefreshTimestamp = componentLoader.setHMRRefreshTimestamp;\nvar { usesRegistryFallback, getNavigationStore } = resolveNavigationStore(RouterRuntime);\nvar routerRuntime = createRouterRuntime({\n  env,\n  logging,\n  routeTiming,\n  componentLoader,\n  snapshotModules,\n  initialHydrationData,\n  documentDependencyPinningCacheKey,\n  getNavigationStore,\n  navigationStoreUsesRegistryFallback: usesRegistryFallback\n});\ncreateHydrationRenderer({\n  env,\n  logging,\n  componentLoader,\n  snapshotModules,\n  moduleServerUrl: moduleServerUrl(runtimeWindow),\n  router: routerRuntime.router\n}).start();\n';
+export const HYDRATION_RUNTIME_BUNDLE = '// src/html/hydration-script-builder/runtime/main.ts\nimport * as React from "react";\nimport { createRoot } from "react-dom/client";\nimport { RouterProvider, useRouter as useRouterFromModule } from "veryfront/router";\nimport * as RouterRuntime from "veryfront/router";\nimport { PageContextProvider } from "veryfront/context";\n\n// src/routing/flatten-route-params.ts\nfunction flattenRouteParams(params) {\n  if (!params) return {};\n  const flat = {};\n  for (const [key, value] of Object.entries(params)) {\n    if (value === void 0) continue;\n    flat[key] = Array.isArray(value) ? value.join("/") : value;\n  }\n  return flat;\n}\n\n// src/html/hydration-script-builder/runtime/shared.ts\nfunction moduleServerUrl(window) {\n  return window.location.origin + "/_vf_modules";\n}\nfunction createLogging(window) {\n  const DEBUG = Boolean(\n    window.__VERYFRONT_DEBUG__ || new URLSearchParams(window.location.search).has("vf_debug")\n  );\n  const log = DEBUG ? console.log.bind(console, "[Veryfront]") : () => {\n  };\n  const logError = console.error.bind(console, "[Veryfront]");\n  function logBackgroundFetchFailure(reason, path, error) {\n    const message = error?.message ?? String(error);\n    log(reason + " failed:", path, message);\n  }\n  const perfTimers = /* @__PURE__ */ new Map();\n  const perfStart = DEBUG ? (label) => {\n    perfTimers.set(label, performance.now());\n  } : () => {\n  };\n  const perfEnd = DEBUG ? (label) => {\n    const start = perfTimers.get(label);\n    if (start === void 0) return 0;\n    const duration = performance.now() - start;\n    perfTimers.delete(label);\n    console.log(\n      "[Veryfront Perf] %c" + label + ": %c" + duration.toFixed(2) + "ms",\n      "color: #888",\n      duration > 100 ? "color: #f00; font-weight: bold" : "color: #0a0"\n    );\n    return duration;\n  } : () => 0;\n  return { DEBUG, log, logError, logBackgroundFetchFailure, perfStart, perfEnd };\n}\nfunction isAbortError(error) {\n  return error?.name === "AbortError";\n}\nfunction resolveDocumentNavigationUrl(target, origin) {\n  try {\n    const url = new URL(target, origin);\n    if (url.protocol === "http:" || url.protocol === "https:") return url.href;\n  } catch (_) {\n  }\n  return null;\n}\nfunction getDocumentNonce(document2) {\n  const element = document2.querySelector("script[nonce], style[nonce], link[nonce]");\n  if (!element) return void 0;\n  return element.nonce || element.getAttribute("nonce") || void 0;\n}\n\n// src/html/hydration-data-element.ts\nvar HYDRATION_DATA_ELEMENT_ID = "veryfront-hydration-data";\nfunction findServerHydrationDataElement(document2) {\n  try {\n    const matches = [...document2.querySelectorAll(`[id="${HYDRATION_DATA_ELEMENT_ID}"]`)];\n    if (matches.length !== 1) return null;\n    const body = document2.body;\n    if (!body) return null;\n    const element = matches[0];\n    if (body.firstElementChild !== element && element.parentElement !== body) return null;\n    if (element.tagName?.toLowerCase() !== "script") return null;\n    if (element.getAttribute("type")?.trim().toLowerCase() !== "application/json") return null;\n    return element;\n  } catch {\n    return null;\n  }\n}\n\n// src/html/hydration-script-builder/runtime/hydration-data.ts\nfunction readInitialHydrationData(document2) {\n  try {\n    const element = findServerHydrationDataElement(document2);\n    return JSON.parse(element && element.textContent ? element.textContent : "{}") || {};\n  } catch (_) {\n    return {};\n  }\n}\nfunction readDocumentDependencyPinningCacheKey(initialHydrationData2) {\n  return typeof initialHydrationData2.dependencyPinningCacheKey === "string" && initialHydrationData2.dependencyPinningCacheKey.startsWith("on:") ? initialHydrationData2.dependencyPinningCacheKey : null;\n}\n\n// src/html/hydration-script-builder/runtime/snapshot-modules.ts\nvar RECOVERY_STATE_KEY = "__VF_DEPENDENCY_SNAPSHOT_RECOVERY_STARTED__";\nasync function isDependencySnapshotConflictResponse(response) {\n  if (!response || response.status !== 409) return false;\n  try {\n    const clone = response.clone?.() ?? response;\n    const body = (await clone.text?.() ?? "").trim();\n    return body === "Unknown dependency snapshot" || body === "export default null; // Unknown dependency snapshot";\n  } catch (_) {\n    return false;\n  }\n}\nfunction createSnapshotModuleImporter(deps) {\n  async function recoverFromSnapshotBoundModuleFailure(moduleUrl, allowDocumentReload = true) {\n    try {\n      const parsedUrl = new URL(moduleUrl, "http://veryfront.local");\n      const snapshotKeys = parsedUrl.searchParams.getAll("pins");\n      const pathMatch = parsedUrl.pathname.match(\n        /^\\/_vf_modules\\/_pins\\/([^/]+)(?:\\/|$)/\n      );\n      if (pathMatch) {\n        try {\n          snapshotKeys.push(decodeURIComponent(pathMatch[1]));\n        } catch (_) {\n          return false;\n        }\n      }\n      if (snapshotKeys.length !== 1 || !/^on:[A-Za-z0-9._-]+$/.test(snapshotKeys[0])) return false;\n      const response = await deps.fetchModule(moduleUrl, { cache: "no-store" });\n      if (!await isDependencySnapshotConflictResponse(response)) return false;\n      if (!allowDocumentReload) return true;\n      if (deps.recoveryState[RECOVERY_STATE_KEY] === true) return true;\n      deps.recoveryState[RECOVERY_STATE_KEY] = true;\n      try {\n        deps.reloadDocument();\n      } catch (_) {\n        delete deps.recoveryState[RECOVERY_STATE_KEY];\n        return false;\n      }\n      return true;\n    } catch (_) {\n      return false;\n    }\n  }\n  async function importSnapshotBoundModule(moduleUrl, allowDocumentReload = true) {\n    try {\n      return await deps.importModule(moduleUrl);\n    } catch (error) {\n      const snapshotConflict = await recoverFromSnapshotBoundModuleFailure(\n        moduleUrl,\n        allowDocumentReload\n      );\n      if (snapshotConflict && !allowDocumentReload) {\n        const conflictError = new Error(\n          "Dependency snapshot is unavailable during speculative module prefetch"\n        );\n        conflictError.name = "DependencySnapshotConflictError";\n        conflictError.dependencySnapshotConflict = true;\n        conflictError.cause = error;\n        throw conflictError;\n      }\n      throw error;\n    }\n  }\n  return { importSnapshotBoundModule, recoverFromSnapshotBoundModuleFailure };\n}\nfunction isDependencySnapshotConflict(error) {\n  return Boolean(error?.dependencySnapshotConflict);\n}\n\n// src/utils/version-constant.ts\nvar VERSION = "0.1.1234";\n\n// src/html/hydration-script-builder/runtime/module-urls.ts\nfunction appendQueryParam(url, key, value) {\n  return url + (url.includes("?") ? "&" : "?") + key + "=" + value;\n}\nfunction appendDependencyPinningVersion(url, moduleData) {\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  if (typeof pinKey !== "string" || !pinKey.startsWith("on:")) return url;\n  const hashIndex = url.indexOf("#");\n  const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";\n  const withoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;\n  const queryIndex = withoutHash.indexOf("?");\n  const base = queryIndex >= 0 ? withoutHash.slice(0, queryIndex) : withoutHash;\n  const params = new URLSearchParams(queryIndex >= 0 ? withoutHash.slice(queryIndex + 1) : "");\n  const modulePrefix = "/_vf_modules/";\n  const prefixIndex = base.indexOf(modulePrefix);\n  const origin = prefixIndex >= 0 ? base.slice(0, prefixIndex) : "";\n  if (prefixIndex >= 0 && (origin === "" || /^https?:\\/\\/[^/]+$/i.test(origin))) {\n    const pathStart = prefixIndex + modulePrefix.length;\n    let modulePath = base.slice(pathStart);\n    if (modulePath.startsWith("_pins/")) {\n      const existingKeyEnd = modulePath.indexOf("/", "_pins/".length);\n      const encodedExistingKey = existingKeyEnd < 0 ? modulePath.slice("_pins/".length) : modulePath.slice("_pins/".length, existingKeyEnd);\n      let existingKey;\n      try {\n        existingKey = decodeURIComponent(encodedExistingKey);\n      } catch {\n        existingKey = void 0;\n      }\n      if (existingKey && /^on:[A-Za-z0-9._-]+$/.test(existingKey)) {\n        if (existingKeyEnd < 0) return url;\n        modulePath = modulePath.slice(existingKeyEnd + 1);\n      }\n    }\n    params.delete("pins");\n    const query = params.toString();\n    return base.slice(0, pathStart) + "_pins/" + encodeURIComponent(pinKey) + "/" + modulePath + (query ? "?" + query : "") + hash;\n  }\n  params.set("pins", pinKey);\n  return base + "?" + params.toString() + hash;\n}\nfunction componentCacheKey(path, moduleData) {\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  return typeof pinKey === "string" && pinKey.startsWith("on:") ? path + "|vf_pins|" + pinKey : path;\n}\nfunction normalizeReleaseAssetModulePath(path) {\n  return String(path || "").replace(/^\\/?_vf_modules\\//, "").replace(/^\\/+/, "").replace(/[?#].*$/, "");\n}\nfunction buildPinnedRscModuleUrl(path, moduleData) {\n  let moduleUrl = "/_veryfront/rsc/module?rel=" + encodeURIComponent(path);\n  const pinKey = moduleData && moduleData.dependencyPinningCacheKey;\n  if (typeof pinKey === "string" && pinKey.startsWith("on:")) {\n    moduleUrl += "&pins=" + encodeURIComponent(pinKey);\n  }\n  return moduleUrl;\n}\nfunction buildPageDataEndpoint(path, origin) {\n  const targetUrl = new URL(path, origin);\n  const normalizedPath = targetUrl.pathname === "/" ? "" : targetUrl.pathname.replace(/^\\//, "");\n  const endpointUrl = new URL(\n    "/_veryfront/page-data/" + normalizedPath + ".json",\n    origin\n  );\n  endpointUrl.search = targetUrl.search;\n  return endpointUrl.pathname + endpointUrl.search;\n}\nfunction pageDataCacheIdentity(path, documentDependencyPinningCacheKey2) {\n  return documentDependencyPinningCacheKey2 ? documentDependencyPinningCacheKey2 + "|path:" + path : path;\n}\nfunction assertPageDataMatchesDocumentSnapshot(path, data, documentDependencyPinningCacheKey2) {\n  if (!documentDependencyPinningCacheKey2) return data;\n  if (data && data.dependencyPinningCacheKey === documentDependencyPinningCacheKey2) {\n    return data;\n  }\n  const error = new Error("Page data dependency snapshot does not match the document");\n  error.status = 409;\n  error.dependencySnapshotMismatch = true;\n  error.path = path;\n  throw error;\n}\n\n// src/html/hydration-script-builder/runtime/component-loader.ts\nvar VERYFRONT_RUNTIME_VERSION = VERSION;\nfunction createComponentLoader(deps) {\n  const { window, moduleServerUrl: moduleServerUrl2 } = deps;\n  const { DEBUG, log, logError } = deps.logging;\n  const componentCache = /* @__PURE__ */ new Map();\n  const loadingPromises = /* @__PURE__ */ new Map();\n  let releaseId = null;\n  let releaseAssetModules = null;\n  let studioEmbed = false;\n  let hmrRefreshTimestamp = null;\n  function clearComponentCache(path) {\n    if (!path) {\n      componentCache.clear();\n      loadingPromises.clear();\n      log("Cleared all component caches");\n      return;\n    }\n    for (const key of componentCache.keys()) {\n      if (key === path || key.startsWith(path + "|vf_pins|")) {\n        componentCache.delete(key);\n      }\n    }\n    for (const key of loadingPromises.keys()) {\n      if (key === path || key.startsWith(path + "|vf_pins|")) {\n        loadingPromises.delete(key);\n      }\n    }\n    log("Cleared component cache for:", path);\n  }\n  function setReleaseId(value) {\n    releaseId = typeof value === "string" && value ? value : null;\n    window.__veryfrontReleaseId = releaseId;\n  }\n  function appendReleaseModuleVersion(url) {\n    if (!releaseId || url.includes("vf_release=")) return url;\n    let versionedUrl = appendQueryParam(url, "vf_release", encodeURIComponent(releaseId));\n    versionedUrl = appendQueryParam(\n      versionedUrl,\n      "vf_runtime",\n      encodeURIComponent(VERYFRONT_RUNTIME_VERSION)\n    );\n    return versionedUrl;\n  }\n  function setReleaseAssetModules(value) {\n    releaseAssetModules = value && typeof value === "object" && !Array.isArray(value) ? value : null;\n    window.__veryfrontReleaseAssetModules = releaseAssetModules;\n  }\n  function resolveReleaseAssetModuleUrl(path) {\n    if (!releaseAssetModules || studioEmbed || hmrRefreshTimestamp) return null;\n    const key = normalizeReleaseAssetModulePath(path);\n    if (releaseAssetModules[key]) return releaseAssetModules[key];\n    const withoutExt = key.replace(/\\.(tsx|ts|jsx|mdx|js|mjs)$/, "");\n    const extensions = [".tsx", ".ts", ".jsx", ".mdx", ".js"];\n    for (const ext of extensions) {\n      const candidate = withoutExt + ext;\n      if (releaseAssetModules[candidate]) return releaseAssetModules[candidate];\n    }\n    return null;\n  }\n  function pathToModuleUrl(path, embedInStudio, moduleData) {\n    const releaseAssetUrl = resolveReleaseAssetModuleUrl(path);\n    if (releaseAssetUrl) return releaseAssetUrl;\n    const pattern = /(pages|components|app|lib|layouts|shared|features)\\/(.+)\\.(tsx|ts|jsx|mdx)$/;\n    const match = path.match(new RegExp("/" + pattern.source)) || path.match(new RegExp("^" + pattern.source));\n    let url;\n    if (match) {\n      url = moduleServerUrl2 + "/" + match[1] + "/" + match[2] + ".js";\n    } else {\n      const hasKnownExt = /\\.(tsx|ts|jsx|mdx|js|mjs)$/.test(path);\n      url = moduleServerUrl2 + "/" + (hasKnownExt ? path.replace(/\\.(tsx|ts|jsx|mdx)$/, ".js") : path + ".js");\n    }\n    if (embedInStudio) url = appendQueryParam(url, "studio_embed", "true");\n    if (hmrRefreshTimestamp) url = appendQueryParam(url, "t", hmrRefreshTimestamp);\n    if (!embedInStudio && !hmrRefreshTimestamp) url = appendReleaseModuleVersion(url);\n    url = appendDependencyPinningVersion(url, moduleData);\n    return url;\n  }\n  function setStudioEmbed(value) {\n    studioEmbed = value;\n    window.__veryfrontStudioEmbed = value;\n  }\n  function setHMRRefreshTimestamp(timestamp) {\n    hmrRefreshTimestamp = timestamp;\n    window.__veryfrontHMRRefreshTimestamp = timestamp;\n  }\n  async function loadComponent(path, moduleData, options = {}) {\n    if (!path) return null;\n    const cacheKey = componentCacheKey(path, moduleData);\n    if (componentCache.has(cacheKey)) {\n      log("Component cached:", path);\n      return componentCache.get(cacheKey);\n    }\n    const existingPromise = loadingPromises.get(cacheKey);\n    if (existingPromise) return existingPromise;\n    const loadPromise = (async () => {\n      try {\n        const moduleUrl = pathToModuleUrl(path, studioEmbed, moduleData);\n        const start = DEBUG ? performance.now() : 0;\n        log("Loading component:", moduleUrl);\n        const module = await deps.snapshotModules.importSnapshotBoundModule(\n          moduleUrl,\n          options.allowDocumentReload !== false\n        );\n        const component = module.MDXLayout || module.MainLayout || module.default || module;\n        if (DEBUG) {\n          const duration = performance.now() - start;\n          console.log(\n            "[Veryfront Perf] %cimport:" + path.split("/").pop() + ": %c" + duration.toFixed(2) + "ms",\n            "color: #888",\n            duration > 50 ? "color: #f00; font-weight: bold" : "color: #0a0"\n          );\n        }\n        componentCache.set(cacheKey, component);\n        return component;\n      } catch (error) {\n        if (isDependencySnapshotConflict(error)) throw error;\n        logError("Failed to load component:", path, error);\n        return null;\n      } finally {\n        loadingPromises.delete(cacheKey);\n      }\n    })();\n    loadingPromises.set(cacheKey, loadPromise);\n    return loadPromise;\n  }\n  return {\n    loadComponent,\n    pathToModuleUrl,\n    clearComponentCache,\n    setStudioEmbed,\n    setReleaseId,\n    setReleaseAssetModules,\n    setHMRRefreshTimestamp\n  };\n}\n\n// src/html/hydration-script-builder/runtime/route-timing.ts\nvar MAX_ROUTE_TIMINGS = 100;\nvar MAX_SERVER_TIMING_LENGTH = 1024;\nfunction routeTimingNow() {\n  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();\n}\nfunction sanitizeServerTimingMetricName(name) {\n  return String(name || "").trim().replace(/[^A-Za-z0-9_.-]/g, "_").slice(0, 128);\n}\nfunction sanitizeServerTimingHeader(value) {\n  if (!value) return null;\n  const metrics = [];\n  const printable = String(value).replace(/[^\\x20-\\x7E]/g, " ").trim();\n  if (!printable) return null;\n  for (const item of printable.split(",")) {\n    const segments = item.split(";").map((segment) => segment.trim()).filter(Boolean);\n    const name = sanitizeServerTimingMetricName(segments[0]);\n    if (!name) continue;\n    for (const segment of segments.slice(1)) {\n      const [key, rawValue = ""] = segment.split("=");\n      if ((key ?? "").trim().toLowerCase() !== "dur") continue;\n      const duration = Number(rawValue.trim().replace(/^"|"$/g, ""));\n      if (!Number.isFinite(duration) || duration < 0) continue;\n      metrics.push(name + ";dur=" + (Math.round(duration * 100) / 100).toFixed(2));\n      break;\n    }\n  }\n  const sanitized = metrics.join(", ");\n  return sanitized ? sanitized.slice(0, MAX_SERVER_TIMING_LENGTH) : null;\n}\nfunction parseServerTimingMetrics(value) {\n  const header = sanitizeServerTimingHeader(value);\n  if (!header) return null;\n  const metrics = {};\n  for (const item of header.split(",")) {\n    const segments = item.split(";").map((segment) => segment.trim()).filter(Boolean);\n    const name = sanitizeServerTimingMetricName(segments[0]);\n    if (!name) continue;\n    for (const segment of segments.slice(1)) {\n      const [key, rawValue = ""] = segment.split("=");\n      if ((key ?? "").trim().toLowerCase() !== "dur") continue;\n      const duration = Number(rawValue.trim().replace(/^"|"$/g, ""));\n      if (Number.isFinite(duration) && duration >= 0) {\n        metrics[name] = Math.round(duration * 100) / 100;\n      }\n    }\n  }\n  return Object.keys(metrics).length ? metrics : null;\n}\nfunction readResponseServerTiming(response) {\n  try {\n    return sanitizeServerTimingHeader(response.headers?.get("server-timing"));\n  } catch (_) {\n    return null;\n  }\n}\nfunction roundRouteTimingValue(value) {\n  return Math.round(value * 100) / 100;\n}\nfunction extractResourceTiming(entry) {\n  const fields = [\n    "startTime",\n    "requestStart",\n    "responseStart",\n    "responseEnd",\n    "duration",\n    "transferSize",\n    "encodedBodySize",\n    "decodedBodySize"\n  ];\n  const timing = {};\n  for (const field of fields) {\n    const value = entry?.[field];\n    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {\n      timing[field] = roundRouteTimingValue(value);\n    }\n  }\n  return Object.keys(timing).length ? timing : null;\n}\nfunction createRouteTimingRecorder(window, logging2) {\n  const { log } = logging2;\n  function emitRouteTiming(phase, path, startedAt, detail = {}) {\n    const entry = {\n      phase,\n      path,\n      duration: Math.max(0, routeTimingNow() - startedAt),\n      timestamp: Date.now(),\n      ...detail\n    };\n    const timings = Array.isArray(window.__veryfrontRouteTimings) ? window.__veryfrontRouteTimings : [];\n    timings.push(entry);\n    if (timings.length > MAX_ROUTE_TIMINGS) {\n      timings.splice(0, timings.length - MAX_ROUTE_TIMINGS);\n    }\n    window.__veryfrontRouteTimings = timings;\n    try {\n      window.dispatchEvent(new CustomEvent("veryfront:route-timing", { detail: entry }));\n    } catch (_) {\n    }\n    log("Route timing:", entry);\n    return entry;\n  }\n  function getPageDataResourceTiming(endpoint, fetchStartedAt) {\n    try {\n      if (typeof performance === "undefined" || typeof performance.getEntriesByName !== "function") {\n        return null;\n      }\n      const href = new URL(endpoint, window.location.href).href;\n      const entries = performance.getEntriesByName(href, "resource");\n      if (!entries.length) return null;\n      for (let index = entries.length - 1; index >= 0; index--) {\n        const entry = entries[index];\n        const responseEnd = entry?.responseEnd;\n        if (typeof responseEnd === "number" && Number.isFinite(responseEnd) && responseEnd + 1 >= fetchStartedAt) {\n          return extractResourceTiming(entry);\n        }\n      }\n      return null;\n    } catch (_) {\n      return null;\n    }\n  }\n  function buildPageDataTimingDetail(response, endpoint, fetchStartedAt, source) {\n    const detail = { source, status: response.status };\n    const serverTiming = readResponseServerTiming(response);\n    if (serverTiming) {\n      detail.serverTiming = serverTiming;\n      const serverTimingMetrics = parseServerTimingMetrics(serverTiming);\n      if (serverTimingMetrics) detail.serverTimingMetrics = serverTimingMetrics;\n    }\n    const resourceTiming = getPageDataResourceTiming(response.url || endpoint, fetchStartedAt);\n    if (resourceTiming) detail.resourceTiming = resourceTiming;\n    return detail;\n  }\n  return { emitRouteTiming, buildPageDataTimingDetail };\n}\n\n// src/html/managed-head-protocol.ts\nvar HEAD_PROVENANCE_ATTRIBUTE = "data-vf-head";\nvar HEAD_LEGACY_MANAGED_ATTRIBUTE = "data-veryfront-managed";\nvar HEAD_CONTENT_HASH_ATTRIBUTE = "data-vf-hash";\nvar HEAD_REACT_MANAGED_ATTRIBUTE = "data-vf-react-head";\nvar HEAD_REACT_OWNER_ATTRIBUTE = "data-vf-react-head-owner";\nvar HEAD_ROUTE_MANAGED_ATTRIBUTE = "data-vf-route-head";\nvar HEAD_SERVER_COMMIT_ATTRIBUTE = "data-vf-server-head-commit";\nvar HEAD_SHELL_PROVENANCE_ATTRIBUTE = "data-vf-shell-head";\nvar HEAD_SSR_PAYLOAD_ATTRIBUTE = "data-vf-ssr-head";\nvar MAX_MANAGED_HEAD_BYTES = 2 * 1024 * 1024;\nvar MAX_MANAGED_HEAD_PAYLOAD_BYTES = MAX_MANAGED_HEAD_BYTES * 2;\nvar SINGLETON_META_KEYS = /* @__PURE__ */ new Set([\n  "description",\n  "robots",\n  "viewport",\n  "referrer",\n  "color-scheme",\n  "application-name",\n  "generator",\n  "og:title",\n  "og:description",\n  "og:url",\n  "og:type",\n  "og:site_name",\n  "og:locale",\n  "twitter:card",\n  "twitter:site",\n  "twitter:creator",\n  "twitter:title",\n  "twitter:description",\n  "twitter:image",\n  "twitter:image:alt"\n]);\nvar SINGLETON_LINK_RELS = /* @__PURE__ */ new Set([\n  "canonical",\n  "manifest",\n  "amphtml"\n]);\nvar MAX_HEAD_ATTRIBUTE_VALUE_BYTES = 64 * 1024;\nvar MAX_HEAD_ATTRIBUTE_BYTES = 1024 * 1024;\nvar MAX_HEAD_CONTENT_BYTES = 1024 * 1024;\nvar headTextEncoder = new TextEncoder();\nvar BOOLEAN_HEAD_ATTRIBUTES = /* @__PURE__ */ new Set([\n  "async",\n  "defer",\n  "disabled",\n  "itemscope",\n  "nomodule"\n]);\nfunction isHeadFrameworkAttribute(name) {\n  switch (name.toLowerCase()) {\n    case HEAD_PROVENANCE_ATTRIBUTE:\n    case HEAD_LEGACY_MANAGED_ATTRIBUTE:\n    case HEAD_CONTENT_HASH_ATTRIBUTE:\n    case HEAD_REACT_MANAGED_ATTRIBUTE:\n    case HEAD_REACT_OWNER_ATTRIBUTE:\n    case HEAD_ROUTE_MANAGED_ATTRIBUTE:\n    case HEAD_SERVER_COMMIT_ATTRIBUTE:\n    case HEAD_SHELL_PROVENANCE_ATTRIBUTE:\n    case HEAD_SSR_PAYLOAD_ATTRIBUTE:\n      return true;\n    default:\n      return false;\n  }\n}\nfunction normalizeHeadIdentityValue(value) {\n  const normalized = value?.trim().toLowerCase();\n  return normalized || void 0;\n}\nfunction readOwnString(record, key) {\n  try {\n    const descriptor = Reflect.getOwnPropertyDescriptor(record, key);\n    return descriptor && !descriptor.get && !descriptor.set && "value" in descriptor && typeof descriptor.value === "string" ? descriptor.value : void 0;\n  } catch {\n    return void 0;\n  }\n}\nfunction headMetaSingletonKeyFromRecord(meta) {\n  if (readOwnString(meta, "charset") !== void 0) return "meta:charset";\n  const key = normalizeHeadIdentityValue(\n    readOwnString(meta, "property") ?? readOwnString(meta, "name")\n  );\n  if (!key) return void 0;\n  if (key === "theme-color") {\n    return `meta:theme-color:${readOwnString(meta, "media")?.trim() ?? ""}`;\n  }\n  return SINGLETON_META_KEYS.has(key) ? `meta:${key}` : void 0;\n}\nfunction headLinkSingletonKeyFromRecord(link) {\n  const rel = normalizeHeadIdentityValue(readOwnString(link, "rel"));\n  return rel && SINGLETON_LINK_RELS.has(rel) ? `link:${rel}` : void 0;\n}\n\n// src/html/client-head-manager.ts\nvar HEAD_MANAGER_STATE_SYMBOL = /* @__PURE__ */ Symbol.for(\n  "veryfront.client-head-manager.v2"\n);\nvar CROSS_PAGE_PRESERVED_SINGLETON_KEYS = /* @__PURE__ */ new Set([\n  "meta:viewport",\n  "link:manifest"\n]);\nfunction getClientHeadManagerState() {\n  const globalState = globalThis;\n  return globalState[HEAD_MANAGER_STATE_SYMBOL] ?? (globalState[HEAD_MANAGER_STATE_SYMBOL] = {\n    documents: /* @__PURE__ */ new WeakMap()\n  });\n}\nfunction readElementAttributes(element) {\n  const attributes = [];\n  for (const attribute of element.attributes) {\n    const name = attribute.name.toLowerCase();\n    if (isHeadFrameworkAttribute(name)) continue;\n    const nonce = name === "nonce" && "nonce" in element ? element.nonce : "";\n    const value = BOOLEAN_HEAD_ATTRIBUTES.has(name) ? "" : nonce || attribute.value;\n    attributes.push([name, value]);\n  }\n  return attributes.sort(([left], [right]) => left.localeCompare(right));\n}\nfunction elementSingletonKey(element) {\n  const tagName = element.tagName.toLowerCase();\n  if (tagName === "title") return "title";\n  const attributes = Object.fromEntries(readElementAttributes(element));\n  if (tagName === "meta") return headMetaSingletonKeyFromRecord(attributes);\n  if (tagName === "link") return headLinkSingletonKeyFromRecord(attributes);\n  return void 0;\n}\nfunction promoteToShellHeadBaseline(element) {\n  for (const attribute of [...element.attributes]) {\n    if (isHeadFrameworkAttribute(attribute.name)) {\n      element.removeAttribute(attribute.name);\n    }\n  }\n  element.setAttribute(HEAD_SHELL_PROVENANCE_ATTRIBUTE, "true");\n}\nfunction isCrossPagePreservedSingleton(element, singletonKey = elementSingletonKey(element)) {\n  return element.parentElement !== null && singletonKey !== void 0 && CROSS_PAGE_PRESERVED_SINGLETON_KEYS.has(singletonKey);\n}\nfunction isFrameworkOwnedHeadElement(element) {\n  return element.getAttribute(HEAD_PROVENANCE_ATTRIBUTE) === "true" || element.getAttribute(HEAD_REACT_MANAGED_ATTRIBUTE) === "true" || element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1" || element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true" || element.getAttribute(HEAD_SHELL_PROVENANCE_ATTRIBUTE) === "true";\n}\nfunction retireFrameworkHeadElement(element) {\n  if (isCrossPagePreservedSingleton(element)) {\n    promoteToShellHeadBaseline(element);\n    return;\n  }\n  element.remove();\n}\nfunction retireClientHeadOwnership(targetDocument) {\n  const manager = getClientHeadManagerState().documents.get(targetDocument);\n  if (manager) {\n    manager.retire();\n    return;\n  }\n  for (const element of [...targetDocument.head?.children ?? []]) {\n    if (isFrameworkOwnedHeadElement(element)) retireFrameworkHeadElement(element);\n  }\n}\n\n// src/html/client-route-head.ts\nfunction updateRouteTitle(title, targetDocument = document) {\n  if (typeof title !== "string" || !title) return;\n  const titles = [...targetDocument.head.querySelectorAll("title")];\n  if (titles.some((element) => element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1")) {\n    return;\n  }\n  let titleElement = titles.find(\n    (element) => element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true"\n  );\n  for (const element of titles) {\n    if (element !== titleElement) element.remove();\n  }\n  if (!titleElement) {\n    titleElement = targetDocument.createElement("title");\n    titleElement.setAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE, "true");\n    targetDocument.head.appendChild(titleElement);\n  }\n  titleElement.textContent = title;\n}\nfunction updateRouteMetaTag(targetDocument, selector, attributeName, attributeValue, content) {\n  const matches = [...targetDocument.head.querySelectorAll(selector)];\n  if (matches.some((element) => element.getAttribute(HEAD_LEGACY_MANAGED_ATTRIBUTE) === "1")) {\n    return;\n  }\n  let metaTag = matches.find(\n    (element) => element.getAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE) === "true"\n  );\n  if (!metaTag) {\n    metaTag = targetDocument.createElement("meta");\n    metaTag.setAttribute(attributeName, attributeValue);\n    metaTag.setAttribute(HEAD_ROUTE_MANAGED_ATTRIBUTE, "true");\n    targetDocument.head.appendChild(metaTag);\n  }\n  metaTag.setAttribute("content", content);\n}\nfunction updateRouteMetaTags(metadata, targetDocument = document) {\n  if (typeof metadata.description === "string" && metadata.description) {\n    updateRouteMetaTag(\n      targetDocument,\n      \'meta[name="description"]\',\n      "name",\n      "description",\n      metadata.description\n    );\n  }\n  if (typeof metadata.ogTitle === "string" && metadata.ogTitle) {\n    updateRouteMetaTag(\n      targetDocument,\n      \'meta[property="og:title"]\',\n      "property",\n      "og:title",\n      metadata.ogTitle\n    );\n  }\n}\nfunction handoffClientRouteMetadata(metadata, targetDocument = document) {\n  const retainedTitle = targetDocument.title;\n  retireClientHeadOwnership(targetDocument);\n  updateRouteTitle(\n    typeof metadata.title === "string" && metadata.title ? metadata.title : retainedTitle,\n    targetDocument\n  );\n  updateRouteMetaTags(metadata, targetDocument);\n}\n\n// src/html/hydration-script-builder/runtime/router.ts\nvar FETCH_TIMEOUT_MS = 1e4;\nvar MAX_RETRIES = 2;\nvar MAX_CACHE_SIZE = 50;\nvar CACHE_TTL_MS = 5 * 60 * 1e3;\nvar BACKGROUND_REFRESH_INTERVAL_MS = 30 * 1e3;\nvar PREFETCH_DELAY_MS = 100;\nvar MAX_PREFETCH_PATHS = 100;\nvar IDLE_PREFETCH_DELAY_MS = 1200;\nvar IDLE_PREFETCH_MAX_LINKS = 4;\nvar VIEWPORT_PREFETCH_MAX_LINKS = 8;\nvar PAGE_DATA_PREFETCH_CONCURRENCY = 2;\nvar VIEWPORT_PREFETCH_ROOT_MARGIN = "200px";\nvar MAX_SCROLL_POSITIONS = 100;\nfunction createRouterRuntime(deps) {\n  const { env: env2, logging: logging2, routeTiming: routeTiming2, componentLoader: componentLoader2, snapshotModules: snapshotModules2 } = deps;\n  const { window, document: document2, React: React2, RouterProvider: RouterProvider2, PageContextProvider: PageContextProvider2 } = env2;\n  const { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = env2;\n  const { log, logError, logBackgroundFetchFailure, perfStart, perfEnd } = logging2;\n  const { emitRouteTiming, buildPageDataTimingDetail } = routeTiming2;\n  const { loadComponent } = componentLoader2;\n  const documentPinKey = deps.documentDependencyPinningCacheKey;\n  let hydrationResolve;\n  let hydrationReject;\n  const hydrationPromise = new Promise((resolve, reject) => {\n    hydrationResolve = resolve;\n    hydrationReject = reject;\n  });\n  let hydrationCompleted = false;\n  let hydrationFailed = false;\n  function signalHydrationComplete() {\n    hydrationCompleted = true;\n    hydrationResolve();\n    log("Hydration complete signal received");\n  }\n  function signalHydrationFailed(error) {\n    hydrationFailed = true;\n    hydrationReject(error);\n    logError("Hydration failed signal received:", error);\n  }\n  window.__veryfrontHydrationComplete = signalHydrationComplete;\n  window.__veryfrontHydrationFailed = signalHydrationFailed;\n  function pageDataCacheIdentity2(path) {\n    return pageDataCacheIdentity(path, documentPinKey);\n  }\n  function navigateDocument(target) {\n    const safeUrl = resolveDocumentNavigationUrl(target, window.location.origin);\n    if (safeUrl) {\n      window.location.href = safeUrl;\n      return;\n    }\n    logError("Refusing an unsafe document navigation:", target);\n    window.location.reload();\n  }\n  let clientBuildVersion = null;\n  function checkVersionMismatch(newVersion) {\n    if (!clientBuildVersion) {\n      clientBuildVersion = newVersion;\n      log("Build version initialized:", newVersion);\n      return false;\n    }\n    if (newVersion.serverStart !== clientBuildVersion.serverStart) {\n      log("Server restarted, reloading...", {\n        old: clientBuildVersion.serverStart,\n        new: newVersion.serverStart\n      });\n      return true;\n    }\n    if (newVersion.framework !== clientBuildVersion.framework) {\n      log("Framework version changed, reloading...", {\n        old: clientBuildVersion.framework,\n        new: newVersion.framework\n      });\n      return true;\n    }\n    if (newVersion.projectUpdated && clientBuildVersion.projectUpdated && newVersion.projectUpdated !== clientBuildVersion.projectUpdated) {\n      log("Project content updated, reloading...", {\n        old: clientBuildVersion.projectUpdated,\n        new: newVersion.projectUpdated\n      });\n      return true;\n    }\n    return false;\n  }\n  const pageDataCache = /* @__PURE__ */ new Map();\n  const pendingPageDataFetches = /* @__PURE__ */ new Map();\n  const backgroundRefreshTimestamps = /* @__PURE__ */ new Map();\n  function getCachedPageData(path) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const entry = pageDataCache.get(cacheIdentity);\n    if (!entry) return null;\n    if (Date.now() - entry.timestamp < CACHE_TTL_MS) return entry.data;\n    pageDataCache.delete(cacheIdentity);\n    backgroundRefreshTimestamps.delete(cacheIdentity);\n    return null;\n  }\n  function setCachedPageData(path, data) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    if (pageDataCache.size >= MAX_CACHE_SIZE) {\n      const oldest = pageDataCache.keys().next().value;\n      if (oldest) {\n        pageDataCache.delete(oldest);\n        backgroundRefreshTimestamps.delete(oldest);\n      }\n    }\n    pageDataCache.set(cacheIdentity, { data, timestamp: Date.now() });\n  }\n  const scrollPositions = /* @__PURE__ */ new Map();\n  function saveScrollPosition(path) {\n    if (scrollPositions.size >= MAX_SCROLL_POSITIONS) {\n      const oldest = scrollPositions.keys().next().value;\n      if (oldest) scrollPositions.delete(oldest);\n    }\n    scrollPositions.set(path, window.scrollY);\n  }\n  function restoreScrollPosition(path) {\n    const savedY = scrollPositions.get(path);\n    if (savedY === void 0) return false;\n    requestAnimationFrame(() => window.scrollTo(0, savedY));\n    return true;\n  }\n  let progressBar = null;\n  let progressTimeout = null;\n  function showNavigationProgress() {\n    if (!progressBar) {\n      progressBar = document2.createElement("div");\n      progressBar.id = "vf-nav-progress";\n      progressBar.style.cssText = "position:fixed;top:0;left:0;height:3px;width:0;background:linear-gradient(90deg,#0066ff,#00aaff);z-index:99999;transition:width 0.3s ease-out,opacity 0.2s;opacity:1;";\n      document2.body.prepend(progressBar);\n    }\n    progressBar.style.opacity = "1";\n    progressBar.style.width = "30%";\n    progressTimeout = setTimeout2(() => {\n      if (progressBar?.style) progressBar.style.width = "70%";\n    }, 300);\n    document2.body.setAttribute("aria-busy", "true");\n  }\n  function hideNavigationProgress() {\n    if (progressTimeout) {\n      clearTimeout2(progressTimeout);\n      progressTimeout = null;\n    }\n    if (progressBar) {\n      progressBar.style.width = "100%";\n      setTimeout2(() => {\n        if (!progressBar) return;\n        progressBar.style.opacity = "0";\n        setTimeout2(() => {\n          if (progressBar) progressBar.style.width = "0";\n        }, 200);\n      }, 150);\n    }\n    document2.body.removeAttribute("aria-busy");\n  }\n  let currentAbortController = null;\n  function sleep(ms) {\n    return new Promise((resolve) => setTimeout2(resolve, ms));\n  }\n  async function fetchWithRetry(url, options, maxRetries = MAX_RETRIES) {\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      const controller = new AbortController();\n      const callerSignal = options.signal;\n      const abortFromCaller = () => controller.abort();\n      if (callerSignal?.aborted) controller.abort();\n      callerSignal?.addEventListener("abort", abortFromCaller, { once: true });\n      const timeout = setTimeout2(() => controller.abort(), FETCH_TIMEOUT_MS);\n      try {\n        const response = await env2.fetch(url, { ...options, signal: controller.signal });\n        clearTimeout2(timeout);\n        callerSignal?.removeEventListener("abort", abortFromCaller);\n        if (response.ok) return response;\n        if (response.status >= 500 && attempt < maxRetries) {\n          log("Server error, retrying...", response.status);\n          await sleep(Math.pow(2, attempt) * 500);\n          continue;\n        }\n        return response;\n      } catch (error) {\n        clearTimeout2(timeout);\n        callerSignal?.removeEventListener("abort", abortFromCaller);\n        if (error.name === "AbortError" && callerSignal?.aborted) throw error;\n        if (attempt === maxRetries) throw error;\n        log("Fetch failed, retrying...", error.message);\n        await sleep(Math.pow(2, attempt) * 500);\n      }\n    }\n    throw new Error("Failed to fetch page data");\n  }\n  async function fetchPageDataFresh(path, signal, options = {}) {\n    const {\n      triggerReloadOnVersionMismatch = false,\n      recordRouteTiming = false,\n      timingSource = "network"\n    } = options;\n    const endpoint = buildPageDataEndpoint(path, window.location.origin);\n    const startedAt = recordRouteTiming ? routeTimingNow() : 0;\n    log("Fetching page data:", path);\n    perfStart("fetch:" + path);\n    const headers = options.prefetch ? { "X-Veryfront-Prefetch": "1" } : { "X-Veryfront-Navigation": "spa" };\n    if (documentPinKey) {\n      headers["X-Veryfront-Dependency-Pins"] = documentPinKey;\n    }\n    const response = await fetchWithRetry(endpoint, {\n      headers,\n      signal\n    }, options.prefetch ? 0 : MAX_RETRIES);\n    if (!response.ok) {\n      perfEnd("fetch:" + path);\n      if (recordRouteTiming) {\n        emitRouteTiming(\n          "page-data",\n          path,\n          startedAt,\n          buildPageDataTimingDetail(response, endpoint, startedAt, timingSource)\n        );\n      }\n      const error = new Error("Failed to fetch page data: " + response.status);\n      error.status = response.status;\n      throw error;\n    }\n    perfStart("parse:" + path);\n    const data = assertPageDataMatchesDocumentSnapshot(\n      path,\n      await response.json(),\n      documentPinKey\n    );\n    perfEnd("parse:" + path);\n    perfEnd("fetch:" + path);\n    if (recordRouteTiming) {\n      emitRouteTiming(\n        "page-data",\n        path,\n        startedAt,\n        buildPageDataTimingDetail(response, endpoint, startedAt, timingSource)\n      );\n    }\n    if (triggerReloadOnVersionMismatch) {\n      const checkedData = handlePageDataVersionMismatch(path, data);\n      if (checkedData !== data) return checkedData;\n    }\n    setCachedPageData(path, data);\n    return data;\n  }\n  function handlePageDataVersionMismatch(path, data) {\n    if (data.buildVersion && checkVersionMismatch(data.buildVersion)) {\n      log("Version mismatch detected, performing full page reload to:", path);\n      navigateDocument(path);\n      return new Promise(() => {\n      });\n    }\n    return data;\n  }\n  function startPageDataFetch(path, signal, options = {}) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const request = fetchPageDataFresh(path, signal, options).finally(() => {\n      if (options.trackPending !== false && pendingPageDataFetches.get(cacheIdentity) === request) {\n        pendingPageDataFetches.delete(cacheIdentity);\n      }\n    });\n    if (options.trackPending !== false) {\n      pendingPageDataFetches.set(cacheIdentity, request);\n    }\n    return request;\n  }\n  function fetchPageDataDeduped(path) {\n    const pending = pendingPageDataFetches.get(pageDataCacheIdentity2(path));\n    if (pending) return pending;\n    return startPageDataFetch(path, null);\n  }\n  function refreshPageDataInBackground(path) {\n    const cacheIdentity = pageDataCacheIdentity2(path);\n    const lastRefreshAt = backgroundRefreshTimestamps.get(cacheIdentity) || 0;\n    const now = Date.now();\n    if (now - lastRefreshAt < BACKGROUND_REFRESH_INTERVAL_MS) return;\n    backgroundRefreshTimestamps.set(cacheIdentity, now);\n    fetchPageDataDeduped(path).catch((error) => {\n      logBackgroundFetchFailure("Stale page data refresh", path, error);\n    });\n  }\n  async function fetchPageDataForNavigation(path, signal) {\n    const startedAt = routeTimingNow();\n    const cached = getCachedPageData(path);\n    if (cached) {\n      log("Using cached page data:", path);\n      refreshPageDataInBackground(path);\n      emitRouteTiming("page-data", path, startedAt, { source: "cache" });\n      return cached;\n    }\n    const pending = pendingPageDataFetches.get(pageDataCacheIdentity2(path));\n    if (pending) {\n      log("Reusing pending page data fetch for navigation:", path);\n      const data = await pending;\n      emitRouteTiming("page-data", path, startedAt, { source: "deduped" });\n      return handlePageDataVersionMismatch(path, data);\n    }\n    return startPageDataFetch(path, signal, {\n      triggerReloadOnVersionMismatch: true,\n      recordRouteTiming: true,\n      timingSource: "network"\n    });\n  }\n  function fetchPageDataForPrefetch(path, signal) {\n    if (getCachedPageData(path)) return Promise.resolve();\n    return startPageDataFetch(path, signal, { prefetch: true, trackPending: false }).then((data) => preloadModulesForPageData(data, path)).catch((error) => {\n      if (!isAbortError(error)) {\n        logBackgroundFetchFailure("Page data prefetch", path, error);\n      }\n      throw error;\n    });\n  }\n  let currentPath = window.location.pathname;\n  let isNavigating = false;\n  async function navigateSPA(href, historyMode = "push", restoreScroll = false) {\n    currentAbortController?.abort();\n    if (isNavigating) return;\n    isNavigating = true;\n    const [navigationPath] = href.split("#");\n    removeQueuedPrefetch(navigationPath || href);\n    abortActiveSpeculativePrefetches();\n    currentAbortController = new AbortController();\n    const signal = currentAbortController.signal;\n    const navigationStartedAt = routeTimingNow();\n    showNavigationProgress();\n    perfStart("nav:total:" + href);\n    try {\n      log("SPA navigating to:", href);\n      saveScrollPosition(currentPath);\n      const [path, hash] = href.split("#");\n      const targetPath = path || currentPath;\n      perfStart("nav:fetchData:" + href);\n      const pageData = await fetchPageDataForNavigation(targetPath, signal);\n      perfEnd("nav:fetchData:" + href);\n      if (signal.aborted) return;\n      if (pageData && pageData.redirect && typeof pageData.redirect.destination === "string") {\n        const redirectUrl = resolveDocumentNavigationUrl(\n          pageData.redirect.destination,\n          window.location.origin\n        );\n        if (redirectUrl) {\n          log("SPA navigation redirect -> " + redirectUrl);\n          window.location.href = redirectUrl;\n          return;\n        }\n      }\n      if (historyMode === "push") {\n        window.history.pushState({ pageData, scrollY: 0 }, "", href);\n      } else if (historyMode === "replace") {\n        window.history.replaceState({ pageData, scrollY: 0 }, "", href);\n      }\n      currentPath = targetPath;\n      router.pathname = targetPath;\n      router.query = Object.fromEntries(new URLSearchParams(window.location.search));\n      router.params = flattenRouteParams(pageData.params);\n      perfStart("nav:render:" + href);\n      await renderPageFromData(pageData, targetPath);\n      perfEnd("nav:render:" + href);\n      if (restoreScroll) {\n        restoreScrollPosition(targetPath);\n      } else if (hash) {\n        requestAnimationFrame(() => {\n          const target = document2.getElementById(hash);\n          if (target) {\n            target.scrollIntoView({ behavior: "smooth" });\n            return;\n          }\n          window.scrollTo(0, 0);\n        });\n      } else {\n        window.scrollTo(0, 0);\n      }\n      hideNavigationProgress();\n      perfEnd("nav:total:" + href);\n      emitRouteTiming("total", targetPath, navigationStartedAt, {\n        href,\n        historyMode,\n        restoreScroll\n      });\n      log("SPA navigation complete");\n    } catch (error) {\n      hideNavigationProgress();\n      if (error.name === "AbortError") {\n        log("Navigation aborted");\n        return;\n      }\n      logError("SPA navigation failed:", error.message);\n      if (error.status === 404) {\n        logError("Page not found:", href);\n      }\n      navigateDocument(href);\n    } finally {\n      isNavigating = false;\n      currentAbortController = null;\n      processPageDataPrefetchQueue();\n    }\n  }\n  async function loadPageDataComponent(pageData, path, options = {}) {\n    if (!pageData.isolatedClientPage) return loadComponent(path, pageData, options);\n    const moduleUrl = buildPinnedRscModuleUrl(path, pageData);\n    const module = await snapshotModules2.importSnapshotBoundModule(\n      moduleUrl,\n      options.allowDocumentReload !== false\n    );\n    return module.MDXLayout || module.MainLayout || module.default || module;\n  }\n  async function renderPageFromData(pageData, targetPath) {\n    if (pageData.requiresFullDocumentNavigation) {\n      throw new Error("Server layout requires full document navigation");\n    }\n    if (window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(pageData.releaseId || null);\n    }\n    if (window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(pageData.releaseAssetModules || null);\n    }\n    perfStart("render:loadAll");\n    const allPaths = getPageDataModulePaths(pageData);\n    const modulesStartedAt = routeTimingNow();\n    const components = await Promise.all(\n      allPaths.map((path) => loadPageDataComponent(pageData, path))\n    );\n    emitRouteTiming("modules", targetPath, modulesStartedAt, { count: allPaths.length });\n    perfEnd("render:loadAll");\n    const [PageComponent, ...rest] = components;\n    const ErrorComponent = pageData.errorPath ? rest.pop() : null;\n    const AppComponent = pageData.appPath ? rest.pop() : null;\n    const LayoutComponents = rest;\n    if (!PageComponent) {\n      throw new Error("Failed to load page component: " + pageData.pagePath);\n    }\n    handoffClientRouteMetadata(\n      pageData.frontmatter ?? {},\n      document2\n    );\n    if (pageData.css) {\n      const existingStyle = document2.getElementById("veryfront-spa-css");\n      if (existingStyle) {\n        existingStyle.textContent = pageData.css;\n      } else {\n        const styleEl = document2.createElement("style");\n        const nonce = getDocumentNonce(document2);\n        if (nonce) styleEl.setAttribute("nonce", nonce);\n        styleEl.id = "veryfront-spa-css";\n        styleEl.textContent = pageData.css;\n        document2.head.appendChild(styleEl);\n      }\n      log("Injected CSS for SPA navigation", { cssLength: pageData.css.length });\n    } else if (pageData.cssAction === "clear") {\n      const existingStyle = document2.getElementById("veryfront-spa-css");\n      if (existingStyle) {\n        existingStyle.remove();\n        log("Cleared SPA CSS for release stylesheet navigation");\n      }\n    }\n    const normalizedParams = flattenRouteParams(pageData.params);\n    let tree = React2.createElement(PageComponent, {\n      ...pageData.props,\n      params: normalizedParams\n    });\n    if (pageData.layouts?.length) {\n      for (let i = pageData.layouts.length - 1; i >= 0; i--) {\n        const layout = pageData.layouts[i];\n        const LayoutComponent = LayoutComponents[i];\n        if (!LayoutComponent || !layout) continue;\n        const layoutProps = pageData.layoutProps?.[layout.path] || {};\n        tree = React2.createElement(LayoutComponent, { ...layoutProps, children: tree });\n      }\n    }\n    if (AppComponent) {\n      tree = React2.createElement(AppComponent, { children: tree });\n      log("Wrapped with App component for SPA navigation");\n    }\n    if (ErrorComponent) {\n      class AppRouterErrorBoundary extends React2.Component {\n        constructor(props) {\n          super(props);\n          this.state = { hasError: false, error: null };\n        }\n        static getDerivedStateFromError(error) {\n          return { hasError: true, error };\n        }\n        render() {\n          if (this.state.hasError) {\n            return React2.createElement(ErrorComponent, {\n              error: this.state.error,\n              reset: () => this.setState({ hasError: false, error: null })\n            });\n          }\n          return this.props.children;\n        }\n      }\n      tree = React2.createElement(AppRouterErrorBoundary, null, tree);\n    }\n    const headingsArray = pageData.headings || [];\n    const pageContext = {\n      slug: pageData.slug || "",\n      path: pageData.pagePath || targetPath,\n      params: normalizedParams,\n      query: Object.fromEntries(new URLSearchParams(window.location.search)),\n      frontmatter: pageData.frontmatter || {},\n      data: pageData.props || {},\n      headings: headingsArray,\n      mdxHeadings: headingsArray\n    };\n    tree = React2.createElement(PageContextProvider2, { pageContext, children: tree });\n    tree = React2.createElement(RouterProvider2, { router, children: tree });\n    const container = pageData.isolatedClientPage ? document2.getElementById("veryfront-page-island") : document2.getElementById("root");\n    if (!hydrationCompleted && !hydrationFailed) {\n      log("Waiting for hydration to complete before SPA render...");\n      try {\n        await Promise.race([\n          hydrationPromise,\n          new Promise(\n            (_, reject) => setTimeout2(() => reject(new Error("Hydration timeout")), 1e4)\n          )\n        ]);\n      } catch (waitError) {\n        log("Hydration wait failed:", waitError.message);\n      }\n    }\n    if (container?.__reactRoot) {\n      perfStart("render:reactRender");\n      container.__reactRoot.render(tree);\n      perfEnd("render:reactRender");\n      log("Page re-rendered via SPA");\n      scheduleRoutePrefetchRefresh();\n      return;\n    }\n    if (hydrationFailed) {\n      throw new Error(\n        "React root not found - hydration failed, falling back to full page navigation"\n      );\n    }\n    throw new Error("React root not found");\n  }\n  let prefetchTimeout = null;\n  let currentHoverLink = null;\n  let routePrefetchRefreshPending = false;\n  let viewportPrefetchObserver = null;\n  const observedPrefetchLinks = /* @__PURE__ */ new WeakSet();\n  const prefetchedPaths = /* @__PURE__ */ new Set();\n  const inFlightPrefetches = /* @__PURE__ */ new Set();\n  const queuedPrefetchPaths = /* @__PURE__ */ new Set();\n  const pageDataPrefetchQueue = [];\n  const activePageDataPrefetchControllers = /* @__PURE__ */ new Map();\n  function cancelScheduledPrefetch() {\n    if (prefetchTimeout) {\n      clearTimeout2(prefetchTimeout);\n      prefetchTimeout = null;\n    }\n    currentHoverLink = null;\n  }\n  function getPageDataModulePaths(pageData) {\n    const layoutPaths = (pageData.layouts || []).map((l) => l.path).filter(Boolean);\n    const allPaths = [pageData.pagePath, ...layoutPaths].filter(Boolean);\n    if (pageData.appPath) allPaths.push(pageData.appPath);\n    if (pageData.errorPath) allPaths.push(pageData.errorPath);\n    return allPaths;\n  }\n  function getCurrentRouteHref() {\n    return window.location.pathname + window.location.search;\n  }\n  function getInternalRouteHrefFromLink(link) {\n    if (!link || link.target === "_blank" || link.hasAttribute("download") || link.getAttribute("data-prefetch") === "false") {\n      return null;\n    }\n    const href = link.getAttribute("href");\n    if (!href || href.startsWith("#") || href.startsWith("//") || !href.startsWith("/")) {\n      return null;\n    }\n    try {\n      const url = new URL(href, window.location.origin);\n      if (url.origin !== window.location.origin) return null;\n      const routeHref = url.pathname + url.search;\n      return routeHref === getCurrentRouteHref() ? null : routeHref;\n    } catch (_) {\n      return null;\n    }\n  }\n  function getEligiblePrefetchLinks(limit) {\n    const links = [];\n    const seenHrefs = /* @__PURE__ */ new Set();\n    for (const link of document2.querySelectorAll("a[href]")) {\n      const href = getInternalRouteHrefFromLink(link);\n      if (!href || seenHrefs.has(href)) continue;\n      seenHrefs.add(href);\n      links.push({ link, href });\n      if (links.length >= limit) break;\n    }\n    return links;\n  }\n  async function preloadModulesForPageData(pageData, path) {\n    if (!pageData || pageData.requiresFullDocumentNavigation) return;\n    if (pageData.releaseId && window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(pageData.releaseId);\n    }\n    if (pageData.releaseAssetModules && window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(pageData.releaseAssetModules);\n    }\n    const modulePaths = getPageDataModulePaths(pageData);\n    if (modulePaths.length === 0) return;\n    try {\n      await Promise.all(\n        modulePaths.map(\n          (modulePath) => loadPageDataComponent(pageData, modulePath, { allowDocumentReload: false })\n        )\n      );\n    } catch (error) {\n      if (isDependencySnapshotConflict(error)) {\n        const cacheIdentity = pageDataCacheIdentity2(path);\n        pageDataCache.delete(cacheIdentity);\n        backgroundRefreshTimestamps.delete(cacheIdentity);\n        prefetchedPaths.delete(path);\n        throw error;\n      }\n      logBackgroundFetchFailure("Module prefetch", path, error);\n    }\n  }\n  function removeQueuedPrefetch(path) {\n    queuedPrefetchPaths.delete(path);\n    for (let i = pageDataPrefetchQueue.length - 1; i >= 0; i--) {\n      if (pageDataPrefetchQueue[i] === path) pageDataPrefetchQueue.splice(i, 1);\n    }\n  }\n  function abortActiveSpeculativePrefetches() {\n    for (const controller of activePageDataPrefetchControllers.values()) {\n      controller.abort();\n    }\n  }\n  function processPageDataPrefetchQueue() {\n    if (isNavigating) return;\n    while (activePageDataPrefetchControllers.size < PAGE_DATA_PREFETCH_CONCURRENCY && pageDataPrefetchQueue.length > 0) {\n      const href = pageDataPrefetchQueue.shift();\n      queuedPrefetchPaths.delete(href);\n      if (prefetchedPaths.has(href) || inFlightPrefetches.has(href) || getCachedPageData(href)) {\n        continue;\n      }\n      if (prefetchedPaths.size >= MAX_PREFETCH_PATHS) {\n        const oldest = prefetchedPaths.values().next().value;\n        if (oldest) prefetchedPaths.delete(oldest);\n      }\n      const controller = new AbortController();\n      prefetchedPaths.add(href);\n      inFlightPrefetches.add(href);\n      activePageDataPrefetchControllers.set(href, controller);\n      fetchPageDataForPrefetch(href, controller.signal).catch((error) => {\n        prefetchedPaths.delete(href);\n        if (isDependencySnapshotConflict(error)) {\n          logBackgroundFetchFailure("Module prefetch", href, error);\n        }\n      }).finally(() => {\n        inFlightPrefetches.delete(href);\n        activePageDataPrefetchControllers.delete(href);\n        processPageDataPrefetchQueue();\n      });\n    }\n  }\n  function prefetchPage(href) {\n    if (isNavigating) return;\n    if (prefetchedPaths.has(href) || inFlightPrefetches.has(href) || queuedPrefetchPaths.has(href)) return;\n    const cachedPageData = getCachedPageData(href);\n    if (cachedPageData) {\n      preloadModulesForPageData(cachedPageData, href).catch((error) => {\n        logBackgroundFetchFailure("Module prefetch", href, error);\n      });\n      return;\n    }\n    queuedPrefetchPaths.add(href);\n    pageDataPrefetchQueue.push(href);\n    processPageDataPrefetchQueue();\n  }\n  function prefetchEligibleRouteLinks(limit) {\n    for (const { href } of getEligiblePrefetchLinks(limit)) {\n      prefetchPage(href);\n    }\n  }\n  function ensureViewportPrefetchObserver() {\n    if (viewportPrefetchObserver || typeof IntersectionObserver !== "function") {\n      return viewportPrefetchObserver;\n    }\n    viewportPrefetchObserver = new IntersectionObserver((entries) => {\n      for (const entry of entries) {\n        if (!entry.isIntersecting) continue;\n        viewportPrefetchObserver?.unobserve(entry.target);\n        const href = getInternalRouteHrefFromLink(\n          entry.target\n        );\n        if (href) prefetchPage(href);\n      }\n    }, { rootMargin: VIEWPORT_PREFETCH_ROOT_MARGIN });\n    return viewportPrefetchObserver;\n  }\n  function observeViewportPrefetchLinks() {\n    const observer = ensureViewportPrefetchObserver();\n    if (!observer) return;\n    for (const { link } of getEligiblePrefetchLinks(VIEWPORT_PREFETCH_MAX_LINKS)) {\n      if (observedPrefetchLinks.has(link)) continue;\n      observedPrefetchLinks.add(link);\n      observer.observe(link);\n    }\n  }\n  function runRoutePrefetchRefresh() {\n    routePrefetchRefreshPending = false;\n    prefetchEligibleRouteLinks(IDLE_PREFETCH_MAX_LINKS);\n    observeViewportPrefetchLinks();\n  }\n  function scheduleRoutePrefetchRefresh() {\n    if (routePrefetchRefreshPending) return;\n    routePrefetchRefreshPending = true;\n    setTimeout2(() => {\n      if (typeof requestIdleCallback === "function") {\n        requestIdleCallback(runRoutePrefetchRefresh, { timeout: IDLE_PREFETCH_DELAY_MS });\n        return;\n      }\n      runRoutePrefetchRefresh();\n    }, IDLE_PREFETCH_DELAY_MS);\n  }\n  const router = {\n    domain: window.location.origin,\n    path: window.location.pathname,\n    push: (path) => {\n      void navigateSPA(path, "push");\n    },\n    replace: (path) => {\n      void navigateSPA(path, "replace");\n    },\n    back: () => {\n      window.history.back();\n    },\n    forward: () => {\n      window.history.forward();\n    },\n    prefetch: (path) => {\n      prefetchPage(path);\n    },\n    pathname: window.location.pathname,\n    query: Object.fromEntries(new URLSearchParams(window.location.search)),\n    // Seed route params from the hydration data (issue #2741). Catch-all\n    // segments arrive as arrays and are joined so no path info is lost.\n    params: flattenRouteParams(deps.initialHydrationData.params || {}),\n    isPreview: false,\n    isMounted: true,\n    navigate: (path) => navigateSPA(path, "push"),\n    reload: () => window.location.reload()\n  };\n  window.__veryfrontRouter = router;\n  if (deps.navigationStoreUsesRegistryFallback) {\n    log("Router runtime does not export getNavigationStore; using shared v1 registry fallback");\n  }\n  if (typeof deps.getNavigationStore === "function") {\n    deps.getNavigationStore().setNavigator((href, options) => {\n      const mode = options && options.history;\n      const historyMode = mode === "replace" ? "replace" : mode === "none" ? "none" : "push";\n      return navigateSPA(href, historyMode);\n    });\n  }\n  window.addEventListener("popstate", async (e) => {\n    const path = window.location.pathname;\n    log("Popstate:", path);\n    saveScrollPosition(currentPath);\n    if (!e.state?.pageData) {\n      await navigateSPA(path, "none", true);\n      return;\n    }\n    showNavigationProgress();\n    try {\n      currentPath = path;\n      router.pathname = path;\n      router.query = Object.fromEntries(new URLSearchParams(window.location.search));\n      router.params = flattenRouteParams(e.state.pageData.params);\n      await renderPageFromData(e.state.pageData, path);\n      restoreScrollPosition(path);\n      hideNavigationProgress();\n    } catch (error) {\n      hideNavigationProgress();\n      logError("Popstate render failed:", error.message);\n      window.location.reload();\n    }\n  });\n  document2.addEventListener("click", (e) => {\n    const link = e.target?.closest("a[href]");\n    if (!link) return;\n    const href = link.getAttribute("href");\n    if (!href) return;\n    if (href.startsWith("#")) {\n      const target = document2.getElementById(href.slice(1));\n      if (!target) return;\n      e.preventDefault();\n      target.scrollIntoView({ behavior: "smooth" });\n      window.history.pushState(null, "", href);\n      return;\n    }\n    if (link.target === "_blank" || link.hasAttribute("download") || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || !href.startsWith("/") || href.startsWith("//")) {\n      return;\n    }\n    e.preventDefault();\n    cancelScheduledPrefetch();\n    void navigateSPA(href, "push");\n  });\n  document2.addEventListener(\n    "mouseenter",\n    (e) => {\n      if (!e.target || typeof e.target.closest !== "function") return;\n      const link = e.target.closest("a[href]");\n      if (!link) return;\n      const href = getInternalRouteHrefFromLink(link);\n      if (!href) return;\n      if (currentHoverLink === link) return;\n      if (prefetchTimeout) {\n        clearTimeout2(prefetchTimeout);\n        prefetchTimeout = null;\n      }\n      currentHoverLink = link;\n      prefetchTimeout = setTimeout2(() => {\n        prefetchPage(href);\n        prefetchTimeout = null;\n      }, PREFETCH_DELAY_MS);\n    },\n    true\n  );\n  document2.addEventListener(\n    "mouseleave",\n    (e) => {\n      if (!e.target || typeof e.target.closest !== "function") return;\n      const relatedTarget = e.relatedTarget;\n      if (currentHoverLink && relatedTarget && currentHoverLink.contains(relatedTarget)) return;\n      cancelScheduledPrefetch();\n    },\n    true\n  );\n  if (document2.readyState === "loading") {\n    document2.addEventListener("DOMContentLoaded", scheduleRoutePrefetchRefresh, { once: true });\n  } else {\n    scheduleRoutePrefetchRefresh();\n  }\n  window.useRouter = () => {\n    try {\n      return env2.useRouterFromModule();\n    } catch (_) {\n      return window.__veryfrontRouter;\n    }\n  };\n  return {\n    router,\n    navigateSPA,\n    renderPageFromData,\n    prefetchPage,\n    signalHydrationComplete,\n    signalHydrationFailed\n  };\n}\n\n// src/html/hydration-script-builder/runtime/renderer.ts\nfunction isModuleNotFoundError(error) {\n  if (!error) return false;\n  if (error instanceof SyntaxError) return false;\n  const message = String(error.message || error);\n  return /(?:dynamically imported module|Importing a module script failed|Failed to load module script)/i.test(message);\n}\nfunction preferReachedModuleError(earlier, later) {\n  if (!earlier) return later;\n  if (!later) return earlier;\n  if (isModuleNotFoundError(earlier) && !isModuleNotFoundError(later)) return later;\n  return earlier;\n}\nasync function loadPageModuleWithIndexFallback(basePath, pageSlug, pageModuleError, importModule) {\n  try {\n    return await importModule(basePath + ".js");\n  } catch (error) {\n    const routeError = preferReachedModuleError(pageModuleError, error);\n    if (pageSlug === "index" || pageSlug.endsWith("/index")) throw routeError;\n    try {\n      return await importModule(basePath + "/index.js");\n    } catch (indexError) {\n      throw preferReachedModuleError(routeError, indexError);\n    }\n  }\n}\nfunction isAppRouterPath(path, appRouterRoot) {\n  const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n  return normalizedPath === appRouterRoot || normalizedPath.startsWith(appRouterRoot + "/");\n}\nfunction isRootAppLayoutPath(path, appRouterRoot) {\n  const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n  const pathWithoutExtension = normalizedPath.replace(/\\.(?:tsx|jsx|ts|js)$/, "");\n  return pathWithoutExtension === appRouterRoot + "/layout";\n}\nfunction unwrapAppRouterDocumentLayout(LayoutComponent, React2) {\n  return function AppRouterDocumentLayout(props) {\n    const element = LayoutComponent(props);\n    const asElement = element;\n    if (!React2.isValidElement(element) || asElement.type !== "html") {\n      return element;\n    }\n    const body = React2.Children.toArray(asElement.props?.children).find(\n      (child) => React2.isValidElement(child) && child.type === "body"\n    );\n    return body?.props?.children ?? props.children;\n  };\n}\nfunction createHydrationRenderer(deps) {\n  const { env: env2, logging: logging2, componentLoader: componentLoader2, snapshotModules: snapshotModules2, moduleServerUrl: moduleServerUrl2 } = deps;\n  const { window, document: document2, React: React2, RouterProvider: RouterProvider2, PageContextProvider: PageContextProvider2 } = env2;\n  const { DEBUG, log, logError } = logging2;\n  const { loadComponent, pathToModuleUrl } = componentLoader2;\n  const { importSnapshotBoundModule } = snapshotModules2;\n  async function renderPage(pathname) {\n    const resolvedPathname = (() => {\n      const input = typeof pathname === "string" ? pathname : window.location.pathname;\n      try {\n        return new URL(input, window.location.origin).pathname || "/";\n      } catch (_) {\n        const [pathOnly] = String(input || "/").split(/[?#]/);\n        return pathOnly || "/";\n      }\n    })();\n    const dataScript = findServerHydrationDataElement(document2);\n    if (!dataScript) {\n      logError("Hydration data not found");\n      return;\n    }\n    let data = {};\n    try {\n      data = JSON.parse(dataScript.textContent || "{}");\n    } catch (parseError) {\n      logError("Failed to parse hydration data:", parseError);\n      return;\n    }\n    log("Hydration data:", data);\n    if (data.studioEmbed && window.__veryfrontSetStudioEmbed) {\n      window.__veryfrontSetStudioEmbed(true);\n    }\n    if (window.__veryfrontSetReleaseId) {\n      window.__veryfrontSetReleaseId(data.releaseId || null);\n    }\n    if (data.releaseAssetModules && window.__veryfrontSetReleaseAssetModules) {\n      window.__veryfrontSetReleaseAssetModules(data.releaseAssetModules);\n    }\n    try {\n      let pageModule;\n      const pagePath = typeof data.pagePath === "string" ? data.pagePath : "";\n      const normalizedPagePath = pagePath.replace(/^\\/+/, "");\n      const normalizedAppRouterRoot = typeof data.appRouterRoot === "string" && data.appRouterRoot.replace(/^\\/+|\\/+$/g, "") ? data.appRouterRoot.replace(/^\\/+|\\/+$/g, "") : "app";\n      const hasReleaseAssetModules = data.releaseAssetModules && Object.keys(data.releaseAssetModules).length > 0;\n      const shouldRenderRscClientPage = data.clientModuleStrategy === "rsc-module" && !hasReleaseAssetModules && isAppRouterPath(normalizedPagePath, normalizedAppRouterRoot);\n      const isolatedClientPage = data.isolatedClientPage === true;\n      const loadHydrationComponent = async (path, preferRscModule) => {\n        const normalizedPath = typeof path === "string" ? path.replace(/^\\/+/, "") : "";\n        if (preferRscModule && isAppRouterPath(normalizedPath, normalizedAppRouterRoot)) {\n          const moduleUrl = buildPinnedRscModuleUrl(path, data);\n          log("Loading App Router component from RSC module:", moduleUrl);\n          const module = await importSnapshotBoundModule(moduleUrl);\n          return module.default || module;\n        }\n        return loadComponent(path, data);\n      };\n      let pageModuleError = null;\n      if (data.pagePath) {\n        const moduleUrl = shouldRenderRscClientPage ? buildPinnedRscModuleUrl(data.pagePath, data) : pathToModuleUrl(data.pagePath, data.studioEmbed, data);\n        log("Loading page from hydration data:", moduleUrl);\n        try {\n          pageModule = await importSnapshotBoundModule(moduleUrl);\n        } catch (error) {\n          pageModuleError = error;\n          logError("Failed to load page from hydration data:", error);\n        }\n      }\n      if (!pageModule) {\n        const pageSlug = resolvedPathname === "/" ? "index" : resolvedPathname.slice(1);\n        log("Falling back to Pages Router pattern:", pageSlug);\n        const prefix = pageSlug.startsWith("@/") ? "" : "/pages";\n        const basePath = moduleServerUrl2 + prefix + "/" + pageSlug;\n        pageModule = await loadPageModuleWithIndexFallback(\n          basePath,\n          pageSlug,\n          pageModuleError,\n          (moduleUrl) => importSnapshotBoundModule(appendDependencyPinningVersion(moduleUrl, data))\n        );\n      }\n      if (!pageModule) {\n        logError("Page module failed to load");\n        return;\n      }\n      const PageComponent = pageModule.default || pageModule;\n      if (!PageComponent) {\n        logError("Page component not found");\n        return;\n      }\n      const normalizedParams = flattenRouteParams(data.params);\n      const pageProps = { ...data.props || {}, params: normalizedParams };\n      let tree = React2.createElement(PageComponent, pageProps);\n      const layouts = data.layouts;\n      if (layouts?.length) {\n        for (let i = layouts.length - 1; i >= 0; i--) {\n          const layout = layouts[i];\n          if (!layout) continue;\n          const LayoutComponent = await loadHydrationComponent(\n            layout.path,\n            shouldRenderRscClientPage\n          );\n          if (LayoutComponent) {\n            const WrappedLayoutComponent = shouldRenderRscClientPage && isRootAppLayoutPath(layout.path, normalizedAppRouterRoot) ? unwrapAppRouterDocumentLayout(LayoutComponent, React2) : LayoutComponent;\n            const layoutProps = data.layoutProps?.[layout.path] || {};\n            tree = React2.createElement(\n              WrappedLayoutComponent,\n              { ...layoutProps, children: tree }\n            );\n          }\n        }\n      }\n      if (data.appPath && !isolatedClientPage) {\n        const AppComponent = await loadHydrationComponent(data.appPath, shouldRenderRscClientPage);\n        if (AppComponent) {\n          tree = React2.createElement(AppComponent, { children: tree });\n        }\n      }\n      if (data.errorPath) {\n        const ErrorComponent = await loadHydrationComponent(\n          data.errorPath,\n          shouldRenderRscClientPage\n        );\n        if (ErrorComponent) {\n          class AppRouterErrorBoundary extends React2.Component {\n            constructor(props) {\n              super(props);\n              this.state = { hasError: false, error: null };\n            }\n            static getDerivedStateFromError(error) {\n              return { hasError: true, error };\n            }\n            render() {\n              if (this.state.hasError) {\n                return React2.createElement(ErrorComponent, {\n                  error: this.state.error,\n                  reset: () => this.setState({ hasError: false, error: null })\n                });\n              }\n              return this.props.children;\n            }\n          }\n          tree = React2.createElement(AppRouterErrorBoundary, null, tree);\n        }\n      }\n      const headings = data.headings || [];\n      const pageContext = {\n        slug: data.slug || "",\n        path: data.pagePath || resolvedPathname,\n        params: normalizedParams,\n        query: Object.fromEntries(new URLSearchParams(window.location.search)),\n        frontmatter: data.frontmatter || {},\n        data: data.props || {},\n        headings,\n        mdxHeadings: headings\n        // Alias for backwards compatibility\n      };\n      tree = React2.createElement(PageContextProvider2, { pageContext, children: tree });\n      tree = React2.createElement(RouterProvider2, { router: deps.router, children: tree });\n      const container = isolatedClientPage ? document2.getElementById("veryfront-page-island") : document2.getElementById("root");\n      if (!container) {\n        if (isolatedClientPage) {\n          throw new Error("Isolated client page root not found");\n        }\n        return;\n      }\n      if (container.__reactRoot) {\n        container.__reactRoot.render(tree);\n        log("Page re-rendered");\n        return;\n      }\n      if (shouldRenderRscClientPage) {\n        container.__reactRoot = env2.createRoot(container);\n        container.__reactRoot.render(tree);\n        log("Client-side React app rendered successfully");\n      } else {\n        const { hydrateRoot } = await import("react-dom/client");\n        const options = {\n          identifierPrefix: "vf",\n          onRecoverableError: (error) => {\n            if (data.dev && DEBUG) {\n              log("Hydration mismatch (suppressed):", error.message);\n            }\n          }\n        };\n        container.__reactRoot = hydrateRoot(container, tree, options);\n        log("Client-side React app hydrated successfully");\n      }\n      if (window.__veryfrontHydrationComplete) {\n        window.__veryfrontHydrationComplete();\n      }\n    } catch (error) {\n      logError("Client initialization error:", error);\n      if (window.__veryfrontHydrationFailed) {\n        window.__veryfrontHydrationFailed(error);\n      }\n    }\n  }\n  function start() {\n    window.__veryfrontRenderPage = renderPage;\n    void renderPage(window.location.pathname);\n    const initialDataScript = findServerHydrationDataElement(document2);\n    if (initialDataScript) {\n      try {\n        const pageData = JSON.parse(initialDataScript.textContent || "{}");\n        if (pageData.pagePath) {\n          window.history.replaceState({ pageData, scrollY: 0 }, "", window.location.href);\n          log("Stored initial page data in history state");\n        }\n      } catch (_) {\n      }\n    }\n  }\n  return { renderPage, start };\n}\n\n// src/html/hydration-script-builder/runtime/navigation-store.ts\nvar NAVIGATION_STORE_REGISTRY_KEY = "veryfront.navigation.store.v1";\nfunction resolveNavigationStore(RouterRuntime2) {\n  const usesRegistryFallback2 = typeof RouterRuntime2.getNavigationStore !== "function";\n  if (!usesRegistryFallback2) {\n    return {\n      usesRegistryFallback: usesRegistryFallback2,\n      getNavigationStore: RouterRuntime2.getNavigationStore\n    };\n  }\n  return {\n    usesRegistryFallback: usesRegistryFallback2,\n    getNavigationStore: () => {\n      const storeKey = Symbol.for(NAVIGATION_STORE_REGISTRY_KEY);\n      const registry = globalThis;\n      const existing = registry[storeKey];\n      if (existing) return existing;\n      const listeners = /* @__PURE__ */ new Set();\n      let navigator = null;\n      const store = {\n        subscribe(listener) {\n          listeners.add(listener);\n          return () => listeners.delete(listener);\n        },\n        getHref() {\n          const loc = globalThis.location;\n          return loc ? loc.pathname + loc.search + loc.hash : "/";\n        },\n        notify() {\n          for (const listener of [...listeners]) {\n            try {\n              listener();\n            } catch {\n            }\n          }\n        },\n        navigate(href, options) {\n          if (navigator) return navigator(href, options);\n          globalThis.location?.assign(href);\n          return Promise.resolve();\n        },\n        setNavigator(next) {\n          navigator = next;\n        }\n      };\n      registry[storeKey] = store;\n      return store;\n    }\n  };\n}\n\n// src/html/hydration-script-builder/runtime/main.ts\nvar runtimeWindow = globalThis;\nvar runtimeDocument = globalThis.document;\nvar env = {\n  window: runtimeWindow,\n  document: runtimeDocument,\n  fetch: (url, init) => fetch(url, init),\n  React,\n  RouterProvider,\n  PageContextProvider,\n  createRoot: (container) => createRoot(container),\n  importModule: (moduleUrl) => import(moduleUrl),\n  useRouterFromModule,\n  setTimeout: (handler, timeout) => setTimeout(handler, timeout),\n  clearTimeout: (id) => clearTimeout(id)\n};\nvar logging = createLogging(runtimeWindow);\nvar initialHydrationData = readInitialHydrationData(runtimeDocument);\nvar documentDependencyPinningCacheKey = readDocumentDependencyPinningCacheKey(\n  initialHydrationData\n);\nvar routeTiming = createRouteTimingRecorder(runtimeWindow, logging);\nvar snapshotModules = createSnapshotModuleImporter({\n  importModule: env.importModule,\n  fetchModule: env.fetch,\n  reloadDocument: () => runtimeWindow.location.reload(),\n  recoveryState: runtimeWindow\n});\nvar componentLoader = createComponentLoader({\n  window: runtimeWindow,\n  logging,\n  moduleServerUrl: moduleServerUrl(runtimeWindow),\n  snapshotModules\n});\nruntimeWindow.__veryfrontClearComponentCache = componentLoader.clearComponentCache;\nruntimeWindow.__veryfrontSetStudioEmbed = componentLoader.setStudioEmbed;\nruntimeWindow.__veryfrontSetReleaseId = componentLoader.setReleaseId;\nruntimeWindow.__veryfrontSetReleaseAssetModules = componentLoader.setReleaseAssetModules;\nruntimeWindow.__veryfrontSetHMRRefreshTimestamp = componentLoader.setHMRRefreshTimestamp;\nvar { usesRegistryFallback, getNavigationStore } = resolveNavigationStore(RouterRuntime);\nvar routerRuntime = createRouterRuntime({\n  env,\n  logging,\n  routeTiming,\n  componentLoader,\n  snapshotModules,\n  initialHydrationData,\n  documentDependencyPinningCacheKey,\n  getNavigationStore,\n  navigationStoreUsesRegistryFallback: usesRegistryFallback\n});\ncreateHydrationRenderer({\n  env,\n  logging,\n  componentLoader,\n  snapshotModules,\n  moduleServerUrl: moduleServerUrl(runtimeWindow),\n  router: routerRuntime.router\n}).start();\n';

package/esm/src/platform/compat/http/pinned-fetch.d.ts

@@ -7,7 +7,7 @@
  * Client identity for guarded egress, standing in for the runtime-supplied
  * `user-agent` (`node`, `Deno/x.y.z`) that this transport cannot inherit.
  */
-export declare const DEFAULT_OUTBOUND_USER_AGENT = "veryfront/0.1.1233";
+export declare const DEFAULT_OUTBOUND_USER_AGENT = "veryfront/0.1.1234";
 /**
  * Fill in the request headers a plain `fetch` attaches on its own, leaving any
  * the caller set untouched. This transport talks to `node:http` directly, so
@@ -37,6 +37,27 @@ export declare const DEFAULT_OUTBOUND_USER_AGENT = "veryfront/0.1.1233";
 export declare function applyRuntimeDefaultRequestHeaders(headers: Headers, mode?: RequestMode): Headers;
 /** @internal Construct a Fetch response without violating null-body statuses. */
 export declare function createPinnedFetchResponse(status: number, statusText: string, headers: Headers, body: BodyInit | null, requestMethod?: string): Response;
+/**
+ * Order the validated addresses into connection attempts.
+ *
+ * Each attempt dials exactly one validated address, so the walk happens here
+ * rather than depending on the runtime: Node honours `autoSelectFamily` and a
+ * custom `lookup`, Bun honours neither. A different family is tried before a
+ * sibling of the one that just failed, because a host with no IPv6 route fails
+ * on every AAAA record its DNS carries.
+ *
+ * Every address is already validated by the egress policy, so trying them in
+ * turn narrows nothing: the set is identical, only the order of use changes.
+ */
+export declare function planPinnedConnectAttempts(addresses: readonly string[]): readonly (readonly string[])[];
+/** True when the request may be issued again against a different address. */
+export declare function isRetriableConnectFailure(error: unknown): boolean;
+/**
+ * A body may only be replayed when re-reading it yields the same bytes. A
+ * ReadableStream does not qualify: the failed attempt already drained it, so a
+ * retry would send nothing.
+ */
+export declare function isReplayableRequestBody(body: BodyInit | null): boolean;
 /** @internal Used by the central egress guard after DNS policy validation. */
 export declare function fetchWithPinnedAddresses(url: URL, addresses: readonly string[], init: RequestInit): Promise<Response>;
 //# sourceMappingURL=pinned-fetch.d.ts.map

package/esm/src/platform/compat/http/pinned-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pinned-fetch.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/http/pinned-fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;GAGG;AACH,eAAO,MAAM,2BAA2B,uBAAyB,CAAC;AAKlE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAeT;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,aAAa,SAAQ,GACpB,QAAQ,CASV;AA6HD,8EAA8E;AAC9E,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CA2FnB"}
+{"version":3,"file":"pinned-fetch.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/compat/http/pinned-fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH;;;GAGG;AACH,eAAO,MAAM,2BAA2B,uBAAyB,CAAC;AAKlE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAeT;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,aAAa,SAAQ,GACpB,QAAQ,CASV;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAUhC;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYjE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAOtE;AA4FD,8EAA8E;AAC9E,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CA+HnB"}

package/esm/src/platform/compat/http/pinned-fetch.js

@@ -70,28 +70,62 @@ export function createPinnedFetchResponse(status, statusText, headers, body, req
 function addressFamily(address) {
     return address.includes(":") ? 6 : 4;
 }
-function createPinnedLookup(addresses) {
-    let nextIndex = 0;
-    return ((_hostname, options, callback) => {
-        const requestedFamily = typeof options === "number"
-            ? options
-            : typeof options === "object" && options !== null && "family" in options
-                ? Number(options.family ?? 0)
-                : 0;
-        const candidates = addresses.filter((address) => requestedFamily === 0 || addressFamily(address) === requestedFamily);
-        if (candidates.length === 0) {
-            callback(new Error("No validated address matches the requested address family"));
-            return;
-        }
-        const wantsAll = typeof options === "object" && options !== null &&
-            options.all === true;
-        if (wantsAll) {
-            callback(null, candidates.map((address) => ({ address, family: addressFamily(address) })));
-            return;
-        }
-        const address = candidates[nextIndex++ % candidates.length];
-        callback(null, address, addressFamily(address));
-    });
+/** Connect-level failures that mean "this address is unusable", not "this request is bad". */
+const RETRIABLE_CONNECT_CODES = new Set([
+    "ECONNREFUSED",
+    "EHOSTUNREACH",
+    "ENETUNREACH",
+    "EADDRNOTAVAIL",
+    "ETIMEDOUT",
+]);
+/**
+ * Order the validated addresses into connection attempts.
+ *
+ * Each attempt dials exactly one validated address, so the walk happens here
+ * rather than depending on the runtime: Node honours `autoSelectFamily` and a
+ * custom `lookup`, Bun honours neither. A different family is tried before a
+ * sibling of the one that just failed, because a host with no IPv6 route fails
+ * on every AAAA record its DNS carries.
+ *
+ * Every address is already validated by the egress policy, so trying them in
+ * turn narrows nothing: the set is identical, only the order of use changes.
+ */
+export function planPinnedConnectAttempts(addresses) {
+    if (addresses.length <= 1)
+        return addresses.map((address) => [address]);
+    const first = addresses[0];
+    const otherFamily = addresses.filter((address) => addressFamily(address) !== addressFamily(first));
+    const sameFamily = addresses.slice(1).filter((address) => addressFamily(address) === addressFamily(first));
+    return [[first], ...[...otherFamily, ...sameFamily].map((address) => [address])];
+}
+/** True when the request may be issued again against a different address. */
+export function isRetriableConnectFailure(error) {
+    if (typeof error !== "object" || error === null)
+        return false;
+    const code = error.code;
+    if (typeof code !== "string" || !RETRIABLE_CONNECT_CODES.has(code))
+        return false;
+    // ETIMEDOUT is the one code here that is not exclusively a connect failure:
+    // it also surfaces when a socket times out after the request was written, and
+    // replaying then could deliver a non-idempotent request twice. Only the
+    // connect syscall is known to have reached no server.
+    if (code === "ETIMEDOUT") {
+        return error.syscall === "connect";
+    }
+    return true;
+}
+/**
+ * A body may only be replayed when re-reading it yields the same bytes. A
+ * ReadableStream does not qualify: the failed attempt already drained it, so a
+ * retry would send nothing.
+ */
+export function isReplayableRequestBody(body) {
+    // A Blob counts: it is immutable and `writeRequestBody` calls `body.stream()`
+    // per attempt, so each attempt gets a fresh stream over identical bytes. A
+    // ReadableStream does not, because the attempt that failed already drained it.
+    return body === null || typeof body === "string" ||
+        body instanceof URLSearchParams || body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) || body instanceof Blob;
 }
 function copyResponseHeaders(message) {
     const headers = new Headers();
@@ -187,70 +221,102 @@ export async function fetchWithPinnedAddresses(url, addresses, init) {
     const transport = url.protocol === "https:"
         ? await import("node:https")
         : await import("node:http");
-    const requestOptions = {
-        protocol: url.protocol,
-        hostname: url.hostname,
-        port: url.port || undefined,
-        path: `${url.pathname}${url.search}`,
-        method,
-        headers: requestHeaders,
-        lookup: createPinnedLookup(addresses),
-        // Let Node/Bun race the complete validated address set instead of binding
-        // availability to whichever A/AAAA record happened to be returned first.
-        autoSelectFamily: true,
-        ...(url.protocol === "https:" ? { servername: url.hostname } : {}),
-    };
-    return await new Promise((resolve, reject) => {
-        let settled = false;
-        let responseMessage;
-        const cleanupAbortListener = () => init.signal?.removeEventListener("abort", abort);
-        const rejectBeforeResponse = (error) => {
-            cleanupAbortListener();
-            reject(error);
+    const attempts = planPinnedConnectAttempts(addresses);
+    const bodyIsReplayable = isReplayableRequestBody(body);
+    let lastConnectError;
+    for (let attemptIndex = 0; attemptIndex < attempts.length; attemptIndex++) {
+        const requestOptions = {
+            protocol: url.protocol,
+            // Connect straight to the validated address. Overriding DNS through a
+            // custom `lookup` is the documented way to pin and Node honours it, but
+            // Bun's node:https ignores the address it returns and fails with
+            // ECONNREFUSED even for a reachable one, so the pin was inert there.
+            // Dialling the address directly needs no runtime cooperation; identity
+            // travels in the Host header and the TLS SNI name instead.
+            hostname: attempts[attemptIndex][0],
+            port: url.port || (url.protocol === "https:" ? 443 : 80),
+            path: `${url.pathname}${url.search}`,
+            method,
+            headers: { ...requestHeaders, host: url.host },
+            ...(url.protocol === "https:" ? { servername: url.hostname } : {}),
         };
-        const request = transport.request(requestOptions, async (message) => {
-            responseMessage = message;
-            try {
-                const responseHeaders = copyResponseHeaders(message);
-                const status = message.statusCode ?? 500;
-                if (method === "HEAD" || NULL_BODY_STATUSES.has(status)) {
-                    message.once("end", cleanupAbortListener);
-                    message.once("close", cleanupAbortListener);
-                    message.once("error", cleanupAbortListener);
-                    // Drain any protocol-invalid payload without exposing it through the
-                    // Fetch response. Response rejects stream bodies for these statuses.
-                    message.resume();
-                    settled = true;
-                    resolve(createPinnedFetchResponse(status, message.statusMessage ?? "", responseHeaders, null, method));
+        let pendingRequest;
+        try {
+            return await new Promise((resolve, reject) => {
+                let settled = false;
+                let responseMessage;
+                const cleanupAbortListener = () => init.signal?.removeEventListener("abort", abort);
+                const rejectBeforeResponse = (error) => {
+                    cleanupAbortListener();
+                    reject(error);
+                };
+                const request = transport.request(requestOptions, async (message) => {
+                    responseMessage = message;
+                    try {
+                        const responseHeaders = copyResponseHeaders(message);
+                        const status = message.statusCode ?? 500;
+                        if (method === "HEAD" || NULL_BODY_STATUSES.has(status)) {
+                            message.once("end", cleanupAbortListener);
+                            message.once("close", cleanupAbortListener);
+                            message.once("error", cleanupAbortListener);
+                            // Drain any protocol-invalid payload without exposing it through the
+                            // Fetch response. Response rejects stream bodies for these statuses.
+                            message.resume();
+                            settled = true;
+                            resolve(createPinnedFetchResponse(status, message.statusMessage ?? "", responseHeaders, null, method));
+                            return;
+                        }
+                        const decoded = await decodeResponseBody(message, responseHeaders);
+                        decoded.once("end", cleanupAbortListener);
+                        decoded.once("close", cleanupAbortListener);
+                        decoded.once("error", cleanupAbortListener);
+                        const { Readable } = await import("node:stream");
+                        const webBody = Readable.toWeb(decoded);
+                        settled = true;
+                        resolve(createPinnedFetchResponse(status, message.statusMessage ?? "", responseHeaders, webBody, method));
+                    }
+                    catch (error) {
+                        rejectBeforeResponse(error);
+                    }
+                });
+                const abort = () => {
+                    const reason = init.signal?.reason ??
+                        new DOMException("The operation was aborted", "AbortError");
+                    responseMessage?.destroy(isErrorAcrossRealms(reason) ? reason : undefined);
+                    request.destroy(isErrorAcrossRealms(reason) ? reason : undefined);
+                    if (!settled)
+                        rejectBeforeResponse(reason);
+                };
+                init.signal?.addEventListener("abort", abort, { once: true });
+                if (init.signal?.aborted) {
+                    abort();
                     return;
                 }
-                const decoded = await decodeResponseBody(message, responseHeaders);
-                decoded.once("end", cleanupAbortListener);
-                decoded.once("close", cleanupAbortListener);
-                decoded.once("error", cleanupAbortListener);
-                const { Readable } = await import("node:stream");
-                const webBody = Readable.toWeb(decoded);
-                settled = true;
-                resolve(createPinnedFetchResponse(status, message.statusMessage ?? "", responseHeaders, webBody, method));
-            }
-            catch (error) {
-                rejectBeforeResponse(error);
+                request.once("error", rejectBeforeResponse);
+                // Bun reports connect failures through
+                // `process.nextTick(() => self.emit("error", err))`, so the emit can
+                // land after this promise has settled and after the `once` listener
+                // above has been consumed. With no listener left, Node stream
+                // semantics turn it into an uncaught exception and the process exits,
+                // which is how one refused address took down the dev server instead of
+                // failing a single request. This sink absorbs the late emit; the first
+                // error still rejects through `rejectBeforeResponse`.
+                request.on("error", () => { });
+                pendingRequest = request;
+                void writeRequestBody(request, body).catch((error) => request.destroy(error));
+            });
+        }
+        catch (error) {
+            // Release the socket of the attempt being abandoned. The sink above stays
+            // attached, so a teardown error from this destroy has somewhere to land.
+            pendingRequest?.destroy();
+            lastConnectError = error;
+            const hasAnotherAddress = attemptIndex < attempts.length - 1;
+            if (!hasAnotherAddress || !bodyIsReplayable || init.signal?.aborted ||
+                !isRetriableConnectFailure(error)) {
+                throw error;
             }
-        });
-        const abort = () => {
-            const reason = init.signal?.reason ??
-                new DOMException("The operation was aborted", "AbortError");
-            responseMessage?.destroy(isErrorAcrossRealms(reason) ? reason : undefined);
-            request.destroy(isErrorAcrossRealms(reason) ? reason : undefined);
-            if (!settled)
-                rejectBeforeResponse(reason);
-        };
-        init.signal?.addEventListener("abort", abort, { once: true });
-        if (init.signal?.aborted) {
-            abort();
-            return;
         }
-        request.once("error", rejectBeforeResponse);
-        void writeRequestBody(request, body).catch((error) => request.destroy(error));
-    });
+    }
+    throw lastConnectError;
 }

package/esm/src/server/runtime-handler/adapter-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uBAAuB;AACjC,+EAA+E;AAC7E,WAAW;AACb,6CAA6C;GAC3C,OAAO;AACT,yDAAyD;GACvD,UAAU;AACZ,sDAAsD;GACpD,QAAQ;AACV,4EAA4E;GAC1E,eAAe,CAAC;AAEpB,UAAU,uBAAuB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,cAAc,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,sCAAsC;IACtC,aAAa,EAAE,uBAAuB,CAAC;IACvC,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,wBAAwB;IAChC;;;OAGG;IACH,GAAG,EAAE,OAAO,CAAC;IACb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,yCAAyC;IACzC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,CAC3B,cAAc,EAAE,OAAO,KACpB,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBzD;AAgCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAqMlC"}
+{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uBAAuB;AACjC,+EAA+E;AAC7E,WAAW;AACb,6CAA6C;GAC3C,OAAO;AACT,yDAAyD;GACvD,UAAU;AACZ,sDAAsD;GACpD,QAAQ;AACV,4EAA4E;GAC1E,eAAe,CAAC;AAEpB,UAAU,uBAAuB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,cAAc,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,sCAAsC;IACtC,aAAa,EAAE,uBAAuB,CAAC;IACvC,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,wBAAwB;IAChC;;;OAGG;IACH,GAAG,EAAE,OAAO,CAAC;IACb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,yCAAyC;IACzC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,CAC3B,cAAc,EAAE,OAAO,KACpB,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBzD;AAgCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA+MlC"}

package/esm/src/server/runtime-handler/adapter-factory.js

@@ -113,16 +113,26 @@ export async function resolveAdapter(opts) {
             projectSlug: opts.projectSlug,
             projectDir: effectiveProjectDir,
         });
-        // Get or create local adapter
-        if (!cache.adapters.has(effectiveProjectDir)) {
-            const baseAdapter = await runtime.get();
-            cache.adapters.set(effectiveProjectDir, baseAdapter);
+        // Get or create local adapter.
+        //
+        // Hold the adapter rather than reading it back: the cache is an LRU that
+        // estimates each value's size and can evict an oversized entry as part of
+        // the same set(), so a write is not guaranteed to be readable afterwards.
+        // A RuntimeAdapter crosses that budget under Bun, where set() then leaves
+        // has() === false and size === 0, and the non-null assertion this replaces
+        // turned that miss into an undefined adapter that reached getConfig and
+        // threw "undefined is not an object (evaluating 'adapter.fs')" on every
+        // request. Caching stays best effort; correctness no longer depends on it.
+        let localAdapter = cache.adapters.get(effectiveProjectDir);
+        if (!localAdapter) {
+            localAdapter = await runtime.get();
+            cache.adapters.set(effectiveProjectDir, localAdapter);
             logger.debug("Created local adapter for project", {
                 projectSlug: opts.projectSlug,
                 projectDir: effectiveProjectDir,
             });
         }
-        effectiveAdapter = cache.adapters.get(effectiveProjectDir);
+        effectiveAdapter = localAdapter;
         if (shouldDeferConfigLoad(opts)) {
             effectiveConfig = undefined;
             configOutcome = "deferred";

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1233";
+export declare const VERSION = "0.1.1234";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1233";
+export const VERSION = "0.1.1234";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1233",
+  "version": "0.1.1234",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -425,13 +425,13 @@
     "@deno/shim-crypto": "0.3.1",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
-    "@veryfront/ext-bundler-esbuild": "0.1.1233",
-    "@veryfront/ext-content-mdx": "0.1.1233",
-    "@veryfront/ext-css-tailwind": "0.1.1233",
-    "@veryfront/ext-dev-ui-react": "0.1.1233",
-    "@veryfront/ext-node-websocket-ws": "0.1.1233",
-    "@veryfront/ext-parser-babel": "0.1.1233",
-    "@veryfront/ext-yaml": "0.1.1233"
+    "@veryfront/ext-bundler-esbuild": "0.1.1234",
+    "@veryfront/ext-content-mdx": "0.1.1234",
+    "@veryfront/ext-css-tailwind": "0.1.1234",
+    "@veryfront/ext-dev-ui-react": "0.1.1234",
+    "@veryfront/ext-node-websocket-ws": "0.1.1234",
+    "@veryfront/ext-parser-babel": "0.1.1234",
+    "@veryfront/ext-yaml": "0.1.1234"
   },
   "devDependencies": {
     "@types/node": "20.9.0"