veryfront 0.1.89 → 0.1.90

package/esm/src/platform/adapters/fs/veryfront/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,SAAS,EACT,eAAe,EAEf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AA2BnE,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAE5B,kFAAkF;IAClF,OAAO,CAAC,oBAAoB,CAA6B;IACzD,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,SAAS,CAAmB;IAEpC,4DAA4D;IAC5D,OAAO,CAAC,aAAa,CAAuB;IAE5C,+CAA+C;IAC/C,OAAO,CAAC,aAAa,CAAgB;IACrC,iGAAiG;IACjG,OAAO,CAAC,cAAc,CAAuC;IAC7D,mFAAmF;IACnF,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,eAAe;IA0L7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgJjC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,sBAAsB;IAmE9B,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAIK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKhD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKhD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzB,OAAO,IAAI,IAAI;IAYf,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,OAAO,GAAG,SAAS;IAI/B,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAoC7E,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAYpD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWrD,0BAA0B,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IA0BvD,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK7C,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,kBAAkB,IAAI,IAAI;IAK1B,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAoCxD,iBAAiB,IAAI,sBAAsB,GAAG,IAAI;IAWlD,SAAS,IAAI,kBAAkB;YAIjB,iBAAiB;IAK/B;;;;;OAKG;YACW,uBAAuB;CA2CtC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/adapter.ts"],"names":[],"mappings":"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"}

package/esm/src/platform/adapters/fs/veryfront/adapter.js

@@ -164,6 +164,7 @@ export class VeryfrontFSAdapter {
             },
             clearFileListIndex: () => this.readOps.clearFileListIndex(),
             setFileListCache: (cacheKey, files) => this.cache.setAsync(cacheKey, files),
+            pregenerateStyles: (files) => this.triggerCSSPregeneration(files),
         });
         logger.debug("Created", {
             apiBaseUrl: this.apiBaseUrl,
@@ -245,10 +246,10 @@ export class VeryfrontFSAdapter {
                 sourceFiles: fileSummary.sourceFiles,
                 sourceFilesWithContent: fileSummary.sourceFilesWithContent,
             });
-            // Trigger CSS pre-generation for non-branch environments (fire-and-forget)
-            // This runs in parallel with the rest of initialization
-            if (this.contentContext.sourceType !== "branch" &&
-                fileSummary.sourceFilesWithContent > 0) {
+            // Trigger CSS pre-generation after the initial file snapshot is ready.
+            // This keeps stylesheet generation off the first styles request for both
+            // preview branches and published content.
+            if (fileSummary.sourceFilesWithContent > 0) {
                 this.triggerCSSPregeneration(files).catch(() => {
                     // Error already logged in triggerCSSPregeneration
                 });
@@ -326,6 +327,12 @@ export class VeryfrontFSAdapter {
                 });
                 const files = await fetchFileListForContext(this.client, warmupContext);
                 await this.cache.setAsync(effectiveCacheKey, files);
+                const fileSummary = summarizeFileList(files);
+                if (fileSummary.sourceFilesWithContent > 0) {
+                    this.triggerCSSPregeneration(files).catch(() => {
+                        // Error already logged in triggerCSSPregeneration
+                    });
+                }
                 logger.debug("File list warmup complete", {
                     reason,
                     cacheKey: effectiveCacheKey,
@@ -542,31 +549,49 @@ export class VeryfrontFSAdapter {
     async triggerCSSPregeneration(files) {
         try {
             const { pregenerateCSSFromFiles, findStylesheetFromFiles } = await import("../../../../html/styles-builder/css-pregeneration.js");
+            const { resolveStyleContentVersion } = await import("../../../../html/styles-builder/content-version.js");
+            const { createStyleScopeProfile } = await import("../../../../html/styles-builder/style-scope-profile.js");
             let stylesheetPath;
+            let styleProfile = createStyleScopeProfile();
             const projectDir = this.normalizer.getProjectDir();
-            if (projectDir) {
-                try {
-                    const { runtime } = await import("../../registry.js");
-                    const { getConfig } = await import("../../../../config/index.js");
-                    const adapter = await runtime.get();
-                    const cacheKey = this.client.getProjectId() || this.projectSlug;
-                    const config = await getConfig(projectDir, adapter, { cacheKey });
-                    stylesheetPath = config?.tailwind?.stylesheet;
-                }
-                catch (error) {
-                    logger.debug("Failed to load config for CSS pre-generation", {
-                        projectSlug: this.projectSlug,
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
+            if (!projectDir) {
+                logger.debug("Skipping CSS pre-generation without projectDir", {
+                    projectSlug: this.projectSlug,
+                });
+                return;
+            }
+            try {
+                const { runtime } = await import("../../registry.js");
+                const { getConfig } = await import("../../../../config/index.js");
+                const adapter = await runtime.get();
+                const cacheKey = this.client.getProjectId() || this.projectSlug;
+                const config = await getConfig(projectDir, adapter, { cacheKey });
+                stylesheetPath = config?.tailwind?.stylesheet;
+                styleProfile = createStyleScopeProfile(config);
+            }
+            catch (error) {
+                logger.debug("Failed to load config for CSS pre-generation", {
+                    projectSlug: this.projectSlug,
+                    error: error instanceof Error ? error.message : String(error),
+                });
             }
             const stylesheet = findStylesheetFromFiles(files, stylesheetPath);
+            const projectVersion = resolveStyleContentVersion(this.contentContext, {
+                branch: this.contentContext?.branch ?? null,
+                releaseId: this.contentContext?.releaseId ?? null,
+                environmentName: this.contentContext?.environmentName ?? null,
+            });
             await pregenerateCSSFromFiles({
                 projectSlug: this.projectSlug,
+                projectVersion,
+                projectDir,
                 files,
+                styleProfile,
                 stylesheet,
                 stylesheetPath,
                 minify: true,
+                environment: "preview",
+                buildMode: "production",
             });
         }
         catch (error) {

package/esm/src/platform/adapters/fs/veryfront/default-invalidation-callbacks.d.ts

@@ -0,0 +1,3 @@
+import type { InvalidationCallbacks } from "./types.js";
+export declare function createDefaultInvalidationCallbacks(callbacks?: InvalidationCallbacks): InvalidationCallbacks;
+//# sourceMappingURL=default-invalidation-callbacks.d.ts.map

package/esm/src/platform/adapters/fs/veryfront/default-invalidation-callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-invalidation-callbacks.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/default-invalidation-callbacks.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,kCAAkC,CAChD,SAAS,CAAC,EAAE,qBAAqB,GAChC,qBAAqB,CAgBvB"}

package/esm/src/platform/adapters/fs/veryfront/default-invalidation-callbacks.js

@@ -0,0 +1,25 @@
+import { clearSSRModuleCache, clearSSRModuleCacheForProject, } from "../../../../modules/react-loader/ssr-module-loader/cache/index.js";
+import { clearRouterDetectionCacheForProject } from "../../../../rendering/router-detection.js";
+import { clearModulePathCache, invalidateModulePaths, } from "../../../../transforms/mdx/esm-module-loader/cache/index.js";
+import { clearSnippetCacheForProject } from "../../../../rendering/snippet-renderer.js";
+import { clearRendererCacheForProject } from "../../../../rendering/renderer.js";
+import { invalidateProjectCSS } from "../../../../html/styles-builder/tailwind-compiler.js";
+import { invalidatePreparedProjectCSS } from "../../../../html/styles-builder/prepared-project-css-cache.js";
+import { invalidateProjectCandidateManifests } from "../../../../rendering/orchestrator/css-candidate-manifest.js";
+export function createDefaultInvalidationCallbacks(callbacks) {
+    return {
+        clearSSRModuleCache,
+        clearModulePathCache,
+        invalidateModulePaths,
+        clearSSRModuleCacheForProject,
+        clearRouterDetectionCacheForProject,
+        clearSnippetCacheForProject,
+        clearRendererCacheForProject,
+        clearProjectCSSCache: (projectSlug) => {
+            invalidateProjectCSS(projectSlug);
+            invalidatePreparedProjectCSS(projectSlug);
+            invalidateProjectCandidateManifests(projectSlug);
+        },
+        ...callbacks,
+    };
+}

package/esm/src/platform/adapters/fs/veryfront/proxy-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/proxy-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AAyBtF,UAAU,2BAA2B;IACnC,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAyC;gBAElD,MAAM,EAAE,2BAA2B;IAkBzC,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,OAAO,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,kBAAkB,CAAC;IA+H9B,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,aAAa;IA4GrB,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,mBAAmB;IAY3B,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,OAAO,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO;IAUV,QAAQ,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE;IAUnE,OAAO,IAAI,IAAI;CAchB"}
+{"version":3,"file":"proxy-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/proxy-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AAetF,UAAU,2BAA2B;IACnC,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAyC;gBAElD,MAAM,EAAE,2BAA2B;IAkBzC,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,OAAO,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,kBAAkB,CAAC;IA+H9B,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,wBAAwB;IAyChC,OAAO,CAAC,aAAa;IAqGrB,OAAO,CAAC,sBAAsB;IAsB9B,OAAO,CAAC,mBAAmB;IAY3B,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,OAAO,EACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO;IAUV,QAAQ,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE;IAUnE,OAAO,IAAI,IAAI;CAchB"}

package/esm/src/platform/adapters/fs/veryfront/proxy-manager.js

@@ -3,12 +3,8 @@ import { logger as baseLogger } from "../../../../utils/index.js";
 import { CACHE_INVARIANT_VIOLATION, INVALID_ARGUMENT } from "../../../../errors/index.js";
 import { buildProxyManagerCacheKey } from "../../../../cache/index.js";
 import { VeryfrontFSAdapter } from "./index.js";
-import { clearSSRModuleCache, clearSSRModuleCacheForProject, } from "../../../../modules/react-loader/ssr-module-loader/cache/index.js";
-import { clearRouterDetectionCacheForProject } from "../../../../rendering/router-detection.js";
-import { clearModulePathCache, invalidateModulePaths, } from "../../../../transforms/mdx/esm-module-loader/cache/index.js";
-import { clearSnippetCacheForProject } from "../../../../rendering/snippet-renderer.js";
-import { clearRendererCacheForProject } from "../../../../rendering/renderer.js";
 import { GetAdapterParamsSchema } from "./schemas/index.js";
+import { createDefaultInvalidationCallbacks } from "./default-invalidation-callbacks.js";
 const logger = baseLogger.component("proxy-fs-adapter-manager");
 const DEFAULT_MAX_ADAPTERS = 100;
 const DEFAULT_MAX_IDLE_MS = 30 * 60 * 1_000;
@@ -193,16 +189,7 @@ export class ProxyFSAdapterManager {
                 projectId,
                 apiToken: effectiveToken,
             },
-            invalidationCallbacks: {
-                clearSSRModuleCache,
-                clearModulePathCache,
-                invalidateModulePaths,
-                clearSSRModuleCacheForProject,
-                clearRouterDetectionCacheForProject,
-                clearSnippetCacheForProject,
-                clearRendererCacheForProject,
-                ...this.baseConfig.invalidationCallbacks,
-            },
+            invalidationCallbacks: createDefaultInvalidationCallbacks(this.baseConfig.invalidationCallbacks),
         };
         const adapter = new VeryfrontFSAdapter(config);
         let context;

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.d.ts

@@ -17,6 +17,10 @@ interface WebSocketDeps {
         path: string;
         content?: string;
     }>) => Promise<void>;
+    pregenerateStyles?: (files: Array<{
+        path: string;
+        content?: string;
+    }>) => Promise<void>;
 }
 export declare class WebSocketManager {
     private readonly deps;

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/websocket-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwB/F,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAE7C,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,gBAAgB,EAAE,MAAM,aAAa,CAAC;IACtC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAqBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IApBjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,gBAAgB,CAAuD;IAC/E,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAsD;IAC/E,OAAO,CAAC,0BAA0B,CAAsD;IACxF,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,2BAA2B;IAUnC,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAID,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA+GhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,IAAI,IAAI;IA8Bf,OAAO,CAAC,iBAAiB;IAyJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YAwI5B,mBAAmB;IA2IjC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAyBpB"}
+{"version":3,"file":"websocket-manager.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/websocket-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAwB/F,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAE7C,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,gBAAgB,EAAE,MAAM,aAAa,CAAC;IACtC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACxC,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,gBAAgB,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAC7C,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzF;AAED,qBAAa,gBAAgB;IAqBf,OAAO,CAAC,QAAQ,CAAC,IAAI;IApBjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,gBAAgB,CAAuD;IAC/E,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAsD;IAC/E,OAAO,CAAC,0BAA0B,CAAsD;IACxF,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,0BAA0B,CAAK;IACvC,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,WAAW,CAIjB;gBAE2B,IAAI,EAAE,aAAa;IAEhD,OAAO,CAAC,uBAAuB;IAK/B,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,2BAA2B;IAUnC,cAAc,IAAI;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;IAID,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IA+GhC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,IAAI,IAAI;IA8Bf,OAAO,CAAC,iBAAiB;IAyJzB,OAAO,CAAC,8BAA8B;IA0GtC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,6BAA6B;YAiBvB,4BAA4B;YAyI5B,mBAAmB;IA4IjC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAyBpB"}

package/esm/src/platform/adapters/fs/veryfront/websocket-manager.js

@@ -481,6 +481,7 @@ export class WebSocketManager {
                     const cacheKey = buildFileListCacheKey(contentContext);
                     await this.deps.setFileListCache(cacheKey, files);
                     this.deps.clearFileListIndex();
+                    await this.deps.pregenerateStyles?.(files);
                     logger.debug("Fresh files cached (memory + Redis)", {
                         cacheKey,
                         fileCount: files.length,
@@ -586,6 +587,7 @@ export class WebSocketManager {
                     const cacheKey = buildFileListCacheKey(contentContext);
                     await this.deps.setFileListCache(cacheKey, files);
                     this.deps.clearFileListIndex();
+                    await this.deps.pregenerateStyles?.(files);
                     logger.debug("FRESH FILES FETCHED", {
                         cacheKey,
                         fileCount: files.length,

package/esm/src/rendering/orchestrator/css-candidate-manifest.d.ts

@@ -1,3 +1,4 @@
+import { type StyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
 interface SourceFileLike {
     path: string;
     content?: string;
@@ -6,6 +7,7 @@ interface RouteCandidateOptions {
     projectScope: string;
     projectVersion: string;
     projectDir: string;
+    styleProfile?: StyleScopeProfile;
     routeKey: string;
     routeFilePaths: string[];
     files: SourceFileLike[];
@@ -15,6 +17,7 @@ interface ProjectCandidateOptions {
     projectScope: string;
     projectVersion: string;
     projectDir: string;
+    styleProfile?: StyleScopeProfile;
     files: SourceFileLike[];
     developmentMode: boolean;
 }

package/esm/src/rendering/orchestrator/css-candidate-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AA0GD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAkC9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}
+{"version":3,"file":"css-candidate-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/css-candidate-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kDAAkD,CAAC;AAI1D,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAqHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,GAAG,CAAC,MAAM,CAAC,CAuC9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAc/E"}

package/esm/src/rendering/orchestrator/css-candidate-manifest.js

@@ -1,4 +1,5 @@
 import { extractCandidates } from "../../html/styles-builder/tailwind-compiler.js";
+import { filterFilesForStyleScope, } from "../../html/styles-builder/style-scope-profile.js";
 import { getRouteModulePaths } from "../../modules/manifest/route-module-manifest.js";
 import { rendererLogger } from "../../utils/index.js";
 const logger = rendererLogger.component("css-candidate-manifest");
@@ -17,8 +18,8 @@ function toRelativeProjectPath(path, projectDir) {
     }
     return normalized.replace(/^\/+/, "");
 }
-function buildManifestCacheKey(projectScope, projectVersion) {
-    return `${projectScope}:${projectVersion}`;
+function buildManifestCacheKey(projectScope, projectVersion, styleProfileHash) {
+    return `${projectScope}:${projectVersion}:${styleProfileHash ?? "default"}`;
 }
 function shouldRebuildManifest(existing, developmentMode) {
     if (!existing)
@@ -59,10 +60,13 @@ function buildCandidateManifest(files, projectDir) {
     return { fileCandidates, allCandidates, builtAt: Date.now() };
 }
 function getOrBuildManifest(options) {
-    const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
+    const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion, options.styleProfile?.hash);
     const existingManifest = manifestCache.get(manifestKey);
+    const scopedFiles = options.styleProfile
+        ? filterFilesForStyleScope(options.files, options.styleProfile, options.projectDir)
+        : options.files;
     const manifest = shouldRebuildManifest(existingManifest, options.developmentMode)
-        ? buildCandidateManifest(options.files, options.projectDir)
+        ? buildCandidateManifest(scopedFiles, options.projectDir)
         : existingManifest;
     if (manifest !== existingManifest) {
         manifestCache.set(manifestKey, manifest);
@@ -87,7 +91,7 @@ function addCandidatesForPath(target, manifest, path, projectDir) {
  * Resolve route-scoped Tailwind candidates from a precomputed per-project manifest.
  */
 export function getRouteCandidates(options) {
-    const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion);
+    const manifestKey = buildManifestCacheKey(options.projectScope, options.projectVersion, options.styleProfile?.hash);
     const manifest = getOrBuildManifest(options);
     const routeCacheKey = `${manifestKey}:${options.routeKey}`;
     const cachedRoute = routeCandidateCache.get(routeCacheKey);
@@ -111,6 +115,7 @@ export function getRouteCandidates(options) {
     logger.debug("Resolved route candidates", {
         projectScope: options.projectScope,
         projectVersion: options.projectVersion,
+        styleProfileHash: options.styleProfile?.hash,
         route: options.routeKey,
         count: routeCandidates.size,
     });

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;AAQ7D,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;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,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;IAWjE,kBAAkB,CACtB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC;YAmCZ,sBAAsB;YAsBtB,wBAAwB;YAmBxB,gBAAgB;YAehB,kBAAkB;IAsDhC,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;YAQR,eAAe;YAaf,gBAAgB;IAwE9B;;;;OAIG;YACW,gBAAgB;IA2D9B,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,qBAAqB;YAOf,6BAA6B;CAwD5C"}
+{"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;AAQ7D,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;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiBhD,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;IAWjE,kBAAkB,CACtB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC;YAmCZ,sBAAsB;YAsBtB,wBAAwB;YAmBxB,gBAAgB;YAehB,kBAAkB;IAsDhC,OAAO,CAAC,iBAAiB;IA4DzB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;YAQR,eAAe;YAaf,gBAAgB;IAwE9B;;;;OAIG;YACW,gBAAgB;IA2D9B,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,qBAAqB;YAOf,6BAA6B;CAyD5C"}

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

@@ -9,6 +9,8 @@ import { resolveAppComponentPath } from "../layouts/utils/app-resolver.js";
 import { StreamTimeoutError, streamToString } from "../utils/stream-utils.js";
 import { normalizeCssModuleKey, rewriteCssModuleContent, } from "../../transforms/css-modules/naming.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";
 const logger = rendererLogger.component("html-generator");
 export class HTMLGenerator {
     config;
@@ -317,6 +319,11 @@ export class HTMLGenerator {
         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) {
@@ -351,6 +358,7 @@ export class HTMLGenerator {
             projectScope,
             projectVersion,
             projectDir: this.config.projectDir,
+            styleProfile: createStyleScopeProfile(this.config.config),
             routeKey,
             routeFilePaths,
             files,

package/esm/src/server/handlers/dev/styles-candidate-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles-candidate-scanner.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-candidate-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8BlD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CA0CxF"}
+{"version":3,"file":"styles-candidate-scanner.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-candidate-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAgDxF"}

package/esm/src/server/handlers/dev/styles-candidate-scanner.js

@@ -8,6 +8,8 @@
  * @module server/handlers/dev/styles-candidate-scanner
  */
 import { extractCandidates } from "../../../html/styles-builder/tailwind-compiler.js";
+import { resolveStyleContentVersion } from "../../../html/styles-builder/content-version.js";
+import { createStyleScopeProfile, shouldIncludeStylePath, shouldTraverseStyleDirectory, } from "../../../html/styles-builder/style-scope-profile.js";
 import { serverLogger } from "../../../utils/index.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import { join } from "../../../platform/compat/path/index.js";
@@ -15,22 +17,8 @@ import { getProjectCandidates } from "../../../rendering/orchestrator/css-candid
 import { FRAMEWORK_CANDIDATES } from "./framework-candidates.generated.js";
 const logger = serverLogger.component("styles-candidate-scanner");
 const SOURCE_EXTENSIONS = [".tsx", ".jsx", ".mdx", ".ts", ".js"];
-const SKIP_DIRS = new Set(["node_modules", ".cache", ".git", "dist", "build", ".vscode"]);
 /** De-duplicated set of framework candidates, computed once at import time. */
 const frameworkCandidates = new Set(FRAMEWORK_CANDIDATES);
-function resolveProjectVersion(ctx, contentContext) {
-    if (contentContext?.releaseId)
-        return `release:${contentContext.releaseId}`;
-    if (contentContext?.branch)
-        return `branch:${contentContext.branch}`;
-    if (contentContext?.environmentName)
-        return `environment:${contentContext.environmentName}`;
-    if (ctx.releaseId)
-        return `release:${ctx.releaseId}`;
-    if (ctx.parsedDomain?.branch)
-        return `branch:${ctx.parsedDomain.branch}`;
-    return "live";
-}
 /**
  * Extract Tailwind CSS candidate class names from all project source files.
  *
@@ -39,6 +27,7 @@ function resolveProjectVersion(ctx, contentContext) {
  * method is available (local dev mode).
  */
 export async function extractProjectCandidates(ctx) {
+    const styleProfile = createStyleScopeProfile(ctx.config);
     const wrappedFs = ctx.adapter.fs;
     if (typeof wrappedFs.getUnderlyingAdapter !== "function") {
         logger.debug("[StylesCandidateScanner] No FS adapter wrapper, falling back to local file scanning");
@@ -57,8 +46,13 @@ export async function extractProjectCandidates(ctx) {
         : null;
     for (const cls of getProjectCandidates({
         projectScope: ctx.projectSlug ?? contentContext?.projectSlug ?? ctx.projectDir,
-        projectVersion: resolveProjectVersion(ctx, contentContext),
+        projectVersion: resolveStyleContentVersion(contentContext, {
+            releaseId: ctx.releaseId,
+            branch: ctx.parsedDomain?.branch,
+            environmentName: ctx.environmentName,
+        }),
         projectDir: ctx.projectDir,
+        styleProfile,
         files,
         developmentMode: contentContext?.sourceType === "branch",
     })) {
@@ -71,6 +65,7 @@ export async function extractProjectCandidates(ctx) {
  * Used in local development mode where projects are read directly from disk.
  */
 async function scanLocalFiles(projectDir, ctx) {
+    const styleProfile = createStyleScopeProfile(ctx.config);
     const candidates = new Set(frameworkCandidates);
     const fs = createFileSystem();
     const scanDir = async (dir) => {
@@ -85,12 +80,15 @@ async function scanLocalFiles(projectDir, ctx) {
         for await (const entry of entries) {
             const fullPath = join(dir, entry.name);
             if (entry.isDirectory) {
-                if (!SKIP_DIRS.has(entry.name))
+                if (shouldTraverseStyleDirectory(styleProfile, fullPath, projectDir)) {
                     await scanDir(fullPath);
+                }
                 continue;
             }
             if (!entry.isFile)
                 continue;
+            if (!shouldIncludeStylePath(styleProfile, fullPath, projectDir))
+                continue;
             if (!SOURCE_EXTENSIONS.some((ext) => entry.name.endsWith(ext)))
                 continue;
             try {

package/esm/src/server/handlers/dev/styles-css.handler.d.ts

@@ -12,5 +12,7 @@ export declare class StylesCSSHandler extends BaseHandler {
     handle(req: dntShim.Request, ctx: HandlerContext): Promise<HandlerResult>;
     private loadStylesheet;
     private generateStylesheet;
+    private getContentContext;
+    private createPreparedCSSContext;
 }
 //# sourceMappingURL=styles-css.handler.d.ts.map

package/esm/src/server/handlers/dev/styles-css.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBnG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAkGjE,cAAc;IAkB5B,OAAO,CAAC,kBAAkB;CAe3B"}
+{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBnG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAqIjE,cAAc;IAkB5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,wBAAwB;CAyBjC"}

package/esm/src/server/handlers/dev/styles-css.handler.js

@@ -1,8 +1,11 @@
 import { BaseHandler } from "../response/base.js";
 import { HTTP_OK, PRIORITY_HIGH_DEV } from "../../../utils/constants/index.js";
 import { joinPath } from "../../../utils/path-utils.js";
-import { formatCSSError, generateTailwindCSS, getProjectCSS, } from "../../../html/styles-builder/tailwind-compiler.js";
+import { formatCSSError, getProjectCSS } from "../../../html/styles-builder/tailwind-compiler.js";
 import { DEFAULT_STYLESHEET } from "../../../html/styles-builder/css-hash-cache.js";
+import { resolveStyleContentVersion } from "../../../html/styles-builder/content-version.js";
+import { createPreparedProjectCSSContext, storePreparedProjectCSS, tryGetPreparedProjectCSS, } from "../../../html/styles-builder/prepared-project-css-cache.js";
+import { createStyleScopeProfile } from "../../../html/styles-builder/style-scope-profile.js";
 import { serverLogger } from "../../../utils/index.js";
 import { extractProjectCandidates } from "./styles-candidate-scanner.js";
 const logger = serverLogger.component("styles-css-handler");
@@ -19,6 +22,9 @@ export class StylesCSSHandler extends BaseHandler {
         try {
             return await this.withProxyContext(ctx, async () => {
                 const responseBuilder = this.createResponseBuilder(ctx).withCache("no-cache");
+                const projectScope = ctx.projectSlug ?? ctx.projectDir;
+                const styleProfile = createStyleScopeProfile(ctx.config);
+                const contentContext = this.getContentContext(ctx);
                 let rawCss;
                 try {
                     rawCss = await this.loadStylesheet(ctx);
@@ -29,6 +35,19 @@ export class StylesCSSHandler extends BaseHandler {
                     });
                     rawCss = DEFAULT_STYLESHEET;
                 }
+                const preparedContext = this.createPreparedCSSContext(projectScope, rawCss, styleProfile.hash, contentContext, ctx);
+                if (preparedContext) {
+                    const prepared = await tryGetPreparedProjectCSS(preparedContext);
+                    if (prepared) {
+                        logger.debug("Prepared CSS cache hit", {
+                            projectScope,
+                            projectVersion: preparedContext.projectVersion,
+                            styleProfileHash: styleProfile.hash,
+                            cssHash: prepared.hash,
+                        });
+                        return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", prepared.css, HTTP_OK));
+                    }
+                }
                 let candidates;
                 try {
                     candidates = await extractProjectCandidates(ctx);
@@ -39,9 +58,12 @@ export class StylesCSSHandler extends BaseHandler {
                     });
                     candidates = new Set();
                 }
-                const result = await this.generateStylesheet(ctx, rawCss, candidates);
-                if ("error" in result && result.error) {
-                    const formatted = formatCSSError(result.error);
+                let result;
+                try {
+                    result = await this.generateStylesheet(ctx, rawCss, candidates);
+                }
+                catch (error) {
+                    const formatted = formatCSSError(error instanceof Error ? error : String(error));
                     logger.error("Tailwind error", {
                         error: formatted.message,
                         suggestion: formatted.suggestion,
@@ -78,11 +100,18 @@ body::before {
                     });
                 }
                 logger.debug("CSS generated", {
+                    projectScope,
                     candidates: candidates.size,
                     cssLength: result.css.length,
                     fromCache: "fromCache" in result ? result.fromCache : false,
                     cssHash: "hash" in result ? result.hash : undefined,
                 });
+                if (preparedContext && "hash" in result) {
+                    await storePreparedProjectCSS(preparedContext, {
+                        css: result.css,
+                        hash: result.hash,
+                    });
+                }
                 return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", result.css, HTTP_OK));
             });
         }
@@ -115,10 +144,28 @@ body::before {
         }
     }
     generateStylesheet(ctx, rawCss, candidates) {
-        if (!ctx.projectSlug) {
-            return generateTailwindCSS(rawCss, candidates);
-        }
-        return getProjectCSS(ctx.projectSlug, rawCss, candidates, {
+        const projectScope = ctx.projectSlug ?? ctx.projectDir;
+        return getProjectCSS(projectScope, rawCss, candidates, {
+            minify: true,
+            environment: "preview",
+            buildMode: "production",
+        });
+    }
+    getContentContext(ctx) {
+        const wrappedFs = ctx.adapter.fs;
+        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
+            return null;
+        const fsAdapter = wrappedFs.getUnderlyingAdapter();
+        return typeof fsAdapter.getContentContext === "function" ? fsAdapter.getContentContext() : null;
+    }
+    createPreparedCSSContext(projectScope, rawCss, styleProfileHash, contentContext, ctx) {
+        if (!projectScope)
+            return undefined;
+        return createPreparedProjectCSSContext(projectScope, resolveStyleContentVersion(contentContext, {
+            releaseId: ctx.releaseId,
+            branch: ctx.parsedDomain?.branch,
+            environmentName: ctx.environmentName,
+        }), rawCss, styleProfileHash, {
             minify: true,
             environment: "preview",
             buildMode: "production",

package/package.json

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

package/src/cli/commands/knowledge/command.ts

@@ -219,6 +219,23 @@ function slugify(value: string): string {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "document";
 }
 
+/**
+ * Strip the chat-upload prefix that Studio prepends to uploaded files.
+ *
+ * Studio stores uploads with a generated prefix like:
+ *   chat-<uuid>-<timestamp>-<shortid>-<original-filename>
+ *
+ * This function removes the prefix so knowledge files use the clean
+ * original filename (e.g. "agents" instead of
+ * "chat-909d3dbc-5a9a-4156-97e4-bcceb5c2ec0d-1773942180291-fv1qg5-agents").
+ */
+const CHAT_UPLOAD_PREFIX_RE =
+  /^chat-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-\d+-[a-z0-9]+-/i;
+
+export function stripChatUploadPrefix(name: string): string {
+  return name.replace(CHAT_UPLOAD_PREFIX_RE, "");
+}
+
 function defaultOutputRoot(): Promise<string> {
   return dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-" });
 }
@@ -361,7 +378,7 @@ function buildSourceReference(source: KnowledgeSource): string {
     : source.localPath;
 }
 
-function buildSuggestedSlug(source: KnowledgeSource, index: number): string {
+export function buildSuggestedSlug(source: KnowledgeSource, index: number): string {
   const normalized = normalize(
     source.kind === "upload" ? source.uploadPath : source.localPath,
   ).replace(/\\/g, "/");
@@ -383,9 +400,20 @@ function buildSuggestedSlug(source: KnowledgeSource, index: number): string {
     stripped = normalized.replace(/\.[^.]+$/, "");
   }
 
+  // Strip Studio's chat-upload prefix from the filename portion so that
+  // knowledge files use the original clean filename.
+  const lastSlash = stripped.lastIndexOf("/");
+  if (lastSlash >= 0) {
+    const dir = stripped.slice(0, lastSlash + 1);
+    const file = stripChatUploadPrefix(stripped.slice(lastSlash + 1));
+    stripped = file ? `${dir}${file}` : stripped;
+  } else {
+    stripped = stripChatUploadPrefix(stripped) || stripped;
+  }
+
   return slugify(stripped || basename(normalized, extname(normalized)) || `document-${index + 1}`);
 }
-function ensureUniqueSlugs(sources: KnowledgeSource[]): string[] {
+export function ensureUniqueSlugs(sources: KnowledgeSource[]): string[] {
   const counts = new Map<string, number>();
   return sources.map((source, index) => {
     const baseSlug = buildSuggestedSlug(source, index);