@codingame/monaco-vscode-api 1.79.1 → 1.79.2-next.0

package/dist/editorBrowser.d.ts

@@ -1,5 +1,5 @@
 import { S as ServiceIdentifier } from './instantiation.js';
-import { a as IDisposable, E as Event, I as IReference } from './event.js';
+import { a as IDisposable, E as Event, I as IReference, D as Disposable } from './event.js';
 import { a as UriComponents, U as URI } from './uri.js';
 import * as monaco from 'monaco-editor';
 import { a as ThemeColor } from './themables.js';
@@ -301,6 +301,7 @@ declare class Range {
  * A range of lines (1-based).
  */
 declare class LineRange {
+    static fromRange(range: Range): LineRange;
     /**
      * @param lineRanges An array of sorted line ranges.
      */
@@ -310,6 +311,7 @@ declare class LineRange {
      * @param lineRanges2 Must be sorted.
      */
     static join(lineRanges1: readonly LineRange[], lineRanges2: readonly LineRange[]): readonly LineRange[];
+    static ofLength(startLineNumber: number, length: number): LineRange;
     /**
      * The start line number.
      */
@@ -345,14 +347,18 @@ declare class LineRange {
      * If the ranges don't even touch, the result is undefined.
      */
     intersect(other: LineRange): LineRange | undefined;
+    intersectsStrict(other: LineRange): boolean;
     overlapOrTouch(other: LineRange): boolean;
     equals(b: LineRange): boolean;
+    toInclusiveRange(): Range | null;
+    toExclusiveRange(): Range;
 }
 
 /**
  * Maps a line range in the original text model to a line range in the modified text model.
  */
 declare class LineRangeMapping {
+    static inverse(mapping: LineRangeMapping[], originalLineCount: number, modifiedLineCount: number): LineRangeMapping[];
     /**
      * The line range in the original text model.
      */
@@ -1144,7 +1150,7 @@ interface IDocumentDiffProvider {
  */
 interface IDocumentDiffProviderOptions {
     /**
-     * When set to true, the diff should ignore whitespace changes.i
+     * When set to true, the diff should ignore whitespace changes.
      */
     ignoreTrimWhitespace: boolean;
     /**
@@ -1850,6 +1856,10 @@ interface IEditorOptions$1 {
      * When enabled, this shows a preview of the drop location and triggers an `onDropIntoEditor` event.
      */
     dropIntoEditor?: IDropIntoEditorOptions;
+    /**
+     * Controls support for changing how content is pasted into the editor.
+     */
+    pasteAs?: IPasteAsOptions;
     /**
      * Controls whether the editor receives tabs or defers them to the workbench for navigation.
      */
@@ -1924,11 +1934,22 @@ interface IDiffEditorBaseOptions {
      * Whether the diff editor aria label should be verbose.
      */
     accessibilityVerbose?: boolean;
+    experimental?: {
+        /**
+         * Defaults to false.
+         */
+        collapseUnchangedRegions?: boolean;
+    };
 }
 /**
  * Configuration options for the diff editor.
  */
 interface IDiffEditorOptions extends IEditorOptions$1, IDiffEditorBaseOptions {
+    /**
+     * Is the diff editor inside another editor
+     * Defaults to false
+     */
+    isInEmbeddedEditor?: boolean;
 }
 /**
  * Configuration options for editor comments
@@ -2499,6 +2520,21 @@ interface IDropIntoEditorOptions {
      */
     showDropSelector?: 'afterDrop' | 'never';
 }
+/**
+ * Configuration options for editor pasting as into behavior
+ */
+interface IPasteAsOptions {
+    /**
+     * Enable paste as functionality in editors.
+     * Defaults to true.
+     */
+    enabled?: boolean;
+    /**
+     * Controls if a widget is shown after a drop.
+     * Defaults to 'afterPaste'.
+     */
+    showPasteSelector?: 'afterPaste' | 'never';
+}
 
 interface IDiffComputationResult {
     quitEarly: boolean;
@@ -3345,6 +3381,227 @@ interface IResolvedTextEditorModel extends ITextEditorModel {
     readonly textEditorModel: ITextModel;
 }
 
+/**
+ * A vertical sash layout provider provides position and height for a sash.
+ */
+interface IVerticalSashLayoutProvider {
+    getVerticalSashLeft(sash: Sash): number;
+    getVerticalSashTop?(sash: Sash): number;
+    getVerticalSashHeight?(sash: Sash): number;
+}
+/**
+ * A vertical sash layout provider provides position and width for a sash.
+ */
+interface IHorizontalSashLayoutProvider {
+    getHorizontalSashTop(sash: Sash): number;
+    getHorizontalSashLeft?(sash: Sash): number;
+    getHorizontalSashWidth?(sash: Sash): number;
+}
+interface ISashEvent {
+    readonly startX: number;
+    readonly currentX: number;
+    readonly startY: number;
+    readonly currentY: number;
+    readonly altKey: boolean;
+}
+declare enum OrthogonalEdge {
+    North = "north",
+    South = "south",
+    East = "east",
+    West = "west"
+}
+interface IBoundarySashes {
+    readonly top?: Sash;
+    readonly right?: Sash;
+    readonly bottom?: Sash;
+    readonly left?: Sash;
+}
+interface ISashOptions {
+    /**
+     * Whether a sash is horizontal or vertical.
+     */
+    readonly orientation: Orientation;
+    /**
+     * The width or height of a vertical or horizontal sash, respectively.
+     */
+    readonly size?: number;
+    /**
+     * A reference to another sash, perpendicular to this one, which
+     * aligns at the start of this one. A corner sash will be created
+     * automatically at that location.
+     *
+     * The start of a horizontal sash is its left-most position.
+     * The start of a vertical sash is its top-most position.
+     */
+    readonly orthogonalStartSash?: Sash;
+    /**
+     * A reference to another sash, perpendicular to this one, which
+     * aligns at the end of this one. A corner sash will be created
+     * automatically at that location.
+     *
+     * The end of a horizontal sash is its right-most position.
+     * The end of a vertical sash is its bottom-most position.
+     */
+    readonly orthogonalEndSash?: Sash;
+    /**
+     * Provides a hint as to what mouse cursor to use whenever the user
+     * hovers over a corner sash provided by this and an orthogonal sash.
+     */
+    readonly orthogonalEdge?: OrthogonalEdge;
+}
+interface IVerticalSashOptions extends ISashOptions {
+    readonly orientation: Orientation.VERTICAL;
+}
+interface IHorizontalSashOptions extends ISashOptions {
+    readonly orientation: Orientation.HORIZONTAL;
+}
+declare const enum Orientation {
+    VERTICAL = 0,
+    HORIZONTAL = 1
+}
+declare const enum SashState {
+    /**
+     * Disable any UI interaction.
+     */
+    Disabled = 0,
+    /**
+     * Allow dragging down or to the right, depending on the sash orientation.
+     *
+     * Some OSs allow customizing the mouse cursor differently whenever
+     * some resizable component can't be any smaller, but can be larger.
+     */
+    AtMinimum = 1,
+    /**
+     * Allow dragging up or to the left, depending on the sash orientation.
+     *
+     * Some OSs allow customizing the mouse cursor differently whenever
+     * some resizable component can't be any larger, but can be smaller.
+     */
+    AtMaximum = 2,
+    /**
+     * Enable dragging.
+     */
+    Enabled = 3
+}
+/**
+ * The {@link Sash} is the UI component which allows the user to resize other
+ * components. It's usually an invisible horizontal or vertical line which, when
+ * hovered, becomes highlighted and can be dragged along the perpendicular dimension
+ * to its direction.
+ *
+ * Features:
+ * - Touch event handling
+ * - Corner sash support
+ * - Hover with different mouse cursor support
+ * - Configurable hover size
+ * - Linked sash support, for 2x2 corner sashes
+ */
+declare class Sash extends Disposable {
+    private el;
+    private layoutProvider;
+    private orientation;
+    private size;
+    private hoverDelay;
+    private hoverDelayer;
+    private _state;
+    private readonly onDidEnablementChange;
+    private readonly _onDidStart;
+    private readonly _onDidChange;
+    private readonly _onDidReset;
+    private readonly _onDidEnd;
+    private readonly orthogonalStartSashDisposables;
+    private _orthogonalStartSash;
+    private readonly orthogonalStartDragHandleDisposables;
+    private _orthogonalStartDragHandle;
+    private readonly orthogonalEndSashDisposables;
+    private _orthogonalEndSash;
+    private readonly orthogonalEndDragHandleDisposables;
+    private _orthogonalEndDragHandle;
+    get state(): SashState;
+    get orthogonalStartSash(): Sash | undefined;
+    get orthogonalEndSash(): Sash | undefined;
+    /**
+     * The state of a sash defines whether it can be interacted with by the user
+     * as well as what mouse cursor to use, when hovered.
+     */
+    set state(state: SashState);
+    /**
+     * An event which fires whenever the user starts dragging this sash.
+     */
+    readonly onDidStart: Event<ISashEvent>;
+    /**
+     * An event which fires whenever the user moves the mouse while
+     * dragging this sash.
+     */
+    readonly onDidChange: Event<ISashEvent>;
+    /**
+     * An event which fires whenever the user double clicks this sash.
+     */
+    readonly onDidReset: Event<void>;
+    /**
+     * An event which fires whenever the user stops dragging this sash.
+     */
+    readonly onDidEnd: Event<void>;
+    /**
+     * A linked sash will be forwarded the same user interactions and events
+     * so it moves exactly the same way as this sash.
+     *
+     * Useful in 2x2 grids. Not meant for widespread usage.
+     */
+    linkedSash: Sash | undefined;
+    /**
+     * A reference to another sash, perpendicular to this one, which
+     * aligns at the start of this one. A corner sash will be created
+     * automatically at that location.
+     *
+     * The start of a horizontal sash is its left-most position.
+     * The start of a vertical sash is its top-most position.
+     */
+    set orthogonalStartSash(sash: Sash | undefined);
+    /**
+     * A reference to another sash, perpendicular to this one, which
+     * aligns at the end of this one. A corner sash will be created
+     * automatically at that location.
+     *
+     * The end of a horizontal sash is its right-most position.
+     * The end of a vertical sash is its bottom-most position.
+     */
+    set orthogonalEndSash(sash: Sash | undefined);
+    /**
+     * Create a new vertical sash.
+     *
+     * @param container A DOM node to append the sash to.
+     * @param verticalLayoutProvider A vertical layout provider.
+     * @param options The options.
+     */
+    constructor(container: HTMLElement, verticalLayoutProvider: IVerticalSashLayoutProvider, options: IVerticalSashOptions);
+    /**
+     * Create a new horizontal sash.
+     *
+     * @param container A DOM node to append the sash to.
+     * @param horizontalLayoutProvider A horizontal layout provider.
+     * @param options The options.
+     */
+    constructor(container: HTMLElement, horizontalLayoutProvider: IHorizontalSashLayoutProvider, options: IHorizontalSashOptions);
+    private onPointerStart;
+    private onPointerDoublePress;
+    private static onMouseEnter;
+    private static onMouseLeave;
+    /**
+     * Forcefully stop any user interactions with this sash.
+     * Useful when hiding a parent component, while the user is still
+     * interacting with the sash.
+     */
+    clearSashHoverState(): void;
+    /**
+     * Layout the sash. The sash will size and position itself
+     * based on its provided {@link ISashLayoutProvider layout provider}.
+     */
+    layout(): void;
+    private getOrthogonalSash;
+    dispose(): void;
+}
+
 /**
  * A rich code editor.
  */
@@ -3440,6 +3697,18 @@ interface IDiffEditor extends IEditor {
      * Update the editor's options after the editor has been created.
      */
     updateOptions(newOptions: IDiffEditorOptions): void;
+    /**
+     * @internal
+     */
+    setBoundarySashes(sashes: IBoundarySashes): void;
+    /**
+     * @internal
+     */
+    goToDiff(target: 'next' | 'previous'): void;
+    /**
+     * @internal
+     */
+    revealFirstDiff(): unknown;
 }
 
-export { IChange as A, IDiffEditor as B, IDecorationRenderOptions as C, ITextModelContentProvider as D, EndOfLineSequence as E, ITextModelService as F, IEditorOptions as I, MarkdownStringTrustedOptions as M, Position as P, Range as R, Selection as S, IResolvedTextEditorModel as a, ICodeEditor as b, ITextModel as c, IModelDecorationOptions as d, IModelDecorationsChangeAccessor as e, IEditorContribution as f, IPosition as g, IRange as h, IMarkdownString as i, ISingleEditOperation as j, EditorAutoIndentStrategy as k, IEditorModel as l, IDimension as m, ITextEditorModel as n, ITextSnapshot as o, ITextBufferFactory as p, IDiffEditor$1 as q, IBaseTextResourceEditorInput as r, IBaseUntypedEditorInput as s, IResourceEditorInput as t, ITextResourceEditorInput as u, ITextModelCreationOptions as v, IEditor as w, IResourceEditorInputIdentifier as x, IDocumentDiffProviderOptions as y, IDocumentDiff as z };
+export { IChange as A, IBoundarySashes as B, IDiffEditor as C, IDecorationRenderOptions as D, EndOfLineSequence as E, ITextModelContentProvider as F, ITextModelService as G, IEditorOptions as I, MarkdownStringTrustedOptions as M, Orientation as O, Position as P, Range as R, Selection as S, IResolvedTextEditorModel as a, ICodeEditor as b, ITextModel as c, IModelDecorationOptions as d, IModelDecorationsChangeAccessor as e, IEditorContribution as f, IPosition as g, IRange as h, IMarkdownString as i, ISingleEditOperation as j, EditorAutoIndentStrategy as k, IEditorModel as l, IDimension as m, ITextEditorModel as n, ITextSnapshot as o, ITextBufferFactory as p, IDiffEditor$1 as q, IBaseTextResourceEditorInput as r, IBaseUntypedEditorInput as s, IResourceEditorInput as t, ITextResourceEditorInput as u, ITextModelCreationOptions as v, IEditor as w, IResourceEditorInputIdentifier as x, IDocumentDiffProviderOptions as y, IDocumentDiff as z };

package/dist/event.d.ts

@@ -115,6 +115,11 @@ declare class LinkedList<E> {
     [Symbol.iterator](): Iterator<E>;
 }
 
+/**
+ * Represents an observable value.
+ * @template T The type of the value.
+ * @template TChange The type of delta information (usually `void` and only used in advanced scenarios).
+ */
 interface IObservable<T, TChange = unknown> {
     /**
      * Returns the current value.
@@ -578,4 +583,4 @@ interface IWaitUntil {
     waitUntil(thenable: Promise<unknown>): void;
 }
 
-export { CancellationToken as C, Disposable as D, Event as E, IReference as I, IDisposable as a, Emitter as b, DisposableStore as c, IWaitUntil as d };
+export { CancellationToken as C, Disposable as D, Event as E, IReference as I, IDisposable as a, DisposableStore as b, Emitter as c, IWaitUntil as d };