/** Thrown when a caller-supplied path would escape the screenshot sandbox. */ export declare class UnsafePathError extends Error { constructor(message: string); } /** * Normalises a path written on one platform for use on another. In practice * this is about Windows hosts driving a server running under WSL, which is a * recurring source of "screenshot saved somewhere I can't find it" reports. */ export declare function convertPathForPlatform(inputPath: string, platform?: NodeJS.Platform): string; export declare function convertPathForCurrentPlatform(inputPath: string): string; /** Default directory screenshots are written to. */ export declare function getDefaultScreenshotDir(): string; /** * Resolves a caller-supplied relative name inside `baseDir`, refusing anything * that could escape it. Callers never choose the base directory. */ export declare function resolveSafeScreenshotPath(baseDir: string, relativeName: string): string; /** * Builds a unique, sortable, shell-safe screenshot filename. Colons are * stripped so the name survives every platform and never needs quoting. */ export declare function screenshotFilename(now?: Date, extension?: string): string;