--- *mini.hues* Generate configurable color scheme

--- *MiniHues*

---

--- MIT License Copyright (c) 2023 Evgeni Chasnovski

---

--- ==============================================================================

---

--- Features:

--- - Required to set two base colors: background and foreground.

--- Their shades and other non-base colors are computed to be as much

--- perceptually different as reasonably possible.

--- See |MiniHues.config| for setup inspiration.

---

--- - Configurable:

--- - Number of hues used for non-base colors (from 0 to 8).

--- - Saturation level ('low', 'medium', 'high').

--- - Accent color used for some selected UI elements.

--- - Plugin integration (can be selectively enabled for faster startup).

---

--- - Random generator for base colors. See |MiniHues.gen_random_base_colors()|.

--- Powers |randomhue| color scheme.

---

--- - Lua function to compute palette used in color scheme.

--- See |MiniHues.make_palette()|.

---

--- Supported highlight groups:

--- - All built-in UI and syntax groups.

---

--- - Built-in Neovim LSP and diagnostic.

---

--- - Tree-sitter (|treesitter-highlight-groups|).

---

--- - LSP semantic tokens (|lsp-semantic-highlight|).

---

--- - Plugins (either with explicit definition or by verification that default

--- highlighting works appropriately):

--- - 'echasnovski/mini.nvim'

--- - 'akinsho/bufferline.nvim'

--- - 'anuvyklack/hydra.nvim'

--- - 'DanilaMihailov/beacon.nvim'

--- - 'folke/lazy.nvim'

--- - 'folke/noice.nvim'

--- - 'folke/todo-comments.nvim'

--- - 'folke/trouble.nvim'

--- - 'folke/which-key.nvim'

--- - 'ggandor/leap.nvim'

--- - 'glepnir/dashboard-nvim'

--- - 'glepnir/lspsaga.nvim'

--- - 'HiPhish/rainbow-delimiters.nvim'

--- - 'hrsh7th/nvim-cmp'

--- - 'justinmk/vim-sneak'

--- - 'kevinhwang91/nvim-ufo'

--- - 'lewis6991/gitsigns.nvim'

--- - 'lukas-reineke/indent-blankline.nvim'

--- - 'neoclide/coc.nvim'

--- - 'NeogitOrg/neogit'

--- - 'nvim-lualine/lualine.nvim'

--- - 'nvim-neo-tree/neo-tree.nvim'

--- - 'nvim-telescope/telescope.nvim'

--- - 'nvim-tree/nvim-tree.lua'

--- - 'phaazon/hop.nvim'

--- - 'rcarriga/nvim-dap-ui'

--- - 'rcarriga/nvim-notify'

--- - 'rlane/pounce.nvim'

--- - 'romgrk/barbar.nvim'

--- - 'stevearc/aerial.nvim'

--- - 'williamboman/mason.nvim'

---

--- # Setup ~

---

--- This module needs a setup with `require('mini.hues').setup({})` and

--- **mandatory `background` and `foreground` fields** (add more fields to fit

--- your taste). It will create global Lua table `MiniHues` which you can use

--- for scripting or manually (with `:lua MiniHues.*`).

---

--- See |MiniHues.config| for `config` structure and default values.

---

--- This module doesn't have runtime options, so using `vim.b.minihues_config`

--- will have no effect here.

---

--- Example:

--- >

--- require('mini.hues').setup({

--- background = '#11262d',

--- foreground = '#c0c8cc',

--- plugins = {

--- default = false,

--- ['echasnovski/mini.nvim'] = true,

--- },

--- })

--- <

--- # Notes ~

---

--- - Using `setup()` doesn't actually create a |colorscheme|. It basically

--- creates a coordinated set of |highlight|s. To create your own scheme:

--- - Put "myscheme.lua" file (name after your chosen theme name) inside

--- any "colors" directory reachable from 'runtimepath' ("colors" inside

--- your Neovim config directory is usually enough).

--- - Inside "myscheme.lua" call `require('mini.hues').setup()` with your

--- palette and only after that set |g:colors_name| to "myscheme".

---

--- - This module doesn't define |cterm-colors| for implementation simplicity.

--- Use |mini.colors| module, |MiniColors-colorscheme:add_cterm_attributes()|

--- in particular.

--- Random hue color scheme ~

---

--- This module comes with a pre-built color scheme but with a twist: every

--- `:colorscheme randomhue` call will result in a different (randomly yet

--- carefully selected) colors.

---

--- It is essentially a combination of calls to |MiniHues.setup()| and

--- |MiniHues.gen_random_base_colors()| with a slight adjustments for

--- 'background' value.

---

--- Activate it as regular |colorscheme|. Get currently active config with

--- `:lua print(vim.inspect(MiniHues.config))`.

---@tag randomhue

---@diagnostic disable:undefined-field

---@diagnostic disable:discard-returns

---@diagnostic disable:unused-local

-- Module definition ==========================================================

local MiniHues = {}

local H = {}

--- Module setup

---

---@usage >lua

--- require('mini.hues').setup({

--- -- Use config table as you like

--- -- Needs both `background` and `foreground` fields present

--- background = '#11262d',

--- foreground = '#c0c8cc',

--- })

--- <

MiniHues.setup = function(config)

-- Export module

_G.MiniHues = MiniHues

-- Setup config

config = H.setup_config(config)

-- Apply config

H.apply_config(config)

end

--- Module config

---

--- See |MiniHues.make_palette()| for more information about how certain

--- settings affect output color scheme.

---

--- Default values:

---@eval return MiniDoc.afterlines_to_code(MiniDoc.current.eval_section)

---@text # Options ~

---

--- ## Plugin integrations ~

---

--- `config.plugins` defines for which supported plugins highlight groups will

--- be created. Limiting number of integrations slightly decreases startup time.

--- It is a table with boolean (`true`/`false`) values which are applied as follows:

--- - If plugin name (as listed in |mini.hues|) has entry, it is used.

--- - Otherwise `config.plugins.default` is used.

---

--- Example which will load only "mini.nvim" integration:

--- >

--- require('mini.hues').setup({

--- background = '#11262d',

--- foreground = '#c0c8cc',

--- plugins = {

--- default = false,

--- ['echasnovski/mini.nvim'] = true,

--- },

--- })

---

--- # Examples ~

---

--- Here are some possible setup configurations (copy first line and then use

--- only one `setup` call): >

---

--- local setup = require('mini.hues').setup

---

--- -- Choose background and foreground

--- setup({ background = '#2f1c22', foreground = '#cdc4c6' }) -- red

--- setup({ background = '#2f1e16', foreground = '#cdc5c1' }) -- orange

--- setup({ background = '#282211', foreground = '#c9c6c0' }) -- yellow

--- setup({ background = '#1c2617', foreground = '#c4c8c2' }) -- green

--- setup({ background = '#112723', foreground = '#c0c9c7' }) -- cyan

--- setup({ background = '#11262d', foreground = '#c0c8cc' }) -- azure

--- setup({ background = '#1d2231', foreground = '#c4c6cd' }) -- blue

--- setup({ background = '#281e2c', foreground = '#c9c5cb' }) -- purple

---

--- -- Choose number of accent colors

--- setup({ background = '#11262d', foreground = '#c0c8cc', n_hues = 6 })

--- setup({ background = '#11262d', foreground = '#c0c8cc', n_hues = 4 })

--- setup({ background = '#11262d', foreground = '#c0c8cc', n_hues = 2 })

--- setup({ background = '#11262d', foreground = '#c0c8cc', n_hues = 0 })

---

--- -- Choose saturation of colored text

--- setup({ background = '#11262d', foreground = '#c0c8cc', saturation = 'low' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', saturation = 'medium' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', saturation = 'high' })

---

--- -- Choose accent color

--- setup({ background = '#11262d', foreground = '#c0c8cc', accent = 'bg' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', accent = 'red' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', accent = 'yellow' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', accent = 'cyan' })

--- setup({ background = '#11262d', foreground = '#c0c8cc', accent = 'blue' })

MiniHues.config = {

-- **Required** base colors as '#rrggbb' hex strings

background = nil,

foreground = nil,

-- Number of hues used for non-base colors

n_hues = 8,

-- Saturation level. One of 'low', 'medium', 'high'.

saturation = 'medium',

-- Accent color. One of: 'bg', 'fg', 'red', 'orange', 'yellow', 'green',

-- 'cyan', 'azure', 'blue', 'purple'

accent = 'bg',

-- Plugin integrations. Use `default = false` to disable all integrations.

-- Also can be set per plugin (see |MiniHues.config|).

plugins = { default = true },

}

--minidoc_afterlines_end

--- Make palette

---

--- General idea of palette generation is that it is mostly based on color channel

--- information extracted from base colors (background and foreground).

---

--- All operations are done inside `Oklch` color space, meaning that each color

--- is defined by three numbers:

--- - Lightness (`l`) - number between 0 (black) and 100 (white) describing how

--- light is a color.

--- - Chroma (`c`) - positive number describing how colorful is a color (bigger

--- values - more colorful; 0 is gray).

--- - Hue (`h`) - periodic number in [0, 360) describing a value of "true color"

--- on color circle/wheel.

---

--- For more details about `Oklch` see |MiniColors-color-spaces| or

--- https://bottosson.github.io/posts/oklab/.

---

--- Algorithm overview ~

---

--- - Extract lightness, chroma, and hue of base colors.

---

--- - Generate reference lightness values:

--- - Background edge: 0 or 100, whichever is closest to background lightness.

--- - Foreground edge: 0 or 100, different from background edge.

--- - Middle: arithmetic mean of background and foreground lightness values.

---

--- - Compute background and foreground tints and shades by changing lightness

--- of background color: two colors closer to background lightness edge and

--- two closer to middle.

---

--- - Pick chroma value for non-base colors based on `config.saturation`.

---

--- - Generate hues for non-base colors:

--- - Fit an equidistant circular grid with `config.n_hues` points to be as

--- far from both background and foreground hues. This will ensure that

--- non-base colors are as different as possible from base ones (for

--- better visual perception).

--- Example: for background hue 0, foreground hue 180, and `config.n_hues` 2

--- the output grid will be `{ 90, 270 }`.

---

--- - For each hue of reference color (which itself is an equidistant grid

--- of 8 hues) compute the closest value from the grid. This allows

--- operating in same terms (like "red", "green") despite maybe actually

--- having less different hues.

---

--- - Compute for each hue two variants of non-base colors: with background and

--- foreground lightness values.

---

--- - Compute two variants of accent color (with background and foreground

--- lightness) based on `config.accent`.

---

--- Notes:

--- - Some output colors can have not exact values of generated Oklch channels.

--- This is due to actually computed colors being impossible to represent via

--- '#rrggbb' hex string. In this case a process called gamut clipping is done

--- to reduce lightness and chroma in optimal way while maintaining same hue.

--- For more information see |MiniColors-gamut-clip|.

---

--- - Not all colors are actually used in highlight groups and are present for the

--- sake of completeness.

---

---@param config table Configuration for palette. Same structure as |MiniHues.config|.

--- Needs to have <background> and <foreground> fields.

---

---@return table Palette with the following fields:

--- - <bg> and <fg> with supplied `background` and `foreground` colors.

--- - Fields like <bg_*> and <fg_*> are essentially <bg> and <fg> but with

--- different lightness values: `_edge`/`_edge2` - closer to edge lightness,

--- `_mid`/`_mid2` - closer to middle lightness.

--- - Fields for non-base colors (<red>, <orange>, <yellow>, <green>, <cyan>,

--- <azure>, <blue>, <purple>) have the same lightness as foreground.

--- - Fields for non-base colors with <_bg> suffix have the same lightness as

--- background.

--- - <accent> and <accent_bg> represent accent colors with foreground and

--- background lightness values.

MiniHues.make_palette = function(config)

config = vim.tbl_deep_extend('force', MiniHues.config, config or {})

local bg = H.validate_hex(config.background, 'background')

local fg = H.validate_hex(config.foreground, 'foreground')

local n_hues = H.validate_n_hues(config.n_hues)

local saturation = H.validate_one_of(config.saturation, H.saturation_values, 'saturation')

local accent = H.validate_one_of(config.accent, H.accent_values, 'accent')

local bg_lch, fg_lch = H.hex2oklch(bg), H.hex2oklch(fg)

local bg_l, fg_l = bg_lch.l, fg_lch.l

if not ((bg_l <= 50 and 50 < fg_l) or (fg_l <= 50 and 50 < bg_l)) then

H.error('`background` and `foreground` should have opposite lightness.')

end

-- Reference lightness levels

local is_dark = bg_l <= 50

local l_bg_edge = is_dark and 0 or 100

local l_fg_edge = is_dark and 100 or 0

local l_mid = 0.5 * (bg_l + fg_l)

-- Configurable chroma level

local chroma = ({ low = 4, medium = 8, high = 16 })[saturation]

-- Hues

local hues = H.make_hues(bg_lch.h, fg_lch.h, n_hues)

-- Compute result

--stylua: ignore

local res = {

-- `_edge`/`_mid` are third of the way towards reference (edge/middle)

-- `_edge2`/`_mid2` are two thirds

bg_edge2 = H.oklch2hex({ l = 0.33 * bg_l + 0.67 * l_bg_edge, c = bg_lch.c, h = bg_lch.h }),

bg_edge = H.oklch2hex({ l = 0.67 * bg_l + 0.33 * l_bg_edge, c = bg_lch.c, h = bg_lch.h }),

bg = bg,

bg_mid = H.oklch2hex({ l = 0.67 * bg_l + 0.33 * l_mid, c = bg_lch.c, h = bg_lch.h }),

bg_mid2 = H.oklch2hex({ l = 0.33 * bg_l + 0.67 * l_mid, c = bg_lch.c, h = bg_lch.h }),

fg_edge2 = H.oklch2hex({ l = 0.33 * fg_l + 0.67 * l_fg_edge, c = fg_lch.c, h = fg_lch.h }),

fg_edge = H.oklch2hex({ l = 0.67 * fg_l + 0.33 * l_fg_edge, c = fg_lch.c, h = fg_lch.h }),

fg = fg,

fg_mid = H.oklch2hex({ l = 0.67 * fg_l + 0.33 * l_mid, c = fg_lch.c, h = fg_lch.h }),

fg_mid2 = H.oklch2hex({ l = 0.33 * fg_l + 0.67 * l_mid, c = fg_lch.c, h = fg_lch.h }),

red = H.oklch2hex({ l = fg_l, c = chroma, h = hues.red }),

red_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.red }),

orange = H.oklch2hex({ l = fg_l, c = chroma, h = hues.orange }),

orange_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.orange }),

yellow = H.oklch2hex({ l = fg_l, c = chroma, h = hues.yellow }),

yellow_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.yellow }),

green = H.oklch2hex({ l = fg_l, c = chroma, h = hues.green }),

green_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.green }),

cyan = H.oklch2hex({ l = fg_l, c = chroma, h = hues.cyan }),

cyan_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.cyan }),

azure = H.oklch2hex({ l = fg_l, c = chroma, h = hues.azure }),

azure_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.azure }),

blue = H.oklch2hex({ l = fg_l, c = chroma, h = hues.blue }),

blue_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.blue }),

purple = H.oklch2hex({ l = fg_l, c = chroma, h = hues.purple }),

purple_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues.purple }),

}

-- Manage 'bg' and 'fg' accents separately to ensure that corresponding

-- background and foreground colors match exactly

--stylua: ignore

if accent == 'bg' then

res.accent = H.oklch2hex({ l = fg_l, c = chroma, h = bg_lch.h })

res.accent_bg = bg

elseif accent == 'fg' then

res.accent = fg

res.accent_bg = H.oklch2hex({ l = bg_l, c = chroma, h = fg_lch.h })

else

res.accent = H.oklch2hex({ l = fg_l, c = chroma, h = hues[accent] })

res.accent_bg = H.oklch2hex({ l = bg_l, c = chroma, h = hues[accent] })

end

return res

end

--- Generate random base colors

---

--- Compute background and foreground colors based on randomly generated hue

--- and heuristally picked lightness-chroma values.

---

--- You can recreate a similar functionality but tweaked to your taste

--- using |mini.colors|: >

---

--- local convert = require('mini.colors').convert

--- local hue = math.random(0, 359)

--- return {

--- background = convert({ l = 15, c = 3, h = hue }, 'hex'),

--- foreground = convert({ l = 80, c = 1, h = hue }, 'hex'),

--- }

---

--- Notes:

--- - Respects 'background' (uses different lightness and chroma values for

--- "dark" and "light" backgrounds).

---

--- - When used during startup, might require usage of `math.randomseed()` for

--- proper random generation. For example: >

---

--- local hues = require('mini.hues')

--- math.randomseed(vim.loop.hrtime())

--- hues.setup(hues.gen_random_base_colors())

---

---@param opts table|nil Options. Possible values:

--- - <gen_hue> `(function)` - callable which will return single number for

--- output hue. Can be used to limit which hues will be generated.

--- Default: random integer between 0 and 359.

---

---@return table Table with <background> and <foreground> fields containing

--- color hex strings.

MiniHues.gen_random_base_colors = function(opts)

opts = opts or {}

local gen_hue = opts.gen_hue or function() return math.random(0, 359) end

if not vim.is_callable(gen_hue) then H.error('`gen_hue` should be callable.') end

local is_dark = vim.o.background == 'dark'

local bg_l = is_dark and 15 or 90

local fg_l = is_dark and 80 or 20

local bg_c = is_dark and 3 or 1

local hue = gen_hue() % 360

--stylua: ignore

return {

background = H.oklch2hex({ l = bg_l, c = bg_c, h = hue }),

foreground = H.oklch2hex({ l = fg_l, c = 1, h = hue }),

}

end

-- Helper data ================================================================

-- Module default config

H.default_config = vim.deepcopy(MiniHues.config)

-- Color conversion constants

H.tau = 2 * math.pi

H.saturation_values = { 'low', 'medium', 'high' }

H.accent_values = { 'bg', 'fg', 'red', 'orange', 'yellow', 'green', 'cyan', 'azure', 'blue', 'purple' }

-- Cusps for Oklch color space. See 'mini.colors' for more details.

--stylua: ignore start

---@diagnostic disable

---@private

H.cusps = {

[0] = {26.23,64.74},

{26.14,64.65},{26.06,64.56},{25.98,64.48},{25.91,64.39},{25.82,64.29},{25.76,64.21},{25.70,64.13},{25.65,64.06},

{25.59,63.97},{25.55,63.90},{25.52,63.83},{25.48,63.77},{25.45,63.69},{25.43,63.63},{25.41,63.55},{25.40,63.50},

{25.39,63.43},{25.40,63.33},{25.40,63.27},{25.42,63.22},{25.44,63.15},{25.46,63.11},{25.50,63.05},{25.53,63.00},

{25.58,62.95},{25.63,62.90},{25.69,62.85},{25.75,62.81},{25.77,62.80},{25.34,63.25},{24.84,63.79},{24.37,64.32},

{23.92,64.83},{23.48,65.35},{23.08,65.85},{22.65,66.38},{22.28,66.86},{21.98,67.27},{21.67,67.70},{21.36,68.14},

{21.05,68.60},{20.74,69.08},{20.50,69.45},{20.27,69.83},{20.04,70.22},{19.82,70.62},{19.60,71.03},{19.38,71.44},

{19.17,71.87},{19.03,72.16},{18.83,72.59},{18.71,72.89},{18.52,73.34},{18.40,73.64},{18.28,73.95},{18.17,74.26},

{18.01,74.74},{17.91,75.05},{17.82,75.38},{17.72,75.70},{17.64,76.03},{17.56,76.36},{17.48,76.69},{17.41,77.03},

{17.35,77.36},{17.29,77.71},{17.24,78.05},{17.19,78.39},{17.15,78.74},{17.12,79.09},{17.09,79.45},{17.07,79.80},

{17.05,80.16},{17.04,80.52},{17.04,81.06},{17.04,81.42},{17.05,81.79},{17.07,82.16},{17.08,82.53},{17.11,82.72},

{17.14,83.09},{17.18,83.46},{17.22,83.84},{17.27,84.22},{17.33,84.60},{17.39,84.98},{17.48,85.56},{17.56,85.94},

{17.64,86.33},{17.73,86.72},{17.81,87.10},{17.91,87.50},{18.04,88.09},{18.16,88.48},{18.27,88.88},{18.40,89.48},

{18.57,89.87},{18.69,90.27},{18.88,90.87},{19.03,91.48},{19.22,91.88},{19.44,92.49},{19.66,93.10},{19.85,93.71},

{20.04,94.33},{20.33,94.94},{20.60,95.56},{20.85,96.18},{21.10,96.80},{21.19,96.48},{21.27,96.24},{21.38,95.93},

{21.47,95.70},{21.59,95.40},{21.72,95.10},{21.86,94.80},{21.97,94.58},{22.12,94.30},{22.27,94.02},{22.43,93.74},

{22.64,93.40},{22.81,93.14},{23.04,92.81},{23.22,92.56},{23.45,92.25},{23.68,91.95},{23.92,91.65},{24.21,91.31},

{24.45,91.04},{24.74,90.72},{25.08,90.36},{25.37,90.07},{25.70,89.74},{26.08,89.39},{26.44,89.07},{26.87,88.69},

{27.27,88.34},{27.72,87.98},{28.19,87.61},{28.68,87.23},{29.21,86.84},{29.48,86.64},{28.99,86.70},{28.13,86.81},

{27.28,86.92},{26.56,87.02},{25.83,87.12},{25.18,87.22},{24.57,87.32},{24.01,87.41},{23.53,87.49},{23.03,87.58},

{22.53,87.68},{22.10,87.76},{21.68,87.84},{21.26,87.93},{20.92,88.01},{20.58,88.08},{20.25,88.16},{19.92,88.24},

{19.59,88.33},{19.35,88.39},{19.12,88.46},{18.81,88.55},{18.58,88.61},{18.36,88.68},{18.14,88.76},{17.93,88.83},

{17.79,88.88},{17.59,88.95},{17.39,89.03},{17.26,89.08},{17.08,89.16},{16.96,89.21},{16.79,89.29},{16.68,89.35},

{16.58,89.41},{16.43,89.49},{16.33,89.55},{16.24,89.60},{16.16,89.66},{16.04,89.75},{15.96,89.81},{15.89,89.87},

{15.83,89.93},{15.77,89.99},{15.71,90.05},{15.66,90.12},{15.61,90.18},{15.57,90.24},{15.54,90.31},{15.51,90.37},

{15.48,90.44},{15.46,90.51},{15.40,90.30},{15.30,89.83},{15.21,89.36},{15.12,88.89},{15.03,88.67},{14.99,88.18},

{14.92,87.71},{14.85,87.24},{14.78,86.77},{14.75,86.53},{14.70,86.06},{14.65,85.59},{14.61,85.12},{14.60,84.89},

{14.57,84.42},{14.54,83.94},{14.53,83.71},{14.52,83.24},{14.51,82.77},{14.52,82.30},{14.52,81.83},{14.53,81.60},

{14.55,81.13},{14.58,80.66},{14.59,80.43},{14.63,79.96},{14.68,79.49},{14.70,79.26},{14.76,78.79},{14.82,78.32},

{14.85,78.09},{14.93,77.62},{15.01,77.16},{15.10,76.69},{15.19,76.23},{15.24,76.00},{15.34,75.54},{15.45,75.07},

{15.57,74.61},{15.69,74.15},{15.82,73.69},{15.96,73.23},{16.10,72.77},{16.24,72.31},{16.39,71.86},{16.55,71.40},

{16.71,70.95},{16.96,70.26},{17.14,69.81},{17.32,69.36},{17.59,68.69},{17.88,68.02},{18.07,67.57},{18.37,66.90},

{18.67,66.24},{18.99,65.58},{19.30,64.93},{19.74,64.06},{20.07,63.42},{20.51,62.57},{20.97,61.73},{21.54,60.69},

{22.00,59.87},{22.70,58.66},{23.39,57.49},{24.19,56.16},{25.20,54.52},{26.38,52.66},{28.55,49.32},{31.32,45.20},

{31.15,45.42},{30.99,45.64},{30.85,45.85},{30.72,46.06},{30.57,46.31},{30.47,46.50},{30.34,46.75},{30.23,46.97},

{30.13,47.20},{30.03,47.45},{29.93,47.71},{29.86,47.91},{29.77,48.20},{29.71,48.43},{29.65,48.66},{29.58,48.98},

{29.53,49.23},{29.48,49.48},{29.44,49.74},{29.41,50.01},{29.37,50.29},{29.35,50.57},{29.33,50.86},{29.31,51.16},

{29.30,51.56},{29.29,51.87},{29.29,52.39},{29.30,52.72},{29.31,53.05},{29.33,53.38},{29.35,53.72},{29.37,54.06},

{29.40,54.41},{29.43,54.76},{29.47,55.12},{29.52,55.60},{29.56,55.97},{29.61,56.34},{29.66,56.72},{29.73,57.22},

{29.79,57.61},{29.84,57.99},{29.93,58.52},{29.99,58.91},{30.08,59.44},{30.15,59.84},{30.24,60.38},{30.34,60.93},

{30.42,61.34},{30.52,61.90},{30.63,62.45},{30.73,63.02},{30.85,63.58},{30.96,64.15},{31.08,64.72},{31.19,65.30},

{31.31,65.88},{31.44,66.46},{31.59,67.20},{31.72,67.79},{31.88,68.53},{32.01,69.12},{32.18,69.87},{32.25,70.17},

{32.06,69.99},{31.76,69.70},{31.45,69.42},{31.21,69.20},{30.97,68.98},{30.68,68.71},{30.44,68.50},{30.21,68.29},

{29.98,68.09},{29.75,67.89},{29.53,67.69},{29.31,67.50},{29.09,67.31},{28.88,67.12},{28.72,66.98},{28.52,66.80},

{28.31,66.63},{28.16,66.50},{27.97,66.33},{27.78,66.17},{27.64,66.05},{27.49,65.94},{27.33,65.77},{27.20,65.66},

{27.04,65.51},{26.92,65.40},{26.81,65.30},{26.66,65.16},{26.55,65.06},{26.45,64.96},{26.35,64.87},

}

--stylua: ignore end

-- Helper functionality =======================================================

-- Settings -------------------------------------------------------------------

H.setup_config = function(config)

-- General idea: if some table elements are not present in user-supplied

-- `config`, take them from default config

vim.validate({ config = { config, 'table', true } })

config = vim.tbl_deep_extend('force', vim.deepcopy(H.default_config), config or {})

if config.background == nil or config.foreground == nil then

H.error('`setup()` needs both `background` and `foreground`.')

end

vim.validate({

background = { config.background, H.is_hex },

foreground = { config.foreground, H.is_hex },

n_hues = { config.n_hues, H.is_n_hues },

saturation = { config.saturation, H.is_saturation },

accent = { config.accent, H.is_accent },

plugins = { config.plugins, 'table' },

})

return config

end

H.apply_config = function(config)

MiniHues.config = config

H.apply_colorscheme(config)

end

H.is_hex = function(x)

local res = type(x) == 'string' and x:find('^#%x%x%x%x%x%x$') ~= nil

if res then return true, nil end

return false, 'Color string in the form "#rrggbb"'

end

H.is_n_hues = function(x)

local res = type(x) == 'number' and 0 <= x and x <= 8

if res then return true, nil end

return false, 'Number between 0 and 8'

end

H.is_saturation = function(x)

local res = vim.tbl_contains(H.saturation_values, x)

if res then return true, nil end

return false, 'One of ' .. table.concat(vim.tbl_map(vim.inspect, H.saturation_values), ', ')

end

H.is_accent = function(x)

local res = vim.tbl_contains(H.accent_values, x)

if res then return true, nil end

return false, 'One of ' .. table.concat(vim.tbl_map(vim.inspect, H.accent_values), ', ')

end

-- Palette --------------------------------------------------------------------

H.make_hues = function(bg_h, fg_h, n_hues)

local res = { bg = bg_h, fg = fg_h }

if n_hues == 0 then return res end

-- Generate equidistant circular grid of hues which is the most distant from

-- background and foreground hues. Distance between two sets is assumed as

-- minimum distance between all pairs of points.

local period = 360 / n_hues

local half_period = 0.5 * period

-- - Compute delta which determines the furthest grid

local d

if bg_h == nil and fg_h == nil then d = 0 end

if bg_h ~= nil and fg_h == nil then d = (bg_h % period + half_period) % period end

if bg_h == nil and fg_h ~= nil then d = (fg_h % period + half_period) % period end

if bg_h ~= nil and fg_h ~= nil then

local ref_bg, ref_fg = bg_h % period, fg_h % period

local mid = 0.5 * (ref_bg + ref_fg)

local mid_alt = (mid + half_period) % period

d = H.dist_period(mid, ref_bg, period) < H.dist_period(mid_alt, ref_bg, period) and mid_alt or mid

end

local grid = {}

for i = 0, n_hues - 1 do

table.insert(grid, i * period + d)

end

-- Normalize equidistant grid to be base 8 colors

local dist_fun = function(x, y) return H.dist_period(x, y, 360) end

local approx = function(ref_hue) return H.get_closest(ref_hue, grid, dist_fun) end

--stylua: ignore start

res.red = approx(0)

res.orange = approx(45)

res.yellow = approx(90)

res.green = approx(135)

res.cyan = approx(180)

res.azure = approx(225)

res.blue = approx(270)

res.purple = approx(315)

--stylua: ignore end

return res

end

H.validate_hex = function(x, name)

if H.is_hex(x) then return x end

local msg = string.format('`%s` should be hex color string in the form "#rrggbb", not %s.', name, vim.inspect(x))

H.error(msg)

end

H.validate_n_hues = function(x)

if H.is_n_hues(x) then return x end

local msg = string.format('`n_hues` should be a number between 0 and 8', name)

H.error(msg)

end

H.validate_one_of = function(x, choices, name)

if vim.tbl_contains(choices, x) then return x end

local choices_string = table.concat(vim.tbl_map(vim.inspect, choices), ', ')

local msg = string.format('`%s` should be one of ', name, choices_string)

H.error(msg)

end

-- Highlighting ---------------------------------------------------------------

---@diagnostic disable

---@private

-- stylua: ignore

H.apply_colorscheme = function(config)

-- Prepare highlighting application. Notes:

-- - Clear current highlight only if other theme was loaded previously.

-- - No need to `syntax reset` because *all* syntax groups are defined later.

if vim.g.colors_name then vim.cmd('highlight clear') end

-- As this doesn't create colorscheme, don't store any name. Not doing it

-- might cause some issues with `syntax on`.

vim.g.colors_name = nil

local p = MiniHues.make_palette(config)

local hi = function(name, data) vim.api.nvim_set_hl(0, name, data) end

local has_integration = function(name)

local entry = config.plugins[name]

if entry == nil then return config.plugins.default end

return entry

end

-- NOTE: recommendations for adding new highlight groups:

-- - Put all related groups (like for new plugin) in single paragraph.

-- - Sort within group alphabetically (by hl-group name) ignoring case.

-- - Link all repeated groups within paragraph (lowers execution time).

-- - Align by commas.

-- Builtin highlighting groups

hi('ColorColumn', { fg=nil, bg=p.bg_mid2 })

hi('Conceal', { fg=p.azure, bg=nil })

hi('CurSearch', { fg=p.bg, bg=p.yellow })

hi('Cursor', { fg=p.bg, bg=p.fg })

hi('CursorColumn', { fg=nil, bg=p.bg_mid })

hi('CursorIM', { link='Cursor' })

hi('CursorLine', { fg=nil, bg=p.bg_mid })

hi('CursorLineFold', { fg=p.bg_mid2, bg=nil })

hi('CursorLineNr', { fg=p.accent, bg=nil, bold=true })

hi('CursorLineSign', { fg=p.bg_mid2, bg=nil })

hi('DiffAdd', { fg=nil, bg=p.green_bg })

hi('DiffChange', { fg=nil, bg=p.cyan_bg })

hi('DiffDelete', { fg=nil, bg=p.red_bg })

hi('DiffText', { fg=nil, bg=p.yellow_bg })

hi('Directory', { fg=p.azure, bg=nil })

hi('EndOfBuffer', { fg=p.bg_mid2, bg=nil })

hi('ErrorMsg', { fg=p.red, bg=nil })

hi('FloatBorder', { fg=p.accent, bg=p.bg_edge })

hi('FloatTitle', { fg=p.accent, bg=p.bg_edge, bold = true })

hi('FoldColumn', { fg=p.bg_mid2, bg=nil })

hi('Folded', { fg=p.fg_mid2, bg=p.bg_edge })

hi('IncSearch', { fg=p.bg, bg=p.yellow })

hi('lCursor', { fg=p.bg, bg=p.fg })

hi('LineNr', { fg=p.bg_mid2, bg=nil })

hi('LineNrAbove', { link='LineNr' })

hi('LineNrBelow', { link='LineNr' })

hi('MatchParen', { fg=nil, bg=p.bg_mid2, bold=true })

hi('ModeMsg', { fg=p.green, bg=nil })

hi('MoreMsg', { fg=p.azure, bg=nil })

hi('MsgArea', { link='Normal' })

hi('MsgSeparator', { fg=p.fg_mid2, bg=p.bg_mid2 })

hi('NonText', { fg=p.bg_mid2, bg=nil })

hi('Normal', { fg=p.fg, bg=p.bg })

hi('NormalFloat', { fg=p.fg, bg=p.bg_edge })

hi('NormalNC', { link='Normal' })

hi('PMenu', { fg=p.fg, bg=p.bg_mid })

hi('PMenuExtra', { link='PMenu' })

hi('PMenuExtraSel', { link='PMenuSel' })

hi('PMenuKind', { link='PMenu' })

hi('PMenuKindSel', { link='PMenuSel' })

hi('PMenuSbar', { link='PMenu' })

hi('PMenuSel', { fg=p.bg, bg=p.fg, blend=0 })

hi('PMenuThumb', { fg=nil, bg=p.bg_mid2 })

hi('Question', { fg=p.azure, bg=nil })

hi('QuickFixLine', { fg=nil, bg=nil, bold=true })

hi('Search', { fg=p.bg, bg=p.accent })

hi('SignColumn', { fg=p.bg_mid2, bg=nil })

hi('SpecialKey', { fg=p.bg_mid2, bg=nil })

hi('SpellBad', { fg=nil, bg=nil, sp=p.red, undercurl=true })

hi('SpellCap', { fg=nil, bg=nil, sp=p.cyan, undercurl=true })

hi('SpellLocal', { fg=nil, bg=nil, sp=p.yellow, undercurl=true })

hi('SpellRare', { fg=nil, bg=nil, sp=p.blue, undercurl=true })

hi('StatusLine', { fg=p.fg_mid, bg=p.accent_bg })

hi('StatusLineNC', { fg=p.fg_mid, bg=p.bg_edge })

hi('Substitute', { fg=p.bg, bg=p.blue })

hi('TabLine', { fg=p.fg_mid, bg=p.bg_edge })

hi('TabLineFill', { link='Tabline' })

hi('TabLineSel', { fg=p.accent, bg=p.bg_edge })

hi('TermCursor', { fg=nil, bg=nil, reverse=true })

hi('TermCursorNC', { fg=nil, bg=nil, reverse=true })

hi('Title', { fg=p.accent, bg=nil })

hi('VertSplit', { fg=p.accent, bg=nil })

hi('Visual', { fg=nil, bg=p.bg_mid2 })

hi('VisualNOS', { fg=nil, bg=p.bg_mid })

hi('WarningMsg', { fg=p.yellow, bg=nil })

hi('Whitespace', { fg=p.bg_mid2, bg=nil })

hi('WildMenu', { link='PMenuSel' })

hi('WinBar', { link='StatusLine' })

hi('WinBarNC', { link='StatusLineNC' })

hi('WinSeparator', { fg=p.accent, bg=nil })

-- Standard syntax (affects treesitter)

hi('Boolean', { link='Constant' })

hi('Character', { link='Constant' })

hi('Comment', { fg=p.fg_mid2, bg=nil })

hi('Conditional', { link='Statement' })

hi('Constant', { fg=p.purple, bg=nil })

hi('Debug', { link='Special' })

hi('Define', { link='PreProc' })

hi('Delimiter', { fg=p.orange, bg=nil })

hi('Error', { fg=nil, bg=p.red_bg })

hi('Exception', { link='Statement' })

hi('Float', { link='Constant' })

hi('Function', { fg=p.azure, bg=nil })

hi('Identifier', { fg=p.yellow, bg=nil })

hi('Ignore', { fg=nil, bg=nil })

hi('Include', { link='PreProc' })

hi('Keyword', { link='Statement' })

hi('Label', { link='Statement' })

hi('Macro', { link='PreProc' })

hi('Number', { link='Constant' })

hi('Operator', { fg=p.fg, bg=nil })

hi('PreCondit', { link='PreProc' })

hi('PreProc', { fg=p.blue, bg=nil })

hi('Repeat', { link='Statement' })

hi('Special', { fg=p.cyan, bg=nil })

hi('SpecialChar', { link='Special' })

hi('SpecialComment', { link='Special' })

hi('Statement', { fg=p.fg, bg=nil, bold=true })

hi('StorageClass', { link='Type' })

hi('String', { fg=p.green, bg=nil })

hi('Structure', { link='Type' })

hi('Tag', { link='Special' })

hi('Todo', { fg=p.accent, bg=p.accent_bg, bold=true })

hi('Type', { fg=p.fg, bg=nil })

hi('Typedef', { link='Type' })

-- Other community standard

hi('Bold', { fg=nil, bg=nil, bold=true })

hi('Italic', { fg=nil, bg=nil, italic=true })

hi('Underlined', { fg=nil, bg=nil, underline=true })

-- Patch diff

hi('diffAdded', { fg=p.green, bg=nil })

hi('diffChanged', { fg=p.cyan, bg=nil })

hi('diffFile', { fg=p.yellow, bg=nil })

hi('diffLine', { fg=p.blue, bg=nil })

hi('diffRemoved', { fg=p.red, bg=nil })

hi('Added', { fg=p.green, bg=nil })

hi('Changed', { fg=p.cyan, bg=nil })

hi('Removed', { fg=p.red, bg=nil })

-- Git commit

hi('gitcommitBranch', { fg=p.orange, bg=nil, bold=true })

hi('gitcommitComment', { link='Comment' })

hi('gitcommitDiscarded', { link='Comment' })

hi('gitcommitDiscardedFile', { fg=p.yellow, bg=nil, bold=true })

hi('gitcommitDiscardedType', { fg=p.azure, bg=nil })

hi('gitcommitHeader', { link='Title' })

hi('gitcommitOverflow', { fg=p.yellow, bg=nil })

hi('gitcommitSelected', { link='Comment' })

hi('gitcommitSelectedFile', { fg=p.green, bg=nil, bold=true })

hi('gitcommitSelectedType', { link='gitcommitDiscardedType' })

hi('gitcommitSummary', { fg=p.green, bg=nil })

hi('gitcommitUnmergedFile', { link='gitcommitDiscardedFile' })

hi('gitcommitUnmergedType', { link='gitcommitDiscardedType' })

hi('gitcommitUntracked', { link='Comment' })

hi('gitcommitUntrackedFile', { fg=p.cyan, bg=nil })

-- Built-in diagnostic

-- Logic:

-- - Error is red.

-- - Distance from hue to error hue should increase the less important it is

-- (warning - info - ok - hint).

hi('DiagnosticError', { fg=p.red, bg=nil })

hi('DiagnosticHint', { fg=p.cyan, bg=nil })

hi('DiagnosticInfo', { fg=p.blue, bg=nil })

hi('DiagnosticOk', { fg=p.green, bg=nil })

hi('DiagnosticWarn', { fg=p.yellow, bg=nil })

hi('DiagnosticUnderlineError', { fg=nil, bg=nil, sp=p.red, underline=true })

hi('DiagnosticUnderlineHint', { fg=nil, bg=nil, sp=p.cyan, underline=true })

hi('DiagnosticUnderlineInfo', { fg=nil, bg=nil, sp=p.blue, underline=true })

hi('DiagnosticUnderlineOk', { fg=nil, bg=nil, sp=p.green, underline=true })

hi('DiagnosticUnderlineWarn', { fg=nil, bg=nil, sp=p.yellow, underline=true })

hi('DiagnosticFloatingError', { fg=p.red, bg=p.bg_edge })

hi('DiagnosticFloatingHint', { fg=p.cyan, bg=p.bg_edge })

hi('DiagnosticFloatingInfo', { fg=p.blue, bg=p.bg_edge })

hi('DiagnosticFloatingOk', { fg=p.green, bg=p.bg_edge })

hi('DiagnosticFloatingWarn', { fg=p.yellow, bg=p.bg_edge })

hi('DiagnosticVirtualTextError', { link='DiagnosticError' })

hi('DiagnosticVirtualTextWarn', { link='DiagnosticWarn' })

hi('DiagnosticVirtualTextInfo', { link='DiagnosticInfo' })

hi('DiagnosticVirtualTextHint', { link='DiagnosticHint' })

hi('DiagnosticVirtualTextOk', { link='DiagnosticOk' })

hi('DiagnosticSignError', { link='DiagnosticError' })

hi('DiagnosticSignWarn', { link='DiagnosticWarn' })

hi('DiagnosticSignInfo', { link='DiagnosticInfo' })

hi('DiagnosticSignHint', { link='DiagnosticHint' })

hi('DiagnosticSignOk', { link='DiagnosticOk' })

hi('DiagnosticDeprecated', { fg=nil, bg=nil, sp=p.red, strikethrough=true })

hi('DiagnosticUnnecessary', { link='Comment' })

-- Built-in LSP

hi('LspReferenceText', { fg=nil, bg=p.bg_mid2 })

hi('LspReferenceRead', { link='LspReferenceText' })

hi('LspReferenceWrite', { link='LspReferenceText' })

hi('LspSignatureActiveParameter', { link='LspReferenceText' })

hi('LspCodeLens', { link='Comment' })

hi('LspCodeLensSeparator', { link='Comment' })

-- Tree-sitter

-- Sources:

-- - `:h treesitter-highlight-groups`

-- - https://github.com/nvim-treesitter/nvim-treesitter/blob/master/CONTRIBUTING.md#highlights

hi('@text.literal', { link='Special' })

hi('@text.reference', { link='Identifier' })

hi('@text.title', { link='Title' })

hi('@text.uri', { link='Underlined' })

hi('@text.todo', { link='Todo' })

hi('@text.note', { link='MoreMsg' })

hi('@text.warning', { link='WarningMsg' })

hi('@text.danger', { link='ErrorMsg' })

hi('@text.strong', { fg=nil, bg=nil, bold=true })

hi('@text.emphasis', { fg=nil, bg=nil, italic=true })

hi('@text.strike', { fg=nil, bg=nil, strikethrough=true })

hi('@text.underline', { link='Underlined' })

hi('@comment', { link='Comment' })

hi('@punctuation', { link='Delimiter' })

hi('@constant', { link='Constant' })

hi('@constant.builtin', { link='Special' })

hi('@constant.macro', { link='Macro' })

hi('@define', { link='Define' })

hi('@macro', { link='Macro' })

hi('@string', { link='String' })

hi('@string.escape', { link='SpecialChar' })

hi('@string.special', { link='SpecialChar' })

hi('@character', { link='Character' })

hi('@character.special', { link='SpecialChar' })

hi('@number', { link='Number' })

hi('@boolean', { link='Boolean' })

hi('@float', { link='Float' })

hi('@function', { link='Function' })

hi('@function.builtin', { link='Special' })

hi('@function.call', { link='Function' })

hi('@function.macro', { link='Macro' })

hi('@parameter', { fg=p.blue, bg=nil })

hi('@method', { link='Function' })

hi('@method.call', { link='Function' })

hi('@field', { link='Identifier' })

hi('@property', { link='Identifier' })

hi('@constructor', { link='Special' })

hi('@conditional', { link='Conditional' })

hi('@repeat', { link='Repeat' })

hi('@label', { link='Label' })

hi('@operator', { link='Operator' })

hi('@keyword', { link='Keyword' })

hi('@keyword.return', { fg=p.orange, bg=nil, bold=true })

hi('@exception', { link='Exception' })

hi('@variable', { fg=p.fg, bg=nil })

hi('@variable.builtin', { link='Special' })

hi('@type', { link='Type' })

hi('@type.builtin', { link='Special' })

hi('@type.definition', { link='Typedef' })

hi('@storageclass', { link='StorageClass' })

hi('@structure', { link='Structure' })

hi('@namespace', { link='Identifier' })

hi('@include', { link='Include' })

hi('@preproc', { link='PreProc' })

hi('@debug', { link='Debug' })

hi('@tag', { link='Tag' })

hi('@symbol', { link='Keyword' })

hi('@none', { link='Normal'})

-- Semantic tokens

if vim.fn.has('nvim-0.9') == 1 then

-- Source: `:h lsp-semantic-highlight`

hi('@lsp.type.class', { link='@structure' })

hi('@lsp.type.decorator', { link='@function' })

hi('@lsp.type.enum', { link='@type' })

hi('@lsp.type.enumMember', { link='@constant' })

hi('@lsp.type.function', { link='@function' })

hi('@lsp.type.interface', { link='@type' })

hi('@lsp.type.macro', { link='@macro' })

hi('@lsp.type.method', { link='@method' })

hi('@lsp.type.namespace', { link='@namespace' })

hi('@lsp.type.parameter', { link='@parameter' })

hi('@lsp.type.property', { link='@property' })

hi('@lsp.type.struct', { link='@structure' })

hi('@lsp.type.type', { link='@type' })

hi('@lsp.type.typeParameter', { link='@type.definition' })

hi('@lsp.type.variable', { link='@variable' })

hi('@lsp.mod.defaultLibrary', { link='Special' })

hi('@lsp.mod.deprecated', { fg=p.red, bg=nil })

end

-- New tree-sitter groups

if vim.fn.has('nvim-0.9') == 1 then

-- Sources:

-- - `:h treesitter-highlight-groups`

-- - https://github.com/nvim-treesitter/nvim-treesitter/commit/1ae9b0e4558fe7868f8cda2db65239cfb14836d0

-- NOTE: commented groups are the same as in Neovim<0.10 defined earlier

-- @variable

-- @variable.builtin

hi('@variable.parameter', { link='@parameter' })

hi('@variable.member', { link='@field' })

-- @constant

-- @constant.builtin

-- @constant.macro

hi('@module', { link='@namespace' })

hi('@module.builtin', { link='@variable.builtin' })

-- @label

-- @string

hi('@string.documentation', { link='@string' })

hi('@string.regexp', { link='SpecialChar' })

-- @string.escape

-- @string.special

hi('@string.special.symbol', { link='@constant' })

hi('@string.special.path', { link='Directory' })

hi('@string.special.url', { link='@markup.link.url' })

-- @character

-- @character.special

-- @boolean

-- @number

hi('@number.float', { link='@float' })

-- @type

-- @type.builtin

-- @type.definition

hi('@type.qualifier', { link='StorageClass' })

hi('@attribute', { link='Macro' })

-- @property

-- @function

-- @function.builtin

-- @function.call

-- @function.macro

hi('@function.method', { link='@method' })

hi('@function.method.call', { link='@method.call' })

-- @constructor

-- @operator

-- @keyword

hi('@keyword.coroutine', { link='@keyword' })

hi('@keyword.function', { link='@keyword' })

hi('@keyword.operator', { link='@keyword' })

hi('@keyword.import', { fg=p.blue, bg=nil, bold=true })

hi('@keyword.storage', { fg=p.fg, bg=nil, bold=true })

hi('@keyword.repeat', { link='@keyword' })

-- @keyword.return

hi('@keyword.debug', { fg=p.cyan, bg=nil, bold=true })

hi('@keyword.exception', { link='@keyword' })