@difizen/libro-lsp 0.1.2

package/es/connection.d.ts

@@ -0,0 +1,149 @@
+import type { Event } from '@difizen/mana-app';
+import { Emitter } from '@difizen/mana-app';
+import type * as lsp from 'vscode-languageserver-protocol';
+import { Method } from './tokens.js';
+import type { ClientNotifications, ClientRequests, IDocumentInfo, ILSPConnection, ILSPOptions, ServerNotifications, ServerRequests } from './tokens.js';
+import { LspWsConnection } from './ws-connection/ws-connection.js';
+export declare const Provider: Record<string, keyof lsp.ServerCapabilities>;
+type AnyMethod = Method.ServerNotification | Method.ClientNotification | Method.ClientRequest | Method.ServerRequest;
+declare enum MessageKind {
+    clientNotifiedServer = 0,
+    serverNotifiedClient = 1,
+    serverRequested = 2,
+    clientRequested = 3,
+    resultForClient = 4,
+    responseForServer = 5
+}
+interface IMessageLog<T extends AnyMethod = AnyMethod> {
+    method: T;
+    message: any;
+}
+export declare class LSPConnection extends LspWsConnection implements ILSPConnection {
+    constructor(options: ILSPOptions);
+    /**
+     * Identifier of the language server
+     */
+    readonly serverIdentifier?: string;
+    /**
+     * Language of the language server
+     */
+    readonly serverLanguage?: string;
+    /**
+     * Notifications comes from the client.
+     */
+    readonly clientNotifications: ClientNotifications;
+    /**
+     * Notifications comes from the server.
+     */
+    readonly serverNotifications: ServerNotifications;
+    /**
+     * Requests comes from the client.
+     */
+    clientRequests: ClientRequests;
+    /**
+     * Responses comes from the server.
+     */
+    serverRequests: ServerRequests;
+    /**
+     * Should log all communication?
+     */
+    logAllCommunication: boolean;
+    get capabilities(): lsp.ServerCapabilities<any>;
+    /**
+     * Signal emitted when the connection is closed.
+     */
+    get closeSignal(): Event<boolean>;
+    /**
+     * Signal emitted when the connection receives an error
+     * message..
+     */
+    get errorSignal(): Event<any>;
+    /**
+     * Signal emitted when the connection is initialized.
+     */
+    get serverInitialized(): Event<lsp.ServerCapabilities<any>>;
+    /**
+     * Dispose the connection.
+     */
+    dispose(): void;
+    /**
+     * Helper to print the logs to logger, for now we are using
+     * directly the browser's console.
+     */
+    log(kind: MessageKind, message: IMessageLog): void;
+    /**
+     * Send the open request to the backend when the server is
+     * ready.
+     */
+    sendOpenWhenReady(documentInfo: IDocumentInfo): void;
+    /**
+     * Send the document changes to the server.
+     */
+    sendSelectiveChange(changeEvent: lsp.TextDocumentContentChangeEvent, documentInfo: IDocumentInfo): void;
+    /**
+     * Send all changes to the server.
+     */
+    sendFullTextChange(text: string, documentInfo: IDocumentInfo): void;
+    /**
+     * Check if a provider is available in the registered capabilities.
+     */
+    provides(provider: keyof lsp.ServerCapabilities): boolean;
+    /**
+     * Close the connection to the server.
+     */
+    close(): void;
+    /**
+     * initialize a connection over a web socket that speaks the LSP
+     */
+    connect(socket: WebSocket): void;
+    /**
+     * Get send request to the server to get completion results
+     * from a completion item
+     */
+    getCompletionResolve(completionItem: lsp.CompletionItem): Promise<lsp.CompletionItem | undefined>;
+    /**
+     * List of documents waiting to be opened once the connection
+     * is ready.
+     */
+    protected documentsToOpen: IDocumentInfo[];
+    /**
+     * Generate the notification handlers
+     */
+    protected constructNotificationHandlers<T extends ServerNotifications | ClientNotifications>(methods: typeof Method.ServerNotification | typeof Method.ClientNotification): T;
+    /**
+     * Generate the client request handler
+     */
+    protected constructClientRequestHandler<T extends ClientRequests, U extends keyof T = keyof T>(methods: typeof Method.ClientRequest): T;
+    /**
+     * Generate the server response handler
+     */
+    protected constructServerRequestHandler<T extends ServerRequests, U extends keyof T = keyof T>(methods: typeof Method.ServerRequest): T;
+    /**
+     * Initialization parameters to be sent to the language server.
+     * Subclasses can overload this when adding more features.
+     */
+    protected initializeParams(): lsp.InitializeParams;
+    /**
+     * Callback called when the server is initialized.
+     */
+    protected onServerInitialized(params: lsp.InitializeResult): void;
+    /**
+     * Once the server is initialized, this method generates the
+     * client and server handlers
+     */
+    protected afterInitialized(): void;
+    /**
+     * Is the connection is closed manually?
+     */
+    protected _closingManually: boolean;
+    protected _options: ILSPOptions;
+    protected _closeSignal: Emitter<boolean>;
+    protected _errorSignal: Emitter<any>;
+    protected _serverInitialized: Emitter<lsp.ServerCapabilities<any>>;
+    /**
+     * Send the document changed data to the server.
+     */
+    protected _sendChange(changeEvents: lsp.TextDocumentContentChangeEvent[], documentInfo: IDocumentInfo): void;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/es/connection.d.ts.map

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