@codingame/monaco-vscode-api 20.1.1 → 20.2.0

package/vscode/src/vs/editor/contrib/inlineCompletions/browser/view/inlineEdits/view.css

@@ -1,36 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/*
+	@keyframes blink { 50% { border-color: orange; }  }
+*/
+
 .monaco-editor {
 	.inline-edits-view-indicator {
 		display: flex;
-		z-index: 34;
+
+		z-index: 34; /* Below the find widget */
 		height: 20px;
+
 		color: var(--vscode-inlineEdit-gutterIndicator-primaryForeground);
 		background-color: var(--vscode-inlineEdit-gutterIndicator-background);
 		border: 1px solid var(--vscode-inlineEdit-gutterIndicator-primaryBorder);
 		border-radius: 3px;
+
 		align-items: center;
 		padding: 2px;
 		padding-right: 10px;
 		margin: 0 4px;
+
+		/*
+		animation: blink 1s;
+		animation-iteration-count: 3;
+		*/
+
 		opacity: 0;
+
 		&.contained {
 			transition: opacity 0.2s ease-in-out;
 			transition-delay: 0.4s;
 		}
+
 		&.visible {
 			opacity: 1;
 		}
+
 		&.top {
 			opacity: 1;
+
 			.icon {
 				transform: rotate(90deg);
 			}
 		}
+
 		&.bottom {
 			opacity: 1;
+
 			.icon {
 				transform: rotate(-90deg);
 			}
 		}
+
 		.icon {
 			display: flex;
 			align-items: center;
@@ -41,85 +66,107 @@
 				color: var(--vscode-inlineEdit-gutterIndicator-primaryForeground);
 			}
 		}
+
 		.label {
 			margin: 0 2px;
+
 			display: flex;
 			justify-content: center;
 			width: 100%;
 		}
 	}
+
 	.inline-edits-view .editorContainer {
 		.preview .monaco-editor {
 			.view-overlays .current-line-exact {
 				border: none;
 			}
+
 			.current-line-margin {
 				border: none;
 			}
 		}
+
 		.inline-edits-view-zone.diagonal-fill {
 			opacity: 0.5;
 		}
 	}
+
 	.strike-through {
 		text-decoration: line-through;
 	}
+
 	.inlineCompletions-line-insert {
 		background: var(--vscode-inlineEdit-modifiedChangedLineBackground);
 	}
+
 	.inlineCompletions-line-delete {
 		background: var(--vscode-inlineEdit-originalChangedLineBackground);
 	}
+
 	.inlineCompletions-char-insert {
 		background: var(--vscode-inlineEdit-modifiedChangedTextBackground);
 		cursor: pointer;
 	}
+
 	.inlineCompletions-char-delete {
 		background: var(--vscode-inlineEdit-originalChangedTextBackground);
 	}
+
 	.inlineCompletions-char-delete.diff-range-empty {
 		margin-left: -1px;
 		border-left: solid var(--vscode-inlineEdit-originalChangedTextBackground) 3px;
 	}
+
 	.inlineCompletions-char-insert.diff-range-empty {
 		border-left: solid var(--vscode-inlineEdit-modifiedChangedTextBackground) 3px;
 	}
-	.inlineCompletions-char-delete.single-line-inline {
+
+	.inlineCompletions-char-delete.single-line-inline { /* Editor Decoration */
 		border: 1px solid var(--vscode-editorHoverWidget-border);
 		margin: -2px 0 0 -2px;
 	}
-	.inlineCompletions-char-insert.single-line-inline {
-		border-top: 1px solid var(--vscode-inlineEdit-modifiedBorder);
-		border-bottom: 1px solid var(--vscode-inlineEdit-modifiedBorder);
+
+	.inlineCompletions-char-insert.single-line-inline { /* Inline Decoration */
+		border-top: 1px solid var(--vscode-inlineEdit-modifiedBorder); /* TODO: Do not set border inline but create overlaywidget (like deletion view) */
+		border-bottom: 1px solid var(--vscode-inlineEdit-modifiedBorder); /* TODO: Do not set border inline but create overlaywidget (like deletion view) */
 	}
 	.inlineCompletions-char-insert.single-line-inline.start {
 		border-top-left-radius: 4px;
 		border-bottom-left-radius: 4px;
-		border-left: 1px solid var(--vscode-inlineEdit-modifiedBorder);
+		border-left: 1px solid var(--vscode-inlineEdit-modifiedBorder); /* TODO: Do not set border inline but create overlaywidget (like deletion view) */
 	}
 	.inlineCompletions-char-insert.single-line-inline.end {
 		border-top-right-radius: 4px;
 		border-bottom-right-radius: 4px;
-		border-right: 1px solid var(--vscode-inlineEdit-modifiedBorder);
+		border-right: 1px solid var(--vscode-inlineEdit-modifiedBorder); /* TODO: Do not set border inline but create overlaywidget (like deletion view) */
 	}
+
 	.inlineCompletions-char-delete.single-line-inline.empty,
 	.inlineCompletions-char-insert.single-line-inline.empty {
 		display: none;
 	}
+
 	.inlineCompletions.strike-through {
 		text-decoration-thickness: 1px;
 	}
+
+	/* line replacement bubbles */
+
 	.inlineCompletions-modified-bubble {
 		background: var(--vscode-inlineEdit-modifiedChangedTextBackground);
 	}
+
 	.inlineCompletions-original-bubble {
 		background: var(--vscode-inlineEdit-originalChangedTextBackground);
 	}
+
 	.inlineCompletions-modified-bubble,
 	.inlineCompletions-original-bubble {
 		pointer-events: none;
 		display: inline-block;
 	}
+
 	.inline-edit.ghost-text,
 	.inline-edit.ghost-text-decoration,
 	.inline-edit.ghost-text-decoration-preview,
@@ -129,6 +176,7 @@
 		}
 		font-style: normal !important;
 	}
+
 	.inline-edit.modified-background.ghost-text,
 	.inline-edit.modified-background.ghost-text-decoration,
 	.inline-edit.modified-background.ghost-text-decoration-preview,
@@ -136,10 +184,12 @@
 		background: var(--vscode-inlineEdit-modifiedChangedTextBackground) !important;
 		display: inline-block !important;
 	}
+
 	.inlineCompletions-original-lines {
 		background: var(--vscode-editor-background);
 	}
 }
+
 .monaco-menu-option {
 	color: var(--vscode-editorActionList-foreground);
 	font-size: 13px;
@@ -150,6 +200,7 @@
 	align-items: center;
 	border-radius: 4px;
 	cursor: pointer;
+
 	&.active {
 		background: var(--vscode-editorActionList-focusBackground);
 		color: var(--vscode-editorActionList-focusForeground);

package/vscode/src/vs/editor/contrib/inlineProgress/browser/inlineProgress.d.ts

@@ -9,6 +9,7 @@ export declare class InlineProgressManager extends Disposable {
     private readonly id;
     private readonly _editor;
     private readonly _instantiationService;
+    /** Delay before showing the progress widget */
     private readonly _showDelay;
     private readonly _showPromise;
     private readonly _currentDecorations;

package/vscode/src/vs/editor/contrib/inlineProgress/browser/inlineProgressWidget.css

@@ -1,20 +1,29 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .inline-editor-progress-decoration {
 	display: inline-block;
 	width: 1em;
 	height: 1em;
 }
+
 .inline-progress-widget  {
 	display: flex !important;
 	justify-content: center;
 	align-items: center;
 }
+
 .inline-progress-widget .icon {
 	font-size: 80% !important;
 }
+
 .inline-progress-widget:hover .icon {
 	font-size: 90% !important;
 	animation: none;
 }
+
 .inline-progress-widget:hover .icon::before {
 	content: var(--vscode-icon-x-content);
 	font-family: var(--vscode-icon-x-font-family);

package/vscode/src/vs/editor/contrib/insertFinalNewLine/browser/insertFinalNewLineCommand.d.ts

@@ -9,4 +9,8 @@ export declare class InsertFinalNewLineCommand implements ICommand {
     getEditOperations(model: ITextModel, builder: IEditOperationBuilder): void;
     computeCursorState(model: ITextModel, helper: ICursorStateComputerData): Selection;
 }
+/**
+ * Generate edit operations for inserting a final new line if needed.
+ * Returns undefined if no edit is needed.
+ */
 export declare function insertFinalNewLine(model: ITextModel): ISingleEditOperation | undefined;

package/vscode/src/vs/editor/contrib/linesOperations/browser/linesOperations.d.ts

@@ -49,6 +49,9 @@ export declare class InsertLineAfterAction extends EditorAction {
 }
 export declare abstract class AbstractDeleteAllToBoundaryAction extends EditorAction {
     run(_accessor: ServicesAccessor, editor: ICodeEditor): void;
+    /**
+     * Compute the cursor state after the edit operations were applied.
+     */
     protected abstract _getEndCursorState(primaryCursor: Range, rangesToDelete: Range[]): Selection[];
     protected abstract _getRangesToDelete(editor: IActiveCodeEditor): Range[];
 }

package/vscode/src/vs/editor/contrib/linesOperations/browser/moveLinesCommand.d.ts

@@ -15,6 +15,15 @@ export declare class MoveLinesCommand implements ICommand {
     getEditOperations(model: ITextModel, builder: IEditOperationBuilder): void;
     private buildIndentConverter;
     private parseEnterResult;
+    /**
+     *
+     * @param model
+     * @param indentConverter
+     * @param tabSize
+     * @param line the line moving down
+     * @param futureAboveLineNumber the line which will be at the `line` position
+     * @param futureAboveLineText
+     */
     private matchEnterRuleMovingDown;
     private matchEnterRule;
     private trimStart;

package/vscode/src/vs/editor/contrib/linkedEditing/browser/linkedEditing.css

@@ -1,4 +1,11 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor .linked-editing-decoration {
 	background-color: var(--vscode-editor-linkedEditingBackground);
+
+	/* Ensure decoration is visible even if range is empty */
 	min-width: 1px;
 }

package/vscode/src/vs/editor/contrib/links/browser/links.css

@@ -1,8 +1,13 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
 .monaco-editor .detected-link,
 .monaco-editor .detected-link-active {
 	text-decoration: underline;
 	text-underline-position: under;
 }
+
 .monaco-editor .detected-link-active {
 	cursor: pointer;
 	color: var(--vscode-editorLink-activeForeground) !important;

package/vscode/src/vs/editor/contrib/message/browser/messageController.css

@@ -1,12 +1,19 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor .monaco-editor-overlaymessage {
 	padding-bottom: 8px;
 	z-index: 10000;
 }
+
 .monaco-editor .monaco-editor-overlaymessage.below {
 	padding-bottom: 0;
 	padding-top: 8px;
 	z-index: 10000;
 }
+
 @keyframes fadeIn {
 	from { opacity: 0; }
 	to { opacity: 1; }
@@ -14,6 +21,7 @@
 .monaco-editor .monaco-editor-overlaymessage.fadeIn {
 	animation: fadeIn 150ms ease-out;
 }
+
 @keyframes fadeOut {
 	from { opacity: 1; }
 	to { opacity: 0; }
@@ -21,6 +29,7 @@
 .monaco-editor .monaco-editor-overlaymessage.fadeOut {
 	animation: fadeOut 100ms ease-out;
 }
+
 .monaco-editor .monaco-editor-overlaymessage .message {
 	padding: 2px 4px;
 	color: var(--vscode-editorHoverWidget-foreground);
@@ -28,19 +37,24 @@
 	border: 1px solid var(--vscode-inputValidation-infoBorder);
 	border-radius: 3px;
 }
+
 .monaco-editor .monaco-editor-overlaymessage .message p {
 	margin-block: 0px;
 }
+
 .monaco-editor .monaco-editor-overlaymessage .message a {
 	color: var(--vscode-textLink-foreground);
 }
+
 .monaco-editor .monaco-editor-overlaymessage .message a:hover {
 	color: var(--vscode-textLink-activeForeground);
 }
+
 .monaco-editor.hc-black .monaco-editor-overlaymessage .message,
 .monaco-editor.hc-light .monaco-editor-overlaymessage .message {
 	border-width: 2px;
 }
+
 .monaco-editor .monaco-editor-overlaymessage .anchor {
 	width: 0 !important;
 	height: 0 !important;
@@ -51,16 +65,20 @@
 	position: absolute;
 	left: 2px;
 }
+
 .monaco-editor .monaco-editor-overlaymessage .anchor.top {
 	border-bottom-color: var(--vscode-inputValidation-infoBorder);
 }
+
 .monaco-editor .monaco-editor-overlaymessage .anchor.below {
 	border-top-color: var(--vscode-inputValidation-infoBorder);
 }
+
 .monaco-editor .monaco-editor-overlaymessage:not(.below) .anchor.top,
 .monaco-editor .monaco-editor-overlaymessage.below .anchor.below {
 	display: none;
 }
+
 .monaco-editor .monaco-editor-overlaymessage.below .anchor.top {
 	display: inherit;
 	top: -8px;

package/vscode/src/vs/editor/contrib/middleScroll/browser/middleScroll.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.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor {
 	.scroll-editor-on-middle-click-dot {
 		cursor: all-scroll;
@@ -10,10 +15,12 @@
 		height: 5px;
 		border-radius: 50%;
 		transform: translate(-50%, -50%);
+
 		&.hidden {
 			display: none;
 		}
 	}
+
 	&.scroll-editor-on-middle-click-editor * {
 		cursor: all-scroll;
 	}

package/vscode/src/vs/editor/contrib/parameterHints/browser/parameterHints.css

@@ -1,4 +1,10 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor .parameter-hints-widget {
+	/* Must be higher than the sash's z-index and terminal canvases but lower than the suggest widget */
 	z-index: 39;
 	display: flex;
 	flex-direction: column;
@@ -8,19 +14,23 @@
 	background-color: var(--vscode-editorHoverWidget-background);
 	border: 1px solid var(--vscode-editorHoverWidget-border);
 }
+
 .hc-black .monaco-editor .parameter-hints-widget,
 .hc-light .monaco-editor .parameter-hints-widget {
 	border-width: 2px;
 }
+
 .monaco-editor .parameter-hints-widget > .phwrapper {
 	max-width: 440px;
 	display: flex;
 	flex-direction: row;
 }
+
 .monaco-editor .parameter-hints-widget.multiple {
 	min-height: 3.3em;
 	padding: 0;
 }
+
 .monaco-editor .parameter-hints-widget.multiple .body::before {
 	content: "";
 	display: block;
@@ -29,10 +39,12 @@
 	opacity: 0.5;
 	border-left: 1px solid var(--vscode-editorHoverWidget-border);
 }
+
 .monaco-editor .parameter-hints-widget p,
 .monaco-editor .parameter-hints-widget ul {
 	margin: 8px 0;
 }
+
 .monaco-editor .parameter-hints-widget .monaco-scrollable-element,
 .monaco-editor .parameter-hints-widget .body {
 	display: flex;
@@ -40,10 +52,12 @@
 	flex-direction: column;
 	min-height: 100%;
 }
+
 .monaco-editor .parameter-hints-widget .signature {
 	padding: 4px 5px;
 	position: relative;
 }
+
 .monaco-editor .parameter-hints-widget .signature.has-docs::after {
 	content: "";
 	display: block;
@@ -54,36 +68,45 @@
 	opacity: 0.5;
 	border-bottom: 1px solid var(--vscode-editorHoverWidget-border);
 }
+
 .monaco-editor .parameter-hints-widget .code {
 	font-family: var(--vscode-parameterHintsWidget-editorFontFamily), var(--vscode-parameterHintsWidget-editorFontFamilyDefault);
 }
+
 .monaco-editor .parameter-hints-widget .docs {
 	padding: 0 10px 0 5px;
 	white-space: pre-wrap;
 }
+
 .monaco-editor .parameter-hints-widget .docs.empty {
 	display: none;
 }
+
 .monaco-editor .parameter-hints-widget .docs a {
 	color: var(--vscode-textLink-foreground);
 }
+
 .monaco-editor .parameter-hints-widget .docs a:hover {
 	color: var(--vscode-textLink-activeForeground);
 	cursor: pointer;
 }
+
 .monaco-editor .parameter-hints-widget .docs .markdown-docs {
 	white-space: initial;
 }
+
 .monaco-editor .parameter-hints-widget .docs code {
 	font-family: var(--monaco-monospace-font);
 	border-radius: 3px;
 	padding: 0 0.4em;
 	background-color: var(--vscode-textCodeBlock-background);
 }
+
 .monaco-editor .parameter-hints-widget .docs .monaco-tokenized-source,
 .monaco-editor .parameter-hints-widget .docs .code {
 	white-space: pre-wrap;
 }
+
 .monaco-editor .parameter-hints-widget .controls {
 	display: none;
 	flex-direction: column;
@@ -91,29 +114,35 @@
 	min-width: 22px;
 	justify-content: flex-end;
 }
+
 .monaco-editor .parameter-hints-widget.multiple .controls {
 	display: flex;
 	padding: 0 2px;
 }
+
 .monaco-editor .parameter-hints-widget.multiple .button {
 	width: 16px;
 	height: 16px;
 	background-repeat: no-repeat;
 	cursor: pointer;
 }
+
 .monaco-editor .parameter-hints-widget .button.previous {
 	bottom: 24px;
 }
+
 .monaco-editor .parameter-hints-widget .overloads {
 	text-align: center;
 	height: 12px;
 	line-height: 12px;
 	font-family: var(--monaco-monospace-font);
 }
+
 .monaco-editor .parameter-hints-widget .signature .parameter.active {
 	color: var(--vscode-editorHoverWidget-highlightForeground);
 	font-weight: bold;
 }
+
 .monaco-editor .parameter-hints-widget .documentation-parameter > .parameter {
 	font-weight: bold;
 	margin-right: 0.5em;

package/vscode/src/vs/editor/contrib/peekView/browser/media/peekViewWidget.css

@@ -1,9 +1,15 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor .peekview-widget .head {
 	box-sizing: border-box;
 	display: flex;
 	justify-content: space-between;
 	flex-wrap: nowrap;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title {
 	display: flex;
 	align-items: baseline;
@@ -13,52 +19,64 @@
 	text-overflow: ellipsis;
 	overflow: hidden;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title.clickable {
 	cursor: pointer;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .dirname:not(:empty) {
 	font-size: 0.9em;
 	margin-left: 0.5em;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .meta {
 	white-space: nowrap;
 	overflow: hidden;
 	text-overflow: ellipsis;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .dirname {
 	overflow: hidden;
 	text-overflow: ellipsis;
 	white-space: nowrap;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .filename {
 	overflow: hidden;
 	text-overflow: ellipsis;
 	white-space: nowrap;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .meta:not(:empty)::before {
 	content: '-';
 	padding: 0 0.3em;
 }
+
 .monaco-editor .peekview-widget .head .peekview-actions {
 	flex: 1;
 	text-align: right;
 	padding-right: 2px;
 }
+
 .monaco-editor .peekview-widget .head .peekview-actions > .monaco-action-bar {
 	display: inline-block;
 }
+
 .monaco-editor .peekview-widget .head .peekview-actions > .monaco-action-bar,
 .monaco-editor .peekview-widget .head .peekview-actions > .monaco-action-bar > .actions-container {
 	height: 100%;
 }
+
 .monaco-editor .peekview-widget > .body {
 	border-top: 1px solid;
 	position: relative;
 }
+
 .monaco-editor .peekview-widget .head .peekview-title .codicon {
 	margin-right: 4px;
 	align-self: center;
 }
+
 .monaco-editor .peekview-widget .monaco-list .monaco-list-row.focused .codicon {
 	color: inherit !important;
 }

package/vscode/src/vs/editor/contrib/placeholderText/browser/placeholderText.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.
+ *--------------------------------------------------------------------------------------------*/
+
 .monaco-editor {
 	.editorPlaceholder {
 		top: 0px;
@@ -6,6 +11,7 @@
 		text-overflow: ellipsis;
 		text-wrap: nowrap;
 		pointer-events: none;
+
 		color: var(--vscode-editor-placeholder-foreground);
 	}
 }

package/vscode/src/vs/editor/contrib/placeholderText/browser/placeholderTextContribution.d.ts

@@ -1,6 +1,9 @@
 import { Disposable } from "../../../../base/common/lifecycle.js";
 import { ICodeEditor } from "../../../browser/editorBrowser.js";
 import { IEditorContribution } from "../../../common/editorCommon.js";
+/**
+ * Use the editor option to set the placeholder text.
+*/
 export declare class PlaceholderTextContribution extends Disposable implements IEditorContribution {
     private readonly _editor;
     static get(editor: ICodeEditor): PlaceholderTextContribution;