import { type Stats } from 'node:fs';
export declare function isPathInside(basePath: string, candidatePath: string): boolean;
export declare function lstatIfExists(targetPath: string): Stats | null;
export declare function isRealPathInside(basePath: string, candidatePath: string): boolean;
export type BoundaryViolation = 'outside' | 'symlink' | 'not_directory';
export interface SafePathSegmentInspection {
    readonly resolvedRoot: string;
    readonly resolvedTarget: string;
    readonly segments: readonly {
        readonly path: string;
        readonly stats: Stats | null;
    }[];
}
export declare function inspectSafePathSegments(rootDir: string, targetPath: string, buildError: (violation: BoundaryViolation, segmentPath: string) => Error, options?: {
    readonly rejectSamePath?: boolean;
}): SafePathSegmentInspection;
export declare function assertPathSegmentsAreSafe(rootDir: string, targetPath: string, buildError: (violation: BoundaryViolation, segmentPath: string) => Error, options?: {
    readonly rejectSamePath?: boolean;
}): Stats | null;
//# sourceMappingURL=pathBoundary.d.ts.map