@codingame/monaco-vscode-base-service-override 20.1.1 → 20.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-base-service-override",
-  "version": "20.1.1",
+  "version": "20.2.0",
   "private": false,
   "description": "VSCode public API plugged on the monaco editor - base service-override",
   "keywords": [],
@@ -15,13 +15,13 @@
   },
   "type": "module",
   "dependencies": {
-    "@codingame/monaco-vscode-158b9837-fc78-5d9c-86f5-9134e4358643-common": "20.1.1",
-    "@codingame/monaco-vscode-23aade48-f094-5c08-9555-97fc9cca96c9-common": "20.1.1",
-    "@codingame/monaco-vscode-34a0ffd3-b9f5-5699-b43b-38af5732f38a-common": "20.1.1",
-    "@codingame/monaco-vscode-60014c9d-b815-501d-83a9-4b08725c2ec2-common": "20.1.1",
-    "@codingame/monaco-vscode-9a1a5840-af83-5d07-a156-ba32a36c5c4b-common": "20.1.1",
-    "@codingame/monaco-vscode-api": "20.1.1",
-    "@codingame/monaco-vscode-d987325e-3e05-53aa-b9ff-6f97476f64db-common": "20.1.1"
+    "@codingame/monaco-vscode-158b9837-fc78-5d9c-86f5-9134e4358643-common": "20.2.0",
+    "@codingame/monaco-vscode-23aade48-f094-5c08-9555-97fc9cca96c9-common": "20.2.0",
+    "@codingame/monaco-vscode-34a0ffd3-b9f5-5699-b43b-38af5732f38a-common": "20.2.0",
+    "@codingame/monaco-vscode-60014c9d-b815-501d-83a9-4b08725c2ec2-common": "20.2.0",
+    "@codingame/monaco-vscode-9a1a5840-af83-5d07-a156-ba32a36c5c4b-common": "20.2.0",
+    "@codingame/monaco-vscode-api": "20.2.0",
+    "@codingame/monaco-vscode-d987325e-3e05-53aa-b9ff-6f97476f64db-common": "20.2.0"
   },
   "main": "index.js",
   "module": "index.js",

package/vscode/src/vs/workbench/services/url/browser/urlService.d.ts

@@ -5,7 +5,26 @@ import { IBrowserWorkbenchEnvironmentService } from "@codingame/monaco-vscode-34
 import { IOpenerService } from "@codingame/monaco-vscode-api/vscode/vs/platform/opener/common/opener.service";
 import { IProductService } from "@codingame/monaco-vscode-api/vscode/vs/platform/product/common/productService.service";
 export interface IURLCallbackProvider {
+    /**
+     * Indicates that a Uri has been opened outside of VSCode. The Uri
+     * will be forwarded to all installed Uri handlers in the system.
+     */
     readonly onCallback: Event<URI>;
+    /**
+     * Creates a Uri that - if opened in a browser - must result in
+     * the `onCallback` to fire.
+     *
+     * The optional `Partial<UriComponents>` must be properly restored for
+     * the Uri passed to the `onCallback` handler.
+     *
+     * For example: if a Uri is to be created with `scheme:"vscode"`,
+     * `authority:"foo"` and `path:"bar"` the `onCallback` should fire
+     * with a Uri `vscode://foo/bar`.
+     *
+     * If there are additional `query` values in the Uri, they should
+     * be added to the list of provided `query` arguments from the
+     * `Partial<UriComponents>`.
+     */
     create(options?: Partial<UriComponents>): URI;
 }
 export declare class BrowserURLService extends AbstractURLService {

package/vscode/src/vs/workbench/services/userActivity/common/userActivityService.d.ts

@@ -4,6 +4,10 @@ import { IInstantiationService } from "@codingame/monaco-vscode-api/vscode/vs/pl
 import { IUserActivityService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/userActivity/common/userActivityService.service";
 export interface IMarkActiveOptions {
     whenHeldFor?: number;
+    /**
+     * Only consider this progress if the state is already active. Used to avoid
+     * background work from incorrectly marking the user as active (#237386)
+     */
     extendOnly?: boolean;
 }
 export declare class UserActivityService extends Disposable implements IUserActivityService {
@@ -11,8 +15,17 @@ export declare class UserActivityService extends Disposable implements IUserActi
     private readonly markInactive;
     private readonly changeEmitter;
     private active;
+    /**
+     * @inheritdoc
+     *
+     * Note: initialized to true, since the user just did something to open the
+     * window. The bundled DomActivityTracker will initially assume activity
+     * as well in order to unset this if the window gets abandoned.
+     */
     isActive: boolean;
+    /** @inheritdoc */
     onDidChangeIsActive: Event<boolean>;
     constructor(instantiationService: IInstantiationService);
+    /** @inheritdoc */
     markActive(opts?: IMarkActiveOptions): IDisposable;
 }

package/vscode/src/vs/workbench/services/workingCopy/common/workingCopyFileService.d.ts

@@ -14,27 +14,70 @@ import { IProgress, IProgressStep } from "@codingame/monaco-vscode-api/vscode/vs
 import { IStoredFileWorkingCopy, IStoredFileWorkingCopyModel } from "@codingame/monaco-vscode-6f931a91-88ea-5232-897f-a17ec3929ba5-common/vscode/vs/workbench/services/workingCopy/common/storedFileWorkingCopy";
 import { IWorkingCopyFileService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/workingCopy/common/workingCopyFileService.service";
 export interface SourceTargetPair {
+    /**
+     * The source resource that is defined for move operations.
+     */
     readonly source?: URI;
+    /**
+     * The target resource the event is about.
+     */
     readonly target: URI;
 }
 export interface IFileOperationUndoRedoInfo {
+    /**
+     * Id of the undo group that the file operation belongs to.
+     */
     undoRedoGroupId?: number;
+    /**
+     * Flag indicates if the operation is an undo.
+     */
     isUndoing?: boolean;
 }
 export interface WorkingCopyFileEvent extends IWaitUntil {
+    /**
+     * An identifier to correlate the operation through the
+     * different event types (before, after, error).
+     */
     readonly correlationId: number;
+    /**
+     * The file operation that is taking place.
+     */
     readonly operation: FileOperation;
+    /**
+     * The array of source/target pair of files involved in given operation.
+     */
     readonly files: readonly SourceTargetPair[];
 }
 export interface IWorkingCopyFileOperationParticipant {
+    /**
+     * Participate in a file operation of working copies. Allows to
+     * change the working copies before they are being saved to disk.
+     */
     participate(files: SourceTargetPair[], operation: FileOperation, undoInfo: IFileOperationUndoRedoInfo | undefined, timeout: number, token: CancellationToken): Promise<void>;
 }
 export interface IStoredFileWorkingCopySaveParticipantContext {
+    /**
+     * The reason why the save was triggered.
+     */
     readonly reason: SaveReason;
+    /**
+     * Only applies to when a text file was saved as, for
+     * example when starting with untitled and saving. This
+     * provides access to the initial resource the text
+     * file had before.
+     */
     readonly savedFrom?: URI;
 }
 export interface IStoredFileWorkingCopySaveParticipant {
+    /**
+     * The ordinal number which determines the order of participation.
+     * Lower values mean to participant sooner
+     */
     readonly ordinal?: number;
+    /**
+     * Participate in a save operation of file stored working copies.
+     * Allows to make changes before content is being saved to disk.
+     */
     participate(workingCopy: IStoredFileWorkingCopy<IStoredFileWorkingCopyModel>, context: IStoredFileWorkingCopySaveParticipantContext, progress: IProgress<IProgressStep>, token: CancellationToken): Promise<void>;
 }
 export interface ICreateOperation {
@@ -55,6 +98,9 @@ export interface IMoveOperation {
 }
 export interface ICopyOperation extends IMoveOperation {
 }
+/**
+ * Returns the working copies for a given resource.
+ */
 export type WorkingCopyProvider = (resourceOrFolder: URI) => IWorkingCopy[];
 export declare class WorkingCopyFileService extends Disposable implements IWorkingCopyFileService {
     private readonly fileService;