local m = require 'lpeglabel' local re = require 'parser.relabel' local lines = require 'parser.lines' local guide = require 'parser.guide' local TokenTypes, TokenStarts, TokenFinishs, TokenContents local Ci, Offset, pushError, Ct, NextComment local parseType local Parser = re.compile([[ Main <- (Token / Sp)* Sp <- %s+ X16 <- [a-fA-F0-9] Word <- [a-zA-Z0-9_] Token <- Name / String / Symbol Name <- ({} {[a-zA-Z0-9_] [a-zA-Z0-9_.*]*} {}) -> Name String <- ({} StringDef {}) -> String StringDef <- '"' {~(Esc / !'"' .)*~} -> 1 ('"'?) / "'" {~(Esc / !"'" .)*~} -> 1 ("'"?) / ('[' {:eq: '='* :} '[' {(!StringClose .)*} -> 1 (StringClose?)) StringClose <- ']' =eq ']' Esc <- '\' -> '' EChar EChar <- 'a' -> ea / 'b' -> eb / 'f' -> ef / 'n' -> en / 'r' -> er / 't' -> et / 'v' -> ev / '\' / '"' / "'" / %nl / ('z' (%nl / %s)*) -> '' / ('x' {X16 X16}) -> Char16 / ([0-9] [0-9]? [0-9]?) -> Char10 / ('u{' {Word*} '}') -> CharUtf8 Symbol <- ({} { ':' / '|' / ',' / '[]' / '<' / '>' / '(' / ')' / '?' / '...' / '+' } {}) -> Symbol ]], { s = m.S' \t', ea = '\a', eb = '\b', ef = '\f', en = '\n', er = '\r', et = '\t', ev = '\v', Char10 = function (char) char = tonumber(char) if not char or char < 0 or char > 255 then return '' end return string.char(char) end, Char16 = function (char) return string.char(tonumber(char, 16)) end, CharUtf8 = function (char) if #char == 0 then return '' end local v = tonumber(char, 16) if not v then return '' end if v >= 0 and v <= 0x10FFFF then return utf8.char(v) end return '' end, Name = function (start, content, finish) Ci = Ci + 1 TokenTypes[Ci] = 'name' TokenStarts[Ci] = start TokenFinishs[Ci] = finish - 1 TokenContents[Ci] = content end, String = function (start, content, finish) Ci = Ci + 1 TokenTypes[Ci] = 'string' TokenStarts[Ci] = start TokenFinishs[Ci] = finish - 1 TokenContents[Ci] = content end, Symbol = function (start, content, finish) Ci = Ci + 1 TokenTypes[Ci] = 'symbol' TokenStarts[Ci] = start TokenFinishs[Ci] = finish - 1 TokenContents[Ci] = content end, }) local function trim(str) return str:match '^%s*(%S+)%s*$' end local function parseTokens(text, offset) Ct = offset Ci = 0 Offset = offset TokenTypes = {} TokenStarts = {} TokenFinishs = {} TokenContents = {} Parser:match(text) Ci = 0 end local function peekToken() return TokenTypes[Ci+1], TokenContents[Ci+1] end local function nextToken() Ci = Ci + 1 if not TokenTypes[Ci] then Ci = Ci - 1 return nil end return TokenTypes[Ci], TokenContents[Ci] end local function checkToken(tp, content, offset) offset = offset or 0 return TokenTypes[Ci + offset] == tp and TokenContents[Ci + offset] == content end local function getStart() if Ci == 0 then return Offset end return TokenStarts[Ci] + Offset end local function getFinish() if Ci == 0 then return Offset end return TokenFinishs[Ci] + Offset end local function try(callback) local savePoint = Ci -- rollback local suc = callback() if not suc then Ci = savePoint end return suc end local function parseName(tp, parent) local nameTp, nameText = peekToken() if nameTp ~= 'name' then return nil end nextToken() local class = { type = tp, start = getStart(), finish = getFinish(), parent = parent, [1] = nameText, } return class end local function parseClass(parent) local result = { type = 'doc.class', parent = parent, } result.class = parseName('doc.class.name', result) if not result.class then pushError { type = 'LUADOC_MISS_CLASS_NAME', start = getFinish(), finish = getFinish(), } return nil end result.start = getStart() result.finish = getFinish() if not peekToken() then return result end nextToken() if not checkToken('symbol', ':') then pushError { type = 'LUADOC_MISS_EXTENDS_SYMBOL', start = result.finish + 1, finish = getStart() - 1, } return result end result.extends = parseName('doc.extends.name', result) if not result.extends then pushError { type = 'LUADOC_MISS_CLASS_EXTENDS_NAME', start = getFinish(), finish = getFinish(), } return result end result.finish = getFinish() return result end local function nextSymbolOrError(symbol) if checkToken('symbol', symbol, 1) then nextToken() return true end pushError { type = 'LUADOC_MISS_SYMBOL', start = getFinish(), finish = getFinish(), info = { symbol = symbol, } } return false end local function parseTypeUnitArray(node) if not checkToken('symbol', '[]', 1) then return nil end nextToken() local result = { type = 'doc.type.array', start = node.start, finish = getFinish(), node = node, } return result end local function parseTypeUnitGeneric(node) if not checkToken('symbol', '<', 1) then return nil end if not nextSymbolOrError('<') then return nil end local key = parseType(node) if not key or not nextSymbolOrError(',') then return nil end local value = parseType(node) if not value then return nil end nextSymbolOrError('>') local result = { type = 'doc.type.generic', start = node.start, finish = getFinish(), node = node, key = key, value = value, } return result end local function parseTypeUnitFunction() local typeUnit = { type = 'doc.type.function', start = getStart(), args = {}, returns = {}, } if not nextSymbolOrError('(') then return nil end while true do if checkToken('symbol', ')', 1) then nextToken() break end local arg = { type = 'doc.type.arg', parent = typeUnit, } arg.name = parseName('doc.type.name', arg) if not arg.name then pushError { type = 'LUADOC_MISS_ARG_NAME', start = getFinish(), finish = getFinish(), } break end if not arg.start then arg.start = arg.name.start end if checkToken('symbol', '?', 1) then nextToken() arg.optional = true end arg.finish = getFinish() if not nextSymbolOrError(':') then break end arg.extends = parseType(arg) if not arg.extends then break end arg.finish = getFinish() typeUnit.args[#typeUnit.args+1] = arg if checkToken('symbol', ',', 1) then nextToken() else nextSymbolOrError(')') break end end if checkToken('symbol', ':', 1) then nextToken() while true do local rtn = parseType(typeUnit) if not rtn then break end if checkToken('symbol', '?', 1) then nextToken() rtn.optional = true end typeUnit.returns[#typeUnit.returns+1] = rtn if checkToken('symbol', ',', 1) then nextToken() else break end end end typeUnit.finish = getFinish() return typeUnit end local function parseTypeUnit(parent, content) local result if content == 'fun' then result = parseTypeUnitFunction() end if not result then result = { type = 'doc.type.name', start = getStart(), finish = getFinish(), [1] = content, } end if not result then return nil end result.parent = parent while true do local newResult = parseTypeUnitArray(result) or parseTypeUnitGeneric(result) if not newResult then break end result = newResult end return result end local function parseResume() local result = { type = 'doc.resume' } if checkToken('symbol', '>', 1) then nextToken() result.default = true end if checkToken('symbol', '+', 1) then nextToken() result.additional = true end local tp = peekToken() if tp ~= 'string' then pushError { type = 'LUADOC_MISS_STRING', start = getFinish(), finish = getFinish(), } return nil end local _, str = nextToken() result[1] = str result.start = getStart() result.finish = getFinish() return result end function parseType(parent) local result = { type = 'doc.type', parent = parent, types = {}, enums = {}, resumes = {}, } result.start = getStart() while true do local tp, content = peekToken() if not tp then break end if tp == 'name' then nextToken() local typeUnit = parseTypeUnit(result, content) if not typeUnit then break end result.types[#result.types+1] = typeUnit if not result.start then result.start = typeUnit.start end elseif tp == 'string' then nextToken() local typeEnum = { type = 'doc.type.enum', start = getStart(), finish = getFinish(), parent = result, [1] = content, } result.enums[#result.enums+1] = typeEnum if not result.start then result.start = typeEnum.start end elseif tp == 'symbol' and content == '...' then nextToken() local vararg = { type = 'doc.type.name', start = getStart(), finish = getFinish(), parent = result, [1] = content, } result.types[#result.types+1] = vararg if not result.start then result.start = vararg.start end end if not checkToken('symbol', '|', 1) then break end nextToken() end result.finish = getFinish() while true do local nextComm = NextComment('peek') if nextComm and nextComm.text:sub(1, 2) == '-|' then NextComment() local finishPos = nextComm.text:find('#', 3) or #nextComm.text parseTokens(nextComm.text:sub(3, finishPos), nextComm.start + 1) local resume = parseResume() if resume then resume.comment = nextComm.text:match('#%s*(.+)', 3) result.resumes[#result.resumes+1] = resume result.finish = resume.finish end else break end end if #result.types == 0 and #result.enums == 0 and #result.resumes == 0 then pushError { type = 'LUADOC_MISS_TYPE_NAME', start = getFinish(), finish = getFinish(), } return nil end return result end local function parseAlias() local result = { type = 'doc.alias', } result.alias = parseName('doc.alias.name', result) if not result.alias then pushError { type = 'LUADOC_MISS_ALIAS_NAME', start = getFinish(), finish = getFinish(), } return nil end result.start = getStart() result.extends = parseType(result) if not result.extends then pushError { type = 'LUADOC_MISS_ALIAS_EXTENDS', start = getFinish(), finish = getFinish(), } return nil end result.finish = getFinish() return result end local function parseParam() local result = { type = 'doc.param', } result.param = parseName('doc.param.name', result) if not result.param then pushError { type = 'LUADOC_MISS_PARAM_NAME', start = getFinish(), finish = getFinish(), } return nil end if checkToken('symbol', '?', 1) then nextToken() result.optional = true end result.start = result.param.start result.finish = getFinish() result.extends = parseType(result) if not result.extends then pushError { type = 'LUADOC_MISS_PARAM_EXTENDS', start = getFinish(), finish = getFinish(), } return result end result.finish = getFinish() return result end local function parseReturn() local result = { type = 'doc.return', returns = {}, } while true do local docType = parseType(result) if not docType then break end if not result.start then result.start = docType.start end if checkToken('symbol', '?', 1) then nextToken() docType.optional = true end docType.name = parseName('doc.return.name', docType) result.returns[#result.returns+1] = docType if not checkToken('symbol', ',', 1) then break end nextToken() end if #result.returns == 0 then return nil end result.finish = getFinish() return result end local function parseField() local result = { type = 'doc.field', } try(function () local tp, value = nextToken() if tp == 'name' then if value == 'public' or value == 'protected' or value == 'private' then result.visible = value result.start = getStart() return true end end return false end) result.field = parseName('doc.field.name', result) if not result.field then pushError { type = 'LUADOC_MISS_FIELD_NAME', start = getFinish(), finish = getFinish(), } return nil end if not result.start then result.start = result.field.start end result.extends = parseType(result) if not result.extends then pushError { type = 'LUADOC_MISS_FIELD_EXTENDS', start = getFinish(), finish = getFinish(), } return nil end result.finish = getFinish() return result end local function parseGeneric() local result = { type = 'doc.generic', generics = {}, } while true do local object = { type = 'doc.generic.object', parent = result, } object.generic = parseName('doc.generic.name', object) if not object.generic then pushError { type = 'LUADOC_MISS_GENERIC_NAME', start = getFinish(), finish = getFinish(), } return nil end object.start = object.generic.start if not result.start then result.start = object.start end if checkToken('symbol', ':', 1) then nextToken() object.extends = parseType(object) end object.finish = getFinish() result.generics[#result.generics+1] = object if not checkToken('symbol', ',', 1) then break end nextToken() end result.finish = getFinish() return result end local function parseVararg() local result = { type = 'doc.vararg', } result.vararg = parseType(result) if not result.vararg then pushError { type = 'LUADOC_MISS_VARARG_TYPE', start = getFinish(), finish = getFinish(), } return end result.start = result.vararg.start result.finish = result.vararg.finish return result end local function parseOverload() local tp, name = peekToken() if tp ~= 'name' or name ~= 'fun' then pushError { type = 'LUADOC_MISS_FUN_AFTER_OVERLOAD', start = getFinish(), finish = getFinish(), } return nil end nextToken() local result = { type = 'doc.overload', } result.overload = parseTypeUnitFunction() if not result.overload then return nil end result.overload.parent = result result.start = result.overload.start result.finish = result.overload.finish return result end local function parseDeprecated() return { type = 'doc.deprecated', start = getFinish(), finish = getFinish(), } end local function parseMeta() return { type = 'doc.meta', start = getFinish(), finish = getFinish(), } end local function parseVersion() local result = { type = 'doc.version', versions = {}, } while true do local tp, text = nextToken() if not tp then pushError { type = 'LUADOC_MISS_VERSION', start = getStart(), finish = getFinish(), } break end if not result.start then result.start = getStart() end local version = { type = 'doc.version.unit', start = getStart(), } if tp == 'symbol' then if text == '>' then version.ge = true elseif text == '<' then version.le = true end tp, text = nextToken() end if tp ~= 'name' then pushError { type = 'LUADOC_MISS_VERSION', start = getStart(), finish = getFinish(), } break end version.version = tonumber(text) or text version.finish = getFinish() result.versions[#result.versions+1] = version if not checkToken('symbol', ',', 1) then break end nextToken() end if #result.versions == 0 then return nil end result.finish = getFinish() return result end local function convertTokens() local tp, text = nextToken() if not tp then return end if tp ~= 'name' then pushError { type = 'LUADOC_MISS_CATE_NAME', start = getStart(), finish = getFinish(), } return nil end if text == 'class' then return parseClass() elseif text == 'type' then return parseType() elseif text == 'alias' then return parseAlias() elseif text == 'param' then return parseParam() elseif text == 'return' then return parseReturn() elseif text == 'field' then return parseField() elseif text == 'generic' then return parseGeneric() elseif text == 'vararg' then return parseVararg() elseif text == 'overload' then return parseOverload() elseif text == 'deprecated' then return parseDeprecated() elseif text == 'meta' then return parseMeta() elseif text == 'version' then return parseVersion() end end local function buildLuaDoc(comment) local text = comment.text if text:sub(1, 1) ~= '-' then return end local _, startPos = text:find('%s*@', 2) if not startPos then return { type = 'doc.comment', start = comment.start, finish = comment.finish, comment = comment, } end local finishPos = text:find('@', startPos + 1) local doc, lastComment if finishPos then doc = text:sub(startPos + 1, finishPos - 1) lastComment = text:sub(finishPos) else doc = text:sub(startPos + 1) end parseTokens(doc, comment.start + startPos - 1) local result = convertTokens() if result then result.comment = lastComment end return result end local function isNextLine(lns, binded, doc) if not binded then return false end local lastDoc = binded[#binded] local lastRow = guide.positionOf(lns, lastDoc.finish) local newRow = guide.positionOf(lns, doc.start) return newRow - lastRow == 1 end local function bindGeneric(binded) local generics = {} for _, doc in ipairs(binded) do if doc.type == 'doc.generic' then for _, obj in ipairs(doc.generics) do local name = obj.generic[1] generics[name] = {} end elseif doc.type == 'doc.param' or doc.type == 'doc.return' then guide.eachSourceType(doc, 'doc.type.name', function (src) local name = src[1] if generics[name] then generics[name][#generics[name]+1] = src src.typeGeneric = generics end end) end end end local function bindDoc(state, lns, binded) if not binded then return end local lastDoc = binded[#binded] if not lastDoc then return end local bindSources = {} for _, doc in ipairs(binded) do doc.bindGroup = binded doc.bindSources = bindSources end bindGeneric(binded) local row = guide.positionOf(lns, lastDoc.finish) local start, finish = guide.lineRange(lns, row + 1) if start >= finish then -- 空行 return end guide.eachSourceBetween(state.ast, start, finish, function (src) if src.start and src.start < start then return end if src.type == 'local' or src.type == 'setlocal' or src.type == 'setglobal' or src.type == 'setfield' or src.type == 'setmethod' or src.type == 'setindex' or src.type == 'tablefield' or src.type == 'tableindex' or src.type == 'function' or src.type == '...' then src.bindDocs = binded bindSources[#bindSources+1] = src end end) end local function bindDocs(state) local lns = lines(nil, state.lua) local binded for _, doc in ipairs(state.ast.docs) do if not isNextLine(lns, binded, doc) then bindDoc(state, lns, binded) binded = {} state.ast.docs.groups[#state.ast.docs.groups+1] = binded end binded[#binded+1] = doc end bindDoc(state, lns, binded) end return function (_, state) local ast = state.ast local comments = state.comms table.sort(comments, function (a, b) return a.start < b.start end) ast.docs = { type = 'doc', parent = ast, groups = {}, } pushError = state.pushError local ci = 1 NextComment = function (peek) local comment = comments[ci] if not peek then ci = ci + 1 end return comment end while true do local comment = NextComment() if not comment then break end local doc = buildLuaDoc(comment) if doc then ast.docs[#ast.docs+1] = doc doc.parent = ast.docs if ast.start > doc.start then ast.start = doc.start end if ast.finish < doc.finish then ast.finish = doc.finish end end end if #ast.docs == 0 then return end bindDocs(state) end