fix(render): not render two separator for doc window (#451)

* fix(render): not render two separator for doc window

Some LSP servers like lua_ls would return `---` for function doc,
so the manually added separator would make two separator in doc window.

* doc: update default highlight group

Author: tim3nd

README.md

@@ -679,12 +679,14 @@ MiniDeps.add({
 | `BlinkCmpScrollBarThumb` | PmenuThumb | The scrollbar thumb |
 | `BlinkCmpScrollBarGutter` | PmenuSbar | The scrollbar gutter |
 | `BlinkCmpLabel` | Pmenu | Label of the completion item |
-| `BlinkCmpLabelDeprecated` | Comment | Deprecated label of the completion item |
+| `BlinkCmpLabelDeprecated` | NonText | Deprecated label of the completion item |
 | `BlinkCmpLabelMatch` | Pmenu | (Currently unused) Label of the completion item when it matches the query |
+| `BlinkCmpLabelDetail` | NonText | Label description of the completion item |
+| `BlinkCmpLabelDescription` | NonText | Label description of the completion item |
 | `BlinkCmpKind` | Special | Kind icon/text of the completion item |
 | `BlinkCmpKind<kind>` | Special | Kind icon/text of the completion item |
 | `BlinkCmpSource` | NonText | Source of the completion item |
-| `BlinkCmpGhostText` | Comment | Preview item with ghost text  |
+| `BlinkCmpGhostText` | NonText | Preview item with ghost text  |
 | `BlinkCmpDoc` | NormalFloat | The documentation window |
 | `BlinkCmpDocBorder` | NormalFloat | The documentation window border |
 | `BlinkCmpDocSeparator` | NormalFloat | The documentation separator between doc and detail |

lua/blink/cmp/lib/window/docs.lua

@@ -24,9 +24,12 @@ function docs.render_detail_and_documentation(bufnr, detail, documentation, max_
   detail_lines, doc_lines = docs.extract_detail_from_doc(detail_lines, doc_lines)
 
   local combined_lines = vim.list_extend({}, detail_lines)
+
   -- add a blank line for the --- separator
-  if #detail_lines > 0 and #doc_lines > 0 then table.insert(combined_lines, '') end
-  vim.list_extend(combined_lines, doc_lines)
+  local doc_already_has_separator = #doc_lines > 1 and (doc_lines[1] == '---' or doc_lines[1] == '***')
+  if #detail_lines > 0 and #doc_lines > 0  then table.insert(combined_lines, '') end
+  -- skip original separator in doc_lines, so we can highlight it later
+  vim.list_extend(combined_lines, doc_lines, doc_already_has_separator and 2 or 1)
 
   vim.api.nvim_buf_set_lines(bufnr, 0, -1, true, combined_lines)
   vim.api.nvim_set_option_value('modified', false, { buf = bufnr })