Skip to content

Latest commit

 

History

History
152 lines (119 loc) · 4.76 KB

README.md

File metadata and controls

152 lines (119 loc) · 4.76 KB
Raw

Eva-Theme.nvim

A semantic coloring code colorscheme for NeoVim ported from Eva-Theme

Supports both Dark and Light modes, with four styles available for each mode: Normal, Bold, Italic, and Italic Bold.

🌙 Dark

Snipaste_2024-08-14_20-20-16

☀ Light

Snipaste_2024-08-14_17-42-18

🎨 Palette

dark light semantic
$\color{#6495EE}{● \#6495EE}$ $\color{#437AED}{● \#437AED}$ function-like names
$\color{#A78CFA}{● \#A78CFA}$ $\color{#7C4DFF}{● \#7C4DFF}$ declaration keywords
$\color{#E4BF7F}{● \#E4BF7F}$ $\color{#F0AA0B}{● \#F0AA0B}$ parameter name and typeparameter
$\color{#FF6AB3}{● \#FF6AB3}$ $\color{#EF8ED8}{● \#EF8ED8}$ primitive/builtin type names
$\color{#56B7C3}{● \#56B7C3}$ $\color{#00BEC4}{● \#00BEC4}$ type names, arithmetic operators
$\color{#98C379}{● \#98C379}$ $\color{#53A053}{● \#53A053}$ string context
$\color{#B0B7C3}{● \#B0B7C3}$ $\color{#5D5D5F}{● \#5D5D5F}$ variable
$\color{#FF9070}{● \#FF9070}$ $\color{#FF6D12}{● \#FF6D12}$ numbers, constants
$\color{#CF68E1}{● \#CF68E1}$ $\color{#C838C6}{● \#C838C6}$ flow control keywords, boolean literal, null literal,keyword operators
$\color{#E06C75}{● \#E06C75}$ $\color{#CD6069}{● \#CD6069}$ object members/properties, namespaces/modules
$\color{#676E95}{● \#676E95}$ $\color{#A9A9AA}{● \#A9A9AA}$ comment
$\color{#F02B77}{● \#F02B77}$ $\color{#FA278E}{● \#FA278E}$ builtin variables like self, super, this, base

🛠 Installation

Note

For implementation downside, Eva-Theme.nvim uses file cache complation to improve loading speed. Use :EvaCompile command to compile new cache if necessary.

Lazy

{
  'sharpchen/Eva-Theme.nvim',
  lazy = false,
  priority = 1000,
  build = ':EvaCompile'
}

🎯 Usage

VimScript

colo Eva-Dark " or any other variant
" colo Eva-Light
" colo Eva-Dark-Bold
" colo Eva-Light-Bold
" colo Eva-Dark-Italic
" colo Eva-Light-Italic
" colo Eva-Dark-Italic-Bold
" colo Eva-Light-Italic-Bold

Lua

vim.cmd('colo Eva-Dark') -- or any variant

⚙ Options

Override palette

Specifiy colors for dark and light variants, specified values will be taken while the rest remains default.

Caution

All highlight groups uses certain overrided color will be affected, something unexpected might happen. To override more specificly, use override_highlight.

Tip

For palette structure, see: palette.lua Or use lazydev.nvim to get full intellisense from type annotations.

require('Eva-Theme').setup({
  override_palette = {
    dark = {
      background = '#14161B',
      git = {
        diffAdded = '#RRGGBB'
      }
    },
    light = {
      declarative = '#RRGGBB'
    }
  }
})

Override highlight

To customize any highlight group for different variants, you can put function callbacks or tables of key-value pair inside override_highlight. Palette and variant name is available for the function case.

require('Eva-Theme').setup({
  override_highlight = {
    dark = {
      ['@foo'] = { fg = '#RRGGBB', bg = '#RRGGBB' },
    },
    light = {
      ['@foo'] = { fg = '#RRGGBB', bg = '#RRGGBB' },
    },
    ['@foo'] = function(variant)
      return { fg = require('Eva-Theme.utils').is_dark(variant) and '#RRGGBB' or '#RRGGBB' }
    end,
    LspInlayHint = function(_, palette)
      return { fg = palette.comment, bg = nil }
    end
  },
})

Tip

Value returned from override_highlight will be merged with the default value. Set certain property to nil to cancel the default.

Note

Palette accessible here is the palette override by override_palette.

Ambiguity issue

This port was intented to respect the upstream where operators got different colors by their usages. While treesitter parsers generally don't classify operator into different usages, so there's no much I can do. If you find ambiguity between operator and type(pointer type T* for example), I suggest customize by yourself.

This is what I prefer:

require('Eva-Theme').setup({
  override_palette = {
    dark = {
      operator = require('Eva-Theme.palette').dark_base.punctuation,
    },
    light = {
      operator = require('Eva-Theme.palette').light_base.punctuation,
    },
  },
)

Contributing

See: CONTRIBUTING.md