1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
local findResult = require 'matcher.find_result'
local findLib = require 'matcher.find_lib'
local function buildArgs(lib)
if not lib.args then
return ''
end
local strs = {}
for i, arg in ipairs(lib.args) do
if arg.optional then
if i > 1 then
strs[#strs+1] = ' ['
else
strs[#strs+1] = '['
end
end
if i > 1 then
strs[#strs+1] = ', '
end
if arg.name then
strs[#strs+1] = ('%s:'):format(arg.name)
end
strs[#strs+1] = arg.type or 'any'
if arg.default then
strs[#strs+1] = ('(%q)'):format(arg.default)
end
if arg.optional == 'self' then
strs[#strs+1] = ']'
end
end
for _, arg in ipairs(lib.args) do
if arg.optional == 'after' then
strs[#strs+1] = ']'
end
end
return table.concat(strs)
end
local function buildReturns(lib)
if not lib.returns then
return ''
end
local strs = {}
for i, rtn in ipairs(lib.returns) do
if rtn.optional then
if i > 1 then
strs[#strs+1] = ' ['
else
strs[#strs+1] = '['
end
end
if i > 1 then
strs[#strs+1] = ', '
end
if rtn.name then
strs[#strs+1] = ('%s:'):format(rtn.name)
end
strs[#strs+1] = rtn.type or 'any'
if rtn.default then
strs[#strs+1] = ('(%q)'):format(rtn.default)
end
if rtn.optional == 'self' then
strs[#strs+1] = ']'
end
end
for _, rtn in ipairs(lib.returns) do
if rtn.optional == 'after' then
strs[#strs+1] = ']'
end
end
return '\n -> ' .. table.concat(strs)
end
local function buildEnum(lib)
if not lib.enums then
return ''
end
local container = table.container()
for _, enum in ipairs(lib.enums) do
if not enum.name or not enum.enum then
goto NEXT_ENUM
end
if not container[enum.name] then
container[enum.name] = {}
if lib.args then
for _, arg in ipairs(lib.args) do
if arg.name == enum.name then
container[enum.name].type = arg.type
break
end
end
end
end
table.insert(container[enum.name], enum)
::NEXT_ENUM::
end
local strs = {}
for name, enums in pairs(container) do
strs[#strs+1] = ('\n%s:%s'):format(name, enums.type or '')
for _, enum in ipairs(enums) do
if enum.default then
strs[#strs+1] = '\n -> '
else
strs[#strs+1] = '\n | '
end
strs[#strs+1] = ('%q -- %s'):format(enum.enum, enum.description or '')
end
end
return table.concat(strs)
end
local function buildFunctionHover(lib, name)
local title = ('function %s(%s)%s'):format(name, buildArgs(lib), buildReturns(lib))
local enum = buildEnum(lib)
local tip = lib.description or ''
return ([[
```lua
%s
```
%s
```lua
%s
```
]]):format(title, tip, enum)
end
local function buildField(lib)
if not lib.fields then
return ''
end
local strs = {}
for _, field in ipairs(lib.fields) do
strs[#strs+1] = ('\n%s:%s -- %s'):format(field.field, field.type, field.description or '')
end
return table.concat(strs)
end
local function buildTableHover(lib, name)
local title = ('table %s'):format(name)
local field = buildField(lib)
local tip = lib.description or ''
return ([[
```lua
%s
```
%s
```lua
%s
```
]]):format(title, tip, field)
end
return function (results, pos)
local result = findResult(results, pos)
if not result then
return nil
end
if result.type ~= 'var' then
return nil
end
local var = result.var
local lib, name = findLib(var)
if not lib then
return nil
end
if lib.type == 'function' then
return buildFunctionHover(lib, name)
elseif lib.type == 'table' then
return buildTableHover(lib, name)
elseif lib.type == 'string' then
return lib.description
end
end
|
