Merge from vscode 718331d6f3ebd1b571530ab499edb266ddd493d5

This commit is contained in:
ADS Merger
2020-02-08 04:50:58 +00:00
parent 8c61538a27
commit 2af13c18d2
752 changed files with 16458 additions and 10063 deletions

60
src/vs/vscode.d.ts vendored
View File

@@ -793,15 +793,18 @@ declare module 'vscode' {
* A reference to a named icon. Currently, [File](#ThemeIcon.File), [Folder](#ThemeIcon.Folder),
* and [codicons](https://microsoft.github.io/vscode-codicons/dist/codicon.html) are supported.
* Using a theme icon is preferred over a custom icon as it gives theme authors the possibility to change the icons.
*
* *Note* that theme icons can also be rendered inside labels and descriptions. Places that support theme icons spell this out
* and they use the `$(<name>)`-syntax, for instance `quickPick.label = "Hello World $(globe)"`.
*/
export class ThemeIcon {
/**
* Reference to a icon representing a file. The icon is taken from the current file icon theme or a placeholder icon.
* Reference to an icon representing a file. The icon is taken from the current file icon theme or a placeholder icon is used.
*/
static readonly File: ThemeIcon;
/**
* Reference to a icon representing a folder. The icon is taken from the current file icon theme or a placeholder icon.
* Reference to an icon representing a folder. The icon is taken from the current file icon theme or a placeholder icon is used.
*/
static readonly Folder: ThemeIcon;
@@ -1578,17 +1581,20 @@ declare module 'vscode' {
export interface QuickPickItem {
/**
* A human-readable string which is rendered prominent.
* A human-readable string which is rendered prominent. Supports rendering of [theme icons](#ThemeIcon) via
* the `$(<name>)`-syntax.
*/
label: string;
/**
* A human-readable string which is rendered less prominent in the same line.
* A human-readable string which is rendered less prominent in the same line. Supports rendering of
* [theme icons](#ThemeIcon) via the `$(<name>)`-syntax.
*/
description?: string;
/**
* A human-readable string which is rendered less prominent in a separate line.
* A human-readable string which is rendered less prominent in a separate line. Supports rendering of
* [theme icons](#ThemeIcon) via the `$(<name>)`-syntax.
*/
detail?: string;
@@ -2163,14 +2169,16 @@ declare module 'vscode' {
}
/**
* Metadata about the type of code actions that a [CodeActionProvider](#CodeActionProvider) providers
* Metadata about the type of code actions that a [CodeActionProvider](#CodeActionProvider) providers.
*/
export interface CodeActionProviderMetadata {
/**
* [CodeActionKinds](#CodeActionKind) that this provider may return.
* List of [CodeActionKinds](#CodeActionKind) that a [CodeActionProvider](#CodeActionProvider) may return.
*
* The list of kinds may be generic, such as `CodeActionKind.Refactor`, or the provider
* may list our every specific kind they provide, such as `CodeActionKind.Refactor.Extract.append('function`)`
* This list is used to determine if a given `CodeActionProvider` should be invoked or not.
* To avoid unnecessary computation, every `CodeActionProvider` should list use `providedCodeActionKinds`. The
* list of kinds may either be generic, such as `[CodeActionKind.Refactor]`, or list out every kind provided,
* such as `[CodeActionKind.Refactor.Extract.append('function'), CodeActionKind.Refactor.Extract.append('constant'), ...]`.
*/
readonly providedCodeActionKinds?: ReadonlyArray<CodeActionKind>;
}
@@ -2342,6 +2350,9 @@ declare module 'vscode' {
/**
* The MarkdownString represents human-readable text that supports formatting via the
* markdown syntax. Standard markdown is supported, also tables, but no embedded html.
*
* When created with `supportThemeIcons` then rendering of [theme icons](#ThemeIcon) via
* the `$(<name>)`-syntax is supported.
*/
export class MarkdownString {
@@ -3983,7 +3994,7 @@ declare module 'vscode' {
/**
* The range at which this item is called. This is the range relative to the caller, e.g the item
* passed to [`provideCallHierarchyOutgoingCalls`](#CallHierarchyItemProvider.provideCallHierarchyOutgoingCalls)
* passed to [`provideCallHierarchyOutgoingCalls`](#CallHierarchyProvider.provideCallHierarchyOutgoingCalls)
* and not [`this.to`](#CallHierarchyOutgoingCall.to).
*/
fromRanges: Range[];
@@ -4351,7 +4362,7 @@ declare module 'vscode' {
workspaceFolderValue?: T,
defaultLanguageValue?: T;
userLanguageValue?: T;
globalLanguageValue?: T;
workspaceLanguageValue?: T;
workspaceFolderLanguageValue?: T;
@@ -4378,7 +4389,7 @@ declare module 'vscode' {
* - If `false` updates [Workspace settings](#ConfigurationTarget.Workspace).
* - If `undefined` or `null` updates to [Workspace folder settings](#ConfigurationTarget.WorkspaceFolder) if configuration is resource specific,
* otherwise to [Workspace settings](#ConfigurationTarget.Workspace).
* @param scopeToLanguage Whether to update the value in the scope of requested languageId or not.
* @param overrideInLanguage Whether to update the value in the scope of requested languageId or not.
* - If `true` updates the value under the requested languageId.
* - If `undefined` updates the value under the requested languageId only if the configuration is defined for the language.
* @throws error while updating
@@ -4388,7 +4399,7 @@ declare module 'vscode' {
* - configuration to workspace folder when there is no workspace folder settings.
* - configuration to workspace folder when [WorkspaceConfiguration](#WorkspaceConfiguration) is not scoped to a resource.
*/
update(section: string, value: any, configurationTarget?: ConfigurationTarget | boolean, scopeToLanguage?: boolean): Thenable<void>;
update(section: string, value: any, configurationTarget?: ConfigurationTarget | boolean, overrideInLanguage?: boolean): Thenable<void>;
/**
* Readable dictionary that backs this configuration.
@@ -5557,8 +5568,8 @@ declare module 'vscode' {
isBackground: boolean;
/**
* A human-readable string describing the source of this
* shell task, e.g. 'gulp' or 'npm'.
* A human-readable string describing the source of this shell task, e.g. 'gulp'
* or 'npm'. Supports rendering of [theme icons](#ThemeIcon) via the `$(<name>)`-syntax.
*/
source: string;
@@ -7602,7 +7613,7 @@ declare module 'vscode' {
onDidWrite: Event<string>;
/**
* An event that when fired allows overriding the [dimensions](#Terminal.dimensions) of the
* An event that when fired allows overriding the [dimensions](#Pseudoterminal.setDimensions) of the
* terminal. Note that when set, the overridden dimensions will only take effect when they
* are lower than the actual dimensions of the terminal (ie. there will never be a scroll
* bar). Set to `undefined` for the terminal to go back to the regular dimensions (fit to
@@ -8039,19 +8050,19 @@ declare module 'vscode' {
/**
* The range that got replaced.
*/
range: Range;
readonly range: Range;
/**
* The offset of the range that got replaced.
*/
rangeOffset: number;
readonly rangeOffset: number;
/**
* The length of the range that got replaced.
*/
rangeLength: number;
readonly rangeLength: number;
/**
* The new text for the range.
*/
text: string;
readonly text: string;
}
/**
@@ -8738,6 +8749,7 @@ declare module 'vscode' {
* When a scope is provided configuraiton confined to that scope is returned. Scope can be a resource or a language identifier or both.
*
* @param section A dot-separated identifier.
* @param scope A scope for which the configuration is asked for.
* @return The full configuration or a subset.
*/
export function getConfiguration(section?: string | undefined, scope?: ConfigurationScope | null): WorkspaceConfiguration;
@@ -8772,6 +8784,12 @@ declare module 'vscode' {
export function registerFileSystemProvider(scheme: string, provider: FileSystemProvider, options?: { readonly isCaseSensitive?: boolean, readonly isReadonly?: boolean }): Disposable;
}
/**
* The configuration scope which can be a
* a 'resource' or a languageId or both or
* a '[TextDocument](#TextDocument)' or
* a '[WorkspaceFolder](#WorkspaceFolder)'
*/
export type ConfigurationScope = Uri | TextDocument | WorkspaceFolder | { uri?: Uri, languageId: string };
/**
@@ -10036,7 +10054,7 @@ declare module 'vscode' {
* return api;
* }
* ```
* When depending on the API of another extension add an `extensionDependency`-entry
* When depending on the API of another extension add an `extensionDependencies`-entry
* to `package.json`, and use the [getExtension](#extensions.getExtension)-function
* and the [exports](#Extension.exports)-property, like below:
*