/** Parsed result from the argument parser */
export interface ParsedArgs {
    /** The subcommand (or null for top-level flags like --help / --version) */
    command: string | null;
    /** Positional arguments following the subcommand */
    positional: string[];
    /** Named flags (e.g. --category → category) mapped to their values */
    flags: Record<string, string | boolean>;
}
/**
 * Parse process.argv into a structured object.
 *
 * Supports:
 * - Positional arguments
 * - Long flags: --flag, --flag value, --flag=value
 * - Short flags: -h, -v
 * - Boolean negation: --no-<flag> → flag = false
 *
 * @param argv - Raw argument array (typically process.argv.slice(2))
 * @returns Parsed command, positional args, and flags
 */
export declare function parseArgs(argv: string[]): ParsedArgs;