import type { CLIConfig, CLIContext, ParsedArgv } from "./types";
/**
 * Result returned by `buildContext`. Includes the relaxed parse result under
 * the `parsed` field for debugging and tooling consumption.
 */
export interface BuildContextResult extends CLIContext {
    parsed: ParsedArgv;
}
/**
 * Build execution context for the provided argv and CLI configuration.
 *
 * Responsibilities:
 * - Resolve the command path from argv
 * - Parse options in two phases (relaxed root scan + strict per-command parse)
 * - Separate `globalOptions` and `commandOptions`
 * - Validate parsed values against their schemas
 *
 * The function returns a `CLIContext` suitable for passing to command
 * handlers.
 */
export declare function buildContext(cfg: CLIConfig, argv: string[]): BuildContextResult;