Add when clause context for language at active cursor

I would like a new when clause context for the language ID at the active cursor position within the document. Right now, we have editorLangId which only uses the language ID of the editor itself, but documents can have other languages embedded in them defined in the contributes.grammars.

I’m not sure about the full extent of how the embedded language is used, but I’ve seen it used for some built-in features like language snippets and the built-in commands that toggle language comments. I can also see the language present in the inspector for the command editor.action.inspectTMScopes. Since it’s clearly seen as useful for this built-in functionality and has implementations demonstrating how it can be used, it should also be clear that it would be useful to have access to this in the when clause.

[gjsjohnmurray]

+1 for this feature.

I hope you upvoted the issue above, otherwise your +1 won’t count and will only have been ‘noise’.

[hediet]

The syntax highlighting

But what does syntax highlighting have to do with the requested feature?

keybindings would be available for editing, formatting, and executing the embedded code

I think these keybinding handlers most likely also need to understand the surrounding markdown, at least for formatting and executing the code, so I suggest to have editorLangId == r || editorLangId == markdown (and make the command aware of markdown) instead of some hypothetical editorLangIdAtCursor == r. The only problem here is that you cannot bind multiple language-specific commands to the same key-binding, but I wonder if that really is a problem.

I doubt a handler that triggers when editorLangIdAtCursor == r would be able to work for code that is embedded in completely arbitrary/unexpected documents, as it does not know the semantics of the outer document. For example in this case, a “toggle line comment command” would need to be aware of the outer html:

<script type="r">print("Hello World!")</script>

In that case, the when clause should probably rather be editorLangId == r || (editorLangId == markdown && editorLangIdAtCursor == r).