veryfront 0.1.127 → 0.1.129

package/esm/src/data/static-data-fetcher.js

@@ -34,7 +34,7 @@ function releaseRevalidationSlot(projectId) {
     }
     projectRevalidationCounts.set(projectId, current - 1);
 }
-function getProjectId(context, fallback) {
+function resolveProjectId(context, fallback) {
     return context.request?.headers?.get("x-project-id") ?? context.url?.hostname ?? fallback;
 }
 export class StaticDataFetcher {
@@ -44,13 +44,14 @@ export class StaticDataFetcher {
         this.cacheManager = cacheManager;
     }
     async fetch(pageModule, context) {
-        if (typeof pageModule.getStaticData !== "function")
+        const getStaticData = pageModule.getStaticData;
+        if (typeof getStaticData !== "function")
             return { props: {} };
         const pathname = context.url?.pathname ?? "unknown";
         const cacheKey = this.cacheManager.createCacheKey(context);
         // No caching in preview mode (cacheKey is null)
         if (!cacheKey) {
-            return withSpan("data.fetch_static", () => this.fetchFreshNoCache(pageModule, context), {
+            return withSpan("data.fetch_static", () => this.fetchFreshNoCache(getStaticData, context), {
                 "data.fetch_method": "getStaticData",
                 "data.pathname": pathname,
                 "data.cache": "disabled",
@@ -58,22 +59,35 @@ export class StaticDataFetcher {
         }
         const cached = await withSpan(SpanNames.DATA_CACHE_GET, () => Promise.resolve(this.cacheManager.get(cacheKey)), { "data.cache_key": cacheKey, "data.pathname": pathname });
         if (!cached) {
-            return withSpan("data.fetch_static", () => this.fetchFresh(pageModule, context, cacheKey), {
+            return withSpan("data.fetch_static", () => this.fetchFresh(getStaticData, context, cacheKey), {
                 "data.fetch_method": "getStaticData",
                 "data.pathname": pathname,
                 "data.cache": "miss",
             });
         }
         if (this.cacheManager.shouldRevalidate(cached) && !this.pendingRevalidations.has(cacheKey)) {
-            this.pendingRevalidations.set(cacheKey, this.revalidateInBackground(pageModule, context, cacheKey));
+            this.pendingRevalidations.set(cacheKey, this.revalidateInBackground(getStaticData, context, cacheKey));
         }
         return cached.data;
     }
-    async fetchFreshNoCache(pageModule, context) {
+    createStaticDataContext(context) {
+        return { params: context.params, url: context.url };
+    }
+    executeStaticData(getStaticData, context, timeoutMs, label) {
+        return withTimeoutThrow(Promise.resolve(getStaticData(this.createStaticDataContext(context))), timeoutMs, label);
+    }
+    storeCacheEntry(cacheKey, result) {
+        this.cacheManager.set(cacheKey, {
+            data: result,
+            timestamp: Date.now(),
+            revalidate: result.revalidate,
+        });
+    }
+    async fetchFreshNoCache(getStaticData, context) {
         const pathname = context.url?.pathname ?? "unknown";
         const start = performance.now();
         try {
-            return await withTimeoutThrow(Promise.resolve(pageModule.getStaticData({ params: context.params, url: context.url })), DATA_FETCH_TIMEOUT_MS, `getStaticData for ${pathname}`);
+            return await this.executeStaticData(getStaticData, context, DATA_FETCH_TIMEOUT_MS, `getStaticData for ${pathname}`);
         }
         catch (error) {
             const durationMs = Math.round(performance.now() - start);
@@ -89,10 +103,10 @@ export class StaticDataFetcher {
             throw error;
         }
     }
-    async fetchFresh(pageModule, context, cacheKey) {
+    async fetchFresh(getStaticData, context, cacheKey) {
         const pathname = context.url?.pathname ?? "unknown";
         // Extract projectId from request headers (set by proxy) for proper circuit breaker isolation
-        const projectId = getProjectId(context, "default");
+        const projectId = resolveProjectId(context, "default");
         const start = performance.now();
         // Circuit breaker per project to prevent cascade failures
         const circuitBreaker = getCircuitBreaker(`static-data-fetch:${projectId}`, {
@@ -101,13 +115,9 @@ export class StaticDataFetcher {
             successThreshold: 2,
         });
         try {
-            const result = await circuitBreaker.execute(() => withTimeoutThrow(Promise.resolve(pageModule.getStaticData({ params: context.params, url: context.url })), DATA_FETCH_TIMEOUT_MS, `getStaticData for ${pathname}`));
+            const result = await circuitBreaker.execute(() => this.executeStaticData(getStaticData, context, DATA_FETCH_TIMEOUT_MS, `getStaticData for ${pathname}`));
             await withSpan(SpanNames.DATA_CACHE_SET, () => {
-                this.cacheManager.set(cacheKey, {
-                    data: result,
-                    timestamp: Date.now(),
-                    revalidate: result.revalidate,
-                });
+                this.storeCacheEntry(cacheKey, result);
                 return Promise.resolve();
             }, { "data.cache_key": cacheKey, "data.revalidate": result.revalidate ?? 0 });
             return result;
@@ -140,12 +150,10 @@ export class StaticDataFetcher {
             throw error;
         }
     }
-    async revalidateInBackground(pageModule, context, cacheKey) {
-        if (typeof pageModule.getStaticData !== "function")
-            return;
+    async revalidateInBackground(getStaticData, context, cacheKey) {
         const pathname = context.url?.pathname ?? "unknown";
         // Use projectId from request headers for proper per-project fairness
-        const projectId = getProjectId(context, "unknown");
+        const projectId = resolveProjectId(context, "unknown");
         // Check per-project limit before acquiring global semaphore
         if (!acquireRevalidationSlot(projectId)) {
             serverLogger.debug("DATA_REVALIDATION_SKIPPED per-project limit reached", {
@@ -161,12 +169,8 @@ export class StaticDataFetcher {
             await revalidationSemaphore.acquire(async () => {
                 const start = performance.now();
                 try {
-                    const result = await withTimeoutThrow(Promise.resolve(pageModule.getStaticData({ params: context.params, url: context.url })), REVALIDATION_TIMEOUT_MS, `getStaticData revalidation for ${pathname}`);
-                    this.cacheManager.set(cacheKey, {
-                        data: result,
-                        timestamp: Date.now(),
-                        revalidate: result.revalidate,
-                    });
+                    const result = await this.executeStaticData(getStaticData, context, REVALIDATION_TIMEOUT_MS, `getStaticData revalidation for ${pathname}`);
+                    this.storeCacheEntry(cacheKey, result);
                 }
                 catch (error) {
                     const durationMs = Math.round(performance.now() - start);

package/esm/src/data/static-paths-fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-paths-fetcher.d.ts","sourceRoot":"","sources":["../../../src/src/data/static-paths-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMlE,qBAAa,kBAAkB;IAC7B,KAAK,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAyBnE"}
+{"version":3,"file":"static-paths-fetcher.d.ts","sourceRoot":"","sources":["../../../src/src/data/static-paths-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQlE,qBAAa,kBAAkB;IAC7B,KAAK,CAAC,UAAU,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAyBnE"}

package/esm/src/data/static-paths-fetcher.js

@@ -1,6 +1,7 @@
 import { serverLogger } from "../utils/index.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../observability/tracing/span-names.js";
+const EMPTY_STATIC_PATHS_RESULT = { paths: [], fallback: false };
 export class StaticPathsFetcher {
     fetch(pageModule) {
         const getStaticPaths = pageModule.getStaticPaths;
@@ -10,13 +11,13 @@ export class StaticPathsFetcher {
         return withSpan(SpanNames.DATA_FETCH_STATIC_PATHS, async (span) => {
             try {
                 const result = await getStaticPaths();
-                const finalResult = result ?? { paths: [], fallback: false };
+                const finalResult = result ?? EMPTY_STATIC_PATHS_RESULT;
                 span?.setAttribute("data.paths_count", finalResult.paths?.length ?? 0);
                 span?.setAttribute("data.fallback", String(finalResult.fallback ?? false));
                 return finalResult;
             }
             catch (error) {
-                serverLogger.error("Error in getStaticPaths:", error);
+                serverLogger.error("DATA_FETCH_STATIC_PATHS_ERROR getStaticPaths failed", {}, error);
                 throw error;
             }
         }, { "data.fetch_method": "getStaticPaths" });

package/esm/src/errors/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/src/errors/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAqCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/src/errors/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAiCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN"}

package/esm/src/errors/logging.js

@@ -6,6 +6,19 @@
  */
 import { isProduction } from "../build/config/environment.js";
 import { serverLogger } from "../utils/logger/logger.js";
+function toContextRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function mergeContext(errorContext, extraContext) {
+    const baseContext = toContextRecord(errorContext);
+    if (!baseContext)
+        return extraContext;
+    if (!extraContext)
+        return baseContext;
+    return { ...baseContext, ...extraContext };
+}
 /**
  * Log a VeryfrontError with structured formatting
  *
@@ -16,6 +29,7 @@ import { serverLogger } from "../utils/logger/logger.js";
  * @param context - Additional context to include in logs
  */
 export function logError(error, context) {
+    const mergedContext = mergeContext(error.context, context);
     const entry = {
         level: "error",
         slug: error.slug,
@@ -24,11 +38,9 @@ export function logError(error, context) {
         detail: error.detail,
         suggestion: error.suggestion,
         status: error.status,
-        docs: `https://veryfront.com/docs/errors/${error.slug}`,
+        docs: error.getDocsUrl(),
         timestamp: new Date().toISOString(),
-        context: context
-            ? { ...(error.context ?? {}), ...context }
-            : error.context,
+        context: mergedContext,
     };
     if (isProduction()) {
         // Direct JSON output — this module owns its own structured format
@@ -45,9 +57,6 @@ export function logError(error, context) {
             serverLogger.error(`  💡 Suggestion: ${error.suggestion}`);
         }
         serverLogger.error(`  📚 Docs: ${entry.docs}`);
-        const mergedContext = context
-            ? { ...(error.context ?? {}), ...context }
-            : error.context;
         if (mergedContext) {
             serverLogger.error(`  Context: ${JSON.stringify(mergedContext, null, 2)}`);
         }

package/esm/src/errors/user-friendly/error-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/user-friendly/error-formatter.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAwCnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAsBpD"}
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/user-friendly/error-formatter.ts"],"names":[],"mappings":"AAoCA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuBnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAyBpD"}

package/esm/src/errors/user-friendly/error-formatter.js

@@ -3,27 +3,22 @@ import { box } from "../../utils/box.js";
 import { ERROR_SOLUTIONS } from "./error-catalog.js";
 import { identifyError } from "./error-identifier.js";
 const errorColor = "\x1b[38;2;239;68;68m"; // Red
-function buildSolutionLines(solution) {
+function buildSolutionDetailsLines(solution, options) {
     const lines = [];
-    if (solution.message) {
-        lines.push(yellow("Problem: ") + solution.message, "");
-    }
     if (solution.steps?.length) {
-        lines.push(cyan("How to fix:"));
+        lines.push("", cyan("How to fix:"));
         for (const [i, step] of solution.steps.entries()) {
             lines.push(`  ${dim(`${i + 1}.`)} ${step}`);
         }
-        lines.push("");
     }
     if (solution.example) {
-        lines.push(cyan("Example:"), "");
+        lines.push("", options?.exampleLabel ?? cyan("Example:"));
         for (const line of solution.example.split("\n")) {
             lines.push(`  ${dim(line)}`);
         }
-        lines.push("");
     }
     if (solution.docs) {
-        lines.push(dim("Learn more: ") + cyan(solution.docs), "");
+        lines.push("", dim("Learn more: ") + cyan(solution.docs));
     }
     return lines;
 }
@@ -41,21 +36,7 @@ export function formatErrorBox(error) {
         if (solution.message) {
             content.push("", dim(solution.message));
         }
-        if (solution.steps?.length) {
-            content.push("", cyan("How to fix:"));
-            for (const [i, step] of solution.steps.entries()) {
-                content.push(`  ${dim(`${i + 1}.`)} ${step}`);
-            }
-        }
-        if (solution.example) {
-            content.push("", dim("Example:"));
-            for (const line of solution.example.split("\n")) {
-                content.push(`  ${dim(line)}`);
-            }
-        }
-        if (solution.docs) {
-            content.push("", dim("Learn more: ") + cyan(solution.docs));
-        }
+        content.push(...buildSolutionDetailsLines(solution, { exampleLabel: dim("Example:") }));
     }
     return box(content.join("\n"), {
         style: "rounded",
@@ -74,7 +55,10 @@ export function formatUserError(error) {
     const errorKey = identifyError(error);
     const solution = ERROR_SOLUTIONS[errorKey];
     if (solution) {
-        output.push(...buildSolutionLines(solution));
+        if (solution.message) {
+            output.push(yellow("Problem: ") + solution.message);
+        }
+        output.push(...buildSolutionDetailsLines(solution), "");
         return output.join("\n");
     }
     if (error.stack) {

package/esm/src/fs/index.d.ts

@@ -1,11 +1,11 @@
 /**
- * Filesystem operations and path utilities.
+ * Public filesystem, path, and cwd utilities.
  *
  * @module fs
  *
  * @example File operations
  * ```ts
- * import { readTextFile, writeTextFile, mkdir, exists } from "veryfront/fs";
+ * import { exists, mkdir, readTextFile, writeTextFile } from "veryfront/fs";
  *
  * const content = await readTextFile("./data/config.json");
  * await writeTextFile("./output/result.json", JSON.stringify(data));
@@ -19,17 +19,16 @@
  * const filePath = join("src", "pages", "index.tsx");
  * const dir = dirname(filePath); // "src/pages"
  * ```
+ *
+ * @example Working directory
+ * ```ts
+ * import { cwd, resolve } from "veryfront/fs";
+ *
+ * const configPath = resolve(cwd(), "veryfront.config.ts");
+ * ```
  */
 import "../../_dnt.polyfills.js";
-export { createFileSystem } from "../platform/compat/fs.js";
-export { readTextFile } from "../platform/compat/fs.js";
-export { writeTextFile } from "../platform/compat/fs.js";
-export { mkdir } from "../platform/compat/fs.js";
-export { exists } from "../platform/compat/fs.js";
-export { remove } from "../platform/compat/fs.js";
-export { readDir } from "../platform/compat/fs.js";
-export type { FileSystem } from "../platform/compat/fs.js";
-export { basename, dirname, extname, join, } from "../platform/compat/path/basic-operations.js";
-export { resolve } from "../platform/compat/path/resolution.js";
+export { createFileSystem, exists, type FileSystem, mkdir, readDir, readTextFile, remove, writeTextFile, } from "../platform/compat/fs.js";
+export { basename, dirname, extname, join, resolve, } from "../platform/compat/path/index.js";
 export { cwd } from "../platform/compat/process.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/fs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/fs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAM3D,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,IAAI,GACL,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAMhE,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/fs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,KAAK,UAAU,EACf,KAAK,EACL,OAAO,EACP,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,OAAO,EACP,IAAI,EACJ,OAAO,GACR,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC"}

package/esm/src/fs/index.js

@@ -1,11 +1,11 @@
 /**
- * Filesystem operations and path utilities.
+ * Public filesystem, path, and cwd utilities.
  *
  * @module fs
  *
  * @example File operations
  * ```ts
- * import { readTextFile, writeTextFile, mkdir, exists } from "veryfront/fs";
+ * import { exists, mkdir, readTextFile, writeTextFile } from "veryfront/fs";
  *
  * const content = await readTextFile("./data/config.json");
  * await writeTextFile("./output/result.json", JSON.stringify(data));
@@ -19,28 +19,15 @@
  * const filePath = join("src", "pages", "index.tsx");
  * const dir = dirname(filePath); // "src/pages"
  * ```
+ *
+ * @example Working directory
+ * ```ts
+ * import { cwd, resolve } from "veryfront/fs";
+ *
+ * const configPath = resolve(cwd(), "veryfront.config.ts");
+ * ```
  */
-// veryfront/fs — Filesystem operations + path utilities
-//
-// Slim public surface for file I/O, path manipulation, and
-// project context (cwd). Re-exports from the platform compat layer.
-// ---------------------------------------------------------------------------
-// Filesystem
-// ---------------------------------------------------------------------------
 import "../../_dnt.polyfills.js";
-export { createFileSystem } from "../platform/compat/fs.js";
-export { readTextFile } from "../platform/compat/fs.js";
-export { writeTextFile } from "../platform/compat/fs.js";
-export { mkdir } from "../platform/compat/fs.js";
-export { exists } from "../platform/compat/fs.js";
-export { remove } from "../platform/compat/fs.js";
-export { readDir } from "../platform/compat/fs.js";
-// ---------------------------------------------------------------------------
-// Path utilities
-// ---------------------------------------------------------------------------
-export { basename, dirname, extname, join, } from "../platform/compat/path/basic-operations.js";
-export { resolve } from "../platform/compat/path/resolution.js";
-// ---------------------------------------------------------------------------
-// Project context
-// ---------------------------------------------------------------------------
+export { createFileSystem, exists, mkdir, readDir, readTextFile, remove, writeTextFile, } from "../platform/compat/fs.js";
+export { basename, dirname, extname, join, resolve, } from "../platform/compat/path/index.js";
 export { cwd } from "../platform/compat/process.js";

package/esm/src/html/dev-scripts.d.ts

@@ -1,3 +1,4 @@
+export declare function getPreviewStylesheetLink(): string;
 export declare function getDevStyles(nonce?: string): string;
 export declare function getDevScripts(_hmrPort?: number, nonce?: string): string;
 export declare function getProdScripts(slug: string, nonce?: string): string;

package/esm/src/html/dev-scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-scripts.d.ts","sourceRoot":"","sources":["../../../src/src/html/dev-scripts.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA+BnD;AAMD,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAwBrE"}
+{"version":3,"file":"dev-scripts.d.ts","sourceRoot":"","sources":["../../../src/src/html/dev-scripts.ts"],"names":[],"mappings":"AAEA,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA+BnD;AAED,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAwBrE"}

package/esm/src/html/dev-scripts.js

@@ -1,6 +1,9 @@
-import { escapeHtml } from "./html-escape.js";
+import { buildNonceAttribute } from "./html-escape.js";
+export function getPreviewStylesheetLink() {
+    return `<link id="vf-tailwind-css" rel="stylesheet" href="/_vf_styles/styles.css?t=${Date.now()}">`;
+}
 export function getDevStyles(nonce) {
-    const nonceAttr = nonce ? ` nonce="${escapeHtml(nonce)}"` : "";
+    const nonceAttr = buildNonceAttribute(nonce);
     return `
   <style${nonceAttr}>
     .dev-indicator {
@@ -30,24 +33,21 @@ export function getDevStyles(nonce) {
     }
   </style>`;
 }
-function getNonceAttr(nonce) {
-    return nonce ? ` nonce="${escapeHtml(nonce)}"` : "";
-}
 export function getDevScripts(_hmrPort, nonce) {
-    const nonceAttr = getNonceAttr(nonce);
+    const nonceAttr = buildNonceAttribute(nonce);
     return `
   <script type="module" src="/_veryfront/rsc/client.js"${nonceAttr}></script>
   <script type="module" src="/_veryfront/hmr.js"${nonceAttr}></script>`;
 }
 export function getProdScripts(slug, nonce) {
-    const nonceAttr = getNonceAttr(nonce);
+    const nonceAttr = buildNonceAttribute(nonce);
     const encodedSlug = encodeURIComponent(slug);
     return `
   <script type="module" src="/_veryfront/rsc/client.js"${nonceAttr}></script>
   <script type="module" src="/_veryfront/hydrate.js?slug=${encodedSlug}"${nonceAttr}></script>`;
 }
 export function getStudioScripts(options) {
-    const nonceAttr = getNonceAttr(options.nonce);
+    const nonceAttr = buildNonceAttribute(options.nonce);
     const bridgeConfig = {
         projectId: options.projectId,
         pageId: options.pageId,

package/esm/src/html/html-escape.d.ts

@@ -1,4 +1,5 @@
 export declare function escapeHTML(str: string): string;
 export declare const escapeHtml: typeof escapeHTML;
 export declare function buildAttributes(attrs: Record<string, string>): string;
+export declare function buildNonceAttribute(nonce?: string): string;
 //# sourceMappingURL=html-escape.d.ts.map

package/esm/src/html/html-escape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-escape.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-escape.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,eAAO,MAAM,UAAU,mBAAa,CAAC;AAErC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIrE"}
+{"version":3,"file":"html-escape.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-escape.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,eAAO,MAAM,UAAU,mBAAa,CAAC;AAErC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/esm/src/html/html-escape.js

@@ -12,3 +12,6 @@ export function buildAttributes(attrs) {
         .map(([key, value]) => `${key}="${escapeHTML(value)}"`)
         .join(" ");
 }
+export function buildNonceAttribute(nonce) {
+    return nonce ? ` nonce="${escapeHTML(nonce)}"` : "";
+}

package/esm/src/html/html-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAY/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACvC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAwFR"}
+{"version":3,"file":"html-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAkB/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACvC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CA+FR"}

package/esm/src/html/html-injection.js

@@ -1,14 +1,19 @@
 import { resolveRelativePath } from "../modules/react-loader/path-resolver.js";
 import { determineClientModuleStrategy } from "../rendering/rsc/client-module-strategy.js";
 import { generateLinkTags, generateMetaTags, generateScriptTags, generateStyleTags, } from "./tag-generators.js";
-import { escapeHtml } from "./html-escape.js";
-import { getDevScripts, getDevStyles, getProdScripts, getStudioScripts } from "./dev-scripts.js";
+import { buildNonceAttribute } from "./html-escape.js";
+import { getDevScripts, getDevStyles, getPreviewStylesheetLink, getProdScripts, getStudioScripts, } from "./dev-scripts.js";
 function toProjectRelativePath(absolutePath, projectDir) {
     const normalizedPath = absolutePath.replace(/\\/g, "/");
     if (!projectDir)
         return normalizedPath.replace(/^\//, "");
     return resolveRelativePath(normalizedPath, projectDir);
 }
+function hasProjectStylesheet(html) {
+    return /id=["']vf-tailwind-css["']/i.test(html) ||
+        /href=["'][^"']*\/_vf_styles\/styles\.css(?:\?[^"']*)?["']/i.test(html) ||
+        /href=["'][^"']*\/_vf\/css\/[^"']+\.css["']/i.test(html);
+}
 export function injectHTMLContent(template, content, metadata, options) {
     let html = template;
     html = html.replace(/{{\s*content\s*}}/gi, content);
@@ -28,10 +33,15 @@ export function injectHTMLContent(template, content, metadata, options) {
     }
     // Inject import map into <head> for ESM module resolution (must be before any module scripts)
     if (options.importMapJson && /<\/head>/i.test(html)) {
-        const nonceAttr = options.nonce ? ` nonce="${escapeHtml(options.nonce)}"` : "";
+        const nonceAttr = buildNonceAttribute(options.nonce);
         const importMapTag = `<script type="importmap"${nonceAttr}>\n${options.importMapJson}\n</script>`;
         html = html.replace(/<\/head>/i, `${importMapTag}\n</head>`);
     }
+    const shouldUsePreviewStylesheet = options.mode === "development" ||
+        options.environment === "preview";
+    if (shouldUsePreviewStylesheet && /<\/head>/i.test(html) && !hasProjectStylesheet(html)) {
+        html = html.replace(/<\/head>/i, `${getPreviewStylesheetLink()}\n</head>`);
+    }
     const hasBodyClose = /<\/body>/i.test(html);
     // Inject hydration data for 'use client' pages (before scripts, so client.js can find it)
     if (options.pagePath && options.isClientPage && hasBodyClose) {

package/esm/src/html/html-shell-generator.d.ts

@@ -1,8 +1,11 @@
 import type { ComponentProps, RenderMetadata } from "../types/index.js";
+import { getProjectCSS } from "./styles-builder/index.js";
 import type { HTMLGenerationOptions } from "./types.js";
-export declare function generateHTMLShellParts(meta: RenderMetadata, options: HTMLGenerationOptions, params?: Record<string, string | string[]>, props?: ComponentProps, contentForTailwind?: string): Promise<{
+type ProjectCSSResult = Awaited<ReturnType<typeof getProjectCSS>> | null;
+export declare function generateHTMLShellParts(meta: RenderMetadata, options: HTMLGenerationOptions, params?: Record<string, string | string[]>, props?: ComponentProps, contentForTailwind?: string, projectCSSPromise?: Promise<ProjectCSSResult>): Promise<{
     start: string;
     end: string;
 }>;
-export declare function wrapInHTMLShell(content: string, meta: RenderMetadata, options: HTMLGenerationOptions, params?: Record<string, string | string[]>, props?: ComponentProps): Promise<string>;
+export declare function wrapInHTMLShell(content: string, meta: RenderMetadata, options: HTMLGenerationOptions, params?: Record<string, string | string[]>, props?: ComponentProps, projectCSSPromise?: Promise<ProjectCSSResult>): Promise<string>;
+export {};
 //# sourceMappingURL=html-shell-generator.d.ts.map

package/esm/src/html/html-shell-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+ExD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AA6PD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}
+{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAoBxE,OAAO,EAGL,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA0BxD,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC;AA8DzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAoQD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAoBjB"}