Method handleHover

pkg/lsp/handler.go:607–637

handleHover provides hover information for SQL keywords. When the user hovers over a SQL keyword in their editor, this handler returns markdown-formatted documentation with syntax examples. The handler supports 60+ SQL keywords across all major categories: - Core DML: SELECT, INSERT, UPDATE, DELET

(params json.RawMessage)

//   - Empty Hover if position is not on a keyword
//   - Error if document not found or params invalid
func (h *Handler) handleHover(params json.RawMessage) (*Hover, error) {
	var p TextDocumentPositionParams
	if err := json.Unmarshal(params, &p); err != nil {
		return nil, err
	}

	doc, ok := h.server.Documents().Get(p.TextDocument.URI)
	if !ok {
		// Return empty hover response instead of nil for proper LSP compliance
		return &Hover{}, nil
	}

	// Get word at position
	word := doc.GetWordAtPosition(p.Position)
	if word == "" {
		return &Hover{}, nil
	}

	// Look up keyword documentation
	doc_text := getKeywordDocumentation(strings.ToUpper(word))
	if doc_text == "" {
		return &Hover{}, nil
	}

	return &Hover{
		Contents: MarkupContent{
			Kind:  Markdown,
			Value: doc_text,
		},
	}, nil
}

// handleCompletion provides completion suggestions for SQL keywords and snippets.
//