import { CommandRegistry, CommandSegment } from './command-registry';
import { BooleanCommandResult, CommandResult, ErrorCommandResult, ImageCommandResult, JsonCommandResult, TextCommandResult } from './command-results';
export interface CommandExecutionContext<ArgName extends string = string> {
    rawArgs: string[];
    namedArgs: Record<ArgName, string | undefined>;
    commandPath: string;
}
export type DslCommandHandler<ArgName extends string = string> = (context: CommandExecutionContext<ArgName>) => CommandResult | Promise<CommandResult>;
export interface CommandDefinition<ArgName extends string = string> {
    path: string;
    description: string;
    details?: string;
    segments: CommandSegment[];
    handler: DslCommandHandler<ArgName>;
}
export interface ArgumentBuilderApi {
    describe(description: string): this;
}
export interface CommandBuilderApi<ArgName extends string = never> {
    describe(description: string): this;
    details(details: string): this;
    arg<Name extends string>(name: Name, configure?: (argument: ArgumentBuilderApi) => ArgumentBuilderApi | void): CommandBuilderApi<ArgName | Name>;
    handle(handler: DslCommandHandler<ArgName>): CommandDefinition<ArgName>;
}
export declare function command(path: string): CommandBuilderApi;
export declare function registerCommand(registry: CommandRegistry, definition: CommandDefinition): void;
export declare function registerCommands(registry: CommandRegistry, definitions: CommandDefinition[]): CommandRegistry;
export declare function createCommandRegistry(definitions: CommandDefinition[]): CommandRegistry;
export declare function text(value: string): TextCommandResult;
export declare function bool(value: boolean, trueText?: string, falseText?: string): BooleanCommandResult;
export declare function json(value: unknown): JsonCommandResult;
export declare function image(url: string, altText?: string): ImageCommandResult;
export declare function error(value: string): ErrorCommandResult;