extHost.api.impl.ts 48.0 KB
Newer Older
E
Erich Gamma 已提交
1 2 3 4 5
/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

A
Alex Dima 已提交
6 7 8
import { localize } from 'vs/nls';
import { CancellationTokenSource } from 'vs/base/common/cancellation';
import * as errors from 'vs/base/common/errors';
J
Joao Moreno 已提交
9
import { Emitter, Event } from 'vs/base/common/event';
10
import { TernarySearchTree } from 'vs/base/common/map';
11
import * as path from 'vs/base/common/path';
A
Alex Dima 已提交
12
import * as platform from 'vs/base/common/platform';
A
Alex Dima 已提交
13 14 15 16 17 18 19
import Severity from 'vs/base/common/severity';
import { URI } from 'vs/base/common/uri';
import { TextEditorCursorStyle } from 'vs/editor/common/config/editorOptions';
import { OverviewRulerLane } from 'vs/editor/common/model';
import * as languageConfiguration from 'vs/editor/common/modes/languageConfiguration';
import { score } from 'vs/editor/common/modes/languageSelector';
import * as files from 'vs/platform/files/common/files';
20
import pkg from 'vs/platform/node/package';
A
Alex Dima 已提交
21 22 23 24 25 26
import product from 'vs/platform/node/product';
import { ExtHostContext, IInitData, IMainContext, MainContext } from 'vs/workbench/api/node/extHost.protocol';
import { ExtHostApiCommands } from 'vs/workbench/api/node/extHostApiCommands';
import { ExtHostClipboard } from 'vs/workbench/api/node/extHostClipboard';
import { ExtHostCommands } from 'vs/workbench/api/node/extHostCommands';
import { ExtHostComments } from 'vs/workbench/api/node/extHostComments';
27
import { ExtHostConfiguration, ExtHostConfigProvider } from 'vs/workbench/api/node/extHostConfiguration';
A
Alex Dima 已提交
28 29
import { ExtHostDebugService } from 'vs/workbench/api/node/extHostDebugService';
import { ExtHostDecorations } from 'vs/workbench/api/node/extHostDecorations';
J
Johannes Rieken 已提交
30
import { ExtHostDiagnostics } from 'vs/workbench/api/node/extHostDiagnostics';
A
Alex Dima 已提交
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
import { ExtHostDialogs } from 'vs/workbench/api/node/extHostDialogs';
import { ExtHostDocumentContentProvider } from 'vs/workbench/api/node/extHostDocumentContentProviders';
import { ExtHostDocumentSaveParticipant } from 'vs/workbench/api/node/extHostDocumentSaveParticipant';
import { ExtHostDocuments } from 'vs/workbench/api/node/extHostDocuments';
import { ExtHostDocumentsAndEditors } from 'vs/workbench/api/node/extHostDocumentsAndEditors';
import { ExtensionActivatedByAPI } from 'vs/workbench/api/node/extHostExtensionActivator';
import { ExtHostExtensionService } from 'vs/workbench/api/node/extHostExtensionService';
import { ExtHostFileSystem } from 'vs/workbench/api/node/extHostFileSystem';
import { ExtHostFileSystemEventService } from 'vs/workbench/api/node/extHostFileSystemEventService';
import { ExtHostHeapService } from 'vs/workbench/api/node/extHostHeapService';
import { ExtHostLanguageFeatures, ISchemeTransformer } from 'vs/workbench/api/node/extHostLanguageFeatures';
import { ExtHostLanguages } from 'vs/workbench/api/node/extHostLanguages';
import { ExtHostLogService } from 'vs/workbench/api/node/extHostLogService';
import { ExtHostMessageService } from 'vs/workbench/api/node/extHostMessageService';
import { ExtHostOutputService } from 'vs/workbench/api/node/extHostOutputService';
46
import { ExtHostProgress } from 'vs/workbench/api/node/extHostProgress';
A
Alex Dima 已提交
47
import { ExtHostQuickOpen } from 'vs/workbench/api/node/extHostQuickOpen';
J
Joao Moreno 已提交
48
import { ExtHostSCM } from 'vs/workbench/api/node/extHostSCM';
A
Alex Dima 已提交
49
import { ExtHostSearch } from 'vs/workbench/api/node/extHostSearch';
J
Johannes Rieken 已提交
50
import { ExtHostStatusBar } from 'vs/workbench/api/node/extHostStatusBar';
A
Alex Dima 已提交
51 52
import { ExtHostStorage } from 'vs/workbench/api/node/extHostStorage';
import { ExtHostTask } from 'vs/workbench/api/node/extHostTask';
J
Johannes Rieken 已提交
53
import { ExtHostTerminalService } from 'vs/workbench/api/node/extHostTerminalService';
J
Johannes Rieken 已提交
54
import { ExtHostEditors } from 'vs/workbench/api/node/extHostTextEditors';
A
Alex Dima 已提交
55 56
import { ExtHostTreeViews } from 'vs/workbench/api/node/extHostTreeViews';
import * as typeConverters from 'vs/workbench/api/node/extHostTypeConverters';
J
Johannes Rieken 已提交
57
import * as extHostTypes from 'vs/workbench/api/node/extHostTypes';
A
Alex Dima 已提交
58 59 60
import { ExtHostUrls } from 'vs/workbench/api/node/extHostUrls';
import { ExtHostWebviews } from 'vs/workbench/api/node/extHostWebview';
import { ExtHostWindow } from 'vs/workbench/api/node/extHostWindow';
61
import { ExtHostWorkspace, ExtHostWorkspaceProvider } from 'vs/workbench/api/node/extHostWorkspace';
62
import { IExtensionDescription, throwProposedApiError, checkProposedApiEnabled, nullExtensionDescription } from 'vs/workbench/services/extensions/common/extensions';
A
Alex Dima 已提交
63
import { ProxyIdentifier } from 'vs/workbench/services/extensions/node/proxyIdentifier';
A
Alex Dima 已提交
64
import { ExtensionDescriptionRegistry } from 'vs/workbench/services/extensions/node/extensionDescriptionRegistry';
A
Alex Dima 已提交
65
import * as vscode from 'vscode';
66
import { ExtensionIdentifier } from 'vs/platform/extensions/common/extensions';
67
import { originalFSPath } from 'vs/base/common/resources';
E
Erich Gamma 已提交
68

69
export interface IExtensionApiFactory {
70
	(extension: IExtensionDescription, registry: ExtensionDescriptionRegistry, workspaceProvider: ExtHostWorkspaceProvider, configProvider: ExtHostConfigProvider): typeof vscode;
71 72
}

73
function proposedApiFunction<T>(extension: IExtensionDescription, fn: T): T {
74
	if (extension.enableProposedApi) {
75 76
		return fn;
	} else {
77
		return throwProposedApiError.bind(null, extension) as any as T;
78 79 80
	}
}

E
Erich Gamma 已提交
81
/**
82
 * This method instantiates and returns the extension API surface
E
Erich Gamma 已提交
83
 */
84 85
export function createApiFactory(
	initData: IInitData,
86
	rpcProtocol: IMainContext,
87 88
	extHostWorkspace: ExtHostWorkspace,
	extHostConfiguration: ExtHostConfiguration,
J
Joao Moreno 已提交
89
	extensionService: ExtHostExtensionService,
90 91
	extHostLogService: ExtHostLogService,
	extHostStorage: ExtHostStorage
92
): IExtensionApiFactory {
93

94
	let schemeTransformer: ISchemeTransformer | null = null;
A
Alex Dima 已提交
95

96
	// Addressable instances
97
	rpcProtocol.set(ExtHostContext.ExtHostLogService, extHostLogService);
A
Alex Dima 已提交
98 99
	const extHostHeapService = rpcProtocol.set(ExtHostContext.ExtHostHeapService, new ExtHostHeapService());
	const extHostDecorations = rpcProtocol.set(ExtHostContext.ExtHostDecorations, new ExtHostDecorations(rpcProtocol));
M
Matt Bierner 已提交
100
	const extHostWebviews = rpcProtocol.set(ExtHostContext.ExtHostWebviews, new ExtHostWebviews(rpcProtocol));
J
Joao Moreno 已提交
101
	const extHostUrls = rpcProtocol.set(ExtHostContext.ExtHostUrls, new ExtHostUrls(rpcProtocol));
102
	const extHostDocumentsAndEditors = rpcProtocol.set(ExtHostContext.ExtHostDocumentsAndEditors, new ExtHostDocumentsAndEditors(rpcProtocol));
A
Alex Dima 已提交
103
	const extHostDocuments = rpcProtocol.set(ExtHostContext.ExtHostDocuments, new ExtHostDocuments(rpcProtocol, extHostDocumentsAndEditors));
104
	const extHostDocumentContentProviders = rpcProtocol.set(ExtHostContext.ExtHostDocumentContentProviders, new ExtHostDocumentContentProvider(rpcProtocol, extHostDocumentsAndEditors, extHostLogService));
105
	const extHostDocumentSaveParticipant = rpcProtocol.set(ExtHostContext.ExtHostDocumentSaveParticipant, new ExtHostDocumentSaveParticipant(extHostLogService, extHostDocuments, rpcProtocol.getProxy(MainContext.MainThreadTextEditors)));
A
Alex Dima 已提交
106
	const extHostEditors = rpcProtocol.set(ExtHostContext.ExtHostEditors, new ExtHostEditors(rpcProtocol, extHostDocumentsAndEditors));
107
	const extHostCommands = rpcProtocol.set(ExtHostContext.ExtHostCommands, new ExtHostCommands(rpcProtocol, extHostHeapService, extHostLogService));
S
Sandeep Somavarapu 已提交
108
	const extHostTreeViews = rpcProtocol.set(ExtHostContext.ExtHostTreeViews, new ExtHostTreeViews(rpcProtocol.getProxy(MainContext.MainThreadTreeViews), extHostCommands, extHostLogService));
A
Alex Dima 已提交
109 110 111
	rpcProtocol.set(ExtHostContext.ExtHostWorkspace, extHostWorkspace);
	rpcProtocol.set(ExtHostContext.ExtHostConfiguration, extHostConfiguration);
	const extHostDiagnostics = rpcProtocol.set(ExtHostContext.ExtHostDiagnostics, new ExtHostDiagnostics(rpcProtocol));
112
	const extHostLanguageFeatures = rpcProtocol.set(ExtHostContext.ExtHostLanguageFeatures, new ExtHostLanguageFeatures(rpcProtocol, schemeTransformer, extHostDocuments, extHostCommands, extHostHeapService, extHostDiagnostics, extHostLogService));
113
	const extHostFileSystem = rpcProtocol.set(ExtHostContext.ExtHostFileSystem, new ExtHostFileSystem(rpcProtocol, extHostLanguageFeatures));
114
	const extHostFileSystemEvent = rpcProtocol.set(ExtHostContext.ExtHostFileSystemEventService, new ExtHostFileSystemEventService(rpcProtocol, extHostDocumentsAndEditors));
A
Alex Dima 已提交
115
	const extHostQuickOpen = rpcProtocol.set(ExtHostContext.ExtHostQuickOpen, new ExtHostQuickOpen(rpcProtocol, extHostWorkspace, extHostCommands));
116
	const extHostTerminalService = rpcProtocol.set(ExtHostContext.ExtHostTerminalService, new ExtHostTerminalService(rpcProtocol, extHostConfiguration, extHostLogService, extHostCommands));
117
	const extHostDebugService = rpcProtocol.set(ExtHostContext.ExtHostDebugService, new ExtHostDebugService(rpcProtocol, extHostWorkspace, extensionService, extHostDocumentsAndEditors, extHostConfiguration, extHostTerminalService, extHostCommands));
118
	const extHostSCM = rpcProtocol.set(ExtHostContext.ExtHostSCM, new ExtHostSCM(rpcProtocol, extHostCommands, extHostLogService));
R
Rob Lourens 已提交
119
	const extHostSearch = rpcProtocol.set(ExtHostContext.ExtHostSearch, new ExtHostSearch(rpcProtocol, schemeTransformer, extHostLogService));
120
	const extHostTask = rpcProtocol.set(ExtHostContext.ExtHostTask, new ExtHostTask(rpcProtocol, extHostWorkspace, extHostDocumentsAndEditors, extHostConfiguration));
A
Alex Dima 已提交
121 122
	const extHostWindow = rpcProtocol.set(ExtHostContext.ExtHostWindow, new ExtHostWindow(rpcProtocol));
	rpcProtocol.set(ExtHostContext.ExtHostExtensionService, extensionService);
123
	const extHostProgress = rpcProtocol.set(ExtHostContext.ExtHostProgress, new ExtHostProgress(rpcProtocol.getProxy(MainContext.MainThreadProgress)));
124
	const exthostCommentProviders = rpcProtocol.set(ExtHostContext.ExtHostComments, new ExtHostComments(rpcProtocol, extHostCommands.converter, extHostDocuments));
125
	const extHostOutputService = rpcProtocol.set(ExtHostContext.ExtHostOutputService, new ExtHostOutputService(initData.logsLocation, rpcProtocol));
126
	rpcProtocol.set(ExtHostContext.ExtHostStorage, extHostStorage);
127 128

	// Check that no named customers are missing
A
Alex Dima 已提交
129
	const expected: ProxyIdentifier<any>[] = Object.keys(ExtHostContext).map((key) => (<any>ExtHostContext)[key]);
A
Alex Dima 已提交
130
	rpcProtocol.assertRegistered(expected);
131

132
	// Other instances
133
	const extHostClipboard = new ExtHostClipboard(rpcProtocol);
A
Alex Dima 已提交
134 135 136
	const extHostMessageService = new ExtHostMessageService(rpcProtocol);
	const extHostDialogs = new ExtHostDialogs(rpcProtocol);
	const extHostStatusBar = new ExtHostStatusBar(rpcProtocol);
137
	const extHostLanguages = new ExtHostLanguages(rpcProtocol, extHostDocuments);
138

139
	// Register an output channel for exthost log
A
Tweaks  
Alex Dima 已提交
140 141
	const name = localize('extensionsLog', "Extension Host");
	extHostOutputService.createOutputChannelFromLogFile(name, extHostLogService.logFile);
142

143
	// Register API-ish commands
144
	ExtHostApiCommands.register(extHostCommands);
145

146
	return function (extension: IExtensionDescription, extensionRegistry: ExtensionDescriptionRegistry, workspaceProvider: ExtHostWorkspaceProvider, configProvider: ExtHostConfigProvider): typeof vscode {
147

148 149 150 151 152
		// Check document selectors for being overly generic. Technically this isn't a problem but
		// in practice many extensions say they support `fooLang` but need fs-access to do so. Those
		// extension should specify then the `file`-scheme, e.g `{ scheme: 'fooLang', language: 'fooLang' }`
		// We only inform once, it is not a warning because we just want to raise awareness and because
		// we cannot say if the extension is doing it right or wrong...
153
		const checkSelector = (function () {
A
Alex Dima 已提交
154
			let done = (!extension.isUnderDevelopment);
155 156
			function informOnce(selector: vscode.DocumentSelector) {
				if (!done) {
157
					console.info(`Extension '${extension.identifier.value}' uses a document selector without scheme. Learn more about this: https://go.microsoft.com/fwlink/?linkid=872305`);
158 159
					done = true;
				}
160
			}
161
			return function perform(selector: vscode.DocumentSelector): vscode.DocumentSelector {
162 163 164 165 166 167 168 169 170 171
				if (Array.isArray(selector)) {
					selector.forEach(perform);
				} else if (typeof selector === 'string') {
					informOnce(selector);
				} else {
					if (typeof selector.scheme === 'undefined') {
						informOnce(selector);
					}
					if (!extension.enableProposedApi && typeof selector.exclusive === 'boolean') {
						throwProposedApiError(extension);
172 173 174 175 176
					}
				}
				return selector;
			};
		})();
177

178 179 180
		// Warn when trying to use the vscode.previewHtml command as it does not work properly in all scenarios and
		// has security concerns.
		const checkCommand = (() => {
181
			let done = false;
182 183 184
			const informOnce = () => {
				if (!done) {
					done = true;
185
					window.showWarningMessage(localize('previewHtml.deprecated', "Extension '{0}' uses the 'vscode.previewHtml' command which is deprecated and will be removed soon. Please file an issue against this extension to update to use VS Code's webview API.", extension.identifier.value));
186 187 188 189 190 191 192 193 194 195
				}
			};
			return (commandId: string) => {
				if (commandId === 'vscode.previewHtml') {
					informOnce();
				}
				return commandId;
			};
		})();

196 197
		// namespace: commands
		const commands: typeof vscode.commands = {
M
Matt Bierner 已提交
198
			registerCommand(id: string, command: <T>(...args: any[]) => T | Thenable<T>, thisArgs?: any): vscode.Disposable {
199
				return extHostCommands.registerCommand(true, id, command, thisArgs);
200
			},
201
			registerTextEditorCommand(id: string, callback: (textEditor: vscode.TextEditor, edit: vscode.TextEditorEdit, ...args: any[]) => void, thisArg?: any): vscode.Disposable {
202
				return extHostCommands.registerCommand(true, id, (...args: any[]): any => {
203 204 205
					let activeTextEditor = extHostEditors.getActiveTextEditor();
					if (!activeTextEditor) {
						console.warn('Cannot execute ' + id + ' because there is no active text editor.');
206
						return undefined;
207
					}
208 209 210 211 212 213 214 215 216 217

					return activeTextEditor.edit((edit: vscode.TextEditorEdit) => {
						args.unshift(activeTextEditor, edit);
						callback.apply(thisArg, args);

					}).then((result) => {
						if (!result) {
							console.warn('Edits from command ' + id + ' were not applied.');
						}
					}, (err) => {
218
						console.warn('An error occurred while running command ' + id, err);
219
					});
220
				});
221 222
			},
			registerDiffInformationCommand: proposedApiFunction(extension, (id: string, callback: (diff: vscode.LineChange[], ...args: any[]) => any, thisArg?: any): vscode.Disposable => {
223
				return extHostCommands.registerCommand(true, id, async (...args: any[]): Promise<any> => {
224 225 226 227 228 229 230 231 232
					let activeTextEditor = extHostEditors.getActiveTextEditor();
					if (!activeTextEditor) {
						console.warn('Cannot execute ' + id + ' because there is no active text editor.');
						return undefined;
					}

					const diff = await extHostEditors.getDiffInformation(activeTextEditor.id);
					callback.apply(thisArg, [diff, ...args]);
				});
233
			}),
234
			executeCommand<T>(id: string, ...args: any[]): Thenable<T> {
235
				return extHostCommands.executeCommand<T>(checkCommand(id), ...args);
236
			},
237 238 239
			getCommands(filterInternal: boolean = false): Thenable<string[]> {
				return extHostCommands.getCommands(filterInternal);
			}
240
		};
241

242 243
		// namespace: env
		const env: typeof vscode.env = Object.freeze({
244 245
			get machineId() { return initData.telemetryInfo.machineId; },
			get sessionId() { return initData.telemetryInfo.sessionId; },
246
			get language() { return platform.language!; },
J
Johannes Rieken 已提交
247
			get appName() { return product.nameLong; },
248
			get appRoot() { return initData.environment.appRoot!.fsPath; },
249 250
			get logLevel() {
				checkProposedApiEnabled(extension);
251
				return typeConverters.LogLevel.to(extHostLogService.getLevel());
252 253 254
			},
			get onDidChangeLogLevel() {
				checkProposedApiEnabled(extension);
J
Joao Moreno 已提交
255
				return Event.map(extHostLogService.onDidChangeLogLevel, l => typeConverters.LogLevel.to(l));
256 257 258
			},
			get clipboard(): vscode.Clipboard {
				return extHostClipboard;
259
			},
J
Johannes Rieken 已提交
260
			openExternal(uri: URI) {
261
				return extHostWindow.openUri(uri);
262
			}
263
		});
E
Erich Gamma 已提交
264

265 266
		// namespace: extensions
		const extensions: typeof vscode.extensions = {
267 268
			getExtension(extensionId: string): Extension<any> | undefined {
				const desc = extensionRegistry.getExtensionDescription(extensionId);
269 270 271
				if (desc) {
					return new Extension(extensionService, desc);
				}
272
				return undefined;
273 274
			},
			get all(): Extension<any>[] {
A
Alex Dima 已提交
275
				return extensionRegistry.getAllExtensionDescriptions().map((desc) => new Extension(extensionService, desc));
276 277 278
			},
			get onDidChange() {
				return extensionRegistry.onDidChange;
E
Erich Gamma 已提交
279
			}
280
		};
E
Erich Gamma 已提交
281

282 283 284 285 286
		// namespace: languages
		const languages: typeof vscode.languages = {
			createDiagnosticCollection(name?: string): vscode.DiagnosticCollection {
				return extHostDiagnostics.createDiagnosticCollection(name);
			},
287 288 289
			get onDidChangeDiagnostics() {
				return extHostDiagnostics.onDidChangeDiagnostics;
			},
A
Alex Dima 已提交
290
			getDiagnostics: (resource?: vscode.Uri) => {
291 292
				return <any>extHostDiagnostics.getDiagnostics(resource);
			},
293
			getLanguages(): Thenable<string[]> {
294 295
				return extHostLanguages.getLanguages();
			},
296
			setTextDocumentLanguage(document: vscode.TextDocument, languageId: string): Thenable<vscode.TextDocument> {
M
mechatroner 已提交
297
				return extHostLanguages.changeLanguage(document.uri, languageId);
298
			},
299
			match(selector: vscode.DocumentSelector, document: vscode.TextDocument): number {
300
				return score(typeConverters.LanguageSelector.from(selector), document.uri, document.languageId, true);
301
			},
302
			registerCodeActionsProvider(selector: vscode.DocumentSelector, provider: vscode.CodeActionProvider, metadata?: vscode.CodeActionProviderMetadata): vscode.Disposable {
303
				return extHostLanguageFeatures.registerCodeActionProvider(extension, checkSelector(selector), provider, metadata);
304 305
			},
			registerCodeLensProvider(selector: vscode.DocumentSelector, provider: vscode.CodeLensProvider): vscode.Disposable {
306
				return extHostLanguageFeatures.registerCodeLensProvider(extension, checkSelector(selector), provider);
307
			},
R
Rob DeLine 已提交
308
			registerCodeInsetProvider(selector: vscode.DocumentSelector, provider: vscode.CodeInsetProvider): vscode.Disposable {
309
				checkProposedApiEnabled(extension);
R
Rob DeLine 已提交
310 311
				return extHostLanguageFeatures.registerCodeInsetProvider(extension, checkSelector(selector), provider);
			},
312
			registerDefinitionProvider(selector: vscode.DocumentSelector, provider: vscode.DefinitionProvider): vscode.Disposable {
313
				return extHostLanguageFeatures.registerDefinitionProvider(extension, checkSelector(selector), provider);
314
			},
315 316 317
			registerDeclarationProvider(selector: vscode.DocumentSelector, provider: vscode.DeclarationProvider): vscode.Disposable {
				return extHostLanguageFeatures.registerDeclarationProvider(extension, checkSelector(selector), provider);
			},
M
Matt Bierner 已提交
318
			registerImplementationProvider(selector: vscode.DocumentSelector, provider: vscode.ImplementationProvider): vscode.Disposable {
319
				return extHostLanguageFeatures.registerImplementationProvider(extension, checkSelector(selector), provider);
320
			},
321
			registerTypeDefinitionProvider(selector: vscode.DocumentSelector, provider: vscode.TypeDefinitionProvider): vscode.Disposable {
322
				return extHostLanguageFeatures.registerTypeDefinitionProvider(extension, checkSelector(selector), provider);
323
			},
324
			registerHoverProvider(selector: vscode.DocumentSelector, provider: vscode.HoverProvider): vscode.Disposable {
325
				return extHostLanguageFeatures.registerHoverProvider(extension, checkSelector(selector), provider, extension.identifier);
326 327
			},
			registerDocumentHighlightProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentHighlightProvider): vscode.Disposable {
328
				return extHostLanguageFeatures.registerDocumentHighlightProvider(extension, checkSelector(selector), provider);
329 330
			},
			registerReferenceProvider(selector: vscode.DocumentSelector, provider: vscode.ReferenceProvider): vscode.Disposable {
331
				return extHostLanguageFeatures.registerReferenceProvider(extension, checkSelector(selector), provider);
332 333
			},
			registerRenameProvider(selector: vscode.DocumentSelector, provider: vscode.RenameProvider): vscode.Disposable {
334
				return extHostLanguageFeatures.registerRenameProvider(extension, checkSelector(selector), provider);
335
			},
336 337
			registerDocumentSymbolProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentSymbolProvider, metadata?: vscode.DocumentSymbolProviderMetadata): vscode.Disposable {
				return extHostLanguageFeatures.registerDocumentSymbolProvider(extension, checkSelector(selector), provider, metadata);
338 339
			},
			registerWorkspaceSymbolProvider(provider: vscode.WorkspaceSymbolProvider): vscode.Disposable {
340
				return extHostLanguageFeatures.registerWorkspaceSymbolProvider(extension, provider);
341 342
			},
			registerDocumentFormattingEditProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentFormattingEditProvider): vscode.Disposable {
343
				return extHostLanguageFeatures.registerDocumentFormattingEditProvider(extension, checkSelector(selector), provider);
344 345
			},
			registerDocumentRangeFormattingEditProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentRangeFormattingEditProvider): vscode.Disposable {
346
				return extHostLanguageFeatures.registerDocumentRangeFormattingEditProvider(extension, checkSelector(selector), provider);
347 348
			},
			registerOnTypeFormattingEditProvider(selector: vscode.DocumentSelector, provider: vscode.OnTypeFormattingEditProvider, firstTriggerCharacter: string, ...moreTriggerCharacters: string[]): vscode.Disposable {
349
				return extHostLanguageFeatures.registerOnTypeFormattingEditProvider(extension, checkSelector(selector), provider, [firstTriggerCharacter].concat(moreTriggerCharacters));
350
			},
351 352
			registerSignatureHelpProvider(selector: vscode.DocumentSelector, provider: vscode.SignatureHelpProvider, firstItem?: string | vscode.SignatureHelpProviderMetadata, ...remaining: string[]): vscode.Disposable {
				if (typeof firstItem === 'object') {
353
					return extHostLanguageFeatures.registerSignatureHelpProvider(extension, checkSelector(selector), provider, firstItem);
354
				}
355
				return extHostLanguageFeatures.registerSignatureHelpProvider(extension, checkSelector(selector), provider, typeof firstItem === 'undefined' ? [] : [firstItem, ...remaining]);
356 357
			},
			registerCompletionItemProvider(selector: vscode.DocumentSelector, provider: vscode.CompletionItemProvider, ...triggerCharacters: string[]): vscode.Disposable {
358
				return extHostLanguageFeatures.registerCompletionItemProvider(extension, checkSelector(selector), provider, triggerCharacters);
359 360
			},
			registerDocumentLinkProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentLinkProvider): vscode.Disposable {
361
				return extHostLanguageFeatures.registerDocumentLinkProvider(extension, checkSelector(selector), provider);
362
			},
363
			registerColorProvider(selector: vscode.DocumentSelector, provider: vscode.DocumentColorProvider): vscode.Disposable {
364
				return extHostLanguageFeatures.registerColorProvider(extension, checkSelector(selector), provider);
365
			},
366
			registerFoldingRangeProvider(selector: vscode.DocumentSelector, provider: vscode.FoldingRangeProvider): vscode.Disposable {
367
				return extHostLanguageFeatures.registerFoldingRangeProvider(extension, checkSelector(selector), provider);
368
			},
369 370 371
			registerSelectionRangeProvider(selector: vscode.DocumentSelector, provider: vscode.SelectionRangeProvider): vscode.Disposable {
				return extHostLanguageFeatures.registerSelectionRangeProvider(extension, selector, provider);
			},
372
			setLanguageConfiguration: (language: string, configuration: vscode.LanguageConfiguration): vscode.Disposable => {
373
				return extHostLanguageFeatures.setLanguageConfiguration(language, configuration);
374
			}
375
		};
E
Erich Gamma 已提交
376

377 378 379 380 381 382 383 384
		// namespace: window
		const window: typeof vscode.window = {
			get activeTextEditor() {
				return extHostEditors.getActiveTextEditor();
			},
			get visibleTextEditors() {
				return extHostEditors.getVisibleTextEditors();
			},
385
			get activeTerminal() {
D
Daniel Imms 已提交
386
				return extHostTerminalService.activeTerminal;
387
			},
D
Daniel Imms 已提交
388
			get terminals() {
D
Daniel Imms 已提交
389
				return extHostTerminalService.terminals;
D
Daniel Imms 已提交
390
			},
391
			showTextDocument(documentOrUri: vscode.TextDocument | vscode.Uri, columnOrOptions?: vscode.ViewColumn | vscode.TextDocumentShowOptions, preserveFocus?: boolean): Thenable<vscode.TextEditor> {
392
				let documentPromise: Promise<vscode.TextDocument>;
J
Johannes Rieken 已提交
393
				if (URI.isUri(documentOrUri)) {
394
					documentPromise = Promise.resolve(workspace.openTextDocument(documentOrUri));
B
Benjamin Pasero 已提交
395
				} else {
396
					documentPromise = Promise.resolve(<vscode.TextDocument>documentOrUri);
B
Benjamin Pasero 已提交
397 398 399 400
				}
				return documentPromise.then(document => {
					return extHostEditors.showTextDocument(document, columnOrOptions, preserveFocus);
				});
401 402 403 404
			},
			createTextEditorDecorationType(options: vscode.DecorationRenderOptions): vscode.TextEditorDecorationType {
				return extHostEditors.createTextEditorDecorationType(options);
			},
405 406 407
			onDidChangeActiveTextEditor(listener, thisArg?, disposables?) {
				return extHostEditors.onDidChangeActiveTextEditor(listener, thisArg, disposables);
			},
408 409 410
			onDidChangeVisibleTextEditors(listener, thisArg, disposables) {
				return extHostEditors.onDidChangeVisibleTextEditors(listener, thisArg, disposables);
			},
411
			onDidChangeTextEditorSelection(listener: (e: vscode.TextEditorSelectionChangeEvent) => any, thisArgs?: any, disposables?: extHostTypes.Disposable[]) {
412 413
				return extHostEditors.onDidChangeTextEditorSelection(listener, thisArgs, disposables);
			},
414
			onDidChangeTextEditorOptions(listener: (e: vscode.TextEditorOptionsChangeEvent) => any, thisArgs?: any, disposables?: extHostTypes.Disposable[]) {
415 416
				return extHostEditors.onDidChangeTextEditorOptions(listener, thisArgs, disposables);
			},
417
			onDidChangeTextEditorVisibleRanges(listener: (e: vscode.TextEditorVisibleRangesChangeEvent) => any, thisArgs?: any, disposables?: extHostTypes.Disposable[]) {
418
				return extHostEditors.onDidChangeTextEditorVisibleRanges(listener, thisArgs, disposables);
419
			},
420 421 422
			onDidChangeTextEditorViewColumn(listener, thisArg?, disposables?) {
				return extHostEditors.onDidChangeTextEditorViewColumn(listener, thisArg, disposables);
			},
423 424 425
			onDidCloseTerminal(listener, thisArg?, disposables?) {
				return extHostTerminalService.onDidCloseTerminal(listener, thisArg, disposables);
			},
D
Daniel Imms 已提交
426
			onDidOpenTerminal(listener, thisArg?, disposables?) {
427
				return extHostTerminalService.onDidOpenTerminal(listener, thisArg, disposables);
D
Daniel Imms 已提交
428
			},
D
Daniel Imms 已提交
429
			onDidChangeActiveTerminal(listener, thisArg?, disposables?) {
430
				return extHostTerminalService.onDidChangeActiveTerminal(listener, thisArg, disposables);
D
Daniel Imms 已提交
431
			},
432 433 434
			onDidChangeTerminalDimensions(listener, thisArg?, disposables?) {
				return extHostTerminalService.onDidChangeTerminalDimensions(listener, thisArg, disposables);
			},
J
Joao Moreno 已提交
435 436
			get state() {
				return extHostWindow.state;
437
			},
J
Joao Moreno 已提交
438
			onDidChangeWindowState(listener, thisArg?, disposables?) {
J
Joao Moreno 已提交
439
				return extHostWindow.onDidChangeWindowState(listener, thisArg, disposables);
J
Joao Moreno 已提交
440
			},
J
Joao Moreno 已提交
441
			showInformationMessage(message, first, ...rest) {
442
				return extHostMessageService.showMessage(extension, Severity.Info, message, first, rest);
443
			},
J
Joao Moreno 已提交
444
			showWarningMessage(message, first, ...rest) {
445
				return extHostMessageService.showMessage(extension, Severity.Warning, message, first, rest);
446
			},
J
Joao Moreno 已提交
447
			showErrorMessage(message, first, ...rest) {
448
				return extHostMessageService.showMessage(extension, Severity.Error, message, first, rest);
449
			},
C
Christof Marti 已提交
450
			showQuickPick(items: any, options: vscode.QuickPickOptions, token?: vscode.CancellationToken): any {
451
				return extHostQuickOpen.showQuickPick(items, !!extension.enableProposedApi, options, token);
452
			},
453
			showWorkspaceFolderPick(options: vscode.WorkspaceFolderPickOptions) {
454
				return extHostQuickOpen.showWorkspaceFolderPick(options);
455
			},
456
			showInputBox(options?: vscode.InputBoxOptions, token?: vscode.CancellationToken) {
457
				return extHostQuickOpen.showInput(options, token);
C
Christof Marti 已提交
458
			},
459 460 461 462 463 464
			showOpenDialog(options) {
				return extHostDialogs.showOpenDialog(options);
			},
			showSaveDialog(options) {
				return extHostDialogs.showSaveDialog(options);
			},
465
			createStatusBarItem(position?: vscode.StatusBarAlignment, priority?: number): vscode.StatusBarItem {
466
				return extHostStatusBar.createStatusBarEntry(extension.identifier, <number>position, priority);
467 468 469 470
			},
			setStatusBarMessage(text: string, timeoutOrThenable?: number | Thenable<any>): vscode.Disposable {
				return extHostStatusBar.setStatusBarMessage(text, timeoutOrThenable);
			},
471
			withScmProgress<R>(task: (progress: vscode.Progress<number>) => Thenable<R>) {
472
				console.warn(`[Deprecation Warning] function 'withScmProgress' is deprecated and should no longer be used. Use 'withProgress' instead.`);
473
				return extHostProgress.withProgress(extension, { location: extHostTypes.ProgressLocation.SourceControl }, (progress, token) => task({ report(n: number) { /*noop*/ } }));
J
Johannes Rieken 已提交
474
			},
475
			withProgress<R>(options: vscode.ProgressOptions, task: (progress: vscode.Progress<{ message?: string; worked?: number }>, token: vscode.CancellationToken) => Thenable<R>) {
J
Johannes Rieken 已提交
476
				return extHostProgress.withProgress(extension, options, task);
477
			},
S
Sandeep Somavarapu 已提交
478 479
			createOutputChannel(name: string): vscode.OutputChannel {
				return extHostOutputService.createOutputChannel(name);
480
			},
481
			createWebviewPanel(viewType: string, title: string, showOptions: vscode.ViewColumn | { viewColumn: vscode.ViewColumn, preserveFocus?: boolean }, options: vscode.WebviewPanelOptions & vscode.WebviewOptions): vscode.WebviewPanel {
482
				return extHostWebviews.createWebviewPanel(extension, viewType, title, showOptions, options);
483
			},
484 485 486 487
			createTerminal(nameOrOptions: vscode.TerminalOptions | string, shellPath?: string, shellArgs?: string[]): vscode.Terminal {
				if (typeof nameOrOptions === 'object') {
					return extHostTerminalService.createTerminalFromOptions(<vscode.TerminalOptions>nameOrOptions);
				}
D
Daniel Imms 已提交
488
				return extHostTerminalService.createTerminal(<string>nameOrOptions, shellPath, shellArgs);
489
			},
490
			createTerminalRenderer(name: string): vscode.TerminalRenderer {
491
				return extHostTerminalService.createTerminalRenderer(name);
492
			},
493
			registerTreeDataProvider(viewId: string, treeDataProvider: vscode.TreeDataProvider<any>): vscode.Disposable {
494
				return extHostTreeViews.registerTreeDataProvider(viewId, treeDataProvider, extension);
495
			},
496
			createTreeView(viewId: string, options: { treeDataProvider: vscode.TreeDataProvider<any> }): vscode.TreeView<any> {
497
				return extHostTreeViews.createTreeView(viewId, options, extension);
S
Sandeep Somavarapu 已提交
498
			},
499 500 501
			registerWebviewPanelSerializer: (viewType: string, serializer: vscode.WebviewPanelSerializer) => {
				return extHostWebviews.registerWebviewPanelSerializer(viewType, serializer);
			},
502
			registerDecorationProvider: proposedApiFunction(extension, (provider: vscode.DecorationProvider) => {
503
				return extHostDecorations.registerDecorationProvider(provider, extension.identifier);
M
Matt Bierner 已提交
504
			}),
J
Joao Moreno 已提交
505
			registerUriHandler(handler: vscode.UriHandler) {
506
				return extHostUrls.registerUriHandler(extension.identifier, handler);
J
Joao Moreno 已提交
507
			},
C
Christof Marti 已提交
508
			createQuickPick<T extends vscode.QuickPickItem>(): vscode.QuickPick<T> {
509
				return extHostQuickOpen.createQuickPick(extension.identifier, extension.enableProposedApi);
C
Christof Marti 已提交
510 511
			},
			createInputBox(): vscode.InputBox {
512
				return extHostQuickOpen.createInputBox(extension.identifier);
513
			}
514
		};
E
Erich Gamma 已提交
515

516 517 518
		// namespace: workspace
		const workspace: typeof vscode.workspace = {
			get rootPath() {
519
				return workspaceProvider.getPath();
520 521 522 523
			},
			set rootPath(value) {
				throw errors.readonly();
			},
524
			getWorkspaceFolder(resource) {
525
				return workspaceProvider.getWorkspaceFolder(resource);
526
			},
527
			get workspaceFolders() {
528
				return workspaceProvider.getWorkspaceFolders();
529
			},
530
			get name() {
531
				return workspaceProvider.name;
532 533 534 535
			},
			set name(value) {
				throw errors.readonly();
			},
536
			updateWorkspaceFolders: (index, deleteCount, ...workspaceFoldersToAdd) => {
537
				return workspaceProvider.updateWorkspaceFolders(extension, index, deleteCount || 0, ...workspaceFoldersToAdd);
538
			},
539
			onDidChangeWorkspaceFolders: function (listener, thisArgs?, disposables?) {
540
				return workspaceProvider.onDidChangeWorkspace(listener, thisArgs, disposables);
541
			},
J
Johannes Rieken 已提交
542
			asRelativePath: (pathOrUri, includeWorkspace) => {
543
				return workspaceProvider.getRelativePath(pathOrUri, includeWorkspace);
544 545
			},
			findFiles: (include, exclude, maxResults?, token?) => {
546
				return workspaceProvider.findFiles(typeConverters.GlobPattern.from(include), typeConverters.GlobPattern.from(exclude), maxResults, extension.identifier, token);
547
			},
548 549 550 551 552 553 554 555 556 557 558 559 560
			findTextInFiles: (query: vscode.TextSearchQuery, optionsOrCallback, callbackOrToken?, token?: vscode.CancellationToken) => {
				let options: vscode.FindTextInFilesOptions;
				let callback: (result: vscode.TextSearchResult) => void;

				if (typeof optionsOrCallback === 'object') {
					options = optionsOrCallback;
					callback = callbackOrToken;
				} else {
					options = {};
					callback = optionsOrCallback;
					token = callbackOrToken;
				}

561
				return workspaceProvider.findTextInFiles(query, options || {}, callback, extension.identifier, token);
R
Rob Lourens 已提交
562
			},
563
			saveAll: (includeUntitled?) => {
564
				return workspaceProvider.saveAll(includeUntitled);
565
			},
566
			applyEdit(edit: vscode.WorkspaceEdit): Thenable<boolean> {
567
				return extHostEditors.applyWorkspaceEdit(edit);
568 569
			},
			createFileSystemWatcher: (pattern, ignoreCreate, ignoreChange, ignoreDelete): vscode.FileSystemWatcher => {
570
				return extHostFileSystemEvent.createFileSystemWatcher(typeConverters.GlobPattern.from(pattern), ignoreCreate, ignoreChange, ignoreDelete);
571 572 573 574 575 576 577
			},
			get textDocuments() {
				return extHostDocuments.getAllDocumentData().map(data => data.document);
			},
			set textDocuments(value) {
				throw errors.readonly();
			},
578
			openTextDocument(uriOrFileNameOrOptions?: vscode.Uri | string | { language?: string; content?: string; }) {
579
				let uriPromise: Thenable<URI>;
B
Benjamin Pasero 已提交
580

581
				let options = uriOrFileNameOrOptions as { language?: string; content?: string; };
B
Benjamin Pasero 已提交
582
				if (typeof uriOrFileNameOrOptions === 'string') {
583
					uriPromise = Promise.resolve(URI.file(uriOrFileNameOrOptions));
B
Benjamin Pasero 已提交
584
				} else if (uriOrFileNameOrOptions instanceof URI) {
585
					uriPromise = Promise.resolve(uriOrFileNameOrOptions);
B
Benjamin Pasero 已提交
586 587
				} else if (!options || typeof options === 'object') {
					uriPromise = extHostDocuments.createDocumentData(options);
588
				} else {
B
Benjamin Pasero 已提交
589
					throw new Error('illegal argument - uriOrFileNameOrOptions');
590
				}
B
Benjamin Pasero 已提交
591 592 593 594 595 596

				return uriPromise.then(uri => {
					return extHostDocuments.ensureDocumentData(uri).then(() => {
						const data = extHostDocuments.getDocumentData(uri);
						return data && data.document;
					});
597 598 599 600 601 602 603 604 605 606 607 608 609 610 611
				});
			},
			onDidOpenTextDocument: (listener, thisArgs?, disposables?) => {
				return extHostDocuments.onDidAddDocument(listener, thisArgs, disposables);
			},
			onDidCloseTextDocument: (listener, thisArgs?, disposables?) => {
				return extHostDocuments.onDidRemoveDocument(listener, thisArgs, disposables);
			},
			onDidChangeTextDocument: (listener, thisArgs?, disposables?) => {
				return extHostDocuments.onDidChangeDocument(listener, thisArgs, disposables);
			},
			onDidSaveTextDocument: (listener, thisArgs?, disposables?) => {
				return extHostDocuments.onDidSaveDocument(listener, thisArgs, disposables);
			},
			onWillSaveTextDocument: (listener, thisArgs?, disposables?) => {
612
				return extHostDocumentSaveParticipant.getOnWillSaveTextDocumentEvent(extension)(listener, thisArgs, disposables);
613
			},
614
			onDidChangeConfiguration: (listener: (_: any) => any, thisArgs?: any, disposables?: extHostTypes.Disposable[]) => {
615
				return configProvider.onDidChangeConfiguration(listener, thisArgs, disposables);
616
			},
617
			getConfiguration(section?: string, resource?: vscode.Uri): vscode.WorkspaceConfiguration {
R
Rob Lourens 已提交
618
				resource = arguments.length === 1 ? undefined : resource;
619
				return configProvider.getConfiguration(section, resource, extension.identifier);
620
			},
621 622
			registerTextDocumentContentProvider(scheme: string, provider: vscode.TextDocumentContentProvider) {
				return extHostDocumentContentProviders.registerTextDocumentContentProvider(scheme, provider);
623
			},
624
			registerTaskProvider: (type: string, provider: vscode.TaskProvider) => {
625
				return extHostTask.registerTaskProvider(extension, provider);
J
Johannes Rieken 已提交
626
			},
627
			registerFileSystemProvider(scheme, provider, options) {
628
				return extHostFileSystem.registerFileSystemProvider(scheme, provider, options);
629
			},
630 631
			registerFileSearchProvider: proposedApiFunction(extension, (scheme, provider) => {
				return extHostSearch.registerFileSearchProvider(scheme, provider);
M
Matt Bierner 已提交
632
			}),
633 634 635 636
			registerSearchProvider: proposedApiFunction(extension, () => {
				// Temp for live share in Insiders
				return { dispose: () => { } };
			}),
637 638 639
			registerTextSearchProvider: proposedApiFunction(extension, (scheme, provider) => {
				return extHostSearch.registerTextSearchProvider(scheme, provider);
			}),
640 641
			registerFileIndexProvider: proposedApiFunction(extension, (scheme, provider) => {
				return extHostSearch.registerFileIndexProvider(scheme, provider);
M
Matt Bierner 已提交
642
			}),
643
			registerDocumentCommentProvider: proposedApiFunction(extension, (provider: vscode.DocumentCommentProvider) => {
644
				return exthostCommentProviders.registerDocumentCommentProvider(extension.identifier, provider);
645 646
			}),
			registerWorkspaceCommentProvider: proposedApiFunction(extension, (provider: vscode.WorkspaceCommentProvider) => {
647
				return exthostCommentProviders.registerWorkspaceCommentProvider(extension.identifier, provider);
648
			}),
A
Alex Dima 已提交
649 650 651
			registerRemoteAuthorityResolver: proposedApiFunction(extension, (authorityPrefix: string, resolver: vscode.RemoteAuthorityResolver) => {
				return extensionService.registerRemoteAuthorityResolver(authorityPrefix, resolver);
			}),
652 653
			onDidRenameFile: proposedApiFunction(extension, (listener, thisArg?, disposables?) => {
				return extHostFileSystemEvent.onDidRenameFile(listener, thisArg, disposables);
654 655
			}),
			onWillRenameFile: proposedApiFunction(extension, (listener, thisArg?, disposables?) => {
656
				return extHostFileSystemEvent.getOnWillRenameFileEvent(extension)(listener, thisArg, disposables);
J
Johannes Rieken 已提交
657
			})
658
		};
659

660 661
		// namespace: scm
		const scm: typeof vscode.scm = {
662
			get inputBox() {
J
Joao Moreno 已提交
663
				return extHostSCM.getLastInputBox(extension);
664
			},
J
Joao Moreno 已提交
665 666
			createSourceControl(id: string, label: string, rootUri?: vscode.Uri) {
				return extHostSCM.createSourceControl(extension, id, label, rootUri);
J
Joao Moreno 已提交
667
			}
668
		};
J
Joao Moreno 已提交
669

670 671
		// namespace: debug
		const debug: typeof vscode.debug = {
672 673 674
			get activeDebugSession() {
				return extHostDebugService.activeDebugSession;
			},
675 676
			get activeDebugConsole() {
				return extHostDebugService.activeDebugConsole;
677
			},
678 679
			get breakpoints() {
				return extHostDebugService.breakpoints;
680
			},
681 682 683
			onDidStartDebugSession(listener, thisArg?, disposables?) {
				return extHostDebugService.onDidStartDebugSession(listener, thisArg, disposables);
			},
684
			onDidTerminateDebugSession(listener, thisArg?, disposables?) {
685
				return extHostDebugService.onDidTerminateDebugSession(listener, thisArg, disposables);
686
			},
A
Andre Weinand 已提交
687
			onDidChangeActiveDebugSession(listener, thisArg?, disposables?) {
688
				return extHostDebugService.onDidChangeActiveDebugSession(listener, thisArg, disposables);
A
Andre Weinand 已提交
689 690
			},
			onDidReceiveDebugSessionCustomEvent(listener, thisArg?, disposables?) {
A
Andre Weinand 已提交
691
				return extHostDebugService.onDidReceiveDebugSessionCustomEvent(listener, thisArg, disposables);
692
			},
693
			onDidChangeBreakpoints(listener, thisArgs?, disposables?) {
694 695
				return extHostDebugService.onDidChangeBreakpoints(listener, thisArgs, disposables);
			},
A
Andre Weinand 已提交
696
			registerDebugConfigurationProvider(debugType: string, provider: vscode.DebugConfigurationProvider) {
697
				return extHostDebugService.registerDebugConfigurationProvider(debugType, provider);
698
			},
A
Andre Weinand 已提交
699 700
			registerDebugAdapterDescriptorFactory(debugType: string, factory: vscode.DebugAdapterDescriptorFactory) {
				return extHostDebugService.registerDebugAdapterDescriptorFactory(extension, debugType, factory);
701
			},
A
Andre Weinand 已提交
702 703
			registerDebugAdapterTrackerFactory(debugType: string, factory: vscode.DebugAdapterTrackerFactory) {
				return extHostDebugService.registerDebugAdapterTrackerFactory(debugType, factory);
704
			},
705 706 707 708
			startDebugging(folder: vscode.WorkspaceFolder | undefined, nameOrConfig: string | vscode.DebugConfiguration) {
				return extHostDebugService.startDebugging(folder, nameOrConfig);
			},
			addBreakpoints(breakpoints: vscode.Breakpoint[]) {
709
				return extHostDebugService.addBreakpoints(breakpoints);
710 711
			},
			removeBreakpoints(breakpoints: vscode.Breakpoint[]) {
712
				return extHostDebugService.removeBreakpoints(breakpoints);
713
			}
714 715
		};

D
Dirk Baeumer 已提交
716 717 718 719
		const tasks: typeof vscode.tasks = {
			registerTaskProvider: (type: string, provider: vscode.TaskProvider) => {
				return extHostTask.registerTaskProvider(extension, provider);
			},
720
			fetchTasks: (filter?: vscode.TaskFilter): Thenable<vscode.Task[]> => {
D
Dirk Baeumer 已提交
721
				return extHostTask.fetchTasks(filter);
722 723
			},
			executeTask: (task: vscode.Task): Thenable<vscode.TaskExecution> => {
D
Dirk Baeumer 已提交
724
				return extHostTask.executeTask(extension, task);
725
			},
D
Dirk Baeumer 已提交
726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741
			get taskExecutions(): vscode.TaskExecution[] {
				return extHostTask.taskExecutions;
			},
			onDidStartTask: (listeners, thisArgs?, disposables?) => {
				return extHostTask.onDidStartTask(listeners, thisArgs, disposables);
			},
			onDidEndTask: (listeners, thisArgs?, disposables?) => {
				return extHostTask.onDidEndTask(listeners, thisArgs, disposables);
			},
			onDidStartTaskProcess: (listeners, thisArgs?, disposables?) => {
				return extHostTask.onDidStartTaskProcess(listeners, thisArgs, disposables);
			},
			onDidEndTaskProcess: (listeners, thisArgs?, disposables?) => {
				return extHostTask.onDidEndTaskProcess(listeners, thisArgs, disposables);
			}
		};
742

743
		return <typeof vscode>{
744 745 746
			version: pkg.version,
			// namespaces
			commands,
747
			debug,
748 749 750
			env,
			extensions,
			languages,
J
Joao Moreno 已提交
751
			scm,
D
Dirk Baeumer 已提交
752
			tasks,
753 754
			window,
			workspace,
755
			// types
756
			Breakpoint: extHostTypes.Breakpoint,
757
			CancellationTokenSource: CancellationTokenSource,
758
			CodeAction: extHostTypes.CodeAction,
M
Matt Bierner 已提交
759
			CodeActionKind: extHostTypes.CodeActionKind,
760
			CodeActionTrigger: extHostTypes.CodeActionTrigger,
761
			CodeLens: extHostTypes.CodeLens,
R
Rob DeLine 已提交
762
			CodeInset: extHostTypes.CodeInset,
763
			Color: extHostTypes.Color,
764
			ColorInformation: extHostTypes.ColorInformation,
765 766
			ColorPresentation: extHostTypes.ColorPresentation,
			CommentThreadCollapsibleState: extHostTypes.CommentThreadCollapsibleState,
767 768 769
			CompletionItem: extHostTypes.CompletionItem,
			CompletionItemKind: extHostTypes.CompletionItemKind,
			CompletionList: extHostTypes.CompletionList,
M
Matt Bierner 已提交
770
			CompletionTriggerKind: extHostTypes.CompletionTriggerKind,
771
			ConfigurationTarget: extHostTypes.ConfigurationTarget,
772
			DebugAdapterExecutable: extHostTypes.DebugAdapterExecutable,
773
			DebugAdapterServer: extHostTypes.DebugAdapterServer,
774
			DecorationRangeBehavior: extHostTypes.DecorationRangeBehavior,
775
			Diagnostic: extHostTypes.Diagnostic,
776
			DiagnosticRelatedInformation: extHostTypes.DiagnosticRelatedInformation,
777
			DiagnosticSeverity: extHostTypes.DiagnosticSeverity,
778
			DiagnosticTag: extHostTypes.DiagnosticTag,
779 780 781
			Disposable: extHostTypes.Disposable,
			DocumentHighlight: extHostTypes.DocumentHighlight,
			DocumentHighlightKind: extHostTypes.DocumentHighlightKind,
782
			DocumentLink: extHostTypes.DocumentLink,
783 784
			DocumentSymbol: extHostTypes.DocumentSymbol,
			EndOfLine: extHostTypes.EndOfLine,
785
			EventEmitter: Emitter,
786 787 788 789 790
			FileChangeType: extHostTypes.FileChangeType,
			FileSystemError: extHostTypes.FileSystemError,
			FileType: files.FileType,
			FoldingRange: extHostTypes.FoldingRange,
			FoldingRangeKind: extHostTypes.FoldingRangeKind,
791
			FunctionBreakpoint: extHostTypes.FunctionBreakpoint,
792
			Hover: extHostTypes.Hover,
793
			IndentAction: languageConfiguration.IndentAction,
794
			Location: extHostTypes.Location,
795
			LogLevel: extHostTypes.LogLevel,
796
			MarkdownString: extHostTypes.MarkdownString,
797
			OverviewRulerLane: OverviewRulerLane,
798 799
			ParameterInformation: extHostTypes.ParameterInformation,
			Position: extHostTypes.Position,
800 801
			ProcessExecution: extHostTypes.ProcessExecution,
			ProgressLocation: extHostTypes.ProgressLocation,
802
			QuickInputButtons: extHostTypes.QuickInputButtons,
803
			Range: extHostTypes.Range,
804
			RelativePattern: extHostTypes.RelativePattern,
A
Alex Dima 已提交
805
			ResolvedAuthority: extHostTypes.ResolvedAuthority,
806
			Selection: extHostTypes.Selection,
807 808
			SelectionRange: extHostTypes.SelectionRange,
			SelectionRangeKind: extHostTypes.SelectionRangeKind,
809 810
			ShellExecution: extHostTypes.ShellExecution,
			ShellQuoting: extHostTypes.ShellQuoting,
M
Matt Bierner 已提交
811
			SignatureHelpTriggerKind: extHostTypes.SignatureHelpTriggerKind,
812 813 814
			SignatureHelp: extHostTypes.SignatureHelp,
			SignatureInformation: extHostTypes.SignatureInformation,
			SnippetString: extHostTypes.SnippetString,
815
			SourceBreakpoint: extHostTypes.SourceBreakpoint,
816
			SourceControlInputBoxValidationType: extHostTypes.SourceControlInputBoxValidationType,
817 818 819
			StatusBarAlignment: extHostTypes.StatusBarAlignment,
			SymbolInformation: extHostTypes.SymbolInformation,
			SymbolKind: extHostTypes.SymbolKind,
820
			Task: extHostTypes.Task,
A
Alex Ross 已提交
821
			Task2: extHostTypes.Task,
822 823 824 825
			TaskGroup: extHostTypes.TaskGroup,
			TaskPanelKind: extHostTypes.TaskPanelKind,
			TaskRevealKind: extHostTypes.TaskRevealKind,
			TaskScope: extHostTypes.TaskScope,
826 827
			TextDocumentSaveReason: extHostTypes.TextDocumentSaveReason,
			TextEdit: extHostTypes.TextEdit,
828
			TextEditorCursorStyle: TextEditorCursorStyle,
829
			TextEditorLineNumbersStyle: extHostTypes.TextEditorLineNumbersStyle,
830
			TextEditorRevealType: extHostTypes.TextEditorRevealType,
831
			TextEditorSelectionChangeKind: extHostTypes.TextEditorSelectionChangeKind,
832 833 834
			ThemeColor: extHostTypes.ThemeColor,
			ThemeIcon: extHostTypes.ThemeIcon,
			TreeItem: extHostTypes.TreeItem,
835
			TreeItem2: extHostTypes.TreeItem,
836
			TreeItemCollapsibleState: extHostTypes.TreeItemCollapsibleState,
837
			Uri: URI,
838 839
			ViewColumn: extHostTypes.ViewColumn,
			WorkspaceEdit: extHostTypes.WorkspaceEdit,
J
Joao Moreno 已提交
840
			// functions
841
		};
842
	};
E
Erich Gamma 已提交
843 844 845 846
}

class Extension<T> implements vscode.Extension<T> {

A
Alex Dima 已提交
847
	private _extensionService: ExtHostExtensionService;
848
	private _identifier: ExtensionIdentifier;
E
Erich Gamma 已提交
849 850 851

	public id: string;
	public extensionPath: string;
852
	public packageJSON: IExtensionDescription;
E
Erich Gamma 已提交
853

J
Johannes Rieken 已提交
854
	constructor(extensionService: ExtHostExtensionService, description: IExtensionDescription) {
A
Alex Dima 已提交
855
		this._extensionService = extensionService;
856 857
		this._identifier = description.identifier;
		this.id = description.identifier.value;
858
		this.extensionPath = path.normalize(originalFSPath(description.extensionLocation));
E
Erich Gamma 已提交
859 860 861 862
		this.packageJSON = description;
	}

	get isActive(): boolean {
863
		return this._extensionService.isActivated(this._identifier);
E
Erich Gamma 已提交
864 865 866
	}

	get exports(): T {
867 868 869
		if (this.packageJSON.api === 'none') {
			return undefined;
		}
870
		return <T>this._extensionService.getExtensionExports(this._identifier);
E
Erich Gamma 已提交
871 872 873
	}

	activate(): Thenable<T> {
874
		return this._extensionService.activateByIdWithErrors(this._identifier, new ExtensionActivatedByAPI(false)).then(() => this.exports);
E
Erich Gamma 已提交
875 876 877
	}
}

878 879
export function initializeExtensionApi(extensionService: ExtHostExtensionService, apiFactory: IExtensionApiFactory, extensionRegistry: ExtensionDescriptionRegistry, workspaceProvider: ExtHostWorkspaceProvider, configProvider: ExtHostConfigProvider): Promise<void> {
	return extensionService.getExtensionPathIndex().then(trie => defineAPI(apiFactory, trie, extensionRegistry, workspaceProvider, configProvider));
J
Johannes Rieken 已提交
880 881
}

882
function defineAPI(factory: IExtensionApiFactory, extensionPaths: TernarySearchTree<IExtensionDescription>, extensionRegistry: ExtensionDescriptionRegistry, workspaceProvider: ExtHostWorkspaceProvider, configProvider: ExtHostConfigProvider): void {
J
Johannes Rieken 已提交
883 884

	// each extension is meant to get its own api implementation
J
Johannes Rieken 已提交
885
	const extApiImpl = new Map<string, typeof vscode>();
J
Johannes Rieken 已提交
886
	let defaultApiImpl: typeof vscode;
887 888 889

	const node_module = <any>require.__$__nodeRequire('module');
	const original = node_module._load;
A
Alex Dima 已提交
890
	node_module._load = function load(request: string, parent: any, isMain: any) {
891 892 893 894 895
		if (request !== 'vscode') {
			return original.apply(this, arguments);
		}

		// get extension id from filename and api for extension
896
		const ext = extensionPaths.findSubstr(URI.file(parent.filename).fsPath);
897
		if (ext) {
898
			let apiImpl = extApiImpl.get(ExtensionIdentifier.toKey(ext.identifier));
899
			if (!apiImpl) {
900
				apiImpl = factory(ext, extensionRegistry, workspaceProvider, configProvider);
901
				extApiImpl.set(ExtensionIdentifier.toKey(ext.identifier), apiImpl);
902 903 904 905 906 907
			}
			return apiImpl;
		}

		// fall back to a default implementation
		if (!defaultApiImpl) {
908
			let extensionPathsPretty = '';
909
			extensionPaths.forEach((value, index) => extensionPathsPretty += `\t${index} -> ${value.identifier.value}\n`);
910
			console.warn(`Could not identify extension for 'vscode' require call from ${parent.filename}. These are the extension path mappings: \n${extensionPathsPretty}`);
911
			defaultApiImpl = factory(nullExtensionDescription, extensionRegistry, workspaceProvider, configProvider);
E
Erich Gamma 已提交
912
		}
913
		return defaultApiImpl;
E
Erich Gamma 已提交
914 915
	};
}