@theia/plugin 1.56.0 → 1.57.0-next.136

package/src/theia.proposed.documentPaste.d.ts

@@ -28,6 +28,20 @@ export module '@theia/plugin' {
     class DocumentDropOrPasteEditKind {
         static readonly Empty: DocumentDropOrPasteEditKind;
 
+        /**
+         * The root kind for basic text edits.
+         *
+         * This kind should be used for edits that insert basic text into the document. A good example of this is
+         * an edit that pastes the clipboard text while also updating imports in the file based on the pasted text.
+         * For this we could use a kind such as `text.updateImports.someLanguageId`.
+         *
+         * Even though most drop/paste edits ultimately insert text, you should not use {@linkcode Text} as the base kind
+         * for every edit as this is redundant. Instead a more specific kind that describes the type of content being
+         * inserted should be used instead For example, if the edit adds a Markdown link, use `markdown.link` since even
+         * though the content being inserted is text, it's more important to know that the edit inserts Markdown syntax.
+         */
+        static readonly Text: DocumentDropOrPasteEditKind;
+
         private constructor(value: string);
 
         /**

package/src/theia.proposed.mappedEditsProvider.d.ts

@@ -45,7 +45,7 @@ export module '@theia/plugin' {
          * The conversation that led to the current code block(s).
          * The last conversation part contains the code block(s) for which the code mapper should provide edits.
          */
-        readonly conversation?: (ConversationRequest | ConversationResponse)[];
+        readonly conversation?: Array<ConversationRequest | ConversationResponse>;
     }
 
     /**
@@ -72,7 +72,7 @@ export module '@theia/plugin' {
     export interface MappedEditsRequest {
         readonly codeBlocks: { code: string; resource: Uri; markdownBeforeBlock?: string }[];
         // for every prior response that contains codeblocks, make sure we pass the code as well as the resources based on the reported codemapper URIs
-        readonly conversation: (ConversationRequest | ConversationResponse)[];
+        readonly conversation: Array<ConversationRequest | ConversationResponse>;
     }
 
     export interface MappedEditsResponseStream {

package/src/theia.proposed.terminalCompletionProvider.d.ts

@@ -0,0 +1,143 @@
+// *****************************************************************************
+// Copyright (C) 2025 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// code copied and modified from https://github.com/microsoft/vscode/blob/1.96.2/src/vscode-dts/vscode.proposed.terminalCompletionProvider.d.ts
+
+declare module '@theia/plugin' {
+
+    // https://github.com/microsoft/vscode/issues/226562
+
+    export interface TerminalCompletionProvider<T extends TerminalCompletionItem> {
+        id: string;
+        /**
+         * Provide completions for the given position and document.
+         * @param terminal The terminal for which completions are being provided.
+         * @param context Information about the terminal's current state.
+         * @param token A cancellation token.
+         * @return A list of completions.
+         */
+        provideTerminalCompletions(terminal: Terminal, context: TerminalCompletionContext, token: CancellationToken): ProviderResult<T[] | TerminalCompletionList<T>>;
+    }
+
+    export interface TerminalCompletionItem {
+        /**
+         * The label of the completion.
+         */
+        label: string;
+
+        /**
+         * The index of the start of the range to replace.
+         */
+        replacementIndex: number;
+
+        /**
+         * The length of the range to replace.
+         */
+        replacementLength: number;
+
+        /**
+         * The completion's detail which appears on the right of the list.
+         */
+        detail?: string;
+
+        /**
+         * The completion's kind. Note that this will map to an icon.
+         */
+        kind?: TerminalCompletionItemKind;
+    }
+
+    /**
+     * Terminal item kinds.
+     */
+    export enum TerminalCompletionItemKind {
+        File = 0,
+        Folder = 1,
+        Flag = 2,
+        Method = 3,
+        Argument = 4
+    }
+
+    export interface TerminalCompletionContext {
+        /**
+         * The complete terminal command line.
+         */
+        commandLine: string;
+        /**
+         * The index of the
+         * cursor in the command line.
+         */
+        cursorPosition: number;
+    }
+
+    export namespace window {
+        /**
+         * Register a completion provider for a certain type of terminal.
+         *
+         * @param provider The completion provider.
+         * @returns A {@link Disposable} that unregisters this provider when being disposed.
+         * @stubbed
+         */
+        export function registerTerminalCompletionProvider<T extends TerminalCompletionItem>(provider: TerminalCompletionProvider<T>, ...triggerCharacters: string[]): Disposable;
+    }
+
+    /**
+     * Represents a collection of {@link TerminalCompletionItem completion items} to be presented
+     * in the terminal.
+     */
+    export class TerminalCompletionList<T extends TerminalCompletionItem = TerminalCompletionItem> {
+
+        /**
+         * Resources that should be shown in the completions list for the cwd of the terminal.
+         */
+        resourceRequestConfig?: TerminalResourceRequestConfig;
+
+        /**
+         * The completion items.
+         */
+        items: T[];
+
+        /**
+         * Creates a new completion list.
+         *
+         * @param items The completion items.
+         * @param resourceRequestConfig Indicates which resources should be shown as completions for the cwd of the terminal.
+         */
+        constructor(items?: T[], resourceRequestConfig?: TerminalResourceRequestConfig);
+    }
+
+    export interface TerminalResourceRequestConfig {
+        /**
+         * Show files as completion items.
+         */
+        filesRequested?: boolean;
+        /**
+         * Show folders as completion items.
+         */
+        foldersRequested?: boolean;
+        /**
+         * If no cwd is provided, no resources will be shown as completions.
+         */
+        cwd?: Uri;
+        /**
+         * The path separator to use when constructing paths.
+         */
+        pathSeparator: string;
+    }
+}