docs: promote apex-neon.md/apex-aeon.md to canonical specs

Rename the v2 spec docs to drop the -v2 suffix and make them the authoritative source of truth. Slim GEMINI.md to a pointer and update CLAUDE.md, AGENTS.md, README.md, INSTALL.md to v2 semantics and the current 15-app target list.

.gitignore

@@ -1,4 +1,3 @@
-dist/
 .venv/
 __pycache__/
 *.pyc

AGENTS.md

@@ -29,5 +29,6 @@
 - For visual/theme changes, include a brief before/after note or screenshots when possible.
 
 ## Theme Rules & Source of Truth
-- `GEMINI.md` is the authoritative source for color semantics and rules; update `src/*.yaml` first, then templates if needed.
+- `apex-neon.md` and `apex-aeon.md` are the authoritative source for color semantics and rules (`GEMINI.md` is a slim pointer to them); update `src/*.yaml` first, then templates if needed.
+- Semantic spine: red = danger only, violet = attention (cursor/search), cyan = info/actions, blue = kinds, green = values, amber = UI warning. Red, violet, and amber never enter a code buffer.
 - Avoid introducing ad-hoc colors that violate the semantic palette.

CLAUDE.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build
+
+```bash
+uv run build.py
+```
+
+Regenerates all theme files from `src/*.yaml` via Jinja2 templates into `dist/`. There is no watch mode — rerun after any YAML or template change. Python 3.12+ required; dependencies managed via `uv` (`pyproject.toml`).
+
+## Architecture
+
+Apex is a **theme factory** — a build system that generates native theme configs for 15 applications from a single semantic color specification.
+
+**Data flow:**
+1. `src/neon.yaml` and `src/aeon.yaml` define the canonical color palette and semantic roles
+2. `templates/<app>/*.j2` define per-application output formats (Lua, JSON, TOML, CSS, Conf, etc.)
+3. `templates/<app>/meta.yaml` controls the build strategy:
+   - `strategy: individual` → outputs `apex-neon.<ext>` and `apex-aeon.<ext>` separately
+   - `strategy: aggregated` → outputs a single file containing both schemes (e.g., `apex.json` for Zed)
+4. `build.py` orchestrates rendering; `dist/` holds all generated artifacts (gitignored)
+
+**Adding a new app target:** create `templates/<app>/`, add a `meta.yaml` with strategy, write `.j2` templates using the YAML variables, then run the build.
+
+## Theme Design Rules
+
+`apex-neon.md` and `apex-aeon.md` are the authoritative source of truth for color semantics (`GEMINI.md` is a slim pointer to them). Key axioms (the semantic spine):
+
+- **Red (`#ff0044`) = Danger only** — errors, destructive actions, active window border. **Never inside a code buffer.**
+- **Violet = Attention** — cursor, search, matched pairs, selection. **Never inside a code buffer.**
+- **Cyan = Informational / actions** — links, info state, function calls. Never use for errors or destruction.
+- **Blue = Kinds** — types, structures, structural accents (a real channel, distinct from cyan).
+- **Green = Values** — strings, numbers, constants, success.
+- **Amber = UI warning only** — never inside a code buffer.
+- **Purple = Sacred** — reserved for root access and exceptional system states.
+- **Bright ANSI variants (8–15)** are for escalated/active states only.
+- Do not introduce colors without a semantic reason. If it has no signal purpose, remove it.
+
+Before modifying `src/*.yaml`, consult `apex-neon.md` / `apex-aeon.md` to verify that any new or changed role fits the semantic palette.
+
+## Conventions
+
+- Commit style: Conventional Commits (`feat:`, `fix:`, `docs:`, `chore:`, `refactor:`)
+- Template output names: `apex-<scheme>.<ext>` for individual; base name for aggregated
+- YAML keys in `src/`: keep consistent with existing semantic roles; add new roles only when truly necessary
+- `dist/` is build output — never edit by hand
+
+## Validation
+
+After changes, run `uv run build.py` and inspect relevant files in `dist/`. For Neovim-specific validation, `scripts/nvim-audit.sh` is available.
+
+## Scripts
+
+- `scripts/release.sh` — Per-app versioning and Gitea release automation. Usage: `bash scripts/release.sh <semver>`. Discovers changed apps via git diff, updates `meta.yaml` version fields, builds, and publishes tarballs. Supports `--dry-run`.
+- `scripts/nvim-audit.sh` — Validates the built Neovim theme by running headless Neovim. Requires `dist/nvim/colors/apex-neon.lua` to exist first.

GEMINI.md

@@ -1,89 +1,25 @@
-# Apex Theme System: GEMINI Context
+# Apex Theme System — Color Source of Truth
 
-This file serves as the persistent brain and Source of Truth for the Apex Theme System (Neon & Aeon). It defines the philosophy, DNA, and rules that must be adhered to in all generated code and configurations.
+The canonical color specifications for the Apex Theme System are:
 
-## 1. Project Philosophy
-**"State over Decoration."**
-Apex is not about pretty colors; it is about signal clarity.
-- **Neon** is a high-contrast dark theme for low-light focus.
-- **Aeon** is a clinical, high-clarity light theme for daylight precision.
-- Both share a unified semantic discipline: color exists only to communicate state.
+- **[`apex-neon.md`](apex-neon.md)** — the dark theme specification.
+- **[`apex-aeon.md`](apex-aeon.md)** — the light theme specification.
 
-## 2. The Color DNA (Source of Truth)
+These two documents are the authoritative source of truth for all color
+semantics, the semantic spine, and the rules that every generated theme must
+honor. Consult them before changing `src/neon.yaml` or `src/aeon.yaml`.
 
-### Core & Semantics
+## The semantic spine (summary)
 
-| Role | Apex Neon (Dark) | Apex Aeon (Light) | Note |
-|---|---|---|---|
-| **Background** | `#050505` (Void Black) | `#f5f5f5` (Void White) | The Canvas |
-| **Foreground** | `#ededed` (Stark White) | `#0a0a0a` (Near Black) | Primary Text |
-| **Primary/Error**| `#ff0044` (Razor Red) | `#ff0044` (Razor Red) | Aggressor/Focus |
-| **Info/Accent** | `#00eaff` (Electric Cyan)| `#007a88` (Deep Cyan) | Technical/Info |
-| **Success** | `#00ff99` | `#00b377` | OK/Pass |
-| **Warning** | `#ffb700` | `#d18f00` | Alert/Load |
-| **Special** | `#9d00ff` | `#7a3cff` | Root/Admin |
-| **Azure** | `#0088cc` | `#005577` | Structural/Functions |
+- **Red** = danger only — errors, destructive actions, active window border.
+  Never inside a code buffer.
+- **Violet** = attention — cursor, search, matched pairs, selection.
+  Never inside a code buffer.
+- **Cyan** = information / actions — links, info state, function calls.
+- **Blue** = kinds — types, structures, structural accents (distinct from cyan).
+- **Green** = values — strings, numbers, constants, success.
+- **Amber** = UI warning only — never inside a code buffer.
+- **Purple** = sacred — reserved for root access / exceptional system states.
 
-### UI Surfaces
-
-| Role | Apex Neon (Dark) | Apex Aeon (Light) |
-|---|---|---|
-| **Main BG** | `#050505` | `#f5f5f5` |
-| **Panel/Soft** | `#141414` | `#e8e8e8` |
-| **Border/Muted**| `#262626` | `#737373` |
-| **High Surface**| N/A | `#ffffff` |
-| **Muted Text** | `#737373` | `#737373` |
-| **Stealth** | `#404040` | `#a0a0a0` |
-
-### ANSI Tables (16-Color)
-
-| Slot | Role | Neon Hex | Aeon Hex |
-|---|---|---|---|
-| 0 | Black/Bg | `#050505` | `#0a0a0a` |
-| 1 | Red | `#ff0044` | `#ff0044` |
-| 2 | Green | `#00ff99` | `#00b377` |
-| 3 | Yellow | `#ffb700` | `#d18f00` |
-| 4 | Blue | `#00eaff` | `#007a88` |
-| 5 | Magenta | `#9d00ff` | `#7a3cff` |
-| 6 | Cyan | `#00eaff` | `#007a88` |
-| 7 | White/Fg | `#ededed` | `#f5f5f5` |
-| 8 | BrBlack | `#737373` | `#737373` |
-| 9 | BrRed | `#ff8899` | `#ff4d6d` |
-| 10 | BrGreen | `#2bffb2` | `#33d6a6` |
-| 11 | BrYellow | `#ffd24d` | `#ffbf40` |
-| 12 | BrBlue | `#5af3ff` | `#33bccc` |
-| 13 | BrMagenta| `#c84dff` | `#a680ff` |
-| 14 | BrCyan | `#5af3ff` | `#33bccc` |
-| 15 | BrWhite | `#ffffff` | `#ffffff` |
-
-## 3. The Axioms (Immutable Rules)
-
-1.  **If it's not important, it does not glow.** Reserve high brightness/saturation for active states.
-2.  **Red is the Predator.** Red (`#ff0044`) is the color of **Active Intent**. It marks the Hunter (Cursor), the Territory (Current Directory), the Target (Selection), and the Threat (Critical Error). It signals "Live Fire." If it's Red, it is either you or a problem you need to kill.
-3.  **Text turns Black on Red.** When the background is `#ff0044`, the text must be `#050505` (Neon) or `#0a0a0a` (Aeon) for contrast. This is non-negotiable.
-4.  **Cyan is Informational.** Never use Cyan for errors or destruction.
-5.  **Purple is Sacred.** Reserved for special modes, root access, or exceptional states.
-6.  **Bright = Escalation.** Use bright ANSI variants (8-15) only when a state is elevated or active. Use **Bright Red** (`color9`) for errors to distinguish them from the cursor/path.
-7.  **No Random Accents.** If a color has no semantic reason to be there, remove it.
-
-## 4. Repository Map
-/
-├── GEMINI.md # This file. Source of Truth.
-├── src/ # Raw DNA
-│ ├── neon.yaml # Apex Neon definitions
-│ └── aeon.yaml # Apex Aeon definitions
-├── templates/ # Jinja2 templates for build targets
-│ ├── nvim/
-│ ├── zed/
-│ ├── zsh/
-│ ├── kitty/
-│ ├── gemini/
-│ ├── gtk4/
-│ ├── hyprland/
-│ ├── fuzzel/
-│ ├── waybar/
-│ ├── zathura/
-│ ├── btop/
-│ ├── swaync/
-│ └── alacritty/
-└── dist/ # Compiled theme files (gitignore this)
+"State over Decoration." If a color has no signal purpose, remove it. See the
+spec docs above for the full rule system, value tables, and rationale.

INSTALL.md

@@ -96,27 +96,7 @@ All generated theme files can be found in the `dist/` directory after running `u
 
 ---
 
-## 6. Gemini CLI
-
-**Files:**
-- `dist/gemini/apex-neon.json`
-- `dist/gemini/apex-aeon.json`
-
-**Installation:**
-1. Edit your Gemini settings file (usually `~/.config/gemini/settings.json` or via `gemini settings`).
-2. Point the `theme` property to the absolute path of the generated file:
-
-   ```json
-   {
-     "ui": {
-       "theme": "/absolute/path/to/dist/gemini/apex-neon.json"
-     }
-   }
-   ```
-
----
-
-## 7. GTK4 / Libadwaita
+## 6. GTK4 / Libadwaita
 
 **Files:**
 - `dist/gtk4/gtk.css` (Aggregated: Responsive to System Dark/Light mode)
@@ -133,7 +113,7 @@ All generated theme files can be found in the `dist/` directory after running `u
 
 ---
 
-## 8. Hyprland
+## 7. Hyprland
 
 **Files:**
 - `dist/hyprland/apex-neon-colors.conf`
@@ -152,7 +132,7 @@ All generated theme files can be found in the `dist/` directory after running `u
 
 ---
 
-## 9. Fuzzel
+## 8. Fuzzel
 
 **Files:**
 - `dist/fuzzel/apex-neon-fuzzel.ini`
@@ -167,26 +147,7 @@ All generated theme files can be found in the `dist/` directory after running `u
 
 ---
 
-## 10. Waybar
-
-**Files:**
-- `dist/waybar/apex-neon-colors.css`
-- `dist/waybar/apex-aeon-colors.css`
-
-**Installation:**
-1. Copy the desired file to your Waybar config directory:
-   ```bash
-   cp dist/waybar/apex-neon-colors.css ~/.config/waybar/colors.css
-   ```
-2. Import it in your main `style.css`:
-   ```css
-   @import "colors.css";
-   ```
-3. Use the variables in your CSS (e.g., `background-color: @background;`, `color: @foreground;`, `border-color: @accent;`).
-
----
-
-## 11. Zathura
+## 9. Zathura
 
 **Files:**
 - `dist/zathura/apex-neon-zathurarc`
@@ -205,7 +166,7 @@ All generated theme files can be found in the `dist/` directory after running `u
 
 ---
 
-## 12. Btop
+## 10. Btop
 
 **Files:**
 - `dist/btop/apex-neon.theme`
@@ -218,22 +179,3 @@ All generated theme files can be found in the `dist/` directory after running `u
    cp dist/btop/*.theme ~/.config/btop/themes/
    ```
 2. Select the theme within Btop settings (ESC -> Options -> Color theme).
-
----
-
-## 13. SwayNC
-
-**Files:**
-- `dist/swaync/apex-neon-style.css`
-- `dist/swaync/apex-aeon-style.css`
-
-**Installation:**
-1. Copy the desired file to your SwayNC config directory:
-   ```bash
-   mkdir -p ~/.config/swaync
-   cp dist/swaync/apex-neon-style.css ~/.config/swaync/style.css
-   ```
-2. Reload SwayNC:
-   ```bash
-   swaync-client -rs
-   ```

README.md

@@ -16,24 +16,24 @@ The factory currently generates native themes for:
 - **Zed** (JSON extension)
 - **Alacritty** (TOML)
 - **Kitty** (Conf)
+- **Ghostty** (Theme)
 - **Zsh** (Theme with Radar/AAR)
-- **Gemini CLI** (JSON)
 - **GTK4 / Libadwaita** (CSS)
 - **Hyprland** (Conf)
 - **Fuzzel** (INI)
-- **Waybar** (CSS variables)
 - **Zathura** (Config)
 - **Btop** (Theme)
-- **SwayNC** (CSS)
 
 ## The Apex DNA
 
 Apex is built on a unified semantic discipline where every color has a specific role:
 
-- **Red is the Predator**: Reserved for active intent, the cursor, current location, and critical errors. It signals "Live Fire."
-- **Cyan is Informational**: Used for technical data, links, and neutral highlights.
+- **Red is Danger**: Reserved for errors, destructive actions, and the active window border. It never enters a code buffer.
+- **Violet is Attention**: The cursor, search matches, matched pairs, and selection — the "you are here" channel. It never enters a code buffer.
+- **Cyan is Informational**: Used for links, technical data, info state, and function calls.
+- **Blue is Kinds**: Types, structures, and structural accents — a real channel, distinct from cyan.
+- **Green is Values**: Strings, numbers, constants, and success.
 - **Purple is Sacred**: Reserved for root access, special modes, or exceptional system states.
-- **Contrast is King**: Non-negotiable rules for readability (e.g., Black text on Red backgrounds).
 
 ## Development & Building
 
@@ -73,7 +73,7 @@ Notes:
 - `src/`: Source YAML definitions containing the "DNA" of the themes.
 - `templates/`: Jinja2 templates for each supported application.
 - `dist/`: Compiled theme files ready for deployment.
-- `GEMINI.md`: AI Context & Source of Truth.
+- `GEMINI.md`: Slim pointer to the canonical color specs.
 - `apex-neon.md` / `apex-aeon.md`: Detailed specifications.
 
 ## Authors

apex-aeon.md

@@ -1,98 +1,287 @@
 # Apex Aeon — Light Theme Specification
 
-Apex Aeon is the daylight translation of Apex Neon: the same semantic discipline, but on a bright canvas. Color still signals **state**, not decoration. The theme is clinical, high-clarity, and intentionally restrained.
+Apex Aeon is the **light sibling** of Apex Neon. Same rule system, recomputed for a
+bright field. It is not an inversion of Neon's hexes — glow is a dark-theme
+mechanism and does not survive on white. Aeon keeps the **grammar** and recomputes
+the **values**.
+
+> **Thesis.** The daylight hunt. Where Neon is a glowing HUD on deep black, Aeon is
+> tracks in snow — the field is bright, the signal is **ink, not glow**. Figure goes
+> *dark* because the ground went *light*. Red = danger, violet = attention; both
+> still reserved, still absent from code, still the strongest signals on screen.
 
 ---
 
-## 1. Core Colors (DNA)
+## 0. Relationship to Neon — the consistency contract
+
+Aeon is a **sibling**, not a mirror. The rules are invariant; ergonomics drive the
+values. "Consistent" means *system-consistent*, not *hex-consistent*.
+
+### Invariant across Neon ↔ Aeon (never diverges)
+
+- **Semantic spine** — red = danger, violet = attention, cyan = info, blue = kinds,
+  green = values/success, amber = warning.
+- **Reserved-hue rule** — red + violet + amber never appear inside a code buffer.
+- **Role → family syntax map** — kinds / actions / values / connective / navigation.
+- **Figure/ground principle** — one bright/dark figure, one dim field (poles inverted).
+- **Saturation budget** — neon/ink is signal; body is near-neutral.
+- **Cool tint** — both backgrounds sit slightly cool.
+
+### Sibling-licensed to differ
+
+- **Exact hexes** — recomputed; glow values do not port to light.
+- **The carrier channel** — Neon distinguishes roles by *hue + brightness*; Aeon by
+  *hue + texture* (weight, italic, fill-vs-outline). See §2.
+- **One green divergence** (at most) — see §7 / open calibrations.
+
+---
+
+## 1. Why this is not an inversion
+
+- **Neon glow = high-luminance saturated color on near-zero-luminance black.** Put
+  `#00ff99` or `#ffb700` on white and the luminance contrast collapses — they
+  vibrate and vanish. The glow *is* the dark background.
+- **The signal band inverts and compresses.** On dark, signal pops by going *bright*
+  with the full luminance ceiling as headroom. On light, signal must go *dark* — and
+  dark saturated hues **converge** toward muddy ink, where hue discrimination is
+  weakest. The 5-hue pre-attentive system is under **more** pressure on light, not
+  less. This is the central design problem; texture (§2) is the answer.
+
+---
+
+## 2. The second channel is structural
+
+Neon used weight/italic as garnish; hue did the work. Aeon **co-carries meaning by
+form**, because the compressed dark band cannot separate five hues alone.
+
+- **Fill vs outline** becomes a semantic axis Neon never needed.
+- **Figure/ground inverts cleanly:** dark ink figure on a **pale-tint** ground
+  (snow-track logic) — e.g. error = deep-red text on `#fbe4e9`; search = deep-violet
+  on `#efe2fb`.
+- **Diagnostics lean on texture:** underline / undercurl weight + pale field, because
+  a dark squiggle on white is quieter than a neon one on black. Texture compensates
+  for the lost luminance punch.
+
+This is Aeon using light's strength (ink legibility, texture clarity) rather than
+faking dark's strength (glow).
+
+---
+
+## 3. Semantic Spine — five hues, zero overlap
+
+Identical to Neon. Note the **survivor asymmetry**: red and violet are already
+low-luminance, so they port with the most identity intact; cyan/green/amber move
+hardest. Aeon therefore reads **red-and-violet-forward** — embraced, not fought,
+because danger and attention *should* be the loudest, and info *should* be calmer.
+
+| Hue | Meaning | In code buffer? | Survives inversion |
+| --- | --- | --- | --- |
+| **Red** | Danger — error, critical, destructive | ❌ never | best (already dark) |
+| **Violet** | Attention — cursor, search, matched pairs | ❌ never | best |
+| **Cyan** | Information / actions | ✅ | moves hard |
+| **Blue** | Kinds | ✅ | moderate |
+| **Green** | Success / values | ✅ | moves hard (convergence risk) |
+| **Amber** | Warning — UI only | ❌ never | moves hard |
+
+---
+
+## 4. Neutrals — the readable 80% (ramp reversed: light → dark)
+
+Background is off-white, **not pure white** (same halation/fatigue logic as Neon's
+`#070709`). Faint cool tint mirrors the dark theme.
 
 | Hex | Name | Role |
-|---|---|---|
-| `#f5f5f5` | Void White | Primary background. The canvas. |
-| `#0a0a0a` | Near Black | Primary readable text. Default signal. |
-| `#ff0044` | Razor Red | Primary aggressor. Errors, focus, cursor, active borders. |
-| `#007a88` | Deep Cyan | Technical accent. Info, links, highlights. |
+| --- | --- | --- |
+| `#f1f3f7` | Paper | Main background, terminal background |
+| `#e7eaf0` | Surface | Inputs, inactive tabs, widgets |
+| `#dce0e8` | Panel | Panels, separators, scroll track |
+| `#c2c8d4` | Seam | Visible borders, line-highlight background |
+| `#c8cdd8` | Stealth | Ignored / suppressed text (sub-threshold **by design**) |
+| `#5c6270` | Ghost | Comments, subtitles, muted labels |
+| `#16181d` | Ink | Default body text (cool near-black, not pure black) |
+| `#000000` | Deep | Extreme emphasis only |
 
-**Rule:** if an element is not important, it does not glow.
+**Rule.** Depth comes from contrast, not darkness. Nothing load-bearing sits at
+Stealth (its low contrast on Paper is the point).
 
 ---
 
-## 2. UI Surfaces & Depth
+## 5. Signal Layer — figure / ground (poles inverted)
 
-| Hex | Name | Usage |
-|---|---|---|
-| `#f5f5f5` | Void White | Main window backgrounds. |
-| `#ffffff` | High Surface | Cards/inputs where needed (use sparingly). |
-| `#e8e8e8` | Soft Surface | Sub-panels, inactive tabs, grouped regions. |
-| `#737373` | Border / Muted | Borders, dividers, secondary labels. |
+Recomputed accents — **render-untested**; convergence in the dark band makes these
+the riskiest values in the project. Verify hue-separation on a real light buffer.
 
-**Rule:** depth comes from subtle surface stepping, not shadows everywhere.
+```
+DANGER  (red — warm, alarm)
+#c8003a  Razor Red      error figure, destructive, active alarm
+#fbe4e9  Ember Field     error region background (+ diff-delete background)
+#9e0030  Deep Red        escalation (DARKER on light — "bright = escalation" inverts)
+
+ATTENTION  (violet — cool, scanner; underline-shaped)
+#7c2fd6  Focus Max       cursor — the crosshair
+#8c3dd0  Focus Active    current search match, matched bracket / pair
+#efe2fb  Focus Field     other matches, selection background
+
+INFORMATION
+#0080a6  Electric Cyan   info / links
+#00875a  Acid Green      success / diff-add
+#a86b00  Amber           warning / diff-change  (UI only)
+#6a1fb8  Violet (deep)   reserved special / root
+```
+
+**Inversion note.** On Neon, "bright = escalation" meant higher luminance. On light,
+signal intensifies by going *darker*, so the escalation red (`#9e0030`) is **darker**
+than base danger (`#c8003a`). The rule is preserved; its direction flips.
 
 ---
 
-## 3. Interaction States
+## 6. Interaction & State
 
-| Hex | Role | Notes |
-|---|---|---|
-| `#ff0044` | Cursor | Caret in terminals and inputs. |
-| `#ff0044` | Selection BG | “Target locked” selection state. |
-| `#0a0a0a` | Selection FG | **Hard rule:** text turns Near Black on red. |
-| `#ff0044` | Active Border | Focused window/element edge. |
+| Element | Color | Form | Notes |
+| --- | --- | --- | --- |
+| Cursor | `#7c2fd6` Focus Max | **underline** | Sits below a search match's bg+fg. |
+| Current search match | `#8c3dd0` Focus Active | fg | The one match you are on. |
+| Other matches | `#2e333d` on `#efe2fb` | field | The set; pale violet ground. |
+| Selection | `#2e333d` on `#efe2fb` | field | fg preserved. |
+| Matched bracket / pair | `#8c3dd0` | fg | Attention, not syntax. |
+| Active line | bg `#e7eaf0` | — | Line **number** in `#7c2fd6` is the crosshair. |
+| Active border | `#c8003a` | edge | Focused window/element. |
 
 ---
 
-## 4. Functional Semantics
+## 7. Syntax — loud, typed by role (ink, not glow)
 
-| Meaning | Hex |
-|---|---|
-| Success / OK | `#00b377` |
-| Warning / Load | `#d18f00` |
-| Error / Critical | `#ff0044` |
-| Special / Root | `#7a3cff` |
-| Info / Link | `#007a88` |
+Same role model: `blue = kinds · cyan = actions · green = values · neutral =
+connective · bold/bright = navigation`. Loudness now via depth + weight + style.
+
+### Rust reference map
+
+| Token | Hex | Family / weight |
+| --- | --- | --- |
+| Comment | `#5c6270` italic | neutral |
+| Punctuation / delimiter | `#7d8390` | neutral, lifted |
+| Operator | `#5c6270` | neutral |
+| Variable / param | `#16181d` | Ink body |
+| Property / field | `#2e333d` | dim Ink |
+| Type / struct / enum / trait | `#2148c0` | **blue — kinds** |
+| Storage / modifier (`pub mut async`) | `#1633a0` bold | blue, heavier |
+| Attribute (`#[derive]`) | `#2148c0` italic | **blue — declarative** |
+| Function def / call | `#0e6e92` bold | **cyan — actions** |
+| Bang-macro (`println!`) | `#0e6e92` bold italic | **cyan — action + ceremony** |
+| `self` / builtin | `#3a7d9c` italic | cyan, dim |
+| String | `#00734d` | **green — values** |
+| Char / escape | `#2b8f63` | green, brighter |
+| Number / bool / const | `#00875a` | green, cooler |
+
+### Navigation — split static vs dynamic
+
+| Kind | Examples | Color |
+| --- | --- | --- |
+| **Static control flow** | `if return break continue match`, `\begin \end`, `goto` | `#1633a0` bold deep-blue |
+| **Dynamic pairing** | bracket partner, `\begin`↔`\end`, jump target | `#8c3dd0` violet — **attention** |
+
+**Green double-duty.** On light, value-green and success-green both deepen toward the
+same olive band and may converge. Resolution (sibling-legal): **keep both, split by
+texture** — success = fill/bold, value = plain. A teal divergence for values was
+rejected (would collide with cyan-info in the crowded dark band). Flagged for render
+test; most likely failure point.
 
 ---
 
-## 5. Terminal ANSI Table (16-Color Engine)
+## 8. Diff / Git (pale grounds, ink figures)
 
-Bright colors represent **escalation**, not decoration, even on a light background.
+| State | fg | bg |
+| --- | --- | --- |
+| Add | `#00734d` | `#e2f3ea` |
+| Change | `#a86b00` | `#f5ecda` |
+| Delete | `#c8003a` | `#fbe4e9` ← reused Ember Field |
+
+---
+
+## 9. Terminal ANSI Table (16-color fallback bank)
+
+Truecolor-first; this bank is the floor. **Bright-bank inversion:** on a light theme
+the bright variants are *more saturated/deeper*, not lighter — a lighter variant
+would lose contrast against Paper. `color0` stays dark (text), `color15` stays light.
 
 ### Normal Bank (0–7)
 
 | Slot | Name | Hex | Meaning |
-|---|---|---|---|
-| color0 | Black | `#0a0a0a` | Primary text |
-| color1 | Red | `#ff0044` | **The Predator** (Cursor/Path) |
-| color2 | Green | `#00b377` | Success |
-| color3 | Yellow | `#d18f00` | Warning |
-| color4 | Blue | `#007a88` | Info / links |
-| color5 | Magenta | `#7a3cff` | Special / root |
-| color6 | Cyan | `#007a88` | Info (mapped) |
-| color7 | White | `#f5f5f5` | Background |
+| --- | --- | --- | --- |
+| color0 | Black | `#16181d` | Text / ink |
+| color1 | Red | `#c8003a` | Danger / error |
+| color2 | Green | `#00875a` | Success |
+| color3 | Yellow | `#a86b00` | Warning |
+| color4 | Blue | `#2148c0` | Kinds / structural |
+| color5 | Magenta | `#7c2fd6` | Special / root |
+| color6 | Cyan | `#0080a6` | Info / actions |
+| color7 | White | `#c2c8d4` | Light surface |
 
 ### Bright Bank (8–15)
 
 | Slot | Name | Hex | Meaning |
-|---|---|---|---|
-| color8 | BrBlack | `#737373` | Borders / separators / muted |
-| color9 | BrRed | `#ff4d6d` | **Alerts** (Distinguishable from Cursor) |
-| color10 | BrGreen | `#33d6a6` | Active success / completion |
-| color11 | BrYellow | `#ffbf40` | Urgent warning |
-| color12 | BrBlue | `#33bccc` | Active info / focus highlight |
-| color13 | BrMagenta | `#a680ff` | Elevated special state |
-| color14 | BrCyan | `#33bccc` | Active tech signal |
-| color15 | BrWhite | `#ffffff` | Maximum highlight (rare) |
+| --- | --- | --- | --- |
+| color8 | BrBlack | `#5c6270` | Muted / suggestions |
+| color9 | BrRed | `#9e0030` | Escalation (darker = hotter on light) |
+| color10 | BrGreen | `#006e49` | Active success / values |
+| color11 | BrYellow | `#8a5800` | Urgent warning |
+| color12 | BrBlue | `#1633a0` | Active flow nav |
+| color13 | BrMagenta | `#6a1fb8` | Elevated attention |
+| color14 | BrCyan | `#0e6e92` | Active tech signal / functions |
+| color15 | BrWhite | `#f1f3f7` | Lightest highlight |
+
+Background `#f1f3f7`, foreground `#16181d` set separately from the bank.
 
 ---
 
-## 6. Usage Guidelines
+## 10. Cross-Language Role Mapping
 
-- **Red is the Agent**. It marks where the user *is* (Prompt/Path) and what the user *controls* (Cursor/Selection).
-- **Distinguish the Thread.** Since the Prompt is now Red, actual Errors must use **Bright Red** (`#ff4d6d`) or explicit symbols.
-- **Deep Cyan is informational.** Never use it for errors or destructive actions.
-- **Purple is sacred.** Only for special modes, root, or exceptional states.
-- **Bright = escalation.** If nothing changed, don’t use a bright variant.
-- **Surfaces stay simple.** Let state and typography carry hierarchy.
-- **No random accents.** If a color has no semantic reason, it’s wrong.
+Identical to Neon — color follows **roles**, which are language-invariant. The §10
+table and per-language judgment calls from `apex-neon-v2.md` apply unchanged; only
+the hex values differ (§7). Family-skew, role-ambiguous constructs (`$VAR`,
+f-strings, pipelines), and identity pronouns (`self`/`this`/`$`) are resolved the
+same way: weight/style tweak onto an existing family, never a new hue.
 
-Apex Aeon is not “light mode.” It’s the same system under harsher lighting.
+---
+
+## 11. Accessibility Contract
+
+- **Body text** `#16181d` on Paper `#f1f3f7` — very high contrast (≈ 15:1), the
+  resting surface.
+- **Comments** `#5c6270` on Paper — readable (target ≥ 4.5:1, AA normal text).
+- **Stealth** `#c8cdd8` on Paper — sub-threshold **by design**; ignored text only.
+- **No ink-on-ink.** Dark signal colors never sit on dark fills; signal always on a
+  pale or neutral field.
+- **Dark-band separation is the real risk.** Verify the five deep accents are
+  mutually distinguishable on the actual display — this is where light fights you.
+
+---
+
+## 12. Rules with Teeth
+
+- **Red is danger. Violet is attention.** Neither ever appears inside code.
+- **Cyan is information and action. Amber is warning — UI only.**
+- **Signal is ink, not glow.** Pop comes from depth + texture, not brightness.
+- **Form co-carries meaning.** Weight/italic/fill are semantic, not decorative.
+- **Escalation goes darker** (the inverted "bright = escalation").
+- **One color, one meaning.** No accent without a reason.
+- **Scarcity is the weapon.** A signal carries information only when rare.
+
+Apex Aeon is the same predator at noon. The hunt does not change with the light.
+
+---
+
+## Open calibrations (verify on a real light buffer)
+
+1. **Dark-band hue separation.** The five deep accents (`#c8003a #7c2fd6 #0080a6
+   #00875a #a86b00`) crowd more than their Neon cousins. Confirm mutual
+   distinguishability before trusting the role-typing — the single highest risk.
+2. **Green convergence.** Value-green `#00734d` vs success-green `#00875a` may read
+   as one olive on light. If they collapse, push success toward fill/bold weight
+   harder, or accept the texture-only split.
+3. **Cyan family crowding.** Functions `#0e6e92`, `self` `#3a7d9c`, and info `#0080a6`
+   all occupy a narrow deep-cyan band. Verify functions vs info separate; widen by
+   weight if not.
+4. **Paper warmth.** `#f1f3f7` is cool-neutral. If it reads clinical/cold under warm
+   ambient light, a hair of warmth (`#f4f2ee`) is sibling-legal — but breaks the
+   cool-tint invariant, so decide deliberately.

apex-neon.md

@@ -1,99 +1,298 @@
 # Apex Neon — Dark Theme Specification
 
-Apex Neon is a high-contrast dark theme built for terminals, editors, and system UI. Color exists to signal **state**, not to decorate space.
+Apex Neon is a high-contrast dark theme for terminals, editors, and system UI.
+It is a **rule system**, not a palette. Color carries **meaning**, not decoration.
+
+> **Thesis.** A cold neon HUD on deep black. Hue carries meaning, sparsely.
+> **Red = danger. Violet = attention.** Both are absent from code, so they always
+> strike. The forest (syntax) is loud and typed by grammatical role so the hunter
+> navigates fast — but the predator and the crosshair stay the only red and violet
+> things in it.
 
 ---
 
-## 1. Core Colors (DNA)
+## 0. What changed from v1
+
+| v1 problem | v2 fix |
+| --- | --- |
+| **Red overloaded** — meant *self/cursor* **and** *danger* simultaneously | Hue split: **red = danger only**, **violet = attention** (cursor/search/pairs) |
+| `color4 ≡ color6` and `color12 ≡ color14` (cyan/blue collision) | Blue split into a real channel (`#2e6bff` / `#5b8cff`) |
+| Comments double-defined (Stealth **and** Muted) | Comments = Ghost; Stealth = *ignored* text only |
+| Backwards bright-red (`#ff8899` softer than base — "escalation" read calmer) | `#ff3b3b` — hotter and truer red |
+| No diff/git colors | Figure/ground diff tints added |
+| No syntax model | Role-typed syntax across all languages |
+| `#050505` near-pure black (halation, crushed surfaces) | `#070709` — deep, cool-tinted, halation-safe |
+
+---
+
+## 1. Semantic Spine — five hues, zero overlap
+
+The core invariant. Every color does exactly one job.
+
+| Hue | Meaning | In code buffer? | Temp |
+| --- | --- | --- | --- |
+| **Red** | Danger — error, critical, destructive | ❌ never | warm |
+| **Violet** | Attention — cursor, search, matched pairs | ❌ never | cool |
+| **Cyan** | Information / **actions** (functions, bang-macros) | ✅ | cool |
+| **Blue** | **Kinds** (types, storage, attributes) | ✅ | cool |
+| **Green** | Success / **values** (strings, numbers) | ✅ | cool-warm |
+| **Amber** | Warning — UI only | ❌ never | warm |
+
+**Keystone rule.** Red, violet, and amber never appear inside a code buffer. When
+an error (red), the cursor/search (violet), or a warning (amber) fires, it pops
+against a field that contains none of those hues — however loud the syntax is.
+
+---
+
+## 2. Operating Principles
+
+1. **Saturation budget.** Neon is for *signal*. Body text is near-neutral.
+   Striking comes from restraint against contrast — not coverage.
+2. **Figure / ground.** A bright hue marks the *one* thing (cursor, error text);
+   a dim hue field marks the *set* (search hits, error region, diff block).
+   Applied to both red and violet.
+3. **Hue rotates for severity.** `info → warn → error → critical` rotates hue;
+   it never ramps lightness within a single hue (pre-attentively unreadable).
+4. **Loudness is allocated by grammatical role, not sprayed.** Code can be vivid;
+   uniform saturation is noise. Each grammatical class owns one hue family.
+5. **Pre-attentive bandwidth is ~5–7 categories.** The limit is the feature:
+   scarcity is what makes a signal pop. The display is not the constraint; the
+   visual cortex is.
+
+---
+
+## 3. Neutrals — the readable 80%
+
+Anchored at `#070709`. Faint cool bias (B ≳ R) reinforces the cold scan and makes
+warm signals pop by complementary contrast.
 
 | Hex | Name | Role |
-|---|---|---|
-| `#050505` | Void Black | Absolute background. The canvas. |
-| `#ff0044` | Razor Red | Primary aggressor. Errors, focus, cursor, active borders. |
-| `#00eaff` | Electric Cyan | Technical accent. Info, links, highlights. |
-| `#ededed` | Stark White | Default readable text. |
+| --- | --- | --- |
+| `#070709` | Void | Main background, terminal background |
+| `#101218` | Hull | Inputs, inactive tabs, widgets |
+| `#181b22` | Plating | Panels, separators, scroll track |
+| `#262a34` | Seam | Visible borders, line-highlight background |
+| `#383d49` | Stealth | Ignored / suppressed text (sub-threshold **by design**) |
+| `#8b909c` | Ghost | Comments, subtitles, muted labels |
+| `#e6e8ec` | Stark | Default body text (not pure white — fatigue / halation) |
+| `#ffffff` | Flare | Extreme highlight only |
 
-**Rule:** if a UI element is not important, it does not glow.
+**Rule.** Depth comes from contrast, not brightness. Nothing load-bearing ever
+sits at Stealth.
 
 ---
 
-## 2. UI Surfaces & Depth
+## 4. Signal Layer — figure / ground
 
-| Hex | Name | Usage |
-|---|---|---|
-| `#050505` | Void Deep | Main window backgrounds, terminal background. |
-| `#141414` | Dark Surface | Inputs, inactive tabs, widget backgrounds. |
-| `#262626` | Light Surface | Separators, scroll tracks, inactive borders. |
-| `#404040` | Stealth | Comments, ignored text, suppressed hints. |
-| `#737373` | Muted Text | Comments, subtitles, inactive labels. |
+```
+DANGER  (red — warm, alarm)
+#ff0044  Razor Red     error figure, destructive action, active alarm
+#1f0a12  Ember Field    error region background (+ diff-delete background)
+#ff3b3b  Bright Red     ANSI color9 / escalation
 
-**Rule:** depth comes from contrast, not brightness.
+ATTENTION  (violet — cool, scanner; underline-shaped)
+#d68fff  Focus Max      cursor — the crosshair (the single hottest mark)
+#b14dff  Focus Active   current search match, matched bracket / pair
+#3a1a4d  Focus Field    other search matches, selection background
+
+INFORMATION
+#00eaff  Electric Cyan  info / links
+#00ff99  Acid Green     success / diff-add
+#ffb700  Amber          warning / diff-change  (UI only — never in buffer)
+#9d00ff  Violet (deep)  reserved special / root (ANSI color5)
+```
 
 ---
 
-## 3. Interaction States
+## 5. Interaction & State
 
-| Hex | Role | Notes |
-|---|---|---|
-| `#ff0044` | Cursor | Caret in terminals and inputs (Beam shape). |
-| `#ff0044` | Selection BG | “Target locked” selection state. |
-| `#050505` | Selection FG | **Hard rule:** text turns black on red. |
-| `#ff0044` | Active Border | Focused window/element edge. |
+| Element | Color | Form | Notes |
+| --- | --- | --- | --- |
+| Cursor | `#d68fff` Focus Max | **underline** | Sits *below* a search match's bg+fg — all three stay visible. |
+| Current search match | `#b14dff` Focus Active | fg | The one match you are on. |
+| Other search matches | `#e6e8ec` on `#3a1a4d` | field | The set; dim violet ground. |
+| Selection | `#e6e8ec` on `#3a1a4d` | field | "Region scanned." fg preserved (no black-on-red). |
+| Matched bracket / pair | `#b14dff` | fg | **Attention**, not syntax — same act as search. |
+| Active line | neutral bg `#101218` | — | Line **number** in `#d68fff` is the crosshair; near-zero red coverage. |
+| Active border | `#ff0044` | edge | Focused window/element. |
+
+**Known overlap.** Cursor underline (violet, straight) and error undercurl (red,
+wavy) share the bottom-line layer. On an error token under the cursor they coexist
+— distinguishable by shape *and* hue, but visually busy. Accepted, not a surprise.
 
 ---
 
-## 4. Functional Semantics
+## 6. Severity Ladder — rotates hue, never a red ramp
 
-| Meaning | Hex |
-|---|---|
-| Success / OK | `#00ff99` |
-| Warning / Load | `#ffb700` |
-| Error / Critical | `#ff0044` |
-| Special / Root | `#9d00ff` |
-| Info / Link | `#00eaff` |
+```
+info        warn        error                    critical
+#00eaff  →  #ffb700  →  #ff0044  →  figure on ground: #ff0044 on #1f0a12
+ cyan       amber       red          the whole region lights red
+```
+
+Critical does not get a new hue (rotating past red collides with amber or violet).
+It escalates via **field** — error-red figure on a dark-red ground. This is the
+*only* place red becomes a background. Maximum alarm, maximally rare.
 
 ---
 
-## 5. Terminal ANSI Table (16-Color Engine)
+## 7. Syntax — loud, typed by grammatical role
 
-Bright colors represent **escalation**, not decoration.
+**Model:** `blue = kinds · cyan = actions · green = values · neutral = connective
+tissue · bold/bright = navigation`. Roles are language-invariant (see §10).
+
+### Rust reference map
+
+| Token | Hex | Family / weight |
+| --- | --- | --- |
+| Comment | `#8b909c` italic | neutral — not a target |
+| Punctuation / delimiter | `#aab0bc` | neutral, lifted |
+| Operator | `#c2c8d4` | neutral |
+| Variable / param | `#e6e8ec` | Stark body (everywhere = calm) |
+| Property / field | `#cdd4e3` | dim Stark |
+| Type / struct / enum / trait | `#7db4ff` | **blue — kinds** |
+| Storage / modifier (`pub mut async`) | `#2e6bff` bold | blue, heavier |
+| Attribute (`#[derive]`) | `#2e6bff` italic | **blue — declarative** |
+| Function def / call | `#5af3ff` bold | **cyan — actions** |
+| Bang-macro (`println!`) | `#5af3ff` bold italic | **cyan — action + ceremony** |
+| `self` / builtin | `#8fd6ff` italic | cyan, dim |
+| String | `#2bffb2` | **green — values** |
+| Char / escape | `#7dffd0` | green, brighter |
+| Number / bool / const | `#37dba0` | green, cooler |
+
+### Navigation — split static vs dynamic
+
+| Kind | Examples | Color |
+| --- | --- | --- |
+| **Static control flow** | `if return break continue match`, `\begin \end`, `goto` | `#5b8cff` bold bright-blue — trail markers |
+| **Dynamic pairing** | bracket-under-cursor partner, `\begin`↔`\end`, jump target | `#b14dff` violet — this is **attention**, not syntax |
+
+---
+
+## 8. Diff / Git
+
+Dark tinted **grounds**, neon **figures**. Never full-saturation blocks.
+
+| State | fg | bg |
+| --- | --- | --- |
+| Add | `#00ff99` | `#0a1f16` |
+| Change | `#ffb700` | `#1f1a0a` |
+| Delete | `#ff0044` | `#1f0a12` ← reused Ember Field |
+
+---
+
+## 9. Terminal ANSI Table (16-color fallback bank)
+
+Truecolor-first: design in exact hex everywhere the app emits 24-bit. This bank is
+the floor for anything emitting raw 16-color codes. Skip the 256-color cube entirely.
 
 ### Normal Bank (0–7)
 
 | Slot | Name | Hex | Meaning |
-|---|---|---|---|
-| color0 | Black | `#050505` | Background |
-| color1 | Red | `#ff0044` | **The Predator** (Cursor/Path/Self) |
+| --- | --- | --- | --- |
+| color0 | Black | `#070709` | Background |
+| color1 | Red | `#ff0044` | Danger / error / destructive |
 | color2 | Green | `#00ff99` | Success |
 | color3 | Yellow | `#ffb700` | Warning |
-| color4 | Blue | `#00eaff` | Info / links |
+| color4 | Blue | `#2e6bff` | Kinds / structural (real blue) |
 | color5 | Magenta | `#9d00ff` | Special / root |
-| color6 | Cyan | `#00eaff` | Info (mapped) |
-| color7 | White | `#ededed` | Default text |
+| color6 | Cyan | `#00eaff` | Info / actions |
+| color7 | White | `#e6e8ec` | Default text |
 
 ### Bright Bank (8–15)
 
 | Slot | Name | Hex | Meaning |
-|---|---|---|---|
-| color8 | BrBlack | `#737373` | Muted text / suggestions |
-| color9 | BrRed | `#ff8899` | **Alerts** (Distinguishable from Cursor) |
-| color10 | BrGreen | `#2bffb2` | Active success / completion |
+| --- | --- | --- | --- |
+| color8 | BrBlack | `#383d49` | Muted / suggestions |
+| color9 | BrRed | `#ff3b3b` | Escalation / alert (hotter than base) |
+| color10 | BrGreen | `#2bffb2` | Active success / values |
 | color11 | BrYellow | `#ffd24d` | Urgent warning |
-| color12 | BrBlue | `#5af3ff` | Active info / focus highlight |
-| color13 | BrMagenta | `#c84dff` | Elevated special state |
-| color14 | BrCyan | `#5af3ff` | Active tech signal |
+| color12 | BrBlue | `#5b8cff` | Active flow nav / focus highlight |
+| color13 | BrMagenta | `#c84dff` | Elevated attention state |
+| color14 | BrCyan | `#5af3ff` | Active tech signal / functions |
 | color15 | BrWhite | `#ffffff` | Extreme highlight only |
 
+**Multiplexer warning.** tmux silently downsamples truecolor to the 256-cube if
+misconfigured — which collapses the figure/ground tints. Assert passthrough:
+
+```tmux
+set -g default-terminal "tmux-256color"
+set -ga terminal-overrides ",*:RGB"
+```
+
+```bash
+# verify the chain carries 24-bit (run inside and outside tmux — should not shift)
+printf '\033[38;2;255;0;68mtruecolor\033[0m\n'
+```
+
+Neovim additionally requires `vim.o.termguicolors = true`.
+
 ---
 
-## 6. Usage Guidelines
+## 10. Cross-Language Role Mapping
 
-- **Red is the Agent**. It marks where the user *is* (Prompt/Path) and what the user *controls* (Cursor/Selection).
-- **Distinguish the Threat.** Since the Prompt is now Red, actual Errors must use **Bright Red** (`#ff8899`) or explicit symbols to distinguish them from the environment.
-- **Cyan is informational.** Never use it for errors or destructive actions.
-- **Purple is sacred.** Only for special modes, root, or exceptional states.
-- **Bright = escalation.** If nothing changed, don’t use a bright variant.
+Color follows **roles**, not tokens. Surface syntax differs across languages; the
+deep grammar does not. One palette, every grammar — more languages means more
+*query mappings to maintain*, not more colors.
+
+| Role → hue | Rust | Python | TypeScript | Go | Java | Bash/sh | Nushell |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| **Kinds** (blue) | `struct trait` | class, hints | `interface type` | `struct interface` | `class enum` | — (untyped) | `int record table` |
+| **Actions** (cyan) | `fn` / `m!` | `def`, methods | fn, arrow, methods | `func` | methods | commands, `echo` | `def`, commands |
+| **Values** (green) | str / num | str / f-str / num | str / template / num | literals | literals | quoted str | literals / records |
+| **Declarative** (blue italic) | `#[attr]` | `@decorator` | `@Decorator` | struct tags | `@Override` | — | — |
+| **Flow nav** (bold blue) | `if match` | `if for try` | `if switch` | `if for go defer` | `if switch` | `if/fi for/done case` | `if/else for` |
+| **Connective** (neutral) | `+ \| ::` | `+ .` | `+ . =>` | `+ . :=` | `+ .` | `\| && $ >` | `\| $ ;` |
+
+### Per-language judgment calls (handle with weight/style, never a new hue)
+
+- **Family skew.** TypeScript is type-saturated (blue-heavy); bash is
+  command-saturated (cyan-heavy). Resolve with brightness/weight tiers *inside* the
+  family (e.g. dim built-in types, bright user types).
+- **Role-ambiguous constructs.** Bash `$VAR` / `${...}` / `$(...)` expansion,
+  Python f-strings / TS template literals (green string containing live code),
+  Nushell pipelines `|` (connective but navigationally load-bearing). Map each onto
+  an existing family with a weight/style tweak per-language.
+- **Identity pronouns.** `self` / `this` / `$` → dim cyan italic everywhere.
+
+---
+
+## 11. Accessibility Contract
+
+- **Body text** `#e6e8ec` on Void `#070709` — high contrast, low saturation. The
+  resting surface. (≈ 16:1, well above WCAG AAA.)
+- **Comments** `#8b909c` on Void — readable (≈ 6.5:1, AA for normal text).
+- **Stealth** `#383d49` on Void — sub-threshold **by design**; ignored text only,
+  never load-bearing.
+- **No neon on neon.** Saturated signal colors are never placed on saturated
+  backgrounds; signal always sits on a neutral or dim field.
+- Verify exact ratios per render target; near-black + neon halation is
+  panel-dependent and only confirmable on the actual display.
+
+---
+
+## 12. Rules with Teeth
+
+- **Red is danger. Violet is attention.** Neither ever appears inside code.
+- **Cyan is information and action.** Never errors, never destructive.
+- **Amber is warning — UI only.** It never enters a buffer.
+- **Bright = escalation.** If nothing changed, don't use a bright variant.
 - **Backgrounds stay dark.** Text and state carry the signal.
-- **No random accents.** If a color has no semantic reason, it’s wrong.
+- **One color, one meaning.** If a color has no semantic reason, it's wrong.
+- **Loud is earned by role.** Vivid syntax is fine; uniform saturation is noise.
+- **Scarcity is the weapon.** A signal only carries information when it is rare.
 
-Apex Neon is not a palette. It’s a rule system with teeth.
+Apex Neon is not a palette. It's a rule system with teeth.
+
+---
+
+## Open calibrations (verify on a real buffer — not on paper)
+
+1. **Cyan budget in dense code.** Functions, bang-macros, `self`, and info/links
+   all live in cyan. A function-heavy file may read as a cyan wash. If so, drop
+   functions to mid-cyan and reserve bright `#5af3ff` for sparse use.
+2. **Blue vs cyan separability.** `#2e6bff` (kinds) vs `#5af3ff` (actions) are both
+   cool and adjacent. Types-vs-functions is a constant distinction; confirm they
+   split cleanly on `#070709` first.
+3. **Green double duty.** Values (`#2bffb2`) and success (`#00ff99`) are close.
+   Low collision risk (success rarely renders inside code), but noted.

dist/.gitignore

@@ -0,0 +1,3 @@
+# Release artifacts (tarballs)
+releases/
+*.tar.gz

dist/alacritty/apex-aeon.toml

@@ -0,0 +1,64 @@
+# APEX AEON — Alacritty theme (colors only)
+# v2 spine: red = danger · violet = attention · cyan = info
+
+[colors.primary]
+background = "#f1f3f7"
+foreground = "#16181d"
+dim_foreground = "#5c6270"
+bright_foreground = "#f1f3f7"
+
+[colors.cursor]
+text = "#f1f3f7"
+cursor = "#7c2fd6"
+
+[colors.vi_mode_cursor]
+text = "#f1f3f7"
+cursor = "#8c3dd0"
+
+[colors.selection]
+text = "#16181d"
+background = "#efe2fb"
+
+[colors.search.matches]
+foreground = "#16181d"
+background = "#efe2fb"
+
+[colors.search.focused_match]
+foreground = "#f1f3f7"
+background = "#8c3dd0"
+
+[colors.hints.start]
+foreground = "#f1f3f7"
+background = "#a86b00"
+
+[colors.hints.end]
+foreground = "#f1f3f7"
+background = "#0080a6"
+
+[colors.line_indicator]
+foreground = "None"
+background = "None"
+
+[colors.footer_bar]
+foreground = "#16181d"
+background = "#e7eaf0"
+
+[colors.normal]
+black   = "#16181d"
+red     = "#c8003a"
+green   = "#00875a"
+yellow  = "#a86b00"
+blue    = "#2148c0"
+magenta = "#7c2fd6"
+cyan    = "#0080a6"
+white   = "#c2c8d4"
+
+[colors.bright]
+black   = "#5c6270"
+red     = "#9e0030"
+green   = "#006e49"
+yellow  = "#8a5800"
+blue    = "#1633a0"
+magenta = "#6a1fb8"
+cyan    = "#0e6e92"
+white   = "#f1f3f7"

dist/alacritty/apex-neon.toml

@@ -0,0 +1,64 @@
+# APEX NEON — Alacritty theme (colors only)
+# v2 spine: red = danger · violet = attention · cyan = info
+
+[colors.primary]
+background = "#070709"
+foreground = "#e6e8ec"
+dim_foreground = "#8b909c"
+bright_foreground = "#ffffff"
+
+[colors.cursor]
+text = "#070709"
+cursor = "#d68fff"
+
+[colors.vi_mode_cursor]
+text = "#070709"
+cursor = "#b14dff"
+
+[colors.selection]
+text = "#e6e8ec"
+background = "#3a1a4d"
+
+[colors.search.matches]
+foreground = "#e6e8ec"
+background = "#3a1a4d"
+
+[colors.search.focused_match]
+foreground = "#070709"
+background = "#b14dff"
+
+[colors.hints.start]
+foreground = "#070709"
+background = "#ffb700"
+
+[colors.hints.end]
+foreground = "#070709"
+background = "#00eaff"
+
+[colors.line_indicator]
+foreground = "None"
+background = "None"
+
+[colors.footer_bar]
+foreground = "#e6e8ec"
+background = "#101218"
+
+[colors.normal]
+black   = "#070709"
+red     = "#ff0044"
+green   = "#00ff99"
+yellow  = "#ffb700"
+blue    = "#2e6bff"
+magenta = "#9d00ff"
+cyan    = "#00eaff"
+white   = "#e6e8ec"
+
+[colors.bright]
+black   = "#383d49"
+red     = "#ff3b3b"
+green   = "#2bffb2"
+yellow  = "#ffd24d"
+blue    = "#5b8cff"
+magenta = "#c84dff"
+cyan    = "#5af3ff"
+white   = "#ffffff"

dist/btop/apex-aeon.theme

@@ -0,0 +1,90 @@
+# Apex Aeon — Btop Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Main background, empty for terminal default, black for dark themes
+theme[main_bg]="#f1f3f7"
+
+# Main text color
+theme[main_fg]="#16181d"
+
+# Title color for boxes
+theme[title]="#16181d"
+
+# Highlight color for keyboard shortcuts — violet attention accent
+theme[hi_fg]="#7c2fd6"
+
+# Background color of selected item in processes box — violet field
+theme[selected_bg]="#efe2fb"
+
+# Foreground color of selected item in processes box
+theme[selected_fg]="#16181d"
+
+# Color of inactive/disabled text
+theme[inactive_fg]="#5c6270"
+
+# Color of text appearing on top of graphs, i.e. usage percentage
+theme[graph_text]="#5c6270"
+
+# Background color of the percentage meters
+theme[meter_bg]="#e7eaf0"
+
+# Misc colors for processes box including mini cpu graphs, used memory percentage, and entries filter
+theme[proc_misc]="#0080a6"
+
+# Cpu box outline color
+theme[cpu_box]="#c2c8d4"
+
+# Memory box outline color
+theme[mem_box]="#c2c8d4"
+
+# Net box outline color
+theme[net_box]="#c2c8d4"
+
+# Processes box outline color
+theme[proc_box]="#c2c8d4"
+
+# Box divider line and small boxes line color
+theme[div_line]="#c2c8d4"
+
+# Heat gradients: calm info -> special -> danger red at the hot end
+# Temperature graph colors
+theme[temp_start]="#0080a6"
+theme[temp_mid]="#6a1fb8"
+theme[temp_end]="#c8003a"
+
+# CPU graph colors
+theme[cpu_start]="#0080a6"
+theme[cpu_mid]="#6a1fb8"
+theme[cpu_end]="#c8003a"
+
+# Mem graph colors
+theme[free_start]="#00875a"
+theme[free_mid]="#a86b00"
+theme[free_end]="#c8003a"
+
+theme[cached_start]="#0080a6"
+theme[cached_mid]="#6a1fb8"
+theme[cached_end]="#c8003a"
+
+theme[available_start]="#00875a"
+theme[available_mid]="#a86b00"
+theme[available_end]="#c8003a"
+
+theme[used_start]="#0080a6"
+theme[used_mid]="#6a1fb8"
+theme[used_end]="#c8003a"
+
+# Download graph colors
+theme[download_start]="#0080a6"
+theme[download_mid]="#6a1fb8"
+theme[download_end]="#c8003a"
+
+# Upload graph colors
+theme[upload_start]="#0080a6"
+theme[upload_mid]="#6a1fb8"
+theme[upload_end]="#c8003a"
+
+# Process path color
+theme[process_start]="#0080a6"
+theme[process_mid]="#6a1fb8"
+theme[process_end]="#c8003a"

dist/btop/apex-neon.theme

@@ -0,0 +1,90 @@
+# Apex Neon — Btop Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Main background, empty for terminal default, black for dark themes
+theme[main_bg]="#070709"
+
+# Main text color
+theme[main_fg]="#e6e8ec"
+
+# Title color for boxes
+theme[title]="#e6e8ec"
+
+# Highlight color for keyboard shortcuts — violet attention accent
+theme[hi_fg]="#d68fff"
+
+# Background color of selected item in processes box — violet field
+theme[selected_bg]="#3a1a4d"
+
+# Foreground color of selected item in processes box
+theme[selected_fg]="#e6e8ec"
+
+# Color of inactive/disabled text
+theme[inactive_fg]="#8b909c"
+
+# Color of text appearing on top of graphs, i.e. usage percentage
+theme[graph_text]="#8b909c"
+
+# Background color of the percentage meters
+theme[meter_bg]="#101218"
+
+# Misc colors for processes box including mini cpu graphs, used memory percentage, and entries filter
+theme[proc_misc]="#00eaff"
+
+# Cpu box outline color
+theme[cpu_box]="#262a34"
+
+# Memory box outline color
+theme[mem_box]="#262a34"
+
+# Net box outline color
+theme[net_box]="#262a34"
+
+# Processes box outline color
+theme[proc_box]="#262a34"
+
+# Box divider line and small boxes line color
+theme[div_line]="#262a34"
+
+# Heat gradients: calm info -> special -> danger red at the hot end
+# Temperature graph colors
+theme[temp_start]="#00eaff"
+theme[temp_mid]="#9d00ff"
+theme[temp_end]="#ff0044"
+
+# CPU graph colors
+theme[cpu_start]="#00eaff"
+theme[cpu_mid]="#9d00ff"
+theme[cpu_end]="#ff0044"
+
+# Mem graph colors
+theme[free_start]="#00ff99"
+theme[free_mid]="#ffb700"
+theme[free_end]="#ff0044"
+
+theme[cached_start]="#00eaff"
+theme[cached_mid]="#9d00ff"
+theme[cached_end]="#ff0044"
+
+theme[available_start]="#00ff99"
+theme[available_mid]="#ffb700"
+theme[available_end]="#ff0044"
+
+theme[used_start]="#00eaff"
+theme[used_mid]="#9d00ff"
+theme[used_end]="#ff0044"
+
+# Download graph colors
+theme[download_start]="#00eaff"
+theme[download_mid]="#9d00ff"
+theme[download_end]="#ff0044"
+
+# Upload graph colors
+theme[upload_start]="#00eaff"
+theme[upload_mid]="#9d00ff"
+theme[upload_end]="#ff0044"
+
+# Process path color
+theme[process_start]="#00eaff"
+theme[process_mid]="#9d00ff"
+theme[process_end]="#ff0044"

dist/fuzzel/apex-aeon-fuzzel.ini

@@ -0,0 +1,15 @@
+# Apex Aeon — Fuzzel Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+[colors]
+background=f1f3f7ff
+text=16181dff
+match=0080a6ff
+selection=efe2fbff
+selection-text=16181dff
+selection-match=0080a6ff
+border=0080a6ff
+
+[border]
+width=2
+radius=0

dist/fuzzel/apex-neon-fuzzel.ini

@@ -0,0 +1,15 @@
+# Apex Neon — Fuzzel Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+[colors]
+background=070709ff
+text=e6e8ecff
+match=00eaffff
+selection=3a1a4dff
+selection-text=e6e8ecff
+selection-match=00eaffff
+border=00eaffff
+
+[border]
+width=2
+radius=0

dist/ghostty/apex-aeon

@@ -0,0 +1,30 @@
+# Apex Aeon - Ghostty theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+background = #f1f3f7
+foreground = #16181d
+
+# Cursor: the crosshair — violet, dark ink under the block
+cursor-color = #7c2fd6
+cursor-text = #f1f3f7
+
+# Selection: violet field (attention, not danger)
+selection-background = #efe2fb
+selection-foreground = #16181d
+
+palette = 0=#16181d
+palette = 1=#c8003a
+palette = 2=#00875a
+palette = 3=#a86b00
+palette = 4=#2148c0
+palette = 5=#7c2fd6
+palette = 6=#0080a6
+palette = 7=#c2c8d4
+palette = 8=#5c6270
+palette = 9=#9e0030
+palette = 10=#006e49
+palette = 11=#8a5800
+palette = 12=#1633a0
+palette = 13=#6a1fb8
+palette = 14=#0e6e92
+palette = 15=#f1f3f7

dist/ghostty/apex-neon

@@ -0,0 +1,30 @@
+# Apex Neon - Ghostty theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+background = #070709
+foreground = #e6e8ec
+
+# Cursor: the crosshair — violet, dark ink under the block
+cursor-color = #d68fff
+cursor-text = #070709
+
+# Selection: violet field (attention, not danger)
+selection-background = #3a1a4d
+selection-foreground = #e6e8ec
+
+palette = 0=#070709
+palette = 1=#ff0044
+palette = 2=#00ff99
+palette = 3=#ffb700
+palette = 4=#2e6bff
+palette = 5=#9d00ff
+palette = 6=#00eaff
+palette = 7=#e6e8ec
+palette = 8=#383d49
+palette = 9=#ff3b3b
+palette = 10=#2bffb2
+palette = 11=#ffd24d
+palette = 12=#5b8cff
+palette = 13=#c84dff
+palette = 14=#5af3ff
+palette = 15=#ffffff

dist/gtk4/gtk.css

@@ -0,0 +1,131 @@
+/* Apex Theme System — GTK4 / Libadwaita */
+/* v2 spine: red = danger · violet = attention · cyan = info */
+
+
+/* Scheme: Apex Neon (dark) */
+
+@media (prefers-color-scheme: dark) {
+
+  :root {
+    /* Core Surfaces */
+    @define-color window_bg_color #070709;
+    @define-color window_fg_color #e6e8ec;
+
+    @define-color view_bg_color #070709;
+    @define-color view_fg_color #e6e8ec;
+
+    @define-color headerbar_bg_color #101218;
+    @define-color headerbar_fg_color #e6e8ec;
+    @define-color headerbar_border_color #262a34;
+    @define-color headerbar_backdrop_color @window_bg_color;
+    @define-color headerbar_shade_color rgba(0, 0, 0, 0.07);
+
+    @define-color popover_bg_color #101218;
+    @define-color popover_fg_color #e6e8ec;
+
+    @define-color card_bg_color #101218;
+    @define-color card_fg_color #e6e8ec;
+    @define-color card_shade_color rgba(0, 0, 0, 0.07);
+
+    @define-color dialog_bg_color #101218;
+    @define-color dialog_fg_color #e6e8ec;
+
+    /* Accents */
+    @define-color accent_color #00eaff;
+    @define-color accent_bg_color #00eaff;
+    @define-color accent_fg_color #070709;
+
+    /* Destructive = danger red (spec §5,6) */
+    @define-color destructive_color #ff0044;
+    @define-color destructive_bg_color #ff0044;
+    @define-color destructive_fg_color #070709;
+
+    @define-color success_color #00ff99;
+    @define-color success_bg_color #00ff99;
+    @define-color success_fg_color #070709;
+
+    @define-color warning_color #ffb700;
+    @define-color warning_bg_color #ffb700;
+    @define-color warning_fg_color #070709;
+
+    @define-color error_color #ff0044;
+    @define-color error_bg_color #ff0044;
+    @define-color error_fg_color #070709;
+
+    /* UI Elements */
+    @define-color borders #262a34;
+    @define-color sidebar_bg_color #101218;
+    @define-color sidebar_fg_color #e6e8ec;
+    @define-color sidebar_backdrop_color @window_bg_color;
+    @define-color sidebar_shade_color rgba(0, 0, 0, 0.07);
+
+    /* Custom Apex Palette */
+    @define-color apex_focus #d68fff;
+    @define-color apex_void #070709;
+    @define-color apex_subtle #383d49;
+  }
+}
+
+/* Scheme: Apex Aeon (light) */
+
+@media (prefers-color-scheme: light) {
+
+  :root {
+    /* Core Surfaces */
+    @define-color window_bg_color #f1f3f7;
+    @define-color window_fg_color #16181d;
+
+    @define-color view_bg_color #f1f3f7;
+    @define-color view_fg_color #16181d;
+
+    @define-color headerbar_bg_color #e7eaf0;
+    @define-color headerbar_fg_color #16181d;
+    @define-color headerbar_border_color #c2c8d4;
+    @define-color headerbar_backdrop_color @window_bg_color;
+    @define-color headerbar_shade_color rgba(0, 0, 0, 0.07);
+
+    @define-color popover_bg_color #e7eaf0;
+    @define-color popover_fg_color #16181d;
+
+    @define-color card_bg_color #e7eaf0;
+    @define-color card_fg_color #16181d;
+    @define-color card_shade_color rgba(0, 0, 0, 0.07);
+
+    @define-color dialog_bg_color #e7eaf0;
+    @define-color dialog_fg_color #16181d;
+
+    /* Accents */
+    @define-color accent_color #0080a6;
+    @define-color accent_bg_color #0080a6;
+    @define-color accent_fg_color #f1f3f7;
+
+    /* Destructive = danger red (spec §5,6) */
+    @define-color destructive_color #c8003a;
+    @define-color destructive_bg_color #c8003a;
+    @define-color destructive_fg_color #f1f3f7;
+
+    @define-color success_color #00875a;
+    @define-color success_bg_color #00875a;
+    @define-color success_fg_color #f1f3f7;
+
+    @define-color warning_color #a86b00;
+    @define-color warning_bg_color #a86b00;
+    @define-color warning_fg_color #f1f3f7;
+
+    @define-color error_color #c8003a;
+    @define-color error_bg_color #c8003a;
+    @define-color error_fg_color #f1f3f7;
+
+    /* UI Elements */
+    @define-color borders #c2c8d4;
+    @define-color sidebar_bg_color #e7eaf0;
+    @define-color sidebar_fg_color #16181d;
+    @define-color sidebar_backdrop_color @window_bg_color;
+    @define-color sidebar_shade_color rgba(0, 0, 0, 0.07);
+
+    /* Custom Apex Palette */
+    @define-color apex_focus #7c2fd6;
+    @define-color apex_void #f1f3f7;
+    @define-color apex_subtle #c8cdd8;
+  }
+}

dist/hyprland/apex-aeon-colors.conf

@@ -0,0 +1,83 @@
+#############################
+### APEX AEON THEME ###
+#############################
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Backgrounds — the readable ground
+$base = rgb(f1f3f7)
+$baseAlpha = f1f3f7
+
+$surface = rgb(e7eaf0)
+$surfaceAlpha = e7eaf0
+
+$overlay = rgb(c2c8d4)
+$overlayAlpha = c2c8d4
+
+$muted = rgb(c8cdd8)
+$mutedAlpha = c8cdd8
+
+$subtle = rgb(c8cdd8)
+$subtleAlpha = c8cdd8
+
+# Text
+$text = rgb(16181d)
+$textAlpha = 16181d
+
+# Accents
+# Danger red — active borders, alerts (spec §5)
+$love = rgb(c8003a)
+$loveAlpha = c8003a
+
+# Warning amber
+$gold = rgb(a86b00)
+$goldAlpha = a86b00
+
+# Success green
+$pine = rgb(00875a)
+$pineAlpha = 00875a
+
+# Info cyan
+$foam = rgb(0080a6)
+$foamAlpha = 0080a6
+
+# Special / root violet
+$iris = rgb(6a1fb8)
+$irisAlpha = 6a1fb8
+
+# Escalation red (hotter than base)
+$rose = rgb(9e0030)
+$roseAlpha = 9e0030
+
+# Highlight variants
+$highlight_low = rgb(e7eaf0)
+$highlight_lowAlpha = e7eaf0
+
+$highlight_med = rgb(c2c8d4)
+$highlight_medAlpha = c2c8d4
+
+$highlight_high = rgb(c8cdd8)
+$highlight_highAlpha = c8cdd8
+
+# Theme-specific definitions
+$splash_text = rgba($textAlphaee)
+$dec_shadow = rgba(000000ee) # Hard shadows
+
+# Border configurations — active window = danger red into special violet
+$border_active = rgba($loveAlphaff) rgba($irisAlphaff) 45deg
+$border_inactive = rgba($mutedAlpha44) rgba($surfaceAlpha44) 45deg
+
+$border_nogroup_active = rgba($foamAlphaff) rgba($pineAlphaff) 45deg
+$border_nogroup_inactive = rgba($mutedAlpha44) rgba($surfaceAlpha44) 45deg
+
+$border_group_active = rgba($goldAlphaff) rgba($loveAlphaff) 45deg
+$border_group_inactive = rgba($mutedAlpha66) rgba($surfaceAlpha66) 45deg
+
+$border_grouplocked_active = rgba($foamAlphaff) rgba($irisAlphaff) 45deg
+$border_grouplocked_inactive = rgba($foamAlpha66) rgba($irisAlpha66) 45deg
+
+# Group bar configurations
+$groupbar_text = rgba($baseAlphaff)
+$groupbar_active = rgba($loveAlphaff) rgba($irisAlphaaa)
+$groupbar_inactive = rgba($surfaceAlphaee) rgba($mutedAlphaaa)
+$groupbar_grouplocked_active = rgba($foamAlphaff) rgba($irisAlphaff)
+$groupbar_grouplocked_inactive = rgba($foamAlphaaa) rgba($irisAlphaaa)

dist/hyprland/apex-neon-colors.conf

@@ -0,0 +1,83 @@
+#############################
+### APEX NEON THEME ###
+#############################
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Backgrounds — the readable ground
+$base = rgb(070709)
+$baseAlpha = 070709
+
+$surface = rgb(101218)
+$surfaceAlpha = 101218
+
+$overlay = rgb(262a34)
+$overlayAlpha = 262a34
+
+$muted = rgb(383d49)
+$mutedAlpha = 383d49
+
+$subtle = rgb(383d49)
+$subtleAlpha = 383d49
+
+# Text
+$text = rgb(e6e8ec)
+$textAlpha = e6e8ec
+
+# Accents
+# Danger red — active borders, alerts (spec §5)
+$love = rgb(ff0044)
+$loveAlpha = ff0044
+
+# Warning amber
+$gold = rgb(ffb700)
+$goldAlpha = ffb700
+
+# Success green
+$pine = rgb(00ff99)
+$pineAlpha = 00ff99
+
+# Info cyan
+$foam = rgb(00eaff)
+$foamAlpha = 00eaff
+
+# Special / root violet
+$iris = rgb(9d00ff)
+$irisAlpha = 9d00ff
+
+# Escalation red (hotter than base)
+$rose = rgb(ff3b3b)
+$roseAlpha = ff3b3b
+
+# Highlight variants
+$highlight_low = rgb(101218)
+$highlight_lowAlpha = 101218
+
+$highlight_med = rgb(262a34)
+$highlight_medAlpha = 262a34
+
+$highlight_high = rgb(383d49)
+$highlight_highAlpha = 383d49
+
+# Theme-specific definitions
+$splash_text = rgba($textAlphaee)
+$dec_shadow = rgba(000000ee) # Hard shadows
+
+# Border configurations — active window = danger red into special violet
+$border_active = rgba($loveAlphaff) rgba($irisAlphaff) 45deg
+$border_inactive = rgba($mutedAlpha44) rgba($surfaceAlpha44) 45deg
+
+$border_nogroup_active = rgba($foamAlphaff) rgba($pineAlphaff) 45deg
+$border_nogroup_inactive = rgba($mutedAlpha44) rgba($surfaceAlpha44) 45deg
+
+$border_group_active = rgba($goldAlphaff) rgba($loveAlphaff) 45deg
+$border_group_inactive = rgba($mutedAlpha66) rgba($surfaceAlpha66) 45deg
+
+$border_grouplocked_active = rgba($foamAlphaff) rgba($irisAlphaff) 45deg
+$border_grouplocked_inactive = rgba($foamAlpha66) rgba($irisAlpha66) 45deg
+
+# Group bar configurations
+$groupbar_text = rgba($baseAlphaff)
+$groupbar_active = rgba($loveAlphaff) rgba($irisAlphaaa)
+$groupbar_inactive = rgba($surfaceAlphaee) rgba($mutedAlphaaa)
+$groupbar_grouplocked_active = rgba($foamAlphaff) rgba($irisAlphaff)
+$groupbar_grouplocked_inactive = rgba($foamAlphaaa) rgba($irisAlphaaa)

dist/kitty/apex-aeon.conf

@@ -0,0 +1,66 @@
+## APEX AEON - KITTY THEME ##
+## v2 spine: red = danger · violet = attention · cyan = info
+
+# --- Core ---
+foreground            #16181d
+background            #f1f3f7
+
+# Selection: violet field (attention, not danger)
+selection_background  #efe2fb
+selection_foreground  #16181d
+
+# Cursor: the crosshair — violet, dark ink under the block
+cursor                #7c2fd6
+cursor_text_color     #f1f3f7
+cursor_shape          beam
+
+# URLs: informational cyan
+url_color             #0080a6
+
+# Borders: active window = danger red (spec §5)
+active_border_color   #c8003a
+inactive_border_color #c2c8d4
+
+# Visual bell: hot red
+visual_bell_color     #9e0030
+
+# Spacing
+window_padding_width  4
+
+# --- 16-COLOR ANSI TABLE (Apex Aeon spec §9) ---
+
+# Normal bank (0–7)
+# color0: Black (bg)
+color0   #16181d
+# color1: Red (danger)
+color1   #c8003a
+# color2: Green (success)
+color2   #00875a
+# color3: Yellow (warning)
+color3   #a86b00
+# color4: Blue (kinds / structural)
+color4   #2148c0
+# color5: Magenta (special / root)
+color5   #7c2fd6
+# color6: Cyan (info / actions)
+color6   #0080a6
+# color7: White (text)
+color7   #c2c8d4
+
+# Bright bank (8–15) — escalation / active states only
+# color8: Bright black (muted / separators)
+color8   #5c6270
+# color9: Bright red (escalation)
+color9   #9e0030
+# color10: Bright green (active success)
+color10  #006e49
+# color11: Bright yellow (urgent warning)
+color11  #8a5800
+# color12: Bright blue (active flow)
+color12  #1633a0
+# color13: Bright magenta (elevated attention)
+color13  #6a1fb8
+# color14: Bright cyan (active tech signal)
+color14  #0e6e92
+# color15: Bright white (extreme highlight)
+color15  #f1f3f7

dist/kitty/apex-neon.conf

@@ -0,0 +1,66 @@
+## APEX NEON - KITTY THEME ##
+## v2 spine: red = danger · violet = attention · cyan = info
+
+# --- Core ---
+foreground            #e6e8ec
+background            #070709
+
+# Selection: violet field (attention, not danger)
+selection_background  #3a1a4d
+selection_foreground  #e6e8ec
+
+# Cursor: the crosshair — violet, dark ink under the block
+cursor                #d68fff
+cursor_text_color     #070709
+cursor_shape          beam
+
+# URLs: informational cyan
+url_color             #00eaff
+
+# Borders: active window = danger red (spec §5)
+active_border_color   #ff0044
+inactive_border_color #262a34
+
+# Visual bell: hot red
+visual_bell_color     #ff3b3b
+
+# Spacing
+window_padding_width  4
+
+# --- 16-COLOR ANSI TABLE (Apex Neon spec §9) ---
+
+# Normal bank (0–7)
+# color0: Black (bg)
+color0   #070709
+# color1: Red (danger)
+color1   #ff0044
+# color2: Green (success)
+color2   #00ff99
+# color3: Yellow (warning)
+color3   #ffb700
+# color4: Blue (kinds / structural)
+color4   #2e6bff
+# color5: Magenta (special / root)
+color5   #9d00ff
+# color6: Cyan (info / actions)
+color6   #00eaff
+# color7: White (text)
+color7   #e6e8ec
+
+# Bright bank (8–15) — escalation / active states only
+# color8: Bright black (muted / separators)
+color8   #383d49
+# color9: Bright red (escalation)
+color9   #ff3b3b
+# color10: Bright green (active success)
+color10  #2bffb2
+# color11: Bright yellow (urgent warning)
+color11  #ffd24d
+# color12: Bright blue (active flow)
+color12  #5b8cff
+# color13: Bright magenta (elevated attention)
+color13  #c84dff
+# color14: Bright cyan (active tech signal)
+color14  #5af3ff
+# color15: Bright white (extreme highlight)
+color15  #ffffff

dist/nushell/apex-aeon.nu

@@ -0,0 +1,70 @@
+# Apex Aeon — Nushell color config
+# v2 spine: red = danger · violet = attention · cyan = info
+# Usage: add `use /path/to/apex-aeon.nu` to config.nu
+
+export-env {
+    $env.config.color_config = {
+
+        # --- Chrome ---
+        separator:                    "#5c6270"
+        leading_trailing_space_bg:  { bg: "#c2c8d4" }
+        header:                     { fg: "#2148c0" attr: b }
+        empty:                        "#5c6270"
+        row_index:                  { fg: "#5c6270" attr: b }
+        hints:                        "#c8cdd8"
+
+        # --- Primitive types ---
+        string:                     { fg: "#00734d" }
+        int:                        { fg: "#00875a" }
+        float:                      { fg: "#00875a" }
+        bool:                       { fg: "#00875a" }
+        filesize:                   { fg: "#0080a6" }
+        duration:                   { fg: "#0080a6" }
+        datetime:                   { fg: "#0080a6" }
+        range:                      { fg: "#16181d" }
+        record:                     { fg: "#16181d" }
+        list:                       { fg: "#16181d" }
+        block:                      { fg: "#1633a0" }
+        nothing:                    { fg: "#5c6270" }
+        binary:                     { fg: "#0080a6" }
+
+        # --- Shapes (REPL syntax highlighting) ---
+        # The REPL line is a code buffer: amber/violet/red stay out (keystone).
+        shape_string:               { fg: "#00734d" }
+        shape_string_interpolation: { fg: "#00734d" attr: b }
+        shape_int:                  { fg: "#00875a" }
+        shape_float:                { fg: "#00875a" }
+        shape_bool:                 { fg: "#00875a" }
+        shape_datetime:             { fg: "#0080a6" }
+        shape_binary:               { fg: "#0080a6" }
+        shape_filepath:             { fg: "#0080a6" }
+        shape_directory:            { fg: "#0080a6" }
+        shape_globpattern:          { fg: "#0080a6" }
+        shape_glob_interpolation:   { fg: "#0080a6" }
+        shape_nothing:              { fg: "#5c6270" }
+        shape_variable:             { fg: "#16181d" }
+        shape_vardecl:              { fg: "#16181d" }
+        shape_operator:             { fg: "#5c6270" }
+        shape_external:             { fg: "#0e6e92" }
+        shape_externalarg:          { fg: "#16181d" }
+        shape_internalcall:         { fg: "#0e6e92" attr: b }
+        shape_signature:            { fg: "#0e6e92" }
+        shape_flag:                 { fg: "#2148c0" }
+        shape_pipe:                 { fg: "#1633a0" attr: b }
+        shape_redirection:          { fg: "#5c6270" }
+        shape_and:                  { fg: "#1633a0" attr: b }
+        shape_or:                   { fg: "#1633a0" attr: b }
+        shape_keyword:              { fg: "#1633a0" attr: b }
+        shape_block:                { fg: "#1633a0" }
+        shape_closure:              { fg: "#1633a0" }
+        shape_list:                 { fg: "#16181d" }
+        shape_record:               { fg: "#16181d" }
+        shape_table:                { fg: "#16181d" }
+        shape_range:                { fg: "#16181d" }
+        shape_literal:              { fg: "#16181d" }
+        shape_custom:               { fg: "#16181d" }
+        shape_match_pattern:        { fg: "#1633a0" }
+        shape_matching_brackets:    { attr: u }
+        shape_garbage:              { fg: "#c8003a" attr: b }
+    }
+}

dist/nushell/apex-neon.nu

@@ -0,0 +1,70 @@
+# Apex Neon — Nushell color config
+# v2 spine: red = danger · violet = attention · cyan = info
+# Usage: add `use /path/to/apex-neon.nu` to config.nu
+
+export-env {
+    $env.config.color_config = {
+
+        # --- Chrome ---
+        separator:                    "#8b909c"
+        leading_trailing_space_bg:  { bg: "#262a34" }
+        header:                     { fg: "#7db4ff" attr: b }
+        empty:                        "#8b909c"
+        row_index:                  { fg: "#8b909c" attr: b }
+        hints:                        "#383d49"
+
+        # --- Primitive types ---
+        string:                     { fg: "#2bffb2" }
+        int:                        { fg: "#37dba0" }
+        float:                      { fg: "#37dba0" }
+        bool:                       { fg: "#37dba0" }
+        filesize:                   { fg: "#00eaff" }
+        duration:                   { fg: "#00eaff" }
+        datetime:                   { fg: "#00eaff" }
+        range:                      { fg: "#e6e8ec" }
+        record:                     { fg: "#e6e8ec" }
+        list:                       { fg: "#e6e8ec" }
+        block:                      { fg: "#5b8cff" }
+        nothing:                    { fg: "#8b909c" }
+        binary:                     { fg: "#00eaff" }
+
+        # --- Shapes (REPL syntax highlighting) ---
+        # The REPL line is a code buffer: amber/violet/red stay out (keystone).
+        shape_string:               { fg: "#2bffb2" }
+        shape_string_interpolation: { fg: "#2bffb2" attr: b }
+        shape_int:                  { fg: "#37dba0" }
+        shape_float:                { fg: "#37dba0" }
+        shape_bool:                 { fg: "#37dba0" }
+        shape_datetime:             { fg: "#00eaff" }
+        shape_binary:               { fg: "#00eaff" }
+        shape_filepath:             { fg: "#00eaff" }
+        shape_directory:            { fg: "#00eaff" }
+        shape_globpattern:          { fg: "#00eaff" }
+        shape_glob_interpolation:   { fg: "#00eaff" }
+        shape_nothing:              { fg: "#8b909c" }
+        shape_variable:             { fg: "#e6e8ec" }
+        shape_vardecl:              { fg: "#e6e8ec" }
+        shape_operator:             { fg: "#c2c8d4" }
+        shape_external:             { fg: "#5af3ff" }
+        shape_externalarg:          { fg: "#e6e8ec" }
+        shape_internalcall:         { fg: "#5af3ff" attr: b }
+        shape_signature:            { fg: "#5af3ff" }
+        shape_flag:                 { fg: "#2e6bff" }
+        shape_pipe:                 { fg: "#5b8cff" attr: b }
+        shape_redirection:          { fg: "#c2c8d4" }
+        shape_and:                  { fg: "#5b8cff" attr: b }
+        shape_or:                   { fg: "#5b8cff" attr: b }
+        shape_keyword:              { fg: "#5b8cff" attr: b }
+        shape_block:                { fg: "#5b8cff" }
+        shape_closure:              { fg: "#5b8cff" }
+        shape_list:                 { fg: "#e6e8ec" }
+        shape_record:               { fg: "#e6e8ec" }
+        shape_table:                { fg: "#e6e8ec" }
+        shape_range:                { fg: "#e6e8ec" }
+        shape_literal:              { fg: "#e6e8ec" }
+        shape_custom:               { fg: "#e6e8ec" }
+        shape_match_pattern:        { fg: "#5b8cff" }
+        shape_matching_brackets:    { attr: u }
+        shape_garbage:              { fg: "#ff0044" attr: b }
+    }
+}

dist/nvim/colors/apex-aeon.lua

@@ -0,0 +1,802 @@
+-- Apex Aeon: Standalone Theme Engine
+-- Philosophy: Signal over decoration. Red = danger. Violet = attention.
+-- Neither red nor violet ever appears inside the code buffer (spec §1, §12).
+
+local M = {}
+
+M.palette = {
+  -- NEUTRALS — the readable field --------------------------------------------
+  void    = "#f1f3f7",      -- Background (also: ink on a bright accent fill)
+  panel   = "#e7eaf0", -- Dark surface (statusline, floats, cursorline)
+  border  = "#c2c8d4",  -- Borders, separators
+  stealth = "#c8cdd8",  -- Ignored text only (sub-threshold by design)
+  dim     = "#5c6270",   -- Comments, muted labels (ghost)
+  text    = "#16181d",    -- Body text (stark / ink)
+  punct   = "#7d8390", -- Punctuation / delimiters (lifted neutral)
+  op      = "#5c6270",    -- Operators (neutral)
+  prop    = "#2e333d",    -- Fields / properties (dim body)
+
+  -- ATTENTION (violet) — cursor, search, matched pairs. NEVER syntax. --------
+  focus        = "#7c2fd6",    -- Cursor — the crosshair (hottest mark)
+  focus_active = "#8c3dd0", -- Current match, matched bracket / pair
+  focus_field  = "#efe2fb",  -- Search-set / selection background
+
+  -- DANGER (red) — error, destructive, alarm. NEVER syntax. ------------------
+  danger       = "#c8003a",   -- Error figure, destructive, active border
+  danger_field = "#fbe4e9",  -- Error region / delete background
+  danger_hot   = "#9e0030", -- Escalation
+
+  -- CODE HUES (buffer-safe) --------------------------------------------------
+  info    = "#0080a6",     -- Cyan — info / links
+  action  = "#0e6e92", -- Cyan — functions / methods
+  builtin = "#3a7d9c",  -- Cyan, dim — self / builtin
+  kind    = "#2148c0",     -- Blue — types / kinds
+  storage = "#1633a0",  -- Blue, heavy — storage / modifier / attribute
+  flow    = "#1633a0",  -- Bright-blue — control-flow navigation
+  value   = "#00734d",   -- Green — strings / values
+  escape  = "#2b8f63",   -- Green, bright — char / escape
+  const   = "#00875a", -- Green, cool — numbers / const
+  ok      = "#00875a",  -- Green — success state
+  warn    = "#a86b00",  -- Amber — warning (UI only)
+  special = "#6a1fb8",  -- Violet-deep — root / special only
+
+  -- DIFF grounds -------------------------------------------------------------
+  diff_add = "#e2f3ea",
+  diff_chg = "#f5ecda",
+  diff_del = "#fbe4e9",
+
+  -- ON-ACCENT INK ------------------------------------------------------------
+  ink = "#16181d", -- fg on a dim violet field (search / selection)
+}
+
+function M.load()
+  vim.cmd "hi clear"
+  if vim.fn.exists "syntax_on" then vim.cmd "syntax reset" end
+  vim.o.background = "light"
+  vim.g.colors_name = "apex-aeon"
+
+  -- Optional transparency: set g:apex_blend or g:apex_transparent to opt in.
+  local blend = vim.g.apex_blend
+  if type(blend) == "number" then
+    vim.o.winblend = blend
+    vim.o.pumblend = blend
+  elseif vim.g.apex_transparent == true then
+    vim.o.winblend = 20
+    vim.o.pumblend = 20
+  end
+
+  local p = M.palette
+  local groups = {
+    -- CANVAS & UI -----------------------------------------------------------
+    Normal = { fg = p.text, bg = p.void },
+    NormalNC = { fg = p.dim, bg = p.void }, -- Non-focused windows
+    SignColumn = { bg = p.void },
+    FoldColumn = { fg = p.stealth, bg = p.void },
+    VertSplit = { fg = p.border }, -- Deprecated in nvim 0.10, but good fallback
+    WinSeparator = { fg = p.border },
+    EndOfBuffer = { fg = p.void }, -- Hide tildes
+    NormalFloat = { fg = p.text, bg = p.panel },
+    FloatBorder = { fg = p.border, bg = p.panel },
+    MsgArea = { fg = p.text, bg = p.void },
+    WinBar = { fg = p.text, bg = p.panel },
+    WinBarNC = { fg = p.dim, bg = p.panel },
+
+    -- CURSOR & NAVIGATION ("Attention" — violet) ----------------------------
+    Cursor = { fg = p.void, bg = p.focus }, -- Violet crosshair
+    TermCursor = { fg = p.void, bg = p.focus },
+    CursorLine = { bg = p.panel },
+    CursorColumn = { bg = p.panel },
+    ColorColumn = { bg = p.panel },
+    CursorLineNr = { fg = p.focus, bold = true }, -- Violet line number (you are here)
+    LineNr = { fg = p.stealth }, -- Other lines fade out
+
+    -- SELECTION & SEARCH ("Region scanned" — violet field) ------------------
+    Visual = { fg = p.ink, bg = p.focus_field }, -- Dim violet field, fg preserved
+    VisualNOS = { fg = p.ink, bg = p.focus_field },
+
+    Search = { fg = p.ink, bg = p.focus_field }, -- Other matches: the set
+    IncSearch = { fg = p.void, bg = p.focus_active }, -- Acquiring
+    CurSearch = { fg = p.void, bg = p.focus_active, bold = true }, -- The one you are on
+
+    -- STATUS & MESSAGES -----------------------------------------------------
+    StatusLine = { fg = p.text, bg = p.panel },
+    StatusLineNC = { fg = p.dim, bg = p.void },
+    WildMenu = { fg = p.void, bg = p.focus_active },
+    Pmenu = { fg = p.text, bg = p.panel },
+    PmenuSel = { fg = p.void, bg = p.focus, bold = true }, -- Violet menu selection
+    PmenuKind = { fg = p.dim, bg = p.panel },
+    PmenuKindSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuExtra = { fg = p.dim, bg = p.panel },
+    PmenuExtraSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuMatch = { fg = p.info, bg = p.panel, bold = true },
+    PmenuMatchSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuSbar = { bg = p.panel },
+    PmenuThumb = { bg = p.stealth },
+    ErrorMsg = { fg = p.danger },
+    WarningMsg = { fg = p.warn },
+    MoreMsg = { fg = p.info },
+    ModeMsg = { fg = p.text },
+    TabLine = { fg = p.dim, bg = p.panel },
+    TabLineSel = { fg = p.text, bg = p.void, bold = true },
+    TabLineFill = { fg = p.panel, bg = p.panel },
+    QuickFixLine = { fg = p.text, bg = p.panel, bold = true },
+
+    -- SYNTAX: typed by grammatical role (spec §7) ---------------------------
+    -- blue = kinds · cyan = actions · green = values · neutral = connective
+    Comment = { fg = p.dim, italic = true }, -- Ghost — not a target
+
+    Constant = { fg = p.const }, -- Green (cool) — const values
+    String = { fg = p.value }, -- Green — strings
+    Character = { fg = p.value },
+    Number = { fg = p.const },
+    Boolean = { fg = p.const },
+    Float = { fg = p.const },
+
+    Identifier = { fg = p.text }, -- Variables (calm body)
+    Property = { fg = p.prop }, -- Fields / properties (dim body)
+    Function = { fg = p.action }, -- Cyan — actions
+    Builtin = { fg = p.builtin, italic = true }, -- Cyan dim — self / builtin
+
+    Statement = { fg = p.flow, bold = true }, -- Bright-blue — control flow
+    Conditional = { fg = p.flow, bold = true },
+    Repeat = { fg = p.flow, bold = true },
+    Label = { fg = p.flow },
+    Operator = { fg = p.op }, -- Neutral
+    Keyword = { fg = p.storage }, -- Blue — storage / modifier
+    Exception = { fg = p.flow, bold = true }, -- Control flow (NOT danger — never red in code)
+
+    PreProc = { fg = p.action }, -- Cyan — preprocessor / macro ceremony
+    Include = { fg = p.storage }, -- Blue — declarative (use / import)
+    Define = { fg = p.action },
+    Macro = { fg = p.action, italic = true }, -- Cyan — bang-macros (action + ceremony)
+    PreCondit = { fg = p.action },
+
+    Type = { fg = p.kind }, -- Blue — kinds
+    StorageClass = { fg = p.storage, bold = true }, -- Blue heavy
+    Structure = { fg = p.kind },
+    Typedef = { fg = p.kind },
+    Attribute = { fg = p.storage, italic = true }, -- Blue declarative — #[derive], decorators
+
+    Special = { fg = p.escape }, -- Green — special tokens (escapes-adjacent)
+    SpecialChar = { fg = p.escape }, -- Green bright — string escapes / regex
+    Tag = { fg = p.kind }, -- Blue — structural HTML/XML tags
+    Delimiter = { fg = p.punct }, -- Neutral, lifted
+    Debug = { fg = p.special },
+
+    Underlined = { fg = p.info, underline = true },
+    Ignore = { fg = p.stealth },
+    Error = { fg = p.danger },
+    Todo = { fg = p.void, bg = p.warn, bold = true },
+    Title = { fg = p.info, bold = true },
+
+    MatchParen = { fg = p.focus_active, bold = true }, -- Attention — matched pair (violet)
+    Whitespace = { fg = p.border },
+    NonText = { fg = p.border },
+    SpecialKey = { fg = p.border },
+    SpellBad = { sp = p.danger, undercurl = true },
+    SpellCap = { sp = p.warn, undercurl = true },
+    SpellRare = { sp = p.info, undercurl = true },
+    SpellLocal = { sp = p.dim, undercurl = true },
+    LspReferenceText = { bg = p.panel },
+    LspReferenceRead = { bg = p.panel },
+    LspReferenceWrite = { bg = p.panel, bold = true },
+    LspSignatureActiveParameter = { fg = p.void, bg = p.info, bold = true },
+    LspInlayHint = { fg = p.dim, bg = p.panel },
+    LspCodeLens = { fg = p.dim },
+    LspCodeLensSeparator = { fg = p.stealth },
+    LspInfoBorder = { fg = p.border, bg = p.panel },
+    LspInfoTitle = { fg = p.dim, bg = p.panel },
+
+    -- DIAGNOSTICS -----------------------------------------------------------
+    DiagnosticError = { fg = p.danger },
+    DiagnosticWarn = { fg = p.warn },
+    DiagnosticInfo = { fg = p.info },
+    DiagnosticHint = { fg = p.dim },
+    DiagnosticOk = { fg = p.ok },
+    DiagnosticDeprecated = { fg = p.dim, strikethrough = true },
+    DiagnosticUnnecessary = { fg = p.dim },
+
+    DiagnosticUnderlineError = { undercurl = true, sp = p.danger },
+    DiagnosticUnderlineWarn = { undercurl = true, sp = p.warn },
+    DiagnosticUnderlineInfo = { undercurl = true, sp = p.info },
+    DiagnosticUnderlineHint = { undercurl = true, sp = p.dim },
+    DiagnosticUnderlineOk = { undercurl = true, sp = p.ok },
+    DiagnosticVirtualTextError = { fg = p.danger, bg = p.panel },
+    DiagnosticVirtualTextWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticVirtualTextInfo = { fg = p.info, bg = p.panel },
+    DiagnosticVirtualTextHint = { fg = p.dim, bg = p.panel },
+    DiagnosticVirtualTextOk = { fg = p.ok, bg = p.panel },
+    DiagnosticVirtualLinesError = { fg = p.danger, bg = p.panel },
+    DiagnosticVirtualLinesWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticVirtualLinesInfo = { fg = p.info, bg = p.panel },
+    DiagnosticVirtualLinesHint = { fg = p.dim, bg = p.panel },
+    DiagnosticVirtualLinesOk = { fg = p.ok, bg = p.panel },
+    DiagnosticSignError = { fg = p.danger, bg = p.void },
+    DiagnosticSignWarn = { fg = p.warn, bg = p.void },
+    DiagnosticSignInfo = { fg = p.info, bg = p.void },
+    DiagnosticSignHint = { fg = p.dim, bg = p.void },
+    DiagnosticSignOk = { fg = p.ok, bg = p.void },
+    DiagnosticFloatingError = { fg = p.danger, bg = p.panel },
+    DiagnosticFloatingWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticFloatingInfo = { fg = p.info, bg = p.panel },
+    DiagnosticFloatingHint = { fg = p.dim, bg = p.panel },
+    DiagnosticFloatingOk = { fg = p.ok, bg = p.panel },
+    ApexMarkupStrong = { bold = true },
+    ApexMarkupItalic = { italic = true },
+    ApexMarkupLink = { fg = p.info, underline = true },
+
+    -- DIFF (figure / ground — spec §8) --------------------------------------
+    DiffAdd = { fg = p.ok, bg = p.diff_add },
+    DiffChange = { fg = p.warn, bg = p.diff_chg },
+    DiffDelete = { fg = p.danger, bg = p.diff_del },
+    DiffText = { fg = p.void, bg = p.warn, bold = true },
+
+    -- PLUGINS: TELESCOPE ("The HUD") ----------------------------------------
+    TelescopeNormal = { bg = p.void },
+    TelescopeBorder = { fg = p.border, bg = p.void },
+    TelescopePromptNormal = { fg = p.text, bg = p.void },
+    TelescopePromptBorder = { fg = p.info, bg = p.void }, -- Cyan input border
+    TelescopePromptTitle = { fg = p.void, bg = p.info }, -- Cyan label
+    TelescopePreviewTitle = { fg = p.void, bg = p.ok }, -- Green label
+    TelescopeResultsTitle = { fg = p.dim, bg = p.panel },
+    TelescopeSelection = { fg = p.text, bg = p.focus_field, bold = true }, -- Violet field
+    TelescopeMatching = { fg = p.info, bold = true },
+
+    -- PLUGINS: NEO-TREE -----------------------------------------------------
+    NeoTreeNormal = { bg = p.void },
+    NeoTreeNormalNC = { bg = p.void },
+    NeoTreeVertSplit = { fg = p.panel, bg = p.void },
+    NeoTreeWinSeparator = { fg = p.panel, bg = p.void }, -- Fade out tree border
+    NeoTreeRootName = { fg = p.focus, bold = true }, -- Root = location (violet)
+    NeoTreeGitAdded = { fg = p.ok },
+    NeoTreeGitConflict = { fg = p.warn },
+    NeoTreeGitDeleted = { fg = p.danger },
+    NeoTreeGitModified = { fg = p.info },
+
+    -- PLUGINS: GITSIGNS -----------------------------------------------------
+    GitSignsAdd = { fg = p.ok, bg = p.void },
+    GitSignsChange = { fg = p.warn, bg = p.void },
+    GitSignsDelete = { fg = p.danger, bg = p.void },
+
+    -- PLUGINS: CMP (Completion) ---------------------------------------------
+    CmpItemAbbrDeprecated = { fg = p.dim, strikethrough = true },
+    CmpItemAbbrMatch = { fg = p.info, bold = true },
+    CmpItemAbbrMatchFuzzy = { fg = p.info, bold = true },
+    CmpItemKindFunction = { fg = p.action },
+    CmpItemKindMethod = { fg = p.action },
+    CmpItemKindKeyword = { fg = p.flow },
+    CmpItemKindVariable = { fg = p.text },
+
+    -- PLUGINS: BLINK.CMP (Completion) ----------------------------------------
+    BlinkCmpMenu             = { fg = p.text, bg = p.panel },
+    BlinkCmpMenuBorder       = { fg = p.border, bg = p.panel },
+    BlinkCmpMenuSelection    = { fg = p.void, bg = p.focus, bold = true },
+    BlinkCmpScrollBarThumb   = { bg = p.stealth },
+    BlinkCmpScrollBarGutter  = { bg = p.panel },
+    BlinkCmpLabel            = { fg = p.text },
+    BlinkCmpLabelDeprecated  = { fg = p.dim, strikethrough = true },
+    BlinkCmpLabelMatch       = { fg = p.info, bold = true },
+    BlinkCmpKindText         = { fg = p.text },
+    BlinkCmpKindMethod       = { fg = p.action },
+    BlinkCmpKindFunction     = { fg = p.action },
+    BlinkCmpKindConstructor  = { fg = p.kind },
+    BlinkCmpKindField        = { fg = p.prop },
+    BlinkCmpKindVariable     = { fg = p.text },
+    BlinkCmpKindClass        = { fg = p.kind },
+    BlinkCmpKindInterface    = { fg = p.kind },
+    BlinkCmpKindModule       = { fg = p.kind },
+    BlinkCmpKindProperty     = { fg = p.prop },
+    BlinkCmpKindUnit         = { fg = p.const },
+    BlinkCmpKindValue        = { fg = p.const },
+    BlinkCmpKindEnum         = { fg = p.kind },
+    BlinkCmpKindKeyword      = { fg = p.flow },
+    BlinkCmpKindSnippet      = { fg = p.value },
+    BlinkCmpKindColor        = { fg = p.info },
+    BlinkCmpKindFile         = { fg = p.text },
+    BlinkCmpKindReference    = { fg = p.info },
+    BlinkCmpKindFolder       = { fg = p.info },
+    BlinkCmpKindEnumMember   = { fg = p.const },
+    BlinkCmpKindConstant     = { fg = p.const },
+    BlinkCmpKindStruct       = { fg = p.kind },
+    BlinkCmpKindEvent        = { fg = p.kind },
+    BlinkCmpKindOperator     = { fg = p.op },
+    BlinkCmpKindTypeParameter = { fg = p.kind },
+    BlinkCmpGhostText        = { fg = p.stealth, italic = true },
+    BlinkCmpDoc              = { fg = p.text, bg = p.panel },
+    BlinkCmpDocBorder        = { fg = p.border, bg = p.panel },
+    BlinkCmpDocSeparator     = { fg = p.border, bg = p.panel },
+    BlinkCmpDocCursorLine    = { bg = p.border },
+    BlinkCmpSignatureHelp    = { fg = p.text, bg = p.panel },
+    BlinkCmpSignatureHelpBorder = { fg = p.border, bg = p.panel },
+    BlinkCmpSignatureHelpActiveParameter = { fg = p.void, bg = p.info, bold = true },
+    BlinkCmpSource           = { fg = p.dim },
+
+    -- PLUGINS: BUFFERLINE -----------------------------------------------------
+    BufferLineBackground        = { fg = p.dim, bg = p.panel },
+    BufferLineFill              = { bg = p.panel },
+    BufferLineBuffer            = { fg = p.dim, bg = p.panel },
+    BufferLineBufferSelected    = { fg = p.text, bg = p.void, bold = true },
+    BufferLineBufferVisible     = { fg = p.dim, bg = p.panel },
+    BufferLineTab               = { fg = p.dim, bg = p.panel },
+    BufferLineTabSelected       = { fg = p.text, bg = p.void, bold = true },
+    BufferLineTabClose          = { fg = p.dim, bg = p.panel },
+    BufferLineModified          = { fg = p.info, bg = p.panel },
+    BufferLineModifiedSelected  = { fg = p.info, bg = p.void },
+    BufferLineModifiedVisible   = { fg = p.info, bg = p.panel },
+    BufferLineSeparator         = { fg = p.border, bg = p.panel },
+    BufferLineSeparatorSelected = { fg = p.border, bg = p.void },
+    BufferLineSeparatorVisible  = { fg = p.border, bg = p.panel },
+    BufferLineIndicatorSelected = { fg = p.focus, bg = p.void }, -- Active = violet
+    BufferLineCloseButton       = { fg = p.dim, bg = p.panel },
+    BufferLineCloseButtonSelected = { fg = p.focus, bg = p.void },
+    BufferLineCloseButtonVisible  = { fg = p.dim, bg = p.panel },
+    BufferLineDiagnostic           = { fg = p.dim, bg = p.panel },
+    BufferLineDiagnosticSelected   = { fg = p.dim, bg = p.void },
+    BufferLineError                = { fg = p.danger, bg = p.panel },
+    BufferLineErrorSelected        = { fg = p.danger, bg = p.void, bold = true },
+    BufferLineWarning              = { fg = p.warn, bg = p.panel },
+    BufferLineWarningSelected      = { fg = p.warn, bg = p.void, bold = true },
+    BufferLineInfo                 = { fg = p.info, bg = p.panel },
+    BufferLineInfoSelected         = { fg = p.info, bg = p.void, bold = true },
+    BufferLineHint                 = { fg = p.dim, bg = p.panel },
+    BufferLineHintSelected         = { fg = p.dim, bg = p.void, bold = true },
+    BufferLinePick                 = { fg = p.focus, bg = p.panel, bold = true },
+    BufferLinePickSelected         = { fg = p.focus, bg = p.void, bold = true },
+    BufferLinePickVisible          = { fg = p.focus, bg = p.panel, bold = true },
+
+    -- PLUGINS: WHICH-KEY ------------------------------------------------------
+    WhichKey            = { fg = p.flow, bold = true }, -- The key trigger = navigation
+    WhichKeySeparator   = { fg = p.stealth },
+    WhichKeyGroup       = { fg = p.info },
+    WhichKeyDesc        = { fg = p.text },
+    WhichKeyFloat       = { bg = p.panel },
+    WhichKeyBorder      = { fg = p.border, bg = p.panel },
+    WhichKeyTitle       = { fg = p.void, bg = p.focus, bold = true },
+    WhichKeyNormal      = { fg = p.text, bg = p.panel },
+    WhichKeyValue       = { fg = p.dim },
+    WhichKeyIcon        = { fg = p.action },
+    WhichKeyIconAzure   = { fg = p.kind },
+    WhichKeyIconGreen   = { fg = p.ok },
+    WhichKeyIconYellow  = { fg = p.warn },
+    WhichKeyIconRed     = { fg = p.danger },
+    WhichKeyIconPurple  = { fg = p.special },
+    WhichKeyIconCyan    = { fg = p.info },
+
+    -- PLUGINS: TROUBLE --------------------------------------------------------
+    TroubleNormal       = { fg = p.text, bg = p.void },
+    TroubleNormalNC     = { fg = p.dim, bg = p.void },
+    TroubleText         = { fg = p.text },
+    TroubleCount        = { fg = p.void, bg = p.focus_active, bold = true },
+    TroubleError        = { fg = p.danger },
+    TroubleWarning      = { fg = p.warn },
+    TroubleHint         = { fg = p.dim },
+    TroubleInfo         = { fg = p.info },
+    TroubleSource       = { fg = p.dim },
+    TroubleCode         = { fg = p.stealth },
+    TroubleLocation     = { fg = p.dim },
+    TroubleFile         = { fg = p.info, bold = true },
+    TroubleIndent       = { fg = p.border },
+    TroublePos          = { fg = p.dim },
+    TroubleSignError    = { fg = p.danger },
+    TroubleSignWarning  = { fg = p.warn },
+    TroubleSignHint     = { fg = p.dim },
+    TroubleSignInfo     = { fg = p.info },
+    TroublePreview      = { fg = p.text, bg = p.focus_field },
+    TroubleFocusText    = { fg = p.text, bold = true },
+
+    -- PLUGINS: INDENT-BLANKLINE -----------------------------------------------
+    IblIndent     = { fg = p.border },
+    IblScope      = { fg = p.flow }, -- Current scope = structural (blue)
+    IblWhitespace = { fg = p.border },
+
+    -- PLUGINS: NEOGIT ---------------------------------------------------------
+    NeogitBranch                = { fg = p.flow, bold = true }, -- Ref / location
+    NeogitRemote                = { fg = p.info },
+    NeogitHunkHeader            = { fg = p.text, bg = p.panel, bold = true },
+    NeogitHunkHeaderHighlight   = { fg = p.void, bg = p.info, bold = true },
+    NeogitDiffAdd               = { fg = p.ok, bg = p.void },
+    NeogitDiffDelete            = { fg = p.danger, bg = p.void },
+    NeogitDiffContext           = { fg = p.dim, bg = p.void },
+    NeogitDiffAddHighlight      = { fg = p.ok, bg = p.diff_add },
+    NeogitDiffDeleteHighlight   = { fg = p.danger, bg = p.diff_del },
+    NeogitDiffContextHighlight  = { fg = p.text, bg = p.panel },
+    NeogitCommitViewHeader      = { fg = p.void, bg = p.info, bold = true },
+    NeogitFilePath              = { fg = p.info, underline = true },
+    NeogitDiffHeader            = { fg = p.warn, bold = true },
+    NeogitDiffHeaderHighlight   = { fg = p.void, bg = p.warn, bold = true },
+    NeogitObjectId              = { fg = p.dim },
+    NeogitStashes               = { fg = p.special },
+    NeogitRebaseDone            = { fg = p.ok },
+    NeogitFold                  = { fg = p.stealth },
+
+    -- PLUGINS: AERIAL (Symbols Outline) --------------------------------------
+    AerialLine          = { fg = p.ink, bg = p.focus_field },
+    AerialLineNC        = { fg = p.dim, bg = p.panel },
+    AerialNormal        = { fg = p.text, bg = p.void },
+    AerialGuide         = { fg = p.border },
+    AerialClass         = { fg = p.kind },
+    AerialClassIcon     = { fg = p.kind },
+    AerialFunction      = { fg = p.action },
+    AerialFunctionIcon  = { fg = p.action },
+    AerialMethod        = { fg = p.action },
+    AerialMethodIcon    = { fg = p.action },
+    AerialConstructor   = { fg = p.kind },
+    AerialField         = { fg = p.prop },
+    AerialVariable      = { fg = p.text },
+    AerialEnum          = { fg = p.kind },
+    AerialEnumIcon      = { fg = p.kind },
+    AerialInterface     = { fg = p.kind },
+    AerialModule        = { fg = p.kind },
+    AerialNamespace     = { fg = p.kind },
+    AerialPackage       = { fg = p.kind },
+    AerialProperty      = { fg = p.prop },
+    AerialStruct        = { fg = p.kind },
+    AerialType          = { fg = p.kind },
+    AerialTypeParameter = { fg = p.kind },
+    AerialConstant      = { fg = p.const },
+    AerialString        = { fg = p.value },
+    AerialNumber        = { fg = p.const },
+    AerialBoolean       = { fg = p.const },
+    AerialKey           = { fg = p.flow },
+    AerialKeyword       = { fg = p.flow },
+    AerialOperator      = { fg = p.op },
+    AerialNull          = { fg = p.dim },
+    AerialArray         = { fg = p.const },
+    AerialObject        = { fg = p.kind },
+    AerialEvent         = { fg = p.kind },
+
+    -- PLUGINS: DAP-UI ---------------------------------------------------------
+    DapUIScope                    = { fg = p.info, bold = true },
+    DapUIType                     = { fg = p.kind },
+    DapUIDecoration               = { fg = p.border },
+    DapUIThread                   = { fg = p.ok },
+    DapUIStoppedThread            = { fg = p.danger, bold = true }, -- Halted = alarm
+    DapUICurrentFrameName         = { fg = p.danger, bold = true },
+    DapUISource                   = { fg = p.dim },
+    DapUILineNumber               = { fg = p.stealth },
+    DapUIFloatBorder              = { fg = p.border, bg = p.panel },
+    DapUIFloatNormal              = { fg = p.text, bg = p.panel },
+    DapUIWatchesEmpty             = { fg = p.dim },
+    DapUIWatchesValue             = { fg = p.value },
+    DapUIWatchesError             = { fg = p.danger },
+    DapUIBreakpointsPath          = { fg = p.info },
+    DapUIBreakpointsInfo          = { fg = p.dim },
+    DapUIBreakpointsCurrentLine   = { fg = p.danger, bold = true },
+    DapUIBreakpointsDisabledLine  = { fg = p.stealth },
+    DapUIEndofBuffer              = { fg = p.void },
+    DapUIModifiedValue            = { fg = p.warn, bold = true },
+    DapUIStop                     = { fg = p.danger },
+    DapUIStepOver                 = { fg = p.info },
+    DapUIStepInto                 = { fg = p.info },
+    DapUIStepBack                 = { fg = p.info },
+    DapUIStepOut                  = { fg = p.info },
+    DapUIRestart                  = { fg = p.ok },
+    DapUIUnavailable              = { fg = p.stealth },
+    DapUIPlayPause                = { fg = p.ok },
+
+    -- PLUGINS: DAP VIRTUAL TEXT -----------------------------------------------
+    NvimDapVirtualText        = { fg = p.dim, italic = true },
+    NvimDapVirtualTextChanged = { fg = p.warn, italic = true },
+    NvimDapVirtualTextError   = { fg = p.danger, italic = true },
+    NvimDapVirtualTextInfo    = { fg = p.info, italic = true },
+
+    -- PLUGINS: NVIM-NOTIFY ----------------------------------------------------
+    NotifyERRORBorder = { fg = p.danger },
+    NotifyWARNBorder  = { fg = p.warn },
+    NotifyINFOBorder  = { fg = p.info },
+    NotifyDEBUGBorder = { fg = p.stealth },
+    NotifyTRACEBorder = { fg = p.special },
+    NotifyERRORIcon   = { fg = p.danger },
+    NotifyWARNIcon    = { fg = p.warn },
+    NotifyINFOIcon    = { fg = p.info },
+    NotifyDEBUGIcon   = { fg = p.stealth },
+    NotifyTRACEIcon   = { fg = p.special },
+    NotifyERRORTitle  = { fg = p.danger, bold = true },
+    NotifyWARNTitle   = { fg = p.warn, bold = true },
+    NotifyINFOTitle   = { fg = p.info, bold = true },
+    NotifyDEBUGTitle  = { fg = p.stealth, bold = true },
+    NotifyTRACETitle  = { fg = p.special, bold = true },
+    NotifyERRORBody   = { fg = p.text, bg = p.panel },
+    NotifyWARNBody    = { fg = p.text, bg = p.panel },
+    NotifyINFOBody    = { fg = p.text, bg = p.panel },
+    NotifyDEBUGBody   = { fg = p.dim, bg = p.panel },
+    NotifyTRACEBody   = { fg = p.dim, bg = p.panel },
+
+    -- PLUGINS: SATELLITE (Scrollbar) -----------------------------------------
+    SatelliteBar      = { bg = p.panel },
+    SatelliteCursor   = { fg = p.focus }, -- Cursor position = violet
+    SatellitePosition = { fg = p.dim },
+    SatelliteError    = { fg = p.danger },
+    SatelliteWarning  = { fg = p.warn },
+    SatelliteHint     = { fg = p.dim },
+    SatelliteInfo     = { fg = p.info },
+    SatelliteSearch   = { fg = p.focus_active }, -- Search = violet
+    SatelliteGit      = { fg = p.ok },
+    SatelliteMark     = { fg = p.warn },
+
+    -- PLUGINS: OIL.NVIM (File Explorer) --------------------------------------
+    OilDir            = { fg = p.info, bold = true },
+    OilDirIcon        = { fg = p.info },
+    OilLink           = { fg = p.flow, italic = true }, -- Symlink = structural (blue)
+    OilLinkTarget     = { fg = p.flow },
+    OilCopy           = { fg = p.warn, bold = true },
+    OilMove           = { fg = p.warn },
+    OilChange         = { fg = p.info },
+    OilCreate         = { fg = p.ok, bold = true },
+    OilDelete         = { fg = p.danger, bold = true }, -- Destructive = danger
+    OilPermissionNone = { fg = p.stealth },
+    OilPermissionRead = { fg = p.info },
+    OilPermissionWrite = { fg = p.warn },
+    OilPermissionExecute = { fg = p.ok },
+    OilTypeDir        = { fg = p.info },
+    OilTypeFile       = { fg = p.text },
+    OilTypeLink       = { fg = p.flow },
+    OilTypeSpecial    = { fg = p.special },
+    OilSize           = { fg = p.dim },
+    OilMtime          = { fg = p.stealth },
+
+    -- PLUGINS: NEOTEST --------------------------------------------------------
+    NeotestPassed       = { fg = p.ok },
+    NeotestFailed       = { fg = p.danger },
+    NeotestRunning      = { fg = p.warn },
+    NeotestSkipped      = { fg = p.dim },
+    NeotestUnknown      = { fg = p.stealth },
+    NeotestTest         = { fg = p.text },
+    NeotestFile         = { fg = p.info },
+    NeotestDir          = { fg = p.info, bold = true },
+    NeotestNamespace    = { fg = p.kind },
+    NeotestMarked       = { fg = p.focus, bold = true }, -- Mark = attention
+    NeotestTarget       = { fg = p.focus },
+    NeotestAdapterName  = { fg = p.info, bold = true },
+    NeotestWinSelect    = { fg = p.info, bold = true },
+    NeotestFocused      = { bold = true },
+    NeotestIndent       = { fg = p.border },
+    NeotestExpandMarker = { fg = p.dim },
+    NeotestWatching     = { fg = p.warn },
+
+    -- PLUGINS: GRUG-FAR (Search & Replace) -----------------------------------
+    GrugFarResultsHeader      = { fg = p.void, bg = p.focus, bold = true }, -- Search = violet
+    GrugFarResultsMatch       = { fg = p.ink, bg = p.focus_field, bold = true },
+    GrugFarResultsMatchAdded  = { fg = p.ok },
+    GrugFarResultsMatchRemoved = { fg = p.danger },
+    GrugFarResultsLineNo      = { fg = p.dim },
+    GrugFarResultsPath        = { fg = p.info, underline = true },
+    GrugFarResultsStats       = { fg = p.dim },
+    GrugFarInputLabel         = { fg = p.warn, bold = true },
+    GrugFarInputPlaceholder   = { fg = p.stealth },
+    GrugFarHelpHeader         = { fg = p.dim, bold = true },
+    GrugFarHelpWinHeader      = { fg = p.text, bg = p.panel, bold = true },
+
+    -- PLUGINS: TWINNY (AI Ghost Text) ----------------------------------------
+    TwinnyAccept       = { fg = p.stealth, italic = true },
+    TwinnyHint         = { fg = p.stealth, italic = true },
+
+    -- PLUGINS: GITSIGNS (extended) -------------------------------------------
+    GitSignsCurrentLineBlame  = { fg = p.stealth, italic = true },
+    GitSignsAddNr             = { fg = p.ok },
+    GitSignsChangeNr          = { fg = p.warn },
+    GitSignsDeleteNr          = { fg = p.danger },
+    GitSignsAddLn             = { fg = p.ok, bg = p.diff_add },
+    GitSignsChangeLn          = { fg = p.warn, bg = p.diff_chg },
+    GitSignsDeleteLn          = { fg = p.danger, bg = p.diff_del },
+    GitSignsAddPreview        = { fg = p.ok, bg = p.diff_add },
+    GitSignsDeletePreview     = { fg = p.danger, bg = p.diff_del },
+    GitSignsAddInline         = { fg = p.void, bg = p.ok },
+    GitSignsDeleteInline      = { fg = p.void, bg = p.danger },
+    GitSignsChangeInline      = { fg = p.void, bg = p.warn },
+    GitSignsUntracked         = { fg = p.dim },
+
+    -- PLUGINS: RENDER-MARKDOWN ------------------------------------------------
+    -- Heading ramp avoids red + violet (both reserved); uses code-safe hues only.
+    RenderMarkdownH1         = { fg = p.info, bold = true },
+    RenderMarkdownH2         = { fg = p.flow, bold = true },
+    RenderMarkdownH3         = { fg = p.kind, bold = true },
+    RenderMarkdownH4         = { fg = p.ok, bold = true },
+    RenderMarkdownH5         = { fg = p.warn, bold = true },
+    RenderMarkdownH6         = { fg = p.dim, bold = true },
+    RenderMarkdownH1Bg       = { bg = p.panel },
+    RenderMarkdownH2Bg       = { bg = p.panel },
+    RenderMarkdownH3Bg       = { bg = p.panel },
+    RenderMarkdownH4Bg       = { bg = p.panel },
+    RenderMarkdownH5Bg       = { bg = p.panel },
+    RenderMarkdownH6Bg       = { bg = p.panel },
+    RenderMarkdownCode       = { bg = p.panel },
+    RenderMarkdownCodeInline = { fg = p.value, bg = p.panel },
+    RenderMarkdownBullet     = { fg = p.info },
+    RenderMarkdownQuote      = { fg = p.dim, italic = true },
+    RenderMarkdownDash       = { fg = p.border },
+    RenderMarkdownLink       = { fg = p.info, underline = true },
+    RenderMarkdownSign       = { bg = p.void },
+    RenderMarkdownMath       = { fg = p.info },
+    RenderMarkdownTableHead  = { fg = p.void, bg = p.info, bold = true },
+    RenderMarkdownTableRow   = { fg = p.text },
+    RenderMarkdownTableFill  = { fg = p.border },
+    RenderMarkdownTodo       = { fg = p.void, bg = p.warn, bold = true },
+    RenderMarkdownUnchecked  = { fg = p.stealth },
+    RenderMarkdownChecked    = { fg = p.ok },
+  }
+
+  for group, highlight in pairs(groups) do
+    vim.api.nvim_set_hl(0, group, highlight)
+  end
+
+  local links = {
+    ["@annotation"] = "Attribute",
+    ["@attribute"] = "Attribute",
+    ["@character"] = "Character",
+    ["@comment"] = "Comment",
+    ["@constant"] = "Constant",
+    ["@constant.builtin"] = "Constant",
+    ["@constant.macro"] = "Macro",
+    ["@constructor"] = "Type",
+    ["@debug"] = "Debug",
+    ["@define"] = "Define",
+    ["@exception"] = "Exception",
+    ["@field"] = "Property",
+    ["@float"] = "Float",
+    ["@function"] = "Function",
+    ["@function.builtin"] = "Function",
+    ["@function.call"] = "Function",
+    ["@function.macro"] = "Macro",
+    ["@include"] = "Include",
+    ["@keyword"] = "Keyword",
+    ["@keyword.conditional"] = "Conditional",
+    ["@keyword.repeat"] = "Repeat",
+    ["@keyword.return"] = "Statement",
+    ["@keyword.function"] = "Keyword",
+    ["@keyword.operator"] = "Operator",
+    ["@keyword.exception"] = "Exception",
+    ["@label"] = "Label",
+    ["@method"] = "Function",
+    ["@method.call"] = "Function",
+    ["@module"] = "Structure",
+    ["@namespace"] = "Structure",
+    ["@number"] = "Number",
+    ["@operator"] = "Operator",
+    ["@parameter"] = "Identifier",
+    ["@preproc"] = "PreProc",
+    ["@property"] = "Property",
+    ["@punctuation"] = "Delimiter",
+    ["@punctuation.bracket"] = "Delimiter",
+    ["@punctuation.delimiter"] = "Delimiter",
+    ["@punctuation.special"] = "Delimiter",
+    ["@repeat"] = "Repeat",
+    ["@string"] = "String",
+    ["@string.escape"] = "SpecialChar",
+    ["@string.regex"] = "SpecialChar",
+    ["@string.special"] = "SpecialChar",
+    ["@tag"] = "Tag",
+    ["@tag.attribute"] = "Property",
+    ["@tag.delimiter"] = "Delimiter",
+    ["@text"] = "Normal",
+    ["@text.title"] = "Title",
+    ["@markup.heading"] = "Title",
+    ["@markup.heading.1"] = "Title",
+    ["@markup.heading.2"] = "Title",
+    ["@markup.heading.3"] = "Title",
+    ["@markup.heading.4"] = "Title",
+    ["@markup.heading.5"] = "Title",
+    ["@markup.heading.6"] = "Title",
+    ["@markup.link"] = "ApexMarkupLink",
+    ["@markup.link.label"] = "ApexMarkupLink",
+    ["@markup.link.url"] = "ApexMarkupLink",
+    ["@markup.strong"] = "ApexMarkupStrong",
+    ["@markup.italic"] = "ApexMarkupItalic",
+    ["@markup.strikethrough"] = "DiagnosticDeprecated",
+    ["@markup.underline"] = "Underlined",
+    ["@markup.raw"] = "String",
+    ["@markup.raw.block"] = "String",
+    ["@markup.raw.delimiter"] = "Delimiter",
+    ["@markup.quote"] = "Comment",
+    ["@markup.list"] = "Delimiter",
+    ["@markup.list.checked"] = "String",
+    ["@markup.list.unchecked"] = "Comment",
+    ["@markup.math"] = "Constant",
+    ["@markup.environment"] = "Type",
+    ["@markup.environment.name"] = "Type",
+    ["@type"] = "Type",
+    ["@type.builtin"] = "Type",
+    ["@type.definition"] = "Type",
+    ["@type.qualifier"] = "Keyword",
+    ["@variable"] = "Identifier",
+    ["@variable.builtin"] = "Builtin",
+    ["@variable.parameter"] = "Identifier",
+    ["@variable.member"] = "Property",
+
+    ["@lsp.type.boolean"] = "Boolean",
+    ["@lsp.type.builtinType"] = "Type",
+    ["@lsp.type.class"] = "Type",
+    ["@lsp.type.comment"] = "Comment",
+    ["@lsp.type.decorator"] = "Attribute",
+    ["@lsp.type.enum"] = "Type",
+    ["@lsp.type.enumMember"] = "Constant",
+    ["@lsp.type.event"] = "Type",
+    ["@lsp.type.function"] = "Function",
+    ["@lsp.type.interface"] = "Type",
+    ["@lsp.type.keyword"] = "Keyword",
+    ["@lsp.type.macro"] = "Macro",
+    ["@lsp.type.method"] = "Function",
+    ["@lsp.type.modifier"] = "Keyword",
+    ["@lsp.type.namespace"] = "Structure",
+    ["@lsp.type.number"] = "Number",
+    ["@lsp.type.operator"] = "Operator",
+    ["@lsp.type.parameter"] = "Identifier",
+    ["@lsp.type.property"] = "Property",
+    ["@lsp.type.regexp"] = "SpecialChar",
+    ["@lsp.type.string"] = "String",
+    ["@lsp.type.struct"] = "Structure",
+    ["@lsp.type.type"] = "Type",
+    ["@lsp.type.typeParameter"] = "Type",
+    ["@lsp.type.variable"] = "Identifier",
+
+    ["@lsp.mod.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.mod.abstract"] = "Type",
+    ["@lsp.mod.declaration"] = "Keyword",
+    ["@lsp.mod.defaultLibrary"] = "Constant",
+    ["@lsp.mod.definition"] = "Keyword",
+    ["@lsp.mod.documentation"] = "Comment",
+    ["@lsp.mod.modification"] = "Operator",
+    ["@lsp.mod.readonly"] = "Constant",
+    ["@lsp.mod.static"] = "Constant",
+    ["@lsp.mod.async"] = "Keyword",
+
+    ["@lsp.typemod.function.async"] = "Keyword",
+    ["@lsp.typemod.method.async"] = "Keyword",
+    ["@lsp.typemod.function.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.method.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.variable.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.variable.readonly"] = "Constant",
+    ["@lsp.typemod.parameter.readonly"] = "Constant",
+    ["@lsp.typemod.property.readonly"] = "Constant",
+    ["@lsp.typemod.variable.static"] = "Constant",
+    ["@lsp.typemod.property.static"] = "Constant",
+  }
+
+  for group, target in pairs(links) do
+    vim.api.nvim_set_hl(0, group, { link = target })
+  end
+end
+
+M.load()
+
+-- PLUGINS: LUALINE --------------------------------------------------------
+-- Export lualine theme from palette for use in lualine config.
+-- Mode hues stay distinct: normal=violet(attention), insert=green, visual=cyan,
+-- replace=amber, command=violet-deep. fg = void for contrast on bright accents.
+do
+  local p = M.palette
+  M.lualine = {
+    normal = {
+      a = { fg = p.void, bg = p.focus, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    insert = {
+      a = { fg = p.void, bg = p.ok, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    visual = {
+      a = { fg = p.void, bg = p.info, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    replace = {
+      a = { fg = p.void, bg = p.warn, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    command = {
+      a = { fg = p.void, bg = p.special, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    inactive = {
+      a = { fg = p.dim, bg = p.panel },
+      b = { fg = p.dim, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+  }
+end
+
+return M

dist/nvim/colors/apex-neon.lua

@@ -0,0 +1,802 @@
+-- Apex Neon: Standalone Theme Engine
+-- Philosophy: Signal over decoration. Red = danger. Violet = attention.
+-- Neither red nor violet ever appears inside the code buffer (spec §1, §12).
+
+local M = {}
+
+M.palette = {
+  -- NEUTRALS — the readable field --------------------------------------------
+  void    = "#070709",      -- Background (also: ink on a bright accent fill)
+  panel   = "#101218", -- Dark surface (statusline, floats, cursorline)
+  border  = "#262a34",  -- Borders, separators
+  stealth = "#383d49",  -- Ignored text only (sub-threshold by design)
+  dim     = "#8b909c",   -- Comments, muted labels (ghost)
+  text    = "#e6e8ec",    -- Body text (stark / ink)
+  punct   = "#aab0bc", -- Punctuation / delimiters (lifted neutral)
+  op      = "#c2c8d4",    -- Operators (neutral)
+  prop    = "#cdd4e3",    -- Fields / properties (dim body)
+
+  -- ATTENTION (violet) — cursor, search, matched pairs. NEVER syntax. --------
+  focus        = "#d68fff",    -- Cursor — the crosshair (hottest mark)
+  focus_active = "#b14dff", -- Current match, matched bracket / pair
+  focus_field  = "#3a1a4d",  -- Search-set / selection background
+
+  -- DANGER (red) — error, destructive, alarm. NEVER syntax. ------------------
+  danger       = "#ff0044",   -- Error figure, destructive, active border
+  danger_field = "#1f0a12",  -- Error region / delete background
+  danger_hot   = "#ff3b3b", -- Escalation
+
+  -- CODE HUES (buffer-safe) --------------------------------------------------
+  info    = "#00eaff",     -- Cyan — info / links
+  action  = "#5af3ff", -- Cyan — functions / methods
+  builtin = "#8fd6ff",  -- Cyan, dim — self / builtin
+  kind    = "#7db4ff",     -- Blue — types / kinds
+  storage = "#2e6bff",  -- Blue, heavy — storage / modifier / attribute
+  flow    = "#5b8cff",  -- Bright-blue — control-flow navigation
+  value   = "#2bffb2",   -- Green — strings / values
+  escape  = "#7dffd0",   -- Green, bright — char / escape
+  const   = "#37dba0", -- Green, cool — numbers / const
+  ok      = "#00ff99",  -- Green — success state
+  warn    = "#ffb700",  -- Amber — warning (UI only)
+  special = "#9d00ff",  -- Violet-deep — root / special only
+
+  -- DIFF grounds -------------------------------------------------------------
+  diff_add = "#0a1f16",
+  diff_chg = "#1f1a0a",
+  diff_del = "#1f0a12",
+
+  -- ON-ACCENT INK ------------------------------------------------------------
+  ink = "#e6e8ec", -- fg on a dim violet field (search / selection)
+}
+
+function M.load()
+  vim.cmd "hi clear"
+  if vim.fn.exists "syntax_on" then vim.cmd "syntax reset" end
+  vim.o.background = "dark"
+  vim.g.colors_name = "apex-neon"
+
+  -- Optional transparency: set g:apex_blend or g:apex_transparent to opt in.
+  local blend = vim.g.apex_blend
+  if type(blend) == "number" then
+    vim.o.winblend = blend
+    vim.o.pumblend = blend
+  elseif vim.g.apex_transparent == true then
+    vim.o.winblend = 20
+    vim.o.pumblend = 20
+  end
+
+  local p = M.palette
+  local groups = {
+    -- CANVAS & UI -----------------------------------------------------------
+    Normal = { fg = p.text, bg = p.void },
+    NormalNC = { fg = p.dim, bg = p.void }, -- Non-focused windows
+    SignColumn = { bg = p.void },
+    FoldColumn = { fg = p.stealth, bg = p.void },
+    VertSplit = { fg = p.border }, -- Deprecated in nvim 0.10, but good fallback
+    WinSeparator = { fg = p.border },
+    EndOfBuffer = { fg = p.void }, -- Hide tildes
+    NormalFloat = { fg = p.text, bg = p.panel },
+    FloatBorder = { fg = p.border, bg = p.panel },
+    MsgArea = { fg = p.text, bg = p.void },
+    WinBar = { fg = p.text, bg = p.panel },
+    WinBarNC = { fg = p.dim, bg = p.panel },
+
+    -- CURSOR & NAVIGATION ("Attention" — violet) ----------------------------
+    Cursor = { fg = p.void, bg = p.focus }, -- Violet crosshair
+    TermCursor = { fg = p.void, bg = p.focus },
+    CursorLine = { bg = p.panel },
+    CursorColumn = { bg = p.panel },
+    ColorColumn = { bg = p.panel },
+    CursorLineNr = { fg = p.focus, bold = true }, -- Violet line number (you are here)
+    LineNr = { fg = p.stealth }, -- Other lines fade out
+
+    -- SELECTION & SEARCH ("Region scanned" — violet field) ------------------
+    Visual = { fg = p.ink, bg = p.focus_field }, -- Dim violet field, fg preserved
+    VisualNOS = { fg = p.ink, bg = p.focus_field },
+
+    Search = { fg = p.ink, bg = p.focus_field }, -- Other matches: the set
+    IncSearch = { fg = p.void, bg = p.focus_active }, -- Acquiring
+    CurSearch = { fg = p.void, bg = p.focus_active, bold = true }, -- The one you are on
+
+    -- STATUS & MESSAGES -----------------------------------------------------
+    StatusLine = { fg = p.text, bg = p.panel },
+    StatusLineNC = { fg = p.dim, bg = p.void },
+    WildMenu = { fg = p.void, bg = p.focus_active },
+    Pmenu = { fg = p.text, bg = p.panel },
+    PmenuSel = { fg = p.void, bg = p.focus, bold = true }, -- Violet menu selection
+    PmenuKind = { fg = p.dim, bg = p.panel },
+    PmenuKindSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuExtra = { fg = p.dim, bg = p.panel },
+    PmenuExtraSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuMatch = { fg = p.info, bg = p.panel, bold = true },
+    PmenuMatchSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuSbar = { bg = p.panel },
+    PmenuThumb = { bg = p.stealth },
+    ErrorMsg = { fg = p.danger },
+    WarningMsg = { fg = p.warn },
+    MoreMsg = { fg = p.info },
+    ModeMsg = { fg = p.text },
+    TabLine = { fg = p.dim, bg = p.panel },
+    TabLineSel = { fg = p.text, bg = p.void, bold = true },
+    TabLineFill = { fg = p.panel, bg = p.panel },
+    QuickFixLine = { fg = p.text, bg = p.panel, bold = true },
+
+    -- SYNTAX: typed by grammatical role (spec §7) ---------------------------
+    -- blue = kinds · cyan = actions · green = values · neutral = connective
+    Comment = { fg = p.dim, italic = true }, -- Ghost — not a target
+
+    Constant = { fg = p.const }, -- Green (cool) — const values
+    String = { fg = p.value }, -- Green — strings
+    Character = { fg = p.value },
+    Number = { fg = p.const },
+    Boolean = { fg = p.const },
+    Float = { fg = p.const },
+
+    Identifier = { fg = p.text }, -- Variables (calm body)
+    Property = { fg = p.prop }, -- Fields / properties (dim body)
+    Function = { fg = p.action }, -- Cyan — actions
+    Builtin = { fg = p.builtin, italic = true }, -- Cyan dim — self / builtin
+
+    Statement = { fg = p.flow, bold = true }, -- Bright-blue — control flow
+    Conditional = { fg = p.flow, bold = true },
+    Repeat = { fg = p.flow, bold = true },
+    Label = { fg = p.flow },
+    Operator = { fg = p.op }, -- Neutral
+    Keyword = { fg = p.storage }, -- Blue — storage / modifier
+    Exception = { fg = p.flow, bold = true }, -- Control flow (NOT danger — never red in code)
+
+    PreProc = { fg = p.action }, -- Cyan — preprocessor / macro ceremony
+    Include = { fg = p.storage }, -- Blue — declarative (use / import)
+    Define = { fg = p.action },
+    Macro = { fg = p.action, italic = true }, -- Cyan — bang-macros (action + ceremony)
+    PreCondit = { fg = p.action },
+
+    Type = { fg = p.kind }, -- Blue — kinds
+    StorageClass = { fg = p.storage, bold = true }, -- Blue heavy
+    Structure = { fg = p.kind },
+    Typedef = { fg = p.kind },
+    Attribute = { fg = p.storage, italic = true }, -- Blue declarative — #[derive], decorators
+
+    Special = { fg = p.escape }, -- Green — special tokens (escapes-adjacent)
+    SpecialChar = { fg = p.escape }, -- Green bright — string escapes / regex
+    Tag = { fg = p.kind }, -- Blue — structural HTML/XML tags
+    Delimiter = { fg = p.punct }, -- Neutral, lifted
+    Debug = { fg = p.special },
+
+    Underlined = { fg = p.info, underline = true },
+    Ignore = { fg = p.stealth },
+    Error = { fg = p.danger },
+    Todo = { fg = p.void, bg = p.warn, bold = true },
+    Title = { fg = p.info, bold = true },
+
+    MatchParen = { fg = p.focus_active, bold = true }, -- Attention — matched pair (violet)
+    Whitespace = { fg = p.border },
+    NonText = { fg = p.border },
+    SpecialKey = { fg = p.border },
+    SpellBad = { sp = p.danger, undercurl = true },
+    SpellCap = { sp = p.warn, undercurl = true },
+    SpellRare = { sp = p.info, undercurl = true },
+    SpellLocal = { sp = p.dim, undercurl = true },
+    LspReferenceText = { bg = p.panel },
+    LspReferenceRead = { bg = p.panel },
+    LspReferenceWrite = { bg = p.panel, bold = true },
+    LspSignatureActiveParameter = { fg = p.void, bg = p.info, bold = true },
+    LspInlayHint = { fg = p.dim, bg = p.panel },
+    LspCodeLens = { fg = p.dim },
+    LspCodeLensSeparator = { fg = p.stealth },
+    LspInfoBorder = { fg = p.border, bg = p.panel },
+    LspInfoTitle = { fg = p.dim, bg = p.panel },
+
+    -- DIAGNOSTICS -----------------------------------------------------------
+    DiagnosticError = { fg = p.danger },
+    DiagnosticWarn = { fg = p.warn },
+    DiagnosticInfo = { fg = p.info },
+    DiagnosticHint = { fg = p.dim },
+    DiagnosticOk = { fg = p.ok },
+    DiagnosticDeprecated = { fg = p.dim, strikethrough = true },
+    DiagnosticUnnecessary = { fg = p.dim },
+
+    DiagnosticUnderlineError = { undercurl = true, sp = p.danger },
+    DiagnosticUnderlineWarn = { undercurl = true, sp = p.warn },
+    DiagnosticUnderlineInfo = { undercurl = true, sp = p.info },
+    DiagnosticUnderlineHint = { undercurl = true, sp = p.dim },
+    DiagnosticUnderlineOk = { undercurl = true, sp = p.ok },
+    DiagnosticVirtualTextError = { fg = p.danger, bg = p.panel },
+    DiagnosticVirtualTextWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticVirtualTextInfo = { fg = p.info, bg = p.panel },
+    DiagnosticVirtualTextHint = { fg = p.dim, bg = p.panel },
+    DiagnosticVirtualTextOk = { fg = p.ok, bg = p.panel },
+    DiagnosticVirtualLinesError = { fg = p.danger, bg = p.panel },
+    DiagnosticVirtualLinesWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticVirtualLinesInfo = { fg = p.info, bg = p.panel },
+    DiagnosticVirtualLinesHint = { fg = p.dim, bg = p.panel },
+    DiagnosticVirtualLinesOk = { fg = p.ok, bg = p.panel },
+    DiagnosticSignError = { fg = p.danger, bg = p.void },
+    DiagnosticSignWarn = { fg = p.warn, bg = p.void },
+    DiagnosticSignInfo = { fg = p.info, bg = p.void },
+    DiagnosticSignHint = { fg = p.dim, bg = p.void },
+    DiagnosticSignOk = { fg = p.ok, bg = p.void },
+    DiagnosticFloatingError = { fg = p.danger, bg = p.panel },
+    DiagnosticFloatingWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticFloatingInfo = { fg = p.info, bg = p.panel },
+    DiagnosticFloatingHint = { fg = p.dim, bg = p.panel },
+    DiagnosticFloatingOk = { fg = p.ok, bg = p.panel },
+    ApexMarkupStrong = { bold = true },
+    ApexMarkupItalic = { italic = true },
+    ApexMarkupLink = { fg = p.info, underline = true },
+
+    -- DIFF (figure / ground — spec §8) --------------------------------------
+    DiffAdd = { fg = p.ok, bg = p.diff_add },
+    DiffChange = { fg = p.warn, bg = p.diff_chg },
+    DiffDelete = { fg = p.danger, bg = p.diff_del },
+    DiffText = { fg = p.void, bg = p.warn, bold = true },
+
+    -- PLUGINS: TELESCOPE ("The HUD") ----------------------------------------
+    TelescopeNormal = { bg = p.void },
+    TelescopeBorder = { fg = p.border, bg = p.void },
+    TelescopePromptNormal = { fg = p.text, bg = p.void },
+    TelescopePromptBorder = { fg = p.info, bg = p.void }, -- Cyan input border
+    TelescopePromptTitle = { fg = p.void, bg = p.info }, -- Cyan label
+    TelescopePreviewTitle = { fg = p.void, bg = p.ok }, -- Green label
+    TelescopeResultsTitle = { fg = p.dim, bg = p.panel },
+    TelescopeSelection = { fg = p.text, bg = p.focus_field, bold = true }, -- Violet field
+    TelescopeMatching = { fg = p.info, bold = true },
+
+    -- PLUGINS: NEO-TREE -----------------------------------------------------
+    NeoTreeNormal = { bg = p.void },
+    NeoTreeNormalNC = { bg = p.void },
+    NeoTreeVertSplit = { fg = p.panel, bg = p.void },
+    NeoTreeWinSeparator = { fg = p.panel, bg = p.void }, -- Fade out tree border
+    NeoTreeRootName = { fg = p.focus, bold = true }, -- Root = location (violet)
+    NeoTreeGitAdded = { fg = p.ok },
+    NeoTreeGitConflict = { fg = p.warn },
+    NeoTreeGitDeleted = { fg = p.danger },
+    NeoTreeGitModified = { fg = p.info },
+
+    -- PLUGINS: GITSIGNS -----------------------------------------------------
+    GitSignsAdd = { fg = p.ok, bg = p.void },
+    GitSignsChange = { fg = p.warn, bg = p.void },
+    GitSignsDelete = { fg = p.danger, bg = p.void },
+
+    -- PLUGINS: CMP (Completion) ---------------------------------------------
+    CmpItemAbbrDeprecated = { fg = p.dim, strikethrough = true },
+    CmpItemAbbrMatch = { fg = p.info, bold = true },
+    CmpItemAbbrMatchFuzzy = { fg = p.info, bold = true },
+    CmpItemKindFunction = { fg = p.action },
+    CmpItemKindMethod = { fg = p.action },
+    CmpItemKindKeyword = { fg = p.flow },
+    CmpItemKindVariable = { fg = p.text },
+
+    -- PLUGINS: BLINK.CMP (Completion) ----------------------------------------
+    BlinkCmpMenu             = { fg = p.text, bg = p.panel },
+    BlinkCmpMenuBorder       = { fg = p.border, bg = p.panel },
+    BlinkCmpMenuSelection    = { fg = p.void, bg = p.focus, bold = true },
+    BlinkCmpScrollBarThumb   = { bg = p.stealth },
+    BlinkCmpScrollBarGutter  = { bg = p.panel },
+    BlinkCmpLabel            = { fg = p.text },
+    BlinkCmpLabelDeprecated  = { fg = p.dim, strikethrough = true },
+    BlinkCmpLabelMatch       = { fg = p.info, bold = true },
+    BlinkCmpKindText         = { fg = p.text },
+    BlinkCmpKindMethod       = { fg = p.action },
+    BlinkCmpKindFunction     = { fg = p.action },
+    BlinkCmpKindConstructor  = { fg = p.kind },
+    BlinkCmpKindField        = { fg = p.prop },
+    BlinkCmpKindVariable     = { fg = p.text },
+    BlinkCmpKindClass        = { fg = p.kind },
+    BlinkCmpKindInterface    = { fg = p.kind },
+    BlinkCmpKindModule       = { fg = p.kind },
+    BlinkCmpKindProperty     = { fg = p.prop },
+    BlinkCmpKindUnit         = { fg = p.const },
+    BlinkCmpKindValue        = { fg = p.const },
+    BlinkCmpKindEnum         = { fg = p.kind },
+    BlinkCmpKindKeyword      = { fg = p.flow },
+    BlinkCmpKindSnippet      = { fg = p.value },
+    BlinkCmpKindColor        = { fg = p.info },
+    BlinkCmpKindFile         = { fg = p.text },
+    BlinkCmpKindReference    = { fg = p.info },
+    BlinkCmpKindFolder       = { fg = p.info },
+    BlinkCmpKindEnumMember   = { fg = p.const },
+    BlinkCmpKindConstant     = { fg = p.const },
+    BlinkCmpKindStruct       = { fg = p.kind },
+    BlinkCmpKindEvent        = { fg = p.kind },
+    BlinkCmpKindOperator     = { fg = p.op },
+    BlinkCmpKindTypeParameter = { fg = p.kind },
+    BlinkCmpGhostText        = { fg = p.stealth, italic = true },
+    BlinkCmpDoc              = { fg = p.text, bg = p.panel },
+    BlinkCmpDocBorder        = { fg = p.border, bg = p.panel },
+    BlinkCmpDocSeparator     = { fg = p.border, bg = p.panel },
+    BlinkCmpDocCursorLine    = { bg = p.border },
+    BlinkCmpSignatureHelp    = { fg = p.text, bg = p.panel },
+    BlinkCmpSignatureHelpBorder = { fg = p.border, bg = p.panel },
+    BlinkCmpSignatureHelpActiveParameter = { fg = p.void, bg = p.info, bold = true },
+    BlinkCmpSource           = { fg = p.dim },
+
+    -- PLUGINS: BUFFERLINE -----------------------------------------------------
+    BufferLineBackground        = { fg = p.dim, bg = p.panel },
+    BufferLineFill              = { bg = p.panel },
+    BufferLineBuffer            = { fg = p.dim, bg = p.panel },
+    BufferLineBufferSelected    = { fg = p.text, bg = p.void, bold = true },
+    BufferLineBufferVisible     = { fg = p.dim, bg = p.panel },
+    BufferLineTab               = { fg = p.dim, bg = p.panel },
+    BufferLineTabSelected       = { fg = p.text, bg = p.void, bold = true },
+    BufferLineTabClose          = { fg = p.dim, bg = p.panel },
+    BufferLineModified          = { fg = p.info, bg = p.panel },
+    BufferLineModifiedSelected  = { fg = p.info, bg = p.void },
+    BufferLineModifiedVisible   = { fg = p.info, bg = p.panel },
+    BufferLineSeparator         = { fg = p.border, bg = p.panel },
+    BufferLineSeparatorSelected = { fg = p.border, bg = p.void },
+    BufferLineSeparatorVisible  = { fg = p.border, bg = p.panel },
+    BufferLineIndicatorSelected = { fg = p.focus, bg = p.void }, -- Active = violet
+    BufferLineCloseButton       = { fg = p.dim, bg = p.panel },
+    BufferLineCloseButtonSelected = { fg = p.focus, bg = p.void },
+    BufferLineCloseButtonVisible  = { fg = p.dim, bg = p.panel },
+    BufferLineDiagnostic           = { fg = p.dim, bg = p.panel },
+    BufferLineDiagnosticSelected   = { fg = p.dim, bg = p.void },
+    BufferLineError                = { fg = p.danger, bg = p.panel },
+    BufferLineErrorSelected        = { fg = p.danger, bg = p.void, bold = true },
+    BufferLineWarning              = { fg = p.warn, bg = p.panel },
+    BufferLineWarningSelected      = { fg = p.warn, bg = p.void, bold = true },
+    BufferLineInfo                 = { fg = p.info, bg = p.panel },
+    BufferLineInfoSelected         = { fg = p.info, bg = p.void, bold = true },
+    BufferLineHint                 = { fg = p.dim, bg = p.panel },
+    BufferLineHintSelected         = { fg = p.dim, bg = p.void, bold = true },
+    BufferLinePick                 = { fg = p.focus, bg = p.panel, bold = true },
+    BufferLinePickSelected         = { fg = p.focus, bg = p.void, bold = true },
+    BufferLinePickVisible          = { fg = p.focus, bg = p.panel, bold = true },
+
+    -- PLUGINS: WHICH-KEY ------------------------------------------------------
+    WhichKey            = { fg = p.flow, bold = true }, -- The key trigger = navigation
+    WhichKeySeparator   = { fg = p.stealth },
+    WhichKeyGroup       = { fg = p.info },
+    WhichKeyDesc        = { fg = p.text },
+    WhichKeyFloat       = { bg = p.panel },
+    WhichKeyBorder      = { fg = p.border, bg = p.panel },
+    WhichKeyTitle       = { fg = p.void, bg = p.focus, bold = true },
+    WhichKeyNormal      = { fg = p.text, bg = p.panel },
+    WhichKeyValue       = { fg = p.dim },
+    WhichKeyIcon        = { fg = p.action },
+    WhichKeyIconAzure   = { fg = p.kind },
+    WhichKeyIconGreen   = { fg = p.ok },
+    WhichKeyIconYellow  = { fg = p.warn },
+    WhichKeyIconRed     = { fg = p.danger },
+    WhichKeyIconPurple  = { fg = p.special },
+    WhichKeyIconCyan    = { fg = p.info },
+
+    -- PLUGINS: TROUBLE --------------------------------------------------------
+    TroubleNormal       = { fg = p.text, bg = p.void },
+    TroubleNormalNC     = { fg = p.dim, bg = p.void },
+    TroubleText         = { fg = p.text },
+    TroubleCount        = { fg = p.void, bg = p.focus_active, bold = true },
+    TroubleError        = { fg = p.danger },
+    TroubleWarning      = { fg = p.warn },
+    TroubleHint         = { fg = p.dim },
+    TroubleInfo         = { fg = p.info },
+    TroubleSource       = { fg = p.dim },
+    TroubleCode         = { fg = p.stealth },
+    TroubleLocation     = { fg = p.dim },
+    TroubleFile         = { fg = p.info, bold = true },
+    TroubleIndent       = { fg = p.border },
+    TroublePos          = { fg = p.dim },
+    TroubleSignError    = { fg = p.danger },
+    TroubleSignWarning  = { fg = p.warn },
+    TroubleSignHint     = { fg = p.dim },
+    TroubleSignInfo     = { fg = p.info },
+    TroublePreview      = { fg = p.text, bg = p.focus_field },
+    TroubleFocusText    = { fg = p.text, bold = true },
+
+    -- PLUGINS: INDENT-BLANKLINE -----------------------------------------------
+    IblIndent     = { fg = p.border },
+    IblScope      = { fg = p.flow }, -- Current scope = structural (blue)
+    IblWhitespace = { fg = p.border },
+
+    -- PLUGINS: NEOGIT ---------------------------------------------------------
+    NeogitBranch                = { fg = p.flow, bold = true }, -- Ref / location
+    NeogitRemote                = { fg = p.info },
+    NeogitHunkHeader            = { fg = p.text, bg = p.panel, bold = true },
+    NeogitHunkHeaderHighlight   = { fg = p.void, bg = p.info, bold = true },
+    NeogitDiffAdd               = { fg = p.ok, bg = p.void },
+    NeogitDiffDelete            = { fg = p.danger, bg = p.void },
+    NeogitDiffContext           = { fg = p.dim, bg = p.void },
+    NeogitDiffAddHighlight      = { fg = p.ok, bg = p.diff_add },
+    NeogitDiffDeleteHighlight   = { fg = p.danger, bg = p.diff_del },
+    NeogitDiffContextHighlight  = { fg = p.text, bg = p.panel },
+    NeogitCommitViewHeader      = { fg = p.void, bg = p.info, bold = true },
+    NeogitFilePath              = { fg = p.info, underline = true },
+    NeogitDiffHeader            = { fg = p.warn, bold = true },
+    NeogitDiffHeaderHighlight   = { fg = p.void, bg = p.warn, bold = true },
+    NeogitObjectId              = { fg = p.dim },
+    NeogitStashes               = { fg = p.special },
+    NeogitRebaseDone            = { fg = p.ok },
+    NeogitFold                  = { fg = p.stealth },
+
+    -- PLUGINS: AERIAL (Symbols Outline) --------------------------------------
+    AerialLine          = { fg = p.ink, bg = p.focus_field },
+    AerialLineNC        = { fg = p.dim, bg = p.panel },
+    AerialNormal        = { fg = p.text, bg = p.void },
+    AerialGuide         = { fg = p.border },
+    AerialClass         = { fg = p.kind },
+    AerialClassIcon     = { fg = p.kind },
+    AerialFunction      = { fg = p.action },
+    AerialFunctionIcon  = { fg = p.action },
+    AerialMethod        = { fg = p.action },
+    AerialMethodIcon    = { fg = p.action },
+    AerialConstructor   = { fg = p.kind },
+    AerialField         = { fg = p.prop },
+    AerialVariable      = { fg = p.text },
+    AerialEnum          = { fg = p.kind },
+    AerialEnumIcon      = { fg = p.kind },
+    AerialInterface     = { fg = p.kind },
+    AerialModule        = { fg = p.kind },
+    AerialNamespace     = { fg = p.kind },
+    AerialPackage       = { fg = p.kind },
+    AerialProperty      = { fg = p.prop },
+    AerialStruct        = { fg = p.kind },
+    AerialType          = { fg = p.kind },
+    AerialTypeParameter = { fg = p.kind },
+    AerialConstant      = { fg = p.const },
+    AerialString        = { fg = p.value },
+    AerialNumber        = { fg = p.const },
+    AerialBoolean       = { fg = p.const },
+    AerialKey           = { fg = p.flow },
+    AerialKeyword       = { fg = p.flow },
+    AerialOperator      = { fg = p.op },
+    AerialNull          = { fg = p.dim },
+    AerialArray         = { fg = p.const },
+    AerialObject        = { fg = p.kind },
+    AerialEvent         = { fg = p.kind },
+
+    -- PLUGINS: DAP-UI ---------------------------------------------------------
+    DapUIScope                    = { fg = p.info, bold = true },
+    DapUIType                     = { fg = p.kind },
+    DapUIDecoration               = { fg = p.border },
+    DapUIThread                   = { fg = p.ok },
+    DapUIStoppedThread            = { fg = p.danger, bold = true }, -- Halted = alarm
+    DapUICurrentFrameName         = { fg = p.danger, bold = true },
+    DapUISource                   = { fg = p.dim },
+    DapUILineNumber               = { fg = p.stealth },
+    DapUIFloatBorder              = { fg = p.border, bg = p.panel },
+    DapUIFloatNormal              = { fg = p.text, bg = p.panel },
+    DapUIWatchesEmpty             = { fg = p.dim },
+    DapUIWatchesValue             = { fg = p.value },
+    DapUIWatchesError             = { fg = p.danger },
+    DapUIBreakpointsPath          = { fg = p.info },
+    DapUIBreakpointsInfo          = { fg = p.dim },
+    DapUIBreakpointsCurrentLine   = { fg = p.danger, bold = true },
+    DapUIBreakpointsDisabledLine  = { fg = p.stealth },
+    DapUIEndofBuffer              = { fg = p.void },
+    DapUIModifiedValue            = { fg = p.warn, bold = true },
+    DapUIStop                     = { fg = p.danger },
+    DapUIStepOver                 = { fg = p.info },
+    DapUIStepInto                 = { fg = p.info },
+    DapUIStepBack                 = { fg = p.info },
+    DapUIStepOut                  = { fg = p.info },
+    DapUIRestart                  = { fg = p.ok },
+    DapUIUnavailable              = { fg = p.stealth },
+    DapUIPlayPause                = { fg = p.ok },
+
+    -- PLUGINS: DAP VIRTUAL TEXT -----------------------------------------------
+    NvimDapVirtualText        = { fg = p.dim, italic = true },
+    NvimDapVirtualTextChanged = { fg = p.warn, italic = true },
+    NvimDapVirtualTextError   = { fg = p.danger, italic = true },
+    NvimDapVirtualTextInfo    = { fg = p.info, italic = true },
+
+    -- PLUGINS: NVIM-NOTIFY ----------------------------------------------------
+    NotifyERRORBorder = { fg = p.danger },
+    NotifyWARNBorder  = { fg = p.warn },
+    NotifyINFOBorder  = { fg = p.info },
+    NotifyDEBUGBorder = { fg = p.stealth },
+    NotifyTRACEBorder = { fg = p.special },
+    NotifyERRORIcon   = { fg = p.danger },
+    NotifyWARNIcon    = { fg = p.warn },
+    NotifyINFOIcon    = { fg = p.info },
+    NotifyDEBUGIcon   = { fg = p.stealth },
+    NotifyTRACEIcon   = { fg = p.special },
+    NotifyERRORTitle  = { fg = p.danger, bold = true },
+    NotifyWARNTitle   = { fg = p.warn, bold = true },
+    NotifyINFOTitle   = { fg = p.info, bold = true },
+    NotifyDEBUGTitle  = { fg = p.stealth, bold = true },
+    NotifyTRACETitle  = { fg = p.special, bold = true },
+    NotifyERRORBody   = { fg = p.text, bg = p.panel },
+    NotifyWARNBody    = { fg = p.text, bg = p.panel },
+    NotifyINFOBody    = { fg = p.text, bg = p.panel },
+    NotifyDEBUGBody   = { fg = p.dim, bg = p.panel },
+    NotifyTRACEBody   = { fg = p.dim, bg = p.panel },
+
+    -- PLUGINS: SATELLITE (Scrollbar) -----------------------------------------
+    SatelliteBar      = { bg = p.panel },
+    SatelliteCursor   = { fg = p.focus }, -- Cursor position = violet
+    SatellitePosition = { fg = p.dim },
+    SatelliteError    = { fg = p.danger },
+    SatelliteWarning  = { fg = p.warn },
+    SatelliteHint     = { fg = p.dim },
+    SatelliteInfo     = { fg = p.info },
+    SatelliteSearch   = { fg = p.focus_active }, -- Search = violet
+    SatelliteGit      = { fg = p.ok },
+    SatelliteMark     = { fg = p.warn },
+
+    -- PLUGINS: OIL.NVIM (File Explorer) --------------------------------------
+    OilDir            = { fg = p.info, bold = true },
+    OilDirIcon        = { fg = p.info },
+    OilLink           = { fg = p.flow, italic = true }, -- Symlink = structural (blue)
+    OilLinkTarget     = { fg = p.flow },
+    OilCopy           = { fg = p.warn, bold = true },
+    OilMove           = { fg = p.warn },
+    OilChange         = { fg = p.info },
+    OilCreate         = { fg = p.ok, bold = true },
+    OilDelete         = { fg = p.danger, bold = true }, -- Destructive = danger
+    OilPermissionNone = { fg = p.stealth },
+    OilPermissionRead = { fg = p.info },
+    OilPermissionWrite = { fg = p.warn },
+    OilPermissionExecute = { fg = p.ok },
+    OilTypeDir        = { fg = p.info },
+    OilTypeFile       = { fg = p.text },
+    OilTypeLink       = { fg = p.flow },
+    OilTypeSpecial    = { fg = p.special },
+    OilSize           = { fg = p.dim },
+    OilMtime          = { fg = p.stealth },
+
+    -- PLUGINS: NEOTEST --------------------------------------------------------
+    NeotestPassed       = { fg = p.ok },
+    NeotestFailed       = { fg = p.danger },
+    NeotestRunning      = { fg = p.warn },
+    NeotestSkipped      = { fg = p.dim },
+    NeotestUnknown      = { fg = p.stealth },
+    NeotestTest         = { fg = p.text },
+    NeotestFile         = { fg = p.info },
+    NeotestDir          = { fg = p.info, bold = true },
+    NeotestNamespace    = { fg = p.kind },
+    NeotestMarked       = { fg = p.focus, bold = true }, -- Mark = attention
+    NeotestTarget       = { fg = p.focus },
+    NeotestAdapterName  = { fg = p.info, bold = true },
+    NeotestWinSelect    = { fg = p.info, bold = true },
+    NeotestFocused      = { bold = true },
+    NeotestIndent       = { fg = p.border },
+    NeotestExpandMarker = { fg = p.dim },
+    NeotestWatching     = { fg = p.warn },
+
+    -- PLUGINS: GRUG-FAR (Search & Replace) -----------------------------------
+    GrugFarResultsHeader      = { fg = p.void, bg = p.focus, bold = true }, -- Search = violet
+    GrugFarResultsMatch       = { fg = p.ink, bg = p.focus_field, bold = true },
+    GrugFarResultsMatchAdded  = { fg = p.ok },
+    GrugFarResultsMatchRemoved = { fg = p.danger },
+    GrugFarResultsLineNo      = { fg = p.dim },
+    GrugFarResultsPath        = { fg = p.info, underline = true },
+    GrugFarResultsStats       = { fg = p.dim },
+    GrugFarInputLabel         = { fg = p.warn, bold = true },
+    GrugFarInputPlaceholder   = { fg = p.stealth },
+    GrugFarHelpHeader         = { fg = p.dim, bold = true },
+    GrugFarHelpWinHeader      = { fg = p.text, bg = p.panel, bold = true },
+
+    -- PLUGINS: TWINNY (AI Ghost Text) ----------------------------------------
+    TwinnyAccept       = { fg = p.stealth, italic = true },
+    TwinnyHint         = { fg = p.stealth, italic = true },
+
+    -- PLUGINS: GITSIGNS (extended) -------------------------------------------
+    GitSignsCurrentLineBlame  = { fg = p.stealth, italic = true },
+    GitSignsAddNr             = { fg = p.ok },
+    GitSignsChangeNr          = { fg = p.warn },
+    GitSignsDeleteNr          = { fg = p.danger },
+    GitSignsAddLn             = { fg = p.ok, bg = p.diff_add },
+    GitSignsChangeLn          = { fg = p.warn, bg = p.diff_chg },
+    GitSignsDeleteLn          = { fg = p.danger, bg = p.diff_del },
+    GitSignsAddPreview        = { fg = p.ok, bg = p.diff_add },
+    GitSignsDeletePreview     = { fg = p.danger, bg = p.diff_del },
+    GitSignsAddInline         = { fg = p.void, bg = p.ok },
+    GitSignsDeleteInline      = { fg = p.void, bg = p.danger },
+    GitSignsChangeInline      = { fg = p.void, bg = p.warn },
+    GitSignsUntracked         = { fg = p.dim },
+
+    -- PLUGINS: RENDER-MARKDOWN ------------------------------------------------
+    -- Heading ramp avoids red + violet (both reserved); uses code-safe hues only.
+    RenderMarkdownH1         = { fg = p.info, bold = true },
+    RenderMarkdownH2         = { fg = p.flow, bold = true },
+    RenderMarkdownH3         = { fg = p.kind, bold = true },
+    RenderMarkdownH4         = { fg = p.ok, bold = true },
+    RenderMarkdownH5         = { fg = p.warn, bold = true },
+    RenderMarkdownH6         = { fg = p.dim, bold = true },
+    RenderMarkdownH1Bg       = { bg = p.panel },
+    RenderMarkdownH2Bg       = { bg = p.panel },
+    RenderMarkdownH3Bg       = { bg = p.panel },
+    RenderMarkdownH4Bg       = { bg = p.panel },
+    RenderMarkdownH5Bg       = { bg = p.panel },
+    RenderMarkdownH6Bg       = { bg = p.panel },
+    RenderMarkdownCode       = { bg = p.panel },
+    RenderMarkdownCodeInline = { fg = p.value, bg = p.panel },
+    RenderMarkdownBullet     = { fg = p.info },
+    RenderMarkdownQuote      = { fg = p.dim, italic = true },
+    RenderMarkdownDash       = { fg = p.border },
+    RenderMarkdownLink       = { fg = p.info, underline = true },
+    RenderMarkdownSign       = { bg = p.void },
+    RenderMarkdownMath       = { fg = p.info },
+    RenderMarkdownTableHead  = { fg = p.void, bg = p.info, bold = true },
+    RenderMarkdownTableRow   = { fg = p.text },
+    RenderMarkdownTableFill  = { fg = p.border },
+    RenderMarkdownTodo       = { fg = p.void, bg = p.warn, bold = true },
+    RenderMarkdownUnchecked  = { fg = p.stealth },
+    RenderMarkdownChecked    = { fg = p.ok },
+  }
+
+  for group, highlight in pairs(groups) do
+    vim.api.nvim_set_hl(0, group, highlight)
+  end
+
+  local links = {
+    ["@annotation"] = "Attribute",
+    ["@attribute"] = "Attribute",
+    ["@character"] = "Character",
+    ["@comment"] = "Comment",
+    ["@constant"] = "Constant",
+    ["@constant.builtin"] = "Constant",
+    ["@constant.macro"] = "Macro",
+    ["@constructor"] = "Type",
+    ["@debug"] = "Debug",
+    ["@define"] = "Define",
+    ["@exception"] = "Exception",
+    ["@field"] = "Property",
+    ["@float"] = "Float",
+    ["@function"] = "Function",
+    ["@function.builtin"] = "Function",
+    ["@function.call"] = "Function",
+    ["@function.macro"] = "Macro",
+    ["@include"] = "Include",
+    ["@keyword"] = "Keyword",
+    ["@keyword.conditional"] = "Conditional",
+    ["@keyword.repeat"] = "Repeat",
+    ["@keyword.return"] = "Statement",
+    ["@keyword.function"] = "Keyword",
+    ["@keyword.operator"] = "Operator",
+    ["@keyword.exception"] = "Exception",
+    ["@label"] = "Label",
+    ["@method"] = "Function",
+    ["@method.call"] = "Function",
+    ["@module"] = "Structure",
+    ["@namespace"] = "Structure",
+    ["@number"] = "Number",
+    ["@operator"] = "Operator",
+    ["@parameter"] = "Identifier",
+    ["@preproc"] = "PreProc",
+    ["@property"] = "Property",
+    ["@punctuation"] = "Delimiter",
+    ["@punctuation.bracket"] = "Delimiter",
+    ["@punctuation.delimiter"] = "Delimiter",
+    ["@punctuation.special"] = "Delimiter",
+    ["@repeat"] = "Repeat",
+    ["@string"] = "String",
+    ["@string.escape"] = "SpecialChar",
+    ["@string.regex"] = "SpecialChar",
+    ["@string.special"] = "SpecialChar",
+    ["@tag"] = "Tag",
+    ["@tag.attribute"] = "Property",
+    ["@tag.delimiter"] = "Delimiter",
+    ["@text"] = "Normal",
+    ["@text.title"] = "Title",
+    ["@markup.heading"] = "Title",
+    ["@markup.heading.1"] = "Title",
+    ["@markup.heading.2"] = "Title",
+    ["@markup.heading.3"] = "Title",
+    ["@markup.heading.4"] = "Title",
+    ["@markup.heading.5"] = "Title",
+    ["@markup.heading.6"] = "Title",
+    ["@markup.link"] = "ApexMarkupLink",
+    ["@markup.link.label"] = "ApexMarkupLink",
+    ["@markup.link.url"] = "ApexMarkupLink",
+    ["@markup.strong"] = "ApexMarkupStrong",
+    ["@markup.italic"] = "ApexMarkupItalic",
+    ["@markup.strikethrough"] = "DiagnosticDeprecated",
+    ["@markup.underline"] = "Underlined",
+    ["@markup.raw"] = "String",
+    ["@markup.raw.block"] = "String",
+    ["@markup.raw.delimiter"] = "Delimiter",
+    ["@markup.quote"] = "Comment",
+    ["@markup.list"] = "Delimiter",
+    ["@markup.list.checked"] = "String",
+    ["@markup.list.unchecked"] = "Comment",
+    ["@markup.math"] = "Constant",
+    ["@markup.environment"] = "Type",
+    ["@markup.environment.name"] = "Type",
+    ["@type"] = "Type",
+    ["@type.builtin"] = "Type",
+    ["@type.definition"] = "Type",
+    ["@type.qualifier"] = "Keyword",
+    ["@variable"] = "Identifier",
+    ["@variable.builtin"] = "Builtin",
+    ["@variable.parameter"] = "Identifier",
+    ["@variable.member"] = "Property",
+
+    ["@lsp.type.boolean"] = "Boolean",
+    ["@lsp.type.builtinType"] = "Type",
+    ["@lsp.type.class"] = "Type",
+    ["@lsp.type.comment"] = "Comment",
+    ["@lsp.type.decorator"] = "Attribute",
+    ["@lsp.type.enum"] = "Type",
+    ["@lsp.type.enumMember"] = "Constant",
+    ["@lsp.type.event"] = "Type",
+    ["@lsp.type.function"] = "Function",
+    ["@lsp.type.interface"] = "Type",
+    ["@lsp.type.keyword"] = "Keyword",
+    ["@lsp.type.macro"] = "Macro",
+    ["@lsp.type.method"] = "Function",
+    ["@lsp.type.modifier"] = "Keyword",
+    ["@lsp.type.namespace"] = "Structure",
+    ["@lsp.type.number"] = "Number",
+    ["@lsp.type.operator"] = "Operator",
+    ["@lsp.type.parameter"] = "Identifier",
+    ["@lsp.type.property"] = "Property",
+    ["@lsp.type.regexp"] = "SpecialChar",
+    ["@lsp.type.string"] = "String",
+    ["@lsp.type.struct"] = "Structure",
+    ["@lsp.type.type"] = "Type",
+    ["@lsp.type.typeParameter"] = "Type",
+    ["@lsp.type.variable"] = "Identifier",
+
+    ["@lsp.mod.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.mod.abstract"] = "Type",
+    ["@lsp.mod.declaration"] = "Keyword",
+    ["@lsp.mod.defaultLibrary"] = "Constant",
+    ["@lsp.mod.definition"] = "Keyword",
+    ["@lsp.mod.documentation"] = "Comment",
+    ["@lsp.mod.modification"] = "Operator",
+    ["@lsp.mod.readonly"] = "Constant",
+    ["@lsp.mod.static"] = "Constant",
+    ["@lsp.mod.async"] = "Keyword",
+
+    ["@lsp.typemod.function.async"] = "Keyword",
+    ["@lsp.typemod.method.async"] = "Keyword",
+    ["@lsp.typemod.function.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.method.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.variable.deprecated"] = "DiagnosticDeprecated",
+    ["@lsp.typemod.variable.readonly"] = "Constant",
+    ["@lsp.typemod.parameter.readonly"] = "Constant",
+    ["@lsp.typemod.property.readonly"] = "Constant",
+    ["@lsp.typemod.variable.static"] = "Constant",
+    ["@lsp.typemod.property.static"] = "Constant",
+  }
+
+  for group, target in pairs(links) do
+    vim.api.nvim_set_hl(0, group, { link = target })
+  end
+end
+
+M.load()
+
+-- PLUGINS: LUALINE --------------------------------------------------------
+-- Export lualine theme from palette for use in lualine config.
+-- Mode hues stay distinct: normal=violet(attention), insert=green, visual=cyan,
+-- replace=amber, command=violet-deep. fg = void for contrast on bright accents.
+do
+  local p = M.palette
+  M.lualine = {
+    normal = {
+      a = { fg = p.void, bg = p.focus, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    insert = {
+      a = { fg = p.void, bg = p.ok, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    visual = {
+      a = { fg = p.void, bg = p.info, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    replace = {
+      a = { fg = p.void, bg = p.warn, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    command = {
+      a = { fg = p.void, bg = p.special, gui = "bold" },
+      b = { fg = p.text, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+    inactive = {
+      a = { fg = p.dim, bg = p.panel },
+      b = { fg = p.dim, bg = p.panel },
+      c = { fg = p.dim, bg = p.void },
+    },
+  }
+end
+
+return M

dist/owlry/apex-aeon.css

@@ -0,0 +1,171 @@
+
+
+/*
+ * Owlry - Apex Aeon Theme
+ * v2 spine: red = danger · violet = attention · cyan = info
+ *
+ * A high-contrast theme built for focus and clinical clarity.
+ * Color exists to signal STATE, not to decorate space.
+ *
+ * Author: S0wlz (Owlibou)
+ *
+ * Usage: Set theme = "apex-aeon" in config
+ */
+
+:root {
+    /* Core surfaces */
+    --owlry-bg: #f1f3f7;
+    --owlry-bg-secondary: #e7eaf0;
+    --owlry-border: #c2c8d4;
+    --owlry-text: #16181d;
+    --owlry-text-secondary: #5c6270;
+
+    /* Attention - primary accent (caret, selection, focus) is violet */
+    --owlry-accent: #7c2fd6;
+    --owlry-accent-bright: #8c3dd0;
+
+    /* Provider badges - mapped to Apex v2 semantics */
+    --owlry-badge-app: #0080a6;        /* Cyan: apps are informational */
+    --owlry-badge-bookmark: #a86b00;   /* Amber: bookmarks need attention */
+    --owlry-badge-calc: #8a5800;       /* Bright amber: calculator results */
+    --owlry-badge-clip: #6a1fb8;       /* Purple: clipboard is special */
+    --owlry-badge-cmd: #6a1fb8;        /* Purple: commands are elevated */
+    --owlry-badge-dmenu: #00875a;      /* Green: dmenu is success/pipe */
+    --owlry-badge-emoji: #6a1fb8;      /* Bright purple: emoji is special */
+    --owlry-badge-file: #0e6e92;       /* Bright cyan: file search is active info */
+    --owlry-badge-script: #006e49;     /* Bright green: scripts execute successfully */
+    --owlry-badge-ssh: #0080a6;        /* Cyan: SSH is technical/info */
+    --owlry-badge-sys: #c8003a;        /* Red: system actions are critical/danger */
+    --owlry-badge-uuctl: #a86b00;      /* Amber: uuctl requires attention */
+    --owlry-badge-web: #0080a6;        /* Cyan: web is informational */
+
+    /* Widget badges */
+    --owlry-badge-media: #6a1fb8;      /* Bright purple: media is special */
+    --owlry-badge-weather: #0e6e92;    /* Bright cyan: weather is active info */
+    --owlry-badge-pomo: #9e0030;       /* Alert red: pomodoro alarm */
+}
+
+.owlry-main {
+    background-color: rgba(241, 243, 247, 0.98);
+    border: 1px solid rgba(194, 200, 212, 0.8);
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.8),
+                0 0 0 1px rgba(124, 47, 214, 0.1);
+}
+
+.owlry-search {
+    background-color: rgba(231, 234, 240, 0.9);
+    border: 2px solid rgba(194, 200, 212, 0.8);
+    color: var(--owlry-text);
+    caret-color: var(--owlry-accent);
+}
+
+.owlry-search:focus {
+    border-color: var(--owlry-accent);
+    box-shadow: 0 0 0 2px rgba(124, 47, 214, 0.3);
+}
+
+.owlry-result-row:hover {
+    background-color: rgba(231, 234, 240, 0.8);
+}
+
+.owlry-result-row:selected {
+    background-color: rgba(124, 47, 214, 0.15);
+    border-left: 3px solid var(--owlry-accent);
+}
+
+.owlry-result-row:selected .owlry-result-name {
+    color: var(--owlry-accent-bright);
+}
+
+.owlry-result-row:selected .owlry-result-icon {
+    color: var(--owlry-accent);
+}
+
+/* Provider badges - styled per Apex v2 semantics */
+.owlry-badge-app {
+    background-color: rgba(0, 128, 166, 0.15);
+    color: var(--owlry-badge-app);
+}
+
+.owlry-badge-bookmark {
+    background-color: rgba(168, 107, 0, 0.15);
+    color: var(--owlry-badge-bookmark);
+}
+
+.owlry-badge-calc {
+    background-color: rgba(138, 88, 0, 0.15);
+    color: var(--owlry-badge-calc);
+}
+
+.owlry-badge-clip {
+    background-color: rgba(106, 31, 184, 0.15);
+    color: var(--owlry-badge-clip);
+}
+
+.owlry-badge-cmd {
+    background-color: rgba(106, 31, 184, 0.15);
+    color: var(--owlry-badge-cmd);
+}
+
+.owlry-badge-dmenu {
+    background-color: rgba(0, 135, 90, 0.15);
+    color: var(--owlry-badge-dmenu);
+}
+
+.owlry-badge-emoji {
+    background-color: rgba(106, 31, 184, 0.15);
+    color: var(--owlry-badge-emoji);
+}
+
+.owlry-badge-file {
+    background-color: rgba(14, 110, 146, 0.15);
+    color: var(--owlry-badge-file);
+}
+
+.owlry-badge-script {
+    background-color: rgba(0, 110, 73, 0.15);
+    color: var(--owlry-badge-script);
+}
+
+.owlry-badge-ssh {
+    background-color: rgba(0, 128, 166, 0.15);
+    color: var(--owlry-badge-ssh);
+}
+
+.owlry-badge-sys {
+    background-color: rgba(200, 0, 58, 0.15);
+    color: var(--owlry-badge-sys);
+}
+
+.owlry-badge-uuctl {
+    background-color: rgba(168, 107, 0, 0.15);
+    color: var(--owlry-badge-uuctl);
+}
+
+.owlry-badge-web {
+    background-color: rgba(0, 128, 166, 0.15);
+    color: var(--owlry-badge-web);
+}
+
+/* Widget badges */
+.owlry-badge-media {
+    background-color: rgba(106, 31, 184, 0.15);
+    color: var(--owlry-badge-media);
+}
+
+.owlry-badge-weather {
+    background-color: rgba(14, 110, 146, 0.15);
+    color: var(--owlry-badge-weather);
+}
+
+.owlry-badge-pomo {
+    background-color: rgba(158, 0, 48, 0.15);
+    color: var(--owlry-badge-pomo);
+}
+
+/* Filter button - default uses the violet attention accent */
+.owlry-filter-button:checked {
+    background-color: rgba(124, 47, 214, 0.2);
+    color: var(--owlry-accent);
+    border-color: rgba(124, 47, 214, 0.5);
+}

dist/owlry/apex-neon.css

@@ -0,0 +1,171 @@
+
+
+/*
+ * Owlry - Apex Neon Theme
+ * v2 spine: red = danger · violet = attention · cyan = info
+ *
+ * A high-contrast theme built for focus and clinical clarity.
+ * Color exists to signal STATE, not to decorate space.
+ *
+ * Author: S0wlz (Owlibou)
+ *
+ * Usage: Set theme = "apex-neon" in config
+ */
+
+:root {
+    /* Core surfaces */
+    --owlry-bg: #070709;
+    --owlry-bg-secondary: #101218;
+    --owlry-border: #262a34;
+    --owlry-text: #e6e8ec;
+    --owlry-text-secondary: #8b909c;
+
+    /* Attention - primary accent (caret, selection, focus) is violet */
+    --owlry-accent: #d68fff;
+    --owlry-accent-bright: #b14dff;
+
+    /* Provider badges - mapped to Apex v2 semantics */
+    --owlry-badge-app: #00eaff;        /* Cyan: apps are informational */
+    --owlry-badge-bookmark: #ffb700;   /* Amber: bookmarks need attention */
+    --owlry-badge-calc: #ffd24d;       /* Bright amber: calculator results */
+    --owlry-badge-clip: #9d00ff;       /* Purple: clipboard is special */
+    --owlry-badge-cmd: #9d00ff;        /* Purple: commands are elevated */
+    --owlry-badge-dmenu: #00ff99;      /* Green: dmenu is success/pipe */
+    --owlry-badge-emoji: #c84dff;      /* Bright purple: emoji is special */
+    --owlry-badge-file: #5af3ff;       /* Bright cyan: file search is active info */
+    --owlry-badge-script: #2bffb2;     /* Bright green: scripts execute successfully */
+    --owlry-badge-ssh: #00eaff;        /* Cyan: SSH is technical/info */
+    --owlry-badge-sys: #ff0044;        /* Red: system actions are critical/danger */
+    --owlry-badge-uuctl: #ffb700;      /* Amber: uuctl requires attention */
+    --owlry-badge-web: #00eaff;        /* Cyan: web is informational */
+
+    /* Widget badges */
+    --owlry-badge-media: #c84dff;      /* Bright purple: media is special */
+    --owlry-badge-weather: #5af3ff;    /* Bright cyan: weather is active info */
+    --owlry-badge-pomo: #ff3b3b;       /* Alert red: pomodoro alarm */
+}
+
+.owlry-main {
+    background-color: rgba(7, 7, 9, 0.98);
+    border: 1px solid rgba(38, 42, 52, 0.8);
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.8),
+                0 0 0 1px rgba(214, 143, 255, 0.1);
+}
+
+.owlry-search {
+    background-color: rgba(16, 18, 24, 0.9);
+    border: 2px solid rgba(38, 42, 52, 0.8);
+    color: var(--owlry-text);
+    caret-color: var(--owlry-accent);
+}
+
+.owlry-search:focus {
+    border-color: var(--owlry-accent);
+    box-shadow: 0 0 0 2px rgba(214, 143, 255, 0.3);
+}
+
+.owlry-result-row:hover {
+    background-color: rgba(16, 18, 24, 0.8);
+}
+
+.owlry-result-row:selected {
+    background-color: rgba(214, 143, 255, 0.15);
+    border-left: 3px solid var(--owlry-accent);
+}
+
+.owlry-result-row:selected .owlry-result-name {
+    color: var(--owlry-accent-bright);
+}
+
+.owlry-result-row:selected .owlry-result-icon {
+    color: var(--owlry-accent);
+}
+
+/* Provider badges - styled per Apex v2 semantics */
+.owlry-badge-app {
+    background-color: rgba(0, 234, 255, 0.15);
+    color: var(--owlry-badge-app);
+}
+
+.owlry-badge-bookmark {
+    background-color: rgba(255, 183, 0, 0.15);
+    color: var(--owlry-badge-bookmark);
+}
+
+.owlry-badge-calc {
+    background-color: rgba(255, 210, 77, 0.15);
+    color: var(--owlry-badge-calc);
+}
+
+.owlry-badge-clip {
+    background-color: rgba(157, 0, 255, 0.15);
+    color: var(--owlry-badge-clip);
+}
+
+.owlry-badge-cmd {
+    background-color: rgba(157, 0, 255, 0.15);
+    color: var(--owlry-badge-cmd);
+}
+
+.owlry-badge-dmenu {
+    background-color: rgba(0, 255, 153, 0.15);
+    color: var(--owlry-badge-dmenu);
+}
+
+.owlry-badge-emoji {
+    background-color: rgba(200, 77, 255, 0.15);
+    color: var(--owlry-badge-emoji);
+}
+
+.owlry-badge-file {
+    background-color: rgba(90, 243, 255, 0.15);
+    color: var(--owlry-badge-file);
+}
+
+.owlry-badge-script {
+    background-color: rgba(43, 255, 178, 0.15);
+    color: var(--owlry-badge-script);
+}
+
+.owlry-badge-ssh {
+    background-color: rgba(0, 234, 255, 0.15);
+    color: var(--owlry-badge-ssh);
+}
+
+.owlry-badge-sys {
+    background-color: rgba(255, 0, 68, 0.15);
+    color: var(--owlry-badge-sys);
+}
+
+.owlry-badge-uuctl {
+    background-color: rgba(255, 183, 0, 0.15);
+    color: var(--owlry-badge-uuctl);
+}
+
+.owlry-badge-web {
+    background-color: rgba(0, 234, 255, 0.15);
+    color: var(--owlry-badge-web);
+}
+
+/* Widget badges */
+.owlry-badge-media {
+    background-color: rgba(200, 77, 255, 0.15);
+    color: var(--owlry-badge-media);
+}
+
+.owlry-badge-weather {
+    background-color: rgba(90, 243, 255, 0.15);
+    color: var(--owlry-badge-weather);
+}
+
+.owlry-badge-pomo {
+    background-color: rgba(255, 59, 59, 0.15);
+    color: var(--owlry-badge-pomo);
+}
+
+/* Filter button - default uses the violet attention accent */
+.owlry-filter-button:checked {
+    background-color: rgba(214, 143, 255, 0.2);
+    color: var(--owlry-accent);
+    border-color: rgba(214, 143, 255, 0.5);
+}

dist/spicetify/apex-aeon-color.ini

@@ -0,0 +1,17 @@
+
+[apex-aeon]
+text               = 16181d
+subtext            = 5c6270
+main               = f1f3f7
+sidebar            = f1f3f7
+player             = f1f3f7
+card               = e7eaf0
+shadow             = 000000
+selected-row       = 0080a6
+button             = 0080a6
+button-active      = 7c2fd6
+button-disabled    = c8cdd8
+tab-active         = c2c8d4
+notification       = 0080a6
+notification-error = c8003a
+misc               = a86b00

dist/spicetify/apex-aeon-user.css

@@ -0,0 +1 @@
+/* Apex Aeon - Spicetify overrides */

dist/spicetify/apex-neon-color.ini

@@ -0,0 +1,17 @@
+
+[apex-neon]
+text               = e6e8ec
+subtext            = 8b909c
+main               = 070709
+sidebar            = 070709
+player             = 070709
+card               = 101218
+shadow             = 000000
+selected-row       = 00eaff
+button             = 00eaff
+button-active      = d68fff
+button-disabled    = 383d49
+tab-active         = 262a34
+notification       = 00eaff
+notification-error = ff0044
+misc               = ffb700

dist/spicetify/apex-neon-user.css

@@ -0,0 +1 @@
+/* Apex Neon - Spicetify overrides */

dist/tmux/apex-aeon.conf

@@ -0,0 +1,36 @@
+# Apex Aeon — tmux theme
+# Generated by the Apex build system. Do not edit.
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Status bar
+set -g status-style "fg=#16181d,bg=#e7eaf0"
+
+# Status left: session name — violet attention accent ("you are here")
+set -g status-left "#[fg=#f1f3f7,bg=#7c2fd6,bold] #S #[fg=#e7eaf0,bg=#e7eaf0]"
+set -g status-left-length 30
+
+# Status right: date/time in muted
+set -g status-right "#[fg=#5c6270,bg=#e7eaf0] %H:%M %d-%b "
+set -g status-right-length 30
+
+# Window list
+set -g window-status-format "#[fg=#5c6270,bg=#e7eaf0] #I:#W "
+set -g window-status-current-format "#[fg=#16181d,bg=#e7eaf0,bold] #I:#W #[fg=#7c2fd6]▏"
+
+# Pane borders — active = danger red (spec §5)
+set -g pane-border-style "fg=#c2c8d4"
+set -g pane-active-border-style "fg=#c8003a"
+
+# Messages
+set -g message-style "fg=#0080a6,bg=#e7eaf0"
+set -g message-command-style "fg=#f1f3f7,bg=#7c2fd6"
+
+# Copy mode — violet attention selection
+set -g mode-style "fg=#f1f3f7,bg=#8c3dd0,bold"
+
+# Clock
+set -g clock-mode-colour "#0080a6"
+
+# Misc
+set -g status-position bottom
+set -g status-justify left

dist/tmux/apex-neon.conf

@@ -0,0 +1,36 @@
+# Apex Neon — tmux theme
+# Generated by the Apex build system. Do not edit.
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Status bar
+set -g status-style "fg=#e6e8ec,bg=#101218"
+
+# Status left: session name — violet attention accent ("you are here")
+set -g status-left "#[fg=#070709,bg=#d68fff,bold] #S #[fg=#101218,bg=#101218]"
+set -g status-left-length 30
+
+# Status right: date/time in muted
+set -g status-right "#[fg=#8b909c,bg=#101218] %H:%M %d-%b "
+set -g status-right-length 30
+
+# Window list
+set -g window-status-format "#[fg=#8b909c,bg=#101218] #I:#W "
+set -g window-status-current-format "#[fg=#e6e8ec,bg=#101218,bold] #I:#W #[fg=#d68fff]▏"
+
+# Pane borders — active = danger red (spec §5)
+set -g pane-border-style "fg=#262a34"
+set -g pane-active-border-style "fg=#ff0044"
+
+# Messages
+set -g message-style "fg=#00eaff,bg=#101218"
+set -g message-command-style "fg=#070709,bg=#d68fff"
+
+# Copy mode — violet attention selection
+set -g mode-style "fg=#070709,bg=#b14dff,bold"
+
+# Clock
+set -g clock-mode-colour "#00eaff"
+
+# Misc
+set -g status-position bottom
+set -g status-justify left

dist/zathura/apex-aeon-zathurarc

@@ -0,0 +1,46 @@
+# Apex Aeon — Zathura Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Core
+set default-bg              "#f1f3f7"
+set default-fg              "#16181d"
+
+# Status Bar
+set statusbar-bg            "#e7eaf0"
+set statusbar-fg            "#16181d"
+
+# Input Bar
+set inputbar-bg             "#e7eaf0"
+set inputbar-fg             "#16181d"
+
+# Completion
+set completion-bg           "#e7eaf0"
+set completion-fg           "#16181d"
+set completion-group-bg     "#c2c8d4"
+set completion-group-fg     "#5c6270"
+set completion-highlight-bg "#efe2fb"
+set completion-highlight-fg "#16181d"
+
+# Notifications
+set notification-bg         "#e7eaf0"
+set notification-fg         "#16181d"
+set notification-error-bg   "#c8003a"
+set notification-error-fg   "#f1f3f7"
+set notification-warning-bg "#a86b00"
+set notification-warning-fg "#f1f3f7"
+
+# Search highlight — violet attention (current match brighter)
+set highlight-color         "rgba(8c3dd0, 0.5)"
+set highlight-active-color  "rgba(8c3dd0, 0.8)"
+
+# Recolor (Dark Mode for PDFs)
+# In Neon (Dark), we want dark paper (background) and light ink (foreground).
+# In Aeon (Light), we want light paper and dark ink (standard).
+set recolor-lightcolor      "#f1f3f7"
+set recolor-darkcolor       "#16181d"
+
+# Default recolor state
+# Ideally, only true for dark themes, but Zathura config is static.
+# Users can toggle with Ctrl+R.
+set recolor                 "false"
+set recolor-keephue         "true"

dist/zathura/apex-neon-zathurarc

@@ -0,0 +1,46 @@
+# Apex Neon — Zathura Theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+# Core
+set default-bg              "#070709"
+set default-fg              "#e6e8ec"
+
+# Status Bar
+set statusbar-bg            "#101218"
+set statusbar-fg            "#e6e8ec"
+
+# Input Bar
+set inputbar-bg             "#101218"
+set inputbar-fg             "#e6e8ec"
+
+# Completion
+set completion-bg           "#101218"
+set completion-fg           "#e6e8ec"
+set completion-group-bg     "#262a34"
+set completion-group-fg     "#8b909c"
+set completion-highlight-bg "#3a1a4d"
+set completion-highlight-fg "#e6e8ec"
+
+# Notifications
+set notification-bg         "#101218"
+set notification-fg         "#e6e8ec"
+set notification-error-bg   "#ff0044"
+set notification-error-fg   "#070709"
+set notification-warning-bg "#ffb700"
+set notification-warning-fg "#070709"
+
+# Search highlight — violet attention (current match brighter)
+set highlight-color         "rgba(b14dff, 0.5)"
+set highlight-active-color  "rgba(b14dff, 0.8)"
+
+# Recolor (Dark Mode for PDFs)
+# In Neon (Dark), we want dark paper (background) and light ink (foreground).
+# In Aeon (Light), we want light paper and dark ink (standard).
+set recolor-lightcolor      "#070709"
+set recolor-darkcolor       "#e6e8ec"
+
+# Default recolor state
+# Ideally, only true for dark themes, but Zathura config is static.
+# Users can toggle with Ctrl+R.
+set recolor                 "false"
+set recolor-keephue         "true"

dist/zed/apex.json

@@ -0,0 +1,632 @@
+{
+  "$schema": "https://zed.dev/schema/themes/v0.2.0.json",
+  "name": "Apex",
+  "author": "S0wlz (Owlibou)",
+  "themes": [
+    
+    {
+      "name": "Apex Neon",
+      "appearance": "dark",
+      "style": {
+        "background": "#070709",
+        "background.appearance": "opaque",
+        "surface.background": "#101218",
+        "elevated_surface.background": "#101218",
+        "panel.background": "#101218",
+        "panel.focused_border": "#d68fff",
+        "panel.indent_guide": "#262a3466",
+        "panel.indent_guide_active": "#8b909caa",
+        "panel.indent_guide_hover": "#8b909ccc",
+        "tab_bar.background": "#101218",
+        "tab.inactive_background": "#101218",
+        "tab.active_background": "#070709",
+        "title_bar.background": "#070709",
+        "title_bar.inactive_background": "#101218",
+        "toolbar.background": "#101218",
+        "status_bar.background": "#101218",
+        "border": "#262a34",
+        "border.variant": "#101218",
+        "border.focused": "#d68fff",
+        "border.selected": "#d68fff",
+        "border.disabled": "#101218",
+        "border.transparent": "transparent",
+        "text": "#e6e8ec",
+        "text.muted": "#8b909c",
+        "text.placeholder": "#8b909c",
+        "text.disabled": "#8b909c",
+        "text.accent": "#00eaff",
+        "icon": "#e6e8ec",
+        "icon.muted": "#8b909c",
+        "icon.placeholder": "#8b909c",
+        "icon.disabled": "#8b909c",
+        "icon.accent": "#00eaff",
+        "accents": [
+          "#d68fff",
+          "#00eaff",
+          "#9d00ff",
+          "#00ff99",
+          "#ffb700"
+        ],
+        "element.background": "#101218",
+        "element.hover": "#262a34",
+        "element.active": "#262a34",
+        "element.selected": "#262a34",
+        "element.disabled": "#101218",
+        "ghost_element.background": null,
+        "ghost_element.hover": "#262a3466",
+        "ghost_element.active": "#262a3488",
+        "ghost_element.selected": "#262a3466",
+        "ghost_element.disabled": null,
+        "drop_target.background": "#00eaff22",
+        "editor.background": "#070709",
+        "editor.foreground": "#e6e8ec",
+        "editor.gutter.background": "#070709",
+        "editor.subheader.background": "#101218",
+        "editor.active_line.background": "#101218",
+        "editor.highlighted_line.background": "#101218",
+        "editor.line_number": "#8b909c",
+        "editor.active_line_number": "#d68fff",
+        "editor.wrap_guide": "#262a34",
+        "editor.active_wrap_guide": "#8b909c",
+        "editor.indent_guide": "#262a3466",
+        "editor.indent_guide_active": "#8b909caa",
+        "editor.invisible": "#262a3488",
+        "editor.document_highlight.read_background": "#00eaff22",
+        "editor.document_highlight.write_background": "#d68fff22",
+        "editor.document_highlight.bracket_background": "#262a3466",
+        "search.match_background": "#b14dff33",
+        "scrollbar.track.background": "#070709",
+        "scrollbar.track.border": "#070709",
+        "scrollbar.thumb.background": "#262a34aa",
+        "scrollbar.thumb.hover_background": "#383d49",
+        "scrollbar.thumb.border": "transparent",
+        "pane.focused_border": "#d68fff",
+        "pane_group.border": "#262a34",
+        "link_text.hover": "#5b8cff",
+        "success": "#00ff99",
+        "success.background": "#00ff991a",
+        "success.border": "#00ff99",
+        "warning": "#ffb700",
+        "warning.background": "#ffb7001a",
+        "warning.border": "#ffb700",
+        "error": "#ff0044",
+        "error.background": "#ff00441a",
+        "error.border": "#ff0044",
+        "info": "#00eaff",
+        "info.background": "#00eaff1a",
+        "info.border": "#00eaff",
+        "hint": "#2e6bff",
+        "hint.background": "#2e6bff1a",
+        "hint.border": "#2e6bff",
+        "predictive": "#8b909c",
+        "predictive.background": "#8b909c1a",
+        "predictive.border": "#8b909c",
+        "unreachable": "#9d00ff",
+        "unreachable.background": "#9d00ff1a",
+        "unreachable.border": "#9d00ff",
+        "created": "#00ff99",
+        "created.background": "#00ff991a",
+        "created.border": "#00ff99",
+        "modified": "#ffb700",
+        "modified.background": "#ffb7001a",
+        "modified.border": "#ffb700",
+        "deleted": "#ff0044",
+        "deleted.background": "#ff00441a",
+        "deleted.border": "#ff0044",
+        "renamed": "#00eaff",
+        "renamed.background": "#00eaff1a",
+        "renamed.border": "#00eaff",
+        "conflict": "#ff0044",
+        "conflict.background": "#ff00441a",
+        "conflict.border": "#ff0044",
+        "ignored": "#8b909c",
+        "ignored.background": "#8b909c1a",
+        "ignored.border": "#262a34",
+        "hidden": "#8b909c",
+        "hidden.background": "#8b909c1a",
+        "hidden.border": "#262a34",
+        "terminal.background": "#070709",
+        "terminal.foreground": "#e6e8ec",
+        "terminal.bright_foreground": "#ffffff",
+        "terminal.dim_foreground": "#8b909c",
+        "terminal.ansi.background": "#070709",
+        "terminal.ansi.black": "#070709",
+        "terminal.ansi.red": "#ff0044",
+        "terminal.ansi.green": "#00ff99",
+        "terminal.ansi.yellow": "#ffb700",
+        "terminal.ansi.blue": "#2e6bff",
+        "terminal.ansi.magenta": "#9d00ff",
+        "terminal.ansi.cyan": "#00eaff",
+        "terminal.ansi.white": "#e6e8ec",
+        "terminal.ansi.bright_black": "#383d49",
+        "terminal.ansi.bright_red": "#ff3b3b",
+        "terminal.ansi.bright_green": "#2bffb2",
+        "terminal.ansi.bright_yellow": "#ffd24d",
+        "terminal.ansi.bright_blue": "#5b8cff",
+        "terminal.ansi.bright_magenta": "#c84dff",
+        "terminal.ansi.bright_cyan": "#5af3ff",
+        "terminal.ansi.bright_white": "#ffffff",
+        "terminal.ansi.dim_black": "#070709",
+        "terminal.ansi.dim_red": "#ff0044",
+        "terminal.ansi.dim_green": "#00ff99",
+        "terminal.ansi.dim_yellow": "#ffb700",
+        "terminal.ansi.dim_blue": "#2e6bff",
+        "terminal.ansi.dim_magenta": "#9d00ff",
+        "terminal.ansi.dim_cyan": "#00eaff",
+        "terminal.ansi.dim_white": "#e6e8ec",
+        "players": [
+          {
+            "cursor": "#d68fff",
+            "background": "#d68fff",
+            "selection": "#d68fff33"
+          },
+          {
+            "cursor": "#00eaff",
+            "background": "#00eaff",
+            "selection": "#00eaff33"
+          },
+          {
+            "cursor": "#9d00ff",
+            "background": "#9d00ff",
+            "selection": "#9d00ff33"
+          },
+          {
+            "cursor": "#00ff99",
+            "background": "#00ff99",
+            "selection": "#00ff9933"
+          },
+          {
+            "cursor": "#ffb700",
+            "background": "#ffb700",
+            "selection": "#ffb70033"
+          }
+        ],
+        "version_control.added": "#00ff99",
+        "version_control.modified": "#ffb700",
+        "version_control.deleted": "#ff0044",
+        "version_control.conflict": "#ff0044",
+        "version_control.renamed": "#00eaff",
+        "version_control.ignored": "#8b909c",
+        "syntax": {
+          "comment": {
+            "color": "#8b909c",
+            "font_style": "italic"
+          },
+          "comment.doc": {
+            "color": "#8b909c",
+            "font_style": "italic"
+          },
+          "keyword": {
+            "color": "#5b8cff"
+          },
+          "keyword.import": {
+            "color": "#5b8cff"
+          },
+          "keyword.storage": {
+            "color": "#2e6bff"
+          },
+          "function": {
+            "color": "#5af3ff"
+          },
+          "function.method": {
+            "color": "#5af3ff"
+          },
+          "function.special.definition": {
+            "color": "#5af3ff"
+          },
+          "type": {
+            "color": "#7db4ff"
+          },
+          "type.builtin": {
+            "color": "#7db4ff"
+          },
+          "string": {
+            "color": "#2bffb2"
+          },
+          "string.escape": {
+            "color": "#7dffd0"
+          },
+          "string.regex": {
+            "color": "#7dffd0"
+          },
+          "number": {
+            "color": "#37dba0"
+          },
+          "boolean": {
+            "color": "#37dba0"
+          },
+          "constant": {
+            "color": "#37dba0"
+          },
+          "constant.builtin": {
+            "color": "#37dba0"
+          },
+          "variable": {
+            "color": "#e6e8ec"
+          },
+          "variable.special": {
+            "color": "#8fd6ff"
+          },
+          "property": {
+            "color": "#cdd4e3"
+          },
+          "attribute": {
+            "color": "#2e6bff"
+          },
+          "tag": {
+            "color": "#7db4ff"
+          },
+          "label": {
+            "color": "#5b8cff"
+          },
+          "operator": {
+            "color": "#c2c8d4"
+          },
+          "punctuation": {
+            "color": "#aab0bc"
+          },
+          "punctuation.bracket": {
+            "color": "#aab0bc"
+          },
+          "punctuation.delimiter": {
+            "color": "#aab0bc"
+          },
+          "punctuation.list_marker": {
+            "color": "#aab0bc",
+            "font_weight": 700
+          },
+          "link_text": {
+            "color": "#00eaff"
+          },
+          "link_uri": {
+            "color": "#2e6bff"
+          },
+          "emphasis": {
+            "font_style": "italic"
+          },
+          "emphasis.strong": {
+            "font_weight": 700
+          },
+          "title": {
+            "color": "#e6e8ec",
+            "font_weight": 700
+          },
+          "text.literal": {
+            "color": "#2bffb2"
+          },
+          "preproc": {
+            "color": "#5af3ff"
+          },
+          "constructor": {
+            "color": "#7db4ff"
+          },
+          "enum": {
+            "color": "#7db4ff"
+          },
+          "variant": {
+            "color": "#37dba0"
+          },
+          "hint": {
+            "color": "#8b909c"
+          },
+          "predictive": {
+            "color": "#8b909c"
+          }
+        }
+      }
+    },
+    
+    {
+      "name": "Apex Aeon",
+      "appearance": "light",
+      "style": {
+        "background": "#f1f3f7",
+        "background.appearance": "opaque",
+        "surface.background": "#e7eaf0",
+        "elevated_surface.background": "#ffffff",
+        "panel.background": "#e7eaf0",
+        "panel.focused_border": "#7c2fd6",
+        "panel.indent_guide": "#c2c8d466",
+        "panel.indent_guide_active": "#5c6270aa",
+        "panel.indent_guide_hover": "#5c6270cc",
+        "tab_bar.background": "#e7eaf0",
+        "tab.inactive_background": "#e7eaf0",
+        "tab.active_background": "#f1f3f7",
+        "title_bar.background": "#f1f3f7",
+        "title_bar.inactive_background": "#e7eaf0",
+        "toolbar.background": "#e7eaf0",
+        "status_bar.background": "#e7eaf0",
+        "border": "#c2c8d4",
+        "border.variant": "#c8cdd8",
+        "border.focused": "#7c2fd6",
+        "border.selected": "#7c2fd6",
+        "border.disabled": "#c8cdd8",
+        "border.transparent": "transparent",
+        "text": "#16181d",
+        "text.muted": "#5c6270",
+        "text.placeholder": "#5c6270",
+        "text.disabled": "#c8cdd8",
+        "text.accent": "#0080a6",
+        "icon": "#16181d",
+        "icon.muted": "#5c6270",
+        "icon.placeholder": "#5c6270",
+        "icon.disabled": "#c8cdd8",
+        "icon.accent": "#0080a6",
+        "accents": [
+          "#7c2fd6",
+          "#0080a6",
+          "#6a1fb8",
+          "#00875a",
+          "#a86b00"
+        ],
+        "element.background": "#ffffff",
+        "element.hover": "#c2c8d4",
+        "element.active": "#c2c8d4",
+        "element.selected": "#c2c8d4",
+        "element.disabled": "#e7eaf0",
+        "ghost_element.background": null,
+        "ghost_element.hover": "#c2c8d466",
+        "ghost_element.active": "#c2c8d488",
+        "ghost_element.selected": "#c2c8d466",
+        "ghost_element.disabled": null,
+        "drop_target.background": "#0080a622",
+        "editor.background": "#f1f3f7",
+        "editor.foreground": "#16181d",
+        "editor.gutter.background": "#f1f3f7",
+        "editor.subheader.background": "#e7eaf0",
+        "editor.active_line.background": "#e7eaf0",
+        "editor.highlighted_line.background": "#e7eaf0",
+        "editor.line_number": "#5c6270",
+        "editor.active_line_number": "#7c2fd6",
+        "editor.wrap_guide": "#c2c8d4",
+        "editor.active_wrap_guide": "#5c6270",
+        "editor.indent_guide": "#c2c8d466",
+        "editor.indent_guide_active": "#5c6270aa",
+        "editor.invisible": "#c2c8d488",
+        "editor.document_highlight.read_background": "#0080a61a",
+        "editor.document_highlight.write_background": "#7c2fd61a",
+        "editor.document_highlight.bracket_background": "#c2c8d466",
+        "search.match_background": "#8c3dd044",
+        "scrollbar.track.background": "#f1f3f7",
+        "scrollbar.track.border": "#f1f3f7",
+        "scrollbar.thumb.background": "#c8cdd8aa",
+        "scrollbar.thumb.hover_background": "#5c6270",
+        "scrollbar.thumb.border": "transparent",
+        "pane.focused_border": "#7c2fd6",
+        "pane_group.border": "#c8cdd8",
+        "link_text.hover": "#1633a0",
+        "success": "#00875a",
+        "success.background": "#00875a1a",
+        "success.border": "#00875a",
+        "warning": "#a86b00",
+        "warning.background": "#a86b001a",
+        "warning.border": "#a86b00",
+        "error": "#c8003a",
+        "error.background": "#c8003a1a",
+        "error.border": "#c8003a",
+        "info": "#0080a6",
+        "info.background": "#0080a61a",
+        "info.border": "#0080a6",
+        "hint": "#2148c0",
+        "hint.background": "#2148c01a",
+        "hint.border": "#2148c0",
+        "predictive": "#5c6270",
+        "predictive.background": "#5c62701a",
+        "predictive.border": "#5c6270",
+        "unreachable": "#6a1fb8",
+        "unreachable.background": "#6a1fb81a",
+        "unreachable.border": "#6a1fb8",
+        "created": "#00875a",
+        "created.background": "#00875a1a",
+        "created.border": "#00875a",
+        "modified": "#a86b00",
+        "modified.background": "#a86b001a",
+        "modified.border": "#a86b00",
+        "deleted": "#c8003a",
+        "deleted.background": "#c8003a1a",
+        "deleted.border": "#c8003a",
+        "renamed": "#0080a6",
+        "renamed.background": "#0080a61a",
+        "renamed.border": "#0080a6",
+        "conflict": "#c8003a",
+        "conflict.background": "#c8003a1a",
+        "conflict.border": "#c8003a",
+        "ignored": "#5c6270",
+        "ignored.background": "#5c62701a",
+        "ignored.border": "#c2c8d4",
+        "hidden": "#5c6270",
+        "hidden.background": "#5c62701a",
+        "hidden.border": "#c2c8d4",
+        "terminal.background": "#f1f3f7",
+        "terminal.foreground": "#16181d",
+        "terminal.bright_foreground": "#16181d",
+        "terminal.dim_foreground": "#5c6270",
+        "terminal.ansi.background": "#f1f3f7",
+        "terminal.ansi.black": "#16181d",
+        "terminal.ansi.red": "#c8003a",
+        "terminal.ansi.green": "#00875a",
+        "terminal.ansi.yellow": "#a86b00",
+        "terminal.ansi.blue": "#2148c0",
+        "terminal.ansi.magenta": "#7c2fd6",
+        "terminal.ansi.cyan": "#0080a6",
+        "terminal.ansi.white": "#c2c8d4",
+        "terminal.ansi.bright_black": "#5c6270",
+        "terminal.ansi.bright_red": "#9e0030",
+        "terminal.ansi.bright_green": "#006e49",
+        "terminal.ansi.bright_yellow": "#8a5800",
+        "terminal.ansi.bright_blue": "#1633a0",
+        "terminal.ansi.bright_magenta": "#6a1fb8",
+        "terminal.ansi.bright_cyan": "#0e6e92",
+        "terminal.ansi.bright_white": "#f1f3f7",
+        "terminal.ansi.dim_black": "#16181d",
+        "terminal.ansi.dim_red": "#c8003a",
+        "terminal.ansi.dim_green": "#00875a",
+        "terminal.ansi.dim_yellow": "#a86b00",
+        "terminal.ansi.dim_blue": "#2148c0",
+        "terminal.ansi.dim_magenta": "#7c2fd6",
+        "terminal.ansi.dim_cyan": "#0080a6",
+        "terminal.ansi.dim_white": "#c2c8d4",
+        "players": [
+          {
+            "cursor": "#7c2fd6",
+            "background": "#7c2fd6",
+            "selection": "#7c2fd633"
+          },
+          {
+            "cursor": "#0080a6",
+            "background": "#0080a6",
+            "selection": "#0080a633"
+          },
+          {
+            "cursor": "#6a1fb8",
+            "background": "#6a1fb8",
+            "selection": "#6a1fb833"
+          },
+          {
+            "cursor": "#00875a",
+            "background": "#00875a",
+            "selection": "#00875a33"
+          },
+          {
+            "cursor": "#a86b00",
+            "background": "#a86b00",
+            "selection": "#a86b0033"
+          }
+        ],
+        "version_control.added": "#00875a",
+        "version_control.modified": "#a86b00",
+        "version_control.deleted": "#c8003a",
+        "version_control.conflict": "#c8003a",
+        "version_control.renamed": "#0080a6",
+        "version_control.ignored": "#5c6270",
+        "syntax": {
+          "comment": {
+            "color": "#5c6270",
+            "font_style": "italic"
+          },
+          "comment.doc": {
+            "color": "#5c6270",
+            "font_style": "italic"
+          },
+          "keyword": {
+            "color": "#1633a0"
+          },
+          "keyword.import": {
+            "color": "#1633a0"
+          },
+          "keyword.storage": {
+            "color": "#1633a0"
+          },
+          "function": {
+            "color": "#0e6e92"
+          },
+          "function.method": {
+            "color": "#0e6e92"
+          },
+          "function.special.definition": {
+            "color": "#0e6e92"
+          },
+          "type": {
+            "color": "#2148c0"
+          },
+          "type.builtin": {
+            "color": "#2148c0"
+          },
+          "string": {
+            "color": "#00734d"
+          },
+          "string.escape": {
+            "color": "#2b8f63"
+          },
+          "string.regex": {
+            "color": "#2b8f63"
+          },
+          "number": {
+            "color": "#00875a"
+          },
+          "boolean": {
+            "color": "#00875a"
+          },
+          "constant": {
+            "color": "#00875a"
+          },
+          "constant.builtin": {
+            "color": "#00875a"
+          },
+          "variable": {
+            "color": "#16181d"
+          },
+          "variable.special": {
+            "color": "#3a7d9c"
+          },
+          "property": {
+            "color": "#2e333d"
+          },
+          "attribute": {
+            "color": "#2148c0"
+          },
+          "tag": {
+            "color": "#2148c0"
+          },
+          "label": {
+            "color": "#1633a0"
+          },
+          "operator": {
+            "color": "#5c6270"
+          },
+          "punctuation": {
+            "color": "#7d8390"
+          },
+          "punctuation.bracket": {
+            "color": "#7d8390"
+          },
+          "punctuation.delimiter": {
+            "color": "#7d8390"
+          },
+          "punctuation.list_marker": {
+            "color": "#7d8390",
+            "font_weight": 700
+          },
+          "link_text": {
+            "color": "#0080a6"
+          },
+          "link_uri": {
+            "color": "#2148c0"
+          },
+          "emphasis": {
+            "font_style": "italic"
+          },
+          "emphasis.strong": {
+            "font_weight": 700
+          },
+          "title": {
+            "color": "#16181d",
+            "font_weight": 700
+          },
+          "text.literal": {
+            "color": "#00734d"
+          },
+          "preproc": {
+            "color": "#0e6e92"
+          },
+          "constructor": {
+            "color": "#2148c0"
+          },
+          "enum": {
+            "color": "#2148c0"
+          },
+          "variant": {
+            "color": "#00875a"
+          },
+          "hint": {
+            "color": "#5c6270"
+          },
+          "predictive": {
+            "color": "#5c6270"
+          }
+        }
+      }
+    }
+    
+  ]
+}

dist/zsh/apex-aeon.zsh-theme

@@ -0,0 +1,630 @@
+# Apex Aeon — Predator Cockpit (Zsh) — v2
+# Two-bus design:
+#   [precmd radar]  -> after-action + context bursts (event-driven)
+#   [promptline]    -> LEFT: identity + territory
+#                      RIGHT: intel + vcs + friction (stable)
+
+setopt prompt_subst
+setopt no_beep
+
+zmodload zsh/datetime 2>/dev/null
+
+# -----------------------------------------------------------------------------
+# 1) PALETTE (Apex Aeon DNA)
+# -----------------------------------------------------------------------------
+typeset -gA C
+C[VOID]="#f1f3f7"
+C[WHITE]="#16181d"
+C[MUTED]="#5c6270"
+C[RAZOR]="#7c2fd6"
+C[CYAN]="#0080a6"
+C[GOLD]="#a86b00"
+C[OK]="#00875a"
+C[PURPLE]="#6a1fb8"
+C[ALERT]="#c8003a"
+
+# -----------------------------------------------------------------------------
+# 1b) PLUGIN COLORS
+# -----------------------------------------------------------------------------
+# zsh-autosuggestions: ghost text from history (subtle, intentionally dim)
+ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=#5c6270"
+
+# zsh-history-substring-search
+HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_FOUND="fg=#0080a6,bold"
+HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_NOT_FOUND="fg=#c8003a,bold"
+
+# -----------------------------------------------------------------------------
+# 2) ICONS / GLYPHS (Nerd Font optional)
+# -----------------------------------------------------------------------------
+typeset -gA I
+I[OS]=""
+I[SSH]=""
+I[ROOT]=""
+I[GIT]=""
+I[JOBS]=""
+I[RADAR]="⌁"
+I[RET]="↩"
+
+typeset -gA S
+S[PL_L]=""
+S[PL_R]=""
+S[DOT]="·"
+
+# -----------------------------------------------------------------------------
+# 3) CONFIG
+# -----------------------------------------------------------------------------
+typeset -gA APEX
+APEX[SLOW_SOFT_MS]=750
+APEX[SLOW_HARD_MS]=2000
+
+APEX[STARTUP_BURST]=1
+APEX[SHOW_AAR]=1
+APEX[SHOW_CONTEXT_BURST]=1
+APEX[SHOW_VCS]=1
+APEX[SHOW_INTEL]=1
+APEX[SHOW_JOBS]=1
+APEX[SHOW_RO]=1
+APEX[GIT_AHEAD_BEHIND]=1
+
+# Ops commands (also match wrappers like sudo/doas/command)
+APEX[OPS_RE]='^((sudo|doas|command)[[:space:]]+)*((pacman|yay|paru|apt|dnf|brew|systemctl|docker|kubectl|helm|git))([[:space:]]|$)'
+
+# Session-ish commands (spawn a subshell; exit codes are often “not a failure”)
+APEX[SESSION_RE]='^((sudo|doas|command)[[:space:]]+)*chezmoi[[:space:]]+cd([[:space:]]|$)'
+
+# -----------------------------------------------------------------------------
+# 4) STATE
+# -----------------------------------------------------------------------------
+typeset -gF apex_cmd_start=0.0
+typeset -g  apex_last_cmd=""
+typeset -g  apex_has_run_cmd=0
+
+typeset -g  apex_startup_done=0
+typeset -g  apex_pwd_changed=1
+
+# Sticky intel
+typeset -g  apex_venv_name=""
+typeset -g  apex_target_sig=""
+typeset -g  apex_mode_sig=""
+
+# Git state
+typeset -g  apex_in_git=0
+typeset -g  apex_git_branch=""
+typeset -g  apex_git_dirty_wt=0
+typeset -g  apex_git_dirty_ix=0
+typeset -g  apex_git_untracked=0
+typeset -g  apex_git_conflict=0
+typeset -g  apex_git_op=""
+typeset -g  apex_git_up_ok=0
+typeset -g  apex_git_ahead=0
+typeset -g  apex_git_behind=0
+typeset -g  apex_git_stash=0
+typeset -g  apex_git_root=""
+typeset -g  apex_git_dir=""
+
+# Radar previous snapshots (transition detection)
+typeset -g  apex_prev_in_git=-1
+typeset -g  apex_prev_git_branch=""
+typeset -g  apex_prev_git_op=""
+typeset -g  apex_prev_venv_name=""
+typeset -g  apex_prev_target_sig=""
+typeset -g  apex_prev_proj_sig=""
+
+# -----------------------------------------------------------------------------
+# 5) UTILITIES
+# -----------------------------------------------------------------------------
+apex__short_cmd() {
+  local s="$1"
+  s="${s//$'
+'/ }"
+  s="${s#"${s%%[![:space:]]*}"}"   # ltrim
+  s="${s%"${s##*[![:space:]]}"}"   # rtrim
+  print -r -- "${s[1,90]}"
+}
+
+apex__project_sig() {
+  local s=""
+  [[ -f package.json ]] && s+="node"
+  [[ -f pnpm-lock.yaml ]] && s+="+pnpm"
+  [[ -f bun.lockb ]] && s+="+bun"
+  [[ -f yarn.lock ]] && s+="+yarn"
+
+  [[ -f pyproject.toml || -f requirements.txt ]] && s+="${s:+ }py"
+  [[ -f uv.lock ]] && s+="+uv"
+
+  [[ -f Cargo.toml ]] && s+="${s:+ }rust"
+  [[ -f go.mod ]] && s+="${s:+ }go"
+
+  [[ -n "$s" ]] && print -r -- "$s"
+}
+
+apex__escape_prompt() {
+  local s="$1"
+  s="${s//\\%/%%}"
+  print -r -- "$s"
+}
+
+apex__now_float() {
+  if [[ -n "${EPOCHREALTIME:-}" ]]; then
+    print -r -- "$EPOCHREALTIME"
+  elif [[ -n "${EPOCHSECONDS:-}" ]]; then
+    print -r -- "${EPOCHSECONDS}.0"
+  else
+    print -r -- "0.0"
+  fi
+}
+
+apex__find_git_root() {
+  local dir="$PWD"
+  local git_root=""
+  local git_dir=""
+
+  while [[ -n "$dir" ]]; do
+    if [[ -d "$dir/.git" ]]; then
+      git_root="$dir"
+      git_dir="$dir/.git"
+      break
+    elif [[ -f "$dir/.git" ]]; then
+      local line
+      line="$(<"$dir/.git")"
+      if [[ "$line" == gitdir:* ]]; then
+        git_root="$dir"
+        git_dir="${line#gitdir: }"
+        [[ "$git_dir" != /* ]] && git_dir="$dir/$git_dir"
+        break
+      fi
+    fi
+
+    [[ "$dir" == "/" ]] && break
+    dir="${dir:h}"
+  done
+
+  [[ -n "$git_root" ]] && print -r -- "${git_root}|${git_dir}"
+}
+
+# -----------------------------------------------------------------------------
+# 6) INTEL (sticky; updated each prompt)
+# -----------------------------------------------------------------------------
+apex_update_intel() {
+  # Target (cheap env-based; no kubectl calls)
+  if [[ -n "$AWS_PROFILE" ]]; then
+    apex_target_sig="aws:${AWS_PROFILE}"
+  elif [[ -n "$GOOGLE_CLOUD_PROJECT" ]]; then
+    apex_target_sig="gcp:${GOOGLE_CLOUD_PROJECT}"
+  elif [[ -n "$KUBE_CONTEXT" ]]; then
+    apex_target_sig="kube:${KUBE_CONTEXT}"
+  else
+    apex_target_sig=""
+  fi
+
+  # Mode
+  if [[ -n "$IN_NIX_SHELL" ]]; then
+    apex_mode_sig="nix"
+  elif [[ -n "$DIRENV_DIR" ]]; then
+    apex_mode_sig="direnv"
+  elif [[ -f /run/.containerenv || -f /.dockerenv ]]; then
+    apex_mode_sig="ctr"
+  else
+    apex_mode_sig=""
+  fi
+
+  # Venv
+  apex_venv_name=""
+  if [[ -n "$VIRTUAL_ENV" ]]; then
+    apex_venv_name="$(basename "$VIRTUAL_ENV")"
+  elif [[ -n "$CONDA_DEFAULT_ENV" ]]; then
+    apex_venv_name="$CONDA_DEFAULT_ENV"
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 7) GIT
+# -----------------------------------------------------------------------------
+apex_git_update() {
+  apex_in_git=0
+  apex_git_branch=""
+  apex_git_dirty_wt=0
+  apex_git_dirty_ix=0
+  apex_git_untracked=0
+  apex_git_conflict=0
+  apex_git_op=""
+  apex_git_up_ok=0
+  apex_git_ahead=0
+  apex_git_behind=0
+  apex_git_stash=0
+
+  local status_out
+  status_out="$(command git status --porcelain=2 --branch 2>/dev/null)" || {
+    apex_git_root=""
+    apex_git_dir=""
+    return
+  }
+  apex_in_git=1
+
+  if (( apex_pwd_changed )) || [[ -z "$apex_git_root" ]]; then
+    local root_info
+    root_info="$(apex__find_git_root)"
+    if [[ -n "$root_info" ]]; then
+      apex_git_root="${root_info%%|*}"
+      apex_git_dir="${root_info#*|}"
+    else
+      apex_git_root=""
+      apex_git_dir=""
+    fi
+  fi
+
+  local branch_head="" branch_oid="" upstream=""
+  local xy="" ix="" wt=""
+  local line
+  while IFS= read -r line; do
+    case "$line" in
+      \#\ branch.head\ *)
+        branch_head="${line#\# branch.head }"
+        ;;
+      \#\ branch.oid\ *)
+        branch_oid="${line#\# branch.oid }"
+        ;;
+      \#\ branch.upstream\ *)
+        upstream="${line#\# branch.upstream }"
+        ;;
+      \#\ branch.ab\ *)
+        local ab a b
+        ab="${line#\# branch.ab }"
+        IFS=' ' read -r a b <<<"$ab"
+        a="${a#+}"
+        b="${b#-}"
+        apex_git_ahead="${a:-0}"
+        apex_git_behind="${b:-0}"
+        ;;
+      1\ *|2\ *)
+        xy="${line[3,4]}"
+        ix="${xy[1]}"
+        wt="${xy[2]}"
+        [[ "$ix" != "." ]] && apex_git_dirty_ix=1
+        [[ "$wt" != "." ]] && apex_git_dirty_wt=1
+        ;;
+      u\ *)
+        apex_git_conflict=1
+        apex_git_dirty_ix=1
+        apex_git_dirty_wt=1
+        ;;
+      \?\ *)
+        apex_git_untracked=1
+        ;;
+    esac
+  done <<<"$status_out"
+
+  if [[ -n "$branch_head" && "$branch_head" != "(detached)" && "$branch_head" != "HEAD" ]]; then
+    apex_git_branch="$branch_head"
+  elif [[ -n "$branch_oid" ]]; then
+    apex_git_branch="${branch_oid[1,7]}"
+  fi
+
+  if [[ -n "$apex_git_dir" ]]; then
+    [[ -d "$apex_git_dir/rebase-apply" || -d "$apex_git_dir/rebase-merge" ]] && apex_git_op="rebase"
+    [[ -f "$apex_git_dir/MERGE_HEAD" ]] && apex_git_op="merge"
+    [[ -f "$apex_git_dir/CHERRY_PICK_HEAD" ]] && apex_git_op="cherry-pick"
+    [[ -f "$apex_git_dir/BISECT_LOG" ]] && apex_git_op="bisect"
+
+    if [[ -f "$apex_git_dir/logs/refs/stash" ]]; then
+      local -a stash_lines
+      stash_lines=(${(f)"$(<"$apex_git_dir/logs/refs/stash")"})
+      apex_git_stash=$#stash_lines
+    elif [[ -f "$apex_git_dir/refs/stash" ]]; then
+      apex_git_stash=1
+    fi
+  fi
+
+  (( apex_git_conflict )) && apex_git_op="conflict"
+
+  if [[ -n "$upstream" && "$upstream" != "(gone)" ]]; then
+    if (( apex_git_dirty_wt == 0 && apex_git_dirty_ix == 0 && apex_git_untracked == 0 && apex_git_conflict == 0 && apex_git_stash == 0 )) \
+      && [[ -z "$apex_git_op" ]]; then
+      [[ "$apex_git_behind" == "0" && "$apex_git_ahead" == "0" ]] && apex_git_up_ok=1
+    fi
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 8) LEFT PROMPTLINE: IDENTITY + TERRITORY
+# -----------------------------------------------------------------------------
+apex_identity() {
+  local is_root=0 is_ssh=0 color label
+  (( EUID == 0 )) && is_root=1
+  [[ -n "$SSH_CONNECTION$SSH_TTY" ]] && is_ssh=1
+
+  if (( is_root )); then
+    color="${C[PURPLE]}"
+    if (( is_ssh )); then
+      label="${I[ROOT]} @%m"
+    else
+      label="${I[ROOT]} root"
+    fi
+  elif (( is_ssh )); then
+    color="${C[CYAN]}"
+    label="${I[SSH]} %n@%m"
+  else
+    return 0
+  fi
+
+  print -n "%F{${color}}${S[PL_L]}%f%K{${color}}%F{${C[VOID]}}%B ${label} %b%f%k%F{${color}}${S[PL_R]}%f "
+}
+
+apex_territory() {
+  print -n "%F{${C[RAZOR]}}${S[PL_L]}%f%K{${C[RAZOR]}}%F{${C[VOID]}}%B ${I[OS]}%b %F{${C[WHITE]}}%B%~%b %f%k%F{${C[RAZOR]}}${S[PL_R]}%f"
+}
+
+# -----------------------------------------------------------------------------
+# 9) RIGHT PROMPT (RPROMPT): INTEL + VCS + FRICTION
+# -----------------------------------------------------------------------------
+apex_intel_r() {
+  (( APEX[SHOW_INTEL] )) || return 0
+  if [[ -n "$apex_target_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_target_sig})%f"
+  elif [[ -n "$apex_mode_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_mode_sig})%f"
+  elif [[ -n "$apex_venv_name" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_venv_name})%f"
+  fi
+}
+
+apex_vcs_r() {
+  (( APEX[SHOW_VCS] )) || return 0
+  (( apex_in_git )) || return 0
+  local branch; branch="$(apex__escape_prompt "$apex_git_branch")"
+
+  if [[ -n "$apex_git_op" ]]; then
+    print -n "%F{${C[ALERT]}}${I[GIT]} ${branch} ${apex_git_op}%f"
+    return 0
+  fi
+
+  print -n "%F{${C[CYAN]}}${I[GIT]} ${branch}%f"
+
+  local mark=""
+  (( apex_git_dirty_ix )) && mark+="+"
+  (( apex_git_dirty_wt )) && mark+="!"
+  (( apex_git_untracked )) && mark+="?"
+  [[ -n "$mark" ]] && print -n "%F{${C[GOLD]}} ${mark}%f"
+
+  (( apex_git_stash > 0 )) && print -n "%F{${C[MUTED]}} s${apex_git_stash}%f"
+
+  (( apex_git_up_ok )) && print -n "%F{${C[OK]}} ✓%f"
+
+  if (( APEX[GIT_AHEAD_BEHIND] )); then
+    (( apex_git_ahead > 0 )) && print -n "%F{${C[MUTED]}} ⇡${apex_git_ahead}%f"
+    (( apex_git_behind > 0 )) && print -n "%F{${C[MUTED]}} ⇣${apex_git_behind}%f"
+  fi
+}
+
+apex_friction_r() {
+  if (( APEX[SHOW_RO] )); then
+    local ro=0
+    [[ ! -w . ]] && ro=1
+    if (( apex_in_git )) && [[ -n "$apex_git_root" && ! -w "$apex_git_root" ]]; then
+      ro=1
+    fi
+    if (( ro )); then
+      print -n "%F{${C[GOLD]}}${I[ROOT]} ro%f"
+      return 0
+    fi
+  fi
+
+  if (( APEX[SHOW_JOBS] )); then
+    local -a job_pids
+    job_pids=(${(f)"$(jobs -p 2>/dev/null)"})
+    local jc=$#job_pids
+    if (( jc > 0 )); then
+      print -n "%F{${C[MUTED]}}${I[JOBS]} ${jc}%f"
+      return 0
+    fi
+  fi
+}
+
+build_rprompt() {
+  local s out=""
+  local sep="%F{${C[MUTED]}} ${S[DOT]} %f"
+
+  s="$(apex_intel_r)";    [[ -n "$s" ]] && out+="$s"
+  s="$(apex_vcs_r)";      [[ -n "$s" ]] && out+="${out:+$sep}$s"
+  s="$(apex_friction_r)"; [[ -n "$s" ]] && out+="${out:+$sep}$s"
+
+  [[ -n "$out" ]] && out="%F{${C[MUTED]}}[%f${out}%F{${C[MUTED]}}]%f"
+  print -n "$out"
+}
+
+# -----------------------------------------------------------------------------
+# 10) RADAR (precmd)
+# -----------------------------------------------------------------------------
+apex_radar_aar() {
+  (( APEX[SHOW_AAR] )) || return 0
+
+  local ec=$1 cmd="$2" dur="$3"
+  local -i ms=${4:-0}
+
+  local show=0
+  (( ec != 0 )) && show=1
+  [[ -n "$dur" ]] && show=1
+  [[ "$cmd" =~ ${APEX[OPS_RE]} ]] && show=1
+  (( show )) || return 0
+
+  local short; short="$(apex__short_cmd "$cmd")"
+  short="$(apex__escape_prompt "$short")"
+
+  local dur_color="${C[MUTED]}"
+  (( ms >= ${APEX[SLOW_HARD_MS]} )) && dur_color="${C[GOLD]}"
+
+  local dur_chunk=""
+  if [[ -n "$dur" ]]; then
+    if (( ms >= ${APEX[SLOW_HARD_MS]} )); then
+      dur_chunk=" %F{${dur_color}}%B${dur}%b%f"
+    else
+      dur_chunk=" %F{${dur_color}}${dur}%f"
+    fi
+  fi
+
+  # Session commands: don't scream in red for “rc:1”
+  if [[ "$cmd" =~ ${APEX[SESSION_RE]} ]]; then
+    if (( ec == 0 )); then
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    else
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f %F{${C[MUTED]}}rc:${ec}%f${dur_chunk}"
+    fi
+    return 0
+  fi
+
+  if (( ec == 0 )); then
+    print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}✓%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    return 0
+  fi
+
+  # Signals: 128 + signal number
+  case $ec in
+    130) # SIGINT (Ctrl+C)
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[CYAN]}}^C%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    141) # SIGPIPE
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[MUTED]}}PIPE%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    143) # SIGTERM
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}TERM%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    *) 
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[ALERT]}}✘ ${ec}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+  esac
+}
+
+apex_radar_context_burst() {
+  (( APEX[SHOW_CONTEXT_BURST] )) || return 0
+
+  local proj_sig; proj_sig="$(apex__project_sig 2>/dev/null || print -r -- "")"
+
+  local emit=0
+  if (( apex_startup_done == 0 )); then
+    (( APEX[STARTUP_BURST] )) && emit=1
+  fi
+  (( apex_pwd_changed )) && emit=1
+  [[ "$apex_venv_name" != "$apex_prev_venv_name" ]] && emit=1
+  [[ "$apex_target_sig" != "$apex_prev_target_sig" ]] && emit=1
+  (( apex_in_git != apex_prev_in_git )) && emit=1
+  [[ "$apex_git_branch" != "$apex_prev_git_branch" ]] && emit=1
+  [[ "$apex_git_op" != "$apex_prev_git_op" ]] && emit=1
+  [[ "$proj_sig" != "$apex_prev_proj_sig" ]] && emit=1
+
+  (( emit )) || return 0
+
+  # If nothing to say, say nothing.
+  if [[ -z "$proj_sig" && -z "$apex_venv_name" && -z "$apex_target_sig" ]] && (( apex_in_git == 0 )); then
+    apex_pwd_changed=0
+    apex_startup_done=1
+    return 0
+  fi
+
+  local out="%F{${C[MUTED]}}${I[RADAR]}%f "
+
+  # Git first
+  if (( apex_in_git )); then
+    local branch; branch="$(apex__escape_prompt "$apex_git_branch")"
+    if [[ -n "$apex_git_op" ]]; then
+      out+="%F{${C[ALERT]}}${I[GIT]} ${branch} ${apex_git_op}%f"
+    else
+      out+="%F{${C[CYAN]}}${I[GIT]} ${branch}%f"
+    fi
+  fi
+
+  [[ -n "$proj_sig" ]]        && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[MUTED]}}${proj_sig}%f"
+  [[ -n "$apex_venv_name" ]]  && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_venv_name})%f"
+  [[ -n "$apex_target_sig" ]] && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_target_sig})%f"
+
+  print -P "$out"
+
+  apex_prev_venv_name="$apex_venv_name"
+  apex_prev_target_sig="$apex_target_sig"
+  apex_prev_in_git="$apex_in_git"
+  apex_prev_git_branch="$apex_git_branch"
+  apex_prev_git_op="$apex_git_op"
+  apex_prev_proj_sig="$proj_sig"
+
+  apex_pwd_changed=0
+  apex_startup_done=1
+}
+
+# -----------------------------------------------------------------------------
+# 11) HOOKS
+# -----------------------------------------------------------------------------
+apex_preexec_hook() {
+  apex_has_run_cmd=1
+  apex_cmd_start="$(apex__now_float)"
+  apex_last_cmd="$1"
+}
+
+apex_chpwd_hook() {
+  apex_pwd_changed=1
+}
+
+apex_precmd_hook() {
+  local ec=$?
+
+  apex_update_intel
+  apex_git_update
+
+  # Did a command actually run since the last prompt?
+  local ran=0
+  (( apex_has_run_cmd )) && ran=1
+
+  if (( ran )); then
+    local now; now="$(apex__now_float)"
+    local -i ms=0
+    local -F delta=0.0
+    if [[ -n "$now" ]]; then
+      delta=$(( now - apex_cmd_start ))
+      (( delta < 0 )) && delta=0
+      ms=$(( delta * 1000 ))
+    fi
+
+    # Show time if: slow OR ops OR failed.
+    local dur=""
+    if (( ms >= ${APEX[SLOW_SOFT_MS]} )) || [[ "$apex_last_cmd" =~ ${APEX[OPS_RE]} ]] || (( ec != 0 )); then
+      dur="$(printf "%.2fs" $(( ms / 1000.0 )))"
+    fi
+
+    apex_radar_aar $ec "$apex_last_cmd" "$dur" $ms
+
+    apex_has_run_cmd=0
+
+    # Spacer between AAR and context burst / prompt.
+    print -r -- ""
+  fi
+
+  apex_radar_context_burst
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec apex_preexec_hook
+add-zsh-hook precmd  apex_precmd_hook
+add-zsh-hook chpwd   apex_chpwd_hook
+
+# -----------------------------------------------------------------------------
+# 12) PROMPT BUILD
+# -----------------------------------------------------------------------------
+build_prompt() {
+  local ec=$?
+
+  # Line 1: identity + territory (left)
+  print -n "$(apex_identity)"
+  print -n "$(apex_territory)"
+  print -n $'
+'
+
+  # Line 2: trigger posture
+  if (( EUID == 0 )); then
+    print -n "%F{${C[PURPLE]}}❯%f "
+  elif (( ec != 0 )); then
+    print -n "%F{${C[ALERT]}}❯%f "
+  else
+    print -n "%F{${C[CYAN]}}❯%f "
+  fi
+}
+
+PROMPT='$(build_prompt)'
+RPROMPT='$(build_rprompt)'

dist/zsh/apex-neon.zsh-theme

@@ -0,0 +1,630 @@
+# Apex Neon — Predator Cockpit (Zsh) — v2
+# Two-bus design:
+#   [precmd radar]  -> after-action + context bursts (event-driven)
+#   [promptline]    -> LEFT: identity + territory
+#                      RIGHT: intel + vcs + friction (stable)
+
+setopt prompt_subst
+setopt no_beep
+
+zmodload zsh/datetime 2>/dev/null
+
+# -----------------------------------------------------------------------------
+# 1) PALETTE (Apex Neon DNA)
+# -----------------------------------------------------------------------------
+typeset -gA C
+C[VOID]="#070709"
+C[WHITE]="#e6e8ec"
+C[MUTED]="#8b909c"
+C[RAZOR]="#d68fff"
+C[CYAN]="#00eaff"
+C[GOLD]="#ffb700"
+C[OK]="#00ff99"
+C[PURPLE]="#9d00ff"
+C[ALERT]="#ff0044"
+
+# -----------------------------------------------------------------------------
+# 1b) PLUGIN COLORS
+# -----------------------------------------------------------------------------
+# zsh-autosuggestions: ghost text from history (subtle, intentionally dim)
+ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=#8b909c"
+
+# zsh-history-substring-search
+HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_FOUND="fg=#00eaff,bold"
+HISTORY_SUBSTRING_SEARCH_HIGHLIGHT_NOT_FOUND="fg=#ff0044,bold"
+
+# -----------------------------------------------------------------------------
+# 2) ICONS / GLYPHS (Nerd Font optional)
+# -----------------------------------------------------------------------------
+typeset -gA I
+I[OS]=""
+I[SSH]=""
+I[ROOT]=""
+I[GIT]=""
+I[JOBS]=""
+I[RADAR]="⌁"
+I[RET]="↩"
+
+typeset -gA S
+S[PL_L]=""
+S[PL_R]=""
+S[DOT]="·"
+
+# -----------------------------------------------------------------------------
+# 3) CONFIG
+# -----------------------------------------------------------------------------
+typeset -gA APEX
+APEX[SLOW_SOFT_MS]=750
+APEX[SLOW_HARD_MS]=2000
+
+APEX[STARTUP_BURST]=1
+APEX[SHOW_AAR]=1
+APEX[SHOW_CONTEXT_BURST]=1
+APEX[SHOW_VCS]=1
+APEX[SHOW_INTEL]=1
+APEX[SHOW_JOBS]=1
+APEX[SHOW_RO]=1
+APEX[GIT_AHEAD_BEHIND]=1
+
+# Ops commands (also match wrappers like sudo/doas/command)
+APEX[OPS_RE]='^((sudo|doas|command)[[:space:]]+)*((pacman|yay|paru|apt|dnf|brew|systemctl|docker|kubectl|helm|git))([[:space:]]|$)'
+
+# Session-ish commands (spawn a subshell; exit codes are often “not a failure”)
+APEX[SESSION_RE]='^((sudo|doas|command)[[:space:]]+)*chezmoi[[:space:]]+cd([[:space:]]|$)'
+
+# -----------------------------------------------------------------------------
+# 4) STATE
+# -----------------------------------------------------------------------------
+typeset -gF apex_cmd_start=0.0
+typeset -g  apex_last_cmd=""
+typeset -g  apex_has_run_cmd=0
+
+typeset -g  apex_startup_done=0
+typeset -g  apex_pwd_changed=1
+
+# Sticky intel
+typeset -g  apex_venv_name=""
+typeset -g  apex_target_sig=""
+typeset -g  apex_mode_sig=""
+
+# Git state
+typeset -g  apex_in_git=0
+typeset -g  apex_git_branch=""
+typeset -g  apex_git_dirty_wt=0
+typeset -g  apex_git_dirty_ix=0
+typeset -g  apex_git_untracked=0
+typeset -g  apex_git_conflict=0
+typeset -g  apex_git_op=""
+typeset -g  apex_git_up_ok=0
+typeset -g  apex_git_ahead=0
+typeset -g  apex_git_behind=0
+typeset -g  apex_git_stash=0
+typeset -g  apex_git_root=""
+typeset -g  apex_git_dir=""
+
+# Radar previous snapshots (transition detection)
+typeset -g  apex_prev_in_git=-1
+typeset -g  apex_prev_git_branch=""
+typeset -g  apex_prev_git_op=""
+typeset -g  apex_prev_venv_name=""
+typeset -g  apex_prev_target_sig=""
+typeset -g  apex_prev_proj_sig=""
+
+# -----------------------------------------------------------------------------
+# 5) UTILITIES
+# -----------------------------------------------------------------------------
+apex__short_cmd() {
+  local s="$1"
+  s="${s//$'
+'/ }"
+  s="${s#"${s%%[![:space:]]*}"}"   # ltrim
+  s="${s%"${s##*[![:space:]]}"}"   # rtrim
+  print -r -- "${s[1,90]}"
+}
+
+apex__project_sig() {
+  local s=""
+  [[ -f package.json ]] && s+="node"
+  [[ -f pnpm-lock.yaml ]] && s+="+pnpm"
+  [[ -f bun.lockb ]] && s+="+bun"
+  [[ -f yarn.lock ]] && s+="+yarn"
+
+  [[ -f pyproject.toml || -f requirements.txt ]] && s+="${s:+ }py"
+  [[ -f uv.lock ]] && s+="+uv"
+
+  [[ -f Cargo.toml ]] && s+="${s:+ }rust"
+  [[ -f go.mod ]] && s+="${s:+ }go"
+
+  [[ -n "$s" ]] && print -r -- "$s"
+}
+
+apex__escape_prompt() {
+  local s="$1"
+  s="${s//\\%/%%}"
+  print -r -- "$s"
+}
+
+apex__now_float() {
+  if [[ -n "${EPOCHREALTIME:-}" ]]; then
+    print -r -- "$EPOCHREALTIME"
+  elif [[ -n "${EPOCHSECONDS:-}" ]]; then
+    print -r -- "${EPOCHSECONDS}.0"
+  else
+    print -r -- "0.0"
+  fi
+}
+
+apex__find_git_root() {
+  local dir="$PWD"
+  local git_root=""
+  local git_dir=""
+
+  while [[ -n "$dir" ]]; do
+    if [[ -d "$dir/.git" ]]; then
+      git_root="$dir"
+      git_dir="$dir/.git"
+      break
+    elif [[ -f "$dir/.git" ]]; then
+      local line
+      line="$(<"$dir/.git")"
+      if [[ "$line" == gitdir:* ]]; then
+        git_root="$dir"
+        git_dir="${line#gitdir: }"
+        [[ "$git_dir" != /* ]] && git_dir="$dir/$git_dir"
+        break
+      fi
+    fi
+
+    [[ "$dir" == "/" ]] && break
+    dir="${dir:h}"
+  done
+
+  [[ -n "$git_root" ]] && print -r -- "${git_root}|${git_dir}"
+}
+
+# -----------------------------------------------------------------------------
+# 6) INTEL (sticky; updated each prompt)
+# -----------------------------------------------------------------------------
+apex_update_intel() {
+  # Target (cheap env-based; no kubectl calls)
+  if [[ -n "$AWS_PROFILE" ]]; then
+    apex_target_sig="aws:${AWS_PROFILE}"
+  elif [[ -n "$GOOGLE_CLOUD_PROJECT" ]]; then
+    apex_target_sig="gcp:${GOOGLE_CLOUD_PROJECT}"
+  elif [[ -n "$KUBE_CONTEXT" ]]; then
+    apex_target_sig="kube:${KUBE_CONTEXT}"
+  else
+    apex_target_sig=""
+  fi
+
+  # Mode
+  if [[ -n "$IN_NIX_SHELL" ]]; then
+    apex_mode_sig="nix"
+  elif [[ -n "$DIRENV_DIR" ]]; then
+    apex_mode_sig="direnv"
+  elif [[ -f /run/.containerenv || -f /.dockerenv ]]; then
+    apex_mode_sig="ctr"
+  else
+    apex_mode_sig=""
+  fi
+
+  # Venv
+  apex_venv_name=""
+  if [[ -n "$VIRTUAL_ENV" ]]; then
+    apex_venv_name="$(basename "$VIRTUAL_ENV")"
+  elif [[ -n "$CONDA_DEFAULT_ENV" ]]; then
+    apex_venv_name="$CONDA_DEFAULT_ENV"
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 7) GIT
+# -----------------------------------------------------------------------------
+apex_git_update() {
+  apex_in_git=0
+  apex_git_branch=""
+  apex_git_dirty_wt=0
+  apex_git_dirty_ix=0
+  apex_git_untracked=0
+  apex_git_conflict=0
+  apex_git_op=""
+  apex_git_up_ok=0
+  apex_git_ahead=0
+  apex_git_behind=0
+  apex_git_stash=0
+
+  local status_out
+  status_out="$(command git status --porcelain=2 --branch 2>/dev/null)" || {
+    apex_git_root=""
+    apex_git_dir=""
+    return
+  }
+  apex_in_git=1
+
+  if (( apex_pwd_changed )) || [[ -z "$apex_git_root" ]]; then
+    local root_info
+    root_info="$(apex__find_git_root)"
+    if [[ -n "$root_info" ]]; then
+      apex_git_root="${root_info%%|*}"
+      apex_git_dir="${root_info#*|}"
+    else
+      apex_git_root=""
+      apex_git_dir=""
+    fi
+  fi
+
+  local branch_head="" branch_oid="" upstream=""
+  local xy="" ix="" wt=""
+  local line
+  while IFS= read -r line; do
+    case "$line" in
+      \#\ branch.head\ *)
+        branch_head="${line#\# branch.head }"
+        ;;
+      \#\ branch.oid\ *)
+        branch_oid="${line#\# branch.oid }"
+        ;;
+      \#\ branch.upstream\ *)
+        upstream="${line#\# branch.upstream }"
+        ;;
+      \#\ branch.ab\ *)
+        local ab a b
+        ab="${line#\# branch.ab }"
+        IFS=' ' read -r a b <<<"$ab"
+        a="${a#+}"
+        b="${b#-}"
+        apex_git_ahead="${a:-0}"
+        apex_git_behind="${b:-0}"
+        ;;
+      1\ *|2\ *)
+        xy="${line[3,4]}"
+        ix="${xy[1]}"
+        wt="${xy[2]}"
+        [[ "$ix" != "." ]] && apex_git_dirty_ix=1
+        [[ "$wt" != "." ]] && apex_git_dirty_wt=1
+        ;;
+      u\ *)
+        apex_git_conflict=1
+        apex_git_dirty_ix=1
+        apex_git_dirty_wt=1
+        ;;
+      \?\ *)
+        apex_git_untracked=1
+        ;;
+    esac
+  done <<<"$status_out"
+
+  if [[ -n "$branch_head" && "$branch_head" != "(detached)" && "$branch_head" != "HEAD" ]]; then
+    apex_git_branch="$branch_head"
+  elif [[ -n "$branch_oid" ]]; then
+    apex_git_branch="${branch_oid[1,7]}"
+  fi
+
+  if [[ -n "$apex_git_dir" ]]; then
+    [[ -d "$apex_git_dir/rebase-apply" || -d "$apex_git_dir/rebase-merge" ]] && apex_git_op="rebase"
+    [[ -f "$apex_git_dir/MERGE_HEAD" ]] && apex_git_op="merge"
+    [[ -f "$apex_git_dir/CHERRY_PICK_HEAD" ]] && apex_git_op="cherry-pick"
+    [[ -f "$apex_git_dir/BISECT_LOG" ]] && apex_git_op="bisect"
+
+    if [[ -f "$apex_git_dir/logs/refs/stash" ]]; then
+      local -a stash_lines
+      stash_lines=(${(f)"$(<"$apex_git_dir/logs/refs/stash")"})
+      apex_git_stash=$#stash_lines
+    elif [[ -f "$apex_git_dir/refs/stash" ]]; then
+      apex_git_stash=1
+    fi
+  fi
+
+  (( apex_git_conflict )) && apex_git_op="conflict"
+
+  if [[ -n "$upstream" && "$upstream" != "(gone)" ]]; then
+    if (( apex_git_dirty_wt == 0 && apex_git_dirty_ix == 0 && apex_git_untracked == 0 && apex_git_conflict == 0 && apex_git_stash == 0 )) \
+      && [[ -z "$apex_git_op" ]]; then
+      [[ "$apex_git_behind" == "0" && "$apex_git_ahead" == "0" ]] && apex_git_up_ok=1
+    fi
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# 8) LEFT PROMPTLINE: IDENTITY + TERRITORY
+# -----------------------------------------------------------------------------
+apex_identity() {
+  local is_root=0 is_ssh=0 color label
+  (( EUID == 0 )) && is_root=1
+  [[ -n "$SSH_CONNECTION$SSH_TTY" ]] && is_ssh=1
+
+  if (( is_root )); then
+    color="${C[PURPLE]}"
+    if (( is_ssh )); then
+      label="${I[ROOT]} @%m"
+    else
+      label="${I[ROOT]} root"
+    fi
+  elif (( is_ssh )); then
+    color="${C[CYAN]}"
+    label="${I[SSH]} %n@%m"
+  else
+    return 0
+  fi
+
+  print -n "%F{${color}}${S[PL_L]}%f%K{${color}}%F{${C[VOID]}}%B ${label} %b%f%k%F{${color}}${S[PL_R]}%f "
+}
+
+apex_territory() {
+  print -n "%F{${C[RAZOR]}}${S[PL_L]}%f%K{${C[RAZOR]}}%F{${C[VOID]}}%B ${I[OS]}%b %F{${C[WHITE]}}%B%~%b %f%k%F{${C[RAZOR]}}${S[PL_R]}%f"
+}
+
+# -----------------------------------------------------------------------------
+# 9) RIGHT PROMPT (RPROMPT): INTEL + VCS + FRICTION
+# -----------------------------------------------------------------------------
+apex_intel_r() {
+  (( APEX[SHOW_INTEL] )) || return 0
+  if [[ -n "$apex_target_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_target_sig})%f"
+  elif [[ -n "$apex_mode_sig" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_mode_sig})%f"
+  elif [[ -n "$apex_venv_name" ]]; then
+    print -n "%F{${C[CYAN]}}(${apex_venv_name})%f"
+  fi
+}
+
+apex_vcs_r() {
+  (( APEX[SHOW_VCS] )) || return 0
+  (( apex_in_git )) || return 0
+  local branch; branch="$(apex__escape_prompt "$apex_git_branch")"
+
+  if [[ -n "$apex_git_op" ]]; then
+    print -n "%F{${C[ALERT]}}${I[GIT]} ${branch} ${apex_git_op}%f"
+    return 0
+  fi
+
+  print -n "%F{${C[CYAN]}}${I[GIT]} ${branch}%f"
+
+  local mark=""
+  (( apex_git_dirty_ix )) && mark+="+"
+  (( apex_git_dirty_wt )) && mark+="!"
+  (( apex_git_untracked )) && mark+="?"
+  [[ -n "$mark" ]] && print -n "%F{${C[GOLD]}} ${mark}%f"
+
+  (( apex_git_stash > 0 )) && print -n "%F{${C[MUTED]}} s${apex_git_stash}%f"
+
+  (( apex_git_up_ok )) && print -n "%F{${C[OK]}} ✓%f"
+
+  if (( APEX[GIT_AHEAD_BEHIND] )); then
+    (( apex_git_ahead > 0 )) && print -n "%F{${C[MUTED]}} ⇡${apex_git_ahead}%f"
+    (( apex_git_behind > 0 )) && print -n "%F{${C[MUTED]}} ⇣${apex_git_behind}%f"
+  fi
+}
+
+apex_friction_r() {
+  if (( APEX[SHOW_RO] )); then
+    local ro=0
+    [[ ! -w . ]] && ro=1
+    if (( apex_in_git )) && [[ -n "$apex_git_root" && ! -w "$apex_git_root" ]]; then
+      ro=1
+    fi
+    if (( ro )); then
+      print -n "%F{${C[GOLD]}}${I[ROOT]} ro%f"
+      return 0
+    fi
+  fi
+
+  if (( APEX[SHOW_JOBS] )); then
+    local -a job_pids
+    job_pids=(${(f)"$(jobs -p 2>/dev/null)"})
+    local jc=$#job_pids
+    if (( jc > 0 )); then
+      print -n "%F{${C[MUTED]}}${I[JOBS]} ${jc}%f"
+      return 0
+    fi
+  fi
+}
+
+build_rprompt() {
+  local s out=""
+  local sep="%F{${C[MUTED]}} ${S[DOT]} %f"
+
+  s="$(apex_intel_r)";    [[ -n "$s" ]] && out+="$s"
+  s="$(apex_vcs_r)";      [[ -n "$s" ]] && out+="${out:+$sep}$s"
+  s="$(apex_friction_r)"; [[ -n "$s" ]] && out+="${out:+$sep}$s"
+
+  [[ -n "$out" ]] && out="%F{${C[MUTED]}}[%f${out}%F{${C[MUTED]}}]%f"
+  print -n "$out"
+}
+
+# -----------------------------------------------------------------------------
+# 10) RADAR (precmd)
+# -----------------------------------------------------------------------------
+apex_radar_aar() {
+  (( APEX[SHOW_AAR] )) || return 0
+
+  local ec=$1 cmd="$2" dur="$3"
+  local -i ms=${4:-0}
+
+  local show=0
+  (( ec != 0 )) && show=1
+  [[ -n "$dur" ]] && show=1
+  [[ "$cmd" =~ ${APEX[OPS_RE]} ]] && show=1
+  (( show )) || return 0
+
+  local short; short="$(apex__short_cmd "$cmd")"
+  short="$(apex__escape_prompt "$short")"
+
+  local dur_color="${C[MUTED]}"
+  (( ms >= ${APEX[SLOW_HARD_MS]} )) && dur_color="${C[GOLD]}"
+
+  local dur_chunk=""
+  if [[ -n "$dur" ]]; then
+    if (( ms >= ${APEX[SLOW_HARD_MS]} )); then
+      dur_chunk=" %F{${dur_color}}%B${dur}%b%f"
+    else
+      dur_chunk=" %F{${dur_color}}${dur}%f"
+    fi
+  fi
+
+  # Session commands: don't scream in red for “rc:1”
+  if [[ "$cmd" =~ ${APEX[SESSION_RE]} ]]; then
+    if (( ec == 0 )); then
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    else
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}${I[RET]}%f %F{${C[WHITE]}}${short}%f %F{${C[MUTED]}}rc:${ec}%f${dur_chunk}"
+    fi
+    return 0
+  fi
+
+  if (( ec == 0 )); then
+    print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[OK]}}✓%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+    return 0
+  fi
+
+  # Signals: 128 + signal number
+  case $ec in
+    130) # SIGINT (Ctrl+C)
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[CYAN]}}^C%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    141) # SIGPIPE
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[MUTED]}}PIPE%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    143) # SIGTERM
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[GOLD]}}TERM%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+    *) 
+      print -P "%F{${C[MUTED]}}${I[RADAR]}%f %F{${C[ALERT]}}✘ ${ec}%f %F{${C[WHITE]}}${short}%f${dur_chunk}"
+      ;;
+  esac
+}
+
+apex_radar_context_burst() {
+  (( APEX[SHOW_CONTEXT_BURST] )) || return 0
+
+  local proj_sig; proj_sig="$(apex__project_sig 2>/dev/null || print -r -- "")"
+
+  local emit=0
+  if (( apex_startup_done == 0 )); then
+    (( APEX[STARTUP_BURST] )) && emit=1
+  fi
+  (( apex_pwd_changed )) && emit=1
+  [[ "$apex_venv_name" != "$apex_prev_venv_name" ]] && emit=1
+  [[ "$apex_target_sig" != "$apex_prev_target_sig" ]] && emit=1
+  (( apex_in_git != apex_prev_in_git )) && emit=1
+  [[ "$apex_git_branch" != "$apex_prev_git_branch" ]] && emit=1
+  [[ "$apex_git_op" != "$apex_prev_git_op" ]] && emit=1
+  [[ "$proj_sig" != "$apex_prev_proj_sig" ]] && emit=1
+
+  (( emit )) || return 0
+
+  # If nothing to say, say nothing.
+  if [[ -z "$proj_sig" && -z "$apex_venv_name" && -z "$apex_target_sig" ]] && (( apex_in_git == 0 )); then
+    apex_pwd_changed=0
+    apex_startup_done=1
+    return 0
+  fi
+
+  local out="%F{${C[MUTED]}}${I[RADAR]}%f "
+
+  # Git first
+  if (( apex_in_git )); then
+    local branch; branch="$(apex__escape_prompt "$apex_git_branch")"
+    if [[ -n "$apex_git_op" ]]; then
+      out+="%F{${C[ALERT]}}${I[GIT]} ${branch} ${apex_git_op}%f"
+    else
+      out+="%F{${C[CYAN]}}${I[GIT]} ${branch}%f"
+    fi
+  fi
+
+  [[ -n "$proj_sig" ]]        && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[MUTED]}}${proj_sig}%f"
+  [[ -n "$apex_venv_name" ]]  && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_venv_name})%f"
+  [[ -n "$apex_target_sig" ]] && out+="${out:+ %F{${C[MUTED]}}·%f }%F{${C[CYAN]}}(${apex_target_sig})%f"
+
+  print -P "$out"
+
+  apex_prev_venv_name="$apex_venv_name"
+  apex_prev_target_sig="$apex_target_sig"
+  apex_prev_in_git="$apex_in_git"
+  apex_prev_git_branch="$apex_git_branch"
+  apex_prev_git_op="$apex_git_op"
+  apex_prev_proj_sig="$proj_sig"
+
+  apex_pwd_changed=0
+  apex_startup_done=1
+}
+
+# -----------------------------------------------------------------------------
+# 11) HOOKS
+# -----------------------------------------------------------------------------
+apex_preexec_hook() {
+  apex_has_run_cmd=1
+  apex_cmd_start="$(apex__now_float)"
+  apex_last_cmd="$1"
+}
+
+apex_chpwd_hook() {
+  apex_pwd_changed=1
+}
+
+apex_precmd_hook() {
+  local ec=$?
+
+  apex_update_intel
+  apex_git_update
+
+  # Did a command actually run since the last prompt?
+  local ran=0
+  (( apex_has_run_cmd )) && ran=1
+
+  if (( ran )); then
+    local now; now="$(apex__now_float)"
+    local -i ms=0
+    local -F delta=0.0
+    if [[ -n "$now" ]]; then
+      delta=$(( now - apex_cmd_start ))
+      (( delta < 0 )) && delta=0
+      ms=$(( delta * 1000 ))
+    fi
+
+    # Show time if: slow OR ops OR failed.
+    local dur=""
+    if (( ms >= ${APEX[SLOW_SOFT_MS]} )) || [[ "$apex_last_cmd" =~ ${APEX[OPS_RE]} ]] || (( ec != 0 )); then
+      dur="$(printf "%.2fs" $(( ms / 1000.0 )))"
+    fi
+
+    apex_radar_aar $ec "$apex_last_cmd" "$dur" $ms
+
+    apex_has_run_cmd=0
+
+    # Spacer between AAR and context burst / prompt.
+    print -r -- ""
+  fi
+
+  apex_radar_context_burst
+}
+
+autoload -Uz add-zsh-hook
+add-zsh-hook preexec apex_preexec_hook
+add-zsh-hook precmd  apex_precmd_hook
+add-zsh-hook chpwd   apex_chpwd_hook
+
+# -----------------------------------------------------------------------------
+# 12) PROMPT BUILD
+# -----------------------------------------------------------------------------
+build_prompt() {
+  local ec=$?
+
+  # Line 1: identity + territory (left)
+  print -n "$(apex_identity)"
+  print -n "$(apex_territory)"
+  print -n $'
+'
+
+  # Line 2: trigger posture
+  if (( EUID == 0 )); then
+    print -n "%F{${C[PURPLE]}}❯%f "
+  elif (( ec != 0 )); then
+    print -n "%F{${C[ALERT]}}❯%f "
+  else
+    print -n "%F{${C[CYAN]}}❯%f "
+  fi
+}
+
+PROMPT='$(build_prompt)'
+RPROMPT='$(build_rprompt)'

scripts/nvim-audit.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+
+root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+if ! command -v nvim >/dev/null 2>&1; then
+  echo "error: nvim not found on PATH" >&2
+  exit 1
+fi
+
+if [[ ! -f "${root}/dist/nvim/colors/apex-neon.lua" ]]; then
+  echo "error: missing dist/nvim/colors/apex-neon.lua; run 'uv run build.py'" >&2
+  exit 1
+fi
+
+cd "$root"
+nvim --headless -u NONE -U NONE -c "lua dofile('${root}/scripts/nvim_audit.lua')"

scripts/nvim_audit.lua

@@ -0,0 +1,181 @@
+local function out(msg)
+  vim.api.nvim_out_write(msg .. "\n")
+end
+
+local function err(msg)
+  vim.api.nvim_err_write(msg .. "\n")
+end
+
+if not vim.api.nvim_get_hl then
+  err("error: nvim_get_hl unavailable; require Neovim 0.9+")
+  vim.cmd("cquit")
+end
+
+local function load_theme()
+  local theme_path = vim.fn.getcwd() .. "/dist/nvim/colors/apex-neon.lua"
+  local ok, load_err = pcall(dofile, theme_path)
+  if not ok then
+    err("error: failed to load theme: " .. tostring(load_err))
+    err("hint: run 'uv run build.py' to regenerate dist/")
+    vim.cmd("cquit")
+  end
+end
+
+local function has_style(hl)
+  for key, value in pairs(hl) do
+    if key ~= "link" and key ~= "default" then
+      if type(value) ~= "boolean" or value then
+        return true
+      end
+    end
+  end
+  return false
+end
+
+local function get_hl(name)
+  local ok, hl = pcall(vim.api.nvim_get_hl, 0, { name = name, link = false })
+  if not ok then
+    return nil, "error"
+  end
+  return hl, nil
+end
+
+local function audit(groups)
+  local issues = {}
+  local default_links = {
+    Normal = true,
+    NONE = true,
+  }
+
+  for _, group in ipairs(groups) do
+    local hl, api_err = get_hl(group)
+    if api_err or not hl or next(hl) == nil then
+      table.insert(issues, "missing: " .. group)
+    elseif hl.link and default_links[hl.link] then
+      table.insert(issues, "default-link: " .. group .. " -> " .. hl.link)
+    elseif not hl.link and not has_style(hl) then
+      table.insert(issues, "empty: " .. group)
+    end
+  end
+
+  return issues
+end
+
+local groups = {
+  -- Pmenu
+  "Pmenu",
+  "PmenuSel",
+  "PmenuSbar",
+  "PmenuThumb",
+  "WildMenu",
+
+  -- LSP UI
+  "LspReferenceText",
+  "LspReferenceRead",
+  "LspReferenceWrite",
+  "LspSignatureActiveParameter",
+  "LspInlayHint",
+
+  -- Diagnostics (core + variants)
+  "DiagnosticError",
+  "DiagnosticWarn",
+  "DiagnosticInfo",
+  "DiagnosticHint",
+  "DiagnosticOk",
+  "DiagnosticDeprecated",
+  "DiagnosticUnnecessary",
+  "DiagnosticUnderlineError",
+  "DiagnosticUnderlineWarn",
+  "DiagnosticUnderlineInfo",
+  "DiagnosticUnderlineHint",
+  "DiagnosticUnderlineOk",
+  "DiagnosticVirtualTextError",
+  "DiagnosticVirtualTextWarn",
+  "DiagnosticVirtualTextInfo",
+  "DiagnosticVirtualTextHint",
+  "DiagnosticVirtualTextOk",
+  "DiagnosticVirtualLinesError",
+  "DiagnosticVirtualLinesWarn",
+  "DiagnosticVirtualLinesInfo",
+  "DiagnosticVirtualLinesHint",
+  "DiagnosticVirtualLinesOk",
+  "DiagnosticSignError",
+  "DiagnosticSignWarn",
+  "DiagnosticSignInfo",
+  "DiagnosticSignHint",
+  "DiagnosticSignOk",
+  "DiagnosticFloatingError",
+  "DiagnosticFloatingWarn",
+  "DiagnosticFloatingInfo",
+  "DiagnosticFloatingHint",
+  "DiagnosticFloatingOk",
+
+  -- Markup (Tree-sitter)
+  "@markup.heading",
+  "@markup.link",
+  "@markup.link.url",
+  "@markup.strong",
+  "@markup.italic",
+  "ApexMarkupStrong",
+  "ApexMarkupItalic",
+  "ApexMarkupLink",
+
+  -- LSP semantic tokens (types)
+  "@lsp.type.boolean",
+  "@lsp.type.builtinType",
+  "@lsp.type.class",
+  "@lsp.type.comment",
+  "@lsp.type.decorator",
+  "@lsp.type.enum",
+  "@lsp.type.enumMember",
+  "@lsp.type.event",
+  "@lsp.type.function",
+  "@lsp.type.interface",
+  "@lsp.type.keyword",
+  "@lsp.type.macro",
+  "@lsp.type.method",
+  "@lsp.type.modifier",
+  "@lsp.type.namespace",
+  "@lsp.type.number",
+  "@lsp.type.operator",
+  "@lsp.type.parameter",
+  "@lsp.type.property",
+  "@lsp.type.regexp",
+  "@lsp.type.string",
+  "@lsp.type.struct",
+  "@lsp.type.type",
+  "@lsp.type.typeParameter",
+  "@lsp.type.variable",
+
+  -- LSP semantic tokens (modifiers)
+  "@lsp.mod.deprecated",
+  "@lsp.mod.readonly",
+  "@lsp.mod.static",
+  "@lsp.mod.async",
+
+  -- LSP semantic tokens (typemods)
+  "@lsp.typemod.function.async",
+  "@lsp.typemod.method.async",
+  "@lsp.typemod.function.deprecated",
+  "@lsp.typemod.method.deprecated",
+  "@lsp.typemod.variable.deprecated",
+  "@lsp.typemod.variable.readonly",
+  "@lsp.typemod.parameter.readonly",
+  "@lsp.typemod.property.readonly",
+  "@lsp.typemod.variable.static",
+  "@lsp.typemod.property.static",
+}
+
+load_theme()
+
+local issues = audit(groups)
+if #issues == 0 then
+  out("nvim audit: ok (" .. tostring(#groups) .. " groups)")
+  vim.cmd("qa")
+end
+
+err("nvim audit: " .. tostring(#issues) .. " issue(s)")
+for _, issue in ipairs(issues) do
+  err(issue)
+end
+vim.cmd("cquit")

src/aeon.yaml

@@ -2,48 +2,95 @@ scheme: "Apex Aeon"
 author: "S0wlz (Owlibou)"
 type: "light"
 
-# Core Semantics (The DNA)
-palette:
-  background: "#f5f5f5" # Void White
-  foreground: "#0a0a0a" # Near Black
-  cursor:     "#ff0044" # Razor Red (Still the aggressor)
-  selection:  "#ff0044"
-  selection_fg: "#0a0a0a" # HARD RULE: Near Black on Red
-  
-  # Functional Roles
-  error:   "#ff0044"
-  success: "#00b377" # Darker for contrast on light bg
-  warning: "#d18f00" # Darker for contrast
-  info:    "#007a88" # Deep Cyan (Readable against white)
-  special: "#7a3cff"
-  azure:   "#005577"
+# ============================================================================
+# Apex Aeon v2 — the daylight hunt. Tracks in snow: the field is bright, the
+# signal is ink, not glow. Figure goes dark because the ground went light.
+# Same rule system as Neon, recomputed values. Canonical spec: apex-aeon.md
+# Red = danger. Violet = attention. Neither ever enters a code buffer.
+#
+# Key names are symmetric with neon.yaml so shared/aggregated templates work.
+# ============================================================================
 
-# UI Surfaces (Depth)
-ui:
-  panel:   "#e8e8e8" # Soft Surface
-  border:  "#737373" # Muted/Borders
-  high:    "#ffffff" # High Surface (Cards)
-  dim:     "#737373"
-  stealth: "#a0a0a0"
+# Neutrals — the readable 80% (spec §4). Off-white Paper, faint cool tint.
+neutral:
+  bg:      "#f1f3f7" # Main background, terminal background
+  surface: "#e7eaf0" # Inputs, inactive tabs, widgets, statuslines
+  panel:   "#dce0e8" # Panels, separators, scroll track
+  border:  "#c2c8d4" # Visible borders, line-highlight background
+  subtle:  "#c8cdd8" # Ignored / suppressed text (sub-threshold by design)
+  muted:   "#5c6270" # Comments, subtitles, muted labels
+  text:    "#16181d" # Default body text (cool near-black, not pure black)
+  bright:  "#000000" # Extreme emphasis only
 
-# ANSI Table (Terminal)
+# Attention — violet figure/ground (spec §5). Never inside a code buffer.
+focus:
+  max:    "#7c2fd6" # Cursor — the crosshair
+  active: "#8c3dd0" # Current search match, matched bracket / pair
+  field:  "#efe2fb" # Other search matches, selection background
+
+# Danger — red figure/ground (spec §5,6). Escalation goes DARKER on light.
+danger:
+  base:   "#c8003a" # Error figure, destructive action, active window border
+  field:  "#fbe4e9" # Error region bg (Ember Field, + diff-delete bg)
+  bright: "#9e0030" # Escalation (ANSI color9) — darker = hotter on light
+
+# Signal hues — information, state, structure.
+signal:
+  info:        "#0080a6" # Cyan (deep) — information / links
+  success:     "#00875a" # Green — success / OK
+  warning:     "#a86b00" # Amber — warning (UI only, never in buffer)
+  special:     "#6a1fb8" # Violet (deep) — reserved special / root
+  blue:        "#2148c0" # Blue — kinds / structural accent
+  blue_bright: "#1633a0" # Deep-blue — active flow / focus highlight
+
+# Syntax — typed by grammatical role (spec §7). Ink, not glow.
+# blue = kinds · cyan = actions · green = values · neutral = connective tissue
+syntax:
+  comment:     "#5c6270" # muted, italic
+  punctuation: "#7d8390" # neutral, lifted
+  operator:    "#5c6270" # neutral
+  variable:    "#16181d" # body text
+  property:    "#2e333d" # dim body — fields / properties
+  # kinds — blue
+  type:        "#2148c0" # blue — types / struct / enum / trait
+  storage:     "#1633a0" # blue, heavier — storage / modifier (pub mut async)
+  attribute:   "#2148c0" # blue, declarative — #[derive]
+  # actions — cyan
+  function:    "#0e6e92" # cyan — function def / call
+  macro:       "#0e6e92" # cyan — bang-macro (action + ceremony)
+  builtin:     "#3a7d9c" # cyan, dim — self / builtin
+  # values — green
+  string:      "#00734d" # green — values
+  escape:      "#2b8f63" # green, brighter — char / escape
+  constant:    "#00875a" # green, cooler — number / bool / const
+  # navigation
+  keyword:     "#1633a0" # deep-blue, bold — static control flow
+
+# Diff / Git — pale grounds, ink figures (spec §8)
+diff:
+  add:    { fg: "#00734d", bg: "#e2f3ea" }
+  change: { fg: "#a86b00", bg: "#f5ecda" }
+  delete: { fg: "#c8003a", bg: "#fbe4e9" } # reuses danger.field (Ember Field)
+
+# ANSI Table — 16-color fallback bank (spec §9).
+# Bright bank is DEEPER, not lighter (a lighter variant loses contrast on Paper).
 ansi:
   normal:
-    black:   "#0a0a0a"
-    red:     "#ff0044"
-    green:   "#00b377"
-    yellow:  "#d18f00"
-    blue:    "#007a88"
-    magenta: "#7a3cff"
-    cyan:    "#007a88"
-    white:   "#f5f5f5"
-  
-  bright: # Escalation only
-    black:   "#737373"
-    red:     "#ff4d6d"
-    green:   "#33d6a6"
-    yellow:  "#ffbf40"
-    blue:    "#33bccc"
-    magenta: "#a680ff"
-    cyan:    "#33bccc"
-    white:   "#ffffff"
+    black:   "#16181d" # Text / ink
+    red:     "#c8003a" # Danger / error
+    green:   "#00875a" # Success
+    yellow:  "#a86b00" # Warning
+    blue:    "#2148c0" # Kinds / structural
+    magenta: "#7c2fd6" # Special / root
+    cyan:    "#0080a6" # Info / actions
+    white:   "#c2c8d4" # Light surface
+
+  bright: # Escalation / active states only — deeper, not lighter
+    black:   "#5c6270" # Muted / suggestions
+    red:     "#9e0030" # Escalation (darker = hotter on light)
+    green:   "#006e49" # Active success / values
+    yellow:  "#8a5800" # Urgent warning
+    blue:    "#1633a0" # Active flow nav
+    magenta: "#6a1fb8" # Elevated attention
+    cyan:    "#0e6e92" # Active tech signal / functions
+    white:   "#f1f3f7" # Lightest highlight

src/neon.yaml

@@ -2,47 +2,93 @@ scheme: "Apex Neon"
 author: "S0wlz (Owlibou)"
 type: "dark"
 
-# Core Semantics (The DNA)
-palette:
-  background: "#050505" # Void Black
-  foreground: "#ededed" # Stark White
-  cursor:     "#ff0044" # Razor Red (Primary Aggressor)
-  selection:  "#ff0044" # Target Locked
-  selection_fg: "#050505" # HARD RULE: Black text on Red
-  
-  # Functional Roles
-  error:   "#ff0044"
-  success: "#00ff99"
-  warning: "#ffb700"
-  info:    "#00eaff" # Electric Cyan
-  special: "#9d00ff" # Sacred Purple
-  azure:   "#0088cc" # Structural Blue
+# ============================================================================
+# Apex Neon v2 — a cold neon HUD on deep black. Hue carries meaning, sparsely.
+# Red = danger. Violet = attention. Neither ever enters a code buffer.
+# Canonical spec: apex-neon.md
+#
+# Key names are symmetric with aeon.yaml so shared/aggregated templates work.
+# ============================================================================
 
-# UI Surfaces (Depth)
-ui:
-  panel:   "#141414" # Inputs/Inactive Tabs
-  border:  "#262626" # Separators
-  dim:     "#737373" # Muted Text
-  stealth: "#404040" # Comments/Ignored
+# Neutrals — the readable 80% (spec §3). Anchored at Void, faint cool bias.
+neutral:
+  bg:      "#070709" # Main background, terminal background
+  surface: "#101218" # Inputs, inactive tabs, widgets, statuslines
+  panel:   "#181b22" # Panels, separators, scroll track
+  border:  "#262a34" # Visible borders, line-highlight background
+  subtle:  "#383d49" # Ignored / suppressed text (sub-threshold by design)
+  muted:   "#8b909c" # Comments, subtitles, muted labels
+  text:    "#e6e8ec" # Default body text (not pure white)
+  bright:  "#ffffff" # Extreme highlight only
 
-# ANSI Table (Terminal)
+# Attention — violet figure/ground (spec §4-5). Never inside a code buffer.
+focus:
+  max:    "#d68fff" # Cursor — the single hottest mark
+  active: "#b14dff" # Current search match, matched bracket / pair
+  field:  "#3a1a4d" # Other search matches, selection background
+
+# Danger — red figure/ground (spec §4,6). Never inside a code buffer.
+danger:
+  base:   "#ff0044" # Error figure, destructive action, active window border
+  field:  "#1f0a12" # Error region bg (Ember Field, + diff-delete bg)
+  bright: "#ff3b3b" # Escalation (ANSI color9) — hotter than base
+
+# Signal hues — information, state, structure.
+signal:
+  info:        "#00eaff" # Cyan — information / links
+  success:     "#00ff99" # Green — success / OK
+  warning:     "#ffb700" # Amber — warning (UI only, never in buffer)
+  special:     "#9d00ff" # Violet (deep) — reserved special / root
+  blue:        "#2e6bff" # Blue — kinds / structural accent
+  blue_bright: "#5b8cff" # Bright-blue — active flow / focus highlight
+
+# Syntax — typed by grammatical role (spec §7)
+# blue = kinds · cyan = actions · green = values · neutral = connective tissue
+syntax:
+  comment:     "#8b909c" # muted, italic — not a target
+  punctuation: "#aab0bc" # neutral, lifted
+  operator:    "#c2c8d4" # neutral
+  variable:    "#e6e8ec" # body text (calm everywhere)
+  property:    "#cdd4e3" # dim body — fields / properties
+  # kinds — blue
+  type:        "#7db4ff" # blue — types / struct / enum / trait
+  storage:     "#2e6bff" # blue, heavier — storage / modifier (pub mut async)
+  attribute:   "#2e6bff" # blue, declarative — #[derive]
+  # actions — cyan
+  function:    "#5af3ff" # cyan — function def / call
+  macro:       "#5af3ff" # cyan — bang-macro (action + ceremony)
+  builtin:     "#8fd6ff" # cyan, dim — self / builtin
+  # values — green
+  string:      "#2bffb2" # green — values
+  escape:      "#7dffd0" # green, brighter — char / escape
+  constant:    "#37dba0" # green, cooler — number / bool / const
+  # navigation
+  keyword:     "#5b8cff" # bright-blue, bold — static control flow
+
+# Diff / Git — dark tinted grounds, neon figures (spec §8)
+diff:
+  add:    { fg: "#00ff99", bg: "#0a1f16" }
+  change: { fg: "#ffb700", bg: "#1f1a0a" }
+  delete: { fg: "#ff0044", bg: "#1f0a12" } # reuses danger.field (Ember Field)
+
+# ANSI Table — 16-color fallback bank (spec §9)
 ansi:
   normal:
-    black:   "#050505"
-    red:     "#ff0044"
-    green:   "#00ff99"
-    yellow:  "#ffb700"
-    blue:    "#00eaff"
-    magenta: "#9d00ff"
-    cyan:    "#00eaff" # Mapped to Blue/Info
-    white:   "#ededed"
-  
-  bright: # Escalation only
-    black:   "#737373"
-    red:     "#ff8899"
-    green:   "#2bffb2"
-    yellow:  "#ffd24d"
-    blue:    "#5af3ff"
-    magenta: "#c84dff"
-    cyan:    "#5af3ff"
-    white:   "#ffffff"
+    black:   "#070709" # Background
+    red:     "#ff0044" # Danger / error / destructive
+    green:   "#00ff99" # Success
+    yellow:  "#ffb700" # Warning
+    blue:    "#2e6bff" # Kinds / structural (real blue)
+    magenta: "#9d00ff" # Special / root
+    cyan:    "#00eaff" # Info / actions
+    white:   "#e6e8ec" # Default text
+
+  bright: # Escalation / active states only
+    black:   "#383d49" # Muted / suggestions
+    red:     "#ff3b3b" # Escalation / alert (hotter than base)
+    green:   "#2bffb2" # Active success / values
+    yellow:  "#ffd24d" # Urgent warning
+    blue:    "#5b8cff" # Active flow nav / focus highlight
+    magenta: "#c84dff" # Elevated attention state
+    cyan:    "#5af3ff" # Active tech signal / functions
+    white:   "#ffffff" # Extreme highlight only

templates/alacritty/apex.toml.j2

@@ -1,46 +1,47 @@
 # {{ scheme | upper }} — Alacritty theme (colors only)
+# v2 spine: red = danger · violet = attention · cyan = info
 
 [colors.primary]
-background = "{{ palette.background }}"
-foreground = "{{ palette.foreground }}"
-dim_foreground = "{{ ui.dim }}"
+background = "{{ neutral.bg }}"
+foreground = "{{ neutral.text }}"
+dim_foreground = "{{ neutral.muted }}"
 bright_foreground = "{{ ansi.bright.white }}"
 
 [colors.cursor]
-text = "{{ palette.selection_fg }}"
-cursor = "{{ palette.cursor }}"
+text = "{{ neutral.bg }}"
+cursor = "{{ focus.max }}"
 
 [colors.vi_mode_cursor]
-text = "{{ palette.selection_fg }}"
-cursor = "{{ palette.info }}"
+text = "{{ neutral.bg }}"
+cursor = "{{ focus.active }}"
 
 [colors.selection]
-text = "{{ palette.selection_fg }}"
-background = "{{ palette.selection }}"
+text = "{{ neutral.text }}"
+background = "{{ focus.field }}"
 
 [colors.search.matches]
-foreground = "{{ palette.selection_fg }}"
-background = "{{ palette.selection }}"
+foreground = "{{ neutral.text }}"
+background = "{{ focus.field }}"
 
 [colors.search.focused_match]
-foreground = "{{ palette.selection_fg }}"
-background = "{{ palette.warning }}"
+foreground = "{{ neutral.bg }}"
+background = "{{ focus.active }}"
 
 [colors.hints.start]
-foreground = "{{ palette.selection_fg }}"
-background = "{{ palette.warning }}"
+foreground = "{{ neutral.bg }}"
+background = "{{ signal.warning }}"
 
 [colors.hints.end]
-foreground = "{{ palette.selection_fg }}"
-background = "{{ palette.info }}"
+foreground = "{{ neutral.bg }}"
+background = "{{ signal.info }}"
 
 [colors.line_indicator]
 foreground = "None"
 background = "None"
 
 [colors.footer_bar]
-foreground = "{{ palette.foreground }}"
-background = "{{ ui.panel }}"
+foreground = "{{ neutral.text }}"
+background = "{{ neutral.surface }}"
 
 [colors.normal]
 black   = "{{ ansi.normal.black }}"

templates/btop/apex.theme.j2

@@ -1,89 +1,90 @@
 # {{ scheme }} — Btop Theme
-# DNA: State over Decoration
+# v2 spine: red = danger · violet = attention · cyan = info
 
 # Main background, empty for terminal default, black for dark themes
-theme[main_bg]="{{ palette.background }}"
+theme[main_bg]="{{ neutral.bg }}"
 
 # Main text color
-theme[main_fg]="{{ palette.foreground }}"
+theme[main_fg]="{{ neutral.text }}"
 
 # Title color for boxes
-theme[title]="{{ palette.foreground }}"
+theme[title]="{{ neutral.text }}"
 
-# Highlight color for keyboard shortcuts
-theme[hi_fg]="{{ palette.cursor }}"
+# Highlight color for keyboard shortcuts — violet attention accent
+theme[hi_fg]="{{ focus.max }}"
 
-# Background color of selected item in processes box
-theme[selected_bg]="{{ palette.selection }}"
+# Background color of selected item in processes box — violet field
+theme[selected_bg]="{{ focus.field }}"
 
 # Foreground color of selected item in processes box
-theme[selected_fg]="{{ palette.selection_fg }}"
+theme[selected_fg]="{{ neutral.text }}"
 
 # Color of inactive/disabled text
-theme[inactive_fg]="{{ ui.dim }}"
+theme[inactive_fg]="{{ neutral.muted }}"
 
 # Color of text appearing on top of graphs, i.e. usage percentage
-theme[graph_text]="{{ ui.dim }}"
+theme[graph_text]="{{ neutral.muted }}"
 
 # Background color of the percentage meters
-theme[meter_bg]="{{ ui.panel }}"
+theme[meter_bg]="{{ neutral.surface }}"
 
 # Misc colors for processes box including mini cpu graphs, used memory percentage, and entries filter
-theme[proc_misc]="{{ palette.info }}"
+theme[proc_misc]="{{ signal.info }}"
 
 # Cpu box outline color
-theme[cpu_box]="{{ ui.border }}"
+theme[cpu_box]="{{ neutral.border }}"
 
 # Memory box outline color
-theme[mem_box]="{{ ui.border }}"
+theme[mem_box]="{{ neutral.border }}"
 
 # Net box outline color
-theme[net_box]="{{ ui.border }}"
+theme[net_box]="{{ neutral.border }}"
 
 # Processes box outline color
-theme[proc_box]="{{ ui.border }}"
+theme[proc_box]="{{ neutral.border }}"
 
 # Box divider line and small boxes line color
-theme[div_line]="{{ ui.border }}"
+theme[div_line]="{{ neutral.border }}"
 
+# Heat gradients: calm info -> special -> danger red at the hot end
 # Temperature graph colors
-theme[temp_start]="{{ palette.info }}"
-theme[temp_mid]="{{ palette.special }}"
-theme[temp_end]="{{ palette.cursor }}"
+theme[temp_start]="{{ signal.info }}"
+theme[temp_mid]="{{ signal.special }}"
+theme[temp_end]="{{ danger.base }}"
 
 # CPU graph colors
-theme[cpu_start]="{{ palette.info }}"
-theme[cpu_mid]="{{ palette.special }}"
-theme[cpu_end]="{{ palette.cursor }}"
+theme[cpu_start]="{{ signal.info }}"
+theme[cpu_mid]="{{ signal.special }}"
+theme[cpu_end]="{{ danger.base }}"
 
 # Mem graph colors
-theme[free_start]="{{ palette.success }}"
-theme[free_mid]="{{ palette.warning }}"
-theme[free_end]="{{ palette.cursor }}"
+theme[free_start]="{{ signal.success }}"
+theme[free_mid]="{{ signal.warning }}"
+theme[free_end]="{{ danger.base }}"
 
-theme[cached_start]="{{ palette.info }}"
-theme[cached_mid]="{{ palette.special }}"
-theme[cached_end]="{{ palette.cursor }}"
+theme[cached_start]="{{ signal.info }}"
+theme[cached_mid]="{{ signal.special }}"
+theme[cached_end]="{{ danger.base }}"
 
-theme[available_start]="{{ palette.success }}"
-theme[available_mid]="{{ palette.warning }}"
-theme[available_end]="{{ palette.cursor }}"
+theme[available_start]="{{ signal.success }}"
+theme[available_mid]="{{ signal.warning }}"
+theme[available_end]="{{ danger.base }}"
 
-theme[used_start]="{{ palette.info }}"
-theme[used_mid]="{{ palette.special }}"
-theme[used_end]="{{ palette.cursor }}"
+theme[used_start]="{{ signal.info }}"
+theme[used_mid]="{{ signal.special }}"
+theme[used_end]="{{ danger.base }}"
 
 # Download graph colors
-theme[download_start]="{{ palette.info }}"
-theme[download_mid]="{{ palette.special }}"
-theme[download_end]="{{ palette.cursor }}"
+theme[download_start]="{{ signal.info }}"
+theme[download_mid]="{{ signal.special }}"
+theme[download_end]="{{ danger.base }}"
 
 # Upload graph colors
-theme[upload_start]="{{ palette.info }}"
-theme[upload_mid]="{{ palette.special }}"
-theme[upload_end]="{{ palette.cursor }}"
+theme[upload_start]="{{ signal.info }}"
+theme[upload_mid]="{{ signal.special }}"
+theme[upload_end]="{{ danger.base }}"
 
 # Process path color
-theme[process_start]="{{ palette.info }}"
-theme[process_mid]="{{ palette.special }}"
-theme[process_end]="{{ palette.cursor }}"
+theme[process_start]="{{ signal.info }}"
+theme[process_mid]="{{ signal.special }}"
+theme[process_end]="{{ danger.base }}"

templates/fuzzel/fuzzel.ini.j2

@@ -1,14 +1,14 @@
 # {{ scheme }} — Fuzzel Theme
-# DNA: State over Decoration
+# v2 spine: red = danger · violet = attention · cyan = info
 
 [colors]
-background={{ palette.background | replace('#', '') }}ff
-text={{ palette.foreground | replace('#', '') }}ff
-match={{ palette.info | replace('#', '') }}ff
-selection={{ palette.selection | replace('#', '') }}ff
-selection-text={{ palette.selection_fg | replace('#', '') }}ff
-selection-match={{ palette.info | replace('#', '') }}ff
-border={{ palette.info | replace('#', '') }}ff
+background={{ neutral.bg | replace('#', '') }}ff
+text={{ neutral.text | replace('#', '') }}ff
+match={{ signal.info | replace('#', '') }}ff
+selection={{ focus.field | replace('#', '') }}ff
+selection-text={{ neutral.text | replace('#', '') }}ff
+selection-match={{ signal.info | replace('#', '') }}ff
+border={{ signal.info | replace('#', '') }}ff
 
 [border]
 width=2

templates/gemini/apex.json.j2

@@ -1,24 +0,0 @@
-{
-  "name": "{{ scheme }}",
-  "type": "custom",
-  "Background": "{{ palette.background }}",
-  "Foreground": "{{ palette.foreground }}",
-  "LightBlue": "{{ ansi.bright.blue }}",
-  "AccentBlue": "{{ palette.info }}",
-  "AccentPurple": "{{ palette.special }}",
-  "AccentCyan": "{{ ansi.bright.cyan }}",
-  "AccentGreen": "{{ palette.success }}",
-  "AccentYellow": "{{ palette.warning }}",
-  "AccentRed": "{{ palette.cursor }}",
-  "Comment": "{{ ui.dim }}",
-  "Gray": "{{ ui.stealth }}",
-  "DiffAdded": "{{ palette.success }}",
-  "DiffRemoved": "{{ palette.error }}",
-  "DiffModified": "{{ palette.warning }}",
-  "text": {
-    "primary": "{{ palette.foreground }}",
-    "secondary": "{{ ui.dim }}",
-    "accent": "{{ palette.info }}",
-    "response": "{{ palette.foreground }}"
-  }
-}

templates/gemini/meta.yaml

@@ -1,4 +0,0 @@
-author: S0wlz (Owlibou)
-description: Gemini CLI custom theme
-version: 1.0.1
-strategy: individual

templates/ghostty/apex.j2

@@ -0,0 +1,30 @@
+# {{ scheme }} - Ghostty theme
+# v2 spine: red = danger · violet = attention · cyan = info
+
+background = {{ neutral.bg }}
+foreground = {{ neutral.text }}
+
+# Cursor: the crosshair — violet, dark ink under the block
+cursor-color = {{ focus.max }}
+cursor-text = {{ neutral.bg }}
+
+# Selection: violet field (attention, not danger)
+selection-background = {{ focus.field }}
+selection-foreground = {{ neutral.text }}
+
+palette = 0={{ ansi.normal.black }}
+palette = 1={{ ansi.normal.red }}
+palette = 2={{ ansi.normal.green }}
+palette = 3={{ ansi.normal.yellow }}
+palette = 4={{ ansi.normal.blue }}
+palette = 5={{ ansi.normal.magenta }}
+palette = 6={{ ansi.normal.cyan }}
+palette = 7={{ ansi.normal.white }}
+palette = 8={{ ansi.bright.black }}
+palette = 9={{ ansi.bright.red }}
+palette = 10={{ ansi.bright.green }}
+palette = 11={{ ansi.bright.yellow }}
+palette = 12={{ ansi.bright.blue }}
+palette = 13={{ ansi.bright.magenta }}
+palette = 14={{ ansi.bright.cyan }}
+palette = 15={{ ansi.bright.white }}

templates/ghostty/meta.yaml

@@ -1,4 +1,4 @@
 author: S0wlz (Owlibou)
-description: Sherlock launcher theme
+description: Ghostty theme
 version: 1.0.0
 strategy: individual

templates/gtk4/gtk.css.j2

@@ -1,5 +1,5 @@
 /* Apex Theme System — GTK4 / Libadwaita */
-/* Auto-generated from Apex DNA */
+/* v2 spine: red = danger · violet = attention · cyan = info */
 
 {% for s in schemes %}
 /* Scheme: {{ s.scheme }} ({{ s.type }}) */
@@ -10,60 +10,61 @@
 {% endif %}
   :root {
     /* Core Surfaces */
-    @define-color window_bg_color {{ s.palette.background }};
-    @define-color window_fg_color {{ s.palette.foreground }};
+    @define-color window_bg_color {{ s.neutral.bg }};
+    @define-color window_fg_color {{ s.neutral.text }};
 
-    @define-color view_bg_color {{ s.palette.background }};
-    @define-color view_fg_color {{ s.palette.foreground }};
+    @define-color view_bg_color {{ s.neutral.bg }};
+    @define-color view_fg_color {{ s.neutral.text }};
 
-    @define-color headerbar_bg_color {{ s.ui.panel }};
-    @define-color headerbar_fg_color {{ s.palette.foreground }};
-    @define-color headerbar_border_color {{ s.ui.border }};
+    @define-color headerbar_bg_color {{ s.neutral.surface }};
+    @define-color headerbar_fg_color {{ s.neutral.text }};
+    @define-color headerbar_border_color {{ s.neutral.border }};
     @define-color headerbar_backdrop_color @window_bg_color;
     @define-color headerbar_shade_color rgba(0, 0, 0, 0.07);
 
-    @define-color popover_bg_color {{ s.ui.panel }};
-    @define-color popover_fg_color {{ s.palette.foreground }};
+    @define-color popover_bg_color {{ s.neutral.surface }};
+    @define-color popover_fg_color {{ s.neutral.text }};
 
-    @define-color card_bg_color {{ s.ui.panel }};
-    @define-color card_fg_color {{ s.palette.foreground }};
+    @define-color card_bg_color {{ s.neutral.surface }};
+    @define-color card_fg_color {{ s.neutral.text }};
     @define-color card_shade_color rgba(0, 0, 0, 0.07);
 
-    @define-color dialog_bg_color {{ s.ui.panel }};
-    @define-color dialog_fg_color {{ s.palette.foreground }};
+    @define-color dialog_bg_color {{ s.neutral.surface }};
+    @define-color dialog_fg_color {{ s.neutral.text }};
 
     /* Accents */
-    @define-color accent_color {{ s.palette.info }};
-    @define-color accent_bg_color {{ s.palette.info }};
-    @define-color accent_fg_color {{ s.palette.background }};
+    @define-color accent_color {{ s.signal.info }};
+    @define-color accent_bg_color {{ s.signal.info }};
+    @define-color accent_fg_color {{ s.neutral.bg }};
 
-    @define-color destructive_color {{ s.palette.cursor }};
-    @define-color destructive_bg_color {{ s.palette.cursor }};
-    @define-color destructive_fg_color {{ s.palette.background }};
+    /* Destructive = danger red (spec §5,6) */
+    @define-color destructive_color {{ s.danger.base }};
+    @define-color destructive_bg_color {{ s.danger.base }};
+    @define-color destructive_fg_color {{ s.neutral.bg }};
 
-    @define-color success_color {{ s.palette.success }};
-    @define-color success_bg_color {{ s.palette.success }};
-    @define-color success_fg_color {{ s.palette.background }};
+    @define-color success_color {{ s.signal.success }};
+    @define-color success_bg_color {{ s.signal.success }};
+    @define-color success_fg_color {{ s.neutral.bg }};
 
-    @define-color warning_color {{ s.palette.warning }};
-    @define-color warning_bg_color {{ s.palette.warning }};
-    @define-color warning_fg_color {{ s.palette.background }};
+    @define-color warning_color {{ s.signal.warning }};
+    @define-color warning_bg_color {{ s.signal.warning }};
+    @define-color warning_fg_color {{ s.neutral.bg }};
 
-    @define-color error_color {{ s.ansi.bright.red }};
-    @define-color error_bg_color {{ s.ansi.bright.red }};
-    @define-color error_fg_color {{ s.palette.background }};
+    @define-color error_color {{ s.danger.base }};
+    @define-color error_bg_color {{ s.danger.base }};
+    @define-color error_fg_color {{ s.neutral.bg }};
 
     /* UI Elements */
-    @define-color borders {{ s.ui.border }};
-    @define-color sidebar_bg_color {{ s.ui.panel }};
-    @define-color sidebar_fg_color {{ s.palette.foreground }};
+    @define-color borders {{ s.neutral.border }};
+    @define-color sidebar_bg_color {{ s.neutral.surface }};
+    @define-color sidebar_fg_color {{ s.neutral.text }};
     @define-color sidebar_backdrop_color @window_bg_color;
     @define-color sidebar_shade_color rgba(0, 0, 0, 0.07);
 
     /* Custom Apex Palette */
-    @define-color apex_razor {{ s.palette.cursor }};
-    @define-color apex_void {{ s.palette.background }};
-    @define-color apex_stealth {{ s.ui.stealth }};
+    @define-color apex_focus {{ s.focus.max }};
+    @define-color apex_void {{ s.neutral.bg }};
+    @define-color apex_subtle {{ s.neutral.subtle }};
   }
 }
 {% endfor %}

templates/hyprland/colors.conf.j2

@@ -1,70 +1,68 @@
 #############################
 ### {{ scheme | upper }} THEME ###
 #############################
+# v2 spine: red = danger · violet = attention · cyan = info
 
-# The Void (Backgrounds)
-# Pure, unadulterated darkness. None of that "grey-blue" nonsense.
-$base = rgb({{ palette.background | replace('#', '') }})
-$baseAlpha = {{ palette.background | replace('#', '') }}
+# Backgrounds — the readable ground
+$base = rgb({{ neutral.bg | replace('#', '') }})
+$baseAlpha = {{ neutral.bg | replace('#', '') }}
 
-$surface = rgb({{ ui.panel | replace('#', '') }})
-$surfaceAlpha = {{ ui.panel | replace('#', '') }}
+$surface = rgb({{ neutral.surface | replace('#', '') }})
+$surfaceAlpha = {{ neutral.surface | replace('#', '') }}
 
-$overlay = rgb({{ ui.border | replace('#', '') }})
-$overlayAlpha = {{ ui.border | replace('#', '') }}
+$overlay = rgb({{ neutral.border | replace('#', '') }})
+$overlayAlpha = {{ neutral.border | replace('#', '') }}
 
-$muted = rgb({{ ui.stealth | replace('#', '') }})
-$mutedAlpha = {{ ui.stealth | replace('#', '') }}
+$muted = rgb({{ neutral.subtle | replace('#', '') }})
+$mutedAlpha = {{ neutral.subtle | replace('#', '') }}
 
-$subtle = rgb({{ ui.stealth | replace('#', '') }})
-$subtleAlpha = {{ ui.stealth | replace('#', '') }}
+$subtle = rgb({{ neutral.subtle | replace('#', '') }})
+$subtleAlpha = {{ neutral.subtle | replace('#', '') }}
 
-# The Signal (Text)
-# Stark white for maximum readability.
-$text = rgb({{ palette.foreground | replace('#', '') }})
-$textAlpha = {{ palette.foreground | replace('#', '') }}
+# Text
+$text = rgb({{ neutral.text | replace('#', '') }})
+$textAlpha = {{ neutral.text | replace('#', '') }}
 
-# Accents (Aggressive)
-# "Razor Red" - For errors or active borders. Blood-like.
-$love = rgb({{ palette.cursor | replace('#', '') }})
-$loveAlpha = {{ palette.cursor | replace('#', '') }}
+# Accents
+# Danger red — active borders, alerts (spec §5)
+$love = rgb({{ danger.base | replace('#', '') }})
+$loveAlpha = {{ danger.base | replace('#', '') }}
 
-# "Warning Gold"
-$gold = rgb({{ palette.warning | replace('#', '') }})
-$goldAlpha = {{ palette.warning | replace('#', '') }}
+# Warning amber
+$gold = rgb({{ signal.warning | replace('#', '') }})
+$goldAlpha = {{ signal.warning | replace('#', '') }}
 
-# "Toxic Green" - Because nature isn't always nice.
-$pine = rgb({{ palette.success | replace('#', '') }})
-$pineAlpha = {{ palette.success | replace('#', '') }}
+# Success green
+$pine = rgb({{ signal.success | replace('#', '') }})
+$pineAlpha = {{ signal.success | replace('#', '') }}
 
-# "Electric Cyan" - Cold, digital logic.
-$foam = rgb({{ palette.info | replace('#', '') }})
-$foamAlpha = {{ palette.info | replace('#', '') }}
+# Info cyan
+$foam = rgb({{ signal.info | replace('#', '') }})
+$foamAlpha = {{ signal.info | replace('#', '') }}
 
-# "Deep Void Purple"
-$iris = rgb({{ palette.special | replace('#', '') }})
-$irisAlpha = {{ palette.special | replace('#', '') }}
+# Special / root violet
+$iris = rgb({{ signal.special | replace('#', '') }})
+$irisAlpha = {{ signal.special | replace('#', '') }}
 
-# "Pale Rose" (Mapped to alert color)
-$rose = rgb({{ ansi.bright.red | replace('#', '') }})
-$roseAlpha = {{ ansi.bright.red | replace('#', '') }}
+# Escalation red (hotter than base)
+$rose = rgb({{ danger.bright | replace('#', '') }})
+$roseAlpha = {{ danger.bright | replace('#', '') }}
 
 # Highlight variants
-$highlight_low = rgb({{ ui.panel | replace('#', '') }})
-$highlight_lowAlpha = {{ ui.panel | replace('#', '') }}
+$highlight_low = rgb({{ neutral.surface | replace('#', '') }})
+$highlight_lowAlpha = {{ neutral.surface | replace('#', '') }}
 
-$highlight_med = rgb({{ ui.border | replace('#', '') }})
-$highlight_medAlpha = {{ ui.border | replace('#', '') }}
+$highlight_med = rgb({{ neutral.border | replace('#', '') }})
+$highlight_medAlpha = {{ neutral.border | replace('#', '') }}
 
-$highlight_high = rgb({{ ui.stealth | replace('#', '') }})
-$highlight_highAlpha = {{ ui.stealth | replace('#', '') }}
+$highlight_high = rgb({{ neutral.subtle | replace('#', '') }})
+$highlight_highAlpha = {{ neutral.subtle | replace('#', '') }}
 
 # Theme-specific definitions
 $splash_text = rgba($textAlphaee)
 $dec_shadow = rgba(000000ee) # Hard shadows
 
-# Border configurations
-# Sharp, thin, and aggressive.
+# Border configurations — active window = danger red into special violet
 $border_active = rgba($loveAlphaff) rgba($irisAlphaff) 45deg
 $border_inactive = rgba($mutedAlpha44) rgba($surfaceAlpha44) 45deg
 

templates/kitty/apex.conf.j2

@@ -1,66 +1,66 @@
 ## {{ scheme | upper }} - KITTY THEME ##
-## Spec-accurate: color = state, not decoration
+## v2 spine: red = danger · violet = attention · cyan = info
 
 # --- Core ---
-foreground            {{ palette.foreground }}
-background            {{ palette.background }}
+foreground            {{ neutral.text }}
+background            {{ neutral.bg }}
 
-# Selection: "target locked"
-selection_background  {{ palette.selection }}
-selection_foreground  {{ palette.selection_fg }}
+# Selection: violet field (attention, not danger)
+selection_background  {{ focus.field }}
+selection_foreground  {{ neutral.text }}
 
-# Cursor: Razor Red beam
-cursor                {{ palette.cursor }}
-cursor_text_color     {{ palette.selection_fg }}
+# Cursor: the crosshair — violet, dark ink under the block
+cursor                {{ focus.max }}
+cursor_text_color     {{ neutral.bg }}
 cursor_shape          beam
 
 # URLs: informational cyan
-url_color             {{ palette.info }}
+url_color             {{ signal.info }}
 
-# Borders (optional)
-active_border_color   {{ palette.cursor }}
-inactive_border_color {{ ui.border }}
+# Borders: active window = danger red (spec §5)
+active_border_color   {{ danger.base }}
+inactive_border_color {{ neutral.border }}
 
-# Optional: subtle UI hint for visual bell
-visual_bell_color     {{ ansi.bright.red }}
+# Visual bell: hot red
+visual_bell_color     {{ danger.bright }}
 
 # Spacing
 window_padding_width  4
 
-# --- 16-COLOR ANSI TABLE ({{ scheme }} spec) ---
+# --- 16-COLOR ANSI TABLE ({{ scheme }} spec §9) ---
 
 # Normal bank (0–7)
-# color0: Black (Void)
+# color0: Black (bg)
 color0   {{ ansi.normal.black }}
-# color1: Red (Razor)
+# color1: Red (danger)
 color1   {{ ansi.normal.red }}
-# color2: Green (OK)
+# color2: Green (success)
 color2   {{ ansi.normal.green }}
-# color3: Yellow (Gold)
+# color3: Yellow (warning)
 color3   {{ ansi.normal.yellow }}
-# color4: Blue (Info)
+# color4: Blue (kinds / structural)
 color4   {{ ansi.normal.blue }}
-# color5: Magenta (Purple)
+# color5: Magenta (special / root)
 color5   {{ ansi.normal.magenta }}
-# color6: Cyan (Info mapped)
+# color6: Cyan (info / actions)
 color6   {{ ansi.normal.cyan }}
-# color7: White (Stark)
+# color7: White (text)
 color7   {{ ansi.normal.white }}
 
-# Bright bank (8–15)
-# color8: Bright black (UI separators)
+# Bright bank (8–15) — escalation / active states only
+# color8: Bright black (muted / separators)
 color8   {{ ansi.bright.black }}
-# color9: Bright red (Alerts)
+# color9: Bright red (escalation)
 color9   {{ ansi.bright.red }}
-# color10: Bright green (Active success)
+# color10: Bright green (active success)
 color10  {{ ansi.bright.green }}
-# color11: Bright yellow (Urgent warning)
+# color11: Bright yellow (urgent warning)
 color11  {{ ansi.bright.yellow }}
-# color12: Bright blue (Active info)
+# color12: Bright blue (active flow)
 color12  {{ ansi.bright.blue }}
-# color13: Bright magenta (Elevated special)
+# color13: Bright magenta (elevated attention)
 color13  {{ ansi.bright.magenta }}
-# color14: Bright cyan (Active tech signal)
+# color14: Bright cyan (active tech signal)
 color14  {{ ansi.bright.cyan }}
-# color15: Bright white (Extreme highlight)
+# color15: Bright white (extreme highlight)
 color15  {{ ansi.bright.white }}

templates/nushell/apex.nu.j2

@@ -0,0 +1,70 @@
+# {{ scheme }} — Nushell color config
+# v2 spine: red = danger · violet = attention · cyan = info
+# Usage: add `use /path/to/apex-{{ scheme | lower | replace(' ', '-') | replace('apex-', '') }}.nu` to config.nu
+
+export-env {
+    $env.config.color_config = {
+
+        # --- Chrome ---
+        separator:                    "{{ neutral.muted }}"
+        leading_trailing_space_bg:  { bg: "{{ neutral.border }}" }
+        header:                     { fg: "{{ syntax.type }}" attr: b }
+        empty:                        "{{ neutral.muted }}"
+        row_index:                  { fg: "{{ neutral.muted }}" attr: b }
+        hints:                        "{{ neutral.subtle }}"
+
+        # --- Primitive types ---
+        string:                     { fg: "{{ syntax.string }}" }
+        int:                        { fg: "{{ syntax.constant }}" }
+        float:                      { fg: "{{ syntax.constant }}" }
+        bool:                       { fg: "{{ syntax.constant }}" }
+        filesize:                   { fg: "{{ signal.info }}" }
+        duration:                   { fg: "{{ signal.info }}" }
+        datetime:                   { fg: "{{ signal.info }}" }
+        range:                      { fg: "{{ neutral.text }}" }
+        record:                     { fg: "{{ neutral.text }}" }
+        list:                       { fg: "{{ neutral.text }}" }
+        block:                      { fg: "{{ syntax.keyword }}" }
+        nothing:                    { fg: "{{ neutral.muted }}" }
+        binary:                     { fg: "{{ signal.info }}" }
+
+        # --- Shapes (REPL syntax highlighting) ---
+        # The REPL line is a code buffer: amber/violet/red stay out (keystone).
+        shape_string:               { fg: "{{ syntax.string }}" }
+        shape_string_interpolation: { fg: "{{ syntax.string }}" attr: b }
+        shape_int:                  { fg: "{{ syntax.constant }}" }
+        shape_float:                { fg: "{{ syntax.constant }}" }
+        shape_bool:                 { fg: "{{ syntax.constant }}" }
+        shape_datetime:             { fg: "{{ signal.info }}" }
+        shape_binary:               { fg: "{{ signal.info }}" }
+        shape_filepath:             { fg: "{{ signal.info }}" }
+        shape_directory:            { fg: "{{ signal.info }}" }
+        shape_globpattern:          { fg: "{{ signal.info }}" }
+        shape_glob_interpolation:   { fg: "{{ signal.info }}" }
+        shape_nothing:              { fg: "{{ neutral.muted }}" }
+        shape_variable:             { fg: "{{ syntax.variable }}" }
+        shape_vardecl:              { fg: "{{ syntax.variable }}" }
+        shape_operator:             { fg: "{{ syntax.operator }}" }
+        shape_external:             { fg: "{{ syntax.function }}" }
+        shape_externalarg:          { fg: "{{ neutral.text }}" }
+        shape_internalcall:         { fg: "{{ syntax.function }}" attr: b }
+        shape_signature:            { fg: "{{ syntax.function }}" }
+        shape_flag:                 { fg: "{{ syntax.attribute }}" }
+        shape_pipe:                 { fg: "{{ syntax.keyword }}" attr: b }
+        shape_redirection:          { fg: "{{ syntax.operator }}" }
+        shape_and:                  { fg: "{{ syntax.keyword }}" attr: b }
+        shape_or:                   { fg: "{{ syntax.keyword }}" attr: b }
+        shape_keyword:              { fg: "{{ syntax.keyword }}" attr: b }
+        shape_block:                { fg: "{{ syntax.keyword }}" }
+        shape_closure:              { fg: "{{ syntax.keyword }}" }
+        shape_list:                 { fg: "{{ neutral.text }}" }
+        shape_record:               { fg: "{{ neutral.text }}" }
+        shape_table:                { fg: "{{ neutral.text }}" }
+        shape_range:                { fg: "{{ neutral.text }}" }
+        shape_literal:              { fg: "{{ neutral.text }}" }
+        shape_custom:               { fg: "{{ neutral.text }}" }
+        shape_match_pattern:        { fg: "{{ syntax.keyword }}" }
+        shape_matching_brackets:    { attr: u }
+        shape_garbage:              { fg: "{{ danger.base }}" attr: b }
+    }
+}

templates/nushell/meta.yaml

@@ -0,0 +1,4 @@
+author: S0wlz (Owlibou)
+description: Nushell color_config theme
+version: 1.0.0
+strategy: individual

templates/nvim/colors/apex.lua.j2

@@ -1,29 +1,52 @@
 -- {{ scheme }}: Standalone Theme Engine
--- Philosophy: State over Decoration. Red is Presence. Cyan is Data.
+-- Philosophy: Signal over decoration. Red = danger. Violet = attention.
+-- Neither red nor violet ever appears inside the code buffer (spec §1, §12).
 
 local M = {}
 
 M.palette = {
-  -- The Void
-  void = "{{ palette.background }}", -- Background
-  panel = "{{ ui.panel }}", -- Dark Surface (Statusline/Gutter)
-  border = "{{ ui.border }}", -- Muted Border
-  stealth = "{{ ui.stealth }}", -- Comments / Ignored
+  -- NEUTRALS — the readable field --------------------------------------------
+  void    = "{{ neutral.bg }}",      -- Background (also: ink on a bright accent fill)
+  panel   = "{{ neutral.surface }}", -- Dark surface (statusline, floats, cursorline)
+  border  = "{{ neutral.border }}",  -- Borders, separators
+  stealth = "{{ neutral.subtle }}",  -- Ignored text only (sub-threshold by design)
+  dim     = "{{ neutral.muted }}",   -- Comments, muted labels (ghost)
+  text    = "{{ neutral.text }}",    -- Body text (stark / ink)
+  punct   = "{{ syntax.punctuation }}", -- Punctuation / delimiters (lifted neutral)
+  op      = "{{ syntax.operator }}",    -- Operators (neutral)
+  prop    = "{{ syntax.property }}",    -- Fields / properties (dim body)
 
-  -- The Signal
-  text = "{{ palette.foreground }}", -- Stark White
-  dim = "{{ ui.dim }}", -- Muted Text
+  -- ATTENTION (violet) — cursor, search, matched pairs. NEVER syntax. --------
+  focus        = "{{ focus.max }}",    -- Cursor — the crosshair (hottest mark)
+  focus_active = "{{ focus.active }}", -- Current match, matched bracket / pair
+  focus_field  = "{{ focus.field }}",  -- Search-set / selection background
 
-  -- The Hunter (Presence)
-  razor = "{{ palette.cursor }}", -- PRIMARY: Cursor, Current Match, Active Border
-  alert = "{{ ansi.bright.red }}", -- ERROR: Readable text on Red
+  -- DANGER (red) — error, destructive, alarm. NEVER syntax. ------------------
+  danger       = "{{ danger.base }}",   -- Error figure, destructive, active border
+  danger_field = "{{ danger.field }}",  -- Error region / delete background
+  danger_hot   = "{{ danger.bright }}", -- Escalation
 
-  -- The HUD (Data)
-  tech = "{{ palette.info }}", -- INFO: Selection, Search Match, Constants
-  toxic = "{{ palette.success }}", -- SUCCESS: Strings
-  amber = "{{ palette.warning }}", -- WARNING: Types, Search
-  azure = "{{ palette.azure }}", -- STRUCT: Functions (Deep Blue)
-  sacred = "{{ palette.special }}", -- SPECIAL: Keywords, Root
+  -- CODE HUES (buffer-safe) --------------------------------------------------
+  info    = "{{ signal.info }}",     -- Cyan — info / links
+  action  = "{{ syntax.function }}", -- Cyan — functions / methods
+  builtin = "{{ syntax.builtin }}",  -- Cyan, dim — self / builtin
+  kind    = "{{ syntax.type }}",     -- Blue — types / kinds
+  storage = "{{ syntax.storage }}",  -- Blue, heavy — storage / modifier / attribute
+  flow    = "{{ syntax.keyword }}",  -- Bright-blue — control-flow navigation
+  value   = "{{ syntax.string }}",   -- Green — strings / values
+  escape  = "{{ syntax.escape }}",   -- Green, bright — char / escape
+  const   = "{{ syntax.constant }}", -- Green, cool — numbers / const
+  ok      = "{{ signal.success }}",  -- Green — success state
+  warn    = "{{ signal.warning }}",  -- Amber — warning (UI only)
+  special = "{{ signal.special }}",  -- Violet-deep — root / special only
+
+  -- DIFF grounds -------------------------------------------------------------
+  diff_add = "{{ diff.add.bg }}",
+  diff_chg = "{{ diff.change.bg }}",
+  diff_del = "{{ diff.delete.bg }}",
+
+  -- ON-ACCENT INK ------------------------------------------------------------
+  ink = "{{ neutral.text }}", -- fg on a dim violet field (search / selection)
 }
 
 function M.load()
@@ -32,6 +55,16 @@ function M.load()
   vim.o.background = "{{ type }}"
   vim.g.colors_name = "{{ scheme | lower | replace(' ', '-') }}"
 
+  -- Optional transparency: set g:apex_blend or g:apex_transparent to opt in.
+  local blend = vim.g.apex_blend
+  if type(blend) == "number" then
+    vim.o.winblend = blend
+    vim.o.pumblend = blend
+  elseif vim.g.apex_transparent == true then
+    vim.o.winblend = 20
+    vim.o.pumblend = 20
+  end
+
   local p = M.palette
   local groups = {
     -- CANVAS & UI -----------------------------------------------------------
@@ -39,126 +72,731 @@ function M.load()
     NormalNC = { fg = p.dim, bg = p.void }, -- Non-focused windows
     SignColumn = { bg = p.void },
     FoldColumn = { fg = p.stealth, bg = p.void },
-    VertSplit = { fg = p.razor }, -- Deprecated in nvim 0.10, but good fallback
-    WinSeparator = { fg = p.razor }, -- The Cage (Red Borders)
+    VertSplit = { fg = p.border }, -- Deprecated in nvim 0.10, but good fallback
+    WinSeparator = { fg = p.border },
     EndOfBuffer = { fg = p.void }, -- Hide tildes
+    NormalFloat = { fg = p.text, bg = p.panel },
+    FloatBorder = { fg = p.border, bg = p.panel },
+    MsgArea = { fg = p.text, bg = p.void },
+    WinBar = { fg = p.text, bg = p.panel },
+    WinBarNC = { fg = p.dim, bg = p.panel },
 
-    -- CURSOR & NAVIGATION ("The Hunter") ------------------------------------
-    Cursor = { fg = p.void, bg = p.razor }, -- Red Beam
-    TermCursor = { fg = p.void, bg = p.razor },
+    -- CURSOR & NAVIGATION ("Attention" — violet) ----------------------------
+    Cursor = { fg = p.void, bg = p.focus }, -- Violet crosshair
+    TermCursor = { fg = p.void, bg = p.focus },
     CursorLine = { bg = p.panel },
-    CursorLineNr = { fg = p.razor, bold = true }, -- Red Line Number (You are here)
+    CursorColumn = { bg = p.panel },
+    ColorColumn = { bg = p.panel },
+    CursorLineNr = { fg = p.focus, bold = true }, -- Violet line number (you are here)
     LineNr = { fg = p.stealth }, -- Other lines fade out
 
-    -- SELECTION & SEARCH ("Terminator Vision") ------------------------------
-    Visual = { fg = p.void, bg = p.tech, bold = true }, -- Cyan (Data Lock)
-    VisualNOS = { fg = p.void, bg = p.border },
+    -- SELECTION & SEARCH ("Region scanned" — violet field) ------------------
+    Visual = { fg = p.ink, bg = p.focus_field }, -- Dim violet field, fg preserved
+    VisualNOS = { fg = p.ink, bg = p.focus_field },
 
-    Search = { fg = p.void, bg = p.tech }, -- Cyan (Potential Targets)
-    IncSearch = { fg = p.void, bg = p.razor }, -- Red (Acquiring...)
-    CurSearch = { fg = p.void, bg = p.razor, bold = true }, -- Red (Target Locked)
+    Search = { fg = p.ink, bg = p.focus_field }, -- Other matches: the set
+    IncSearch = { fg = p.void, bg = p.focus_active }, -- Acquiring
+    CurSearch = { fg = p.void, bg = p.focus_active, bold = true }, -- The one you are on
 
     -- STATUS & MESSAGES -----------------------------------------------------
     StatusLine = { fg = p.text, bg = p.panel },
     StatusLineNC = { fg = p.dim, bg = p.void },
-    WildMenu = { fg = p.void, bg = p.tech },
+    WildMenu = { fg = p.void, bg = p.focus_active },
     Pmenu = { fg = p.text, bg = p.panel },
-    PmenuSel = { fg = p.void, bg = p.razor, bold = true }, -- Red Menu Selection
+    PmenuSel = { fg = p.void, bg = p.focus, bold = true }, -- Violet menu selection
+    PmenuKind = { fg = p.dim, bg = p.panel },
+    PmenuKindSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuExtra = { fg = p.dim, bg = p.panel },
+    PmenuExtraSel = { fg = p.void, bg = p.focus, bold = true },
+    PmenuMatch = { fg = p.info, bg = p.panel, bold = true },
+    PmenuMatchSel = { fg = p.void, bg = p.focus, bold = true },
     PmenuSbar = { bg = p.panel },
     PmenuThumb = { bg = p.stealth },
+    ErrorMsg = { fg = p.danger },
+    WarningMsg = { fg = p.warn },
+    MoreMsg = { fg = p.info },
+    ModeMsg = { fg = p.text },
+    TabLine = { fg = p.dim, bg = p.panel },
+    TabLineSel = { fg = p.text, bg = p.void, bold = true },
+    TabLineFill = { fg = p.panel, bg = p.panel },
+    QuickFixLine = { fg = p.text, bg = p.panel, bold = true },
 
-    -- SYNTAX HIGHLIGHTING ---------------------------------------------------
-    Comment = { fg = p.stealth, italic = true },
-    Constant = { fg = p.tech }, -- Cyan (Digital values)
-    String = { fg = p.toxic }, -- Green (Organic strings)
-    Character = { fg = p.toxic },
-    Number = { fg = p.tech },
-    Boolean = { fg = p.tech },
-    Float = { fg = p.tech },
+    -- SYNTAX: typed by grammatical role (spec §7) ---------------------------
+    -- blue = kinds · cyan = actions · green = values · neutral = connective
+    Comment = { fg = p.dim, italic = true }, -- Ghost — not a target
 
-    Identifier = { fg = p.text }, -- Variables (White)
-    Function = { fg = p.azure }, -- Deep Blue (Structure)
+    Constant = { fg = p.const }, -- Green (cool) — const values
+    String = { fg = p.value }, -- Green — strings
+    Character = { fg = p.value },
+    Number = { fg = p.const },
+    Boolean = { fg = p.const },
+    Float = { fg = p.const },
 
-    Statement = { fg = p.sacred }, -- Purple (Keywords)
-    Conditional = { fg = p.sacred },
-    Repeat = { fg = p.sacred },
-    Label = { fg = p.sacred },
-    Operator = { fg = p.tech }, -- Cyan (Tech)
-    Keyword = { fg = p.sacred },
-    Exception = { fg = p.razor }, -- Red (Errors)
+    Identifier = { fg = p.text }, -- Variables (calm body)
+    Property = { fg = p.prop }, -- Fields / properties (dim body)
+    Function = { fg = p.action }, -- Cyan — actions
+    Builtin = { fg = p.builtin, italic = true }, -- Cyan dim — self / builtin
 
-    PreProc = { fg = p.sacred },
-    Include = { fg = p.sacred },
-    Define = { fg = p.sacred },
-    Macro = { fg = p.sacred },
-    PreCondit = { fg = p.sacred },
+    Statement = { fg = p.flow, bold = true }, -- Bright-blue — control flow
+    Conditional = { fg = p.flow, bold = true },
+    Repeat = { fg = p.flow, bold = true },
+    Label = { fg = p.flow },
+    Operator = { fg = p.op }, -- Neutral
+    Keyword = { fg = p.storage }, -- Blue — storage / modifier
+    Exception = { fg = p.flow, bold = true }, -- Control flow (NOT danger — never red in code)
 
-    Type = { fg = p.amber }, -- Yellow (Types/Classes)
-    StorageClass = { fg = p.amber },
-    Structure = { fg = p.amber },
-    Typedef = { fg = p.amber },
+    PreProc = { fg = p.action }, -- Cyan — preprocessor / macro ceremony
+    Include = { fg = p.storage }, -- Blue — declarative (use / import)
+    Define = { fg = p.action },
+    Macro = { fg = p.action, italic = true }, -- Cyan — bang-macros (action + ceremony)
+    PreCondit = { fg = p.action },
 
-    Special = { fg = p.tech },
-    SpecialChar = { fg = p.tech },
-    Tag = { fg = p.tech },
-    Delimiter = { fg = p.dim }, -- Subtle delimiters
-    Debug = { fg = p.razor },
+    Type = { fg = p.kind }, -- Blue — kinds
+    StorageClass = { fg = p.storage, bold = true }, -- Blue heavy
+    Structure = { fg = p.kind },
+    Typedef = { fg = p.kind },
+    Attribute = { fg = p.storage, italic = true }, -- Blue declarative — #[derive], decorators
 
-    Underlined = { underline = true },
+    Special = { fg = p.escape }, -- Green — special tokens (escapes-adjacent)
+    SpecialChar = { fg = p.escape }, -- Green bright — string escapes / regex
+    Tag = { fg = p.kind }, -- Blue — structural HTML/XML tags
+    Delimiter = { fg = p.punct }, -- Neutral, lifted
+    Debug = { fg = p.special },
+
+    Underlined = { fg = p.info, underline = true },
     Ignore = { fg = p.stealth },
-    Error = { fg = p.razor },
-    Todo = { fg = p.void, bg = p.amber, bold = true },
+    Error = { fg = p.danger },
+    Todo = { fg = p.void, bg = p.warn, bold = true },
+    Title = { fg = p.info, bold = true },
+
+    MatchParen = { fg = p.focus_active, bold = true }, -- Attention — matched pair (violet)
+    Whitespace = { fg = p.border },
+    NonText = { fg = p.border },
+    SpecialKey = { fg = p.border },
+    SpellBad = { sp = p.danger, undercurl = true },
+    SpellCap = { sp = p.warn, undercurl = true },
+    SpellRare = { sp = p.info, undercurl = true },
+    SpellLocal = { sp = p.dim, undercurl = true },
+    LspReferenceText = { bg = p.panel },
+    LspReferenceRead = { bg = p.panel },
+    LspReferenceWrite = { bg = p.panel, bold = true },
+    LspSignatureActiveParameter = { fg = p.void, bg = p.info, bold = true },
+    LspInlayHint = { fg = p.dim, bg = p.panel },
+    LspCodeLens = { fg = p.dim },
+    LspCodeLensSeparator = { fg = p.stealth },
+    LspInfoBorder = { fg = p.border, bg = p.panel },
+    LspInfoTitle = { fg = p.dim, bg = p.panel },
 
     -- DIAGNOSTICS -----------------------------------------------------------
-    DiagnosticError = { fg = p.razor },
-    DiagnosticWarn = { fg = p.amber },
-    DiagnosticInfo = { fg = p.tech },
+    DiagnosticError = { fg = p.danger },
+    DiagnosticWarn = { fg = p.warn },
+    DiagnosticInfo = { fg = p.info },
     DiagnosticHint = { fg = p.dim },
+    DiagnosticOk = { fg = p.ok },
+    DiagnosticDeprecated = { fg = p.dim, strikethrough = true },
+    DiagnosticUnnecessary = { fg = p.dim },
 
-    DiagnosticUnderlineError = { sp = p.razor, underline = true },
-    DiagnosticUnderlineWarn = { sp = p.amber, underline = true },
+    DiagnosticUnderlineError = { undercurl = true, sp = p.danger },
+    DiagnosticUnderlineWarn = { undercurl = true, sp = p.warn },
+    DiagnosticUnderlineInfo = { undercurl = true, sp = p.info },
+    DiagnosticUnderlineHint = { undercurl = true, sp = p.dim },
+    DiagnosticUnderlineOk = { undercurl = true, sp = p.ok },
+    DiagnosticVirtualTextError = { fg = p.danger, bg = p.panel },
+    DiagnosticVirtualTextWarn = { fg = p.warn, bg = p.panel },
+    DiagnosticVirtualTextInfo = { fg = p.info, bg = p.panel },
+    DiagnosticVirtualTextHint = { fg = p.dim, bg = p.panel },
+    DiagnosticVirtualTextOk = { fg = p.ok, bg = p.panel },
+