textEdit and completion filtering

[kristijanhusak]

Hi,

I noticed that each completion item has a textEdit, even when there are no differences in the label and inserted text.

That wouldn't be an issue, but it seems that the completion filtering depends on this information. In https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#textDocument_completion, there is this section

Completion item provides an insertText / label without a text edit: in the model the client should filter against what the user has already typed using the word boundary rules of the language (e.g. resolving the word under the cursor position). The reason for this mode is that it makes it extremely easy for a server to implement a basic completion list and get it filtered on the client.

Completion Item with text edits: in this mode the server tells the client that it actually knows what it is doing. If you create a completion item with a text edit at the current cursor position no word guessing takes place and no automatic filtering (like with an insertText) should happen. This mode can be combined with a sort text and filter text to customize two things. If the text edit is a replace edit then the range denotes the word used for filtering. If the replace changes the text it most likely makes sense to specify a filter text to be used

By the specification, the completion item should already be pre-filtered if it has a textEdit, which is not the case at the moment. I tested with typescript-language-server and it seems it does not have textEdit on the completion items.

[yioneko]

See https://github.com/microsoft/language-server-protocol/issues/2042. From what I understand, the clarification means that the automatic filtering here refers to the client default filtering behavior based on language-specific word boundary and insertText or label field in completion item.

If the text edit is a replace edit then the range denotes the word used for filtering. If the replace changes the text it most likely makes sense to specify a filter text to be used

But when a replacement text edit is provided, the client should change the default word boundary to the replacement range and use the filterText for item filtering. To be honest, I'm still quite confused by the improved clarification in spec, but this seems the most reasonable interpretation to me and please correct me if you think I'm wrong.

[kristijanhusak]

It is indeed confusing. If you check the comments on that issue, you can see that everyone understands it differently. I noticed this issue after setting up https://github.com/neovim/neovim/pull/30945 and discussing with a Neovim maintainer.

I also think that automatic filtering refers to client side filtering, but the 2nd paragraph clearly states that the automatic filtering is not needed when there is a text edit:

Completion Item with text edits: in this mode the server tells the client that it actually knows what it is doing. If you create a completion item with a text edit at the current cursor position no word guessing takes place and no automatic filtering (like with an insertText) should happen.

For the part that you quoted:

If the text edit is a replace edit then the range denotes the word used for filtering. If the replace changes the text it most likely makes sense to specify a filter text to be used.

I think first sentence provides information how to extract what was used for filtering on the server, in case the client needs it, and 2nd sentence states that if textEdit is a ReplaceText action, the server should provide a filterText for filtering.

I think the general agreement is that filterText has precedence over all of this, so if we would have filterText here, I think we would be ok.

Besides the typescript-language-server I also tested Lua LSP, and it also does not provide textEdit. Should've probably test a few more LSPs, but I'm not sure if that information can be used as a decider here.

Edit: Tested few more LSPs:

1. gopls - Provides both filterText and textEdit
2. intelephense - also provides both filterText and textEdit
3. vimls - Doesn't have either filterText or textEdit