veryfront 0.1.162 → 0.1.163

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.162",
+    "version": "0.1.163",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/rendering/orchestrator/html-project-css.d.ts

@@ -0,0 +1,31 @@
+import type { VeryfrontConfig } from "../../config/index.js";
+import type { HTMLGenerationOptions } from "../../html/index.js";
+import { getProjectCSS } from "../../html/styles-builder/index.js";
+import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
+import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
+import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
+import type { RuntimeAdapter } from "../../platform/adapters/base.js";
+import { getRouteCandidates } from "./css-candidate-manifest.js";
+import type { HTMLGenerationContext } from "./html.js";
+export type ProjectCSSResult = Awaited<ReturnType<typeof getProjectCSS>> | null;
+interface ProjectCssConfig {
+    projectDir: string;
+    adapter: RuntimeAdapter;
+    config: VeryfrontConfig;
+    mode: "development" | "production";
+}
+interface ProjectCssDeps {
+    createStyleScopeProfile?: typeof createStyleScopeProfile;
+    getProjectCSS?: typeof getProjectCSS;
+    getProjectContentVersion?: (config: Pick<ProjectCssConfig, "adapter" | "mode">) => string | undefined;
+    getRouteCandidates?: typeof getRouteCandidates;
+    resolveStyleContentVersion?: typeof resolveStyleContentVersion;
+    warmPreparedCSSArtifactFromFiles?: typeof warmPreparedCSSArtifactFromFiles;
+}
+export declare function buildRouteManifestKey(pagePath: string, projectDir: string): string;
+export declare function getProjectContentVersion(config: Pick<ProjectCssConfig, "adapter" | "mode">, deps?: Pick<ProjectCssDeps, "resolveStyleContentVersion">): string | undefined;
+export declare function startProjectCSSPreparation(context: HTMLGenerationContext, htmlOptions: HTMLGenerationOptions, deps?: Pick<ProjectCssDeps, "getProjectCSS">): Promise<ProjectCSSResult> | undefined;
+export declare function startPreparedCSSWarmup(config: ProjectCssConfig, context: HTMLGenerationContext, htmlOptions: HTMLGenerationOptions, deps?: Pick<ProjectCssDeps, "createStyleScopeProfile" | "getProjectContentVersion" | "warmPreparedCSSArtifactFromFiles">): void;
+export declare function extractProjectClassesForRoute(config: ProjectCssConfig, context: HTMLGenerationContext, appComponentPath?: string, deps?: Pick<ProjectCssDeps, "createStyleScopeProfile" | "getProjectContentVersion" | "getRouteCandidates">): Promise<Set<string>>;
+export {};
+//# sourceMappingURL=html-project-css.d.ts.map

package/esm/src/rendering/orchestrator/html-project-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-project-css.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/html-project-css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAItE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAIvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC;AAEhF,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;CACpC;AAED,UAAU,cAAc;IACtB,uBAAuB,CAAC,EAAE,OAAO,uBAAuB,CAAC;IACzD,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,wBAAwB,CAAC,EAAE,CACzB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,MAAM,CAAC,KAC/C,MAAM,GAAG,SAAS,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,0BAA0B,CAAC,EAAE,OAAO,0BAA0B,CAAC;IAC/D,gCAAgC,CAAC,EAAE,OAAO,gCAAgC,CAAC;CAC5E;AAUD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,MAAM,CAAC,EAClD,IAAI,GAAE,IAAI,CAAC,cAAc,EAAE,4BAA4B,CAAM,GAC5D,MAAM,GAAG,SAAS,CAiBpB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,qBAAqB,EAClC,IAAI,GAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAM,GAC/C,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAkBvC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,qBAAqB,EAClC,IAAI,GAAE,IAAI,CACR,cAAc,EACd,yBAAyB,GAAG,0BAA0B,GAAG,kCAAkC,CACvF,GACL,IAAI,CAyCN;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,qBAAqB,EAC9B,gBAAgB,CAAC,EAAE,MAAM,EACzB,IAAI,GAAE,IAAI,CACR,cAAc,EACd,yBAAyB,GAAG,0BAA0B,GAAG,oBAAoB,CACzE,GACL,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CA+CtB"}

package/esm/src/rendering/orchestrator/html-project-css.js

@@ -0,0 +1,126 @@
+import { getProjectCSS } from "../../html/styles-builder/index.js";
+import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
+import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
+import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
+import { rendererLogger } from "../../utils/index.js";
+import { extractRelativePath } from "../../utils/route-path-utils.js";
+import { getRouteCandidates } from "./css-candidate-manifest.js";
+const logger = rendererLogger.component("html-project-css");
+function getUnderlyingFsAdapter(adapter) {
+    const wrappedFs = adapter.fs;
+    if (typeof wrappedFs.getUnderlyingAdapter !== "function")
+        return undefined;
+    return wrappedFs.getUnderlyingAdapter();
+}
+export function buildRouteManifestKey(pagePath, projectDir) {
+    const relativePagePath = extractRelativePath(pagePath, projectDir);
+    return relativePagePath
+        .replace(/\.(tsx|ts|jsx|mdx|md|js)$/, "")
+        .replace(/^pages\//, "");
+}
+export function getProjectContentVersion(config, deps = {}) {
+    const fsAdapter = getUnderlyingFsAdapter(config.adapter);
+    if (!fsAdapter)
+        return undefined;
+    const contentContext = typeof fsAdapter.getContentContext === "function"
+        ? fsAdapter.getContentContext()
+        : null;
+    if (contentContext) {
+        const resolveContentVersion = deps.resolveStyleContentVersion ?? resolveStyleContentVersion;
+        return resolveContentVersion(contentContext);
+    }
+    return fsAdapter.getProjectData?.()?.updated_at;
+}
+export function startProjectCSSPreparation(context, htmlOptions, deps = {}) {
+    const isLocalProject = htmlOptions.isLocalProject ?? false;
+    if (isLocalProject || htmlOptions.environment !== "production")
+        return undefined;
+    const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
+    if (!projectScope || projectScope === "default")
+        return undefined;
+    const getProjectCss = deps.getProjectCSS ?? getProjectCSS;
+    return getProjectCss(projectScope, htmlOptions.globalCSS, new Set([...(htmlOptions.projectClasses ?? [])]), {
+        minify: true,
+        environment: htmlOptions.environment,
+        buildMode: htmlOptions.mode,
+    });
+}
+export function startPreparedCSSWarmup(config, context, htmlOptions, deps = {}) {
+    const isLocalProject = htmlOptions.isLocalProject ?? false;
+    const usesPreviewStylesheet = isLocalProject || htmlOptions.environment !== "production";
+    if (!usesPreviewStylesheet)
+        return;
+    const fsAdapter = getUnderlyingFsAdapter(config.adapter);
+    if (typeof fsAdapter?.getAllSourceFiles !== "function")
+        return;
+    const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
+    if (!projectScope || projectScope === "default")
+        return;
+    const resolveProjectContentVersion = deps.getProjectContentVersion ?? getProjectContentVersion;
+    const projectVersion = resolveProjectContentVersion(config) ??
+        (config.mode === "development" ? "dev" : "unknown");
+    const createStyleProfile = deps.createStyleScopeProfile ?? createStyleScopeProfile;
+    const warmPreparedCss = deps.warmPreparedCSSArtifactFromFiles ?? warmPreparedCSSArtifactFromFiles;
+    const styleProfile = createStyleProfile(config.config);
+    const stylesheetPath = config.config?.tailwind?.stylesheet;
+    Promise.resolve(fsAdapter.getAllSourceFiles())
+        .then((files) => warmPreparedCss({
+        projectSlug: projectScope,
+        projectVersion,
+        projectDir: config.projectDir,
+        files,
+        styleProfile,
+        stylesheetPath,
+        minify: true,
+        environment: "preview",
+        buildMode: "production",
+    }))
+        .catch((error) => {
+        logger.debug("Prepared CSS warmup skipped after source scan failure", {
+            projectScope,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    });
+}
+export async function extractProjectClassesForRoute(config, context, appComponentPath, deps = {}) {
+    const classes = new Set();
+    const fsAdapter = getUnderlyingFsAdapter(config.adapter);
+    if (typeof fsAdapter?.getAllSourceFiles !== "function")
+        return classes;
+    const files = await fsAdapter.getAllSourceFiles();
+    const projectScope = context.options?.projectSlug || context.options?.projectId ||
+        config.projectDir;
+    const resolveProjectContentVersion = deps.getProjectContentVersion ?? getProjectContentVersion;
+    const projectVersion = resolveProjectContentVersion(config) ??
+        (config.mode === "development" ? "dev" : "unknown");
+    const routeKey = buildRouteManifestKey(context.pageInfo.entity.path, config.projectDir);
+    const routeLayoutPaths = context.nestedLayouts
+        .map((layout) => layout.componentPath || layout.path)
+        .filter((path) => Boolean(path));
+    const routeFilePaths = [
+        context.pageInfo.entity.path,
+        ...routeLayoutPaths,
+        ...(appComponentPath ? [appComponentPath] : []),
+    ];
+    const createStyleProfile = deps.createStyleScopeProfile ?? createStyleScopeProfile;
+    const getRouteCssCandidates = deps.getRouteCandidates ?? getRouteCandidates;
+    const routeCandidates = getRouteCssCandidates({
+        projectScope,
+        projectVersion,
+        projectDir: config.projectDir,
+        styleProfile: createStyleProfile(config.config),
+        routeKey,
+        routeFilePaths,
+        files,
+        developmentMode: config.mode === "development",
+    });
+    for (const cls of routeCandidates)
+        classes.add(cls);
+    logger.debug("extractProjectClasses", {
+        filesProcessed: files.length,
+        routeKey,
+        routeFileCount: routeFilePaths.length,
+        totalClasses: classes.size,
+    });
+    return classes;
+}

package/esm/src/rendering/orchestrator/html.d.ts

@@ -33,8 +33,6 @@ export declare class HTMLGenerator {
     private detectUseClientDirective;
     private wrapHTMLFragment;
     private generateShellParts;
-    private startProjectCSSPreparation;
-    private startPreparedCSSWarmup;
     private buildHeadElements;
     private mergeFrontmatter;
     private resolveAppPath;
@@ -46,8 +44,5 @@ export declare class HTMLGenerator {
      * double-loading globals.css when it's both auto-discovered and explicitly imported.
      */
     private mergeImportedCSS;
-    private getProjectContentVersion;
-    private buildRouteManifestKey;
-    private extractProjectClassesForRoute;
 }
 //# sourceMappingURL=html.d.ts.map

package/esm/src/rendering/orchestrator/html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,SAAS,EAET,UAAU,EACX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6EhD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIjC,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BjE,kBAAkB,CACtB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC;YAqEZ,sBAAsB;YAqDtB,4BAA4B;YAiB5B,wBAAwB;YAmBxB,gBAAgB;YAyBhB,kBAAkB;IAwDhC,OAAO,CAAC,0BAA0B;IAsBlC,OAAO,CAAC,sBAAsB;IAgD9B,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;YAQR,eAAe;YAaf,gBAAgB;IAgF9B;;;;OAIG;YACW,gBAAgB;IA2D9B,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,qBAAqB;YAOf,6BAA6B;CAyD5C"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,SAAS,EAET,UAAU,EACX,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4EhD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,SAAS,GAAG,SAAS,CAAC;IACpC,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIjC,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BjE,kBAAkB,CACtB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC;YAqEZ,sBAAsB;YAqDtB,4BAA4B;YAiB5B,wBAAwB;YAmBxB,gBAAgB;YAyBhB,kBAAkB;IAwDhC,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;YAQR,eAAe;YAaf,gBAAgB;IAgF9B;;;;OAIG;YACW,gBAAgB;CA0D/B"}

package/esm/src/rendering/orchestrator/html.js

@@ -10,11 +10,7 @@ import { resolveAppComponentPath } from "../layouts/utils/app-resolver.js";
 import { StreamTimeoutError, streamToString } from "../utils/stream-utils.js";
 import { profilePhase, profileSyncPhase } from "../../observability/request-profiler.js";
 import { normalizeCssModuleKey, rewriteCssModuleContent, } from "../../transforms/css-modules/naming.js";
-import { getProjectCSS } from "../../html/styles-builder/index.js";
-import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
-import { getRouteCandidates } from "./css-candidate-manifest.js";
-import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
-import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
+import { extractProjectClassesForRoute, startPreparedCSSWarmup, startProjectCSSPreparation, } from "./html-project-css.js";
 const logger = rendererLogger.component("html-generator");
 function applyExplicitThemeToDocument(html, colorScheme, enabled) {
     if (!enabled || !colorScheme)
@@ -67,7 +63,7 @@ export class HTMLGenerator {
             if (this.config.mode === "production" && context.options?.environment === "production") {
                 const mergedFrontmatter = this.mergeFrontmatter(context);
                 const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(context, mergedFrontmatter));
-                projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
+                projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
             }
             html = await this.handleFullHTMLDocument(context, projectCSSPromise);
         }
@@ -84,8 +80,8 @@ export class HTMLGenerator {
         const fullContext = context;
         const mergedFrontmatter = this.mergeFrontmatter(fullContext);
         const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(fullContext, mergedFrontmatter));
-        const projectCSSPromise = this.startProjectCSSPreparation(fullContext, htmlOptions);
-        this.startPreparedCSSWarmup(fullContext, htmlOptions);
+        const projectCSSPromise = startProjectCSSPreparation(fullContext, htmlOptions);
+        startPreparedCSSWarmup(this.config, fullContext, htmlOptions);
         let reactContent;
         try {
             reactContent = (await streamToString(reactStream)).trim();
@@ -181,8 +177,8 @@ export class HTMLGenerator {
     async wrapHTMLFragment(context) {
         const mergedFrontmatter = this.mergeFrontmatter(context);
         const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(context, mergedFrontmatter));
-        const projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
-        this.startPreparedCSSWarmup(context, htmlOptions);
+        const projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
+        startPreparedCSSWarmup(this.config, context, htmlOptions);
         const reactContent = context.html.trim();
         const { start, end } = await profilePhase("html.generate_shell_parts", () => this.generateShellParts(context, mergedFrontmatter, htmlOptions, reactContent, projectCSSPromise));
         return `${start}${reactContent}${end}`;
@@ -224,54 +220,6 @@ export class HTMLGenerator {
         }
         return { start: modifiedStart, end };
     }
-    startProjectCSSPreparation(context, htmlOptions) {
-        const isLocalProject = htmlOptions.isLocalProject ?? false;
-        if (isLocalProject || htmlOptions.environment !== "production")
-            return undefined;
-        const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-        if (!projectScope || projectScope === "default")
-            return undefined;
-        return getProjectCSS(projectScope, htmlOptions.globalCSS, new Set([...(htmlOptions.projectClasses ?? [])]), {
-            minify: true,
-            environment: htmlOptions.environment,
-            buildMode: htmlOptions.mode,
-        });
-    }
-    startPreparedCSSWarmup(context, htmlOptions) {
-        const isLocalProject = htmlOptions.isLocalProject ?? false;
-        const usesPreviewStylesheet = isLocalProject || htmlOptions.environment !== "production";
-        if (!usesPreviewStylesheet)
-            return;
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        if (typeof fsAdapter.getAllSourceFiles !== "function")
-            return;
-        const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-        if (!projectScope || projectScope === "default")
-            return;
-        const projectVersion = this.getProjectContentVersion() ??
-            (this.config.mode === "development" ? "dev" : "unknown");
-        const styleProfile = createStyleScopeProfile(this.config.config);
-        const stylesheetPath = this.config.config?.tailwind?.stylesheet;
-        Promise.resolve(fsAdapter.getAllSourceFiles()).then((files) => warmPreparedCSSArtifactFromFiles({
-            projectSlug: projectScope,
-            projectVersion,
-            projectDir: this.config.projectDir,
-            files,
-            styleProfile,
-            stylesheetPath,
-            minify: true,
-            environment: "preview",
-            buildMode: "production",
-        })).catch((error) => {
-            logger.debug("Prepared CSS warmup skipped after source scan failure", {
-                projectScope,
-                error: error instanceof Error ? error.message : String(error),
-            });
-        });
-    }
     buildHeadElements(head) {
         if (!head)
             return { scripts: "", other: "" };
@@ -360,7 +308,7 @@ export class HTMLGenerator {
             profilePhase("html.load_global_css", () => this.loadProjectFile(stylesheetPath)),
         ]);
         const appComponentPath = appComponentPathOrNull ?? undefined;
-        const projectClasses = await profilePhase("html.route_candidates", () => this.extractProjectClassesForRoute(context, appComponentPath));
+        const projectClasses = await profilePhase("html.route_candidates", () => extractProjectClassesForRoute(this.config, context, appComponentPath));
         // Load CSS imported by components and merge with globalCSS.
         // Deduplicate against the configured stylesheet to avoid double-loading.
         const combinedCSS = await profilePhase("html.merge_imported_css", () => this.mergeImportedCSS(globalCSS, context.cssImports, stylesheetPath));
@@ -462,64 +410,4 @@ export class HTMLGenerator {
         });
         return combined;
     }
-    getProjectContentVersion() {
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return undefined;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        const contentContext = typeof fsAdapter.getContentContext === "function"
-            ? fsAdapter.getContentContext()
-            : null;
-        if (contentContext)
-            return resolveStyleContentVersion(contentContext);
-        return fsAdapter.getProjectData?.()?.updated_at;
-    }
-    buildRouteManifestKey(pagePath) {
-        const relativePagePath = extractRelativePath(pagePath, this.config.projectDir);
-        return relativePagePath
-            .replace(/\.(tsx|ts|jsx|mdx|md|js)$/, "")
-            .replace(/^pages\//, "");
-    }
-    async extractProjectClassesForRoute(context, appComponentPath) {
-        const classes = new Set();
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return classes;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        if (typeof fsAdapter.getAllSourceFiles !== "function")
-            return classes;
-        const files = await fsAdapter.getAllSourceFiles();
-        const projectScope = context.options?.projectSlug || context.options?.projectId ||
-            this.config.projectDir;
-        const projectVersion = this.getProjectContentVersion() ??
-            (this.config.mode === "development" ? "dev" : "unknown");
-        const routeKey = this.buildRouteManifestKey(context.pageInfo.entity.path);
-        const routeLayoutPaths = context.nestedLayouts
-            .map((layout) => layout.componentPath || layout.path)
-            .filter((path) => Boolean(path));
-        const routeFilePaths = [
-            context.pageInfo.entity.path,
-            ...routeLayoutPaths,
-            ...(appComponentPath ? [appComponentPath] : []),
-        ];
-        const routeCandidates = getRouteCandidates({
-            projectScope,
-            projectVersion,
-            projectDir: this.config.projectDir,
-            styleProfile: createStyleScopeProfile(this.config.config),
-            routeKey,
-            routeFilePaths,
-            files,
-            developmentMode: this.config.mode === "development",
-        });
-        for (const cls of routeCandidates)
-            classes.add(cls);
-        logger.debug("extractProjectClasses", {
-            filesProcessed: files.length,
-            routeKey,
-            routeFileCount: routeFilePaths.length,
-            totalClasses: classes.size,
-        });
-        return classes;
-    }
 }

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.162";
+export declare const VERSION = "0.1.163";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.162";
+export const VERSION = "0.1.163";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.162",
+  "version": "0.1.163",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.162",
+  "version": "0.1.163",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/rendering/orchestrator/html-project-css.ts

@@ -0,0 +1,203 @@
+import type { VeryfrontConfig } from "../../config/index.js";
+import type { HTMLGenerationOptions } from "../../html/index.js";
+import { getProjectCSS } from "../../html/styles-builder/index.js";
+import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
+import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
+import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
+import type { RuntimeAdapter } from "../../platform/adapters/base.js";
+import type { ResolvedContentContext } from "../../platform/adapters/fs/veryfront/types.js";
+import { rendererLogger } from "../../utils/index.js";
+import { extractRelativePath } from "../../utils/route-path-utils.js";
+import { getRouteCandidates } from "./css-candidate-manifest.js";
+import type { HTMLGenerationContext } from "./html.js";
+
+const logger = rendererLogger.component("html-project-css");
+
+export type ProjectCSSResult = Awaited<ReturnType<typeof getProjectCSS>> | null;
+
+interface ProjectCssConfig {
+  projectDir: string;
+  adapter: RuntimeAdapter;
+  config: VeryfrontConfig;
+  mode: "development" | "production";
+}
+
+interface ProjectCssDeps {
+  createStyleScopeProfile?: typeof createStyleScopeProfile;
+  getProjectCSS?: typeof getProjectCSS;
+  getProjectContentVersion?: (
+    config: Pick<ProjectCssConfig, "adapter" | "mode">,
+  ) => string | undefined;
+  getRouteCandidates?: typeof getRouteCandidates;
+  resolveStyleContentVersion?: typeof resolveStyleContentVersion;
+  warmPreparedCSSArtifactFromFiles?: typeof warmPreparedCSSArtifactFromFiles;
+}
+
+type SourceFileEntry = { path: string; content?: string };
+
+function getUnderlyingFsAdapter(adapter: RuntimeAdapter): unknown {
+  const wrappedFs = adapter.fs as unknown as { getUnderlyingAdapter?: () => unknown };
+  if (typeof wrappedFs.getUnderlyingAdapter !== "function") return undefined;
+  return wrappedFs.getUnderlyingAdapter();
+}
+
+export function buildRouteManifestKey(pagePath: string, projectDir: string): string {
+  const relativePagePath = extractRelativePath(pagePath, projectDir);
+  return relativePagePath
+    .replace(/\.(tsx|ts|jsx|mdx|md|js)$/, "")
+    .replace(/^pages\//, "");
+}
+
+export function getProjectContentVersion(
+  config: Pick<ProjectCssConfig, "adapter" | "mode">,
+  deps: Pick<ProjectCssDeps, "resolveStyleContentVersion"> = {},
+): string | undefined {
+  const fsAdapter = getUnderlyingFsAdapter(config.adapter) as {
+    getContentContext?: () => ResolvedContentContext | null;
+    getProjectData?: () => { updated_at?: string } | undefined;
+  } | undefined;
+
+  if (!fsAdapter) return undefined;
+
+  const contentContext = typeof fsAdapter.getContentContext === "function"
+    ? fsAdapter.getContentContext()
+    : null;
+  if (contentContext) {
+    const resolveContentVersion = deps.resolveStyleContentVersion ?? resolveStyleContentVersion;
+    return resolveContentVersion(contentContext);
+  }
+
+  return fsAdapter.getProjectData?.()?.updated_at;
+}
+
+export function startProjectCSSPreparation(
+  context: HTMLGenerationContext,
+  htmlOptions: HTMLGenerationOptions,
+  deps: Pick<ProjectCssDeps, "getProjectCSS"> = {},
+): Promise<ProjectCSSResult> | undefined {
+  const isLocalProject = htmlOptions.isLocalProject ?? false;
+  if (isLocalProject || htmlOptions.environment !== "production") return undefined;
+
+  const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
+  if (!projectScope || projectScope === "default") return undefined;
+
+  const getProjectCss = deps.getProjectCSS ?? getProjectCSS;
+  return getProjectCss(
+    projectScope,
+    htmlOptions.globalCSS,
+    new Set([...(htmlOptions.projectClasses ?? [])]),
+    {
+      minify: true,
+      environment: htmlOptions.environment,
+      buildMode: htmlOptions.mode,
+    },
+  );
+}
+
+export function startPreparedCSSWarmup(
+  config: ProjectCssConfig,
+  context: HTMLGenerationContext,
+  htmlOptions: HTMLGenerationOptions,
+  deps: Pick<
+    ProjectCssDeps,
+    "createStyleScopeProfile" | "getProjectContentVersion" | "warmPreparedCSSArtifactFromFiles"
+  > = {},
+): void {
+  const isLocalProject = htmlOptions.isLocalProject ?? false;
+  const usesPreviewStylesheet = isLocalProject || htmlOptions.environment !== "production";
+  if (!usesPreviewStylesheet) return;
+
+  const fsAdapter = getUnderlyingFsAdapter(config.adapter) as {
+    getAllSourceFiles?: () => SourceFileEntry[] | Promise<SourceFileEntry[]>;
+  } | undefined;
+  if (typeof fsAdapter?.getAllSourceFiles !== "function") return;
+
+  const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
+  if (!projectScope || projectScope === "default") return;
+
+  const resolveProjectContentVersion = deps.getProjectContentVersion ?? getProjectContentVersion;
+  const projectVersion = resolveProjectContentVersion(config) ??
+    (config.mode === "development" ? "dev" : "unknown");
+  const createStyleProfile = deps.createStyleScopeProfile ?? createStyleScopeProfile;
+  const warmPreparedCss = deps.warmPreparedCSSArtifactFromFiles ?? warmPreparedCSSArtifactFromFiles;
+  const styleProfile = createStyleProfile(config.config);
+  const stylesheetPath = config.config?.tailwind?.stylesheet;
+
+  Promise.resolve(fsAdapter.getAllSourceFiles())
+    .then((files) =>
+      warmPreparedCss({
+        projectSlug: projectScope,
+        projectVersion,
+        projectDir: config.projectDir,
+        files,
+        styleProfile,
+        stylesheetPath,
+        minify: true,
+        environment: "preview",
+        buildMode: "production",
+      })
+    )
+    .catch((error) => {
+      logger.debug("Prepared CSS warmup skipped after source scan failure", {
+        projectScope,
+        error: error instanceof Error ? error.message : String(error),
+      });
+    });
+}
+
+export async function extractProjectClassesForRoute(
+  config: ProjectCssConfig,
+  context: HTMLGenerationContext,
+  appComponentPath?: string,
+  deps: Pick<
+    ProjectCssDeps,
+    "createStyleScopeProfile" | "getProjectContentVersion" | "getRouteCandidates"
+  > = {},
+): Promise<Set<string>> {
+  const classes = new Set<string>();
+  const fsAdapter = getUnderlyingFsAdapter(config.adapter) as {
+    getAllSourceFiles?: () => SourceFileEntry[] | Promise<SourceFileEntry[]>;
+  } | undefined;
+
+  if (typeof fsAdapter?.getAllSourceFiles !== "function") return classes;
+
+  const files = await fsAdapter.getAllSourceFiles();
+  const projectScope = context.options?.projectSlug || context.options?.projectId ||
+    config.projectDir;
+  const resolveProjectContentVersion = deps.getProjectContentVersion ?? getProjectContentVersion;
+  const projectVersion = resolveProjectContentVersion(config) ??
+    (config.mode === "development" ? "dev" : "unknown");
+  const routeKey = buildRouteManifestKey(context.pageInfo.entity.path, config.projectDir);
+  const routeLayoutPaths = context.nestedLayouts
+    .map((layout) => layout.componentPath || layout.path)
+    .filter((path): path is string => Boolean(path));
+  const routeFilePaths = [
+    context.pageInfo.entity.path,
+    ...routeLayoutPaths,
+    ...(appComponentPath ? [appComponentPath] : []),
+  ];
+
+  const createStyleProfile = deps.createStyleScopeProfile ?? createStyleScopeProfile;
+  const getRouteCssCandidates = deps.getRouteCandidates ?? getRouteCandidates;
+  const routeCandidates = getRouteCssCandidates({
+    projectScope,
+    projectVersion,
+    projectDir: config.projectDir,
+    styleProfile: createStyleProfile(config.config),
+    routeKey,
+    routeFilePaths,
+    files,
+    developmentMode: config.mode === "development",
+  });
+
+  for (const cls of routeCandidates) classes.add(cls);
+
+  logger.debug("extractProjectClasses", {
+    filesProcessed: files.length,
+    routeKey,
+    routeFileCount: routeFilePaths.length,
+    totalClasses: classes.size,
+  });
+
+  return classes;
+}

package/src/src/rendering/orchestrator/html.ts

@@ -31,15 +31,14 @@ import {
   normalizeCssModuleKey,
   rewriteCssModuleContent,
 } from "../../transforms/css-modules/naming.js";
-import { getProjectCSS } from "../../html/styles-builder/index.js";
-import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
-import { getRouteCandidates } from "./css-candidate-manifest.js";
-import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
-import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
-import type { ResolvedContentContext } from "../../platform/adapters/fs/veryfront/types.js";
+import {
+  extractProjectClassesForRoute,
+  type ProjectCSSResult,
+  startPreparedCSSWarmup,
+  startProjectCSSPreparation,
+} from "./html-project-css.js";
 
 const logger = rendererLogger.component("html-generator");
-type ProjectCSSResult = Awaited<ReturnType<typeof getProjectCSS>> | null;
 
 function applyExplicitThemeToDocument(
   html: string,
@@ -136,7 +135,7 @@ export class HTMLGenerator {
           "html.build_options",
           () => this.buildHTMLOptions(context, mergedFrontmatter),
         );
-        projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
+        projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
       }
 
       html = await this.handleFullHTMLDocument(context, projectCSSPromise);
@@ -162,8 +161,8 @@ export class HTMLGenerator {
       "html.build_options",
       () => this.buildHTMLOptions(fullContext, mergedFrontmatter),
     );
-    const projectCSSPromise = this.startProjectCSSPreparation(fullContext, htmlOptions);
-    this.startPreparedCSSWarmup(fullContext, htmlOptions);
+    const projectCSSPromise = startProjectCSSPreparation(fullContext, htmlOptions);
+    startPreparedCSSWarmup(this.config, fullContext, htmlOptions);
 
     let reactContent: string;
     try {
@@ -319,8 +318,8 @@ export class HTMLGenerator {
       "html.build_options",
       () => this.buildHTMLOptions(context, mergedFrontmatter),
     );
-    const projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
-    this.startPreparedCSSWarmup(context, htmlOptions);
+    const projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
+    startPreparedCSSWarmup(this.config, context, htmlOptions);
     const reactContent = context.html.trim();
 
     const { start, end } = await profilePhase(
@@ -394,76 +393,6 @@ export class HTMLGenerator {
     return { start: modifiedStart, end };
   }
 
-  private startProjectCSSPreparation(
-    context: HTMLGenerationContext,
-    htmlOptions: HTMLGenerationOptions,
-  ): Promise<ProjectCSSResult> | undefined {
-    const isLocalProject = htmlOptions.isLocalProject ?? false;
-    if (isLocalProject || htmlOptions.environment !== "production") return undefined;
-
-    const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-    if (!projectScope || projectScope === "default") return undefined;
-
-    return getProjectCSS(
-      projectScope,
-      htmlOptions.globalCSS,
-      new Set([...(htmlOptions.projectClasses ?? [])]),
-      {
-        minify: true,
-        environment: htmlOptions.environment,
-        buildMode: htmlOptions.mode,
-      },
-    );
-  }
-
-  private startPreparedCSSWarmup(
-    context: HTMLGenerationContext,
-    htmlOptions: HTMLGenerationOptions,
-  ): void {
-    const isLocalProject = htmlOptions.isLocalProject ?? false;
-    const usesPreviewStylesheet = isLocalProject || htmlOptions.environment !== "production";
-    if (!usesPreviewStylesheet) return;
-
-    const wrappedFs = this.config.adapter.fs as unknown as {
-      getUnderlyingAdapter?: () => unknown;
-    };
-    if (typeof wrappedFs.getUnderlyingAdapter !== "function") return;
-
-    const fsAdapter = wrappedFs.getUnderlyingAdapter() as {
-      getAllSourceFiles?: () =>
-        | Array<{ path: string; content?: string }>
-        | Promise<Array<{ path: string; content?: string }>>;
-    };
-    if (typeof fsAdapter.getAllSourceFiles !== "function") return;
-
-    const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-    if (!projectScope || projectScope === "default") return;
-
-    const projectVersion = this.getProjectContentVersion() ??
-      (this.config.mode === "development" ? "dev" : "unknown");
-    const styleProfile = createStyleScopeProfile(this.config.config);
-    const stylesheetPath = this.config.config?.tailwind?.stylesheet;
-
-    Promise.resolve(fsAdapter.getAllSourceFiles()).then((files) =>
-      warmPreparedCSSArtifactFromFiles({
-        projectSlug: projectScope,
-        projectVersion,
-        projectDir: this.config.projectDir,
-        files,
-        styleProfile,
-        stylesheetPath,
-        minify: true,
-        environment: "preview",
-        buildMode: "production",
-      })
-    ).catch((error) => {
-      logger.debug("Prepared CSS warmup skipped after source scan failure", {
-        projectScope,
-        error: error instanceof Error ? error.message : String(error),
-      });
-    });
-  }
-
   private buildHeadElements(head?: CollectedHead): { scripts: string; other: string } {
     if (!head) return { scripts: "", other: "" };
 
@@ -565,7 +494,7 @@ export class HTMLGenerator {
     const appComponentPath = appComponentPathOrNull ?? undefined;
     const projectClasses = await profilePhase(
       "html.route_candidates",
-      () => this.extractProjectClassesForRoute(context, appComponentPath),
+      () => extractProjectClassesForRoute(this.config, context, appComponentPath),
     );
 
     // Load CSS imported by components and merge with globalCSS.
@@ -696,90 +625,4 @@ export class HTMLGenerator {
     });
     return combined;
   }
-
-  private getProjectContentVersion(): string | undefined {
-    const wrappedFs = this.config.adapter.fs as unknown as {
-      getUnderlyingAdapter?: () => unknown;
-    };
-
-    if (typeof wrappedFs.getUnderlyingAdapter !== "function") return undefined;
-
-    const fsAdapter = wrappedFs.getUnderlyingAdapter() as {
-      getContentContext?: () => ResolvedContentContext | null;
-      getProjectData?: () => { updated_at?: string } | undefined;
-    };
-
-    const contentContext = typeof fsAdapter.getContentContext === "function"
-      ? fsAdapter.getContentContext()
-      : null;
-
-    if (contentContext) return resolveStyleContentVersion(contentContext);
-
-    return fsAdapter.getProjectData?.()?.updated_at;
-  }
-
-  private buildRouteManifestKey(pagePath: string): string {
-    const relativePagePath = extractRelativePath(pagePath, this.config.projectDir);
-    return relativePagePath
-      .replace(/\.(tsx|ts|jsx|mdx|md|js)$/, "")
-      .replace(/^pages\//, "");
-  }
-
-  private async extractProjectClassesForRoute(
-    context: HTMLGenerationContext,
-    appComponentPath?: string,
-  ): Promise<Set<string>> {
-    const classes = new Set<string>();
-
-    const wrappedFs = this.config.adapter.fs as unknown as {
-      getUnderlyingAdapter?: () => unknown;
-    };
-
-    if (typeof wrappedFs.getUnderlyingAdapter !== "function") return classes;
-
-    const fsAdapter = wrappedFs.getUnderlyingAdapter() as {
-      getAllSourceFiles?: () =>
-        | Array<{ path: string; content?: string }>
-        | Promise<Array<{ path: string; content?: string }>>;
-    };
-
-    if (typeof fsAdapter.getAllSourceFiles !== "function") return classes;
-
-    const files = await fsAdapter.getAllSourceFiles();
-    const projectScope = context.options?.projectSlug || context.options?.projectId ||
-      this.config.projectDir;
-    const projectVersion = this.getProjectContentVersion() ??
-      (this.config.mode === "development" ? "dev" : "unknown");
-    const routeKey = this.buildRouteManifestKey(context.pageInfo.entity.path);
-    const routeLayoutPaths = context.nestedLayouts
-      .map((layout) => layout.componentPath || layout.path)
-      .filter((path): path is string => Boolean(path));
-    const routeFilePaths = [
-      context.pageInfo.entity.path,
-      ...routeLayoutPaths,
-      ...(appComponentPath ? [appComponentPath] : []),
-    ];
-
-    const routeCandidates = getRouteCandidates({
-      projectScope,
-      projectVersion,
-      projectDir: this.config.projectDir,
-      styleProfile: createStyleScopeProfile(this.config.config),
-      routeKey,
-      routeFilePaths,
-      files,
-      developmentMode: this.config.mode === "development",
-    });
-
-    for (const cls of routeCandidates) classes.add(cls);
-
-    logger.debug("extractProjectClasses", {
-      filesProcessed: files.length,
-      routeKey,
-      routeFileCount: routeFilePaths.length,
-      totalClasses: classes.size,
-    });
-
-    return classes;
-  }
 }

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.162";
+export const VERSION = "0.1.163";