@codingame/monaco-vscode-api 4.5.1 → 5.0.0

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

@@ -5,6 +5,45 @@
 
 declare module 'vscode' {
 
+	/**
+	 * The location at which the chat is happening.
+	 */
+	export enum ChatLocation {
+		/**
+		 * The chat panel
+		 */
+		Panel = 1,
+		/**
+		 * Terminal inline chat
+		 */
+		Terminal = 2,
+		/**
+		 * Notebook inline chat
+		 */
+		Notebook = 3,
+		/**
+		 * Code editor inline chat
+		 */
+		Editor = 4
+	}
+
+	export interface ChatRequest {
+		/**
+		 * The attempt number of the request. The first request has attempt number 0.
+		 */
+		readonly attempt: number;
+
+		/**
+		 * If automatic command detection is enabled.
+		 */
+		readonly enableCommandDetection: boolean;
+
+		/**
+		 * The location at which the chat is happening. This will always be one of the supported values
+		 */
+		readonly location: ChatLocation;
+	}
+
 	export interface ChatParticipant {
 		onDidPerformAction: Event<ChatUserActionEvent>;
 		supportIssueReporting?: boolean;
@@ -17,11 +56,6 @@ declare module 'vscode' {
 		responseIsRedacted?: boolean;
 	}
 
-	/** @deprecated */
-	export interface ChatMarkdownContent {
-		markdownContent: MarkdownString;
-	}
-
 	/**
 	 * Now only used for the "intent detection" API below
 	 */
@@ -30,73 +64,23 @@ declare module 'vscode' {
 		readonly description: string;
 	}
 
-	// TODO@API fit this into the stream
-	export interface ChatDetectedParticipant {
+	export class ChatResponseDetectedParticipantPart {
 		participant: string;
 		// TODO@API validate this against statically-declared slash commands?
 		command?: ChatCommand;
+		constructor(participant: string, command?: ChatCommand);
 	}
 
-	// TODO@API fit this into the stream
 	export interface ChatVulnerability {
 		title: string;
 		description: string;
 		// id: string; // Later we will need to be able to link these across multiple content chunks.
 	}
 
-	// TODO@API fit this into the stream
-	export interface ChatContent {
-		vulnerabilities?: ChatVulnerability[];
-	}
-
-	/**
-	 * @deprecated use ChatResponseStream instead
-	 */
-	export type ChatContentProgress =
-		| ChatContent
-		| ChatInlineContentReference
-		| ChatCommandButton;
-
-	/**
-	 * @deprecated use ChatResponseStream instead
-	 */
-	export type ChatMetadataProgress =
-		| ChatUsedContext
-		| ChatContentReference
-		| ChatProgressMessage;
-
-	/**
-	 * @deprecated use ChatResponseStream instead
-	 */
-	export type ChatProgress = ChatContentProgress | ChatMetadataProgress;
-
-	/** @deprecated */
-	export interface ChatProgressMessage {
-		message: string;
-	}
-
-	/** @deprecated */
-
-	export interface ChatContentReference {
-		/**
-		 * The resource that was referenced.
-		 */
-		reference: Uri | Location;
-	}
-
-	/**
-	 * A reference to a piece of content that will be rendered inline with the markdown content.
-	 */
-	export interface ChatInlineContentReference {
-		/**
-		 * The resource being referenced.
-		 */
-		inlineReference: Uri | Location;
-
-		/**
-		 * An alternate title for the resource.
-		 */
-		title?: string;
+	export class ChatResponseMarkdownWithVulnerabilitiesPart {
+		value: MarkdownString;
+		vulnerabilities: ChatVulnerability[];
+		constructor(value: string | MarkdownString, vulnerabilities: ChatVulnerability[]);
 	}
 
 	/**
@@ -106,45 +90,29 @@ declare module 'vscode' {
 		command: Command;
 	}
 
-	/**
-	 * A piece of the chat response's content. Will be merged with other progress pieces as needed, and rendered as markdown.
-	 */
-	export interface ChatContent {
-		/**
-		 * The content as a string of markdown source.
-		 */
-		content: string;
-	}
-
 	export interface ChatDocumentContext {
 		uri: Uri;
 		version: number;
 		ranges: Range[];
 	}
 
-	// TODO@API fit this into the stream
-	export interface ChatUsedContext {
-		documents: ChatDocumentContext[];
+	export class ChatResponseTextEditPart {
+		uri: Uri;
+		edits: TextEdit[];
+		constructor(uri: Uri, edits: TextEdit | TextEdit[]);
 	}
 
 	export interface ChatResponseStream {
-		/**
-		 * @deprecated use above methods instread
-		 */
-		report(value: ChatProgress): void;
+		textEdit(target: Uri, edits: TextEdit | TextEdit[]): ChatResponseStream;
+		markdownWithVulnerabilities(value: string | MarkdownString, vulnerabilities: ChatVulnerability[]): ChatResponseStream;
+		detectedParticipant(participant: string, command?: ChatCommand): ChatResponseStream;
+		push(part: ChatResponsePart | ChatResponseTextEditPart | ChatResponseDetectedParticipantPart): ChatResponseStream;
 	}
 
-	/** @deprecated */
-	export type ChatExtendedProgress = ChatProgress
-		| ChatMarkdownContent
-		| ChatDetectedParticipant;
-
-	export type ChatExtendedResponseStream = ChatResponseStream & {
-		/**
-		 * @deprecated
-		 */
-		report(value: ChatExtendedProgress): void;
-	};
+	// TODO@API fit this into the stream
+	export interface ChatUsedContext {
+		documents: ChatDocumentContext[];
+	}
 
 	export interface ChatParticipant {
 		/**
@@ -163,11 +131,12 @@ declare module 'vscode' {
 		insertText?: string;
 		detail?: string;
 		documentation?: string | MarkdownString;
+		command?: Command;
 
 		constructor(label: string | CompletionItemLabel, values: ChatVariableValue[]);
 	}
 
-	export type ChatExtendedRequestHandler = (request: ChatRequest, context: ChatContext, response: ChatExtendedResponseStream, token: CancellationToken) => ProviderResult<ChatResult | void>;
+	export type ChatExtendedRequestHandler = (request: ChatRequest, context: ChatContext, response: ChatResponseStream, token: CancellationToken) => ProviderResult<ChatResult | void>;
 
 	export namespace chat {
 		/**
@@ -230,9 +199,14 @@ declare module 'vscode' {
 		kind: 'bug';
 	}
 
+	export interface ChatEditorAction {
+		kind: 'editor';
+		accepted: boolean;
+	}
+
 	export interface ChatUserActionEvent {
 		readonly result: ChatResult;
-		readonly action: ChatCopyAction | ChatInsertAction | ChatTerminalAction | ChatCommandAction | ChatFollowupAction | ChatBugReportAction;
+		readonly action: ChatCopyAction | ChatInsertAction | ChatTerminalAction | ChatCommandAction | ChatFollowupAction | ChatBugReportAction | ChatEditorAction;
 	}
 
 	export interface ChatVariableValue {

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

@@ -16,7 +16,12 @@ declare module 'vscode' {
 	 * Represents a large language model that accepts ChatML messages and produces a streaming response
 	 */
 	export interface ChatResponseProvider {
+
+		onDidReceiveLanguageModelResponse2?: Event<{ readonly extensionId: string; readonly participant?: string; readonly tokenCount?: number }>;
+
 		provideLanguageModelResponse2(messages: LanguageModelChatMessage[], options: { [name: string]: any }, extensionId: string, progress: Progress<ChatResponseFragment>, token: CancellationToken): Thenable<any>;
+
+		provideTokenCount(text: string | LanguageModelChatMessage, token: CancellationToken): Thenable<number>;
 	}
 
 	export interface ChatResponseProviderMetadata {
@@ -27,6 +32,10 @@ declare module 'vscode' {
 		// TODO@API rename to model
 		name: string;
 
+		version: string;
+
+		tokens: number;
+
 		/**
 		 * When present, this gates the use of `requestLanguageModelAccess` behind an authorization flow where
 		 * the user must approve of another extension accessing the models contributed by this extension.

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

@@ -8,11 +8,7 @@ declare module 'vscode' {
 	 * The tab represents an interactive window.
 	 */
 	export class TabInputChat {
-		/**
-		 * The uri of the history notebook in the interactive window.
-		 */
-		readonly providerId: string;
-		constructor(providerId: string);
+		constructor();
 	}
 
 	export interface Tab {

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

@@ -0,0 +1,15 @@
+/*---------------------------------------------------------------------------------------------
+ *  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 `accessibilityHelpContent`-property of the `views`-contribution
+
+// https://github.com/microsoft/vscode/issues/209855 @meganrogge
+
+/**
+ * View contributions can include an `accessibilityHelpContent` property that provides help content for screen readers
+ * when the accessibility help dialog is invoked by the user with focus in the view.
+ *
+ * The content is provided as a markdown string and can contain commands that will be resolved along with their keybindings.
+ */

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

@@ -7,7 +7,7 @@ declare module 'vscode' {
 
 	// See https://github.com/microsoft/vscode/issues/63943
 
-	export class Thread {
+	export class DebugThread {
 		/**
 		 * Create a ThreadFocus
 		 * @param session
@@ -26,7 +26,7 @@ declare module 'vscode' {
 		readonly threadId: number;
 	}
 
-	export class StackFrame {
+	export class DebugStackFrame {
 		/**
 		 * Create a StackFrameFocus
 		 * @param session
@@ -56,11 +56,11 @@ declare module 'vscode' {
 		 * The currently focused thread or stack frame, or `undefined` if no
 		 * thread or stack is focused.
 		 */
-		export const activeStackItem: Thread | StackFrame | undefined;
+		export const activeStackItem: DebugThread | DebugStackFrame | undefined;
 
 		/**
 		 * An event which fires when the {@link debug.activeStackItem} has changed.
 		 */
-		export const onDidChangeActiveStackItem: Event<Thread | StackFrame | undefined>;
+		export const onDidChangeActiveStackItem: Event<DebugThread | DebugStackFrame | undefined>;
 	}
 }

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

@@ -8,8 +8,8 @@ declare module 'vscode' {
 	export type ChatWelcomeMessageContent = string | MarkdownString;
 
 	export interface ChatWelcomeMessageProvider {
-		provideWelcomeMessage(token: CancellationToken): ProviderResult<ChatWelcomeMessageContent[]>;
-		provideSampleQuestions?(token: CancellationToken): ProviderResult<ChatFollowup[]>;
+		provideWelcomeMessage(location: ChatLocation, token: CancellationToken): ProviderResult<ChatWelcomeMessageContent[]>;
+		provideSampleQuestions?(location: ChatLocation, token: CancellationToken): ProviderResult<ChatFollowup[]>;
 	}
 
 	export interface ChatRequesterInformation {

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

@@ -7,6 +7,47 @@ declare module 'vscode' {
 
 	// https://github.com/microsoft/vscode/issues/30066/
 
+	/**
+	 * Identifies a {@linkcode DocumentDropEdit} or {@linkcode DocumentPasteEdit}
+	 */
+	class DocumentDropOrPasteEditKind {
+		static readonly Empty: DocumentDropOrPasteEditKind;
+
+		private constructor(value: string);
+
+		/**
+		 * The raw string value of the kind.
+		 */
+		readonly value: string;
+
+		/**
+		 * Create a new kind by appending additional scopes to the current kind.
+		 *
+		 * Does not modify the current kind.
+		 */
+		append(...parts: string[]): DocumentDropOrPasteEditKind;
+
+		/**
+		 * Checks if this kind intersects `other`.
+		 *
+		 * The kind `"text.plain"` for example intersects `text`, `"text.plain"` and `"text.plain.list"`,
+		 * but not `"unicorn"`, or `"textUnicorn.plain"`.
+		 *
+		 * @param other Kind to check.
+		 */
+		intersects(other: DocumentDropOrPasteEditKind): boolean;
+
+		/**
+		 * Checks if `other` is a sub-kind of this `DocumentDropOrPasteEditKind`.
+		 *
+		 * The kind `"text.plain"` for example contains `"text.plain"` and `"text.plain.list"`,
+		 * but not `"text"` or `"unicorn.text.plain"`.
+		 *
+		 * @param other Kind to check.
+		 */
+		contains(other: DocumentDropOrPasteEditKind): boolean;
+	}
+
 	/**
 	 * The reason why paste edits were requested.
 	 */
@@ -30,7 +71,7 @@ declare module 'vscode' {
 		/**
 		 * Requested kind of paste edits to return.
 		 */
-		readonly only: DocumentPasteEditKind | undefined;
+		readonly only: DocumentDropOrPasteEditKind | undefined;
 
 		/**
 		 * The reason why paste edits were requested.
@@ -44,18 +85,18 @@ declare module 'vscode' {
 	interface DocumentPasteEditProvider<T extends DocumentPasteEdit = DocumentPasteEdit> {
 
 		/**
-		 * Optional method invoked after the user copies text in a file.
+		 * Optional method invoked after the user copies from a {@link TextEditor text editor}.
 		 *
-		 * This allows the provider to attach copy metadata to the {@link DataTransfer}
-		 * which is then passed back to providers in {@linkcode provideDocumentPasteEdits}.
+		 * This allows the provider to attach metadata about the copied text to the {@link DataTransfer}. This data
+		 * transfer is then passed back to providers in {@linkcode provideDocumentPasteEdits}.
 		 *
-		 * Note that currently any changes to the {@linkcode DataTransfer} are isolated to the current editor session.
-		 * This means that added metadata cannot be seen by other applications.
+		 * Note that currently any changes to the {@linkcode DataTransfer} are isolated to the current editor window.
+		 * This means that any added metadata cannot be seen by other editor windows or by other applications.
 		 *
-		 * @param document Document where the copy took place.
+		 * @param document Text document where the copy took place.
 		 * @param ranges Ranges being copied in {@linkcode document}.
-		 * @param dataTransfer The data transfer associated with the copy. You can store additional values on this for later use in  {@linkcode provideDocumentPasteEdits}.
-		 * This object is only valid for the duration of this method.
+		 * @param dataTransfer The data transfer associated with the copy. You can store additional values on this for
+		 * later use in  {@linkcode provideDocumentPasteEdits}. This object is only valid for the duration of this method.
 		 * @param token A cancellation token.
 		 *
 		 * @return Optional thenable that resolves when all changes to the `dataTransfer` are complete.
@@ -63,17 +104,20 @@ declare module 'vscode' {
 		prepareDocumentPaste?(document: TextDocument, ranges: readonly Range[], dataTransfer: DataTransfer, token: CancellationToken): void | Thenable<void>;
 
 		/**
-		 * Invoked before the user pastes into a document.
+		 * Invoked before the user pastes into a {@link TextEditor text editor}.
 		 *
 		 * Returned edits can replace the standard pasting behavior.
 		 *
 		 * @param document Document being pasted into
 		 * @param ranges Range in the {@linkcode document} to paste into.
-		 * @param dataTransfer The {@link DataTransfer data transfer} associated with the paste. This object is only valid for the duration of the paste operation.
+		 * @param dataTransfer The {@link DataTransfer data transfer} associated with the paste. This object is only
+		 * valid for the duration of the paste operation.
 		 * @param context Additional context for the paste.
 		 * @param token A cancellation token.
 		 *
-		 * @return Set of potential {@link DocumentPasteEdit edits} that apply the paste. Return `undefined` to use standard pasting.
+		 * @return Set of potential {@link DocumentPasteEdit edits} that can apply the paste. Only a single returned
+		 * {@linkcode DocumentPasteEdit} is applied at a time. If multiple edits are returned from all providers, then
+		 * the first is automatically applied and a widget is shown that lets the user switch to the other edits.
 		 */
 		provideDocumentPasteEdits?(document: TextDocument, ranges: readonly Range[], dataTransfer: DataTransfer, context: DocumentPasteEditContext, token: CancellationToken): ProviderResult<T[]>;
 
@@ -81,7 +125,7 @@ declare module 'vscode' {
 		 * Optional method which fills in the {@linkcode DocumentPasteEdit.additionalEdit} before the edit is applied.
 		 *
 		 * This is called once per edit and should be used if generating the complete edit may take a long time.
-		 * Resolve can only be used to change {@link DocumentPasteEdit.additionalEdit}.
+		 * Resolve can only be used to change {@linkcode DocumentPasteEdit.additionalEdit}.
 		 *
 		 * @param pasteEdit The {@linkcode DocumentPasteEdit} to resolve.
 		 * @param token A cancellation token.
@@ -93,7 +137,7 @@ declare module 'vscode' {
 	}
 
 	/**
-	 * An edit applied on paste.
+	 * An edit the applies a paste operation.
 	 */
 	class DocumentPasteEdit {
 
@@ -103,14 +147,14 @@ declare module 'vscode' {
 		title: string;
 
 		/**
-		 * {@link DocumentPasteEditKind Kind} of the edit.
-		 *
-		 * Used to identify specific types of edits.
+		 * {@link DocumentDropOrPasteEditKind Kind} of the edit.
 		 */
-		kind: DocumentPasteEditKind;
+		kind: DocumentDropOrPasteEditKind;
 
 		/**
 		 * The text or snippet to insert at the pasted locations.
+		 *
+		 * If your edit requires more advanced insertion logic, set this to an empty string and provide an {@link DocumentPasteEdit.additionalEdit additional edit} instead.
 		 */
 		insertText: string | SnippetString;
 
@@ -120,47 +164,32 @@ declare module 'vscode' {
 		additionalEdit?: WorkspaceEdit;
 
 		/**
-		 * Controls the ordering of paste edits provided by multiple providers.
+		 * Controls ordering when multiple paste edits can potentially be applied.
 		 *
-		 * If this edit yields to another, it will be shown lower in the list of paste edit.
+		 * If this edit yields to another, it will be shown lower in the list of possible paste edits shown to the user.
 		 */
-		yieldTo?: readonly DocumentPasteEditKind[];
+		yieldTo?: readonly DocumentDropOrPasteEditKind[];
 
 		/**
 		 * Create a new paste edit.
 		 *
 		 * @param insertText The text or snippet to insert at the pasted locations.
 		 * @param title Human readable label that describes the edit.
-		 * @param kind {@link DocumentPasteEditKind Kind} of the edit.
+		 * @param kind {@link DocumentDropOrPasteEditKind Kind} of the edit.
 		 */
-		constructor(insertText: string | SnippetString, title: string, kind: DocumentPasteEditKind);
+		constructor(insertText: string | SnippetString, title: string, kind: DocumentDropOrPasteEditKind);
 	}
 
-
 	/**
-	 * TODO: Share with code action kind?
+	 * Provides additional metadata about how a {@linkcode DocumentPasteEditProvider} works.
 	 */
-	class DocumentPasteEditKind {
-		static readonly Empty: DocumentPasteEditKind;
-
-		// TODO: Add `Text` any others?
-
-		private constructor(value: string);
-
-		readonly value: string;
-
-		append(...parts: string[]): CodeActionKind;
-		intersects(other: CodeActionKind): boolean;
-		contains(other: CodeActionKind): boolean;
-	}
-
 	interface DocumentPasteProviderMetadata {
 		/**
-		 * List of {@link DocumentPasteEditKind kinds} that the provider may return in {@linkcode DocumentPasteEditProvider.provideDocumentPasteEdits provideDocumentPasteEdits}.
+		 * List of {@link DocumentDropOrPasteEditKind kinds} that the provider may return in {@linkcode DocumentPasteEditProvider.provideDocumentPasteEdits provideDocumentPasteEdits}.
 		 *
-		 * The provider will only be invoked when one of these kinds is being requested. For normal pasting, all providers will be invoked.
+		 * This is used to filter out providers when a specific {@link DocumentDropOrPasteEditKind kind} of edit is requested.
 		 */
-		readonly providedPasteEditKinds: readonly DocumentPasteEditKind[];
+		readonly providedPasteEditKinds: readonly DocumentDropOrPasteEditKind[];
 
 		/**
 		 * Mime types that {@linkcode DocumentPasteEditProvider.prepareDocumentPaste prepareDocumentPaste} may add on copy.
@@ -175,12 +204,79 @@ declare module 'vscode' {
 		 * Use `text/uri-list` for resources dropped from the explorer or other tree views in the workbench.
 		 *
 		 * Use `files` to indicate that the provider should be invoked if any {@link DataTransferFile files} are present in the {@linkcode DataTransfer}.
-		 * Note that {@linkcode DataTransferFile} entries are only created when dropping content from outside the editor, such as
+		 * Note that {@linkcode DataTransferFile} entries are only created when pasting content from outside the editor, such as
 		 * from the operating system.
 		 */
 		readonly pasteMimeTypes?: readonly string[];
 	}
 
+	/**
+	 * TODO on finalization:
+	 * - Add ctor(insertText: string | SnippetString, title?: string, kind?: DocumentDropOrPasteEditKind); Can't be done as this is an extension to an existing class
+	 */
+
+	export interface DocumentDropEdit {
+		/**
+		 * Human readable label that describes the edit.
+		 */
+		title?: string;
+
+		/**
+		 * {@link DocumentDropOrPasteEditKind Kind} of the edit.
+		 */
+		kind: DocumentDropOrPasteEditKind;
+
+		/**
+		 * Controls the ordering or multiple edits. If this provider yield to edits, it will be shown lower in the list.
+		 */
+		yieldTo?: readonly DocumentDropOrPasteEditKind[];
+	}
+
+	export interface DocumentDropEditProvider<T extends DocumentDropEdit = DocumentDropEdit> {
+		// Overload that allows returning multiple edits
+		// Will be merged in on finalization
+		provideDocumentDropEdits(document: TextDocument, position: Position, dataTransfer: DataTransfer, token: CancellationToken): ProviderResult<DocumentDropEdit | DocumentDropEdit[]>;
+
+		/**
+		 * Optional method which fills in the {@linkcode DocumentDropEdit.additionalEdit} before the edit is applied.
+		 *
+		 * This is called once per edit and should be used if generating the complete edit may take a long time.
+		 * Resolve can only be used to change {@link DocumentDropEdit.additionalEdit}.
+		 *
+		 * @param pasteEdit The {@linkcode DocumentDropEdit} to resolve.
+		 * @param token A cancellation token.
+		 *
+		 * @returns The resolved edit or a thenable that resolves to such. It is OK to return the given
+		 * `edit`. If no result is returned, the given `edit` is used.
+		 */
+		resolveDocumentDropEdit?(edit: T, token: CancellationToken): ProviderResult<T>;
+	}
+
+	/**
+	 * Provides additional metadata about how a {@linkcode DocumentDropEditProvider} works.
+	 */
+	export interface DocumentDropEditProviderMetadata {
+		/**
+		 * List of {@link DocumentDropOrPasteEditKind kinds} that the provider may return in {@linkcode DocumentDropEditProvider.provideDocumentDropEdits provideDocumentDropEdits}.
+		 *
+		 * This is used to filter out providers when a specific {@link DocumentDropOrPasteEditKind kind} of edit is requested.
+		 */
+		readonly providedDropEditKinds?: readonly DocumentDropOrPasteEditKind[];
+
+		/**
+		 * List of {@link DataTransfer} mime types that the provider can handle.
+		 *
+		 * This can either be an exact mime type such as `image/png`, or a wildcard pattern such as `image/*`.
+		 *
+		 * Use `text/uri-list` for resources dropped from the explorer or other tree views in the workbench.
+		 *
+		 * Use `files` to indicate that the provider should be invoked if any {@link DataTransferFile files} are present in the {@link DataTransfer}.
+		 * Note that {@link DataTransferFile} entries are only created when dropping content from outside the editor, such as
+		 * from the operating system.
+		 */
+		readonly dropMimeTypes: readonly string[];
+	}
+
 	namespace languages {
 		/**
 		 * Registers a new {@linkcode DocumentPasteEditProvider}.
@@ -192,5 +288,10 @@ declare module 'vscode' {
 		 * @returns A {@link Disposable} that unregisters this provider when disposed of.
 		 */
 		export function registerDocumentPasteEditProvider(selector: DocumentSelector, provider: DocumentPasteEditProvider, metadata: DocumentPasteProviderMetadata): Disposable;
+
+		/**
+		 * Overload which adds extra metadata. Will be removed on finalization.
+		 */
+		export function registerDocumentDropEditProvider(selector: DocumentSelector, provider: DocumentDropEditProvider, metadata?: DocumentDropEditProviderMetadata): Disposable;
 	}
 }