import { type ErrorReport } from "../report-error.js";
import type { ParsedArgs } from "./args.js";
export interface ValidateResult {
    ok: boolean;
    config: string;
    source: string;
    /** Structured error report — present only on failure. See {@link ErrorReport}. */
    error?: ErrorReport;
}
/**
 * `node-settings validate [env-file]` — load the user's config, build
 * settings against the supplied env file (or `process.env` if none),
 * and exit non-zero if validation fails.
 *
 * `--format=json` emits a single `ValidateResult` document on stdout
 * for machine consumers (CI dashboards, AI agents).
 */
export declare function runValidate(args: ParsedArgs): Promise<number>;
/**
 * Compute a ValidateResult without printing it. `envFileMissing` is
 * set when the caller supplied an env-file path that doesn't exist;
 * callers translate that into exit code 2.
 */
export declare function buildValidateResult(configPath: string | undefined, envFileArg: string | undefined): Promise<{
    result: ValidateResult;
    envFileMissing?: true;
}>;
export declare function printValidateResultText(result: ValidateResult): void;
//# sourceMappingURL=validate.d.ts.map