/** The file methods of a directory on disk. */
export interface DirectoryFiles {
    readFile(file: string): Promise<string>;
    writeFile(file: string, content: string): Promise<void>;
    listFiles(directory?: string): Promise<string[]>;
    removeFile(file: string): Promise<void>;
    glob(pattern: string, options?: {
        cwd?: string;
        limit?: number;
    }): Promise<string[]>;
    grep(pattern: string, options?: {
        cwd?: string;
        glob?: string;
        ignoreCase?: boolean;
        limit?: number;
    }): Promise<Array<{
        file: string;
        line: number;
        text: string;
    }>>;
    readBytes(file: string): Promise<Uint8Array>;
    writeBytes(file: string, bytes: Uint8Array): Promise<void>;
}
/** The files under `root`, refusing a path outside it with the error `refuse` makes. */
export declare function directoryFiles(rootDirectory: string, refuse: (path: string) => Error): DirectoryFiles & {
    ready: Promise<DirectoryHandle>;
};
/** What a directory's file methods hold once Node's modules have loaded. */
export interface DirectoryHandle {
    fs: typeof import('node:fs/promises');
    dirname: typeof import('node:path').dirname;
    join: typeof import('node:path').join;
    relative: typeof import('node:path').relative;
    root: string;
    inside: (file: string) => string;
}