Merge from vscode 4636be2b71c87bfb0bfe3c94278b447a5efcc1f1 (#8722)

* Merge from vscode 4636be2b71c87bfb0bfe3c94278b447a5efcc1f1

* remove tests that aren't working
This commit is contained in:
Anthony Dresser
2019-12-18 00:14:28 -08:00
committed by GitHub
parent 0fd870d156
commit 30d9e9c141
289 changed files with 5537 additions and 3039 deletions

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

@@ -790,7 +790,8 @@ declare module 'vscode' {
}
/**
* A reference to a named icon. Currently only [File](#ThemeIcon.File) and [Folder](#ThemeIcon.Folder) are supported.
* 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.
*/
export class ThemeIcon {
@@ -804,7 +805,11 @@ declare module 'vscode' {
*/
static readonly Folder: ThemeIcon;
private constructor(id: string);
/**
* Creates a reference to a theme icon.
* @param id id of the icon. The avaiable icons are listed in https://microsoft.github.io/vscode-codicons/dist/codicon.html.
*/
constructor(id: string);
}
/**
@@ -1574,17 +1579,17 @@ declare module 'vscode' {
export interface QuickPickItem {
/**
* A human readable string which is rendered prominent.
* A human-readable string which is rendered prominent.
*/
label: string;
/**
* A human readable string which is rendered less prominent.
* A human-readable string which is rendered less prominent.
*/
description?: string;
/**
* A human readable string which is rendered less prominent.
* A human-readable string which is rendered less prominent.
*/
detail?: string;
@@ -1688,7 +1693,7 @@ declare module 'vscode' {
canSelectMany?: boolean;
/**
* A set of file filters that are used by the dialog. Each entry is a human readable label,
* A set of file filters that are used by the dialog. Each entry is a human-readable label,
* like "TypeScript", and an array of extensions, e.g.
* ```ts
* {
@@ -1715,7 +1720,7 @@ declare module 'vscode' {
saveLabel?: string;
/**
* A set of file filters that are used by the dialog. Each entry is a human readable label,
* A set of file filters that are used by the dialog. Each entry is a human-readable label,
* like "TypeScript", and an array of extensions, e.g.
* ```ts
* {
@@ -1810,7 +1815,7 @@ declare module 'vscode' {
* to the user.
*
* @param value The current value of the input box.
* @return A human readable string which is presented as diagnostic message.
* @return A human-readable string which is presented as diagnostic message.
* Return `undefined`, `null`, or the empty string when 'value' is valid.
*/
validateInput?(value: string): string | undefined | null | Thenable<string | undefined | null>;
@@ -2336,17 +2341,11 @@ declare module 'vscode' {
}
/**
* The MarkdownString represents human readable text that supports formatting via the
* The MarkdownString represents human-readable text that supports formatting via the
* markdown syntax. Standard markdown is supported, also tables, but no embedded html.
*/
export class MarkdownString {
/**
* Escapes any [ThemeIcons](#ThemeIcon), e.g. `$(zap)`, in the string.
* @param value A string.
*/
static escapeThemeIcons(value: string): string;
/**
* The markdown string.
*/
@@ -2362,9 +2361,9 @@ declare module 'vscode' {
* Creates a new markdown string with the given value.
*
* @param value Optional, initial value.
* @param options Optional, options to specify whether [ThemeIcons](#ThemeIcon) are supported within the [`MarkdownString`](#MarkdownString).
* @param supportThemeIcons Optional, Specifies whether [ThemeIcons](#ThemeIcon) are supported within the [`MarkdownString`](#MarkdownString).
*/
constructor(value?: string, options?: { supportThemeIcons?: boolean });
constructor(value?: string, supportThemeIcons?: boolean);
/**
* Appends and escapes the given string to this markdown string.
@@ -2373,7 +2372,7 @@ declare module 'vscode' {
appendText(value: string): MarkdownString;
/**
* Appends the given string 'as is' to this markdown string.
* Appends the given string 'as is' to this markdown string. When [`supportThemeIcons`](#MarkdownString.supportThemeIcons) is `true`, [ThemeIcons](#ThemeIcon) in the `value` will be iconified.
* @param value Markdown string.
*/
appendMarkdown(value: string): MarkdownString;
@@ -2387,7 +2386,7 @@ declare module 'vscode' {
}
/**
* ~~MarkedString can be used to render human readable text. It is either a markdown string
* ~~MarkedString can be used to render human-readable text. It is either a markdown string
* or a code-block that provides a language and a code snippet. Note that
* markdown strings will be sanitized - that means html will be escaped.~~
*
@@ -2684,7 +2683,7 @@ declare module 'vscode' {
*/
export interface DocumentSymbolProviderMetadata {
/**
* A human readable string that is shown when multiple outlines trees show for one document.
* A human-readable string that is shown when multiple outlines trees show for one document.
*/
label?: string;
}
@@ -4015,7 +4014,7 @@ declare module 'vscode' {
* @returns A call hierarchy item or a thenable that resolves to such. The lack of a result can be
* signaled by returning `undefined` or `null`.
*/
prepareCallHierarchy(document: TextDocument, position: Position, token: CancellationToken): ProviderResult<CallHierarchyItem>;
prepareCallHierarchy(document: TextDocument, position: Position, token: CancellationToken): ProviderResult<CallHierarchyItem | CallHierarchyItem[]>;
/**
* Provide all incoming calls for an item, e.g all callers for a method. In graph terms this describes directed
@@ -5717,7 +5716,7 @@ declare module 'vscode' {
/**
* Enumeration of file types. The types `File` and `Directory` can also be
* a symbolic links, in that use `FileType.File | FileType.SymbolicLink` and
* a symbolic links, in that case use `FileType.File | FileType.SymbolicLink` and
* `FileType.Directory | FileType.SymbolicLink`.
*/
export enum FileType {
@@ -5746,6 +5745,8 @@ declare module 'vscode' {
/**
* The type of the file, e.g. is a regular file, a directory, or symbolic link
* to a file.
*
* *Note:* This value might be a bitmask, e.g. `FileType.File | FileType.SymbolicLink`.
*/
type: FileType;
/**
@@ -7375,7 +7376,7 @@ declare module 'vscode' {
iconPath?: string | Uri | { light: string | Uri; dark: string | Uri } | ThemeIcon;
/**
* A human readable string which is rendered less prominent.
* A human-readable string which is rendered less prominent.
* When `true`, it is derived from [resourceUri](#TreeItem.resourceUri) and when `falsy`, it is not shown.
*/
description?: string | boolean;
@@ -9584,7 +9585,45 @@ declare module 'vscode' {
constructor(port: number, host?: string);
}
export type DebugAdapterDescriptor = DebugAdapterExecutable | DebugAdapterServer;
/**
* A debug adapter that implements the Debug Adapter Protocol can be registered with VS Code if it implements the DebugAdapter interface.
*/
export interface DebugAdapter extends Disposable {
/**
* An event which fires after the debug adapter has sent a Debug Adapter Protocol message to VS Code.
* Messages can be requests, responses, or events.
*/
readonly onDidSendMessage: Event<DebugProtocolMessage>;
/**
* Handle a Debug Adapter Protocol message.
* Messages can be requests, responses, or events.
* Results or errors are returned via onSendMessage events.
* @param message A Debug Adapter Protocol message
*/
handleMessage(message: DebugProtocolMessage): void;
}
/**
* A DebugProtocolMessage is an opaque stand-in type for the [ProtocolMessage](https://microsoft.github.io/debug-adapter-protocol/specification#Base_Protocol_ProtocolMessage) type defined in the Debug Adapter Protocol.
*/
export interface DebugProtocolMessage {
// Properties: see details [here](https://microsoft.github.io/debug-adapter-protocol/specification#Base_Protocol_ProtocolMessage).
}
/**
* A debug adapter descriptor for an inline implementation.
*/
export class DebugAdapterInlineImplementation {
/**
* Create a descriptor for an inline implementation of a debug adapter.
*/
constructor(implementation: DebugAdapter);
}
export type DebugAdapterDescriptor = DebugAdapterExecutable | DebugAdapterServer | DebugAdapterInlineImplementation;
export interface DebugAdapterDescriptorFactory {
/**