What's the timing of sending textDocument/publishDiagnostics from langium to monaco editor?

[durianwaffle]

I noticed that everytime when user typed something, there will be a textDocument/publishDiagnostics message from langium to monaco editor. I am wondering are all the textDocument/publishDiagnostics message from DocumentValidator(which is for the final phase of validation)? Or there are other phases will also send textDocument/publishDiagnostics for example during lexing/parsing/linking before the customized validation checking?
What's the timing to send textDocument/publishDiagnostic for language server to Monaco editor?

[msujew]

Hey @durianwaffle,

Langium will only publish/update the diagnostics once, when the Validated document state has been reached. Otherwise, users will experience a flickering of diagnostics as the publishDiagnostice notification replaces all existing diagnostics on the language client for the given document.

langium/packages/langium/src/lsp/language-server.ts

Lines 336 to 343 in fa8371b

	documentBuilder.onDocumentPhase(DocumentState.Validated, async (document) => {
	if (document.diagnostics) {
	connection.sendDiagnostics({
	uri: document.uri.toString(),
	diagnostics: document.diagnostics
	});
	}
	});