/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

import { NativeParsedArgs } from '../common/argv.mjs';
/**
 * This code is also used by standalone cli's. Avoid adding any other dependencies.
 */
declare const helpCategories: {
	o: string;
	e: string;
	t: string;
};
export interface Option<OptionType> {
	type: OptionType;
	alias?: string;
	deprecates?: string[];
	args?: string | string[];
	description?: string;
	deprecationMessage?: string;
	allowEmptyValue?: boolean;
	cat?: keyof typeof helpCategories;
	global?: boolean;
}
export interface Subcommand<T> {
	type: 'subcommand';
	description?: string;
	deprecationMessage?: string;
	options: OptionDescriptions<Required<T>>;
}
export type OptionDescriptions<T> = {
	[P in keyof T]: T[P] extends boolean | undefined
		? Option<'boolean'>
		: T[P] extends string | undefined
		? Option<'string'>
		: T[P] extends string[] | undefined
		? Option<'string[]'>
		: Subcommand<T[P]>;
};
export declare const OPTIONS: OptionDescriptions<Required<NativeParsedArgs>>;
export interface ErrorReporter {
	onUnknownOption(id: string): void;
	onMultipleValues(id: string, usedValue: string): void;
	onEmptyValue(id: string): void;
	onDeprecatedOption(deprecatedId: string, message: string): void;
	getSubcommandReporter?(commmand: string): ErrorReporter;
}
export declare function parseArgs<T>(args: string[], options: OptionDescriptions<T>, errorReporter?: ErrorReporter): T;
export declare function formatOptions(options: OptionDescriptions<any>, columns: number): string[];
export declare function buildHelpMessage(
	productName: string,
	executableName: string,
	version: string,
	options: OptionDescriptions<any>,
	capabilities?: {
		noPipe?: boolean;
		noInputFiles: boolean;
	},
): string;
export declare function buildVersionMessage(version: string | undefined, commit: string | undefined): string;
export {};