Breaking Changes

[L3MON4D3]

Watch this issue to be notified of any breaking changes.

thanks to @clason for recommending this

[L3MON4D3]

23.07.2021

09716b1

Changed default for wordTrig to true. If you have any snippets that rely on the default being false, wordTrig must now be explicitly set to false, eg.

s({trig = "trigger anywhere"}, {...})

or

s("trigger anywhere", {...})

to

s({trig = "trigger anywhere", wordTrig=false}, {...})

[L3MON4D3]

24.07.2021

e9f4d03

Move pseudo-nodes (rep and partial) from luasnip.util.functions to luasnip.extras.

These functions are probably imported once:

local r = require("luasnip.util.functions").rep
local p = require("luasnip.util.functions").partial

Those lines must be changed to

local r = require("luasnip.extras").rep
local p = require("luasnip.extras").partial

[L3MON4D3]

02.08.2021

eb4680f

Pass function/dynamicNodes their arg-text without snippet-indent, prepend snippet-indent to returned text.

Should affect very few setups, if a functionNode relies on the previous behaviour, they can now be simplified.

[L3MON4D3]

26.08.2021

f2d90d4

This commit changes the third and subsequent arguments to s(...) from s(context, nodes, condition: function, ...) to s(context, nodes, opts: table), meaning no more user-arguments for the condition-function (via s(...) at least).
The condition-function can now be set via opts.condition. As for passing arguments to condition, that is now only possible using partial functions:

-- Checks whether the same number of c1 and c2 occur on the current line.
-- The implementation is omitted as it is irrelevant in this context.
local function char_count_nequal(c1, c2) ... end

-- only expand if a closing ) is missing:
s("(", {t"(", i(1), t")"}, char_count_nequal, "(", ")")

would now be

-- Checks whether the same number of c1 and c2 occur on the current line.
-- The implementation is omitted as it is irrelevant in this context.
local function char_count_nequal(c1, c2) ... end

local function partial(func, ...)
	local args = {...}
	return function() return func(unpack(args))
end

-- only expand if a closing ) is missing:
s("(", {t"(", i(1), t")"}, { condition = partial(char_count_nequal, "(", ")") })

(The user_args for function/dynamicNodes may also be removed in the future)

[L3MON4D3]

## 30.08.2021

d2aa43c

Fixes parsing of {,} in lsp-snippets, only closing brackets have to be escaped, opening ones don't.
In fixing, the parser also got more strict, previously "\\begin{$1}" would've parsed just fine, now the closing } has to be escaped("\begin{$1\}").

Doesn't apply anymore as of 31.08.2021, eg."\begin{}" parses just fine again.

[L3MON4D3]

05.09.2021

8361b35

The functions used in matchNode are no longer only passed the '\n'-joined text from the node. Instead, they now get the same object as the function passed to functionNode ie. {{line1, line2}, snip}.

Changing

function(text)
	-- do something with text.
end

to

function(args)
	local text = table.concat(args[1], "\n")
	-- do the same thing with text.
end

should do the trick.

[L3MON4D3]

21.09.2021

cb4fe49

Changes the signature of the function passed to function/dynamicNodes from

-- snippet inside the table of argnodes' text.
function({argnode_text, snip}, ...) end

to

function(argnode_text, snip, ...) end

(eg. the snippet can no longer be accessed as argnode_text[#argnode_text], but only as a separate argument).

This will likely break many configs, but adjusting the existing functions should be straightforward:

-- also likely: args[#args]
f(function(args) return args[1].env.SELECT_DEDENT end, {})

to

f(function(args, snip) return snip.env.SELECT_DEDENT end, {})

[L3MON4D3]

23.09.2021

257f65b

Changes the meaning of passive in ext_opts, it now only applies while the snippet is active.
To get back the old behaviour, the new snippet_passive-key may be used:

vim.api.nvim_command("hi LuasnipInsertNodePassive cterm=italic")
ls.config.setup({
	ext_opts = {
		[types.choiceNode] = {
			passive = {
				virt_text = {{"●", "GruvboxOrange"}},
			}
		},
	},
})

to

vim.api.nvim_command("hi LuasnipInsertNodeSnippetPassive cterm=italic")
ls.config.setup({
	ext_opts = {
		[types.choiceNode] = {
			snippet_passive = {
				virt_text = {{"●", "GruvboxOrange"}},
			}
		},
	},
})

[L3MON4D3]

29.10.2021

b7d520e

The module luasnip.extras.conditions was moved to luasnip.extras.expand_conditions due to their incompatibility with show_condition.
To transition, it's enough to change

local conditions = require("luasnip.extras.conditions")

to

local conditions = require("luasnip.extras.expand_conditions")

[L3MON4D3]

14.12.2021

dddd655

env is no longer passed to snippetNodes, only the actual snippet contains it. The commit-message contains a short discussion of the change.

Most dynamic/functionNode-functions should keep working, if not, replacing all occurences of

second_arg.env.SOMETHING

with

second_arg.snippet.env.SOMETHING

should do the trick.

[L3MON4D3]

07.03.2022

b8a4480

require("luasnip.loader.from_*").load() will no longer load snippets asynchronously, which means startup might take an additional ~60ms (depending on the number of snippets).

There are two ways to mitigate the effect of this change on your precious startuptime:

• lazy_load the snippets

   require("luasnip.loaders.from_snipmate").lazy_load()
   -- or
   require("luasnip.loaders.from_vscode").lazy_load()

• or, if you need to modify the loaded snippets in any way, do

   vim.schedule(function()
   	-- likewise for `from_snipmate`
   	require("luasnip.loaders.from_vscode").load()
   	-- modify snippets here.
   end)

  Note: do not vim.schedule lazy_load, the snippets are loaded on certainevents and (depending on scheduling) the autocommands for actually loading the snippets might only be registered after the event already fired.

[L3MON4D3]

11.03.2022

48a79b7

The last argument of all nodes is now a table containing optional arguments, which clashes with the user_args of variable length in dynamic/functionNode.
The user_args are now simply accepted in the previously mentioned table:

d(1, some_function, {argnode1, argnode2}, "user_arg1", "user_arg2")

becomes

d(1, some_function, {argnode1, argnode2}, { user_args = {"user_arg1", "user_arg2"}})

[L3MON4D3]

This is not a breaking change, but important nonetheless:
We're planning to move away from exposing the internal structure of snippet-storage (the ls.snippets-table) to setting/getting snippets via functions (details in #338).
If some workflow of yours depends on the current layout/direct access to that table, please leave a comment there so we can find a solution.