/**
 * Validation Error Transformation
 *
 * Transforms raw validation errors into user-friendly messages.
 */
import type { TypeDefinition } from '../structure-types';
/**
 * Validation error from the JSON Structure validator
 */
export interface RawValidationError {
    /** JSON Pointer path to error location */
    path: string;
    /** Error type/code */
    type: string;
    /** Expected value/constraint */
    expected?: unknown;
    /** Actual value */
    actual?: unknown;
    /** Additional context */
    context?: Record<string, unknown>;
}
/**
 * User-friendly validation error
 */
export interface FormattedValidationError {
    /** JSON Pointer path to error location */
    path: string;
    /** Human-readable error message */
    message: string;
    /** Original error type for programmatic handling */
    code: string;
}
/**
 * Transform a raw validation error into a user-friendly message
 */
export declare function formatValidationError(error: RawValidationError, definition?: TypeDefinition): FormattedValidationError;
/**
 * Transform multiple validation errors
 */
export declare function formatValidationErrors(errors: RawValidationError[], definitions?: Map<string, TypeDefinition>): FormattedValidationError[];
/**
 * Group errors by path for display
 */
export declare function groupErrorsByPath(errors: FormattedValidationError[]): Map<string, FormattedValidationError[]>;
/**
 * Get errors for a specific path
 */
export declare function getErrorsForPath(errors: FormattedValidationError[], path: string): FormattedValidationError[];
/**
 * Check if a path has errors
 */
export declare function hasErrorsAtPath(errors: FormattedValidationError[], path: string): boolean;
/**
 * Get child errors for a path (errors with paths that start with the given path)
 */
export declare function getChildErrors(errors: FormattedValidationError[], parentPath: string): FormattedValidationError[];
