import type { CLIConfig, OptionRecord, ParsedArgv } from "./types";
/** Result of a relaxed argv parse used to discover command path. */
export interface ParseResult extends ParsedArgv {
}
/**
 * Perform a relaxed parse of argv.
 *
 * This pass is permissive: unknown options are ignored. The goal is to
 * discover the command path (which tokens are commands vs options) so we can
 * perform a strict parse for the resolved command later.
 */
export declare function parseArgv(argv: string[], cfg: CLIConfig): ParseResult;
/**
 * Parse only options from tokens after command path is determined.
 * Assumption: all options appear contiguously after the command path.
 */
/**
 * Strictly parse option tokens for a resolved command.
 *
 * This pass rejects unknown options and duplicates. It returns a map of
 * option name -> coerced value.
 */
export declare function parseOptions(tokens: string[], optionSchema: OptionRecord): Record<string, unknown>;