@vesk/vesk-cli 0.2.13 → 0.2.15

package/dist/cli.js

@@ -1708,7 +1708,7 @@ async function runFetcher(handle2, timeout) {
   }
 }
 function sleep(ms) {
-  return new Promise((resolve35) => setTimeout(resolve35, ms));
+  return new Promise((resolve38) => setTimeout(resolve38, ms));
 }
 function streamText(res, into, onChunk) {
   const decoder = new TextDecoder();
@@ -2117,10 +2117,10 @@ function createHydrateWalker(container, markerList) {
 }
 function hydrateViewport(container, componentFn, props, rootMargin = 500) {
   if (document.readyState !== "complete") {
-    return new Promise((resolve35) => {
+    return new Promise((resolve38) => {
       const onLoad = () => {
         window.removeEventListener("load", onLoad);
-        resolve35(hydrateViewport(container, componentFn, props, rootMargin));
+        resolve38(hydrateViewport(container, componentFn, props, rootMargin));
       };
       window.addEventListener("load", onLoad);
     });
@@ -2147,7 +2147,7 @@ function hydrateViewport(container, componentFn, props, rootMargin = 500) {
   const viewportWalker = createHydrateWalker(container, viewportMarkers);
   componentFn(props || {}, /* @__PURE__ */ new Map(), viewportWalker);
   if (deferredMarkers.length > 0) {
-    return new Promise((resolve35) => {
+    return new Promise((resolve38) => {
       const observer = new IntersectionObserver((entries) => {
         const toHydrate = [];
         for (const entry of entries) {
@@ -2170,7 +2170,7 @@ function hydrateViewport(container, componentFn, props, rootMargin = 500) {
         }
         if (observer._observed === 0) {
           observer.disconnect();
-          resolve35();
+          resolve38();
         }
       }, { rootMargin: `${rootMargin}px` });
       observer._observed = deferredMarkers.length;
@@ -3033,12 +3033,12 @@ function ensureChunk(chunkUrl) {
   if (typeof document === "undefined" || typeof document.createElement !== "function") {
     return Promise.resolve();
   }
-  return new Promise((resolve35, reject) => {
+  return new Promise((resolve38, reject) => {
     const s = document.createElement("script");
     s.src = chunkUrl;
     s.onload = () => {
       failedChunks.delete(chunkUrl);
-      resolve35();
+      resolve38();
     };
     s.onerror = () => {
       loadedChunks.delete(chunkUrl);
@@ -16728,8 +16728,7 @@ function parse4(source, options2 = {}) {
         "Check the line indicated by the ^ marker for missing brackets, quotes, or JSX syntax.",
         "If you wrote literal { or } inside JSX text, escape them as {'{'} and {'}'} or use { }.",
         "Ensure all JSX tags are properly closed and component names start with an uppercase letter."
-      ],
-      tip: "Vesk parses with Acorn + TypeScript + JSX \u2014 use the code frame above to locate the error."
+      ]
     });
   }
 }
@@ -21173,7 +21172,7 @@ function custom(fn, msg) {
   return { validate: fn, message: msg || "Invalid value" };
 }
 function Field(props, registry, hydrate) {
-  const { name, label, rules = [], children, errorClass, class: className, style, ...rest } = props;
+  const { name, label, rules: rules2 = [], children, errorClass, class: className, style, ...rest } = props;
   if (formIsSSR()) {
     const labelHtml = label ? `<label>${escapeHtml2(String(label))}</label>` : "";
     const serverErrors = readServerFieldErrors();
@@ -21195,7 +21194,7 @@ function Field(props, registry, hydrate) {
     }
     const inner = wrapper2 ? wrapper2.querySelector(`[data-vsk-field="${name}"]`) : null;
     const fieldEl = inner || wrapper2;
-    if (fieldEl) fieldEl.__vsk_rules = rules;
+    if (fieldEl) fieldEl.__vsk_rules = rules2;
     return document.createDocumentFragment();
   }
   const wrapper = document.createElement("div");
@@ -21205,7 +21204,7 @@ function Field(props, registry, hydrate) {
   for (const [k, v] of Object.entries(rest)) {
     if (v != null && v !== false) wrapper.setAttribute(k, v === true ? "" : String(v));
   }
-  wrapper.__vsk_rules = rules;
+  wrapper.__vsk_rules = rules2;
   if (label) {
     const lbl = document.createElement("label");
     lbl.textContent = label;
@@ -21240,10 +21239,10 @@ function bindFormSubmit(form, { action, method, onSubmit, onError, onSuccess })
       const fieldName = el.getAttribute("data-vsk-field");
       const propRules = el.__vsk_rules || [];
       const schemaRules = fieldName && actionSchema && actionSchema[fieldName] ? Array.isArray(actionSchema[fieldName]) ? actionSchema[fieldName] : [actionSchema[fieldName]] : [];
-      const rules = [...propRules, ...schemaRules];
+      const rules2 = [...propRules, ...schemaRules];
       const errEl = el.querySelector("[data-vsk-error]");
       let errMsg = "";
-      for (const rule of rules) {
+      for (const rule of rules2) {
         if (!rule.validate(obj[fieldName || ""])) {
           errMsg = rule.message;
           break;
@@ -23764,8 +23763,8 @@ function isFormAction(action) {
 function validateActionInput(def, input) {
   const issues = [];
   for (const [field, ruleOrRules] of Object.entries(def.input || {})) {
-    const rules = Array.isArray(ruleOrRules) ? ruleOrRules : [ruleOrRules];
-    for (const rule of rules) {
+    const rules2 = Array.isArray(ruleOrRules) ? ruleOrRules : [ruleOrRules];
+    for (const rule of rules2) {
       if (rule && !rule.validate(input[field])) {
         issues.push({ field, message: rule.message });
         break;
@@ -24862,7 +24861,7 @@ is not a problem with esbuild. You need to fix your environment instead.
         let latestResultPromise;
         let provideLatestResult;
         if (isContext)
-          requestCallbacks["on-end"] = (id, request2) => new Promise((resolve35) => {
+          requestCallbacks["on-end"] = (id, request2) => new Promise((resolve38) => {
             buildResponseToResult(request2, (err, result2, onEndErrors, onEndWarnings) => {
               const response = {
                 errors: onEndErrors,
@@ -24872,7 +24871,7 @@ is not a problem with esbuild. You need to fix your environment instead.
               latestResultPromise = void 0;
               provideLatestResult = void 0;
               sendResponse(id, response);
-              resolve35();
+              resolve38();
             });
           });
         sendRequest(refs, request, (error, response) => {
@@ -24889,10 +24888,10 @@ is not a problem with esbuild. You need to fix your environment instead.
           let didDispose = false;
           const result2 = {
             rebuild: () => {
-              if (!latestResultPromise) latestResultPromise = new Promise((resolve35, reject) => {
+              if (!latestResultPromise) latestResultPromise = new Promise((resolve38, reject) => {
                 let settlePromise;
                 provideLatestResult = (err, result22) => {
-                  if (!settlePromise) settlePromise = () => err ? reject(err) : resolve35(result22);
+                  if (!settlePromise) settlePromise = () => err ? reject(err) : resolve38(result22);
                 };
                 const triggerAnotherBuild = () => {
                   const request2 = {
@@ -24913,7 +24912,7 @@ is not a problem with esbuild. You need to fix your environment instead.
               });
               return latestResultPromise;
             },
-            watch: (options22 = {}) => new Promise((resolve35, reject) => {
+            watch: (options22 = {}) => new Promise((resolve38, reject) => {
               if (!streamIn.hasFS) throw new Error(`Cannot use the "watch" API in this environment`);
               const keys = {};
               const delay = getFlag(options22, keys, "delay", mustBeInteger);
@@ -24925,10 +24924,10 @@ is not a problem with esbuild. You need to fix your environment instead.
               if (delay) request2.delay = delay;
               sendRequest(refs, request2, (error2) => {
                 if (error2) reject(new Error(error2));
-                else resolve35(void 0);
+                else resolve38(void 0);
               });
             }),
-            serve: (options22 = {}) => new Promise((resolve35, reject) => {
+            serve: (options22 = {}) => new Promise((resolve38, reject) => {
               if (!streamIn.hasFS) throw new Error(`Cannot use the "serve" API in this environment`);
               const keys = {};
               const port2 = getFlag(options22, keys, "port", mustBeValidPortNumber);
@@ -24966,28 +24965,28 @@ is not a problem with esbuild. You need to fix your environment instead.
                     sendResponse(id, {});
                   };
                 }
-                resolve35(response2);
+                resolve38(response2);
               });
             }),
-            cancel: () => new Promise((resolve35) => {
-              if (didDispose) return resolve35();
+            cancel: () => new Promise((resolve38) => {
+              if (didDispose) return resolve38();
               const request2 = {
                 command: "cancel",
                 key: buildKey
               };
               sendRequest(refs, request2, () => {
-                resolve35();
+                resolve38();
               });
             }),
-            dispose: () => new Promise((resolve35) => {
-              if (didDispose) return resolve35();
+            dispose: () => new Promise((resolve38) => {
+              if (didDispose) return resolve38();
               didDispose = true;
               const request2 = {
                 command: "dispose",
                 key: buildKey
               };
               sendRequest(refs, request2, () => {
-                resolve35();
+                resolve38();
                 scheduleOnDisposeCallbacks();
                 refs.unref();
               });
@@ -25026,7 +25025,7 @@ is not a problem with esbuild. You need to fix your environment instead.
             onLoad: []
           };
           i++;
-          let resolve35 = (path3, options2 = {}) => {
+          let resolve38 = (path3, options2 = {}) => {
             if (!isSetupDone) throw new Error('Cannot call "resolve" before plugin setup has completed');
             if (typeof path3 !== "string") throw new Error(`The path to resolve must be a string`);
             let keys2 = /* @__PURE__ */ Object.create(null);
@@ -25070,7 +25069,7 @@ is not a problem with esbuild. You need to fix your environment instead.
           };
           let promise = setup({
             initialOptions,
-            resolve: resolve35,
+            resolve: resolve38,
             onStart(callback) {
               let registeredText = `This error came from the "onStart" callback registered here:`;
               let registeredNote = extractCallerV8(new Error(registeredText), streamIn, "onStart");
@@ -25763,46 +25762,46 @@ More information: The file containing the code for esbuild's JavaScript API (${_
         }
       };
       longLivedService = {
-        build: (options2) => new Promise((resolve35, reject) => {
+        build: (options2) => new Promise((resolve38, reject) => {
           service.buildOrContext({
             callName: "build",
             refs,
             options: options2,
             isTTY: isTTY(),
             defaultWD,
-            callback: (err, res) => err ? reject(err) : resolve35(res)
+            callback: (err, res) => err ? reject(err) : resolve38(res)
           });
         }),
-        context: (options2) => new Promise((resolve35, reject) => service.buildOrContext({
+        context: (options2) => new Promise((resolve38, reject) => service.buildOrContext({
           callName: "context",
           refs,
           options: options2,
           isTTY: isTTY(),
           defaultWD,
-          callback: (err, res) => err ? reject(err) : resolve35(res)
+          callback: (err, res) => err ? reject(err) : resolve38(res)
         })),
-        transform: (input, options2) => new Promise((resolve35, reject) => service.transform({
+        transform: (input, options2) => new Promise((resolve38, reject) => service.transform({
           callName: "transform",
           refs,
           input,
           options: options2 || {},
           isTTY: isTTY(),
           fs: fsAsync,
-          callback: (err, res) => err ? reject(err) : resolve35(res)
+          callback: (err, res) => err ? reject(err) : resolve38(res)
         })),
-        formatMessages: (messages, options2) => new Promise((resolve35, reject) => service.formatMessages({
+        formatMessages: (messages, options2) => new Promise((resolve38, reject) => service.formatMessages({
           callName: "formatMessages",
           refs,
           messages,
           options: options2,
-          callback: (err, res) => err ? reject(err) : resolve35(res)
+          callback: (err, res) => err ? reject(err) : resolve38(res)
         })),
-        analyzeMetafile: (metafile, options2) => new Promise((resolve35, reject) => service.analyzeMetafile({
+        analyzeMetafile: (metafile, options2) => new Promise((resolve38, reject) => service.analyzeMetafile({
           callName: "analyzeMetafile",
           refs,
           metafile: typeof metafile === "string" ? metafile : JSON.stringify(metafile),
           options: options2,
-          callback: (err, res) => err ? reject(err) : resolve35(res)
+          callback: (err, res) => err ? reject(err) : resolve38(res)
         }))
       };
       return longLivedService;
@@ -25880,13 +25879,13 @@ error: ${text}`);
         worker.postMessage(msg);
         let status = Atomics.wait(sharedBufferView, 0, 0);
         if (status !== "ok" && status !== "not-equal") throw new Error("Internal error: Atomics.wait() failed: " + status);
-        let { message: { id: id2, resolve: resolve35, reject, properties } } = worker_threads2.receiveMessageOnPort(mainPort);
+        let { message: { id: id2, resolve: resolve38, reject, properties } } = worker_threads2.receiveMessageOnPort(mainPort);
         if (id !== id2) throw new Error(`Internal error: Expected id ${id} but got id ${id2}`);
         if (reject) {
           applyProperties(reject, properties);
           throw reject;
         }
-        return resolve35;
+        return resolve38;
       };
       worker.unref();
       return {
@@ -26178,8 +26177,9 @@ function scanHeadTag(html, lt) {
     if (aName) attrs.set(aName, value);
   }
   let raw2 = html.slice(lt, i);
-  if (!selfClosing && tag === "title") {
-    const closeTag = html.indexOf("</title", i);
+  const nonVoidTags = /* @__PURE__ */ new Set(["title", "script", "style", "noscript"]);
+  if (!selfClosing && nonVoidTags.has(tag)) {
+    const closeTag = html.indexOf("</" + tag, i);
     if (closeTag !== -1) {
       const end = html.indexOf(">", closeTag);
       if (end !== -1) {
@@ -26262,8 +26262,12 @@ function mergeHeadHtml(pageHead, layoutHead) {
     const bi = order.findIndex((o) => bk.startsWith(o));
     return (ai === -1 ? 999 : ai) - (bi === -1 ? 999 : bi);
   });
+  const unkeyed = [];
+  for (const e of [...layoutEntries, ...pageEntries]) {
+    if (extractKey(e) === null && !unkeyed.includes(e.raw)) unkeyed.push(e.raw);
+  }
   return {
-    html: sorted.map((e) => e.html).join("\n"),
+    html: [...sorted.map((e) => e.html), ...unkeyed].join("\n"),
     conflicts
   };
 }
@@ -28349,6 +28353,9 @@ var init_ssr_store = __esm({
 // ../compiler/src/server-render.ts
 var server_render_exports = {};
 __export(server_render_exports, {
+  applyHeadInjects: () => applyHeadInjects,
+  applyHeadPlugins: () => applyHeadPlugins,
+  applyHtmlPlugins: () => applyHtmlPlugins,
   buildDataScripts: () => buildDataScripts,
   compileFile: () => compileFile,
   render: () => render2,
@@ -28509,6 +28516,37 @@ function clearSsrCells(token) {
     if (typeof k === "string" && k.startsWith(token)) cells.delete(k);
   }
 }
+async function applyHeadPlugins(headHtml, plugins, ctx2) {
+  if (!plugins || plugins.length === 0) return headHtml;
+  let out = headHtml;
+  for (const plugin of plugins) {
+    if (typeof plugin.onHead === "function") {
+      const result2 = await plugin.onHead(out, ctx2);
+      if (typeof result2 === "string") out = result2;
+    }
+  }
+  return out;
+}
+async function applyHtmlPlugins(html, plugins, ctx2) {
+  if (!plugins || plugins.length === 0) return html;
+  let out = html;
+  for (const plugin of plugins) {
+    if (typeof plugin.onHtml === "function") {
+      const result2 = await plugin.onHtml(out, ctx2);
+      if (typeof result2 === "string") out = result2;
+    }
+  }
+  return out;
+}
+async function applyHeadInjects(headHtml, options2, ctx2) {
+  if (options2.plugins && options2.plugins.length > 0) {
+    return applyHeadPlugins(headHtml, options2.plugins, ctx2);
+  }
+  if (options2.headExtra) {
+    return mergeHeadHtml(headHtml, options2.headExtra).html;
+  }
+  return headHtml;
+}
 async function ssg(source, componentName, customProps, options2 = {}) {
   const ast = parse4(source, options2.sourcePath ? { filename: options2.sourcePath } : {});
   const ir = generateIR(ast, source, options2.sourcePath);
@@ -28548,23 +28586,32 @@ async function ssg(source, componentName, customProps, options2 = {}) {
   const cssUrls = options2.cssUrls || (options2.cssUrl ? [options2.cssUrl] : []);
   const cssLink = cssUrls.map((u) => `	<link rel="stylesheet" href="${u}" />
 `).join("");
+  const renderCtx = { sourcePath: options2.sourcePath };
+  let finalHead = ['	<meta charset="utf-8" />', '	<meta name="viewport" content="width=device-width, initial-scale=1" />'].join("\n");
+  if (cssLink) finalHead += "\n" + cssLink.trimEnd();
+  if (headHtml) finalHead += "\n" + headHtml.split("\n").map((l) => "	" + l).join("\n");
+  finalHead = await applyHeadInjects(
+    finalHead,
+    { plugins: options2.plugins, headExtra: options2.headExtra },
+    renderCtx
+  );
   const html = `<!DOCTYPE html>
 <html>
 <head>
-	<meta charset="utf-8" />
-	<meta name="viewport" content="width=device-width, initial-scale=1" />
-${cssLink}${headHtml ? "	" + headHtml.split("\n").join("\n	") + "\n" : ""}</head>
+${finalHead}
+</head>
 <body>
 ${bodyHtml}${scriptBlock}</body>
 </html>
 `;
+  const finalHtml = await applyHtmlPlugins(html, options2.plugins, renderCtx);
   const staticLists = ir.components.some((c) => {
     return c.body.some((node) => {
       if (node instanceof MapRegion) return isStaticIR(node.bodyTemplate) && isStaticIR(node.alternateNodes);
       return false;
     });
   });
-  return { html, body: bodyHtml, head: headHtml, props: serializedProps, clientCode, static: !hasClient, staticLists };
+  return { html: finalHtml, body: bodyHtml, head: headHtml, props: serializedProps, clientCode, static: !hasClient, staticLists };
 }
 function buildDataScripts(ssrProps, ssrData, external) {
   const meaningfulKeys = ssrProps !== void 0 && ssrProps !== null ? Object.keys(ssrProps).filter((k) => k !== "children" && k !== "params") : [];
@@ -28634,16 +28681,22 @@ async function renderFullPage(source, componentName, props = {}, registry = /* @
         if (sec.contentSecurityPolicy !== false) headLines.push(`	<meta http-equiv="Content-Security-Policy" content="${quoteAttr(sec.contentSecurityPolicy || "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; frame-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'")}" />`);
         if (sec.autoEscape !== false) headLines.push(`	<!-- vesk: auto-escape enabled -->`);
       }
-      return `<!DOCTYPE html>
+      const finalHead = await applyHeadInjects(
+        headLines.join("\n"),
+        { plugins: options2.plugins, headExtra: options2.headExtra },
+        { sourcePath: options2.sourcePath, url: options2.__vesk?.url || void 0 }
+      );
+      const docHtml = `<!DOCTYPE html>
 <html>
 <head>
-${headLines.join("\n")}</head>
+${finalHead}</head>
 <body>
 <div id="root">
 ${bodyHtml}
 </div>
 ${dataScriptBlock}${clientScript}</body>
 </html>`;
+      return applyHtmlPlugins(docHtml, options2.plugins, { sourcePath: options2.sourcePath, url: options2.__vesk?.url || void 0 });
     } finally {
       delete globalThis.__vsk_ssr;
     }
@@ -28678,16 +28731,13 @@ function renderPageStream(source, componentName, props = {}, registry = /* @__PU
     const cssUrls = options2.cssUrls || (options2.cssUrl ? [options2.cssUrl] : []);
     const cssLink = cssUrls.map((u) => `	<link rel="stylesheet" href="${u}" />
 `).join("");
-    yield '<!DOCTYPE html>\n<html>\n<head>\n	<meta charset="utf-8" />\n	<meta name="viewport" content="width=device-width, initial-scale=1" />\n';
-    if (cssLink) yield cssLink;
+    const headParts = ['	<meta charset="utf-8" />', '	<meta name="viewport" content="width=device-width, initial-scale=1" />'];
+    if (cssLink) headParts.push(cssLink.trimEnd());
     if (options2.security) {
       const sec = options2.security;
-      if (sec.referrerPolicy !== false) yield `	<meta name="referrer" content="${quoteAttr(sec.referrerPolicy || "strict-origin-when-cross-origin")}" />
-`;
-      if (sec.contentSecurityPolicy !== false) yield `	<meta http-equiv="Content-Security-Policy" content="${quoteAttr(sec.contentSecurityPolicy || "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; frame-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'")}" />
-`;
-      if (sec.autoEscape !== false) yield `	<!-- vesk: auto-escape enabled -->
-`;
+      if (sec.referrerPolicy !== false) headParts.push(`	<meta name="referrer" content="${quoteAttr(sec.referrerPolicy || "strict-origin-when-cross-origin")}" />`);
+      if (sec.contentSecurityPolicy !== false) headParts.push(`	<meta http-equiv="Content-Security-Policy" content="${quoteAttr(sec.contentSecurityPolicy || "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; frame-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'")}" />`);
+      if (sec.autoEscape !== false) headParts.push("	<!-- vesk: auto-escape enabled -->");
     }
     if (targetComp) {
       let headHtml = renderHeadHtml(targetComp, ssrProps);
@@ -28700,8 +28750,15 @@ function renderPageStream(source, componentName, props = {}, registry = /* @__PU
           }
         }
       }
-      if (headHtml) yield "	" + headHtml.split("\n").join("\n	") + "\n";
+      if (headHtml) headParts.push("	" + headHtml.split("\n").join("\n	"));
     }
+    yield "<!DOCTYPE html>\n<html>\n<head>\n";
+    const finalHead = await applyHeadInjects(
+      headParts.join("\n"),
+      { plugins: options2.plugins, headExtra: options2.headExtra },
+      { sourcePath: options2.sourcePath, url: options2.__vesk?.url || void 0 }
+    );
+    yield finalHead + "\n";
     yield '</head>\n<body>\n<div id="root">\n';
     globalThis.__vsk_ssr = true;
     globalThis.__vsk_ssr_token = Math.random().toString(36).slice(2);
@@ -28753,17 +28810,17 @@ 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";
+import { resolve as resolve10, sep as sep2 } from "node:path";
+import { existsSync as existsSync9, statSync as statSync4, readFileSync as readFileSync10 } from "node:fs";
 function resolveWithin(baseDir, relPath) {
-  const base = resolve9(baseDir);
-  const target = resolve9(baseDir, relPath);
+  const base = resolve10(baseDir);
+  const target = resolve10(baseDir, relPath);
   const prefix = base + sep2;
   if (!target.startsWith(prefix)) return null;
   return target;
 }
 function installMdReadHook(publicDirs) {
-  const dirs = publicDirs.map((d) => resolve9(d));
+  const dirs = publicDirs.map((d) => resolve10(d));
   globalThis.__vsk_md_read_file = (p) => {
     for (const dir of dirs) {
       try {
@@ -28773,7 +28830,7 @@ function installMdReadHook(publicDirs) {
         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");
+        if (existsSync9(abs) && statSync4(abs).isFile()) return readFileSync10(abs, "utf8");
       } catch {
       }
     }
@@ -28806,13 +28863,13 @@ __export(plugins_exports, {
   writePluginState: () => writePluginState
 });
 import {
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   writeFileSync as writeFileSync4,
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync2,
   statSync as statSync7
 } from "node:fs";
-import { resolve as resolve12, dirname as dirname8, join as join7, extname as extname4, basename } from "node:path";
+import { resolve as resolve13, dirname as dirname8, join as join7, extname as extname4, basename } from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 import { spawn } from "node:child_process";
 function defaultState() {
@@ -28822,14 +28879,14 @@ function eqIgnoreCase(a, b) {
   return String(a || "").toLowerCase() === String(b || "").toLowerCase();
 }
 function stateFilePath(veskDir) {
-  return resolve12(veskDir, PLUGIN_STATE_FILENAME);
+  return resolve13(veskDir, PLUGIN_STATE_FILENAME);
 }
 function readPluginState(veskDir) {
   const file = stateFilePath(veskDir);
-  if (!existsSync11(file)) return defaultState();
+  if (!existsSync12(file)) return defaultState();
   let raw2;
   try {
-    raw2 = JSON.parse(readFileSync12(file, "utf-8"));
+    raw2 = JSON.parse(readFileSync13(file, "utf-8"));
   } catch {
     return defaultState();
   }
@@ -28847,11 +28904,11 @@ function readPluginState(veskDir) {
 function writePluginState(veskDir, state) {
   const file = stateFilePath(veskDir);
   const dir = dirname8(file);
-  if (!existsSync11(dir)) mkdirSync2(dir, { recursive: true });
+  if (!existsSync12(dir)) mkdirSync2(dir, { recursive: true });
   writeFileSync4(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function resolvePackage(appDir, pkg) {
-  const require3 = createRequire3(resolve12(appDir, "package.json"));
+  const require3 = createRequire3(resolve13(appDir, "package.json"));
   let entryPath = null;
   let pkgJsonPath = null;
   let pkgJson = null;
@@ -28865,7 +28922,7 @@ function resolvePackage(appDir, pkg) {
       while (cur && cur !== dirname8(cur) && !seen.has(cur)) {
         seen.add(cur);
         const candidate = join7(cur, "package.json");
-        if (existsSync11(candidate)) {
+        if (existsSync12(candidate)) {
           pkgJsonPath = candidate;
           break;
         }
@@ -28876,15 +28933,15 @@ function resolvePackage(appDir, pkg) {
     } catch {
     }
   }
-  if (pkgJsonPath && existsSync11(pkgJsonPath)) {
+  if (pkgJsonPath && existsSync12(pkgJsonPath)) {
     pkgJson = readJsonFile(pkgJsonPath);
     const main = pkgJson?.main || pkgJson?.module || "index.js";
-    entryPath = resolve12(dirname8(pkgJsonPath), main);
+    entryPath = resolve13(dirname8(pkgJsonPath), main);
   }
   let localPath = localDir(appDir, pkg);
   if (!localPath) {
     for (const sub of ["src/plugins", "plugins", "lib/plugins"]) {
-      const candidate = localDir(resolve12(appDir, sub), pkg);
+      const candidate = localDir(resolve13(appDir, sub), pkg);
       if (candidate) {
         localPath = candidate;
         break;
@@ -28894,28 +28951,28 @@ function resolvePackage(appDir, pkg) {
   if (localPath) {
     const localJson = join7(localPath, "package.json");
     let json = null;
-    if (existsSync11(localJson)) {
+    if (existsSync12(localJson)) {
       json = readJsonFile(localJson);
     }
     return { installed: true, path: localPath, dir: localPath, packageJson: json ?? pkgJson };
   }
-  const installed2 = !!pkgJsonPath && existsSync11(pkgJsonPath);
+  const installed2 = !!pkgJsonPath && existsSync12(pkgJsonPath);
   return { installed: installed2, path: entryPath, dir: installed2 ? dirname8(pkgJsonPath) : null, packageJson: pkgJson };
 }
 function localDir(base, pkg) {
   if (pkg.startsWith("@")) {
     const parts = pkg.split("/");
-    const p2 = resolve12(base, parts[0], parts[1] ?? "");
-    if (existsSync11(p2)) return p2;
+    const p2 = resolve13(base, parts[0], parts[1] ?? "");
+    if (existsSync12(p2)) return p2;
     return null;
   }
-  const p = resolve12(base, pkg);
-  if (existsSync11(p)) return p;
+  const p = resolve13(base, pkg);
+  if (existsSync12(p)) return p;
   return null;
 }
 function readJsonFile(file) {
   try {
-    if (existsSync11(file)) return JSON.parse(readFileSync12(file, "utf-8"));
+    if (existsSync12(file)) return JSON.parse(readFileSync13(file, "utf-8"));
   } catch {
   }
   return null;
@@ -28955,7 +29012,7 @@ function repositoryToString(r) {
 function assemblePluginMeta(probe) {
   const pkgJson = probe.packageJson || {};
   const dir = probe.dir;
-  const meta = dir ? readJsonFile(resolve12(dir, "vesk.meta.json")) : null;
+  const meta = dir ? readJsonFile(resolve13(dir, "vesk.meta.json")) : null;
   const hasMeta = !!meta && Object.keys(meta).length > 0;
   const m = meta || {};
   const metaSource = hasMeta ? "vesk.meta.json" : probe.packageJson ? "package.json" : "none";
@@ -29194,11 +29251,11 @@ function findIconFile(dir, meta) {
   const explicit = str(meta?.icon);
   if (explicit) {
     const p = resolveWithin(dir, explicit);
-    if (p && existsSync11(p) && statSync7(p).isFile()) return p;
+    if (p && existsSync12(p) && statSync7(p).isFile()) return p;
   }
   for (const name of ["icon.png", "icon.ico"]) {
-    const p = resolve12(dir, name);
-    if (existsSync11(p) && statSync7(p).isFile()) return p;
+    const p = resolve13(dir, name);
+    if (existsSync12(p) && statSync7(p).isFile()) return p;
   }
   return null;
 }
@@ -29206,7 +29263,7 @@ function findPluginIcon(appDir, name) {
   const probe = resolvePackage(appDir, name);
   const dir = probe.dir;
   if (!dir) return null;
-  const meta = readJsonFile(resolve12(dir, "vesk.meta.json"));
+  const meta = readJsonFile(resolve13(dir, "vesk.meta.json"));
   const iconPath = findIconFile(dir, meta);
   if (!iconPath) return null;
   const ext = extname4(iconPath).toLowerCase();
@@ -29269,7 +29326,7 @@ function resolveDtsPath(probe, pkgJson) {
   for (const rel of candidates) {
     if (!rel) continue;
     const abs = resolveWithin(dir, rel);
-    if (abs && existsSync11(abs) && statSync7(abs).isFile()) return abs;
+    if (abs && existsSync12(abs) && statSync7(abs).isFile()) return abs;
   }
   return null;
 }
@@ -29585,7 +29642,7 @@ function introspectPlugin(appDir, name) {
   const pkgName = str(pkgJson.name) ?? name;
   const exportsMap = flattenPackageExports(pkgJson.exports);
   const dtsPath = resolveDtsPath(probe, pkgJson);
-  const dtsExports = dtsPath ? parseDtsExports(readFileSync12(dtsPath, "utf-8")) : [];
+  const dtsExports = dtsPath ? parseDtsExports(readFileSync13(dtsPath, "utf-8")) : [];
   return {
     ok: true,
     name: pkgName,
@@ -29726,12 +29783,12 @@ __export(static_exports, {
   generateSitemap: () => generateSitemap,
   generateSsgRoutes: () => generateSsgRoutes
 });
-import { mkdirSync as mkdirSync3, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync8, existsSync as existsSync12, writeFileSync as writeFileSync5, readFileSync as readFileSync13 } from "node:fs";
-import { resolve as resolve13, join as join8 } from "node:path";
+import { mkdirSync as mkdirSync3, copyFileSync as copyFileSync2, readdirSync as readdirSync3, statSync as statSync8, existsSync as existsSync13, writeFileSync as writeFileSync5, readFileSync as readFileSync14 } from "node:fs";
+import { resolve as resolve14, join as join8 } from "node:path";
 function copyStaticAssets2(publicDir, outDir2) {
-  const targetDir = resolve13(outDir2, "static", "public");
+  const targetDir = resolve14(outDir2, "static", "public");
   mkdirSync3(targetDir, { recursive: true });
-  if (!existsSync12(publicDir))
+  if (!existsSync13(publicDir))
     return;
   function copyDir(src2, dest) {
     mkdirSync3(dest, { recursive: true });
@@ -29749,10 +29806,11 @@ function copyStaticAssets2(publicDir, outDir2) {
   }
   copyDir(publicDir, targetDir);
 }
-async function generateSsgRoutes(routeTree, appDir, outDir2) {
+async function generateSsgRoutes(routeTree, appDir, outDir2, plugins, headExtra, cssUrls) {
   const { ssg: ssg2 } = await Promise.resolve().then(() => (init_server_render(), server_render_exports));
-  const prerenderDir = resolve13(outDir2, "prerendered");
+  const prerenderDir = resolve14(outDir2, "prerendered");
   mkdirSync3(prerenderDir, { recursive: true });
+  const ssgOptions = { plugins, headExtra, cssUrls };
   const results = [];
   async function evaluateExport(src2, exportName) {
     try {
@@ -29770,8 +29828,8 @@ async function generateSsgRoutes(routeTree, appDir, outDir2) {
   async function walk6(nodes) {
     for (const node of nodes) {
       if (node.page) {
-        const pagePath = resolve13(appDir, node.sourceDir, "page.vsk");
-        const src2 = readFileSync13(pagePath, "utf-8");
+        const pagePath = resolve14(appDir, node.sourceDir, "page.vsk");
+        const src2 = readFileSync14(pagePath, "utf-8");
         const hasStaticProps = src2.includes("getStaticProps");
         const hasStaticPaths = src2.includes("getStaticPaths");
         if (hasStaticPaths) {
@@ -29780,7 +29838,7 @@ async function generateSsgRoutes(routeTree, appDir, outDir2) {
             for (const entry of paths) {
               try {
                 const params = entry.params || {};
-                const result2 = await ssg2(src2, null, params, {});
+                const result2 = await ssg2(src2, null, params, ssgOptions);
                 const urlPath = entry.path || node.fullPath;
                 const relName = urlPath === "/" ? "index.html" : `${urlPath.replace(/^\//, "")}.html`;
                 const htmlPath = resolveWithin(prerenderDir, relName);
@@ -29788,7 +29846,7 @@ async function generateSsgRoutes(routeTree, appDir, outDir2) {
                   console.error(`vesk: SSG path escaped output dir \u2014 skipping ${pagePath} (path: ${urlPath})`);
                   continue;
                 }
-                mkdirSync3(resolve13(htmlPath, ".."), { recursive: true });
+                mkdirSync3(resolve14(htmlPath, ".."), { recursive: true });
                 writeFileSync5(htmlPath, result2.html);
                 results.push({ path: urlPath, html: htmlPath, static: result2.static, params });
               } catch (e) {
@@ -29799,9 +29857,9 @@ async function generateSsgRoutes(routeTree, appDir, outDir2) {
           }
         } else if (hasStaticProps) {
           try {
-            const result2 = await ssg2(src2, null, void 0, {});
-            const htmlPath = resolve13(prerenderDir, node.fullPath === "/" ? "index.html" : `${node.fullPath.slice(1)}.html`);
-            mkdirSync3(resolve13(htmlPath, ".."), { recursive: true });
+            const result2 = await ssg2(src2, null, void 0, ssgOptions);
+            const htmlPath = resolve14(prerenderDir, node.fullPath === "/" ? "index.html" : `${node.fullPath.slice(1)}.html`);
+            mkdirSync3(resolve14(htmlPath, ".."), { recursive: true });
             writeFileSync5(htmlPath, result2.html);
             results.push({ path: node.fullPath, html: htmlPath, static: result2.static });
           } catch (e) {
@@ -29871,14 +29929,14 @@ var image_pipeline_exports = {};
 __export(image_pipeline_exports, {
   optimizeImages: () => optimizeImages
 });
-import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync6, readFileSync as readFileSync14, existsSync as existsSync13, readdirSync as readdirSync4, statSync as statSync9 } from "node:fs";
-import { resolve as resolve14, extname as extname5, dirname as dirname9 } from "node:path";
+import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync6, readFileSync as readFileSync15, existsSync as existsSync14, readdirSync as readdirSync4, statSync as statSync9 } from "node:fs";
+import { resolve as resolve15, extname as extname5, dirname as dirname9 } from "node:path";
 async function processImage(srcPath, outDir2, baseName) {
   const image = sharpFn ? sharpFn(srcPath) : null;
   if (!image) {
-    const original = readFileSync14(srcPath);
+    const original = readFileSync15(srcPath);
     for (const w of OUTPUT_WIDTHS) {
-      const outputPath = resolve14(outDir2, `${baseName}-${w}w`);
+      const outputPath = resolve15(outDir2, `${baseName}-${w}w`);
       mkdirSync4(dirname9(outputPath), { recursive: true });
       writeFileSync6(outputPath, original);
     }
@@ -29892,12 +29950,12 @@ async function processImage(srcPath, outDir2, baseName) {
       continue;
     const resized = image.clone().resize({ width: w, withoutEnlargement: true });
     const base = `${baseName}-${w}w`;
-    const jpgPath = resolve14(outDir2, `${base}${extname5(srcPath)}`);
+    const jpgPath = resolve15(outDir2, `${base}${extname5(srcPath)}`);
     mkdirSync4(dirname9(jpgPath), { recursive: true });
     await resized.toFile(jpgPath);
     generated.push(jpgPath);
     for (const fmt of FORMATS) {
-      const fmtPath = resolve14(outDir2, `${base}.${fmt}`);
+      const fmtPath = resolve15(outDir2, `${base}.${fmt}`);
       await resized.toFormat(fmt, { quality: 80 }).toFile(fmtPath);
       generated.push(fmtPath);
     }
@@ -29914,14 +29972,14 @@ function collectImageRefs(appDir) {
       return;
     }
     for (const entry of entries) {
-      const full = resolve14(dir, entry);
+      const full = resolve15(dir, entry);
       const st = statSync9(full);
       if (st.isDirectory()) {
         if (entry.startsWith("."))
           continue;
         walk6(full);
       } else if (entry === "page.vsk") {
-        const src2 = readFileSync14(full, "utf-8");
+        const src2 = readFileSync15(full, "utf-8");
         const imgRegex = /<Image\s+src=["']([^"']+)["']/g;
         let m;
         while ((m = imgRegex.exec(src2)) !== null) {
@@ -29934,7 +29992,7 @@ function collectImageRefs(appDir) {
   return refs;
 }
 async function optimizeImages(appDir, outDir2) {
-  const imageOutDir = resolve14(outDir2, "static", "images");
+  const imageOutDir = resolve15(outDir2, "static", "images");
   mkdirSync4(imageOutDir, { recursive: true });
   const refs = collectImageRefs(appDir);
   if (refs.length === 0) {
@@ -29944,14 +30002,14 @@ async function optimizeImages(appDir, outDir2) {
   const results = [];
   for (const ref2 of refs) {
     const possiblePaths = [
-      resolve14(appDir, ref2.src),
-      resolve14(appDir, "..", "public", ref2.src.replace(/^\//, "")),
-      resolve14(appDir, "..", "src", ref2.src.replace(/^\//, "")),
-      resolve14(outDir2, "static", "public", ref2.src.replace(/^\//, ""))
+      resolve15(appDir, ref2.src),
+      resolve15(appDir, "..", "public", ref2.src.replace(/^\//, "")),
+      resolve15(appDir, "..", "src", ref2.src.replace(/^\//, "")),
+      resolve15(outDir2, "static", "public", ref2.src.replace(/^\//, ""))
     ];
     let srcPath = null;
     for (const p of possiblePaths) {
-      if (existsSync13(p)) {
+      if (existsSync14(p)) {
         srcPath = p;
         break;
       }
@@ -29998,8 +30056,8 @@ var seo_audit_exports = {};
 __export(seo_audit_exports, {
   runSeoAudit: () => runSeoAudit
 });
-import { readFileSync as readFileSync15, existsSync as existsSync14, readdirSync as readdirSync5, statSync as statSync10 } from "node:fs";
-import { resolve as resolve15 } from "node:path";
+import { readFileSync as readFileSync16, existsSync as existsSync15, readdirSync as readdirSync5, statSync as statSync10 } from "node:fs";
+import { resolve as resolve16 } from "node:path";
 function walkFiles(dir) {
   const results = [];
   let entries;
@@ -30009,7 +30067,7 @@ function walkFiles(dir) {
     return results;
   }
   for (const entry of entries) {
-    const full = resolve15(dir, entry);
+    const full = resolve16(dir, entry);
     const st = statSync10(full);
     if (st.isDirectory()) {
       if (!entry.startsWith("."))
@@ -30024,10 +30082,10 @@ function collectCombinedSource(appDir) {
   const pages = files.filter((f) => f.endsWith("/page.vsk") || f.endsWith("\\page.vsk"));
   const combined = [];
   for (const pagePath of pages) {
-    const dir = resolve15(pagePath, "..");
-    const layoutPath = resolve15(dir, "layout.vsk");
-    const pageSrc = readFileSync15(pagePath, "utf-8");
-    const layoutSrc = existsSync14(layoutPath) ? readFileSync15(layoutPath, "utf-8") : "";
+    const dir = resolve16(pagePath, "..");
+    const layoutPath = resolve16(dir, "layout.vsk");
+    const pageSrc = readFileSync16(pagePath, "utf-8");
+    const layoutSrc = existsSync15(layoutPath) ? readFileSync16(layoutPath, "utf-8") : "";
     const combinedSrc = layoutSrc ? layoutSrc + "\n" + pageSrc : pageSrc;
     combined.push({
       path: pagePath,
@@ -30202,8 +30260,8 @@ var init_platform = __esm({
 });
 
 // ../adapter/src/platform-handler.ts
-import { existsSync as existsSync15 } from "node:fs";
-import { resolve as resolve16, dirname as dirname10 } from "node:path";
+import { existsSync as existsSync16 } from "node:fs";
+import { resolve as resolve17, dirname as dirname10 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function routeName2(segments) {
   const parts = segments.filter(Boolean).map((s) => {
@@ -30220,8 +30278,8 @@ function toId(s) {
   return s.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^_/, "");
 }
 function findCompilerSrc2() {
-  const monorepo = resolve16(__dirname5, "..", "..", "..", "packages", "compiler", "dist");
-  if (existsSync15(monorepo)) return monorepo;
+  const monorepo = resolve17(__dirname5, "..", "..", "..", "packages", "compiler", "dist");
+  if (existsSync16(monorepo)) return monorepo;
   throw new Error('@vesk/compiler/dist not found \u2014 run "npm run build" first');
 }
 function generatePlatformHandlerSource(input) {
@@ -30252,7 +30310,7 @@ function generatePlatformHandlerSource(input) {
 ` : "const __prerendered = new Set();\n";
   const isrCache = "const __isrCache = new Map();";
   const compilerSrc = findCompilerSrc2();
-  const parseCookiesImport = hasMiddleware ? `import { parseCookies } from ${JSON.stringify(resolve16(compilerSrc, "server-cookies.js"))};` : "";
+  const parseCookiesImport = hasMiddleware ? `import { parseCookies } from ${JSON.stringify(resolve17(compilerSrc, "server-cookies.js"))};` : "";
   return `
 ${imports}
 ${parseCookiesImport}
@@ -30443,18 +30501,18 @@ import {
   copyFileSync as copyFileSync3,
   readdirSync as readdirSync6,
   statSync as statSync11,
-  existsSync as existsSync16,
+  existsSync as existsSync17,
   writeFileSync as writeFileSync7,
   rmSync as rmSync2,
-  readFileSync as readFileSync16
+  readFileSync as readFileSync17
 } from "node:fs";
-import { resolve as resolve17, join as join9, extname as extname6, dirname as dirname11 } from "node:path";
+import { resolve as resolve18, join as join9, extname as extname6, dirname as dirname11 } from "node:path";
 function ensureCleanDir(dir) {
   rmSync2(dir, { recursive: true, force: true });
   mkdirSync5(dir, { recursive: true });
 }
 function copyDirContents(srcDir, destDir) {
-  if (!existsSync16(srcDir)) return;
+  if (!existsSync17(srcDir)) return;
   mkdirSync5(destDir, { recursive: true });
   for (const entry of readdirSync6(srcDir)) {
     const srcPath = join9(srcDir, entry);
@@ -30473,35 +30531,35 @@ function writeFile(path, content) {
 }
 function writePlatformStatic(buildStaticDir, platformStaticDir) {
   mkdirSync5(platformStaticDir, { recursive: true });
-  const publicDir = resolve17(buildStaticDir, "public");
-  if (existsSync16(publicDir)) {
+  const publicDir = resolve18(buildStaticDir, "public");
+  if (existsSync17(publicDir)) {
     copyDirContents(publicDir, platformStaticDir);
   }
-  const assetsDir = resolve17(platformStaticDir, "_vesk", "static");
+  const assetsDir = resolve18(platformStaticDir, "_vesk", "static");
   copyDirContents(buildStaticDir, assetsDir);
-  const runtimeAlias = resolve17(platformStaticDir, "_vesk", "runtime.js");
-  const clientPath = resolve17(buildStaticDir, "client.js");
-  if (existsSync16(clientPath)) {
+  const runtimeAlias = resolve18(platformStaticDir, "_vesk", "runtime.js");
+  const clientPath = resolve18(buildStaticDir, "client.js");
+  if (existsSync17(clientPath)) {
     mkdirSync5(dirname11(runtimeAlias), { recursive: true });
     copyFileSync3(clientPath, runtimeAlias);
   }
 }
 function writePrerenderedStatic(prerenderedRoutes, platformStaticDir) {
   for (const route of prerenderedRoutes) {
-    if (!existsSync16(route.html)) continue;
-    const content = readFileSync16(route.html);
+    if (!existsSync17(route.html)) continue;
+    const content = readFileSync17(route.html);
     const htmlRel = route.path === "/" ? "index.html" : `${route.path.replace(/^\//, "")}.html`;
-    const target = resolve17(platformStaticDir, "_vesk", "static", "public", htmlRel);
+    const target = resolve18(platformStaticDir, "_vesk", "static", "public", htmlRel);
     writeFile(target, content);
     if (route.path !== "/" && route.path.endsWith("/")) {
-      const dirIndex = resolve17(platformStaticDir, "_vesk", "static", "public", `${route.path.replace(/^\//, "")}index.html`);
+      const dirIndex = resolve18(platformStaticDir, "_vesk", "static", "public", `${route.path.replace(/^\//, "")}index.html`);
       writeFile(dirIndex, content);
     }
   }
 }
 function listStaticDir(dir) {
   const out = [];
-  if (!existsSync16(dir)) return out;
+  if (!existsSync17(dir)) return out;
   function walk6(d, prefix) {
     for (const entry of readdirSync6(d)) {
       const full = join9(d, entry);
@@ -30509,7 +30567,7 @@ function listStaticDir(dir) {
       if (statSync11(full).isDirectory()) {
         walk6(full, rel);
       } else {
-        out.push({ rel, buffer: readFileSync16(full) });
+        out.push({ rel, buffer: readFileSync17(full) });
       }
     }
   }
@@ -30557,7 +30615,7 @@ __export(platform_deploy_exports, {
   emitPlatformOutput: () => emitPlatformOutput
 });
 import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync6, rmSync as rmSync3, symlinkSync } from "node:fs";
-import { resolve as resolve18, dirname as dirname12, relative as relative3 } from "node:path";
+import { resolve as resolve19, dirname as dirname12, relative as relative3 } from "node:path";
 async function emitPlatformOutput(platform, ctx2) {
   if (platform === "node") return null;
   const prerenderedPaths = ctx2.prerenderedRoutes.map((r) => r.path);
@@ -30568,13 +30626,13 @@ async function emitPlatformOutput(platform, ctx2) {
     hasMiddleware: ctx2.hasMiddleware
   });
   const shell = shellFor(platform);
-  const projectRoot = resolve18(ctx2.outDir, "..");
-  const outRoot = resolve18(projectRoot, shell.root);
+  const projectRoot = resolve19(ctx2.outDir, "..");
+  const outRoot = resolve19(projectRoot, shell.root);
   ensureCleanDir(outRoot);
-  const staticDir2 = shell.staticSubdir === "" ? outRoot : resolve18(outRoot, shell.staticSubdir || "static");
-  writePlatformStatic(resolve18(ctx2.outDir, "static"), staticDir2);
+  const staticDir2 = shell.staticSubdir === "" ? outRoot : resolve19(outRoot, shell.staticSubdir || "static");
+  writePlatformStatic(resolve19(ctx2.outDir, "static"), staticDir2);
   writePrerenderedStatic(ctx2.prerenderedRoutes, staticDir2);
-  const entry = resolve18(ctx2.outDir, ".platform-entry.mjs");
+  const entry = resolve19(ctx2.outDir, ".platform-entry.mjs");
   let source = handler;
   if (shell.imports) source = `${shell.imports}
 ${source}`;
@@ -30592,24 +30650,24 @@ ${shell.bootstrap}
   writeFileSync8(entry, source, "utf-8");
   let handlerRel;
   if (shell.functionFile) {
-    const funcDir = resolve18(outRoot, shell.functionFile.dir);
+    const funcDir = resolve19(outRoot, shell.functionFile.dir);
     mkdirSync6(funcDir, { recursive: true });
     if (shell.functionConfig) {
-      writeFileSync8(resolve18(funcDir, ".vc-config.json"), JSON.stringify(shell.functionConfig, null, 2), "utf-8");
+      writeFileSync8(resolve19(funcDir, ".vc-config.json"), JSON.stringify(shell.functionConfig, null, 2), "utf-8");
     }
     handlerRel = `${shell.functionFile.dir}/${shell.functionFile.file}`;
-    await bundlePlatformHandler({ entry, outfile: resolve18(funcDir, shell.functionFile.file), nodeBuiltins: shell.nodeBuiltins });
+    await bundlePlatformHandler({ entry, outfile: resolve19(funcDir, shell.functionFile.file), nodeBuiltins: shell.nodeBuiltins });
   } else {
     handlerRel = shell.outfile || "index.js";
-    await bundlePlatformHandler({ entry, outfile: resolve18(outRoot, handlerRel), nodeBuiltins: shell.nodeBuiltins });
+    await bundlePlatformHandler({ entry, outfile: resolve19(outRoot, handlerRel), nodeBuiltins: shell.nodeBuiltins });
   }
   for (const file of shell.extraFiles || []) {
-    writeFileSync8(resolve18(outRoot, file.path), file.content, "utf-8");
+    writeFileSync8(resolve19(outRoot, file.path), file.content, "utf-8");
   }
   if (platform === "vercel") {
-    writeFileSync8(resolve18(outRoot, "config.json"), vercelConfigJson(prerenderedPaths), "utf-8");
+    writeFileSync8(resolve19(outRoot, "config.json"), vercelConfigJson(prerenderedPaths), "utf-8");
   }
-  writeFileSync8(resolve18(outRoot, "manifest.json"), JSON.stringify({
+  writeFileSync8(resolve19(outRoot, "manifest.json"), JSON.stringify({
     platform,
     runtime: shell.nodeBuiltins ? "node" : "edge",
     static: shell.staticMode,
@@ -30619,9 +30677,9 @@ ${shell.bootstrap}
     prerendered: prerenderedPaths
   }, null, 2), "utf-8");
   if (platform === "vercel") {
-    const vercelDir = resolve18(projectRoot, ".vercel");
+    const vercelDir = resolve19(projectRoot, ".vercel");
     mkdirSync6(vercelDir, { recursive: true });
-    const linkPath = resolve18(vercelDir, "output");
+    const linkPath = resolve19(vercelDir, "output");
     rmSync3(linkPath, { recursive: true, force: true });
     symlinkSync(relative3(dirname12(linkPath), outRoot), linkPath, "dir");
   }
@@ -34935,8 +34993,8 @@ __export(typecheck_exports, {
   formatTypecheckWarnings: () => formatTypecheckWarnings,
   typecheckProject: () => typecheckProject
 });
-import { readFileSync as readFileSync31, readdirSync as readdirSync14, statSync as statSync22 } from "node:fs";
-import { join as join20, dirname as dirname21, normalize, relative as relative7, resolve as resolve33, sep as sep7 } from "node:path";
+import { readFileSync as readFileSync34, readdirSync as readdirSync14, statSync as statSync22 } from "node:fs";
+import { join as join20, dirname as dirname22, normalize, relative as relative7, resolve as resolve36, sep as sep7 } from "node:path";
 import * as ts8 from "typescript";
 function walkProjectFiles(projectRoot) {
   const code = [];
@@ -34977,8 +35035,8 @@ function walkProjectFiles(projectRoot) {
   return { code, js };
 }
 function isUnder(dir, file) {
-  const base = resolve33(dir);
-  const abs = resolve33(file);
+  const base = resolve36(dir);
+  const abs = resolve36(file);
   return abs === base || abs.startsWith(base + sep7);
 }
 function structureWarning(rel, message) {
@@ -35086,7 +35144,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
     resolveModuleNameLiterals(moduleLiterals, containingFile, redirectedReference, options2) {
       return moduleLiterals.map(({ text }) => {
         if (text.endsWith(".vsk")) {
-          const abs = normalize(join20(dirname21(containingFile), text));
+          const abs = normalize(join20(dirname22(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -35097,7 +35155,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
           };
         }
         if (text.endsWith(".css")) {
-          const abs = normalize(join20(dirname21(containingFile), text));
+          const abs = normalize(join20(dirname22(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -35137,7 +35195,7 @@ function typecheckProject(projectRoot, opts = {}) {
       }
     }
     if (f.endsWith(".vsk")) {
-      const src2 = readFileSync31(f, "utf-8");
+      const src2 = readFileSync34(f, "utf-8");
       try {
         parse4(src2);
       } catch (e) {
@@ -35719,9 +35777,9 @@ declare module '@vesk/runtime' {
 });
 
 // src/index.ts
-import { readFileSync as readFileSync32, writeFileSync as writeFileSync17, mkdirSync as mkdirSync15, existsSync as existsSync33 } from "fs";
-import { resolve as resolve34, join as join21, dirname as dirname22 } from "path";
-import { fileURLToPath as fileURLToPath8 } from "url";
+import { readFileSync as readFileSync35, writeFileSync as writeFileSync18, mkdirSync as mkdirSync15, existsSync as existsSync36 } from "fs";
+import { resolve as resolve37, join as join21, dirname as dirname23 } from "path";
+import { fileURLToPath as fileURLToPath9 } from "url";
 
 // ../compiler/dist/config.js
 init_errors();
@@ -35828,9 +35886,9 @@ function validateConfig(config) {
     if (typeof plugin.name !== "string" || !plugin.name) {
       throw new Error("[vesk] A plugin is missing a `name` property. Use a Vesk-native plugin factory (e.g. tailwindcss({...}) from @vesk/plugin-tailwind) that returns a plugin object with the correct shape.");
     }
-    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
+    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
     if (!hasKnownHook) {
-      throw new Error(`[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`);
+      throw new Error(`[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`);
     }
   }
   return config;
@@ -36218,9 +36276,8 @@ function setRuntimeModule2(mod) {
 }
 
 // ../adapter/dist/index.js
-init_scan();
-import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync9, existsSync as existsSync17, readFileSync as readFileSync17 } from "node:fs";
-import { resolve as resolve19, dirname as dirname13, relative as relative4, basename as basename2 } from "node:path";
+import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync9, existsSync as existsSync18, readFileSync as readFileSync18 } from "node:fs";
+import { resolve as resolve20, dirname as dirname13, relative as relative4, basename as basename2 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // ../adapter/src/runtime-bundle.ts
@@ -36367,8 +36424,8 @@ async function bundleRuntime(appDir, outDir2) {
 }
 
 // ../adapter/src/ssr-function.ts
-import { readFileSync as readFileSync4, existsSync as existsSync5 } from "node:fs";
-import { resolve as resolve6, relative, join as join4 } from "node:path";
+import { readFileSync as readFileSync5, existsSync as existsSync6 } from "node:fs";
+import { resolve as resolve7, relative, join as join4 } from "node:path";
 
 // ../compiler/src/server-codegen.ts
 init_server_utils();
@@ -36376,6 +36433,55 @@ init_server_head();
 init_server_jsgen();
 init_server_render();
 
+// ../adapter/src/css.ts
+init_scan();
+import { readFileSync as readFileSync4, existsSync as existsSync5 } from "node:fs";
+import { resolve as resolve6 } from "node:path";
+var TAILWIND_CSS_URL = "/_vesk/static/_tailwind.css";
+var GLOBAL_CSS_URL = "/_vesk/static/global.css";
+function resolveUserCssPath(appDir) {
+  const cssSrc = resolve6(appDir, "..", "src", "global.css");
+  if (existsSync5(cssSrc)) return cssSrc;
+  const altCssSrc = resolve6(appDir, "..", "src", "app.css");
+  if (existsSync5(altCssSrc)) return altCssSrc;
+  return null;
+}
+function hasUserCss(appDir) {
+  return resolveUserCssPath(appDir) !== null;
+}
+function hasBuiltTailwindCss(outDir2) {
+  const p = resolve6(outDir2, "static", "_tailwind.css");
+  return existsSync5(p) && readFileSync4(p, "utf-8").trim().length > 0;
+}
+function isTailwindPlugin(plugins) {
+  return (plugins || []).some((p) => String(p && p.name).toLowerCase().includes("tailwind"));
+}
+function resolveCssUrls(opts) {
+  const urls = [];
+  if (opts.tailwind) urls.push(TAILWIND_CSS_URL);
+  if (opts.userCss) urls.push(GLOBAL_CSS_URL);
+  return urls;
+}
+function stripTailwindDirectives(css) {
+  const blockStart = /^\s*@(theme\s*\{|layer\s+(components|utilities)\s*\{|utility\s+[\w-]+\s*\{)/;
+  let result2 = css.replace(/^\s*@import\s+['"]tailwindcss['"]\s*;?\s*$/gm, "");
+  result2 = result2.replace(/^\s*@source\s+['"][^'"]+['"]\s*;?\s*$/gm, "");
+  const output = [];
+  let pos = 0;
+  while (pos < result2.length) {
+    const lineEnd = result2.indexOf("\n", pos) === -1 ? result2.length : result2.indexOf("\n", pos) + 1;
+    const line = result2.slice(pos, lineEnd);
+    if (blockStart.test(line.trim())) {
+      const end = cssBlockEnd(result2, pos);
+      pos = end;
+      continue;
+    }
+    output.push(line);
+    pos = lineEnd;
+  }
+  return output.join("").trim();
+}
+
 // ../adapter/src/ssr-function.ts
 function escapeSource(src2) {
   return src2.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$/g, "\\$");
@@ -36385,7 +36491,7 @@ function resolveErrorFile(sourceDir, appDir) {
   for (let depth = rel.length; depth >= 0; depth--) {
     const dir = depth === 0 ? appDir : join4(appDir, ...rel.slice(0, depth));
     const p = join4(dir, "error.vsk");
-    if (existsSync5(p)) return p;
+    if (existsSync6(p)) return p;
   }
   return null;
 }
@@ -36436,27 +36542,26 @@ function buildParamExtraction(node, urlParts) {
 function generateSsrFunction(routeNode, appDir, outDir2, componentMap, options2) {
   const ancestorLayouts = options2?.ancestorLayouts || [];
   const middlewareCode = options2?.middlewareCode || null;
-  const pagePath = resolve6(appDir, routeNode.sourceDir, "page.vsk");
-  const layoutPath = resolve6(appDir, routeNode.sourceDir, "layout.vsk");
+  const headExtra = options2?.headExtra || null;
+  const pagePath = resolve7(appDir, routeNode.sourceDir, "page.vsk");
+  const layoutPath = resolve7(appDir, routeNode.sourceDir, "layout.vsk");
   const parts = routeNode.fullPath.split("/").filter(Boolean);
   const name = routeName(parts);
-  const funcDir = resolve6(outDir2, "server", "functions");
-  const funcPath = resolve6(funcDir, `${name}.js`);
-  const tailwindPath = resolve6(outDir2, "static", "_tailwind.css");
-  const globalCssPath = resolve6(appDir, "..", "src", "global.css");
-  const altCssPath = resolve6(appDir, "..", "src", "app.css");
-  const hasGlobalCss = existsSync5(globalCssPath) || existsSync5(altCssPath);
-  const hasTailwind = existsSync5(tailwindPath) && readFileSync4(tailwindPath, "utf-8").trim().length > 0;
-  const cssUrls = [];
-  if (hasTailwind) cssUrls.push("/_vesk/static/_tailwind.css");
-  if (hasGlobalCss) cssUrls.push("/_vesk/static/global.css");
+  const funcDir = resolve7(outDir2, "server", "functions");
+  const funcPath = resolve7(funcDir, `${name}.js`);
+  const cssUrls = resolveCssUrls({
+    tailwind: hasBuiltTailwindCss(outDir2),
+    userCss: hasUserCss(appDir)
+  });
   const cssOption = cssUrls.length > 0 ? `, cssUrls: ${JSON.stringify(cssUrls)}` : "";
+  const headExtraOption = headExtra ? `, headExtra: ${JSON.stringify(headExtra)}` : "";
+  const bakedOptions = cssOption + headExtraOption;
   const hasLayout = !!routeNode.layout;
   const hasAncestorLayout = ancestorLayouts.length > 0;
-  const pageSrc = readFileSync4(pagePath, "utf-8");
+  const pageSrc = readFileSync5(pagePath, "utf-8");
   const pageComp = extractCompName(pageSrc) || "Page";
   const errorPath = resolveErrorFile(routeNode.sourceDir, appDir);
-  const errorSrc = errorPath ? readFileSync4(errorPath, "utf-8") : null;
+  const errorSrc = errorPath ? readFileSync5(errorPath, "utf-8") : null;
   const errorComp = errorPath ? extractCompName(errorSrc) || "Error" : null;
   const errorVars = errorPath ? `const _errorSrc = \`${escapeSource(errorSrc)}\`;
 const _errorComp = ${JSON.stringify(errorComp)};
@@ -36465,7 +36570,7 @@ const _errorCompiled = (() => { try { setVskHydrate(true); return compileFile(_e
 ` : "const _errorSrc = null;\nconst _errorComp = null;\nconst _errorPath = null;\nconst _errorCompiled = null;\n";
   let src2 = "";
   if (hasLayout) {
-    const layoutSrc = readFileSync4(layoutPath, "utf-8");
+    const layoutSrc = readFileSync5(layoutPath, "utf-8");
     const layoutComp = extractCompName(layoutSrc) || "Layout";
     src2 = `const _layoutSrc = \`${escapeSource(layoutSrc)}\`;
 const _pageSrc = \`${escapeSource(pageSrc)}\`;
@@ -36483,8 +36588,8 @@ const _pagePath = ${JSON.stringify(pagePath)};
     src2 += errorVars;
   } else if (hasAncestorLayout) {
     const outerLayout = ancestorLayouts[0];
-    const outerLayoutPath = resolve6(appDir, outerLayout.sourceDir, "layout.vsk");
-    const outerLayoutSrc = readFileSync4(outerLayoutPath, "utf-8");
+    const outerLayoutPath = resolve7(appDir, outerLayout.sourceDir, "layout.vsk");
+    const outerLayoutSrc = readFileSync5(outerLayoutPath, "utf-8");
     const outerLayoutComp = extractCompName(outerLayoutSrc) || "Layout";
     src2 = `const _pageSrc = \`${escapeSource(pageSrc)}\`;
 `;
@@ -36525,7 +36630,7 @@ const _comp = ${JSON.stringify(pageComp)};
   const compRegEntries = [];
   const compMap = componentMap || /* @__PURE__ */ new Map();
   for (const [compName, compPath] of compMap) {
-    const compSrc = readFileSync4(compPath, "utf-8");
+    const compSrc = readFileSync5(compPath, "utf-8");
     const escapedSrc = escapeSource(compSrc);
     compRegEntries.push(`  registry.set(${JSON.stringify(compName)}, async (props, __registry, __vesk) => {
     const _src = \`${escapedSrc}\`;
@@ -36571,7 +36676,7 @@ ${compRegEntries.join("\n")}
       "    const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
       "    page = { body: await __renderErrorBody({ params, statusCode: 500, error: __expose ? message : 'Internal Server Error', stack: __expose ? stack : '', url: requestUrl || '' }), head: '' };",
       "  }",
-      "  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? '<!--vesk-ssr-error:' + (caughtError && typeof caughtError === 'object' && 'message' in caughtError ? encodeURIComponent(__expose ? String(caughtError.message) : 'Internal Server Error') : '') + '-->' : '') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled" + cssOption + clientScriptOption + dataScriptOption + ", pageHead: page.head, sourcePath: _layoutPath });",
+      "  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? '<!--vesk-ssr-error:' + (caughtError && typeof caughtError === 'object' && 'message' in caughtError ? encodeURIComponent(__expose ? String(caughtError.message) : 'Internal Server Error') : '') + '-->' : '') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled" + bakedOptions + clientScriptOption + dataScriptOption + ", pageHead: page.head, sourcePath: _layoutPath });",
       "  return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
       "  });",
       "}",
@@ -36585,14 +36690,14 @@ ${compRegEntries.join("\n")}
       "  const message = err && typeof err === 'object' && 'message' in err ? String(err.message) : String(err);",
       "  const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
       "  const props = { params, statusCode: 500, error: __expose ? message : 'Internal Server Error', stack: __expose ? stack : '', url: requestUrl || '' };",
-      "  return renderFullPage(_errorSrc, _errorComp, props, __componentRegistry, { hydrate: true, cached: _errorCompiled" + cssOption + clientScriptOption + dataScriptOption + ", sourcePath: _errorPath });",
+      "  return renderFullPage(_errorSrc, _errorComp, props, __componentRegistry, { hydrate: true, cached: _errorCompiled" + bakedOptions + clientScriptOption + dataScriptOption + ", sourcePath: _errorPath });",
       "}",
       "",
       "async function __renderHtml(params, requestUrl) {",
       "  return withSsrStore(async () => {",
       "  let stream;",
       "  try {",
-      "    stream = renderPageStream(_src, _comp, { params }, __componentRegistry, { hydrate: true, cached: _srcCompiled" + cssOption + clientScriptOption + dataScriptOption + ", sourcePath: _srcPath });",
+      "    stream = renderPageStream(_src, _comp, { params }, __componentRegistry, { hydrate: true, cached: _srcCompiled" + bakedOptions + clientScriptOption + dataScriptOption + ", sourcePath: _srcPath });",
       "  } catch (err) {",
       "    if (err && (err.name === 'NotFoundError' || err.name === 'Redirect')) throw err;",
       "    const html = await __renderErrorFullPage(params, requestUrl, err);",
@@ -36833,8 +36938,8 @@ init_actions();
 
 // ../adapter/src/api-function.ts
 init_strip_ts();
-import { readFileSync as readFileSync5 } from "node:fs";
-import { resolve as resolve7 } from "node:path";
+import { readFileSync as readFileSync6 } from "node:fs";
+import { resolve as resolve8 } from "node:path";
 function apiRouteName(fullPath) {
   const parts = fullPath.split("/").filter(Boolean);
   return parts.map((s) => s.startsWith(":") ? s.slice(1) || "param" : s).join("_") || "index";
@@ -36842,10 +36947,10 @@ function apiRouteName(fullPath) {
 function generateApiFunction(apiNode, _apiDir, outDir2, options2) {
   const middlewareCode = options2?.middlewareCode || null;
   const name = apiRouteName(apiNode.fullPath);
-  const funcPath = resolve7(outDir2, "server", "api", `${name}.js`);
+  const funcPath = resolve8(outDir2, "server", "api", `${name}.js`);
   const routeFilePath = apiNode.filePath;
   if (!routeFilePath) throw new Error(`api route ${apiNode.fullPath} has no filePath`);
-  let routeSrc = readFileSync5(routeFilePath, "utf-8");
+  let routeSrc = readFileSync6(routeFilePath, "utf-8");
   routeSrc = routeSrc.replace(/from\s+['"]@vesk\/runtime['"]\s*;?/g, "from '../runtime.js';").replace(/from\s+['"]@vesk\/runtime\/(\w+)['"]\s*;?/g, () => {
     return "from '../runtime.js';";
   });
@@ -37013,10 +37118,10 @@ function generateApiFunction(apiNode, _apiDir, outDir2, options2) {
 }
 
 // ../adapter/src/middleware.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 
 // ../compiler/src/router.ts
-import { readdirSync, statSync as statSync2, existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { readdirSync, statSync as statSync2, existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
 init_parser();
 init_tokens();
 init_scan();
@@ -37098,8 +37203,8 @@ function fallbackExtractMiddleware(src2) {
 }
 function extractMiddleware(sourcePath2) {
   try {
-    if (!existsSync6(sourcePath2)) return null;
-    const src2 = readFileSync6(sourcePath2, "utf-8");
+    if (!existsSync7(sourcePath2)) return null;
+    const src2 = readFileSync7(sourcePath2, "utf-8");
     const parts = extractMiddlewareParts(src2);
     if (!parts) return null;
     return `async function middleware(${parts.params}) {
@@ -37121,7 +37226,7 @@ function compileMiddleware(mwChain, _appDir) {
   const parts = [];
   for (let i = 0; i < mwChain.length; i++) {
     const { sourcePath: sourcePath2 } = mwChain[i];
-    const src2 = readFileSync7(sourcePath2, "utf-8");
+    const src2 = readFileSync8(sourcePath2, "utf-8");
     const extracted = extractMiddlewareBody(src2);
     if (!extracted) continue;
     parts.push(`async function mw_${i}(${extracted.params}) {
@@ -37214,8 +37319,8 @@ init_esbuild_fallback();
 init_strip_ts();
 init_parser();
 init_client_codegen();
-import { readFileSync as readFileSync8, existsSync as existsSync7, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, statSync as statSync3, rmSync } from "node:fs";
-import { resolve as resolve8, join as join5, dirname as dirname6, relative as relative2, sep } from "node:path";
+import { readFileSync as readFileSync9, existsSync as existsSync8, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, statSync as statSync3, rmSync } from "node:fs";
+import { resolve as resolve9, join as join5, dirname as dirname6, relative as relative2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 init_vsk_imports();
 init_md_inline();
@@ -37236,15 +37341,15 @@ function buildRouterOpts(options2) {
   return "";
 }
 function findRuntimeSrc2(appDir) {
-  const monorepoRoot = resolve8(__dirname3, "..", "..", "..");
+  const monorepoRoot = resolve9(__dirname3, "..", "..", "..");
   const candidates = [
-    resolve8(monorepoRoot, "packages", "runtime", "dist"),
-    resolve8(appDir, "..", "node_modules", "@vesk/runtime"),
-    resolve8(appDir, "node_modules", "@vesk/runtime")
+    resolve9(monorepoRoot, "packages", "runtime", "dist"),
+    resolve9(appDir, "..", "node_modules", "@vesk/runtime"),
+    resolve9(appDir, "node_modules", "@vesk/runtime")
   ];
   for (const base of candidates) {
     for (const dir of [base, join5(base, "dist")]) {
-      if (existsSync7(join5(dir, "index-client.js"))) return dir;
+      if (existsSync8(join5(dir, "index-client.js"))) return dir;
     }
   }
   throw new Error('@vesk/runtime/dist not found \u2014 run "npm run build" first');
@@ -37432,11 +37537,11 @@ async function generateClientBundle(routeTree, appDir, componentMap, options2) {
     return removeCompiledNodes(code, isVskImport);
   }
   function resolveVskImports(filePath, compile) {
-    const src2 = readFileSync8(filePath, "utf-8");
+    const src2 = readFileSync9(filePath, "utf-8");
     const resolved = [];
     for (const importPath of collectVskImportPaths(vskImportLines(src2), filePath)) {
       try {
-        readFileSync8(importPath);
+        readFileSync9(importPath);
       } catch {
         continue;
       }
@@ -37476,7 +37581,7 @@ async function generateClientBundle(routeTree, appDir, componentMap, options2) {
       return;
     }
     compiledFiles++;
-    let src2 = readFileSync8(filePath, "utf-8");
+    let src2 = readFileSync9(filePath, "utf-8");
     if (/content=["'][^"']*\.md["']/i.test(src2)) {
       src2 = inlineMdContentAttrs(src2, dirname6(filePath), guessProjectRoots(appDir));
     }
@@ -37517,36 +37622,48 @@ async function generateClientBundle(routeTree, appDir, componentMap, options2) {
     return slug.replace(/[\[\]]/g, "_");
   }
   const codeSplit = !!options2?.codeSplit;
+  const transformPlugins = options2?.plugins || [];
+  async function applyTransformPlugins(code, filePath) {
+    if (transformPlugins.length === 0) return code;
+    let out = code;
+    for (const plugin of transformPlugins) {
+      if (typeof plugin.onTransformJS === "function") {
+        const result2 = await plugin.onTransformJS(out, filePath);
+        if (typeof result2 === "string") out = result2;
+      }
+    }
+    return out;
+  }
   if (codeSplit) {
     let walkSplit2 = function(nodes, _chain) {
       for (const node of nodes) {
         const chunkCode = [];
-        const pagePath = resolve8(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync7(pagePath)) {
+        const pagePath = resolve9(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync8(pagePath)) {
           compileFile2(pagePath, node.page, chunkCode);
         }
-        const layoutPath = resolve8(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync7(layoutPath)) {
+        const layoutPath = resolve9(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync8(layoutPath)) {
           compileFile2(layoutPath, node.layout, chunkCode);
         }
-        const errorPath = resolve8(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync7(errorPath)) {
+        const errorPath = resolve9(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync8(errorPath)) {
           compileFile2(errorPath, node.error, chunkCode);
         }
-        const notFoundPath = resolve8(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync7(notFoundPath)) {
+        const notFoundPath = resolve9(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync8(notFoundPath)) {
           compileFile2(notFoundPath, node.notFound, chunkCode);
         }
-        const offlinePath = resolve8(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync7(offlinePath)) {
+        const offlinePath = resolve9(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync8(offlinePath)) {
           compileFile2(offlinePath, node.offline, chunkCode);
         }
-        const networkPath = resolve8(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync7(networkPath)) {
+        const networkPath = resolve9(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync8(networkPath)) {
           compileFile2(networkPath, node.network, chunkCode);
         }
-        const loadingPath = resolve8(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync7(loadingPath)) {
+        const loadingPath = resolve9(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync8(loadingPath)) {
           compileFile2(loadingPath, node.loading, chunkCode);
         }
         if (chunkCode.length > 0) {
@@ -37597,12 +37714,16 @@ ${entry.code}
       main = await buildMainBundle(routeTree, runtimeDir, true, {}, !!options2?.hmr, !!options2?.importRuntime, runtimeImportNames, options2?.routeDataCache);
       if (cache2) cache2.mainBundle = { key: mainKey, code: main };
     }
-    return { main, chunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
+    const transformedChunks = [];
+    for (const chunk of chunks) {
+      transformedChunks.push({ ...chunk, code: await applyTransformPlugins(chunk.code, chunk.name) });
+    }
+    return { main: await applyTransformPlugins(main, "client.js"), chunks: transformedChunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
   } else {
     let compileFileMono2 = function(filePath, resolvedName) {
       if (seen.has(filePath)) return;
       seen.add(filePath);
-      const src2 = readFileSync8(filePath, "utf-8");
+      const src2 = readFileSync9(filePath, "utf-8");
       resolveVskImports(filePath, (p, n) => compileFileMono2(p, n || ""));
       const compCode = compileClient(src2, null, { forceClient: true, sourcePath: filePath });
       const hydCode = compileClient(src2, null, { hydrate: true, forceClient: true, includeTopLevel: false, sourcePath: filePath });
@@ -37619,20 +37740,20 @@ ${entry.code}
       }
     }, walkMono2 = function(nodes) {
       for (const node of nodes) {
-        const pagePath = resolve8(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync7(pagePath)) compileFileMono2(pagePath, node.page);
-        const layoutPath = resolve8(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync7(layoutPath)) compileFileMono2(layoutPath, node.layout);
-        const errorPath = resolve8(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync7(errorPath)) compileFileMono2(errorPath, node.error);
-        const notFoundPath = resolve8(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync7(notFoundPath)) compileFileMono2(notFoundPath, node.notFound);
-        const offlinePath = resolve8(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync7(offlinePath)) compileFileMono2(offlinePath, node.offline);
-        const networkPath = resolve8(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync7(networkPath)) compileFileMono2(networkPath, node.network);
-        const loadingPath = resolve8(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync7(loadingPath)) compileFileMono2(loadingPath, node.loading);
+        const pagePath = resolve9(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync8(pagePath)) compileFileMono2(pagePath, node.page);
+        const layoutPath = resolve9(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync8(layoutPath)) compileFileMono2(layoutPath, node.layout);
+        const errorPath = resolve9(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync8(errorPath)) compileFileMono2(errorPath, node.error);
+        const notFoundPath = resolve9(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync8(notFoundPath)) compileFileMono2(notFoundPath, node.notFound);
+        const offlinePath = resolve9(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync8(offlinePath)) compileFileMono2(offlinePath, node.offline);
+        const networkPath = resolve9(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync8(networkPath)) compileFileMono2(networkPath, node.network);
+        const loadingPath = resolve9(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync8(loadingPath)) compileFileMono2(loadingPath, node.loading);
         walkMono2(node.children || []);
       }
     };
@@ -37652,7 +37773,7 @@ ${entry.code}
       aliasLines,
       hydratorAliasLines
     }, !!options2?.hmr, !!options2?.importRuntime, runtimeImportNames, options2?.routeDataCache);
-    return { main, chunks: [] };
+    return { main: await applyTransformPlugins(main, "client.js"), chunks: [] };
   }
 }
 function stripTypes(code) {
@@ -37682,8 +37803,8 @@ function buildRuntimeCode(runtimeDir) {
   let code = "";
   for (const f of runtimeFiles) {
     const p = join5(runtimeDir, f);
-    if (existsSync7(p)) {
-      let src2 = readFileSync8(p, "utf-8");
+    if (existsSync8(p)) {
+      let src2 = readFileSync9(p, "utf-8");
       src2 = stripTypes(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, "");
@@ -37695,7 +37816,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync8(join5(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync9(join5(runtimeDir, "index-client.js"), "utf-8");
   const exportNames = stripTypes(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)]) {
@@ -37705,7 +37826,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames(runtimeDir) {
-  const indexSrc = readFileSync8(join5(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync9(join5(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(",")) {
@@ -37861,7 +37982,7 @@ if (typeof document !== 'undefined') __router.start();
 }
 
 // ../adapter/src/manifest.ts
-function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap) {
+function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap, headExtra) {
   const routeEntries = [];
   for (const r of ssrRoutes) {
     const urlParts = r.fullPath.split("/").filter(Boolean);
@@ -37901,18 +38022,19 @@ function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middleware
       prefix: "/_vesk/static",
       dir: "static"
     },
-    ...actionEntries.length > 0 ? { actions: actionEntries } : {}
+    ...actionEntries.length > 0 ? { actions: actionEntries } : {},
+    ...headExtra ? { headExtra } : {}
   };
 }
 
 // ../adapter/src/static.ts
 init_paths();
-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";
+import { mkdirSync, copyFileSync, readdirSync as readdirSync2, statSync as statSync5, existsSync as existsSync10, writeFileSync as writeFileSync3, readFileSync as readFileSync11 } from "node:fs";
+import { resolve as resolve11, join as join6 } from "node:path";
 function copyStaticAssets(publicDir, outDir2) {
-  const targetDir = resolve10(outDir2, "static", "public");
+  const targetDir = resolve11(outDir2, "static", "public");
   mkdirSync(targetDir, { recursive: true });
-  if (!existsSync9(publicDir)) return;
+  if (!existsSync10(publicDir)) return;
   function copyDir(src2, dest) {
     mkdirSync(dest, { recursive: true });
     const entries = readdirSync2(src2);
@@ -37931,8 +38053,8 @@ function copyStaticAssets(publicDir, outDir2) {
 }
 
 // ../adapter/src/prod-server.ts
-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 { readFileSync as readFileSync12, existsSync as existsSync11, statSync as statSync6 } from "node:fs";
+import { resolve as resolve12, extname as extname3, dirname as dirname7 } from "node:path";
 import { createServer } from "node:http";
 import { createRequire as createRequire2 } from "node:module";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -38037,6 +38159,7 @@ var MIME = {
   ".ico": "image/x-icon",
   ".html": "text/html",
   ".json": "application/json",
+  ".webmanifest": "application/manifest+json",
   ".woff": "font/woff",
   ".woff2": "font/woff2",
   ".wasm": "application/wasm"
@@ -38046,28 +38169,29 @@ async function startProdServer(outDir, options) {
   const host = options?.host || "127.0.0.1";
   const maxBodyBytes = options?.maxBodyBytes || DEFAULT_MAX_BODY_BYTES;
   if (!process.env.NODE_ENV) process.env.NODE_ENV = "production";
-  const staticDir = resolve11(outDir, "static");
-  const configPath = resolve11(outDir, "config.json");
-  installMdReadHook([resolve11(staticDir, "public")]);
-  if (!existsSync10(configPath)) {
+  const staticDir = resolve12(outDir, "static");
+  const configPath = resolve12(outDir, "config.json");
+  installMdReadHook([resolve12(staticDir, "public")]);
+  if (!existsSync11(configPath)) {
     console.error(`vesk start: no build found at ${outDir}`);
     console.error('Run "vesk build" first');
     process.exit(1);
   }
-  const buildConfig = JSON.parse(readFileSync11(configPath, "utf-8"));
+  const buildConfig = JSON.parse(readFileSync12(configPath, "utf-8"));
+  const bakedHeadExtra = buildConfig.headExtra || "";
   console.error(`vesk start: serving from ${outDir}`);
-  const projectDir = resolve11(outDir, "..");
+  const projectDir = resolve12(outDir, "..");
   let securityConfig = {};
   let mdConfig;
   try {
-    const veskConfigPath = resolve11(projectDir, "vesk.config.js");
-    const veskConfigTsPath = resolve11(projectDir, "vesk.config.ts");
+    const veskConfigPath = resolve12(projectDir, "vesk.config.js");
+    const veskConfigTsPath = resolve12(projectDir, "vesk.config.ts");
     let rawConfig = {};
-    if (existsSync10(veskConfigPath)) {
+    if (existsSync11(veskConfigPath)) {
       rawConfig = _require(veskConfigPath);
-    } else if (existsSync10(veskConfigTsPath)) {
+    } else if (existsSync11(veskConfigTsPath)) {
       const { transpile } = _require("typescript");
-      const src = readFileSync11(veskConfigTsPath, "utf-8");
+      const src = readFileSync12(veskConfigTsPath, "utf-8");
       const result = transpile(src, { module: 99, target: 99 });
       rawConfig = eval(`(${result})`);
     }
@@ -38096,8 +38220,8 @@ async function startProdServer(outDir, options) {
   } catch {
   }
   let middlewareMod = null;
-  const mwPath = resolve11(outDir, "server", "middleware.js");
-  if (existsSync10(mwPath)) {
+  const mwPath = resolve12(outDir, "server", "middleware.js");
+  if (existsSync11(mwPath)) {
     try {
       middlewareMod = await import(`${mwPath}?t=${Date.now()}`);
     } catch {
@@ -38106,8 +38230,8 @@ async function startProdServer(outDir, options) {
   const functionCache = /* @__PURE__ */ new Map();
   async function loadFunction(funcPath) {
     if (functionCache.has(funcPath)) return functionCache.get(funcPath);
-    const fullPath = resolve11(outDir, funcPath);
-    if (!existsSync10(fullPath)) return null;
+    const fullPath = resolve12(outDir, funcPath);
+    if (!existsSync11(fullPath)) return null;
     try {
       const mod = await import(`${fullPath}?t=${Date.now()}`);
       functionCache.set(funcPath, mod);
@@ -38167,12 +38291,12 @@ async function startProdServer(outDir, options) {
       }
       return origWriteHead(statusCode, headers2);
     });
-    const publicDir = resolve11(staticDir, "public");
+    const publicDir = resolve12(staticDir, "public");
     const rootFile = url.pathname.length > 1 ? resolveWithin(publicDir, url.pathname.slice(1)) : null;
-    if (rootFile && existsSync10(rootFile) && statSync6(rootFile).isFile()) {
+    if (rootFile && existsSync11(rootFile) && statSync6(rootFile).isFile()) {
       const ext = extname3(rootFile);
       res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
-      res.end(readFileSync11(rootFile));
+      res.end(readFileSync12(rootFile));
       return;
     }
     if (url.pathname === "/ssr-data.js") {
@@ -38188,10 +38312,10 @@ async function startProdServer(outDir, options) {
       return;
     }
     if (url.pathname === "/_vesk/runtime.js") {
-      const clientPath = resolve11(staticDir, "client.js");
-      if (existsSync10(clientPath)) {
+      const clientPath = resolve12(staticDir, "client.js");
+      if (existsSync11(clientPath)) {
         res.writeHead(200, { "Content-Type": "application/javascript" });
-        res.end(readFileSync11(clientPath));
+        res.end(readFileSync12(clientPath));
         return;
       }
     }
@@ -38203,20 +38327,20 @@ async function startProdServer(outDir, options) {
         res.end("Forbidden");
         return;
       }
-      if (existsSync10(staticPath) && statSync6(staticPath).isFile()) {
+      if (existsSync11(staticPath) && statSync6(staticPath).isFile()) {
         const ext = extname3(staticPath);
         res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
-        res.end(readFileSync11(staticPath));
+        res.end(readFileSync12(staticPath));
         return;
       }
     }
     if (buildConfig.prerendered) {
       const prerendered = buildConfig.prerendered.find((r) => r.path === url.pathname);
       if (prerendered) {
-        const htmlPath = resolve11(outDir, prerendered.file);
-        if (existsSync10(htmlPath)) {
+        const htmlPath = resolve12(outDir, prerendered.file);
+        if (existsSync11(htmlPath)) {
           res.writeHead(200, { "Content-Type": "text/html" });
-          res.end(readFileSync11(htmlPath));
+          res.end(readFileSync12(htmlPath));
           return;
         }
       }
@@ -38310,21 +38434,20 @@ async function startProdServer(outDir, options) {
         }
       }
     }
-    const appDir = resolve11(projectDir, "app");
-    const nfPath = resolve11(appDir, "not-found.vsk");
+    const appDir = resolve12(projectDir, "app");
+    const pageCssUrls = resolveCssUrls({
+      tailwind: hasBuiltTailwindCss(outDir),
+      userCss: hasUserCss(appDir)
+    });
+    const nfPath = resolve12(appDir, "not-found.vsk");
     let notFoundHtml = null;
-    if (existsSync10(nfPath)) {
+    if (existsSync11(nfPath)) {
       try {
-        const runtimePath = resolve11(outDir, "server", "runtime.js");
+        const runtimePath = resolve12(outDir, "server", "runtime.js");
         const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
-        const src2 = readFileSync11(nfPath, "utf-8");
+        const src2 = readFileSync12(nfPath, "utf-8");
         const compName = resolveComponentName(src2) || "NotFound";
-        const tailwindPathNF = resolve11(outDir, "static", "_tailwind.css");
-        const hasTailwindNF = existsSync10(tailwindPathNF) && readFileSync11(tailwindPathNF, "utf-8").trim().length > 0;
-        const cssUrlsNF = [];
-        if (hasTailwindNF) cssUrlsNF.push("/_vesk/static/_tailwind.css");
-        cssUrlsNF.push("/_vesk/static/global.css");
-        notFoundHtml = await renderFullPage2(src2, compName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: cssUrlsNF, security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: nfPath });
+        notFoundHtml = await renderFullPage2(src2, compName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: pageCssUrls, security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: nfPath, headExtra: bakedHeadExtra });
       } catch {
       }
     }
@@ -38380,21 +38503,16 @@ async function startProdServer(outDir, options) {
                 return;
               }
               console.error("vesk ssr error:", err.message);
-              const errPath = resolve11(appDir, "error.vsk");
+              const errPath = resolve12(appDir, "error.vsk");
               let errorHtml = null;
-              if (existsSync10(errPath)) {
+              if (existsSync11(errPath)) {
                 try {
-                  const runtimePath = resolve11(outDir, "server", "runtime.js");
+                  const runtimePath = resolve12(outDir, "server", "runtime.js");
                   const { renderFullPage: renderFullPage2, storeDataScriptGlobal } = await import(runtimePath);
-                  const src2 = readFileSync11(errPath, "utf-8");
+                  const src2 = readFileSync12(errPath, "utf-8");
                   const compName = resolveComponentName(src2) || "Error";
                   const expose = process.env.NODE_ENV !== "production";
-                  const tailwindPathErr = resolve11(outDir, "static", "_tailwind.css");
-                  const hasTailwindErr = existsSync10(tailwindPathErr) && readFileSync11(tailwindPathErr, "utf-8").trim().length > 0;
-                  const cssUrlsErr = [];
-                  if (hasTailwindErr) cssUrlsErr.push("/_vesk/static/_tailwind.css");
-                  cssUrlsErr.push("/_vesk/static/global.css");
-                  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: cssUrlsErr, clientScriptUrl: "/_vesk/static/client.js", security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath });
+                  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: pageCssUrls, clientScriptUrl: "/_vesk/static/client.js", security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath, headExtra: bakedHeadExtra });
                 } catch {
                 }
               }
@@ -38508,10 +38626,10 @@ function validateConfig2(config) {
         "[vesk] A plugin is missing a `name` property. Use a Vesk-native plugin factory (e.g. tailwindcss({...}) from @vesk/plugin-tailwind) that returns a plugin object with the correct shape."
       );
     }
-    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
+    const hasKnownHook = typeof plugin.onCSS === "function" || typeof plugin.onFileWatch === "function" || typeof plugin.onTransformJS === "function" || typeof plugin.onBuildStart === "function" || typeof plugin.onBuildEnd === "function" || typeof plugin.onRequest === "function" || typeof plugin.onHead === "function" || typeof plugin.onHtml === "function" || plugin.provides && typeof plugin.provides === "object" && Object.keys(plugin.provides).length > 0;
     if (!hasKnownHook) {
       throw new Error(
-        `[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`
+        `[vesk] Plugin "${plugin.name}" implements none of the recognized hooks (onCSS, onFileWatch, onTransformJS, onBuildStart, onBuildEnd, onRequest, onHead, onHtml) or provides \u2014 it will never be called. Check the plugin package version, or see /docu/cli/plugin-api.md for the current hook contract.`
       );
     }
   }
@@ -38527,13 +38645,13 @@ init_paths();
 // ../adapter/dist/index.js
 var __dirname6 = dirname13(fileURLToPath5(import.meta.url));
 async function resolveCompilerApi(name) {
-  const monorepoSrc = resolve19(__dirname6, "..", "..", "compiler", "src");
-  if (existsSync17(monorepoSrc)) {
-    const tsFile = resolve19(monorepoSrc, name.replace(/\.js$/, ".ts"));
-    if (existsSync17(tsFile)) {
+  const monorepoSrc = resolve20(__dirname6, "..", "..", "compiler", "src");
+  if (existsSync18(monorepoSrc)) {
+    const tsFile = resolve20(monorepoSrc, name.replace(/\.js$/, ".ts"));
+    if (existsSync18(tsFile)) {
       return import(tsFile);
     }
-    return import(resolve19(monorepoSrc, name));
+    return import(resolve20(monorepoSrc, name));
   }
   return import(`@vesk/compiler/src/${name.replace(/\.js$/, "")}`);
 }
@@ -38556,10 +38674,24 @@ function veskDirFromOutDir(outDir2) {
     return dirname13(outDir2);
   return outDir2;
 }
+async function collectPluginHeadExtra(pluginsPipelines) {
+  const parts = [];
+  for (const plugin of pluginsPipelines) {
+    if (typeof plugin.onHead !== "function")
+      continue;
+    try {
+      const result2 = await plugin.onHead("", { sourcePath: "build" });
+      if (typeof result2 === "string" && result2.trim())
+        parts.push(result2);
+    } catch {
+    }
+  }
+  return parts.join("\n");
+}
 async function build2(appDir, options2) {
-  appDir = resolve19(appDir);
-  const outDir2 = resolve19(options2?.outDir || resolve19(appDir, "..", ".vesk"));
-  const publicDir = options2?.publicDir || resolve19(appDir, "..", "public");
+  appDir = resolve20(appDir);
+  const outDir2 = resolve20(options2?.outDir || resolve20(appDir, "..", ".vesk"));
+  const publicDir = options2?.publicDir || resolve20(appDir, "..", "public");
   const plugins = options2?.plugins || [];
   if (options2?.md) {
     const { configureMd: configureMd3 } = await Promise.resolve().then(() => (init_md(), md_exports));
@@ -38594,15 +38726,57 @@ async function build2(appDir, options2) {
       await plugin.onBuildStart();
     }
   }
+  const pluginHeadExtra = await collectPluginHeadExtra(pluginsPipelines);
+  if (pluginHeadExtra)
+    console.error("vesk build: baked plugin head \u2192 config.json + SSR functions");
   console.error(`vesk build: output \u2192 ${outDir2}`);
   const dirs = [
-    resolve19(outDir2, "server", "functions"),
-    resolve19(outDir2, "server", "api"),
-    resolve19(outDir2, "static", "public"),
-    resolve19(outDir2, "prerendered")
+    resolve20(outDir2, "server", "functions"),
+    resolve20(outDir2, "server", "api"),
+    resolve20(outDir2, "static", "public"),
+    resolve20(outDir2, "prerendered")
   ];
   for (const d of dirs)
     mkdirSync7(d, { recursive: true });
+  const cssSourcePath = resolveUserCssPath(appDir);
+  if (cssSourcePath !== null) {
+    const cssContent = readFileSync18(cssSourcePath, "utf-8");
+    const userCss = stripTailwindDirectives(cssContent);
+    const userCssTarget = resolve20(outDir2, "static", "global.css");
+    writeFileSync9(userCssTarget, userCss, "utf-8");
+    console.error(`vesk build: css  \u2192 static/global.css  (${userCss.length} bytes)`);
+    const twCssTarget = resolve20(outDir2, "static", "_tailwind.css");
+    const tailwindActive = isTailwindPlugin(pluginsPipelines);
+    if (!tailwindActive) {
+      writeFileSync9(twCssTarget, "", "utf-8");
+      console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind plugin inactive)");
+    } else {
+      let twCss = cssContent;
+      for (const plugin of pluginsPipelines) {
+        if (typeof plugin.onCSS === "function") {
+          const result2 = await plugin.onCSS(twCss, cssSourcePath);
+          if (result2 !== null && typeof result2 === "string") {
+            twCss = result2;
+          }
+        }
+      }
+      const hasUnresolvedTailwindImport = /@import\s+['"]tailwindcss['"]/.test(twCss);
+      if (hasUnresolvedTailwindImport) {
+        const lines = twCss.split("\n").filter((l) => !/^\s*@import\s+['"]tailwindcss['"]/.test(l));
+        twCss = lines.join("\n").trim();
+        if (twCss.length === 0) {
+          writeFileSync9(twCssTarget, "", "utf-8");
+          console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind unresolved)");
+        } else {
+          writeFileSync9(twCssTarget, twCss, "utf-8");
+          console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes, tailwind partially unresolved)`);
+        }
+      } else {
+        writeFileSync9(twCssTarget, twCss, "utf-8");
+        console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes)`);
+      }
+    }
+  }
   const { scanRoutes: scanRoutes2, scanComponents } = await resolveCompilerApi("router.js");
   const { scanApiRoutes: scanApiRoutes2 } = await resolveCompilerApi("api-routes.js");
   const { collectMiddlewareChain: collectMiddlewareChain2 } = await resolveCompilerApi("middleware.js");
@@ -38611,14 +38785,14 @@ async function build2(appDir, options2) {
     console.error("vesk build: no routes found in", appDir);
     return;
   }
-  const projectRoot = resolve19(appDir, "..");
-  const componentsDir = resolve19(projectRoot, "components");
+  const projectRoot = resolve20(appDir, "..");
+  const componentsDir = resolve20(projectRoot, "components");
   const componentMap = scanComponents(componentsDir);
   if (componentMap.size > 0) {
     console.error(`vesk build: ${componentMap.size} external components found in ${componentsDir}`);
   }
-  const apiDir = resolve19(appDir, "api");
-  const apiTree = existsSync17(apiDir) ? scanApiRoutes2(apiDir) : [];
+  const apiDir = resolve20(appDir, "api");
+  const apiTree = existsSync18(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);
@@ -38631,21 +38805,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) => readFileSync17(m.sourcePath, "utf-8"));
+          const mwSources = mwChain2.map((m) => readFileSync18(m.sourcePath, "utf-8"));
           mwCode = compileMiddlewareCode(mwSources);
         }
-        const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir2, componentMap, { ancestorLayouts, middlewareCode: mwCode });
+        const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir2, componentMap, { ancestorLayouts, middlewareCode: mwCode, headExtra: pluginHeadExtra });
         writeFileSync9(funcPath, funcCode, "utf-8");
-        const pagePath = resolve19(appDir, node.sourceDir, "page.vsk");
-        if (existsSync17(pagePath)) {
-          const src2 = readFileSync17(pagePath, "utf-8");
+        const pagePath = resolve20(appDir, node.sourceDir, "page.vsk");
+        if (existsSync18(pagePath)) {
+          const src2 = readFileSync18(pagePath, "utf-8");
           const actionIds = collectActionIds(src2);
           if (node.layout) {
-            const layoutSrc = readFileSync17(resolve19(appDir, node.sourceDir, "layout.vsk"), "utf-8");
+            const layoutSrc = readFileSync18(resolve20(appDir, node.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(layoutSrc));
           }
           for (const a of ancestorLayouts) {
-            const ancestorSrc = readFileSync17(resolve19(appDir, a.sourceDir, "layout.vsk"), "utf-8");
+            const ancestorSrc = readFileSync18(resolve20(appDir, a.sourceDir, "layout.vsk"), "utf-8");
             actionIds.push(...collectActionIds(ancestorSrc));
           }
           for (const id of actionIds) {
@@ -38685,7 +38859,7 @@ async function build2(appDir, options2) {
   if (mwChain.length > 0) {
     const mwCode = compileMiddleware(mwChain, appDir);
     if (mwCode) {
-      writeFileSync9(resolve19(outDir2, "server", "middleware.js"), mwCode, "utf-8");
+      writeFileSync9(resolve20(outDir2, "server", "middleware.js"), mwCode, "utf-8");
       middlewareEnabled = true;
       console.error(`vesk build: mw   \u2192 server/middleware.js  (${mwChain.length} middlewares)`);
     }
@@ -38698,91 +38872,29 @@ async function build2(appDir, options2) {
     bundleOpts.hmr = true;
   if (options2?.routeDataCache !== void 0)
     bundleOpts.routeDataCache = options2.routeDataCache;
+  if (pluginsPipelines.length > 0)
+    bundleOpts.plugins = pluginsPipelines;
   const { main, chunks } = await generateClientBundle(routeTree, appDir, componentMap, bundleOpts);
-  writeFileSync9(resolve19(outDir2, "static", "client.js"), main, "utf-8");
+  writeFileSync9(resolve20(outDir2, "static", "client.js"), main, "utf-8");
   const mode = chunks.length > 0 ? "code-split" : "monolithic";
   console.error(`vesk build: client \u2192 static/client.js  (${main.length} bytes, ${mode})`);
   if (chunks.length > 0) {
-    const staticDir2 = resolve19(outDir2, "static");
+    const staticDir2 = resolve20(outDir2, "static");
     for (const chunk of chunks) {
-      writeFileSync9(resolve19(staticDir2, chunk.name), chunk.code, "utf-8");
+      writeFileSync9(resolve20(staticDir2, chunk.name), chunk.code, "utf-8");
       console.error(`vesk build: chunk \u2192 static/${chunk.name}  (${chunk.code.length} bytes)`);
     }
   }
   copyStaticAssets(publicDir, outDir2);
   console.error("vesk build: static \u2192 static/public/");
-  const srcDir = resolve19(appDir, "..", "src");
-  const cssSrc = resolve19(srcDir, "global.css");
-  const altCssSrc = resolve19(srcDir, "app.css");
-  let cssContent = null;
-  let cssSourcePath = null;
-  if (existsSync17(cssSrc)) {
-    cssContent = readFileSync17(cssSrc, "utf-8");
-    cssSourcePath = cssSrc;
-  } else if (existsSync17(altCssSrc)) {
-    cssContent = readFileSync17(altCssSrc, "utf-8");
-    cssSourcePath = altCssSrc;
-  }
-  function stripTailwindDirectives2(css) {
-    const blockStart = /^\s*@(theme\s*\{|layer\s+(components|utilities)\s*\{|utility\s+\w+\s*\{)/;
-    let result2 = css.replace(/^\s*@import\s+['"]tailwindcss['"]\s*;?\s*$/gm, "");
-    result2 = result2.replace(/^\s*@source\s+['"][^'"]+['"]\s*;?\s*$/gm, "");
-    const output = [];
-    let pos = 0;
-    while (pos < result2.length) {
-      const lineEnd = result2.indexOf("\n", pos) === -1 ? result2.length : result2.indexOf("\n", pos) + 1;
-      const line = result2.slice(pos, lineEnd);
-      if (blockStart.test(line.trim())) {
-        const end = cssBlockEnd(result2, pos);
-        pos = end;
-        continue;
-      }
-      output.push(line);
-      pos = lineEnd;
-    }
-    return output.join("").trim();
-  }
-  if (cssContent !== null) {
-    const userCss = stripTailwindDirectives2(cssContent);
-    const userCssTarget = resolve19(outDir2, "static", "global.css");
-    writeFileSync9(userCssTarget, userCss, "utf-8");
-    console.error(`vesk build: css  \u2192 static/global.css  (${userCss.length} bytes)`);
-    const twCssTarget = resolve19(outDir2, "static", "_tailwind.css");
-    const isTailwindActive = pluginsPipelines.some((p) => String(p.name).toLowerCase().includes("tailwind"));
-    if (!isTailwindActive) {
-      writeFileSync9(twCssTarget, "", "utf-8");
-      console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind plugin inactive)");
-    } else {
-      let twCss = cssContent;
-      for (const plugin of pluginsPipelines) {
-        if (typeof plugin.onCSS === "function") {
-          const result2 = await plugin.onCSS(twCss, cssSourcePath);
-          if (result2 !== null && typeof result2 === "string") {
-            twCss = result2;
-          }
-        }
-      }
-      const hasUnresolvedTailwindImport = /@import\s+['"]tailwindcss['"]/.test(twCss);
-      if (hasUnresolvedTailwindImport) {
-        const lines = twCss.split("\n").filter((l) => !/^\s*@import\s+['"]tailwindcss['"]/.test(l));
-        twCss = lines.join("\n").trim();
-        if (twCss.length === 0) {
-          writeFileSync9(twCssTarget, "", "utf-8");
-          console.error("vesk build: css  \u2192 static/_tailwind.css  (empty, tailwind unresolved)");
-        } else {
-          writeFileSync9(twCssTarget, twCss, "utf-8");
-          console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes, tailwind partially unresolved)`);
-        }
-      } else {
-        writeFileSync9(twCssTarget, twCss, "utf-8");
-        console.error(`vesk build: css  \u2192 static/_tailwind.css  (${twCss.length} bytes)`);
-      }
-    }
-  }
   let prerenderedRoutes = [];
   if (options2?.ssg) {
     const { generateSsgRoutes: generateSsgRoutes2 } = await Promise.resolve().then(() => (init_static(), static_exports));
-    prerenderedRoutes = await generateSsgRoutes2(routeTree, appDir, outDir2);
+    const cssUrls = resolveCssUrls({
+      tailwind: hasBuiltTailwindCss(outDir2),
+      userCss: hasUserCss(appDir)
+    });
+    prerenderedRoutes = await generateSsgRoutes2(routeTree, appDir, outDir2, pluginsPipelines, pluginHeadExtra, cssUrls);
     console.error(`vesk build: ssg   \u2192 prerendered/  (${prerenderedRoutes.length} pages)`);
   }
   {
@@ -38802,23 +38914,23 @@ async function build2(appDir, options2) {
   }
   {
     const { generateSitemap: generateSitemap2, generateRobotsTxt: generateRobotsTxt2 } = await Promise.resolve().then(() => (init_static(), static_exports));
-    const publicDirResolved = resolve19(outDir2, "static", "public");
+    const publicDirResolved = resolve20(outDir2, "static", "public");
     const siteUrl = options2?.siteUrl || "http://localhost:3000";
-    const sitemapOverride = resolve19(publicDirResolved, "sitemap.xml");
-    if (!existsSync17(sitemapOverride)) {
+    const sitemapOverride = resolve20(publicDirResolved, "sitemap.xml");
+    if (!existsSync18(sitemapOverride)) {
       const sitemap = generateSitemap2(routeTree, ssrRoutes, prerenderedRoutes, { siteUrl });
       writeFileSync9(sitemapOverride, sitemap, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/sitemap.xml (${sitemap.length} bytes)`);
     }
-    const robotsOverride = resolve19(publicDirResolved, "robots.txt");
-    if (!existsSync17(robotsOverride)) {
+    const robotsOverride = resolve20(publicDirResolved, "robots.txt");
+    if (!existsSync18(robotsOverride)) {
       const robots = generateRobotsTxt2(siteUrl);
       writeFileSync9(robotsOverride, robots, "utf-8");
       console.error(`vesk build: seo   \u2192 static/public/robots.txt (${robots.length} bytes)`);
     }
   }
-  const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap);
-  writeFileSync9(resolve19(outDir2, "config.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+  const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap, pluginHeadExtra);
+  writeFileSync9(resolve20(outDir2, "config.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
   console.error("vesk build: config \u2192 config.json");
   {
     const { detectPlatform: detectPlatform2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
@@ -38857,10 +38969,10 @@ vesk build: done (${outDir2})`);
 init_seo_audit();
 
 // src/dev-server.ts
-import { readFileSync as readFileSync30, watch, statSync as statSync21, existsSync as existsSync32, readdirSync as readdirSync13 } from "node:fs";
-import { resolve as resolve32, extname as extname8, join as join19 } from "node:path";
+import { readFileSync as readFileSync33, watch, statSync as statSync21, existsSync as existsSync35, readdirSync as readdirSync13 } from "node:fs";
+import { resolve as resolve35, extname as extname8, join as join19 } from "node:path";
 import { createServer as createServer2 } from "node:http";
-import { WebSocketServer } from "ws";
+import { WebSocketServer as WebSocketServer2 } from "ws";
 
 // ../compiler/dist/strip-ts.js
 init_parser();
@@ -40578,7 +40690,7 @@ init_parser();
 init_tokens();
 init_scan();
 init_strip_ts();
-import { readdirSync as readdirSync7, statSync as statSync12, existsSync as existsSync18, readFileSync as readFileSync18 } from "fs";
+import { readdirSync as readdirSync7, statSync as statSync12, existsSync as existsSync19, readFileSync as readFileSync19 } from "fs";
 import { join as join10, relative as relative5, basename as basename3 } from "path";
 function collapseSlashes2(p) {
   let out = "";
@@ -40596,7 +40708,7 @@ function collapseSlashes2(p) {
   return out;
 }
 function scanRoutes(appDir, options2 = {}) {
-  if (!existsSync18(appDir)) {
+  if (!existsSync19(appDir)) {
     return [];
   }
   return scanDirectory(appDir, appDir, "/", options2);
@@ -40849,7 +40961,7 @@ function matchUrl(tree, pathname) {
 }
 
 // ../compiler/dist/api-routes.js
-import { readdirSync as readdirSync8, statSync as statSync13, existsSync as existsSync19 } from "fs";
+import { readdirSync as readdirSync8, statSync as statSync13, existsSync as existsSync20 } from "fs";
 import { join as join11 } from "path";
 init_server_utils();
 function basename4(p) {
@@ -40857,7 +40969,7 @@ function basename4(p) {
   return idx === -1 ? p : p.slice(idx + 1);
 }
 function scanApiRoutes(apiDir) {
-  if (!existsSync19(apiDir))
+  if (!existsSync20(apiDir))
     return [];
   return scanApiDir(apiDir, apiDir, "/");
 }
@@ -41222,8 +41334,8 @@ async function executeRewrite(url, originalRequest) {
 }
 
 // ../compiler/dist/middleware.js
-import { existsSync as existsSync20 } from "fs";
-import { resolve as resolve20 } from "path";
+import { existsSync as existsSync21 } from "fs";
+import { resolve as resolve21 } from "path";
 
 // ../compiler/src/api-routes.ts
 init_server_utils();
@@ -41282,8 +41394,8 @@ function collectMiddlewareChain(routeTree, url, appDir) {
   }
   function collectForNode(node) {
     if (node.hasMiddleware) {
-      const mwPath2 = resolve20(appDir, node.sourceDir, "middleware.ts");
-      if (existsSync20(mwPath2)) {
+      const mwPath2 = resolve21(appDir, node.sourceDir, "middleware.ts");
+      if (existsSync21(mwPath2)) {
         chain.push({ sourcePath: mwPath2, node });
       }
     }
@@ -41446,8 +41558,8 @@ async function executeMiddlewareChain(chain, request, params, options2 = {}) {
 }
 
 // ../adapter/dist/client-bundle.js
-import { readFileSync as readFileSync19, existsSync as existsSync21, writeFileSync as writeFileSync10, unlinkSync as unlinkSync3, statSync as statSync14, rmSync as rmSync4 } from "node:fs";
-import { resolve as resolve21, join as join12, dirname as dirname14, relative as relative6, sep as sep3 } from "node:path";
+import { readFileSync as readFileSync20, existsSync as existsSync22, writeFileSync as writeFileSync10, unlinkSync as unlinkSync3, statSync as statSync14, rmSync as rmSync4 } from "node:fs";
+import { resolve as resolve22, join as join12, dirname as dirname14, relative as relative6, sep as sep3 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 
 // ../adapter/dist/esbuild-fallback.js
@@ -41520,15 +41632,15 @@ function buildRouterOpts2(options2) {
   return "";
 }
 function findRuntimeSrc3(appDir) {
-  const monorepoRoot = resolve21(__dirname7, "..", "..", "..");
+  const monorepoRoot = resolve22(__dirname7, "..", "..", "..");
   const candidates = [
-    resolve21(monorepoRoot, "packages", "runtime", "dist"),
-    resolve21(appDir, "..", "node_modules", "@vesk/runtime"),
-    resolve21(appDir, "node_modules", "@vesk/runtime")
+    resolve22(monorepoRoot, "packages", "runtime", "dist"),
+    resolve22(appDir, "..", "node_modules", "@vesk/runtime"),
+    resolve22(appDir, "node_modules", "@vesk/runtime")
   ];
   for (const base of candidates) {
     for (const dir of [base, join12(base, "dist")]) {
-      if (existsSync21(join12(dir, "index-client.js")))
+      if (existsSync22(join12(dir, "index-client.js")))
         return dir;
     }
   }
@@ -41735,11 +41847,11 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
     return removeCompiledNodes2(code, isVskImport2);
   }
   function resolveVskImports(filePath, compile) {
-    const src2 = readFileSync19(filePath, "utf-8");
+    const src2 = readFileSync20(filePath, "utf-8");
     const resolved = [];
     for (const importPath of collectVskImportPaths(vskImportLines(src2), filePath)) {
       try {
-        readFileSync19(importPath);
+        readFileSync20(importPath);
       } catch {
         continue;
       }
@@ -41783,7 +41895,7 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
       return;
     }
     compiledFiles++;
-    let src2 = readFileSync19(filePath, "utf-8");
+    let src2 = readFileSync20(filePath, "utf-8");
     if (/content=["'][^"']*\.md["']/i.test(src2)) {
       src2 = inlineMdContentAttrs(src2, dirname14(filePath), guessProjectRoots(appDir));
     }
@@ -41827,36 +41939,50 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options2)
     return slug.replace(/[\[\]]/g, "_");
   }
   const codeSplit = !!options2?.codeSplit;
+  const transformPlugins = options2?.plugins || [];
+  async function applyTransformPlugins(code, filePath) {
+    if (transformPlugins.length === 0)
+      return code;
+    let out = code;
+    for (const plugin of transformPlugins) {
+      if (typeof plugin.onTransformJS === "function") {
+        const result2 = await plugin.onTransformJS(out, filePath);
+        if (typeof result2 === "string")
+          out = result2;
+      }
+    }
+    return out;
+  }
   if (codeSplit) {
     let walkSplit2 = function(nodes, _chain) {
       for (const node of nodes) {
         const chunkCode = [];
-        const pagePath = resolve21(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync21(pagePath)) {
+        const pagePath = resolve22(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync22(pagePath)) {
           compileFile2(pagePath, node.page, chunkCode);
         }
-        const layoutPath = resolve21(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync21(layoutPath)) {
+        const layoutPath = resolve22(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync22(layoutPath)) {
           compileFile2(layoutPath, node.layout, chunkCode);
         }
-        const errorPath = resolve21(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync21(errorPath)) {
+        const errorPath = resolve22(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync22(errorPath)) {
           compileFile2(errorPath, node.error, chunkCode);
         }
-        const notFoundPath = resolve21(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync21(notFoundPath)) {
+        const notFoundPath = resolve22(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync22(notFoundPath)) {
           compileFile2(notFoundPath, node.notFound, chunkCode);
         }
-        const offlinePath = resolve21(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync21(offlinePath)) {
+        const offlinePath = resolve22(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync22(offlinePath)) {
           compileFile2(offlinePath, node.offline, chunkCode);
         }
-        const networkPath = resolve21(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync21(networkPath)) {
+        const networkPath = resolve22(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync22(networkPath)) {
           compileFile2(networkPath, node.network, chunkCode);
         }
-        const loadingPath = resolve21(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync21(loadingPath)) {
+        const loadingPath = resolve22(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync22(loadingPath)) {
           compileFile2(loadingPath, node.loading, chunkCode);
         }
         if (chunkCode.length > 0) {
@@ -41909,13 +42035,17 @@ ${entry.code}
       if (cache2)
         cache2.mainBundle = { key: mainKey, code: main };
     }
-    return { main, chunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
+    const transformedChunks = [];
+    for (const chunk of chunks) {
+      transformedChunks.push({ ...chunk, code: await applyTransformPlugins(chunk.code, chunk.name) });
+    }
+    return { main: await applyTransformPlugins(main, "client.js"), chunks: transformedChunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
   } else {
     let compileFileMono2 = function(filePath, resolvedName) {
       if (seen.has(filePath))
         return;
       seen.add(filePath);
-      const src2 = readFileSync19(filePath, "utf-8");
+      const src2 = readFileSync20(filePath, "utf-8");
       resolveVskImports(filePath, (p, n) => compileFileMono2(p, n || ""));
       const compCode = compileClient(src2, null, { forceClient: true, sourcePath: filePath });
       const hydCode = compileClient(src2, null, { hydrate: true, forceClient: true, includeTopLevel: false, sourcePath: filePath });
@@ -41935,26 +42065,26 @@ ${entry.code}
       }
     }, walkMono2 = function(nodes) {
       for (const node of nodes) {
-        const pagePath = resolve21(appDir, node.sourceDir, "page.vsk");
-        if (node.page && existsSync21(pagePath))
+        const pagePath = resolve22(appDir, node.sourceDir, "page.vsk");
+        if (node.page && existsSync22(pagePath))
           compileFileMono2(pagePath, node.page);
-        const layoutPath = resolve21(appDir, node.sourceDir, "layout.vsk");
-        if (node.layout && existsSync21(layoutPath))
+        const layoutPath = resolve22(appDir, node.sourceDir, "layout.vsk");
+        if (node.layout && existsSync22(layoutPath))
           compileFileMono2(layoutPath, node.layout);
-        const errorPath = resolve21(appDir, node.sourceDir, "error.vsk");
-        if (node.error && existsSync21(errorPath))
+        const errorPath = resolve22(appDir, node.sourceDir, "error.vsk");
+        if (node.error && existsSync22(errorPath))
           compileFileMono2(errorPath, node.error);
-        const notFoundPath = resolve21(appDir, node.sourceDir, "not-found.vsk");
-        if (node.notFound && existsSync21(notFoundPath))
+        const notFoundPath = resolve22(appDir, node.sourceDir, "not-found.vsk");
+        if (node.notFound && existsSync22(notFoundPath))
           compileFileMono2(notFoundPath, node.notFound);
-        const offlinePath = resolve21(appDir, node.sourceDir, "offline.vsk");
-        if (node.offline && existsSync21(offlinePath))
+        const offlinePath = resolve22(appDir, node.sourceDir, "offline.vsk");
+        if (node.offline && existsSync22(offlinePath))
           compileFileMono2(offlinePath, node.offline);
-        const networkPath = resolve21(appDir, node.sourceDir, "network.vsk");
-        if (node.network && existsSync21(networkPath))
+        const networkPath = resolve22(appDir, node.sourceDir, "network.vsk");
+        if (node.network && existsSync22(networkPath))
           compileFileMono2(networkPath, node.network);
-        const loadingPath = resolve21(appDir, node.sourceDir, "loading.vsk");
-        if (node.loading && existsSync21(loadingPath))
+        const loadingPath = resolve22(appDir, node.sourceDir, "loading.vsk");
+        if (node.loading && existsSync22(loadingPath))
           compileFileMono2(loadingPath, node.loading);
         walkMono2(node.children || []);
       }
@@ -41975,7 +42105,7 @@ ${entry.code}
       aliasLines,
       hydratorAliasLines
     }, !!options2?.hmr, !!options2?.importRuntime, runtimeImportNames, options2?.routeDataCache);
-    return { main, chunks: [] };
+    return { main: await applyTransformPlugins(main, "client.js"), chunks: [] };
   }
 }
 function stripTypes2(code) {
@@ -42005,8 +42135,8 @@ function buildRuntimeCode2(runtimeDir) {
   let code = "";
   for (const f of runtimeFiles) {
     const p = join12(runtimeDir, f);
-    if (existsSync21(p)) {
-      let src2 = readFileSync19(p, "utf-8");
+    if (existsSync22(p)) {
+      let src2 = readFileSync20(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, "");
@@ -42018,7 +42148,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync19(join12(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync20(join12(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)]) {
@@ -42029,7 +42159,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames2(runtimeDir) {
-  const indexSrc = readFileSync19(join12(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync20(join12(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(",")) {
@@ -42186,18 +42316,18 @@ if (typeof document !== 'undefined') __router.start();
 }
 
 // ../adapter/dist/paths.js
-import { resolve as resolve22, sep as sep4 } from "node:path";
-import { existsSync as existsSync22, statSync as statSync15, readFileSync as readFileSync20 } from "node:fs";
+import { resolve as resolve23, sep as sep4 } from "node:path";
+import { existsSync as existsSync23, statSync as statSync15, readFileSync as readFileSync21 } from "node:fs";
 function resolveWithin2(baseDir, relPath) {
-  const base = resolve22(baseDir);
-  const target = resolve22(baseDir, relPath);
+  const base = resolve23(baseDir);
+  const target = resolve23(baseDir, relPath);
   const prefix = base + sep4;
   if (!target.startsWith(prefix))
     return null;
   return target;
 }
 function installMdReadHook2(publicDirs) {
-  const dirs = publicDirs.map((d) => resolve22(d));
+  const dirs = publicDirs.map((d) => resolve23(d));
   globalThis.__vsk_md_read_file = (p) => {
     for (const dir of dirs) {
       try {
@@ -42210,8 +42340,8 @@ function installMdReadHook2(publicDirs) {
         const lower = abs.toLowerCase();
         if (!lower.endsWith(".md") && !lower.endsWith(".markdown"))
           continue;
-        if (existsSync22(abs) && statSync15(abs).isFile())
-          return readFileSync20(abs, "utf8");
+        if (existsSync23(abs) && statSync15(abs).isFile())
+          return readFileSync21(abs, "utf8");
       } catch {
       }
     }
@@ -42278,13 +42408,13 @@ function urlAuthority3(url) {
 }
 
 // ../adapter/dist/dev-api.js
-import { readFileSync as readFileSync23, statSync as statSync17, existsSync as existsSync25, readdirSync as readdirSync9 } from "node:fs";
-import { resolve as resolve25 } from "node:path";
+import { readFileSync as readFileSync24, statSync as statSync17, existsSync as existsSync26, readdirSync as readdirSync9 } from "node:fs";
+import { resolve as resolve26 } from "node:path";
 
 // ../adapter/dist/plugins.js
 init_paths();
-import { readFileSync as readFileSync21, writeFileSync as writeFileSync11, existsSync as existsSync23, mkdirSync as mkdirSync8, statSync as statSync16 } from "node:fs";
-import { resolve as resolve23, dirname as dirname15, join as join13, extname as extname7, basename as basename5 } from "node:path";
+import { readFileSync as readFileSync22, writeFileSync as writeFileSync11, existsSync as existsSync24, mkdirSync as mkdirSync8, statSync as statSync16 } from "node:fs";
+import { resolve as resolve24, dirname as dirname15, join as join13, extname as extname7, basename as basename5 } from "node:path";
 import { createRequire as createRequire4 } from "node:module";
 import { spawn as spawn2 } from "node:child_process";
 var PLUGIN_STATE_FILENAME2 = "plugins.json";
@@ -42299,15 +42429,15 @@ function eqIgnoreCase2(a, b) {
   return String(a || "").toLowerCase() === String(b || "").toLowerCase();
 }
 function stateFilePath2(veskDir) {
-  return resolve23(veskDir, PLUGIN_STATE_FILENAME2);
+  return resolve24(veskDir, PLUGIN_STATE_FILENAME2);
 }
 function readPluginState2(veskDir) {
   const file = stateFilePath2(veskDir);
-  if (!existsSync23(file))
+  if (!existsSync24(file))
     return defaultState2();
   let raw2;
   try {
-    raw2 = JSON.parse(readFileSync21(file, "utf-8"));
+    raw2 = JSON.parse(readFileSync22(file, "utf-8"));
   } catch {
     return defaultState2();
   }
@@ -42326,12 +42456,12 @@ function readPluginState2(veskDir) {
 function writePluginState2(veskDir, state) {
   const file = stateFilePath2(veskDir);
   const dir = dirname15(file);
-  if (!existsSync23(dir))
+  if (!existsSync24(dir))
     mkdirSync8(dir, { recursive: true });
   writeFileSync11(file, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 function resolvePackage2(appDir, pkg) {
-  const require3 = createRequire4(resolve23(appDir, "package.json"));
+  const require3 = createRequire4(resolve24(appDir, "package.json"));
   let entryPath = null;
   let pkgJsonPath = null;
   let pkgJson = null;
@@ -42345,7 +42475,7 @@ function resolvePackage2(appDir, pkg) {
       while (cur && cur !== dirname15(cur) && !seen.has(cur)) {
         seen.add(cur);
         const candidate = join13(cur, "package.json");
-        if (existsSync23(candidate)) {
+        if (existsSync24(candidate)) {
           pkgJsonPath = candidate;
           break;
         }
@@ -42357,15 +42487,15 @@ function resolvePackage2(appDir, pkg) {
     } catch {
     }
   }
-  if (pkgJsonPath && existsSync23(pkgJsonPath)) {
+  if (pkgJsonPath && existsSync24(pkgJsonPath)) {
     pkgJson = readJsonFile2(pkgJsonPath);
     const main = pkgJson?.main || pkgJson?.module || "index.js";
-    entryPath = resolve23(dirname15(pkgJsonPath), main);
+    entryPath = resolve24(dirname15(pkgJsonPath), main);
   }
   let localPath = localDir2(appDir, pkg);
   if (!localPath) {
     for (const sub of ["src/plugins", "plugins", "lib/plugins"]) {
-      const candidate = localDir2(resolve23(appDir, sub), pkg);
+      const candidate = localDir2(resolve24(appDir, sub), pkg);
       if (candidate) {
         localPath = candidate;
         break;
@@ -42375,31 +42505,31 @@ function resolvePackage2(appDir, pkg) {
   if (localPath) {
     const localJson = join13(localPath, "package.json");
     let json = null;
-    if (existsSync23(localJson)) {
+    if (existsSync24(localJson)) {
       json = readJsonFile2(localJson);
     }
     return { installed: true, path: localPath, dir: localPath, packageJson: json ?? pkgJson };
   }
-  const installed2 = !!pkgJsonPath && existsSync23(pkgJsonPath);
+  const installed2 = !!pkgJsonPath && existsSync24(pkgJsonPath);
   return { installed: installed2, path: entryPath, dir: installed2 ? dirname15(pkgJsonPath) : null, packageJson: pkgJson };
 }
 function localDir2(base, pkg) {
   if (pkg.startsWith("@")) {
     const parts = pkg.split("/");
-    const p2 = resolve23(base, parts[0], parts[1] ?? "");
-    if (existsSync23(p2))
+    const p2 = resolve24(base, parts[0], parts[1] ?? "");
+    if (existsSync24(p2))
       return p2;
     return null;
   }
-  const p = resolve23(base, pkg);
-  if (existsSync23(p))
+  const p = resolve24(base, pkg);
+  if (existsSync24(p))
     return p;
   return null;
 }
 function readJsonFile2(file) {
   try {
-    if (existsSync23(file))
-      return JSON.parse(readFileSync21(file, "utf-8"));
+    if (existsSync24(file))
+      return JSON.parse(readFileSync22(file, "utf-8"));
   } catch {
   }
   return null;
@@ -42445,7 +42575,7 @@ function repositoryToString2(r) {
 function assemblePluginMeta2(probe) {
   const pkgJson = probe.packageJson || {};
   const dir = probe.dir;
-  const meta = dir ? readJsonFile2(resolve23(dir, "vesk.meta.json")) : null;
+  const meta = dir ? readJsonFile2(resolve24(dir, "vesk.meta.json")) : null;
   const hasMeta = !!meta && Object.keys(meta).length > 0;
   const m = meta || {};
   const metaSource = hasMeta ? "vesk.meta.json" : probe.packageJson ? "package.json" : "none";
@@ -42682,12 +42812,12 @@ function findIconFile2(dir, meta) {
   const explicit = str2(meta?.icon);
   if (explicit) {
     const p = resolveWithin(dir, explicit);
-    if (p && existsSync23(p) && statSync16(p).isFile())
+    if (p && existsSync24(p) && statSync16(p).isFile())
       return p;
   }
   for (const name of ["icon.png", "icon.ico"]) {
-    const p = resolve23(dir, name);
-    if (existsSync23(p) && statSync16(p).isFile())
+    const p = resolve24(dir, name);
+    if (existsSync24(p) && statSync16(p).isFile())
       return p;
   }
   return null;
@@ -42697,7 +42827,7 @@ function findPluginIcon2(appDir, name) {
   const dir = probe.dir;
   if (!dir)
     return null;
-  const meta = readJsonFile2(resolve23(dir, "vesk.meta.json"));
+  const meta = readJsonFile2(resolve24(dir, "vesk.meta.json"));
   const iconPath = findIconFile2(dir, meta);
   if (!iconPath)
     return null;
@@ -42772,7 +42902,7 @@ function resolveDtsPath2(probe, pkgJson) {
     if (!rel)
       continue;
     const abs = resolveWithin(dir, rel);
-    if (abs && existsSync23(abs) && statSync16(abs).isFile())
+    if (abs && existsSync24(abs) && statSync16(abs).isFile())
       return abs;
   }
   return null;
@@ -43121,7 +43251,7 @@ function introspectPlugin2(appDir, name) {
   const pkgName = str2(pkgJson.name) ?? name;
   const exportsMap = flattenPackageExports2(pkgJson.exports);
   const dtsPath = resolveDtsPath2(probe, pkgJson);
-  const dtsExports = dtsPath ? parseDtsExports2(readFileSync21(dtsPath, "utf-8")) : [];
+  const dtsExports = dtsPath ? parseDtsExports2(readFileSync22(dtsPath, "utf-8")) : [];
   return {
     ok: true,
     name: pkgName,
@@ -43259,16 +43389,16 @@ var __internals2 = {
 };
 
 // ../adapter/dist/dev-config.js
-import { existsSync as existsSync24, readFileSync as readFileSync22, writeFileSync as writeFileSync12, mkdirSync as mkdirSync9, mkdtempSync, rmSync as rmSync5 } from "node:fs";
+import { existsSync as existsSync25, readFileSync as readFileSync23, writeFileSync as writeFileSync12, mkdirSync as mkdirSync9, mkdtempSync, rmSync as rmSync5 } from "node:fs";
 import { tmpdir } from "node:os";
-import { resolve as resolve24, dirname as dirname16, join as join14 } from "node:path";
+import { resolve as resolve25, dirname as dirname16, join as join14 } from "node:path";
 init_parser();
 function findConfigFile2(projectDir2) {
-  const ts9 = resolve24(projectDir2, "vesk.config.ts");
-  if (existsSync24(ts9))
+  const ts9 = resolve25(projectDir2, "vesk.config.ts");
+  if (existsSync25(ts9))
     return { path: ts9, isTs: true };
-  const js = resolve24(projectDir2, "vesk.config.js");
-  if (existsSync24(js))
+  const js = resolve25(projectDir2, "vesk.config.js");
+  if (existsSync25(js))
     return { path: js, isTs: false };
   return { path: null, isTs: false };
 }
@@ -43318,13 +43448,13 @@ async function readConfig2(projectDir2) {
   const { path, isTs } = findConfigFile2(projectDir2);
   if (!path)
     return { path: null, exists: false, source: "", config: {} };
-  const source = readFileSync22(path, "utf-8");
+  const source = readFileSync23(path, "utf-8");
   const config = await parseConfigSource(source, isTs, projectDir2);
   return { path, exists: true, source, config };
 }
 async function writeConfigSource2(projectDir2, source) {
   const { path, isTs } = findConfigFile2(projectDir2);
-  const target = path || resolve24(projectDir2, "vesk.config.ts");
+  const target = path || resolve25(projectDir2, "vesk.config.ts");
   await parseConfigSource(source, isTs, projectDir2);
   mkdirSync9(dirname16(target), { recursive: true });
   writeFileSync12(target, source, "utf-8");
@@ -44034,11 +44164,11 @@ export default defineConfig({
 	]
 })
 `;
-    target = resolve24(projectDir2, "vesk.config.ts");
+    target = resolve25(projectDir2, "vesk.config.ts");
     await writeConfigSource2(projectDir2, source);
     return;
   }
-  source = readFileSync22(path, "utf-8");
+  source = readFileSync23(path, "utf-8");
   const existingImport = findPluginImportAst(source, pkg);
   let importName;
   if (existingImport) {
@@ -44118,7 +44248,7 @@ async function removePluginFromConfig2(projectDir2, pkg) {
   const { path } = findConfigFile2(projectDir2);
   if (!path)
     return false;
-  let source = readFileSync22(path, "utf-8");
+  let source = readFileSync23(path, "utf-8");
   const original = source;
   const existingImport = findPluginImportAst(source, pkg);
   let importName = existingImport ? existingImport.name : null;
@@ -44196,7 +44326,7 @@ function jsonStatus(status, data2) {
 function createDevApiRouter2(opts) {
   const veskDir = opts.veskDir;
   const caps = new CapabilityTable2(opts.caps, opts.commandAllowlist);
-  const projectDir2 = opts.projectDir || resolve25(opts.appDir, "..");
+  const projectDir2 = opts.projectDir || resolve26(opts.appDir, "..");
   const getState = opts.getHmrState || (() => ({ status: "up", lastCompileMs: null, error: null, hasError: false, componentCount: 0 }));
   function denied2(cap) {
     return jsonStatus(403, { error: `capability denied: ${cap}` });
@@ -44239,7 +44369,7 @@ function createDevApiRouter2(opts) {
             return badRequest2("no vesk.config file to edit");
           if (!isTs)
             return badRequest2("single-key toggle edits only apply to vesk.config.ts (use the source editor for .js)");
-          const patched = applyConfigToggle2(readFileSync23(path, "utf-8"), b.key, b.value);
+          const patched = applyConfigToggle2(readFileSync24(path, "utf-8"), b.key, b.value);
           if (patched === null)
             return badRequest2("could not safely edit the config object; use the source editor");
           const cfg = await writeConfigSource2(projectDir2, patched);
@@ -44278,14 +44408,14 @@ function createDevApiRouter2(opts) {
         const resolved = resolveWithin2(projectDir2, target);
         if (!resolved)
           return jsonStatus(403, { error: "path escapes project root" });
-        if (!existsSync25(resolved))
+        if (!existsSync26(resolved))
           return jsonStatus(404, { error: "not found" });
         if (statSync17(resolved).isDirectory()) {
           const entries = readdirSync9(resolved, { withFileTypes: true }).map((e) => e.name);
           return jsonStatus(200, { ok: true, path: target, directory: true, entries });
         }
         if (statSync17(resolved).isFile()) {
-          return jsonStatus(200, { ok: true, path: target, directory: false, content: readFileSync23(resolved, "utf-8") });
+          return jsonStatus(200, { ok: true, path: target, directory: false, content: readFileSync24(resolved, "utf-8") });
         }
         return badRequest2("unsupported file type");
       } catch (e) {
@@ -44421,7 +44551,7 @@ function createDevApiRouter2(opts) {
         return {
           status: 200,
           headers: { "Content-Type": icon.mime, "Cache-Control": "private, max-age=60" },
-          body: readFileSync23(icon.file).toString("base64"),
+          body: readFileSync24(icon.file).toString("base64"),
           encoding: "base64"
         };
       }
@@ -44478,8 +44608,8 @@ function produceDiagnostics(input) {
 }
 
 // ../agentic/dist/checkpoints.js
-import { existsSync as existsSync26, mkdirSync as mkdirSync10, readFileSync as readFileSync24, writeFileSync as writeFileSync13, statSync as statSync18, unlinkSync as unlinkSync4, rmSync as rmSync6, renameSync } from "node:fs";
-import { join as join15, resolve as resolve26, dirname as dirname17, sep as sep5 } from "node:path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync10, readFileSync as readFileSync25, writeFileSync as writeFileSync13, statSync as statSync18, unlinkSync as unlinkSync4, rmSync as rmSync6, renameSync } from "node:fs";
+import { join as join15, resolve as resolve27, dirname as dirname17, sep as sep5 } from "node:path";
 import { randomUUID as nodeRandomUUID } from "node:crypto";
 function generateId() {
   try {
@@ -44612,7 +44742,7 @@ var CheckpointManager = class {
   }
 };
 function getAgenticDir(projectDir2) {
-  return join15(resolve26(projectDir2), ".vesk", "agentic");
+  return join15(resolve27(projectDir2), ".vesk", "agentic");
 }
 function getHistoryPath(projectDir2) {
   return join15(getAgenticDir(projectDir2), "history.json");
@@ -44628,9 +44758,9 @@ function ensureDir(dir) {
 }
 function readJson(filePath, fallback) {
   try {
-    if (!existsSync26(filePath))
+    if (!existsSync27(filePath))
       return fallback;
-    const raw2 = readFileSync24(filePath, "utf-8");
+    const raw2 = readFileSync25(filePath, "utf-8");
     if (raw2.trim() === "")
       return fallback;
     return JSON.parse(raw2);
@@ -44722,14 +44852,14 @@ function rollback(projectDir2, id) {
   const cp = getCheckpoint(projectDir2, id);
   if (!cp)
     return null;
-  const projectRoot = resolve26(projectDir2);
+  const projectRoot = resolve27(projectDir2);
   for (const f of cp.files) {
     if (!f.path || !f.path.trim())
       continue;
-    const abs = resolve26(projectRoot, f.path);
+    const abs = resolve27(projectRoot, f.path);
     if (f.before === null) {
       try {
-        if (existsSync26(abs)) {
+        if (existsSync27(abs)) {
           const s = statSync18(abs);
           if (s.isDirectory())
             rmSync6(abs, { recursive: true, force: true });
@@ -44750,8 +44880,8 @@ function rollback(projectDir2, id) {
 }
 
 // ../agentic/dist/config.js
-import { readFileSync as readFileSync25, writeFileSync as writeFileSync14, existsSync as existsSync27, mkdirSync as mkdirSync11, chmodSync } from "node:fs";
-import { resolve as resolve27, dirname as dirname18 } from "node:path";
+import { readFileSync as readFileSync26, writeFileSync as writeFileSync14, existsSync as existsSync28, mkdirSync as mkdirSync11, chmodSync } from "node:fs";
+import { resolve as resolve28, dirname as dirname18 } from "node:path";
 var DEFAULT_CONFIG = {
   provider: "openai",
   model: "gpt-4o-mini",
@@ -44770,10 +44900,10 @@ var SUPPORTED_PROVIDERS = [
   "custom"
 ];
 function configPath2(projectDir2) {
-  return resolve27(projectDir2, ".vesk", "agentic", "config.json");
+  return resolve28(projectDir2, ".vesk", "agentic", "config.json");
 }
 function keysDir(projectDir2) {
-  return resolve27(projectDir2, ".vesk", "agentic", "keys");
+  return resolve28(projectDir2, ".vesk", "agentic", "keys");
 }
 function sanitizeProvider(provider) {
   const p = provider.trim().toLowerCase();
@@ -44785,21 +44915,21 @@ function normalizeProvider(provider) {
   return provider.trim().toLowerCase();
 }
 function providerKeyPath(projectDir2, provider) {
-  return resolve27(keysDir(projectDir2), `${sanitizeProvider(provider)}.key`);
+  return resolve28(keysDir(projectDir2), `${sanitizeProvider(provider)}.key`);
 }
 function providerDotenvVar(provider) {
   const prov = sanitizeProvider(provider);
   return `VK_${prov.toUpperCase().replace(/[^A-Z0-9]/g, "_")}_KEY`;
 }
 function dotenvPath(projectDir2) {
-  return resolve27(projectDir2, ".env.local");
+  return resolve28(projectDir2, ".env.local");
 }
 function readDotenvValue(projectDir2, key, def = null) {
   try {
     const p = dotenvPath(projectDir2);
-    if (!existsSync27(p))
+    if (!existsSync28(p))
       return def;
-    const content = readFileSync25(p, "utf-8");
+    const content = readFileSync26(p, "utf-8");
     for (const rawLine of content.split("\n")) {
       const line = rawLine.trim();
       if (!line || line.startsWith("#"))
@@ -44826,8 +44956,8 @@ function writeDotenvValue(projectDir2, key, value) {
   try {
     let out = "";
     let replaced = false;
-    if (existsSync27(p)) {
-      const lines = readFileSync25(p, "utf-8").split("\n");
+    if (existsSync28(p)) {
+      const lines = readFileSync26(p, "utf-8").split("\n");
       for (const rawLine of lines) {
         const trimmed = rawLine.trim();
         const eq = trimmed.indexOf("=");
@@ -44856,8 +44986,8 @@ function loadAgenticConfig(projectDir2) {
   const p = configPath2(projectDir2);
   let cfg = { ...DEFAULT_CONFIG };
   try {
-    if (existsSync27(p))
-      cfg = { ...cfg, ...JSON.parse(readFileSync25(p, "utf-8")) };
+    if (existsSync28(p))
+      cfg = { ...cfg, ...JSON.parse(readFileSync26(p, "utf-8")) };
   } catch {
   }
   let hasKey = false;
@@ -44899,8 +45029,8 @@ function getProviderSpecificKey(projectDir2, provider) {
     return dotenvFile.trim();
   try {
     const pp2 = providerKeyPath(projectDir2, prov);
-    if (existsSync27(pp2)) {
-      const v = readFileSync25(pp2, "utf-8").trim();
+    if (existsSync28(pp2)) {
+      const v = readFileSync26(pp2, "utf-8").trim();
       if (v)
         return v;
     }
@@ -44947,8 +45077,8 @@ function getApiKey(projectDir2, provider) {
     }
     try {
       const pp2 = providerKeyPath(projectDir2, prov);
-      if (existsSync27(pp2)) {
-        const v = readFileSync25(pp2, "utf-8").trim();
+      if (existsSync28(pp2)) {
+        const v = readFileSync26(pp2, "utf-8").trim();
         if (v)
           return v;
       }
@@ -44971,8 +45101,8 @@ function getApiKey(projectDir2, provider) {
 }
 
 // ../agentic/dist/dev-api.js
-import { existsSync as existsSync28, readFileSync as readFileSync26 } from "node:fs";
-import { resolve as resolve28 } from "node:path";
+import { existsSync as existsSync29, readFileSync as readFileSync27 } from "node:fs";
+import { resolve as resolve29 } from "node:path";
 
 // ../agentic/dist/providers/openai.js
 var OPENAI_FALLBACK_MODELS = ["gpt-4o-mini", "gpt-4o", "gpt-3.5-turbo"];
@@ -45342,9 +45472,9 @@ function getPerProviderKeyRaw(projectDir2, provider) {
   } catch {
   }
   try {
-    const p = resolve28(projectDir2, ".vesk", "agentic", "keys", `${sanitizeProviderName(prov)}.key`);
-    if (existsSync28(p)) {
-      const v = readFileSync26(p, "utf-8").trim();
+    const p = resolve29(projectDir2, ".vesk", "agentic", "keys", `${sanitizeProviderName(prov)}.key`);
+    if (existsSync29(p)) {
+      const v = readFileSync27(p, "utf-8").trim();
       if (v)
         return v;
     }
@@ -46205,11 +46335,11 @@ var Agent = class {
 };
 
 // ../agentic/dist/tools/vesk.js
-import { existsSync as existsSync29, readFileSync as readFileSync27, writeFileSync as writeFileSync15, mkdirSync as mkdirSync12, readdirSync as readdirSync10, statSync as statSync19 } from "node:fs";
-import { resolve as resolve29, join as join16, dirname as dirname19, sep as sep6 } from "node:path";
+import { existsSync as existsSync30, readFileSync as readFileSync28, writeFileSync as writeFileSync15, mkdirSync as mkdirSync12, readdirSync as readdirSync10, statSync as statSync19 } from "node:fs";
+import { resolve as resolve30, join as join16, dirname as dirname19, sep as sep6 } from "node:path";
 function resolveWithin3(baseDir, relPath) {
-  const base = resolve29(baseDir);
-  const target = resolve29(baseDir, relPath);
+  const base = resolve30(baseDir);
+  const target = resolve30(baseDir, relPath);
   const prefix = base + sep6;
   if (target === base || !target.startsWith(prefix))
     return null;
@@ -46217,14 +46347,14 @@ function resolveWithin3(baseDir, relPath) {
 }
 var PLUGIN_STATE_FILENAME3 = "plugins.json";
 function stateFilePath3(veskDir) {
-  return resolve29(veskDir, PLUGIN_STATE_FILENAME3);
+  return resolve30(veskDir, PLUGIN_STATE_FILENAME3);
 }
 function readPluginState3(veskDir) {
   const file = stateFilePath3(veskDir);
-  if (!existsSync29(file))
+  if (!existsSync30(file))
     return { version: 1, plugins: [] };
   try {
-    const raw2 = JSON.parse(readFileSync27(file, "utf-8"));
+    const raw2 = JSON.parse(readFileSync28(file, "utf-8"));
     if (!raw2 || typeof raw2 !== "object")
       return { version: 1, plugins: [] };
     if (raw2.version !== 1)
@@ -46259,16 +46389,16 @@ function validatePackageSpec3(pkg) {
   return null;
 }
 function findConfigFile3(projectDir2) {
-  const ts9 = resolve29(projectDir2, "vesk.config.ts");
-  if (existsSync29(ts9))
+  const ts9 = resolve30(projectDir2, "vesk.config.ts");
+  if (existsSync30(ts9))
     return { path: ts9, isTs: true };
-  const js = resolve29(projectDir2, "vesk.config.js");
-  if (existsSync29(js))
+  const js = resolve30(projectDir2, "vesk.config.js");
+  if (existsSync30(js))
     return { path: js, isTs: false };
   return { path: null, isTs: false };
 }
 function checkpointDir(veskDir) {
-  return join16(resolve29(veskDir), "checkpoints");
+  return join16(resolve30(veskDir), "checkpoints");
 }
 function findMatchingBrace2(src2, openIdx) {
   let inStr = null;
@@ -46397,9 +46527,9 @@ function jsonError(message, extra) {
   return JSON.stringify({ ok: false, error: message, ...extra || {} });
 }
 function createVeskTools(deps) {
-  const projectDir2 = resolve29(deps.projectDir);
-  const appDir = resolve29(deps.appDir);
-  const veskDir = resolve29(deps.veskDir);
+  const projectDir2 = resolve30(deps.projectDir);
+  const appDir = resolve30(deps.appDir);
+  const veskDir = resolve30(deps.veskDir);
   const tools = [
     // 1. vesk.inspectProject
     {
@@ -46412,28 +46542,28 @@ function createVeskTools(deps) {
       },
       async execute(_args) {
         try {
-          const projExists = existsSync29(projectDir2);
+          const projExists = existsSync30(projectDir2);
           const projEntries = projExists ? readdirSync10(projectDir2, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
-          const appExists = existsSync29(appDir);
+          const appExists = existsSync30(appDir);
           const appEntries = appExists ? readdirSync10(appDir, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
-          const veskExists = existsSync29(veskDir);
+          const veskExists = existsSync30(veskDir);
           const veskEntries = veskExists ? readdirSync10(veskDir, { withFileTypes: true }).map((e) => e.isDirectory() ? e.name + "/" : e.name) : [];
           const cfgInfo = findConfigFile3(projectDir2);
           let configSource = null;
           let configExists = false;
-          if (cfgInfo.path && existsSync29(cfgInfo.path)) {
+          if (cfgInfo.path && existsSync30(cfgInfo.path)) {
             configExists = true;
             try {
-              configSource = readFileSync27(cfgInfo.path, "utf-8").slice(0, 8e3);
+              configSource = readFileSync28(cfgInfo.path, "utf-8").slice(0, 8e3);
             } catch {
               configSource = null;
             }
           }
           let packageJson = null;
-          const pkgPath = resolve29(projectDir2, "package.json");
-          if (existsSync29(pkgPath)) {
+          const pkgPath = resolve30(projectDir2, "package.json");
+          if (existsSync30(pkgPath)) {
             try {
-              packageJson = JSON.parse(readFileSync27(pkgPath, "utf-8"));
+              packageJson = JSON.parse(readFileSync28(pkgPath, "utf-8"));
             } catch {
               packageJson = null;
             }
@@ -46513,7 +46643,7 @@ function createVeskTools(deps) {
             resolved = resolveWithin3(appDir, rel);
           if (!resolved)
             return jsonError("path escapes project root", { path: rel });
-          if (!existsSync29(resolved))
+          if (!existsSync30(resolved))
             return jsonError("not found", { path: rel });
           const st = statSync19(resolved);
           if (st.isDirectory()) {
@@ -46521,7 +46651,7 @@ function createVeskTools(deps) {
             return jsonOk({ ok: true, path: rel, directory: true, entries: entries.slice(0, 200) });
           }
           if (st.isFile()) {
-            const content = readFileSync27(resolved, "utf-8");
+            const content = readFileSync28(resolved, "utf-8");
             const capped = content.length > 2e4 ? content.slice(0, 2e4) + "\n/* truncated */" : content;
             return jsonOk({ ok: true, path: rel, directory: false, content: capped, size: content.length });
           }
@@ -46554,10 +46684,10 @@ function createVeskTools(deps) {
             }
           }
           const info = findConfigFile3(projectDir2);
-          if (!info.path || !existsSync29(info.path)) {
+          if (!info.path || !existsSync30(info.path)) {
             return jsonOk({ ok: true, path: null, exists: false, source: "", config: {} });
           }
-          const source = readFileSync27(info.path, "utf-8");
+          const source = readFileSync28(info.path, "utf-8");
           return jsonOk({ ok: true, path: info.path, exists: true, source, config: null });
         } catch (e) {
           return jsonError(e instanceof Error ? e.message : String(e));
@@ -46590,11 +46720,11 @@ function createVeskTools(deps) {
               target = info.path;
               const rel = target.startsWith(projectDir2 + sep6) ? target.slice(projectDir2.length + 1) : "vesk.config.ts";
               const contained = resolveWithin3(projectDir2, rel);
-              if (!contained && target !== resolve29(projectDir2, "vesk.config.ts") && target !== resolve29(projectDir2, "vesk.config.js")) {
+              if (!contained && target !== resolve30(projectDir2, "vesk.config.ts") && target !== resolve30(projectDir2, "vesk.config.js")) {
                 return jsonError("path escapes project root");
               }
             } else {
-              target = resolve29(projectDir2, "vesk.config.ts");
+              target = resolve30(projectDir2, "vesk.config.ts");
               const contained = resolveWithin3(projectDir2, "vesk.config.ts");
               if (!contained)
                 return jsonError("path escapes project root");
@@ -46615,7 +46745,7 @@ function createVeskTools(deps) {
             const contained = resolveWithin3(projectDir2, info.path.slice(projectDir2.length + 1));
             if (!contained)
               return jsonError("path escapes project root");
-            const current2 = readFileSync27(info.path, "utf-8");
+            const current2 = readFileSync28(info.path, "utf-8");
             const patched = applySimpleConfigToggle(current2, key, a.value);
             if (patched === null)
               return jsonError("could not safely edit the config object; use the source editor");
@@ -46936,9 +47066,9 @@ function createVeskTools(deps) {
           const contained = resolveWithin3(dir, `${checkpointId}.json`);
           if (!contained)
             return jsonError("path escapes project root");
-          if (!existsSync29(file))
+          if (!existsSync30(file))
             return jsonError(`checkpoint not found: ${checkpointId}`, { checkpointId });
-          const raw2 = readFileSync27(file, "utf-8");
+          const raw2 = readFileSync28(file, "utf-8");
           let data2;
           try {
             data2 = JSON.parse(raw2);
@@ -46955,15 +47085,354 @@ function createVeskTools(deps) {
   return tools;
 }
 
+// ../adapter/dist/css.js
+init_scan();
+import { readFileSync as readFileSync29, existsSync as existsSync31 } from "node:fs";
+import { resolve as resolve31 } from "node:path";
+var TAILWIND_CSS_URL2 = "/_vesk/static/_tailwind.css";
+var GLOBAL_CSS_URL2 = "/_vesk/static/global.css";
+function resolveUserCssPath2(appDir) {
+  const cssSrc = resolve31(appDir, "..", "src", "global.css");
+  if (existsSync31(cssSrc))
+    return cssSrc;
+  const altCssSrc = resolve31(appDir, "..", "src", "app.css");
+  if (existsSync31(altCssSrc))
+    return altCssSrc;
+  return null;
+}
+function hasUserCss2(appDir) {
+  return resolveUserCssPath2(appDir) !== null;
+}
+function isTailwindPlugin2(plugins) {
+  return (plugins || []).some((p) => String(p && p.name).toLowerCase().includes("tailwind"));
+}
+function resolveCssUrls2(opts) {
+  const urls = [];
+  if (opts.tailwind)
+    urls.push(TAILWIND_CSS_URL2);
+  if (opts.userCss)
+    urls.push(GLOBAL_CSS_URL2);
+  return urls;
+}
+function stripTailwindDirectives2(css) {
+  const blockStart = /^\s*@(theme\s*\{|layer\s+(components|utilities)\s*\{|utility\s+[\w-]+\s*\{)/;
+  let result2 = css.replace(/^\s*@import\s+['"]tailwindcss['"]\s*;?\s*$/gm, "");
+  result2 = result2.replace(/^\s*@source\s+['"][^'"]+['"]\s*;?\s*$/gm, "");
+  const output = [];
+  let pos = 0;
+  while (pos < result2.length) {
+    const lineEnd = result2.indexOf("\n", pos) === -1 ? result2.length : result2.indexOf("\n", pos) + 1;
+    const line = result2.slice(pos, lineEnd);
+    if (blockStart.test(line.trim())) {
+      const end = cssBlockEnd(result2, pos);
+      pos = end;
+      continue;
+    }
+    output.push(line);
+    pos = lineEnd;
+  }
+  return output.join("").trim();
+}
+
+// ../adapter/dist/hmr.js
+init_client_codegen();
+import { WebSocketServer } from "ws";
+import { readFileSync as readFileSync30, existsSync as existsSync32, writeFileSync as writeFileSync16 } from "node:fs";
+import { resolve as resolve32, dirname as dirname20 } from "node:path";
+import { fileURLToPath as fileURLToPath7 } from "node:url";
+init_paths();
+
+// ../adapter/src/error-codeframe.ts
+function buildCodeframe(src2, line, column, context = 5) {
+  if (typeof src2 !== "string" || src2.length === 0) return null;
+  if (typeof line !== "number" || !Number.isInteger(line)) return null;
+  const lines = src2.split("\n");
+  if (line < 1 || line > lines.length) return null;
+  const col = typeof column === "number" && Number.isInteger(column) && column >= 1 ? column : 1;
+  const window2 = typeof context === "number" && Number.isFinite(context) && context >= 0 ? context : 5;
+  const start = Math.max(1, line - window2);
+  const end = Math.min(lines.length, line + window2);
+  const code = [];
+  for (let i = start; i <= end; i++) {
+    code.push({ no: i, text: lines[i - 1] ?? "", isError: i === line });
+  }
+  return { file: "", line, column: col, context: window2, code };
+}
+var LOCATION_RE = /\((\d+):(\d+)\)/;
+function asRecord(v) {
+  if (typeof v === "object" && v !== null) return v;
+  return null;
+}
+function asNumber(v) {
+  if (typeof v === "number" && Number.isFinite(v)) return Math.trunc(v);
+  return null;
+}
+function parseEmbeddedLocation(message) {
+  const m = message.match(LOCATION_RE);
+  if (!m) return null;
+  const line = parseInt(m[1], 10);
+  const column = parseInt(m[2], 10);
+  if (!Number.isFinite(line) || !Number.isFinite(column)) return null;
+  return { line, column: column + 1 };
+}
+function parseCompilerError(err, file, src2) {
+  if (err === void 0 || err === null) return null;
+  const record = asRecord(err);
+  let message;
+  let stack = null;
+  if (record && typeof record.message === "string") {
+    message = record.message;
+    if (typeof record.stack === "string") stack = record.stack;
+  } else if (typeof err === "string") {
+    message = err;
+  } else {
+    try {
+      message = String(err);
+    } catch {
+      message = "Unknown compiler error";
+    }
+    const asAny = err;
+    if (asAny && typeof asAny.stack === "string") stack = asAny.stack;
+  }
+  let line = null;
+  let column = null;
+  let fileResolved = typeof file === "string" ? file : "";
+  if (record) {
+    const loc = asRecord(record.loc);
+    if (loc) {
+      const ln = asNumber(loc.line);
+      if (ln !== null) {
+        line = ln;
+        const rawCol = asNumber(loc.column);
+        column = rawCol !== null ? rawCol + 1 : 1;
+      }
+    }
+    if (line === null) {
+      const pos = asRecord(record.position);
+      if (pos) {
+        const ln = asNumber(pos.line);
+        if (ln !== null) {
+          line = ln;
+          const rawCol = asNumber(pos.column);
+          column = rawCol !== null ? rawCol + 1 : 1;
+        }
+      }
+    }
+    if (line === null) {
+      const ln = asNumber(record.line);
+      if (ln !== null && ln > 0) {
+        line = ln;
+        const rawCol = asNumber(record.column);
+        if (rawCol !== null) column = rawCol;
+      }
+    }
+    if (typeof record.file === "string" && record.file) fileResolved = record.file;
+  }
+  if (line === null) {
+    const embedded = parseEmbeddedLocation(message);
+    if (embedded) {
+      line = embedded.line;
+      column = embedded.column;
+    }
+  }
+  let codeframe = null;
+  if (src2 !== void 0 && typeof src2 === "string" && src2.length > 0 && line !== null) {
+    codeframe = buildCodeframe(src2, line, column ?? 1);
+    if (codeframe) codeframe.file = fileResolved;
+  }
+  return {
+    file: fileResolved,
+    line,
+    column,
+    message,
+    stack,
+    codeframe
+  };
+}
+
+// ../adapter/src/error-tips.ts
+var RUNTIME_AUTOIMPORTS = "effect, derived, untrack, peek, tick, flushSync, on_destroy, createContext";
+var SYNTAX_KINDS = ["Unexpected token", "Parse error", "SyntaxError"];
+var MODULE_KINDS = ["Cannot find module", "Cannot load module", "Module not found"];
+var NULL_DEREF_KINDS = ["Cannot read properties of", "Cannot read property"];
+var rules = [
+  {
+    match: (m) => m.includes("is not defined"),
+    build: () => ({
+      tips: [
+        "The name was referenced before it was imported or declared in this file, so the compiler treated it as undeclared."
+      ],
+      suggestions: [
+        `Vesk auto-imports the reactive helpers from @vesk/runtime (${RUNTIME_AUTOIMPORTS}); note that \`batch\` does NOT exist \u2014 never import it.`
+      ],
+      nextSteps: [
+        "Check the spelling, add an explicit import for the name, or declare it as a binding before use."
+      ]
+    })
+  },
+  {
+    match: (m) => SYNTAX_KINDS.some((k) => m.includes(k)),
+    build: () => ({
+      tips: ["The parser hit a token it could not place in the current context."],
+      suggestions: [
+        "Statement mode accepts bare JSX plus if/for/while/switch/try \u2014 no return statement needed; expression mode requires `return <jsx>;`."
+      ],
+      nextSteps: [
+        "Check the line under the ^ marker for missing brackets, quotes, or unclosed JSX tags, then fix and re-save."
+      ]
+    })
+  },
+  {
+    match: (m) => MODULE_KINDS.some((k) => m.includes(k)),
+    build: () => ({
+      tips: ["An import path could not be resolved from this file."],
+      suggestions: ["Check the specifier spelling and the relative path (./ vs ../) in the import statement."],
+      nextSteps: [
+        "Install the missing dependency or create the file at the expected path, then restart the dev server."
+      ]
+    })
+  },
+  {
+    match: (m) => m.toLowerCase().includes("unterminated"),
+    build: () => ({
+      tips: ["A string or template literal was opened earlier in the file and never closed."],
+      suggestions: ["Look for a missing closing quote or backtick on the line just above the marker."],
+      nextSteps: [
+        "Close the literal; to span lines, open it with a backtick and use ${expr} for interpolation."
+      ]
+    })
+  },
+  {
+    match: (m) => m.includes("is not a function") || m.includes("undefined is not"),
+    build: () => ({
+      tips: ["The value being called is not callable \u2014 often undefined, null, or the wrong import."],
+      suggestions: ["Check that you imported the function itself and used the correct export name."],
+      nextSteps: [
+        "Guard the call (typeof x === 'function' && x()) or trace where the value is assigned before invoking it."
+      ]
+    })
+  },
+  {
+    match: (m) => NULL_DEREF_KINDS.some((k) => m.includes(k)) || m.includes(" of null") || m.includes(" of undefined"),
+    build: () => ({
+      tips: ["A property was read on null or undefined at the marked line."],
+      suggestions: ["Guard the access with optional chaining (obj?.prop) or a default value (const x = data ?? {})."],
+      nextSteps: [
+        "Trace where the value is set \u2014 async data may not have arrived when the component first renders."
+      ]
+    })
+  }
+];
+var FALLBACK = {
+  tips: ["The compiler reported an error in this file but no rule matched its message text."],
+  suggestions: [
+    "Verify imports and that every referenced name is declared \u2014 and check the body in both statement mode (bare JSX, if/for/while/switch/try) and expression mode (return <jsx>)."
+  ],
+  nextSteps: [
+    "Look for a fuller error message printed above this one.",
+    "Restart the dev server if the error persists after the fix."
+  ]
+};
+function suggestFor(message) {
+  if (typeof message !== "string") return FALLBACK;
+  for (const rule of rules) {
+    if (rule.match(message)) return rule.build(message);
+  }
+  return FALLBACK;
+}
+
+// ../adapter/dist/hmr.js
+var __dirname8 = dirname20(fileURLToPath7(import.meta.url));
+function buildErrorPayload(error, filename, opts = {}) {
+  const file = typeof filename === "string" && filename ? filename : "unknown";
+  const parsed = parseCompilerError(error, file);
+  const fallbackMessage = error instanceof Error ? error.message : typeof error === "string" ? error : (() => {
+    try {
+      return String(error);
+    } catch {
+      return "Unknown error";
+    }
+  })();
+  const message = parsed && parsed.message ? parsed.message : fallbackMessage;
+  const line = parsed ? parsed.line : null;
+  const column = parsed ? parsed.column : null;
+  const stack = parsed && typeof parsed.stack === "string" && parsed.stack ? parsed.stack : error instanceof Error && error.stack ? error.stack : void 0;
+  let codeframe;
+  if (line !== null && line >= 1 && typeof opts.appDir === "string") {
+    let src2;
+    try {
+      const absPath = resolve32(opts.appDir, file);
+      if (existsSync32(absPath))
+        src2 = readFileSync30(absPath, "utf-8");
+    } catch {
+      src2 = void 0;
+    }
+    if (typeof src2 === "string" && src2.length > 0) {
+      const cf = buildCodeframe(src2, line, column ?? 1);
+      if (cf) {
+        cf.file = file;
+        codeframe = cf;
+      }
+    }
+  }
+  const tipsData = suggestFor(message);
+  const filePath = typeof opts.appDir === "string" ? resolve32(opts.appDir, file) : void 0;
+  const cleanMessage = filePath && message.endsWith(` in ${filePath}`) ? message.slice(0, -` in ${filePath}`.length).trim() : message.endsWith(` in ${file}`) ? message.slice(0, -` in ${file}`.length).trim() : message;
+  const payload = {
+    file,
+    line,
+    column,
+    message: cleanMessage
+  };
+  if (filePath)
+    payload.filePath = filePath;
+  if (codeframe)
+    payload.codeframe = codeframe;
+  if (tipsData.tips && tipsData.tips.length)
+    payload.tips = tipsData.tips;
+  if (tipsData.suggestions && tipsData.suggestions.length)
+    payload.suggestions = tipsData.suggestions;
+  if (tipsData.nextSteps && tipsData.nextSteps.length)
+    payload.nextSteps = tipsData.nextSteps;
+  if (stack)
+    payload.stack = stack;
+  if (opts.extra) {
+    for (const [k, v] of Object.entries(opts.extra)) {
+      payload[k] = v;
+    }
+  }
+  return payload;
+}
+
+// ../adapter/dist/error-codeframe.js
+function buildCodeframe2(src2, line, column, context = 5) {
+  if (typeof src2 !== "string" || src2.length === 0)
+    return null;
+  if (typeof line !== "number" || !Number.isInteger(line))
+    return null;
+  const lines = src2.split("\n");
+  if (line < 1 || line > lines.length)
+    return null;
+  const col = typeof column === "number" && Number.isInteger(column) && column >= 1 ? column : 1;
+  const window2 = typeof context === "number" && Number.isFinite(context) && context >= 0 ? context : 5;
+  const start = Math.max(1, line - window2);
+  const end = Math.min(lines.length, line + window2);
+  const code = [];
+  for (let i = start; i <= end; i++) {
+    code.push({ no: i, text: lines[i - 1] ?? "", isError: i === line });
+  }
+  return { file: "", line, column: col, context: window2, code };
+}
+
 // src/build-packages.ts
 import { spawnSync } from "node:child_process";
-import { cpSync, existsSync as existsSync30, mkdirSync as mkdirSync13, readFileSync as readFileSync28, readdirSync as readdirSync11, statSync as statSync20, writeFileSync as writeFileSync16 } from "node:fs";
+import { cpSync, existsSync as existsSync33, mkdirSync as mkdirSync13, readFileSync as readFileSync31, readdirSync as readdirSync11, statSync as statSync20, writeFileSync as writeFileSync17 } from "node:fs";
 import { createRequire as createRequire5 } from "node:module";
-import { dirname as dirname20, join as join17, resolve as resolve30 } from "node:path";
-import { fileURLToPath as fileURLToPath7 } from "node:url";
+import { dirname as dirname21, join as join17, resolve as resolve33 } from "node:path";
+import { fileURLToPath as fileURLToPath8 } from "node:url";
 var require2 = createRequire5(import.meta.url);
-var __dirname8 = dirname20(fileURLToPath7(import.meta.url));
-var root2 = resolve30(__dirname8, "..", "..", "..");
+var __dirname9 = dirname21(fileURLToPath8(import.meta.url));
+var root2 = resolve33(__dirname9, "..", "..", "..");
 var PACKAGES = {
   // types first — it is a dependency-free leaf that compiler and adapter
   // import for their shared type definitions.
@@ -46995,9 +47464,9 @@ function newestSourceMtime(srcDir) {
 }
 function distStale(pkgDir, entry) {
   const distIndex = join17(pkgDir, "dist", `${entry}.js`);
-  if (!existsSync30(distIndex)) return true;
+  if (!existsSync33(distIndex)) return true;
   const distPkg = join17(pkgDir, "dist", "package.json");
-  const distStamp = Math.max(statSync20(distIndex).mtimeMs, existsSync30(distPkg) ? statSync20(distPkg).mtimeMs : 0);
+  const distStamp = Math.max(statSync20(distIndex).mtimeMs, existsSync33(distPkg) ? statSync20(distPkg).mtimeMs : 0);
   return newestSourceMtime(join17(pkgDir, "src")) > distStamp;
 }
 function distPackageJson(pkgName, entry, serverEntry, version2) {
@@ -47021,8 +47490,8 @@ function distPackageJson(pkgName, entry, serverEntry, version2) {
 }
 function buildPackages(force = false) {
   for (const [pkg, cfg] of Object.entries(PACKAGES)) {
-    const pkgDir = resolve30(root2, "packages", pkg);
-    if (!existsSync30(join17(pkgDir, "src"))) continue;
+    const pkgDir = resolve33(root2, "packages", pkg);
+    if (!existsSync33(join17(pkgDir, "src"))) continue;
     if (!force && !distStale(pkgDir, cfg.entry)) continue;
     console.log(`[build] ${cfg.name} -> tsc`);
     const tscBin = require2.resolve("typescript/bin/tsc");
@@ -47035,10 +47504,10 @@ function buildPackages(force = false) {
     const distDir = join17(pkgDir, "dist");
     for (const c of cfg.copy || []) {
       const to = join17(distDir, c.to);
-      mkdirSync13(dirname20(to), { recursive: true });
+      mkdirSync13(dirname21(to), { recursive: true });
       cpSync(join17(pkgDir, c.from), to, { recursive: true });
     }
-    const srcPkg = JSON.parse(readFileSync28(join17(pkgDir, "package.json"), "utf-8"));
+    const srcPkg = JSON.parse(readFileSync31(join17(pkgDir, "package.json"), "utf-8"));
     if (pkg === "lucide-vesk") {
       const lucideDistPkg = {
         name: srcPkg.name,
@@ -47052,9 +47521,9 @@ function buildPackages(force = false) {
           "./package.json": "./package.json"
         }
       };
-      writeFileSync16(join17(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
+      writeFileSync17(join17(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
     } else {
-      writeFileSync16(join17(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
+      writeFileSync17(join17(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
     }
     console.log(`[build] ${cfg.name} -> dist`);
   }
@@ -47062,13 +47531,13 @@ function buildPackages(force = false) {
 function ensurePackagesBuilt() {
   buildPackages(false);
 }
-if (process.argv[1] && resolve30(process.argv[1]) === fileURLToPath7(import.meta.url)) {
+if (process.argv[1] && resolve33(process.argv[1]) === fileURLToPath8(import.meta.url)) {
   buildPackages(process.argv.includes("--force"));
 }
 
 // src/action-handler.ts
-import { existsSync as existsSync31, readFileSync as readFileSync29, readdirSync as readdirSync12 } from "node:fs";
-import { resolve as resolve31, join as join18 } from "node:path";
+import { existsSync as existsSync34, readFileSync as readFileSync32, readdirSync as readdirSync12 } from "node:fs";
+import { resolve as resolve34, join as join18 } from "node:path";
 
 // ../compiler/dist/server-cookies.js
 function parseCookies3(str3) {
@@ -47101,8 +47570,8 @@ function getAction2(id) {
 function validateActionInput2(def, input) {
   const issues = [];
   for (const [field, ruleOrRules] of Object.entries(def.input || {})) {
-    const rules = Array.isArray(ruleOrRules) ? ruleOrRules : [ruleOrRules];
-    for (const rule of rules) {
+    const rules2 = Array.isArray(ruleOrRules) ? ruleOrRules : [ruleOrRules];
+    for (const rule of rules2) {
       if (rule && !rule.validate(input[field])) {
         issues.push({ field, message: rule.message });
         break;
@@ -47122,21 +47591,21 @@ function issuesToFieldMap2(issues) {
 
 // src/action-handler.ts
 function actionCssUrls(appDirPath) {
+  let tailwind = true;
   try {
-    const veskDir = join18(resolve31(appDirPath, ".."), ".vesk");
+    const veskDir = join18(resolve34(appDirPath, ".."), ".vesk");
     const statePath = join18(veskDir, "plugins.json");
-    if (existsSync31(statePath)) {
-      const raw2 = readFileSync29(statePath, "utf-8");
+    if (existsSync34(statePath)) {
+      const raw2 = readFileSync32(statePath, "utf-8");
       const state = JSON.parse(raw2);
       const entries = state?.plugins || [];
-      const inactiveTailwind = entries.some(
+      tailwind = !entries.some(
         (p) => String(p.name).toLowerCase().includes("tailwind") && p.active === false
       );
-      if (inactiveTailwind) return ["/_vesk/static/global.css"];
     }
   } catch {
   }
-  return ["/_vesk/static/_tailwind.css", "/_vesk/static/global.css"];
+  return resolveCssUrls2({ tailwind, userCss: hasUserCss2(appDirPath) });
 }
 function actionCssLinkTags(appDirPath) {
   return actionCssUrls(appDirPath).map((u) => `	<link rel="stylesheet" href="${u}" />`).join("\n") + "\n";
@@ -47165,8 +47634,8 @@ function pageSourcesFor(appDirPath, routeTree) {
   const out = [];
   function walk6(nodes) {
     for (const node of nodes) {
-      if (node.page) out.push(resolve31(appDirPath, node.sourceDir, "page.vsk"));
-      if (node.layout) out.push(resolve31(appDirPath, node.sourceDir, "layout.vsk"));
+      if (node.page) out.push(resolve34(appDirPath, node.sourceDir, "page.vsk"));
+      if (node.layout) out.push(resolve34(appDirPath, node.sourceDir, "layout.vsk"));
       walk6(node.children);
     }
   }
@@ -47174,7 +47643,7 @@ function pageSourcesFor(appDirPath, routeTree) {
   return out;
 }
 function walkVskFiles(dir, out, seen) {
-  if (!existsSync31(dir)) return;
+  if (!existsSync34(dir)) return;
   let entries;
   try {
     entries = readdirSync12(dir, { withFileTypes: true });
@@ -47182,7 +47651,7 @@ function walkVskFiles(dir, out, seen) {
     return;
   }
   for (const entry of entries) {
-    const full = resolve31(dir, entry.name);
+    const full = resolve34(dir, entry.name);
     if (seen.has(full)) continue;
     seen.add(full);
     if (entry.isDirectory()) {
@@ -47202,16 +47671,16 @@ function candidateSources(appDirPath, routeTree) {
     seen.add(src2);
     out.push(src2);
   }
-  const projectRoot = resolve31(appDirPath, "..");
-  for (const dir of [resolve31(projectRoot, "components"), appDirPath, projectRoot]) {
+  const projectRoot = resolve34(appDirPath, "..");
+  for (const dir of [resolve34(projectRoot, "components"), appDirPath, projectRoot]) {
     walkVskFiles(dir, out, seen);
   }
   return out;
 }
 function registerSource(sourcePath2) {
-  if (!existsSync31(sourcePath2)) return;
+  if (!existsSync34(sourcePath2)) return;
   try {
-    compileFile(readFileSync29(sourcePath2, "utf-8"), { sourcePath: sourcePath2 });
+    compileFile(readFileSync32(sourcePath2, "utf-8"), { sourcePath: sourcePath2 });
   } catch {
   }
 }
@@ -47220,8 +47689,8 @@ function ensureActionRegistered(actionId, pagePathname, appDirPath, routeTree) {
   const match = matchUrl(routeTree, pagePathname);
   if (match) {
     for (let i = match.nodes.length - 1; i >= 0; i--) {
-      registerSource(resolve31(appDirPath, match.nodes[i].sourceDir, "page.vsk"));
-      registerSource(resolve31(appDirPath, match.nodes[i].sourceDir, "layout.vsk"));
+      registerSource(resolve34(appDirPath, match.nodes[i].sourceDir, "page.vsk"));
+      registerSource(resolve34(appDirPath, match.nodes[i].sourceDir, "layout.vsk"));
     }
   }
   if (getAction2(actionId)) return;
@@ -47247,32 +47716,35 @@ async function renderPageHtml(pagePathname, params, ctx2) {
   let head = "";
   for (let i = chain.length - 1; i >= 0; i--) {
     const node = chain[i];
-    const pageFilePath = resolve31(ctx2.appDirPath, node.sourceDir, "page.vsk");
-    const layoutFilePath = resolve31(ctx2.appDirPath, node.sourceDir, "layout.vsk");
-    if (i === chain.length - 1 && node.page && existsSync31(pageFilePath)) {
-      const src3 = readFileSync29(pageFilePath, "utf-8");
+    const pageFilePath = resolve34(ctx2.appDirPath, node.sourceDir, "page.vsk");
+    const layoutFilePath = resolve34(ctx2.appDirPath, node.sourceDir, "layout.vsk");
+    if (i === chain.length - 1 && node.page && existsSync34(pageFilePath)) {
+      const src3 = readFileSync32(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 && existsSync31(layoutFilePath)) {
-      const src3 = readFileSync29(layoutFilePath, "utf-8");
+    if (node.layout && existsSync34(layoutFilePath)) {
+      const src3 = readFileSync32(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 && existsSync31(resolve31(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
+  const hasLayout = chain.some((n) => n.layout && existsSync34(resolve34(ctx2.appDirPath, n.sourceDir, "layout.vsk")));
   if (hasLayout) {
     const secMeta = securityMeta(ctx2.security);
-    return `<!DOCTYPE html>
+    const headBlock = await applyHeadInjects(
+      '	<meta charset="utf-8" />\n	<meta name="viewport" content="width=device-width, initial-scale=1" />\n' + actionCssLinkTags(ctx2.appDirPath) + secMeta + (head ? "	" + head.split("\n").join("\n	") + "\n" : ""),
+      { plugins: ctx2.plugins },
+      { sourcePath: ctx2.url.pathname }
+    );
+    const fullHtml = `<!DOCTYPE html>
 <html>
 <head>
-	<meta charset="utf-8" />
-	<meta name="viewport" content="width=device-width, initial-scale=1" />
-${actionCssLinkTags(ctx2.appDirPath)}${secMeta}${head ? "	" + head.split("\n").join("\n	") + "\n" : ""}</head>
+${headBlock}</head>
 <body>
 <div id="root">
 ${prettifyHtml(body)}
@@ -47281,13 +47753,14 @@ ${prettifyHtml(body)}
 	<script type="module" src="/_vesk/hmr.js"></script>
 </body>
 </html>`;
+    return applyHtmlPlugins(fullHtml, ctx2.plugins, { sourcePath: ctx2.url.pathname });
   }
   const leaf = chain.find((n) => n.page);
   if (!leaf) return null;
-  const src2 = readFileSync29(resolve31(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+  const src2 = readFileSync32(resolve34(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: actionCssUrls(ctx2.appDirPath), security: ctx2.security, sourcePath: resolve31(ctx2.appDirPath, leaf.sourceDir, "page.vsk") });
-  return html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>');
+  const html = await renderFullPage(src2, compName, { params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: actionCssUrls(ctx2.appDirPath), security: ctx2.security, sourcePath: resolve34(ctx2.appDirPath, leaf.sourceDir, "page.vsk"), plugins: ctx2.plugins });
+  return applyHtmlPlugins(html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>'), ctx2.plugins, { sourcePath: ctx2.url.pathname });
 }
 async function handleActionRequest(req, res, ctx2) {
   const { url, appDirPath, routeTree } = ctx2;
@@ -47428,17 +47901,54 @@ async function handleActionRequest(req, res, ctx2) {
 
 // src/dev-server.ts
 var agenticCheckpointManager = new CheckpointManager();
+function buildDevErrorPayload(input) {
+  const { err, errorMessage, filename, fullPath, appDir, fileExists } = input;
+  const payload = buildErrorPayload(err ?? new Error(errorMessage), filename, { appDir });
+  const errDetails = err && typeof err === "object" ? err : void 0;
+  if (errDetails?.name === "VeskError") {
+    if (Array.isArray(errDetails.suggestions) && errDetails.suggestions.length) {
+      payload.suggestions = errDetails.suggestions;
+    }
+    if (Array.isArray(errDetails.nextSteps) && errDetails.nextSteps.length) {
+      payload.nextSteps = errDetails.nextSteps;
+    }
+    if (typeof errDetails.tip === "string" && errDetails.tip) {
+      payload.tips = [errDetails.tip, ...payload.tips || []];
+    }
+  }
+  if (payload.line === null && payload.column === null) {
+    const lineMatch = errorMessage.match(/(?:line|at\s+line)\s*(\d+)/i);
+    const colMatch = errorMessage.match(/(?:column|col)\s*(\d+)/i);
+    if (lineMatch) {
+      payload.line = parseInt(lineMatch[1], 10);
+      payload.column = colMatch ? parseInt(colMatch[1], 10) : 1;
+      if (fileExists && payload.line > 0) {
+        try {
+          const src2 = readFileSync33(fullPath, "utf-8");
+          const cf = buildCodeframe2(src2, payload.line, payload.column);
+          if (cf) {
+            cf.file = payload.file || filename;
+            payload.codeframe = cf;
+          }
+        } catch {
+        }
+      }
+    }
+  }
+  if (!payload.message) payload.message = errorMessage || "Unknown error";
+  return payload;
+}
 function resolveRuntimeDir(projectDir2) {
   const candidates = [
     // installed app layout
-    resolve32(projectDir2, "node_modules", "@vesk", "runtime"),
+    resolve35(projectDir2, "node_modules", "@vesk", "runtime"),
     // monorepo checkout (tests/probes run from the repo root)
-    resolve32(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
+    resolve35(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
   ];
   for (const dir of candidates) {
-    if (existsSync32(join19(dir, "ripple-runtime.js"))) return dir;
+    if (existsSync35(join19(dir, "ripple-runtime.js"))) return dir;
     const distDir = join19(dir, "dist");
-    if (existsSync32(join19(distDir, "ripple-runtime.js"))) return distDir;
+    if (existsSync35(join19(distDir, "ripple-runtime.js"))) return distDir;
   }
   return null;
 }
@@ -47588,7 +48098,7 @@ function collectRoutePaths(nodes, out = []) {
   return out;
 }
 function countFilesNamed(dir, name) {
-  if (!existsSync32(dir)) return 0;
+  if (!existsSync35(dir)) return 0;
   let n = 0;
   for (const entry of readdirSync13(dir, { withFileTypes: true })) {
     const p = join19(dir, entry.name);
@@ -47629,13 +48139,13 @@ async function startDevServer(port2, projectDir2, config, host2) {
     }
   }
   function isTailwindActive() {
-    return getActiveDevPlugins().some((p) => String(p.name).toLowerCase().includes("tailwind"));
+    return isTailwindPlugin2(getActiveDevPlugins());
   }
   function activeCssUrls() {
-    const urls = [];
-    if (isTailwindActive()) urls.push("/_vesk/static/_tailwind.css");
-    urls.push("/_vesk/static/global.css");
-    return urls;
+    return resolveCssUrls2({
+      tailwind: isTailwindActive(),
+      userCss: hasUserCss2(appDirPath)
+    });
   }
   function cssLinkTags() {
     return activeCssUrls().map((u) => `	<link rel="stylesheet" href="${u}" />`).join("\n") + "\n";
@@ -47648,10 +48158,10 @@ async function startDevServer(port2, projectDir2, config, host2) {
   const cssPath = join19(srcDir, "global.css");
   const altCssPath = join19(srcDir, "app.css");
   let rawCss = "";
-  if (existsSync32(cssPath)) {
-    rawCss = readFileSync30(cssPath, "utf-8");
-  } else if (existsSync32(altCssPath)) {
-    rawCss = readFileSync30(altCssPath, "utf-8");
+  if (existsSync35(cssPath)) {
+    rawCss = readFileSync33(cssPath, "utf-8");
+  } else if (existsSync35(altCssPath)) {
+    rawCss = readFileSync33(altCssPath, "utf-8");
   }
   if (rawCss) {
     const activeAtStart = getActiveDevPlugins();
@@ -47660,7 +48170,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
         await plugin.onBuildStart();
       }
     }
-    devUserCssContent = stripTailwindDirectives(rawCss);
+    devUserCssContent = stripTailwindDirectives2(rawCss);
     if (!isTailwindActive()) {
       devTailwindCssContent = "";
     } else {
@@ -47740,7 +48250,19 @@ async function startDevServer(port2, projectDir2, config, host2) {
       return { err: e, editedSource: null, actualName: null };
     }
   }
-  await buildClientBundle();
+  let devLastBuildMs = null;
+  let devLastError = null;
+  const devDiagnostics = [];
+  function recordDiagnostic(finding) {
+    devDiagnostics.unshift(finding);
+    if (devDiagnostics.length > 50) devDiagnostics.length = 50;
+  }
+  try {
+    await buildClientBundle();
+  } catch (e) {
+    devLastError = { file: "", line: null, column: null, message: e.message };
+    LOG.warn(`dev server started with an app compile error: ${e.message}`);
+  }
   await bundleRuntime2();
   const sourceToComponents = /* @__PURE__ */ new Map();
   function updateSourceMapping() {
@@ -47752,13 +48274,6 @@ async function startDevServer(port2, projectDir2, config, host2) {
     }
   }
   updateSourceMapping();
-  let devLastBuildMs = null;
-  let devLastError = null;
-  const devDiagnostics = [];
-  function recordDiagnostic(finding) {
-    devDiagnostics.unshift(finding);
-    if (devDiagnostics.length > 50) devDiagnostics.length = 50;
-  }
   async function fullRebuild() {
     const t0 = Date.now();
     try {
@@ -47775,7 +48290,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
       return { ok: true, ms: devLastBuildMs ?? 0 };
     } catch (e) {
       const err = e instanceof Error ? e : new Error(String(e));
-      devLastError = { message: err.message };
+      devLastError = { file: "", line: null, column: null, message: err.message };
       recordDiagnostic({ severity: "error", code: "BUILD", file: null, message: err.message, hint: "Fix the failing file; HMR will reload on save." });
       return { ok: false, error: err.message, ms: Date.now() - t0 };
     }
@@ -47866,7 +48381,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
   async function rebuildTailwindCss() {
     if (!rawCss) return false;
     try {
-      const nextUser = stripTailwindDirectives(rawCss);
+      const nextUser = stripTailwindDirectives2(rawCss);
       let nextTailwind;
       if (!isTailwindActive()) {
         nextTailwind = "";
@@ -47901,7 +48416,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
     let debounceTimer = null;
     let cssDebounceTimer = null;
     const watchDirs = [appDirPath];
-    if (existsSync32(srcDir)) watchDirs.push(srcDir);
+    if (existsSync35(srcDir)) watchDirs.push(srcDir);
     for (const watchDir of watchDirs) {
       watch(watchDir, { recursive: true }, (eventType, filename) => {
         if (!filename) return;
@@ -47910,7 +48425,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 : join19(watchDir, filename);
-        const fileExists = existsSync32(fullPath);
+        const fileExists = existsSync35(fullPath);
         if (isVsk) {
           if (debounceTimer) clearTimeout(debounceTimer);
           debounceTimer = setTimeout(async () => {
@@ -47944,6 +48459,7 @@ async function startDevServer(port2, projectDir2, config, host2) {
                 LOG.err(`client build error:`, e.message);
               }
               if (typeof globalThis.__vesk_broadcastHmr === "function") {
+                const hadErrorState = devLastError !== null;
                 if (changedComponents.length > 0) {
                   let fnSources;
                   let errorMessage = bundleError ? bundleError.message : "";
@@ -47959,7 +48475,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
                     if (compCode.trim()) fnSources = { _raw: compCode };
                   } else if (fileExists && !bundleError) {
                     try {
-                      const src2 = readFileSync30(fullPath, "utf-8");
+                      const src2 = readFileSync33(fullPath, "utf-8");
                       let compCode = buildHmrEvalSnippet2(
                         compileClient2(src2, null, { forceClient: true, sourcePath: fullPath, mdRoots: [projectDir2] })
                       );
@@ -47974,88 +48490,48 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
                       if (compCode.trim()) fnSources = { _raw: compCode };
                     } catch (e) {
                       errorMessage = e.message;
-                      LOG.err(`HMR compile error for ${filename}:`, e.message);
+                      bundleError = e;
                     }
                   } else if (!fileExists) {
                     LOG.warn(`HMR source not found: ${fullPath}`);
                   }
                   if (fnSources) {
                     devLastError = null;
-                    globalThis.__vesk_broadcastHmr({
-                      type: "update",
-                      time: Date.now() - t0,
-                      components: Object.fromEntries(changedComponents.map((name) => [name, true])),
-                      fnSources
-                    });
-                  } else if (errorMessage) {
-                    const err = bundleError;
-                    let line = 0, col = 0, file = "";
-                    const suggestions = [];
-                    const nextSteps = [];
-                    let tip = "";
-                    const errDetails = err ? err : void 0;
-                    if (errDetails?.name === "VeskError") {
-                      line = errDetails.line || 0;
-                      col = errDetails.column || 0;
-                      file = errDetails.file || fullPath.replace(projectDir2, "").replace(/^\//, "") || filename || "";
-                      if (errDetails.suggestions) suggestions.push(...errDetails.suggestions);
-                      if (errDetails.nextSteps) nextSteps.push(...errDetails.nextSteps);
-                      tip = errDetails.tip || "";
+                    const bcast = globalThis.__vesk_broadcastHmr;
+                    if (hadErrorState) {
+                      bcast({ type: "reload" });
                     } else {
-                      const lineMatch = errorMessage.match(/(?:line|at\s+line)\s*(\d+)/i);
-                      const colMatch = errorMessage.match(/(?:column|col)\s*(\d+)/i);
-                      const fileMatch = errorMessage.match(/(?:in|at)\s+['"]?([^'":\s]+(?:\.[a-z]+))['"]?/i);
-                      line = lineMatch ? parseInt(lineMatch[1]) : 0;
-                      col = colMatch ? parseInt(colMatch[1]) : 0;
-                      file = fullPath.replace(projectDir2, "").replace(/^\//, "") || filename || "";
-                      if (fileMatch) file = fileMatch[1];
-                    }
-                    let code = "";
-                    if (errDetails?.code && typeof errDetails.code === "string" && errDetails.code.trim()) {
-                      code = errDetails.code;
-                    } else if (line > 0 && fileExists) {
-                      try {
-                        const src2 = readFileSync30(fullPath, "utf-8");
-                        const lines = src2.split("\n");
-                        const start = Math.max(0, line - 6);
-                        const end = Math.min(lines.length, line + 5);
-                        const width = String(end).length;
-                        const out = [];
-                        for (let i = start; i < end; i++) {
-                          const ln = String(i + 1).padStart(width, " ");
-                          out.push(`${ln} | ${lines[i] ?? ""}`);
-                          if (i + 1 === line) {
-                            const pointerCol = Math.max(0, col - 1);
-                            out.push(`${" ".repeat(width)} | ${" ".repeat(pointerCol)}^`);
-                          }
-                        }
-                        code = out.join("\n");
-                      } catch {
-                      }
+                      bcast({
+                        type: "update",
+                        time: Date.now() - t0,
+                        components: Object.fromEntries(changedComponents.map((name) => [name, true])),
+                        fnSources
+                      });
                     }
-                    const tips = [];
-                    if (tip) tips.push(tip);
-                    if (errorMessage.toLowerCase().includes("unexpected token")) tips.push("Check for missing or extra brackets, parentheses, or quotes.");
-                    if (errorMessage.toLowerCase().includes("unexpected identifier")) tips.push("A keyword or identifier is in an unexpected position.");
-                    if (errorMessage.toLowerCase().includes("expected")) tips.push("Check the syntax around the reported line.");
-                    if (errorMessage.toLowerCase().includes("not defined") || errorMessage.toLowerCase().includes("is not defined")) tips.push("The variable or component may not be imported or declared.");
-                    if (errorMessage.toLowerCase().includes("invalid")) tips.push("Check the expression syntax.");
-                    if (errorMessage.toLowerCase().includes("component") && errorMessage.toLowerCase().includes("not")) tips.push("Ensure the component is properly defined.");
-                    if (nextSteps.length) tips.push(...nextSteps);
-                    if (tips.length === 0) tips.push("Review the code around the reported line.");
-                    devLastError = { message: errorMessage, file, line, column: col };
-                    recordDiagnostic({ severity: "error", code: "HMR_COMPILE", file: file || null, line: line || null, column: col || null, message: errorMessage, hint: tips[0] || null });
+                  } else if (errorMessage) {
+                    const payload = buildDevErrorPayload({
+                      err: bundleError,
+                      errorMessage,
+                      filename,
+                      fullPath,
+                      appDir: appDirPath,
+                      fileExists
+                    });
+                    const displayFile = payload.file || filename || "";
+                    LOG.err(`[vsk:error] ${displayFile}${payload.line ? `:${payload.line}:${payload.column || 1}` : ""} \u2014 ${payload.message}`);
+                    devLastError = payload;
+                    recordDiagnostic({
+                      severity: "error",
+                      code: "HMR_COMPILE",
+                      file: displayFile || null,
+                      line: payload.line,
+                      column: payload.column,
+                      message: payload.message,
+                      hint: payload.tips && payload.tips[0] || null
+                    });
                     globalThis.__vesk_broadcastHmr({
                       type: "error",
-                      message: errorMessage,
-                      file,
-                      line,
-                      column: col,
-                      code,
-                      stack: err?.stack || "",
-                      tips,
-                      suggestions,
-                      nextSteps
+                      ...payload
                     });
                   } else {
                     devLastError = null;
@@ -48080,7 +48556,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
           cssDebounceTimer = setTimeout(async () => {
             try {
               if (fileExists) {
-                rawCss = readFileSync30(fullPath, "utf-8");
+                rawCss = readFileSync33(fullPath, "utf-8");
               }
               const cssChanged = await rebuildTailwindCss();
               if (cssChanged && typeof globalThis.__vesk_broadcastHmr === "function") {
@@ -48110,11 +48586,12 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     ".jpg": "image/jpeg",
     ".ico": "image/x-icon",
     ".html": "text/html",
-    ".json": "application/json"
+    ".json": "application/json",
+    ".webmanifest": "application/manifest+json"
   };
   const hmrJsPath = join19(runtimeDir, "hmr-client.js");
   const hmrTsPath = join19(runtimeDir, "hmr-client.ts");
-  const hmrClientPath = existsSync32(hmrJsPath) ? hmrJsPath : existsSync32(hmrTsPath) ? hmrTsPath : null;
+  const hmrClientPath = existsSync35(hmrJsPath) ? hmrJsPath : existsSync35(hmrTsPath) ? hmrTsPath : null;
   function extractCompName2(src2) {
     return resolveComponentName(src2);
   }
@@ -48215,7 +48692,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     }
     if (url.pathname === "/_vesk/hmr" || url.pathname === "/_vesk/hmr.js") {
       if (hmrClientPath) {
-        let hmrContent = readFileSync30(hmrClientPath, "utf-8");
+        let hmrContent = readFileSync33(hmrClientPath, "utf-8");
         if (hmrClientPath.endsWith(".ts")) {
           hmrContent = stripCodeTypes2(hmrContent);
         }
@@ -48249,21 +48726,21 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         return;
       }
     }
-    if (await handleActionRequest(req, res, { url, appDirPath, routeTree, security, maxBodyBytes: maxBodyBytes2 })) {
+    if (await handleActionRequest(req, res, { url, appDirPath, routeTree, security, maxBodyBytes: maxBodyBytes2, plugins: getActiveDevPlugins() })) {
       return;
     }
     if (url.pathname !== "/") {
       const staticPath = url.pathname.length > 1 ? resolveWithin2(publicDir, url.pathname.slice(1)) : null;
-      if (staticPath && existsSync32(staticPath) && statSync21(staticPath).isFile()) {
+      if (staticPath && existsSync35(staticPath) && statSync21(staticPath).isFile()) {
         const ext = extname8(staticPath);
         res.writeHead(200, { "Content-Type": MIME3[ext] || "application/octet-stream" });
-        res.end(readFileSync30(staticPath));
+        res.end(readFileSync33(staticPath));
         return;
       }
     }
     const mwChain = collectMiddlewareChain(routeTree, url.pathname, appDirPath);
     const apiDirPath = join19(appDirPath, "api");
-    if (url.pathname.startsWith("/api") && existsSync32(apiDirPath)) {
+    if (url.pathname.startsWith("/api") && existsSync35(apiDirPath)) {
       const apiRoutes = await scanApiRoutes(apiDirPath);
       const apiMatch = matchApiUrl(apiRoutes, req.url || url.pathname);
       if (apiMatch) {
@@ -48338,12 +48815,12 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
       const rootNode = routeTree.find((n) => n.fullPath === "/");
       let notFoundHtml = null;
       if (rootNode && rootNode.notFound) {
-        const nfPath = resolve32(appDirPath, rootNode.sourceDir, "not-found.vsk");
-        if (existsSync32(nfPath)) {
+        const nfPath = resolve35(appDirPath, rootNode.sourceDir, "not-found.vsk");
+        if (existsSync35(nfPath)) {
           try {
-            const nfSrc = readFileSync30(nfPath, "utf-8");
+            const nfSrc = readFileSync33(nfPath, "utf-8");
             const nfCompName = extractCompName2(nfSrc) || rootNode.notFound;
-            notFoundHtml = await renderFullPage(nfSrc, nfCompName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: nfPath });
+            notFoundHtml = await renderFullPage(nfSrc, nfCompName, { params: {}, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: nfPath, plugins: getActiveDevPlugins() });
           } catch {
           }
         }
@@ -48378,18 +48855,18 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
         let props;
         for (let i = chain.length - 1; i >= 0; i--) {
           const node = chain[i];
-          const pageFilePath = resolve32(appDirPath, node.sourceDir, "page.vsk");
-          const layoutFilePath = resolve32(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync32(pageFilePath)) {
-            const src2 = readFileSync30(pageFilePath, "utf-8");
+          const pageFilePath = resolve35(appDirPath, node.sourceDir, "page.vsk");
+          const layoutFilePath = resolve35(appDirPath, node.sourceDir, "layout.vsk");
+          if (i === chain.length - 1 && node.page && existsSync35(pageFilePath)) {
+            const src2 = readFileSync33(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 && existsSync32(layoutFilePath)) {
-            const src2 = readFileSync30(layoutFilePath, "utf-8");
+          if (node.layout && existsSync35(layoutFilePath)) {
+            const src2 = readFileSync33(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;
@@ -48399,7 +48876,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 && existsSync32(resolve32(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync35(resolve35(appDirPath, n.sourceDir, "layout.vsk")));
         let html;
         if (hasLayout) {
           const ssrData = ssrSink3.snapshot();
@@ -48413,12 +48890,12 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
 `;
             if (security.autoEscape !== false) secMeta += "	<!-- vesk: auto-escape enabled -->\n";
           }
+          let headBlock = '	<meta charset="utf-8" />\n	<meta name="viewport" content="width=device-width, initial-scale=1" />\n' + cssLinkTags() + secMeta + (head ? "	" + head.split("\n").join("\n	") + "\n" : "");
+          headBlock = await applyHeadInjects(headBlock, { plugins: getActiveDevPlugins() }, { sourcePath: url.pathname });
           html = `<!DOCTYPE html>
 <html>
 <head>
-	<meta charset="utf-8" />
-	<meta name="viewport" content="width=device-width, initial-scale=1" />
-${cssLinkTags()}${secMeta}${head ? "	" + head.split("\n").join("\n	") + "\n" : ""}</head>
+${headBlock}</head>
 <body>
 <div id="root">
 ${prettifyHtml(body)}
@@ -48426,13 +48903,15 @@ ${prettifyHtml(body)}
 </body>
 </html>`;
           html = injectDevScripts(html);
+          html = await applyHtmlPlugins(html, getActiveDevPlugins(), { sourcePath: url.pathname });
         } else {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync30(resolve32(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync33(resolve35(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: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve32(appDirPath, leaf.sourceDir, "page.vsk") });
+            html = await renderFullPage(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve35(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
             html = html.replace("</body>", '	<script type="module" src="/_vesk/hmr.js"></script>\n</body>');
+            html = await applyHtmlPlugins(html, getActiveDevPlugins(), { sourcePath: url.pathname });
           } else {
             throw new Error("No page or layout matched");
           }
@@ -48443,13 +48922,13 @@ ${prettifyHtml(body)}
     function renderSSRStream() {
       async function* raw2() {
         const chain = cleanChain;
-        const hasLayout = chain.some((n) => n.layout && existsSync32(resolve32(appDirPath, n.sourceDir, "layout.vsk")));
+        const hasLayout = chain.some((n) => n.layout && existsSync35(resolve35(appDirPath, n.sourceDir, "layout.vsk")));
         if (!hasLayout) {
           const leaf = chain.find((n) => n.page);
           if (leaf) {
-            const src2 = readFileSync30(resolve32(appDirPath, leaf.sourceDir, "page.vsk"), "utf-8");
+            const src2 = readFileSync33(resolve35(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: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve32(appDirPath, leaf.sourceDir, "page.vsk") });
+            yield* renderPageStream(src2, compName, { params: matched.params }, /* @__PURE__ */ new Map(), { hydrate: true, clientScriptUrl: "/_vesk/client.js", cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: resolve35(appDirPath, leaf.sourceDir, "page.vsk"), plugins: getActiveDevPlugins() });
           } else {
             throw new Error("No page or layout matched");
           }
@@ -48460,33 +48939,35 @@ ${prettifyHtml(body)}
         let props;
         for (let i = chain.length - 1; i >= 0; i--) {
           const node = chain[i];
-          const pageFilePath = resolve32(appDirPath, node.sourceDir, "page.vsk");
-          const layoutFilePath = resolve32(appDirPath, node.sourceDir, "layout.vsk");
-          if (i === chain.length - 1 && node.page && existsSync32(pageFilePath)) {
-            const src2 = readFileSync30(pageFilePath, "utf-8");
+          const pageFilePath = resolve35(appDirPath, node.sourceDir, "page.vsk");
+          const layoutFilePath = resolve35(appDirPath, node.sourceDir, "layout.vsk");
+          if (i === chain.length - 1 && node.page && existsSync35(pageFilePath)) {
+            const src2 = readFileSync33(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 && existsSync32(layoutFilePath)) {
-            const src2 = readFileSync30(layoutFilePath, "utf-8");
+          if (node.layout && existsSync35(layoutFilePath)) {
+            const src2 = readFileSync33(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;
             head = (result2.head || "") + head;
           }
         }
-        yield '<!DOCTYPE html>\n<html>\n<head>\n	<meta charset="utf-8" />\n	<meta name="viewport" content="width=device-width, initial-scale=1" />\n' + cssLinkTags();
+        const headParts = ['	<meta charset="utf-8" />', '	<meta name="viewport" content="width=device-width, initial-scale=1" />'];
+        const cssTags = cssLinkTags();
+        if (cssTags) headParts.push(cssTags.trimEnd());
         if (security) {
-          if (security.referrerPolicy !== false) yield `	<meta name="referrer" content="${security.referrerPolicy || "strict-origin-when-cross-origin"}" />
-`;
-          if (security.contentSecurityPolicy !== false) yield `	<meta http-equiv="Content-Security-Policy" content="${(security.contentSecurityPolicy || "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; frame-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'").replace(/"/g, "&quot;")}" />
-`;
-          if (security.autoEscape !== false) yield "	<!-- vesk: auto-escape enabled -->\n";
+          if (security.referrerPolicy !== false) headParts.push(`	<meta name="referrer" content="${security.referrerPolicy || "strict-origin-when-cross-origin"}" />`);
+          if (security.contentSecurityPolicy !== false) headParts.push(`	<meta http-equiv="Content-Security-Policy" content="${(security.contentSecurityPolicy || "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self'; frame-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'").replace(/"/g, "&quot;")}" />`);
+          if (security.autoEscape !== false) headParts.push("	<!-- vesk: auto-escape enabled -->");
         }
-        if (head) yield "	" + head.split("\n").join("\n	") + "\n";
+        if (head) headParts.push("	" + head.split("\n").join("\n	"));
+        yield "<!DOCTYPE html>\n<html>\n<head>\n";
+        yield await applyHeadInjects(headParts.join("\n"), { plugins: getActiveDevPlugins() }, { sourcePath: url.pathname }) + "\n";
         yield '</head>\n<body>\n<div id="root">\n';
         yield prettifyHtml(body);
         yield "\n</div>\n";
@@ -48598,12 +49079,12 @@ ${prettifyHtml(body)}
           for (let i = match.nodes.length - 1; i >= 0; i--) {
             const node = match.nodes[i];
             if (node.notFound) {
-              const nfPath = resolve32(appDirPath, node.sourceDir, "not-found.vsk");
-              if (existsSync32(nfPath)) {
+              const nfPath = resolve35(appDirPath, node.sourceDir, "not-found.vsk");
+              if (existsSync35(nfPath)) {
                 try {
-                  const nfSrc = readFileSync30(nfPath, "utf-8");
+                  const nfSrc = readFileSync33(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: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: nfPath });
+                  const html = await renderFullPage(nfSrc, nfCompName, { params: match.params, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: nfPath, plugins: getActiveDevPlugins() });
                   notFoundHtml = injectDevScripts(html);
                 } catch {
                 }
@@ -48621,13 +49102,13 @@ ${prettifyHtml(body)}
           for (let i = match.nodes.length - 1; i >= 0; i--) {
             const node = match.nodes[i];
             if (node.error) {
-              const errPath = resolve32(appDirPath, node.sourceDir, "error.vsk");
-              if (existsSync32(errPath)) {
+              const errPath = resolve35(appDirPath, node.sourceDir, "error.vsk");
+              if (existsSync35(errPath)) {
                 try {
-                  const errSrc = readFileSync30(errPath, "utf-8");
+                  const errSrc = readFileSync33(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: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: errPath });
+                  const html = await renderFullPage(errSrc, errCompName, errProps, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: activeCssUrls(), security, externalDataScript: storeDataScript, sourcePath: errPath, plugins: getActiveDevPlugins() });
                   errorHtml = injectDevScripts(html);
                 } catch (e2) {
                   LOG.err(`error page render failed:`, e2.message);
@@ -48638,10 +49119,12 @@ ${prettifyHtml(body)}
           }
         }
         const errCode = errorStatusCode(err);
+        const fallbackHtml = errorHtml || injectDevScripts(`<!DOCTYPE html><html><body><h1>${errCode}</h1><pre>${err.message}
+${err.stack}</pre></body></html>`);
         logRequest(errCode);
+        LOG.err(`[vsk:error] ${url.pathname} \u2014 ${err.message}`);
         res.writeHead(errCode, { "Content-Type": "text/html" });
-        res.end(injectSsrErrorMarker(errorHtml || `<!DOCTYPE html><html><body><h1>${errCode}</h1><pre>${err.message}
-${err.stack}</pre></body></html>`, err));
+        res.end(injectSsrErrorMarker(fallbackHtml, err));
       }
     }
   });
@@ -48664,10 +49147,14 @@ ${err.stack}</pre></body></html>`, err));
   });
   updateSourceMapping();
   const hmrClients = /* @__PURE__ */ new Set();
-  const wss = new WebSocketServer({ noServer: true });
+  const wss = new WebSocketServer2({ noServer: true });
   wss.on("connection", (ws) => {
     hmrClients.add(ws);
     ws.on("close", () => hmrClients.delete(ws));
+    if (devLastError) {
+      const msg = JSON.stringify({ type: "error", ...devLastError, nonce: hmrNonce });
+      if (ws.readyState === 1) ws.send(msg);
+    }
   });
   server2.on("upgrade", (req, socket, head) => {
     if (req.url === "/_vesk/hmr" && isAllowedWsUpgrade(req.headers)) {
@@ -48689,7 +49176,6 @@ ${err.stack}</pre></body></html>`, err));
   await new Promise(() => {
   });
 }
-var TAILWIND_BLOCK = /^\s*@(theme\s*\{|layer\s+(components|utilities)\s*\{|utility\s+\w+\s*\{)/;
 function injectSsrErrorMarker(html, err) {
   const msg = err instanceof Error ? err.message : String(err);
   const marker = `<!--vesk-ssr-error:${encodeURIComponent(msg || "Internal Server Error")}-->`;
@@ -48700,35 +49186,6 @@ function injectSsrErrorMarker(html, err) {
   }
   return marker + html;
 }
-function stripTailwindDirectives(css) {
-  const lines = css.split("\n");
-  const result2 = [];
-  let i = 0;
-  while (i < lines.length) {
-    const line = lines[i].trim();
-    if (line.startsWith("@import 'tailwindcss'") || line.startsWith('@import "tailwindcss"')) {
-      i++;
-      continue;
-    }
-    if (line.startsWith("@source ")) {
-      i++;
-      continue;
-    }
-    if (TAILWIND_BLOCK.test(line)) {
-      let braceCount = (lines[i].match(/\{/g) || []).length - (lines[i].match(/\}/g) || []).length;
-      i++;
-      while (i < lines.length && braceCount > 0) {
-        braceCount += (lines[i].match(/\{/g) || []).length;
-        braceCount -= (lines[i].match(/\}/g) || []).length;
-        i++;
-      }
-      continue;
-    }
-    result2.push(lines[i]);
-    i++;
-  }
-  return result2.join("\n").trim();
-}
 function buildRequestContext(req) {
   const headers2 = {};
   for (const [k, v] of Object.entries(req.headers)) {
@@ -48894,8 +49351,8 @@ init_loading_indicator();
 init_action();
 
 // src/index.ts
-var __filename2 = fileURLToPath8(import.meta.url);
-var __dirname9 = resolve34(__filename2, "..");
+var __filename2 = fileURLToPath9(import.meta.url);
+var __dirname10 = resolve37(__filename2, "..");
 var args = process.argv.slice(2);
 var cmd = args[0];
 function usage(code = 0) {
@@ -48942,8 +49399,8 @@ function loadEnvFiles(projectDir2) {
     join21(projectDir2, ".env.local")
   ];
   for (const filePath of files) {
-    if (!existsSync33(filePath)) continue;
-    const content = readFileSync32(filePath, "utf-8");
+    if (!existsSync36(filePath)) continue;
+    const content = readFileSync35(filePath, "utf-8");
     for (const line of content.split("\n")) {
       const trimmed = line.trim();
       if (!trimmed || trimmed.startsWith("#")) continue;
@@ -48965,20 +49422,20 @@ async function loadConfig(projectDir2) {
   const jsPath = join21(projectDir2, "vesk.config.js");
   const tsPath = join21(projectDir2, "vesk.config.ts");
   let configPath3 = null;
-  if (existsSync33(jsPath)) configPath3 = jsPath;
-  else if (existsSync33(tsPath)) configPath3 = tsPath;
+  if (existsSync36(jsPath)) configPath3 = jsPath;
+  else if (existsSync36(tsPath)) configPath3 = tsPath;
   if (!configPath3) return {};
   let raw2;
   if (configPath3.endsWith(".ts")) {
     const { transpile: transpile2 } = await import("typescript");
-    const src2 = readFileSync32(configPath3, "utf-8");
+    const src2 = readFileSync35(configPath3, "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;
 ` + js;
     const tmpFile = join21(projectDir2, ".vesk", "config.tmp.js");
-    mkdirSync15(dirname22(tmpFile), { recursive: true });
-    writeFileSync17(tmpFile, js, "utf-8");
+    mkdirSync15(dirname23(tmpFile), { recursive: true });
+    writeFileSync18(tmpFile, js, "utf-8");
     globalThis.__vesk_inject = { defineConfig, definePlugin, preset };
     raw2 = (await import(tmpFile)).default;
     delete globalThis.__vesk_inject;
@@ -49000,7 +49457,7 @@ if (cmd === "build") {
   const projectDir2 = process.cwd();
   const appDirPath = join21(projectDir2, "app");
   const publicDir = join21(projectDir2, "public");
-  if (!existsSync33(appDirPath)) {
+  if (!existsSync36(appDirPath)) {
     console.error(`vesk build: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49071,7 +49528,7 @@ ${code}`;
 if (cmd === "seo") {
   const projectDir2 = process.cwd();
   const appDirPath = join21(projectDir2, "app");
-  if (!existsSync33(appDirPath)) {
+  if (!existsSync36(appDirPath)) {
     console.error(`vesk seo: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49086,7 +49543,7 @@ if (cmd === "seo") {
 if (cmd === "typecheck") {
   const projectDir2 = process.cwd();
   const appDirPath = join21(projectDir2, "app");
-  if (!existsSync33(appDirPath)) {
+  if (!existsSync36(appDirPath)) {
     console.error(`vesk typecheck: no app/ directory found in ${projectDir2}`);
     process.exit(1);
   }
@@ -49121,12 +49578,12 @@ if (cmd === "init") {
   const projectDir2 = process.cwd();
   const srcDir = join21(projectDir2, "src");
   const target = join21(srcDir, "global.css");
-  if (existsSync33(target)) {
+  if (existsSync36(target)) {
     console.error(`vesk init: ${target} already exists \u2014 skipping`);
     process.exit(0);
   }
   mkdirSync15(srcDir, { recursive: true });
-  writeFileSync17(target, [
+  writeFileSync18(target, [
     `@import 'tailwindcss';`,
     ``,
     `@layer base {`,
@@ -49142,7 +49599,7 @@ if (cmd === "dev") {
   const appDirPath = join21(projectDir2, "app");
   const port2 = parsePortArg(args);
   const host2 = parseHostArg(args);
-  if (!existsSync33(appDirPath)) {
+  if (!existsSync36(appDirPath)) {
     console.error(`vesk: no app/ directory found in ${projectDir2}`);
     console.error('Run "npx create-vesk@latest <project-name>" first');
     process.exit(1);