book: Add completion item kinds configuration

editor.completion-item-kinds section and theming information

Author: nferhat

book/src/editor.md

@@ -1,6 +1,7 @@
 ## Editor
 
 - [`[editor]` Section](#editor-section)
+- [`[editor.completion-item-kinds]` Section](#editorcompletion-item-kinds-section)
 - [`[editor.statusline]` Section](#editorstatusline-section)
 - [`[editor.lsp]` Section](#editorlsp-section)
 - [`[editor.cursor-shape]` Section](#editorcursor-shape-section)
@@ -55,6 +56,91 @@
 | `jump-label-alphabet` | The characters that are used to generate two character jump labels. Characters at the start of the alphabet are used first. | `"abcdefghijklmnopqrstuvwxyz"`
 | `end-of-line-diagnostics` | Minimum severity of diagnostics to render at the end of the line. Set to `disable` to disable entirely. Refer to the setting about `inline-diagnostics` for more details | "disable"
 | `clipboard-provider` | Which API to use for clipboard interaction. One of `pasteboard` (MacOS), `wayland`, `x-clip`, `x-sel`, `win-32-yank`, `termux`, `tmux`, `windows`, `termcode`, `none`, or a custom command set. | Platform and environment specific. |
+| `completion-item-kinds` | Text to show for the completion menu item kind. By default helix displays the kind in `kebab-case` | `{}` (empty) |
+
+### `[editor.completion-item-kinds]` Section
+
+These are used to override completion item kinds text. The same text that displays 
+what kind of completion is inside the completion menu.
+
+<details>
+<summary>Here are the completion item kinds for the <b>LSP</b> completion menu:</summary>
+- `text`
+- `method`
+- `function`
+- `constructor`
+- `field`
+- `variable`
+- `class`
+- `interface`
+- `module`
+- `property`
+- `unit`
+- `value`
+- `enum`
+- `keyword`
+- `snippet`
+- `color`
+- `file`
+- `reference`
+- `folder`
+- `enum-member`
+- `constant`
+- `struct`
+- `event`
+- `operator`
+- `type-parameter`
+</details>
+
+<details>
+<summary>Here are the completion item kinds for the <b>path</b> completion menu:</summary>
+- `file`
+- `folder`
+- `link`
+</details>
+
+<br>
+
+The value of the map is the text to display inside of the completion menu. By
+default, helix will use the key.
+
+
+<details>
+
+<summary>Example configuration with <a href="https://nerdfonts.com">Nerd Fonts</a> </summary>
+
+```toml
+[editor.completion-item-kinds]
+text = ""
+method = "󰆧"
+function = "󰊕"
+constructor = ""
+field = "󰇽"
+variable = "󰂡"
+class = "󰠱"
+interface = ""
+module = ""
+property = "󰜢"
+unit = ""
+value = "󰎠"
+enum = ""
+keyword = "󰌋"
+snippet = ""
+color = "󰏘"
+file = "󰈙"
+reference = ""
+folder = "󰉋"
+link = "󱧮"
+enum-member = ""
+constant = "󰏿"
+struct = ""
+event = ""
+operator = "󰆕"
+type-parameter = "󰅲"
+
+```
+
+</details>
 
 ### `[editor.clipboard-provider]` Section
 

book/src/themes.md

@@ -316,6 +316,8 @@ These scopes are used for theming the editor interface:
 | `ui.menu`                         | Code and command completion menus                                                              |
 | `ui.menu.selected`                | Selected autocomplete item                                                                     |
 | `ui.menu.scroll`                  | `fg` sets thumb color, `bg` sets track color of scrollbar                                      |
+| `ui.completion.kind`              | Default completion menu item kind color                                                        |
+| `ui.completion.kind.{kind}`       | Completion menu item kind for `kind`. These are the same as [completion item kinds][cik]       |
 | `ui.selection`                    | For selections in the editing area                                                             |
 | `ui.selection.primary`            |                                                                                                |
 | `ui.highlight`                    | Highlighted lines in the picker preview                                                        |
@@ -337,3 +339,4 @@ These scopes are used for theming the editor interface:
 | `diagnostic.deprecated`           | Diagnostics with deprecated tag (editing area)                                                 |
 
 [editor-section]: ./configuration.md#editor-section
+[cik]: ./editor.md#editorcompletion-item-kinds-section