Module colorscheme 

Colorscheme setup. Colorscheme and highlight group configuration helpers.

Exposes a dictionary with a set function applying base UI preferences (dark background, termguicolors) and custom highlight groups (diagnostics, statusline, general UI).

Note on set_hl implementation

Highlight options are set through a Lua-based path (vim.api.nvim_set_hl) instead of the direct C FFI binding (nvim_oxi::api::set_hl). This works around an ABI mismatch between nvim-oxi’s SetHighlightOpts struct layout (targeting Neovim v0.11.3) and Neovim v0.12.0-dev (886efcb853), where the cterm field in Dict(highlight) changed from Object (32 bytes) to DictAs(highlight_cterm) / Dict (24 bytes), shifting all subsequent fields and causing validation errors.

Structs

LuaHlOpts 🔒

Highlight options that serialize to a Lua table literal for use with vim.api.nvim_set_hl().

Constants

COMMENTS_FG 🔒

CURSOR_BG 🔒

CURSOR_FG 🔒

DIAGNOSTICS_FG 🔒

DIAG_ERROR_FG 🔒

DIAG_HINT_FG 🔒

DIAG_INFO_FG 🔒

DIAG_OK_FG 🔒

DIAG_WARN_FG 🔒

GITSIGNS_ADDED 🔒

GITSIGNS_CHANGED 🔒

GITSIGNS_FG 🔒

GITSIGNS_REMOVED 🔒

GLOBAL_BG 🔒

GLOBAL_FG 🔒

NONE 🔒

NON_TEXT_FG 🔒

TREESITTER_CONTEXT_BG 🔒

Functions

decimal_to_hex_color 🔒

Formats an RGB integer as a #RRGGBB hex string.

dict

[Dictionary] with colorscheme and highlight helpers.

get_hl 🔒

Retrieves [GetHlInfos] (single or map) for given highlight options.

get_hl_multiple 🔒

Retrieves multiple [HighlightInfos] entries (map variant) for given highlight options.

get_hl_single 🔒

Retrieves [HighlightInfos] of a single group.

get_overridden_hl_opts 🔒

Retrieves the current highlight options for a given highlight group and applies overrides.

set

Sets the desired Neovim colorscheme and custom highlight groups.

set_hl 🔒

Sets a highlight group in the specified namespace via Lua, bypassing the broken C FFI path.