/**
 * Spec Validator — Validates specs against their schemas
 * and checks cross-references (e.g., page sections referencing component specs).
 */
import { AnySpec } from "./types.js";
import { Registry } from "../engine/registry.js";
export interface ValidationResult {
    valid: boolean;
    errors: ValidationError[];
    warnings: ValidationWarning[];
}
export interface ValidationError {
    path: string;
    message: string;
}
export interface ValidationWarning {
    path: string;
    message: string;
    suggestion?: string;
}
export declare function validateSpec(spec: unknown): ValidationResult;
/**
 * Cross-reference validation: checks that page specs reference
 * existing component specs, etc.
 */
export declare function validateCrossRefs(spec: AnySpec, registry: Registry): Promise<ValidationWarning[]>;