@vesk/vesk-cli 0.2.50-canary.3 → 0.2.50-canary.5

package/dist/cli.js

@@ -399,6 +399,13 @@ var init_ir = __esm({
       importedNames;
       staticProps;
       loadFn;
+      /**
+       * Source of `export const metadata = defineMetadata({...})`, when present.
+       * Static by construction: evaluated with only `defineMetadata` in scope, at
+       * build time where possible and in a sealed sandbox at request time
+       * otherwise, so the head never depends on the component's frame.
+       */
+      metadataSource;
       topLevelCode;
       /**
        * Same-file specifier exports (`export { A }`, `export { A as B }`) as
@@ -1966,8 +1973,16 @@ function writeCache(key, data2) {
   const entry = getClientCache().get(key);
   if (!entry || entry.data !== data2) getClientCache().set(key, { data: data2, fetchedAt: Date.now() });
 }
-function trackSsrPromise(promise) {
+function trackSsrPromise(promise, defer = false) {
   const tk = g().__vsk_ssr_token || "";
+  if (defer) {
+    const deferredKey = tk ? `__vsk_ssr_deferred_${tk}` : "__vsk_ssr_deferred";
+    if (!g()[deferredKey]) g()[deferredKey] = [];
+    g()[deferredKey].push(promise);
+    promise.then(void 0, () => {
+    });
+    return;
+  }
   const promisesKey = tk ? `__vsk_ssr_promises_${tk}` : "__vsk_ssr_promises";
   if (!g()[promisesKey]) g()[promisesKey] = [];
   g()[promisesKey].push(promise);
@@ -2034,7 +2049,7 @@ function startRequest(handle2, skipCache) {
     } else {
       attachSettle(handle2, prom2);
     }
-    trackSsrPromise(prom2);
+    trackSsrPromise(prom2, options.ssr === "defer");
     return prom2;
   }
   if (!skipCache && options.staleTime && options.staleTime > 0) {
@@ -19480,6 +19495,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 +19562,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 +19663,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 {
       }
@@ -21186,6 +21307,7 @@ function generateIR(ast, source, filename) {
   const importedNames = /* @__PURE__ */ new Set();
   let staticProps = null;
   let loadFn = null;
+  let metadataSource = null;
   const topLevelCode = [];
   const exportAliases = [];
   const reexportSources = [];
@@ -21221,6 +21343,14 @@ function generateIR(ast, source, filename) {
           continue;
         }
       }
+      if (node.type === "ExportNamedDeclaration" && node.declaration && !metadataSource) {
+        const decl = node.declaration;
+        const first = decl.type === "VariableDeclaration" ? decl.declarations[0] : null;
+        if (first?.id?.name === "metadata") {
+          metadataSource = first.init ? stripCodeTypes(getSource(source, first.init)) : null;
+          continue;
+        }
+      }
       if (node.type === "ExportNamedDeclaration" && node.declaration && !loadFn) {
         const decl = node.declaration;
         const fnName = decl.type === "FunctionDeclaration" ? decl.id?.name : decl.type === "VariableDeclaration" ? decl.declarations[0]?.id?.name : null;
@@ -21437,7 +21567,9 @@ function generateIR(ast, source, filename) {
         imports.push(`import { ${missing.join(", ")} } from '@vesk/runtime';`);
       }
     }
-    return new IRRoot(components, imports, importedNames, staticProps, loadFn, topLevelCode, exportAliases, reexportSources);
+    const irRoot = new IRRoot(components, imports, importedNames, staticProps, loadFn, topLevelCode, exportAliases, reexportSources);
+    irRoot.metadataSource = metadataSource;
+    return irRoot;
   } finally {
     currentVskNamespaceLocals = prevNamespaceLocals;
     currentSourceFile = prevSourceFile;
@@ -22635,18 +22767,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;
   }
@@ -26508,6 +26640,177 @@ var init_action = __esm({
   }
 });
 
+// ../runtime/src/metadata.ts
+function assertPlainObject(value, where) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`defineMetadata: ${where} must be a plain object, got ${Array.isArray(value) ? "an array" : typeof value}`);
+  }
+  return value;
+}
+function defineMetadata(input) {
+  const meta = assertPlainObject(input, "the argument");
+  if ("title" in meta && meta.title !== void 0) {
+    if (typeof meta.title !== "string" && typeof meta.title !== "object") {
+      throw new Error("defineMetadata: `title` must be a string or { default, template }");
+    }
+    if (typeof meta.title === "object") {
+      const t = assertPlainObject(meta.title, "`title`");
+      for (const key of Object.keys(t)) {
+        if (key !== "default" && key !== "template" && key !== "absolute") {
+          throw new Error(`defineMetadata: unknown \`title.${key}\` (expected default, template or absolute)`);
+        }
+      }
+    }
+  }
+  if ("description" in meta && meta.description !== void 0 && typeof meta.description !== "string") {
+    throw new Error("defineMetadata: `description` must be a string");
+  }
+  for (const key of ["openGraph", "twitter"]) {
+    if (key in meta && meta[key] !== void 0) assertPlainObject(meta[key], `\`${key}\``);
+  }
+  if ("alternates" in meta && meta.alternates !== void 0) {
+    const alt = assertPlainObject(meta.alternates, "`alternates`");
+    for (const key of Object.keys(alt)) {
+      if (key !== "canonical" && key !== "languages") {
+        throw new Error(`defineMetadata: unknown \`alternates.${key}\` (expected canonical or languages)`);
+      }
+    }
+  }
+  for (const key of Object.keys(meta)) {
+    if (!KNOWN_KEYS.has(key)) {
+      throw new Error(
+        `defineMetadata: unknown key "${key}". Known keys: ${[...KNOWN_KEYS].join(", ")}. (\`openGraph\` carries og:* tags, not top-level \`ogTitle\`.)`
+      );
+    }
+  }
+  return meta;
+}
+function resolveTitle(meta, child) {
+  if (!meta || meta.title === void 0 || meta.title === null) return null;
+  if (typeof meta.title === "string") return meta.title;
+  if (meta.title.absolute) return meta.title.absolute;
+  if (meta.title.default) return meta.title.default;
+  if (meta.title.template && child) {
+    const childTitle = resolveTitle(child);
+    return childTitle === null ? null : meta.title.template.replace("%s", childTitle);
+  }
+  return null;
+}
+function mergeMetadata(...sources) {
+  const out = {};
+  let template;
+  let sawTemplate = false;
+  for (const source of sources) {
+    if (!source) continue;
+    for (const [key, value] of Object.entries(source)) {
+      if (value === void 0) continue;
+      if (key === "openGraph" || key === "twitter") {
+        out[key] = { ...out[key] || {}, ...value };
+        continue;
+      }
+      if (key === "title") {
+        if (value && typeof value === "object" && value.template) {
+          sawTemplate = true;
+          template = value.template || template;
+        }
+        out.title = value;
+        continue;
+      }
+      out[key] = value;
+    }
+  }
+  if (sawTemplate && out.title !== void 0) {
+    const own = out.title;
+    if (typeof own === "string") out.title = { absolute: own };
+    else if (own && typeof own === "object" && own.template) {
+      out.title = { default: own.default, template: own.template || template };
+    } else if (own && typeof own === "object") {
+      out.title = { ...own, template };
+    }
+  }
+  return out;
+}
+function escapeAttr2(value) {
+  return String(value).split("&").join("&amp;").split("<").join("&lt;").split(">").join("&gt;").split('"').join("&quot;");
+}
+function escapeText(value) {
+  return String(value).split("&").join("&amp;").split("<").join("&lt;").split(">").join("&gt;");
+}
+function metadataToHtml(meta, opts = {}) {
+  if (!meta) return "";
+  const lines = [];
+  const title = resolveTitle(meta, opts.child);
+  if (title !== null) lines.push(`<title data-vesk-head>${escapeText(title)}</title>`);
+  if (typeof meta.description === "string" && meta.description.length > 0) {
+    lines.push(`<meta name="description" content="${escapeAttr2(meta.description)}" data-vesk-head />`);
+  }
+  if (meta.robots) {
+    const content = typeof meta.robots === "string" ? meta.robots : Object.entries(meta.robots).filter(([, on]) => on).map(([k]) => k).join(", ");
+    if (content) lines.push(`<meta name="robots" content="${escapeAttr2(content)}" data-vesk-head />`);
+  }
+  if (meta.themeColor) {
+    lines.push(`<meta name="theme-color" content="${escapeAttr2(meta.themeColor)}" data-vesk-head />`);
+  }
+  const og = meta.openGraph;
+  if (og) {
+    const ogTitle = resolveTitle(og) ?? title;
+    const ogFields = [
+      ["og:title", ogTitle],
+      ["og:description", og.description ?? meta.description],
+      ["og:url", og.url],
+      ["og:site_name", og.siteName],
+      ["og:image", og.image],
+      ["og:type", og.type]
+    ];
+    for (const [prop, value] of ogFields) {
+      if (value === void 0 || value === null || value === "") continue;
+      lines.push(`<meta property="${prop}" content="${escapeAttr2(value)}" data-vesk-head />`);
+    }
+  }
+  const tw = meta.twitter;
+  if (tw) {
+    const twFields = [
+      ["twitter:card", tw.card],
+      ["twitter:site", tw.site],
+      ["twitter:title", resolveTitle(tw) ?? title],
+      ["twitter:description", tw.description ?? meta.description],
+      ["twitter:image", tw.image]
+    ];
+    for (const [name, value] of twFields) {
+      if (value === void 0 || value === null || value === "") continue;
+      lines.push(`<meta name="${name}" content="${escapeAttr2(value)}" data-vesk-head />`);
+    }
+  }
+  const alt = meta.alternates;
+  if (alt) {
+    if (typeof alt === "object" && typeof alt.canonical === "string") {
+      lines.push(`<link rel="canonical" href="${escapeAttr2(alt.canonical)}" data-vesk-head />`);
+    }
+    const languages = alt.languages;
+    if (languages && typeof languages === "object") {
+      for (const [lang, href] of Object.entries(languages)) {
+        lines.push(`<link rel="alternate" hreflang="${escapeAttr2(lang)}" href="${escapeAttr2(href)}" data-vesk-head />`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+var KNOWN_KEYS;
+var init_metadata = __esm({
+  "../runtime/src/metadata.ts"() {
+    "use strict";
+    KNOWN_KEYS = /* @__PURE__ */ new Set([
+      "title",
+      "description",
+      "robots",
+      "openGraph",
+      "twitter",
+      "alternates",
+      "themeColor"
+    ]);
+  }
+});
+
 // ../runtime/src/index-server.ts
 var index_server_exports = {};
 __export(index_server_exports, {
@@ -26569,6 +26872,7 @@ __export(index_server_exports, {
   custom: () => custom,
   defineAction: () => defineAction,
   defineHook: () => defineHook,
+  defineMetadata: () => defineMetadata,
   defineRoute: () => defineRoute,
   derived: () => derived,
   destroy_block: () => destroy_block,
@@ -26596,6 +26900,8 @@ __export(index_server_exports, {
   leaf: () => leaf,
   locals: () => locals,
   maxLength: () => maxLength,
+  mergeMetadata: () => mergeMetadata,
+  metadataToHtml: () => metadataToHtml,
   minLength: () => minLength,
   mutate: () => mutate,
   notFound: () => notFound,
@@ -26616,6 +26922,7 @@ __export(index_server_exports, {
   required: () => required,
   rerenderNode: () => rerenderNode,
   resolveSsrResources: () => resolveSsrResources,
+  resolveTitle: () => resolveTitle,
   resume_block: () => resume_block,
   revalidateComponent: () => revalidateComponent,
   revalidatePath: () => revalidatePath,
@@ -26680,6 +26987,7 @@ var init_index_server = __esm({
     init_primitive();
     init_loading_indicator();
     init_action();
+    init_metadata();
   }
 });
 
@@ -31304,6 +31612,17 @@ function irNodeToHeadHtml(node, ctx2, reconcileable = false) {
   }
   return "";
 }
+function renderStaticMetadataHtml(source) {
+  if (!source) return "";
+  try {
+    const fn = new Function("defineMetadata", "return (" + source + ")");
+    const meta = fn(defineMetadata);
+    return metadataToHtml(meta);
+  } catch (e) {
+    console.error("vesk: static metadata could not be evaluated:", e instanceof Error ? e.message : e);
+    return "";
+  }
+}
 function renderHeadHtml(comp, props = {}, scope2 = {}) {
   const tracked2 = collectTrackedNames(comp.body);
   const needed = headNeededNames(comp);
@@ -31471,6 +31790,7 @@ var init_server_head = __esm({
     init_scan();
     init_parser();
     init_client_codegen();
+    init_metadata();
     headRuntimeShims = () => ({
       track: (init) => headCell(init),
       derived: (fn) => headCell(typeof fn === "function" ? fn() : fn),
@@ -32138,6 +32458,7 @@ function compileFile(source, options) {
   const owners = new VskComponentOwners();
   const result = compileFileInternal(source, options?.sourcePath, /* @__PURE__ */ new Set(), owners);
   owners.report("SSR");
+  result.metadataSource = result.ir.metadataSource || null;
   return result;
 }
 function compileFileInternal(source, sourcePath2, seenImportFiles, owners) {
@@ -32240,6 +32561,7 @@ function renderPage(source, componentName, props = {}, registry = /* @__PURE__ *
   if (!renderFn) throw new Error(`Component "${componentName}" not found in source`);
   const fullRegistry = new Map([...registry, ...componentMap]);
   const targetComp = ir.components.find((c) => c.name === componentName);
+  const metadataSource = ir.metadataSource || null;
   const doRender = (ssrProps) => {
     globalThis.__vsk_ssr = true;
     if (!globalThis.__vsk_ssr_token) globalThis.__vsk_ssr_token = Math.random().toString(36).slice(2);
@@ -32258,9 +32580,11 @@ function renderPage(source, componentName, props = {}, registry = /* @__PURE__ *
         }
         return {
           body: bodyHtml2,
-          // The component's own scope, so head expressions that read an import
-          // resolve (see renderHeadHtml).
-          head: renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk)),
+          // A static `export const metadata` wins: it is evaluated in a sealed
+          // sandbox, so it cannot depend on the component's frame resolving
+          // (the failure mode that shipped an empty <title>). Whatever the
+          // page's `<Head>` adds is appended, not lost.
+          head: [renderStaticMetadataHtml(metadataSource), renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk))].filter(Boolean).join("\n"),
           props: ssrProps
         };
       })();
@@ -32271,7 +32595,10 @@ function renderPage(source, componentName, props = {}, registry = /* @__PURE__ *
     } finally {
       delete globalThis.__vsk_ssr;
     }
-    const headHtml = targetComp ? renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk)) : "";
+    const headHtml = [
+      renderStaticMetadataHtml(metadataSource),
+      targetComp ? renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk)) : ""
+    ].filter(Boolean).join("\n");
     const pending = globalThis[`__vsk_ssr_promises_${renderToken}`];
     if (pending && pending.length > 0) {
       return (async () => {
@@ -32301,6 +32628,7 @@ function renderPage(source, componentName, props = {}, registry = /* @__PURE__ *
 function clearSsrCells(token) {
   if (!token) return;
   delete globalThis[`__vsk_ssr_promises_${token}`];
+  delete globalThis[`__vsk_ssr_deferred_${token}`];
   delete globalThis[`__vsk_ssr_failures_${token}`];
   dropSsrSlot(token);
   const cells = globalThis.__vsk_ssr_cells;
@@ -32573,6 +32901,7 @@ function renderPageStream(source, componentName, props = {}, registry = /* @__PU
     if (!renderFn) throw new Error(`Component "${componentName}" not found in source`);
     resetVskState(!!options.hydrate, options.markerless !== false);
     const targetComp = ir.components.find((c) => c.name === componentName);
+    const metadataSource = cached?.metadataSource ?? ir.metadataSource ?? null;
     const cssUrls = options.cssUrls || (options.cssUrl ? [options.cssUrl] : []);
     const cssLink = cssUrls.map((u) => `	<link rel="stylesheet" href="${u}" />
 `).join("");
@@ -32586,7 +32915,10 @@ function renderPageStream(source, componentName, props = {}, registry = /* @__PU
     }
     let streamHeadHtml = null;
     if (targetComp) {
-      let headHtml = renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk));
+      let headHtml = [
+        renderStaticMetadataHtml(metadataSource),
+        renderHeadHtml(targetComp, ssrProps, scopedVesk(renderFn, __vesk))
+      ].filter(Boolean).join("\n");
       if (options.pageHead) {
         const merged = mergeHeadHtml(options.pageHead, headHtml);
         headHtml = merged.html;
@@ -39227,7 +39559,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 +39572,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 +39627,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 +39698,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 +39710,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 +39721,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 +39768,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 +39807,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 +45754,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 +45774,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 +45904,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 +45927,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 +45962,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 +46008,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 +46587,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 basename3 } 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
@@ -46551,6 +46883,7 @@ function precompileFileInternal(source, sourcePath2, seenImportFiles) {
     setVskHydrate(false);
   }
   const topLevelCode = transformTopLevelForActions(ir.topLevelCode, "server");
+  const metadataSource = ir.metadataSource || null;
   const runtimeImports = ir.imports.slice();
   const collector = { keysByAbs: /* @__PURE__ */ new Map(), modules: [] };
   const bindings = sourcePath2 !== void 0 ? collectModuleBundle(ir.imports, dirname6(sourcePath2), collector) : [];
@@ -46578,7 +46911,10 @@ function precompileFileInternal(source, sourcePath2, seenImportFiles) {
     modules: collector.modules,
     bindings,
     topLevelCode,
-    subFiles
+    subFiles,
+    // A static `export const metadata` rides along so a serverless function can
+    // serialize the head without the `.vsk` source being present at all.
+    ...metadataSource ? { metadataSource } : {}
   };
 }
 
@@ -47541,14 +47877,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;",
     "}",
@@ -47589,16 +47928,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],
@@ -48668,6 +49017,38 @@ import { resolve as resolve13, extname as extname3, dirname as dirname10, basena
 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
@@ -49191,6 +49572,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)) {
@@ -49255,6 +49646,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");
@@ -49559,6 +49953,9 @@ 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 },
@@ -49613,7 +50010,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";
 
@@ -52263,7 +52660,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 basename4 } from "path";
+import { join as join16, relative as relative5, basename as basename4 } from "path";
 function collapseSlashes2(p) {
   let out = "";
   let prevSlash = false;
@@ -52366,7 +52763,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);
@@ -52467,7 +52864,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) || "/",
@@ -52488,7 +52885,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);
@@ -52540,19 +52937,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);
     }
   }
@@ -52654,7 +53051,7 @@ 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 basename5(p) {
   const idx = p.lastIndexOf("/");
@@ -52691,7 +53088,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);
@@ -52721,11 +53118,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);
@@ -53255,11 +53652,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;
   }
@@ -53291,7 +53688,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();
@@ -53368,10 +53765,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;
     }
@@ -53385,7 +53782,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)
@@ -53397,7 +53794,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";
 
@@ -53480,8 +53877,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;
     }
   }
@@ -54133,8 +54530,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}
@@ -54286,7 +54683,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);
@@ -54300,7 +54697,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)]) {
@@ -54311,7 +54708,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(",")) {
@@ -54327,7 +54724,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) {
@@ -54344,7 +54741,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 });
@@ -54583,7 +54980,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 basename6 } 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";
@@ -54643,7 +55040,7 @@ 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;
@@ -54672,7 +55069,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);
@@ -55560,7 +55957,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");
@@ -55588,9 +55985,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 = {
@@ -56900,7 +57297,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 {
@@ -57033,16 +57430,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 });
@@ -57122,7 +57519,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);
@@ -58627,7 +59024,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);
@@ -58689,7 +59086,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;
@@ -59304,7 +59701,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");
@@ -59353,7 +59750,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");
@@ -60076,7 +60473,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));
@@ -60100,12 +60497,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));
@@ -60116,11 +60515,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 = {
@@ -60144,23 +60543,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,
@@ -60174,9 +60573,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`);
   }
@@ -60653,9 +61052,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;
 }
@@ -60895,7 +61294,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++;
   }
@@ -60938,7 +61337,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 || [];
@@ -61037,10 +61436,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)) {
@@ -61327,7 +61726,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;
@@ -61542,8 +61941,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);
@@ -61715,7 +62114,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);
@@ -62207,7 +62606,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)`);
@@ -62365,6 +62764,7 @@ __export(index_server_exports2, {
   custom: () => custom,
   defineAction: () => defineAction,
   defineHook: () => defineHook,
+  defineMetadata: () => defineMetadata,
   defineRoute: () => defineRoute,
   derived: () => derived,
   destroy_block: () => destroy_block,
@@ -62392,6 +62792,8 @@ __export(index_server_exports2, {
   leaf: () => leaf,
   locals: () => locals,
   maxLength: () => maxLength,
+  mergeMetadata: () => mergeMetadata,
+  metadataToHtml: () => metadataToHtml,
   minLength: () => minLength,
   mutate: () => mutate,
   notFound: () => notFound,
@@ -62412,6 +62814,7 @@ __export(index_server_exports2, {
   required: () => required,
   rerenderNode: () => rerenderNode,
   resolveSsrResources: () => resolveSsrResources,
+  resolveTitle: () => resolveTitle,
   resume_block: () => resume_block,
   revalidateComponent: () => revalidateComponent,
   revalidatePath: () => revalidatePath,
@@ -62473,6 +62876,7 @@ init_headless();
 init_primitive();
 init_loading_indicator();
 init_action();
+init_metadata();
 
 // src/index.ts
 var __filename2 = fileURLToPath9(import.meta.url);
@@ -62521,8 +62925,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;
@@ -62693,7 +63097,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);
@@ -62714,7 +63118,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) {