@theia/plugin 1.29.0-next.9 → 1.30.0-next.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/plugin",
-  "version": "1.29.0-next.9+7b29ac6f2d1",
+  "version": "1.30.0-next.1+77e8a6029f3",
   "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": "77e8a6029f3d83183f823fd7a53ccdaa54beb47d"
 }

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.
      */
@@ -456,6 +332,23 @@ export module '@theia/plugin' {
         matches: Range | Range[];
     }
 
+    /**
+     * Options to specify the size of the result text preview.
+     * These options don't affect the size of the match itself, just the amount of preview text.
+     */
+    export interface TextSearchPreviewOptions {
+        /**
+         * The maximum number of lines in the preview.
+         * Only search providers that support multiline search will ever return more than one line in the match.
+         */
+        matchLines: number;
+
+        /**
+         * The maximum number of characters included per line.
+         */
+        charsPerLine: number;
+    }
+
     /**
      * A line of context surrounding a TextSearchMatch.
      */
@@ -492,6 +385,18 @@ export module '@theia/plugin' {
          */
         limitHit?: boolean;
     }
+
+    export namespace workspace {
+        /**
+         * Find text in files across all [workspace folders] in the workspace
+         * @param query What to search
+         * @param optionsOrCallback
+         * @param callbackOrToken
+         * @param token
+         */
+        export function findTextInFiles(query: TextSearchQuery, optionsOrCallback: FindTextInFilesOptions | ((result: TextSearchResult) => void),
+            callbackOrToken?: CancellationToken | ((result: TextSearchResult) => void), token?: CancellationToken): Promise<TextSearchComplete>;
+    }
     // #endregion
 
     // #region read/write in chunks: https://github.com/microsoft/vscode/issues/84515
@@ -705,3 +610,21 @@ export module '@theia/plugin' {
 
     // #endregion
 }
+
+/**
+ * Thenable is a common denominator between ES6 promises, Q, jquery.Deferred, WinJS.Promise,
+ * and others. This API makes no assumption about what promise library is being used which
+ * enables reusing existing code without migrating to a specific promise implementation. Still,
+ * we recommend the use of native promises which are available in this editor.
+ */
+interface Thenable<T> {
+    /**
+     * Attaches callbacks for the resolution and/or rejection of the Promise.
+     * @param onfulfilled The callback to execute when the Promise is resolved.
+     * @param onrejected The callback to execute when the Promise is rejected.
+     * @returns A Promise for the completion of which ever callback is executed.
+     */
+    then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => TResult | Thenable<TResult>): Thenable<TResult>;
+    then<TResult>(onfulfilled?: (value: T) => TResult | Thenable<TResult>, onrejected?: (reason: any) => void): Thenable<TResult>;
+}
+