what is the difference between VSCodeNotifyRange and VSCodeNotifyRangePos?

[MrOxMasTer]

It's all wonderful of course that you want to switch completely to the Lua API, but such is the problem that I don't understand what the point of these functions are, or rather how they differ

I have some code that I borrowed from another person because I am not very good with neovim / lua and I would like to know the difference between these functions, because I am not that old of this extension and was not from the bottom of the VimScript API, but this piece of deprecated information is not enough for me, and on the Lua API it is not clear at all how they differ:

I would like to understand this API completely to fully understand how the function works.

Specifically, for example, what the last parameter in the VSCodeNotifyRangePos function is responsible for.

[justinmk]

Specifically, for example, what the last parameter in the VSCodeNotifyRangePos function is responsible for

That is the leaveSelection param:

vscode-neovim/runtime/vscode-neovim.vim

Line 121 in 4df0f6e

function! VSCodeNotifyRangePos(cmd, line1, line2, pos1, pos2, leaveSelection, ...)

With the Lua api which replaces that api, that parameter would be passed as restore_selection item in the opts options map:

vscode-neovim/runtime/lua/vscode/api.lua

Lines 98 to 109 in 4df0f6e

	---@param opts? table Optional options table, all fields are optional
	--- - args: (table) Optional arguments for the action
	--- - range: (table) Specific range for the action. In visual mode, this parameter is generally not needed.
	--- Three formats supported (All values are 0-indexed):
	--- - [start_line, end_line]
	--- - [start_line, start_character, end_line, end_character]
	--- - {start = { line = start_line , character = start_character}, end = { line = end_line , character = end_character}}
	--- - restore_selection: (boolean) Whether to preserve the current selection, only valid when `range` is specified. Defaults to `true`
	---@param timeout? number Timeout in milliseconds. The default value is -1, which means no timeout.
	---
	---@return any: result
	function M.call(name, opts, timeout)

So, an example call using the Lua api (just guessing based on your screenshot; please post code instead of screenshots):

require('vscode').call('workbench.action.showCommands', {
  range = {
    start = { line = startPos[1], character = endPos[1] },
    end = { line = startPos[2], character = endPos[2]},
  },
  restore_selection = true,
})