/**
 * @file Synchronous file-access predicates — boolean "can this process do X to
 *   this path?" checks over `fs.accessSync`. Prefer these only where the answer
 *   drives a user-facing decision (e.g. "is the cache dir writable, so I can
 *   pick a fallback?"). For "I'm about to write, can I?" do NOT pre-check —
 *   just attempt the write and handle the error; a check-then-act gap is a
 *   TOCTOU race. `canAccess` (F_OK) overlaps `existsSync`; use `existsSync` for
 *   plain existence, these for permission bits.
 */
import type { PathLike } from 'node:fs';
/**
 * Does the process have `mode` access to `path`? Wraps `fs.accessSync`,
 * returning a boolean instead of throwing. Default mode is `F_OK` (existence).
 *
 * @param path - Path to check.
 * @param mode - `fs.constants` bit (`F_OK` / `R_OK` / `W_OK` / `X_OK`).
 *
 * @returns True if the access check succeeds.
 */
export declare function canAccess(path: PathLike, mode?: number | undefined): boolean;
/**
 * Can the process execute `path`? (`X_OK`)
 */
export declare function canExecute(path: PathLike): boolean;
/**
 * Can the process read `path`? (`R_OK`)
 */
export declare function canRead(path: PathLike): boolean;
/**
 * Can the process write `path`? (`W_OK`)
 */
export declare function canWrite(path: PathLike): boolean;
