add: completion of lua symbol references

Author: carsakiller

script/core/completion/completion.lua

@@ -1546,7 +1546,7 @@ local function tryWord(state, position, triggerCharacter, results)
                     local env = guide.getENV(state.ast, startPos)
                     if env then
                         checkGlobal(state, word, startPos, position, env, false, results)
-                        checkModule(state, word, startPos, results) 
+                        checkModule(state, word, startPos, results)
                     end
                 end
             end
@@ -2256,16 +2256,43 @@ local function tryluaDocOfFunction(doc, results, pad)
     }
 end
 
+---@async
+local function appendSymbolResults(symbol, results)
+    for _, match in ipairs(wssymbol(symbol)) do
+        results[#results+1] = {
+            label = match.name,
+            kind = define.CompletionItemKind.Class,
+            insertText = match.name
+        }
+    end
+end
+
 ---@async
 local function tryLuaDoc(state, position, results)
     local doc = getLuaDoc(state, position)
     if not doc then
         return
     end
+
+    -- Used for matching referenced symbols e.g. [mySymbol](lua://mySymbol)
+    local SYMBOL_REF_PATTERN = "%]%(lua://([^)]*)()"
+    -- Every symbol reference starts with the start of a comment `--` and then `](lua://`
+    local SYMBOL_REF_COL_OFFSET = #"--](lua://"
+
     if doc.type == 'doc.comment' then
+        ---@type string
         local line = doc.originalComment.text
-        -- 尝试 '---$' or '--- $'
-        if line == '-' or line == '- ' then
+        ---@type integer
+        local offsetCol = select(2, guide.rowColOf(position)) - SYMBOL_REF_COL_OFFSET
+        ---@type string, integer
+        local symbol, endCol = string.match(line, SYMBOL_REF_PATTERN, offsetCol)
+
+        if symbol and offsetCol <= endCol then
+            -- Contains ](lua://...
+            appendSymbolResults(symbol, results)
+            return
+        elseif line == '-' or line == '- ' then
+            -- 尝试 '---$' or '--- $'
             tryluaDocOfFunction(doc, results, line == '- ')
             return
         end