import type { JSONSchemaDefinition } from '../json-schema/schema-types';
export type MismatchKind = 'type-mismatch' | 'missing-required' | 'extra-property' | 'enum-mismatch' | 'const-mismatch' | 'constraint-violation';
export interface Mismatch {
    readonly kind: MismatchKind;
    readonly path: ReadonlyArray<PropertyKey>;
    readonly message: string;
    readonly expected?: string;
    readonly actual?: string;
}
/**
 * Lightweight mismatch detection between a JSON value and a JSON Schema definition.
 * No AJV dependency - checks type, required, extra properties, enum/const, and basic constraints.
 */
export declare function detectMismatches(value: unknown, definition: JSONSchemaDefinition, path?: PropertyKey[]): Mismatch[];