17#ifndef A11_FLOW_NAVIGATE_H_
18#define A11_FLOW_NAVIGATE_H_
88 CompilationBudget* absl_nullable
budget =
nullptr);
119 std::string_view source,
size_t offset,
122 CompilationBudget* absl_nullable
budget =
nullptr,
123 const LinkedModule* absl_nullable
linked =
nullptr);
135 bool required,
bool unary,
Everything the tools know about the world, in one place.
Definition catalogue.h:91
static const Catalogue & Builtin()
The embedded snapshot: what a standalone tool knows with nothing configured.
Definition catalogue.cc:503
CompilationLimits limits
Definition main.cc:148
LinkedModule linked
Definition lsp.cc:290
CompilationBudget budget
Definition lsp.cc:289
catalogue::Catalogue known
Definition lsp.cc:291
WordRole
The grammar role under which a word is documented.
Definition vocabulary.h:120
Definition catalogue.cc:29
Description Describe(std::string_view source, size_t offset, const catalogue::Catalogue &known, CompilationLimits limits, CompilationBudget *budget, const LinkedModule *linked)
Definition navigate.cc:1217
std::string BuiltinMarkdown(std::string_view name)
A built-in function, the same way.
Definition navigate.cc:902
std::string_view SymbolClassName(SymbolClass kind)
Definition navigate.cc:992
std::vector< DocumentSymbol > Symbols(std::string_view source, CompilationLimits limits, CompilationBudget *budget)
Definition navigate.cc:1055
std::string FlowMarkdown(const FlowPlan &flow)
A flow of the document, written out the same way: what it does, then its ports and which direction ea...
Definition navigate.cc:964
@ kPort
A port of this flow, or of a call.
@ kCall
A bound run/call step.
@ kField
A field of something: a status's code, a node's id.
@ kHeader
A header, under its alias.
@ kNode
A node of the flow's own.
@ kFlow
A flow of this file, offered as a call target.
@ kVariable
A loop variable, the index a loop binds, or what a repeat carries.
@ kBarrier
A bound wait/close.
std::string PortMarkdown(std::string_view name, std::string_view type, bool required, bool unary, std::string_view description)
One port, written out as the Markdown a reader wants beside its name.
Definition navigate.cc:950
std::string WordMarkdown(std::string_view name, vocabulary::WordRole role)
One word or mark of the language, written out as reference: what it does, what it takes,...
Definition navigate.cc:886
std::string ActionMarkdown(const catalogue::ActionInfo &action)
An action, written out as the Markdown a reader wants to see: what it does, then every port it has.
Definition navigate.cc:906
constexpr std::string_view kHoverFormat
The format field of the hover envelope.
Definition navigate.h:170
std::string StageMarkdown(std::string_view name)
A pipeline stage, written out as reference.
Definition navigate.cc:898
constexpr std::string_view kSymbolsFormat
The format field of the symbols envelope.
Definition navigate.h:168
SymbolClass
Moving around a document: what is under the caret, what the file declares, and where a name was bound...
Definition navigate.h:46
@ kExternal
Something the language knows about but the document did not declare: an action, a registered type,...
constexpr std::string_view kDefinitionFormat
The format field of the definition envelope.
Definition navigate.h:172
std::string ShapeMarkdown(const DtoPlan &shape)
A struct, written out the same way: how many fields, then each of them.
Definition navigate.cc:984
std::string shape
Declared shape of stream values, retained through compatible stages.
Definition resolve.cc:814
std::uint32_t offset
Definition runtime_streams.cc:36
Host-controlled bounds shared by parsing, linking and semantic analysis.
Definition limits.h:24
What is at one offset, described.
Definition navigate.h:91
std::optional< catalogue::Origin > origin
Where it was declared, when it was declared in another file and something read that file: an action o...
Definition navigate.h:114
Range definition
Definition navigate.h:108
Range range
What the word covers, so an editor can underline exactly it.
Definition navigate.h:105
std::string text
The word or construct itself, as written.
Definition navigate.h:96
std::string detail
Details such as action ports, shape fields, or stage arguments.
Definition navigate.h:101
std::string summary
One line: what it is. an action, ‘a port of 'search’`.
Definition navigate.h:99
std::string markdown
The same as Markdown, which is what an editor's hover wants.
Definition navigate.h:103
SymbolClass kind
Definition navigate.h:97
bool found
Whether anything is there at all.
Definition navigate.h:94
bool has_definition
Where it was declared, when it was declared in this document.
Definition navigate.h:107
One thing a document declares, and the things declared inside it.
Definition navigate.h:66
std::string name
Definition navigate.h:67
bool port_required
Definition navigate.h:75
std::vector< DocumentSymbol > children
Definition navigate.h:80
SymbolClass kind
Definition navigate.h:68
Range selection
Just the name, for "put the caret here".
Definition navigate.h:79
std::string port_type
Definition navigate.h:73
Range range
The whole construct, for "select this symbol".
Definition navigate.h:77
bool port_stream
Definition navigate.h:74
std::string detail
What an editor shows beside the name: a port's type, a call's action.
Definition navigate.h:70
std::string port_direction
Port metadata, populated only when kind is kPort.
Definition navigate.h:72
Half-open span of source, [start, end).
Definition diagnostic.h:68