@vertz/ui-server 0.2.21 → 0.2.23

package/dist/bun-dev-server.d.ts

@@ -72,6 +72,16 @@ interface BunDevServerOptions {
 	* optionally `window.__VERTZ_ACCESS_SET__` for instant auth hydration.
 	*/
 	sessionResolver?: SessionResolver;
+	/**
+	* Watch workspace-linked package dist directories for changes.
+	* When a dist directory changes, automatically restart the server.
+	*
+	* Accepts an array of package names (e.g., ['@vertz/theme-shadcn', '@vertz/ui'])
+	* or `true` to auto-detect all `@vertz/*` packages linked via workspace symlinks.
+	*
+	* @default false
+	*/
+	watchDeps?: boolean | string[];
 }
 interface ErrorDetail {
 	message: string;

package/dist/bun-dev-server.js

@@ -9,7 +9,7 @@ import {
 
 // src/bun-dev-server.ts
 import { execSync } from "child_process";
-import { existsSync, mkdirSync, readFileSync as readFileSync2, watch, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, watch as watch2, writeFileSync as writeFileSync2 } from "fs";
 import { dirname, normalize, resolve } from "path";
 
 // src/debug-logger.ts
@@ -286,6 +286,7 @@ function runWithScopedFetch(interceptor, fn) {
 }
 
 // src/font-metrics.ts
+import { access as fsAccess } from "fs/promises";
 import { readFile } from "fs/promises";
 import { join as join2 } from "path";
 import { fromBuffer } from "@capsizecss/unpack";
@@ -354,9 +355,15 @@ function getPrimarySrcPath(descriptor) {
     return first.path;
   return null;
 }
-function resolveFilePath(urlPath, rootDir) {
+async function resolveFilePath(urlPath, rootDir) {
   const cleaned = urlPath.startsWith("/") ? urlPath.slice(1) : urlPath;
-  return join2(rootDir, cleaned);
+  const direct = join2(rootDir, cleaned);
+  try {
+    await fsAccess(direct);
+    return direct;
+  } catch {
+    return join2(rootDir, "public", cleaned);
+  }
 }
 async function extractFontMetrics(fonts, rootDir) {
   const result = {};
@@ -370,7 +377,7 @@ async function extractFontMetrics(fonts, rootDir) {
     if (!srcPath.toLowerCase().endsWith(".woff2"))
       continue;
     try {
-      const filePath = resolveFilePath(srcPath, rootDir);
+      const filePath = await resolveFilePath(srcPath, rootDir);
       const buffer = await readFile(filePath);
       const metrics = await fromBuffer(buffer);
       const fallbackFont = typeof adjustFontFallback === "string" ? adjustFontFallback : detectFallbackFont(descriptor.fallback);
@@ -891,6 +898,96 @@ class SSRElement extends SSRNode {
   get innerHTML() {
     return this._innerHTML ?? "";
   }
+  get placeholder() {
+    return this.attrs.placeholder ?? "";
+  }
+  set placeholder(value) {
+    this.attrs.placeholder = value;
+  }
+  get type() {
+    return this.attrs.type ?? "";
+  }
+  set type(value) {
+    this.attrs.type = value;
+  }
+  get name() {
+    return this.attrs.name ?? "";
+  }
+  set name(value) {
+    this.attrs.name = value;
+  }
+  get value() {
+    return this.attrs.value ?? "";
+  }
+  set value(value) {
+    this.attrs.value = value;
+  }
+  get src() {
+    return this.attrs.src ?? "";
+  }
+  set src(value) {
+    this.attrs.src = value;
+  }
+  get alt() {
+    return this.attrs.alt ?? "";
+  }
+  set alt(value) {
+    this.attrs.alt = value;
+  }
+  get htmlFor() {
+    return this.attrs.for ?? "";
+  }
+  set htmlFor(value) {
+    this.attrs.for = value;
+  }
+  get disabled() {
+    return "disabled" in this.attrs;
+  }
+  set disabled(value) {
+    if (value) {
+      this.attrs.disabled = "";
+    } else {
+      delete this.attrs.disabled;
+    }
+  }
+  get checked() {
+    return "checked" in this.attrs;
+  }
+  set checked(value) {
+    if (value) {
+      this.attrs.checked = "";
+    } else {
+      delete this.attrs.checked;
+    }
+  }
+  get selected() {
+    return "selected" in this.attrs;
+  }
+  set selected(value) {
+    if (value) {
+      this.attrs.selected = "";
+    } else {
+      delete this.attrs.selected;
+    }
+  }
+  get rows() {
+    return Number(this.attrs.rows) || 0;
+  }
+  set rows(value) {
+    this.attrs.rows = String(value);
+  }
+  get scope() {
+    return this.attrs.scope ?? "";
+  }
+  set scope(value) {
+    this.attrs.scope = value;
+  }
+  get href() {
+    return this.attrs.href ?? "";
+  }
+  set href(value) {
+    this.attrs.href = value;
+  }
   addEventListener(_event, _handler) {}
   removeEventListener(_event, _handler) {}
   toVNode() {
@@ -1524,15 +1621,95 @@ function escapeAttr3(s) {
   return s.replace(/[&"'<>]/g, (c) => `&#${c.charCodeAt(0)};`);
 }
 
+// src/upstream-watcher.ts
+import { existsSync, lstatSync, readdirSync, realpathSync, watch } from "fs";
+import { join as join3 } from "path";
+function resolveWorkspacePackages(projectRoot, filter) {
+  const results = [];
+  const packageNames = filter === true ? discoverVertzPackages(projectRoot) : parsePackageNames(filter);
+  for (const { scope, name } of packageNames) {
+    const nmPath = join3(projectRoot, "node_modules", scope, name);
+    if (!existsSync(nmPath))
+      continue;
+    const stat = lstatSync(nmPath);
+    if (!stat.isSymbolicLink())
+      continue;
+    const realPath = realpathSync(nmPath);
+    const distPath = join3(realPath, "dist");
+    if (!existsSync(distPath))
+      continue;
+    const fullName = scope ? `${scope}/${name}` : name;
+    results.push({ name: fullName, distPath });
+  }
+  return results;
+}
+function discoverVertzPackages(projectRoot) {
+  const scopeDir = join3(projectRoot, "node_modules", "@vertz");
+  if (!existsSync(scopeDir))
+    return [];
+  return readdirSync(scopeDir).filter((entry) => !entry.startsWith(".")).map((entry) => ({ scope: "@vertz", name: entry }));
+}
+function parsePackageNames(names) {
+  return names.map((pkg) => {
+    const match = pkg.match(/^(@[^/]+)\/(.+)$/);
+    if (match?.[1] && match[2])
+      return { scope: match[1], name: match[2] };
+    return { scope: "", name: pkg };
+  });
+}
+function createUpstreamWatcher(options) {
+  const { projectRoot, watchDeps, onDistChanged, debounceMs = 1000, persistent = false } = options;
+  const packages = resolveWorkspacePackages(projectRoot, watchDeps);
+  const watchers = [];
+  const debounceTimers = new Map;
+  let closed = false;
+  for (const pkg of packages) {
+    try {
+      const watcher = watch(pkg.distPath, { recursive: true, persistent }, () => {
+        if (closed)
+          return;
+        const existing = debounceTimers.get(pkg.name);
+        if (existing)
+          clearTimeout(existing);
+        debounceTimers.set(pkg.name, setTimeout(() => {
+          debounceTimers.delete(pkg.name);
+          if (!closed) {
+            onDistChanged(pkg.name);
+          }
+        }, debounceMs));
+      });
+      watcher.on("error", () => {});
+      watchers.push(watcher);
+    } catch {}
+  }
+  return {
+    packages,
+    close() {
+      closed = true;
+      for (const w of watchers) {
+        try {
+          w.close();
+        } catch {}
+      }
+      watchers.length = 0;
+      for (const timer of debounceTimers.values()) {
+        clearTimeout(timer);
+      }
+      debounceTimers.clear();
+    }
+  };
+}
+
 // src/bun-dev-server.ts
 function detectFaviconTag(projectRoot) {
   const faviconPath = resolve(projectRoot, "public", "favicon.svg");
-  return existsSync(faviconPath) ? '<link rel="icon" type="image/svg+xml" href="/favicon.svg">' : "";
+  return existsSync2(faviconPath) ? '<link rel="icon" type="image/svg+xml" href="/favicon.svg">' : "";
 }
 var STALE_GRAPH_PATTERNS = [
   /Export named ['"].*['"] not found in module/i,
   /No matching export in ['"].*['"] for import/i,
-  /does not provide an export named/i
+  /does not provide an export named/i,
+  /Failed to resolve module specifier/i
 ];
 function isStaleGraphError(message) {
   return STALE_GRAPH_PATTERNS.some((pattern) => pattern.test(message));
@@ -1632,7 +1809,7 @@ function buildErrorChannelScript(editor) {
     "V._hadClientError=false;",
     "V._needsReload=false;",
     "V._restarting=false;",
-    `V.isStaleGraph=function(m){return/Export named ['"].*['"] not found in module/i.test(m)||/No matching export in ['"].*['"] for import/i.test(m)||/does not provide an export named/i.test(m)};`,
+    `V.isStaleGraph=function(m){return/Export named ['"].*['"] not found in module/i.test(m)||/No matching export in ['"].*['"] for import/i.test(m)||/does not provide an export named/i.test(m)||/Failed to resolve module specifier/i.test(m)};`,
     "V._canAutoRestart=function(){",
     "var raw=sessionStorage.getItem('__vertz_auto_restart');",
     "var ts;try{ts=raw?JSON.parse(raw):[]}catch(e){ts=[]}",
@@ -1904,7 +2081,8 @@ function createBunDevServer(options) {
     logRequests = true,
     editor: editorOption,
     headTags: headTagsOption = "",
-    sessionResolver
+    sessionResolver,
+    watchDeps
   } = options;
   const faviconTag = detectFaviconTag(projectRoot);
   const headTags = [faviconTag, headTagsOption].filter(Boolean).join(`
@@ -2136,7 +2314,7 @@ function createBunDevServer(options) {
     }
   };
   const setupOpenAPIWatcher = () => {
-    if (!openapi || !existsSync(openapi.specPath))
+    if (!openapi || !existsSync2(openapi.specPath))
       return;
     cachedSpec = loadOpenAPISpec();
     if (cachedSpec === null)
@@ -2144,7 +2322,7 @@ function createBunDevServer(options) {
     try {
       const specDir = dirname(openapi.specPath);
       const specFile = openapi.specPath.split("/").pop() || "openapi.json";
-      specWatcher = watch(specDir, { persistent: false }, (eventType, filename) => {
+      specWatcher = watch2(specDir, { persistent: false }, (eventType, filename) => {
         if (filename === specFile && (eventType === "change" || eventType === "rename")) {
           if (logRequests) {
             console.log("[Server] OpenAPI spec file changed, reloading...");
@@ -2162,7 +2340,7 @@ function createBunDevServer(options) {
         headers: { "Content-Type": "application/json" }
       });
     }
-    if (openapi && existsSync(openapi.specPath)) {
+    if (openapi && existsSync2(openapi.specPath)) {
       cachedSpec = loadOpenAPISpec();
       if (cachedSpec) {
         return new Response(JSON.stringify(cachedSpec), {
@@ -2175,6 +2353,42 @@ function createBunDevServer(options) {
   let isRestarting = false;
   let pluginsRegistered = false;
   let stableUpdateManifest = null;
+  let upstreamWatcherRef = null;
+  let pendingDistRestart = false;
+  let restartFn = null;
+  if (watchDeps) {
+    upstreamWatcherRef = createUpstreamWatcher({
+      projectRoot,
+      watchDeps,
+      onDistChanged: (pkgName) => {
+        if (!restartFn || stopped)
+          return;
+        if (logRequests) {
+          console.log(`[Server] Upstream package rebuilt: ${pkgName} \u2014 restarting...`);
+        }
+        if (isRestarting) {
+          pendingDistRestart = true;
+          return;
+        }
+        restartFn().then(() => {
+          if (pendingDistRestart && restartFn && !stopped) {
+            pendingDistRestart = false;
+            restartFn().catch((err) => {
+              const msg = err instanceof Error ? err.message : String(err);
+              console.error(`[Server] Pending upstream restart failed: ${msg}`);
+            });
+          }
+        }).catch((err) => {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.error(`[Server] Upstream restart failed: ${msg}`);
+        });
+      }
+    });
+    if (logRequests && upstreamWatcherRef.packages.length > 0) {
+      const names = upstreamWatcherRef.packages.map((p) => p.name).join(", ");
+      console.log(`[Server] Watching upstream packages: ${names}`);
+    }
+  }
   async function start() {
     const { plugin } = await Promise.resolve(globalThis.Bun);
     const { createVertzBunPlugin } = await import("./bun-plugin/index.js");
@@ -2640,8 +2854,8 @@ data: {}
     }
     const srcDir = resolve(projectRoot, "src");
     stopped = false;
-    if (existsSync(srcDir)) {
-      srcWatcherRef = watch(srcDir, { recursive: true }, (_event, filename) => {
+    if (existsSync2(srcDir)) {
+      srcWatcherRef = watch2(srcDir, { recursive: true }, (_event, filename) => {
         if (!filename)
           return;
         if (refreshTimeout)
@@ -2800,6 +3014,10 @@ data: {}
         server.stop(true);
         server = null;
       }
+      if (upstreamWatcherRef) {
+        upstreamWatcherRef.close();
+        upstreamWatcherRef = null;
+      }
     },
     async restart() {
       if (isRestarting) {
@@ -2859,6 +3077,7 @@ data: {}
       isRestarting = false;
     }
   };
+  restartFn = () => devServer.restart();
   return devServer;
 }
 export {

package/dist/dom-shim/index.d.ts

@@ -84,6 +84,32 @@ declare class SSRElement extends SSRNode {
 	get textContent(): string | null;
 	set innerHTML(value: string);
 	get innerHTML(): string;
+	get placeholder(): string;
+	set placeholder(value: string);
+	get type(): string;
+	set type(value: string);
+	get name(): string;
+	set name(value: string);
+	get value(): string;
+	set value(value: string);
+	get src(): string;
+	set src(value: string);
+	get alt(): string;
+	set alt(value: string);
+	get htmlFor(): string;
+	set htmlFor(value: string);
+	get disabled(): boolean;
+	set disabled(value: boolean);
+	get checked(): boolean;
+	set checked(value: boolean);
+	get selected(): boolean;
+	set selected(value: boolean);
+	get rows(): number;
+	set rows(value: number);
+	get scope(): string;
+	set scope(value: string);
+	get href(): string;
+	set href(value: string);
 	addEventListener(_event: string, _handler: any): void;
 	removeEventListener(_event: string, _handler: any): void;
 	/** Convert to a VNode tree for @vertz/ui-server */

package/dist/dom-shim/index.js

@@ -7,7 +7,7 @@ import {
   installDomShim,
   removeDomShim,
   toVNode
-} from "../shared/chunk-8matma4a.js";
+} from "../shared/chunk-bm16zy8d.js";
 export {
   toVNode,
   removeDomShim,

package/dist/index.d.ts

@@ -80,6 +80,7 @@ declare function renderAssetTags(assets: AssetDescriptor[]): string;
 * Returns an empty string if the CSS is empty.
 */
 declare function inlineCriticalCss(css: string): string;
+import { FallbackFontName as FallbackFontName2, FontFallbackMetrics as FontFallbackMetrics5 } from "@vertz/ui";
 import { FallbackFontName, FontDescriptor, FontFallbackMetrics } from "@vertz/ui";
 /**
 * Auto-detect which system font to use as fallback base.
@@ -589,4 +590,4 @@ declare function collectStreamChunks(stream: ReadableStream<Uint8Array>): Promis
 * @param nonce - Optional CSP nonce to add to the inline script tag.
 */
 declare function createTemplateChunk(slotId: number, resolvedHtml: string, nonce?: string): string;
-export { wrapWithHydrationMarkers, streamToString, ssrStorage, ssrRenderToString, ssrDiscoverQueries, setGlobalSSRTimeout, serializeToHtml, safeSerialize, resetSlotCounter, renderToStream, renderToHTMLStream, renderToHTML, renderPage, renderHeadToHtml, renderAssetTags, registerSSRQuery, rawHtml, isInSSR, inlineCriticalCss, getStreamingRuntimeScript, getSSRUrl, getSSRQueries, getGlobalSSRTimeout, getAccessSetForSSR, generateSSRHtml, extractFontMetrics, encodeChunk, detectFallbackFont, createTemplateChunk, createSlotPlaceholder, createSessionScript, createSSRHandler, createSSRDataChunk, createSSRAdapter, createAccessSetScript, collectStreamChunks, clearGlobalSSRTimeout, VNode, SessionResolver, SessionData, SSRSessionInfo, SSRRenderResult, SSRQueryEntry2 as SSRQueryEntry, SSRModule, SSRHandlerOptions, SSRDiscoverResult, RenderToStreamOptions, RenderToHTMLStreamOptions, RenderToHTMLOptions, RawHtml, PageOptions, HydrationOptions, HeadEntry, HeadCollector, GenerateSSRHtmlOptions, AssetDescriptor };
+export { wrapWithHydrationMarkers, streamToString, ssrStorage, ssrRenderToString, ssrDiscoverQueries, setGlobalSSRTimeout, serializeToHtml, safeSerialize, resetSlotCounter, renderToStream, renderToHTMLStream, renderToHTML, renderPage, renderHeadToHtml, renderAssetTags, registerSSRQuery, rawHtml, isInSSR, inlineCriticalCss, getStreamingRuntimeScript, getSSRUrl, getSSRQueries, getGlobalSSRTimeout, getAccessSetForSSR, generateSSRHtml, extractFontMetrics, encodeChunk, detectFallbackFont, createTemplateChunk, createSlotPlaceholder, createSessionScript, createSSRHandler, createSSRDataChunk, createSSRAdapter, createAccessSetScript, collectStreamChunks, clearGlobalSSRTimeout, VNode, SessionResolver, SessionData, SSRSessionInfo, SSRRenderResult, SSRQueryEntry2 as SSRQueryEntry, SSRModule, SSRHandlerOptions, SSRDiscoverResult, RenderToStreamOptions, RenderToHTMLStreamOptions, RenderToHTMLOptions, RawHtml, PageOptions, HydrationOptions, HeadEntry, HeadCollector, GenerateSSRHtmlOptions, FontFallbackMetrics5 as FontFallbackMetrics, FallbackFontName2 as FallbackFontName, AssetDescriptor };

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   ssrDiscoverQueries,
   ssrRenderToString,
   streamToString
-} from "./shared/chunk-vyjj02de.js";
+} from "./shared/chunk-5cny4vzm.js";
 import {
   clearGlobalSSRTimeout,
   createSSRAdapter,
@@ -31,7 +31,7 @@ import {
   registerSSRQuery,
   setGlobalSSRTimeout,
   ssrStorage
-} from "./shared/chunk-8matma4a.js";
+} from "./shared/chunk-bm16zy8d.js";
 
 // src/asset-pipeline.ts
 function renderAssetTags(assets) {
@@ -59,6 +59,7 @@ function inlineCriticalCss(css) {
   return `<style>${safeCss}</style>`;
 }
 // src/font-metrics.ts
+import { access as fsAccess } from "node:fs/promises";
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { fromBuffer } from "@capsizecss/unpack";
@@ -127,9 +128,15 @@ function getPrimarySrcPath(descriptor) {
     return first.path;
   return null;
 }
-function resolveFilePath(urlPath, rootDir) {
+async function resolveFilePath(urlPath, rootDir) {
   const cleaned = urlPath.startsWith("/") ? urlPath.slice(1) : urlPath;
-  return join(rootDir, cleaned);
+  const direct = join(rootDir, cleaned);
+  try {
+    await fsAccess(direct);
+    return direct;
+  } catch {
+    return join(rootDir, "public", cleaned);
+  }
 }
 async function extractFontMetrics(fonts, rootDir) {
   const result = {};
@@ -143,7 +150,7 @@ async function extractFontMetrics(fonts, rootDir) {
     if (!srcPath.toLowerCase().endsWith(".woff2"))
       continue;
     try {
-      const filePath = resolveFilePath(srcPath, rootDir);
+      const filePath = await resolveFilePath(srcPath, rootDir);
       const buffer = await readFile(filePath);
       const metrics = await fromBuffer(buffer);
       const fallbackFont = typeof adjustFontFallback === "string" ? adjustFontFallback : detectFallbackFont(descriptor.fallback);

package/dist/shared/{chunk-vyjj02de.js → chunk-5cny4vzm.js}

@@ -6,7 +6,7 @@ import {
   setGlobalSSRTimeout,
   ssrStorage,
   toVNode
-} from "./chunk-8matma4a.js";
+} from "./chunk-bm16zy8d.js";
 
 // src/html-serializer.ts
 var VOID_ELEMENTS = new Set([

package/dist/shared/{chunk-8matma4a.js → chunk-bm16zy8d.js}

@@ -341,6 +341,96 @@ class SSRElement extends SSRNode {
   get innerHTML() {
     return this._innerHTML ?? "";
   }
+  get placeholder() {
+    return this.attrs.placeholder ?? "";
+  }
+  set placeholder(value) {
+    this.attrs.placeholder = value;
+  }
+  get type() {
+    return this.attrs.type ?? "";
+  }
+  set type(value) {
+    this.attrs.type = value;
+  }
+  get name() {
+    return this.attrs.name ?? "";
+  }
+  set name(value) {
+    this.attrs.name = value;
+  }
+  get value() {
+    return this.attrs.value ?? "";
+  }
+  set value(value) {
+    this.attrs.value = value;
+  }
+  get src() {
+    return this.attrs.src ?? "";
+  }
+  set src(value) {
+    this.attrs.src = value;
+  }
+  get alt() {
+    return this.attrs.alt ?? "";
+  }
+  set alt(value) {
+    this.attrs.alt = value;
+  }
+  get htmlFor() {
+    return this.attrs.for ?? "";
+  }
+  set htmlFor(value) {
+    this.attrs.for = value;
+  }
+  get disabled() {
+    return "disabled" in this.attrs;
+  }
+  set disabled(value) {
+    if (value) {
+      this.attrs.disabled = "";
+    } else {
+      delete this.attrs.disabled;
+    }
+  }
+  get checked() {
+    return "checked" in this.attrs;
+  }
+  set checked(value) {
+    if (value) {
+      this.attrs.checked = "";
+    } else {
+      delete this.attrs.checked;
+    }
+  }
+  get selected() {
+    return "selected" in this.attrs;
+  }
+  set selected(value) {
+    if (value) {
+      this.attrs.selected = "";
+    } else {
+      delete this.attrs.selected;
+    }
+  }
+  get rows() {
+    return Number(this.attrs.rows) || 0;
+  }
+  set rows(value) {
+    this.attrs.rows = String(value);
+  }
+  get scope() {
+    return this.attrs.scope ?? "";
+  }
+  set scope(value) {
+    this.attrs.scope = value;
+  }
+  get href() {
+    return this.attrs.href ?? "";
+  }
+  set href(value) {
+    this.attrs.href = value;
+  }
   addEventListener(_event, _handler) {}
   removeEventListener(_event, _handler) {}
   toVNode() {

package/dist/ssr/index.d.ts

@@ -1,4 +1,4 @@
-import { CompiledRoute as CompiledRoute2 } from "@vertz/ui";
+import { CompiledRoute as CompiledRoute2, FontFallbackMetrics as FontFallbackMetrics2 } from "@vertz/ui";
 import { CompiledRoute, FontFallbackMetrics, Theme } from "@vertz/ui";
 import { SSRAuth as SSRAuth_jq1nwm } from "@vertz/ui/internals";
 interface SSRModule {
@@ -76,6 +76,8 @@ interface PrerenderOptions {
 	routes: string[];
 	/** CSP nonce for inline scripts. */
 	nonce?: string;
+	/** Pre-computed font fallback metrics for zero-CLS font loading. */
+	fallbackMetrics?: Record<string, FontFallbackMetrics2>;
 }
 /**
 * Discover all route patterns from an SSR module.
@@ -124,7 +126,7 @@ declare function stripScriptsFromStaticHTML(html: string): string;
 * - Routes without `prerender` or `generateParams` are not collected
 */
 declare function collectPrerenderPaths(routes: CompiledRoute2[], prefix?: string): Promise<string[]>;
-import { FontFallbackMetrics as FontFallbackMetrics2 } from "@vertz/ui";
+import { FontFallbackMetrics as FontFallbackMetrics3 } from "@vertz/ui";
 import { AccessSet } from "@vertz/ui/auth";
 interface SessionData {
 	user: {
@@ -178,7 +180,7 @@ interface SSRHandlerOptions {
 	*/
 	nonce?: string;
 	/** Pre-computed font fallback metrics (computed at server startup). */
-	fallbackMetrics?: Record<string, FontFallbackMetrics2>;
+	fallbackMetrics?: Record<string, FontFallbackMetrics3>;
 	/** Paths to inject as `<link rel="modulepreload">` in `<head>`. */
 	modulepreload?: string[];
 	/**

package/dist/ssr/index.js

@@ -3,8 +3,8 @@ import {
   injectIntoTemplate,
   ssrDiscoverQueries,
   ssrRenderToString
-} from "../shared/chunk-vyjj02de.js";
-import"../shared/chunk-8matma4a.js";
+} from "../shared/chunk-5cny4vzm.js";
+import"../shared/chunk-bm16zy8d.js";
 
 // src/prerender.ts
 async function discoverRoutes(module) {
@@ -28,7 +28,9 @@ async function prerenderRoutes(module, template, options) {
   for (const routePath of options.routes) {
     let renderResult;
     try {
-      renderResult = await ssrRenderToString(module, routePath);
+      renderResult = await ssrRenderToString(module, routePath, {
+        fallbackMetrics: options.fallbackMetrics
+      });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw new Error(`Pre-render failed for ${routePath}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui-server",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "type": "module",
   "license": "MIT",
   "description": "Vertz UI server-side rendering runtime",
@@ -58,16 +58,16 @@
     "@ampproject/remapping": "^2.3.0",
     "@capsizecss/unpack": "^4.0.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@vertz/core": "^0.2.20",
-    "@vertz/ui": "^0.2.20",
-    "@vertz/ui-compiler": "^0.2.20",
+    "@vertz/core": "^0.2.22",
+    "@vertz/ui": "^0.2.22",
+    "@vertz/ui-compiler": "^0.2.22",
     "magic-string": "^0.30.0",
     "sharp": "^0.34.5",
     "ts-morph": "^27.0.2"
   },
   "devDependencies": {
-    "@vertz/codegen": "^0.2.20",
-    "@vertz/ui-auth": "^0.2.18",
+    "@vertz/codegen": "^0.2.22",
+    "@vertz/ui-auth": "^0.2.19",
     "bun-types": "^1.3.10",
     "bunup": "^0.16.31",
     "@happy-dom/global-registrator": "^20.8.3",