import { Opts, ParsedArgs } from 'minimist';
/**
 * Parse command-line arguments using minimist.
 * Wrapper around minimist so you don't need to import it directly.
 *
 * @example
 * ```typescript
 * const argv = parseArgv(process.argv);
 * console.log(argv.config); // --config value
 * ```
 */
export declare const parseArgv: (args?: string[], opts?: Opts) => ParsedArgs;
/**
 * Extracts the first positional argument from argv and returns it along with the remaining argv.
 * Useful for command routing where the first argument is a subcommand.
 *
 * @example
 * ```typescript
 * const { first: command, newArgv } = extractFirst(argv);
 * if (command === 'init') {
 *   await handleInit(newArgv);
 * }
 * ```
 */
export declare const extractFirst: (argv: Partial<ParsedArgs>) => {
    first: string;
    newArgv: {
        _: string[];
        "--"?: string[] | undefined;
    };
};
export type { ParsedArgs, Opts as ParseArgvOptions } from 'minimist';