@codingame/monaco-vscode-api 20.1.1 → 20.2.1

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

@@ -3,9 +3,25 @@ import { IDisposable } from "../../../base/common/lifecycle.js";
 import { URI } from "../../../base/common/uri.js";
 import { IEditorOptions, ITextEditorSelection } from "../../editor/common/editor.js";
 export type OpenInternalOptions = {
+    /**
+     * Signals that the intent is to open an editor to the side
+     * of the currently active editor.
+     */
     readonly openToSide?: boolean;
+    /**
+     * Extra editor options to apply in case an editor is used to open.
+     */
     readonly editorOptions?: IEditorOptions;
+    /**
+     * Signals that the editor to open was triggered through a user
+     * action, such as keyboard or mouse usage.
+     */
     readonly fromUserGesture?: boolean;
+    /**
+     * Allow command links to be handled.
+     *
+     * If this is an array, then only the commands included in the array can be run.
+     */
     readonly allowCommands?: boolean | readonly string[];
 };
 export type OpenExternalOptions = {
@@ -41,7 +57,24 @@ export interface IExternalUriResolver {
         dispose(): void;
     } | undefined>;
 }
+/**
+ * Encodes selection into the `URI`.
+ *
+ * IMPORTANT: you MUST use `extractSelection` to separate the selection
+ * again from the original `URI` before passing the `URI` into any
+ * component that is not aware of selections.
+ */
 export declare function withSelection(uri: URI, selection: ITextEditorSelection): URI;
+/**
+ * file:///some/file.js#73
+ * file:///some/file.js#L73
+ * file:///some/file.js#73,84
+ * file:///some/file.js#L73,84
+ * file:///some/file.js#73-83
+ * file:///some/file.js#L73-L83
+ * file:///some/file.js#73,84-83,52
+ * file:///some/file.js#L73,84-L83,52
+ */
 export declare function extractSelection(uri: URI): {
     selection: ITextEditorSelection | undefined;
     uri: URI;

package/vscode/src/vs/platform/opener/common/opener.service.d.ts

@@ -4,11 +4,38 @@ import { IOpener, IValidator, IExternalUriResolver, IExternalOpener, OpenInterna
 export declare const IOpenerService: import("../../instantiation/common/instantiation.js").ServiceIdentifier<IOpenerService>;
 export interface IOpenerService {
     readonly _serviceBrand: undefined;
+    /**
+    * Register a participant that can handle the open() call.
+    */
     registerOpener(opener: IOpener): IDisposable;
+    /**
+    * Register a participant that can validate if the URI resource be opened.
+    * Validators are run before openers.
+    */
     registerValidator(validator: IValidator): IDisposable;
+    /**
+    * Register a participant that can resolve an external URI resource to be opened.
+    */
     registerExternalUriResolver(resolver: IExternalUriResolver): IDisposable;
+    /**
+    * Sets the handler for opening externally. If not provided,
+    * a default handler will be used.
+    */
     setDefaultExternalOpener(opener: IExternalOpener): void;
+    /**
+    * Registers a new opener external resources openers.
+    */
     registerExternalOpener(opener: IExternalOpener): IDisposable;
+    /**
+    * Opens a resource, like a webaddress, a document uri, or executes command.
+    *
+    * @param resource A resource
+    * @return A promise that resolves when the opening is done.
+    */
     open(resource: URI | string, options?: OpenInternalOptions | OpenExternalOptions): Promise<boolean>;
+    /**
+    * Resolve a resource to its external form.
+    * @throws whenever resolvers couldn't resolve this resource externally.
+    */
     resolveExternalUri(resource: URI, options?: ResolveExternalUriOptions): Promise<IResolvedExternalUri>;
 }

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

@@ -1,3 +1,8 @@
 import { IProductConfiguration } from "../../../base/common/product.js";
+/**
+ * @deprecated It is preferred that you use `IProductService` if you can. This
+ * allows web embedders to override our defaults. But for things like `product.quality`,
+ * the use is fine because that property is not overridable.
+ */
 declare let product: IProductConfiguration;
 export default product;

package/vscode/src/vs/platform/product/common/product.js

@@ -6,7 +6,7 @@ var product = {
   quality: 'stable',
   version: '1.103.1',
   commit: '360a4e4fd251bfce169a4ddf857c7d25d1ad40da',
-  date: '2025-08-14T13:28:09.738Z',
+  date: '2025-08-18T13:21:50.332Z',
   ...(globalThis._VSCODE_PRODUCT_JSON ?? {})
 };
 

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

@@ -4,8 +4,15 @@ import { Disposable } from "../../../base/common/lifecycle.js";
 import { INotificationSource, NotificationPriority } from "../../notification/common/notification.js";
 import { IProgressService } from "./progress.service.js";
 export interface IProgressIndicator {
+    /**
+     * Show progress customized with the provided flags.
+     */
     show(infinite: true, delay?: number): IProgressRunner;
     show(total: number, delay?: number): IProgressRunner;
+    /**
+     * Indicate progress for the duration of the provided promise. Progress will stop in
+     * any case of promise completion, error or cancellation.
+     */
     showWhile(promise: Promise<unknown>, delay?: number): Promise<void>;
 }
 export declare enum ProgressLocation {
@@ -80,12 +87,20 @@ export declare class AsyncProgress<T> implements IProgress<T> {
     private _processAsyncQueue;
     drain(): Promise<void>;
 }
+/**
+ * A helper to show progress during a long running operation. If the operation
+ * is started multiple times, only the last invocation will drive the progress.
+ */
 export interface IOperation {
     id: number;
     isCurrent: () => boolean;
     token: CancellationToken;
     stop(): void;
 }
+/**
+ * RAII-style progress instance that allows imperative reporting and hides
+ * once `dispose()` is called.
+ */
 export declare class UnmanagedProgress extends Disposable {
     private readonly deferred;
     private reporter?;

package/vscode/src/vs/platform/progress/common/progress.service.d.ts

@@ -1,10 +1,16 @@
 import { IProgressOptions, IProgressDialogOptions, IProgressNotificationOptions, IProgressWindowOptions, IProgressCompositeOptions, IProgress, IProgressStep, type IProgressIndicator } from "./progress.js";
 export declare const IProgressService: import("../../instantiation/common/instantiation.js").ServiceIdentifier<IProgressService>;
+/**
+* A progress service that can be used to report progress to various locations of the UI.
+*/
 export interface IProgressService {
     readonly _serviceBrand: undefined;
     withProgress<R>(options: IProgressOptions | IProgressDialogOptions | IProgressNotificationOptions | IProgressWindowOptions | IProgressCompositeOptions, task: (progress: IProgress<IProgressStep>) => Promise<R>, onDidCancel?: (choice?: number) => void): Promise<R>;
 }
 export declare const IEditorProgressService: import("../../instantiation/common/instantiation.js").ServiceIdentifier<IEditorProgressService>;
+/**
+* A progress service that will report progress local to the editor triggered from.
+*/
 export interface IEditorProgressService extends IProgressIndicator {
     readonly _serviceBrand: undefined;
 }

package/vscode/src/vs/platform/quickinput/browser/media/quickInput.css

@@ -1,3 +1,8 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .quick-input-widget {
 	position: absolute;
 	width: 600px;
@@ -6,6 +11,7 @@
 	-webkit-app-region: no-drag;
 	border-radius: 6px;
 }
+
 .quick-input-titlebar {
 	cursor: grab;
 	display: flex;
@@ -13,17 +19,23 @@
 	border-top-right-radius: 5px;
 	border-top-left-radius: 5px;
 }
+
 .quick-input-left-action-bar {
 	display: flex;
 	margin-left: 4px;
 	flex: 1;
 }
+
+/* give some space between input and action bar */
 .quick-input-inline-action-bar > .actions-container > .action-item:first-child {
 	margin-left: 5px;
 }
+
+/* center horizontally */
 .quick-input-inline-action-bar > .actions-container > .action-item {
 	margin-top: 2px;
 }
+
 .quick-input-title {
 	cursor: grab;
 	padding: 3px 0px;
@@ -31,35 +43,44 @@
 	text-overflow: ellipsis;
 	overflow: hidden;
 }
+
 .quick-input-right-action-bar {
 	display: flex;
 	margin-right: 4px;
 	flex: 1;
 }
+
 .quick-input-right-action-bar > .actions-container {
 	justify-content: flex-end;
 }
+
 .quick-input-titlebar .monaco-action-bar .action-label.codicon {
 	background-position: center;
 	background-repeat: no-repeat;
 	padding: 2px;
 }
+
 .quick-input-description {
 	margin: 6px 6px 6px 11px;
 }
+
 .quick-input-header .quick-input-description {
 	margin: 4px 2px;
 	flex: 1;
 }
+
 .quick-input-header {
 	cursor: grab;
 	display: flex;
 	padding: 6px 6px 2px 6px;
 }
+
 .quick-input-widget.hidden-input .quick-input-header {
+	/* reduce margins and paddings when input box hidden */
 	padding: 0;
 	margin-bottom: 0;
 }
+
 .quick-input-and-message {
 	display: flex;
 	flex-direction: column;
@@ -67,26 +88,32 @@
 	min-width: 0;
 	position: relative;
 }
+
 .quick-input-check-all {
 	align-self: center;
 	margin: 0;
 }
+
 .quick-input-filter {
 	flex-grow: 1;
 	display: flex;
 	position: relative;
 }
+
 .quick-input-box {
 	flex-grow: 1;
 }
+
 .quick-input-widget.show-checkboxes .quick-input-box,
 .quick-input-widget.show-checkboxes .quick-input-message {
 	margin-left: 5px;
 }
+
 .quick-input-visible-count {
 	position: absolute;
 	left: -10000px;
 }
+
 .quick-input-count {
 	align-self: center;
 	position: absolute;
@@ -94,6 +121,7 @@
 	display: flex;
 	align-items: center;
 }
+
 .quick-input-count .monaco-count-badge {
 	vertical-align: middle;
 	padding: 2px 4px;
@@ -101,9 +129,11 @@
 	min-height: auto;
 	line-height: normal;
 }
+
 .quick-input-action {
 	margin-left: 6px;
 }
+
 .quick-input-action .monaco-text-button {
 	font-size: 11px;
 	padding: 0 6px;
@@ -111,65 +141,83 @@
 	height: 25px;
 	align-items: center;
 }
+
 .quick-input-message {
 	margin-top: -1px;
 	padding: 5px;
 	overflow-wrap: break-word;
 }
+
 .quick-input-message > .codicon {
 	margin: 0 0.2em;
 	vertical-align: text-bottom;
 }
+
+/* Links in descriptions & validations */
 .quick-input-message a {
 	color: inherit;
 }
+
 .quick-input-progress.monaco-progress-container {
 	position: relative;
 }
+
 .quick-input-list {
 	line-height: 22px;
 }
+
 .quick-input-widget.hidden-input .quick-input-list {
 	margin-top: 4px;
+	/* reduce margins when input box hidden */
 	padding-bottom: 4px;
 }
+
 .quick-input-list .monaco-list {
 	overflow: hidden;
 	max-height: calc(20 * 22px);
 	padding-bottom: 5px;
 }
+
 .quick-input-list .monaco-scrollable-element {
 	padding: 0px 6px;
 }
+
 .quick-input-list .quick-input-list-entry {
 	box-sizing: border-box;
 	overflow: hidden;
 	display: flex;
 	padding: 0 6px;
 }
+
 .quick-input-list .quick-input-list-entry.indented {
 	padding-left: 1.3em;
 }
+
 .quick-input-list .quick-input-list-entry.quick-input-list-separator-border {
 	border-top-width: 1px;
 	border-top-style: solid;
 }
+
 .quick-input-list .monaco-list-row {
 	border-radius: 3px;
 }
+
 .quick-input-list .monaco-list-row[data-index="0"] .quick-input-list-entry.quick-input-list-separator-border {
 	border-top-style: none;
 }
+
 .quick-input-list .quick-input-list-label {
 	overflow: hidden;
 	display: flex;
 	height: 100%;
 	flex: 1;
 }
+
 .quick-input-widget .monaco-checkbox {
 	margin-right: 0;
 	align-self: center;
 }
+
 .quick-input-list .quick-input-list-icon {
 	background-size: 16px;
 	background-position: left center;
@@ -181,6 +229,7 @@
 	align-items: center;
 	justify-content: center;
 }
+
 .quick-input-list .quick-input-list-rows {
 	overflow: hidden;
 	text-overflow: ellipsis;
@@ -190,58 +239,83 @@
 	flex: 1;
 	margin-left: 5px;
 }
+
 .quick-input-list .quick-input-list-rows > .quick-input-list-row {
 	display: flex;
 	align-items: center;
 }
+
 .quick-input-list .quick-input-list-rows > .quick-input-list-row .monaco-icon-label,
 .quick-input-list .quick-input-list-rows > .quick-input-list-row .monaco-icon-label .monaco-icon-label-container > .monaco-icon-name-container {
 	flex: 1;
+	/* make sure the icon label grows within the row */
 }
+
 .quick-input-list .quick-input-list-rows > .quick-input-list-row .codicon[class*='codicon-'] {
 	vertical-align: text-bottom;
 }
+
 .quick-input-list .quick-input-list-rows .monaco-highlighted-label > span {
 	opacity: 1;
 }
+
 .quick-input-list .quick-input-list-entry .quick-input-list-entry-keybinding {
 	margin-right: 8px;
+	/* separate from the separator label or scrollbar if any */
 }
+
 .quick-input-list .quick-input-list-label-meta {
 	opacity: 0.7;
 	line-height: normal;
 	text-overflow: ellipsis;
 	overflow: hidden;
 }
+
+/* preserve list-like styling instead of tree-like styling */
 .quick-input-list .monaco-list .monaco-list-row .monaco-highlighted-label .highlight {
 	font-weight: bold;
 	background-color: unset;
 	color: var(--vscode-list-highlightForeground) !important;
 }
+
+/* preserve list-like styling instead of tree-like styling */
 .quick-input-list .monaco-list .monaco-list-row.focused .monaco-highlighted-label .highlight {
 	color: var(--vscode-list-focusHighlightForeground) !important;
 }
+
 .quick-input-list .quick-input-list-entry .quick-input-list-separator {
 	margin-right: 4px;
+	/* separate from keybindings or actions */
 }
+
 .quick-input-list .quick-input-list-entry-action-bar {
 	display: flex;
 	flex: 0;
 	overflow: visible;
 }
+
 .quick-input-list .quick-input-list-entry-action-bar .action-label {
+	/*
+	 * By default, actions in the quick input action bar are hidden
+	 * until hovered over them or selected.
+	 */
 	display: none;
 }
+
 .quick-input-list .quick-input-list-entry-action-bar .action-label.codicon {
 	margin-right: 4px;
 	padding: 2px;
 }
+
 .quick-input-list .quick-input-list-entry-action-bar {
 	margin-top: 1px;
 }
+
 .quick-input-list .quick-input-list-entry-action-bar {
 	margin-right: 4px;
+	/* separate from scrollbar */
 }
+
 .quick-input-list .quick-input-list-entry .quick-input-list-entry-action-bar .action-label.always-visible,
 .quick-input-list .quick-input-list-entry:hover .quick-input-list-entry-action-bar .action-label,
 .quick-input-list .quick-input-list-entry.focus-inside .quick-input-list-entry-action-bar .action-label,
@@ -249,56 +323,78 @@
 .quick-input-list .monaco-list-row.passive-focused .quick-input-list-entry-action-bar .action-label {
 	display: flex;
 }
+
 .quick-input-list > .monaco-list:focus .monaco-list-row.focused {
 	outline: 1px solid var(--vscode-list-focusOutline) !important;
 	outline-offset: -1px;
 }
+
 .quick-input-list > .monaco-list:focus .monaco-list-row.focused .quick-input-list-entry.quick-input-list-separator-border {
 	border-color: transparent;
 }
+
+/* focused items in quick pick */
 .quick-input-list .monaco-list-row.focused .monaco-keybinding-key,
 .quick-input-list .monaco-list-row.focused .quick-input-list-entry .quick-input-list-separator {
 	color: inherit
 }
+
 .quick-input-list .monaco-list-row.focused .monaco-keybinding-key {
 	background: none;
 }
+
 .quick-input-list .quick-input-list-separator-as-item {
 	padding: 4px 6px;
 	font-size: 12px;
 }
+
+/* Quick input separators as full-row item */
 .quick-input-list .quick-input-list-separator-as-item .label-name {
 	font-weight: 600;
 }
+
 .quick-input-list .quick-input-list-separator-as-item .label-description {
+	/* Override default description opacity so we don't have a contrast ratio issue. */
 	opacity: 1 !important;
 }
+
+/* Hide border when the item becomes the sticky one */
 .quick-input-list .monaco-tree-sticky-row .quick-input-list-entry.quick-input-list-separator-as-item.quick-input-list-separator-border {
 	border-top-style: none;
 }
+
+/* Give sticky row the same padding as the scrollable list */
 .quick-input-list .monaco-tree-sticky-row {
 	padding: 0 5px;
 }
+
+/* Hide the twistie containers so that there isn't blank indent */
 .quick-input-list .monaco-tl-twistie {
 	display: none !important;
 }
+
+/* Tree */
+
 .quick-input-tree .monaco-list {
 	overflow: hidden;
 	max-height: calc(20 * 22px);
 	padding-bottom: 5px;
 }
+
 .quick-input-tree .quick-input-tree-entry {
 	box-sizing: border-box;
 	overflow: hidden;
 	display: flex;
 	padding: 0 6px;
 }
+
 .quick-input-tree .quick-input-tree-label {
 	overflow: hidden;
 	display: flex;
 	height: 100%;
 	flex: 1;
 }
+
 .quick-input-tree .quick-input-tree-icon {
 	background-size: 16px;
 	background-position: left center;
@@ -310,6 +406,7 @@
 	align-items: center;
 	justify-content: center;
 }
+
 .quick-input-tree .quick-input-tree-rows {
 	overflow: hidden;
 	text-overflow: ellipsis;
@@ -319,44 +416,61 @@
 	flex: 1;
 	margin-left: 5px;
 }
+
 .quick-input-tree .quick-input-tree-rows > .quick-input-tree-row {
 	display: flex;
 	align-items: center;
 }
+
 .quick-input-tree .quick-input-tree-rows > .quick-input-tree-row .monaco-icon-label,
 .quick-input-tree .quick-input-tree-rows > .quick-input-tree-row .monaco-icon-label .monaco-icon-label-container > .monaco-icon-name-container {
 	flex: 1;
+	/* make sure the icon label grows within the row */
 }
+
 .quick-input-tree .quick-input-tree-rows > .quick-input-tree-row .codicon[class*='codicon-'] {
 	vertical-align: text-bottom;
 }
+
 .quick-input-tree .quick-input-tree-rows .monaco-highlighted-label > span {
 	opacity: 1;
 }
+
 .quick-input-tree .quick-input-tree-detail {
 	opacity: 0.7;
 	line-height: normal;
 	text-overflow: ellipsis;
 	overflow: hidden;
 }
+
 .quick-input-tree .quick-input-tree-entry-action-bar {
 	display: flex;
 	flex: 0;
 	overflow: visible;
 }
+
 .quick-input-tree .quick-input-tree-entry-action-bar .action-label {
+	/*
+	 * By default, actions in the quick input action bar are hidden
+	 * until hovered over them or selected.
+	 */
 	display: none;
 }
+
 .quick-input-tree .quick-input-tree-entry-action-bar .action-label.codicon {
 	margin-right: 4px;
 	padding: 2px;
 }
+
 .quick-input-tree .quick-input-tree-entry-action-bar {
 	margin-top: 1px;
 }
+
 .quick-input-tree .quick-input-tree-entry-action-bar {
 	margin-right: 4px;
+	/* separate from scrollbar */
 }
+
 .quick-input-tree .quick-input-tree-entry .quick-input-tree-entry-action-bar .action-label.always-visible,
 .quick-input-tree .quick-input-tree-entry:hover .quick-input-tree-entry-action-bar .action-label,
 .quick-input-tree .quick-input-tree-entry.focus-inside .quick-input-tree-entry-action-bar .action-label,
@@ -364,6 +478,7 @@
 .quick-input-tree .monaco-list-row.passive-focused .quick-input-tree-entry-action-bar .action-label {
 	display: flex;
 }
+
 .quick-input-tree > .monaco-list:focus .monaco-list-row.focused {
 	outline: 1px solid var(--vscode-list-focusOutline) !important;
 	outline-offset: -1px;

package/vscode/src/vs/platform/quickinput/browser/quickInput.d.ts

@@ -36,6 +36,10 @@ export interface IQuickInputOptions {
     setContextKey(id?: string): void;
     linkOpenerDelegate(content: string): void;
     returnFocus(): void;
+    /**
+     * @todo With IHover in vs/editor, can we depend on the service directly
+     * instead of passing it through a hover delegate?
+     */
     hoverDelegate: IHoverDelegate;
     styles: IQuickInputStyles;
 }

package/vscode/src/vs/platform/quickinput/browser/quickInputList.d.ts

@@ -12,8 +12,14 @@ export declare class QuickInputList extends Disposable {
     private linkOpenerDelegate;
     private readonly accessibilityService;
     private readonly _onKeyDown;
+    /**
+     * Event that is fired when the tree receives a keydown.
+    */
     readonly onKeyDown: Event<StandardKeyboardEvent>;
     private readonly _onLeave;
+    /**
+     * Event that is fired when the tree would no longer have focus.
+    */
     readonly onLeave: Event<void>;
     private readonly _visibleCountObservable;
     onChangedVisibleCount: Event<number>;
@@ -82,6 +88,10 @@ export declare class QuickInputList extends Disposable {
     private _registerOnElementChecked;
     private _registerOnContextMenu;
     private _registerHoverListeners;
+    /**
+     * Register's focus change and mouse events so that we can track when items inside of a
+     * separator's section are focused or hovered so that we can display the separator's actions
+     */
     private _registerSeparatorActionShowingListeners;
     private _registerSelectionChangeListener;
     setAllVisibleChecked(checked: boolean): void;
@@ -102,5 +112,9 @@ export declare class QuickInputList extends Disposable {
     private _setElementsToTree;
     private _allVisibleChecked;
     private _updateCheckedObservables;
+    /**
+     * Disposes of the hover and shows a new one for the given index if it has a tooltip.
+     * @param element The element to show the hover for
+     */
     private showHover;
 }

package/vscode/src/vs/platform/quickinput/browser/tree/quickInputDelegate.d.ts

@@ -1,5 +1,8 @@
 import { IListVirtualDelegate } from "../../../../base/browser/ui/list/list.js";
 import { IQuickTreeItem } from "../../common/quickInput.js";
+/**
+ * Delegate for QuickInputTree that provides height and template information.
+ */
 export declare class QuickInputTreeDelegate<T extends IQuickTreeItem> implements IListVirtualDelegate<T> {
     getHeight(element: T): number;
     getTemplateId(_element: T): string;

package/vscode/src/vs/platform/quickinput/browser/tree/quickInputTreeAccessibilityProvider.d.ts

@@ -2,6 +2,9 @@ import { AriaRole } from "../../../../base/browser/ui/aria/aria.js";
 import { IListAccessibilityProvider } from "../../../../base/browser/ui/list/listWidget.js";
 import { Event, IValueWithChangeEvent } from "../../../../base/common/event.js";
 import { IQuickTreeCheckboxEvent, IQuickTreeItem } from "../../common/quickInput.js";
+/**
+ * Accessibility provider for QuickTree.
+ */
 export declare class QuickTreeAccessibilityProvider<T extends IQuickTreeItem> implements IListAccessibilityProvider<T> {
     private readonly onCheckedEvent;
     constructor(onCheckedEvent: Event<IQuickTreeCheckboxEvent<T>>);