@jupyterlab/lsp 4.0.0-alpha.11

package/lib/connection.js

@@ -0,0 +1,309 @@
+// Disclaimer/acknowledgement: Fragments are based on LspWsConnection, 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.
+import { Signal } from '@lumino/signaling';
+import { LspWsConnection } from 'lsp-ws-connection';
+import { registerServerCapability, unregisterServerCapability } from 'lsp-ws-connection/lib/server-capability-registration';
+import { Method } from './tokens';
+import { untilReady } from './utils';
+class ClientRequestHandler {
+    constructor(connection, method, emitter) {
+        this.connection = connection;
+        this.method = method;
+        this.emitter = emitter;
+    }
+    request(params) {
+        // TODO check if is ready?
+        this.emitter.log(MessageKind.clientRequested, {
+            method: this.method,
+            message: params
+        });
+        return this.connection
+            .sendRequest(this.method, params)
+            .then((result) => {
+            this.emitter.log(MessageKind.resultForClient, {
+                method: this.method,
+                message: params
+            });
+            return result;
+        });
+    }
+}
+class ServerRequestHandler {
+    constructor(connection, method, emitter) {
+        this.connection = connection;
+        this.method = method;
+        this.emitter = emitter;
+        // on request accepts "thenable"
+        this.connection.onRequest(method, this.handle.bind(this));
+        this._handler = null;
+    }
+    handle(request) {
+        this.emitter.log(MessageKind.serverRequested, {
+            method: this.method,
+            message: request
+        });
+        if (!this._handler) {
+            return new Promise(() => undefined);
+        }
+        return this._handler(request, this.emitter).then(result => {
+            this.emitter.log(MessageKind.responseForServer, {
+                method: this.method,
+                message: result
+            });
+            return result;
+        });
+    }
+    setHandler(handler) {
+        this._handler = handler;
+    }
+    clearHandler() {
+        this._handler = null;
+    }
+}
+export const Provider = {
+    TEXT_DOCUMENT_SYNC: 'textDocumentSync',
+    COMPLETION: 'completionProvider',
+    HOVER: 'hoverProvider',
+    SIGNATURE_HELP: 'signatureHelpProvider',
+    DECLARATION: 'declarationProvider',
+    DEFINITION: 'definitionProvider',
+    TYPE_DEFINITION: 'typeDefinitionProvider',
+    IMPLEMENTATION: 'implementationProvider',
+    REFERENCES: 'referencesProvider',
+    DOCUMENT_HIGHLIGHT: 'documentHighlightProvider',
+    DOCUMENT_SYMBOL: 'documentSymbolProvider',
+    CODE_ACTION: 'codeActionProvider',
+    CODE_LENS: 'codeLensProvider',
+    DOCUMENT_LINK: 'documentLinkProvider',
+    COLOR: 'colorProvider',
+    DOCUMENT_FORMATTING: 'documentFormattingProvider',
+    DOCUMENT_RANGE_FORMATTING: 'documentRangeFormattingProvider',
+    DOCUMENT_ON_TYPE_FORMATTING: 'documentOnTypeFormattingProvider',
+    RENAME: 'renameProvider',
+    FOLDING_RANGE: 'foldingRangeProvider',
+    EXECUTE_COMMAND: 'executeCommandProvider',
+    SELECTION_RANGE: 'selectionRangeProvider',
+    WORKSPACE_SYMBOL: 'workspaceSymbolProvider',
+    WORKSPACE: 'workspace'
+};
+function createMethodMap(methods, handlerFactory) {
+    const result = {};
+    for (let method of Object.values(methods)) {
+        result[method] = handlerFactory(method);
+    }
+    return result;
+}
+var MessageKind;
+(function (MessageKind) {
+    MessageKind[MessageKind["clientNotifiedServer"] = 0] = "clientNotifiedServer";
+    MessageKind[MessageKind["serverNotifiedClient"] = 1] = "serverNotifiedClient";
+    MessageKind[MessageKind["serverRequested"] = 2] = "serverRequested";
+    MessageKind[MessageKind["clientRequested"] = 3] = "clientRequested";
+    MessageKind[MessageKind["resultForClient"] = 4] = "resultForClient";
+    MessageKind[MessageKind["responseForServer"] = 5] = "responseForServer";
+})(MessageKind || (MessageKind = {}));
+export class LSPConnection extends LspWsConnection {
+    constructor(options) {
+        super(options);
+        this.closingManually = false;
+        this._options = options;
+        this.logAllCommunication = false;
+        this.serverIdentifier = options.serverIdentifier;
+        this.serverLanguage = options.languageId;
+        this.documentsToOpen = [];
+        this.clientNotifications =
+            this.constructNotificationHandlers(Method.ClientNotification);
+        this.serverNotifications =
+            this.constructNotificationHandlers(Method.ServerNotification);
+    }
+    log(kind, message) {
+        if (this.logAllCommunication) {
+            console.log(kind, message);
+        }
+    }
+    constructNotificationHandlers(methods) {
+        return createMethodMap(methods, () => new Signal(this));
+    }
+    constructClientRequestHandler(methods) {
+        return createMethodMap(methods, method => new ClientRequestHandler(this.connection, method, this));
+    }
+    constructServerRequestHandler(methods) {
+        return createMethodMap(methods, method => new ServerRequestHandler(this.connection, method, this));
+    }
+    /**
+     * Initialization parameters to be sent to the language server.
+     * Subclasses can overload this when adding more features.
+     */
+    initializeParams() {
+        return Object.assign(Object.assign({}, super.initializeParams()), { 
+            // TODO: remove as `lsp.ClientCapabilities` after upgrading to 3.17
+            // which should finally include a fix for moniker issue:
+            // https://github.com/microsoft/vscode-languageserver-node/pull/720
+            capabilities: this._options.capabilities, initializationOptions: null, processId: null, workspaceFolders: null });
+    }
+    sendOpenWhenReady(documentInfo) {
+        if (this.isReady) {
+            this.sendOpen(documentInfo);
+        }
+        else {
+            this.documentsToOpen.push(documentInfo);
+        }
+    }
+    onServerInitialized(params) {
+        this.afterInitialized();
+        super.onServerInitialized(params);
+        while (this.documentsToOpen.length) {
+            this.sendOpen(this.documentsToOpen.pop());
+        }
+    }
+    afterInitialized() {
+        for (const method of Object.values(Method.ServerNotification)) {
+            const signal = this.serverNotifications[method];
+            this.connection.onNotification(method, params => {
+                this.log(MessageKind.serverNotifiedClient, {
+                    method,
+                    message: params
+                });
+                signal.emit(params);
+            });
+        }
+        for (const method of Object.values(Method.ClientNotification)) {
+            const signal = this.clientNotifications[method];
+            signal.connect((emitter, params) => {
+                this.log(MessageKind.clientNotifiedServer, {
+                    method,
+                    message: params
+                });
+                this.connection.sendNotification(method, params);
+            });
+        }
+        this.clientRequests = this.constructClientRequestHandler(Method.ClientRequest);
+        this.serverRequests = this.constructServerRequestHandler(Method.ServerRequest);
+        this.serverRequests['client/registerCapability'].setHandler(async (params) => {
+            params.registrations.forEach((capabilityRegistration) => {
+                try {
+                    const updatedCapabilities = registerServerCapability(this.serverCapabilities, capabilityRegistration);
+                    if (updatedCapabilities === null) {
+                        console.error(`Failed to register server capability: ${capabilityRegistration}`);
+                        return;
+                    }
+                    this.serverCapabilities = updatedCapabilities;
+                }
+                catch (err) {
+                    console.error(err);
+                }
+            });
+        });
+        this.serverRequests['client/unregisterCapability'].setHandler(async (params) => {
+            params.unregisterations.forEach((capabilityUnregistration) => {
+                this.serverCapabilities = unregisterServerCapability(this.serverCapabilities, capabilityUnregistration);
+            });
+        });
+        this.serverRequests['workspace/configuration'].setHandler(async (params) => {
+            return params.items.map(item => {
+                // LSP: "If the client can’t provide a configuration setting for a given scope
+                // then `null` needs to be present in the returned array."
+                // for now we do not support configuration, but yaml server does not respect
+                // client capability so we have a handler just for that
+                return null;
+            });
+        });
+    }
+    sendSelectiveChange(changeEvent, documentInfo) {
+        this._sendChange([changeEvent], documentInfo);
+    }
+    sendFullTextChange(text, documentInfo) {
+        this._sendChange([{ text }], documentInfo);
+    }
+    /**
+     * @deprecated The method should not be used in new code. Use provides() instead.
+     */
+    isRenameSupported() {
+        return !!(this.serverCapabilities && this.serverCapabilities.renameProvider);
+    }
+    provides(provider) {
+        return !!(this.serverCapabilities && this.serverCapabilities[provider]);
+    }
+    /**
+     * @deprecated The method should not be used in new code
+     */
+    async rename(location, documentInfo, newName, emit = true) {
+        if (!this.isReady || !this.isRenameSupported()) {
+            return null;
+        }
+        const params = {
+            textDocument: {
+                uri: documentInfo.uri
+            },
+            position: {
+                line: location.line,
+                character: location.ch
+            },
+            newName
+        };
+        const edit = await this.connection.sendRequest('textDocument/rename', params);
+        if (emit) {
+            this.emit('renamed', edit);
+        }
+        return edit;
+    }
+    connect(socket) {
+        super.connect(socket);
+        untilReady(() => {
+            return this.isConnected;
+        }, -1)
+            .then(() => {
+            this.connection.onClose(() => {
+                this.isConnected = false;
+                this.emit('close', this.closingManually);
+            });
+        })
+            .catch(() => {
+            console.error('Could not connect onClose signal');
+        });
+        return this;
+    }
+    close() {
+        try {
+            this.closingManually = true;
+            super.close();
+        }
+        catch (e) {
+            this.closingManually = false;
+        }
+    }
+    _sendChange(changeEvents, documentInfo) {
+        if (!this.isReady) {
+            return;
+        }
+        if (!this.openedUris.get(documentInfo.uri)) {
+            this.sendOpen(documentInfo);
+        }
+        const textDocumentChange = {
+            textDocument: {
+                uri: documentInfo.uri,
+                version: documentInfo.version
+            },
+            contentChanges: changeEvents
+        };
+        this.connection.sendNotification('textDocument/didChange', textDocumentChange);
+        documentInfo.version++;
+    }
+    async getCompletionResolve(completionItem) {
+        if (!this.isReady || !this.isCompletionResolveProvider()) {
+            return;
+        }
+        return this.connection.sendRequest('completionItem/resolve', completionItem);
+    }
+    /**
+     * Does support completionItem/resolve?
+     * @deprecated The method should not be used in new code
+     */
+    isCompletionResolveProvider() {
+        var _a, _b;
+        return (((_b = (_a = this.serverCapabilities) === null || _a === void 0 ? void 0 : _a.completionProvider) === null || _b === void 0 ? void 0 : _b.resolveProvider) || false);
+    }
+}
+//# sourceMappingURL=connection.js.map

package/lib/connection.js.map

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

package/lib/connection_manager.d.ts

@@ -0,0 +1,71 @@
+import { IDocumentWidget } from '@jupyterlab/docregistry';
+import { Signal } from '@lumino/signaling';
+import { WidgetAdapter } from './adapters/adapter';
+import { LSPConnection } from './connection';
+import { AskServersToSendTraceNotifications } from './plugin';
+import { IDocumentConnectionData, ILanguageServerManager, ILSPConnection, ILSPDocumentConnectionManager, ISocketConnectionOptions, TLanguageServerConfigurations, TLanguageServerId } from './tokens';
+import { IForeignContext, VirtualDocument } from './virtual/document';
+/**
+ * Each Widget with a document (whether file or a notebook) has the same DocumentConnectionManager
+ * (see JupyterLabWidgetAdapter). Using id_path instead of uri led to documents being overwritten
+ * as two identical id_paths could be created for two different notebooks.
+ */
+export declare class DocumentConnectionManager implements ILSPDocumentConnectionManager {
+    connections: Map<VirtualDocument.uri, LSPConnection>;
+    adapters: Map<string, WidgetAdapter<IDocumentWidget>>;
+    documents: Map<VirtualDocument.uri, VirtualDocument>;
+    initialized: Signal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    connected: Signal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Connection temporarily lost or could not be fully established; a re-connection will be attempted;
+     */
+    disconnected: Signal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Connection was closed permanently and no-reconnection will be attempted, e.g.:
+     *  - there was a serious server error
+     *  - user closed the connection,
+     *  - re-connection attempts exceeded,
+     */
+    closed: Signal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    documentsChanged: Signal<ILSPDocumentConnectionManager, Map<VirtualDocument.uri, VirtualDocument>>;
+    languageServerManager: ILanguageServerManager;
+    initialConfigurations: TLanguageServerConfigurations;
+    private ignoredLanguages;
+    constructor(options: DocumentConnectionManager.IOptions);
+    connectDocumentSignals(virtualDocument: VirtualDocument): void;
+    disconnectDocumentSignals(virtualDocument: VirtualDocument, emit?: boolean): void;
+    onForeignDocumentOpened(_host: VirtualDocument, context: IForeignContext): void;
+    onForeignDocumentClosed(_host: VirtualDocument, context: IForeignContext): void;
+    private connectSocket;
+    registerAdapter(path: string, adapter: WidgetAdapter<IDocumentWidget>): void;
+    updateConfiguration(allServerSettings: TLanguageServerConfigurations): void;
+    updateServerConfigurations(allServerSettings: TLanguageServerConfigurations): void;
+    /**
+     * Fired the first time a connection is opened. These _should_ be the only
+     * invocation of `.on` (once remaining LSPFeature.connection_handlers are made
+     * singletons).
+     */
+    onNewConnection: (connection: LSPConnection) => void;
+    /**
+     * TODO: presently no longer referenced. A failing connection would close
+     * the socket, triggering the language server on the other end to exit
+     */
+    retryToConnect(options: ISocketConnectionOptions, reconnectDelay: number, retrialsLeft?: number): Promise<void>;
+    disconnect(languageId: TLanguageServerId): void;
+    connect(options: ISocketConnectionOptions, firstTimeoutSeconds?: number, secondTimeoutMinutes?: number): Promise<ILSPConnection | undefined>;
+    unregisterDocument(virtualDocument: VirtualDocument, emit?: boolean): void;
+    updateLogging(logAllCommunication: boolean, setTrace: AskServersToSendTraceNotifications): void;
+    private forEachDocumentOfConnection;
+}
+export declare namespace DocumentConnectionManager {
+    interface IOptions {
+        languageServerManager: ILanguageServerManager;
+    }
+    function solveUris(virtualDocument: VirtualDocument, language: string): IURIs;
+    interface IURIs {
+        base: string;
+        document: string;
+        server: string;
+        socket: string;
+    }
+}