@jupyterlab/lsp 4.0.0-alpha.11

package/lib/connection_manager.js

@@ -0,0 +1,312 @@
+import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+import { Signal } from '@lumino/signaling';
+import { LSPConnection } from './connection';
+import { expandDottedPaths, sleep, untilReady } from './utils';
+/**
+ * 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 class DocumentConnectionManager {
+    constructor(options) {
+        /**
+         * Fired the first time a connection is opened. These _should_ be the only
+         * invocation of `.on` (once remaining LSPFeature.connection_handlers are made
+         * singletons).
+         */
+        this.onNewConnection = (connection) => {
+            connection.on('error', e => {
+                console.error(e);
+                // TODO invalid now
+                let error = e.length && e.length >= 1 ? e[0] : new Error();
+                // TODO: those codes may be specific to my proxy client, need to investigate
+                if (error.message.indexOf('code = 1005') !== -1) {
+                    console.error(`Connection failed for ${connection}`);
+                    this.forEachDocumentOfConnection(connection, virtualDocument => {
+                        console.error('disconnecting ' + virtualDocument.uri);
+                        this.closed.emit({ connection, virtualDocument });
+                        this.ignoredLanguages.add(virtualDocument.language);
+                        console.error(`Cancelling further attempts to connect ${virtualDocument.uri} and other documents for this language (no support from the server)`);
+                    });
+                }
+                else if (error.message.indexOf('code = 1006') !== -1) {
+                    console.error('Connection closed by the server');
+                }
+                else {
+                    console.error('Connection error:', e);
+                }
+            });
+            connection.on('serverInitialized', capabilities => {
+                // Initialize using settings stored in the SettingRegistry
+                this.forEachDocumentOfConnection(connection, virtualDocument => {
+                    // TODO: is this still necessary, e.g. for status bar to update responsively?
+                    this.initialized.emit({ connection, virtualDocument });
+                });
+                this.updateServerConfigurations(this.initialConfigurations);
+            });
+            connection.on('close', closedManually => {
+                if (!closedManually) {
+                    console.error('Connection unexpectedly disconnected');
+                }
+                else {
+                    console.log('Connection closed');
+                    this.forEachDocumentOfConnection(connection, virtualDocument => {
+                        this.closed.emit({ connection, virtualDocument });
+                    });
+                }
+            });
+        };
+        this.connections = new Map();
+        this.documents = new Map();
+        this.adapters = new Map();
+        this.ignoredLanguages = new Set();
+        this.connected = new Signal(this);
+        this.initialized = new Signal(this);
+        this.disconnected = new Signal(this);
+        this.closed = new Signal(this);
+        this.documentsChanged = new Signal(this);
+        this.languageServerManager = options.languageServerManager;
+        Private.setLanguageServerManager(options.languageServerManager);
+    }
+    connectDocumentSignals(virtualDocument) {
+        virtualDocument.foreignDocumentOpened.connect(this.onForeignDocumentOpened, this);
+        virtualDocument.foreignDocumentClosed.connect(this.onForeignDocumentClosed, this);
+        this.documents.set(virtualDocument.uri, virtualDocument);
+        this.documentsChanged.emit(this.documents);
+    }
+    disconnectDocumentSignals(virtualDocument, emit = true) {
+        virtualDocument.foreignDocumentOpened.disconnect(this.onForeignDocumentOpened, this);
+        virtualDocument.foreignDocumentClosed.disconnect(this.onForeignDocumentClosed, this);
+        this.documents.delete(virtualDocument.uri);
+        for (const foreign of virtualDocument.foreignDocuments.values()) {
+            this.disconnectDocumentSignals(foreign, false);
+        }
+        if (emit) {
+            this.documentsChanged.emit(this.documents);
+        }
+    }
+    onForeignDocumentOpened(_host, context) {
+        console.log('ConnectionManager received foreign document: ', context.foreignDocument.uri);
+    }
+    onForeignDocumentClosed(_host, context) {
+        const { foreignDocument } = context;
+        this.unregisterDocument(foreignDocument, false);
+        this.disconnectDocumentSignals(foreignDocument);
+    }
+    async connectSocket(options) {
+        let { language, capabilities, virtualDocument } = options;
+        this.connectDocumentSignals(virtualDocument);
+        const uris = DocumentConnectionManager.solveUris(virtualDocument, language);
+        const matchingServers = this.languageServerManager.getMatchingServers({
+            language
+        });
+        console.debug('Matching servers: ', matchingServers);
+        // for now use only the server with the highest priority.
+        const languageServerId = matchingServers.length === 0 ? null : matchingServers[0];
+        // lazily load 1) the underlying library (1.5mb) and/or 2) a live WebSocket-
+        // like connection: either already connected or potentially in the process
+        // of connecting.
+        const connection = await Private.connection(language, languageServerId, uris, this.onNewConnection, capabilities);
+        // if connecting for the first time, all documents subsequent documents will
+        // be re-opened and synced
+        this.connections.set(virtualDocument.uri, connection);
+        return connection;
+    }
+    registerAdapter(path, adapter) {
+        this.adapters.set(path, adapter);
+        adapter.widget.disposed.connect(() => {
+            this.adapters.delete(path);
+        });
+    }
+    updateConfiguration(allServerSettings) {
+        this.languageServerManager.setConfiguration(allServerSettings);
+    }
+    updateServerConfigurations(allServerSettings) {
+        let languageServerId;
+        for (languageServerId in allServerSettings) {
+            if (!allServerSettings.hasOwnProperty(languageServerId)) {
+                continue;
+            }
+            const rawSettings = allServerSettings[languageServerId];
+            const parsedSettings = expandDottedPaths(rawSettings.serverSettings || {});
+            const serverSettings = {
+                settings: parsedSettings
+            };
+            Private.updateServerConfiguration(languageServerId, serverSettings);
+        }
+    }
+    /**
+     * TODO: presently no longer referenced. A failing connection would close
+     * the socket, triggering the language server on the other end to exit
+     */
+    async retryToConnect(options, reconnectDelay, retrialsLeft = -1) {
+        let { virtualDocument } = options;
+        if (this.ignoredLanguages.has(virtualDocument.language)) {
+            return;
+        }
+        let interval = reconnectDelay * 1000;
+        let success = false;
+        while (retrialsLeft !== 0 && !success) {
+            await this.connect(options)
+                .then(() => {
+                success = true;
+            })
+                .catch(e => {
+                console.warn(e);
+            });
+            console.log('will attempt to re-connect in ' + interval / 1000 + ' seconds');
+            await sleep(interval);
+            // gradually increase the time delay, up to 5 sec
+            interval = interval < 5 * 1000 ? interval + 500 : interval;
+        }
+    }
+    disconnect(languageId) {
+        Private.disconnect(languageId);
+    }
+    // async registerDocument(options: IDocumentRegistationOptions) {}
+    async connect(options, firstTimeoutSeconds = 30, secondTimeoutMinutes = 5) {
+        let connection = await this.connectSocket(options);
+        let { virtualDocument } = options;
+        if (!connection.isReady) {
+            try {
+                // user feedback hinted that 40 seconds was too short and some users are willing to wait more;
+                // to make the best of both worlds we first check frequently (6.6 times a second) for the first
+                // 30 seconds, and show the warning early in case if something is wrong; we then continue retrying
+                // for another 5 minutes, but only once per second.
+                await untilReady(() => connection.isReady, Math.round((firstTimeoutSeconds * 1000) / 150), 150);
+            }
+            catch (_a) {
+                console.log(`Connection to ${virtualDocument.uri} timed out after ${firstTimeoutSeconds} seconds, will continue retrying for another ${secondTimeoutMinutes} minutes`);
+                try {
+                    await untilReady(() => connection.isReady, 60 * secondTimeoutMinutes, 1000);
+                }
+                catch (_b) {
+                    console.log(`Connection to ${virtualDocument.uri} timed out again after ${secondTimeoutMinutes} minutes, giving up`);
+                    return;
+                }
+            }
+        }
+        this.connected.emit({ connection, virtualDocument });
+        return connection;
+    }
+    unregisterDocument(virtualDocument, emit = true) {
+        const connection = this.connections.get(virtualDocument.uri);
+        if (connection) {
+            this.connections.delete(virtualDocument.uri);
+            const allConnection = new Set(this.connections.values());
+            if (!allConnection.has(connection)) {
+                this.disconnect(connection.serverIdentifier);
+            }
+            if (emit) {
+                this.documentsChanged.emit(this.documents);
+            }
+        }
+    }
+    updateLogging(logAllCommunication, setTrace) {
+        for (const connection of this.connections.values()) {
+            connection.logAllCommunication = logAllCommunication;
+            if (setTrace !== null) {
+                connection.clientNotifications['$/setTrace'].emit({ value: setTrace });
+            }
+        }
+    }
+    forEachDocumentOfConnection(connection, callback) {
+        for (const [virtualDocumentUri, currentConnection] of this.connections.entries()) {
+            if (connection !== currentConnection) {
+                continue;
+            }
+            callback(this.documents.get(virtualDocumentUri));
+        }
+    }
+}
+(function (DocumentConnectionManager) {
+    function solveUris(virtualDocument, language) {
+        const wsBase = PageConfig.getBaseUrl().replace(/^http/, 'ws');
+        const rootUri = PageConfig.getOption('rootUri');
+        const virtualDocumentsUri = PageConfig.getOption('virtualDocumentsUri');
+        const baseUri = virtualDocument.hasLspSupportedFile
+            ? rootUri
+            : virtualDocumentsUri;
+        // for now take the best match only
+        const matchingServers = Private.getLanguageServerManager().getMatchingServers({
+            language
+        });
+        const languageServerId = matchingServers.length === 0 ? null : matchingServers[0];
+        if (languageServerId === null) {
+            throw `No language server installed for language ${language}`;
+        }
+        // workaround url-parse bug(s) (see https://github.com/jupyter-lsp/jupyterlab-lsp/issues/595)
+        let documentUri = URLExt.join(baseUri, virtualDocument.uri);
+        if (!documentUri.startsWith('file:///') &&
+            documentUri.startsWith('file://')) {
+            documentUri = documentUri.replace('file://', 'file:///');
+            if (documentUri.startsWith('file:///users/') &&
+                baseUri.startsWith('file:///Users/')) {
+                documentUri = documentUri.replace('file:///users/', 'file:///Users/');
+            }
+        }
+        return {
+            base: baseUri,
+            document: documentUri,
+            server: URLExt.join('ws://jupyter-lsp', language),
+            socket: URLExt.join(wsBase, 'lsp', 'ws', languageServerId)
+        };
+    }
+    DocumentConnectionManager.solveUris = solveUris;
+})(DocumentConnectionManager || (DocumentConnectionManager = {}));
+/**
+ * Namespace primarily for language-keyed cache of LSPConnections
+ */
+var Private;
+(function (Private) {
+    const _connections = new Map();
+    let _languageServerManager;
+    function getLanguageServerManager() {
+        return _languageServerManager;
+    }
+    Private.getLanguageServerManager = getLanguageServerManager;
+    function setLanguageServerManager(languageServerManager) {
+        _languageServerManager = languageServerManager;
+    }
+    Private.setLanguageServerManager = setLanguageServerManager;
+    function disconnect(languageServerId) {
+        const connection = _connections.get(languageServerId);
+        if (connection) {
+            connection.close();
+            _connections.delete(languageServerId);
+        }
+    }
+    Private.disconnect = disconnect;
+    /**
+     * Return (or create and initialize) the WebSocket associated with the language
+     */
+    async function connection(language, languageServerId, uris, onCreate, capabilities) {
+        let connection = _connections.get(languageServerId);
+        if (connection == null) {
+            const socket = new WebSocket(uris.socket);
+            const connection = new LSPConnection({
+                languageId: language,
+                serverUri: uris.server,
+                rootUri: uris.base,
+                serverIdentifier: languageServerId,
+                capabilities: capabilities
+            });
+            // TODO: remove remaining unbounded users of connection.on
+            connection.setMaxListeners(999);
+            _connections.set(languageServerId, connection);
+            connection.connect(socket);
+            onCreate(connection);
+        }
+        connection = _connections.get(languageServerId);
+        return connection;
+    }
+    Private.connection = connection;
+    function updateServerConfiguration(languageServerId, settings) {
+        const connection = _connections.get(languageServerId);
+        if (connection) {
+            connection.sendConfigurationChange(settings);
+        }
+    }
+    Private.updateServerConfiguration = updateServerConfiguration;
+})(Private || (Private = {}));
+//# sourceMappingURL=connection_manager.js.map

package/lib/connection_manager.js.map

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

package/lib/extractors/manager.d.ts

@@ -0,0 +1,13 @@
+import { CellType } from '@jupyterlab/nbformat';
+import { ILSPCodeExtractorsManager } from '../tokens';
+import { IForeignCodeExtractor } from './types';
+export declare class CodeExtractorsManager implements ILSPCodeExtractorsManager {
+    private _extractorMap;
+    private _extractorMapAnyLanguage;
+    constructor();
+    getExtractors(cellType: CellType, hostLanguage: string | null): IForeignCodeExtractor[];
+    /**
+     * Register an extractor to extract foreign code from host documents of specified language.
+     */
+    register(extractor: IForeignCodeExtractor, hostLanguage: string | null): void;
+}

package/lib/extractors/manager.js

@@ -0,0 +1,44 @@
+export class CodeExtractorsManager {
+    constructor() {
+        this._extractorMap = new Map();
+        this._extractorMapAnyLanguage = new Map();
+        ['code', 'markdown', 'raw'].forEach(cell => {
+            this._extractorMap.set(cell, new Map());
+            this._extractorMapAnyLanguage.set(cell, []);
+        });
+    }
+    getExtractors(cellType, hostLanguage) {
+        var _a, _b;
+        if (hostLanguage) {
+            const currentMap = this._extractorMap.get(cellType);
+            return (_a = currentMap.get(hostLanguage)) !== null && _a !== void 0 ? _a : [];
+        }
+        else {
+            return (_b = this._extractorMapAnyLanguage.get(cellType)) !== null && _b !== void 0 ? _b : [];
+        }
+    }
+    /**
+     * Register an extractor to extract foreign code from host documents of specified language.
+     */
+    register(extractor, hostLanguage) {
+        const cellType = extractor.cellType;
+        if (hostLanguage) {
+            cellType.forEach(type => {
+                const currentMap = this._extractorMap.get(type);
+                const extractorList = currentMap.get(hostLanguage);
+                if (!extractorList) {
+                    currentMap.set(hostLanguage, [extractor]);
+                }
+                else {
+                    extractorList === null || extractorList === void 0 ? void 0 : extractorList.push(extractor);
+                }
+            });
+        }
+        else {
+            cellType.forEach(type => {
+                this._extractorMapAnyLanguage.get(type).push(extractor);
+            });
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/lib/extractors/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/extractors/manager.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,qBAAqB;IAGhC;QACE,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAGzB,CAAC;QAEJ,IAAI,CAAC,wBAAwB,GAAG,IAAI,GAAG,EAGpC,CAAC;QAEH,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACzD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,QAAkB,EAClB,YAA2B;;QAE3B,IAAI,YAAY,EAAE;YAChB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;YACrD,OAAO,MAAA,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,mCAAI,EAAE,CAAC;SAC3C;aAAM;YACL,OAAO,MAAA,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,mCAAI,EAAE,CAAC;SAC1D;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,SAAgC,EAChC,YAA2B;QAE3B,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QACpC,IAAI,YAAY,EAAE;YAChB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;gBACjD,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBACnD,IAAI,CAAC,aAAa,EAAE;oBAClB,UAAU,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;iBAC3C;qBAAM;oBACL,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,IAAI,CAAC,SAAS,CAAC,CAAC;iBAChC;YACH,CAAC,CAAC,CAAC;SACJ;aAAM;YACL,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACtB,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;SACJ;IACH,CAAC;CACF"}

package/lib/extractors/text_extractor.d.ts

@@ -0,0 +1,28 @@
+import { CellType } from '@jupyterlab/nbformat';
+import { LanguageIdentifier } from '../lsp';
+import { IExtractedCode, IForeignCodeExtractor } from './types';
+export declare class TextForeignCodeExtractor implements IForeignCodeExtractor {
+    language: LanguageIdentifier;
+    standalone: boolean;
+    fileExtension: string;
+    cellType: CellType[];
+    constructor(options: TextForeignCodeExtractor.IOptions);
+    hasForeignCode(code: string, cellType: CellType): boolean;
+    extractForeignCode(code: string): IExtractedCode[];
+}
+declare namespace TextForeignCodeExtractor {
+    interface IOptions {
+        /**
+         * The foreign language.
+         */
+        language: string;
+        /**
+         * Should the foreign code be appended (False) to the previously established virtual document of the same language,
+         * or is it standalone snippet which requires separate connection?
+         */
+        isStandalone: boolean;
+        file_extension: string;
+        cellType: CellType[];
+    }
+}
+export {};

package/lib/extractors/text_extractor.js

@@ -0,0 +1,27 @@
+import { positionAtOffset } from '../positioning';
+export class TextForeignCodeExtractor {
+    constructor(options) {
+        this.language = options.language;
+        this.standalone = options.isStandalone;
+        this.fileExtension = options.file_extension;
+        this.cellType = options.cellType;
+    }
+    hasForeignCode(code, cellType) {
+        return this.cellType.includes(cellType);
+    }
+    extractForeignCode(code) {
+        let lines = code.split('\n');
+        let extracts = new Array();
+        let foreignCodeFragment = code;
+        let start = positionAtOffset(0, lines);
+        let end = positionAtOffset(foreignCodeFragment.length, lines);
+        extracts.push({
+            hostCode: '',
+            foreignCode: foreignCodeFragment,
+            range: { start, end },
+            virtualShift: null
+        });
+        return extracts;
+    }
+}
+//# sourceMappingURL=text_extractor.js.map

package/lib/extractors/text_extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text_extractor.js","sourceRoot":"","sources":["../../src/extractors/text_extractor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD,MAAM,OAAO,wBAAwB;IAMnC,YAAY,OAA0C;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,QAAkB;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC7B,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7B,IAAI,QAAQ,GAAG,IAAI,KAAK,EAAkB,CAAC;QAE3C,IAAI,mBAAmB,GAAG,IAAI,CAAC;QAE/B,IAAI,KAAK,GAAG,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,GAAG,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE9D,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,mBAAmB;YAChC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;YACrB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/extractors/types.d.ts

@@ -0,0 +1,65 @@
+import { CodeEditor } from '@jupyterlab/codeeditor';
+import { CellType } from '@jupyterlab/nbformat';
+import { LanguageIdentifier } from '../lsp';
+export interface IExtractedCode {
+    /**
+     * Foreign code (may be empty, for example line of '%R') or null if none.
+     */
+    foreignCode: string | null;
+    /**
+     * Range of the foreign code relative to the original source.
+     * `null` is used internally to represent a leftover host code after extraction.
+     */
+    range: CodeEditor.IRange | null;
+    /**
+     * Shift due to any additional code inserted at the beginning of the virtual document
+     * (usually in order to mock the arguments passed to a magic, or to provide other context clues for the linters)
+     */
+    virtualShift: CodeEditor.IPosition | null;
+    /**
+     * Code to be retained in the virtual document of the host.
+     */
+    hostCode: string | null;
+}
+/**
+ * Foreign code extractor makes it possible to analyze code of language X embedded in code (or notebook) of language Y.
+ *
+ * The typical examples are:
+ *  - (X=CSS< Y=HTML), or
+ *  - (X=JavaScript, Y=HTML),
+ *
+ * while in the data analysis realm, examples include:
+ *   - (X=R, Y=IPython),
+ *   - (X=LATEX Y=IPython),
+ *   - (X=SQL, Y=IPython)
+ *
+ * This extension does not aim to provide comprehensive abilities for foreign code extraction,
+ * but it does intend to provide stable interface for other extensions to build on it.
+ *
+ * A simple, regular expression based, configurable foreign extractor is implemented
+ * to provide a good reference and a good initial experience for the users.
+ */
+export interface IForeignCodeExtractor {
+    /**
+     * The foreign language.
+     */
+    language: LanguageIdentifier;
+    cellType: CellType[];
+    /**
+     * Split the code into the host and foreign code (if any foreign code was detected)
+     */
+    extractForeignCode(code: string): IExtractedCode[];
+    /**
+     * Does the extractor produce code which should be appended to the previously established virtual document (False)
+     * of the same language, or does it produce standalone snippets which require separate connections (True)?
+     */
+    standalone: boolean;
+    /**
+     * Test if there is any foreign code in provided code snippet.
+     */
+    hasForeignCode(code: string, cellType: CellType): boolean;
+    /**
+     * Extension of the virtual document (some servers check extensions of files), e.g. 'py' or 'R'.
+     */
+    fileExtension: string;
+}

package/lib/extractors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/extractors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/extractors/types.ts"],"names":[],"mappings":""}

package/lib/feature.d.ts

@@ -0,0 +1,11 @@
+import { ISignal } from '@lumino/signaling';
+import { ClientCapabilities } from './lsp';
+import { IFeature, ILSPFeatureManager } from './tokens';
+export declare class FeatureManager implements ILSPFeatureManager {
+    readonly features: Array<IFeature>;
+    private _featuresRegistered;
+    constructor();
+    register(feature: IFeature): void;
+    get featuresRegistered(): ISignal<ILSPFeatureManager, IFeature>;
+    clientCapabilities(): ClientCapabilities;
+}

package/lib/feature.js

@@ -0,0 +1,31 @@
+import { Signal } from '@lumino/signaling';
+import mergeWith from 'lodash.mergewith';
+export class FeatureManager {
+    constructor() {
+        this.features = [];
+        this._featuresRegistered = new Signal(this);
+    }
+    register(feature) {
+        if (this.features.some(ft => ft.id === feature.id)) {
+            console.warn(`Feature with id ${feature.id} is already registered, skipping.`);
+        }
+        else {
+            this.features.push(feature);
+            this._featuresRegistered.emit(feature);
+        }
+    }
+    get featuresRegistered() {
+        return this._featuresRegistered;
+    }
+    clientCapabilities() {
+        let capabilities = {};
+        for (const feature of this.features) {
+            if (!feature.capabilities) {
+                continue;
+            }
+            capabilities = mergeWith(capabilities, feature.capabilities);
+        }
+        return capabilities;
+    }
+}
+//# sourceMappingURL=feature.js.map

package/lib/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../src/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,SAAS,MAAM,kBAAkB,CAAC;AAKzC,MAAM,OAAO,cAAc;IAGzB;QAFgB,aAAQ,GAAoB,EAAE,CAAC;QAG7C,IAAI,CAAC,mBAAmB,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ,CAAC,OAAiB;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,EAAE;YAClD,OAAO,CAAC,IAAI,CACV,mBAAmB,OAAO,CAAC,EAAE,mCAAmC,CACjE,CAAC;SACH;aAAM;YACL,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SACxC;IACH,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,kBAAkB;QAChB,IAAI,YAAY,GAAuB,EAAE,CAAC;QAC1C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE;YACnC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;gBACzB,SAAS;aACV;YACD,YAAY,GAAG,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;SAC9D;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @packageDocumentation
+ * @module lsp
+ */
+export * from './connection_manager';
+export * from './manager';
+export * from './tokens';
+export * from './adapters/adapter';
+export * from './positioning';
+export * from './virtual/document';
+export * from './utils';
+export * from './connection';
+export * from './feature';
+export * from './extractors/manager';
+export * from './extractors/text_extractor';
+export * from './extractors/types';
+export * from './plugin';

package/lib/index.js

@@ -0,0 +1,22 @@
+/* -----------------------------------------------------------------------------
+| Copyright (c) Jupyter Development Team.
+| Distributed under the terms of the Modified BSD License.
+|----------------------------------------------------------------------------*/
+/**
+ * @packageDocumentation
+ * @module lsp
+ */
+export * from './connection_manager';
+export * from './manager';
+export * from './tokens';
+export * from './adapters/adapter';
+export * from './positioning';
+export * from './virtual/document';
+export * from './utils';
+export * from './connection';
+export * from './feature';
+export * from './extractors/manager';
+export * from './extractors/text_extractor';
+export * from './extractors/types';
+export * from './plugin';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;+EAG+E;AAC/E;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC"}