/**
 * Lightweight Argument Parser for Custom Commands
 *
 * Parses POSIX-style flags and positional arguments from a string array.
 * Supports --flag, --flag=value, --flag value, -f, -f value, and -- separator.
 */
export interface ParsedArgs {
    /** Parsed flags: --flag=value → Map("flag", "value"), --flag (boolean) → Map("flag", true) */
    flags: Map<string, string | true>;
    /** Non-flag arguments in order */
    positional: string[];
    /** Check whether a flag was provided */
    has(flag: string): boolean;
    /** Get the string value of a flag (returns undefined for boolean flags or missing flags) */
    get(flag: string): string | undefined;
}
export interface ParseArgsOptions {
    /** Flags that never consume the next argument (always boolean true) */
    booleanFlags?: string[];
}
/**
 * Parse an argument array into structured flags and positional args.
 *
 * @example
 * ```ts
 * const parsed = parseArgs(["--verbose", "--out=build", "src/index.ts"]);
 * parsed.has("verbose"); // true
 * parsed.get("out");     // "build"
 * parsed.positional;     // ["src/index.ts"]
 * ```
 */
export declare function parseArgs(args: string[], options?: ParseArgsOptions): ParsedArgs;
