@jupyterlab/lsp 4.0.0-alpha.11

package/lib/schema.d.ts

@@ -0,0 +1,228 @@
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run jlpm build:schema to regenerate this file.
+ */
+/**
+ * which version of the spec this implements
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "current-version".
+ */
+export declare type SpecSchemaVersion = 2;
+/**
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "env-var".
+ *
+ * This interface was referenced by `EnvironmentVariables`'s JSON-Schema definition
+ * via the `patternProperty` "[^ ]+".
+ */
+export declare type AnEnvironmentVariableMayContainPythonStringTemplateEvaluatedAgainstTheExistingEnvironmentEG$HOME = string;
+/**
+ * the install commands or description for installing the language server
+ *
+ * This interface was referenced by `Installation`'s JSON-Schema definition
+ * via the `patternProperty` ".+".
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "install-help".
+ *
+ * This interface was referenced by `Installation1`'s JSON-Schema definition
+ * via the `patternProperty` ".+".
+ */
+export declare type InstallHelp = string;
+/**
+ * languages supported by this Language Server
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "language-list".
+ */
+export declare type LanguageList = [string, ...string[]];
+/**
+ * a description of a language server that could be started
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "language-server-spec".
+ *
+ * This interface was referenced by `LanguageServerSpecsMap`'s JSON-Schema definition
+ * via the `patternProperty` ".*".
+ */
+export declare type LanguageServerSpec = ServerSpecProperties & {
+    [k: string]: any;
+};
+/**
+ * the arguments to start the language server normally
+ */
+export declare type LaunchArguments = string[];
+/**
+ * the arguments to start the language server with more verbose output
+ */
+export declare type DebugArguments = string[];
+/**
+ * name shown in the UI
+ */
+export declare type DisplayName = string;
+/**
+ * known extensions that can contribute to the Language Server's features
+ */
+export declare type Extensions = LanguageServerExtension[];
+/**
+ * list of MIME types supported by the language server
+ */
+export declare type MIMETypes = [string, ...string[]];
+/**
+ * information on troubleshooting the installation or auto-detection of the language server
+ */
+export declare type Troubleshooting = string;
+/**
+ * a date/time that might not have been recorded
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "nullable-date-time".
+ */
+export declare type NullableDateTime = string | null;
+/**
+ * the count of currently-connected WebSocket handlers
+ */
+export declare type HandlerCount = number;
+/**
+ * a list of tokens for running a command
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "shell-args".
+ */
+export declare type ShellArgs = string[];
+/**
+ * describes the current state of (potentially) running language servers
+ */
+export interface JupyterLspServerStatusResponse {
+    [k: string]: any;
+}
+/**
+ * a JSON schema to configure the Language Server or extension behavior from the client
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "client-config-schema".
+ */
+export interface ClientConfigurationSchema {
+    [k: string]: any;
+}
+/**
+ * a list of installation approaches keyed by package manager, e.g. pip, npm, yarn, apt
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "install-bundle".
+ */
+export interface Installation {
+    [k: string]: InstallHelp;
+}
+/**
+ * an extension which can extend the functionality of the language server and client
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "language-server-extension".
+ */
+export interface LanguageServerExtension {
+    config_schema?: ClientConfigurationSchema;
+    display_name?: string;
+    install?: Installation;
+    [k: string]: any;
+}
+/**
+ * all properties that might be required to start and/or describe a Language Server
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "partial-language-server-spec".
+ */
+export interface ServerSpecProperties {
+    argv?: LaunchArguments;
+    config_schema?: ClientConfigurationSchema1;
+    debug_argv?: DebugArguments;
+    display_name?: DisplayName;
+    env?: EnvironmentVariables;
+    extend?: Extensions;
+    install?: Installation1;
+    languages?: LanguageList;
+    mime_types?: MIMETypes;
+    troubleshoot?: Troubleshooting;
+    urls?: URLs;
+    version?: SpecSchemaVersion;
+    [k: string]: any;
+}
+/**
+ * a JSON schema to configure the Language Server behavior from the client
+ */
+export interface ClientConfigurationSchema1 {
+    [k: string]: any;
+}
+/**
+ * additional environment variables to set when starting the language server
+ */
+export interface EnvironmentVariables {
+    [k: string]: AnEnvironmentVariableMayContainPythonStringTemplateEvaluatedAgainstTheExistingEnvironmentEG$HOME;
+}
+/**
+ * a list of installation approaches keyed by package manager, e.g. pip, npm, yarn, apt
+ */
+export interface Installation1 {
+    [k: string]: InstallHelp;
+}
+/**
+ * a collection of urls keyed by type, e.g. home, issues
+ */
+export interface URLs {
+    [k: string]: string;
+}
+/**
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "servers-response".
+ */
+export interface ServersResponse {
+    sessions: Sessions;
+    specs?: LanguageServerSpecsMap;
+    version: SpecSchemaVersion;
+    [k: string]: any;
+}
+/**
+ * named server sessions that are, could be, or were running
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "sessions".
+ */
+export interface Sessions {
+    [k: string]: LanguageServerSession;
+}
+/**
+ * a language server session
+ *
+ * This interface was referenced by `Sessions`'s JSON-Schema definition
+ * via the `patternProperty` ".*".
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "session".
+ */
+export interface LanguageServerSession {
+    handler_count: HandlerCount;
+    /**
+     * date-time of last seen message from a WebSocket handler
+     */
+    last_handler_message_at: string | null;
+    /**
+     * date-time of last seen message from the language server
+     */
+    last_server_message_at: string | null;
+    spec: ServerSpecProperties;
+    /**
+     * a string describing the current state of the server
+     */
+    status: 'not_started' | 'starting' | 'started' | 'stopping' | 'stopped';
+}
+/**
+ * a set of language servers keyed by their implementation name
+ *
+ * This interface was referenced by `JupyterLspServerStatusResponse`'s JSON-Schema
+ * via the `definition` "language-server-specs-implementation-map".
+ */
+export interface LanguageServerSpecsMap {
+    [k: string]: LanguageServerSpec;
+}

package/lib/schema.js

@@ -0,0 +1,3 @@
+/* eslint-disable */
+export {};
+//# sourceMappingURL=schema.js.map

package/lib/schema.js.map

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

package/lib/tokens.d.ts

@@ -0,0 +1,368 @@
+import { IDocumentWidget } from '@jupyterlab/docregistry';
+import { CellType } from '@jupyterlab/nbformat';
+import { ServerConnection } from '@jupyterlab/services';
+import { Token } from '@lumino/coreutils';
+import { ISignal, Signal } from '@lumino/signaling';
+import { AnyCompletion, AnyLocation, IDocumentInfo, ILspConnection, ILspOptions, IPosition, ITokenInfo } from 'lsp-ws-connection';
+import { WidgetAdapter } from './adapters/adapter';
+import { IForeignCodeExtractor } from './extractors/types';
+import { ClientCapabilities, LanguageIdentifier } from './lsp';
+import { LanguageServer2 as LSPLanguageServerSettings } from './plugin';
+import * as SCHEMA from './schema';
+import { VirtualDocument } from './virtual/document';
+import type * as rpc from 'vscode-jsonrpc';
+import type * as lsp from 'vscode-languageserver-protocol';
+export declare type TLanguageServerId = 'pylsp' | 'bash-language-server' | 'dockerfile-language-server-nodejs' | 'javascript-typescript-langserver' | 'unified-language-server' | 'vscode-css-languageserver-bin' | 'vscode-html-languageserver-bin' | 'vscode-json-languageserver-bin' | 'yaml-language-server' | 'r-languageserver';
+export declare type TServerKeys = TLanguageServerId;
+export declare type TLanguageServerConfigurations = Partial<Record<TServerKeys, LSPLanguageServerSettings>>;
+export declare type TSessionMap = Map<TServerKeys, SCHEMA.LanguageServerSession>;
+export declare type TSpecsMap = Map<TServerKeys, SCHEMA.LanguageServerSpec>;
+export declare type TLanguageId = string;
+export interface ILanguageServerManager {
+    /**
+     * Signal emitted when the language server sessions are changed.
+     *
+     */
+    sessionsChanged: ISignal<ILanguageServerManager, void>;
+    /**
+     * The current session information of running language servers.
+     */
+    sessions: TSessionMap;
+    /**
+     * An ordered list of matching >running< sessions, with servers of higher priority higher in the list
+     */
+    getMatchingServers(options: ILanguageServerManager.IGetServerIdOptions): TLanguageServerId[];
+    /**
+     * A list of all known matching specs (whether detected or not).
+     */
+    getMatchingSpecs(options: ILanguageServerManager.IGetServerIdOptions): TSpecsMap;
+    /**
+     * Set the configuration for language servers
+     *
+     */
+    setConfiguration(configuration: TLanguageServerConfigurations): void;
+    /**
+     * Send a request to language server handler to get the session information.
+     *
+     */
+    fetchSessions(): Promise<void>;
+    /**
+     * Current endpoint to get the status of running language servers
+     */
+    statusUrl: string;
+    /**
+     *
+     * Status code of the `fetchSession` request.
+     */
+    statusCode: number;
+}
+export declare namespace ILanguageServerManager {
+    const URL_NS = "lsp";
+    interface IOptions {
+        settings?: ServerConnection.ISettings;
+        baseUrl?: string;
+        /**
+         * Number of connection retries to fetch the sessions.
+         * Default 2.
+         */
+        retries?: number;
+        /**
+         * The interval for retries, default 10 seconds.
+         */
+        retriesInterval?: number;
+    }
+    interface IGetServerIdOptions {
+        language?: TLanguageId;
+        mimeType?: string;
+    }
+}
+export interface ISocketConnectionOptions {
+    virtualDocument: VirtualDocument;
+    /**
+     * The language identifier, corresponding to the API endpoint on the LSP proxy server.
+     */
+    language: string;
+    /**
+     * LSP capabilities describing currently supported features
+     */
+    capabilities: ClientCapabilities;
+    hasLspSupportedFile: boolean;
+}
+export interface IDocumentRegistationOptions {
+    /**
+     * The language identifier, corresponding to the API endpoint on the LSP proxy server.
+     */
+    language: string;
+    /**
+     * Path to the document in the JupyterLab space
+     */
+    document: string;
+    /**
+     * LSP capabilities describing currently supported features
+     */
+    capabilities: ClientCapabilities;
+    hasLspSupportedFile: boolean;
+}
+export interface IDocumentConnectionData {
+    virtualDocument: VirtualDocument;
+    connection: ILSPConnection;
+}
+export interface ILSPDocumentConnectionManager {
+    /**
+     * The mapping of document uri to the  connection to language server.
+     */
+    connections: Map<VirtualDocument.uri, ILSPConnection>;
+    /**
+     * The mapping of document uri to the virtual document.
+     */
+    documents: Map<VirtualDocument.uri, VirtualDocument>;
+    /**
+     * The mapping of document uri to the widget adapter.
+     */
+    adapters: Map<string, WidgetAdapter<IDocumentWidget>>;
+    /**
+     * Signal emitted when a connection is connected.
+     */
+    connected: ISignal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Signal emitted when a connection is disconnected.
+     */
+    disconnected: ISignal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Signal emitted when the language server is initialized.
+     */
+    initialized: ISignal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Signal emitted when a virtual document is closed.
+     */
+    closed: ISignal<ILSPDocumentConnectionManager, IDocumentConnectionData>;
+    /**
+     * Signal emitted when the content of a virtual document is changed.
+     */
+    documentsChanged: ISignal<ILSPDocumentConnectionManager, Map<VirtualDocument.uri, VirtualDocument>>;
+    /**
+     * The language server manager instance.
+     */
+    languageServerManager: ILanguageServerManager;
+    /**
+     * Handles the settings that do not require an existing connection
+     * with a language server (or can influence to which server the
+     * connection will be created, e.g. `priority`).
+     *
+     * This function should be called **before** initialization of servers.
+     */
+    updateConfiguration(allServerSettings: TLanguageServerConfigurations): void;
+    /**
+     * Handles the settings that the language servers accept using
+     * `onDidChangeConfiguration` messages, which should be passed under
+     * the "serverSettings" keyword in the setting registry.
+     * Other configuration options are handled by `updateConfiguration` instead.
+     *
+     * This function should be called **after** initialization of servers.
+     */
+    updateServerConfigurations(allServerSettings: TLanguageServerConfigurations): void;
+    /**
+     * Retry to connect to the server each `reconnectDelay` seconds
+     * and for `retrialsLeft` times.
+     *
+     */
+    retryToConnect(options: ISocketConnectionOptions, reconnectDelay: number, retrialsLeft: number): Promise<void>;
+    /**
+     * Create a new connection to the language server
+     * @return A promise of the LSP connection
+     */
+    connect(options: ISocketConnectionOptions, firstTimeoutSeconds?: number, secondTimeoutMinute?: number): Promise<ILSPConnection | undefined>;
+    /**
+     * Disconnect the connection to the language server of the requested
+     * language.
+     *
+     */
+    disconnect(languageId: TLanguageServerId): void;
+    /**
+     * Disconnect the signals of requested virtual document.
+     *
+     */
+    unregisterDocument(virtualDocument: VirtualDocument): void;
+    /**
+     * Register a widget adapter.
+     *
+     * @param  path - path to current document widget of input adapter
+     * @param  adapter - the adapter need to be registered
+     */
+    registerAdapter(path: string, adapter: WidgetAdapter<IDocumentWidget>): void;
+}
+export interface IFeature {
+    /**
+     * The feature identifier. It must be the same as the feature plugin id.
+     */
+    id: string;
+    /**
+     * LSP capabilities implemented by the feature.
+     */
+    capabilities?: ClientCapabilities;
+}
+export interface ILSPFeatureManager {
+    /**
+     * A read-only registry of all registered features.
+     */
+    readonly features: IFeature[];
+    /**
+     * Register the new feature (frontend capability)
+     * for one or more code editor implementations.
+     */
+    register(feature: IFeature): void;
+    featuresRegistered: ISignal<ILSPFeatureManager, IFeature>;
+    clientCapabilities(): ClientCapabilities;
+}
+/**
+ * Manages code transclusion plugins.
+ */
+export interface ILSPCodeExtractorsManager {
+    /**
+     * Get the foreign code extractors.
+     */
+    getExtractors(cellType: CellType, hostLanguage: string | null): IForeignCodeExtractor[];
+    /**
+     * Register the extraction rules to be applied in documents with language `host_language`.
+     */
+    register(extractor: IForeignCodeExtractor, hostLanguage: LanguageIdentifier | null): void;
+}
+export declare const ILSPDocumentConnectionManager: Token<ILSPDocumentConnectionManager>;
+export declare const ILSPFeatureManager: Token<ILSPFeatureManager>;
+export declare const ILSPCodeExtractorsManager: Token<ILSPCodeExtractorsManager>;
+export interface ILSPOptions extends ILspOptions {
+    capabilities: ClientCapabilities;
+    serverIdentifier?: string;
+}
+/**
+ * Method strings are reproduced here because a non-typing import of
+ * `vscode-languageserver-protocol` is ridiculously expensive.
+ */
+export declare namespace Method {
+    /** Server notifications */
+    enum ServerNotification {
+        PUBLISH_DIAGNOSTICS = "textDocument/publishDiagnostics",
+        SHOW_MESSAGE = "window/showMessage",
+        LOG_TRACE = "$/logTrace",
+        LOG_MESSAGE = "window/logMessage"
+    }
+    /** Client notifications */
+    enum ClientNotification {
+        DID_CHANGE = "textDocument/didChange",
+        DID_CHANGE_CONFIGURATION = "workspace/didChangeConfiguration",
+        DID_OPEN = "textDocument/didOpen",
+        DID_SAVE = "textDocument/didSave",
+        INITIALIZED = "initialized",
+        SET_TRACE = "$/setTrace"
+    }
+    /** Server requests */
+    enum ServerRequest {
+        REGISTER_CAPABILITY = "client/registerCapability",
+        SHOW_MESSAGE_REQUEST = "window/showMessageRequest",
+        UNREGISTER_CAPABILITY = "client/unregisterCapability",
+        WORKSPACE_CONFIGURATION = "workspace/configuration"
+    }
+    /** Client requests */
+    enum ClientRequest {
+        COMPLETION = "textDocument/completion",
+        COMPLETION_ITEM_RESOLVE = "completionItem/resolve",
+        DEFINITION = "textDocument/definition",
+        DOCUMENT_HIGHLIGHT = "textDocument/documentHighlight",
+        DOCUMENT_SYMBOL = "textDocument/documentSymbol",
+        HOVER = "textDocument/hover",
+        IMPLEMENTATION = "textDocument/implementation",
+        INITIALIZE = "initialize",
+        REFERENCES = "textDocument/references",
+        RENAME = "textDocument/rename",
+        SIGNATURE_HELP = "textDocument/signatureHelp",
+        TYPE_DEFINITION = "textDocument/typeDefinition"
+    }
+}
+export interface IServerNotifyParams {
+    [Method.ServerNotification.LOG_MESSAGE]: lsp.LogMessageParams;
+    [Method.ServerNotification.LOG_TRACE]: rpc.LogTraceParams;
+    [Method.ServerNotification.PUBLISH_DIAGNOSTICS]: lsp.PublishDiagnosticsParams;
+    [Method.ServerNotification.SHOW_MESSAGE]: lsp.ShowMessageParams;
+}
+export interface IClientNotifyParams {
+    [Method.ClientNotification
+        .DID_CHANGE_CONFIGURATION]: lsp.DidChangeConfigurationParams;
+    [Method.ClientNotification.DID_CHANGE]: lsp.DidChangeTextDocumentParams;
+    [Method.ClientNotification.DID_OPEN]: lsp.DidOpenTextDocumentParams;
+    [Method.ClientNotification.DID_SAVE]: lsp.DidSaveTextDocumentParams;
+    [Method.ClientNotification.INITIALIZED]: lsp.InitializedParams;
+    [Method.ClientNotification.SET_TRACE]: rpc.SetTraceParams;
+}
+export interface IServerRequestParams {
+    [Method.ServerRequest.REGISTER_CAPABILITY]: lsp.RegistrationParams;
+    [Method.ServerRequest.SHOW_MESSAGE_REQUEST]: lsp.ShowMessageRequestParams;
+    [Method.ServerRequest.UNREGISTER_CAPABILITY]: lsp.UnregistrationParams;
+    [Method.ServerRequest.WORKSPACE_CONFIGURATION]: lsp.ConfigurationParams;
+}
+export interface IServerResult {
+    [Method.ServerRequest.REGISTER_CAPABILITY]: void;
+    [Method.ServerRequest.SHOW_MESSAGE_REQUEST]: lsp.MessageActionItem | null;
+    [Method.ServerRequest.UNREGISTER_CAPABILITY]: void;
+    [Method.ServerRequest.WORKSPACE_CONFIGURATION]: any[];
+}
+export interface IClientRequestParams {
+    [Method.ClientRequest.COMPLETION_ITEM_RESOLVE]: lsp.CompletionItem;
+    [Method.ClientRequest.COMPLETION]: lsp.CompletionParams;
+    [Method.ClientRequest.DEFINITION]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.DOCUMENT_HIGHLIGHT]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.DOCUMENT_SYMBOL]: lsp.DocumentSymbolParams;
+    [Method.ClientRequest.HOVER]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.IMPLEMENTATION]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.INITIALIZE]: lsp.InitializeParams;
+    [Method.ClientRequest.REFERENCES]: lsp.ReferenceParams;
+    [Method.ClientRequest.RENAME]: lsp.RenameParams;
+    [Method.ClientRequest.SIGNATURE_HELP]: lsp.TextDocumentPositionParams;
+    [Method.ClientRequest.TYPE_DEFINITION]: lsp.TextDocumentPositionParams;
+}
+export interface IClientResult {
+    [Method.ClientRequest.COMPLETION_ITEM_RESOLVE]: lsp.CompletionItem;
+    [Method.ClientRequest.COMPLETION]: AnyCompletion;
+    [Method.ClientRequest.DEFINITION]: AnyLocation;
+    [Method.ClientRequest.DOCUMENT_HIGHLIGHT]: lsp.DocumentHighlight[];
+    [Method.ClientRequest.DOCUMENT_SYMBOL]: lsp.DocumentSymbol[];
+    [Method.ClientRequest.HOVER]: lsp.Hover | null;
+    [Method.ClientRequest.IMPLEMENTATION]: AnyLocation;
+    [Method.ClientRequest.INITIALIZE]: lsp.InitializeResult;
+    [Method.ClientRequest.REFERENCES]: lsp.Location[] | null;
+    [Method.ClientRequest.RENAME]: lsp.WorkspaceEdit;
+    [Method.ClientRequest.SIGNATURE_HELP]: lsp.SignatureHelp;
+    [Method.ClientRequest.TYPE_DEFINITION]: AnyLocation;
+}
+export declare type ServerNotifications<T extends keyof IServerNotifyParams = keyof IServerNotifyParams> = {
+    readonly [key in T]: ISignal<ILSPConnection, IServerNotifyParams[key]>;
+};
+export declare type ClientNotifications<T extends keyof IClientNotifyParams = keyof IClientNotifyParams> = {
+    readonly [key in T]: Signal<ILSPConnection, IClientNotifyParams[key]>;
+};
+export interface IClientRequestHandler<T extends keyof IClientRequestParams = keyof IClientRequestParams> {
+    request(params: IClientRequestParams[T]): Promise<IClientResult[T]>;
+}
+export interface IServerRequestHandler<T extends keyof IServerRequestParams = keyof IServerRequestParams> {
+    setHandler(handler: (params: IServerRequestParams[T], connection?: ILSPConnection) => Promise<IServerResult[T]>): void;
+    clearHandler(): void;
+}
+export declare type ClientRequests<T extends keyof IClientRequestParams = keyof IClientRequestParams> = {
+    readonly [key in T]: IClientRequestHandler<key>;
+};
+export declare type ServerRequests<T extends keyof IServerRequestParams = keyof IServerRequestParams> = {
+    readonly [key in T]: IServerRequestHandler<key>;
+};
+export interface ILSPConnection extends ILspConnection {
+    serverIdentifier?: string;
+    serverLanguage?: string;
+    logAllCommunication: boolean;
+    isReady: boolean;
+    clientNotifications: ClientNotifications;
+    serverNotifications: ServerNotifications;
+    clientRequests: ClientRequests;
+    serverRequests: ServerRequests;
+    sendSaved(documentInfo: IDocumentInfo): void;
+    sendOpenWhenReady(documentInfo: IDocumentInfo): void;
+    sendFullTextChange(text: string, documentInfo: IDocumentInfo): void;
+    getCompletion(location: IPosition, token: ITokenInfo, documentInfo: IDocumentInfo, emit?: boolean, triggerCharacter?: string, triggerKind?: lsp.CompletionTriggerKind): Promise<lsp.CompletionItem[] | undefined>;
+}

package/lib/tokens.js

@@ -0,0 +1,58 @@
+import { Token } from '@lumino/coreutils';
+export var ILanguageServerManager;
+(function (ILanguageServerManager) {
+    ILanguageServerManager.URL_NS = 'lsp';
+})(ILanguageServerManager || (ILanguageServerManager = {}));
+export const ILSPDocumentConnectionManager = new Token('@jupyterlab/lsp:ILSPDocumentConnectionManager');
+export const ILSPFeatureManager = new Token('@jupyterlab/lsp:ILSPFeatureManager');
+export const ILSPCodeExtractorsManager = new Token('@jupyterlab/lsp:ILSPCodeExtractorsManager');
+/**
+ * Method strings are reproduced here because a non-typing import of
+ * `vscode-languageserver-protocol` is ridiculously expensive.
+ */
+export var Method;
+(function (Method) {
+    /** Server notifications */
+    let ServerNotification;
+    (function (ServerNotification) {
+        ServerNotification["PUBLISH_DIAGNOSTICS"] = "textDocument/publishDiagnostics";
+        ServerNotification["SHOW_MESSAGE"] = "window/showMessage";
+        ServerNotification["LOG_TRACE"] = "$/logTrace";
+        ServerNotification["LOG_MESSAGE"] = "window/logMessage";
+    })(ServerNotification = Method.ServerNotification || (Method.ServerNotification = {}));
+    /** Client notifications */
+    let ClientNotification;
+    (function (ClientNotification) {
+        ClientNotification["DID_CHANGE"] = "textDocument/didChange";
+        ClientNotification["DID_CHANGE_CONFIGURATION"] = "workspace/didChangeConfiguration";
+        ClientNotification["DID_OPEN"] = "textDocument/didOpen";
+        ClientNotification["DID_SAVE"] = "textDocument/didSave";
+        ClientNotification["INITIALIZED"] = "initialized";
+        ClientNotification["SET_TRACE"] = "$/setTrace";
+    })(ClientNotification = Method.ClientNotification || (Method.ClientNotification = {}));
+    /** Server requests */
+    let ServerRequest;
+    (function (ServerRequest) {
+        ServerRequest["REGISTER_CAPABILITY"] = "client/registerCapability";
+        ServerRequest["SHOW_MESSAGE_REQUEST"] = "window/showMessageRequest";
+        ServerRequest["UNREGISTER_CAPABILITY"] = "client/unregisterCapability";
+        ServerRequest["WORKSPACE_CONFIGURATION"] = "workspace/configuration";
+    })(ServerRequest = Method.ServerRequest || (Method.ServerRequest = {}));
+    /** Client requests */
+    let ClientRequest;
+    (function (ClientRequest) {
+        ClientRequest["COMPLETION"] = "textDocument/completion";
+        ClientRequest["COMPLETION_ITEM_RESOLVE"] = "completionItem/resolve";
+        ClientRequest["DEFINITION"] = "textDocument/definition";
+        ClientRequest["DOCUMENT_HIGHLIGHT"] = "textDocument/documentHighlight";
+        ClientRequest["DOCUMENT_SYMBOL"] = "textDocument/documentSymbol";
+        ClientRequest["HOVER"] = "textDocument/hover";
+        ClientRequest["IMPLEMENTATION"] = "textDocument/implementation";
+        ClientRequest["INITIALIZE"] = "initialize";
+        ClientRequest["REFERENCES"] = "textDocument/references";
+        ClientRequest["RENAME"] = "textDocument/rename";
+        ClientRequest["SIGNATURE_HELP"] = "textDocument/signatureHelp";
+        ClientRequest["TYPE_DEFINITION"] = "textDocument/typeDefinition";
+    })(ClientRequest = Method.ClientRequest || (Method.ClientRequest = {}));
+})(Method || (Method = {}));
+//# sourceMappingURL=tokens.js.map

package/lib/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA8F1C,MAAM,KAAW,sBAAsB,CAmBtC;AAnBD,WAAiB,sBAAsB;IACxB,6BAAM,GAAG,KAAK,CAAC;AAkB9B,CAAC,EAnBgB,sBAAsB,KAAtB,sBAAsB,QAmBtC;AAyMD,MAAM,CAAC,MAAM,6BAA6B,GACxC,IAAI,KAAK,CACP,+CAA+C,CAChD,CAAC;AAEJ,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CACzC,oCAAoC,CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,KAAK,CAChD,2CAA2C,CAC5C,CAAC;AAOF;;;GAGG;AACH,MAAM,KAAW,MAAM,CA0CtB;AA1CD,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,aAaX;IAbD,WAAY,aAAa;QACvB,uDAAsC,CAAA;QACtC,mEAAkD,CAAA;QAClD,uDAAsC,CAAA;QACtC,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;IACjD,CAAC,EAbW,aAAa,GAAb,oBAAa,KAAb,oBAAa,QAaxB;AACH,CAAC,EA1CgB,MAAM,KAAN,MAAM,QA0CtB"}

package/lib/utils.d.ts

@@ -0,0 +1,18 @@
+import { ReadonlyJSONObject, ReadonlyJSONValue } from '@lumino/coreutils';
+export declare function sleep(timeout: number): Promise<void>;
+export declare function untilReady(isReady: CallableFunction, maxRetrials?: number, interval?: number, intervalModifier?: (i: number) => number): Promise<CallableFunction>;
+export declare const expandDottedPaths: (obj: ReadonlyJSONObject) => ReadonlyJSONObject;
+/**
+ * The docs for many language servers show settings in the
+ * VSCode format, e.g.: "pyls.plugins.pyflakes.enabled"
+ *
+ * VSCode converts that dot notation to JSON behind the scenes,
+ * as the language servers themselves don't accept that syntax.
+ */
+export declare const expandPath: (path: string[], value: ReadonlyJSONValue) => ReadonlyJSONObject;
+export declare class DefaultMap<K, V> extends Map<K, V> {
+    private defaultFactory;
+    constructor(defaultFactory: (...args: any[]) => V, entries?: ReadonlyArray<readonly [K, V]> | null);
+    get(k: K): V;
+    getOrCreate(k: K, ...args: any[]): V;
+}