@theia/plugin 1.40.1 → 1.42.0

package/src/theia.d.ts

@@ -30,6 +30,9 @@ import './theia.proposed.dropMetadata';
 import './theia.proposed.editSessionIdentityProvider';
 import './theia.proposed.extensionsAny';
 import './theia.proposed.externalUriOpener';
+import './theia.proposed.notebookCellExecutionState';
+import './theia.proposed.notebookKernelSource';
+import './theia.proposed.notebookMessaging';
 import './theia.proposed.findTextInFiles';
 import './theia.proposed.fsChunks';
 import './theia.proposed.profileContentHandlers';
@@ -2137,6 +2140,11 @@ export module '@theia/plugin' {
          */
         kind?: QuickPickItemKind;
 
+        /**
+         * The icon path or {@link ThemeIcon} for the QuickPickItem.
+         */
+        iconPath?: Uri | { light: Uri; dark: Uri } | ThemeIcon;
+
         /**
          * A human-readable string which is rendered less prominent in the same line. Supports rendering of
          * {@link ThemeIcon theme icons} via the `$(<name>)`-syntax.
@@ -3585,6 +3593,12 @@ export module '@theia/plugin' {
      * A collection of mutations that an extension can apply to a process environment.
      */
     export interface EnvironmentVariableCollection {
+
+        /**
+         * A description for the environment variable collection, this will be used to describe the changes in the UI.
+         */
+        description: string | MarkdownString | undefined;
+
         /**
          * Whether the collection should be cached for the workspace and applied to the terminal
          * across window reloads. When true the collection will be active immediately such when the
@@ -4941,14 +4955,12 @@ export module '@theia/plugin' {
 
         /**
          * The currently visible {@link NotebookEditor notebook editors} or an empty array.
-         * @stubbed
          */
         export const visibleNotebookEditors: readonly NotebookEditor[];
 
         /**
          * An {@link Event} which fires when the {@link window.visibleNotebookEditors visible notebook editors}
          * has changed.
-         * @stubbed
          */
         export const onDidChangeVisibleNotebookEditors: Event<readonly NotebookEditor[]>;
 
@@ -4956,7 +4968,6 @@ export module '@theia/plugin' {
          * The currently active {@link NotebookEditor notebook editor} or `undefined`. The active editor is the one
          * that currently has focus or, when none has focus, the one that has changed
          * input most recently.
-         * @stubbed
          */
         export const activeNotebookEditor: NotebookEditor | undefined;
 
@@ -4964,21 +4975,18 @@ export module '@theia/plugin' {
          * An {@link Event} which fires when the {@link window.activeNotebookEditor active notebook editor}
          * has changed. *Note* that the event also fires when the active editor changes
          * to `undefined`.
-         * @stubbed
          */
         export const onDidChangeActiveNotebookEditor: Event<NotebookEditor | undefined>;
 
         /**
          * An {@link Event} which fires when the {@link NotebookEditor.selections notebook editor selections}
          * have changed.
-         * @stubbed
          */
         export const onDidChangeNotebookEditorSelection: Event<NotebookEditorSelectionChangeEvent>;
 
         /**
          * An {@link Event} which fires when the {@link NotebookEditor.visibleRanges notebook editor visible ranges}
          * have changed.
-         * @stubbed
          */
         export const onDidChangeNotebookEditorVisibleRanges: Event<NotebookEditorVisibleRangesChangeEvent>;
 
@@ -4989,7 +4997,6 @@ export module '@theia/plugin' {
          * @param options {@link NotebookDocumentShowOptions Editor options} to configure the behavior of showing the {@link NotebookEditor notebook editor}.
          *
          * @return A promise that resolves to an {@link NotebookEditor notebook editor}.
-         * @stubbed
          */
         export function showNotebookDocument(document: NotebookDocument, options?: NotebookDocumentShowOptions): Thenable<NotebookEditor>;
 
@@ -5944,6 +5951,44 @@ export module '@theia/plugin' {
          * array containing all selected tree items.
          */
         canSelectMany?: boolean;
+
+        /**
+         * By default, when the children of a tree item have already been fetched, child checkboxes are automatically managed based on the checked state of the parent tree item.
+         * If the tree item is collapsed by default (meaning that the children haven't yet been fetched) then child checkboxes will not be updated.
+         * To override this behavior and manage child and parent checkbox state in the extension, set this to `true`.
+         *
+         * Examples where {@link TreeViewOptions.manageCheckboxStateManually} is false, the default behavior:
+         *
+         * 1. A tree item is checked, then its children are fetched. The children will be checked.
+         *
+         * 2. A tree item's parent is checked. The tree item and all of it's siblings will be checked.
+         *   - [ ] Parent
+         *     - [ ] Child 1
+         *     - [ ] Child 2
+         *   When the user checks Parent, the tree will look like this:
+         *   - [x] Parent
+         *     - [x] Child 1
+         *     - [x] Child 2
+         *
+         * 3. A tree item and all of it's siblings are checked. The parent will be checked.
+         *   - [ ] Parent
+         *     - [ ] Child 1
+         *     - [ ] Child 2
+         *   When the user checks Child 1 and Child 2, the tree will look like this:
+         *   - [x] Parent
+         *     - [x] Child 1
+         *     - [x] Child 2
+         *
+         * 4. A tree item is unchecked. The parent will be unchecked.
+         *   - [x] Parent
+         *     - [x] Child 1
+         *     - [x] Child 2
+         *   When the user unchecks Child 1, the tree will look like this:
+         *   - [ ] Parent
+         *     - [ ] Child 1
+         *     - [x] Child 2
+         */
+        manageCheckboxStateManually?: boolean;
     }
 
     /**
@@ -6157,6 +6202,16 @@ export module '@theia/plugin' {
         readonly value: number;
     }
 
+    /**
+     * An event describing the change in a tree item's checkbox state.
+     */
+    export interface TreeCheckboxChangeEvent<T> {
+        /**
+         * The items that were checked or unchecked.
+         */
+        readonly items: ReadonlyArray<[T, TreeItemCheckboxState]>;
+    }
+
     /**
      * Represents a Tree view
      */
@@ -6192,6 +6247,11 @@ export module '@theia/plugin' {
          */
         readonly onDidChangeVisibility: Event<TreeViewVisibilityChangeEvent>;
 
+        /**
+         * An event to signal that an element or root has either been checked or unchecked.
+         */
+        readonly onDidChangeCheckboxState: Event<TreeCheckboxChangeEvent<T>>;
+
         /**
          * An optional human-readable message that will be rendered in the view.
          * Setting the message to null, undefined, or empty string will remove the message from the view.
@@ -6364,6 +6424,12 @@ export module '@theia/plugin' {
          */
         accessibilityInformation?: AccessibilityInformation;
 
+        /**
+         * {@link TreeItemCheckboxState TreeItemCheckboxState} of the tree item.
+         * {@link TreeDataProvider.onDidChangeTreeData onDidChangeTreeData} should be fired when {@link TreeItem.checkboxState checkboxState} changes.
+         */
+        checkboxState?: TreeItemCheckboxState | { readonly state: TreeItemCheckboxState; readonly tooltip?: string; readonly accessibilityInformation?: AccessibilityInformation };
+
         /**
          * @param label A human-readable string describing this item
          * @param collapsibleState {@link TreeItemCollapsibleState TreeItemCollapsibleState} of the tree item. Default is [TreeItemCollapsibleState.None](#TreeItemCollapsibleState.None)
@@ -6412,6 +6478,20 @@ export module '@theia/plugin' {
         highlights?: [number, number][];
     }
 
+    /**
+     * Checkbox state of the tree item
+     */
+    export enum TreeItemCheckboxState {
+        /**
+         * Determines an item is unchecked
+         */
+        Unchecked = 0,
+        /**
+         * Determines an item is checked
+         */
+        Checked = 1
+    }
+
     /**
      * Represents the configuration. It is a merged view of
      *
@@ -7079,7 +7159,6 @@ export module '@theia/plugin' {
          * All notebook documents currently known to the editor.
          *
          * @readonly
-         * @stubbed
          */
         export let notebookDocuments: readonly NotebookDocument[];
 
@@ -7096,7 +7175,6 @@ export module '@theia/plugin' {
 
         /**
          * An event that is emitted when a {@link NotebookDocument notebook} is opened.
-         * @stubbed
          */
         export const onDidOpenNotebookDocument: Event<NotebookDocument>;
 
@@ -7106,13 +7184,11 @@ export module '@theia/plugin' {
          * Note 1: There is no guarantee that this event fires when an editor tab is closed.
          *
          * Note 2: A notebook can be open but not shown in an editor which means this event can fire for a notebook that has not been shown in an editor.
-         * @stubbed
          */
         export const onDidCloseNotebookDocument: Event<NotebookDocument>;
 
         /**
          * An event that is emitted when a {@link NotebookDocument notebook} is saved.
-         * @stubbed
          */
         export const onDidSaveNotebookDocument: Event<NotebookDocument>;
 
@@ -7124,7 +7200,6 @@ export module '@theia/plugin' {
          * @param serializer a notebook serializer.
          * @param options Optional context options that define what parts of a notebook should be persisted
          * @return A {@link Disposable disposable} that unregisters this serializer when being disposed.
-         * @stubbed
          */
         export function registerNotebookSerializer(notebookType: string, serializer: NotebookSerializer, options?: NotebookDocumentContentOptions): Disposable;
 
@@ -7178,7 +7253,6 @@ export module '@theia/plugin' {
 
         /**
          * An event that is emitted when a {@link Notebook notebook} has changed.
-         * @stubbed
          */
         export const onDidChangeNotebookDocument: Event<NotebookDocumentChangeEvent>;
 
@@ -7317,7 +7391,6 @@ export module '@theia/plugin' {
          *
          * @param uri The resource to open.
          * @return A promise that resolves to a {@link NotebookDocument notebook}.
-         * @stubbed
          */
         export function openNotebookDocument(uri: Uri): Thenable<NotebookDocument> | undefined;
 
@@ -7327,7 +7400,6 @@ export module '@theia/plugin' {
          * @param notebookType The notebook type that should be used.
          * @param content The initial contents of the notebook.
          * @return A promise that resolves to a {@link NotebookDocument notebook}.
-         * @stubbed
          */
         export function openNotebookDocument(notebookType: string, content?: NotebookData): Thenable<NotebookDocument> | undefined;
 
@@ -10051,6 +10123,30 @@ export module '@theia/plugin' {
          */
         set(uri: Uri, edits: ReadonlyArray<[TextEdit | SnippetTextEdit, WorkspaceEditEntryMetadata]>): void;
 
+        /**
+         * Set (and replace) text edits or snippet edits with metadata for a resource.
+         *
+         * @param uri A resource identifier.
+         * @param edits An array of edits.
+         */
+        set(uri: Uri, edits: ReadonlyArray<[TextEdit | SnippetTextEdit, WorkspaceEditEntryMetadata]>): void;
+
+        /**
+         * Set (and replace) notebook edits for a resource.
+         *
+         * @param uri A resource identifier.
+         * @param edits An array of edits.
+         */
+        set(uri: Uri, edits: readonly NotebookEdit[]): void;
+
+        /**
+         * Set (and replace) notebook edits with metadata for a resource.
+         *
+         * @param uri A resource identifier.
+         * @param edits An array of edits.
+         */
+        set(uri: Uri, edits: ReadonlyArray<[NotebookEdit, WorkspaceEditEntryMetadata]>): void;
+
         /**
          * Get the text edits for a resource.
          *
@@ -14438,13 +14534,11 @@ export module '@theia/plugin' {
 
         /**
          * The {@link NotebookDocument notebook document} associated with this notebook editor.
-         * @stubbed
          */
         readonly notebook: NotebookDocument;
 
         /**
          * The primary selection in this notebook editor.
-         * @stubbed
          */
         selection: NotebookRange;
 
@@ -14452,19 +14546,16 @@ export module '@theia/plugin' {
          * All selections in this notebook editor.
          *
          * The primary selection (or focused range) is `selections[0]`. When the document has no cells, the primary selection is empty `{ start: 0, end: 0 }`;
-         * @stubbed
          */
         selections: readonly NotebookRange[];
 
         /**
          * The current visible ranges in the editor (vertically).
-         * @stubbed
          */
         readonly visibleRanges: readonly NotebookRange[];
 
         /**
          * The column in which this editor shows.
-         * @stubbed
          */
         readonly viewColumn?: ViewColumn;
 
@@ -14484,7 +14575,6 @@ export module '@theia/plugin' {
     export interface NotebookRendererMessaging {
         /**
          * An event that fires when a message is received from a renderer.
-         * @stubbed
          */
         readonly onDidReceiveMessage: Event<{
             readonly editor: NotebookEditor;
@@ -14499,7 +14589,6 @@ export module '@theia/plugin' {
          * message is sent to all renderers.
          * @returns a boolean indicating whether the message was successfully
          * delivered to any renderer.
-         * @stubbed
          */
         postMessage(message: any, editor?: NotebookEditor): Thenable<boolean>;
     }
@@ -14533,7 +14622,6 @@ export module '@theia/plugin' {
          * The index of this cell in its {@link NotebookDocument.cellAt containing notebook}. The
          * index is updated when a cell is moved within its notebook. The index is `-1`
          * when the cell has been removed from its notebook.
-         * @stubbed
          */
         readonly index: number;
 
@@ -14544,31 +14632,26 @@ export module '@theia/plugin' {
 
         /**
          * The kind of this cell.
-         * @stubbed
          */
         readonly kind: NotebookCellKind;
 
         /**
          * The {@link TextDocument text} of this cell, represented as text document.
-         * @stubbed
          */
         readonly document: TextDocument;
 
         /**
          * The metadata of this cell. Can be anything but must be JSON-stringifyable.
-         * @stubbed
          */
         readonly metadata: { readonly [key: string]: any };
 
         /**
          * The outputs of this cell.
-         * @stubbed
          */
         readonly outputs: readonly NotebookCellOutput[];
 
         /**
          * The most recent {@link NotebookCellExecutionSummary execution summary} for this cell.
-         * @stubbed
          */
         readonly executionSummary: NotebookCellExecutionSummary | undefined;
     }
@@ -14584,7 +14667,6 @@ export module '@theia/plugin' {
          *
          * *Note* that most notebooks use the `file`-scheme, which means they are files on disk. However, **not** all notebooks are
          * saved on disk and therefore the `scheme` must be checked before trying to access the underlying file or siblings on disk.
-         * @stubbed
          *
          * @see {@link FileSystemProvider}
          */
@@ -14592,7 +14674,6 @@ export module '@theia/plugin' {
 
         /**
          * The type of notebook.
-         * @stubbed
          */
         readonly notebookType: string;
 
@@ -14620,13 +14701,11 @@ export module '@theia/plugin' {
 
         /**
          * Arbitrary metadata for this notebook. Can be anything but must be JSON-stringifyable.
-         * @stubbed
          */
         readonly metadata: { [key: string]: any };
 
         /**
          * The number of cells in the notebook.
-         * @stubbed
          */
         readonly cellCount: number;
 
@@ -14635,7 +14714,6 @@ export module '@theia/plugin' {
          *
          * @param index - The index of the cell to retrieve.
          * @return A {@link NotebookCell cell}.
-         * @stubbed
          */
         cellAt(index: number): NotebookCell;
 
@@ -14645,7 +14723,6 @@ export module '@theia/plugin' {
          *
          * @param range A notebook range.
          * @returns The cells contained by the range or all cells.
-         * @stubbed
          */
         getCells(range?: NotebookRange): NotebookCell[];
 
@@ -14654,7 +14731,6 @@ export module '@theia/plugin' {
          *
          * @return A promise that will resolve to true when the document
          * has been saved. Will return false if the file was not dirty or when save failed.
-         * @stubbed
          */
         save(): Thenable<boolean>;
     }
@@ -14668,7 +14744,6 @@ export module '@theia/plugin' {
 
         /**
          * The affected cell.
-         * @stubbed
          */
         readonly cell: NotebookCell;
 
@@ -14677,25 +14752,21 @@ export module '@theia/plugin' {
          *
          * *Note* that you should use the {@link workspace.onDidChangeTextDocument onDidChangeTextDocument}-event
          * for detailed change information, like what edits have been performed.
-         * @stubbed
          */
         readonly document: TextDocument | undefined;
 
         /**
          * The new metadata of the cell or `undefined` when it did not change.
-         * @stubbed
          */
         readonly metadata: { [key: string]: any } | undefined;
 
         /**
          * The new outputs of the cell or `undefined` when they did not change.
-         * @stubbed
          */
         readonly outputs: readonly NotebookCellOutput[] | undefined;
 
         /**
          * The new execution summary of the cell or `undefined` when it did not change.
-         * @stubbed
          */
         readonly executionSummary: NotebookCellExecutionSummary | undefined;
     }
@@ -14712,19 +14783,16 @@ export module '@theia/plugin' {
          *
          * Note that no cells have been {@link NotebookDocumentContentChange.removedCells removed}
          * when this range is {@link NotebookRange.isEmpty empty}.
-         * @stubbed
          */
         readonly range: NotebookRange;
 
         /**
          * Cells that have been added to the document.
-         * @stubbed
          */
         readonly addedCells: readonly NotebookCell[];
 
         /**
          * Cells that have been removed from the document.
-         * @stubbed
          */
         readonly removedCells: readonly NotebookCell[];
     }
@@ -14736,25 +14804,21 @@ export module '@theia/plugin' {
 
         /**
          * The affected notebook.
-         * @stubbed
          */
         readonly notebook: NotebookDocument;
 
         /**
          * The new metadata of the notebook or `undefined` when it did not change.
-         * @stubbed
          */
         readonly metadata: { [key: string]: any } | undefined;
 
         /**
          * An array of content changes describing added or removed {@link NotebookCell cells}.
-         * @stubbed
          */
         readonly contentChanges: readonly NotebookDocumentContentChange[];
 
         /**
          * An array of {@link NotebookDocumentCellChange cell changes}.
-         * @stubbed
          */
         readonly cellChanges: readonly NotebookDocumentCellChange[];
     }
@@ -14769,7 +14833,6 @@ export module '@theia/plugin' {
     export interface NotebookDocumentWillSaveEvent {
         /**
          * A cancellation token.
-         * @stubbed
          */
         readonly token: CancellationToken;
 
@@ -14826,19 +14889,16 @@ export module '@theia/plugin' {
 
         /**
          * The order in which the execution happened.
-         * @stubbed
          */
         readonly executionOrder?: number;
 
         /**
          * If the execution finished successfully.
-         * @stubbed
          */
         readonly success?: boolean;
 
         /**
          * The times at which execution started and ended, as unix timestamps
-         * @stubbed
          */
         readonly timing?: { readonly startTime: number; readonly endTime: number };
     }
@@ -14851,19 +14911,16 @@ export module '@theia/plugin' {
 
         /**
          * The zero-based start index of this range.
-         * @stubbed
          */
         readonly start: number;
 
         /**
          * The exclusive end index of this range (zero-based).
-         * @stubbed
          */
         readonly end: number;
 
         /**
          * `true` if `start` and `end` are equal.
-         * @stubbed
          */
         readonly isEmpty: boolean;
 
@@ -14873,7 +14930,6 @@ export module '@theia/plugin' {
          *
          * @param start start index
          * @param end end index.
-         * @stubbed
          */
         constructor(start: number, end: number);
 
@@ -14883,7 +14939,6 @@ export module '@theia/plugin' {
          * @param change An object that describes a change to this range.
          * @return A range that reflects the given change. Will return `this` range if the change
          * is not changing anything.
-         * @stubbed
          */
         with(change: { start?: number; end?: number }): NotebookRange;
     }
@@ -14987,13 +15042,11 @@ export module '@theia/plugin' {
          *  vscode.NotebookCellOutputItem.text('Hey', 'text/plain'), // INVALID: repeated type, editor will pick just one
          * ])
          * ```
-         * @stubbed
          */
         items: NotebookCellOutputItem[];
 
         /**
          * Arbitrary metadata for this cell output. Can be anything but must be JSON-stringifyable.
-         * @stubbed
          */
         metadata?: { [key: string]: any };
 
@@ -15002,7 +15055,6 @@ export module '@theia/plugin' {
          *
          * @param items Notebook output items.
          * @param metadata Optional metadata.
-         * @stubbed
          */
         constructor(items: NotebookCellOutputItem[], metadata?: { [key: string]: any });
     }
@@ -15014,26 +15066,22 @@ export module '@theia/plugin' {
 
         /**
          * The {@link NotebookCellKind kind} of this cell data.
-         * @stubbed
          */
         kind: NotebookCellKind;
 
         /**
          * The source value of this cell data - either source code or formatted text.
-         * @stubbed
          */
         value: string;
 
         /**
          * The language identifier of the source value of this cell data. Any value from
          * {@linkcode languages.getLanguages getLanguages} is possible.
-         * @stubbed
          */
         languageId: string;
 
         /**
          * The outputs of this cell data.
-         * @stubbed
          */
         outputs?: NotebookCellOutput[];
 
@@ -15044,7 +15092,6 @@ export module '@theia/plugin' {
 
         /**
          * The execution summary of this cell data.
-         * @stubbed
          */
         executionSummary?: NotebookCellExecutionSummary;
 
@@ -15055,7 +15102,6 @@ export module '@theia/plugin' {
          * @param kind The kind.
          * @param value The source value.
          * @param languageId The language identifier of the source value.
-         * @stubbed
          */
         constructor(kind: NotebookCellKind, value: string, languageId: string);
     }
@@ -15071,13 +15117,11 @@ export module '@theia/plugin' {
     export class NotebookData {
         /**
          * The cell data of this notebook data.
-         * @stubbed
          */
         cells: NotebookCellData[];
 
         /**
          * Arbitrary metadata of notebook data.
-         * @stubbed
          */
         metadata?: { [key: string]: any };
 
@@ -15085,7 +15129,6 @@ export module '@theia/plugin' {
          * Create new notebook data.
          *
          * @param cells An array of cell data.
-         * @stubbed
          */
         constructor(cells: NotebookCellData[]);
     }
@@ -15106,7 +15149,6 @@ export module '@theia/plugin' {
          * @param content Contents of a notebook file.
          * @param token A cancellation token.
          * @return Notebook data or a thenable that resolves to such.
-         * @stubbed
          */
         deserializeNotebook(content: Uint8Array, token: CancellationToken): NotebookData | Thenable<NotebookData>;
 
@@ -15116,7 +15158,6 @@ export module '@theia/plugin' {
          * @param data A notebook data structure.
          * @param token A cancellation token.
          * @returns An array of bytes or a thenable that resolves to such.
-         * @stubbed
          */
         serializeNotebook(data: NotebookData, token: CancellationToken): Uint8Array | Thenable<Uint8Array>;
     }
@@ -15132,7 +15173,6 @@ export module '@theia/plugin' {
          * Controls if output change events will trigger notebook document content change events and
          * if it will be used in the diff editor, defaults to false. If the content provider doesn't
          * persist the outputs in the file document, this should be set to true.
-         * @stubbed
          */
         transientOutputs?: boolean;
 
@@ -15141,7 +15181,6 @@ export module '@theia/plugin' {
          * change events and if it will be used in the diff editor, defaults to false. If the
          * content provider doesn't persist a metadata property in the file document, it should be
          * set to true.
-         * @stubbed
          */
         transientCellMetadata?: { [key: string]: boolean | undefined };
 
@@ -15150,7 +15189,6 @@ export module '@theia/plugin' {
          * content change event and if it will be used in the diff editor, defaults to false. If the
          * content provider doesn't persist a metadata property in the file document, it should be
          * set to true.
-         * @stubbed
          */
         transientDocumentMetadata?: { [key: string]: boolean | undefined };
     }
@@ -15165,13 +15203,11 @@ export module '@theia/plugin' {
          * will be created as needed up to the maximum of {@linkcode ViewColumn.Nine}.
          * Use {@linkcode ViewColumn.Beside} to open the editor to the side of the currently
          * active one.
-         * @stubbed
          */
         readonly viewColumn?: ViewColumn;
 
         /**
          * An optional flag that when `true` will stop the {@link NotebookEditor notebook editor} from taking focus.
-         * @stubbed
          */
         readonly preserveFocus?: boolean;
 
@@ -15179,13 +15215,11 @@ export module '@theia/plugin' {
          * An optional flag that controls if an {@link NotebookEditor notebook editor}-tab shows as preview. Preview tabs will
          * be replaced and reused until set to stay - either explicitly or through editing. The default behaviour depends
          * on the `workbench.editor.enablePreview`-setting.
-         * @stubbed
          */
         readonly preview?: boolean;
 
         /**
          * An optional selection to apply for the document in the {@link NotebookEditor notebook editor}.
-         * @stubbed
          */
         readonly selections?: readonly NotebookRange[];
     }
@@ -15248,7 +15282,6 @@ export module '@theia/plugin' {
          *
          * @param range The range of cells to replace
          * @param newCells The new notebook cells.
-         * @stubbed
          */
         static replaceCells(range: NotebookRange, newCells: NotebookCellData[]): NotebookEdit;
 
@@ -15257,7 +15290,6 @@ export module '@theia/plugin' {
          *
          * @param index The index to insert cells at.
          * @param newCells The new notebook cells.
-         * @stubbed
          */
         static insertCells(index: number, newCells: NotebookCellData[]): NotebookEdit;
 
@@ -15265,7 +15297,6 @@ export module '@theia/plugin' {
          * Utility to create an edit that deletes cells in a notebook.
          *
          * @param range The range of cells to delete.
-         * @stubbed
          */
         static deleteCells(range: NotebookRange): NotebookEdit;
 
@@ -15274,7 +15305,6 @@ export module '@theia/plugin' {
          *
          * @param index The index of the cell to update.
          * @param newCellMetadata The new metadata for the cell.
-         * @stubbed
          */
         static updateCellMetadata(index: number, newCellMetadata: { [key: string]: any }): NotebookEdit;
 
@@ -15282,31 +15312,26 @@ export module '@theia/plugin' {
          * Utility to create an edit that updates the notebook's metadata.
          *
          * @param newNotebookMetadata The new metadata for the notebook.
-         * @stubbed
          */
         static updateNotebookMetadata(newNotebookMetadata: { [key: string]: any }): NotebookEdit;
 
         /**
          * Range of the cells being edited. May be empty.
-         * @stubbed
          */
         range: NotebookRange;
 
         /**
          * New cells being inserted. May be empty.
-         * @stubbed
          */
         newCells: NotebookCellData[];
 
         /**
          * Optional new metadata for the cells.
-         * @stubbed
          */
         newCellMetadata?: { [key: string]: any };
 
         /**
          * Optional new metadata for the notebook.
-         * @stubbed
          */
         newNotebookMetadata?: { [key: string]: any };
 
@@ -15319,13 +15344,11 @@ export module '@theia/plugin' {
     export interface NotebookEditorSelectionChangeEvent {
         /**
          * The {@link NotebookEditor notebook editor} for which the selections have changed.
-         * @stubbed
          */
         readonly notebookEditor: NotebookEditor;
 
         /**
          * The new value for the {@link NotebookEditor.selections notebook editor's selections}.
-         * @stubbed
          */
         readonly selections: readonly NotebookRange[];
     }
@@ -15336,13 +15359,11 @@ export module '@theia/plugin' {
     export interface NotebookEditorVisibleRangesChangeEvent {
         /**
          * The {@link NotebookEditor notebook editor} for which the visible ranges have changed.
-         * @stubbed
          */
         readonly notebookEditor: NotebookEditor;
 
         /**
          * The new value for the {@link NotebookEditor.visibleRanges notebook editor's visibleRanges}.
-         * @stubbed
          */
         readonly visibleRanges: readonly NotebookRange[];
     }
@@ -15383,13 +15404,11 @@ export module '@theia/plugin' {
          *
          * _Note_ that controllers are remembered by their identifier and that extensions should use
          * stable identifiers across sessions.
-         * @stubbed
          */
         readonly id: string;
 
         /**
          * The notebook type this controller is for.
-         * @stubbed
          */
         readonly notebookType: string;
 
@@ -15407,32 +15426,27 @@ export module '@theia/plugin' {
          * myController.supportedLanguages = undefined; // falsy
          * myController.supportedLanguages = []; // falsy
          * ```
-         * @stubbed
          */
         supportedLanguages?: string[];
 
         /**
          * The human-readable label of this notebook controller.
-         * @stubbed
          */
         label: string;
 
         /**
          * The human-readable description which is rendered less prominent.
-         * @stubbed
          */
         description?: string;
 
         /**
          * The human-readable detail which is rendered less prominent.
-         * @stubbed
          */
         detail?: string;
 
         /**
          * Whether this controller supports execution order so that the
          * editor can render placeholders for them.
-         * @stubbed
          */
         supportsExecutionOrder?: boolean;
 
@@ -15448,14 +15462,12 @@ export module '@theia/plugin' {
          *
          * @param cell The notebook cell for which to create the execution.
          * @returns A notebook cell execution.
-         * @stubbed
          */
         createNotebookCellExecution(cell: NotebookCell): NotebookCellExecution;
 
         /**
          * The execute handler is invoked when the run gestures in the UI are selected, e.g Run Cell, Run All,
          * Run Selection etc. The execute handler is responsible for creating and managing {@link NotebookCellExecution execution}-objects.
-         * @stubbed
          */
         executeHandler: (cells: NotebookCell[], notebook: NotebookDocument, controller: NotebookController) => void | Thenable<void>;
 
@@ -15470,7 +15482,6 @@ export module '@theia/plugin' {
          *
          * _Note_ that supporting {@link NotebookCellExecution.token cancellation tokens} is preferred and that interrupt handlers should
          * only be used when tokens cannot be supported.
-         * @stubbed
          */
         interruptHandler?: (notebook: NotebookDocument) => void | Thenable<void>;
 
@@ -15483,7 +15494,6 @@ export module '@theia/plugin' {
          *
          * _Note_ that controller selection is persisted (by the controllers {@link NotebookController.id id}) and restored as soon as a
          * controller is re-created or as a notebook is {@link workspace.onDidOpenNotebookDocument opened}.
-         * @stubbed
          */
         readonly onDidChangeSelectedNotebooks: Event<{ readonly notebook: NotebookDocument; readonly selected: boolean }>;
 
@@ -15493,13 +15503,11 @@ export module '@theia/plugin' {
          *
          * @param notebook The notebook for which a priority is set.
          * @param affinity A controller affinity
-         * @stubbed
          */
         updateNotebookAffinity(notebook: NotebookDocument, affinity: NotebookControllerAffinity): void;
 
         /**
          * Dispose and free associated resources.
-         * @stubbed
          */
         dispose(): void;
     }
@@ -15516,7 +15524,6 @@ export module '@theia/plugin' {
 
         /**
          * The {@link NotebookCell cell} for which this execution has been created.
-         * @stubbed
          */
         readonly cell: NotebookCell;
 
@@ -15526,13 +15533,11 @@ export module '@theia/plugin' {
          *
          * _Note_ that the cancellation token will not be triggered when the {@link NotebookController controller}
          * that created this execution uses an {@link NotebookController.interruptHandler interrupt-handler}.
-         * @stubbed
          */
         readonly token: CancellationToken;
 
         /**
          * Set and unset the order of this cell execution.
-         * @stubbed
          */
         executionOrder: number | undefined;
 
@@ -15541,7 +15546,6 @@ export module '@theia/plugin' {
          *
          * @param startTime The time that execution began, in milliseconds in the Unix epoch. Used to drive the clock
          * that shows for how long a cell has been running. If not given, the clock won't be shown.
-         * @stubbed
          */
         start(startTime?: number): void;
 
@@ -15552,7 +15556,6 @@ export module '@theia/plugin' {
          * If false, a red X is shown.
          * If undefined, no check or X icon is shown.
          * @param endTime The time that execution finished, in milliseconds in the Unix epoch.
-         * @stubbed
          */
         end(success: boolean | undefined, endTime?: number): void;
 
@@ -15562,7 +15565,6 @@ export module '@theia/plugin' {
          * @param cell Cell for which output is cleared. Defaults to the {@link NotebookCellExecution.cell cell} of
          * this execution.
          * @return A thenable that resolves when the operation finished.
-         * @stubbed
          */
         clearOutput(cell?: NotebookCell): Thenable<void>;
 
@@ -15573,7 +15575,6 @@ export module '@theia/plugin' {
          * @param cell Cell for which output is cleared. Defaults to the {@link NotebookCellExecution.cell cell} of
          * this execution.
          * @return A thenable that resolves when the operation finished.
-         * @stubbed
          */
         replaceOutput(out: NotebookCellOutput | readonly NotebookCellOutput[], cell?: NotebookCell): Thenable<void>;
 
@@ -15584,7 +15585,6 @@ export module '@theia/plugin' {
          * @param cell Cell for which output is cleared. Defaults to the {@link NotebookCellExecution.cell cell} of
          * this execution.
          * @return A thenable that resolves when the operation finished.
-         * @stubbed
          */
         appendOutput(out: NotebookCellOutput | readonly NotebookCellOutput[], cell?: NotebookCell): Thenable<void>;
 
@@ -15594,7 +15594,6 @@ export module '@theia/plugin' {
          * @param items Output items that replace the items of existing output.
          * @param output Output object that already exists.
          * @return A thenable that resolves when the operation finished.
-         * @stubbed
          */
         replaceOutputItems(items: NotebookCellOutputItem | readonly NotebookCellOutputItem[], output: NotebookCellOutput): Thenable<void>;
 
@@ -15604,7 +15603,6 @@ export module '@theia/plugin' {
          * @param items Output items that are append to existing output.
          * @param output Output object that already exists.
          * @return A thenable that resolves when the operation finished.
-         * @stubbed
          */
         appendOutputItems(items: NotebookCellOutputItem | readonly NotebookCellOutputItem[], output: NotebookCellOutput): Thenable<void>;
     }
@@ -15631,7 +15629,6 @@ export module '@theia/plugin' {
     export class NotebookCellStatusBarItem {
         /**
          * The text to show for the item.
-         * @stubbed
          */
         text: string;
 
@@ -15648,25 +15645,21 @@ export module '@theia/plugin' {
          *
          * Note that if this is a {@linkcode Command} object, only the {@linkcode Command.command command} and {@linkcode Command.arguments arguments}
          * are used by the editor.
-         * @stubbed
          */
         command?: string | Command;
 
         /**
          * A tooltip to show when the item is hovered.
-         * @stubbed
          */
         tooltip?: string;
 
         /**
          * The priority of the item. A higher value item will be shown more to the left.
-         * @stubbed
          */
         priority?: number;
 
         /**
          * Accessibility information used when a screen reader interacts with this item.
-         * @stubbed
          */
         accessibilityInformation?: AccessibilityInformation;
 
@@ -15674,7 +15667,6 @@ export module '@theia/plugin' {
          * Creates a new NotebookCellStatusBarItem.
          * @param text The text to show for the item.
          * @param alignment Whether the item is aligned to the left or right.
-         * @stubbed
          */
         constructor(text: string, alignment: NotebookCellStatusBarAlignment);
     }
@@ -15685,7 +15677,6 @@ export module '@theia/plugin' {
     export interface NotebookCellStatusBarItemProvider {
         /**
          * An optional event to signal that statusbar items have changed. The provide method will be called again.
-         * @stubbed
          */
         onDidChangeCellStatusBarItems?: Event<void>;
 
@@ -15694,7 +15685,6 @@ export module '@theia/plugin' {
          * @param cell The cell for which to return items.
          * @param token A token triggered if this request should be cancelled.
          * @return One or more {@link NotebookCellStatusBarItem cell statusbar items}
-         * @stubbed
          */
         provideCellStatusBarItems(cell: NotebookCell, token: CancellationToken): ProviderResult<NotebookCellStatusBarItem | NotebookCellStatusBarItem[]>;
     }
@@ -15716,7 +15706,6 @@ export module '@theia/plugin' {
          * @param label The label of the controller.
          * @param handler The execute-handler of the controller.
          * @returns a new instance of {@link NotebookController}
-         * @stubbed
          */
         export function createNotebookController(
             id: string,
@@ -15732,7 +15721,6 @@ export module '@theia/plugin' {
          * - Note 2: A renderer only has access to messaging if requiresMessaging is set to always or optional in its notebookRenderer contribution.
          * @param rendererId The renderer ID to communicate with
          * @returns A new notebook renderer messaging object.
-         * @stubbed
          */
         export function createRendererMessaging(rendererId: string): NotebookRendererMessaging;
 
@@ -15741,630 +15729,648 @@ export module '@theia/plugin' {
          * @param notebookType The notebook type to register for.
          * @param provider A cell status bar provider.
          * @returns A Disposable that unregisters this provider when being disposed.
-         * @stubbed
          */
         export function registerNotebookCellStatusBarItemProvider(notebookType: string, provider: NotebookCellStatusBarItemProvider): Disposable;
     }
-}
 
-/**
- * Namespace for testing functionality. Tests are published by registering
- * {@link TestController} instances, then adding {@link TestItem TestItems}.
- * Controllers may also describe how to run tests by creating one or more
- * {@link TestRunProfile} instances.
- */
-export namespace tests {
     /**
-     * Creates a new test controller.
-     *
-     * @param id Identifier for the controller, must be globally unique.
-     * @param label A human-readable label for the controller.
-     * @returns An instance of the {@link TestController}.
-     * @stubbed
+     * Namespace for testing functionality. Tests are published by registering
+     * {@link TestController} instances, then adding {@link TestItem TestItems}.
+     * Controllers may also describe how to run tests by creating one or more
+     * {@link TestRunProfile} instances.
      */
-    export function createTestController(id: string, label: string): TestController;
-}
-
-/**
- * The kind of executions that {@link TestRunProfile TestRunProfiles} control.
- */
-export enum TestRunProfileKind {
-    Run = 1,
-    Debug = 2,
-    Coverage = 3,
-}
+    export namespace tests {
+        /**
+         * Creates a new test controller.
+         *
+         * @param id Identifier for the controller, must be globally unique.
+         * @param label A human-readable label for the controller.
+         * @returns An instance of the {@link TestController}.
+         * @stubbed
+         */
+        export function createTestController(id: string, label: string): TestController;
+    }
 
-/**
- * Tags can be associated with {@link TestItem TestItems} and
- * {@link TestRunProfile TestRunProfiles}. A profile with a tag can only
- * execute tests that include that tag in their {@link TestItem.tags} array.
- */
-export class TestTag {
     /**
-     * ID of the test tag. `TestTag` instances with the same ID are considered
-     * to be identical.
+     * The kind of executions that {@link TestRunProfile TestRunProfiles} control.
      */
-    readonly id: string;
+    export enum TestRunProfileKind {
+        Run = 1,
+        Debug = 2,
+        Coverage = 3,
+    }
 
     /**
-     * Creates a new TestTag instance.
-     * @param id ID of the test tag.
+     * Tags can be associated with {@link TestItem TestItems} and
+     * {@link TestRunProfile TestRunProfiles}. A profile with a tag can only
+     * execute tests that include that tag in their {@link TestItem.tags} array.
      */
-    constructor(id: string);
-}
+    export class TestTag {
+        /**
+         * ID of the test tag. `TestTag` instances with the same ID are considered
+         * to be identical.
+         */
+        readonly id: string;
 
-/**
- * A TestRunProfile describes one way to execute tests in a {@link TestController}.
- */
-export interface TestRunProfile {
-    /**
-     * Label shown to the user in the UI.
-     *
-     * Note that the label has some significance if the user requests that
-     * tests be re-run in a certain way. For example, if tests were run
-     * normally and the user requests to re-run them in debug mode, the editor
-     * will attempt use a configuration with the same label of the `Debug`
-     * kind. If there is no such configuration, the default will be used.
-     * @stubbed
-     */
-    label: string;
+        /**
+         * Creates a new TestTag instance.
+         * @param id ID of the test tag.
+         */
+        constructor(id: string);
+    }
 
     /**
-     * Configures what kind of execution this profile controls. If there
-     * are no profiles for a kind, it will not be available in the UI.
-     * @stubbed
+     * A TestRunProfile describes one way to execute tests in a {@link TestController}.
      */
-    readonly kind: TestRunProfileKind;
+    export interface TestRunProfile {
+        /**
+         * Label shown to the user in the UI.
+         *
+         * Note that the label has some significance if the user requests that
+         * tests be re-run in a certain way. For example, if tests were run
+         * normally and the user requests to re-run them in debug mode, the editor
+         * will attempt use a configuration with the same label of the `Debug`
+         * kind. If there is no such configuration, the default will be used.
+         * @stubbed
+         */
+        label: string;
 
-    /**
-     * Controls whether this profile is the default action that will
-     * be taken when its kind is actioned. For example, if the user clicks
-     * the generic "run all" button, then the default profile for
-     * {@link TestRunProfileKind.Run} will be executed, although the
-     * user can configure this.
-     * @stubbed
-     */
-    isDefault: boolean;
+        /**
+         * Configures what kind of execution this profile controls. If there
+         * are no profiles for a kind, it will not be available in the UI.
+         * @stubbed
+         */
+        readonly kind: TestRunProfileKind;
 
-    /**
-     * Whether this profile supports continuous running of requests. If so,
-     * then {@link TestRunRequest.continuous} may be set to `true`. Defaults
-     * to false.
-     * @stubbed
-     */
-    supportsContinuousRun: boolean;
+        /**
+         * Controls whether this profile is the default action that will
+         * be taken when its kind is actioned. For example, if the user clicks
+         * the generic "run all" button, then the default profile for
+         * {@link TestRunProfileKind.Run} will be executed, although the
+         * user can configure this.
+         * @stubbed
+         */
+        isDefault: boolean;
 
-    /**
-     * Associated tag for the profile. If this is set, only {@link TestItem}
-     * instances with the same tag will be eligible to execute in this profile.
-     * @stubbed
-     */
-    tag: TestTag | undefined;
+        /**
+         * Whether this profile supports continuous running of requests. If so,
+         * then {@link TestRunRequest.continuous} may be set to `true`. Defaults
+         * to false.
+         * @stubbed
+         */
+        supportsContinuousRun: boolean;
 
-    /**
-     * If this method is present, a configuration gear will be present in the
-     * UI, and this method will be invoked when it's clicked. When called,
-     * you can take other editor actions, such as showing a quick pick or
-     * opening a configuration file.
-     * @stubbed
-     */
-    configureHandler: (() => void) | undefined;
+        /**
+         * Associated tag for the profile. If this is set, only {@link TestItem}
+         * instances with the same tag will be eligible to execute in this profile.
+         * @stubbed
+         */
+        tag: TestTag | undefined;
 
-    /**
-     * Handler called to start a test run. When invoked, the function should call
-     * {@link TestController.createTestRun} at least once, and all test runs
-     * associated with the request should be created before the function returns
-     * or the returned promise is resolved.
-     *
-     * If {@link supportsContinuousRun} is set, then {@link TestRunRequest.continuous}
-     * may be `true`. In this case, the profile should observe changes to
-     * source code and create new test runs by calling {@link TestController.createTestRun},
-     * until the cancellation is requested on the `token`.
-     *
-     * @param request Request information for the test run.
-     * @param cancellationToken Token that signals the used asked to abort the
-     * test run. If cancellation is requested on this token, all {@link TestRun}
-     * instances associated with the request will be
-     * automatically cancelled as well.
-     * @stubbed
-     */
-    runHandler: (request: TestRunRequest, token: CancellationToken) => Thenable<void> | void;
+        /**
+         * If this method is present, a configuration gear will be present in the
+         * UI, and this method will be invoked when it's clicked. When called,
+         * you can take other editor actions, such as showing a quick pick or
+         * opening a configuration file.
+         * @stubbed
+         */
+        configureHandler: (() => void) | undefined;
 
-    /**
-     * Deletes the run profile.
-     * @stubbed
-     */
-    dispose(): void;
-}
+        /**
+         * Handler called to start a test run. When invoked, the function should call
+         * {@link TestController.createTestRun} at least once, and all test runs
+         * associated with the request should be created before the function returns
+         * or the returned promise is resolved.
+         *
+         * If {@link supportsContinuousRun} is set, then {@link TestRunRequest.continuous}
+         * may be `true`. In this case, the profile should observe changes to
+         * source code and create new test runs by calling {@link TestController.createTestRun},
+         * until the cancellation is requested on the `token`.
+         *
+         * @param request Request information for the test run.
+         * @param cancellationToken Token that signals the used asked to abort the
+         * test run. If cancellation is requested on this token, all {@link TestRun}
+         * instances associated with the request will be
+         * automatically cancelled as well.
+         * @stubbed
+         */
+        runHandler: (request: TestRunRequest, token: CancellationToken) => Thenable<void> | void;
 
-/**
- * Entry point to discover and execute tests. It contains {@link TestController.items} which
- * are used to populate the editor UI, and is associated with
- * {@link TestController.createRunProfile run profiles} to allow
- * for tests to be executed.
- */
-export interface TestController {
-    /**
-     * The id of the controller passed in {@link vscode.tests.createTestController}.
-     * This must be globally unique.
-     * @stubbed
-     */
-    readonly id: string;
+        /**
+         * Deletes the run profile.
+         * @stubbed
+         */
+        dispose(): void;
+    }
 
     /**
-     * Human-readable label for the test controller.
-     * @stubbed
+     * Entry point to discover and execute tests. It contains {@link TestController.items} which
+     * are used to populate the editor UI, and is associated with
+     * {@link TestController.createRunProfile run profiles} to allow
+     * for tests to be executed.
      */
-    label: string;
+    export interface TestController {
+        /**
+         * The id of the controller passed in {@link vscode.tests.createTestController}.
+         * This must be globally unique.
+         * @stubbed
+         */
+        readonly id: string;
 
-    /**
-     * A collection of "top-level" {@link TestItem} instances, which can in
-     * turn have their own {@link TestItem.children children} to form the
-     * "test tree."
-     *
-     * The extension controls when to add tests. For example, extensions should
-     * add tests for a file when {@link vscode.workspace.onDidOpenTextDocument}
-     * fires in order for decorations for tests within a file to be visible.
-     *
-     * However, the editor may sometimes explicitly request children using the
-     * {@link resolveHandler} See the documentation on that method for more details.
-     * @stubbed
-     */
-    readonly items: TestItemCollection;
+        /**
+         * Human-readable label for the test controller.
+         * @stubbed
+         */
+        label: string;
 
-    /**
-     * Creates a profile used for running tests. Extensions must create
-     * at least one profile in order for tests to be run.
-     * @param label A human-readable label for this profile.
-     * @param kind Configures what kind of execution this profile manages.
-     * @param runHandler Function called to start a test run.
-     * @param isDefault Whether this is the default action for its kind.
-     * @param tag Profile test tag.
-     * @param supportsContinuousRun Whether the profile supports continuous running.
-     * @returns An instance of a {@link TestRunProfile}, which is automatically
-     * associated with this controller.
-     * @stubbed
-     */
-    createRunProfile(label: string, kind: TestRunProfileKind, runHandler: (request: TestRunRequest, token: CancellationToken) => Thenable<void> | void, isDefault?: boolean, tag?: TestTag, supportsContinuousRun?: boolean): TestRunProfile;
+        /**
+         * A collection of "top-level" {@link TestItem} instances, which can in
+         * turn have their own {@link TestItem.children children} to form the
+         * "test tree."
+         *
+         * The extension controls when to add tests. For example, extensions should
+         * add tests for a file when {@link vscode.workspace.onDidOpenTextDocument}
+         * fires in order for decorations for tests within a file to be visible.
+         *
+         * However, the editor may sometimes explicitly request children using the
+         * {@link resolveHandler} See the documentation on that method for more details.
+         * @stubbed
+         */
+        readonly items: TestItemCollection;
 
-    /**
-     * A function provided by the extension that the editor may call to request
-     * children of a test item, if the {@link TestItem.canResolveChildren} is
-     * `true`. When called, the item should discover children and call
-     * {@link vscode.tests.createTestItem} as children are discovered.
-     *
-     * Generally the extension manages the lifecycle of test items, but under
-     * certain conditions the editor may request the children of a specific
-     * item to be loaded. For example, if the user requests to re-run tests
-     * after reloading the editor, the editor may need to call this method
-     * to resolve the previously-run tests.
-     *
-     * The item in the explorer will automatically be marked as "busy" until
-     * the function returns or the returned thenable resolves.
-     *
-     * @param item An unresolved test item for which children are being
-     * requested, or `undefined` to resolve the controller's initial {@link TestController.items items}.
-     * @stubbed
-     */
-    resolveHandler?: (item: TestItem | undefined) => Thenable<void> | void;
+        /**
+         * Creates a profile used for running tests. Extensions must create
+         * at least one profile in order for tests to be run.
+         * @param label A human-readable label for this profile.
+         * @param kind Configures what kind of execution this profile manages.
+         * @param runHandler Function called to start a test run.
+         * @param isDefault Whether this is the default action for its kind.
+         * @param tag Profile test tag.
+         * @param supportsContinuousRun Whether the profile supports continuous running.
+         * @returns An instance of a {@link TestRunProfile}, which is automatically
+         * associated with this controller.
+         * @stubbed
+         */
+        createRunProfile(label: string, kind: TestRunProfileKind, runHandler: (request: TestRunRequest, token: CancellationToken) => Thenable<void> | void, isDefault?: boolean, tag?: TestTag, supportsContinuousRun?: boolean): TestRunProfile;
 
-    /**
-     * If this method is present, a refresh button will be present in the
-     * UI, and this method will be invoked when it's clicked. When called,
-     * the extension should scan the workspace for any new, changed, or
-     * removed tests.
-     *
-     * It's recommended that extensions try to update tests in realtime, using
-     * a {@link FileSystemWatcher} for example, and use this method as a fallback.
-     *
-     * @returns A thenable that resolves when tests have been refreshed.
-     * @stubbed
-     */
-    refreshHandler: ((token: CancellationToken) => Thenable<void> | void) | undefined;
+        /**
+         * A function provided by the extension that the editor may call to request
+         * children of a test item, if the {@link TestItem.canResolveChildren} is
+         * `true`. When called, the item should discover children and call
+         * {@link vscode.tests.createTestItem} as children are discovered.
+         *
+         * Generally the extension manages the lifecycle of test items, but under
+         * certain conditions the editor may request the children of a specific
+         * item to be loaded. For example, if the user requests to re-run tests
+         * after reloading the editor, the editor may need to call this method
+         * to resolve the previously-run tests.
+         *
+         * The item in the explorer will automatically be marked as "busy" until
+         * the function returns or the returned thenable resolves.
+         *
+         * @param item An unresolved test item for which children are being
+         * requested, or `undefined` to resolve the controller's initial {@link TestController.items items}.
+         * @stubbed
+         */
+        resolveHandler?: (item: TestItem | undefined) => Thenable<void> | void;
 
-    /**
-     * Creates a {@link TestRun}. This should be called by the
-     * {@link TestRunProfile} when a request is made to execute tests, and may
-     * also be called if a test run is detected externally. Once created, tests
-     * that are included in the request will be moved into the queued state.
-     *
-     * All runs created using the same `request` instance will be grouped
-     * together. This is useful if, for example, a single suite of tests is
-     * run on multiple platforms.
-     *
-     * @param request Test run request. Only tests inside the `include` may be
-     * modified, and tests in its `exclude` are ignored.
-     * @param name The human-readable name of the run. This can be used to
-     * disambiguate multiple sets of results in a test run. It is useful if
-     * tests are run across multiple platforms, for example.
-     * @param persist Whether the results created by the run should be
-     * persisted in the editor. This may be false if the results are coming from
-     * a file already saved externally, such as a coverage information file.
-     * @returns An instance of the {@link TestRun}. It will be considered "running"
-     * from the moment this method is invoked until {@link TestRun.end} is called.
-     * @stubbed
-     */
-    createTestRun(request: TestRunRequest, name?: string, persist?: boolean): TestRun;
-
-    /**
-     * Creates a new managed {@link TestItem} instance. It can be added into
-     * the {@link TestItem.children} of an existing item, or into the
-     * {@link TestController.items}.
-     *
-     * @param id Identifier for the TestItem. The test item's ID must be unique
-     * in the {@link TestItemCollection} it's added to.
-     * @param label Human-readable label of the test item.
-     * @param uri URI this TestItem is associated with. May be a file or directory.
-     * @stubbed
-     */
-    createTestItem(id: string, label: string, uri?: Uri): TestItem;
+        /**
+         * If this method is present, a refresh button will be present in the
+         * UI, and this method will be invoked when it's clicked. When called,
+         * the extension should scan the workspace for any new, changed, or
+         * removed tests.
+         *
+         * It's recommended that extensions try to update tests in realtime, using
+         * a {@link FileSystemWatcher} for example, and use this method as a fallback.
+         *
+         * @returns A thenable that resolves when tests have been refreshed.
+         * @stubbed
+         */
+        refreshHandler: ((token: CancellationToken) => Thenable<void> | void) | undefined;
 
-    /**
-     * Unregisters the test controller, disposing of its associated tests
-     * and unpersisted results.
-     * @stubbed
-     */
-    dispose(): void;
-}
+        /**
+         * Creates a {@link TestRun}. This should be called by the
+         * {@link TestRunProfile} when a request is made to execute tests, and may
+         * also be called if a test run is detected externally. Once created, tests
+         * that are included in the request will be moved into the queued state.
+         *
+         * All runs created using the same `request` instance will be grouped
+         * together. This is useful if, for example, a single suite of tests is
+         * run on multiple platforms.
+         *
+         * @param request Test run request. Only tests inside the `include` may be
+         * modified, and tests in its `exclude` are ignored.
+         * @param name The human-readable name of the run. This can be used to
+         * disambiguate multiple sets of results in a test run. It is useful if
+         * tests are run across multiple platforms, for example.
+         * @param persist Whether the results created by the run should be
+         * persisted in the editor. This may be false if the results are coming from
+         * a file already saved externally, such as a coverage information file.
+         * @returns An instance of the {@link TestRun}. It will be considered "running"
+         * from the moment this method is invoked until {@link TestRun.end} is called.
+         * @stubbed
+         */
+        createTestRun(request: TestRunRequest, name?: string, persist?: boolean): TestRun;
 
-/**
- * A TestRunRequest is a precursor to a {@link TestRun}, which in turn is
- * created by passing a request to {@link tests.runTests}. The TestRunRequest
- * contains information about which tests should be run, which should not be
- * run, and how they are run (via the {@link TestRunRequest.profile profile}).
- *
- * In general, TestRunRequests are created by the editor and pass to
- * {@link TestRunProfile.runHandler}, however you can also create test
- * requests and runs outside of the `runHandler`.
- */
-export class TestRunRequest {
-    /**
-     * A filter for specific tests to run. If given, the extension should run
-     * all of the included tests and all their children, excluding any tests
-     * that appear in {@link TestRunRequest.exclude}. If this property is
-     * undefined, then the extension should simply run all tests.
-     *
-     * The process of running tests should resolve the children of any test
-     * items who have not yet been resolved.
-     */
-    readonly include: readonly TestItem[] | undefined;
+        /**
+         * Creates a new managed {@link TestItem} instance. It can be added into
+         * the {@link TestItem.children} of an existing item, or into the
+         * {@link TestController.items}.
+         *
+         * @param id Identifier for the TestItem. The test item's ID must be unique
+         * in the {@link TestItemCollection} it's added to.
+         * @param label Human-readable label of the test item.
+         * @param uri URI this TestItem is associated with. May be a file or directory.
+         * @stubbed
+         */
+        createTestItem(id: string, label: string, uri?: Uri): TestItem;
+
+        /**
+         * Marks an item's results as being outdated. This is commonly called when
+         * code or configuration changes and previous results should no longer
+         * be considered relevant. The same logic used to mark results as outdated
+         * may be used to drive {@link TestRunRequest.continuous continuous test runs}.
+         *
+         * If an item is passed to this method, test results for the item and all of
+         * its children will be marked as outdated. If no item is passed, then all
+         * test owned by the TestController will be marked as outdated.
+         *
+         * Any test runs started before the moment this method is called, including
+         * runs which may still be ongoing, will be marked as outdated and deprioritized
+         * in the editor's UI.
+         *
+         * @param item Item to mark as outdated. If undefined, all the controller's items are marked outdated.
+         * @stubbed
+         */
+        invalidateTestResults(items?: TestItem | readonly TestItem[]): void;
+
+        /**
+         * Unregisters the test controller, disposing of its associated tests
+         * and unpersisted results.
+         * @stubbed
+         */
+        dispose(): void;
+    }
 
     /**
-     * An array of tests the user has marked as excluded from the test included
-     * in this run; exclusions should apply after inclusions.
+     * A TestRunRequest is a precursor to a {@link TestRun}, which in turn is
+     * created by passing a request to {@link tests.runTests}. The TestRunRequest
+     * contains information about which tests should be run, which should not be
+     * run, and how they are run (via the {@link TestRunRequest.profile profile}).
      *
-     * May be omitted if no exclusions were requested. Test controllers should
-     * not run excluded tests or any children of excluded tests.
+     * In general, TestRunRequests are created by the editor and pass to
+     * {@link TestRunProfile.runHandler}, however you can also create test
+     * requests and runs outside of the `runHandler`.
      */
-    readonly exclude: readonly TestItem[] | undefined;
+    export class TestRunRequest {
+        /**
+         * A filter for specific tests to run. If given, the extension should run
+         * all of the included tests and all their children, excluding any tests
+         * that appear in {@link TestRunRequest.exclude}. If this property is
+         * undefined, then the extension should simply run all tests.
+         *
+         * The process of running tests should resolve the children of any test
+         * items who have not yet been resolved.
+         */
+        readonly include: readonly TestItem[] | undefined;
 
-    /**
-     * The profile used for this request. This will always be defined
-     * for requests issued from the editor UI, though extensions may
-     * programmatically create requests not associated with any profile.
-     */
-    readonly profile: TestRunProfile | undefined;
+        /**
+         * An array of tests the user has marked as excluded from the test included
+         * in this run; exclusions should apply after inclusions.
+         *
+         * May be omitted if no exclusions were requested. Test controllers should
+         * not run excluded tests or any children of excluded tests.
+         */
+        readonly exclude: readonly TestItem[] | undefined;
 
-    /**
-     * Whether the profile should run continuously as source code changes. Only
-     * relevant for profiles that set {@link TestRunProfile.supportsContinuousRun}.
-     */
-    readonly continuous?: boolean;
+        /**
+         * The profile used for this request. This will always be defined
+         * for requests issued from the editor UI, though extensions may
+         * programmatically create requests not associated with any profile.
+         */
+        readonly profile: TestRunProfile | undefined;
 
-    /**
-     * @param include Array of specific tests to run, or undefined to run all tests
-     * @param exclude An array of tests to exclude from the run.
-     * @param profile The run profile used for this request.
-     * @param continuous Whether to run tests continuously as source changes.
-     */
-    constructor(include?: readonly TestItem[], exclude?: readonly TestItem[], profile?: TestRunProfile, continuous?: boolean);
-}
+        /**
+         * Whether the profile should run continuously as source code changes. Only
+         * relevant for profiles that set {@link TestRunProfile.supportsContinuousRun}.
+         */
+        readonly continuous?: boolean;
 
-/**
- * Options given to {@link TestController.runTests}
- */
-export interface TestRun {
-    /**
-     * The human-readable name of the run. This can be used to
-     * disambiguate multiple sets of results in a test run. It is useful if
-     * tests are run across multiple platforms, for example.
-     * @stubbed
-     */
-    readonly name: string | undefined;
+        /**
+         * @param include Array of specific tests to run, or undefined to run all tests
+         * @param exclude An array of tests to exclude from the run.
+         * @param profile The run profile used for this request.
+         * @param continuous Whether to run tests continuously as source changes.
+         */
+        constructor(include?: readonly TestItem[], exclude?: readonly TestItem[], profile?: TestRunProfile, continuous?: boolean);
+    }
 
     /**
-     * A cancellation token which will be triggered when the test run is
-     * canceled from the UI.
-     * @stubbed
+     * Options given to {@link TestController.runTests}
      */
-    readonly token: CancellationToken;
+    export interface TestRun {
+        /**
+         * The human-readable name of the run. This can be used to
+         * disambiguate multiple sets of results in a test run. It is useful if
+         * tests are run across multiple platforms, for example.
+         * @stubbed
+         */
+        readonly name: string | undefined;
 
-    /**
-     * Whether the test run will be persisted across reloads by the editor.
-     * @stubbed
-     */
-    readonly isPersisted: boolean;
+        /**
+         * A cancellation token which will be triggered when the test run is
+         * canceled from the UI.
+         * @stubbed
+         */
+        readonly token: CancellationToken;
 
-    /**
-     * Indicates a test is queued for later execution.
-     * @param test Test item to update.
-     * @stubbed
-     */
-    enqueued(test: TestItem): void;
+        /**
+         * Whether the test run will be persisted across reloads by the editor.
+         * @stubbed
+         */
+        readonly isPersisted: boolean;
 
-    /**
-     * Indicates a test has started running.
-     * @param test Test item to update.
-     * @stubbed
-     */
-    started(test: TestItem): void;
+        /**
+         * Indicates a test is queued for later execution.
+         * @param test Test item to update.
+         * @stubbed
+         */
+        enqueued(test: TestItem): void;
 
-    /**
-     * Indicates a test has been skipped.
-     * @param test Test item to update.
-     * @stubbed
-     */
-    skipped(test: TestItem): void;
+        /**
+         * Indicates a test has started running.
+         * @param test Test item to update.
+         * @stubbed
+         */
+        started(test: TestItem): void;
 
-    /**
-     * Indicates a test has failed. You should pass one or more
-     * {@link TestMessage TestMessages} to describe the failure.
-     * @param test Test item to update.
-     * @param message Messages associated with the test failure.
-     * @param duration How long the test took to execute, in milliseconds.
-     * @stubbed
-     */
-    failed(test: TestItem, message: TestMessage | readonly TestMessage[], duration?: number): void;
+        /**
+         * Indicates a test has been skipped.
+         * @param test Test item to update.
+         * @stubbed
+         */
+        skipped(test: TestItem): void;
 
-    /**
-     * Indicates a test has errored. You should pass one or more
-     * {@link TestMessage TestMessages} to describe the failure. This differs
-     * from the "failed" state in that it indicates a test that couldn't be
-     * executed at all, from a compilation error for example.
-     * @param test Test item to update.
-     * @param message Messages associated with the test failure.
-     * @param duration How long the test took to execute, in milliseconds.
-     * @stubbed
-     */
-    errored(test: TestItem, message: TestMessage | readonly TestMessage[], duration?: number): void;
+        /**
+         * Indicates a test has failed. You should pass one or more
+         * {@link TestMessage TestMessages} to describe the failure.
+         * @param test Test item to update.
+         * @param message Messages associated with the test failure.
+         * @param duration How long the test took to execute, in milliseconds.
+         * @stubbed
+         */
+        failed(test: TestItem, message: TestMessage | readonly TestMessage[], duration?: number): void;
 
-    /**
-     * Indicates a test has passed.
-     * @param test Test item to update.
-     * @param duration How long the test took to execute, in milliseconds.
-     * @stubbed
-     */
-    passed(test: TestItem, duration?: number): void;
+        /**
+         * Indicates a test has errored. You should pass one or more
+         * {@link TestMessage TestMessages} to describe the failure. This differs
+         * from the "failed" state in that it indicates a test that couldn't be
+         * executed at all, from a compilation error for example.
+         * @param test Test item to update.
+         * @param message Messages associated with the test failure.
+         * @param duration How long the test took to execute, in milliseconds.
+         * @stubbed
+         */
+        errored(test: TestItem, message: TestMessage | readonly TestMessage[], duration?: number): void;
 
-    /**
-     * Appends raw output from the test runner. On the user's request, the
-     * output will be displayed in a terminal. ANSI escape sequences,
-     * such as colors and text styles, are supported.
-     *
-     * @param output Output text to append.
-     * @param location Indicate that the output was logged at the given
-     * location.
-     * @param test Test item to associate the output with.
-     * @stubbed
-     */
-    appendOutput(output: string, location?: Location, test?: TestItem): void;
+        /**
+         * Indicates a test has passed.
+         * @param test Test item to update.
+         * @param duration How long the test took to execute, in milliseconds.
+         * @stubbed
+         */
+        passed(test: TestItem, duration?: number): void;
 
-    /**
-     * Signals that the end of the test run. Any tests included in the run whose
-     * states have not been updated will have their state reset.
-     * @stubbed
-     */
-    end(): void;
-}
+        /**
+         * Appends raw output from the test runner. On the user's request, the
+         * output will be displayed in a terminal. ANSI escape sequences,
+         * such as colors and text styles, are supported.
+         *
+         * @param output Output text to append.
+         * @param location Indicate that the output was logged at the given
+         * location.
+         * @param test Test item to associate the output with.
+         * @stubbed
+         */
+        appendOutput(output: string, location?: Location, test?: TestItem): void;
 
-/**
- * Collection of test items, found in {@link TestItem.children} and
- * {@link TestController.items}.
- */
-export interface TestItemCollection extends Iterable<[id: string, testItem: TestItem]> {
-    /**
-     * Gets the number of items in the collection.
-     * @stubbed
-     */
-    readonly size: number;
+        /**
+         * Signals that the end of the test run. Any tests included in the run whose
+         * states have not been updated will have their state reset.
+         * @stubbed
+         */
+        end(): void;
+    }
 
     /**
-     * Replaces the items stored by the collection.
-     * @param items Items to store.
-     * @stubbed
+     * Collection of test items, found in {@link TestItem.children} and
+     * {@link TestController.items}.
      */
-    replace(items: readonly TestItem[]): void;
+    export interface TestItemCollection extends Iterable<[id: string, testItem: TestItem]> {
+        /**
+         * Gets the number of items in the collection.
+         * @stubbed
+         */
+        readonly size: number;
 
-    /**
-     * Iterate over each entry in this collection.
-     *
-     * @param callback Function to execute for each entry.
-     * @param thisArg The `this` context used when invoking the handler function.
-     * @stubbed
-     */
-    forEach(callback: (item: TestItem, collection: TestItemCollection) => unknown, thisArg?: any): void;
+        /**
+         * Replaces the items stored by the collection.
+         * @param items Items to store.
+         * @stubbed
+         */
+        replace(items: readonly TestItem[]): void;
 
-    /**
-     * Adds the test item to the children. If an item with the same ID already
-     * exists, it'll be replaced.
-     * @param item Item to add.
-     * @stubbed
-     */
-    add(item: TestItem): void;
+        /**
+         * Iterate over each entry in this collection.
+         *
+         * @param callback Function to execute for each entry.
+         * @param thisArg The `this` context used when invoking the handler function.
+         * @stubbed
+         */
+        forEach(callback: (item: TestItem, collection: TestItemCollection) => unknown, thisArg?: any): void;
 
-    /**
-     * Removes a single test item from the collection.
-     * @param itemId Item ID to delete.
-     * @stubbed
-     */
-    delete(itemId: string): void;
+        /**
+         * Adds the test item to the children. If an item with the same ID already
+         * exists, it'll be replaced.
+         * @param item Item to add.
+         * @stubbed
+         */
+        add(item: TestItem): void;
 
-    /**
-     * Efficiently gets a test item by ID, if it exists, in the children.
-     * @param itemId Item ID to get.
-     * @returns The found item or undefined if it does not exist.
-     * @stubbed
-     */
-    get(itemId: string): TestItem | undefined;
-}
+        /**
+         * Removes a single test item from the collection.
+         * @param itemId Item ID to delete.
+         * @stubbed
+         */
+        delete(itemId: string): void;
 
-/**
- * An item shown in the "test explorer" view.
- *
- * A `TestItem` can represent either a test suite or a test itself, since
- * they both have similar capabilities.
- */
-export interface TestItem {
-    /**
-     * Identifier for the `TestItem`. This is used to correlate
-     * test results and tests in the document with those in the workspace
-     * (test explorer). This cannot change for the lifetime of the `TestItem`,
-     * and must be unique among its parent's direct children.
-     * @stubbed
-     */
-    readonly id: string;
+        /**
+         * Efficiently gets a test item by ID, if it exists, in the children.
+         * @param itemId Item ID to get.
+         * @returns The found item or undefined if it does not exist.
+         * @stubbed
+         */
+        get(itemId: string): TestItem | undefined;
+    }
 
     /**
-     * URI this `TestItem` is associated with. May be a file or directory.
-     * @stubbed
+     * An item shown in the "test explorer" view.
+     *
+     * A `TestItem` can represent either a test suite or a test itself, since
+     * they both have similar capabilities.
      */
-    readonly uri: Uri | undefined;
+    export interface TestItem {
+        /**
+         * Identifier for the `TestItem`. This is used to correlate
+         * test results and tests in the document with those in the workspace
+         * (test explorer). This cannot change for the lifetime of the `TestItem`,
+         * and must be unique among its parent's direct children.
+         * @stubbed
+         */
+        readonly id: string;
 
-    /**
-     * The children of this test item. For a test suite, this may contain the
-     * individual test cases or nested suites.
-     * @stubbed
-     */
-    readonly children: TestItemCollection;
+        /**
+         * URI this `TestItem` is associated with. May be a file or directory.
+         * @stubbed
+         */
+        readonly uri: Uri | undefined;
 
-    /**
-     * The parent of this item. It's set automatically, and is undefined
-     * top-level items in the {@link TestController.items} and for items that
-     * aren't yet included in another item's {@link TestItem.children children}.
-     * @stubbed
-     */
-    readonly parent: TestItem | undefined;
+        /**
+         * The children of this test item. For a test suite, this may contain the
+         * individual test cases or nested suites.
+         * @stubbed
+         */
+        readonly children: TestItemCollection;
 
-    /**
-     * Tags associated with this test item. May be used in combination with
-     * {@link TestRunProfile.tags}, or simply as an organizational feature.
-     * @stubbed
-     */
-    tags: readonly TestTag[];
+        /**
+         * The parent of this item. It's set automatically, and is undefined
+         * top-level items in the {@link TestController.items} and for items that
+         * aren't yet included in another item's {@link TestItem.children children}.
+         * @stubbed
+         */
+        readonly parent: TestItem | undefined;
 
-    /**
-     * Indicates whether this test item may have children discovered by resolving.
-     *
-     * If true, this item is shown as expandable in the Test Explorer view and
-     * expanding the item will cause {@link TestController.resolveHandler}
-     * to be invoked with the item.
-     *
-     * Default to `false`.
-     * @stubbed
-     */
-    canResolveChildren: boolean;
+        /**
+         * Tags associated with this test item. May be used in combination with
+         * {@link TestRunProfile.tags}, or simply as an organizational feature.
+         * @stubbed
+         */
+        tags: readonly TestTag[];
 
-    /**
-     * Controls whether the item is shown as "busy" in the Test Explorer view.
-     * This is useful for showing status while discovering children.
-     *
-     * Defaults to `false`.
-     * @stubbed
-     */
-    busy: boolean;
+        /**
+         * Indicates whether this test item may have children discovered by resolving.
+         *
+         * If true, this item is shown as expandable in the Test Explorer view and
+         * expanding the item will cause {@link TestController.resolveHandler}
+         * to be invoked with the item.
+         *
+         * Default to `false`.
+         * @stubbed
+         */
+        canResolveChildren: boolean;
 
-    /**
-     * Display name describing the test case.
-     * @stubbed
-     */
-    label: string;
+        /**
+         * Controls whether the item is shown as "busy" in the Test Explorer view.
+         * This is useful for showing status while discovering children.
+         *
+         * Defaults to `false`.
+         * @stubbed
+         */
+        busy: boolean;
 
-    /**
-     * Optional description that appears next to the label.
-     * @stubbed
-     */
-    description?: string;
+        /**
+         * Display name describing the test case.
+         * @stubbed
+         */
+        label: string;
 
-    /**
-     * A string that should be used when comparing this item
-     * with other items. When `falsy` the {@link TestItem.label label}
-     * is used.
-     * @stubbed
-     */
-    sortText?: string | undefined;
+        /**
+         * Optional description that appears next to the label.
+         * @stubbed
+         */
+        description?: string;
 
-    /**
-     * Location of the test item in its {@link TestItem.uri uri}.
-     *
-     * This is only meaningful if the `uri` points to a file.
-     * @stubbed
-     */
-    range: Range | undefined;
+        /**
+         * A string that should be used when comparing this item
+         * with other items. When `falsy` the {@link TestItem.label label}
+         * is used.
+         * @stubbed
+         */
+        sortText?: string | undefined;
 
-    /**
-     * Optional error encountered while loading the test.
-     *
-     * Note that this is not a test result and should only be used to represent errors in
-     * test discovery, such as syntax errors.
-     * @stubbed
-     */
-    error: string | MarkdownString | undefined;
-}
+        /**
+         * Location of the test item in its {@link TestItem.uri uri}.
+         *
+         * This is only meaningful if the `uri` points to a file.
+         * @stubbed
+         */
+        range: Range | undefined;
 
-/**
- * Message associated with the test state. Can be linked to a specific
- * source range -- useful for assertion failures, for example.
- */
-export class TestMessage {
-    /**
-     * Human-readable message text to display.
-     */
-    message: string | MarkdownString;
+        /**
+         * Optional error encountered while loading the test.
+         *
+         * Note that this is not a test result and should only be used to represent errors in
+         * test discovery, such as syntax errors.
+         * @stubbed
+         */
+        error: string | MarkdownString | undefined;
+    }
 
     /**
-     * Expected test output. If given with {@link TestMessage.actualOutput actualOutput }, a diff view will be shown.
+     * Message associated with the test state. Can be linked to a specific
+     * source range -- useful for assertion failures, for example.
      */
-    expectedOutput?: string;
+    export class TestMessage {
+        /**
+         * Human-readable message text to display.
+         */
+        message: string | MarkdownString;
 
-    /**
-     * Actual test output. If given with {@link TestMessage.expectedOutput expectedOutput }, a diff view will be shown.
-     */
-    actualOutput?: string;
+        /**
+         * Expected test output. If given with {@link TestMessage.actualOutput actualOutput }, a diff view will be shown.
+         */
+        expectedOutput?: string;
 
-    /**
-     * Associated file location.
-     */
-    location?: Location;
+        /**
+         * Actual test output. If given with {@link TestMessage.expectedOutput expectedOutput }, a diff view will be shown.
+         */
+        actualOutput?: string;
 
-    /**
-     * Creates a new TestMessage that will present as a diff in the editor.
-     * @param message Message to display to the user.
-     * @param expected Expected output.
-     * @param actual Actual output.
-     */
-    static diff(message: string | MarkdownString, expected: string, actual: string): TestMessage;
+        /**
+         * Associated file location.
+         */
+        location?: Location;
+
+        /**
+         * Creates a new TestMessage that will present as a diff in the editor.
+         * @param message Message to display to the user.
+         * @param expected Expected output.
+         * @param actual Actual output.
+         */
+        static diff(message: string | MarkdownString, expected: string, actual: string): TestMessage;
+
+        /**
+         * Creates a new TestMessage instance.
+         * @param message The message to show to the user.
+         */
+        constructor(message: string | MarkdownString);
+    }
 
     /**
-     * Creates a new TestMessage instance.
-     * @param message The message to show to the user.
+     * Thenable is a common denominator between ES6 promises, Q, jquery.Deferred, WinJS.Promise,
+     * and others. This API makes no assumption about what promise library is being used which
+     * enables reusing existing code without migrating to a specific promise implementation. Still,
+     * we recommend the use of native promises which are available in this editor.
      */
-    constructor(message: string | MarkdownString);
-}
+    interface Thenable<T> {
+        /**
+         * Attaches callbacks for the resolution and/or rejection of the Promise.
+         * @param onfulfilled The callback to execute when the Promise is resolved.
+         * @param onrejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of which ever callback is executed.
+         */
+        then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => TResult | Thenable<TResult>): Thenable<TResult>;
+        then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => void): Thenable<TResult>;
+    }
 
-/**
- * Thenable is a common denominator between ES6 promises, Q, jquery.Deferred, WinJS.Promise,
- * and others. This API makes no assumption about what promise library is being used which
- * enables reusing existing code without migrating to a specific promise implementation. Still,
- * we recommend the use of native promises which are available in this editor.
- */
-interface Thenable<T> {
-    /**
-     * Attaches callbacks for the resolution and/or rejection of the Promise.
-     * @param onfulfilled The callback to execute when the Promise is resolved.
-     * @param onrejected The callback to execute when the Promise is rejected.
-     * @returns A Promise for the completion of which ever callback is executed.
-     */
-    then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => TResult | Thenable<TResult>): Thenable<TResult>;
-    then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => void): Thenable<TResult>;
 }
-