@codingame/monaco-vscode-api 20.1.1 → 20.2.1

package/vscode/src/vs/editor/browser/viewParts/lineNumbers/lineNumbers.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 .margin-view-overlays .line-numbers {
 	bottom: 0;
 	font-variant-numeric: tabular-nums;
@@ -8,17 +13,21 @@
 	box-sizing: border-box;
 	cursor: default;
 }
+
 .monaco-editor .relative-current-line-number {
 	text-align: left;
 	display: inline-block;
 	width: 100%;
 }
+
 .monaco-editor .margin-view-overlays .line-numbers.lh-odd {
 	margin-top: 1px;
 }
+
 .monaco-editor .line-numbers {
 	color: var(--vscode-editorLineNumber-foreground);
 }
+
 .monaco-editor .line-numbers.active-line-number {
 	color: var(--vscode-editorLineNumber-activeForeground);
 }

package/vscode/src/vs/editor/browser/viewParts/lineNumbers/lineNumbers.d.ts

@@ -2,6 +2,9 @@ import { DynamicViewOverlay } from "../../view/dynamicViewOverlay.js";
 import { RenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * Renders line numbers to the left of the main view lines content.
+ */
 export declare class LineNumbersOverlay extends DynamicViewOverlay {
     static readonly CLASS_NAME = "line-numbers";
     private readonly _context;

package/vscode/src/vs/editor/browser/viewParts/linesDecorations/linesDecorations.css

@@ -1,8 +1,17 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
 .monaco-editor .lines-decorations {
 	position: absolute;
 	top: 0;
 	background: white;
 }
+
+/*
+	Keeping name short for faster parsing.
+	cldr = core lines decorations rendering (div)
+*/
 .monaco-editor .margin-view-overlays .cldr {
 	position: absolute;
 	height: 100%;

package/vscode/src/vs/editor/browser/viewParts/margin/margin.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 .margin {
 	background-color: var(--vscode-editorGutter-background);
 }

package/vscode/src/vs/editor/browser/viewParts/margin/margin.d.ts

@@ -3,6 +3,11 @@ import { ViewPart } from "../../view/viewPart.js";
 import { RenderingContext, RestrictedRenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * Margin is a vertical strip located on the left of the editor's content area.
+ * It is used for various features such as line numbers, folding markers, and
+ * decorations that provide additional information about the lines of code.
+ */
 export declare class Margin extends ViewPart {
     static readonly CLASS_NAME = "glyph-margin";
     static readonly OUTER_CLASS_NAME = "margin";

package/vscode/src/vs/editor/browser/viewParts/marginDecorations/marginDecorations.css

@@ -1,3 +1,12 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/*
+	Keeping name short for faster parsing.
+	cmdr = core margin decorations rendering (div)
+*/
 .monaco-editor .margin-view-overlays .cmdr {
 	position: absolute;
 	left: 0;

package/vscode/src/vs/editor/browser/viewParts/minimap/minimap.css

@@ -1,3 +1,9 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/* START cover the case that slider is visible on mouseover */
 .monaco-editor .minimap.slider-mouseover .minimap-slider {
 	opacity: 0;
 	transition: opacity 100ms linear;
@@ -8,6 +14,7 @@
 .monaco-editor .minimap.slider-mouseover .minimap-slider.active {
 	opacity: 1;
 }
+/* END cover the case that slider is visible on mouseover */
 .monaco-editor .minimap-slider .minimap-slider-horizontal {
 	background: var(--vscode-minimapSlider-background);
 }
@@ -34,6 +41,8 @@
 	left: -1px;
 	width: 1px;
 }
+
+/* 0.5s fade in/out for the minimap */
 .minimap.minimap-autohide-mouseover,
 .minimap.minimap-autohide-scroll {
 	opacity: 0;
@@ -47,6 +56,7 @@
 	opacity: 1;
 	pointer-events: auto;
 }
+
 .monaco-editor .minimap {
 	z-index: 5;
 }

package/vscode/src/vs/editor/browser/viewParts/minimap/minimap.d.ts

@@ -25,12 +25,33 @@ declare class MinimapOptions {
     readonly pixelRatio: number;
     readonly typicalHalfwidthCharacterWidth: number;
     readonly lineHeight: number;
+    /**
+     * container dom node left position (in CSS px)
+     */
     readonly minimapLeft: number;
+    /**
+     * container dom node width (in CSS px)
+     */
     readonly minimapWidth: number;
+    /**
+     * container dom node height (in CSS px)
+     */
     readonly minimapHeight: number;
+    /**
+     * canvas backing store width (in device px)
+     */
     readonly canvasInnerWidth: number;
+    /**
+     * canvas backing store height (in device px)
+     */
     readonly canvasInnerHeight: number;
+    /**
+     * canvas width (in CSS px)
+     */
     readonly canvasOuterWidth: number;
+    /**
+     * canvas height (in CSS px)
+     */
     readonly canvasOuterHeight: number;
     readonly isSampling: boolean;
     readonly editorHeight: number;
@@ -39,11 +60,17 @@ declare class MinimapOptions {
     readonly minimapCharWidth: number;
     readonly sectionHeaderFontFamily: string;
     readonly sectionHeaderFontSize: number;
+    /**
+     * Space in between the characters of the section header (in CSS px)
+     */
     readonly sectionHeaderLetterSpacing: number;
     readonly sectionHeaderFontColor: RGBA8;
     readonly charRenderer: () => MinimapCharRenderer;
     readonly defaultBackgroundColor: RGBA8;
     readonly backgroundColor: RGBA8;
+    /**
+     * foreground alpha: integer in [0-255]
+     */
     readonly foregroundAlpha: number;
     constructor(configuration: IEditorConfiguration, theme: EditorTheme, tokensColorTracker: MinimapTokensColorTracker);
     private static _getMinimapBackground;
@@ -67,6 +94,10 @@ export interface IMinimapModel {
     revealLineNumber(lineNumber: number): void;
     setScrollTop(scrollTop: number): void;
 }
+/**
+ * The minimap appears beside the editor scroll bar and visualizes a zoomed out
+ * view of the file.
+ */
 export declare class Minimap extends ViewPart implements IMinimapModel {
     readonly tokensColorTracker: MinimapTokensColorTracker;
     private _selections;

package/vscode/src/vs/editor/browser/viewParts/minimap/minimapCharRendererFactory.d.ts

@@ -1,9 +1,25 @@
 import { MinimapCharRenderer } from "./minimapCharRenderer.js";
+/**
+ * Creates character renderers. It takes a 'scale' that determines how large
+ * characters should be drawn. Using this, it draws data into a canvas and
+ * then downsamples the characters as necessary for the current display.
+ * This makes rendering more efficient, rather than drawing a full (tiny)
+ * font, or downsampling in real-time.
+ */
 export declare class MinimapCharRendererFactory {
     private static lastCreated?;
     private static lastFontFamily?;
+    /**
+     * Creates a new character renderer factory with the given scale.
+     */
     static create(scale: number, fontFamily: string): MinimapCharRenderer;
+    /**
+     * Creates the font sample data, writing to a canvas.
+     */
     static createSampleData(fontFamily: string): ImageData;
+    /**
+     * Creates a character renderer from the canvas sample data.
+     */
     static createFromSampleData(source: Uint8ClampedArray, scale: number): MinimapCharRenderer;
     private static _downsampleChar;
     private static _downsample;

package/vscode/src/vs/editor/browser/viewParts/minimap/minimapCharSheet.d.ts

@@ -1,7 +1,7 @@
 export declare enum Constants {
-    START_CH_CODE = 32,
-    END_CH_CODE = 126,
-    UNKNOWN_CODE = 65533,
+    START_CH_CODE = 32,// Space
+    END_CH_CODE = 126,// Tilde (~)
+    UNKNOWN_CODE = 65533,// UTF placeholder code
     CHAR_COUNT = 96,
     SAMPLED_CHAR_HEIGHT = 16,
     SAMPLED_CHAR_WIDTH = 10,

package/vscode/src/vs/editor/browser/viewParts/minimap/minimapPreBaked.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Map of minimap scales to prebaked sample data at those scales. We don't
+ * sample much larger data, because then font family becomes visible, which
+ * is use-configurable.
+ */
 export declare const prebakedMiniMaps: {
     [scale: number]: () => Uint8ClampedArray;
 };

package/vscode/src/vs/editor/browser/viewParts/overlayWidgets/overlayWidgets.css

@@ -1,3 +1,7 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
 .monaco-editor .overlayWidgets {
 	position: absolute;
 	top: 0;

package/vscode/src/vs/editor/browser/viewParts/overviewRuler/overviewRuler.d.ts

@@ -4,6 +4,10 @@ import { OverviewRulerZone } from "../../../common/viewModel/overviewZoneManager
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
 import { ViewEventHandler } from "../../../common/viewEventHandler.js";
+/**
+ * The overview ruler appears underneath the editor scroll bar and shows things
+ * like the cursor, various decorations, etc.
+ */
 export declare class OverviewRuler extends ViewEventHandler implements IOverviewRuler {
     private readonly _context;
     private readonly _domNode;

package/vscode/src/vs/editor/browser/viewParts/rulers/rulers.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 .view-ruler {
 	position: absolute;
 	top: 0;

package/vscode/src/vs/editor/browser/viewParts/rulers/rulers.d.ts

@@ -3,6 +3,10 @@ import { ViewPart } from "../../view/viewPart.js";
 import { RenderingContext, RestrictedRenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * Rulers are vertical lines that appear at certain columns in the editor. There can be >= 0 rulers
+ * at a time.
+ */
 export declare class Rulers extends ViewPart {
     domNode: FastDomNode<HTMLElement>;
     private readonly _renderedRulers;

package/vscode/src/vs/editor/browser/viewParts/rulersGpu/rulersGpu.d.ts

@@ -3,6 +3,10 @@ import { RenderingContext, RestrictedRenderingContext } from "../../view/renderi
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
 import type { ViewGpuContext } from "../../gpu/viewGpuContext.js";
+/**
+ * Rulers are vertical lines that appear at certain columns in the editor. There can be >= 0 rulers
+ * at a time.
+ */
 export declare class RulersGpu extends ViewPart {
     private readonly _viewGpuContext;
     private readonly _gpuShapes;

package/vscode/src/vs/editor/browser/viewParts/scrollDecoration/scrollDecoration.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-decoration {
 	position: absolute;
 	top: 0;

package/vscode/src/vs/editor/browser/viewParts/selections/selections.css

@@ -1,20 +1,34 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/*
+	Keeping name short for faster parsing.
+	cslr = core selections layer rendering (div)
+*/
 .monaco-editor .lines-content .cslr {
 	position: absolute;
 }
+
 .monaco-editor .focused .selected-text {
 	background-color: var(--vscode-editor-selectionBackground);
 }
+
 .monaco-editor .selected-text {
 	background-color: var(--vscode-editor-inactiveSelectionBackground);
 }
+
 .monaco-editor			.top-left-radius		{ border-top-left-radius: 3px; }
 .monaco-editor			.bottom-left-radius		{ border-bottom-left-radius: 3px; }
 .monaco-editor			.top-right-radius		{ border-top-right-radius: 3px; }
 .monaco-editor			.bottom-right-radius	{ border-bottom-right-radius: 3px; }
+
 .monaco-editor.hc-black .top-left-radius		{ border-top-left-radius: 0; }
 .monaco-editor.hc-black .bottom-left-radius		{ border-bottom-left-radius: 0; }
 .monaco-editor.hc-black .top-right-radius		{ border-top-right-radius: 0; }
 .monaco-editor.hc-black .bottom-right-radius	{ border-bottom-right-radius: 0; }
+
 .monaco-editor.hc-light .top-left-radius		{ border-top-left-radius: 0; }
 .monaco-editor.hc-light .bottom-left-radius		{ border-bottom-left-radius: 0; }
 .monaco-editor.hc-light .top-right-radius		{ border-top-right-radius: 0; }

package/vscode/src/vs/editor/browser/viewParts/selections/selections.d.ts

@@ -2,6 +2,9 @@ import { DynamicViewOverlay } from "../../view/dynamicViewOverlay.js";
 import { RenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * This view part displays selected text to the user. Every line has its own selection overlay.
+ */
 export declare class SelectionsOverlay extends DynamicViewOverlay {
     private static readonly SELECTION_CLASS_NAME;
     private static readonly SELECTION_TOP_LEFT;

package/vscode/src/vs/editor/browser/viewParts/viewCursors/viewCursor.d.ts

@@ -35,6 +35,10 @@ export declare class ViewCursor {
     hide(): void;
     onConfigurationChanged(e: viewEvents.ViewConfigurationChangedEvent): boolean;
     onCursorPositionChanged(position: Position, pauseAnimation: boolean): boolean;
+    /**
+     * If `this._position` is inside a grapheme, returns the position where the grapheme starts.
+     * Also returns the next grapheme.
+     */
     private _getGraphemeAwarePosition;
     private _prepareRender;
     private _getTokenClassName;

package/vscode/src/vs/editor/browser/viewParts/viewCursors/viewCursors.css

@@ -1,30 +1,44 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
 .monaco-editor .cursors-layer {
 	position: absolute;
 	top: 0;
 }
+
 .monaco-editor .cursors-layer > .cursor {
 	position: absolute;
 	overflow: hidden;
 	box-sizing: border-box;
 }
+
+/* -- smooth-caret-animation -- */
 .monaco-editor .cursors-layer.cursor-smooth-caret-animation > .cursor {
 	transition: all 80ms;
 }
+
+/* -- block-outline-style -- */
 .monaco-editor .cursors-layer.cursor-block-outline-style > .cursor {
 	background: transparent !important;
 	border-style: solid;
 	border-width: 1px;
 }
+
+/* -- underline-style -- */
 .monaco-editor .cursors-layer.cursor-underline-style > .cursor {
 	border-bottom-width: 2px;
 	border-bottom-style: solid;
 	background: transparent !important;
 }
+
+/* -- underline-thin-style -- */
 .monaco-editor .cursors-layer.cursor-underline-thin-style > .cursor {
 	border-bottom-width: 1px;
 	border-bottom-style: solid;
 	background: transparent !important;
 }
+
 @keyframes monaco-cursor-smooth {
 	0%,
 	20% {
@@ -35,6 +49,7 @@
 		opacity: 0;
 	}
 }
+
 @keyframes monaco-cursor-phase {
 	0%,
 	20% {
@@ -45,6 +60,7 @@
 		opacity: 0;
 	}
 }
+
 @keyframes monaco-cursor-expand {
 	0%,
 	20% {
@@ -55,12 +71,15 @@
 		transform: scaleY(0);
 	}
 }
+
 .cursor-smooth {
 	animation: monaco-cursor-smooth 0.5s ease-in-out 0s 20 alternate;
 }
+
 .cursor-phase {
 	animation: monaco-cursor-phase 0.5s ease-in-out 0s 20 alternate;
 }
+
 .cursor-expand > .cursor {
 	animation: monaco-cursor-expand 0.5s ease-in-out 0s 20 alternate;
 }

package/vscode/src/vs/editor/browser/viewParts/viewCursors/viewCursors.d.ts

@@ -4,6 +4,10 @@ import { IViewCursorRenderData } from "./viewCursor.js";
 import { RenderingContext, RestrictedRenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * View cursors is a view part responsible for rendering the primary cursor and
+ * any secondary cursors that are currently active.
+ */
 export declare class ViewCursors extends ViewPart {
     static readonly BLINK_INTERVAL = 500;
     private _readOnly;

package/vscode/src/vs/editor/browser/viewParts/viewLines/rangeUtil.d.ts

@@ -1,6 +1,11 @@
 import { FloatHorizontalRange } from "../../view/renderingContext.js";
 import { DomReadingContext } from "./domReadingContext.js";
 export declare class RangeUtil {
+    /**
+     * Reusing the same range here
+     * because IE is buggy and constantly freezes when using a large number
+     * of ranges and calling .detach on them
+     */
     private static _handyReadyRange;
     private static _createRange;
     private static _detachRange;

package/vscode/src/vs/editor/browser/viewParts/viewLines/viewLines.css

@@ -1,7 +1,24 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+/* Uncomment to see lines flashing when they're painted */
+/*.monaco-editor .view-lines > .view-line {
+	background-color: none;
+	animation-name: flash-background;
+	animation-duration: 800ms;
+}
+@keyframes flash-background {
+	0%   { background-color: lightgreen; }
+	100% { background-color: none }
+}*/
+
 .mtkcontrol {
 	color: rgb(255, 255, 255) !important;
 	background: rgb(150, 0, 0) !important;
 }
+
 .mtkoverflow {
 	background-color: var(--vscode-button-background, var(--vscode-editor-background));
 	color: var(--vscode-button-foreground, var(--vscode-editor-foreground));
@@ -15,12 +32,15 @@
 .mtkoverflow:hover {
 	background-color: var(--vscode-button-hoverBackground);
 }
+
 .monaco-editor.no-user-select .lines-content,
 .monaco-editor.no-user-select .view-line,
 .monaco-editor.no-user-select .view-lines {
 	user-select: none;
 	-webkit-user-select: none;
 }
+/* Use user-select: text for lookup feature on macOS */
+/* https://github.com/microsoft/vscode/issues/85632 */
 .monaco-editor.mac .lines-content:hover,
 .monaco-editor.mac .view-line:hover,
 .monaco-editor.mac .view-lines:hover {
@@ -28,27 +48,41 @@
 	-webkit-user-select: text;
 	-ms-user-select: text;
 }
+
 .monaco-editor.enable-user-select {
 	user-select: initial;
 	-webkit-user-select: initial;
 }
+
 .monaco-editor .view-lines {
 	white-space: nowrap;
 }
+
 .monaco-editor .view-line {
 	box-sizing: border-box;
 	position: absolute;
 	width: 100%;
 }
+
+/* There are view-lines in view-zones. We have to make sure this rule does not apply to them, as they don't set a line height */
 .monaco-editor .lines-content > .view-lines > .view-line > span {
 	top: 0;
 	bottom: 0;
 	position: absolute;
 }
+
 .monaco-editor .mtkw {
 	color: var(--vscode-editorWhitespace-foreground) !important;
 }
+
 .monaco-editor .mtkz {
 	display: inline-block;
 	color: var(--vscode-editorWhitespace-foreground) !important;
 }
+
+/* TODO@tokenization bootstrap fix */
+/*.monaco-editor .view-line > span > span {
+	float: none;
+	min-height: inherit;
+	margin-left: inherit;
+}*/

package/vscode/src/vs/editor/browser/viewParts/viewLines/viewLines.d.ts

@@ -7,7 +7,14 @@ import * as viewEvents from "../../../common/viewEvents.js";
 import { ViewportData } from "../../../common/viewLayout/viewLinesViewportData.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import type { ViewGpuContext } from "../../gpu/viewGpuContext.js";
+/**
+ * The view lines part is responsible for rendering the actual content of a
+ * file.
+ */
 export declare class ViewLines extends ViewPart implements IViewLines {
+    /**
+     * Adds this amount of pixels to the right of lines (no-one wants to type near the edge of the viewport)
+     */
     private static readonly HORIZONTAL_EXTRA_PX;
     private readonly _linesContent;
     private readonly _textRangeRestingSpot;
@@ -46,6 +53,9 @@ export declare class ViewLines extends ViewPart implements IViewLines {
     onThemeChanged(e: viewEvents.ViewThemeChangedEvent): boolean;
     getPositionFromDOMInfo(spanNode: HTMLElement, offset: number): Position | null;
     private _getViewLineDomNode;
+    /**
+     * @returns the line number of this view line dom node.
+     */
     private _getLineNumberFor;
     getLineWidth(lineNumber: number): number;
     linesVisibleRangesForRange(_range: Range, includeNewLines: boolean): LineVisibleRanges[] | null;
@@ -53,8 +63,17 @@ export declare class ViewLines extends ViewPart implements IViewLines {
     private _lineIsRenderedRTL;
     visibleRangeForPosition(position: Position): HorizontalPosition | null;
     updateLineWidths(): void;
+    /**
+     * Updates the max line width if it is fast to compute.
+     * Returns true if all lines were taken into account.
+     * Returns false if some lines need to be reevaluated (in a slow fashion).
+     */
     private _updateLineWidthsFast;
     private _updateLineWidthsSlow;
+    /**
+     * Update the line widths using DOM layout information after someone else
+     * has caused a synchronous layout.
+     */
     private _updateLineWidthsSlowIfDomDidLayout;
     private _updateLineWidths;
     private _checkMonospaceFontAssumptions;

package/vscode/src/vs/editor/browser/viewParts/viewLinesGpu/viewLinesGpu.d.ts

@@ -8,6 +8,9 @@ import { ViewGpuContext } from "../../gpu/viewGpuContext.js";
 import { HorizontalPosition, IViewLines, LineVisibleRanges, RenderingContext, RestrictedRenderingContext } from "../../view/renderingContext.js";
 import { ViewPart } from "../../view/viewPart.js";
 import type * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * The GPU implementation of the ViewLines part.
+ */
 export declare class ViewLinesGpu extends ViewPart implements IViewLines {
     private readonly _viewGpuContext;
     private readonly _instantiationService;

package/vscode/src/vs/editor/browser/viewParts/viewZones/viewZones.d.ts

@@ -4,6 +4,11 @@ import { ViewPart } from "../../view/viewPart.js";
 import { RenderingContext, RestrictedRenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * A view zone is a rectangle that is a section that is inserted into the editor
+ * lines that can be used for various purposes such as showing a diffs, peeking
+ * an implementation, etc.
+ */
 export declare class ViewZones extends ViewPart {
     private _zones;
     private _lineHeight;

package/vscode/src/vs/editor/browser/viewParts/whitespace/whitespace.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 .mwh {
 	position: absolute;
 	color: var(--vscode-editorWhitespace-foreground) !important;

package/vscode/src/vs/editor/browser/viewParts/whitespace/whitespace.d.ts

@@ -2,6 +2,10 @@ import { DynamicViewOverlay } from "../../view/dynamicViewOverlay.js";
 import { RenderingContext } from "../../view/renderingContext.js";
 import { ViewContext } from "../../../common/viewModel/viewContext.js";
 import * as viewEvents from "../../../common/viewEvents.js";
+/**
+ * The whitespace overlay will visual certain whitespace depending on the
+ * current editor configuration (boundary, selection, etc.).
+ */
 export declare class WhitespaceOverlay extends DynamicViewOverlay {
     private readonly _context;
     private _options;