@codingame/monaco-vscode-api 7.1.0 → 7.1.1

package/vscode-dts/vscode.proposed.chatParticipantAdditions.d.ts

@@ -59,10 +59,18 @@ declare module 'vscode' {
 		title: string;
 		message: string;
 		data: any;
-		constructor(title: string, message: string, data: any);
+		buttons?: string[];
+		constructor(title: string, message: string, data: any, buttons?: string[]);
 	}
 
-	export type ExtendedChatResponsePart = ChatResponsePart | ChatResponseTextEditPart | ChatResponseDetectedParticipantPart | ChatResponseConfirmationPart;
+	export class ChatResponseCodeCitationPart {
+		value: Uri;
+		license: string;
+		snippet: string;
+		constructor(value: Uri, license: string, snippet: string);
+	}
+
+	export type ExtendedChatResponsePart = ChatResponsePart | ChatResponseTextEditPart | ChatResponseDetectedParticipantPart | ChatResponseConfirmationPart | ChatResponseCodeCitationPart | ChatResponseReferencePart2;
 
 	export class ChatResponseWarningPart {
 		value: MarkdownString;
@@ -75,6 +83,44 @@ declare module 'vscode' {
 		constructor(value: string, task?: (progress: Progress<ChatResponseWarningPart | ChatResponseReferencePart>) => Thenable<string | void>);
 	}
 
+	export class ChatResponseReferencePart2 {
+		/**
+		 * The reference target.
+		 */
+		value: Uri | Location | { variableName: string; value?: Uri | Location };
+
+		/**
+		 * The icon for the reference.
+		 */
+		iconPath?: Uri | ThemeIcon | {
+			/**
+			 * The icon path for the light theme.
+			 */
+			light: Uri;
+			/**
+			 * The icon path for the dark theme.
+			 */
+			dark: Uri;
+		};
+		options?: { status?: { description: string; kind: ChatResponseReferencePartStatusKind } };
+
+		/**
+		 * Create a new ChatResponseReferencePart.
+		 * @param value A uri or location
+		 * @param iconPath Icon for the reference shown in UI
+		 */
+		constructor(value: Uri | Location | { variableName: string; value?: Uri | Location }, iconPath?: Uri | ThemeIcon | {
+			/**
+			 * The icon path for the light theme.
+			 */
+			light: Uri;
+			/**
+			 * The icon path for the dark theme.
+			 */
+			dark: Uri;
+		}, options?: { status?: { description: string; kind: ChatResponseReferencePartStatusKind } });
+	}
+
 	export interface ChatResponseStream {
 
 		/**
@@ -102,7 +148,7 @@ declare module 'vscode' {
 		 * TODO@API should this be MarkdownString?
 		 * TODO@API should actually be a more generic function that takes an array of buttons
 		 */
-		confirmation(title: string, message: string, data: any): void;
+		confirmation(title: string, message: string, data: any, buttons?: string[]): void;
 
 		/**
 		 * Push a warning to this stream. Short-hand for
@@ -115,9 +161,19 @@ declare module 'vscode' {
 
 		reference(value: Uri | Location | { variableName: string; value?: Uri | Location }, iconPath?: Uri | ThemeIcon | { light: Uri; dark: Uri }): void;
 
+		reference2(value: Uri | Location | { variableName: string; value?: Uri | Location }, iconPath?: Uri | ThemeIcon | { light: Uri; dark: Uri }, options?: { status?: { description: string; kind: ChatResponseReferencePartStatusKind } }): void;
+
+		codeCitation(value: Uri, license: string, snippet: string): void;
+
 		push(part: ExtendedChatResponsePart): void;
 	}
 
+	export enum ChatResponseReferencePartStatusKind {
+		Complete = 1,
+		Partial = 2,
+		Omitted = 3
+	}
+
 	/**
 	 * Does this piggy-back on the existing ChatRequest, or is it a different type of request entirely?
 	 * Does it show up in history?
@@ -132,6 +188,8 @@ declare module 'vscode' {
 		 * The `data` for any confirmations that were rejected
 		 */
 		rejectedConfirmationData?: any[];
+
+		requestedTools?: string[];
 	}
 
 	// TODO@API fit this into the stream

package/vscode-dts/vscode.proposed.chatParticipantPrivate.d.ts

@@ -3,6 +3,8 @@
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
 
+// version: 2
+
 declare module 'vscode' {
 
 	/**
@@ -27,6 +29,22 @@ declare module 'vscode' {
 		Editor = 4
 	}
 
+	export class ChatRequestEditorData {
+		//TODO@API should be the editor
+		document: TextDocument;
+		selection: Selection;
+		wholeRange: Range;
+
+		constructor(document: TextDocument, selection: Selection, wholeRange: Range);
+	}
+
+	export class ChatRequestNotebookData {
+		//TODO@API should be the editor
+		readonly cell: TextDocument;
+
+		constructor(cell: TextDocument);
+	}
+
 	export interface ChatRequest {
 		/**
 		 * The attempt number of the request. The first request has attempt number 0.
@@ -40,8 +58,16 @@ declare module 'vscode' {
 
 		/**
 		 * The location at which the chat is happening. This will always be one of the supported values
+		 *
+		 * @deprecated
 		 */
 		readonly location: ChatLocation;
+
+		/**
+		 * Information that is specific to the location at which chat is happening, e.g within a document, notebook,
+		 * or terminal. Will be `undefined` for the chat panel.
+		 */
+		readonly location2: ChatRequestEditorData | ChatRequestNotebookData | undefined;
 	}
 
 	export interface ChatParticipant {

package/vscode-dts/vscode.proposed.commentReveal.d.ts

@@ -7,26 +7,39 @@ declare module 'vscode' {
 
 	// @alexr00 https://github.com/microsoft/vscode/issues/167253
 
+	export enum CommentThreadFocus {
+		/**
+		 * Focus the comment editor if the thread supports replying.
+		 */
+		Reply = 1,
+		/**
+		 * Focus the revealed comment.
+		 */
+		Comment = 2
+	}
+
 	/**
 	 * Options to reveal a comment thread in an editor.
 	 */
 	export interface CommentThreadRevealOptions {
+
 		/**
-		 * By default, the comment thread will be focused. Set `preserveFocus` to `true` to maintain the original focus.
+		 * Where to move the focus to when revealing the comment thread.
+		 * If undefined, the focus will not be changed.
 		 */
-		preserveFocus?: boolean;
+		focus?: CommentThreadFocus;
+	}
 
+	export interface CommentThread2 {
 		/**
-		 * Focus the comment thread reply editor, if the thread supports replying.
+		 * Reveal the comment thread in an editor. If no comment is provided, the first comment in the thread will be revealed.
 		 */
-		focusReply?: boolean;
-	}
+		reveal(comment?: Comment, options?: CommentThreadRevealOptions): Thenable<void>;
 
-	export interface CommentThread {
 		/**
-		 * Reveal the comment thread in an editor.
+		 * Collapse the comment thread in an editor.
 		 */
-		reveal(options?: CommentThreadRevealOptions): Thenable<void>;
+		hide(): Thenable<void>;
 	}
 
 }

package/vscode-dts/vscode.proposed.commentThreadApplicability.d.ts

@@ -36,7 +36,5 @@ declare module 'vscode' {
 		contextValue?: string;
 		label?: string;
 		dispose(): void;
-		// Part of the comment reveal proposal
-		reveal(options?: CommentThreadRevealOptions): Thenable<void>;
 	}
 }

package/vscode-dts/vscode.proposed.contribSourceControlHistoryItemChangesMenu.d.ts

@@ -0,0 +1,7 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for the `scm/historyItemChanges/title`-menu contribution point
+// https://github.com/microsoft/vscode/issues/201997

package/vscode-dts/vscode.proposed.fileComments.d.ts

@@ -26,7 +26,7 @@ declare module 'vscode' {
 		/**
 		 * The ranges which allow new comment threads creation.
 		 */
-		ranges?: Range[]
+		ranges?: Range[];
 	}
 
 	export interface CommentController {

package/vscode-dts/vscode.proposed.fileSearchProviderNew.d.ts

@@ -0,0 +1,100 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/73524
+
+	/**
+	 * Options that apply to file search.
+	 */
+	export interface FileSearchProviderOptionsNew {
+		folderOptions: {
+			/**
+			 * The root folder to search within.
+			 */
+			folder: Uri;
+
+			/**
+			 * Files that match an `includes` glob pattern should be included in the search.
+			 */
+			includes: string[];
+
+			/**
+			 * Files that match an `excludes` glob pattern should be excluded from the search.
+			 */
+			excludes: GlobPattern[];
+
+			/**
+			 * Whether symlinks should be followed while searching.
+			 * For more info, see the setting description for `search.followSymlinks`.
+			 */
+			followSymlinks: boolean;
+
+			/**
+			 * Which file locations we should look for ignore (.gitignore or .ignore) files to respect.
+			 */
+			useIgnoreFiles: {
+				/**
+				 * Use ignore files at the current workspace root.
+				 */
+				local: boolean;
+				/**
+				 * Use ignore files at the parent directory. If set, {@link FileSearchProviderOptionsNew.useIgnoreFiles.local} should also be `true`.
+				 */
+				parent: boolean;
+				/**
+				 * Use global ignore files. If set, {@link FileSearchProviderOptionsNew.useIgnoreFiles.local} should also be `true`.
+				 */
+				global: boolean;
+			};
+		}[];
+
+		/**
+		 * An object with a lifespan that matches the session's lifespan. If the provider chooses to, this object can be used as the key for a cache,
+		 * and searches with the same session object can search the same cache. When the token is cancelled, the session is complete and the cache can be cleared.
+		 */
+		session: unknown;
+
+		/**
+		 * The maximum number of results to be returned.
+		 */
+		maxResults: number;
+	}
+
+	/**
+	 * A FileSearchProvider provides search results for files in the given folder that match a query string. It can be invoked by quickopen or other extensions.
+	 *
+	 * A FileSearchProvider is the more powerful of two ways to implement file search in the editor. Use a FileSearchProvider if you wish to search within a folder for
+	 * all files that match the user's query.
+	 *
+	 * The FileSearchProvider will be invoked on every keypress in quickopen.
+	 */
+	export interface FileSearchProviderNew {
+		/**
+		 * WARNING: VERY EXPERIMENTAL.
+		 *
+		 * Provide the set of files that match a certain file path pattern.
+		 * @param pattern The search pattern to match against file paths.
+		 * @param options A set of options to consider while searching files.
+		 * @param token A cancellation token.
+		 */
+		provideFileSearchResults(pattern: string, options: FileSearchProviderOptionsNew, token: CancellationToken): ProviderResult<Uri[]>;
+	}
+
+	export namespace workspace {
+		/**
+		 *
+		 * Register a search provider.
+		 *
+		 * Only one provider can be registered per scheme.
+		 *
+		 * @param scheme The provider will be invoked for workspace folders that have this file scheme.
+		 * @param provider The provider.
+		 * @return A {@link Disposable} that unregisters this provider when being disposed.
+		 */
+		export function registerFileSearchProviderNew(scheme: string, provider: FileSearchProviderNew): Disposable;
+	}
+}

package/vscode-dts/vscode.proposed.findFiles2New.d.ts

@@ -0,0 +1,80 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	export interface FindFiles2OptionsNew {
+		/**
+		 * A {@link GlobPattern glob pattern} that defines files and folders to exclude. The glob pattern
+		 * will be matched against the file paths of resulting matches relative to their workspace.
+		 */
+		exclude?: GlobPattern[];
+
+		/**
+		 * Which settings to follow when searching for files. Defaults to {@link ExcludeSettingOptions.searchAndFilesExclude}.
+		 */
+		useExcludeSettings?: ExcludeSettingOptions;
+
+		/**
+		 * The maximum number of results to search for
+		 */
+		maxResults?: number;
+
+		/**
+		 * Which file locations we should look for ignore (.gitignore or .ignore) files to respect.
+		 *
+		 * When any of these fields are `undefined`, we will:
+		 * - assume the value if possible (e.g. if only one is valid)
+		 * or
+		 * - follow settings using the value for the corresponding `search.use*IgnoreFiles` settting.
+		 *
+		 * Will log an error if an invalid combination is set.
+		 */
+		useIgnoreFiles?: {
+			/**
+			 * Use ignore files at the current workspace root.
+			 * May default to `search.useIgnoreFiles` setting if not set.
+			 */
+			local?: boolean;
+			/**
+			 * Use ignore files at the parent directory. When set to `true`, {@link FindFiles2OptionsNew.useIgnoreFiles.local} must also be `true`.
+			 * May default to `search.useParentIgnoreFiles` setting if not set.
+			 */
+			parent?: boolean;
+			/**
+			 * Use global ignore files. When set to `true`, {@link FindFiles2OptionsNew.useIgnoreFiles.local} must also be `true`.
+			 * May default to `search.useGlobalIgnoreFiles` setting if not set.
+			 */
+			global?: boolean;
+		};
+
+		/**
+		 * Whether symlinks should be followed while searching.
+		 * Defaults to the value for `search.followSymlinks` in settings.
+		 * For more info, see the setting description for `search.followSymlinks`.
+		 */
+		followSymlinks?: boolean;
+	}
+
+	export namespace workspace {
+		/**
+		 * WARNING: VERY EXPERIMENTAL.
+		 *
+		 * Find files across all {@link workspace.workspaceFolders workspace folders} in the workspace.
+		 *
+		 * @example
+		 * findFiles(['**​/*.js'], {exclude: ['**​/out/**'], useIgnoreFiles: true, maxResults: 10})
+		 *
+		 * @param filePattern A {@link GlobPattern glob pattern} that defines the files to search for. The glob pattern
+		 * will be matched against the file paths of resulting matches relative to their workspace. Use a {@link RelativePattern relative pattern}
+		 * to restrict the search results to a {@link WorkspaceFolder workspace folder}.
+		 * @param options A set of {@link FindFiles2Options FindFiles2Options} that defines where and how to search (e.g. exclude settings).
+		 * @param token A token that can be used to signal cancellation to the underlying search engine.
+		 * @returns A thenable that resolves to an array of resource identifiers. Will return no results if no
+		 * {@link workspace.workspaceFolders workspace folders} are opened.
+		 */
+		export function findFiles2New(filePattern: GlobPattern[], options?: FindFiles2OptionsNew, token?: CancellationToken): Thenable<Uri[]>;
+	}
+}

package/vscode-dts/vscode.proposed.findTextInFilesNew.d.ts

@@ -0,0 +1,143 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/59924
+
+	export interface FindTextInFilesOptionsNew {
+		/**
+		 * A {@link GlobPattern glob pattern} that defines the files to search for. The glob pattern
+		 * will be matched against the file paths of files relative to their workspace. Use a {@link RelativePattern relative pattern}
+		 * to restrict the search results to a {@link WorkspaceFolder workspace folder}.
+		 */
+		include?: GlobPattern[];
+
+		/**
+		 * A {@link GlobPattern glob pattern} that defines files and folders to exclude. The glob pattern
+		 * will be matched against the file paths of resulting matches relative to their workspace.
+		 */
+		exclude?: GlobPattern[];
+
+		/**
+		 * Which settings to follow when searching for files. Defaults to {@link ExcludeSettingOptions.searchAndFilesExclude}.
+		 */
+		useExcludeSettings?: ExcludeSettingOptions;
+
+		/**
+		 * The maximum number of results to search for
+		 */
+		maxResults?: number;
+
+
+		/**
+		 * Which file locations we should look for ignore (.gitignore or .ignore) files to respect.
+		 *
+		 * When any of these fields are `undefined`, we will:
+		 * - assume the value if possible (e.g. if only one is valid)
+		 * or
+		 * - follow settings using the value for the corresponding `search.use*IgnoreFiles` settting.
+		 *
+		 * Will log an error if an invalid combination is set.
+		 */
+		useIgnoreFiles?: {
+			/**
+			 * Use ignore files at the current workspace root.
+			 * May default to `search.useIgnoreFiles` setting if not set.
+			 */
+			local?: boolean;
+			/**
+			 * Use ignore files at the parent directory. When set to `true`, {@link FindTextInFilesOptionsNew.useIgnoreFiles.local} must be `true`.
+			 * May default to `search.useParentIgnoreFiles` setting if not set.
+			 */
+			parent?: boolean;
+			/**
+			 * Use global ignore files. When set to `true`, {@link FindTextInFilesOptionsNew.useIgnoreFiles.local} must also be `true`.
+			 * May default to `search.useGlobalIgnoreFiles` setting if not set.
+			 */
+			global?: boolean;
+		};
+
+		/**
+		 * Whether symlinks should be followed while searching.
+		 * Defaults to the value for `search.followSymlinks` in settings.
+		 * For more info, see the setting description for `search.followSymlinks`.
+		 */
+		followSymlinks?: boolean;
+
+		/**
+		 * Interpret files using this encoding.
+		 * See the vscode setting `"files.encoding"`
+		 */
+		encoding?: string;
+
+		/**
+		 * Options to specify the size of the result text preview.
+		 */
+		previewOptions?: {
+			/**
+			 * The maximum number of lines in the preview.
+			 * Only search providers that support multiline search will ever return more than one line in the match.
+			 */
+			matchLines?: number;
+
+			/**
+			 * The maximum number of characters included per line.
+			 */
+			charsPerLine?: number;
+		};
+
+		/**
+		 * Number of lines of context to include before and after each match.
+		 */
+		surroundingContext?: number;
+	}
+
+	export interface FindTextInFilesResponse {
+		/**
+		 * The results of the text search, in batches. To get completion information, wait on the `complete` property.
+		 */
+		results: AsyncIterable<TextSearchResultNew>;
+		/**
+		 * The text search completion information. This resolves on completion.
+		 */
+		complete: Thenable<TextSearchCompleteNew>;
+	}
+
+	/*
+	* Options for following search.exclude and files.exclude settings.
+	*/
+	export enum ExcludeSettingOptions {
+		/*
+		 * Don't use any exclude settings.
+		 */
+		none = 1,
+		/*
+		 * Use:
+		 * - files.exclude setting
+		 */
+		filesExclude = 2,
+		/*
+		 * Use:
+		 * - files.exclude setting
+		 * - search.exclude setting
+		 */
+		searchAndFilesExclude = 3
+	}
+
+	export namespace workspace {
+		/**
+		 * WARNING: VERY EXPERIMENTAL.
+		 *
+		 * Search text in files across all {@link workspace.workspaceFolders workspace folders} in the workspace.
+		 * @param query The query parameters for the search - the search string, whether it's case-sensitive, or a regex, or matches whole words.
+		 * @param options An optional set of query options. Include and exclude patterns, maxResults, etc.
+		 * @param callback A callback, called for each result
+		 * @param token A token that can be used to signal cancellation to the underlying search engine.
+		 * @return A thenable that resolves when the search is complete.
+		 */
+		export function findTextInFilesNew(query: TextSearchQueryNew, options?: FindTextInFilesOptionsNew, token?: CancellationToken): FindTextInFilesResponse;
+	}
+}

package/vscode-dts/vscode.proposed.lmTools.d.ts

@@ -23,6 +23,11 @@ declare module 'vscode' {
 	export interface LanguageModelChatRequestOptions {
 		// TODO@API this will a heterogeneous array of different types of tools
 		tools?: LanguageModelChatFunction[];
+
+		/**
+		 * Force a specific tool to be used.
+		 */
+		toolChoice?: string;
 	}
 
 	// LM -> USER: function that should be used

package/vscode-dts/vscode.proposed.quickInputButtonLocation.d.ts

@@ -0,0 +1,29 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/175662
+
+	export enum QuickInputButtonLocation {
+		/**
+		 * In the title bar.
+		 */
+		Title = 1,
+
+		/**
+		 * To the right of the input box.
+		 */
+		Inline = 2
+	}
+
+	export interface QuickInputButton {
+		/**
+		 * Where the button should be rendered. The default is {@link QuickInputButtonLocation.Title}.
+		 * @note This property is ignored if the button was added to a QuickPickItem.
+		 */
+		location?: QuickInputButtonLocation;
+	}
+}

package/vscode-dts/vscode.proposed.scmHistoryProvider.d.ts

@@ -30,6 +30,7 @@ declare module 'vscode' {
 		provideHistoryItemChanges(historyItemId: string, historyItemParentId: string | undefined, token: CancellationToken): ProviderResult<SourceControlHistoryItemChange[]>;
 
 		resolveHistoryItemGroupCommonAncestor(historyItemGroupId1: string, historyItemGroupId2: string | undefined, token: CancellationToken): ProviderResult<{ id: string; ahead: number; behind: number }>;
+		resolveHistoryItemGroupCommonAncestor2(historyItemGroupIds: string[], token: CancellationToken): ProviderResult<string>;
 	}
 
 	export interface SourceControlHistoryOptions {
@@ -41,6 +42,7 @@ declare module 'vscode' {
 	export interface SourceControlHistoryItemGroup {
 		readonly id: string;
 		readonly name: string;
+		readonly revision?: string;
 		readonly base?: Omit<Omit<SourceControlHistoryItemGroup, 'base'>, 'remote'>;
 		readonly remote?: Omit<Omit<SourceControlHistoryItemGroup, 'base'>, 'remote'>;
 	}

package/vscode-dts/vscode.proposed.testMessageStackTrace.d.ts

@@ -0,0 +1,38 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+	export class TestMessage2 extends TestMessage {
+		/**
+		 * The stack trace associated with the message or failure.
+		 */
+		stackTrace?: TestMessageStackFrame[];
+	}
+
+	export class TestMessageStackFrame {
+		/**
+		 * The location of this stack frame. This should be provided as a URI if the
+		 * location of the call frame can be accessed by the editor.
+		 */
+		file?: Uri;
+
+		/**
+		 * Position of the stack frame within the file.
+		 */
+		position?: Position;
+
+		/**
+		 * The name of the stack frame, typically a method or function name.
+		 */
+		label: string;
+
+		/**
+		 * @param label The name of the stack frame
+		 * @param file The file URI of the stack frame
+		 * @param position The position of the stack frame within the file
+		 */
+		constructor(label: string, file?: Uri, position?: Position);
+	}
+}

package/vscode-dts/vscode.proposed.testRelatedCode.d.ts

@@ -0,0 +1,36 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+	export interface TestController {
+		/**
+		 * A provider used for associating code location with tests.
+		 */
+		relatedCodeProvider?: TestRelatedCodeProvider;
+	}
+
+	export interface TestRelatedCodeProvider {
+		/**
+		 * Returns the tests related to the given code location. This may be called
+		 * by the user either explicitly via a "go to test" action, or implicitly
+		 * when running tests at a cursor position.
+		 *
+		 * @param document The document in which the code location is located.
+		 * @param position The position in the document.
+		 * @param token A cancellation token.
+		 * @returns A list of tests related to the position in the code.
+		 */
+		provideRelatedTests?(document: TextDocument, position: Position, token: CancellationToken): ProviderResult<TestItem[]>;
+
+		/**
+		 * Returns the code related to the given test case.
+		 *
+		 * @param test The test for which to provide related code.
+		 * @param token A cancellation token.
+		 * @returns A list of locations related to the test.
+		 */
+		provideRelatedCode?(test: TestItem, token: CancellationToken): ProviderResult<Location[]>;
+	}
+}