feat: implement interactable dap hover

This commit is contained in:
2025-09-26 17:21:04 +02:00
parent 5256beea0f
commit cff07f8317
6 changed files with 801 additions and 510 deletions
+146
View File
@@ -0,0 +1,146 @@
-- Highlighted text content builder for DAP tree display
local log = require("ow.log")
---@class ow.dap.hover.content.Capture
---@field start_col integer
---@field end_col integer
---@field text string
---@field group string
---@field priority integer
---@class ow.dap.hover.Highlight
---@field group string Highlight group name
---@field start_col integer Start column (0-indexed)
---@field end_col integer End column (0-indexed)
---@class ow.dap.hover.Content
---@field text string The complete text content
---@field highlights ow.dap.hover.Highlight[] List of highlights to apply
---@field _current_col integer Current column position (for building)
local Content = {}
Content.__index = Content
---Create new highlighted content
---@return ow.dap.hover.Content
function Content.new()
return setmetatable({
text = "",
highlights = {},
_current_col = 0,
}, Content)
end
---Add text with optional highlighting
---@param text string Text to add
---@param highlight_group? string Optional highlight group
function Content:add(text, highlight_group)
local start_col = self._current_col
local end_col = start_col + #text
self.text = self.text .. text
self._current_col = end_col
if highlight_group then
table.insert(self.highlights, {
group = highlight_group,
start_col = start_col,
end_col = end_col,
})
end
end
---Add text with tree-sitter syntax highlighting
---@param text string The text to highlight
---@param lang string Language for tree-sitter
function Content:add_with_treesitter(text, lang)
local start_col = self._current_col
-- First, just add the text normally
self:add(text)
-- Then apply tree-sitter highlights on top
local ok, parser = pcall(vim.treesitter.get_string_parser, text, lang)
if not ok or not parser then
return
end
local tree = parser:parse()[1]
if not tree then
return
end
local query = vim.treesitter.query.get(lang, "highlights")
if not query then
return
end
-- Add highlights for all captures (overlapping is fine)
for id, node in query:iter_captures(tree:root(), text, 0, -1) do
local capture_name = query.captures[id]
local start_row, start_col_rel, end_row, end_col_rel = node:range()
-- TODO: keep track of text as lines instead, so we can handle multiline
-- highlights
if start_row == end_row then -- Single line only
-- Convert to absolute column positions
local abs_start_col = start_col + start_col_rel
local abs_end_col = start_col + end_col_rel
-- Add the highlight
table.insert(self.highlights, {
group = "@" .. capture_name,
start_col = abs_start_col,
end_col = abs_end_col,
})
end
end
end
---Add a newline and reset column tracking
function Content:newline()
self:add("\n")
self._current_col = 0
end
---Get the lines as a table
---@return string[]
function Content:get_lines()
return vim.split(self.text, "\n", { trimempty = true })
end
---Apply highlights to a buffer
---@param ns_id integer
---@param buf integer Buffer handle
---@param line_offset? integer Line offset to apply highlights at (default 0)
function Content:apply_highlights(ns_id, buf, line_offset)
line_offset = line_offset or 0
local lines = self:get_lines()
local current_line = 0
local line_start_col = 0
for _, highlight in ipairs(self.highlights) do
-- Find which line this highlight belongs to
while
current_line < #lines - 1
and highlight.start_col
>= line_start_col + #lines[current_line + 1] + 1
do
line_start_col = line_start_col + #lines[current_line + 1] + 1 -- +1 for newline
current_line = current_line + 1
end
-- Calculate column positions relative to line start
local start_col = highlight.start_col - line_start_col
local end_col = highlight.end_col - line_start_col
-- Apply highlight
vim.hl.range(
buf,
ns_id,
highlight.group,
{ line_offset + current_line, start_col },
{ line_offset + current_line, end_col }
)
end
end
return Content
+141
View File
@@ -0,0 +1,141 @@
-- Tree node representation for DAP variables
local Content = require("ow.dap.hover.content")
local log = require("ow.log")
---@class ow.dap.hover.Node
---@field item ow.dap.Item The DAP item this node represents
---@field parent ow.dap.hover.Node? Parent node
---@field children ow.dap.hover.Node[] Child nodes
---@field is_expanded boolean Whether this node is expanded
---@field line_number integer Buffer line number where this node is displayed
---@field is_last_child boolean Whether this is the last child of its parent
local Node = {}
Node.__index = Node
---Create a new tree node
---@param item ow.dap.Item
---@param parent ow.dap.hover.Node?
---@return ow.dap.hover.Node
function Node.new(item, parent)
return setmetatable({
item = item,
parent = parent,
children = {},
is_expanded = false,
line_number = -1,
is_last_child = false,
}, Node)
end
---Check if this node represents a container (struct/array)
---@return boolean
function Node:is_container()
return self.item.variablesReference and self.item.variablesReference > 0
or false
end
---Get the tree prefix for this node (├─, └─, │, etc.)
---@return string
function Node:get_tree_prefix()
if not self.parent then
return "" -- Root node has no prefix
end
local prefix = ""
-- Walk up the tree to build the prefix
local node = self.parent
while node and node.parent do
if node.is_last_child then
prefix = " " .. prefix
else
prefix = "" .. prefix
end
node = node.parent
end
-- Add the final branch character
if self.is_last_child then
prefix = prefix .. "└─ "
else
prefix = prefix .. "├─ "
end
return prefix
end
---@return boolean
function Node:is_c_array_element()
return self.item.name:match("^%[?%d+%]?$") ~= nil
end
---@return boolean
function Node:is_c_pointer_child()
return self.parent
and self.parent.item.type:match(
"%*%s*[const%s]*[volatile%s]*[restrict%s]*$"
) ~= nil
or false
end
---@return string
function Node:format_c_expression()
if self:is_c_array_element() then
return string.format(
"%s = (%s) %s",
self.item.name,
self.item.type,
self.item.value
)
end
if self:is_c_pointer_child() then
return string.format("*%s = %s", self.parent.item.name, self.item.value)
end
return string.format(
"%s %s = %s",
self.item.type,
self.item.name,
self.item.value
)
end
---Format this node as highlighted content
---@param session dap.Session DAP session for making requests
---@return ow.dap.hover.Content
function Node:format(session)
local content = Content.new()
-- Add expansion marker for containers
if self:is_container() then
local marker = self.is_expanded and "-" or "+"
content:add(marker .. " ", "@comment")
else
content:add(" ")
end
-- Add tree prefix
local tree_prefix = self:get_tree_prefix()
if tree_prefix ~= "" then
content:add(tree_prefix, "@comment")
end
local stmt
if session.filetype == "c" or session.filetype == "cpp" then
stmt = self:format_c_expression()
else
error(
string.format("Formatting for %s not implemented", session.filetype)
)
end
content:add_with_treesitter(stmt, session.filetype)
if self.item.value == "" then
content:add("...", "@comment")
end
return content
end
return Node
+156
View File
@@ -0,0 +1,156 @@
-- Tree-based DAP variable formatter with expand/collapse support
local Content = require("ow.dap.hover.content")
local Node = require("ow.dap.hover.node")
local log = require("ow.log")
---@class ow.dap.hover.Tree
---@field session dap.Session
---@field root_node ow.dap.hover.Node?
---@field line_to_node table<integer, ow.dap.hover.Node> Map line numbers to nodes
---@field extmark_to_node table<integer, ow.dap.hover.Node> Map extmark IDs to nodes
local Tree = {}
Tree.__index = Tree
---Create a new tree formatter
---@param session dap.Session
---@return ow.dap.hover.Tree
function Tree.new(session)
return setmetatable({
session = session,
root_node = nil,
line_to_node = {},
extmark_to_node = {},
}, Tree)
end
---Build the tree from a DAP item (async)
---@async
---@param item ow.dap.Item Root item to build tree from
---@return ow.dap.hover.Node
function Tree:build(item)
local root = Node.new(item, nil)
self.root_node = root
-- For now, start with everything collapsed
-- Later we can add logic to expand first level by default
return root
end
---Load children for a node (async)
---@async
---@param node ow.dap.hover.Node
---@return boolean success Whether loading succeeded
function Tree:load_children(node)
if not node:is_container() or #node.children > 0 then
return true -- Already loaded or not a container
end
local err, resp = self.session:request("variables", {
variablesReference = node.item.variablesReference,
})
if err or not resp or #resp.variables == 0 then
return false
end
-- Create child nodes
for i, var in ipairs(resp.variables) do
local child_item = {
name = var.name,
type = var.type,
value = var.value,
variablesReference = var.variablesReference,
depth = node.item.depth + 1,
}
local child = Node.new(child_item, node)
child.is_last_child = (i == #resp.variables)
-- Format array indices properly
if child_item.name:match("^%d+$") then
child_item.name = "[" .. child_item.name .. "]"
end
table.insert(node.children, child)
end
return true
end
---Render the tree to highlighted content
---@async
---@return ow.dap.hover.Content
function Tree:render()
if not self.root_node then
return Content.new()
end
local content = Content.new()
self.line_to_node = {}
self:render_node(self.root_node, content, 0)
return content
end
---Render a single node and its expanded children
---@async
---@param node ow.dap.hover.Node
---@param content ow.dap.hover.Content
---@param line_number integer Current line number
---@return integer new_line_number Updated line number after rendering
function Tree:render_node(node, content, line_number)
-- Store line mapping
node.line_number = line_number
self.line_to_node[line_number] = node
-- Format this node
local node_content = node:format(self.session)
content.text = content.text .. node_content.text
-- Copy highlights, adjusting for current position
local text_offset = #content.text - #node_content.text
for _, highlight in ipairs(node_content.highlights) do
table.insert(content.highlights, {
group = highlight.group,
start_col = highlight.start_col + text_offset,
end_col = highlight.end_col + text_offset,
})
end
content:newline()
line_number = line_number + 1
-- Render expanded children
if node.is_expanded then
for _, child in ipairs(node.children) do
line_number = self:render_node(child, content, line_number)
end
end
return line_number
end
---Toggle expansion state of node at given line
---@async
---@param line_number integer
---@return boolean success Whether toggle succeeded
function Tree:toggle_at_line(line_number)
local node = self.line_to_node[line_number]
if not node or not node:is_container() then
return false
end
if not node.is_expanded then
-- Expanding: load children if needed
local success = self:load_children(node)
if not success then
return false
end
end
-- Toggle state
node.is_expanded = not node.is_expanded
return true
end
return Tree