/**
 * Zenith CSS Compiler Module
 *
 * Compiler-owned CSS processing that integrates Tailwind CSS v4 JIT
 * at compile time. This module ensures:
 *
 * 1. All CSS is processed at build time (no runtime generation)
 * 2. Tailwind sees all .zen templates for class scanning
 * 3. HMR support for instant CSS updates in dev mode
 * 4. Deterministic, cacheable output for production
 *
 * Per Zenith CSS Directive: The compiler owns styles.
 */
export interface CSSCompileOptions {
    /** Input CSS file path (e.g., src/styles/globals.css) */
    input: string;
    /** Output CSS file path, or ':memory:' for in-memory result */
    output: string;
    /** Enable minification for production */
    minify?: boolean;
    /** Watch mode for HMR */
    watch?: boolean;
}
export interface CSSCompileResult {
    /** Compiled CSS content */
    css: string;
    /** Compilation time in milliseconds */
    duration: number;
    /** Whether compilation succeeded */
    success: boolean;
    /** Error message if failed */
    error?: string;
}
/**
 * Compile CSS using Tailwind CSS v4 CLI
 *
 * This function synchronously compiles CSS for use in:
 * - Dev server startup
 * - SSG build
 * - On-demand recompilation
 *
 * @param options Compilation options
 * @returns Compiled CSS result
 */
export declare function compileCss(options: CSSCompileOptions): CSSCompileResult;
/**
 * Compile CSS asynchronously (non-blocking)
 *
 * Used for HMR updates where we don't want to block the main thread.
 */
export declare function compileCssAsync(options: CSSCompileOptions): Promise<CSSCompileResult>;
export interface CSSWatchOptions extends CSSCompileOptions {
    /** Callback when CSS changes */
    onChange: (result: CSSCompileResult) => void;
    /** Debounce delay in ms */
    debounce?: number;
}
/**
 * Watch CSS and source files for changes, recompile on change
 *
 * This is used by the dev server for HMR support.
 * It watches both the CSS entry point AND all .zen files
 * that Tailwind scans for class names.
 */
export declare function watchCss(options: CSSWatchOptions): () => void;
/**
 * Resolve the canonical globals.css path for a Zenith project
 */
export declare function resolveGlobalsCss(projectRoot: string): string | null;
/**
 * Get the output path for compiled CSS
 */
export declare function getCompiledCssPath(projectRoot: string, mode: 'dev' | 'build'): string;
