@codingame/monaco-vscode-configuration-service-override 20.1.1 → 20.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codingame/monaco-vscode-configuration-service-override",
-  "version": "20.1.1",
+  "version": "20.2.1",
   "private": false,
   "description": "VSCode public API plugged on the monaco editor - configuration 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-422642f2-7e3a-5c1c-9e1e-1d3ef1817346-common": "20.1.1",
-    "@codingame/monaco-vscode-api": "20.1.1",
-    "@codingame/monaco-vscode-ce7c734f-7712-563c-9335-d7acb43306af-common": "20.1.1",
-    "@codingame/monaco-vscode-d987325e-3e05-53aa-b9ff-6f97476f64db-common": "20.1.1",
-    "@codingame/monaco-vscode-f24e325c-2ce0-5bba-8236-bfc4f53180ab-common": "20.1.1",
-    "@codingame/monaco-vscode-files-service-override": "20.1.1"
+    "@codingame/monaco-vscode-158b9837-fc78-5d9c-86f5-9134e4358643-common": "20.2.1",
+    "@codingame/monaco-vscode-422642f2-7e3a-5c1c-9e1e-1d3ef1817346-common": "20.2.1",
+    "@codingame/monaco-vscode-api": "20.2.1",
+    "@codingame/monaco-vscode-ce7c734f-7712-563c-9335-d7acb43306af-common": "20.2.1",
+    "@codingame/monaco-vscode-d987325e-3e05-53aa-b9ff-6f97476f64db-common": "20.2.1",
+    "@codingame/monaco-vscode-f24e325c-2ce0-5bba-8236-bfc4f53180ab-common": "20.2.1",
+    "@codingame/monaco-vscode-files-service-override": "20.2.1"
   },
   "main": "index.js",
   "module": "index.js",

package/vscode/src/vs/platform/assignment/common/assignment.d.ts

@@ -11,14 +11,42 @@ export declare enum TargetPopulation {
     Exploration = "exploration"
 }
 export declare enum Filters {
+    /**
+     * The market in which the extension is distributed.
+     */
     Market = "X-MSEdge-Market",
+    /**
+     * The corporation network.
+     */
     CorpNet = "X-FD-Corpnet",
+    /**
+     * Version of the application which uses experimentation service.
+     */
     ApplicationVersion = "X-VSCode-AppVersion",
+    /**
+     * Insiders vs Stable.
+     */
     Build = "X-VSCode-Build",
+    /**
+     * Client Id which is used as primary unit for the experimentation.
+     */
     ClientId = "X-MSEdge-ClientId",
+    /**
+     * Extension header.
+     */
     ExtensionName = "X-VSCode-ExtensionName",
+    /**
+     * The version of the extension.
+     */
     ExtensionVersion = "X-VSCode-ExtensionVersion",
+    /**
+     * The language in use by VS Code
+     */
     Language = "X-VSCode-Language",
+    /**
+     * The target population.
+     * This is used to separate internal, early preview, GA, etc.
+     */
     TargetPopulation = "X-VSCode-TargetPopulation"
 }
 export declare class AssignmentFilterProvider implements IExperimentationFilterProvider {
@@ -27,6 +55,13 @@ export declare class AssignmentFilterProvider implements IExperimentationFilterP
     private machineId;
     private targetPopulation;
     constructor(version: string, appName: string, machineId: string, targetPopulation: TargetPopulation);
+    /**
+     * Returns a version string that can be parsed by the TAS client.
+     * The tas client cannot handle suffixes lke "-insider"
+     * Ref: https://github.com/microsoft/tas-client/blob/30340d5e1da37c2789049fcf45928b954680606f/vscode-tas-client/src/vscode-tas-client/VSCodeFilterProvider.ts#L35
+     *
+     * @param version Version string to be trimmed.
+    */
     private static trimVersionSuffix;
     getFilterValue(filter: string): string | null;
     getFilters(): Map<string, any>;

package/vscode/src/vs/workbench/contrib/workspaces/browser/workspaces.contribution.d.ts

@@ -6,6 +6,10 @@ import { INotificationService } from "@codingame/monaco-vscode-api/vscode/vs/pla
 import { IHostService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/host/browser/host.service";
 import { IQuickInputService } from "@codingame/monaco-vscode-api/vscode/vs/platform/quickinput/common/quickInput.service";
 import { IStorageService } from "@codingame/monaco-vscode-api/vscode/vs/platform/storage/common/storage.service";
+/**
+ * A workbench contribution that will look for `.code-workspace` files in the root of the
+ * workspace folder and open a notification to suggest to open one of the workspaces.
+ */
 export declare class WorkspacesFinderContribution extends Disposable implements IWorkbenchContribution {
     private readonly contextService;
     private readonly notificationService;

package/vscode/src/vs/workbench/services/configuration/browser/configurationService.d.ts

@@ -97,6 +97,19 @@ export declare class WorkspaceService extends Disposable implements IWorkbenchCo
         workspaceFolder: string[];
     };
     whenRemoteConfigurationLoaded(): Promise<void>;
+    /**
+     * At present, all workspaces (empty, single-folder, multi-root) in local and remote
+     * can be initialized without requiring extension host except following case:
+     *
+     * A multi root workspace with .code-workspace file that has to be resolved by an extension.
+     * Because of readonly `rootPath` property in extension API we have to resolve multi root workspace
+     * before extension host starts so that `rootPath` can be set to first folder.
+     *
+     * This restriction is lifted partially for web in `MainThreadWorkspace`.
+     * In web, we start extension host with empty `rootPath` in this case.
+     *
+     * Related root path issue discussion is being tracked here - https://github.com/microsoft/vscode/issues/69335
+     */
     initialize(arg: IAnyWorkspaceIdentifier): Promise<void>;
     updateWorkspaceTrust(trusted: boolean): void;
     acquireInstantiationService(instantiationService: IInstantiationService): void;

package/vscode/src/vs/workbench/services/configuration/common/configurationEditing.d.ts

@@ -14,19 +14,61 @@ import { IUserDataProfilesService } from "@codingame/monaco-vscode-api/vscode/vs
 import { ErrorNoTelemetry } from "@codingame/monaco-vscode-api/vscode/vs/base/common/errors";
 import { IFilesConfigurationService } from "@codingame/monaco-vscode-api/vscode/vs/workbench/services/filesConfiguration/common/filesConfigurationService.service";
 export declare enum ConfigurationEditingErrorCode {
+    /**
+     * Error when trying to write a configuration key that is not registered.
+     */
     ERROR_UNKNOWN_KEY = 0,
+    /**
+     * Error when trying to write an application setting into workspace settings.
+     */
     ERROR_INVALID_WORKSPACE_CONFIGURATION_APPLICATION = 1,
+    /**
+     * Error when trying to write a machne setting into workspace settings.
+     */
     ERROR_INVALID_WORKSPACE_CONFIGURATION_MACHINE = 2,
+    /**
+     * Error when trying to write an invalid folder configuration key to folder settings.
+     */
     ERROR_INVALID_FOLDER_CONFIGURATION = 3,
+    /**
+     * Error when trying to write to user target but not supported for provided key.
+     */
     ERROR_INVALID_USER_TARGET = 4,
+    /**
+     * Error when trying to write to user target but not supported for provided key.
+     */
     ERROR_INVALID_WORKSPACE_TARGET = 5,
+    /**
+     * Error when trying to write a configuration key to folder target
+     */
     ERROR_INVALID_FOLDER_TARGET = 6,
+    /**
+     * Error when trying to write to language specific setting but not supported for preovided key
+     */
     ERROR_INVALID_RESOURCE_LANGUAGE_CONFIGURATION = 7,
+    /**
+     * Error when trying to write to the workspace configuration without having a workspace opened.
+     */
     ERROR_NO_WORKSPACE_OPENED = 8,
+    /**
+     * Error when trying to write and save to the configuration file while it is dirty in the editor.
+     */
     ERROR_CONFIGURATION_FILE_DIRTY = 9,
+    /**
+     * Error when trying to write and save to the configuration file while it is not the latest in the disk.
+     */
     ERROR_CONFIGURATION_FILE_MODIFIED_SINCE = 10,
+    /**
+     * Error when trying to write to a configuration file that contains JSON errors.
+     */
     ERROR_INVALID_CONFIGURATION = 11,
+    /**
+     * Error when trying to write a policy configuration
+     */
     ERROR_POLICY_CONFIGURATION = 12,
+    /**
+     * Internal Error.
+     */
     ERROR_INTERNAL = 13
 }
 export declare class ConfigurationEditingError extends ErrorNoTelemetry {
@@ -38,6 +80,9 @@ export interface IConfigurationValue {
     value: unknown;
 }
 export interface IConfigurationEditingOptions extends IConfigurationUpdateOptions {
+    /**
+     * Scope of configuration to be written into.
+     */
     scopes?: IConfigurationUpdateOverrides;
 }
 export declare enum EditableConfigurationTarget {