/**
 * CSS Pre-generation Utility
 *
 * Triggers CSS generation early (after files are fetched) instead of waiting
 * until HTML shell generation during SSR. This runs in parallel with other
 * initialization work, reducing first-request latency by ~2-3 seconds.
 */
import { type FileSystem } from "../../platform/compat/fs.js";
import { createPreparedProjectCSSContext } from "./prepared-project-css-cache.js";
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";
}
export interface PreparedCSSArtifactBuildResult {
    css: string;
    hash: string;
    candidateCount: number;
    fromCache: boolean;
    context: ReturnType<typeof createPreparedProjectCSSContext>;
}
interface LocalProjectSourceFilesOptions {
    projectDir: string;
    styleProfile: StyleScopeProfile;
    fs?: FileSystem;
}
export declare function buildPreparedCSSArtifactFromFiles(options: CSSPregenerationOptions): Promise<PreparedCSSArtifactBuildResult>;
export declare function collectLocalProjectSourceFiles(options: LocalProjectSourceFilesOptions): Promise<Array<{
    path: string;
    content?: string;
}>>;
export declare function readLocalProjectStylesheet(projectDir: string, stylesheetPath?: string, fs?: FileSystem): Promise<string | undefined>;
/**
 * Trigger prepared CSS generation in the background when the artifact is not
 * already cached or currently being built.
 */
export declare function warmPreparedCSSArtifactFromFiles(options: CSSPregenerationOptions): Promise<boolean>;
/**
 * Pre-generate and cache CSS from file list.
 *
 * This extracts Tailwind candidates from source files and generates CSS,
 * storing it in the distributed cache for later retrieval during SSR.
 *
 * Should be called after files are fetched but before SSR starts.
 * This is non-blocking and fire-and-forget - errors are logged but not thrown.
 *
 * @param options Pre-generation options
 * @returns Promise that resolves when CSS is generated (or immediately on error)
 */
export declare function pregenerateCSSFromFiles(options: CSSPregenerationOptions): Promise<void>;
/**
 * Find stylesheet content from file list using a configured path or defaults.
 */
export declare function findStylesheetFromFiles(files: Array<{
    path: string;
    content?: string;
}>, stylesheetPath?: string): string | undefined;
/**
 * Find the globals.css content from a file list.
 *
 * Searches for common stylesheet file patterns:
 * - globals.css, global.css
 * - styles/globals.css
 * - app/globals.css
 *
 * @param files List of files with content
 * @returns Stylesheet content or undefined if not found
 */
export declare function findGlobalStylesheet(files: Array<{
    path: string;
    content?: string;
}>): string | undefined;
export {};
//# sourceMappingURL=css-pregeneration.d.ts.map