texlab/docs/custom_messages.md

Custom Messages

We extend the Language Server Protocol with custom messages to provide better LaTeX integration. These messages are optional and it is up to the client to support them.

Build Request

The build request is sent from the client to the server to build a given LaTeX document.

Request:

• method: 'textDocument/build'
• params: BuildTextDocumentParams defined as follows:

interface BuildTextDocumentParams {
  /**
   * The text document to build.
   */
  textDocument: TextDocumentIdentifier;
}

Response:

• result: BuildResult defined as follows:

interface BuildResult {
  /**
   * The status of the build process.
   */
  status: BuildStatus;
}

enum BuildStatus {
  /**
   * The build process terminated without any errors.
   */
  Success = 0,

  /**
   * The build process terminated with errors.
   */
  Error = 1,

  /**
   * The build process failed to start or crashed.
   */
  Failure = 2,

  /**
   * The build process was cancelled.
   */
  Cancelled = 3,
}

Forward Search Request

The forward search request is sent from the client to the server when the user requests a forward search via SyncTeX.

Request:

• method: 'textDocument/forwardSearch'
• params: TextDocumentPositionParams

Response:

• result: ForwardSearchResult defined as follows:

interface ForwardSearchResult {
  /**
   * The status of the previewer process.
   */
  status: ForwardSearchStatus;
}

enum ForwardSearchStatus {
  /**
   * The previewer process executed the command without any errors.
   */
  Success = 0,

  /**
   * The previewer process executed the command with errors.
   */
  Error = 1,

  /**
   * The previewer process failed to start or crashed.
   */
  Failure = 2,

  /**
   * The previewer command is not configured.
   */
  Unconfigured = 3,
}