import { CancellationToken } from "../../../base/common/cancellation.js";
import { IDisposable } from "../../../base/common/lifecycle.js";
import { ContextKeyExpression } from "../../contextkey/common/contextkey.js";
import { IContextKeyService } from "../../contextkey/common/contextkey.service.js";
import { ItemActivation, IQuickNavigateConfiguration, IQuickPick, IQuickPickItem, QuickPickItem, IQuickPickSeparator } from "./quickInput.js";
/**
 * Provider specific options for this particular showing of the
 * quick access.
 */
export interface IQuickAccessProviderRunOptions {
    readonly from?: string;
    readonly placeholder?: string;
    /**
     * A handler to invoke when an item is accepted for
     * this particular showing of the quick access.
     * @param item The item that was accepted.
     */
    readonly handleAccept?: (item: IQuickPickItem, isBackgroundAccept: boolean) => void;
}
/**
 * The specific options for the AnythingQuickAccessProvider. Put here to share between layers.
 */
export interface AnythingQuickAccessProviderRunOptions extends IQuickAccessProviderRunOptions {
    readonly includeHelp?: boolean;
    readonly filter?: (item: IQuickPickItem | IQuickPickSeparator) => boolean;
    /**
     * @deprecated - temporary for Dynamic Chat Variables (see usage) until it has built-in UX for file picking
     * Useful for adding items to the top of the list that might contain actions.
     */
    readonly additionPicks?: QuickPickItem[];
}
export interface IQuickAccessOptions {
    /**
     * Allows to enable quick navigate support in quick input.
     */
    readonly quickNavigateConfiguration?: IQuickNavigateConfiguration;
    /**
     * Allows to configure a different item activation strategy.
     * By default the first item in the list will get activated.
     */
    readonly itemActivation?: ItemActivation;
    /**
     * Whether to take the input value as is and not restore it
     * from any existing value if quick access is visible.
     */
    readonly preserveValue?: boolean;
    /**
     * Provider specific options for this particular showing of the
     * quick access.
     */
    readonly providerOptions?: IQuickAccessProviderRunOptions;
    /**
     * An array of provider prefixes to enable for this
     * particular showing of the quick access.
     */
    readonly enabledProviderPrefixes?: string[];
    /**
     * A placeholder to use for this particular showing of the quick access.
    */
    readonly placeholder?: string;
}
export interface IQuickAccessController {
    /**
     * Open the quick access picker with the optional value prefilled.
     */
    show(value?: string, options?: IQuickAccessOptions): void;
    /**
     * Same as `show()` but instead of executing the selected pick item,
     * it will be returned. May return `undefined` in case no item was
     * picked by the user.
     */
    pick(value?: string, options?: IQuickAccessOptions): Promise<IQuickPickItem[] | undefined>;
}
export declare enum DefaultQuickAccessFilterValue {
    /**
     * Keep the value as it is given to quick access.
     */
    PRESERVE = 0,
    /**
     * Use the value that was used last time something was accepted from the picker.
     */
    LAST = 1
}
export interface IQuickAccessProvider {
    /**
     * Allows to set a default filter value when the provider opens. This can be:
     * - `undefined` to not specify any default value
     * - `DefaultFilterValues.PRESERVE` to use the value that was last typed
     * - `string` for the actual value to use
     *
     * Note: the default filter will only be used if quick access was opened with
     * the exact prefix of the provider. Otherwise the filter value is preserved.
     */
    readonly defaultFilterValue?: string | DefaultQuickAccessFilterValue;
    /**
     * Called whenever a prefix was typed into quick pick that matches the provider.
     *
     * @param picker the picker to use for showing provider results. The picker is
     * automatically shown after the method returns, no need to call `show()`.
     * @param token providers have to check the cancellation token everytime after
     * a long running operation or from event handlers because it could be that the
     * picker has been closed or changed meanwhile. The token can be used to find out
     * that the picker was closed without picking an entry (e.g. was canceled by the user).
     * @param options additional configuration specific for this provider that will
     * influence what picks will be shown.
     * @return a disposable that will automatically be disposed when the picker
     * closes or is replaced by another picker.
     */
    provide(picker: IQuickPick<IQuickPickItem, {
        useSeparators: true;
    }>, token: CancellationToken, options?: IQuickAccessProviderRunOptions): IDisposable;
}
export interface IQuickAccessProviderHelp {
    /**
     * The prefix to show for the help entry. If not provided,
     * the prefix used for registration will be taken.
     */
    readonly prefix?: string;
    /**
     * A description text to help understand the intent of the provider.
     */
    readonly description: string;
    /**
     * The command to bring up this quick access provider.
     */
    readonly commandId?: string;
    /**
     * The order of help entries in the Command Center.
     * Lower values will be placed above higher values.
     * No value will hide this help entry from the Command Center.
     */
    readonly commandCenterOrder?: number;
    /**
     * An optional label to use for the Command Center entry. If not set
     * the description will be used instead.
     */
    readonly commandCenterLabel?: string;
}
export interface IQuickAccessProviderDescriptor {
    /**
     * The actual provider that will be instantiated as needed.
     */
    readonly ctor: {
        new (...services: any[]): IQuickAccessProvider;
    };
    /**
     * The prefix for quick access picker to use the provider for.
     */
    readonly prefix: string;
    /**
     * A placeholder to use for the input field when the provider is active.
     * This will also be read out by screen readers and thus helps for
     * accessibility.
     */
    readonly placeholder?: string;
    /**
     * Documentation for the provider in the quick access help.
     */
    readonly helpEntries: IQuickAccessProviderHelp[];
    /**
     * A context key that will be set automatically when the
     * picker for the provider is showing.
     */
    readonly contextKey?: string;
    /**
     * A context key expression that must evaluate to true for the
     * provider to be considered in the registry.
     */
    readonly when?: ContextKeyExpression;
}
export declare const Extensions: {
    Quickaccess: string;
};
export interface IQuickAccessRegistry {
    /**
     * Registers a quick access provider to the platform.
     */
    registerQuickAccessProvider(provider: IQuickAccessProviderDescriptor): IDisposable;
    /**
     * Get all registered quick access providers.
     */
    getQuickAccessProviders(contextKeyService: IContextKeyService): IQuickAccessProviderDescriptor[];
    /**
     * Get a specific quick access provider for a given prefix.
     */
    getQuickAccessProvider(prefix: string, contextKeyService: IContextKeyService): IQuickAccessProviderDescriptor | undefined;
}
export declare class QuickAccessRegistry implements IQuickAccessRegistry {
    private providers;
    private defaultProvider;
    registerQuickAccessProvider(provider: IQuickAccessProviderDescriptor): IDisposable;
    getQuickAccessProviders(contextKeyService: IContextKeyService): IQuickAccessProviderDescriptor[];
    getQuickAccessProvider(prefix: string, contextKeyService: IContextKeyService): IQuickAccessProviderDescriptor | undefined;
    clear(): Function;
}