bun-plugin-stx 0.2.616 → 0.2.617

package/dist/serve.js

@@ -9390,6 +9390,20 @@ function resolveImageWarmupBindBudget(value) {
   const ms = typeof value === "string" && value.trim() !== "" ? Number(value) : value;
   return typeof ms === "number" && Number.isFinite(ms) && ms >= 0 ? ms : DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS;
 }
+var PAGE_WARMUP_HEADER = "x-stx-warmup";
+var DEFAULT_PAGE_WARMUP_BUDGET_MS = 60000;
+function resolvePageWarmup(value) {
+  const defaults = { enabled: true, paths: [], budgetMs: DEFAULT_PAGE_WARMUP_BUDGET_MS, concurrency: 4 };
+  if (value === false)
+    return { ...defaults, enabled: false };
+  if (!value || typeof value !== "object")
+    return defaults;
+  const raw = value;
+  const paths = Array.isArray(raw.paths) ? [...new Set(raw.paths.filter((p) => typeof p === "string" && p.startsWith("/") && !p.startsWith("//")))] : [];
+  const budgetMs = typeof raw.budgetMs === "number" && Number.isFinite(raw.budgetMs) && raw.budgetMs >= 0 ? raw.budgetMs : defaults.budgetMs;
+  const concurrency = typeof raw.concurrency === "number" && Number.isFinite(raw.concurrency) && raw.concurrency >= 1 ? Math.floor(raw.concurrency) : defaults.concurrency;
+  return { enabled: true, paths, budgetMs, concurrency };
+}
 async function settleWithin(promise, ms) {
   let timer;
   const settled = promise.then(() => true, () => true);
@@ -9455,6 +9469,7 @@ async function serve(options) {
   const imageWarmupSetting = options.imageWarmup ?? stxConfig.imageWarmup ?? "auto";
   const imageWarmupGraceMs = Math.max(0, options.imageWarmupGraceMs ?? 1000);
   const imageWarmupBindBudgetMs = resolveImageWarmupBindBudget(options.imageWarmupBindBudgetMs ?? stxConfig.imageWarmupBindBudgetMs);
+  const pageWarmup = resolvePageWarmup(options.pageWarmup ?? stxConfig.pageWarmup);
   function awaitImageWarmup() {
     if (placeholdersAreReady || imageWarmupGraceMs === 0)
       return;
@@ -10639,537 +10654,532 @@ ${block}`;
       });
     }
   }
-  const portAutoIncrement = options.autoIncrementPort ?? true;
-  const maxPortAttempts = portAutoIncrement === false ? 1 : typeof portAutoIncrement === "number" ? Math.max(1, portAutoIncrement) : 10;
-  let actualPort = port;
-  let _server;
-  let lastServeError;
-  for (let attempt = 0;attempt < maxPortAttempts; attempt++) {
-    try {
-      _server = bunServe({
-        port: actualPort,
-        reusePort: options.reusePort ?? false,
-        idleTimeout: production ? 120 : 0,
-        error(error) {
-          console.error("[stx] Request failed:", error);
-          return new Response("<h1>Internal Server Error</h1><p>An error occurred while processing your request.</p>", {
-            status: 500,
-            headers: {
-              "Content-Type": "text/html; charset=utf-8",
-              "Cache-Control": "no-store"
-            }
-          });
-        },
-        async fetch(req, server) {
-          const warmup = awaitImageWarmup();
-          if (warmup)
-            await warmup;
-          return compressResponse(req, await (async () => {
-            if (domainRoutes.length) {
-              const original = new URL(req.url);
-              const routed = resolveDomainRoute(requestHost(req), original.pathname, domainRoutes);
-              if (routed) {
-                original.pathname = routed;
-                const headers = new Headers(req.headers);
-                headers.set("x-stx-domain-route", requestHost(req));
-                req = new Request(original, { headers, method: req.method, body: req.body, redirect: req.redirect, duplex: "half" });
-              } else if (req.method === "GET" || req.method === "HEAD") {
-                const staysHere = (pathname) => {
-                  return pathname.startsWith("/api/") || pathname.startsWith("/_stx/") || pathname.startsWith("/.well-known/") || isStaticAssetPath(pathname) || publicFileExists(pathname, publicDir);
-                };
-                const location = resolveDomainElsewhere(requestHost(req), original.pathname, original.search, domainRoutes, staysHere);
-                if (location) {
-                  if (req.headers.get(SPA_NAV_HEADER) === "true")
-                    return new Response(null, { status: 200, headers: { "X-STX-Location": location, "Cache-Control": "no-store", Vary: SPA_NAV_HEADER } });
-                  return new Response(null, { status: 301, headers: { Location: location } });
-                }
+  function listen(listenPort, reusePort, hostname) {
+    return bunServe({
+      port: listenPort,
+      ...hostname ? { hostname } : {},
+      reusePort,
+      idleTimeout: production ? 120 : 0,
+      error(error) {
+        console.error("[stx] Request failed:", error);
+        return new Response("<h1>Internal Server Error</h1><p>An error occurred while processing your request.</p>", {
+          status: 500,
+          headers: {
+            "Content-Type": "text/html; charset=utf-8",
+            "Cache-Control": "no-store"
+          }
+        });
+      },
+      async fetch(req, server) {
+        const warmup = awaitImageWarmup();
+        if (warmup)
+          await warmup;
+        return compressResponse(req, await (async () => {
+          if (domainRoutes.length) {
+            const original = new URL(req.url);
+            const routed = resolveDomainRoute(requestHost(req), original.pathname, domainRoutes);
+            if (routed) {
+              original.pathname = routed;
+              const headers = new Headers(req.headers);
+              headers.set("x-stx-domain-route", requestHost(req));
+              req = new Request(original, { headers, method: req.method, body: req.body, redirect: req.redirect, duplex: "half" });
+            } else if (req.method === "GET" || req.method === "HEAD") {
+              const staysHere = (pathname) => {
+                return pathname.startsWith("/api/") || pathname.startsWith("/_stx/") || pathname.startsWith("/.well-known/") || isStaticAssetPath(pathname) || publicFileExists(pathname, publicDir);
+              };
+              const location = resolveDomainElsewhere(requestHost(req), original.pathname, original.search, domainRoutes, staysHere);
+              if (location) {
+                if (req.headers.get(SPA_NAV_HEADER) === "true")
+                  return new Response(null, { status: 200, headers: { "X-STX-Location": location, "Cache-Control": "no-store", Vary: SPA_NAV_HEADER } });
+                return new Response(null, { status: 301, headers: { Location: location } });
               }
             }
-            const url = new URL(req.url);
-            let path = url.pathname;
-            const proxyRules = stxConfig.server?.proxy;
-            if (proxyRules) {
-              for (const [prefix, rule] of Object.entries(proxyRules)) {
-                if (path !== prefix && !path.startsWith(prefix))
-                  continue;
-                const ruleCfg = typeof rule === "string" ? { target: rule } : rule;
-                const outPath = ruleCfg.rewrite ? ruleCfg.rewrite(path) : path;
-                const target = new URL(ruleCfg.target);
-                const outUrl = new URL(outPath + url.search, target);
-                const headers = new Headers(req.headers);
-                if (ruleCfg.changeOrigin !== false)
-                  headers.set("host", target.host);
-                try {
-                  return await fetch(outUrl, {
-                    method: req.method,
-                    headers,
-                    body: req.body,
-                    redirect: "manual",
-                    ...req.body ? { duplex: "half" } : {}
-                  });
-                } catch (err) {
-                  return new Response(`[stx dev proxy] ${prefix} \u2192 ${ruleCfg.target} failed: ${err instanceof Error ? err.message : String(err)}`, { status: 502 });
-                }
+          }
+          const url = new URL(req.url);
+          let path = url.pathname;
+          const proxyRules = stxConfig.server?.proxy;
+          if (proxyRules) {
+            for (const [prefix, rule] of Object.entries(proxyRules)) {
+              if (path !== prefix && !path.startsWith(prefix))
+                continue;
+              const ruleCfg = typeof rule === "string" ? { target: rule } : rule;
+              const outPath = ruleCfg.rewrite ? ruleCfg.rewrite(path) : path;
+              const target = new URL(ruleCfg.target);
+              const outUrl = new URL(outPath + url.search, target);
+              const headers = new Headers(req.headers);
+              if (ruleCfg.changeOrigin !== false)
+                headers.set("host", target.host);
+              try {
+                return await fetch(outUrl, {
+                  method: req.method,
+                  headers,
+                  body: req.body,
+                  redirect: "manual",
+                  ...req.body ? { duplex: "half" } : {}
+                });
+              } catch (err) {
+                return new Response(`[stx dev proxy] ${prefix} \u2192 ${ruleCfg.target} failed: ${err instanceof Error ? err.message : String(err)}`, { status: 502 });
               }
             }
-            let i18nLocale = null;
-            if (i18nConfig && !url.pathname.startsWith("/api/")) {
-              const stripped = localeFromPath(url.pathname);
-              i18nLocale = stripped.locale;
-              if (stripped.path !== url.pathname) {
-                const rewritten = new URL(req.url);
-                rewritten.pathname = stripped.path;
-                const headers = new Headers(req.headers);
-                headers.set("x-stx-locale", stripped.locale);
-                req = new Request(rewritten, { headers, method: req.method, body: req.body, redirect: req.redirect, duplex: "half" });
-                path = stripped.path;
-              } else if (i18nLocale) {
-                const headers = new Headers(req.headers);
-                headers.set("x-stx-locale", i18nLocale);
-                req = new Request(req, { headers });
-              }
+          }
+          let i18nLocale = null;
+          if (i18nConfig && !url.pathname.startsWith("/api/")) {
+            const stripped = localeFromPath(url.pathname);
+            i18nLocale = stripped.locale;
+            if (stripped.path !== url.pathname) {
+              const rewritten = new URL(req.url);
+              rewritten.pathname = stripped.path;
+              const headers = new Headers(req.headers);
+              headers.set("x-stx-locale", stripped.locale);
+              req = new Request(rewritten, { headers, method: req.method, body: req.body, redirect: req.redirect, duplex: "half" });
+              path = stripped.path;
+            } else if (i18nLocale) {
+              const headers = new Headers(req.headers);
+              headers.set("x-stx-locale", i18nLocale);
+              req = new Request(req, { headers });
             }
-            let mintedCsrfToken = null;
-            const _i18nResp = await (async () => {
-              activeServeLocale = i18nLocale;
-              activeServeSearch = url.search;
-              activeServeHost = req.headers.get("host") || "";
-              activeServeCookieHeader = req.headers.get("cookie") || "";
-              activeServeCookies = parseCookies(req);
-              activeServeIp = resolveClientAddress(req, server);
-              mintedCsrfToken = csrfTokenToMint(req, activeServeCookies);
-              if (mintedCsrfToken)
-                activeServeCookies[CSRF_COOKIE] = mintedCsrfToken;
-              const reqCtx = {
-                url: req.url,
-                path,
-                search: activeServeSearch,
-                host: activeServeHost,
-                cookieHeader: activeServeCookieHeader,
-                cookies: activeServeCookies,
-                ip: activeServeIp,
-                locale: activeServeLocale,
-                params: {},
-                method: (req.method || "GET").toUpperCase(),
-                request: req
-              };
-              try {
-                if (req.method === "OPTIONS") {
-                  return new Response(null, { headers: corsHeaders });
-                }
-                if (path === "/_stx/hmr") {
-                  if (production)
-                    return new Response("Not Found", { status: 404, headers: { "Cache-Control": "no-store" } });
-                  let controller;
-                  let keepalive;
-                  const stream = new ReadableStream({
-                    start(c) {
-                      controller = c;
-                      hmrClients.add(c);
-                      c.enqueue(hmrEncoder.encode(`data: {"type":"connected","version":${hmrVersion}}
+          }
+          let mintedCsrfToken = null;
+          const _i18nResp = await (async () => {
+            activeServeLocale = i18nLocale;
+            activeServeSearch = url.search;
+            activeServeHost = req.headers.get("host") || "";
+            activeServeCookieHeader = req.headers.get("cookie") || "";
+            activeServeCookies = parseCookies(req);
+            activeServeIp = resolveClientAddress(req, server);
+            mintedCsrfToken = csrfTokenToMint(req, activeServeCookies);
+            if (mintedCsrfToken)
+              activeServeCookies[CSRF_COOKIE] = mintedCsrfToken;
+            const reqCtx = {
+              url: req.url,
+              path,
+              search: activeServeSearch,
+              host: activeServeHost,
+              cookieHeader: activeServeCookieHeader,
+              cookies: activeServeCookies,
+              ip: activeServeIp,
+              locale: activeServeLocale,
+              params: {},
+              method: (req.method || "GET").toUpperCase(),
+              request: req
+            };
+            try {
+              if (req.method === "OPTIONS") {
+                return new Response(null, { headers: corsHeaders });
+              }
+              if (path === "/_stx/hmr") {
+                if (production)
+                  return new Response("Not Found", { status: 404, headers: { "Cache-Control": "no-store" } });
+                let controller;
+                let keepalive;
+                const stream = new ReadableStream({
+                  start(c) {
+                    controller = c;
+                    hmrClients.add(c);
+                    c.enqueue(hmrEncoder.encode(`data: {"type":"connected","version":${hmrVersion}}
 
 `));
-                      if (currentBuildErrors.length > 0) {
-                        c.enqueue(hmrEncoder.encode(`data: ${JSON.stringify({ type: "build-error", errors: currentBuildErrors })}
+                    if (currentBuildErrors.length > 0) {
+                      c.enqueue(hmrEncoder.encode(`data: ${JSON.stringify({ type: "build-error", errors: currentBuildErrors })}
 
 `));
-                      }
-                      keepalive = setInterval(() => {
-                        try {
-                          c.enqueue(hmrEncoder.encode(`: keepalive
+                    }
+                    keepalive = setInterval(() => {
+                      try {
+                        c.enqueue(hmrEncoder.encode(`: keepalive
 
 `));
-                        } catch {}
-                      }, 5000);
-                    },
-                    cancel() {
-                      if (keepalive)
-                        clearInterval(keepalive);
-                      if (controller)
-                        hmrClients.delete(controller);
-                    }
-                  });
-                  return new Response(stream, {
-                    headers: {
-                      "Content-Type": "text/event-stream",
-                      "Cache-Control": "no-cache, no-transform",
-                      Connection: "keep-alive",
-                      "X-Accel-Buffering": "no"
-                    }
-                  });
-                }
-                const moduleBundle = path.match(MODULE_BUNDLE_PATH);
-                if (moduleBundle) {
-                  const stx = await stxModule;
-                  const content = stx.getServeModuleBundle(moduleBundle[1]);
-                  if (content === undefined)
-                    return new Response("/* stx: unknown module bundle */", { status: 404, headers: { "Content-Type": "application/javascript; charset=utf-8", "Cache-Control": "no-store", ...corsHeaders } });
-                  const etag = `"${moduleBundle[1]}"`;
-                  const headers = {
-                    "Content-Type": "application/javascript; charset=utf-8",
-                    "Cache-Control": "public, max-age=31536000, immutable",
-                    ETag: etag,
-                    ...corsHeaders
-                  };
-                  if (req.headers.get("if-none-match") === etag)
-                    return new Response(null, { status: 304, headers });
-                  if (req.method === "HEAD")
-                    return new Response(null, { headers });
-                  return new Response(content, { headers });
+                      } catch {}
+                    }, 5000);
+                  },
+                  cancel() {
+                    if (keepalive)
+                      clearInterval(keepalive);
+                    if (controller)
+                      hmrClients.delete(controller);
+                  }
+                });
+                return new Response(stream, {
+                  headers: {
+                    "Content-Type": "text/event-stream",
+                    "Cache-Control": "no-cache, no-transform",
+                    Connection: "keep-alive",
+                    "X-Accel-Buffering": "no"
+                  }
+                });
+              }
+              const moduleBundle = path.match(MODULE_BUNDLE_PATH);
+              if (moduleBundle) {
+                const stx = await stxModule;
+                const content = stx.getServeModuleBundle(moduleBundle[1]);
+                if (content === undefined)
+                  return new Response("/* stx: unknown module bundle */", { status: 404, headers: { "Content-Type": "application/javascript; charset=utf-8", "Cache-Control": "no-store", ...corsHeaders } });
+                const etag = `"${moduleBundle[1]}"`;
+                const headers = {
+                  "Content-Type": "application/javascript; charset=utf-8",
+                  "Cache-Control": "public, max-age=31536000, immutable",
+                  ETag: etag,
+                  ...corsHeaders
+                };
+                if (req.headers.get("if-none-match") === etag)
+                  return new Response(null, { status: 304, headers });
+                if (req.method === "HEAD")
+                  return new Response(null, { headers });
+                return new Response(content, { headers });
+              }
+              const sharedScript = path.match(SHARED_SCRIPT_PATH);
+              if (sharedScript) {
+                const stx = await stxModule;
+                const asset = await stx.getServeClientAsset(sharedScript[1], sharedScript[1] === "runtime" && stxConfig.debug === true);
+                const content = asset.content;
+                const etag = `"${asset.hash}"`;
+                const headers = {
+                  "Content-Type": "application/javascript; charset=utf-8",
+                  "Cache-Control": sharedScriptCacheControl(sharedScript[2], asset.hash),
+                  ETag: etag,
+                  ...corsHeaders
+                };
+                if (req.headers.get("if-none-match") === etag)
+                  return new Response(null, { status: 304, headers });
+                if (req.method === "HEAD")
+                  return new Response(null, { headers });
+                return new Response(content, { headers });
+              }
+              if ((req.method === "GET" || req.method === "HEAD") && path.startsWith("/_stx/images/")) {
+                let decodedPath;
+                try {
+                  decodedPath = decodeURIComponent(path.slice("/_stx/images/".length));
+                } catch {
+                  return new Response("Invalid image path", { status: 400 });
                 }
-                const sharedScript = path.match(SHARED_SCRIPT_PATH);
-                if (sharedScript) {
-                  const stx = await stxModule;
-                  const asset = await stx.getServeClientAsset(sharedScript[1], sharedScript[1] === "runtime" && stxConfig.debug === true);
-                  const content = asset.content;
-                  const etag = `"${asset.hash}"`;
-                  const headers = {
+                if (!decodedPath || decodedPath.includes("\x00"))
+                  return new Response("Invalid image path", { status: 400 });
+                const resolvedPath = nodePath.resolve(imageDeliveryRoot, decodedPath);
+                if (!resolvedPath.startsWith(`${imageDeliveryRoot}${nodePath.sep}`))
+                  return new Response("Invalid image path", { status: 400 });
+                try {
+                  const file = Bun.file(resolvedPath);
+                  if (await file.exists()) {
+                    const stat = await file.stat().catch(() => null);
+                    if (stat && !stat.isDirectory()) {
+                      const headers = {
+                        "Content-Type": staticContentType(resolvedPath),
+                        "Cache-Control": "public, max-age=31536000, immutable",
+                        ...corsHeaders
+                      };
+                      return req.method === "HEAD" ? new Response(null, { headers }) : new Response(file, { headers });
+                    }
+                  }
+                } catch {}
+                return new Response("Image not found", { status: 404 });
+              }
+              if (path === "/_stx/sw.js" && stxConfig.offline?.enabled) {
+                const stx = await stxModule;
+                return new Response(stx.generateOfflineWorker(stxConfig.offline, getBuildId()), {
+                  headers: {
+                    "Content-Type": "text/javascript; charset=utf-8",
+                    "Cache-Control": "no-cache",
+                    "Service-Worker-Allowed": "/"
+                  }
+                });
+              }
+              if (path === "/_stx/stores.js") {
+                const stx = await stxModule;
+                const code = typeof stx.getStoreScript === "function" ? await stx.getStoreScript() : null;
+                return new Response(code ?? "", {
+                  status: code === null ? 404 : 200,
+                  headers: {
                     "Content-Type": "application/javascript; charset=utf-8",
-                    "Cache-Control": sharedScriptCacheControl(sharedScript[2], asset.hash),
-                    ETag: etag,
+                    "Cache-Control": "no-store",
                     ...corsHeaders
-                  };
-                  if (req.headers.get("if-none-match") === etag)
-                    return new Response(null, { status: 304, headers });
-                  if (req.method === "HEAD")
-                    return new Response(null, { headers });
-                  return new Response(content, { headers });
+                  }
+                });
+              }
+              const cssAsset = path.match(/^\/_stx\/css\.([a-f0-9]{16})\.css$/);
+              if (cssAsset) {
+                const stx = await stxModule;
+                const content = stx.getCssServeAsset(cssAsset[1]);
+                if (content === undefined)
+                  return new Response("Css asset not found", { status: 404 });
+                const headers = {
+                  "Content-Type": "text/css; charset=utf-8",
+                  "Cache-Control": "public, max-age=31536000, immutable",
+                  ...corsHeaders
+                };
+                if (req.method === "HEAD")
+                  return new Response(null, { headers });
+                return new Response(content, { headers });
+              }
+              if (options.onRequest) {
+                const hookResult = await options.onRequest(req, server);
+                if (hookResult instanceof Response)
+                  return hookResult;
+                if (hookResult && typeof hookResult === "object")
+                  Object.assign(reqCtx, hookResult);
+              }
+              const route = resolveRouteMiddleware(path);
+              const extraNames = extraProtectedPrefixes.some((p) => path === p || path.startsWith(p.endsWith("/") ? p : `${p}/`)) ? ["auth"] : [];
+              const requested = [...globalMiddlewareNames, ...route.names, ...extraNames];
+              if (requested.length > 0) {
+                const expanded = expandMiddlewareNames(requested);
+                const cookies = parseCookies(req);
+                const ctx = {
+                  path,
+                  url,
+                  params: route.params,
+                  cookies,
+                  redirect: (to, status = 302) => {
+                    const sep = to.includes("?") ? "&" : "?";
+                    const next = encodeURIComponent(path + (url.search || ""));
+                    return new Response(null, {
+                      status,
+                      headers: { Location: `${to}${sep}next=${next}` }
+                    });
+                  }
+                };
+                const middlewareResponse = await runPageMiddleware({
+                  request: req,
+                  context: ctx,
+                  entries: expanded,
+                  registry: middlewareRegistry,
+                  prepareRequest: options.prepareMiddlewareRequest
+                });
+                if (middlewareResponse)
+                  return middlewareResponse;
+              }
+              if (options.routes) {
+                const routeHandler = options.routes[path];
+                if (routeHandler) {
+                  return routeHandler(req);
                 }
-                if ((req.method === "GET" || req.method === "HEAD") && path.startsWith("/_stx/images/")) {
-                  let decodedPath;
+              }
+              if (path.startsWith("/_stx/component/")) {
+                const componentName = decodeURIComponent(path.slice("/_stx/component/".length));
+                if (componentName) {
                   try {
-                    decodedPath = decodeURIComponent(path.slice("/_stx/images/".length));
-                  } catch {
-                    return new Response("Invalid image path", { status: 400 });
+                    const { processDirectives, defaultConfig } = await stxModule;
+                    const componentTemplate = `<${componentName} />`;
+                    const componentOpts = {
+                      ...defaultConfig,
+                      ...componentsDir && { componentsDir },
+                      ...layoutsDir && { layoutsDir },
+                      ...fallbackLayoutsDir && { fallbackLayoutsDir },
+                      ...fallbackComponentsDir && { fallbackComponentsDir },
+                      ...partialsDir && { partialsDir },
+                      autoShell: false
+                    };
+                    const html = await processDirectives(componentTemplate, {}, `${componentsDir}/${componentName}.stx`, componentOpts, new Set);
+                    return new Response(html, {
+                      headers: { "Content-Type": "text/html; charset=utf-8", ...corsHeaders }
+                    });
+                  } catch (e) {
+                    return new Response(`<div class="stx-async-error">${e.message}</div>`, {
+                      status: 500,
+                      headers: { "Content-Type": "text/html; charset=utf-8", ...corsHeaders }
+                    });
                   }
-                  if (!decodedPath || decodedPath.includes("\x00"))
-                    return new Response("Invalid image path", { status: 400 });
-                  const resolvedPath = nodePath.resolve(imageDeliveryRoot, decodedPath);
-                  if (!resolvedPath.startsWith(`${imageDeliveryRoot}${nodePath.sep}`))
-                    return new Response("Invalid image path", { status: 400 });
-                  try {
-                    const file = Bun.file(resolvedPath);
-                    if (await file.exists()) {
-                      const stat = await file.stat().catch(() => null);
-                      if (stat && !stat.isDirectory()) {
-                        const headers = {
-                          "Content-Type": staticContentType(resolvedPath),
-                          "Cache-Control": "public, max-age=31536000, immutable",
-                          ...corsHeaders
-                        };
-                        return req.method === "HEAD" ? new Response(null, { headers }) : new Response(file, { headers });
-                      }
-                    }
-                  } catch {}
-                  return new Response("Image not found", { status: 404 });
-                }
-                if (path === "/_stx/sw.js" && stxConfig.offline?.enabled) {
-                  const stx = await stxModule;
-                  return new Response(stx.generateOfflineWorker(stxConfig.offline, getBuildId()), {
-                    headers: {
-                      "Content-Type": "text/javascript; charset=utf-8",
-                      "Cache-Control": "no-cache",
-                      "Service-Worker-Allowed": "/"
-                    }
-                  });
-                }
-                if (path === "/_stx/stores.js") {
-                  const stx = await stxModule;
-                  const code = typeof stx.getStoreScript === "function" ? await stx.getStoreScript() : null;
-                  return new Response(code ?? "", {
-                    status: code === null ? 404 : 200,
-                    headers: {
-                      "Content-Type": "application/javascript; charset=utf-8",
-                      "Cache-Control": "no-store",
-                      ...corsHeaders
-                    }
-                  });
-                }
-                const cssAsset = path.match(/^\/_stx\/css\.([a-f0-9]{16})\.css$/);
-                if (cssAsset) {
-                  const stx = await stxModule;
-                  const content = stx.getCssServeAsset(cssAsset[1]);
-                  if (content === undefined)
-                    return new Response("Css asset not found", { status: 404 });
-                  const headers = {
-                    "Content-Type": "text/css; charset=utf-8",
-                    "Cache-Control": "public, max-age=31536000, immutable",
-                    ...corsHeaders
-                  };
-                  if (req.method === "HEAD")
-                    return new Response(null, { headers });
-                  return new Response(content, { headers });
-                }
-                if (options.onRequest) {
-                  const hookResult = await options.onRequest(req, server);
-                  if (hookResult instanceof Response)
-                    return hookResult;
-                  if (hookResult && typeof hookResult === "object")
-                    Object.assign(reqCtx, hookResult);
                 }
-                const route = resolveRouteMiddleware(path);
-                const extraNames = extraProtectedPrefixes.some((p) => path === p || path.startsWith(p.endsWith("/") ? p : `${p}/`)) ? ["auth"] : [];
-                const requested = [...globalMiddlewareNames, ...route.names, ...extraNames];
-                if (requested.length > 0) {
-                  const expanded = expandMiddlewareNames(requested);
-                  const cookies = parseCookies(req);
-                  const ctx = {
-                    path,
-                    url,
-                    params: route.params,
-                    cookies,
-                    redirect: (to, status = 302) => {
-                      const sep = to.includes("?") ? "&" : "?";
-                      const next = encodeURIComponent(path + (url.search || ""));
-                      return new Response(null, {
-                        status,
-                        headers: { Location: `${to}${sep}next=${next}` }
-                      });
-                    }
-                  };
-                  const middlewareResponse = await runPageMiddleware({
-                    request: req,
-                    context: ctx,
-                    entries: expanded,
-                    registry: middlewareRegistry,
-                    prepareRequest: options.prepareMiddlewareRequest
-                  });
-                  if (middlewareResponse)
-                    return middlewareResponse;
-                }
-                if (options.routes) {
-                  const routeHandler = options.routes[path];
-                  if (routeHandler) {
-                    return routeHandler(req);
+              }
+              if (path.startsWith("/api/data/") && req.method === "POST") {
+                try {
+                  const tableName = path.replace("/api/data/", "").split("/")[0];
+                  if (!tableName) {
+                    return new Response(JSON.stringify({ error: "Table name required" }), {
+                      status: 400,
+                      headers: { "Content-Type": "application/json", ...corsHeaders }
+                    });
                   }
-                }
-                if (path.startsWith("/_stx/component/")) {
-                  const componentName = decodeURIComponent(path.slice("/_stx/component/".length));
-                  if (componentName) {
-                    try {
-                      const { processDirectives, defaultConfig } = await stxModule;
-                      const componentTemplate = `<${componentName} />`;
-                      const componentOpts = {
-                        ...defaultConfig,
-                        ...componentsDir && { componentsDir },
-                        ...layoutsDir && { layoutsDir },
-                        ...fallbackLayoutsDir && { fallbackLayoutsDir },
-                        ...fallbackComponentsDir && { fallbackComponentsDir },
-                        ...partialsDir && { partialsDir },
-                        autoShell: false
-                      };
-                      const html = await processDirectives(componentTemplate, {}, `${componentsDir}/${componentName}.stx`, componentOpts, new Set);
-                      return new Response(html, {
-                        headers: { "Content-Type": "text/html; charset=utf-8", ...corsHeaders }
-                      });
-                    } catch (e) {
-                      return new Response(`<div class="stx-async-error">${e.message}</div>`, {
-                        status: 500,
-                        headers: { "Content-Type": "text/html; charset=utf-8", ...corsHeaders }
-                      });
-                    }
+                  if (!/^[a-zA-Z_]\w*$/.test(tableName)) {
+                    return new Response(JSON.stringify({ error: "Invalid table name" }), {
+                      status: 400,
+                      headers: { "Content-Type": "application/json", ...corsHeaders }
+                    });
                   }
-                }
-                if (path.startsWith("/api/data/") && req.method === "POST") {
+                  const body = await req.json();
+                  const { Database } = await import("bun:sqlite");
+                  const dbPath = nodePath.resolve(process20.cwd(), "database/stacks.sqlite");
+                  const db = new Database(dbPath);
                   try {
-                    const tableName = path.replace("/api/data/", "").split("/")[0];
-                    if (!tableName) {
-                      return new Response(JSON.stringify({ error: "Table name required" }), {
-                        status: 400,
-                        headers: { "Content-Type": "application/json", ...corsHeaders }
-                      });
+                    const tableInfo = db.query(`PRAGMA table_info("${tableName}")`).all();
+                    const validColumns = tableInfo.map((c) => c.name).filter((n) => n !== "id" && n !== "created_at" && n !== "updated_at");
+                    const columns = [];
+                    const placeholders = [];
+                    const values = [];
+                    for (const col of validColumns) {
+                      if (body[col] !== undefined && body[col] !== "") {
+                        columns.push(col);
+                        placeholders.push("?");
+                        values.push(body[col]);
+                      }
+                    }
+                    const now = new Date().toISOString();
+                    if (tableInfo.some((c) => c.name === "created_at")) {
+                      columns.push("created_at");
+                      placeholders.push("?");
+                      values.push(now);
                     }
-                    if (!/^[a-zA-Z_]\w*$/.test(tableName)) {
-                      return new Response(JSON.stringify({ error: "Invalid table name" }), {
+                    if (tableInfo.some((c) => c.name === "updated_at")) {
+                      columns.push("updated_at");
+                      placeholders.push("?");
+                      values.push(now);
+                    }
+                    if (columns.length === 0) {
+                      return new Response(JSON.stringify({ error: "No valid fields provided" }), {
                         status: 400,
                         headers: { "Content-Type": "application/json", ...corsHeaders }
                       });
                     }
-                    const body = await req.json();
-                    const { Database } = await import("bun:sqlite");
-                    const dbPath = nodePath.resolve(process20.cwd(), "database/stacks.sqlite");
-                    const db = new Database(dbPath);
-                    try {
-                      const tableInfo = db.query(`PRAGMA table_info("${tableName}")`).all();
-                      const validColumns = tableInfo.map((c) => c.name).filter((n) => n !== "id" && n !== "created_at" && n !== "updated_at");
-                      const columns = [];
-                      const placeholders = [];
-                      const values = [];
-                      for (const col of validColumns) {
-                        if (body[col] !== undefined && body[col] !== "") {
-                          columns.push(col);
-                          placeholders.push("?");
-                          values.push(body[col]);
-                        }
-                      }
-                      const now = new Date().toISOString();
-                      if (tableInfo.some((c) => c.name === "created_at")) {
-                        columns.push("created_at");
-                        placeholders.push("?");
-                        values.push(now);
-                      }
-                      if (tableInfo.some((c) => c.name === "updated_at")) {
-                        columns.push("updated_at");
-                        placeholders.push("?");
-                        values.push(now);
-                      }
-                      if (columns.length === 0) {
-                        return new Response(JSON.stringify({ error: "No valid fields provided" }), {
-                          status: 400,
-                          headers: { "Content-Type": "application/json", ...corsHeaders }
-                        });
+                    const query = `INSERT INTO "${tableName}" (${columns.join(", ")}) VALUES (${placeholders.join(", ")})`;
+                    const stmt = db.prepare(query);
+                    const result = stmt.run(...values);
+                    return new Response(JSON.stringify({
+                      success: true,
+                      id: result.lastInsertRowid,
+                      message: "Record created successfully"
+                    }), {
+                      status: 201,
+                      headers: { "Content-Type": "application/json", ...corsHeaders }
+                    });
+                  } catch (error) {
+                    console.error("API Error:", error);
+                    return new Response(JSON.stringify({
+                      error: error.message || "Failed to create record"
+                    }), {
+                      status: 500,
+                      headers: { "Content-Type": "application/json", ...corsHeaders }
+                    });
+                  } finally {
+                    db.close();
+                  }
+                } catch {}
+              }
+              if (path === "/index")
+                path = "/";
+              if (path === "/") {
+                const indexContent = await getRoute("/", reqCtx);
+                if (!indexContent) {
+                  const homeContent = await getRoute("/home", reqCtx);
+                  if (homeContent) {
+                    return new Response(null, {
+                      status: 302,
+                      headers: {
+                        Location: "/home",
+                        ...corsHeaders
                       }
-                      const query = `INSERT INTO "${tableName}" (${columns.join(", ")}) VALUES (${placeholders.join(", ")})`;
-                      const stmt = db.prepare(query);
-                      const result = stmt.run(...values);
-                      return new Response(JSON.stringify({
-                        success: true,
-                        id: result.lastInsertRowid,
-                        message: "Record created successfully"
-                      }), {
-                        status: 201,
-                        headers: { "Content-Type": "application/json", ...corsHeaders }
-                      });
-                    } catch (error) {
-                      console.error("API Error:", error);
-                      return new Response(JSON.stringify({
-                        error: error.message || "Failed to create record"
-                      }), {
-                        status: 500,
-                        headers: { "Content-Type": "application/json", ...corsHeaders }
-                      });
-                    } finally {
-                      db.close();
-                    }
-                  } catch {}
-                }
-                if (path === "/index")
-                  path = "/";
-                if (path === "/") {
-                  const indexContent = await getRoute("/", reqCtx);
-                  if (!indexContent) {
-                    const homeContent = await getRoute("/home", reqCtx);
-                    if (homeContent) {
-                      return new Response(null, {
-                        status: 302,
-                        headers: {
-                          Location: "/home",
-                          ...corsHeaders
-                        }
-                      });
-                    }
+                    });
                   }
                 }
-                const content = await getRoute(path, reqCtx);
-                if (reqCtx.actionRedirect) {
-                  const redirectResponse = actionRedirectResponse(reqCtx.actionRedirect, reqCtx.actionCookies, reqCtx.responseHeaders);
-                  for (const [key, value] of Object.entries(corsHeaders))
-                    redirectResponse.headers.set(key, value);
-                  return redirectResponse;
-                }
-                if (content) {
-                  const responseStatus = reqCtx.responseStatus ?? 200;
-                  const isSpaNav = req.headers.get(SPA_NAV_HEADER) === "true";
-                  if (isSpaNav) {
-                    const layoutMetadata = extractLayoutMetadata(content);
-                    const pageLayout = layoutMetadata.layout;
-                    const pageLayoutGroup = i18nConfig && i18nLocale ? `i18n:${i18nLocale}` : layoutMetadata.group;
-                    let fragment = content;
-                    let containerAttrs = "";
-                    let mainContentStart = -1;
-                    let mainContentEnd = -1;
-                    const headStyles = [];
-                    const headMatch = content.match(/<head\b[^>]*>([\s\S]*?)<\/head>/i);
-                    const withoutScripts = (html) => html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "");
-                    if (headMatch) {
-                      const headContent = withoutScripts(headMatch[1]);
-                      let styleMatch;
-                      const styleRe = /<style\b[^>]*>[\s\S]*?<\/style>/gi;
-                      while ((styleMatch = styleRe.exec(headContent)) !== null) {
-                        if (styleMatch[0].includes("data-css")) {
-                          const cssContent = styleMatch[0].replace(/<style[^>]*>/, "").replace(/<\/style>/, "");
-                          const hiddenRule = cssContent.indexOf("[hidden]");
-                          if (hiddenRule !== -1) {
-                            const afterPreflight = cssContent.indexOf("}", hiddenRule) + 1;
-                            const utilities = cssContent.slice(afterPreflight).trim();
-                            if (utilities) {
-                              headStyles.push(`<style data-css="fragment">${utilities}</style>`);
-                            }
+              }
+              const content = await getRoute(path, reqCtx);
+              if (reqCtx.actionRedirect) {
+                const redirectResponse = actionRedirectResponse(reqCtx.actionRedirect, reqCtx.actionCookies, reqCtx.responseHeaders);
+                for (const [key, value] of Object.entries(corsHeaders))
+                  redirectResponse.headers.set(key, value);
+                return redirectResponse;
+              }
+              if (content) {
+                const responseStatus = reqCtx.responseStatus ?? 200;
+                const isSpaNav = req.headers.get(SPA_NAV_HEADER) === "true";
+                if (isSpaNav) {
+                  const layoutMetadata = extractLayoutMetadata(content);
+                  const pageLayout = layoutMetadata.layout;
+                  const pageLayoutGroup = i18nConfig && i18nLocale ? `i18n:${i18nLocale}` : layoutMetadata.group;
+                  let fragment = content;
+                  let containerAttrs = "";
+                  let mainContentStart = -1;
+                  let mainContentEnd = -1;
+                  const headStyles = [];
+                  const headMatch = content.match(/<head\b[^>]*>([\s\S]*?)<\/head>/i);
+                  const withoutScripts = (html) => html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, "");
+                  if (headMatch) {
+                    const headContent = withoutScripts(headMatch[1]);
+                    let styleMatch;
+                    const styleRe = /<style\b[^>]*>[\s\S]*?<\/style>/gi;
+                    while ((styleMatch = styleRe.exec(headContent)) !== null) {
+                      if (styleMatch[0].includes("data-css")) {
+                        const cssContent = styleMatch[0].replace(/<style[^>]*>/, "").replace(/<\/style>/, "");
+                        const hiddenRule = cssContent.indexOf("[hidden]");
+                        if (hiddenRule !== -1) {
+                          const afterPreflight = cssContent.indexOf("}", hiddenRule) + 1;
+                          const utilities = cssContent.slice(afterPreflight).trim();
+                          if (utilities) {
+                            headStyles.push(`<style data-css="fragment">${utilities}</style>`);
                           }
-                          continue;
                         }
-                        headStyles.push(styleMatch[0]);
-                      }
-                      const cssLinkRe = /<link\b[^>]*\bdata-css=(?:"generated"|'generated')[^>]*>/gi;
-                      let cssLinkMatch;
-                      while ((cssLinkMatch = cssLinkRe.exec(headContent)) !== null) {
-                        headStyles.push(cssLinkMatch[0]);
+                        continue;
                       }
+                      headStyles.push(styleMatch[0]);
                     }
-                    const containerSelector = stxConfig?.router?.container || "main";
-                    const containerRegion = findContainerRegion(fragment, containerSelector);
-                    const containerPath = new URL(req.url).pathname;
-                    if (!containerRegion && !warnedMissingContainer.has(containerPath)) {
-                      warnedMissingContainer.add(containerPath);
-                      console.warn(`[stx] No SPA swap container matching "${containerSelector}" in ${containerPath}. SPA navigation is disabled for links on this page; the full document will load instead. Add a matching element, or point router.container at one this page has.`);
+                    const cssLinkRe = /<link\b[^>]*\bdata-css=(?:"generated"|'generated')[^>]*>/gi;
+                    let cssLinkMatch;
+                    while ((cssLinkMatch = cssLinkRe.exec(headContent)) !== null) {
+                      headStyles.push(cssLinkMatch[0]);
                     }
-                    const mainOpenMatch = containerRegion ? { 0: containerRegion.openTag, index: containerRegion.openIndex } : null;
-                    const mainCloseIdx = containerRegion ? containerRegion.end : -1;
-                    if (mainOpenMatch && mainCloseIdx !== -1) {
-                      const bodyMatch = content.match(/<body\b[^>]*>/i);
-                      if (bodyMatch) {
-                        const bodyStart = bodyMatch.index + bodyMatch[0].length;
-                        const mainIdx = mainOpenMatch.index;
-                        const beforeMain = withoutScripts(content.slice(bodyStart, mainIdx));
-                        let bodyStyleMatch;
-                        const bodyStyleRe = /<style\b[^>]*>[\s\S]*?<\/style>/gi;
-                        while ((bodyStyleMatch = bodyStyleRe.exec(beforeMain)) !== null) {
-                          headStyles.push(bodyStyleMatch[0]);
-                        }
+                  }
+                  const containerSelector = stxConfig?.router?.container || "main";
+                  const containerRegion = findContainerRegion(fragment, containerSelector);
+                  const containerPath = new URL(req.url).pathname;
+                  if (!containerRegion && !warnedMissingContainer.has(containerPath)) {
+                    warnedMissingContainer.add(containerPath);
+                    console.warn(`[stx] No SPA swap container matching "${containerSelector}" in ${containerPath}. SPA navigation is disabled for links on this page; the full document will load instead. Add a matching element, or point router.container at one this page has.`);
+                  }
+                  const mainOpenMatch = containerRegion ? { 0: containerRegion.openTag, index: containerRegion.openIndex } : null;
+                  const mainCloseIdx = containerRegion ? containerRegion.end : -1;
+                  if (mainOpenMatch && mainCloseIdx !== -1) {
+                    const bodyMatch = content.match(/<body\b[^>]*>/i);
+                    if (bodyMatch) {
+                      const bodyStart = bodyMatch.index + bodyMatch[0].length;
+                      const mainIdx = mainOpenMatch.index;
+                      const beforeMain = withoutScripts(content.slice(bodyStart, mainIdx));
+                      let bodyStyleMatch;
+                      const bodyStyleRe = /<style\b[^>]*>[\s\S]*?<\/style>/gi;
+                      while ((bodyStyleMatch = bodyStyleRe.exec(beforeMain)) !== null) {
+                        headStyles.push(bodyStyleMatch[0]);
                       }
-                      containerAttrs = mainOpenMatch[0].replace(new RegExp(`^<${containerRegion.tagName}\\b`, "i"), "").replace(/\/?>$/, "").trim();
-                      const mainStart = mainOpenMatch.index + mainOpenMatch[0].length;
-                      mainContentStart = mainStart;
-                      mainContentEnd = mainCloseIdx;
-                      fragment = fragment.slice(mainStart, mainCloseIdx).trim();
-                    }
-                    const externalPageScripts = containerRegion ? externalScriptsOutsideContainer(content, containerRegion) : [];
-                    const pageSetupScripts = [];
-                    const pageSetupScriptOffsets = new Set;
-                    const appendOutsideMainScript = (match) => {
-                      const offset = match.index;
-                      const insideMain = mainContentStart !== -1 && offset >= mainContentStart && offset < mainContentEnd;
-                      if (insideMain || pageSetupScriptOffsets.has(offset))
-                        return;
-                      if (mainContentStart !== -1 && isChromeInstanceScript(content, match[0], mainContentStart, mainContentEnd))
-                        return;
-                      pageSetupScriptOffsets.add(offset);
-                      pageSetupScripts.push(match[0]);
-                    };
-                    const routeParamsRe = /<script\b[^>]*data-stx-route-params[^>]*>[\s\S]*?<\/script>/gi;
-                    let setupMatch;
-                    while ((setupMatch = routeParamsRe.exec(content)) !== null) {
-                      appendOutsideMainScript(setupMatch);
                     }
-                    const allScriptRe = /<script\b[^>]*data-stx-scoped[^>]*>[\s\S]*?<\/script>/gi;
-                    while ((setupMatch = allScriptRe.exec(content)) !== null) {
-                      const scriptContent = setupMatch[0];
-                      if (scriptContent.includes("__stx_early_mounts"))
-                        continue;
-                      if (scriptContent.includes("data-stx-reactive") && scriptContent.includes("window.__stx_reactive"))
-                        continue;
-                      appendOutsideMainScript(setupMatch);
-                    }
-                    const bridgeInitRe = /<script\b[^>]*data-stx-reactive[^>]*>(?![\s\S]*window\.__stx_reactive)[\s\S]*?<\/script>/gi;
-                    while ((setupMatch = bridgeInitRe.exec(content)) !== null) {
-                      appendOutsideMainScript(setupMatch);
-                    }
-                    fragment = fragment.replace(/<script data-stx-scoped>\s*;?\(function\(\)\s*\{[\s\S]*?<\/script>/g, "");
-                    const clearStale = "<script data-stx-page>if(window.stx)window.stx._latestSetup=null;</script>";
-                    const inlinePageScripts = pageSetupScripts.filter((script) => !externalPageScripts.includes(script));
-                    const componentFactoryScripts = inlinePageScripts.filter((script) => script.includes("data-stx-component-factories"));
-                    const trailingPageScripts = inlinePageScripts.filter((script) => !script.includes("data-stx-component-factories"));
-                    fragment = `${headStyles.join(`
+                    containerAttrs = mainOpenMatch[0].replace(new RegExp(`^<${containerRegion.tagName}\\b`, "i"), "").replace(/\/?>$/, "").trim();
+                    const mainStart = mainOpenMatch.index + mainOpenMatch[0].length;
+                    mainContentStart = mainStart;
+                    mainContentEnd = mainCloseIdx;
+                    fragment = fragment.slice(mainStart, mainCloseIdx).trim();
+                  }
+                  const externalPageScripts = containerRegion ? externalScriptsOutsideContainer(content, containerRegion) : [];
+                  const pageSetupScripts = [];
+                  const pageSetupScriptOffsets = new Set;
+                  const appendOutsideMainScript = (match) => {
+                    const offset = match.index;
+                    const insideMain = mainContentStart !== -1 && offset >= mainContentStart && offset < mainContentEnd;
+                    if (insideMain || pageSetupScriptOffsets.has(offset))
+                      return;
+                    if (mainContentStart !== -1 && isChromeInstanceScript(content, match[0], mainContentStart, mainContentEnd))
+                      return;
+                    pageSetupScriptOffsets.add(offset);
+                    pageSetupScripts.push(match[0]);
+                  };
+                  const routeParamsRe = /<script\b[^>]*data-stx-route-params[^>]*>[\s\S]*?<\/script>/gi;
+                  let setupMatch;
+                  while ((setupMatch = routeParamsRe.exec(content)) !== null) {
+                    appendOutsideMainScript(setupMatch);
+                  }
+                  const allScriptRe = /<script\b[^>]*data-stx-scoped[^>]*>[\s\S]*?<\/script>/gi;
+                  while ((setupMatch = allScriptRe.exec(content)) !== null) {
+                    const scriptContent = setupMatch[0];
+                    if (scriptContent.includes("__stx_early_mounts"))
+                      continue;
+                    if (scriptContent.includes("data-stx-reactive") && scriptContent.includes("window.__stx_reactive"))
+                      continue;
+                    appendOutsideMainScript(setupMatch);
+                  }
+                  const bridgeInitRe = /<script\b[^>]*data-stx-reactive[^>]*>(?![\s\S]*window\.__stx_reactive)[\s\S]*?<\/script>/gi;
+                  while ((setupMatch = bridgeInitRe.exec(content)) !== null) {
+                    appendOutsideMainScript(setupMatch);
+                  }
+                  fragment = fragment.replace(/<script data-stx-scoped>\s*;?\(function\(\)\s*\{[\s\S]*?<\/script>/g, "");
+                  const clearStale = "<script data-stx-page>if(window.stx)window.stx._latestSetup=null;</script>";
+                  const inlinePageScripts = pageSetupScripts.filter((script) => !externalPageScripts.includes(script));
+                  const componentFactoryScripts = inlinePageScripts.filter((script) => script.includes("data-stx-component-factories"));
+                  const trailingPageScripts = inlinePageScripts.filter((script) => !script.includes("data-stx-component-factories"));
+                  fragment = `${headStyles.join(`
 `)}
 ${externalPageScripts.join(`
 `)}
@@ -11179,232 +11189,285 @@ ${fragment}
 ${clearStale}
 ${trailingPageScripts.join(`
 `)}`;
-                    const titleMatch = content.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
-                    const pageTitle = titleMatch ? decodeTitleEntities(titleMatch[1].trim()) : "";
-                    const shipsRuntime = content.includes("data-stx-runtime");
-                    return new Response(fragment, {
-                      status: isRenderFailure(content) ? 500 : responseStatus,
-                      headers: {
-                        "Content-Type": "text/html; charset=utf-8",
-                        "X-STX-Fragment": "true",
-                        "X-STX-Layout": pageLayout,
-                        "X-STX-Layout-Group": pageLayoutGroup,
-                        "X-STX-Runtime": shipsRuntime ? "true" : "false",
-                        ...pageTitle && { "X-STX-Title": encodeURIComponent(pageTitle) },
-                        [BUILD_ID_HEADER]: getBuildId(),
-                        ...containerAttrs && { "X-STX-Container-Attrs": encodeURIComponent(containerAttrs) },
-                        ...spaNavVaryHeaders(),
-                        "Cache-Control": FRAGMENT_CACHE_CONTROL,
-                        ...corsHeaders
+                  const titleMatch = content.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+                  const pageTitle = titleMatch ? decodeTitleEntities(titleMatch[1].trim()) : "";
+                  const shipsRuntime = content.includes("data-stx-runtime");
+                  return new Response(fragment, {
+                    status: isRenderFailure(content) ? 500 : responseStatus,
+                    headers: {
+                      "Content-Type": "text/html; charset=utf-8",
+                      "X-STX-Fragment": "true",
+                      "X-STX-Layout": pageLayout,
+                      "X-STX-Layout-Group": pageLayoutGroup,
+                      "X-STX-Runtime": shipsRuntime ? "true" : "false",
+                      ...pageTitle && { "X-STX-Title": encodeURIComponent(pageTitle) },
+                      [BUILD_ID_HEADER]: getBuildId(),
+                      ...containerAttrs && { "X-STX-Container-Attrs": encodeURIComponent(containerAttrs) },
+                      ...spaNavVaryHeaders(),
+                      "Cache-Control": FRAGMENT_CACHE_CONTROL,
+                      ...corsHeaders
+                    }
+                  });
+                }
+                let cleaned = content;
+                let runtimeCount = 0;
+                cleaned = content.replace(/<script data-stx-scoped>\(function\(\)\{'use strict';var cloakStyle[\s\S]*?<\/script>/g, (match) => {
+                  runtimeCount++;
+                  return runtimeCount === 1 ? match : "";
+                });
+                const pageRenderFailed = isRenderFailure(cleaned);
+                if (pageRenderFailed) {
+                  console.error(`[stx] render failed for ${new URL(req.url).pathname} \u2014 serving 500`);
+                  for (const custom500 of ["/500", "/errors/500"]) {
+                    try {
+                      const errorPage = usableErrorPage(await getRoute(custom500, reqCtx));
+                      if (errorPage) {
+                        const isProd = isProductionServe();
+                        return new Response(isProd ? errorPage : injectHmrClient(errorPage), {
+                          status: 500,
+                          headers: {
+                            "Content-Type": "text/html; charset=utf-8",
+                            "Cache-Control": "no-store",
+                            ...corsHeaders
+                          }
+                        });
                       }
-                    });
+                    } catch {}
                   }
-                  let cleaned = content;
-                  let runtimeCount = 0;
-                  cleaned = content.replace(/<script data-stx-scoped>\(function\(\)\{'use strict';var cloakStyle[\s\S]*?<\/script>/g, (match) => {
-                    runtimeCount++;
-                    return runtimeCount === 1 ? match : "";
-                  });
-                  const pageRenderFailed = isRenderFailure(cleaned);
-                  if (pageRenderFailed) {
-                    console.error(`[stx] render failed for ${new URL(req.url).pathname} \u2014 serving 500`);
-                    for (const custom500 of ["/500", "/errors/500"]) {
-                      try {
-                        const errorPage = usableErrorPage(await getRoute(custom500, reqCtx));
-                        if (errorPage) {
-                          const isProd = isProductionServe();
-                          return new Response(isProd ? errorPage : injectHmrClient(errorPage), {
-                            status: 500,
-                            headers: {
-                              "Content-Type": "text/html; charset=utf-8",
-                              "Cache-Control": "no-store",
-                              ...corsHeaders
-                            }
-                          });
-                        }
-                      } catch {}
+                }
+                const pageHeaders = new Headers({
+                  "Content-Type": "text/html; charset=utf-8",
+                  ...spaNavVaryHeaders(),
+                  "Cache-Control": "no-store",
+                  ...corsHeaders
+                });
+                for (const [name, value] of Object.entries(reqCtx.responseHeaders ?? {}))
+                  pageHeaders.set(name, value);
+                for (const cookie of reqCtx.actionCookies ?? [])
+                  pageHeaders.append("Set-Cookie", cookie);
+                return new Response(injectHmrClient(cleaned), {
+                  status: pageRenderFailed ? 500 : responseStatus,
+                  headers: pageHeaders
+                });
+              }
+              if (!isStaticAssetPath(path)) {
+                const contentWithExt = await getRoute(`${path}.html`, reqCtx);
+                if (contentWithExt) {
+                  return new Response(injectHmrClient(contentWithExt), {
+                    status: reqCtx.responseStatus ?? 200,
+                    headers: {
+                      "Content-Type": "text/html; charset=utf-8",
+                      "Cache-Control": "no-store",
+                      ...corsHeaders
                     }
-                  }
-                  const pageHeaders = new Headers({
-                    "Content-Type": "text/html; charset=utf-8",
-                    ...spaNavVaryHeaders(),
-                    "Cache-Control": "no-store",
-                    ...corsHeaders
-                  });
-                  for (const [name, value] of Object.entries(reqCtx.responseHeaders ?? {}))
-                    pageHeaders.set(name, value);
-                  for (const cookie of reqCtx.actionCookies ?? [])
-                    pageHeaders.append("Set-Cookie", cookie);
-                  return new Response(injectHmrClient(cleaned), {
-                    status: pageRenderFailed ? 500 : responseStatus,
-                    headers: pageHeaders
                   });
                 }
-                if (!isStaticAssetPath(path)) {
-                  const contentWithExt = await getRoute(`${path}.html`, reqCtx);
-                  if (contentWithExt) {
-                    return new Response(injectHmrClient(contentWithExt), {
-                      status: reqCtx.responseStatus ?? 200,
+              }
+              if (path.startsWith("/chunk-") || path.endsWith(".js") || path.endsWith(".css")) {
+                try {
+                  const buildFile = Bun.file(stateDir(process20.cwd(), path));
+                  if (await buildFile.exists()) {
+                    const ext = path.split(".").pop()?.toLowerCase();
+                    const contentType = ext === "css" ? "text/css" : ext === "js" ? "application/javascript" : "text/plain";
+                    return new Response(buildFile, {
                       headers: {
-                        "Content-Type": "text/html; charset=utf-8",
-                        "Cache-Control": "no-store",
-                        ...corsHeaders
+                        "Content-Type": contentType,
+                        "Cache-Control": "no-store"
                       }
                     });
                   }
+                } catch {}
+              }
+              if (path.startsWith("/assets/") || path.startsWith("/resources/assets/")) {
+                await ensureAssets();
+                let assetPathname;
+                try {
+                  assetPathname = decodeURIComponent(path);
+                } catch {
+                  return new Response("Invalid asset path", { status: 400 });
                 }
-                if (path.startsWith("/chunk-") || path.endsWith(".js") || path.endsWith(".css")) {
+                if (!isSafeAssetPath(assetPathname))
+                  return new Response("Invalid asset path", { status: 400 });
+                for (const assetPath of assetRequestPaths(assetPathname)) {
                   try {
-                    const buildFile = Bun.file(stateDir(process20.cwd(), path));
-                    if (await buildFile.exists()) {
-                      const ext = path.split(".").pop()?.toLowerCase();
-                      const contentType = ext === "css" ? "text/css" : ext === "js" ? "application/javascript" : "text/plain";
-                      return new Response(buildFile, {
+                    const filePath = nodePath.resolve(process20.cwd(), `.${assetPath}`);
+                    const file = Bun.file(filePath);
+                    if (await file.exists()) {
+                      const ext = getAssetExtension(assetPath);
+                      if (isBundledAssetExtension(ext))
+                        return bundleBrowserAsset(filePath);
+                      return new Response(file, {
                         headers: {
-                          "Content-Type": contentType,
+                          "Content-Type": staticContentType(assetPath),
                           "Cache-Control": "no-store"
                         }
                       });
                     }
-                  } catch {}
-                }
-                if (path.startsWith("/assets/") || path.startsWith("/resources/assets/")) {
-                  await ensureAssets();
-                  let assetPathname;
-                  try {
-                    assetPathname = decodeURIComponent(path);
                   } catch {
-                    return new Response("Invalid asset path", { status: 400 });
+                    continue;
                   }
-                  if (!isSafeAssetPath(assetPathname))
-                    return new Response("Invalid asset path", { status: 400 });
-                  for (const assetPath of assetRequestPaths(assetPathname)) {
+                }
+              }
+              if ((req.method === "GET" || req.method === "HEAD") && path !== "/") {
+                const publicRoot = nodePath.resolve(process20.cwd(), publicDir);
+                let safePathname;
+                try {
+                  safePathname = decodeURIComponent(path);
+                } catch {
+                  safePathname = path;
+                }
+                if (!safePathname.includes("\x00")) {
+                  const resolvedPath = nodePath.resolve(publicRoot, `.${safePathname}`);
+                  const isInsidePublicRoot = resolvedPath === publicRoot || resolvedPath.startsWith(`${publicRoot}${nodePath.sep}`);
+                  if (isInsidePublicRoot) {
                     try {
-                      const filePath = nodePath.resolve(process20.cwd(), `.${assetPath}`);
-                      const file = Bun.file(filePath);
+                      const file = Bun.file(resolvedPath);
                       if (await file.exists()) {
-                        const ext = getAssetExtension(assetPath);
-                        if (isBundledAssetExtension(ext))
-                          return bundleBrowserAsset(filePath);
-                        return new Response(file, {
-                          headers: {
-                            "Content-Type": staticContentType(assetPath),
-                            "Cache-Control": "no-store"
-                          }
-                        });
+                        const stat = await file.stat().catch(() => null);
+                        if (stat && !stat.isDirectory()) {
+                          return new Response(file, {
+                            headers: {
+                              "Content-Type": staticContentType(resolvedPath),
+                              "Cache-Control": staticCacheControl(resolvedPath)
+                            }
+                          });
+                        }
                       }
-                    } catch {
-                      continue;
-                    }
+                    } catch {}
                   }
                 }
-                if ((req.method === "GET" || req.method === "HEAD") && path !== "/") {
-                  const publicRoot = nodePath.resolve(process20.cwd(), publicDir);
-                  let safePathname;
-                  try {
-                    safePathname = decodeURIComponent(path);
-                  } catch {
-                    safePathname = path;
+              }
+              const isProd = isProductionServe();
+              if (path === "/favicon.ico" && !isProd) {
+                return new Response(null, { status: 204 });
+              }
+              if (isFileRequestPath(path)) {
+                return new Response("Not Found", {
+                  status: 404,
+                  headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" }
+                });
+              }
+              for (const custom404 of ["/404", "/errors/404"]) {
+                try {
+                  const customContent = await getRoute(custom404, reqCtx);
+                  if (customContent) {
+                    return new Response(isProd ? customContent : injectHmrClient(customContent), {
+                      status: 404,
+                      headers: { "Content-Type": "text/html; charset=utf-8" }
+                    });
                   }
-                  if (!safePathname.includes("\x00")) {
-                    const resolvedPath = nodePath.resolve(publicRoot, `.${safePathname}`);
-                    const isInsidePublicRoot = resolvedPath === publicRoot || resolvedPath.startsWith(`${publicRoot}${nodePath.sep}`);
-                    if (isInsidePublicRoot) {
-                      try {
-                        const file = Bun.file(resolvedPath);
-                        if (await file.exists()) {
-                          const stat = await file.stat().catch(() => null);
-                          if (stat && !stat.isDirectory()) {
-                            return new Response(file, {
-                              headers: {
-                                "Content-Type": staticContentType(resolvedPath),
-                                "Cache-Control": staticCacheControl(resolvedPath)
-                              }
-                            });
-                          }
-                        }
-                      } catch {}
+                } catch {}
+              }
+              let availableRoutes;
+              if (!isProd) {
+                const files = await discoverFiles();
+                availableRoutes = [];
+                for (const filePath of files) {
+                  let normalizedPath = filePath.replace(/^\.\//, "").replace(/\\/g, "/");
+                  for (const pattern of patterns) {
+                    const normalizedPattern = pattern.replace(/\\/g, "/").replace(/\/$/, "");
+                    if (normalizedPath.startsWith(`${normalizedPattern}/`)) {
+                      normalizedPath = normalizedPath.slice(normalizedPattern.length + 1);
+                      break;
                     }
                   }
-                }
-                const isProd = isProductionServe();
-                if (path === "/favicon.ico" && !isProd) {
-                  return new Response(null, { status: 204 });
-                }
-                if (isFileRequestPath(path)) {
-                  return new Response("Not Found", {
-                    status: 404,
-                    headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" }
-                  });
-                }
-                for (const custom404 of ["/404", "/errors/404"]) {
-                  try {
-                    const customContent = await getRoute(custom404, reqCtx);
-                    if (customContent) {
-                      return new Response(isProd ? customContent : injectHmrClient(customContent), {
-                        status: 404,
-                        headers: { "Content-Type": "text/html; charset=utf-8" }
-                      });
-                    }
-                  } catch {}
-                }
-                let availableRoutes;
-                if (!isProd) {
-                  const files = await discoverFiles();
-                  availableRoutes = [];
-                  for (const filePath of files) {
-                    let normalizedPath = filePath.replace(/^\.\//, "").replace(/\\/g, "/");
-                    for (const pattern of patterns) {
-                      const normalizedPattern = pattern.replace(/\\/g, "/").replace(/\/$/, "");
-                      if (normalizedPath.startsWith(`${normalizedPattern}/`)) {
-                        normalizedPath = normalizedPath.slice(normalizedPattern.length + 1);
-                        break;
-                      }
-                    }
-                    let route = normalizedPath.replace(/\.(stx|md|html)$/, "");
-                    if (route.startsWith("pages/")) {
-                      route = route.slice(6);
-                    }
-                    availableRoutes.push(route);
+                  let route = normalizedPath.replace(/\.(stx|md|html)$/, "");
+                  if (route.startsWith("pages/")) {
+                    route = route.slice(6);
                   }
+                  availableRoutes.push(route);
                 }
-                const notFoundHtml = render404Page({ path, routes: availableRoutes, isProduction: isProd });
-                return new Response(isProd ? notFoundHtml : injectHmrClient(notFoundHtml), {
-                  status: 404,
-                  headers: { "Content-Type": "text/html; charset=utf-8" }
-                });
-              } finally {
-                activeServeLocale = null;
-                activeServeSearch = "";
-                activeServeHost = "";
-                activeServeCookieHeader = "";
-                activeServeCookies = {};
-                activeServeIp = "";
-              }
-            })();
-            let _finalResp = await applyI18nToResponse(_i18nResp, i18nLocale ?? (i18nConfig?.defaultLocale ?? "en"), path);
-            if (mintedCsrfToken && responseTakesCsrfCookie(_finalResp)) {
-              try {
-                _finalResp.headers.append("Set-Cookie", csrfCookieHeader(mintedCsrfToken, req.url.startsWith("https://")));
-              } catch {
-                const headers = new Headers(_finalResp.headers);
-                headers.append("Set-Cookie", csrfCookieHeader(mintedCsrfToken, req.url.startsWith("https://")));
-                _finalResp = new Response(_finalResp.body, {
-                  status: _finalResp.status,
-                  statusText: _finalResp.statusText,
-                  headers
-                });
               }
+              const notFoundHtml = render404Page({ path, routes: availableRoutes, isProduction: isProd });
+              return new Response(isProd ? notFoundHtml : injectHmrClient(notFoundHtml), {
+                status: 404,
+                headers: { "Content-Type": "text/html; charset=utf-8" }
+              });
+            } finally {
+              activeServeLocale = null;
+              activeServeSearch = "";
+              activeServeHost = "";
+              activeServeCookieHeader = "";
+              activeServeCookies = {};
+              activeServeIp = "";
             }
-            if (options.onResponse) {
-              const hooked = await options.onResponse(req, _finalResp);
-              if (hooked instanceof Response)
-                return hooked;
+          })();
+          let _finalResp = await applyI18nToResponse(_i18nResp, i18nLocale ?? (i18nConfig?.defaultLocale ?? "en"), path);
+          if (mintedCsrfToken && responseTakesCsrfCookie(_finalResp)) {
+            try {
+              _finalResp.headers.append("Set-Cookie", csrfCookieHeader(mintedCsrfToken, req.url.startsWith("https://")));
+            } catch {
+              const headers = new Headers(_finalResp.headers);
+              headers.append("Set-Cookie", csrfCookieHeader(mintedCsrfToken, req.url.startsWith("https://")));
+              _finalResp = new Response(_finalResp.body, {
+                status: _finalResp.status,
+                statusText: _finalResp.statusText,
+                headers
+              });
             }
-            return _finalResp;
-          })());
+          }
+          if (options.onResponse) {
+            const hooked = await options.onResponse(req, _finalResp);
+            if (hooked instanceof Response)
+              return hooked;
+          }
+          return _finalResp;
+        })());
+      }
+    });
+  }
+  if (production && pageWarmup.enabled) {
+    const warmupStartedAt = performance.now();
+    const warming = warmPages();
+    const done = await settleWithin(warming, pageWarmup.budgetMs);
+    if (!done) {
+      console.warn(`[stx] page warm-up still running after ${formatSeconds(pageWarmup.budgetMs)}; binding now and finishing it in the background.`);
+    }
+    warming.then(({ pages, failed }) => {
+      if (!options.quiet)
+        console.log(`[stx] warmed ${pages} pages in ${formatSeconds(performance.now() - warmupStartedAt)}${failed ? ` (${failed} answered 5xx or failed)` : ""}`);
+    });
+  }
+  async function warmPages() {
+    const files = await discoverFiles();
+    const routes = [...new Set([
+      ...files.map(stxViewFileToRoutePath).filter((routePath) => routePath !== null),
+      ...discoveredPagePaths ?? [],
+      ...pageWarmup.paths
+    ])];
+    const warm = listen(0, false, "127.0.0.1");
+    let next = 0;
+    let failed = 0;
+    try {
+      await Promise.all(Array.from({ length: Math.min(pageWarmup.concurrency, routes.length) }, async () => {
+        while (next < routes.length) {
+          const routePath = routes[next++];
+          try {
+            const response = await fetch(`http://127.0.0.1:${warm.port}${routePath}`, {
+              headers: { [PAGE_WARMUP_HEADER]: "1", Accept: "text/html" },
+              redirect: "manual"
+            });
+            await response.arrayBuffer();
+            if (response.status >= 500)
+              failed++;
+          } catch {
+            failed++;
+          }
         }
-      });
+      }));
+    } finally {
+      warm.stop(true);
+    }
+    return { pages: routes.length, failed };
+  }
+  const portAutoIncrement = options.autoIncrementPort ?? true;
+  const maxPortAttempts = portAutoIncrement === false ? 1 : typeof portAutoIncrement === "number" ? Math.max(1, portAutoIncrement) : 10;
+  let actualPort = port;
+  let _server;
+  let lastServeError;
+  for (let attempt = 0;attempt < maxPortAttempts; attempt++) {
+    try {
+      _server = listen(actualPort, options.reusePort ?? false);
       break;
     } catch (err) {
       lastServeError = err;
@@ -11575,7 +11638,9 @@ async function projectUsesImageBuiltins(root) {
 export {
   CSRF_COOKIE,
   DEFAULT_IMAGE_WARMUP_BIND_BUDGET_MS,
+  DEFAULT_PAGE_WARMUP_BUDGET_MS,
   MODULE_BUNDLE_PATH,
+  PAGE_WARMUP_HEADER,
   ROUTE_PARAMS_PLACEHOLDER,
   SHARED_SCRIPT_PATH,
   boundedCache,
@@ -11602,6 +11667,7 @@ export {
   resolveDomainElsewhere,
   resolveDomainRoute,
   resolveImageWarmupBindBudget,
+  resolvePageWarmup,
   resolveServeOpenUrl,
   responseTakesCsrfCookie,
   routeSpecificity,