/**
 * Tiny CLI arg-parsing wrapper around node:util.parseArgs.
 * We support subcommands by consuming the first positional, then re-parsing
 * the remainder with subcommand-specific options.
 */
export interface ParsedSubcommand {
    command: string;
    positionals: string[];
    options: Record<string, string | boolean>;
}
export type OptionDef = {
    type: 'string';
    short?: string;
    multiple?: boolean;
} | {
    type: 'boolean';
    short?: string;
};
export interface SubcommandSpec {
    options?: Record<string, OptionDef>;
}
export declare function parseSubcommand(argv: string[], specs: Record<string, SubcommandSpec>): ParsedSubcommand;
export declare class ArgsError extends Error {
    constructor(message: string);
}
//# sourceMappingURL=args.d.ts.map