fix: bind variables with @class using tail comments

[tomlau10]

fixes #2673

這個是我上年最初接觸和使用 luals 時遇到的一個問題
當時由於找到繞過方式用 @type，也就解決了

但是最近自某版本起 @type 修正成會檢查該 class 的所有 missing field 而導致報錯。。。

• 要麼用 disable 方式忽略部分報錯
• 要麼改回用 @class

後者好像合理一些
換句話還是得解決最根本的問題：
連續多行用 tail comment 寫 @class 時，無法正確 bind 到 variable

最初由於不了解 luals 代碼庫，所以也沒有深究原因
現在算是稍為熟悉一點了，很快找到 fix 方式了 🙂

[tomlau10]

should be fixed now @C3pa

---

But I just found some edge cases...

• my code just specifically check that if a tail comment @class is followed by another @class, then the 1st one should be binded to the left hand side variable
• however if the next line is not @class, then the binding will be incorrect 🤦‍♂️

in the following example:

local ClassA ---@class A local strVar ---@type string

• the @class A will incorrectly bind to strVar
• but what I expect is to bind with the ClassA variable
• this problem persists without my PR though

---

I am thinking we have to come up with a fix to resolve it once and for all 🤔
I think the root cause is that when checking tail comment, currently it will just skip @class and @field here:

lua-language-server/script/parser/luadoc.lua

Lines 2184 to 2186 in 12013ba

	elseif isTailComment(text, doc) and doc.type ~= "doc.class" and doc.type ~= "doc.field" then
	bindDocWithSources(sources, binded)
	binded = nil

• removing doc.class in this condition fixes both mine and the newly identified issue
• i.e. if @class is inside a tail comment, always bind to the left hand side variable
• but I am not sure if it would cause other side effects (I didn't found any in my 2 projects)

What do you think? 🤔
With the new suggested change, then we don't even need to add the elseif case below.

[tomlau10]

hi @emmericp, sorry to bother you

I'm trying to fix the issue mentioned in #2673, where continuous @class tail comment annotation is not working.
(see examples in the issue)

And after git blaming, I found that it is caused by the change in your PR #2502:
https://github.com/LuaLS/lua-language-server/pull/2502/files#diff-1a85305731532da4bf3f750c6ddc3e48793c76b8544c75d04708f673fcd4b3a8R2008

I'm not sure why @class is excluded if it is in tail comment when processing the bind doc to variable logic 😕
So I don't know if the change in this PR would break your original use case.
Would you mind having a review in this PR?

Thanks

[emmericp]

I'm not sure why @Class is excluded if it is in tail comment when processing the bind doc to variable logic 😕

To be honest: I don't remember the reason behind that logic