feat(ui): add structured title chunks and highlights

Author: mhiro2

README.md

@@ -148,8 +148,7 @@ Configure via `require("peekstack").setup({ ... })`.
     },
     title = {
       enabled = true,
-      format = "{provider} · {path}:{line}{context}",
-      breadcrumbs = true,
+      format = "{kind}{provider} {path}:{line}{context}",
       context = {
         enabled = false,
         max_depth = 5,

doc/peekstack.txt

@@ -32,8 +32,7 @@ With options:
       },
       title = {
         enabled = true,
-        format = "{provider} · {path}:{line}{context}",
-        breadcrumbs = true,
+        format = "{kind}{provider} {path}:{line}{context}",
         context = {
           enabled = false,
           max_depth = 5,

lua/peekstack/config.lua

@@ -81,8 +81,7 @@ M.defaults = {
     },
     title = {
       enabled = true,
-      format = "{kind}{provider} · {path}:{line}{context}",
-      breadcrumbs = true,
+      format = "{kind}{provider} {path}:{line}{context}",
       context = {
         enabled = false,
         max_depth = 5,

lua/peekstack/core/popup.lua

@@ -100,7 +100,7 @@ local function capture_origin_from_win(winid)
 end
 
 ---@param location PeekstackLocation
----@param opts? { buffer_mode?: "copy"|"source", title?: string, editable?: boolean, ephemeral?: boolean, origin_winid?: integer }
+---@param opts? { buffer_mode?: "copy"|"source", title?: string|PeekstackTitleChunk[], editable?: boolean, ephemeral?: boolean, origin_winid?: integer }
 ---@return PeekstackPopupModel?
 function M.create(location, opts)
   opts = opts or {}
@@ -167,12 +167,27 @@ function M.create(location, opts)
     return nil
   end
 
-  local title = win_opts.title
+  local title = nil
+  local title_chunks = nil
+  if win_opts.title ~= nil then
+    if type(win_opts.title) == "table" then
+      title_chunks = win_opts.title
+    end
+    title = render.title_text(win_opts.title)
+    if title == "" then
+      title = nil
+      title_chunks = nil
+    end
+  end
   if opts.title and opts.title ~= "" then
-    title = opts.title
     win_opts.title = opts.title
     win_opts.title_pos = "center"
     pcall(vim.api.nvim_win_set_config, winid, win_opts)
+    title = render.title_text(opts.title)
+    title_chunks = nil
+    if title == "" then
+      title = nil
+    end
   end
   set_cursor(winid, location, line_offset)
 
@@ -194,6 +209,7 @@ function M.create(location, opts)
     origin_bufnr = origin.bufnr,
     origin_is_popup = origin_is_popup,
     title = title,
+    title_chunks = title_chunks,
     pinned = false,
     buffer_mode = buffer_mode,
     line_offset = line_offset,

lua/peekstack/core/stack.lua

@@ -184,6 +184,7 @@ local function close_stack_item(stack, idx, item)
   local history_entry = {
     location = item.location,
     title = item.title,
+    title_chunks = item.title_chunks,
     pinned = item.pinned,
     buffer_mode = item.buffer_mode or "copy",
     source_bufnr = item.source_bufnr,
@@ -265,10 +266,15 @@ end
 local function restore_entry(stack, entry)
   deps()
   local create_opts = {
-    title = entry.title,
     buffer_mode = entry.buffer_mode or "copy",
     origin_winid = stack.root_winid,
   }
+  -- Only pass title override for user-renamed popups (no title_chunks).
+  -- Auto-generated titles are regenerated by build_title() to preserve
+  -- structured chunks for popup window and stack view highlighting.
+  if not entry.title_chunks then
+    create_opts.title = entry.title
+  end
 
   -- For source mode, check if the source buffer is still valid
   if create_opts.buffer_mode == "source" and entry.source_bufnr then
@@ -448,11 +454,14 @@ function M.reopen_by_id(id, winid)
   local stack = ensure_stack(winid)
   for idx, item in ipairs(stack.popups) do
     if item.id == id then
-      local model = popup.create(item.location, {
-        title = item.title,
+      local reopen_opts = {
         buffer_mode = item.buffer_mode or "copy",
         origin_winid = stack.root_winid,
-      })
+      }
+      if not item.title_chunks then
+        reopen_opts.title = item.title
+      end
+      local model = popup.create(item.location, reopen_opts)
       if not model then
         return nil
       end
@@ -522,6 +531,7 @@ function M.handle_win_closed(winid)
         local history_entry = {
           location = item.location,
           title = item.title,
+          title_chunks = item.title_chunks,
           pinned = item.pinned,
           buffer_mode = item.buffer_mode or "copy",
           source_bufnr = item.source_bufnr,
@@ -566,6 +576,7 @@ function M.rename_by_id(id, title, winid)
   for _, item in ipairs(stack.popups) do
     if item.id == id then
       item.title = title
+      item.title_chunks = nil
       return true
     end
   end
@@ -774,6 +785,7 @@ function M.close_all(winid)
     local history_entry = {
       location = item.location,
       title = item.title,
+      title_chunks = item.title_chunks,
       pinned = item.pinned,
       buffer_mode = item.buffer_mode or "copy",
       source_bufnr = item.source_bufnr,

lua/peekstack/init.lua

@@ -20,6 +20,12 @@ local function set_hl()
   vim.api.nvim_set_hl(0, "PeekstackStackViewEmpty", { default = true, link = "Comment" })
   vim.api.nvim_set_hl(0, "PeekstackStackViewCursorLine", { default = true, link = "CursorLine" })
   vim.api.nvim_set_hl(0, "PeekstackInlinePreview", { default = true, link = "Comment" })
+  vim.api.nvim_set_hl(0, "PeekstackTitleProvider", { default = true, link = "Type" })
+  vim.api.nvim_set_hl(0, "PeekstackTitlePath", { default = true, link = "Directory" })
+  vim.api.nvim_set_hl(0, "PeekstackTitleKindError", { default = true, link = "DiagnosticError" })
+  vim.api.nvim_set_hl(0, "PeekstackTitleKindWarn", { default = true, link = "DiagnosticWarn" })
+  vim.api.nvim_set_hl(0, "PeekstackTitleKindInfo", { default = true, link = "DiagnosticInfo" })
+  vim.api.nvim_set_hl(0, "PeekstackTitleKindHint", { default = true, link = "DiagnosticHint" })
 end
 
 ---@param name string

lua/peekstack/types.lua

@@ -83,6 +83,10 @@
 ---@field separator string
 ---@field node_types table<string, string[]>
 
+---@class PeekstackTitleChunk
+---@field [1] string
+---@field [2]? string
+
 ---@class PeekstackStoreData
 ---@field version integer
 ---@field sessions table<string, PeekstackSession>
@@ -142,7 +146,6 @@
 ---@class PeekstackConfigTitle
 ---@field enabled boolean
 ---@field format string
----@field breadcrumbs boolean
 ---@field context PeekstackConfigTitleContext
 
 ---@class PeekstackConfigPath