local files = require 'files' local guide = require 'parser.guide' ---@type vm local vm = require 'vm.vm' local config = require 'config' local collector = require 'core.collector' local define = require 'proto.define' local noder = require 'core.noder' ---获取class与alias ---@param name? string ---@return parser.guide.object[] function vm.getDocDefines(name) local cache = vm.getCache 'getDocDefines' if cache[name] then return cache[name] end local results = {} if name == '*' then for noders in collector.each('def:dn:') do for id in noder.eachID(noders) do if id:sub(1, 3) == 'dn:' and not id:find(noder.SPLIT_CHAR) then for source in noder.eachSource(noders, id) do if guide.isSet(source) then results[#results+1] = source end end end end end else local id = 'dn:' .. name for noders in collector.each('def:' .. id) do for source in noder.eachSource(noders, id) do if source.type == 'doc.class.name' or source.type == 'doc.alias.name' then results[#results+1] = source end end end end cache[name] = results return results end function vm.isDocDefined(name) if define.BuiltinClass[name] then return true end local id = 'def:dn:' .. name if collector.has(id) then return true end return false end function vm.getDocEnums(doc) if not doc then return nil end local defs = vm.getDefs(doc) local results = {} for _, def in ipairs(defs) do if def.type == 'doc.type.enum' or def.type == 'doc.resume' then results[#results+1] = def end end return results end function vm.isMetaFile(uri) local status = files.getState(uri) if not status then return false end local cache = files.getCache(uri) if cache.isMeta ~= nil then return cache.isMeta end cache.isMeta = false if not status.ast.docs then return false end for _, doc in ipairs(status.ast.docs) do if doc.type == 'doc.meta' then cache.isMeta = true return true end end return false end function vm.getValidVersions(doc) if doc.type ~= 'doc.version' then return end if doc._validVersions then return doc._validVersions end local valids = { ['Lua 5.1'] = false, ['Lua 5.2'] = false, ['Lua 5.3'] = false, ['Lua 5.4'] = false, ['LuaJIT'] = false, } for _, version in ipairs(doc.versions) do if version.ge and type(version.version) == 'number' then for ver in pairs(valids) do local verNumber = tonumber(ver:sub(-3)) if verNumber and verNumber >= version.version then valids[ver] = true end end elseif version.le and type(version.version) == 'number' then for ver in pairs(valids) do local verNumber = tonumber(ver:sub(-3)) if verNumber and verNumber <= version.version then valids[ver] = true end end elseif type(version.version) == 'number' then valids[('Lua %.1f'):format(version.version)] = true elseif 'JIT' == version.version then valids['LuaJIT'] = true end end if valids['Lua 5.1'] then valids['LuaJIT'] = true end doc._validVersions = valids return valids end local function isDeprecated(value) if not value.bindDocs then return false end if value._deprecated ~= nil then return value._deprecated end for _, doc in ipairs(value.bindDocs) do if doc.type == 'doc.deprecated' then value._deprecated = true return true elseif doc.type == 'doc.version' then local valids = vm.getValidVersions(doc) if not valids[config.get 'Lua.runtime.version'] then value._deprecated = true return true end end end value._deprecated = false return false end function vm.isDeprecated(value, deep) if deep then local defs = vm.getDefs(value) if #defs == 0 then return false end for _, def in ipairs(defs) do if not isDeprecated(def) then return false end end return true else return isDeprecated(value) end end local function makeDiagRange(uri, doc, results) local lines = files.getLines(uri) local names if doc.names then names = {} for i, nameUnit in ipairs(doc.names) do local name = nameUnit[1] names[name] = true end end local row = guide.positionOf(lines, doc.start) if doc.mode == 'disable-next-line' then if lines[row+1] then results[#results+1] = { mode = 'disable', names = names, offset = lines[row+1].start, source = doc, } results[#results+1] = { mode = 'enable', names = names, offset = lines[row+1].finish, source = doc, } end elseif doc.mode == 'disable-line' then results[#results+1] = { mode = 'disable', names = names, offset = lines[row].start, source = doc, } results[#results+1] = { mode = 'enable', names = names, offset = lines[row].finish, source = doc, } elseif doc.mode == 'disable' then if lines[row+1] then results[#results+1] = { mode = 'disable', names = names, offset = lines[row+1].start, source = doc, } end elseif doc.mode == 'enable' then if lines[row+1] then results[#results+1] = { mode = 'enable', names = names, offset = lines[row+1].start, source = doc, } end end end function vm.isDiagDisabledAt(uri, offset, name) local status = files.getState(uri) if not status then return false end if not status.ast.docs then return false end local cache = files.getCache(uri) if not cache.diagnosticRanges then cache.diagnosticRanges = {} for _, doc in ipairs(status.ast.docs) do if doc.type == 'doc.diagnostic' then makeDiagRange(uri, doc, cache.diagnosticRanges) end end table.sort(cache.diagnosticRanges, function (a, b) return a.offset < b.offset end) end if #cache.diagnosticRanges == 0 then return false end local stack = {} for _, range in ipairs(cache.diagnosticRanges) do if range.offset <= offset then if not range.names or range.names[name] then if range.mode == 'disable' then stack[#stack+1] = range elseif range.mode == 'enable' then stack[#stack] = nil end end else break end end local current = stack[#stack] if not current then return false end return true end