import { Event } from '../../../base/common/event.js';
import { IDisposable } from '../../../base/common/lifecycle.js';
import { URI } from '../../../base/common/uri.js';
import { ILanguageIdCodec } from '../languages.js';
export declare const ILanguageService: import("../../../platform/instantiation/common/instantiation.js").ServiceIdentifier<ILanguageService>;
export interface ILanguageExtensionPoint {
    id: string;
    extensions?: string[];
    filenames?: string[];
    filenamePatterns?: string[];
    firstLine?: string;
    aliases?: string[];
    mimetypes?: string[];
    configuration?: URI;
    /**
     * @internal
     */
    icon?: ILanguageIcon;
}
export interface ILanguageSelection {
    readonly languageId: string;
    readonly onDidChange: Event<string>;
}
export interface ILanguageNameIdPair {
    readonly languageName: string;
    readonly languageId: string;
}
export interface ILanguageIcon {
    readonly light: URI;
    readonly dark: URI;
}
export interface ILanguageService {
    readonly _serviceBrand: undefined;
    /**
     * A codec which can encode and decode a string `languageId` as a number.
     */
    readonly languageIdCodec: ILanguageIdCodec;
    /**
     * An event emitted when basic language features are requested for the first time.
     * This event is emitted when embedded languages are encountered (e.g. JS code block inside Markdown)
     * or when a language is associated to a text model.
     *
     * **Note**: Basic language features refers to language configuration related features.
     * **Note**: This event is a superset of `onDidRequestRichLanguageFeatures`
     */
    onDidRequestBasicLanguageFeatures: Event<string>;
    /**
     * An event emitted when rich language features are requested for the first time.
     * This event is emitted when a language is associated to a text model.
     *
     * **Note**: Rich language features refers to tokenizers, language features based on providers, etc.
     * **Note**: This event is a subset of `onDidRequestRichLanguageFeatures`
     */
    onDidRequestRichLanguageFeatures: Event<string>;
    /**
     * An event emitted when languages have changed.
     */
    onDidChange: Event<void>;
    /**
     * Register a language.
     */
    registerLanguage(def: ILanguageExtensionPoint): IDisposable;
    /**
     * Check if `languageId` is registered.
     */
    isRegisteredLanguageId(languageId: string): boolean;
    /**
     * Get a list of all registered languages.
     */
    getRegisteredLanguageIds(): string[];
    /**
     * Get a list of all registered languages with a name.
     * If a language is explicitly registered without a name, it will not be part of the result.
     * The result is sorted using by name case insensitive.
     */
    getSortedRegisteredLanguageNames(): ILanguageNameIdPair[];
    /**
     * Get the preferred language name for a language.
     */
    getLanguageName(languageId: string): string | null;
    /**
     * Get the mimetype for a language.
     */
    getMimeType(languageId: string): string | null;
    /**
     * Get the default icon for the language.
     */
    getIcon(languageId: string): ILanguageIcon | null;
    /**
     * Get all file extensions for a language.
     */
    getExtensions(languageId: string): ReadonlyArray<string>;
    /**
     * Get all file names for a language.
     */
    getFilenames(languageId: string): ReadonlyArray<string>;
    /**
     * Get all language configuration files for a language.
     */
    getConfigurationFiles(languageId: string): ReadonlyArray<URI>;
    /**
     * Look up a language by its name case insensitive.
     */
    getLanguageIdByLanguageName(languageName: string): string | null;
    /**
     * Look up a language by its mime type.
     */
    getLanguageIdByMimeType(mimeType: string | null | undefined): string | null;
    /**
     * Guess the language id for a resource.
     */
    guessLanguageIdByFilepathOrFirstLine(resource: URI, firstLine?: string): string | null;
    /**
     * Will fall back to 'plaintext' if `languageId` is unknown.
     */
    createById(languageId: string | null | undefined): ILanguageSelection;
    /**
     * Will fall back to 'plaintext' if `mimeType` is unknown.
     */
    createByMimeType(mimeType: string | null | undefined): ILanguageSelection;
    /**
     * Will fall back to 'plaintext' if the `languageId` cannot be determined.
     */
    createByFilepathOrFirstLine(resource: URI | null, firstLine?: string): ILanguageSelection;
    /**
     * Request basic language features for a language.
     */
    requestBasicLanguageFeatures(languageId: string): void;
    /**
     * Request rich language features for a language.
     */
    requestRichLanguageFeatures(languageId: string): void;
}