veryfront 0.1.88 → 0.1.90

package/esm/cli/commands/knowledge/command.d.ts

@@ -108,7 +108,10 @@ export declare function normalizeKnowledgeInputPath(inputPath: string): string;
 export declare function normalizeProjectUploadPath(inputPath: string): string;
 export declare function formatKnowledgeUploadSource(uploadPath: string): string;
 export declare function isLikelyLocalPath(value: string): boolean;
+export declare function stripChatUploadPrefix(name: string): string;
 export declare function resolveKnowledgeDownloadOutputDir(outputDir: string): string;
+export declare function buildSuggestedSlug(source: KnowledgeSource, index: number): string;
+export declare function ensureUniqueSlugs(sources: KnowledgeSource[]): string[];
 export declare function deriveKnowledgeRemotePath(outputPath: string, outputDir: string, knowledgePath: string): string;
 export declare function createKnowledgeIngestResult(input: {
     source: string;

package/esm/cli/commands/knowledge/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,KAAK,SAAS,EAA0C,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAuB,KAAK,MAAM,EAAgB,MAAM,6BAA6B,CAAC;AAG7F,OAAO,EAEL,KAAK,+BAA+B,EAEpC,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACtC,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,KAAK,eAAe,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,gCAAgC,EAAE,CAAC;CAC7C;AAED,KAAK,cAAc,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAIhF,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmD7B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAoD/E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAexD;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtE;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAgBD,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AA0KD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC;CAChG,GAAG,yBAAyB,CAY5B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuDjC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC,EAC/E,IAAI,EAAE;IACJ,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE,GACA,OAAO,CAAC,yBAAyB,CAAC,CAuJpC;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE;IACJ,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,kBAAkB,CAAC;IACrC,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACA,OAAO,CAAC;IACT,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,MAAM,EAAE,+BAA+B,EAAE,CAAC;CAC3C,CAAC,CAsGD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwItE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"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"}

package/esm/cli/commands/knowledge/command.js

@@ -158,6 +158,20 @@ function isProjectUploadReference(value) {
 function slugify(value) {
     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) {
+    return name.replace(CHAT_UPLOAD_PREFIX_RE, "");
+}
 function defaultOutputRoot() {
     return dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-" });
 }
@@ -267,7 +281,7 @@ function buildSourceReference(source) {
         ? formatKnowledgeUploadSource(source.uploadPath)
         : source.localPath;
 }
-function buildSuggestedSlug(source, index) {
+export function buildSuggestedSlug(source, index) {
     const normalized = normalize(source.kind === "upload" ? source.uploadPath : source.localPath).replace(/\\/g, "/");
     let stripped;
     if (source.kind === "upload") {
@@ -289,9 +303,20 @@ function buildSuggestedSlug(source, index) {
     else {
         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) {
+export function ensureUniqueSlugs(sources) {
     const counts = new Map();
     return sources.map((source, index) => {
         const baseSlug = buildSuggestedSlug(source, index);

package/esm/deno.js

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

package/esm/src/html/styles-builder/candidate-extractor.d.ts

@@ -5,6 +5,7 @@
  *
  * @module html/styles-builder/candidate-extractor
  */
+import type { StyleScopeProfile } from "./style-scope-profile.js";
 /**
  * Extract potential Tailwind class name candidates from source code content.
  * Uses a comprehensive regex pattern matching Tailwind v4 utility patterns.
@@ -13,7 +14,10 @@ export declare function extractCandidates(content: string): string[];
 export declare function extractCandidatesFromFiles(files: Array<{
     path: string;
     content?: string;
-}>): Set<string>;
+}>, options?: {
+    projectDir?: string;
+    styleProfile?: StyleScopeProfile;
+}): Set<string>;
 /**
  * Simple DJB2-style hash function.
  */

package/esm/src/html/styles-builder/candidate-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"candidate-extractor.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/candidate-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,GAAG,CAAC,MAAM,CAAC,CAcb;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAE9D"}
+{"version":3,"file":"candidate-extractor.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/candidate-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAG3D;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAC7B,GACL,GAAG,CAAC,MAAM,CAAC,CAoBb;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAE9D"}

package/esm/src/html/styles-builder/candidate-extractor.js

@@ -5,6 +5,7 @@
  *
  * @module html/styles-builder/candidate-extractor
  */
+import { shouldIncludeStylePath } from "./style-scope-profile.js";
 /**
  * Extract potential Tailwind class name candidates from source code content.
  * Uses a comprehensive regex pattern matching Tailwind v4 utility patterns.
@@ -13,12 +14,16 @@ export function extractCandidates(content) {
     const pattern = /!?-?@?(?:[a-zA-Z0-9]|\[&?)[a-zA-Z0-9_\-:\/\.\[\]%#,()!'=<>$@{}|*+?;^~]*/g;
     return [...new Set(content.match(pattern) ?? [])];
 }
-export function extractCandidatesFromFiles(files) {
+export function extractCandidatesFromFiles(files, options = {}) {
     const candidates = new Set();
     const sourceExtensions = [".tsx", ".jsx", ".ts", ".js", ".mdx"];
     for (const file of files) {
         if (!file.content)
             continue;
+        if (options.styleProfile &&
+            !shouldIncludeStylePath(options.styleProfile, file.path, options.projectDir)) {
+            continue;
+        }
         if (!sourceExtensions.some((ext) => file.path.endsWith(ext)))
             continue;
         for (const candidate of extractCandidates(file.content)) {

package/esm/src/html/styles-builder/content-version.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedContentContext } from "../../platform/adapters/fs/veryfront/types.js";
+interface ContentVersionFallback {
+    releaseId?: string | null;
+    branch?: string | null;
+    environmentName?: string | null;
+}
+export declare function resolveStyleContentVersion(contentContext: ResolvedContentContext | null, fallback?: ContentVersionFallback): string;
+export {};
+//# sourceMappingURL=content-version.d.ts.map

package/esm/src/html/styles-builder/content-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-version.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/content-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAE5F,UAAU,sBAAsB;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,sBAAsB,GAAG,IAAI,EAC7C,QAAQ,GAAE,sBAA2B,GACpC,MAAM,CAQR"}

package/esm/src/html/styles-builder/content-version.js

@@ -0,0 +1,15 @@
+export function resolveStyleContentVersion(contentContext, fallback = {}) {
+    if (contentContext?.releaseId)
+        return `release:${contentContext.releaseId}`;
+    if (contentContext?.branch)
+        return `branch:${contentContext.branch}`;
+    if (contentContext?.environmentName)
+        return `environment:${contentContext.environmentName}`;
+    if (fallback.releaseId)
+        return `release:${fallback.releaseId}`;
+    if (fallback.branch)
+        return `branch:${fallback.branch}`;
+    if (fallback.environmentName)
+        return `environment:${fallback.environmentName}`;
+    return "live";
+}

package/esm/src/html/styles-builder/css-pregeneration.d.ts

@@ -5,20 +5,31 @@
  * until HTML shell generation during SSR. This runs in parallel with other
  * initialization work, reducing first-request latency by ~2-3 seconds.
  */
+import type { StyleScopeProfile } from "./style-scope-profile.js";
 interface CSSPregenerationOptions {
     /** Project slug for cache keying */
     projectSlug: string;
+    /** Current content version for the prepared stylesheet artifact */
+    projectVersion: string;
+    /** Project root used for style scope filtering */
+    projectDir?: string;
     /** List of files with content to extract candidates from */
     files: Array<{
         path: string;
         content?: string;
     }>;
+    /** Style scope profile for convention-based filtering */
+    styleProfile: StyleScopeProfile;
     /** Optional custom stylesheet (globals.css content) */
     stylesheet?: string;
     /** Optional stylesheet path (from config) to locate content in files */
     stylesheetPath?: string;
     /** Enable minification (default: true) */
     minify?: boolean;
+    /** Environment segment used for prepared artifact cache partitioning */
+    environment?: string;
+    /** Build mode recorded in the prepared artifact profile */
+    buildMode?: "development" | "production";
 }
 /**
  * Pre-generate and cache CSS from file list.

package/esm/src/html/styles-builder/css-pregeneration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css-pregeneration.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/css-pregeneration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,UAAU,uBAAuB;IAC/B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,MAAM,GAAG,SAAS,CAgBpB"}
+{"version":3,"file":"css-pregeneration.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/css-pregeneration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,UAAU,uBAAuB;IAC/B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,yDAAyD;IACzD,YAAY,EAAE,iBAAiB,CAAC;IAChC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAChD,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C,MAAM,GAAG,SAAS,CAgBpB"}

package/esm/src/html/styles-builder/css-pregeneration.js

@@ -7,6 +7,7 @@
  */
 import { serverLogger } from "../../utils/index.js";
 import { extractCandidatesFromFiles, getProjectCSS } from "./tailwind-compiler.js";
+import { createPreparedProjectCSSContext, storePreparedProjectCSS, } from "./prepared-project-css-cache.js";
 const logger = serverLogger.component("css-pregeneration");
 /**
  * Pre-generate and cache CSS from file list.
@@ -21,28 +22,32 @@ const logger = serverLogger.component("css-pregeneration");
  * @returns Promise that resolves when CSS is generated (or immediately on error)
  */
 export async function pregenerateCSSFromFiles(options) {
-    const { projectSlug, files, stylesheet, stylesheetPath, minify = true } = options;
+    const { projectSlug, projectVersion, projectDir, files, styleProfile, stylesheet, stylesheetPath, minify = true, environment = "preview", buildMode = "production", } = options;
     const startTime = performance.now();
     try {
-        const candidates = extractCandidatesFromFiles(files);
-        if (candidates.size === 0) {
-            logger.debug("No candidates found, skipping", {
-                projectSlug,
-                fileCount: files.length,
-            });
-            return;
-        }
         const resolvedStylesheet = stylesheet ?? findStylesheetFromFiles(files, stylesheetPath);
+        const candidates = extractCandidatesFromFiles(files, {
+            projectDir,
+            styleProfile,
+        });
         logger.debug("Starting", {
             projectSlug,
+            projectVersion,
             fileCount: files.length,
             candidateCount: candidates.size,
             hasStylesheet: Boolean(resolvedStylesheet),
+            styleProfileHash: styleProfile.hash,
+        });
+        const result = await getProjectCSS(projectSlug, resolvedStylesheet, candidates, {
+            minify,
+            environment,
+            buildMode,
         });
-        const result = await getProjectCSS(projectSlug, resolvedStylesheet, candidates, { minify });
+        await storePreparedProjectCSS(createPreparedProjectCSSContext(projectSlug, projectVersion, resolvedStylesheet, styleProfile.hash, { minify, environment, buildMode }), { css: result.css, hash: result.hash });
         const duration = performance.now() - startTime;
         logger.debug("Complete", {
             projectSlug,
+            projectVersion,
             candidateCount: candidates.size,
             cssLength: result.css.length,
             cssHash: result.hash,

package/esm/src/html/styles-builder/prepared-project-css-cache.d.ts

@@ -0,0 +1,31 @@
+interface PreparedProjectCSSCacheEntry {
+    css: string;
+    hash: string;
+}
+interface PreparedProjectCSSProfile {
+    minify?: boolean;
+    environment?: string;
+    buildMode?: "development" | "production";
+}
+export interface PreparedProjectCSSRequestContext {
+    projectSlug: string;
+    projectVersion: string;
+    stylesheet: string;
+    stylesheetHash: string;
+    styleProfileHash: string;
+    environment: string;
+    profileHash: string;
+    cacheKey: string;
+}
+export declare function initializePreparedProjectCSSCache(): Promise<boolean>;
+export declare function createPreparedProjectCSSContext(projectSlug: string, projectVersion: string, stylesheet: string | undefined, styleProfileHash: string, profile?: PreparedProjectCSSProfile): PreparedProjectCSSRequestContext;
+export declare function tryGetPreparedProjectCSS(context: PreparedProjectCSSRequestContext): Promise<{
+    css: string;
+    hash: string;
+    fromCache: true;
+} | undefined>;
+export declare function storePreparedProjectCSS(context: PreparedProjectCSSRequestContext, entry: PreparedProjectCSSCacheEntry): Promise<void>;
+export declare function invalidatePreparedProjectCSS(projectSlug: string): void;
+export declare function invalidatePreparedProjectCSSAsync(projectSlug: string): Promise<void>;
+export {};
+//# sourceMappingURL=prepared-project-css-cache.d.ts.map

package/esm/src/html/styles-builder/prepared-project-css-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-project-css-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/prepared-project-css-cache.ts"],"names":[],"mappings":"AAYA,UAAU,4BAA4B;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,UAAU,yBAAyB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;CAC1C;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwDD,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,OAAO,CAAC,CAuB1E;AAED,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,yBAAyB,GAClC,gCAAgC,CAwBlC;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG,SAAS,CAAC,CAgCrE;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,gCAAgC,EACzC,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAUtE;AAED,wBAAsB,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1F"}

package/esm/src/html/styles-builder/prepared-project-css-cache.js

@@ -0,0 +1,165 @@
+import { createCacheBackend, MemoryCacheBackend, } from "../../cache/backend.js";
+import { registerCache } from "../../utils/memory/index.js";
+import { serverLogger } from "../../utils/index.js";
+import { DEFAULT_STYLESHEET } from "./css-hash-cache.js";
+import { resolveStylesheet } from "./tailwind-compiler-utils.js";
+const logger = serverLogger.component("prepared-project-css-cache");
+const PREPARED_PROJECT_CSS_CACHE_TTL_SECONDS = 24 * 3600;
+const PREPARED_PROJECT_CSS_LOCAL_MAX = 50;
+const PREPARED_PROJECT_CSS_LOCAL_TTL_MS = PREPARED_PROJECT_CSS_CACHE_TTL_SECONDS * 1000;
+let preparedProjectCSSBackend = null;
+let preparedProjectCSSInitialized = false;
+let preparedProjectCSSInitPromise = null;
+const localPreparedProjectCSS = new Map();
+registerCache("prepared-project-css-cache", () => ({
+    name: "prepared-project-css-cache",
+    entries: localPreparedProjectCSS.size,
+    maxEntries: PREPARED_PROJECT_CSS_LOCAL_MAX,
+    backend: preparedProjectCSSBackend?.type ?? "uninitialized",
+}));
+function hashValue(input) {
+    let hash = 0;
+    for (let index = 0; index < input.length; index++) {
+        hash = ((hash << 5) - hash) + input.charCodeAt(index);
+        hash |= 0;
+    }
+    return hash.toString(36);
+}
+function setLocalEntry(key, entry) {
+    localPreparedProjectCSS.set(key, {
+        ...entry,
+        expiresAt: Date.now() + PREPARED_PROJECT_CSS_LOCAL_TTL_MS,
+    });
+    if (localPreparedProjectCSS.size <= PREPARED_PROJECT_CSS_LOCAL_MAX)
+        return;
+    const keys = localPreparedProjectCSS.keys();
+    while (localPreparedProjectCSS.size > PREPARED_PROJECT_CSS_LOCAL_MAX) {
+        const result = keys.next();
+        if (result.done)
+            break;
+        localPreparedProjectCSS.delete(result.value);
+    }
+}
+function parsePreparedProjectCSSCacheEntry(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.css !== "string" || typeof parsed.hash !== "string")
+            return null;
+        return { css: parsed.css, hash: parsed.hash };
+    }
+    catch {
+        return null;
+    }
+}
+export async function initializePreparedProjectCSSCache() {
+    if (preparedProjectCSSInitialized)
+        return preparedProjectCSSBackend?.type !== "memory";
+    if (!preparedProjectCSSInitPromise) {
+        preparedProjectCSSInitPromise = (async () => {
+            try {
+                preparedProjectCSSBackend = await createCacheBackend({
+                    keyPrefix: "prepared-project-css",
+                });
+                logger.debug("Initialized", { backend: preparedProjectCSSBackend.type });
+            }
+            catch (error) {
+                logger.warn("Backend init failed, using memory", { error });
+                preparedProjectCSSBackend = new MemoryCacheBackend(PREPARED_PROJECT_CSS_LOCAL_MAX);
+            }
+            finally {
+                preparedProjectCSSInitialized = true;
+            }
+        })();
+    }
+    await preparedProjectCSSInitPromise;
+    preparedProjectCSSInitPromise = null;
+    return preparedProjectCSSBackend?.type !== "memory";
+}
+export function createPreparedProjectCSSContext(projectSlug, projectVersion, stylesheet, styleProfileHash, profile) {
+    const resolvedStylesheet = resolveStylesheet(stylesheet, DEFAULT_STYLESHEET);
+    const stylesheetHash = hashValue(resolvedStylesheet);
+    const environment = profile?.environment ?? "preview";
+    const profileHash = hashValue(JSON.stringify({
+        cacheSchema: "v1",
+        minify: profile?.minify ?? false,
+        buildMode: profile?.buildMode ?? "production",
+        environment,
+    }));
+    return {
+        projectSlug,
+        projectVersion,
+        stylesheet: resolvedStylesheet,
+        stylesheetHash,
+        styleProfileHash,
+        environment,
+        profileHash,
+        cacheKey: `${projectSlug}:${environment}:prepared:${projectVersion}:${stylesheetHash}:${styleProfileHash}:${profileHash}`,
+    };
+}
+export async function tryGetPreparedProjectCSS(context) {
+    const local = localPreparedProjectCSS.get(context.cacheKey);
+    if (local && local.expiresAt > Date.now()) {
+        return { css: local.css, hash: local.hash, fromCache: true };
+    }
+    if (local) {
+        localPreparedProjectCSS.delete(context.cacheKey);
+    }
+    if (!preparedProjectCSSInitialized) {
+        await initializePreparedProjectCSSCache();
+    }
+    if (!preparedProjectCSSBackend)
+        return undefined;
+    try {
+        const raw = await preparedProjectCSSBackend.get(context.cacheKey);
+        if (!raw)
+            return undefined;
+        const entry = parsePreparedProjectCSSCacheEntry(raw);
+        if (!entry)
+            return undefined;
+        setLocalEntry(context.cacheKey, entry);
+        return { css: entry.css, hash: entry.hash, fromCache: true };
+    }
+    catch (error) {
+        logger.debug("Failed to read prepared project CSS", {
+            cacheKey: context.cacheKey,
+            error,
+        });
+        return undefined;
+    }
+}
+export async function storePreparedProjectCSS(context, entry) {
+    if (!preparedProjectCSSInitialized) {
+        await initializePreparedProjectCSSCache();
+    }
+    setLocalEntry(context.cacheKey, entry);
+    if (!preparedProjectCSSBackend)
+        return;
+    preparedProjectCSSBackend
+        .set(context.cacheKey, JSON.stringify(entry), PREPARED_PROJECT_CSS_CACHE_TTL_SECONDS)
+        .catch((error) => {
+        logger.debug("Failed to store prepared project CSS", {
+            cacheKey: context.cacheKey,
+            error,
+        });
+    });
+}
+export function invalidatePreparedProjectCSS(projectSlug) {
+    for (const key of localPreparedProjectCSS.keys()) {
+        if (key.startsWith(`${projectSlug}:`)) {
+            localPreparedProjectCSS.delete(key);
+        }
+    }
+    invalidatePreparedProjectCSSAsync(projectSlug).catch((error) => {
+        logger.debug("Failed to invalidate prepared project CSS", { projectSlug, error });
+    });
+}
+export async function invalidatePreparedProjectCSSAsync(projectSlug) {
+    if (!preparedProjectCSSBackend?.delByPattern)
+        return;
+    try {
+        await preparedProjectCSSBackend.delByPattern(`${projectSlug}:*`);
+    }
+    catch (error) {
+        logger.debug("Failed to delete prepared project CSS", { projectSlug, error });
+    }
+}

package/esm/src/html/styles-builder/style-scope-profile.d.ts

@@ -0,0 +1,14 @@
+import type { VeryfrontConfig } from "../../config/index.js";
+export interface StyleScopeProfile {
+    hash: string;
+    ignoredRoots: string[];
+    protectedRoots: string[];
+    protectedPaths: string[];
+}
+export declare function createStyleScopeProfile(config?: VeryfrontConfig): StyleScopeProfile;
+export declare function shouldIncludeStylePath(profile: StyleScopeProfile, path: string, projectDir?: string): boolean;
+export declare function shouldTraverseStyleDirectory(profile: StyleScopeProfile, directoryPath: string, projectDir?: string): boolean;
+export declare function filterFilesForStyleScope<T extends {
+    path: string;
+}>(files: T[], profile: StyleScopeProfile, projectDir?: string): T[];
+//# sourceMappingURL=style-scope-profile.d.ts.map

package/esm/src/html/styles-builder/style-scope-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-scope-profile.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/style-scope-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAqB7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAkDD,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,iBAAiB,CA2CnF;AAUD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAMT;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAUT;AAED,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,iBAAiB,EAC1B,UAAU,CAAC,EAAE,MAAM,GAClB,CAAC,EAAE,CAEL"}

package/esm/src/html/styles-builder/style-scope-profile.js

@@ -0,0 +1,121 @@
+const DEFAULT_IGNORED_ROOTS = [
+    "knowledge",
+    "coverage",
+    "dist",
+    "build",
+    ".git",
+    "node_modules",
+    ".cache",
+];
+const DEFAULT_PROTECTED_ROOTS = [
+    "app",
+    "pages",
+    "components",
+    "src/app",
+    "src/pages",
+    "src/components",
+];
+function normalizePath(path) {
+    return path.replace(/\\/g, "/").replace(/\/{2,}/g, "/");
+}
+function normalizeRelativePath(path) {
+    return normalizePath(path).replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function toRelativeProjectPath(path, projectDir) {
+    const normalized = normalizePath(path);
+    const normalizedProjectDir = projectDir
+        ? normalizePath(projectDir).replace(/\/+$/, "")
+        : undefined;
+    if (normalizedProjectDir && normalized.startsWith(normalizedProjectDir)) {
+        return normalized.slice(normalizedProjectDir.length).replace(/^\/+/, "");
+    }
+    return normalized.replace(/^\/+/, "");
+}
+function isWithinPath(path, root) {
+    return path === root || path.startsWith(`${root}/`);
+}
+function getParentDirectory(path) {
+    const normalized = normalizeRelativePath(path);
+    const slashIndex = normalized.lastIndexOf("/");
+    if (slashIndex <= 0)
+        return null;
+    return normalized.slice(0, slashIndex);
+}
+function stableHash(input) {
+    let hash = 0;
+    for (let index = 0; index < input.length; index++) {
+        hash = ((hash << 5) - hash) + input.charCodeAt(index);
+        hash |= 0;
+    }
+    return hash.toString(36);
+}
+function addNormalizedPath(target, value) {
+    if (!value)
+        return;
+    const normalized = normalizeRelativePath(value);
+    if (!normalized)
+        return;
+    target.add(normalized);
+}
+export function createStyleScopeProfile(config) {
+    const ignoredRoots = new Set(DEFAULT_IGNORED_ROOTS);
+    const protectedRoots = new Set(DEFAULT_PROTECTED_ROOTS);
+    const protectedPaths = new Set();
+    addNormalizedPath(protectedRoots, config?.directories?.app);
+    addNormalizedPath(protectedRoots, config?.directories?.pages);
+    for (const path of config?.directories?.components ?? []) {
+        addNormalizedPath(protectedRoots, path);
+    }
+    const explicitPaths = [
+        typeof config?.layout === "string" ? config.layout : undefined,
+        typeof config?.app === "string" ? config.app : undefined,
+        config?.tailwind?.stylesheet,
+    ];
+    for (const path of explicitPaths) {
+        addNormalizedPath(protectedPaths, path);
+        addNormalizedPath(protectedRoots, getParentDirectory(path ?? ""));
+    }
+    for (const root of protectedRoots) {
+        ignoredRoots.delete(root);
+    }
+    const sortedIgnoredRoots = [...ignoredRoots].sort();
+    const sortedProtectedRoots = [...protectedRoots].sort();
+    const sortedProtectedPaths = [...protectedPaths].sort();
+    return {
+        ignoredRoots: sortedIgnoredRoots,
+        protectedRoots: sortedProtectedRoots,
+        protectedPaths: sortedProtectedPaths,
+        hash: stableHash(JSON.stringify({
+            ignoredRoots: sortedIgnoredRoots,
+            protectedRoots: sortedProtectedRoots,
+            protectedPaths: sortedProtectedPaths,
+        })),
+    };
+}
+function isProtectedPath(profile, relativePath) {
+    return profile.protectedPaths.some((path) => isWithinPath(relativePath, path)) ||
+        profile.protectedRoots.some((path) => isWithinPath(relativePath, path));
+}
+export function shouldIncludeStylePath(profile, path, projectDir) {
+    const relativePath = normalizeRelativePath(toRelativeProjectPath(path, projectDir));
+    if (!relativePath)
+        return true;
+    if (isProtectedPath(profile, relativePath))
+        return true;
+    return !profile.ignoredRoots.some((root) => isWithinPath(relativePath, root));
+}
+export function shouldTraverseStyleDirectory(profile, directoryPath, projectDir) {
+    const relativePath = normalizeRelativePath(toRelativeProjectPath(directoryPath, projectDir));
+    if (!relativePath)
+        return true;
+    if (isProtectedPath(profile, relativePath))
+        return true;
+    const ignoredRoot = profile.ignoredRoots.find((root) => isWithinPath(relativePath, root));
+    if (!ignoredRoot)
+        return true;
+    return profile.protectedRoots.some((root) => isWithinPath(root, relativePath)) ||
+        profile.protectedPaths.some((path) => isWithinPath(path, relativePath));
+}
+export function filterFilesForStyleScope(files, profile, projectDir) {
+    return files.filter((file) => shouldIncludeStylePath(profile, file.path, projectDir));
+}

package/esm/src/platform/adapters/fs/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/adapters/fs/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiBvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA6E3E"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/src/platform/adapters/fs/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAgE3E"}

package/esm/src/platform/adapters/fs/factory.js

@@ -1,12 +1,6 @@
 import { createError, toError } from "../../../errors/veryfront-error.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.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 { invalidateProjectCSS } from "../../../html/styles-builder/tailwind-compiler.js";
-import { invalidateProjectCandidateManifests } from "../../../rendering/orchestrator/css-candidate-manifest.js";
+import { createDefaultInvalidationCallbacks } from "./veryfront/default-invalidation-callbacks.js";
 export function createFSAdapter(config) {
     const type = config.type ?? "local";
     const proxyMode = config.veryfront?.proxyMode ?? false;
@@ -22,20 +16,7 @@ export function createFSAdapter(config) {
         if (type === "veryfront-api") {
             const configWithCallbacks = {
                 ...config,
-                invalidationCallbacks: {
-                    clearSSRModuleCache,
-                    clearModulePathCache,
-                    invalidateModulePaths,
-                    clearSSRModuleCacheForProject,
-                    clearRouterDetectionCacheForProject,
-                    clearSnippetCacheForProject,
-                    clearRendererCacheForProject,
-                    clearProjectCSSCache: (projectSlug) => {
-                        invalidateProjectCSS(projectSlug);
-                        invalidateProjectCandidateManifests(projectSlug);
-                    },
-                    ...config.invalidationCallbacks,
-                },
+                invalidationCallbacks: createDefaultInvalidationCallbacks(config.invalidationCallbacks),
             };
             if (proxyMode) {
                 const { MultiProjectFSAdapter } = await import("./veryfront/multi-project-adapter.js");