/**
 * @file Thin facade returned by {@link TinyFSCore#open}.
 */
/**
 * Handle returned by `open()`, shaped like `node:fs/promises.FileHandle`.
 *
 * The handle is a facade over the originating {@link TinyFSCore} instance.
 * Every method delegates back to the file system, so no file descriptor is
 * actually held open.
 */
export declare class FileHandle {
    #private;
    /**
     * @param {import('./index.mjs').default} fs Originating file system.
     * @param {string} path Absolute path of the opened file.
     * @param {string} flags Access mode the handle was opened with.
     */
    constructor(fs: import('./index.mjs').default, path: string, flags: string);
    /** @returns {string} Absolute path of the opened file. */
    get path(): string;
    /** @returns {string} Access mode the handle was opened with. */
    get flags(): string;
    /** @returns {boolean} `true` once `close()` has been awaited. */
    get closed(): boolean;
    /**
     * @param {import('./index.mjs').TReadFileOptions} [options] Read options.
     * @returns {Promise<string | Uint8Array>} The file contents.
     */
    readFile(options?: import('./index.mjs').TReadFileOptions): Promise<string | Uint8Array>;
    /**
     * @param {string | Uint8Array | ArrayBuffer} data Payload to persist.
     * @param {import('./index.mjs').TWriteFileOptions} [options] Write options.
     * @returns {Promise<void>} Resolves once the payload is committed.
     */
    writeFile(data: string | Uint8Array | ArrayBuffer, options?: import('./index.mjs').TWriteFileOptions): Promise<void>;
    /**
     * @param {string | Uint8Array | ArrayBuffer} data Payload to append.
     * @param {import('./index.mjs').TWriteFileOptions} [options] Write options.
     * @returns {Promise<void>} Resolves once the payload is committed.
     */
    appendFile(data: string | Uint8Array | ArrayBuffer, options?: import('./index.mjs').TWriteFileOptions): Promise<void>;
    /**
     * @returns {Promise<import('./stats.mjs').Stats>} A fresh snapshot of the file metadata.
     */
    stat(): Promise<import('./stats.mjs').Stats>;
    /**
     * @param {number} [length] Target length in bytes.
     * @returns {Promise<void>} Resolves once the file is truncated.
     */
    truncate(length?: number): Promise<void>;
    /**
     * @returns {Promise<void>} Resolves once the handle is released.
     */
    close(): Promise<void>;
}
//# sourceMappingURL=handle.d.mts.map