@vesk/vesk-cli 0.2.9 → 0.2.10

package/dist/cli.js

@@ -1605,8 +1605,11 @@ function buildRequestInit(options2) {
 }
 function resolveFetchUrl(url) {
   if (/^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith("//")) return url;
-  const reqUrl = g().__vesk_request?.url;
-  const base = typeof reqUrl === "string" && /^https?:\/\//i.test(reqUrl) ? reqUrl : g().__vesk_ssr_base_url || "";
+  const ctx2 = g().__vesk_request;
+  const resolver = ctx2 && typeof ctx2.resolveUrl === "function" ? ctx2.resolveUrl : null;
+  if (resolver) return resolver(url);
+  const reqUrl = ctx2?.url;
+  const base = typeof reqUrl === "string" && /^https?:\/\//i.test(reqUrl) ? reqUrl : globalThis.__vesk_ssr_base_url || "";
   if (base) return new URL(url, base).href;
   return url;
 }
@@ -1668,6 +1671,33 @@ async function runFetcher(handle2, timeout) {
 function sleep(ms) {
   return new Promise((resolve27) => setTimeout(resolve27, ms));
 }
+function streamText(res, into, onChunk) {
+  const decoder = new TextDecoder();
+  let total = "";
+  const emit = (text) => {
+    if (!text) return;
+    total += text;
+    if (into) setInto(into, total);
+    if (onChunk) onChunk(text, total);
+  };
+  const body = res.body;
+  if (body && typeof body.getReader === "function") {
+    const reader = body.getReader();
+    return (async () => {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        emit(decoder.decode(value, { stream: true }));
+      }
+      emit(decoder.decode());
+      return total;
+    })();
+  }
+  return res.text().then((text) => {
+    emit(text);
+    return total;
+  });
+}
 function settle(handle2, data2) {
   if (handle2.block !== null && is_destroyed(handle2.block)) return;
   if (handle2.into) setInto(handle2.into, data2);
@@ -1959,6 +1989,22 @@ var init_resource = __esm({
       ...options2,
       key: options2?.key ?? url
     });
+    useFetch.stream = (urlOrFn, options2) => {
+      const streamInto = options2?.into;
+      const streamOnChunk = options2?.onChunk;
+      const fetcher = (signal) => {
+        const url = typeof urlOrFn === "function" ? urlOrFn() : urlOrFn;
+        const init = buildRequestInit(options2 ?? {});
+        return doFetch(resolveFetchUrl(url), signal ? { ...init, signal } : init).then(async (res) => {
+          if (!res.ok) throw new HttpError(res.status, res.statusText);
+          return streamText(res, streamInto, streamOnChunk);
+        });
+      };
+      const key = options2?.key ?? (typeof urlOrFn === "string" ? urlOrFn : void 0);
+      const resource = useFetch(fetcher, { ...options2, key });
+      resource.into = streamInto;
+      return resource;
+    };
   }
 });
 
@@ -20205,7 +20251,7 @@ var init_request = __esm({
         });
       }
     };
-    VeskRequest = class extends ServerRequest {
+    VeskRequest = class _VeskRequest extends ServerRequest {
       _query;
       _ip;
       _protocol;
@@ -20223,6 +20269,21 @@ var init_request = __esm({
         this._body = null;
         this._bodyPromise = null;
         this._parsedUrl = null;
+        const cookieHeader = this.headers?.get("cookie") || "";
+        if (cookieHeader) {
+          for (const part of cookieHeader.split(";")) {
+            const eq = part.indexOf("=");
+            if (eq > 0) {
+              const name = part.slice(0, eq).trim();
+              const val = part.slice(eq + 1).trim();
+              try {
+                this._cookies[name] = decodeURIComponent(val);
+              } catch {
+                this._cookies[name] = val;
+              }
+            }
+          }
+        }
         Object.defineProperty(this, "body", {
           get: () => {
             if (!this._bodyPromise) {
@@ -20234,6 +20295,52 @@ var init_request = __esm({
           enumerable: true
         });
       }
+      /**
+       * The request's host header (honoring `x-forwarded-host` when
+       * setTrustProxy() is enabled). Falls back to the parsed URL host.
+       */
+      get host() {
+        const trust = this._security.trustProxy === true;
+        const fwd = trust ? this.headers?.get("x-forwarded-host") : void 0;
+        const header = typeof fwd === "string" && fwd ? fwd : this.headers?.get("host") || "";
+        if (header) return header;
+        return this.parsedUrl.host || "localhost";
+      }
+      /** Absolute origin (`protocol://host`) — the base for resolving relative URLs. */
+      get origin() {
+        return `${this.protocol}://${this.host}`;
+      }
+      /**
+       * Resolves a possibly-relative URL against this request's own origin.
+       * Absolute URLs (scheme or protocol-relative `//`) pass through untouched.
+       * Used by the runtime SSR fetcher (`resolveFetchUrl`) to make in-app
+       * fetches (e.g. `/api/...`) work during server rendering.
+       */
+      resolveUrl(url) {
+        if (/^[a-z][a-z0-9+.-]*:/i.test(url) || url.startsWith("//")) return url;
+        return new URL(url, this.origin).href;
+      }
+      /** locals map accessors so <VeskRequest> can double as the middleware ctx. */
+      set(key, value) {
+        this._locals[key] = value;
+      }
+      get(key) {
+        return this._locals[key];
+      }
+      /**
+       * Wraps an inbound platform `Request` (from dev/prod/platform handlers)
+       * into a VeskRequest carrying the same method, headers and cookie store.
+       * Params/locals can be seeded so useParams()/useRequest() work in renders.
+       */
+      static from(request, init) {
+        const vreq = new _VeskRequest(request instanceof Request ? request.url : String(request), {
+          method: request.method,
+          headers: request.headers
+        });
+        if (init?.params) vreq._params = { ...init.params };
+        if (init?.locals) vreq._locals = { ...init.locals };
+        return vreq;
+      }
       get parsedUrl() {
         if (!this._parsedUrl) {
           this._parsedUrl = new URL(this.url);
@@ -20437,6 +20544,10 @@ var init_request = __esm({
           headers: { "Content-Type": "text/html; charset=utf-8", ...init?.headers }
         });
       }
+      /** Chunked streaming response over a `ReadableStream` body (SSE, file streams, …). */
+      static stream(readable, init) {
+        return new __VeskResponse(readable, init);
+      }
     };
     VeskResponse = new Proxy(_VeskResponse, {
       apply(target, _thisArg, args2) {
@@ -22803,6 +22914,84 @@ function wireCopyHandlers(root3) {
 function mdIsSSR() {
   return typeof document === "undefined";
 }
+function stringEndsWith(s, suffix) {
+  if (suffix.length > s.length) return false;
+  for (let i = 0; i < suffix.length; i++) {
+    if (s[s.length - suffix.length + i] !== suffix[i]) return false;
+  }
+  return true;
+}
+function isPublicMarkdownPath(v) {
+  if (typeof v !== "string") return false;
+  const s = v;
+  if (s.length < 2 || s.charCodeAt(0) !== 47) return false;
+  if (s.charCodeAt(1) === 47) return false;
+  for (let i = 0; i < s.length; i++) {
+    const c = s.charCodeAt(i);
+    if (c === 63 || c === 35 || c === 92) return false;
+  }
+  const lower = s.toLowerCase();
+  return stringEndsWith(lower, ".md") || stringEndsWith(lower, ".markdown");
+}
+function getMdPathCell(path) {
+  let cell = mdPathCells.get(path);
+  if (!cell) {
+    cell = tracked(void 0);
+    mdPathCells.set(path, cell);
+  }
+  return cell;
+}
+function ensureMdPathLoaded(path) {
+  if (mdPathCache.has(path) || mdPathInflight.has(path)) return;
+  const ssr = getSsrData("md:" + path);
+  if (typeof ssr === "string") {
+    mdPathCache.set(path, ssr);
+    return;
+  }
+  mdPathInflight.add(path);
+  fetch(path).then((r) => r.ok ? r.text() : Promise.reject(r)).then((text) => {
+    mdPathCache.set(path, text);
+    set(getMdPathCell(path), text);
+  }).catch(() => {
+    mdPathCache.set(path, null);
+    set(getMdPathCell(path), null);
+  }).finally(() => {
+    mdPathInflight.delete(path);
+  });
+}
+function readServerMdPath(path) {
+  const hook = globalThis.__vsk_md_read_file;
+  if (typeof hook !== "function") return null;
+  try {
+    const out = hook(path);
+    if (typeof out === "string") return out;
+  } catch {
+  }
+  return null;
+}
+function resolveMdSource(value) {
+  const s = String(value ?? "");
+  if (!isPublicMarkdownPath(s)) return s;
+  if (mdIsSSR()) {
+    const content = readServerMdPath(s);
+    if (content !== null) {
+      setSsrData("md:" + s, content);
+      return content;
+    }
+    return s;
+  }
+  ensureMdPathLoaded(s);
+  const cached = mdPathCache.get(s);
+  return cached === void 0 || cached === null ? s : cached;
+}
+function streamCellFrom(rawContent) {
+  if (rawContent === null || typeof rawContent !== "object") return null;
+  const into = rawContent.into;
+  if (into !== null && typeof into === "object" && typeof into.get === "function") {
+    return into;
+  }
+  return null;
+}
 function buildHtml(content, props) {
   const global = getMdPolicy();
   const mode = props.html || global.html;
@@ -22839,8 +23028,10 @@ function buildHtml(content, props) {
 }
 function Md(props, _registry, hydrate) {
   const rawContent = props.content;
-  const content = String(unwrapMaybeCell(rawContent) ?? "");
-  const html = buildHtml(content, props);
+  const streamTarget = streamCellFrom(rawContent);
+  const contentCell = streamTarget ?? rawContent;
+  const content = String(unwrapMaybeCell(contentCell) ?? "");
+  const html = buildHtml(resolveMdSource(content), props);
   const classNameRaw = props.className != null ? String(props.className) : props.class != null ? String(props.class) : "";
   const themeClass = props.theme === "dark" ? " vesk-md-dark" : "";
   const className = `vesk-md${themeClass}${classNameRaw ? " " + classNameRaw : ""}`;
@@ -22851,7 +23042,8 @@ function Md(props, _registry, hydrate) {
   const propFg = safeColorValue(String(props.codeFg ?? ""));
   if (propFg && propFg !== "none") wrapperParts.push(`--md-code-fg:${propFg}`);
   const wrapperStyle = wrapperParts.length > 0 ? escapeHtml3(wrapperParts.join(";")) : "";
-  const reactive = isCell(rawContent);
+  const reactive = isCell(contentCell);
+  const pathMode = isPublicMarkdownPath(content);
   if (mdIsSSR()) {
     const attrs = className ? ` class="${escapeHtml3(className)}"` : "";
     const styleAttr = style || wrapperStyle ? ` style="${[wrapperStyle, style.split('"').join("&quot;")].filter(Boolean).join(";")}"` : "";
@@ -22863,11 +23055,19 @@ function Md(props, _registry, hydrate) {
       const existing = hydrate.root.querySelector("div");
       if (existing) el = existing;
     }
-    el.innerHTML = html;
+    const claimed = !!el.parentNode;
+    if (pathMode && claimed) {
+      el.setAttribute("data-vsk-md-ssr", "1");
+      if (mdPathCache.has(content)) el.innerHTML = html;
+    } else {
+      el.innerHTML = html;
+    }
     el.className = className;
     el.style.cssText = [wrapperStyle, style].filter(Boolean).join(";");
     wireCopyHandlers(el);
-    if (reactive) subscribeContent(el, rawContent, props);
+    if (reactive || pathMode) {
+      subscribeContent(el, contentCell, props, pathMode && claimed ? { trustInitialSsr: true, initialValue: content } : void 0);
+    }
     if (el.parentNode) return document.createDocumentFragment();
     return el;
   }
@@ -22876,21 +23076,41 @@ function Md(props, _registry, hydrate) {
   div.className = className;
   div.style.cssText = [wrapperStyle, style].filter(Boolean).join(";");
   wireCopyHandlers(div);
-  if (reactive) subscribeContent(div, rawContent, props);
+  if (reactive || pathMode) subscribeContent(div, contentCell, props);
   return div;
 }
-function subscribeContent(el, rawContent, props) {
+function subscribeContent(el, rawContent, props, opts) {
+  const trust = opts?.trustInitialSsr === true;
+  const initial = opts?.initialValue;
+  let ran = false;
   effect(() => {
     const value = String(unwrapMaybeCell(rawContent) ?? "");
-    el.innerHTML = buildHtml(value, props);
+    if (isPublicMarkdownPath(value)) {
+      const known = getSsrData("md:" + value) !== void 0 || mdPathCache.has(value);
+      ensureMdPathLoaded(value);
+      const cell = getMdPathCell(value);
+      get(cell);
+      if (trust && !ran && value === initial && !known) {
+        ran = true;
+        return;
+      }
+      ran = true;
+      el.innerHTML = buildHtml(resolveMdSource(value), props);
+      wireCopyHandlers(el);
+      return;
+    }
+    ran = true;
+    el.innerHTML = buildHtml(resolveMdSource(value), props);
     wireCopyHandlers(el);
   });
 }
-var COLOR_FUNCS, SAFE_SCHEMES, KW_JS, KW_VSK, LIT_JS, KW_PY, LIT_PY, KW_GO, LIT_GO, KW_RUST, LIT_RUST, KW_SQL, KW_BASH, NAMED_ENTITIES, URL_ATTRS, MD_DEFAULT_ALLOW_TAGS, MD_BASE_CSS, __globalMode, __globalAllowTags, __sessionWarnings, __warnedKeys, __suppressMdConsoleWarnings;
+var COLOR_FUNCS, SAFE_SCHEMES, KW_JS, KW_VSK, LIT_JS, KW_PY, LIT_PY, KW_GO, LIT_GO, KW_RUST, LIT_RUST, KW_SQL, KW_BASH, NAMED_ENTITIES, URL_ATTRS, MD_DEFAULT_ALLOW_TAGS, MD_BASE_CSS, __globalMode, __globalAllowTags, __sessionWarnings, __warnedKeys, __suppressMdConsoleWarnings, mdPathCache, mdPathCells, mdPathInflight;
 var init_md = __esm({
   "../runtime/src/md.ts"() {
     "use strict";
     init_ripple_blocks();
+    init_ripple_runtime();
+    init_resource();
     COLOR_FUNCS = /* @__PURE__ */ new Set(["rgb", "rgba", "hsl", "hsla", "hwb", "lab", "lch", "oklab", "oklch", "color", "color-mix"]);
     SAFE_SCHEMES = ["http:", "https:", "mailto:", "tel:"];
     KW_JS = /* @__PURE__ */ new Set([
@@ -23292,6 +23512,9 @@ var init_md = __esm({
     __sessionWarnings = [];
     __warnedKeys = /* @__PURE__ */ new Set();
     __suppressMdConsoleWarnings = false;
+    mdPathCache = /* @__PURE__ */ new Map();
+    mdPathCells = /* @__PURE__ */ new Map();
+    mdPathInflight = /* @__PURE__ */ new Set();
   }
 });
 
@@ -28316,6 +28539,7 @@ var init_server_render = __esm({
 
 // ../adapter/src/paths.ts
 import { resolve as resolve9, sep as sep2 } from "node:path";
+import { existsSync as existsSync8, statSync as statSync4, readFileSync as readFileSync9 } from "node:fs";
 function resolveWithin(baseDir, relPath) {
   const base = resolve9(baseDir);
   const target = resolve9(baseDir, relPath);
@@ -28323,6 +28547,24 @@ function resolveWithin(baseDir, relPath) {
   if (!target.startsWith(prefix)) return null;
   return target;
 }
+function installMdReadHook(publicDirs) {
+  const dirs = publicDirs.map((d) => resolve9(d));
+  globalThis.__vsk_md_read_file = (p) => {
+    for (const dir of dirs) {
+      try {
+        let rel = String(p);
+        while (rel.length > 0 && rel.charCodeAt(0) === 47) rel = rel.slice(1);
+        const abs = resolveWithin(dir, rel);
+        if (!abs) continue;
+        const lower = abs.toLowerCase();
+        if (!lower.endsWith(".md") && !lower.endsWith(".markdown")) continue;
+        if (existsSync8(abs) && statSync4(abs).isFile()) return readFileSync9(abs, "utf8");
+      } catch {
+      }
+    }
+    return null;
+  };
+}
 var init_paths = __esm({
   "../adapter/src/paths.ts"() {
     "use strict";
@@ -28337,12 +28579,12 @@ __export(static_exports, {
   generateSitemap: () => generateSitemap,
   generateSsgRoutes: () => generateSsgRoutes
 });
-import { mkdirSync as mkdirSync2, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync6, existsSync as existsSync10, writeFileSync as writeFileSync4, readFileSync as readFileSync11 } from "node:fs";
+import { mkdirSync as mkdirSync2, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync7, existsSync as existsSync11, writeFileSync as writeFileSync4, readFileSync as readFileSync12 } from "node:fs";
 import { resolve as resolve12, join as join7 } from "node:path";
 function copyStaticAssets2(publicDir, outDir2) {
   const targetDir = resolve12(outDir2, "static", "public");
   mkdirSync2(targetDir, { recursive: true });
-  if (!existsSync10(publicDir))
+  if (!existsSync11(publicDir))
     return;
   function copyDir(src2, dest) {
     mkdirSync2(dest, { recursive: true });
@@ -28350,7 +28592,7 @@ function copyStaticAssets2(publicDir, outDir2) {
     for (const entry of entries) {
       const srcPath = join7(src2, entry);
       const destPath = join7(dest, entry);
-      const st = statSync6(srcPath);
+      const st = statSync7(srcPath);
       if (st.isDirectory()) {
         copyDir(srcPath, destPath);
       } else {
@@ -28382,7 +28624,7 @@ async function generateSsgRoutes(routeTree, appDir, outDir2) {
     for (const node of nodes) {
       if (node.page) {
         const pagePath = resolve12(appDir, node.sourceDir, "page.vsk");
-        const src2 = readFileSync11(pagePath, "utf-8");
+        const src2 = readFileSync12(pagePath, "utf-8");
         const hasStaticProps = src2.includes("getStaticProps");
         const hasStaticPaths = src2.includes("getStaticPaths");
         if (hasStaticPaths) {
@@ -28482,12 +28724,12 @@ var image_pipeline_exports = {};
 __export(image_pipeline_exports, {
   optimizeImages: () => optimizeImages
 });
-import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync12, existsSync as existsSync11, readdirSync as readdirSync4, statSync as statSync7 } from "node:fs";
+import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, readFileSync as readFileSync13, existsSync as existsSync12, readdirSync as readdirSync4, statSync as statSync8 } from "node:fs";
 import { resolve as resolve13, extname as extname4, dirname as dirname8 } from "node:path";
 async function processImage(srcPath, outDir2, baseName) {
   const image = sharpFn ? sharpFn(srcPath) : null;
   if (!image) {
-    const original = readFileSync12(srcPath);
+    const original = readFileSync13(srcPath);
     for (const w of OUTPUT_WIDTHS) {
       const outputPath = resolve13(outDir2, `${baseName}-${w}w`);
       mkdirSync3(dirname8(outputPath), { recursive: true });
@@ -28526,13 +28768,13 @@ function collectImageRefs(appDir) {
     }
     for (const entry of entries) {
       const full = resolve13(dir, entry);
-      const st = statSync7(full);
+      const st = statSync8(full);
       if (st.isDirectory()) {
         if (entry.startsWith("."))
           continue;
         walk6(full);
       } else if (entry === "page.vsk") {
-        const src2 = readFileSync12(full, "utf-8");
+        const src2 = readFileSync13(full, "utf-8");
         const imgRegex = /<Image\s+src=["']([^"']+)["']/g;
         let m;
         while ((m = imgRegex.exec(src2)) !== null) {
@@ -28562,7 +28804,7 @@ async function optimizeImages(appDir, outDir2) {
     ];
     let srcPath = null;
     for (const p of possiblePaths) {
-      if (existsSync11(p)) {
+      if (existsSync12(p)) {
         srcPath = p;
         break;
       }
@@ -28609,7 +28851,7 @@ var seo_audit_exports = {};
 __export(seo_audit_exports, {
   runSeoAudit: () => runSeoAudit
 });
-import { readFileSync as readFileSync13, existsSync as existsSync12, readdirSync as readdirSync5, statSync as statSync8 } from "node:fs";
+import { readFileSync as readFileSync14, existsSync as existsSync13, readdirSync as readdirSync5, statSync as statSync9 } from "node:fs";
 import { resolve as resolve14 } from "node:path";
 function walkFiles(dir) {
   const results = [];
@@ -28621,7 +28863,7 @@ function walkFiles(dir) {
   }
   for (const entry of entries) {
     const full = resolve14(dir, entry);
-    const st = statSync8(full);
+    const st = statSync9(full);
     if (st.isDirectory()) {
       if (!entry.startsWith("."))
         results.push(...walkFiles(full));
@@ -28637,8 +28879,8 @@ function collectCombinedSource(appDir) {
   for (const pagePath of pages) {
     const dir = resolve14(pagePath, "..");
     const layoutPath = resolve14(dir, "layout.vsk");
-    const pageSrc = readFileSync13(pagePath, "utf-8");
-    const layoutSrc = existsSync12(layoutPath) ? readFileSync13(layoutPath, "utf-8") : "";
+    const pageSrc = readFileSync14(pagePath, "utf-8");
+    const layoutSrc = existsSync13(layoutPath) ? readFileSync14(layoutPath, "utf-8") : "";
     const combinedSrc = layoutSrc ? layoutSrc + "\n" + pageSrc : pageSrc;
     combined.push({
       path: pagePath,
@@ -28813,7 +29055,7 @@ var init_platform = __esm({
 });
 
 // ../adapter/src/platform-handler.ts
-import { existsSync as existsSync13 } from "node:fs";
+import { existsSync as existsSync14 } from "node:fs";
 import { resolve as resolve15, dirname as dirname9 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function routeName2(segments) {
@@ -28832,7 +29074,7 @@ function toId(s) {
 }
 function findCompilerSrc2() {
   const monorepo = resolve15(__dirname5, "..", "..", "..", "packages", "compiler", "dist");
-  if (existsSync13(monorepo)) return monorepo;
+  if (existsSync14(monorepo)) return monorepo;
   throw new Error('@vesk/compiler/dist not found \u2014 run "npm run build" first');
 }
 function generatePlatformHandlerSource(input) {
@@ -28901,7 +29143,7 @@ export async function handleRequest(request) {
     return new Response(null, { status: 308, headers: { Location: '/_vesk/static/public' + (pathname.endsWith('/') ? pathname + 'index.html' : pathname + '.html') } });
   }
 
-  let mwCtx = { params: {}, url, locals: {}, cookies: {}, request, set() {}, get() { return undefined; } };
+  let mwCtx = { params: {}, url, locals: {}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
   if (${hasMwLiteral}) {
     mwCtx = {
       request,
@@ -28909,6 +29151,7 @@ export async function handleRequest(request) {
       url,
       locals: {},
       cookies: typeof parseCookies !== 'undefined' ? parseCookies(request.headers.get('cookie') || '') : {},
+      resolveUrl(u) { return new URL(u, request.url).href; },
       set(key, value) { this.locals[key] = value; },
       get(key) { return this.locals[key]; },
     };
@@ -29052,11 +29295,11 @@ import {
   mkdirSync as mkdirSync4,
   copyFileSync as copyFileSync3,
   readdirSync as readdirSync6,
-  statSync as statSync9,
-  existsSync as existsSync14,
+  statSync as statSync10,
+  existsSync as existsSync15,
   writeFileSync as writeFileSync6,
   rmSync,
-  readFileSync as readFileSync14
+  readFileSync as readFileSync15
 } from "node:fs";
 import { resolve as resolve16, join as join8, extname as extname5, dirname as dirname10 } from "node:path";
 function ensureCleanDir(dir) {
@@ -29064,12 +29307,12 @@ function ensureCleanDir(dir) {
   mkdirSync4(dir, { recursive: true });
 }
 function copyDirContents(srcDir, destDir) {
-  if (!existsSync14(srcDir)) return;
+  if (!existsSync15(srcDir)) return;
   mkdirSync4(destDir, { recursive: true });
   for (const entry of readdirSync6(srcDir)) {
     const srcPath = join8(srcDir, entry);
     const destPath = join8(destDir, entry);
-    if (statSync9(srcPath).isDirectory()) {
+    if (statSync10(srcPath).isDirectory()) {
       copyDirContents(srcPath, destPath);
     } else {
       mkdirSync4(dirname10(destPath), { recursive: true });
@@ -29084,22 +29327,22 @@ function writeFile(path, content) {
 function writePlatformStatic(buildStaticDir, platformStaticDir) {
   mkdirSync4(platformStaticDir, { recursive: true });
   const publicDir = resolve16(buildStaticDir, "public");
-  if (existsSync14(publicDir)) {
+  if (existsSync15(publicDir)) {
     copyDirContents(publicDir, platformStaticDir);
   }
   const assetsDir = resolve16(platformStaticDir, "_vesk", "static");
   copyDirContents(buildStaticDir, assetsDir);
   const runtimeAlias = resolve16(platformStaticDir, "_vesk", "runtime.js");
   const clientPath = resolve16(buildStaticDir, "client.js");
-  if (existsSync14(clientPath)) {
+  if (existsSync15(clientPath)) {
     mkdirSync4(dirname10(runtimeAlias), { recursive: true });
     copyFileSync3(clientPath, runtimeAlias);
   }
 }
 function writePrerenderedStatic(prerenderedRoutes, platformStaticDir) {
   for (const route of prerenderedRoutes) {
-    if (!existsSync14(route.html)) continue;
-    const content = readFileSync14(route.html);
+    if (!existsSync15(route.html)) continue;
+    const content = readFileSync15(route.html);
     const htmlRel = route.path === "/" ? "index.html" : `${route.path.replace(/^\//, "")}.html`;
     const target = resolve16(platformStaticDir, "_vesk", "static", "public", htmlRel);
     writeFile(target, content);
@@ -29111,15 +29354,15 @@ function writePrerenderedStatic(prerenderedRoutes, platformStaticDir) {
 }
 function listStaticDir(dir) {
   const out = [];
-  if (!existsSync14(dir)) return out;
+  if (!existsSync15(dir)) return out;
   function walk6(d, prefix) {
     for (const entry of readdirSync6(d)) {
       const full = join8(d, entry);
       const rel = prefix ? `${prefix}/${entry}` : entry;
-      if (statSync9(full).isDirectory()) {
+      if (statSync10(full).isDirectory()) {
         walk6(full, rel);
       } else {
-        out.push({ rel, buffer: readFileSync14(full) });
+        out.push({ rel, buffer: readFileSync15(full) });
       }
     }
   }
@@ -31406,6 +31649,95 @@ function wireCopyHandlers2(root3) {
 function mdIsSSR2() {
   return typeof document === "undefined";
 }
+function stringEndsWith2(s, suffix) {
+  if (suffix.length > s.length)
+    return false;
+  for (let i = 0; i < suffix.length; i++) {
+    if (s[s.length - suffix.length + i] !== suffix[i])
+      return false;
+  }
+  return true;
+}
+function isPublicMarkdownPath2(v) {
+  if (typeof v !== "string")
+    return false;
+  const s = v;
+  if (s.length < 2 || s.charCodeAt(0) !== 47)
+    return false;
+  if (s.charCodeAt(1) === 47)
+    return false;
+  for (let i = 0; i < s.length; i++) {
+    const c = s.charCodeAt(i);
+    if (c === 63 || c === 35 || c === 92)
+      return false;
+  }
+  const lower = s.toLowerCase();
+  return stringEndsWith2(lower, ".md") || stringEndsWith2(lower, ".markdown");
+}
+function getMdPathCell2(path) {
+  let cell = mdPathCells2.get(path);
+  if (!cell) {
+    cell = tracked(void 0);
+    mdPathCells2.set(path, cell);
+  }
+  return cell;
+}
+function ensureMdPathLoaded2(path) {
+  if (mdPathCache2.has(path) || mdPathInflight2.has(path))
+    return;
+  const ssr = getSsrData("md:" + path);
+  if (typeof ssr === "string") {
+    mdPathCache2.set(path, ssr);
+    return;
+  }
+  mdPathInflight2.add(path);
+  fetch(path).then((r) => r.ok ? r.text() : Promise.reject(r)).then((text) => {
+    mdPathCache2.set(path, text);
+    set(getMdPathCell2(path), text);
+  }).catch(() => {
+    mdPathCache2.set(path, null);
+    set(getMdPathCell2(path), null);
+  }).finally(() => {
+    mdPathInflight2.delete(path);
+  });
+}
+function readServerMdPath2(path) {
+  const hook = globalThis.__vsk_md_read_file;
+  if (typeof hook !== "function")
+    return null;
+  try {
+    const out = hook(path);
+    if (typeof out === "string")
+      return out;
+  } catch {
+  }
+  return null;
+}
+function resolveMdSource2(value) {
+  const s = String(value ?? "");
+  if (!isPublicMarkdownPath2(s))
+    return s;
+  if (mdIsSSR2()) {
+    const content = readServerMdPath2(s);
+    if (content !== null) {
+      setSsrData("md:" + s, content);
+      return content;
+    }
+    return s;
+  }
+  ensureMdPathLoaded2(s);
+  const cached = mdPathCache2.get(s);
+  return cached === void 0 || cached === null ? s : cached;
+}
+function streamCellFrom2(rawContent) {
+  if (rawContent === null || typeof rawContent !== "object")
+    return null;
+  const into = rawContent.into;
+  if (into !== null && typeof into === "object" && typeof into.get === "function") {
+    return into;
+  }
+  return null;
+}
 function buildHtml2(content, props) {
   const global = getMdPolicy2();
   const mode = props.html || global.html;
@@ -31441,8 +31773,10 @@ function buildHtml2(content, props) {
 }
 function Md2(props, _registry, hydrate) {
   const rawContent = props.content;
-  const content = String(unwrapMaybeCell2(rawContent) ?? "");
-  const html = buildHtml2(content, props);
+  const streamTarget = streamCellFrom2(rawContent);
+  const contentCell = streamTarget ?? rawContent;
+  const content = String(unwrapMaybeCell2(contentCell) ?? "");
+  const html = buildHtml2(resolveMdSource2(content), props);
   const classNameRaw = props.className != null ? String(props.className) : props.class != null ? String(props.class) : "";
   const themeClass = props.theme === "dark" ? " vesk-md-dark" : "";
   const className = `vesk-md${themeClass}${classNameRaw ? " " + classNameRaw : ""}`;
@@ -31455,7 +31789,8 @@ function Md2(props, _registry, hydrate) {
   if (propFg && propFg !== "none")
     wrapperParts.push(`--md-code-fg:${propFg}`);
   const wrapperStyle = wrapperParts.length > 0 ? escapeHtml6(wrapperParts.join(";")) : "";
-  const reactive = isCell2(rawContent);
+  const reactive = isCell2(contentCell);
+  const pathMode = isPublicMarkdownPath2(content);
   if (mdIsSSR2()) {
     const attrs = className ? ` class="${escapeHtml6(className)}"` : "";
     const styleAttr = style || wrapperStyle ? ` style="${[wrapperStyle, style.split('"').join("&quot;")].filter(Boolean).join(";")}"` : "";
@@ -31468,12 +31803,20 @@ function Md2(props, _registry, hydrate) {
       if (existing)
         el = existing;
     }
-    el.innerHTML = html;
+    const claimed = !!el.parentNode;
+    if (pathMode && claimed) {
+      el.setAttribute("data-vsk-md-ssr", "1");
+      if (mdPathCache2.has(content))
+        el.innerHTML = html;
+    } else {
+      el.innerHTML = html;
+    }
     el.className = className;
     el.style.cssText = [wrapperStyle, style].filter(Boolean).join(";");
     wireCopyHandlers2(el);
-    if (reactive)
-      subscribeContent2(el, rawContent, props);
+    if (reactive || pathMode) {
+      subscribeContent2(el, contentCell, props, pathMode && claimed ? { trustInitialSsr: true, initialValue: content } : void 0);
+    }
     if (el.parentNode)
       return document.createDocumentFragment();
     return el;
@@ -31483,22 +31826,42 @@ function Md2(props, _registry, hydrate) {
   div.className = className;
   div.style.cssText = [wrapperStyle, style].filter(Boolean).join(";");
   wireCopyHandlers2(div);
-  if (reactive)
-    subscribeContent2(div, rawContent, props);
+  if (reactive || pathMode)
+    subscribeContent2(div, contentCell, props);
   return div;
 }
-function subscribeContent2(el, rawContent, props) {
+function subscribeContent2(el, rawContent, props, opts) {
+  const trust = opts?.trustInitialSsr === true;
+  const initial = opts?.initialValue;
+  let ran = false;
   effect(() => {
     const value = String(unwrapMaybeCell2(rawContent) ?? "");
-    el.innerHTML = buildHtml2(value, props);
+    if (isPublicMarkdownPath2(value)) {
+      const known = getSsrData("md:" + value) !== void 0 || mdPathCache2.has(value);
+      ensureMdPathLoaded2(value);
+      const cell = getMdPathCell2(value);
+      get(cell);
+      if (trust && !ran && value === initial && !known) {
+        ran = true;
+        return;
+      }
+      ran = true;
+      el.innerHTML = buildHtml2(resolveMdSource2(value), props);
+      wireCopyHandlers2(el);
+      return;
+    }
+    ran = true;
+    el.innerHTML = buildHtml2(resolveMdSource2(value), props);
     wireCopyHandlers2(el);
   });
 }
-var COLOR_FUNCS2, SAFE_SCHEMES2, KW_JS2, KW_VSK2, LIT_JS2, KW_PY2, LIT_PY2, KW_GO2, LIT_GO2, KW_RUST2, LIT_RUST2, KW_SQL2, KW_BASH2, NAMED_ENTITIES2, URL_ATTRS2, MD_DEFAULT_ALLOW_TAGS2, MD_BASE_CSS2, __globalMode2, __globalAllowTags2, __sessionWarnings2, __warnedKeys2, __suppressMdConsoleWarnings2;
+var COLOR_FUNCS2, SAFE_SCHEMES2, KW_JS2, KW_VSK2, LIT_JS2, KW_PY2, LIT_PY2, KW_GO2, LIT_GO2, KW_RUST2, LIT_RUST2, KW_SQL2, KW_BASH2, NAMED_ENTITIES2, URL_ATTRS2, MD_DEFAULT_ALLOW_TAGS2, MD_BASE_CSS2, __globalMode2, __globalAllowTags2, __sessionWarnings2, __warnedKeys2, __suppressMdConsoleWarnings2, mdPathCache2, mdPathCells2, mdPathInflight2;
 var init_md2 = __esm({
   "../runtime/dist/md.js"() {
     "use strict";
     init_ripple_blocks();
+    init_ripple_runtime();
+    init_resource();
     COLOR_FUNCS2 = /* @__PURE__ */ new Set(["rgb", "rgba", "hsl", "hsla", "hwb", "lab", "lch", "oklab", "oklch", "color", "color-mix"]);
     SAFE_SCHEMES2 = ["http:", "https:", "mailto:", "tel:"];
     KW_JS2 = /* @__PURE__ */ new Set([
@@ -31900,6 +32263,9 @@ var init_md2 = __esm({
     __sessionWarnings2 = [];
     __warnedKeys2 = /* @__PURE__ */ new Set();
     __suppressMdConsoleWarnings2 = false;
+    mdPathCache2 = /* @__PURE__ */ new Map();
+    mdPathCells2 = /* @__PURE__ */ new Map();
+    mdPathInflight2 = /* @__PURE__ */ new Set();
   }
 });
 
@@ -32871,7 +33237,7 @@ __export(typecheck_exports, {
   formatTypecheckWarnings: () => formatTypecheckWarnings,
   typecheckProject: () => typecheckProject
 });
-import { readFileSync as readFileSync21, readdirSync as readdirSync12, statSync as statSync15 } from "node:fs";
+import { readFileSync as readFileSync23, readdirSync as readdirSync12, statSync as statSync17 } from "node:fs";
 import { join as join14, dirname as dirname15, normalize, relative as relative7, resolve as resolve25, sep as sep5 } from "node:path";
 import * as ts8 from "typescript";
 function walkProjectFiles(projectRoot) {
@@ -32888,7 +33254,7 @@ function walkProjectFiles(projectRoot) {
       const p = join14(dir, e);
       let st;
       try {
-        st = statSync15(p);
+        st = statSync17(p);
       } catch {
         continue;
       }
@@ -33073,7 +33439,7 @@ function typecheckProject(projectRoot, opts = {}) {
       }
     }
     if (f.endsWith(".vsk")) {
-      const src2 = readFileSync21(f, "utf-8");
+      const src2 = readFileSync23(f, "utf-8");
       try {
         parse4(src2);
       } catch (e) {
@@ -33655,7 +34021,7 @@ declare module '@vesk/runtime' {
 });
 
 // src/index.ts
-import { readFileSync as readFileSync22, writeFileSync as writeFileSync11, mkdirSync as mkdirSync9, existsSync as existsSync23 } from "fs";
+import { readFileSync as readFileSync24, writeFileSync as writeFileSync11, mkdirSync as mkdirSync9, existsSync as existsSync25 } from "fs";
 import { resolve as resolve26, join as join15, dirname as dirname16 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 
@@ -34155,7 +34521,7 @@ function setRuntimeModule2(mod) {
 
 // ../adapter/dist/index.js
 init_scan();
-import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync8, existsSync as existsSync15, readFileSync as readFileSync15 } from "node:fs";
+import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync8, existsSync as existsSync16, readFileSync as readFileSync16 } from "node:fs";
 import { resolve as resolve18, dirname as dirname12, relative as relative4 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
@@ -34607,6 +34973,7 @@ ${compRegEntries.join("\n")}
       "    url,",
       "    locals: Object.assign({}, __rootLocals),",
       "    cookies: parseCookies(request.headers.get('cookie') || ''),",
+      "    resolveUrl(u) { return new URL(u, request.url).href; },",
       "    set(key, value) { this.locals[key] = value; },",
       "    get(key) { return this.locals[key]; },",
       "  };",
@@ -34622,7 +34989,17 @@ ${compRegEntries.join("\n")}
       "  }"
     ].join("\n");
   } else {
-    bodyCode = dataCode;
+    const indentedRender = dataCode.split("\n").map((l) => l ? `  ${l}` : "").join("\n");
+    bodyCode = [
+      "  // Request context for SSR helpers (useParams/useRequest, relative useFetch resolution).",
+      "  const prevReq = globalThis.__vesk_request;",
+      "  globalThis.__vesk_request = VeskRequest.from(request, { params });",
+      "  try {",
+      indentedRender,
+      "  } finally {",
+      "    globalThis.__vesk_request = prevReq;",
+      "  }"
+    ].join("\n");
   }
   let registerActionsCode;
   if (hasLayout || hasAncestorLayout) {
@@ -34695,6 +35072,7 @@ ${compRegEntries.join("\n")}
     "    url: pageUrl,",
     "    locals: {},",
     "    cookies: parseCookies(request.headers.get('cookie') || ''),",
+    "    resolveUrl(u) { return new URL(u, pageUrl.href).href; },",
     "  };",
     "  try {",
     "    const result = await action.execute(input, {",
@@ -34725,7 +35103,7 @@ ${compRegEntries.join("\n")}
     ""
   ].join("\n");
   const funcCode = [
-    "import { renderFullPage, renderPageStream, renderPage, compileFile, setVskHydrate, parseCookies, getAction, validateActionInput, issuesToFieldMap, storeDataScriptGlobal, withSsrStore, assertSameOrigin } from '../runtime.js';",
+    "import { renderFullPage, renderPageStream, renderPage, compileFile, setVskHydrate, parseCookies, getAction, validateActionInput, issuesToFieldMap, storeDataScriptGlobal, withSsrStore, assertSameOrigin, VeskRequest } from '../runtime.js';",
     "",
     middlewareCode || "",
     registryCode,
@@ -35674,19 +36052,19 @@ function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middleware
 
 // ../adapter/src/static.ts
 init_paths();
-import { mkdirSync, copyFileSync, readdirSync as readdirSync2, statSync as statSync4, existsSync as existsSync8, writeFileSync as writeFileSync3, readFileSync as readFileSync9 } from "node:fs";
+import { mkdirSync, copyFileSync, readdirSync as readdirSync2, statSync as statSync5, existsSync as existsSync9, writeFileSync as writeFileSync3, readFileSync as readFileSync10 } from "node:fs";
 import { resolve as resolve10, join as join6 } from "node:path";
 function copyStaticAssets(publicDir, outDir2) {
   const targetDir = resolve10(outDir2, "static", "public");
   mkdirSync(targetDir, { recursive: true });
-  if (!existsSync8(publicDir)) return;
+  if (!existsSync9(publicDir)) return;
   function copyDir(src2, dest) {
     mkdirSync(dest, { recursive: true });
     const entries = readdirSync2(src2);
     for (const entry of entries) {
       const srcPath = join6(src2, entry);
       const destPath = join6(dest, entry);
-      const st = statSync4(srcPath);
+      const st = statSync5(srcPath);
       if (st.isDirectory()) {
         copyDir(srcPath, destPath);
       } else {
@@ -35698,7 +36076,7 @@ function copyStaticAssets(publicDir, outDir2) {
 }
 
 // ../adapter/src/prod-server.ts
-import { readFileSync as readFileSync10, existsSync as existsSync9, statSync as statSync5 } from "node:fs";
+import { readFileSync as readFileSync11, existsSync as existsSync10, statSync as statSync6 } from "node:fs";
 import { resolve as resolve11, extname as extname3, dirname as dirname7 } from "node:path";
 import { createServer } from "node:http";
 import { createRequire as createRequire2 } from "node:module";
@@ -35717,6 +36095,24 @@ async function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
   }
   return Buffer.concat(chunks);
 }
+async function deliverResponse(res, response) {
+  res.writeHead(response.status, Object.fromEntries(response.headers));
+  const body = response.body;
+  if (body && typeof body.getReader === "function") {
+    const reader = body.getReader();
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        res.write(Buffer.from(value));
+      }
+    } catch {
+    }
+    res.end();
+    return;
+  }
+  res.end(await response.text());
+}
 function bodyTooLarge(maxBytes) {
   const err = new Error(`Request body exceeds limit (${maxBytes} bytes)`);
   err.status = 413;
@@ -35797,12 +36193,13 @@ async function startProdServer(outDir, options) {
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "production";
   const staticDir = resolve11(outDir, "static");
   const configPath = resolve11(outDir, "config.json");
-  if (!existsSync9(configPath)) {
+  installMdReadHook([resolve11(staticDir, "public")]);
+  if (!existsSync10(configPath)) {
     console.error(`vesk start: no build found at ${outDir}`);
     console.error('Run "vesk build" first');
     process.exit(1);
   }
-  const buildConfig = JSON.parse(readFileSync10(configPath, "utf-8"));
+  const buildConfig = JSON.parse(readFileSync11(configPath, "utf-8"));
   console.error(`vesk start: serving from ${outDir}`);
   const projectDir = resolve11(outDir, "..");
   let securityConfig = {};
@@ -35811,11 +36208,11 @@ async function startProdServer(outDir, options) {
     const veskConfigPath = resolve11(projectDir, "vesk.config.js");
     const veskConfigTsPath = resolve11(projectDir, "vesk.config.ts");
     let rawConfig = {};
-    if (existsSync9(veskConfigPath)) {
+    if (existsSync10(veskConfigPath)) {
       rawConfig = _require(veskConfigPath);
-    } else if (existsSync9(veskConfigTsPath)) {
+    } else if (existsSync10(veskConfigTsPath)) {
       const { transpile } = _require("typescript");
-      const src = readFileSync10(veskConfigTsPath, "utf-8");
+      const src = readFileSync11(veskConfigTsPath, "utf-8");
       const result = transpile(src, { module: 99, target: 99 });
       rawConfig = eval(`(${result})`);
     }
@@ -35845,7 +36242,7 @@ async function startProdServer(outDir, options) {
   }
   let middlewareMod = null;
   const mwPath = resolve11(outDir, "server", "middleware.js");
-  if (existsSync9(mwPath)) {
+  if (existsSync10(mwPath)) {
     try {
       middlewareMod = await import(`${mwPath}?t=${Date.now()}`);
     } catch {
@@ -35855,7 +36252,7 @@ async function startProdServer(outDir, options) {
   async function loadFunction(funcPath) {
     if (functionCache.has(funcPath)) return functionCache.get(funcPath);
     const fullPath = resolve11(outDir, funcPath);
-    if (!existsSync9(fullPath)) return null;
+    if (!existsSync10(fullPath)) return null;
     try {
       const mod = await import(`${fullPath}?t=${Date.now()}`);
       functionCache.set(funcPath, mod);
@@ -35917,10 +36314,10 @@ async function startProdServer(outDir, options) {
     });
     const publicDir = resolve11(staticDir, "public");
     const rootFile = url.pathname.length > 1 ? resolveWithin(publicDir, url.pathname.slice(1)) : null;
-    if (rootFile && existsSync9(rootFile) && statSync5(rootFile).isFile()) {
+    if (rootFile && existsSync10(rootFile) && statSync6(rootFile).isFile()) {
       const ext = extname3(rootFile);
       res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
-      res.end(readFileSync10(rootFile));
+      res.end(readFileSync11(rootFile));
       return;
     }
     if (url.pathname === "/ssr-data.js") {
@@ -35937,9 +36334,9 @@ async function startProdServer(outDir, options) {
     }
     if (url.pathname === "/_vesk/runtime.js") {
       const clientPath = resolve11(staticDir, "client.js");
-      if (existsSync9(clientPath)) {
+      if (existsSync10(clientPath)) {
         res.writeHead(200, { "Content-Type": "application/javascript" });
-        res.end(readFileSync10(clientPath));
+        res.end(readFileSync11(clientPath));
         return;
       }
     }
@@ -35951,10 +36348,10 @@ async function startProdServer(outDir, options) {
         res.end("Forbidden");
         return;
       }
-      if (existsSync9(staticPath) && statSync5(staticPath).isFile()) {
+      if (existsSync10(staticPath) && statSync6(staticPath).isFile()) {
         const ext = extname3(staticPath);
         res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
-        res.end(readFileSync10(staticPath));
+        res.end(readFileSync11(staticPath));
         return;
       }
     }
@@ -35962,9 +36359,9 @@ async function startProdServer(outDir, options) {
       const prerendered = buildConfig.prerendered.find((r) => r.path === url.pathname);
       if (prerendered) {
         const htmlPath = resolve11(outDir, prerendered.file);
-        if (existsSync9(htmlPath)) {
+        if (existsSync10(htmlPath)) {
           res.writeHead(200, { "Content-Type": "text/html" });
-          res.end(readFileSync10(htmlPath));
+          res.end(readFileSync11(htmlPath));
           return;
         }
       }
@@ -36026,9 +36423,7 @@ async function startProdServer(outDir, options) {
       try {
         const webRequest = makeWebRequest(req, url.href, maxBodyBytes);
         const response = await mod.handleAction(webRequest, actionId);
-        const body = await response.text();
-        res.writeHead(response.status, Object.fromEntries(response.headers));
-        res.end(body);
+        await deliverResponse(res, response);
       } catch (e) {
         const status = errorStatus(e, 500);
         const message = status === 500 && process.env.NODE_ENV === "production" ? "Internal Server Error" : e instanceof Error ? e.message : String(e);
@@ -36047,9 +36442,7 @@ async function startProdServer(outDir, options) {
               try {
                 const webRequest = makeWebRequest(req, url.href, maxBodyBytes);
                 const response = await mod.handle(webRequest);
-                const body = await response.text();
-                res.writeHead(response.status, Object.fromEntries(response.headers));
-                res.end(body);
+                await deliverResponse(res, response);
                 return;
               } catch (e) {
                 const status = errorStatus(e, 500);
@@ -36065,11 +36458,11 @@ async function startProdServer(outDir, options) {
     const appDir = resolve11(projectDir, "app");
     const nfPath = resolve11(appDir, "not-found.vsk");
     let notFoundHtml = null;
-    if (existsSync9(nfPath)) {
+    if (existsSync10(nfPath)) {
       try {
         const runtimePath = resolve11(outDir, "server", "runtime.js");
         const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
-        const src2 = readFileSync10(nfPath, "utf-8");
+        const src2 = readFileSync11(nfPath, "utf-8");
         const compName = resolveComponentName(src2) || "NotFound";
         notFoundHtml = await renderFullPage2(src2, compName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: nfPath });
       } catch {
@@ -36129,11 +36522,11 @@ async function startProdServer(outDir, options) {
               console.error("vesk ssr error:", err.message);
               const errPath = resolve11(appDir, "error.vsk");
               let errorHtml = null;
-              if (existsSync9(errPath)) {
+              if (existsSync10(errPath)) {
                 try {
                   const runtimePath = resolve11(outDir, "server", "runtime.js");
                   const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
-                  const src2 = readFileSync10(errPath, "utf-8");
+                  const src2 = readFileSync11(errPath, "utf-8");
                   const compName = resolveComponentName(src2) || "Error";
                   const expose = process.env.NODE_ENV !== "production";
                   errorHtml = await renderFullPage2(src2, compName, { error: expose ? err.message : "Internal Server Error", stack: expose ? err.stack : "", statusCode: 500, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], clientScriptUrl: "/_vesk/static/client.js", security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath });
@@ -36161,9 +36554,9 @@ async function startProdServer(outDir, options) {
 var __dirname6 = dirname12(fileURLToPath5(import.meta.url));
 async function resolveCompilerApi(name) {
   const monorepoSrc = resolve18(__dirname6, "..", "..", "compiler", "src");
-  if (existsSync15(monorepoSrc)) {
+  if (existsSync16(monorepoSrc)) {
     const tsFile = resolve18(monorepoSrc, name.replace(/\.js$/, ".ts"));
-    if (existsSync15(tsFile)) {
+    if (existsSync16(tsFile)) {
       return import(tsFile);
     }
     return import(resolve18(monorepoSrc, name));
@@ -36208,7 +36601,7 @@ async function build2(appDir, options2) {
     console.error(`vesk build: ${componentMap.size} external components found in ${componentsDir}`);
   }
   const apiDir = resolve18(appDir, "api");
-  const apiTree = existsSync15(apiDir) ? scanApiRoutes2(apiDir) : [];
+  const apiTree = existsSync16(apiDir) ? scanApiRoutes2(apiDir) : [];
   console.error(`vesk build: ${routeTree.length} root routes, ${apiTree.length} API routes`);
   console.error("vesk build: bundling server runtime...");
   await bundleRuntime(appDir, outDir2);
@@ -36221,21 +36614,21 @@ async function build2(appDir, options2) {
         const mwChain2 = collectMiddlewareChain2(routeTree, node.fullPath, appDir);
         let mwCode = null;
         if (mwChain2.length > 0) {
-          const mwSources = mwChain2.map((m) => readFileSync15(m.sourcePath, "utf-8"));
+          const mwSources = mwChain2.map((m) => readFileSync16(m.sourcePath, "utf-8"));
           mwCode = compileMiddlewareCode(mwSources);
         }
         const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir2, componentMap, { ancestorLayouts, middlewareCode: mwCode });
         writeFileSync8(funcPath, funcCode, "utf-8");
         const pagePath = resolve18(appDir, node.sourceDir, "page.vsk");
-        if (existsSync15(pagePath)) {
-          const src2 = readFileSync15(pagePath, "utf-8");
+        if (existsSync16(pagePath)) {
+          const src2 = readFileSync16(pagePath, "utf-8");
           const actionIds = collectActionIds(src2);
           if (node.layout) {
-            const layoutSrc = readFileSync15(resolve18(appDir, node.sourceDir, "layout.vsk"), "utf-8");
+            const layoutSrc = readFileSync16(resolve18(appDir, node.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(layoutSrc));
           }
           for (const a of ancestorLayouts) {
-            const ancestorSrc = readFileSync15(resolve18(appDir, a.sourceDir, "layout.vsk"), "utf-8");
+            const ancestorSrc = readFileSync16(resolve18(appDir, a.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(ancestorSrc));
           }
           for (const id of actionIds) {
@@ -36306,11 +36699,11 @@ async function build2(appDir, options2) {
   const altCssSrc = resolve18(srcDir, "app.css");
   let cssContent = null;
   let cssSourcePath = null;
-  if (existsSync15(cssSrc)) {
-    cssContent = readFileSync15(cssSrc, "utf-8");
+  if (existsSync16(cssSrc)) {
+    cssContent = readFileSync16(cssSrc, "utf-8");
     cssSourcePath = cssSrc;
-  } else if (existsSync15(altCssSrc)) {
-    cssContent = readFileSync15(altCssSrc, "utf-8");
+  } else if (existsSync16(altCssSrc)) {
+    cssContent = readFileSync16(altCssSrc, "utf-8");
     cssSourcePath = altCssSrc;
   }
   function stripTailwindDirectives2(css) {
@@ -36389,13 +36782,13 @@ async function build2(appDir, options2) {
     const publicDirResolved = resolve18(outDir2, "static", "public");
     const siteUrl = options2?.siteUrl || "http://localhost:3000";
     const sitemapOverride = resolve18(publicDirResolved, "sitemap.xml");
-    if (!existsSync15(sitemapOverride)) {
+    if (!existsSync16(sitemapOverride)) {
       const sitemap = generateSitemap2(routeTree, ssrRoutes, prerenderedRoutes, { siteUrl });
       writeFileSync8(sitemapOverride, sitemap, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/sitemap.xml (${sitemap.length} bytes)`);
     }
     const robotsOverride = resolve18(publicDirResolved, "robots.txt");
-    if (!existsSync15(robotsOverride)) {
+    if (!existsSync16(robotsOverride)) {
       const robots = generateRobotsTxt2(siteUrl);
       writeFileSync8(robotsOverride, robots, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/robots.txt (${robots.length} bytes)`);
@@ -36441,7 +36834,7 @@ vesk build: done (${outDir2})`);
 init_seo_audit();
 
 // src/dev-server.ts
-import { readFileSync as readFileSync20, watch, statSync as statSync14, existsSync as existsSync22, readdirSync as readdirSync11 } from "node:fs";
+import { readFileSync as readFileSync22, watch, statSync as statSync16, existsSync as existsSync24, readdirSync as readdirSync11 } from "node:fs";
 import { resolve as resolve24, extname as extname6, join as join13 } from "node:path";
 import { createServer as createServer2 } from "node:http";
 import { WebSocketServer } from "ws";
@@ -38130,7 +38523,7 @@ init_parser();
 init_tokens();
 init_scan();
 init_strip_ts();
-import { readdirSync as readdirSync7, statSync as statSync10, existsSync as existsSync16, readFileSync as readFileSync16 } from "fs";
+import { readdirSync as readdirSync7, statSync as statSync11, existsSync as existsSync17, readFileSync as readFileSync17 } from "fs";
 import { join as join9, relative as relative5, basename } from "path";
 function collapseSlashes2(p) {
   let out = "";
@@ -38148,7 +38541,7 @@ function collapseSlashes2(p) {
   return out;
 }
 function scanRoutes(appDir, options2 = {}) {
-  if (!existsSync16(appDir)) {
+  if (!existsSync17(appDir)) {
     return [];
   }
   return scanDirectory(appDir, appDir, "/", options2);
@@ -38254,7 +38647,7 @@ function scanDirectory(rootDir, dir, parentPath, options2) {
     const entryPath = join9(dir, entry);
     let entryStat;
     try {
-      entryStat = statSync10(entryPath);
+      entryStat = statSync11(entryPath);
     } catch {
       continue;
     }
@@ -38401,7 +38794,7 @@ function matchUrl(tree, pathname) {
 }
 
 // ../compiler/dist/api-routes.js
-import { readdirSync as readdirSync8, statSync as statSync11, existsSync as existsSync17 } from "fs";
+import { readdirSync as readdirSync8, statSync as statSync12, existsSync as existsSync18 } from "fs";
 import { join as join10 } from "path";
 init_server_utils();
 function basename2(p) {
@@ -38409,7 +38802,7 @@ function basename2(p) {
   return idx === -1 ? p : p.slice(idx + 1);
 }
 function scanApiRoutes(apiDir) {
-  if (!existsSync17(apiDir))
+  if (!existsSync18(apiDir))
     return [];
   return scanApiDir(apiDir, apiDir, "/");
 }
@@ -38442,7 +38835,7 @@ function scanApiDir(rootDir, dir, parentPath) {
       const entryPath = join10(dir, entry);
       let entryStat;
       try {
-        entryStat = statSync11(entryPath);
+        entryStat = statSync12(entryPath);
       } catch {
         continue;
       }
@@ -38476,7 +38869,7 @@ function scanApiDir(rootDir, dir, parentPath) {
     const entryPath = join10(dir, entry);
     let entryStat;
     try {
-      entryStat = statSync11(entryPath);
+      entryStat = statSync12(entryPath);
     } catch {
       continue;
     }
@@ -38774,7 +39167,7 @@ async function executeRewrite(url, originalRequest) {
 }
 
 // ../compiler/dist/middleware.js
-import { existsSync as existsSync18 } from "fs";
+import { existsSync as existsSync19 } from "fs";
 import { resolve as resolve19 } from "path";
 
 // ../compiler/src/api-routes.ts
@@ -38835,7 +39228,7 @@ function collectMiddlewareChain(routeTree, url, appDir) {
   function collectForNode(node) {
     if (node.hasMiddleware) {
       const mwPath2 = resolve19(appDir, node.sourceDir, "middleware.ts");
-      if (existsSync18(mwPath2)) {
+      if (existsSync19(mwPath2)) {
         chain.push({ sourcePath: mwPath2, node });
       }
     }
@@ -38998,7 +39391,7 @@ async function executeMiddlewareChain(chain, request, params, options2 = {}) {
 }
 
 // ../adapter/dist/client-bundle.js
-import { readFileSync as readFileSync17, existsSync as existsSync19, writeFileSync as writeFileSync9, unlinkSync as unlinkSync3, statSync as statSync12 } from "node:fs";
+import { readFileSync as readFileSync18, existsSync as existsSync20, writeFileSync as writeFileSync9, unlinkSync as unlinkSync3, statSync as statSync13 } from "node:fs";
 import { resolve as resolve20, join as join11, dirname as dirname13, relative as relative6, sep as sep3 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 
@@ -39057,7 +39450,7 @@ init_md_inline();
 var __dirname7 = dirname13(fileURLToPath6(import.meta.url));
 function fileUnchanged2(filePath, cached) {
   try {
-    const st = statSync12(filePath);
+    const st = statSync13(filePath);
     return st.mtimeMs === cached.mtimeMs && st.size === cached.size;
   } catch {
     return false;
@@ -39079,7 +39472,7 @@ function findRuntimeSrc3(appDir) {
   ];
   for (const base of candidates) {
     for (const dir of [base, join11(base, "dist")]) {
-      if (existsSync19(join11(dir, "index-client.js")))
+      if (existsSync20(join11(dir, "index-client.js")))
         return dir;
     }
   }
@@ -39119,11 +39512,11 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
     return code.replace(/^import\s*\{[^}]*\}\s*from\s*['"][^'"]*\.vsk['"];?\s*\n?/gm, "");
   }
   function resolveVskImports(filePath, compile) {
-    const src2 = readFileSync17(filePath, "utf-8");
+    const src2 = readFileSync18(filePath, "utf-8");
     const resolved = [];
     for (const importPath of collectVskImportPaths(vskImportLines(src2), filePath)) {
       try {
-        readFileSync17(importPath);
+        readFileSync18(importPath);
       } catch {
         continue;
       }
@@ -39168,7 +39561,7 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
       return;
     }
     compiledFiles++;
-    let src2 = readFileSync17(filePath, "utf-8");
+    let src2 = readFileSync18(filePath, "utf-8");
     if (/content=["'][^"']*\.md["']/i.test(src2)) {
       src2 = inlineMdContentAttrs(src2, dirname13(filePath), guessProjectRoots(appDir));
     }
@@ -39195,7 +39588,7 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
       output.push(`Object.defineProperty(__hydrators, ${JSON.stringify(resolvedName)}, { get: () => __hydrators[${JSON.stringify(actualName)}], configurable: true });`);
     }
     if (cache2 && namesBefore) {
-      const st = statSync12(filePath);
+      const st = statSync13(filePath);
       cache2.files.set(filePath, {
         mtimeMs: st.mtimeMs,
         size: st.size,
@@ -39219,31 +39612,31 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
       for (const node of nodes) {
         const chunkCode = [];
         const pagePath = resolve20(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync19(pagePath)) {
+        if (node.page && existsSync20(pagePath)) {
           compileFile2(pagePath, node.page, chunkCode);
         }
         const layoutPath = resolve20(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync19(layoutPath)) {
+        if (node.layout && existsSync20(layoutPath)) {
           compileFile2(layoutPath, node.layout, chunkCode);
         }
         const errorPath = resolve20(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync19(errorPath)) {
+        if (node.error && existsSync20(errorPath)) {
           compileFile2(errorPath, node.error, chunkCode);
         }
         const notFoundPath = resolve20(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync19(notFoundPath)) {
+        if (node.notFound && existsSync20(notFoundPath)) {
           compileFile2(notFoundPath, node.notFound, chunkCode);
         }
         const offlinePath = resolve20(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync19(offlinePath)) {
+        if (node.offline && existsSync20(offlinePath)) {
           compileFile2(offlinePath, node.offline, chunkCode);
         }
         const networkPath = resolve20(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync19(networkPath)) {
+        if (node.network && existsSync20(networkPath)) {
           compileFile2(networkPath, node.network, chunkCode);
         }
         const loadingPath = resolve20(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync19(loadingPath)) {
+        if (node.loading && existsSync20(loadingPath)) {
           compileFile2(loadingPath, node.loading, chunkCode);
         }
         if (chunkCode.length > 0) {
@@ -39302,7 +39695,7 @@ ${entry.code}
       if (seen.has(filePath))
         return;
       seen.add(filePath);
-      const src2 = readFileSync17(filePath, "utf-8");
+      const src2 = readFileSync18(filePath, "utf-8");
       resolveVskImports(filePath, (p, n) => compileFileMono2(p, n || ""));
       const compCode = compileClient(src2, null, { forceClient: true });
       if (compCode) {
@@ -39324,25 +39717,25 @@ ${entry.code}
     }, walkMono2 = function(nodes) {
       for (const node of nodes) {
         const pagePath = resolve20(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync19(pagePath))
+        if (node.page && existsSync20(pagePath))
           compileFileMono2(pagePath, node.page);
         const layoutPath = resolve20(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync19(layoutPath))
+        if (node.layout && existsSync20(layoutPath))
           compileFileMono2(layoutPath, node.layout);
         const errorPath = resolve20(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync19(errorPath))
+        if (node.error && existsSync20(errorPath))
           compileFileMono2(errorPath, node.error);
         const notFoundPath = resolve20(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync19(notFoundPath))
+        if (node.notFound && existsSync20(notFoundPath))
           compileFileMono2(notFoundPath, node.notFound);
         const offlinePath = resolve20(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync19(offlinePath))
+        if (node.offline && existsSync20(offlinePath))
           compileFileMono2(offlinePath, node.offline);
         const networkPath = resolve20(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync19(networkPath))
+        if (node.network && existsSync20(networkPath))
           compileFileMono2(networkPath, node.network);
         const loadingPath = resolve20(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync19(loadingPath))
+        if (node.loading && existsSync20(loadingPath))
           compileFileMono2(loadingPath, node.loading);
         walkMono2(node.children || []);
       }
@@ -39393,8 +39786,8 @@ function buildRuntimeCode2(runtimeDir) {
   let code = "";
   for (const f of runtimeFiles) {
     const p = join11(runtimeDir, f);
-    if (existsSync19(p)) {
-      let src2 = readFileSync17(p, "utf-8");
+    if (existsSync20(p)) {
+      let src2 = readFileSync18(p, "utf-8");
       src2 = stripTypes2(src2);
       src2 = src2.replace(/^import\s+[\s\S]*?from\s+['"](?:\.\/.*?|@vesk\/runtime\/src\/.*?)['"];?\n?/gm, "");
       src2 = src2.replace(/^import\s+['"](?:\.\/.*?|@vesk\/runtime\/src\/.*?)['"];?\n?/gm, "");
@@ -39406,7 +39799,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync17(join11(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync18(join11(runtimeDir, "index-client.js"), "utf-8");
   const exportNames = stripTypes2(indexSrc).match(/export\s*\{\s*([^}]+)\s*\}\s*from/g)?.flatMap((m) => m.replace(/export\s*\{\s*|\s*\}\s*from/g, "").split(",").map((s) => s.trim())) || [];
   code += "// --- exports ---\n";
   for (const name of [...new Set(exportNames)]) {
@@ -39417,7 +39810,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames2(runtimeDir) {
-  const indexSrc = readFileSync17(join11(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync18(join11(runtimeDir, "index-client.js"), "utf-8");
   const names = /* @__PURE__ */ new Set();
   for (const m of indexSrc.matchAll(/export\s*\{([^}]+)\}\s*from/g)) {
     for (const raw2 of m[1].split(",")) {
@@ -39564,6 +39957,7 @@ if (typeof document !== 'undefined') __router.start();
 
 // ../adapter/dist/paths.js
 import { resolve as resolve21, sep as sep4 } from "node:path";
+import { existsSync as existsSync21, statSync as statSync14, readFileSync as readFileSync19 } from "node:fs";
 function resolveWithin2(baseDir, relPath) {
   const base = resolve21(baseDir);
   const target = resolve21(baseDir, relPath);
@@ -39572,6 +39966,28 @@ function resolveWithin2(baseDir, relPath) {
     return null;
   return target;
 }
+function installMdReadHook2(publicDirs) {
+  const dirs = publicDirs.map((d) => resolve21(d));
+  globalThis.__vsk_md_read_file = (p) => {
+    for (const dir of dirs) {
+      try {
+        let rel = String(p);
+        while (rel.length > 0 && rel.charCodeAt(0) === 47)
+          rel = rel.slice(1);
+        const abs = resolveWithin2(dir, rel);
+        if (!abs)
+          continue;
+        const lower = abs.toLowerCase();
+        if (!lower.endsWith(".md") && !lower.endsWith(".markdown"))
+          continue;
+        if (existsSync21(abs) && statSync14(abs).isFile())
+          return readFileSync19(abs, "utf8");
+      } catch {
+      }
+    }
+    return null;
+  };
+}
 function isAllowedWsUpgrade(headers2) {
   const origin = typeof headers2["origin"] === "string" ? headers2["origin"] : "";
   if (!origin)
@@ -39633,7 +40049,7 @@ function urlAuthority3(url) {
 
 // src/build-packages.ts
 import { spawnSync } from "node:child_process";
-import { cpSync, existsSync as existsSync20, mkdirSync as mkdirSync7, readFileSync as readFileSync18, readdirSync as readdirSync9, statSync as statSync13, writeFileSync as writeFileSync10 } from "node:fs";
+import { cpSync, existsSync as existsSync22, mkdirSync as mkdirSync7, readFileSync as readFileSync20, readdirSync as readdirSync9, statSync as statSync15, writeFileSync as writeFileSync10 } from "node:fs";
 import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname14, join as join12, resolve as resolve22 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
@@ -39656,7 +40072,7 @@ function newestSourceMtime(srcDir) {
   let newest = 0;
   for (const name of readdirSync9(srcDir)) {
     const p = join12(srcDir, name);
-    const st = statSync13(p);
+    const st = statSync15(p);
     if (st.isDirectory()) {
       newest = Math.max(newest, newestSourceMtime(p));
     } else if (st.isFile() && /\.ts$/.test(name) && !name.endsWith(".test.ts")) {
@@ -39667,9 +40083,9 @@ function newestSourceMtime(srcDir) {
 }
 function distStale(pkgDir, entry) {
   const distIndex = join12(pkgDir, "dist", `${entry}.js`);
-  if (!existsSync20(distIndex)) return true;
+  if (!existsSync22(distIndex)) return true;
   const distPkg = join12(pkgDir, "dist", "package.json");
-  const distStamp = Math.max(statSync13(distIndex).mtimeMs, existsSync20(distPkg) ? statSync13(distPkg).mtimeMs : 0);
+  const distStamp = Math.max(statSync15(distIndex).mtimeMs, existsSync22(distPkg) ? statSync15(distPkg).mtimeMs : 0);
   return newestSourceMtime(join12(pkgDir, "src")) > distStamp;
 }
 function distPackageJson(pkgName, entry, serverEntry, version2) {
@@ -39694,7 +40110,7 @@ function distPackageJson(pkgName, entry, serverEntry, version2) {
 function buildPackages(force = false) {
   for (const [pkg, cfg] of Object.entries(PACKAGES)) {
     const pkgDir = resolve22(root2, "packages", pkg);
-    if (!existsSync20(join12(pkgDir, "src"))) continue;
+    if (!existsSync22(join12(pkgDir, "src"))) continue;
     if (!force && !distStale(pkgDir, cfg.entry)) continue;
     console.log(`[build] ${cfg.name} -> tsc`);
     const tscBin = require2.resolve("typescript/bin/tsc");
@@ -39710,7 +40126,7 @@ function buildPackages(force = false) {
       mkdirSync7(dirname14(to), { recursive: true });
       cpSync(join12(pkgDir, c.from), to, { recursive: true });
     }
-    const srcPkg = JSON.parse(readFileSync18(join12(pkgDir, "package.json"), "utf-8"));
+    const srcPkg = JSON.parse(readFileSync20(join12(pkgDir, "package.json"), "utf-8"));
     writeFileSync10(join12(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
     console.log(`[build] ${cfg.name} -> dist`);
   }
@@ -39723,7 +40139,7 @@ if (process.argv[1] && resolve22(process.argv[1]) === fileURLToPath7(import.meta
 }
 
 // src/action-handler.ts
-import { existsSync as existsSync21, readFileSync as readFileSync19, readdirSync as readdirSync10 } from "node:fs";
+import { existsSync as existsSync23, readFileSync as readFileSync21, readdirSync as readdirSync10 } from "node:fs";
 import { resolve as resolve23 } from "node:path";
 
 // ../compiler/dist/server-cookies.js
@@ -39810,7 +40226,7 @@ function pageSourcesFor(appDirPath, routeTree) {
   return out;
 }
 function walkVskFiles(dir, out, seen) {
-  if (!existsSync21(dir)) return;
+  if (!existsSync23(dir)) return;
   let entries;
   try {
     entries = readdirSync10(dir, { withFileTypes: true });
@@ -39845,9 +40261,9 @@ function candidateSources(appDirPath, routeTree) {
   return out;
 }
 function registerSource(sourcePath2) {
-  if (!existsSync21(sourcePath2)) return;
+  if (!existsSync23(sourcePath2)) return;
   try {
-    compileFile(readFileSync19(sourcePath2, "utf-8"), { sourcePath: sourcePath2 });
+    compileFile(readFileSync21(sourcePath2, "utf-8"), { sourcePath: sourcePath2 });
   } catch {
   }
 }
@@ -39885,22 +40301,22 @@ async function renderPageHtml(pagePathname, params, ctx2) {
     const node = chain[i];
     const pageFilePath = resolve23(ctx2.appDirPath, node.sourceDir, "page.vsk");
     const layoutFilePath = resolve23(ctx2.appDirPath, node.sourceDir, "layout.vsk");
-    if (i === chain.length - 1 && node.page && existsSync21(pageFilePath)) {
-      const src3 = readFileSync19(pageFilePath, "utf-8");
+    if (i === chain.length - 1 && node.page && existsSync23(pageFilePath)) {
+      const src3 = readFileSync21(pageFilePath, "utf-8");
       const compName2 = resolveComponentName(src3) || node.page;
       const result2 = await renderPage(src3, compName2, { params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
       body = result2.body;
       head = result2.head || "";
     }
-    if (node.layout && existsSync21(layoutFilePath)) {
-      const src3 = readFileSync19(layoutFilePath, "utf-8");
+    if (node.layout && existsSync23(layoutFilePath)) {
+      const src3 = readFileSync21(layoutFilePath, "utf-8");
       const compName2 = resolveComponentName(src3) || node.layout;
       const result2 = await renderPage(src3, compName2, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
       body = result2.body;
       head = (result2.head || "") + head;
     }
   }
-  const hasLayout = chain.some((n) => n.layout && existsSync21(resolve23(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
+  const hasLayout = chain.some((n) => n.layout && existsSync23(resolve23(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
   if (hasLayout) {
     const secMeta = securityMeta(ctx2.security);
     return `<!DOCTYPE html>
@@ -39922,7 +40338,7 @@ ${prettifyHtml(body)}
   }
   const leaf = chain.find((n) => n.page);
   if (!leaf) return null;
-  const src2 = readFileSync19(resolve23(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+  const src2 = readFileSync21(resolve23(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
   const compName = resolveComponentName(src2) || leaf.page;
   const html = await renderFullPage(src2, compName, { params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security: ctx2.security, sourcePath: resolve23(ctx2.appDirPath, leaf.sourceDir, "page.vsk") });
   return html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>');
@@ -40073,9 +40489,9 @@ function resolveRuntimeDir(projectDir2) {
     resolve24(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
   ];
   for (const dir of candidates) {
-    if (existsSync22(join13(dir, "ripple-runtime.js"))) return dir;
+    if (existsSync24(join13(dir, "ripple-runtime.js"))) return dir;
     const distDir = join13(dir, "dist");
-    if (existsSync22(join13(distDir, "ripple-runtime.js"))) return distDir;
+    if (existsSync24(join13(distDir, "ripple-runtime.js"))) return distDir;
   }
   return null;
 }
@@ -40145,7 +40561,7 @@ function collectRoutePaths(nodes, out = []) {
   return out;
 }
 function countFilesNamed(dir, name) {
-  if (!existsSync22(dir)) return 0;
+  if (!existsSync24(dir)) return 0;
   let n = 0;
   for (const entry of readdirSync11(dir, { withFileTypes: true })) {
     const p = join13(dir, entry.name);
@@ -40161,6 +40577,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
   const maxBodyBytes2 = (typeof secCfg.maxBodyBytes === "number" ? secCfg.maxBodyBytes : void 0) || DEFAULT_MAX_BODY_BYTES;
   const appDirPath = join13(projectDir2, "app");
   const publicDir = join13(projectDir2, "public");
+  installMdReadHook2([publicDir]);
   try {
     ensurePackagesBuilt();
   } catch (e) {
@@ -40181,10 +40598,10 @@ async function startDevServer(port2, projectDir2, config, host2) {
   const cssPath = join13(srcDir, "global.css");
   const altCssPath = join13(srcDir, "app.css");
   let rawCss = "";
-  if (existsSync22(cssPath)) {
-    rawCss = readFileSync20(cssPath, "utf-8");
-  } else if (existsSync22(altCssPath)) {
-    rawCss = readFileSync20(altCssPath, "utf-8");
+  if (existsSync24(cssPath)) {
+    rawCss = readFileSync22(cssPath, "utf-8");
+  } else if (existsSync24(altCssPath)) {
+    rawCss = readFileSync22(altCssPath, "utf-8");
   }
   if (rawCss) {
     for (const plugin of devPlugins) {
@@ -40310,7 +40727,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
     let debounceTimer = null;
     let cssDebounceTimer = null;
     const watchDirs = [appDirPath];
-    if (existsSync22(srcDir)) watchDirs.push(srcDir);
+    if (existsSync24(srcDir)) watchDirs.push(srcDir);
     for (const watchDir of watchDirs) {
       watch(watchDir, { recursive: true }, (eventType, filename) => {
         if (!filename) return;
@@ -40319,7 +40736,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
         const isApiRoute = filename.endsWith(".ts") || filename.endsWith(".js") || filename.endsWith(".tsx");
         if (!isVsk && !isCss && !isApiRoute) return;
         const fullPath = filename.startsWith("/") ? filename : join13(watchDir, filename);
-        const fileExists = existsSync22(fullPath);
+        const fileExists = existsSync24(fullPath);
         if (isVsk) {
           if (debounceTimer) clearTimeout(debounceTimer);
           debounceTimer = setTimeout(async () => {
@@ -40368,7 +40785,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
                     if (compCode.trim()) fnSources = { _raw: compCode };
                   } else if (fileExists && !bundleError) {
                     try {
-                      const src2 = readFileSync20(fullPath, "utf-8");
+                      const src2 = readFileSync22(fullPath, "utf-8");
                       let compCode = compileClient2(src2, null, { forceClient: true, sourcePath: fullPath, mdRoots: [projectDir2] });
                       compCode = compCode.replace(/^import\s*[\s\S]*?from\s*['"][^'"]+['"];?\s*\n?/gm, "");
                       compCode = compCode.replace(/^const __components = \{\};\s*\n?/m, "");
@@ -40424,7 +40841,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
                     let code = "";
                     if (line > 0 && fileExists) {
                       try {
-                        const src2 = readFileSync20(fullPath, "utf-8");
+                        const src2 = readFileSync22(fullPath, "utf-8");
                         const lines = src2.split("\n");
                         const start = Math.max(0, line - 3);
                         const end = Math.min(lines.length, line + 2);
@@ -40475,7 +40892,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
           cssDebounceTimer = setTimeout(async () => {
             try {
               if (fileExists) {
-                rawCss = readFileSync20(fullPath, "utf-8");
+                rawCss = readFileSync22(fullPath, "utf-8");
               }
               const cssChanged = await rebuildTailwindCss();
               if (cssChanged && typeof globalThis.__vesk_broadcastHmr === "function") {
@@ -40509,7 +40926,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
   };
   const hmrJsPath = join13(runtimeDir, "hmr-client.js");
   const hmrTsPath = join13(runtimeDir, "hmr-client.ts");
-  const hmrClientPath = existsSync22(hmrJsPath) ? hmrJsPath : existsSync22(hmrTsPath) ? hmrTsPath : null;
+  const hmrClientPath = existsSync24(hmrJsPath) ? hmrJsPath : existsSync24(hmrTsPath) ? hmrTsPath : null;
   function extractCompName2(src2) {
     return resolveComponentName(src2);
   }
@@ -40610,7 +41027,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     }
     if (url.pathname === "/_vesk/hmr" || url.pathname === "/_vesk/hmr.js") {
       if (hmrClientPath) {
-        let hmrContent = readFileSync20(hmrClientPath, "utf-8");
+        let hmrContent = readFileSync22(hmrClientPath, "utf-8");
         if (hmrClientPath.endsWith(".ts")) {
           hmrContent = stripCodeTypes2(hmrContent);
         }
@@ -40624,16 +41041,16 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     }
     if (url.pathname !== "/") {
       const staticPath = url.pathname.length > 1 ? resolveWithin2(publicDir, url.pathname.slice(1)) : null;
-      if (staticPath && existsSync22(staticPath) && statSync14(staticPath).isFile()) {
+      if (staticPath && existsSync24(staticPath) && statSync16(staticPath).isFile()) {
         const ext = extname6(staticPath);
         res.writeHead(200, { "Content-Type": MIME3[ext] || "application/octet-stream" });
-        res.end(readFileSync20(staticPath));
+        res.end(readFileSync22(staticPath));
         return;
       }
     }
     const mwChain = collectMiddlewareChain(routeTree, url.pathname, appDirPath);
     const apiDirPath = join13(appDirPath, "api");
-    if (url.pathname.startsWith("/api") && existsSync22(apiDirPath)) {
+    if (url.pathname.startsWith("/api") && existsSync24(apiDirPath)) {
       const apiRoutes = await scanApiRoutes(apiDirPath);
       const apiMatch = matchApiUrl(apiRoutes, req.url || url.pathname);
       if (apiMatch) {
@@ -40709,9 +41126,9 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
       let notFoundHtml = null;
       if (rootNode && rootNode.notFound) {
         const nfPath = resolve24(appDirPath, rootNode.sourceDir, "not-found.vsk");
-        if (existsSync22(nfPath)) {
+        if (existsSync24(nfPath)) {
           try {
-            const nfSrc = readFileSync20(nfPath, "utf-8");
+            const nfSrc = readFileSync22(nfPath, "utf-8");
             const nfCompName = extractCompName2(nfSrc) || rootNode.notFound;
             notFoundHtml = await renderFullPage(nfSrc, nfCompName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security, externalDataScript: storeDataScript, sourcePath: nfPath });
           } catch {
@@ -40750,16 +41167,16 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
           const node = chain[i];
           const pageFilePath = resolve24(appDirPath, node.sourceDir, "page.vsk");
           const layoutFilePath = resolve24(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync22(pageFilePath)) {
-            const src2 = readFileSync20(pageFilePath, "utf-8");
+          if (i === chain.length - 1 && node.page && existsSync24(pageFilePath)) {
+            const src2 = readFileSync22(pageFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.page;
             const result2 = await renderPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
             body = result2.body;
             head = result2.head || "";
             props = result2.props;
           }
-          if (node.layout && existsSync22(layoutFilePath)) {
-            const src2 = readFileSync20(layoutFilePath, "utf-8");
+          if (node.layout && existsSync24(layoutFilePath)) {
+            const src2 = readFileSync22(layoutFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.layout;
             const result2 = await renderPage(src2, compName, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
             body = result2.body;
@@ -40769,7 +41186,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         if (forData) {
           return { html: "", props: props || { params: matched.params }, head };
         }
-        const hasLayout = chain.some((n) => n.layout && existsSync22(resolve24(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync24(resolve24(appDirPath, n.sourceDir, "layout.vsk")));
         let html;
         if (hasLayout) {
           const ssrData = ssrSink3.snapshot();
@@ -40801,7 +41218,7 @@ ${prettifyHtml(body)}
         } else {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync20(resolve24(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync22(resolve24(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
             const compName = extractCompName2(src2) || leaf.page;
             html = await renderFullPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security, externalDataScript: storeDataScript, sourcePath: resolve24(appDirPath, leaf.sourceDir, "page.vsk") });
             html = html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>');
@@ -40815,11 +41232,11 @@ ${prettifyHtml(body)}
     function renderSSRStream() {
       async function* raw2() {
         const chain = cleanChain;
-        const hasLayout = chain.some((n) => n.layout && existsSync22(resolve24(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync24(resolve24(appDirPath, n.sourceDir, "layout.vsk")));
         if (!hasLayout) {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync20(resolve24(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync22(resolve24(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
             const compName = extractCompName2(src2) || leaf.page;
             yield* renderPageStream(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security, externalDataScript: storeDataScript, sourcePath: resolve24(appDirPath, leaf.sourceDir, "page.vsk") });
           } else {
@@ -40834,16 +41251,16 @@ ${prettifyHtml(body)}
           const node = chain[i];
           const pageFilePath = resolve24(appDirPath, node.sourceDir, "page.vsk");
           const layoutFilePath = resolve24(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync22(pageFilePath)) {
-            const src2 = readFileSync20(pageFilePath, "utf-8");
+          if (i === chain.length - 1 && node.page && existsSync24(pageFilePath)) {
+            const src2 = readFileSync22(pageFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.page;
             const result2 = await renderPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: pageFilePath });
             body = result2.body;
             head = result2.head || "";
             props = result2.props;
           }
-          if (node.layout && existsSync22(layoutFilePath)) {
-            const src2 = readFileSync20(layoutFilePath, "utf-8");
+          if (node.layout && existsSync24(layoutFilePath)) {
+            const src2 = readFileSync22(layoutFilePath, "utf-8");
             const compName = extractCompName2(src2) || node.layout;
             const result2 = await renderPage(src2, compName, { children: body }, /* @__PURE__ */ new Map(), { hydrate: true, sourcePath: layoutFilePath });
             body = result2.body;
@@ -40971,9 +41388,9 @@ ${prettifyHtml(body)}
             const node = match.nodes[i];
             if (node.notFound) {
               const nfPath = resolve24(appDirPath, node.sourceDir, "not-found.vsk");
-              if (existsSync22(nfPath)) {
+              if (existsSync24(nfPath)) {
                 try {
-                  const nfSrc = readFileSync20(nfPath, "utf-8");
+                  const nfSrc = readFileSync22(nfPath, "utf-8");
                   const nfCompName = extractCompName2(nfSrc) || node.notFound;
                   const html = await renderFullPage(nfSrc, nfCompName, { params: match.params, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security, externalDataScript: storeDataScript, sourcePath: nfPath });
                   notFoundHtml = html.replace(
@@ -40999,9 +41416,9 @@ ${prettifyHtml(body)}
             const node = match.nodes[i];
             if (node.error) {
               const errPath = resolve24(appDirPath, node.sourceDir, "error.vsk");
-              if (existsSync22(errPath)) {
+              if (existsSync24(errPath)) {
                 try {
-                  const errSrc = readFileSync20(errPath, "utf-8");
+                  const errSrc = readFileSync22(errPath, "utf-8");
                   const errCompName = extractCompName2(errSrc) || node.error;
                   const errProps = { error: err.message, stack: err.stack, statusCode: errorStatusCode(err), url: url.pathname };
                   const html = await renderFullPage(errSrc, errCompName, errProps, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"], security, externalDataScript: storeDataScript, sourcePath: errPath });
@@ -41311,8 +41728,8 @@ function loadEnvFiles(projectDir2) {
     join15(projectDir2, ".env.local")
   ];
   for (const filePath of files) {
-    if (!existsSync23(filePath)) continue;
-    const content = readFileSync22(filePath, "utf-8");
+    if (!existsSync25(filePath)) continue;
+    const content = readFileSync24(filePath, "utf-8");
     for (const line of content.split("\n")) {
       const trimmed = line.trim();
       if (!trimmed || trimmed.startsWith("#")) continue;
@@ -41334,13 +41751,13 @@ async function loadConfig(projectDir2) {
   const jsPath = join15(projectDir2, "vesk.config.js");
   const tsPath = join15(projectDir2, "vesk.config.ts");
   let configPath2 = null;
-  if (existsSync23(jsPath)) configPath2 = jsPath;
-  else if (existsSync23(tsPath)) configPath2 = tsPath;
+  if (existsSync25(jsPath)) configPath2 = jsPath;
+  else if (existsSync25(tsPath)) configPath2 = tsPath;
   if (!configPath2) return {};
   let raw2;
   if (configPath2.endsWith(".ts")) {
     const { transpile: transpile2 } = await import("typescript");
-    const src2 = readFileSync22(configPath2, "utf-8");
+    const src2 = readFileSync24(configPath2, "utf-8");
     let js = transpile2(src2, { module: 99, target: 99 });
     js = js.replace(/import\s+\{[^}]*\}\s*from\s+['"]@vesk\/compiler['"]\s*;?\s*/g, "");
     js = `const { defineConfig, definePlugin, preset } = globalThis.__vesk_inject;
@@ -41369,7 +41786,7 @@ if (cmd === "build") {
   const projectDir2 = process.cwd();
   const appDirPath = join15(projectDir2, "app");
   const publicDir = join15(projectDir2, "public");
-  if (!existsSync23(appDirPath)) {
+  if (!existsSync25(appDirPath)) {
     console.error(`vesk build: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -41408,7 +41825,7 @@ if (cmd === "build") {
 if (cmd === "seo") {
   const projectDir2 = process.cwd();
   const appDirPath = join15(projectDir2, "app");
-  if (!existsSync23(appDirPath)) {
+  if (!existsSync25(appDirPath)) {
     console.error(`vesk seo: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -41423,7 +41840,7 @@ if (cmd === "seo") {
 if (cmd === "typecheck") {
   const projectDir2 = process.cwd();
   const appDirPath = join15(projectDir2, "app");
-  if (!existsSync23(appDirPath)) {
+  if (!existsSync25(appDirPath)) {
     console.error(`vesk typecheck: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -41458,7 +41875,7 @@ if (cmd === "init") {
   const projectDir2 = process.cwd();
   const srcDir = join15(projectDir2, "src");
   const target = join15(srcDir, "global.css");
-  if (existsSync23(target)) {
+  if (existsSync25(target)) {
     console.error(`vesk init: ${target} already exists \u2014 skipping`);
     process.exit(0);
   }
@@ -41479,7 +41896,7 @@ if (cmd === "dev") {
   const appDirPath = join15(projectDir2, "app");
   const port2 = parsePortArg(args);
   const host2 = parseHostArg(args);
-  if (!existsSync23(appDirPath)) {
+  if (!existsSync25(appDirPath)) {
     console.error(`vesk: no app/ directory found in ${projectDir2}`);
     console.error('Run "npx create-vesk@latest <project-name>" first');
     process.exit(1);