* Hyperstitional Themes

Weird themes for Emacs. 

#+HTML: <img src="images/digitalsear-bauble.webp" align="center">
#+HTML: <img src="images/digitalsear-inverted-bauble.webp" align="center">

** Why?
I happen to like certain colors more than others and figured I’d just skip the painful process of selecting different colors, and instead pick two colors I like and pick colors out of a certain number of stops between them.  Make a "dim" variant, a "dark" variant and a "light" variant and you have a color palette from just two colors!

** Is it legible?
/Mostly/.  It is completely legible to me, but I don’t mind weird / bad contrast ratios.

- Digitalsear :: I did tweak the two primary colors with the  [[https://www.myndex.com/APCA/][ACPA Contrast Calculator]] to get a half-satisfactory score on most of the color stops and between the different variants.
- Rebug :: Eyeballed, but thoroughly.
  
** Motivation?

- Digitalsear :: The theme I use the most is [[https://github.com/precompute/sculpture-themes][Sculpture-themes-dark]].  The light variant is undermaintained, because I know I’ll have to modify a lot of colors and will end up maintaining two very different versions of the same theme.  The dark version is what I really set out to make.  So, I decided to make a theme that’s primarily a light theme, but can be inverted to be a dark theme.
- Rebug :: I wanted a theme that used three simple colors in generated grades.  This would make generating alternate color-schemes easier.  This allows modifying the base palette to generate a completely different theme.
  
** Themes
*** Digitalsear
Digitalsear has two versions: *Digitalsear* and *Digitalsear Inverted*.

Digitalsear works between #0000FF and #FF4000.  The background is off-white and dim enough to be gentle (for a light theme).

#+HTML: <img src="images/digitalsear-palette.png" align="center">

From top to bottom:
- Background / Foreground
- "Light" variant
- "Dim" variant
- Base variant
- "Dark" variant

Because we only have 7 distinguishable colors, many faces utilize both ~:foreground~ and ~:background~ properties to ensure distinguishability.

Distinguishability was important, because I was going to invert the theme.

*Digitalsear Inverted* uses an inverted palette.  I’ve only duplicated the primary theme, inverted all the colors and changed the name.

#+HTML: <img src="images/digitalsear-palette-inverted.png" align="center">

*** Rebug

Themes generated from a four color: R, G, B and K.  Colors are generated from a list of Alpha values.

Six themes:
- Rebug
- Rebug Flipped
- Rebug Alternate 
- Rebug Alternate Flipped
- Rebug Lawn Lush
- Rebug Lawn Sere

TODO: Description and Screenshots

*** Planned themes
- +Something forest-green+
- Something sun-yellow

** Screenshots
AKA What you’re really here for.
*** Digitalsear
[[file:images/digitalsear-ss-0.jpg]]
[[file:images/digitalsear-ss-1.jpg]]
[[file:images/digitalsear-ss-2.jpg]]
[[file:images/digitalsear-ss-3.jpg]]

*** Digitalsear Inverted
[[file:images/digitalsear-inverted-ss-0.jpg]]
[[file:images/digitalsear-inverted-ss-1.jpg]]
[[file:images/digitalsear-inverted-ss-2.jpg]]
[[file:images/digitalsear-inverted-ss-3.jpg]]

** Supported Modes

| Base faces        | Popup        | Font-lock               |
| Header line       | Mode line    | Info mode               |
| Eldoc             | Evil         | Diredfl                 |
| Dired-subtree     | Ivy          | Swiper                  |
| Rainbow-delimiter | line Numbers | Isearch, occur          |
| Xref              | Imenu-list   | outline                 |
| Markdown          | Org          | Org-agenda              |
| Org-block         | Org-checkbox | Org-level               |
| Paren             | Shr          | Git-gutter              |
| Diff-hl           | Which-key    | Company                 |
| Message           | Elfeed       | Transient               |
| Magit             | Diff         | Orderless               |
| Ediff             | Vertico      | Olivetti                |
| Flycheck          | Flymake      | Highlight-indent-guides |
| Tree-sitter       | Tabs         | Highlight-indentation   |
| Writegood         | Eglot        | Lsp-mode                |
| Rjsx              | Web-mode     | Corfu                   |
| Evil-goggles      | Vundo        | Eldoc-box               |
| Tuareg            | Merlin       | Breadcrumb              |

** Resources
If you’re trying to make your own theme, these resources might be helpful.  They were very helpful for me.

[[https://www.emacswiki.org/emacs/hexrgb.el][hexrgb.el by Drew Adams - useful color manipulation functions]]

[[https://colorkit.io/][Colorkit - Generate Stepped Gradients, Shades and Tints]]

[[https://www.canva.com/colors/color-wheel/][Canva Color Wheel - Generate Complementary / Monochromatic / Analogous colors]]

[[https://hueplot.ardov.me/][Hueplot - Color Spaces in 3D]]

[[https://huetone.ardov.me/][Huetone - APCA / WCAG explorer for popular color palettes]]