export type FlagType = "string" | "number" | "boolean";
export type FlagSpec = {
    type: FlagType;
    short?: string;
    default?: string | number | boolean;
    required?: boolean;
    description?: string;
    choices?: string[];
    hidden?: boolean;
    optional?: boolean;
};
export type FlagGroups = {
    exclusive?: string[][];
    requiredTogether?: string[][];
};
export type ArgsSchema = {
    programName?: string;
    description?: string;
    version?: string;
    epilog?: string;
    flags: Record<string, FlagSpec>;
    groups?: FlagGroups;
};
export type FlagValues = Record<string, string | number | boolean>;
export type RawFlagValues = Record<string, string | boolean>;
export type NormalizedGroups = Required<FlagGroups>;
export type ParsedArgs = {
    flags: FlagValues;
    positionals: string[];
};
export type NormalizedFlag = Required<Omit<FlagSpec, "short" | "default" | "choices" | "optional">> & {
    name: string;
    short: string | null;
    default: string | number | boolean | null;
    choices: string[] | null;
    optional: boolean;
};
export type NormalizedSchema = {
    programName: string;
    description: string | null;
    version: string | null;
    epilog: string | null;
    flags: NormalizedFlag[];
    flagsByName: Record<string, NormalizedFlag>;
    flagsByShort: Record<string, NormalizedFlag>;
    groups: NormalizedGroups;
    autoHelp: boolean;
    autoVersion: boolean;
};
export type ParseError = {
    kind: "unknownLong";
    flag: string;
} | {
    kind: "unknownShort";
    flag: string;
} | {
    kind: "missingValue";
    flag: string;
} | {
    kind: "missingRequired";
    flag: string;
} | {
    kind: "invalidNumber";
    flag: string;
    raw: string;
} | {
    kind: "invalidChoice";
    flag: string;
    raw: string;
    choices: string[];
} | {
    kind: "booleanTakesNoValue";
    flag: string;
} | {
    kind: "greedyValue";
    flag: string;
    raw: string;
} | {
    kind: "shortEqualsSyntax";
    raw: string;
    suggestion: string;
} | {
    kind: "duplicateFlag";
    flag: string;
} | {
    kind: "mutuallyExclusive";
    a: string;
    b: string;
} | {
    kind: "requiredTogether";
    missing: string;
    trigger: string;
};
export type ParseResult<T> = {
    ok: true;
    value: T;
} | {
    ok: false;
    error: ParseError;
};
export declare function validateSchema(schema: ArgsSchema): void;
export declare function normalizeSchema(schema: ArgsSchema): NormalizedSchema;
export declare function expandOptionalFlags(argv: string[], schema: NormalizedSchema): string[];
export declare function preScanArgv(argv: string[], schema: NormalizedSchema): ParseResult<void>;
type NodeParseOutput = {
    flags: RawFlagValues;
    positionals: string[];
};
export declare function callNodeParse(argv: string[], schema: NormalizedSchema): ParseResult<NodeParseOutput>;
export declare function parseStrictNumber(raw: string): number | null;
export declare function coerceValues(parsed: RawFlagValues, schema: NormalizedSchema): ParseResult<FlagValues>;
export declare function applyDefaults(parsed: FlagValues, schema: NormalizedSchema): ParseResult<FlagValues>;
export declare function checkGroups(parsed: Record<string, unknown>, schema: NormalizedSchema): ParseResult<void>;
export declare function formatHelp(schema: NormalizedSchema): string;
export declare function formatError(error: ParseError, schema: NormalizedSchema): string;
export declare function _parseArgs(schema: ArgsSchema): ParsedArgs;
export declare function _parseArgsWith(argv: string[], schema: ArgsSchema): ParsedArgs;
export {};