@vesk/vesk-cli 0.2.50-canary.2 → 0.2.50-canary.4

package/dist/cli.js

@@ -19480,6 +19480,10 @@ function resolveSsrModule(specifier, fromDir) {
   } else {
     const aliased = resolveAliasModule(specifier, fromDir);
     if (aliased) return toRealPath(aliased);
+    const viaExports = resolveViaPackageExports(specifier, fromDir);
+    if (viaExports) return viaExports;
+    const viaModuleField = resolveViaPackageModuleField(specifier, fromDir);
+    if (viaModuleField) return viaModuleField;
     const native = nativeResolve(specifier, fromDir);
     if (native) return native;
     let dir = fromDir;
@@ -19543,6 +19547,98 @@ function statOrNull(p) {
     return null;
   }
 }
+function resolveExports(exportsField, subpath) {
+  const conditions = ["import", "module", "node", "default"];
+  const target = (value) => {
+    if (typeof value === "string") return value;
+    if (!value || typeof value !== "object") return null;
+    for (const cond of conditions) {
+      if (cond in value) {
+        const got = target(value[cond]);
+        if (got) return got;
+      }
+    }
+    return null;
+  };
+  if (typeof exportsField === "string") return subpath === "." ? exportsField : null;
+  if (!exportsField || typeof exportsField !== "object") return null;
+  const map = exportsField;
+  if (subpath in map) {
+    const direct = target(map[subpath]);
+    if (direct) return direct;
+    return null;
+  }
+  let best = null;
+  for (const key of Object.keys(map)) {
+    const star = key.indexOf("*");
+    if (star === -1) continue;
+    const prefix = key.slice(0, star);
+    const suffix = key.slice(star + 1);
+    if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix)) continue;
+    if (subpath.length < prefix.length + suffix.length) continue;
+    if (best === null || prefix.length > best.key.length) {
+      best = { key: prefix, star: subpath.slice(prefix.length, subpath.length - suffix.length) };
+    }
+  }
+  if (!best) return null;
+  const pattern2 = target(map[Object.keys(map).find((k) => k.startsWith(best.key + "*") && k.endsWith(best.key.slice(0, -1)) + "*")] ?? map[`${best.key}*`]);
+  if (pattern2 === null) return null;
+  return pattern2.split("*").join(best.star);
+}
+function resolveViaPackageModuleField(specifier, fromDir) {
+  const firstSlash = specifier.indexOf("/");
+  const splitAt = specifier.startsWith("@") ? specifier.indexOf("/", firstSlash + 1) : firstSlash;
+  const pkgName = splitAt > 0 ? specifier.slice(0, splitAt) : specifier;
+  if (splitAt > 0) return null;
+  let dir = fromDir;
+  for (let depth = 0; depth < 64; depth++) {
+    const pkgPath = join2(dir, "node_modules", pkgName, "package.json");
+    if (statOrNull(pkgPath) !== null) {
+      try {
+        const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+        if (typeof pkg.module === "string" && pkg.module.length > 0) {
+          const found = probeFile(resolve(join2(dir, "node_modules", pkgName), pkg.module));
+          if (found) return toRealPath(found);
+        }
+      } catch {
+      }
+      return null;
+    }
+    const parent = dirname2(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function resolveViaPackageExports(specifier, fromDir) {
+  const firstSlash = specifier.indexOf("/");
+  const splitAt = specifier.startsWith("@") ? specifier.indexOf("/", firstSlash + 1) : firstSlash;
+  const pkgName = splitAt > 0 ? specifier.slice(0, splitAt) : specifier;
+  const subpath = splitAt > 0 ? "." + specifier.slice(splitAt) : ".";
+  let dir = fromDir;
+  for (let depth = 0; depth < 64; depth++) {
+    const pkgDir = join2(dir, "node_modules", pkgName);
+    const pkgPath = join2(pkgDir, "package.json");
+    if (statOrNull(pkgPath) !== null) {
+      try {
+        const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+        if (pkg.exports !== void 0) {
+          const target = resolveExports(pkg.exports, subpath);
+          if (target) {
+            const found = probeFile(resolve(pkgDir, target));
+            if (found) return toRealPath(found);
+          }
+        }
+      } catch {
+      }
+      return null;
+    }
+    const parent = dirname2(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
 function probeFile(base) {
   const st = statOrNull(base);
   if (st && st.isFile()) return base;
@@ -19552,9 +19648,19 @@ function probeFile(base) {
     if (pkgSt && pkgSt.isFile()) {
       try {
         const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
-        if (typeof pkg.main === "string" && pkg.main.length > 0) {
-          const viaMain = probeFile(resolve(base, pkg.main));
-          if (viaMain) return viaMain;
+        if (pkg.exports !== void 0) {
+          const viaExports = resolveExports(pkg.exports, ".");
+          if (viaExports) {
+            const found = probeFile(resolve(base, viaExports));
+            if (found) return found;
+          }
+        }
+        for (const field of ["module", "main"]) {
+          const value = pkg[field];
+          if (typeof value === "string" && value.length > 0) {
+            const found = probeFile(resolve(base, value));
+            if (found) return found;
+          }
         }
       } catch {
       }
@@ -22635,18 +22741,18 @@ function getHooks() {
   return globalThis.__vesk_hooks;
 }
 function defineHook(name, fn) {
-  const hooks = getHooks();
-  if (!hooks[name]) hooks[name] = [];
-  hooks[name].push(fn);
+  const hooks2 = getHooks();
+  if (!hooks2[name]) hooks2[name] = [];
+  hooks2[name].push(fn);
 }
 function removeHook(name, fn) {
-  const hooks = getHooks();
-  if (!hooks[name]) return;
-  hooks[name] = hooks[name].filter((h) => h !== fn);
+  const hooks2 = getHooks();
+  if (!hooks2[name]) return;
+  hooks2[name] = hooks2[name].filter((h) => h !== fn);
 }
 async function runHooks(name, ...args2) {
-  const hooks = getHooks()[name] || [];
-  for (const fn of hooks) {
+  const hooks2 = getHooks()[name] || [];
+  for (const fn of hooks2) {
     const result = await fn(...args2);
     if (result instanceof Response) return result;
   }
@@ -32504,7 +32610,7 @@ async function renderFullPage(source, componentName, props = {}, registry = /* @
       const cssUrls = options.cssUrls || (options.cssUrl ? [options.cssUrl] : []);
       const cssLink = cssUrls.map((u) => `	<link rel="stylesheet" href="${u}" />
 `).join("");
-      const clientScript = options.clientScriptUrl ? `	<script type="module" src="${options.clientScriptUrl}"></script>
+      const clientScript = options.clientScriptUrl ? `	<script type="module" src="${options.clientScriptUrl}"${options.clientScriptIntegrity ? ` integrity="${options.clientScriptIntegrity}" crossorigin="anonymous"` : ""}></script>
 ` : "";
       const dataScripts = buildDataScripts(ssrProps, ssrData, options.externalDataScript);
       const dataScriptBlock = dataScripts.length > 0 ? "\n" + dataScripts.join("\n") + "\n" : "";
@@ -32640,7 +32746,7 @@ function renderPageStream(source, componentName, props = {}, registry = /* @__PU
     pruneSsrDataSlots();
     const dataScripts = buildDataScripts(ssrProps, ssrData, options.externalDataScript);
     const dataScriptBlock = dataScripts.length > 0 ? "\n" + dataScripts.join("\n") : "";
-    const clientScript = options.clientScriptUrl ? `	<script type="module" src="${options.clientScriptUrl}"></script>
+    const clientScript = options.clientScriptUrl ? `	<script type="module" src="${options.clientScriptUrl}"${options.clientScriptIntegrity ? ` integrity="${options.clientScriptIntegrity}" crossorigin="anonymous"` : ""}></script>
 ` : "";
     yield `
 </div>${dataScriptBlock}${clientScript}</body>
@@ -32745,7 +32851,7 @@ import {
   mkdirSync as mkdirSync6,
   statSync as statSync7
 } from "node:fs";
-import { resolve as resolve14, dirname as dirname11, join as join10, extname as extname4, basename } from "node:path";
+import { resolve as resolve14, dirname as dirname11, join as join10, extname as extname4, basename as basename2 } from "node:path";
 import { createRequire as createRequire4 } from "node:module";
 import { spawn } from "node:child_process";
 function defaultState() {
@@ -32803,7 +32909,7 @@ function resolvePackage(appDir, pkg) {
           break;
         }
         const parent = dirname11(cur);
-        if (parent !== cur && basename(cur) === "node_modules") break;
+        if (parent !== cur && basename2(cur) === "node_modules") break;
         cur = parent;
       }
     } catch {
@@ -39227,7 +39333,7 @@ __export(typecheck_exports, {
   typecheckProject: () => typecheckProject
 });
 import { readFileSync as readFileSync39, readdirSync as readdirSync14, statSync as statSync22 } from "node:fs";
-import { join as join26, dirname as dirname27, normalize, relative as relative8, resolve as resolve39, sep as sep7 } from "node:path";
+import { join as join27, dirname as dirname27, normalize, relative as relative8, resolve as resolve39, sep as sep7 } from "node:path";
 import * as ts8 from "typescript";
 function walkProjectFiles(projectRoot) {
   const code = [];
@@ -39240,7 +39346,7 @@ function walkProjectFiles(projectRoot) {
       return;
     }
     for (const e of entries) {
-      const p = join26(dir, e);
+      const p = join27(dir, e);
       let st;
       try {
         st = statSync22(p);
@@ -39295,8 +39401,8 @@ function checkStructureFile(appDir, file) {
   return null;
 }
 function createTypecheckHost(projectRoot, appDir, vskFiles) {
-  const ambientPath = join26(appDir, "__vesk_ambient.d.ts");
-  const overridePath = join26(appDir, "__vesk_runtime_override.d.ts");
+  const ambientPath = join27(appDir, "__vesk_ambient.d.ts");
+  const overridePath = join27(appDir, "__vesk_runtime_override.d.ts");
   const cached = /* @__PURE__ */ new Map();
   const scriptKindFor = (file) => file.endsWith(".vsk") ? ts8.ScriptKind.TSX : ts8.ScriptKind.TS;
   const host = {
@@ -39366,7 +39472,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
     directoryExists: (dir) => ts8.sys.directoryExists(dir),
     getDirectories: (dir) => {
       try {
-        return readdirSync14(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => join26(dir, d.name));
+        return readdirSync14(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => join27(dir, d.name));
       } catch {
         return [];
       }
@@ -39378,7 +39484,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
       return moduleLiterals.map(({ text }) => {
         if (text.endsWith(".vsk")) {
           const aliased = text.startsWith(".") ? null : resolveAliasModule(text, dirname27(containingFile));
-          const abs = normalize(aliased ?? join26(dirname27(containingFile), text));
+          const abs = normalize(aliased ?? join27(dirname27(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -39389,7 +39495,7 @@ function createTypecheckHost(projectRoot, appDir, vskFiles) {
           };
         }
         if (text.endsWith(".css")) {
-          const abs = normalize(join26(dirname27(containingFile), text));
+          const abs = normalize(join27(dirname27(containingFile), text));
           return {
             resolvedModule: {
               resolvedFileName: abs + ".d.ts",
@@ -39436,7 +39542,7 @@ function sourcePosition(source, offset2) {
   return { line, character: bounded - lineStart + 1 };
 }
 function typecheckProject(projectRoot, opts = {}) {
-  const appDir = opts.appDir ?? join26(projectRoot, "app");
+  const appDir = opts.appDir ?? join27(projectRoot, "app");
   const vskFiles = /* @__PURE__ */ new Map();
   const parseErrors = [];
   const warnings = [];
@@ -39475,8 +39581,8 @@ function typecheckProject(projectRoot, opts = {}) {
     }
     rootNames.push(f);
   }
-  const ambientPath = join26(appDir, "__vesk_ambient.d.ts");
-  const overridePath = join26(appDir, "__vesk_runtime_override.d.ts");
+  const ambientPath = join27(appDir, "__vesk_ambient.d.ts");
+  const overridePath = join27(appDir, "__vesk_runtime_override.d.ts");
   rootNames.push(ambientPath);
   rootNames.push(overridePath);
   const options = {
@@ -45422,7 +45528,7 @@ __export(codemods_exports, {
   compareCore: () => compareCore
 });
 import { readFileSync as readFileSync40, existsSync as existsSync43 } from "node:fs";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 import { walk as walk8 } from "zimmerframe";
 function safeParse(source, filePath) {
   try {
@@ -45442,7 +45548,7 @@ function isVskFile(filePath) {
 }
 function typesPackageExports(projectDir) {
   const candidates = [
-    projectDir ? join27(projectDir, "node_modules", "@vesk", "types", "dist", "index.d.ts") : null,
+    projectDir ? join28(projectDir, "node_modules", "@vesk", "types", "dist", "index.d.ts") : null,
     new URL("../../types/dist/index.d.ts", import.meta.url).pathname
   ].filter((p) => typeof p === "string" && existsSync43(p));
   for (const path of candidates) {
@@ -45572,10 +45678,10 @@ __export(migrate_exports, {
   runMigrate: () => runMigrate
 });
 import { readFileSync as readFileSync41, writeFileSync as writeFileSync21, existsSync as existsSync44, statSync as statSync23, readdirSync as readdirSync15 } from "node:fs";
-import { join as join28, relative as relative9, extname as extname9 } from "node:path";
+import { join as join29, relative as relative9, extname as extname9 } from "node:path";
 function detectInstalledVersion(projectDir, cliVersion) {
   for (const pkg of ["@vesk/vesk-cli", "@vesk/adapter", "@vesk/compiler"]) {
-    const p = join28(projectDir, "node_modules", pkg, "package.json");
+    const p = join29(projectDir, "node_modules", pkg, "package.json");
     if (!existsSync44(p)) continue;
     try {
       const version2 = JSON.parse(readFileSync41(p, "utf-8")).version;
@@ -45595,7 +45701,7 @@ function collectTargets(dir, root3 = dir) {
   }
   for (const entry of entries.sort()) {
     if (SKIP_DIRS2.has(entry)) continue;
-    const full = join28(dir, entry);
+    const full = join29(dir, entry);
     let st;
     try {
       st = statSync23(full);
@@ -45630,7 +45736,7 @@ function runMigrate(options) {
     return report;
   }
   for (const relPath of collectTargets(options.projectDir)) {
-    const abs = join28(options.projectDir, relPath);
+    const abs = join29(options.projectDir, relPath);
     const ctx2 = { filePath: abs, displayPath: relPath, projectDir: options.projectDir };
     if (!existsSync44(abs)) continue;
     let source;
@@ -45676,7 +45782,7 @@ var init_migrate = __esm({
 
 // src/index.ts
 import { readFileSync as readFileSync42, writeFileSync as writeFileSync22, mkdirSync as mkdirSync20, existsSync as existsSync45 } from "fs";
-import { resolve as resolve40, join as join29 } from "path";
+import { resolve as resolve40, join as join30 } from "path";
 import { fileURLToPath as fileURLToPath9 } from "url";
 
 // ../adapter/dist/load-config.js
@@ -46255,7 +46361,7 @@ function setRuntimeModule2(mod) {
 
 // ../adapter/dist/index.js
 import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync12, existsSync as existsSync22, readFileSync as readFileSync21 } from "node:fs";
-import { resolve as resolve21, dirname as dirname16, relative as relative4, basename as basename2 } from "node:path";
+import { resolve as resolve21, dirname as dirname16, relative as relative4, basename as basename3, join as join15 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // ../adapter/src/runtime-bundle.ts
@@ -46738,7 +46844,7 @@ ${layoutDecls.map((d) => "  " + d.compiled + ",").join("\n")}
   return { ${paramExprs.join(", ")} };
 }
 `;
-  const clientScriptOption = ', clientScriptUrl: "/_vesk/static/client.js"';
+  const clientScriptOption = `, clientScriptUrl: ${JSON.stringify(options?.clientScriptUrl || "/_vesk/static/client.js")}` + (options?.clientScriptIntegrity ? `, clientScriptIntegrity: ${JSON.stringify(options.clientScriptIntegrity)}` : "");
   const dataScriptOption = ", externalDataScript: storeDataScriptGlobal";
   let registryCode = "";
   const compRegEntries = [];
@@ -47288,6 +47394,43 @@ function generateApiFunction(apiNode, _apiDir, outDir, options) {
   return { funcPath, funcCode, name };
 }
 
+// ../adapter/src/asset-hash.ts
+import { createHash } from "node:crypto";
+var EXT_RE = /\.([a-z0-9]+)$/i;
+function hashedName(fileName, content) {
+  const m = EXT_RE.exec(fileName);
+  if (!m) return fileName;
+  const base = fileName.slice(0, m.index);
+  return `${base}.${hashOf(content)}${m[0]}`;
+}
+function hashOf(content) {
+  return createHash("sha256").update(content).digest("hex").slice(0, 10);
+}
+function integrityOf(content) {
+  return `sha384-${createHash("sha384").update(content).digest("base64")}`;
+}
+function describeAsset(fileName, content) {
+  return {
+    fileName: hashedName(fileName, content),
+    hash: hashOf(content),
+    bytes: typeof content === "string" ? Buffer.byteLength(content) : content.length,
+    integrity: integrityOf(content)
+  };
+}
+function isHashedName(fileName) {
+  const m = EXT_RE.exec(fileName);
+  if (!m) return false;
+  const base = fileName.slice(0, m.index);
+  const dot = base.lastIndexOf(".");
+  if (dot === -1) return false;
+  const suffix = base.slice(dot + 1);
+  return suffix.length === 10 && /^[0-9a-f]{10}$/.test(suffix);
+}
+function cacheControlFor(fileName, isDev) {
+  if (isDev) return "no-cache";
+  return isHashedName(fileName) ? "public, max-age=31536000, immutable" : "public, max-age=0, must-revalidate";
+}
+
 // ../adapter/src/middleware.ts
 import { readFileSync as readFileSync10 } from "node:fs";
 
@@ -47504,14 +47647,17 @@ function collectEventsFile(appDir) {
 
 // ../adapter/src/events.ts
 var buildId2 = 0;
-function buildEntry(sourcePath2) {
+function buildEventsEntry(sourcePath2) {
   return [
     `import * as __events from ${JSON.stringify(sourcePath2)};`,
     "",
     "const __store = () => (globalThis.__vesk_server_ctx ||= {});",
     "",
     "const __handlers = {};",
-    "for (const __name of ['onStart', 'onRequest', 'onStop']) {",
+    // `onError` joins the server events: production has no plugin objects, so
+    // this is the seam an error reporter actually uses there (plugins carry
+    // their own `onError` in dev, where plugin objects do exist).
+    "for (const __name of ['onStart', 'onRequest', 'onStop', 'onError']) {",
     "  const __fn = __events[__name];",
     "  if (typeof __fn === 'function') __handlers[__name] = __fn;",
     "}",
@@ -47552,16 +47698,26 @@ function buildEntry(sourcePath2) {
     "export const onStart = __handlers.onStart;",
     "export const onRequest = __handlers.onRequest;",
     "export const onStop = __handlers.onStop;",
+    "export const onError = __handlers.onError;",
     ""
   ].join("\n");
 }
+async function executeError(err, base, mod) {
+  const fn = mod?.onError;
+  if (typeof fn !== "function") return;
+  try {
+    await fn(err, base);
+  } catch (e) {
+    console.error("vesk: _events onError threw and was ignored:", e instanceof Error ? e.message : e);
+  }
+}
 async function compileEvents(appDir, outDir) {
   const sourcePath2 = collectEventsFile(appDir);
   if (!sourcePath2) return false;
   const serverDir = resolve9(outDir, "server");
   mkdirSync2(serverDir, { recursive: true });
   const entryFile = resolve9(serverDir, `.events-entry-${buildId2++}.mjs`);
-  writeFileSync3(entryFile, buildEntry(sourcePath2), "utf-8");
+  writeFileSync3(entryFile, buildEventsEntry(sourcePath2), "utf-8");
   try {
     const result = await build({
       entryPoints: [entryFile],
@@ -47591,14 +47747,14 @@ async function compileEvents(appDir, outDir) {
 
 // ../adapter/src/client-bundle.ts
 init_esbuild_fallback();
-init_strip_ts();
-init_parser();
-init_client_codegen();
-init_vsk_collision();
 import { readFileSync as readFileSync11, existsSync as existsSync11, writeFileSync as writeFileSync4, unlinkSync as unlinkSync3, statSync as statSync3, rmSync, mkdtempSync, mkdirSync as mkdirSync3 } from "node:fs";
 import { resolve as resolve10, join as join7, dirname as dirname8, relative as relative2, sep } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { tmpdir } from "node:os";
+init_strip_ts();
+init_parser();
+init_client_codegen();
+init_vsk_collision();
 init_vsk_imports();
 init_md_inline();
 init_module_imports();
@@ -48184,8 +48340,11 @@ async function generateClientBundle(routeTree, appDir, componentMap, options) {
     }, annotate2 = function(nodes) {
       for (const node of nodes) {
         const chunkName = `page-${buildChunkName(node)}.js`;
-        const hasEntry = chunkEntries.some((e) => e.name === chunkName && e.code.trim());
-        if (hasEntry) node.chunk = `/_vesk/static/${chunkName}`;
+        const emitted = chunks.find((c) => c.name === chunkName && c.code.trim());
+        if (emitted) {
+          const fileName = options?.hmr ? chunkName : hashedName(chunkName, emitted.code);
+          node.chunk = `/_vesk/static/${fileName}`;
+        }
         annotate2(node.children || []);
       }
     };
@@ -48624,10 +48783,42 @@ function copyStaticAssets(publicDir, outDir) {
 
 // ../adapter/src/prod-server.ts
 import { readFileSync as readFileSync15, existsSync as existsSync15, statSync as statSync6 } from "node:fs";
-import { resolve as resolve13, extname as extname3, dirname as dirname10 } from "node:path";
+import { resolve as resolve13, extname as extname3, dirname as dirname10, basename } from "node:path";
 import { createServer } from "node:http";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 init_server_utils();
+
+// ../adapter/src/error-report.ts
+var hooks = [];
+var reported = /* @__PURE__ */ new WeakSet();
+async function reportServerError(err, options) {
+  if (options.dedupe !== false && err && typeof err === "object") {
+    if (reported.has(err)) return;
+    reported.add(err);
+  }
+  const cfg = options.buildConfig || null;
+  const ctx2 = {
+    url: options.url,
+    routePath: options.routePath,
+    target: options.target,
+    status: options.status ?? 500,
+    durationMs: options.durationMs,
+    version: typeof cfg?.veskVersion === "string" ? cfg.veskVersion : void 0,
+    buildId: typeof cfg?.buildId === "string" ? cfg.buildId : void 0,
+    errorName: err instanceof Error ? err.name : typeof err,
+    message: err instanceof Error ? err.message : String(err),
+    stack: err instanceof Error ? err.stack : void 0
+  };
+  for (const hook of hooks) {
+    try {
+      await hook(err, ctx2);
+    } catch (e) {
+      console.error("vesk: an onError hook threw and was ignored:", e?.message ?? e);
+    }
+  }
+}
+
+// ../adapter/src/prod-server.ts
 init_paths();
 
 // ../adapter/src/load-config.ts
@@ -48935,9 +49126,13 @@ async function startProdServer(outDir, options) {
       return;
     }
     if (url.pathname === "/_vesk/runtime.js") {
-      const clientPath = resolve13(staticDir, "client.js");
+      const clientFile = buildConfig?.assets?.client?.file || "client.js";
+      const clientPath = resolve13(staticDir, clientFile);
       if (existsSync15(clientPath)) {
-        res.writeHead(200, { "Content-Type": "application/javascript" });
+        res.writeHead(200, {
+          "Content-Type": "application/javascript",
+          "Cache-Control": cacheControlFor(clientFile, false)
+        });
         res.end(readFileSync15(clientPath));
         return;
       }
@@ -48952,7 +49147,13 @@ async function startProdServer(outDir, options) {
       }
       if (existsSync15(staticPath) && statSync6(staticPath).isFile()) {
         const ext = extname3(staticPath);
-        res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
+        res.writeHead(200, {
+          "Content-Type": MIME[ext] || "application/octet-stream",
+          // A content-hashed name can never change meaning, so it is immutable
+          // for a year; anything unhashed must be revalidated or a deploy would
+          // serve stale JS forever.
+          "Cache-Control": cacheControlFor(basename(staticPath), false)
+        });
         res.end(readFileSync15(staticPath));
         return;
       }
@@ -49141,6 +49342,16 @@ async function startProdServer(outDir, options) {
                 return;
               }
               console.error("vesk ssr error:", err.message);
+              await reportServerError(err, {
+                url: url.pathname + url.search,
+                routePath: route.path,
+                target: "node",
+                status: 500,
+                buildConfig
+              });
+              if (eventsMod) {
+                await executeError(err, { url: url.href, routePath: route.path, target: "node", status: 500 }, eventsMod);
+              }
               const errPath = resolve13(appDir, "error.vsk");
               let errorHtml = null;
               if (existsSync15(errPath)) {
@@ -49150,7 +49361,7 @@ async function startProdServer(outDir, options) {
                   const src2 = readFileSync15(errPath, "utf-8");
                   const compName = resolveComponentName(src2) || "Error";
                   const expose = process.env.NODE_ENV !== "production";
-                  errorHtml = await renderFullPage2(src2, compName, { error: expose ? err.message : "Internal Server Error", stack: expose ? err.stack : "", statusCode: 500, url: url.pathname }, /* @__PURE__ */ new Map(), { hydrate: true, cssUrls: pageCssUrls, clientScriptUrl: "/_vesk/static/client.js", security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath, headExtra: bakedHeadExtra });
+                  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: buildConfig?.assets?.client?.url || "/_vesk/static/client.js", clientScriptIntegrity: buildConfig?.assets?.client?.integrity, security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath, headExtra: bakedHeadExtra });
                 } catch {
                 }
               }
@@ -49205,6 +49416,9 @@ init_parser();
 init_paths();
 
 // ../adapter/dist/index.js
+function PACKAGES_DIR_SELF() {
+  return resolve21(dirname16(fileURLToPath5(import.meta.url)), "..");
+}
 var __dirname6 = dirname16(fileURLToPath5(import.meta.url));
 async function resolveCompilerApi(name) {
   const monorepoSrc = resolve21(__dirname6, "..", "..", "compiler", "src");
@@ -49231,7 +49445,7 @@ function filterPluginsForBuild(plugins, state) {
   return filterActivePlugins2(plugins, state.plugins);
 }
 function veskDirFromOutDir(outDir) {
-  const base = basename2(outDir);
+  const base = basename3(outDir);
   if (base === "dev" || base === "build")
     return dirname16(outDir);
   return outDir;
@@ -49360,6 +49574,34 @@ async function build2(appDir, options) {
   const apiTree = existsSync22(apiDir) ? scanApiRoutes2(apiDir) : [];
   console.error(`vesk build: ${routeTree.length} root routes, ${apiTree.length} API routes`);
   markPhase("scan routes");
+  console.error("vesk build: bundling client runtime...");
+  const bundleOpts = {};
+  if (options?.codeSplit)
+    bundleOpts.codeSplit = true;
+  if (options?.hmr)
+    bundleOpts.hmr = true;
+  if (options?.routeDataCache !== void 0)
+    bundleOpts.routeDataCache = options.routeDataCache;
+  if (pluginsPipelines.length > 0)
+    bundleOpts.plugins = pluginsPipelines;
+  const { main, chunks } = await generateClientBundle(routeTree, appDir, componentMap, bundleOpts);
+  markPhase("client runtime + chunks");
+  const staticDir = resolve21(outDir, "static");
+  const hashed = !options?.hmr;
+  const clientAsset = describeAsset("client.js", main);
+  const clientFileName = hashed ? clientAsset.fileName : "client.js";
+  writeFileSync12(resolve21(staticDir, clientFileName), main, "utf-8");
+  const clientUrl = `/_vesk/static/${clientFileName}`;
+  const mode = chunks.length > 0 ? "code-split" : "monolithic";
+  console.error(`vesk build: client \u2192 static/${clientFileName}  (${main.length} bytes, ${mode}${hashed ? `, ${clientAsset.hash}` : ""})`);
+  const emittedAssets = [clientAsset];
+  for (const chunk of chunks) {
+    const asset = describeAsset(chunk.name, chunk.code);
+    emittedAssets.push(asset);
+    writeFileSync12(resolve21(staticDir, hashed ? asset.fileName : chunk.name), chunk.code, "utf-8");
+    console.error(`vesk build: chunk \u2192 static/${hashed ? asset.fileName : chunk.name}  (${chunk.code.length} bytes${hashed ? `, ${asset.hash}` : ""})`);
+  }
+  const clientIntegrity = hashed ? clientAsset.integrity : void 0;
   console.error("vesk build: bundling server runtime...");
   await bundleRuntime(appDir, outDir);
   const ssrRoutes = [];
@@ -49379,7 +49621,7 @@ async function build2(appDir, options) {
           mwCode = compileMiddlewareCode(mwSources);
         }
         const ssrAncestorLayouts = isStandalone ? [] : ancestorLayouts;
-        const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir, componentMap, { ancestorLayouts: ssrAncestorLayouts, middlewareCode: mwCode, headExtra: pluginHeadExtra });
+        const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir, componentMap, { ancestorLayouts: ssrAncestorLayouts, middlewareCode: mwCode, headExtra: pluginHeadExtra, clientScriptUrl: clientUrl, clientScriptIntegrity: clientIntegrity });
         writeFileSync12(funcPath, funcCode, "utf-8");
         const pagePath = resolve21(appDir, node.sourceDir, "page.vsk");
         if (existsSync22(pagePath)) {
@@ -49439,28 +49681,6 @@ async function build2(appDir, options) {
   const hasEvents = await compileEvents(appDir, outDir);
   if (hasEvents)
     console.error("vesk build: evt  \u2192 server/events.js (onStart/onRequest/onStop)");
-  markPhase("api functions");
-  console.error("vesk build: bundling client runtime...");
-  const bundleOpts = {};
-  if (options?.codeSplit)
-    bundleOpts.codeSplit = true;
-  if (options?.hmr)
-    bundleOpts.hmr = true;
-  if (options?.routeDataCache !== void 0)
-    bundleOpts.routeDataCache = options.routeDataCache;
-  if (pluginsPipelines.length > 0)
-    bundleOpts.plugins = pluginsPipelines;
-  const { main, chunks } = await generateClientBundle(routeTree, appDir, componentMap, bundleOpts);
-  writeFileSync12(resolve21(outDir, "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 staticDir = resolve21(outDir, "static");
-    for (const chunk of chunks) {
-      writeFileSync12(resolve21(staticDir, chunk.name), chunk.code, "utf-8");
-      console.error(`vesk build: chunk \u2192 static/${chunk.name}  (${chunk.code.length} bytes)`);
-    }
-  }
   copyStaticAssets(publicDir, outDir);
   markPhase("client runtime + chunks");
   console.error("vesk build: static \u2192 static/public/");
@@ -49503,6 +49723,14 @@ async function build2(appDir, options) {
   }
   markPhase("ssg+images+seo");
   const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap, pluginHeadExtra, hasEvents);
+  const buildId3 = emittedAssets.map((a) => a.hash).join("-");
+  manifest.buildId = buildId3.slice(0, 32);
+  manifest.veskVersion = JSON.parse(readFileSync21(join15(PACKAGES_DIR_SELF(), "package.json"), "utf-8")).version;
+  manifest.assets = {
+    hashed,
+    client: { file: clientFileName, url: clientUrl, hash: clientAsset.hash, bytes: clientAsset.bytes, integrity: clientAsset.integrity },
+    chunks: emittedAssets.slice(1).map((a) => ({ file: a.fileName, hash: a.hash, bytes: a.bytes, integrity: a.integrity }))
+  };
   writeFileSync12(resolve21(outDir, "config.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
   console.error("vesk build: config \u2192 config.json");
   {
@@ -49552,7 +49780,7 @@ init_seo_audit();
 
 // src/dev-server.ts
 import { readFileSync as readFileSync38, watch, statSync as statSync21, existsSync as existsSync42, readdirSync as readdirSync13 } from "node:fs";
-import { resolve as resolve38, extname as extname8, join as join25, dirname as dirname26 } from "node:path";
+import { resolve as resolve38, extname as extname8, join as join26, dirname as dirname26 } from "node:path";
 import { createServer as createServer2 } from "node:http";
 import { WebSocketServer as WebSocketServer2 } from "ws";
 
@@ -52202,7 +52430,7 @@ init_tokens();
 init_scan();
 init_strip_ts();
 import { readdirSync as readdirSync7, statSync as statSync12, existsSync as existsSync23, readFileSync as readFileSync22 } from "fs";
-import { join as join15, relative as relative5, basename as basename3 } from "path";
+import { join as join16, relative as relative5, basename as basename4 } from "path";
 function collapseSlashes2(p) {
   let out = "";
   let prevSlash = false;
@@ -52305,7 +52533,7 @@ function scanComponents(componentsDir) {
       return;
     }
     for (const entry of entries) {
-      const full = join15(dir, entry);
+      const full = join16(dir, entry);
       let stat;
       try {
         stat = statSync12(full);
@@ -52386,7 +52614,7 @@ function scanDirectory(rootDir, dir, parentPath, options) {
       continue;
     }
   }
-  let segName = basename3(dir);
+  let segName = basename4(dir);
   let isGroup = segName.startsWith("(") && segName.endsWith(")");
   let isDynamic = segName.startsWith("[") && segName.endsWith("]") && !segName.startsWith("[...");
   let isCatchAll = segName.startsWith("[...") && segName.endsWith("]");
@@ -52406,7 +52634,7 @@ function scanDirectory(rootDir, dir, parentPath, options) {
     seg = segName;
   }
   const fullPath = seg ? (parentPath === "/" ? "/" : parentPath + "/") + seg : parentPath || "/";
-  const isStandalone = hasLayout ? isStandaloneLayoutFile(join15(dir, "layout.vsk")) : false;
+  const isStandalone = hasLayout ? isStandaloneLayoutFile(join16(dir, "layout.vsk")) : false;
   const node = {
     path: seg,
     fullPath: collapseSlashes2(fullPath) || "/",
@@ -52427,7 +52655,7 @@ function scanDirectory(rootDir, dir, parentPath, options) {
     standalone: isStandalone ? true : void 0
   };
   for (const entry of entries) {
-    const entryPath = join15(dir, entry);
+    const entryPath = join16(dir, entry);
     let entryStat;
     try {
       entryStat = statSync12(entryPath);
@@ -52479,19 +52707,19 @@ function collectSources(tree) {
   function walk9(nodes) {
     for (const node of nodes) {
       if (node.page)
-        map.set(node.page, join15(node.sourceDir, "page.vsk"));
+        map.set(node.page, join16(node.sourceDir, "page.vsk"));
       if (node.layout)
-        map.set(node.layout, join15(node.sourceDir, "layout.vsk"));
+        map.set(node.layout, join16(node.sourceDir, "layout.vsk"));
       if (node.loading)
-        map.set(node.loading, join15(node.sourceDir, "loading.vsk"));
+        map.set(node.loading, join16(node.sourceDir, "loading.vsk"));
       if (node.error)
-        map.set(node.error, join15(node.sourceDir, "error.vsk"));
+        map.set(node.error, join16(node.sourceDir, "error.vsk"));
       if (node.notFound)
-        map.set(node.notFound, join15(node.sourceDir, "not-found.vsk"));
+        map.set(node.notFound, join16(node.sourceDir, "not-found.vsk"));
       if (node.offline)
-        map.set(node.offline, join15(node.sourceDir, "offline.vsk"));
+        map.set(node.offline, join16(node.sourceDir, "offline.vsk"));
       if (node.network)
-        map.set(node.network, join15(node.sourceDir, "network.vsk"));
+        map.set(node.network, join16(node.sourceDir, "network.vsk"));
       walk9(node.children);
     }
   }
@@ -52593,9 +52821,9 @@ function matchUrl(tree, pathname) {
 
 // ../compiler/dist/api-routes.js
 import { readdirSync as readdirSync8, statSync as statSync13, existsSync as existsSync24 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 init_server_utils();
-function basename4(p) {
+function basename5(p) {
   const idx = p.lastIndexOf("/");
   return idx === -1 ? p : p.slice(idx + 1);
 }
@@ -52621,7 +52849,7 @@ function scanApiDir(rootDir, dir, parentPath) {
       break;
     }
   }
-  const segName = basename4(dir);
+  const segName = basename5(dir);
   const isDynamic = segName.startsWith("[") && segName.endsWith("]") && !segName.startsWith("[...");
   const isCatchAll = segName.startsWith("[...") && segName.endsWith("]");
   const isPrivate = segName.startsWith("_");
@@ -52630,7 +52858,7 @@ function scanApiDir(rootDir, dir, parentPath) {
     return nodes;
   if (isRouteGroup) {
     for (const entry of entries) {
-      const entryPath = join16(dir, entry);
+      const entryPath = join17(dir, entry);
       let entryStat;
       try {
         entryStat = statSync13(entryPath);
@@ -52660,11 +52888,11 @@ function scanApiDir(rootDir, dir, parentPath) {
     fullPath: collapseSlashes(fullPath) || "/",
     isDynamic,
     isCatchAll,
-    filePath: hasRoute && routeFileName ? join16(dir, routeFileName) : null,
+    filePath: hasRoute && routeFileName ? join17(dir, routeFileName) : null,
     children: []
   };
   for (const entry of entries) {
-    const entryPath = join16(dir, entry);
+    const entryPath = join17(dir, entry);
     let entryStat;
     try {
       entryStat = statSync13(entryPath);
@@ -53194,11 +53422,11 @@ async function executeMiddlewareChain(chain, request, params, options = {}) {
 
 // ../compiler/dist/events.js
 import { existsSync as existsSync26 } from "fs";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 var EVENTS_FILE_NAMES2 = ["_events.ts", "_events.js"];
 function collectEventsFile2(appDir) {
   for (const name of EVENTS_FILE_NAMES2) {
-    const candidate = join17(appDir, name);
+    const candidate = join18(appDir, name);
     if (existsSync26(candidate))
       return candidate;
   }
@@ -53230,7 +53458,7 @@ async function runEventHandlers(handlers, name, ctx2) {
 
 // ../compiler/dist/md-inline.js
 import { readFileSync as readFileSync23, existsSync as existsSync27 } from "node:fs";
-import { dirname as dirname17, join as join18, resolve as resolve23 } from "node:path";
+import { dirname as dirname17, join as join19, resolve as resolve23 } from "node:path";
 var MD_EXT_MARKER2 = ".md";
 function looksLikeMarkdownPath2(value) {
   const v = value.trim();
@@ -53307,10 +53535,10 @@ function resolveMdPath2(specifier, importerDir, roots) {
   }
   if (spec.startsWith("/")) {
     for (const root3 of roots) {
-      const pub = join18(root3, "public", spec);
+      const pub = join19(root3, "public", spec);
       if (existsSync27(pub))
         return pub;
-      const direct = join18(root3, spec);
+      const direct = join19(root3, spec);
       if (existsSync27(direct))
         return direct;
     }
@@ -53324,7 +53552,7 @@ function guessProjectRoots2(dir) {
   let cur = dir;
   for (let i = 0; i < 6; i++) {
     roots.push(cur);
-    if (existsSync27(join18(cur, "package.json")))
+    if (existsSync27(join19(cur, "package.json")))
       break;
     const parent = dirname17(cur);
     if (parent === cur)
@@ -53336,7 +53564,7 @@ function guessProjectRoots2(dir) {
 
 // ../adapter/dist/client-bundle.js
 import { readFileSync as readFileSync24, existsSync as existsSync28, writeFileSync as writeFileSync13, unlinkSync as unlinkSync4, statSync as statSync14, rmSync as rmSync4, mkdtempSync as mkdtempSync2, mkdirSync as mkdirSync12 } from "node:fs";
-import { resolve as resolve24, join as join19, dirname as dirname18, relative as relative6, sep as sep3 } from "node:path";
+import { resolve as resolve24, join as join20, dirname as dirname18, relative as relative6, sep as sep3 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { tmpdir as tmpdir3 } from "node:os";
 
@@ -53419,8 +53647,8 @@ function findRuntimeSrc3(appDir) {
     resolve24(appDir, "node_modules", "@vesk/runtime")
   ];
   for (const base of candidates) {
-    for (const dir of [base, join19(base, "dist")]) {
-      if (existsSync28(join19(dir, "index-client.js")))
+    for (const dir of [base, join20(base, "dist")]) {
+      if (existsSync28(join20(dir, "index-client.js")))
         return dir;
     }
   }
@@ -54036,9 +54264,11 @@ async function generateClientBundle2(routeTree, appDir, componentMap, options) {
     }, annotate2 = function(nodes) {
       for (const node of nodes) {
         const chunkName = `page-${buildChunkName(node)}.js`;
-        const hasEntry = chunkEntries.some((e) => e.name === chunkName && e.code.trim());
-        if (hasEntry)
-          node.chunk = `/_vesk/static/${chunkName}`;
+        const emitted = chunks.find((c) => c.name === chunkName && c.code.trim());
+        if (emitted) {
+          const fileName = options?.hmr ? chunkName : hashedName(chunkName, emitted.code);
+          node.chunk = `/_vesk/static/${fileName}`;
+        }
         annotate2(node.children || []);
       }
     };
@@ -54070,8 +54300,8 @@ ${body}
         continue;
       let finalCode;
       if (entry.imports) {
-        const tmpBase = mkdtempSync2(join19(resolve24(appDir, ".."), "tmp-vesk-chunk-"));
-        const tmpFile = join19(tmpBase, "entry.js");
+        const tmpBase = mkdtempSync2(join20(resolve24(appDir, ".."), "tmp-vesk-chunk-"));
+        const tmpFile = join20(tmpBase, "entry.js");
         const toBundle = `const __components = globalThis.__components || (globalThis.__components = {});
 const __hydrators = globalThis.__hydrators || (globalThis.__hydrators = {});
 ${entry.code}
@@ -54223,7 +54453,7 @@ function buildRuntimeCode2(runtimeDir) {
   ];
   let code = "";
   for (const f of runtimeFiles) {
-    const p = join19(runtimeDir, f);
+    const p = join20(runtimeDir, f);
     if (existsSync28(p)) {
       let src2 = readFileSync24(p, "utf-8");
       src2 = stripTypes2(src2);
@@ -54237,7 +54467,7 @@ ${src2}
 `;
     }
   }
-  const indexSrc = readFileSync24(join19(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync24(join20(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)]) {
@@ -54248,7 +54478,7 @@ ${src2}
   return code;
 }
 function runtimeExportNames2(runtimeDir) {
-  const indexSrc = readFileSync24(join19(runtimeDir, "index-client.js"), "utf-8");
+  const indexSrc = readFileSync24(join20(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(",")) {
@@ -54264,7 +54494,7 @@ function esbuildPath2(p) {
   return sep3 === "/" ? p : p.split(sep3).join("/");
 }
 function runtimeTreeShakeEntry2() {
-  return join19(tmpdir3(), "vesk-runtime-tree-shake", RUNTIME_ENTRY2);
+  return join20(tmpdir3(), "vesk-runtime-tree-shake", RUNTIME_ENTRY2);
 }
 var treeShakeQueue2 = Promise.resolve();
 function buildTreeShakenRuntime2(runtimeDir, usedNames) {
@@ -54281,7 +54511,7 @@ async function buildTreeShakenRuntimeNow2(runtimeDir, usedNames) {
     return buildRuntimeCode2(runtimeDir);
   }
   const entry = runtimeTreeShakeEntry2();
-  const indexClient = esbuildPath2(join19(runtimeDir, "index-client.js"));
+  const indexClient = esbuildPath2(join20(runtimeDir, "index-client.js"));
   try {
     try {
       mkdirSync12(dirname18(entry), { recursive: true });
@@ -54520,7 +54750,7 @@ import { resolve as resolve28 } from "node:path";
 // ../adapter/dist/plugins.js
 init_paths();
 import { readFileSync as readFileSync26, writeFileSync as writeFileSync14, existsSync as existsSync30, mkdirSync as mkdirSync13, statSync as statSync16 } from "node:fs";
-import { resolve as resolve26, dirname as dirname19, join as join20, extname as extname7, basename as basename5 } from "node:path";
+import { resolve as resolve26, dirname as dirname19, join as join21, extname as extname7, basename as basename6 } from "node:path";
 import { createRequire as createRequire6 } from "node:module";
 import { spawn as spawn2 } from "node:child_process";
 var PLUGIN_STATE_FILENAME2 = "plugins.json";
@@ -54580,13 +54810,13 @@ function resolvePackage2(appDir, pkg) {
       const seen = /* @__PURE__ */ new Set();
       while (cur && cur !== dirname19(cur) && !seen.has(cur)) {
         seen.add(cur);
-        const candidate = join20(cur, "package.json");
+        const candidate = join21(cur, "package.json");
         if (existsSync30(candidate)) {
           pkgJsonPath = candidate;
           break;
         }
         const parent = dirname19(cur);
-        if (parent !== cur && basename5(cur) === "node_modules")
+        if (parent !== cur && basename6(cur) === "node_modules")
           break;
         cur = parent;
       }
@@ -54609,7 +54839,7 @@ function resolvePackage2(appDir, pkg) {
     }
   }
   if (localPath) {
-    const localJson = join20(localPath, "package.json");
+    const localJson = join21(localPath, "package.json");
     let json = null;
     if (existsSync30(localJson)) {
       json = readJsonFile2(localJson);
@@ -55497,7 +55727,7 @@ var __internals2 = {
 // ../adapter/dist/dev-config.js
 import { existsSync as existsSync31, readFileSync as readFileSync27, writeFileSync as writeFileSync15, mkdirSync as mkdirSync14, mkdtempSync as mkdtempSync3, rmSync as rmSync5 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { resolve as resolve27, dirname as dirname20, join as join21 } from "node:path";
+import { resolve as resolve27, dirname as dirname20, join as join22 } from "node:path";
 init_parser();
 function findConfigFile2(projectDir) {
   const ts9 = resolve27(projectDir, "vesk.config.ts");
@@ -55525,9 +55755,9 @@ async function parseConfigSource(source, isTs, projectDir) {
     js = `const { defineConfig, definePlugin, preset } = globalThis.__vesk_inject;
 ` + js;
   }
-  const base = projectDir ? (mkdirSync14(join21(projectDir, ".vesk"), { recursive: true }), join21(projectDir, ".vesk")) : void 0;
-  const dir = base ? mkdtempSync3(join21(base, "cfg-")) : mkdtempSync3(join21(tmpdir4(), "vesk-cfg-"));
-  const tmpFile = join21(dir, "config.mjs");
+  const base = projectDir ? (mkdirSync14(join22(projectDir, ".vesk"), { recursive: true }), join22(projectDir, ".vesk")) : void 0;
+  const dir = base ? mkdtempSync3(join22(base, "cfg-")) : mkdtempSync3(join22(tmpdir4(), "vesk-cfg-"));
+  const tmpFile = join22(dir, "config.mjs");
   try {
     writeFileSync15(tmpFile, js, "utf-8");
     globalThis.__vesk_inject = {
@@ -56837,7 +57067,7 @@ function produceDiagnostics(input) {
 
 // ../agentic/dist/checkpoints.js
 import { existsSync as existsSync33, mkdirSync as mkdirSync15, readFileSync as readFileSync29, writeFileSync as writeFileSync16, statSync as statSync18, unlinkSync as unlinkSync5, rmSync as rmSync6, renameSync } from "node:fs";
-import { join as join22, resolve as resolve29, dirname as dirname21, sep as sep5 } from "node:path";
+import { join as join23, resolve as resolve29, dirname as dirname21, sep as sep5 } from "node:path";
 import { randomUUID as nodeRandomUUID } from "node:crypto";
 function generateId() {
   try {
@@ -56970,16 +57200,16 @@ var CheckpointManager = class {
   }
 };
 function getAgenticDir(projectDir) {
-  return join22(resolve29(projectDir), ".vesk", "agentic");
+  return join23(resolve29(projectDir), ".vesk", "agentic");
 }
 function getHistoryPath(projectDir) {
-  return join22(getAgenticDir(projectDir), "history.json");
+  return join23(getAgenticDir(projectDir), "history.json");
 }
 function getCheckpointDir(projectDir, id) {
-  return join22(getAgenticDir(projectDir), "checkpoints", id);
+  return join23(getAgenticDir(projectDir), "checkpoints", id);
 }
 function getCheckpointPath(projectDir, id) {
-  return join22(getCheckpointDir(projectDir, id), "checkpoint.json");
+  return join23(getCheckpointDir(projectDir, id), "checkpoint.json");
 }
 function ensureDir(dir) {
   mkdirSync15(dir, { recursive: true });
@@ -57059,7 +57289,7 @@ function createCheckpoint(projectDir, message, changes = {}, buildResult) {
   };
   const agenticDir = getAgenticDir(projectDir);
   ensureDir(agenticDir);
-  ensureDir(join22(agenticDir, "checkpoints"));
+  ensureDir(join23(agenticDir, "checkpoints"));
   const cpDir = getCheckpointDir(projectDir, id);
   ensureDir(cpDir);
   writeJsonAtomic(getCheckpointPath(projectDir, id), checkpoint);
@@ -58564,7 +58794,7 @@ var Agent = class {
 
 // ../agentic/dist/tools/vesk.js
 import { existsSync as existsSync36, readFileSync as readFileSync32, writeFileSync as writeFileSync18, mkdirSync as mkdirSync17, readdirSync as readdirSync10, statSync as statSync19 } from "node:fs";
-import { resolve as resolve32, join as join23, dirname as dirname23, sep as sep6 } from "node:path";
+import { resolve as resolve32, join as join24, dirname as dirname23, sep as sep6 } from "node:path";
 function resolveWithin3(baseDir, relPath) {
   const base = resolve32(baseDir);
   const target = resolve32(baseDir, relPath);
@@ -58626,7 +58856,7 @@ function findConfigFile3(projectDir) {
   return { path: null, isTs: false };
 }
 function checkpointDir(veskDir) {
-  return join23(resolve32(veskDir), "checkpoints");
+  return join24(resolve32(veskDir), "checkpoints");
 }
 function findMatchingBrace2(src2, openIdx) {
   let inStr = null;
@@ -59241,7 +59471,7 @@ function createVeskTools(deps) {
           const dir = checkpointDir(veskDir);
           mkdirSync17(dir, { recursive: true });
           const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-          const file = join23(dir, `${id}.json`);
+          const file = join24(dir, `${id}.json`);
           const check = resolveWithin3(dir, `${id}.json`);
           if (!check)
             return jsonError("path escapes project root");
@@ -59290,7 +59520,7 @@ function createVeskTools(deps) {
           } catch {
           }
           const dir = checkpointDir(veskDir);
-          const file = join23(dir, `${checkpointId}.json`);
+          const file = join24(dir, `${checkpointId}.json`);
           const contained = resolveWithin3(dir, `${checkpointId}.json`);
           if (!contained)
             return jsonError("path escapes project root");
@@ -60013,7 +60243,7 @@ function renderDevErrorPage(payload, opts) {
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { cpSync as cpSync2, existsSync as existsSync40, mkdirSync as mkdirSync18, readFileSync as readFileSync36, readdirSync as readdirSync11, statSync as statSync20, writeFileSync as writeFileSync20 } from "node:fs";
 import { createRequire as createRequire7 } from "node:module";
-import { dirname as dirname25, join as join24, resolve as resolve36 } from "node:path";
+import { dirname as dirname25, join as join25, resolve as resolve36 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 var require2 = createRequire7(import.meta.url);
 var __dirname9 = dirname25(fileURLToPath8(import.meta.url));
@@ -60037,12 +60267,14 @@ var PACKAGES = {
   // vesk.config.ts imports them, so their dist must exist for e2e/dev
   // servers on fresh checkouts (CI).
   "plugin-pwa": { name: "@vesk/plugin-pwa", entry: "index" },
-  "plugin-tailwind": { name: "@vesk/plugin-tailwind", entry: "index" }
+  "plugin-tailwind": { name: "@vesk/plugin-tailwind", entry: "index" },
+  // testing last — it depends on the compiler.
+  testing: { name: "@vesk/testing", entry: "index" }
 };
 function newestSourceMtime(srcDir) {
   let newest = 0;
   for (const name of readdirSync11(srcDir)) {
-    const p = join24(srcDir, name);
+    const p = join25(srcDir, name);
     const st = statSync20(p);
     if (st.isDirectory()) {
       newest = Math.max(newest, newestSourceMtime(p));
@@ -60053,11 +60285,11 @@ function newestSourceMtime(srcDir) {
   return newest;
 }
 function distStale(pkgDir, entry) {
-  const distIndex = join24(pkgDir, "dist", `${entry}.js`);
+  const distIndex = join25(pkgDir, "dist", `${entry}.js`);
   if (!existsSync40(distIndex)) return true;
-  const distPkg = join24(pkgDir, "dist", "package.json");
+  const distPkg = join25(pkgDir, "dist", "package.json");
   const distStamp = Math.max(statSync20(distIndex).mtimeMs, existsSync40(distPkg) ? statSync20(distPkg).mtimeMs : 0);
-  return newestSourceMtime(join24(pkgDir, "src")) > distStamp;
+  return newestSourceMtime(join25(pkgDir, "src")) > distStamp;
 }
 function distPackageJson(pkgName, entry, serverEntry, version2) {
   const exports = {
@@ -60081,23 +60313,23 @@ function distPackageJson(pkgName, entry, serverEntry, version2) {
 function buildPackages(force = false) {
   for (const [pkg, cfg] of Object.entries(PACKAGES)) {
     const pkgDir = resolve36(root2, "packages", pkg);
-    if (!existsSync40(join24(pkgDir, "src"))) continue;
+    if (!existsSync40(join25(pkgDir, "src"))) continue;
     if (!force && !distStale(pkgDir, cfg.entry)) continue;
     console.log(`[build] ${cfg.name} -> tsc`);
     const tscBin = require2.resolve("typescript/bin/tsc");
-    const result = spawnSync2(process.execPath, [tscBin, "-p", join24(pkgDir, "tsconfig.build.json")], {
+    const result = spawnSync2(process.execPath, [tscBin, "-p", join25(pkgDir, "tsconfig.build.json")], {
       stdio: "inherit"
     });
     if (result.status !== 0) {
       throw new Error(`tsc failed for ${cfg.name}`);
     }
-    const distDir = join24(pkgDir, "dist");
+    const distDir = join25(pkgDir, "dist");
     for (const c of cfg.copy || []) {
-      const to = join24(distDir, c.to);
+      const to = join25(distDir, c.to);
       mkdirSync18(dirname25(to), { recursive: true });
-      cpSync2(join24(pkgDir, c.from), to, { recursive: true });
+      cpSync2(join25(pkgDir, c.from), to, { recursive: true });
     }
-    const srcPkg = JSON.parse(readFileSync36(join24(pkgDir, "package.json"), "utf-8"));
+    const srcPkg = JSON.parse(readFileSync36(join25(pkgDir, "package.json"), "utf-8"));
     if (pkg === "lucide-vesk") {
       const lucideDistPkg = {
         name: srcPkg.name,
@@ -60111,9 +60343,9 @@ function buildPackages(force = false) {
           "./package.json": "./package.json"
         }
       };
-      writeFileSync20(join24(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
+      writeFileSync20(join25(distDir, "package.json"), JSON.stringify(lucideDistPkg, null, 2) + "\n");
     } else {
-      writeFileSync20(join24(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
+      writeFileSync20(join25(distDir, "package.json"), distPackageJson(cfg.name, cfg.entry, cfg.serverEntry, srcPkg.version || "1.0.0"));
     }
     console.log(`[build] ${cfg.name} -> dist`);
   }
@@ -60590,9 +60822,9 @@ function resolveRuntimeDir(projectDir) {
     resolve38(import.meta.dirname ?? ".", "..", "..", "runtime", "dist")
   ];
   for (const dir of candidates) {
-    if (existsSync42(join25(dir, "ripple-runtime.js"))) return dir;
-    const distDir = join25(dir, "dist");
-    if (existsSync42(join25(distDir, "ripple-runtime.js"))) return distDir;
+    if (existsSync42(join26(dir, "ripple-runtime.js"))) return dir;
+    const distDir = join26(dir, "dist");
+    if (existsSync42(join26(distDir, "ripple-runtime.js"))) return distDir;
   }
   return null;
 }
@@ -60832,7 +61064,7 @@ function countFilesNamed(dir, name) {
   if (!existsSync42(dir)) return 0;
   let n = 0;
   for (const entry of readdirSync13(dir, { withFileTypes: true })) {
-    const p = join25(dir, entry.name);
+    const p = join26(dir, entry.name);
     if (entry.isDirectory()) n += countFilesNamed(p, name);
     else if (entry.name === name) n++;
   }
@@ -60875,7 +61107,7 @@ async function startDevServer(port, projectDir, config, host) {
     process.exit(1);
   }
   const runtimeDir = runtimeDirUnchecked;
-  const veskStateDir = join25(projectDir, ".vesk");
+  const veskStateDir = join26(projectDir, ".vesk");
   const configPluginsRaw = config.plugins || [];
   const configPluginNames = configPluginsRaw.map((p) => typeof p === "string" ? p : p?.name).filter((n) => !!n);
   const rawDevPlugins = config.plugins || [];
@@ -60974,10 +61206,10 @@ async function startDevServer(port, projectDir, config, host) {
   }
   let devGlobalCssContent = "";
   let lastServedCssGlobal = "";
-  const appCssPath = join25(appDirPath, "global.css");
-  const srcDir = join25(projectDir, "src");
-  const cssPath = join25(srcDir, "global.css");
-  const altCssPath = join25(srcDir, "app.css");
+  const appCssPath = join26(appDirPath, "global.css");
+  const srcDir = join26(projectDir, "src");
+  const cssPath = join26(srcDir, "global.css");
+  const altCssPath = join26(srcDir, "app.css");
   let rawCss = "";
   let devCssSource = "";
   if (existsSync42(appCssPath)) {
@@ -61264,7 +61496,7 @@ async function startDevServer(port, projectDir, config, host) {
       if (!filename) return;
       const kind = classifyHmrWatchPath(filename);
       if (kind === "ignored") return;
-      const fullPath = filename.startsWith("/") ? filename : join25(watchDir, filename);
+      const fullPath = filename.startsWith("/") ? filename : join26(watchDir, filename);
       const fileExists = existsSync42(fullPath);
       const bcast = (msg) => {
         const f = globalThis.__vesk_broadcastHmr;
@@ -61479,8 +61711,8 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
     ".json": "application/json",
     ".webmanifest": "application/manifest+json"
   };
-  const hmrJsPath = join25(runtimeDir, "hmr-client.js");
-  const hmrTsPath = join25(runtimeDir, "hmr-client.ts");
+  const hmrJsPath = join26(runtimeDir, "hmr-client.js");
+  const hmrTsPath = join26(runtimeDir, "hmr-client.ts");
   const hmrClientPath = existsSync42(hmrJsPath) ? hmrJsPath : existsSync42(hmrTsPath) ? hmrTsPath : null;
   function extractCompName2(src2) {
     return resolveComponentName(src2);
@@ -61652,7 +61884,7 @@ Object.defineProperty(__components, ${JSON.stringify(cname)}, { get: () => __com
       return;
     }
     const mwChain = collectMiddlewareChain(routeTree, url.pathname, appDirPath);
-    const apiDirPath = join25(appDirPath, "api");
+    const apiDirPath = join26(appDirPath, "api");
     if (url.pathname.startsWith("/api") && existsSync42(apiDirPath)) {
       const apiRoutes = await scanApiRoutes(apiDirPath);
       const apiMatch = matchApiUrl(apiRoutes, req.url || url.pathname);
@@ -62144,7 +62376,7 @@ ${prettifyHtml(body)}
     LOG.ok(`dev server at http://localhost:${port} (listening on ${bindHost})`);
     const routes = collectRoutePaths(routeTree);
     const pageCount = countPages(routeTree);
-    const apiCount = countFilesNamed(join25(appDirPath, "api"), "route.ts");
+    const apiCount = countFilesNamed(join26(appDirPath, "api"), "route.ts");
     LOG.info(`${projectDir}`);
     LOG.info(`${pageCount} page${pageCount === 1 ? "" : "s"}: ${routes.join(", ") || "(none)"}`);
     if (apiCount > 0) LOG.info(`${apiCount} api route${apiCount === 1 ? "" : "s"} (app/api)`);
@@ -62458,8 +62690,8 @@ if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
 }
 function loadEnvFiles(projectDir) {
   const files = [
-    join29(projectDir, ".env"),
-    join29(projectDir, ".env.local")
+    join30(projectDir, ".env"),
+    join30(projectDir, ".env.local")
   ];
   for (const filePath of files) {
     if (!existsSync45(filePath)) continue;
@@ -62630,7 +62862,7 @@ if (cmd === "start") {
 if (cmd === "init") {
   const projectDir = process.cwd();
   const { appDir: appDirPath } = resolveProjectDirs(projectDir, await loadConfig(projectDir) || {});
-  const target = join29(appDirPath, "global.css");
+  const target = join30(appDirPath, "global.css");
   if (existsSync45(target)) {
     console.error(`vesk init: ${target} already exists \u2014 skipping`);
     process.exit(0);
@@ -62651,7 +62883,7 @@ if (cmd === "migrate") {
   const projectDir = process.cwd();
   const { runMigrate: runMigrate2 } = await Promise.resolve().then(() => (init_migrate(), migrate_exports));
   const { CODEMODS: CODEMODS2 } = await Promise.resolve().then(() => (init_codemods(), codemods_exports));
-  const { version: cliVersion } = JSON.parse(readFileSync42(join29(__dirname10, "..", "package.json"), "utf-8"));
+  const { version: cliVersion } = JSON.parse(readFileSync42(join30(__dirname10, "..", "package.json"), "utf-8"));
   if (args.includes("--list")) {
     console.error("vesk migrate: available codemods");
     for (const c of CODEMODS2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesk/vesk-cli",
-  "version": "0.2.50-canary.2",
+  "version": "0.2.50-canary.4",
   "type": "module",
   "description": "Vesk — compiler-first framework for the post-VDOM web. vesk dev, vesk build.",
   "bin": {
@@ -8,10 +8,10 @@
   },
   "main": "./dist/cli.js",
   "dependencies": {
-    "@vesk/adapter": "^0.2.50-canary.2",
-    "@vesk/compiler": "^0.2.50-canary.2",
-    "@vesk/plugin-tailwind": "^0.2.50-canary.2",
-    "@vesk/runtime": "^0.2.50-canary.2",
+    "@vesk/adapter": "^0.2.50-canary.4",
+    "@vesk/compiler": "^0.2.50-canary.4",
+    "@vesk/plugin-tailwind": "^0.2.50-canary.4",
+    "@vesk/runtime": "^0.2.50-canary.4",
     "esrap": "^2.3.0",
     "typescript": "^5.8.0",
     "ws": "^8.18.0",