import { type SchemaType, type ValidationResult } from "@pulsemcp/air-core";
export interface ValidateFileOptions {
    /** Override schema type detection. */
    schema?: string;
    /** Base directory for resolving relative file paths. Defaults to process.cwd(). */
    cwd?: string;
}
export interface ValidateFileResult {
    /** Whether the file is valid against the detected/specified schema. */
    valid: boolean;
    /** The schema type used for validation. */
    schemaType: SchemaType;
    /** Validation result from core (includes errors if invalid). */
    validation: ValidationResult;
}
/**
 * Validate a JSON file against its AIR schema.
 *
 * Schema detection order:
 * 1. Explicit `options.schema` override
 * 2. `$schema` field in the JSON content
 * 3. Filename substring matching
 *
 * @throws Error if the file cannot be read/parsed, schema type is invalid, or schema cannot be detected.
 */
export declare function validateFile(file: string, options?: ValidateFileOptions): ValidateFileResult;
//# sourceMappingURL=validate.d.ts.map