@codingame/monaco-vscode-api 20.1.1 → 20.2.1

package/vscode/src/vs/base/parts/sandbox/common/electronTypes.d.ts

@@ -1,50 +1,193 @@
 export interface MessageBoxOptions {
+    /**
+     * Content of the message box.
+     */
     message: string;
+    /**
+     * Can be `none`, `info`, `error`, `question` or `warning`. On Windows, `question`
+     * displays the same icon as `info`, unless you set an icon using the `icon`
+     * option. On macOS, both `warning` and `error` display the same warning icon.
+     */
     type?: ("none" | "info" | "error" | "question" | "warning");
+    /**
+     * Array of texts for buttons. On Windows, an empty array will result in one button
+     * labeled "OK".
+     */
     buttons?: string[];
+    /**
+     * Index of the button in the buttons array which will be selected by default when
+     * the message box opens.
+     */
     defaultId?: number;
+    /**
+     * Pass an instance of AbortSignal to optionally close the message box, the message
+     * box will behave as if it was cancelled by the user. On macOS, `signal` does not
+     * work with message boxes that do not have a parent window, since those message
+     * boxes run synchronously due to platform limitations.
+     */
     signal?: AbortSignal;
+    /**
+     * Title of the message box, some platforms will not show it.
+     */
     title?: string;
+    /**
+     * Extra information of the message.
+     */
     detail?: string;
+    /**
+     * If provided, the message box will include a checkbox with the given label.
+     */
     checkboxLabel?: string;
+    /**
+     * Initial checked state of the checkbox. `false` by default.
+     */
     checkboxChecked?: boolean;
+    /**
+     * Custom width of the text in the message box.
+     *
+     * @platform darwin
+     */
     textWidth?: number;
+    /**
+     * The index of the button to be used to cancel the dialog, via the `Esc` key. By
+     * default this is assigned to the first button with "cancel" or "no" as the label.
+     * If no such labeled buttons exist and this option is not set, `0` will be used as
+     * the return value.
+     */
     cancelId?: number;
+    /**
+     * On Windows Electron will try to figure out which one of the `buttons` are common
+     * buttons (like "Cancel" or "Yes"), and show the others as command links in the
+     * dialog. This can make the dialog appear in the style of modern Windows apps. If
+     * you don't like this behavior, you can set `noLink` to `true`.
+     */
     noLink?: boolean;
+    /**
+     * Normalize the keyboard access keys across platforms. Default is `false`.
+     * Enabling this assumes `&` is used in the button labels for the placement of the
+     * keyboard shortcut access key and labels will be converted so they work correctly
+     * on each platform, `&` characters are removed on macOS, converted to `_` on
+     * Linux, and left untouched on Windows. For example, a button label of `Vie&w`
+     * will be converted to `Vie_w` on Linux and `View` on macOS and can be selected
+     * via `Alt-W` on Windows and Linux.
+     */
     normalizeAccessKeys?: boolean;
 }
 export interface MessageBoxReturnValue {
+    /**
+     * The index of the clicked button.
+     */
     response: number;
+    /**
+     * The checked state of the checkbox if `checkboxLabel` was set. Otherwise `false`.
+     */
     checkboxChecked: boolean;
 }
 export interface SaveDialogOptions {
+    /**
+     * The dialog title. Cannot be displayed on some _Linux_ desktop environments.
+     */
     title?: string;
+    /**
+     * Absolute directory path, absolute file path, or file name to use by default.
+     */
     defaultPath?: string;
+    /**
+     * Custom label for the confirmation button, when left empty the default label will
+     * be used.
+     */
     buttonLabel?: string;
     filters?: FileFilter[];
+    /**
+     * Message to display above text fields.
+     *
+     * @platform darwin
+     */
     message?: string;
+    /**
+     * Custom label for the text displayed in front of the filename text field.
+     *
+     * @platform darwin
+     */
     nameFieldLabel?: string;
+    /**
+     * Show the tags input box, defaults to `true`.
+     *
+     * @platform darwin
+     */
     showsTagField?: boolean;
     properties?: Array<"showHiddenFiles" | "createDirectory" | "treatPackageAsDirectory" | "showOverwriteConfirmation" | "dontAddToRecent">;
+    /**
+     * Create a security scoped bookmark when packaged for the Mac App Store. If this
+     * option is enabled and the file doesn't already exist a blank file will be
+     * created at the chosen path.
+     *
+     * @platform darwin,mas
+     */
     securityScopedBookmarks?: boolean;
 }
 export interface SaveDialogReturnValue {
+    /**
+     * whether or not the dialog was canceled.
+     */
     canceled: boolean;
+    /**
+     * If the dialog is canceled, this will be an empty string.
+     */
     filePath: string;
+    /**
+     * Base64 encoded string which contains the security scoped bookmark data for the
+     * saved file. `securityScopedBookmarks` must be enabled for this to be present.
+     * (For return values, see table here.)
+     *
+     * @platform darwin,mas
+     */
     bookmark?: string;
 }
 export interface OpenDialogOptions {
     title?: string;
     defaultPath?: string;
+    /**
+     * Custom label for the confirmation button, when left empty the default label will
+     * be used.
+     */
     buttonLabel?: string;
     filters?: FileFilter[];
+    /**
+     * Contains which features the dialog should use. The following values are
+     * supported:
+     */
     properties?: Array<"openFile" | "openDirectory" | "multiSelections" | "showHiddenFiles" | "createDirectory" | "promptToCreate" | "noResolveAliases" | "treatPackageAsDirectory" | "dontAddToRecent">;
+    /**
+     * Message to display above input boxes.
+     *
+     * @platform darwin
+     */
     message?: string;
+    /**
+     * Create security scoped bookmarks when packaged for the Mac App Store.
+     *
+     * @platform darwin,mas
+     */
     securityScopedBookmarks?: boolean;
 }
 export interface OpenDialogReturnValue {
+    /**
+     * whether or not the dialog was canceled.
+     */
     canceled: boolean;
+    /**
+     * An array of file paths chosen by the user. If the dialog is cancelled this will
+     * be an empty array.
+     */
     filePaths: string[];
+    /**
+     * An array matching the `filePaths` array of base64 encoded strings which contains
+     * security scoped bookmark data. `securityScopedBookmarks` must be enabled for
+     * this to be populated. (For return values, see table here.)
+     *
+     * @platform darwin,mas
+     */
     bookmarks?: string[];
 }
 export interface FileFilter {
@@ -52,21 +195,57 @@ export interface FileFilter {
     name: string;
 }
 export interface OpenDevToolsOptions {
+    /**
+     * Opens the devtools with specified dock state, can be `left`, `right`, `bottom`,
+     * `undocked`, `detach`. Defaults to last used dock state. In `undocked` mode it's
+     * possible to dock back. In `detach` mode it's not.
+     */
     mode: ("left" | "right" | "bottom" | "undocked" | "detach");
+    /**
+     * Whether to bring the opened devtools window to the foreground. The default is
+     * `true`.
+     */
     activate?: boolean;
+    /**
+     * A title for the DevTools window (only in `undocked` or `detach` mode).
+     */
     title?: string;
 }
 interface InputEvent {
+    /**
+     * An array of modifiers of the event, can be `shift`, `control`, `ctrl`, `alt`,
+     * `meta`, `command`, `cmd`, `isKeypad`, `isAutoRepeat`, `leftButtonDown`,
+     * `middleButtonDown`, `rightButtonDown`, `capsLock`, `numLock`, `left`, `right`.
+     */
     modifiers?: Array<"shift" | "control" | "ctrl" | "alt" | "meta" | "command" | "cmd" | "isKeypad" | "isAutoRepeat" | "leftButtonDown" | "middleButtonDown" | "rightButtonDown" | "capsLock" | "numLock" | "left" | "right">;
+    /**
+     * Can be `undefined`, `mouseDown`, `mouseUp`, `mouseMove`, `mouseEnter`,
+     * `mouseLeave`, `contextMenu`, `mouseWheel`, `rawKeyDown`, `keyDown`, `keyUp`,
+     * `char`, `gestureScrollBegin`, `gestureScrollEnd`, `gestureScrollUpdate`,
+     * `gestureFlingStart`, `gestureFlingCancel`, `gesturePinchBegin`,
+     * `gesturePinchEnd`, `gesturePinchUpdate`, `gestureTapDown`, `gestureShowPress`,
+     * `gestureTap`, `gestureTapCancel`, `gestureShortPress`, `gestureLongPress`,
+     * `gestureLongTap`, `gestureTwoFingerTap`, `gestureTapUnconfirmed`,
+     * `gestureDoubleTap`, `touchStart`, `touchMove`, `touchEnd`, `touchCancel`,
+     * `touchScrollStarted`, `pointerDown`, `pointerUp`, `pointerMove`,
+     * `pointerRawUpdate`, `pointerCancel` or `pointerCausedUaAction`.
+     */
     type: ("undefined" | "mouseDown" | "mouseUp" | "mouseMove" | "mouseEnter" | "mouseLeave" | "contextMenu" | "mouseWheel" | "rawKeyDown" | "keyDown" | "keyUp" | "char" | "gestureScrollBegin" | "gestureScrollEnd" | "gestureScrollUpdate" | "gestureFlingStart" | "gestureFlingCancel" | "gesturePinchBegin" | "gesturePinchEnd" | "gesturePinchUpdate" | "gestureTapDown" | "gestureShowPress" | "gestureTap" | "gestureTapCancel" | "gestureShortPress" | "gestureLongPress" | "gestureLongTap" | "gestureTwoFingerTap" | "gestureTapUnconfirmed" | "gestureDoubleTap" | "touchStart" | "touchMove" | "touchEnd" | "touchCancel" | "touchScrollStarted" | "pointerDown" | "pointerUp" | "pointerMove" | "pointerRawUpdate" | "pointerCancel" | "pointerCausedUaAction");
 }
 export interface MouseInputEvent extends InputEvent {
+    /**
+     * The button pressed, can be `left`, `middle`, `right`.
+     */
     button?: ("left" | "middle" | "right");
     clickCount?: number;
     globalX?: number;
     globalY?: number;
     movementX?: number;
     movementY?: number;
+    /**
+     * The type of the event, can be `mouseDown`, `mouseUp`, `mouseEnter`,
+     * `mouseLeave`, `contextMenu`, `mouseWheel` or `mouseMove`.
+     */
     type: ("mouseDown" | "mouseUp" | "mouseEnter" | "mouseLeave" | "contextMenu" | "mouseWheel" | "mouseMove");
     x: number;
     y: number;

package/vscode/src/vs/base/parts/sandbox/common/sandboxTypes.d.ts

@@ -1,15 +1,54 @@
 import { IProcessEnvironment } from "../../../common/platform.js";
 import { IProductConfiguration } from "../../../common/product.js";
+/**
+ * The common properties required for any sandboxed
+ * renderer to function.
+ */
 export interface ISandboxConfiguration {
+    /**
+     * Identifier of the sandboxed renderer.
+     */
     windowId: number;
+    /**
+     * Root path of the JavaScript sources.
+     *
+     * Note: This is NOT the installation root
+     * directory itself but contained in it at
+     * a level that is platform dependent.
+     */
     appRoot: string;
+    /**
+     * Per window process environment.
+     */
     userEnv: IProcessEnvironment;
+    /**
+     * Product configuration.
+     */
     product: IProductConfiguration;
+    /**
+     * Configured zoom level.
+     */
     zoomLevel?: number;
+    /**
+     * Location of V8 code cache.
+     */
     codeCachePath?: string;
+    /**
+     * NLS support
+     */
     nls: {
+        /**
+         * All NLS messages produced by `localize` and `localize2` calls
+         * under `src/vs`.
+         */
         messages: string[];
+        /**
+         * The actual language of the NLS messages (e.g. 'en', de' or 'pt-br').
+         */
         language: string | undefined;
     };
+    /**
+     * DEV time only: All CSS-modules that we have.
+     */
     cssModules?: string[];
 }

package/vscode/src/vs/base/parts/storage/common/storage.d.ts

@@ -24,7 +24,18 @@ export interface IStorageDatabase {
     close(recovery?: () => Map<string, string>): Promise<void>;
 }
 export interface IStorageChangeEvent {
+    /**
+     * The `key` of the storage entry that was changed
+     * or was removed.
+     */
     readonly key: string;
+    /**
+     * A hint how the storage change event was triggered. If
+     * `true`, the storage change was triggered by an external
+     * source, such as:
+     * - another process (for example another window)
+     * - operations such as settings sync or profiles change
+     */
     readonly external?: boolean;
 }
 export type StorageValue = string | boolean | number | undefined | null | object;

package/vscode/src/vs/editor/browser/config/editorConfiguration.d.ts

@@ -8,7 +8,14 @@ import { AccessibilitySupport } from "../../../platform/accessibility/common/acc
 import { IAccessibilityService } from "../../../platform/accessibility/common/accessibility.service.js";
 import { MenuId } from "../../../platform/actions/common/actions.js";
 export interface IEditorConstructionOptions extends IEditorOptions {
+    /**
+     * The initial editor dimension (to avoid measuring the container).
+     */
     dimension?: IDimension;
+    /**
+     * Place overflow widgets inside an external DOM node.
+     * Defaults to an internal DOM node.
+     */
     overflowWidgetsDomNode?: HTMLElement;
 }
 export declare class EditorConfiguration extends Disposable implements IEditorConfiguration {
@@ -28,8 +35,17 @@ export declare class EditorConfiguration extends Disposable implements IEditorCo
     private _glyphMarginDecorationLaneCount;
     private _targetWindowId;
     private readonly _computeOptionsMemory;
+    /**
+     * Raw options as they were passed in and merged with all calls to `updateOptions`.
+     */
     private readonly _rawOptions;
+    /**
+     * Validated version of `_rawOptions`.
+     */
     private _validatedOptions;
+    /**
+     * Complete options which are a combination of passed in options and env values.
+     */
     options: ComputedEditorOptions;
     constructor(isSimpleWidget: boolean, contextMenuId: MenuId, isStandaloneEditor: boolean, options: Readonly<IEditorConstructionOptions>, container: HTMLElement | null, _accessibilityService: IAccessibilityService);
     private _recomputeOptions;
@@ -71,6 +87,10 @@ export declare class EditorOptionsUtil {
     static computeOptions(options: ValidatedEditorOptions, env: IEnvironmentalOptions): ComputedEditorOptions;
     private static _deepEquals;
     static checkEquals(a: ComputedEditorOptions, b: ComputedEditorOptions): ConfigurationChangedEvent | null;
+    /**
+     * Returns true if something changed.
+     * Modifies `options`.
+    */
     static applyUpdate(options: IEditorOptions, update: Readonly<IEditorOptions>): boolean;
 }
 export {};

package/vscode/src/vs/editor/browser/config/fontMeasurements.d.ts

@@ -1,5 +1,8 @@
 import { Disposable } from "../../../base/common/lifecycle.js";
 import { BareFontInfo, FontInfo } from "../../common/config/fontInfo.js";
+/**
+ * Serializable font information.
+ */
 export interface ISerializedFontInfo {
     readonly version: number;
     readonly pixelRatio: number;
@@ -25,12 +28,24 @@ export declare class FontMeasurementsImpl extends Disposable {
     private readonly _onDidChange;
     readonly onDidChange: import("../../../base/common/event.js").Event<void>;
     dispose(): void;
+    /**
+     * Clear all cached font information and trigger a change event.
+     */
     clearAllFontInfos(): void;
     private _ensureCache;
     private _writeToCache;
     private _evictUntrustedReadings;
+    /**
+     * Serialized currently cached font information.
+     */
     serializeFontInfo(targetWindow: Window): ISerializedFontInfo[];
+    /**
+     * Restore previously serialized font informations.
+     */
     restoreFontInfo(targetWindow: Window, savedFontInfos: ISerializedFontInfo[]): void;
+    /**
+     * Read font information.
+     */
     readFontInfo(targetWindow: Window, bareFontInfo: BareFontInfo): FontInfo;
     private _createRequest;
     private _actualReadFontInfo;

package/vscode/src/vs/editor/browser/config/migrateOptions.d.ts

@@ -14,4 +14,7 @@ export declare class EditorSettingMigration {
     private static _read;
     private static _write;
 }
+/**
+ * Compatibility with old options
+ */
 export declare function migrateOptions(options: IEditorOptions): void;

package/vscode/src/vs/editor/browser/config/tabFocus.d.ts

@@ -6,5 +6,11 @@ declare class TabFocusImpl {
     getTabFocusMode(): boolean;
     setTabFocusMode(tabFocusMode: boolean): void;
 }
+/**
+ * Control what pressing Tab does.
+ * If it is false, pressing Tab or Shift-Tab will be handled by the editor.
+ * If it is true, pressing Tab or Shift-Tab will move the browser focus.
+ * Defaults to false.
+ */
 export declare const TabFocus: TabFocusImpl;
 export {};

package/vscode/src/vs/editor/browser/controller/dragScrolling.d.ts

@@ -29,6 +29,9 @@ export declare abstract class DragScrollingOperation extends Disposable {
     constructor(_context: ViewContext, _viewHelper: IPointerHandlerHelper, _mouseTargetFactory: MouseTargetFactory, _dispatchMouse: (position: IMouseTarget, inSelectionMode: boolean, revealType: NavigationCommandRevealType) => void, position: IMouseTargetOutsideEditor, mouseEvent: EditorMouseEvent);
     dispose(): void;
     setPosition(position: IMouseTargetOutsideEditor, mouseEvent: EditorMouseEvent): void;
+    /**
+     * update internal state and return elapsed ms since last time
+     */
     protected _tick(): number;
     protected abstract _execute(): void;
 }
@@ -36,6 +39,9 @@ export declare class TopBottomDragScrolling extends DragScrolling {
     protected _createDragScrollingOperation(position: IMouseTargetOutsideEditor, mouseEvent: EditorMouseEvent): DragScrollingOperation;
 }
 export declare class TopBottomDragScrollingOperation extends DragScrollingOperation {
+    /**
+     * get the number of lines per second to auto-scroll
+     */
     private _getScrollSpeed;
     protected _execute(): void;
 }
@@ -43,6 +49,9 @@ export declare class LeftRightDragScrolling extends DragScrolling {
     protected _createDragScrollingOperation(position: IMouseTargetOutsideEditor, mouseEvent: EditorMouseEvent): DragScrollingOperation;
 }
 export declare class LeftRightDragScrollingOperation extends DragScrollingOperation {
+    /**
+     * get the number of cols per second to auto-scroll
+     */
     private _getScrollSpeed;
     protected _execute(): void;
 }

package/vscode/src/vs/editor/browser/controller/editContext/clipboardUtils.d.ts

@@ -1,6 +1,11 @@
 import { IViewModel } from "../../../common/viewModel.js";
 import { Range } from "../../../common/core/range.js";
 export declare function getDataToCopy(viewModel: IViewModel, modelSelections: Range[], emptySelectionClipboard: boolean, copyWithSyntaxHighlighting: boolean): ClipboardDataToCopy;
+/**
+ * Every time we write to the clipboard, we record a bit of extra metadata here.
+ * Every time we read from the cipboard, if the text matches our last written text,
+ * we can fetch the previous metadata.
+ */
 export declare class InMemoryClipboardMetadataManager {
     static readonly INSTANCE: InMemoryClipboardMetadataManager;
     private _lastState;

package/vscode/src/vs/editor/browser/controller/editContext/native/editContextFactory.d.ts

@@ -1,3 +1,6 @@
 export declare namespace EditContext {
+    /**
+     * Create an edit context.
+     */
     function create(window: Window, options?: EditContextInit): EditContext;
 }

package/vscode/src/vs/editor/browser/controller/editContext/native/nativeEditContext.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 .native-edit-context {
 	margin: 0;
 	padding: 0;
@@ -7,6 +12,7 @@
 	z-index: -10;
 	white-space: pre-wrap;
 }
+
 .monaco-editor .ime-text-area {
 	min-width: 0;
 	min-height: 0;
@@ -21,19 +27,24 @@
 	background-color: transparent;
 	z-index: -10;
 }
+
 .monaco-editor .edit-context-composition-none {
 	background-color: transparent;
 	border-bottom: none;
 }
+
 .monaco-editor :not(.hc-black, .hc-light) .edit-context-composition-secondary {
 	border-bottom: 1px solid var(--vscode-editor-compositionBorder);
 }
+
 .monaco-editor :not(.hc-black, .hc-light) .edit-context-composition-primary {
 	border-bottom: 2px solid var(--vscode-editor-compositionBorder);
 }
+
 .monaco-editor :is(.hc-black, .hc-light) .edit-context-composition-secondary {
 	border: 1px solid var(--vscode-editor-compositionBorder);
 }
+
 .monaco-editor :is(.hc-black, .hc-light) .edit-context-composition-primary {
 	border: 2px solid var(--vscode-editor-compositionBorder);
 }

package/vscode/src/vs/editor/browser/controller/editContext/native/screenReaderUtils.d.ts

@@ -2,10 +2,28 @@ import { IComputedEditorOptions } from "../../../../common/config/editorOptions.
 import { Selection } from "../../../../common/core/selection.js";
 export interface IScreenReaderContent {
     dispose(): void;
+    /**
+     * Handle screen reader content before cutting the content
+     */
     onWillCut(): void;
+    /**
+     * Handle screen reader content before pasting the content
+     */
     onWillPaste(): void;
+    /**
+     * Handle focus changes
+     */
     onFocusChange(newFocusValue: boolean): void;
+    /**
+     * Handle configuration changes
+     */
     onConfigurationChanged(options: IComputedEditorOptions): void;
+    /**
+     * Update the screen reader content given the selection. It will update the content and set the range within the screen reader content if needed.
+     */
     updateScreenReaderContent(primarySelection: Selection): void;
+    /**
+     * Update the scroll top value of the screen reader content
+     */
     updateScrollTop(primarySelection: Selection): void;
 }

package/vscode/src/vs/editor/browser/controller/editContext/screenReaderUtils.d.ts

@@ -9,10 +9,15 @@ export interface IPagedScreenReaderStrategy<T> {
 }
 export interface ISimpleScreenReaderContentState {
     value: string;
+    /** the offset where selection starts inside `value` */
     selectionStart: number;
+    /** the offset where selection ends inside `value` */
     selectionEnd: number;
+    /** the editor range in the view coordinate system that matches the selection inside `value` */
     selection: Range;
+    /** the position of the start of the `value` in the editor */
     startPositionWithinEditor: Position;
+    /** the visible line count (wrapped, not necessarily matching \n characters) for the text in `value` before `selectionStart` */
     newlineCountBeforeSelection: number;
 }
 export declare class SimplePagedScreenReaderStrategy implements IPagedScreenReaderStrategy<ISimpleScreenReaderContentState> {

package/vscode/src/vs/editor/browser/controller/editContext/textArea/textAreaEditContext.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 .inputarea {
 	min-width: 0;
 	min-height: 0;
@@ -12,6 +17,20 @@
 	background-color: transparent;
 	z-index: -10;
 }
+/*.monaco-editor .inputarea {
+	position: fixed !important;
+	width: 800px !important;
+	height: 500px !important;
+	top: initial !important;
+	left: initial !important;
+	bottom: 0 !important;
+	right: 0 !important;
+	color: black !important;
+	background: white !important;
+	line-height: 15px !important;
+	font-size: 14px !important;
+	z-index: 10 !important;
+}*/
 .monaco-editor .inputarea.ime-input {
 	z-index: 10;
 	caret-color: var(--vscode-editorCursor-foreground);

package/vscode/src/vs/editor/browser/controller/editContext/textArea/textAreaEditContext.d.ts

@@ -30,9 +30,16 @@ export declare class TextAreaEditContext extends AbstractEditContext {
     private _fontInfo;
     private _emptySelectionClipboard;
     private _copyWithSyntaxHighlighting;
+    /**
+     * Defined only when the text area is visible (composition case).
+     */
     private _visibleTextArea;
     private _selections;
     private _modelSelections;
+    /**
+     * The position at which the textarea was rendered.
+     * This is useful for hit-testing and determining the mouse position.
+     */
     private _lastRenderPosition;
     readonly textArea: FastDomNode<HTMLTextAreaElement>;
     readonly textAreaCover: FastDomNode<HTMLElement>;

package/vscode/src/vs/editor/browser/controller/editContext/textArea/textAreaEditContextInput.d.ts

@@ -53,6 +53,14 @@ export interface IBrowser {
     isChrome: boolean;
     isSafari: boolean;
 }
+/**
+ * Writes screen reader content to the textarea and is able to analyze its input events to generate:
+ *  - onCut
+ *  - onPaste
+ *  - onType
+ *
+ * Composition events are generated for presentation purposes (composition input is reflected in onType).
+ */
 export declare class TextAreaInput extends Disposable {
     private readonly _host;
     private readonly _textArea;

package/vscode/src/vs/editor/browser/controller/editContext/textArea/textAreaEditContextState.d.ts

@@ -17,12 +17,24 @@ export interface ITypeData {
 }
 export declare class TextAreaState {
     readonly value: string;
+    /** the offset where selection starts inside `value` */
     readonly selectionStart: number;
+    /** the offset where selection ends inside `value` */
     readonly selectionEnd: number;
+    /** the editor range in the view coordinate system that matches the selection inside `value` */
     readonly selection: Range | null;
+    /** the visible line count (wrapped, not necessarily matching \n characters) for the text in `value` before `selectionStart` */
     readonly newlineCountBeforeSelection: number | undefined;
     static readonly EMPTY: TextAreaState;
-    constructor(value: string, selectionStart: number, selectionEnd: number, selection: Range | null, newlineCountBeforeSelection: number | undefined);
+    constructor(value: string, 
+    /** the offset where selection starts inside `value` */
+    selectionStart: number, 
+    /** the offset where selection ends inside `value` */
+    selectionEnd: number, 
+    /** the editor range in the view coordinate system that matches the selection inside `value` */
+    selection: Range | null, 
+    /** the visible line count (wrapped, not necessarily matching \n characters) for the text in `value` before `selectionStart` */
+    newlineCountBeforeSelection: number | undefined);
     toString(): string;
     static readFromTextArea(textArea: ITextAreaWrapper, previousState: TextAreaState | null): TextAreaState;
     collapseSelection(): TextAreaState;