veryfront 0.1.91 → 0.1.93

package/esm/cli/commands/styles/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const stylesHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/styles/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/styles/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAkBxB,CAAC"}

package/esm/cli/commands/styles/command-help.js

@@ -0,0 +1,19 @@
+export const stylesHelp = {
+    name: "styles",
+    description: "Build project CSS artifacts",
+    usage: "veryfront styles build-artifact --config <json>",
+    options: [
+        {
+            flag: "--config <json>",
+            description: "JSON build config with exactly one selector and an optional style_profile_hash",
+        },
+        {
+            flag: "--debug",
+            description: "Enable debug logging",
+        },
+    ],
+    examples: [
+        'veryfront styles build-artifact --config \'{"branch":"main"}\'',
+        'veryfront styles build-artifact --config \'{"style_profile_hash":"profile-1","environment_name":"Production"}\'',
+    ],
+};

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

@@ -0,0 +1,3 @@
+import type { StylesArgs } from "./handler.js";
+export declare function stylesCommand(options: StylesArgs): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/styles/command.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA2K/C,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4GtE"}

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

@@ -0,0 +1,198 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import { getConfig } from "../../../src/config/index.js";
+import { enhanceAdapterWithFS, getEnv, isExtendedFSAdapter, runtime, } from "../../../src/platform/index.js";
+import { buildPreparedCSSArtifactFromFiles, createStyleScopeProfile, resolveStyleContentVersion, } from "../../../src/rendering/styles.js";
+import { cliLogger, exitProcess } from "../../utils/index.js";
+import { writeJobResultIfConfigured } from "../../utils/write-job-result.js";
+const StyleArtifactBuildConfigSchema = z.object({
+    style_profile_hash: z.string().min(1).optional(),
+    branch: z.string().min(1).optional(),
+    environment_name: z.string().min(1).optional(),
+    release_id: z.string().min(1).optional(),
+}).superRefine((value, ctx) => {
+    const selectorCount = [value.branch, value.environment_name, value.release_id].filter(Boolean)
+        .length;
+    if (selectorCount !== 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Exactly one of branch, environment_name, or release_id is required.",
+        });
+    }
+});
+function parseStyleArtifactBuildConfig(rawConfig) {
+    if (!rawConfig) {
+        throw new Error("Missing --config JSON");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawConfig);
+    }
+    catch {
+        throw new Error("Invalid --config JSON");
+    }
+    return StyleArtifactBuildConfigSchema.parse(parsed);
+}
+function resolveStyleArtifactSelector(config) {
+    if (config.branch) {
+        return {
+            branch: config.branch,
+            type: "branch",
+            value: config.branch,
+        };
+    }
+    if (config.environment_name) {
+        return {
+            environmentName: config.environment_name,
+            type: "environment",
+            value: config.environment_name,
+        };
+    }
+    return {
+        releaseId: config.release_id,
+        type: "release",
+        value: config.release_id,
+    };
+}
+function resolveContentContextSelector(selector) {
+    if (selector.type === "branch") {
+        return { type: "branch", branch: selector.branch };
+    }
+    if (selector.type === "environment") {
+        return { type: "environment", name: selector.environmentName };
+    }
+    return { type: "release", releaseId: selector.releaseId };
+}
+function requireEnv(name) {
+    const value = getEnv(name)?.trim();
+    if (!value) {
+        throw new Error(`${name} is required`);
+    }
+    return value;
+}
+function getUnderlyingVeryfrontClient(adapter) {
+    if (!isExtendedFSAdapter(adapter.fs)) {
+        throw new Error("Styles build requires a Veryfront FS adapter");
+    }
+    const fsAdapter = adapter.fs.getUnderlyingAdapter();
+    if (typeof fsAdapter.getAllSourceFiles !== "function" ||
+        typeof fsAdapter.getClient !== "function") {
+        throw new Error("Styles build requires a Veryfront source adapter");
+    }
+    return {
+        client: fsAdapter.getClient(),
+        contentContext: typeof fsAdapter.getContentContext === "function"
+            ? fsAdapter.getContentContext()
+            : null,
+        getAllSourceFiles: fsAdapter.getAllSourceFiles,
+    };
+}
+async function markStyleArtifactFailed(client, selector, styleProfileHash, error) {
+    if (!client || !styleProfileHash)
+        return;
+    try {
+        await client.upsertStyleArtifact({
+            ...(selector.type === "branch" ? { branch: selector.branch } : {}),
+            ...(selector.type === "environment" ? { environmentName: selector.environmentName } : {}),
+            ...(selector.type === "release" ? { releaseId: selector.releaseId } : {}),
+            styleProfileHash,
+            status: "failed",
+            failureReason: error,
+        });
+    }
+    catch (updateError) {
+        cliLogger.warn("Failed to mark style artifact as failed", updateError);
+    }
+}
+export async function stylesCommand(options) {
+    const buildConfig = parseStyleArtifactBuildConfig(options.config);
+    const selector = resolveStyleArtifactSelector(buildConfig);
+    const projectSlug = requireEnv("VERYFRONT_PROJECT_SLUG");
+    const apiToken = requireEnv("VERYFRONT_API_TOKEN");
+    const apiBaseUrl = requireEnv("VERYFRONT_API_BASE_URL");
+    const projectId = getEnv("VERYFRONT_PROJECT_ID")?.trim();
+    const projectDir = dntShim.Deno.cwd();
+    const baseAdapter = await runtime.get();
+    const adapter = await enhanceAdapterWithFS(baseAdapter, {
+        fs: {
+            type: "veryfront-api",
+            projectDir,
+            veryfront: {
+                apiBaseUrl,
+                apiToken,
+                projectSlug,
+                projectId,
+                contentSource: resolveContentContextSelector(selector),
+            },
+        },
+    }, projectDir);
+    let client = null;
+    let resolvedStyleProfileHash = buildConfig.style_profile_hash ?? null;
+    try {
+        const sourceAdapter = getUnderlyingVeryfrontClient(adapter);
+        client = sourceAdapter.client;
+        const cacheKey = projectId || projectSlug;
+        const config = await getConfig(projectDir, adapter, { cacheKey });
+        const styleProfile = createStyleScopeProfile(config);
+        resolvedStyleProfileHash = styleProfile.hash;
+        if (buildConfig.style_profile_hash && styleProfile.hash !== buildConfig.style_profile_hash) {
+            const message = `Style profile hash mismatch: expected ${buildConfig.style_profile_hash}, got ${styleProfile.hash}`;
+            await markStyleArtifactFailed(client, selector, buildConfig.style_profile_hash, message);
+            throw new Error(message);
+        }
+        const files = await sourceAdapter.getAllSourceFiles();
+        if (files.length === 0) {
+            throw new Error("No project files were available to build the style artifact");
+        }
+        const projectVersion = resolveStyleContentVersion(null, {
+            branch: sourceAdapter.contentContext?.branch ?? null,
+            releaseId: sourceAdapter.contentContext?.releaseId ?? null,
+            environmentName: sourceAdapter.contentContext?.environmentName ?? null,
+        });
+        const build = await buildPreparedCSSArtifactFromFiles({
+            projectSlug,
+            projectVersion,
+            projectDir,
+            files,
+            styleProfile,
+            stylesheetPath: config?.tailwind?.stylesheet,
+            minify: true,
+            environment: "preview",
+            buildMode: "production",
+        });
+        const resolution = await client.upsertStyleArtifact({
+            ...(selector.type === "branch" ? { branch: selector.branch } : {}),
+            ...(selector.type === "environment" ? { environmentName: selector.environmentName } : {}),
+            ...(selector.type === "release" ? { releaseId: selector.releaseId } : {}),
+            styleProfileHash: styleProfile.hash,
+            status: "ready",
+            artifactHash: build.hash,
+        });
+        const result = {
+            kind: "style_artifact",
+            status: "ready",
+            style_profile_hash: styleProfile.hash,
+            artifact_hash: build.hash,
+            asset_path: resolution.assetPath ?? `/_vf/css/${build.hash}.css`,
+            content_type: resolution.contentType ?? "text/css; charset=utf-8",
+            etag: resolution.etag ?? `"${build.hash}"`,
+            selector: {
+                type: selector.type,
+                value: selector.value,
+            },
+        };
+        await writeJobResultIfConfigured(result);
+        cliLogger.info(`Built style artifact ${build.hash}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        await markStyleArtifactFailed(client, selector, resolvedStyleProfileHash ?? buildConfig.style_profile_hash, message);
+        cliLogger.error(message);
+        exitProcess(1);
+    }
+    finally {
+        if (isExtendedFSAdapter(adapter.fs)) {
+            await adapter.fs.shutdown();
+        }
+    }
+}

package/esm/cli/commands/styles/handler.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { ParsedArgs } from "../../shared/types.js";
+declare const StylesArgsSchema: z.ZodObject<{
+    subcommand: z.ZodLiteral<"build-artifact">;
+    config: z.ZodOptional<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    debug: boolean;
+    subcommand: "build-artifact";
+    config?: string | undefined;
+}, {
+    subcommand: "build-artifact";
+    config?: string | undefined;
+    debug?: boolean | undefined;
+}>;
+export type StylesArgs = z.infer<typeof StylesArgsSchema>;
+export declare const parseStylesArgs: (args: ParsedArgs) => z.SafeParseReturnType<unknown, {
+    debug: boolean;
+    subcommand: "build-artifact";
+    config?: string | undefined;
+}>;
+export declare function handleStylesCommand(args: ParsedArgs): Promise<void>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/styles/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/styles/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,QAAA,MAAM,gBAAgB;;;;;;;;;;;;EAIpB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;EAI1B,CAAC;AAEH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE"}

package/esm/cli/commands/styles/handler.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
+const StylesArgsSchema = z.object({
+    subcommand: z.literal("build-artifact"),
+    config: z.string().optional(),
+    debug: z.boolean().default(false),
+});
+export const parseStylesArgs = createArgParser(StylesArgsSchema, {
+    subcommand: { keys: ["subcommand"], type: "string", positional: 0 },
+    config: { keys: ["config"], type: "string" },
+    debug: { keys: ["debug"], type: "boolean" },
+});
+export async function handleStylesCommand(args) {
+    const opts = parseArgsOrThrow(parseStylesArgs, "styles", args);
+    const { stylesCommand } = await import("./command.js");
+    await stylesCommand(opts);
+}

package/esm/cli/help/command-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAiClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eA+BtB,CAAC"}
+{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAgCtB,CAAC"}

package/esm/cli/help/command-definitions.js

@@ -13,6 +13,7 @@ import { doctorHelp } from "../commands/doctor/command-help.js";
 import { cleanHelp } from "../commands/clean/command-help.js";
 import { routesHelp } from "../commands/routes/command-help.js";
 import { studioHelp } from "../commands/studio/command-help.js";
+import { stylesHelp } from "../commands/styles/command-help.js";
 import { lockHelp } from "../commands/lock/command-help.js";
 import { analyzeChunksHelp } from "../commands/analyze-chunks/command-help.js";
 import { generateHelp } from "../commands/generate/command-help.js";
@@ -47,6 +48,7 @@ export const COMMANDS = {
     clean: cleanHelp,
     routes: routesHelp,
     studio: studioHelp,
+    styles: stylesHelp,
     lock: lockHelp,
     "analyze-chunks": analyzeChunksHelp,
     generate: generateHelp,

package/esm/cli/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2DpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwClE"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA4DpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwClE"}

package/esm/cli/router.js

@@ -28,6 +28,7 @@ import { handleRoutesCommand } from "./commands/routes/handler.js";
 import { handleServeCommand } from "./commands/serve/handler.js";
 import { handleStartCommand } from "./commands/start/handler.js";
 import { handleStudioCommand } from "./commands/studio/handler.js";
+import { handleStylesCommand } from "./commands/styles/handler.js";
 import { handleUpCommand } from "./commands/up/index.js";
 import { handleTaskCommand } from "./commands/task/handler.js";
 import { handleWorkflowCommand } from "./commands/workflow/handler.js";
@@ -52,6 +53,7 @@ const commands = {
     "analyze-chunks": handleAnalyzeChunksCommand,
     "routes": handleRoutesCommand,
     "studio": handleStudioCommand,
+    "styles": handleStylesCommand,
     "lock": handleLockCommand,
     "generate": handleGenerateCommand,
     "g": handleGenerateCommand,

package/esm/deno.d.ts

@@ -87,6 +87,7 @@ declare namespace _default {
         "veryfront/config": string;
         "veryfront/build": string;
         "veryfront/rendering": string;
+        "veryfront/rendering/styles": string;
         "veryfront/cache": string;
         "veryfront/security": string;
         "veryfront/errors": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.91",
+    "version": "0.1.93",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [
@@ -97,6 +97,7 @@ export default {
         "veryfront/config": "./src/config/index.ts",
         "veryfront/build": "./src/build/index.ts",
         "veryfront/rendering": "./src/rendering/index.ts",
+        "veryfront/rendering/styles": "./src/rendering/styles.ts",
         "veryfront/cache": "./src/cache/index.ts",
         "veryfront/security": "./src/security/index.ts",
         "veryfront/errors": "./src/errors/index.ts",

package/esm/src/config/environment-config.js

@@ -91,7 +91,7 @@ function readEnvSnapshot() {
         v8MaxOldSpaceSize: v8MaxOldSpaceSizeRaw
             ? parseNumber(v8MaxOldSpaceSizeRaw, 0) || undefined
             : undefined,
-        veryfrontVersion: getEnv("VERYFRONT_VERSION") || undefined,
+        veryfrontVersion: getEnv("VERYFRONT_VERSION") || getEnv("RELEASE_VERSION") || undefined,
     };
 }
 export function initEnvironmentConfig() {

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

@@ -5,6 +5,7 @@
  * until HTML shell generation during SSR. This runs in parallel with other
  * initialization work, reducing first-request latency by ~2-3 seconds.
  */
+import { createPreparedProjectCSSContext } from "./prepared-project-css-cache.js";
 import type { StyleScopeProfile } from "./style-scope-profile.js";
 interface CSSPregenerationOptions {
     /** Project slug for cache keying */
@@ -31,6 +32,14 @@ interface CSSPregenerationOptions {
     /** Build mode recorded in the prepared artifact profile */
     buildMode?: "development" | "production";
 }
+export interface PreparedCSSArtifactBuildResult {
+    css: string;
+    hash: string;
+    candidateCount: number;
+    fromCache: boolean;
+    context: ReturnType<typeof createPreparedProjectCSSContext>;
+}
+export declare function buildPreparedCSSArtifactFromFiles(options: CSSPregenerationOptions): Promise<PreparedCSSArtifactBuildResult>;
 /**
  * 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;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"}
+{"version":3,"file":"css-pregeneration.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/css-pregeneration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,+BAA+B,EAEhC,MAAM,iCAAiC,CAAC;AACzC,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,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;CAC7D;AAED,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,8BAA8B,CAAC,CA0CzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAwCf;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

@@ -9,6 +9,28 @@ 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");
+export async function buildPreparedCSSArtifactFromFiles(options) {
+    const { projectSlug, projectVersion, projectDir, files, styleProfile, stylesheet, stylesheetPath, minify = true, environment = "preview", buildMode = "production", } = options;
+    const resolvedStylesheet = stylesheet ?? findStylesheetFromFiles(files, stylesheetPath);
+    const candidates = extractCandidatesFromFiles(files, {
+        projectDir,
+        styleProfile,
+    });
+    const result = await getProjectCSS(projectSlug, resolvedStylesheet, candidates, {
+        minify,
+        environment,
+        buildMode,
+    });
+    const context = createPreparedProjectCSSContext(projectSlug, projectVersion, resolvedStylesheet, styleProfile.hash, { minify, environment, buildMode });
+    await storePreparedProjectCSS(context, { css: result.css, hash: result.hash });
+    return {
+        css: result.css,
+        hash: result.hash,
+        candidateCount: candidates.size,
+        fromCache: result.fromCache,
+        context,
+    };
+}
 /**
  * Pre-generate and cache CSS from file list.
  *
@@ -22,33 +44,22 @@ 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, projectVersion, projectDir, files, styleProfile, stylesheet, stylesheetPath, minify = true, environment = "preview", buildMode = "production", } = options;
+    const { projectSlug, projectVersion, files, styleProfile, stylesheet, } = options;
     const startTime = performance.now();
     try {
-        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),
+            hasStylesheet: Boolean(stylesheet),
             styleProfileHash: styleProfile.hash,
         });
-        const result = await getProjectCSS(projectSlug, resolvedStylesheet, candidates, {
-            minify,
-            environment,
-            buildMode,
-        });
-        await storePreparedProjectCSS(createPreparedProjectCSSContext(projectSlug, projectVersion, resolvedStylesheet, styleProfile.hash, { minify, environment, buildMode }), { css: result.css, hash: result.hash });
+        const result = await buildPreparedCSSArtifactFromFiles(options);
         const duration = performance.now() - startTime;
         logger.debug("Complete", {
             projectSlug,
             projectVersion,
-            candidateCount: candidates.size,
+            candidateCount: result.candidateCount,
             cssLength: result.css.length,
             cssHash: result.hash,
             fromCache: result.fromCache,