import * as fs from "node:fs";
/**
 * Configuration for a {@link statsForFile} call.
 */
export type StatsForFileConfig = {
    /**
     * Underlying filesystem call.  Mostly for unit testing.
     */
    statSync?: (path: string, options: {
        throwIfNoEntry: false;
    }) => (undefined | fs.Stats);
    /**
     * Whether to throw (or just return undefined) if the path
     * exists but is not a file.
     * @defaultValue true
     */
    throwIfNotFile?: boolean;
};
/**
 * Get the stats for a path, if it exists.  Throws if the path does
 * not point to a file.
 */
export declare const statsForFile: (filePath: string, config?: StatsForFileConfig) => fs.Stats | undefined;
//# sourceMappingURL=stats-for-file.d.ts.map