protocol

type ClientCapabilities struct{}

type ClientInfo struct {
	// Name is the name of the client.
	Name string `json:"name"`

	// Version is the version of the client (optional).
	Version string `json:"version,omitempty"`
}

type CodeAction struct {
	// Title is a short, human-readable title for the code action.
	Title string `json:"title"`

	// Kind is the kind of the code action, such as "quickfix" or "refactor".
	// Used to filter and organize code actions.
	Kind CodeActionKind `json:"kind,omitempty"`

	// Diagnostics are the diagnostics that this code action resolves.
	Diagnostics []Diagnostic `json:"diagnostics,omitempty"`

	// Edit specifies changes to be made to the workspace when this action is applied.
	// Mutually exclusive with Command.
	Edit *WorkspaceEdit `json:"edit,omitempty"`

	// Command specifies a command to execute after applying the code action.
	// Mutually exclusive with Edit.
	Command *Command `json:"command,omitempty"`

	// Data is custom data the server may use to identify the code action.
	Data interface{} `json:"data,omitempty"`
}

type CodeActionContext struct {
	// Diagnostics contains the diagnostics for the specified range in the document.
	Diagnostics []Diagnostic `json:"diagnostics"`

	// Only is an optional list of code action kinds to return.
	// If specified, the server should only return these kinds.
	Only []CodeActionKind `json:"only,omitempty"`
}

type CodeActionKind string

type CodeActionParams struct {
	// WorkDoneProgressParams are standard parameters for work progress reporting.
	WorkDoneProgressParams

	// PartialResultParams are standard parameters for partial result reporting.
	PartialResultParams

	// TextDocument specifies the text document in which code actions are requested.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Range specifies the range in the document where code actions are requested.
	Range Range `json:"range"`

	// Context provides additional information about the request, such as diagnostics.
	Context CodeActionContext `json:"context"`
}

type CodeActionResult struct {
	Commands    []Command
	CodeActions []CodeAction
}

type CodeDescription struct {
	// Href is a URI pointing to more information about the diagnostic code.
	Href string `json:"href"`
}

type Command struct {
	// Title is a human-readable title for the command, displayed in the UI.
	Title string `json:"title"`

	// Command is the identifier of the actual command to execute.
	Command string `json:"command"`

	// Arguments are additional arguments that the command accepts.
	// These are specific to the command being executed.
	Arguments []interface{} `json:"arguments,omitempty"`
}

type CompletionContext struct {
	// TriggerKind specifies how the completion was triggered.
	TriggerKind CompletionTriggerKind `json:"triggerKind"`

	// TriggerCharacter is the character that triggered the completion, if applicable.
	// This field is only populated if the triggerKind is TriggerCharacter.
	TriggerCharacter *string `json:"triggerCharacter,omitempty"`
}

type CompletionItem struct {
	// Label is the label of this completion item. It will be displayed in the UI.
	Label string `json:"label"`

	// Kind specifies the type of completion item (e.g., Function, Class).
	Kind CompletionItemKind `json:"kind,omitempty"`

	// Tags are optional tags for this item (e.g., Deprecated).
	Tags []CompletionItemTag `json:"tags,omitempty"`

	// Detail provides additional information about this item, like the type or symbol signature.
	Detail string `json:"detail,omitempty"`

	// Documentation contains a human-readable description of the item.
	Documentation *MarkupContent `json:"documentation,omitempty"`

	// Deprecated indicates whether this item is deprecated.
	Deprecated *bool `json:"deprecated,omitempty"`

	// Preselect determines if this item should be preselected in the UI.
	Preselect *bool `json:"preselect,omitempty"`

	// SortText is used to order completion items in the UI.
	SortText string `json:"sortText,omitempty"`

	// FilterText is used to filter items when performing fuzzy matching.
	FilterText string `json:"filterText,omitempty"`

	// InsertText is the string to insert when this item is selected.
	InsertText string `json:"insertText,omitempty"`

	// InsertTextFormat specifies how `InsertText` should be interpreted.
	InsertTextFormat *InsertTextFormat `json:"insertTextFormat,omitempty"`

	// InsertTextMode specifies how whitespace and indentation should be handled during insertion.
	InsertTextMode *InsertTextMode `json:"insertTextMode,omitempty"`

	// TextEdit specifies changes to the document that occur when this item is selected.
	TextEdit *TextEdit `json:"textEdit,omitempty"`

	// AdditionalTextEdits specifies additional edits that are applied after this item is selected.
	AdditionalTextEdits []TextEdit `json:"additionalTextEdits,omitempty"`

	// CommitCharacters is a list of characters that commit the completion item selection.
	CommitCharacters []string `json:"commitCharacters,omitempty"`

	// Command is an optional command that is executed after selecting this item.
	Command *Command `json:"command,omitempty"`

	// Data is a custom data field, which can be used by the server to identify or resolve this item.
	Data interface{} `json:"data,omitempty"`
}

type CompletionItemKind int

type CompletionItemTag int

type CompletionList struct {
	// IsIncomplete indicates if the list is complete.
	// If true, the client should re-trigger completion when typing more characters.
	IsIncomplete bool `json:"isIncomplete"`

	// Items contains the completion items.
	Items []CompletionItem `json:"items"`
}

type CompletionOptions struct {
	// ResolveProvider indicates whether the server provides support to resolve additional information for a completion item.
	ResolveProvider bool `json:"resolveProvider,omitempty"`

	// TriggerCharacters defines the characters that trigger completion.
	TriggerCharacters []string `json:"triggerCharacters,omitempty"`
}

type CompletionParams struct {
	// TextDocument identifies the text document where completion is being requested.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Position specifies the position in the document where completion is requested.
	Position Position `json:"position"`

	// Context provides additional information about the context in which completion is requested.
	Context *CompletionContext `json:"context,omitempty"`

	// WorkDoneProgressParams allows reporting progress for this request.
	WorkDoneProgressParams
}

type CompletionResult struct {
	// CompletionList is populated if the result is a CompletionList.
	CompletionList *CompletionList

	// CompletionItems is populated if the result is a slice of CompletionItem.
	CompletionItems []CompletionItem
}

type CompletionTriggerKind int

type DefinitionParams struct {
	// WorkDoneProgressParams allows the client to request progress updates for the operation.
	WorkDoneProgressParams

	// PartialResultParams allows the server to send partial results for the request.
	PartialResultParams

	// TextDocument specifies the document where the symbol is located.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Position specifies the position within the document where the symbol is located.
	Position Position `json:"position"`
}

type DefinitionResponse struct {
	Location      *Location      // Single Location
	Locations     []Location     // Multiple Locations
	LocationLinks []LocationLink // Multiple LocationLinks
}

type Diagnostic struct {
	// Range specifies the location of the diagnostic within the document.
	Range Range `json:"range"`

	// Severity represents the severity of the diagnostic (e.g., error, warning).
	Severity DiagnosticSeverity `json:"severity,omitempty"`

	// Code is an optional identifier for the diagnostic, which can be a string or number.
	Code interface{} `json:"code,omitempty"`

	// CodeDescription provides an optional URI pointing to more information about the diagnostic code.
	CodeDescription *CodeDescription `json:"codeDescription,omitempty"`

	// Source identifies the origin of this diagnostic (e.g., "typescript").
	Source string `json:"source,omitempty"`

	// Message is the diagnostic message to be displayed.
	Message string `json:"message"`

	// Tags is an optional array of tags for additional metadata.
	Tags []DiagnosticTag `json:"tags,omitempty"`

	// RelatedInformation is an optional array of additional locations related to this diagnostic.
	RelatedInformation []DiagnosticRelatedInformation `json:"relatedInformation,omitempty"`

	// Data provides additional metadata for the diagnostic.
	Data interface{} `json:"data,omitempty"`
}

type DiagnosticOptions struct {
	WorkDoneProgressOptions

	// Identifier is an optional string to identify this diagnostic request.
	Identifier string `json:"identifier,omitempty"`

	// InterFileDependencies indicates if the diagnostics depend on multiple files.
	InterFileDependencies bool `json:"interFileDependencies"`

	// WorkspaceDiagnostics indicates if workspace-wide diagnostics are supported.
	WorkspaceDiagnostics bool `json:"workspaceDiagnostics"`
}

type DiagnosticRelatedInformation struct {
	// Location is the location where this related diagnostic is reported.
	Location Location `json:"location"`

	// Message is the message to be displayed for this related diagnostic.
	Message string `json:"message"`
}

type DiagnosticSeverity int

type DiagnosticTag int

type DidChangeTextDocumentParams struct {
	// TextDocument holds the identifier and version of the text document that changed.
	TextDocument VersionedTextDocumentIdentifier `json:"textDocument"`

	// ContentChanges is a list of changes applied to the document.
	// The changes represent the modified content of the document.
	ContentChanges []TextDocumentContentChangeEvent `json:"contentChanges"`
}

type DidCloseTextDocumentParams struct {
	// TextDocument contains the details of the document that was closed.
	TextDocument TextDocumentIdentifier `json:"textDocument"`
}

type DidOpenTextDocumentParams struct {
	// TextDocument contains the details of the document that was opened.
	TextDocument TextDocumentItem `json:"textDocument"`
}

type DidSaveTextDocumentParams struct {
	// TextDocument holds the identifier and version of the text document that was saved
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Text is the new text of the document that was saved.
	Text *string `json:"text,omitempty"`
}

type DocumentDiagnosticParams struct {
	// WorkDoneProgressParams contains options for work done progress reporting.
	WorkDoneProgressParams

	// TextDocument identifies the specific document to retrieve diagnostics for.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Identifier uniquely identifies the request.
	Identifier string `json:"identifier,omitempty"`

	// PreviousResultID is the identifier of the last known result for this document.
	// The server may use this to optimize diagnostic calculations and only return differences.
	PreviousResultID string `json:"previousResultId,omitempty"`
}

type DocumentDiagnosticReport interface {
	GetKind() string
}

type FullDocumentDiagnosticReport struct {
	// Kind indicates this is a full document diagnostic report.
	Kind string `json:"kind"` // Should be "full"

	// ResultID is an optional identifier for caching and incremental updates.
	ResultID string `json:"resultId,omitempty"`

	// Items contains the list of diagnostics for the document.
	Items []Diagnostic `json:"items"`
}

type HoverContent struct {
	MarkupContent   *MarkupContent `json:"-"`
	MarkedStrings   []MarkedString `json:"-"`
	PlainTextString *string        `json:"-"`
}

type HoverParams struct {
	// TextDocument is the identifier for the text document.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Position specifies the position inside the text document where hover information is requested.
	Position Position `json:"position"`

	// WorkDoneProgressParams allows reporting progress for this request.
	WorkDoneProgressParams
}

type HoverResult struct {
	// Contents is the hover information provided by the server.
	// It can be a string, a MarkupContent object, or an array of MarkedString objects.
	Contents HoverContent `json:"contents"`

	// Range is an optional range in the document that this hover refers to.
	Range *Range `json:"range,omitempty"`
}

type InitializeParams struct {
	WorkDoneProgressParams

	// ProcessID is the ID of the parent process that started the server. If null, the process is not specified.
	ProcessID int `json:"processId,omitempty"`

	// ClientInfo is the information about the client.
	ClientInfo *ClientInfo `json:"clientInfo,omitempty"`

	// RootURI is the root URI of the workspace, which may be null.
	RootURI string `json:"rootUri,omitempty"`

	// Capabilities represents the client capabilities.
	Capabilities ClientCapabilities `json:"capabilities"`

	// Trace enables tracing and can be set to "off", "messages", or "verbose".
	Trace TraceValue `json:"trace,omitempty"`
}

type InitializeResult struct {
	// Capabilities defines the capabilities provided by the language server.
	Capabilities ServerCapabilities `json:"capabilities"`

	// ServerInfo provides information about the server (optional).
	ServerInfo *ServerInfo `json:"serverInfo,omitempty"`
}

type InsertTextFormat int

type InsertTextMode int

type LanguageID string

type Location struct {
	// URI is the unique resource identifier of the document.
	URI string `json:"uri"`

	// Range specifies the range within the document where the symbol's definition is located.
	Range Range `json:"range"`
}

type LocationLink struct {
	// OriginSelectionRange is the range in the originating document where the request was initiated.
	// This can be used to specify the range of the symbol being requested.
	OriginSelectionRange *Range `json:"originSelectionRange,omitempty"`

	// TargetURI is the URI of the target document where the definition is located.
	TargetURI string `json:"targetUri"`

	// TargetRange specifies the full range in the target document where the definition resides.
	TargetRange Range `json:"targetRange"`

	// TargetSelectionRange specifies the range within the target document that identifies the symbol definition.
	TargetSelectionRange Range `json:"targetSelectionRange"`
}

type MarkedString struct {
	Language string `json:"language,omitempty"`
	Value    string `json:"value"`
}

type MarkupContent struct {
	// Kind specifies the type of markup (e.g., "plaintext" or "markdown").
	Kind string `json:"kind"`

	// Value is the content to be displayed in the hover.
	Value string `json:"value"`
}

type PartialResultParams struct {
	// PartialResultToken is a token for handling partial result updates.
	PartialResultToken *ProgressToken `json:"partialResultToken,omitempty"`
}

type Position struct {
	// Line is the zero-based line position in the document.
	Line int `json:"line"`

	// Character is the zero-based character offset in the line.
	Character int `json:"character"`
}

type ProgressToken struct {
	// contains filtered or unexported fields
}

type Range struct {
	// Start is the start position of the range.
	Start Position `json:"start"`

	// End is the end position of the range.
	End Position `json:"end"`
}

type RelatedDocumentDiagnosticReport struct {
	// Kind indicates this is a related document diagnostic report.
	Kind string `json:"kind"` // Should be "related"

	// RelatedDocuments maps document URIs to associated DocumentDiagnosticReport objects.
	RelatedDocuments map[string]DocumentDiagnosticReport `json:"relatedDocuments"`
}

type ServerCapabilities struct {
	// TextDocumentSync defines how the server handles text document synchronization.
	//
	// If omitted it defaults to TextDocumentSyncKind.None`
	TextDocumentSync interface{} `json:"textDocumentSync,omitempty"` // *TextDocumentSyncOptions | TextDocumentSyncKind

	// HoverProvider indicates whether the server provides hover support.
	HoverProvider bool `json:"hoverProvider,omitempty"`

	// CompletionProvider defines the server's capability to provide completion items.
	CompletionProvider *CompletionOptions `json:"completionProvider,omitempty"`

	// SignatureHelpProvider defines the server's capability to provide signature help.
	SignatureHelpProvider *SignatureHelpOptions `json:"signatureHelpProvider,omitempty"`

	// DefinitionProvider represents the server's capability of providing definitions
	// for symbols in a text document, allowing the client to navigate to the symbol's definition.
	DefinitionProvider bool `json:"definitionProvider,omitempty"`

	// The server has support for pull model diagnostics.
	DiagnosticProvider interface{} `json:"diagnosticProvider,omitempty"`

	// The server has support for code actions.
	CodeActionProvider bool `json:"codeActionProvider,omitempty"`
}

type ServerInfo struct {
	// Name is the name of the server.
	Name string `json:"name"`

	// Version is the version of the server (optional).
	Version string `json:"version,omitempty"`
}

type SignatureHelpOptions struct {
	// TriggerCharacters defines the characters that trigger signature help.
	TriggerCharacters []string `json:"triggerCharacters,omitempty"`
}

type TextDocumentContentChangeEvent struct {
	// Range specifies the range of the text document that changed.
	// If nil, the entire document is considered changed.
	Range *Range `json:"range,omitempty"`

	// RangeLength is the length of the range that got replaced.
	// This field is optional and only provided when applicable.
	RangeLength *int `json:"rangeLength,omitempty"`

	// Text is the new text of the document after the change.
	Text string `json:"text"`
}

type TextDocumentEdit struct {
	// TextDocument identifies the text document to change.
	TextDocument VersionedTextDocumentIdentifier `json:"textDocument"`

	// Edits is an array of edits to apply to the text document.
	Edits []TextEdit `json:"edits"`
}

type TextDocumentIdentifier struct {
	// URI is the unique resource identifier of the document that was closed.
	URI string `json:"uri"`
}

type TextDocumentItem struct {
	// URI is the unique resource identifier of the document (usually a file path or URL).
	URI string `json:"uri"`

	// LanguageID is the language identifier associated with the document (e.g., "python", "javascript").
	LanguageID LanguageID `json:"languageId"`

	// Version is the version number of the document.
	Version int `json:"version"`

	// Text is the content of the document.
	Text string `json:"text"`
}

type TextDocumentPositionParams struct {
	// TextDocument holds the identifier of the text document.
	TextDocument TextDocumentIdentifier `json:"textDocument"`

	// Position specifies the position within the text document.
	Position Position `json:"position"`
}

type TextDocumentSyncKind float64

type TextEdit struct {
	// Range specifies the range of text to be replaced.
	Range Range `json:"range"`

	// NewText is the string to replace the range with.
	NewText string `json:"newText"`
}

type TraceValue string

type VersionedTextDocumentIdentifier struct {
	TextDocumentIdentifier

	// Version is the version number of the document.
	Version int `json:"version"`
}

type WorkDoneProgressOptions struct {
	// WorkDoneProgress is a flag that indicates whether progress reporting is supported.
	WorkDoneProgress bool `json:"workDoneProgress,omitempty"`
}

type WorkDoneProgressParams struct {
	// WorkDoneToken an optional token that a server can use to report work done progress.
	WorkDoneToken *ProgressToken `json:"workDoneToken,omitempty"`
}

type WorkspaceEdit struct {
	// Changes is a map of document URIs to an array of TextEdits.
	// Changes should be applied to the documents in the specified order.
	Changes map[string][]TextEdit `json:"changes,omitempty"`

	// DocumentChanges is an optional array of TextDocumentEdits.
	// These edits support versioned documents and resource operations.
	DocumentChanges []TextDocumentEdit `json:"documentChanges,omitempty"`
}