import { PrinterConfig, PrintOptions, DebugConfig } from '../types/index.js';
export interface ParsedArguments {
    printerConfig: Partial<PrinterConfig>;
    printOptions: Partial<PrintOptions>;
    debugConfig: Partial<DebugConfig>;
    isTestMode?: boolean;
    testHeight?: number;
    templateName?: string;
    variables?: Record<string, string | number>;
    renderOnly?: boolean;
    listTemplates?: boolean;
    templateFile?: string;
}
export declare class ArgumentParser {
    /**
     * Parse command line arguments supporting both legacy positional args and modern flag-based args
     */
    static parse(args: string[]): ParsedArguments;
    /**
     * Parse modern flag-based arguments
     */
    private static parseFlags;
    private static extractFlags;
    private static applyTemplateFlags;
    private static applyPrinterFlags;
    private static applyPrintOptionsFlags;
    private static applyDebugFlags;
    private static applySpecialModeFlags;
    static mergeWithDefaults(parsed: ParsedArguments, defaultPrinterConfig: PrinterConfig, defaultPrintOptions: PrintOptions): {
        printerConfig: PrinterConfig;
        printOptions: PrintOptions;
    };
    /**
     * Merge debug config with defaults, handling environment variables as fallback
     */
    static mergeDebugConfig(parsed: ParsedArguments, defaultDebugConfig: DebugConfig): DebugConfig;
    static validateConfig(config: PrinterConfig): void;
    static validatePrintOptions(options: PrintOptions): void;
    /**
     * Generate help text for command line usage
     */
    static getHelpText(): string;
}