import type { FilesystemIdentity, ValidatedFilesystemPath } from "./types.js";
export type ValidatedRoot = ValidatedFilesystemPath;
export interface OpenContainedDirectory {
    path: string;
    descriptor_path: string;
    fd: number;
    identity: FilesystemIdentity;
    close(): void;
}
export declare function filesystemIdentity(path: string): FilesystemIdentity;
export declare function sameFilesystemIdentity(left: FilesystemIdentity, right: FilesystemIdentity): boolean;
export declare function validateConfiguredRoot(root: string): ValidatedRoot;
export declare function revalidateRoot(root: ValidatedRoot): void;
export declare function assertSafeRelativeSegment(value: string, field: string): void;
export declare function containsPath(root: string, candidate: string): boolean;
export declare function assertContainedExisting(root: ValidatedRoot, candidate: string, label: string): string;
export declare function createContainedDirectories(root: ValidatedRoot, segments: readonly string[]): string;
export declare function openContainedDirectory(root: ValidatedRoot, segments: readonly string[]): OpenContainedDirectory;
export declare function candidateUnderRoot(root: ValidatedRoot, segments: readonly string[]): string;
export declare function assertPathIdentity(path: string, expected: FilesystemIdentity, label: string): void;
export declare function descriptorBackedPathsSupported(): boolean;
export declare function descriptorPath(fd: number): string;
//# sourceMappingURL=paths.d.ts.map