📋 Descripción del Proyecto

Kalidozza es un esquema de color artesanal para editores y terminales, nacido de una idea simple pero firme: el código que escribimos durante horas merece una paleta que cuide nuestros ojos, no que los desgaste.

La filosofía central es warm-first: la escala base y los acentos principales se inclinan hacia el espectro cálido — terracotas, ámbares, cremas, naranjas suaves — para minimizar los blancos azulados agresivos típicos de los temas "fríos". Se conserva un set pequeño de tokens fríos para mantener la diversidad sintáctica, así la estructura (keywords, strings, números, tipos) se distingue con claridad. El resultado: menos fatiga visual, mejor calidad de sueño al programar de noche, y una experiencia visual que se siente amigable en lugar de clínica.

"Code with care." — que el código se vea tan bien como se siente escribirlo.

🎯 Objetivos del Proyecto

1. Cuidar la vista: inclinar la escala base hacia el espectro cálido, lejos de los blancos azulados agresivos de los temas "fríos".
2. Verse bien en cualquier archivo: resaltar la estructura (keywords, strings, funciones, tipos) incluso sin resaltado semántico.
3. Mantenerse legible: conservar una capa de acentos fríos para que la paleta nunca se sienta plana o monotemática.
4. Ser multiplataforma: ofrecer la misma experiencia visual en múltiples editores y terminales.

🛠️ Stack Técnico

Lenguaje principal:  Lua (Neovim)
Editores:            Neovim 0.9+ · VSCode
Formato tokens:      Escala base cálida + capa de acentos fríos
Inspiración:         Atardeceres, terracota, papel envejecido
Filosofía:           Warm-first · bajo azul agresivo · amigable con el ojo
Licencia:            MIT

🎨 Paleta — Doom Kalidozza Dark

Kalidozza se organiza en tres capas — una escala base (fondos → primeros planos), un set de acentos principales y un set de complementos armónicos — y se mapea a faces de código y niveles de Org.

🟫 Escala Base (fondos y primeros planos)

🌈 Acentos Principales

🎶 Complementos Armónicos

🔖 Asignación de Faces

📑 Niveles Org / Outline

La paleta completa está definida en lua/kalidozza/palette.lua (Neovim) y themes/kalidozza-color-theme.json (VSCode).

✨ Características

• 🧡 Paleta warm-first — base terrosa, sin blancos azulados agresivos.
• 👁️ Eye Comfort First — menos fatiga, mejor sueño.
• 🎨 Handcrafted Tokens — cada color con propósito.
• 🌈 Capa de Acentos Fríos — diversidad sintáctica sin perder calidez.
• 🌗 Multi-Editor — Neovim + VSCode (más próximamente).
• 🌓 Soporte light/dark — variante clara también disponible.
• 🔌 Tree-sitter & LSP — resaltado semántico de primera.
• 🪶 Ligero — sin dependencias externas, solo Lua/JSON.

🛠️ Instalación

Neovim (con lazy.nvim)

{
  "Kalidozza-theme/neovim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd.colorscheme("kalidozza")
    -- Opcional: variante clara
    -- vim.cmd.colorscheme("kalidozza-light")
  end,
}

VSCode

code --install-extension Kalidozza-theme.vscode

O desde la paleta de comandos (Ctrl+Shift+P):

> Extensions: Install Extensions
> Kalidozza

Luego activa el tema con Preferences: Color Theme → Kalidozza.

🌗 Variantes y Roadmap

📈 Próximos Pasos

• Publicar el paquete en packer.nvim, lazy.nvim y rocks.nvim
• Lanzar las variantes de terminales (Kitty, Ghostty)
• Lanzar el tema GTK/Adwaita basado en Noctalia
• Crear página de documentación dedicada con just-the-docs
• Generador de paleta interactivo (HSL → variantes warm)
• Soporte oficial para LSP semántico adicional: lua_ls, rust, tsserver, pyright

🤝 Contribuciones

El proyecto es open source bajo licencia MIT. Pull requests, issues y sugerencias de tokens son bienvenidos en la organización Kalidozza-theme.