@theia/plugin 1.29.0-next.9 → 1.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.29.0-next.9+7b29ac6f2d1",
+  "version": "1.29.0",
   "description": "Theia - Plugin API",
   "types": "./src/theia.d.ts",
   "publishConfig": {
@@ -27,10 +27,10 @@
     "watch": "theiaext watch"
   },
   "devDependencies": {
-    "@theia/ext-scripts": "1.28.0"
+    "@theia/ext-scripts": "1.29.0"
   },
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "7b29ac6f2d1a75b44b5c5d37ec7ae0200e0c3e99"
+  "gitHead": "054a575b92bd689505dcb74c1573b96483cc687c"
 }

package/src/theia-proposed.d.ts

@@ -21,130 +21,6 @@
  * These API are NOT stable and subject to change. Use it on own risk.
  */
 export module '@theia/plugin' {
-    // #region auth provider
-
-    /**
-     * An [event](#Event) which fires when an [AuthenticationProvider](#AuthenticationProvider) is added or removed.
-     */
-    export interface AuthenticationProvidersChangeEvent {
-        /**
-         * The ids of the [authenticationProvider](#AuthenticationProvider)s that have been added.
-         */
-        readonly added: ReadonlyArray<AuthenticationProviderInformation>;
-
-        /**
-         * The ids of the [authenticationProvider](#AuthenticationProvider)s that have been removed.
-         */
-        readonly removed: ReadonlyArray<AuthenticationProviderInformation>;
-    }
-
-    /**
-     * An [event](#Event) which fires when an [AuthenticationSession](#AuthenticationSession) is added, removed, or changed.
-     */
-    export interface AuthenticationProviderAuthenticationSessionsChangeEvent {
-        /**
-         * The ids of the [AuthenticationSession](#AuthenticationSession)s that have been added.
-         */
-        readonly added: ReadonlyArray<string>;
-
-        /**
-         * The ids of the [AuthenticationSession](#AuthenticationSession)s that have been removed.
-         */
-        readonly removed: ReadonlyArray<string>;
-
-        /**
-         * The ids of the [AuthenticationSession](#AuthenticationSession)s that have been changed.
-         */
-        readonly changed: ReadonlyArray<string>;
-    }
-
-    /**
-     * **WARNING** When writing an AuthenticationProvider, `id` should be treated as part of your extension's
-     * API, changing it is a breaking change for all extensions relying on the provider. The id is
-     * treated case-sensitively.
-     */
-    export interface AuthenticationProvider {
-        /**
-         * Used as an identifier for extensions trying to work with a particular
-         * provider: 'microsoft', 'github', etc. id must be unique, registering
-         * another provider with the same id will fail.
-         */
-        readonly id: string;
-
-        /**
-         * The human-readable name of the provider.
-         */
-        readonly label: string;
-
-        /**
-         * Whether it is possible to be signed into multiple accounts at once with this provider
-         */
-        readonly supportsMultipleAccounts: boolean;
-
-        /**
-         * Returns an array of current sessions.
-         */
-        getSessions(): Thenable<ReadonlyArray<AuthenticationSession>>;
-
-        /**
-         * Prompts a user to login.
-         */
-        login(scopes: string[]): Thenable<AuthenticationSession>;
-
-        /**
-         * Removes the session corresponding to session id.
-         * @param sessionId The session id to log out of
-         */
-        logout(sessionId: string): Thenable<void>;
-    }
-
-    export namespace authentication {
-        /**
-         * Register an authentication provider.
-         *
-         * There can only be one provider per id and an error is being thrown when an id
-         * has already been used by another provider.
-         *
-         * @param provider The authentication provider provider.
-         * @return A [disposable](#Disposable) that unregisters this provider when being disposed.
-         */
-        export function registerAuthenticationProvider(provider: AuthenticationProvider): Disposable;
-
-        /**
-         * Fires with the provider id that was registered or unregistered.
-         */
-        export const onDidChangeAuthenticationProviders: Event<AuthenticationProvidersChangeEvent>;
-
-        /**
-         * @deprecated
-         * The ids of the currently registered authentication providers.
-         * @returns An array of the ids of authentication providers that are currently registered.
-         */
-        export function getProviderIds(): Thenable<ReadonlyArray<string>>;
-
-        /**
-         * @deprecated
-         * An array of the ids of authentication providers that are currently registered.
-         */
-        export const providerIds: ReadonlyArray<string>;
-
-        /**
-         * An array of the information of authentication providers that are currently registered.
-         */
-        export const providers: ReadonlyArray<AuthenticationProviderInformation>;
-
-        /**
-         * @deprecated
-         * Logout of a specific session.
-         * @param providerId The id of the provider to use
-         * @param sessionId The session id to remove
-         * provider
-         */
-        export function logout(providerId: string, sessionId: string): Thenable<void>;
-    }
-
-    // #endregion
-
     /**
      * The contiguous set of modified lines in a diff.
      */

package/src/theia.d.ts

@@ -2353,6 +2353,32 @@ export module '@theia/plugin' {
         ignoreFocusOut?: boolean;
     }
 
+    /**
+     * Impacts the behavior and appearance of the validation message.
+     */
+    export enum InputBoxValidationSeverity {
+        Info = 1,
+        Warning = 2,
+        Error = 3
+    }
+
+    /**
+     * Object to configure the behavior of the validation message.
+     */
+    export interface InputBoxValidationMessage {
+        /**
+         * The validation message to display.
+         */
+        readonly message: string;
+
+        /**
+         * The severity of the validation message.
+         * NOTE: When using `InputBoxValidationSeverity.Error`, the user will not be allowed to accept (hit ENTER) the input.
+         * `Info` and `Warning` will still allow the InputBox to accept the input.
+         */
+        readonly severity: InputBoxValidationSeverity;
+    }
+
     /**
      * Options to configure the behavior of the input box UI.
      */
@@ -2401,10 +2427,10 @@ export module '@theia/plugin' {
          * to the user.
          *
          * @param value The current value of the input box.
-         * @return A human readable string which is presented as diagnostic message.
-         * Return `undefined`, or the empty string when 'value' is valid.
+         * @return Either a human-readable string which is presented as an error message or an {@link InputBoxValidationMessage}
+         *  which can provide a specific message severity. Return `undefined`, `null`, or the empty string when 'value' is valid.
          */
-        validateInput?: (input: string) => Promise<string | null | undefined> | undefined;
+        validateInput?: (input: string) => Promise<string | InputBoxValidationMessage | null | undefined> | undefined;
 
         /**
          * An optional function that will be called on Enter key.
@@ -4465,7 +4491,7 @@ export module '@theia/plugin' {
          * @param token A token that can be used to signal cancellation.
          * @return A promise that resolves to the selection or `undefined`.
          */
-        export function showQuickPick(readonly items: string[] | Thenable<readonly string[]>, options: QuickPickOptions, token?: CancellationToken): Thenable<string | undefined>;
+        export function showQuickPick(items: readonly string[] | Thenable<readonly string[]>, options?: QuickPickOptions, token?: CancellationToken): Thenable<string | undefined>;
 
         /**
          * Shows a selection list allowing multiple selections.
@@ -4475,7 +4501,7 @@ export module '@theia/plugin' {
          * @param token A token that can be used to signal cancellation.
          * @return A promise that resolves to the selected items or `undefined`.
          */
-        export function showQuickPick(readonly items: string[] | Thenable<readonly string[]>, options: QuickPickOptions & { canPickMany: true }, token?: CancellationToken): Thenable<string[] | undefined>;
+        export function showQuickPick(items: readonly string[] | Thenable<readonly string[]>, options: QuickPickOptions & { canPickMany: true }, token?: CancellationToken): Thenable<string[] | undefined>;
 
         /**
          * Shows a selection list.
@@ -4485,7 +4511,7 @@ export module '@theia/plugin' {
          * @param token A token that can be used to signal cancellation.
          * @return A promise that resolves to the selected item or `undefined`.
          */
-        export function showQuickPick<T extends QuickPickItem>(items: readonly T[] | Thenable<readonly T[]>, options: QuickPickOptions, token?: CancellationToken): Thenable<T | undefined>;
+        export function showQuickPick<T extends QuickPickItem>(items: readonly T[] | Thenable<readonly T[]>, options?: QuickPickOptions, token?: CancellationToken): Thenable<T | undefined>;
 
         /**
          * Shows a selection list allowing multiple selections.
@@ -5065,8 +5091,10 @@ export module '@theia/plugin' {
 
         /**
          * An optional validation message indicating a problem with the current input value.
+         * By returning a string, the InputBox will use a default {@link InputBoxValidationSeverity} of Error.
+         * Returning undefined clears the validation message.
          */
-        validationMessage: string | undefined;
+        validationMessage: string | InputBoxValidationMessage | undefined;
     }
 
     /**
@@ -11815,7 +11843,7 @@ export module '@theia/plugin' {
          * The permissions granted by the session's access token. Available scopes
          * are defined by the [AuthenticationProvider](#AuthenticationProvider).
          */
-        readonly scopes: ReadonlyArray<string>;
+        readonly scopes: readonly string[];
     }
 
     /**
@@ -12050,12 +12078,6 @@ export module '@theia/plugin' {
          * @return A {@link Disposable} that unregisters this provider when being disposed.
          */
         export function registerAuthenticationProvider(id: string, label: string, provider: AuthenticationProvider, options?: AuthenticationProviderOptions): Disposable;
-
-        /**
-         * @deprecated Use {@link getSession()} {@link AuthenticationGetSessionOptions.silent} instead.
-         */
-        export function hasSession(providerId: string, scopes: readonly string[]): Thenable<boolean>;
-
     }
 }