There is another pull request where NewCursor is exposed but it is not merged. I do not usually use multiple cursors so I do not know what resolution would be good, but there is a comment where other things that may be done are written: #2941 (comment)

@niten94
Yeah, I just noticed it, thanks.

@dmaluka

Still, what about my question #2920 (comment)?

I.e. isn't NewCursor() too low-level a detail to be exposed to plugins? Perhaps the needed functionality can be already achieved from Lua with existing BufPane methods like SpawnMultiCursor()?

SpawnMultiCursor() hardcodes multi cursor to be the selected word and there's no way to customize it. I don't see how it can be used by plugin to insert cursors in custom places (or other use cases). And other multi-cursor functions deselect existing selections.

Or if those methods are not quite suitable since they do "too much", perhaps we should just add a new simple method to BufPane or to Buffer, which would, roughly speaking, just do NewCursor() + AddCursor() + MergeCursors() and nothing else?

I personally think it doesn't hurt to expose a function that creates a Cursor struct, which can be used in many other places, other scenarios that we might not foresee. And the plugin developer can already look at how NewCursor() is used in the source code which is pretty clear on how it is "meant" to used I think.

That being said, I don't mind having a dedicated function just to allow plugins to add a cursor to the buffer if you want it.

I personally think it doesn't hurt to expose a function that creates a Cursor struct, which can be used in many other places, other scenarios that we might not foresee. And the plugin developer can already look at how NewCursor() is used in the source code which is pretty clear on how it is "meant" to used I think.

So if later for some reason we want to change the way how it is done in the source code, we cannot just do that, since there are already plugins that already do the same, so we would need to update those plugins as well.

Things are already quite messy due to the fact that micro's plugin system doesn't clearly define which APIs are supposed to be used by plugins (and thus are expected to preserve backward compatibility, etc) and which are only supposed to be used internally by micro. So let's not make it even messier.

@dmaluka
Yeah fair enough, I get what you mean.
I added a function that adds a cursor to a buffer and reverted the previous changes.