import { type StyleProofConfig } from './config.js';
export declare function isHelpArg(arg: string | undefined): boolean;
export declare function showHelpAndExit(help: string): never;
export declare function cliErrorMessage(error: unknown): string;
/**
 * Shared CLI prologue: the repo's styleproof.config.json as the lowest-precedence
 * default layer (flag > env > file > built-in), or a loud usage-error exit —
 * config the user wrote must never be silently dropped.
 */
export declare function projectConfigOrExit(cli: string, cwd?: string): StyleProofConfig;
/**
 * The "cached maps couldn't be restored" guidance, shared by styleproof-diff and
 * styleproof-report (each names its own `purpose` — "comparison" / "report").
 */
export declare function cachedMapsUnavailableMessage(command: string, purpose: string, error: unknown): string;
export declare function unknownFlagMessage(command: string, flag: string): string;
export declare function missingSpecMessage(spec: string): string;
export declare function playwrightMissingMessage(message: string): string;
export declare function missingWorkingMapsMessage(command: string, dir: string): string;
export declare function missingManualCaptureMessage(command: string, dir: string): string;
export declare function baseInferenceMessage(command: string, message: string): string;
/**
 * Advisory shown when a map is uploaded from a non-Linux platform. A map's
 * compatibility key is platform-specific, and the scaffolded CI runs on
 * `ubuntu-latest` — so a bundle captured on macOS/Windows can never be restored by
 * that Linux CI, which recaptures instead. The upload isn't wrong (CI may be
 * non-Linux, or the user knows better), so this warns rather than blocks. Returns
 * `null` on Linux (and when suppressed via `STYLEPROOF_SUPPRESS_PLATFORM_WARNING=1`).
 */
export declare function nonLinuxUploadWarning(platform: string, suppressed?: boolean): string | null;