@jupyterlab/lsp 4.6.2 → 4.7.0-alpha.1

package/lib/manager.js

@@ -1,11 +1,11 @@
 // Copyright (c) Jupyter Development Team.
 // Distributed under the terms of the Modified BSD License.
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { URLExt } from '@jupyterlab/coreutils';
 import { ServerConnection } from '@jupyterlab/services';
+import { PromiseDelegate } from '@lumino/coreutils';
+import { DisposableDelegate } from '@lumino/disposable';
 import { Signal } from '@lumino/signaling';
 import { ILanguageServerManager } from './tokens';
-import { PromiseDelegate } from '@lumino/coreutils';
 export class LanguageServerManager {
     constructor(options) {
         /**
@@ -16,6 +16,14 @@ export class LanguageServerManager {
          * Map of language server specs.
          */
         this._specs = new Map();
+        /**
+         * Last known language server sessions from HTTP status endpoint.
+         */
+        this._serverSessions = new Map();
+        /**
+         * Last known language server specs from HTTP status endpoint.
+         */
+        this._serverSpecs = new Map();
         /**
          * Set of emitted warning message, message in this set will not be warned again.
          */
@@ -28,6 +36,14 @@ export class LanguageServerManager {
          * Signal emitted when a  language server session is changed
          */
         this._sessionsChanged = new Signal(this);
+        /**
+         * Runtime language server providers.
+         */
+        this._providers = new Map();
+        /**
+         * Runtime language server transport factories.
+         */
+        this._transports = new Map();
         this._isDisposed = false;
         /**
          * Check if the manager is enabled or disabled
@@ -108,6 +124,10 @@ export class LanguageServerManager {
     disable() {
         this._enabled = false;
         this._sessions = new Map();
+        this._specs = new Map();
+        this._serverSessions = new Map();
+        this._serverSpecs = new Map();
+        this._transports.clear();
         this._sessionsChanged.emit(void 0);
     }
     /**
@@ -118,6 +138,15 @@ export class LanguageServerManager {
             return;
         }
         this._isDisposed = true;
+        for (const registration of this._providers.values()) {
+            if (registration.provider.sessionsChanged) {
+                registration.provider.sessionsChanged.disconnect(registration.onSessionsChanged);
+            }
+        }
+        this._providers.clear();
+        this._serverSessions.clear();
+        this._serverSpecs.clear();
+        this._transports.clear();
         Signal.clearData(this);
     }
     /**
@@ -126,6 +155,43 @@ export class LanguageServerManager {
     setConfiguration(configuration) {
         this._configuration = configuration;
     }
+    /**
+     * Register a runtime language server provider.
+     */
+    registerProvider(provider) {
+        if (this._providers.has(provider.id)) {
+            console.warn(`Language server provider with id ${provider.id} is already registered`);
+            return new DisposableDelegate(() => undefined);
+        }
+        const registration = {
+            provider,
+            onSessionsChanged: () => {
+                void this.fetchSessions().catch(console.error);
+            }
+        };
+        this._providers.set(provider.id, registration);
+        if (provider.sessionsChanged) {
+            provider.sessionsChanged.connect(registration.onSessionsChanged);
+        }
+        void this.fetchSessions().catch(console.error);
+        return new DisposableDelegate(() => {
+            if (this._providers.get(provider.id) !== registration) {
+                return;
+            }
+            if (provider.sessionsChanged) {
+                provider.sessionsChanged.disconnect(registration.onSessionsChanged);
+            }
+            this._providers.delete(provider.id);
+            void this.fetchSessions().catch(console.error);
+        });
+    }
+    /**
+     * Get a runtime transport factory for a language server.
+     */
+    getTransportFactory(languageServerId) {
+        var _a;
+        return (_a = this._transports.get(languageServerId)) !== null && _a !== void 0 ? _a : null;
+    }
     /**
      * Get matching language server for input language option.
      */
@@ -162,52 +228,56 @@ export class LanguageServerManager {
         if (!this._enabled) {
             return;
         }
-        let response = await ServerConnection.makeRequest(this.statusUrl, { method: 'GET' }, this._settings);
-        this._statusCode = response.status;
-        if (!response.ok) {
-            if (this._retries > 0) {
-                this._retries -= 1;
-                setTimeout(this.fetchSessions.bind(this), this._retriesInterval);
-            }
-            else {
-                this._ready.resolve(undefined);
-                console.log('Missing jupyter_lsp server extension, skipping.');
-            }
+        let statusCode = this._statusCode;
+        const sessions = new Map();
+        const specs = new Map();
+        const transports = new Map();
+        const serverData = await this._fetchServerData();
+        if ((serverData === null || serverData === void 0 ? void 0 : serverData.statusCode) !== undefined) {
+            statusCode = serverData.statusCode;
+            this._statusCode = statusCode;
+        }
+        if ((serverData === null || serverData === void 0 ? void 0 : serverData.retryScheduled) && this._providers.size === 0) {
             return;
         }
-        let sessions;
-        try {
-            const data = await response.json();
-            sessions = data.sessions;
-            try {
-                this.version = data.version;
-                this._specs = new Map(Object.entries(data.specs));
-            }
-            catch (err) {
-                console.warn(err);
-            }
+        if ((serverData === null || serverData === void 0 ? void 0 : serverData.sessions) !== undefined) {
+            this._syncSnapshot(this._serverSessions, serverData.sessions);
         }
-        catch (err) {
-            console.warn(err);
-            this._ready.resolve(undefined);
-            return;
+        if ((serverData === null || serverData === void 0 ? void 0 : serverData.specs) !== undefined) {
+            this._syncSnapshot(this._serverSpecs, serverData.specs);
         }
-        for (let key of Object.keys(sessions)) {
-            let id = key;
-            if (this._sessions.has(id)) {
-                Object.assign(this._sessions.get(id) || {}, sessions[key]);
-            }
-            else {
-                this._sessions.set(id, sessions[key]);
+        if (serverData) {
+            if (serverData.version !== undefined) {
+                this.version = serverData.version;
             }
         }
-        const oldKeys = this._sessions.keys();
-        for (const oldKey in oldKeys) {
-            if (!sessions[oldKey]) {
-                let oldId = oldKey;
-                this._sessions.delete(oldId);
+        this._mergeSnapshot(specs, this._serverSpecs);
+        this._mergeSnapshot(sessions, this._serverSessions);
+        for (const registration of this._providers.values()) {
+            try {
+                const data = await registration.provider.fetch();
+                if (!data) {
+                    continue;
+                }
+                if (data.statusCode !== undefined) {
+                    statusCode = data.statusCode;
+                }
+                this._mergeSnapshot(specs, data.specs);
+                this._mergeSnapshot(sessions, data.sessions);
+                if (data.transport) {
+                    for (const [key, factory] of Object.entries(data.transport)) {
+                        transports.set(key, factory);
+                    }
+                }
+            }
+            catch (err) {
+                console.warn(err);
             }
         }
+        this._statusCode = statusCode;
+        this._transports = transports;
+        this._syncSnapshot(this._specs, specs);
+        this._syncSnapshot(this._sessions, sessions);
         this._sessionsChanged.emit(void 0);
         this._ready.resolve(undefined);
     }
@@ -245,6 +315,72 @@ export class LanguageServerManager {
         // higher rank = higher in the list (descending order)
         return bRank - aRank;
     }
+    /**
+     * Fetch language server data from the HTTP endpoint.
+     */
+    async _fetchServerData() {
+        let response;
+        try {
+            response = await ServerConnection.makeRequest(this.statusUrl, { method: 'GET' }, this._settings);
+        }
+        catch (err) {
+            console.warn(err);
+            return null;
+        }
+        if (!response.ok) {
+            if (this._retries > 0) {
+                this._retries -= 1;
+                setTimeout(this.fetchSessions.bind(this), this._retriesInterval);
+                return { statusCode: response.status, retryScheduled: true };
+            }
+            else {
+                console.log('Missing jupyter_lsp server extension, skipping.');
+            }
+            return { statusCode: response.status };
+        }
+        try {
+            const data = await response.json();
+            return {
+                statusCode: response.status,
+                version: data.version,
+                sessions: data.sessions,
+                specs: data.specs
+            };
+        }
+        catch (err) {
+            console.warn(err);
+            return { statusCode: response.status };
+        }
+    }
+    /**
+     * Merge provider snapshot into target map.
+     */
+    _mergeSnapshot(target, source) {
+        if (!source) {
+            return;
+        }
+        const entries = source instanceof Map ? source.entries() : Object.entries(source);
+        for (const [key, value] of entries) {
+            target.set(key, value);
+        }
+    }
+    /**
+     * Synchronize a mutable map in place.
+     */
+    _syncSnapshot(target, source) {
+        const entries = source instanceof Map ? source.entries() : Object.entries(source);
+        const nextKeys = new Set();
+        for (const [key, value] of entries) {
+            const id = key;
+            nextKeys.add(id);
+            target.set(id, value);
+        }
+        for (const key of Array.from(target.keys())) {
+            if (!nextKeys.has(key)) {
+                target.delete(key);
+            }
+        }
+    }
     /**
      * Get the base URL for language server requests.
      */

package/lib/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"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"}

package/lib/tokens.d.ts

@@ -44,6 +44,81 @@ export type TSpecsMap = Map<TServerKeys, SCHEMA.LanguageServerSpec>;
  * Type alias for language server id, it helps to clarify other types.
  */
 export type TLanguageId = string;
+/**
+ * @alpha
+ *
+ * Runtime language server session/spec provider.
+ */
+export interface ILanguageServerProvider {
+    /**
+     * @alpha
+     *
+     * Provider identifier.
+     */
+    readonly id: string;
+    /**
+     * @alpha
+     *
+     * Signal emitted when provider sessions/specs are changed.
+     */
+    readonly sessionsChanged?: ISignal<ILanguageServerProvider, void>;
+    /**
+     * @alpha
+     *
+     * Fetch runtime language server data.
+     */
+    fetch(): Promise<ILanguageServerProvider.IFetchResult | null>;
+}
+export declare namespace ILanguageServerProvider {
+    /**
+     * Arguments used to create a transport for a specific language server.
+     */
+    interface ITransportOptions {
+        /**
+         * Language server identifier.
+         */
+        languageServerId: TLanguageServerId;
+        /**
+         * Default websocket URL for the server.
+         */
+        socketUrl: string;
+        /**
+         * Jupyter server connection settings.
+         */
+        settings: ServerConnection.ISettings;
+    }
+    /**
+     * Transport factory for runtime language server connections.
+     */
+    type TTransportFactory = (options: ITransportOptions) => WebSocket;
+    /**
+     * Per-server transport factories.
+     */
+    interface ITransportFactoryMap {
+        [key: string]: TTransportFactory;
+    }
+    /**
+     * Runtime language server data contributed by a provider.
+     */
+    interface IFetchResult {
+        /**
+         * Runtime sessions for language servers.
+         */
+        sessions?: TSessionMap | SCHEMA.Sessions;
+        /**
+         * Runtime specs for language servers.
+         */
+        specs?: TSpecsMap | SCHEMA.LanguageServerSpecsMap;
+        /**
+         * Provider status code.
+         */
+        statusCode?: number;
+        /**
+         * Optional transport factory/factories.
+         */
+        transport?: ITransportFactoryMap;
+    }
+}
 export interface ILanguageServerManager extends IDisposable {
     /**
      * @alpha
@@ -57,6 +132,12 @@ export interface ILanguageServerManager extends IDisposable {
      * The current session information of running language servers.
      */
     readonly sessions: TSessionMap;
+    /**
+     * @alpha
+     *
+     * The known language server specifications.
+     */
+    readonly specs: TSpecsMap;
     /**
      * @alpha
      *
@@ -102,7 +183,7 @@ export interface ILanguageServerManager extends IDisposable {
     /**
      * @alpha
      *
-     * An ordered list of matching >running< sessions, with servers of higher rank higher in the list
+     * An ordered list of matching running sessions, with servers of higher rank higher in the list
      */
     getMatchingServers(options: ILanguageServerManager.IGetServerIdOptions): TLanguageServerId[];
     /**
@@ -117,6 +198,18 @@ export interface ILanguageServerManager extends IDisposable {
      * Set the configuration for language servers
      */
     setConfiguration(configuration: TLanguageServerConfigurations): void;
+    /**
+     * @alpha
+     *
+     * Register a runtime language server provider.
+     */
+    registerProvider?(provider: ILanguageServerProvider): IDisposable;
+    /**
+     * @alpha
+     *
+     * Get a runtime transport factory for a language server.
+     */
+    getTransportFactory(languageServerId: TLanguageServerId): ILanguageServerProvider.TTransportFactory | null;
     /**
      * @alpha
      *
@@ -358,7 +451,8 @@ export interface ILSPDocumentConnectionManager {
     retryToConnect(options: ISocketConnectionOptions, reconnectDelay: number, retrialsLeft: number): Promise<void>;
     /**
      * Create a new connection to the language server
-     * @return A promise of the LSP connection
+     *
+     * Returns a promise of the LSP connection.
      */
     connect(options: ISocketConnectionOptions, firstTimeoutSeconds?: number, secondTimeoutMinute?: number): Promise<ILSPConnection | undefined>;
     /**
@@ -495,7 +589,7 @@ export interface IWidgetLSPAdapterTracker<T extends WidgetLSPAdapter = WidgetLSP
     /**
      * Find the first instance in the tracker that satisfies a filter function.
      *
-     * @param fn The filter function to call on each instance.
+     * @param fn - The filter function to call on each instance.
      *
      * #### Notes
      * If nothing is found, the value returned is `undefined`.
@@ -601,6 +695,7 @@ export declare namespace Method {
         COMPLETION = "textDocument/completion",
         COMPLETION_ITEM_RESOLVE = "completionItem/resolve",
         DEFINITION = "textDocument/definition",
+        DIAGNOSTIC = "textDocument/diagnostic",
         DOCUMENT_COLOR = "textDocument/documentColor",
         DOCUMENT_HIGHLIGHT = "textDocument/documentHighlight",
         DOCUMENT_SYMBOL = "textDocument/documentSymbol",
@@ -667,6 +762,7 @@ export interface IClientRequestParams {
     [Method.ClientRequest.COMPLETION_ITEM_RESOLVE]: lsp.CompletionItem;
     [Method.ClientRequest.COMPLETION]: lsp.CompletionParams;
     [Method.ClientRequest.DEFINITION]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.DIAGNOSTIC]: lsp.DocumentDiagnosticParams;
     [Method.ClientRequest.DOCUMENT_COLOR]: lsp.DocumentColorParams;
     [Method.ClientRequest.DOCUMENT_HIGHLIGHT]: lsp.TextDocumentPositionParams;
     [Method.ClientRequest.DOCUMENT_SYMBOL]: lsp.DocumentSymbolParams;
@@ -677,6 +773,7 @@ export interface IClientRequestParams {
     [Method.ClientRequest.RENAME]: lsp.RenameParams;
     [Method.ClientRequest.SIGNATURE_HELP]: lsp.TextDocumentPositionParams;
     [Method.ClientRequest.TYPE_DEFINITION]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.LINKED_EDITING_RANGE]: lsp.LinkedEditingRangeParams;
     [Method.ClientRequest.INLINE_VALUE]: lsp.InlineValueParams;
     [Method.ClientRequest.INLAY_HINT]: lsp.InlayHintParams;
     [Method.ClientRequest.WORKSPACE_SYMBOL]: lsp.WorkspaceSymbolParams;
@@ -692,6 +789,7 @@ export interface IClientResult {
     [Method.ClientRequest.COMPLETION_ITEM_RESOLVE]: lsp.CompletionItem;
     [Method.ClientRequest.COMPLETION]: AnyCompletion;
     [Method.ClientRequest.DEFINITION]: AnyLocation;
+    [Method.ClientRequest.DIAGNOSTIC]: lsp.DocumentDiagnosticReport;
     [Method.ClientRequest.DOCUMENT_COLOR]: lsp.ColorInformation[];
     [Method.ClientRequest.DOCUMENT_HIGHLIGHT]: lsp.DocumentHighlight[];
     [Method.ClientRequest.DOCUMENT_SYMBOL]: lsp.DocumentSymbol[];
@@ -702,6 +800,7 @@ export interface IClientResult {
     [Method.ClientRequest.RENAME]: lsp.WorkspaceEdit;
     [Method.ClientRequest.SIGNATURE_HELP]: lsp.SignatureHelp;
     [Method.ClientRequest.TYPE_DEFINITION]: AnyLocation;
+    [Method.ClientRequest.LINKED_EDITING_RANGE]: lsp.LinkedEditingRanges | null;
     [Method.ClientRequest.INLINE_VALUE]: lsp.InlineValue[] | null;
     [Method.ClientRequest.INLAY_HINT]: lsp.InlayHint[] | null;
     [Method.ClientRequest.WORKSPACE_SYMBOL]: lsp.SymbolInformation[] | lsp.WorkspaceSymbol[] | null;
@@ -817,6 +916,17 @@ export interface ILSPConnection extends ILspConnection, IObservableDisposable {
      * Check if a capability is available in the server capabilities.
      */
     provides(capability: keyof lsp.ServerCapabilities): boolean;
+    /**
+     * @alpha
+     *
+     * Send a client request to the language server.
+     *
+     * @param method - The LSP method to request.
+     * @param params - The parameters for the request.
+     * @param options - Options for the request.
+     * @returns The response from the language server.
+     */
+    request<M extends Method.ClientRequest>(method: M, params: IClientRequestParams[M], options?: ILSPConnection.IRequestOptions): Promise<IClientResult[M]>;
     /**
      * @alpha
      *
@@ -843,3 +953,14 @@ export interface ILSPConnection extends ILspConnection, IObservableDisposable {
      */
     sendFullTextChange(text: string, documentInfo: IDocumentInfo): void;
 }
+export declare namespace ILSPConnection {
+    /**
+     * Options for an LSP request.
+     */
+    interface IRequestOptions {
+        /**
+         * A signal used to cancel the request.
+         */
+        signal?: AbortSignal;
+    }
+}

package/lib/tokens.js

@@ -82,6 +82,7 @@ export var Method;
         ClientRequest["COMPLETION"] = "textDocument/completion";
         ClientRequest["COMPLETION_ITEM_RESOLVE"] = "completionItem/resolve";
         ClientRequest["DEFINITION"] = "textDocument/definition";
+        ClientRequest["DIAGNOSTIC"] = "textDocument/diagnostic";
         ClientRequest["DOCUMENT_COLOR"] = "textDocument/documentColor";
         ClientRequest["DOCUMENT_HIGHLIGHT"] = "textDocument/documentHighlight";
         ClientRequest["DOCUMENT_SYMBOL"] = "textDocument/documentSymbol";

package/lib/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAC3D,uDAAuD;AAMvD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAiQ1C,MAAM,KAAW,sBAAsB,CA0CtC;AA1CD,WAAiB,sBAAsB;IACrC;;OAEG;IACU,6BAAM,GAAG,KAAK,CAAC;AAsC9B,CAAC,EA1CgB,sBAAsB,KAAtB,sBAAsB,QA0CtC;AA0VD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,IAAI,KAAK,CACP,+CAA+C,EAC/C,yEAAyE,CAC1E,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CACzC,oCAAoC,EACpC,2GAA2G,CAC5G,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,KAAK,CAChD,2CAA2C,EAC3C,sLAAsL,CACvL,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,KAAK,CAC/C,0CAA0C,EAC1C,6GAA6G,CAC9G,CAAC;AAiBF;;;GAGG;AACH,MAAM,KAAW,MAAM,CAmDtB;AAnDD,WAAiB,MAAM;IACrB,2BAA2B;IAC3B,IAAY,kBAKX;IALD,WAAY,kBAAkB;QAC5B,6EAAuD,CAAA;QACvD,yDAAmC,CAAA;QACnC,8CAAwB,CAAA;QACxB,uDAAiC,CAAA;IACnC,CAAC,EALW,kBAAkB,GAAlB,yBAAkB,KAAlB,yBAAkB,QAK7B;IAED,2BAA2B;IAC3B,IAAY,kBAOX;IAPD,WAAY,kBAAkB;QAC5B,2DAAqC,CAAA;QACrC,mFAA6D,CAAA;QAC7D,uDAAiC,CAAA;QACjC,uDAAiC,CAAA;QACjC,iDAA2B,CAAA;QAC3B,8CAAwB,CAAA;IAC1B,CAAC,EAPW,kBAAkB,GAAlB,yBAAkB,KAAlB,yBAAkB,QAO7B;IAED,sBAAsB;IACtB,IAAY,aAKX;IALD,WAAY,aAAa;QACvB,kEAAiD,CAAA;QACjD,mEAAkD,CAAA;QAClD,sEAAqD,CAAA;QACrD,oEAAmD,CAAA;IACrD,CAAC,EALW,aAAa,GAAb,oBAAa,KAAb,oBAAa,QAKxB;IAED,sBAAsB;IACtB,IAAY,aAsBX;IAtBD,WAAY,aAAa;QACvB,wDAAuC,CAAA;QACvC,uDAAsC,CAAA;QACtC,mEAAkD,CAAA;QAClD,uDAAsC,CAAA;QACtC,8DAA6C,CAAA;QAC7C,sEAAqD,CAAA;QACrD,gEAA+C,CAAA;QAC/C,6CAA4B,CAAA;QAC5B,+DAA8C,CAAA;QAC9C,0CAAyB,CAAA;QACzB,uDAAsC,CAAA;QACtC,+CAA8B,CAAA;QAC9B,8DAA6C,CAAA;QAC7C,gEAA+C,CAAA;QAC/C,yEAAwD,CAAA;QACxD,0DAAyC,CAAA;QACzC,sDAAqC,CAAA;QACrC,sDAAqC,CAAA;QACrC,qEAAoD,CAAA;QACpD,uDAAsC,CAAA;QACtC,kEAAiD,CAAA;IACnD,CAAC,EAtBW,aAAa,GAAb,oBAAa,KAAb,oBAAa,QAsBxB;AACH,CAAC,EAnDgB,MAAM,KAAN,MAAM,QAmDtB"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAC3D,uDAAuD;AAMvD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA+W1C,MAAM,KAAW,sBAAsB,CA0CtC;AA1CD,WAAiB,sBAAsB;IACrC;;OAEG;IACU,6BAAM,GAAG,KAAK,CAAC;AAsC9B,CAAC,EA1CgB,sBAAsB,KAAtB,sBAAsB,QA0CtC;AA2VD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,IAAI,KAAK,CACP,+CAA+C,EAC/C,yEAAyE,CAC1E,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CACzC,oCAAoC,EACpC,2GAA2G,CAC5G,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,KAAK,CAChD,2CAA2C,EAC3C,sLAAsL,CACvL,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,KAAK,CAC/C,0CAA0C,EAC1C,6GAA6G,CAC9G,CAAC;AAiBF;;;GAGG;AACH,MAAM,KAAW,MAAM,CAoDtB;AApDD,WAAiB,MAAM;IACrB,2BAA2B;IAC3B,IAAY,kBAKX;IALD,WAAY,kBAAkB;QAC5B,6EAAuD,CAAA;QACvD,yDAAmC,CAAA;QACnC,8CAAwB,CAAA;QACxB,uDAAiC,CAAA;IACnC,CAAC,EALW,kBAAkB,GAAlB,yBAAkB,KAAlB,yBAAkB,QAK7B;IAED,2BAA2B;IAC3B,IAAY,kBAOX;IAPD,WAAY,kBAAkB;QAC5B,2DAAqC,CAAA;QACrC,mFAA6D,CAAA;QAC7D,uDAAiC,CAAA;QACjC,uDAAiC,CAAA;QACjC,iDAA2B,CAAA;QAC3B,8CAAwB,CAAA;IAC1B,CAAC,EAPW,kBAAkB,GAAlB,yBAAkB,KAAlB,yBAAkB,QAO7B;IAED,sBAAsB;IACtB,IAAY,aAKX;IALD,WAAY,aAAa;QACvB,kEAAiD,CAAA;QACjD,mEAAkD,CAAA;QAClD,sEAAqD,CAAA;QACrD,oEAAmD,CAAA;IACrD,CAAC,EALW,aAAa,GAAb,oBAAa,KAAb,oBAAa,QAKxB;IAED,sBAAsB;IACtB,IAAY,aAuBX;IAvBD,WAAY,aAAa;QACvB,wDAAuC,CAAA;QACvC,uDAAsC,CAAA;QACtC,mEAAkD,CAAA;QAClD,uDAAsC,CAAA;QACtC,uDAAsC,CAAA;QACtC,8DAA6C,CAAA;QAC7C,sEAAqD,CAAA;QACrD,gEAA+C,CAAA;QAC/C,6CAA4B,CAAA;QAC5B,+DAA8C,CAAA;QAC9C,0CAAyB,CAAA;QACzB,uDAAsC,CAAA;QACtC,+CAA8B,CAAA;QAC9B,8DAA6C,CAAA;QAC7C,gEAA+C,CAAA;QAC/C,yEAAwD,CAAA;QACxD,0DAAyC,CAAA;QACzC,sDAAqC,CAAA;QACrC,sDAAqC,CAAA;QACrC,qEAAoD,CAAA;QACpD,uDAAsC,CAAA;QACtC,kEAAiD,CAAA;IACnD,CAAC,EAvBW,aAAa,GAAb,oBAAa,KAAb,oBAAa,QAuBxB;AACH,CAAC,EApDgB,MAAM,KAAN,MAAM,QAoDtB"}

package/lib/ws-connection/server-capability-registration.js

@@ -2,7 +2,11 @@
  * Copyright (c) Jupyter Development Team.
  * Distributed under the terms of the Modified BSD License.
  */
-/* eslint-disable @typescript-eslint/no-explicit-any */
+// Disclaimer/acknowledgement: Fragments are based on https://github.com/wylieconlon/lsp-editor-adapter,
+// which is copyright of wylieconlon and contributors and ISC licenced.
+// ISC licence is, quote, "functionally equivalent to the simplified BSD and MIT licenses,
+// but without language deemed unnecessary following the Berne Convention." (Wikipedia).
+// Introduced modifications are BSD licenced, copyright JupyterLab development team.
 /**
  * Register the capabilities with the server capabilities provider
  *

package/lib/ws-connection/server-capability-registration.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-capability-registration.js","sourceRoot":"","sources":["../../src/ws-connection/server-capability-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,uDAAuD;AAkBvD;;;;;;GAMG;AACH,SAAS,wBAAwB,CAC/B,kBAAsC,EACtC,YAA0B;IAE1B,MAAM,sBAAsB,GAAG,IAAI,CAAC,KAAK,CACvC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CACJ,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;IAEvD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,sBAAsB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,sBAAsB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAC/C,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CACjC,kBAAsC,EACtC,cAA8B;IAE9B,MAAM,sBAAsB,GAAG,IAAI,CAAC,KAAK,CACvC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CACJ,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;IAEvD,OAAO,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE5C,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"server-capability-registration.js","sourceRoot":"","sources":["../../src/ws-connection/server-capability-registration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wGAAwG;AACxG,uEAAuE;AACvE,0FAA0F;AAC1F,wFAAwF;AACxF,oFAAoF;AAYpF;;;;;;GAMG;AACH,SAAS,wBAAwB,CAC/B,kBAAsC,EACtC,YAA0B;IAE1B,MAAM,sBAAsB,GAAG,IAAI,CAAC,KAAK,CACvC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CACJ,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;IAEvD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,sBAAsB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,sBAAsB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAC/C,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,YAAY,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CACjC,kBAAsC,EACtC,cAA8B;IAE9B,MAAM,sBAAsB,GAAG,IAAI,CAAC,KAAK,CACvC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CACJ,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;IAEvD,OAAO,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAE5C,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,OAAO,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/lsp",
-  "version": "4.6.2",
+  "version": "4.7.0-alpha.1",
   "description": "",
   "homepage": "https://github.com/jupyterlab/jupyterlab",
   "bugs": {
@@ -41,24 +41,24 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
-    "@jupyterlab/apputils": "^4.7.2",
-    "@jupyterlab/codeeditor": "^4.6.2",
-    "@jupyterlab/codemirror": "^4.6.2",
-    "@jupyterlab/coreutils": "^6.6.2",
-    "@jupyterlab/docregistry": "^4.6.2",
-    "@jupyterlab/services": "^7.6.2",
-    "@jupyterlab/translation": "^4.6.2",
-    "@lumino/coreutils": "^2.2.2",
-    "@lumino/disposable": "^2.1.5",
-    "@lumino/signaling": "^2.1.5",
-    "@lumino/widgets": "^2.8.0",
+    "@jupyterlab/apputils": "^4.8.0-alpha.1",
+    "@jupyterlab/codeeditor": "^4.7.0-alpha.1",
+    "@jupyterlab/codemirror": "^4.7.0-alpha.1",
+    "@jupyterlab/coreutils": "^6.7.0-alpha.1",
+    "@jupyterlab/docregistry": "^4.7.0-alpha.1",
+    "@jupyterlab/services": "^7.7.0-alpha.1",
+    "@jupyterlab/translation": "^4.7.0-alpha.1",
+    "@lumino/coreutils": "^2.2.3",
+    "@lumino/disposable": "^2.1.6",
+    "@lumino/signaling": "^2.1.6",
+    "@lumino/widgets": "^2.9.0",
     "lodash.mergewith": "^4.6.1",
     "vscode-jsonrpc": "^8.2.0",
     "vscode-languageserver-protocol": "^3.17.0",
     "vscode-ws-jsonrpc": "~1.0.2"
   },
   "devDependencies": {
-    "@jupyterlab/testing": "^4.6.2",
+    "@jupyterlab/testing": "^4.7.0-alpha.1",
     "@types/jest": "^29.2.0",
     "@types/lodash.mergewith": "^4.6.1",
     "jest": "^29.2.0",