LanguageIndex.h

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
 
#include <cstddef>
#include <cstdint>
#include <memory>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace eve::dev::lsp {
 
struct Position {
    size_t line      = 0;
    size_t character = 0;
};
 
struct Range {
    Position start;
    Position end;
};
 
struct Location {
    std::string uri;
    Range       range;
};
 
struct TextEdit {
    Location    location;
    std::string newText;
};
 
namespace SemanticTypes {
constexpr uint32_t Namespace = 0;
constexpr uint32_t Class     = 1;
constexpr uint32_t Function  = 2;
constexpr uint32_t Method    = 3;
constexpr uint32_t Variable  = 4;
constexpr uint32_t Parameter = 5;
constexpr uint32_t Property  = 6;
constexpr uint32_t Keyword   = 7;
}  // namespace SemanticTypes
 
namespace SemanticMods {
constexpr uint32_t Declaration    = 1u << 0;
constexpr uint32_t Readonly       = 1u << 1;
constexpr uint32_t DefaultLibrary = 1u << 2;
}  // namespace SemanticMods
 
struct SemanticToken {
    Position    start;
    size_t      length     = 0;
    uint32_t    type       = SemanticTypes::Variable;
    uint32_t    modifiers  = 0;
    std::string name;
};
 
class EVENGINE_API_FOUNDATION WorkspaceIndex {
public:
    WorkspaceIndex();
    ~WorkspaceIndex();
    WorkspaceIndex(const WorkspaceIndex&)            = delete;
    WorkspaceIndex& operator=(const WorkspaceIndex&) = delete;
 
    void update(std::string canonicalUri, std::string clientUri, std::string source);
    void remove(std::string_view canonicalUri);
    std::optional<Location> definition(std::string_view canonicalUri, Position position) const;
    std::vector<Location> references(std::string_view canonicalUri, Position position, bool includeDeclaration) const;
    std::optional<std::vector<TextEdit>> rename(std::string_view canonicalUri, Position position,
                                                std::string_view newName) const;
    std::vector<SemanticToken> semanticTokens(std::string_view canonicalUri) const;
 
private:
    struct Unit;
    struct Target;
    struct Impl;
 
    const Unit*             unit(std::string_view canonicalUri) const;
    std::optional<Target>   targetAt(const Unit& unit, Position position) const;
    std::optional<Location> targetDefinition(const Target& target) const;
    std::vector<Location>   targetReferences(const Target& target, bool includeDeclaration) const;
    std::unique_ptr<Impl>   impl_;
};
 
}  // namespace eve::dev::lsp