@codingame/monaco-vscode-api 26.2.1 → 27.0.0

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

@@ -0,0 +1,166 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	export namespace env {
+
+		/**
+		 * Namespace for power-related APIs including monitoring system power state
+		 * and preventing the system from entering low-power modes.
+		 *
+		 * Note: These APIs are only fully functional in the desktop version of the editor.
+		 * In web or remote scenarios, events will not fire and queries return default values.
+		 */
+		export namespace power {
+
+			// === Events ===
+
+			/**
+			 * Fires when the system is suspending (going to sleep).
+			 */
+			export const onDidSuspend: Event<void>;
+
+			/**
+			 * Fires when the system is resuming from sleep.
+			 */
+			export const onDidResume: Event<void>;
+
+			/**
+			 * Fires when the system's battery power state changes.
+			 * The event value is `true` when on battery power, `false` when on AC power.
+			 *
+			 * Note: Only available on macOS and Windows.
+			 */
+			export const onDidChangeOnBatteryPower: Event<boolean>;
+
+			/**
+			 * Fires when the system's thermal state changes.
+			 *
+			 * Apps may react to the new state by reducing expensive computing tasks
+			 * (e.g., video encoding), or notifying the user.
+			 *
+			 * Note: Only available on macOS.
+			 */
+			export const onDidChangeThermalState: Event<ThermalState>;
+
+			/**
+			 * Fires when the operating system's advertised CPU speed limit changes.
+			 * The event value is the speed limit in percent (values below 100 indicate
+			 * the system is impairing processing power due to thermal management).
+			 *
+			 * Note: Only available on macOS and Windows.
+			 */
+			export const onDidChangeSpeedLimit: Event<number>;
+
+			/**
+			 * Fires when the system is about to shut down or reboot.
+			 *
+			 * Note: Only available on Linux and macOS.
+			 */
+			export const onWillShutdown: Event<void>;
+
+			/**
+			 * Fires when the system screen is about to be locked.
+			 *
+			 * Note: Only available on macOS and Windows.
+			 */
+			export const onDidLockScreen: Event<void>;
+
+			/**
+			 * Fires when the system screen is unlocked.
+			 *
+			 * Note: Only available on macOS and Windows.
+			 */
+			export const onDidUnlockScreen: Event<void>;
+
+			// === Methods ===
+
+			/**
+			 * Gets the system's current idle state.
+			 *
+			 * @param idleThresholdSeconds The amount of time (in seconds) before the system
+			 * is considered idle.
+			 * @returns The system's current idle state.
+			 */
+			export function getSystemIdleState(idleThresholdSeconds: number): Thenable<SystemIdleState>;
+
+			/**
+			 * Gets the system's idle time in seconds.
+			 *
+			 * @returns The number of seconds the system has been idle.
+			 */
+			export function getSystemIdleTime(): Thenable<number>;
+
+			/**
+			 * Gets the system's current thermal state.
+			 *
+			 * Note: Only available on macOS. Returns `'unknown'` on other platforms.
+			 *
+			 * @returns The system's current thermal state.
+			 */
+			export function getCurrentThermalState(): Thenable<ThermalState>;
+
+			/**
+			 * Checks whether the system is currently on battery power.
+			 *
+			 * @returns `true` if the system is on battery power, `false` otherwise.
+			 */
+			export function isOnBatteryPower(): Thenable<boolean>;
+
+			// === Power Save Blocker ===
+
+			/**
+			 * Starts preventing the system from entering lower-power mode.
+			 *
+			 * @param type The type of power save blocker:
+			 * - `'prevent-app-suspension'`: Prevents the application from being suspended.
+			 *   Keeps the system active but allows the screen to turn off.
+			 *   Example use cases: downloading a file or playing audio.
+			 * - `'prevent-display-sleep'`: Prevents the display from going to sleep.
+			 *   Keeps the system and screen active.
+			 *   Example use case: playing video.
+			 *
+			 * Note: `'prevent-display-sleep'` has higher precedence over `'prevent-app-suspension'`.
+			 *
+			 * @returns A {@link PowerSaveBlocker} that can be disposed to stop blocking.
+			 */
+			export function startPowerSaveBlocker(type: PowerSaveBlockerType): Thenable<PowerSaveBlocker>;
+
+			// === Types ===
+
+			/**
+			 * Represents the system's idle state.
+			 */
+			export type SystemIdleState = 'active' | 'idle' | 'locked' | 'unknown';
+
+			/**
+			 * Represents the system's thermal state.
+			 */
+			export type ThermalState = 'unknown' | 'nominal' | 'fair' | 'serious' | 'critical';
+
+			/**
+			 * The type of power save blocker.
+			 */
+			export type PowerSaveBlockerType = 'prevent-app-suspension' | 'prevent-display-sleep';
+
+			/**
+			 * A power save blocker that prevents the system from entering low-power mode.
+			 * Dispose to stop blocking.
+			 */
+			export interface PowerSaveBlocker extends Disposable {
+				/**
+				 * The unique identifier for this power save blocker.
+				 */
+				readonly id: number;
+
+				/**
+				 * Whether this power save blocker is currently active.
+				 */
+				readonly isStarted: boolean;
+			}
+		}
+	}
+}

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

@@ -147,6 +147,11 @@ declare module 'vscode' {
 		// eslint-disable-next-line local/vscode-dts-provider-naming
 		setCurrentModelId?(modelId: string): Thenable<void>;
 
+		readonly providerOptions?: readonly InlineCompletionProviderOption[];
+		readonly onDidChangeProviderOptions?: Event<void>;
+		// eslint-disable-next-line local/vscode-dts-provider-naming
+		setProviderOptionValue?(optionId: string, valueId: string): Thenable<void>;
+
 
 		// #region Deprecated methods
 
@@ -178,6 +183,18 @@ declare module 'vscode' {
 		readonly name: string;
 	}
 
+	export interface InlineCompletionProviderOption {
+		readonly id: string;
+		readonly label: string;
+		readonly values: readonly InlineCompletionProviderOptionValue[];
+		readonly currentValueId: string;
+	}
+
+	export interface InlineCompletionProviderOptionValue {
+		readonly id: string;
+		readonly label: string;
+	}
+
 	export enum InlineCompletionEndOfLifeReasonKind {
 		Accepted = 0,
 		Rejected = 1,

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

@@ -7,6 +7,19 @@ declare module 'vscode' {
 
 	// https://github.com/microsoft/vscode/issues/288777 @DonJayamanne
 
+	/**
+	 * Represents an MCP gateway that exposes MCP servers via HTTP.
+	 * The gateway provides an HTTP endpoint that external processes can connect
+	 * to in order to interact with MCP servers known to the editor.
+	 */
+	export interface McpGateway extends Disposable {
+		/**
+		 * The address of the HTTP MCP server endpoint.
+		 * External processes can connect to this URI to interact with MCP servers.
+		 */
+		readonly address: Uri;
+	}
+
 	/**
 	 * Namespace for language model related functionality.
 	 */
@@ -27,5 +40,20 @@ declare module 'vscode' {
 		 * definitions from any source.
 		 */
 		export const onDidChangeMcpServerDefinitions: Event<void>;
+
+		/**
+		 * Starts an MCP gateway that exposes MCP servers via an HTTP endpoint.
+		 *
+		 * The gateway creates a localhost HTTP server that external processes (such as
+		 * CLI-based agent loops) can connect to in order to interact with MCP servers
+		 * that the editor knows about.
+		 *
+		 * The HTTP server is shared among all gateways and is automatically torn down
+		 * when the last gateway is disposed.
+		 *
+		 * @returns A promise that resolves to an {@link McpGateway} if successful,
+		 * or `undefined` if no Node process is available (e.g., in serverless web environments).
+		 */
+		export function startMcpGateway(): Thenable<McpGateway | undefined>;
 	}
 }

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

@@ -0,0 +1,37 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+declare module 'vscode' {
+
+	// https://github.com/microsoft/vscode/issues/xyz
+
+	export interface TerminalOptions {
+		/**
+		 * A title template string for the terminal tab. This supports the same variables as the
+		 * `terminal.integrated.tabs.title` setting, such as `${sequence}`, `${process}`, `${cwd}`,
+		 * `${cwdFolder}`, `${workspaceFolderName}`, etc. When set, this overrides the default title
+		 * behavior (which uses the `name` as a static title) and instead uses the template for
+		 * dynamic title resolution.
+		 *
+		 * For example, setting `titleTemplate` to `"${sequence}"` allows the terminal's escape sequence
+		 * title to be used as the tab title.
+		 */
+		titleTemplate?: string;
+	}
+
+	export interface ExtensionTerminalOptions {
+		/**
+		 * A title template string for the terminal tab. This supports the same variables as the
+		 * `terminal.integrated.tabs.title` setting, such as `${sequence}`, `${process}`, `${cwd}`,
+		 * `${cwdFolder}`, `${workspaceFolderName}`, etc. When set, this overrides the default title
+		 * behavior (which uses the `name` as a static title) and instead uses the template for
+		 * dynamic title resolution.
+		 *
+		 * For example, setting `titleTemplate` to `"${sequence}"` allows the terminal's escape sequence
+		 * title to be used as the tab title.
+		 */
+		titleTemplate?: string;
+	}
+}

package/vscode/src/vs/platform/assignment/common/assignment.d.ts

@@ -1,85 +0,0 @@
-import { Event } from "../../../base/common/event.js";
-import type { IExperimentationFilterProvider } from "tas-client";
-export declare const ASSIGNMENT_STORAGE_KEY = "VSCode.ABExp.FeatureData";
-export declare const ASSIGNMENT_REFETCH_INTERVAL: number;
-export interface IAssignmentService {
-    readonly _serviceBrand: undefined;
-    readonly onDidRefetchAssignments: Event<void>;
-    getTreatment<T extends string | number | boolean>(name: string): Promise<T | undefined>;
-}
-export declare enum TargetPopulation {
-    Insiders = "insider",
-    Public = "public",
-    Exploration = "exploration"
-}
-export declare enum Filters {
-    /**
-     * The market in which the extension is distributed.
-     */
-    Market = "X-MSEdge-Market",
-    /**
-     * The corporation network.
-     */
-    CorpNet = "X-FD-Corpnet",
-    /**
-     * Version of the application which uses experimentation service.
-     */
-    ApplicationVersion = "X-VSCode-AppVersion",
-    /**
-     * Insiders vs Stable.
-     */
-    Build = "X-VSCode-Build",
-    /**
-     * Client Id which is used as primary unit for the experimentation.
-     */
-    ClientId = "X-MSEdge-ClientId",
-    /**
-     * Developer Device Id which can be used as an alternate unit for experimentation.
-     */
-    DeveloperDeviceId = "X-VSCode-DevDeviceId",
-    /**
-     * Extension header.
-     */
-    ExtensionName = "X-VSCode-ExtensionName",
-    /**
-     * The version of the extension.
-     */
-    ExtensionVersion = "X-VSCode-ExtensionVersion",
-    /**
-     * The language in use by VS Code
-     */
-    Language = "X-VSCode-Language",
-    /**
-     * The target population.
-     * This is used to separate internal, early preview, GA, etc.
-     */
-    TargetPopulation = "X-VSCode-TargetPopulation",
-    /**
-     * The platform (OS) on which VS Code is running.
-     */
-    Platform = "X-VSCode-Platform",
-    /**
-     * The release/build date of VS Code (UTC) in the format yyyymmddHH.
-     */
-    ReleaseDate = "X-VSCode-ReleaseDate"
-}
-export declare class AssignmentFilterProvider implements IExperimentationFilterProvider {
-    private version;
-    private appName;
-    private machineId;
-    private devDeviceId;
-    private targetPopulation;
-    private releaseDate;
-    constructor(version: string, appName: string, machineId: string, devDeviceId: string, targetPopulation: TargetPopulation, releaseDate: string);
-    /**
-     * Returns a version string that can be parsed by the TAS client.
-     * The tas client cannot handle suffixes lke "-insider"
-     * Ref: https://github.com/microsoft/tas-client/blob/30340d5e1da37c2789049fcf45928b954680606f/vscode-tas-client/src/vscode-tas-client/VSCodeFilterProvider.ts#L35
-     *
-     * @param version Version string to be trimmed.
-    */
-    private static trimVersionSuffix;
-    getFilterValue(filter: string): string | null;
-    private static formatReleaseDate;
-    getFilters(): Map<string, unknown>;
-}

package/vscode/src/vs/platform/dialogs/browser/dialog.d.ts

@@ -1,10 +0,0 @@
-import { IDialogOptions } from "../../../base/browser/ui/dialog/dialog.js";
-import { IKeybindingService } from "../../keybinding/common/keybinding.service.js";
-import { ILayoutService } from "../../layout/browser/layoutService.service.js";
-import { IProductService } from "../../product/common/productService.service.js";
-export declare function createWorkbenchDialogOptions(options: Partial<IDialogOptions>, keybindingService: IKeybindingService, layoutService: ILayoutService, allowableCommands?: string[]): IDialogOptions;
-export declare function createBrowserAboutDialogDetails(productService: IProductService): {
-    title: string;
-    details: string;
-    detailsToCopy: string;
-};

package/vscode/src/vs/workbench/services/layout/common/workbenchModeService.d.ts

@@ -1,16 +0,0 @@
-import { Event } from "../../../../base/common/event.js";
-import { IStringDictionary } from "../../../../base/common/collections.js";
-import { IWorkbenchModeService } from "./workbenchModeService.service.js";
-export interface IWorkbenchModeConfiguration {
-    readonly id: string;
-    readonly name: string;
-    readonly settings: IStringDictionary<unknown>;
-}
-export declare class DefaultWorkbenchModeService implements IWorkbenchModeService {
-    readonly _serviceBrand: undefined;
-    readonly workbenchMode: string | undefined;
-    readonly onDidChangeWorkbenchMode: Event<string | undefined>;
-    getWorkbenchModeConfiguration(_id: string): Promise<IWorkbenchModeConfiguration | undefined>;
-    getWorkbenchModeConfigurations(): Promise<IWorkbenchModeConfiguration[]>;
-    setWorkbenchMode(_workbenchMode: string | undefined): Promise<void>;
-}

package/vscode/src/vs/workbench/services/layout/common/workbenchModeService.js

@@ -1,20 +0,0 @@
-
-import { Event } from '../../../../base/common/event.js';
-
-class DefaultWorkbenchModeService {
-    constructor() {
-        this.workbenchMode = undefined;
-        this.onDidChangeWorkbenchMode = Event.None;
-    }
-    getWorkbenchModeConfiguration(_id) {
-        return Promise.resolve(undefined);
-    }
-    getWorkbenchModeConfigurations() {
-        return Promise.resolve([]);
-    }
-    setWorkbenchMode(_workbenchMode) {
-        return Promise.resolve();
-    }
-}
-
-export { DefaultWorkbenchModeService };

package/vscode/src/vs/workbench/services/layout/common/workbenchModeService.service.d.ts

@@ -1,27 +0,0 @@
-import { Event } from "../../../../base/common/event.js";
-import { IWorkbenchModeConfiguration } from "./workbenchModeService.js";
-export declare const IWorkbenchModeService: import("../../../../platform/instantiation/common/instantiation.js").ServiceIdentifier<IWorkbenchModeService>;
-export interface IWorkbenchModeService {
-    readonly _serviceBrand: undefined;
-    /**
-    * The currently active workbench mode id, or undefined if using default settings
-    */
-    readonly workbenchMode: string | undefined;
-    /**
-    * Event fired when the workbench mode changes
-    */
-    readonly onDidChangeWorkbenchMode: Event<string | undefined>;
-    /**
-    * Resolve a workbench mode by its id
-    * @param id The id of the workbench mode to resolve
-    */
-    getWorkbenchModeConfiguration(id: string): Promise<IWorkbenchModeConfiguration | undefined>;
-    /**
-    * Get all workbench modes
-    */
-    getWorkbenchModeConfigurations(): Promise<IWorkbenchModeConfiguration[]>;
-    /**
-    * Set the active workbench mode. Pass undefined to clear the mode and return to defaults.
-    */
-    setWorkbenchMode(workbenchMode: string | undefined): Promise<void>;
-}

package/vscode/src/vs/workbench/services/views/browser/viewsService.d.ts

@@ -1,77 +0,0 @@
-import { Disposable } from "../../../../base/common/lifecycle.js";
-import { ViewContainer, IViewDescriptor, IView, ViewContainerLocation, IViewPaneContainer } from "../../../common/views.js";
-import { IViewDescriptorService } from "../../../common/views.service.js";
-import { IContextKeyService } from "../../../../platform/contextkey/common/contextkey.service.js";
-import { Event } from "../../../../base/common/event.js";
-import { IPaneComposite } from "../../../common/panecomposite.js";
-import { Parts } from "../../layout/browser/layoutService.js";
-import { IWorkbenchLayoutService } from "../../layout/browser/layoutService.service.js";
-import { IProgressIndicator } from "../../../../platform/progress/common/progress.js";
-import { IPaneCompositePartService } from "../../panecomposite/browser/panecomposite.service.js";
-import { IEditorService } from "../../editor/common/editorService.service.js";
-import { IViewsService } from "../common/viewsService.service.js";
-export declare class ViewsService extends Disposable implements IViewsService {
-    private readonly viewDescriptorService;
-    private readonly paneCompositeService;
-    private readonly contextKeyService;
-    private readonly layoutService;
-    private readonly editorService;
-    readonly _serviceBrand: undefined;
-    private readonly viewDisposable;
-    private readonly viewPaneContainers;
-    private readonly _onDidChangeViewVisibility;
-    readonly onDidChangeViewVisibility: Event<{
-        id: string;
-        visible: boolean;
-    }>;
-    private readonly _onDidChangeViewContainerVisibility;
-    readonly onDidChangeViewContainerVisibility: Event<{
-        id: string;
-        visible: boolean;
-        location: ViewContainerLocation;
-    }>;
-    private readonly _onDidChangeFocusedView;
-    readonly onDidChangeFocusedView: Event<void>;
-    private readonly viewContainerDisposables;
-    private readonly enabledViewContainersContextKeys;
-    private readonly visibleViewContextKeys;
-    private readonly focusedViewContextKey;
-    constructor(viewDescriptorService: IViewDescriptorService, paneCompositeService: IPaneCompositePartService, contextKeyService: IContextKeyService, layoutService: IWorkbenchLayoutService, editorService: IEditorService);
-    private onViewsAdded;
-    private onViewsVisibilityChanged;
-    private onViewsRemoved;
-    private getOrCreateActiveViewContextKey;
-    private onDidChangeContainers;
-    private onDidRegisterViewContainer;
-    private onDidDeregisterViewContainer;
-    private onDidChangeContainerLocation;
-    private onViewDescriptorsAdded;
-    private onViewDescriptorsRemoved;
-    private updateViewContainerEnablementContextKey;
-    private openComposite;
-    private getComposite;
-    isViewContainerVisible(id: string): boolean;
-    isViewContainerActive(id: string): boolean;
-    getVisibleViewContainer(location: ViewContainerLocation): ViewContainer | null;
-    getActiveViewPaneContainerWithId(viewContainerId: string): IViewPaneContainer | null;
-    openViewContainer(id: string, focus?: boolean): Promise<IPaneComposite | null>;
-    closeViewContainer(id: string): Promise<void>;
-    isViewVisible(id: string): boolean;
-    getActiveViewWithId<T extends IView>(id: string): T | null;
-    getViewWithId<T extends IView>(id: string): T | null;
-    getFocusedView(): IViewDescriptor | null;
-    getFocusedViewName(): string;
-    openView<T extends IView>(id: string, focus?: boolean): Promise<T | null>;
-    closeView(id: string): void;
-    private getActiveViewPaneContainer;
-    getViewProgressIndicator(viewId: string): IProgressIndicator | undefined;
-    private getViewContainerProgressIndicator;
-    private registerOpenViewContainerAction;
-    private registerOpenViewAction;
-    private registerFocusViewAction;
-    private registerResetViewLocationAction;
-    private registerPaneComposite;
-    private deregisterPaneComposite;
-    private createViewPaneContainer;
-}
-export declare function getPartByLocation(viewContainerLocation: ViewContainerLocation): Parts.AUXILIARYBAR_PART | Parts.SIDEBAR_PART | Parts.PANEL_PART;