keys.toml

# The theme-key registry — the one hand-edited source for every Atlas theme key,
# and for how every shadcn base token a theme leaves out is derived (ADR-0022).
#
# This file lives in @tryatlas/design (ADR-0027); desktop copies it into
# crates/atlas-theme/ verbatim. Edit it there, never in a copy.
#
# GENERATED FROM THIS FILE in the package (never edit those by hand; run
# `bun run theme`):
#
#   src/theme/theme-key-registry.ts   the TS registry the resolver reads
#   theme-rules/theme-keys.txt        the key list + descriptions Rust reads
#   theme-rules/base-rules.txt        the `[[base]]` rules, which Rust's
#                                     interpreter runs for import and export
#   src/styles/themes.css             every built-in theme, resolved
#
# Desktop generates the rest from its copy: the JSON Schema's `keys` property
# (so `#:schema` gives authors completion) and the table in
# docs/reference/theme-keys.md.
#
# `bun run theme:check` (and `bun run test`) fail when any of them is stale.
#
# ── An entry ──────────────────────────────────────────────────────────────────
#
#   name         the dotted role name an author writes under `[dark.keys]`.
#   group        heading this key sits under in the generated outputs. Keys of a
#                group must be contiguous.
#   description  one line, what this key colours. Shown on hover in a TOML editor.
#   palette      first derivation source: one of the eight palette hues.
#   base         second derivation source: a shadcn base token.
#   op/amount    the transform applied to whichever source was chosen. Omit for a
#                plain alias.
#   dark/light   the Atlas default for each appearance, used when a theme sets
#                neither the key nor any source it derives from.
#   note         optional prose, carried into the generated TS as a comment.
#
# Resolution order, implemented once in `resolve-theme.ts`: an explicit `keys`
# value in the theme wins; then `palette`; then `base`; then the appearance
# default. `op` is applied to whichever of those three was used — never to an
# explicit value, which is taken exactly as written.
#
# ── The operation vocabulary (closed; adding one means editing the resolver) ──
#
#   alpha              replace the colour's alpha channel with `amount`.
#   toward_background  mix `amount` of `base.background` into the colour. Keeps a
#                      muted role muted on a light theme, where lightening would
#                      wash it out.
#   toward_foreground  mix `amount` of `base.foreground` into the colour — the
#                      mirror of the above. This is what "a stronger version of
#                      this colour" means in BOTH appearances: on a dark variant
#                      the foreground is pale so it lightens, on a light variant
#                      it is dark so it darkens. Reach for this, not `lighten`.
#   readable           whichever of `base.foreground` and `base.background` has
#                      the higher WCAG contrast against the colour: the text for
#                      a filled surface (`primary-foreground` on a pale primary
#                      in a dark theme is the dark background). Takes no amount.
#   lighten            mix `amount` of literal white into the colour. Appearance
#                      BLIND, so it is only correct where "paler" is the literal
#                      intent whatever the background — which, after the light
#                      pass, is one key (`terminal.ansi.bright_white`). A hover
#                      or a bright ANSI slot used to use it and went PALER on a
#                      light theme, i.e. away from the reader.
#
# Every mix is in OKLab (`color.ts`, `color.rs`), so it moves lightness evenly
# and keeps the hue.
#
# Deleting a key, renaming one, or changing what it derives from is an edit to
# this file and nothing else.
#
# ── `[[derived]]`: a colour Atlas writes but no theme may set ─────────────────
#
# Some `--atlas-…` variables the app reads are not judgement calls. A status
# BADGE fill is its status FOREGROUND at 12% — an author who wants a different
# green wants a different green, not two greens that must be kept in step. So
# those live here instead of as keys: Atlas resolves them to exactly the value
# a key would have produced, and they are absent from `theme-keys.txt` and from
# the JSON Schema, so writing one in a theme file is an unknown-key warning.
#
#   name/description  as for a key.
#   from              the settable key this transforms, OR
#   base              the shadcn base token it transforms. Exactly one of the two.
#   op/amount         required — a derived variable with no transform would be
#                     an alias, and an alias should just be the key itself.
#
# Reach for this when a colour is a FUNCTION of a key. Anything a theme author
# would genuinely want to set independently is a key, however small.
#
# ── `[[base]]`: how a shadcn base token a theme leaves out is derived ────────
#
# No base token is required (ADR-0022). `background`, `foreground` and
# `primary` are the seeds; everything else follows from them by the rules
# below, which use the same fields and the same resolution order as a key —
# an explicit value wins, then `palette`, then `base`, then the default — with
# `base` naming another base token. Rules are in `BASE_TOKENS` order, and a
# rule's `base` must be an earlier rule, so one pass resolves them all.
# `dark`/`light` are required only where nothing else can answer.
#
# A built-in or imported theme pins its values, so a change here moves only
# the themes that left a token out. The amounts were fitted, in OKLab, to the
# median of the fifteen built-in themes' hand-written values.

version = 1


# ── Base tokens ───────────────────────────────────────────────────────────────

[[base]]
name = "background"
description = "The app's ground. A seed."
dark = "#000000"
light = "#ffffff"

[[base]]
name = "foreground"
description = "Body text. A seed; left out, the ink that reads on the background."
base = "background"
op = "readable"

[[base]]
name = "card"
description = "Raised surfaces: cards, composer, tiles."
base = "background"
op = "toward_foreground"
amount = 0.05

[[base]]
name = "card-foreground"
description = "Text on a card."
base = "foreground"

[[base]]
name = "popover"
description = "Menus, popovers, tooltips."
base = "background"
op = "toward_foreground"
amount = 0.12

[[base]]
name = "popover-foreground"
description = "Text in a popover."
base = "foreground"

[[base]]
name = "primary"
description = "Brand colour for buttons, focus and selection. A seed; monochrome if unset."
base = "foreground"

[[base]]
name = "primary-foreground"
description = "Text on a primary fill."
base = "primary"
op = "readable"

[[base]]
name = "secondary"
description = "Secondary button fill."
base = "background"
op = "toward_foreground"
amount = 0.05

[[base]]
name = "secondary-foreground"
description = "Secondary text and secondary button labels."
base = "foreground"
op = "toward_background"
amount = 0.28

[[base]]
name = "muted"
description = "Quiet fills: wells, inactive tracks."
base = "background"
op = "toward_foreground"
amount = 0.05

[[base]]
name = "muted-foreground"
description = "Hints, captions, placeholders."
base = "foreground"
op = "toward_background"
amount = 0.32

[[base]]
name = "accent"
description = "Hover and selected rows (shadcn's meaning, not the brand colour)."
base = "muted"

[[base]]
name = "accent-foreground"
description = "Text on an accent row."
base = "foreground"

[[base]]
name = "destructive"
description = "Destructive actions and errors."
palette = "red"
dark = "#f44747"
light = "#c62828"

[[base]]
name = "destructive-foreground"
description = "Text on a destructive fill."
base = "destructive"
op = "readable"

[[base]]
name = "border"
description = "Separators and outlines."
base = "background"
op = "toward_foreground"
amount = 0.16

[[base]]
name = "input"
description = "Input outlines."
base = "border"

[[base]]
name = "ring"
description = "Focus rings."
base = "primary"

[[base]]
name = "chart-1"
description = "The first chart series: the theme's ink."
base = "primary"

[[base]]
name = "chart-2"
description = "Chart series 2."
palette = "green"
dark = "#9ecf8a"
light = "#3f7f2f"

[[base]]
name = "chart-3"
description = "Chart series 3."
palette = "yellow"
dark = "#e0b070"
light = "#b06000"

[[base]]
name = "chart-4"
description = "Chart series 4."
palette = "purple"
dark = "#c9a2f5"
light = "#7b3fb5"

[[base]]
name = "chart-5"
description = "Chart series 5."
palette = "cyan"
dark = "#7fd1e8"
light = "#1f7f99"

[[base]]
name = "sidebar"
description = "The sidebars' ground."
base = "background"

[[base]]
name = "sidebar-foreground"
description = "Sidebar text."
base = "foreground"

[[base]]
name = "sidebar-primary"
description = "Primary fills in a sidebar."
base = "primary"

[[base]]
name = "sidebar-primary-foreground"
description = "Text on a sidebar primary fill."
base = "primary-foreground"

[[base]]
name = "sidebar-accent"
description = "Hover and selected rows in a sidebar."
base = "accent"

[[base]]
name = "sidebar-accent-foreground"
description = "Text on a sidebar accent row."
base = "accent-foreground"

[[base]]
name = "sidebar-border"
description = "Sidebar separators, quieter than `border`."
base = "background"
op = "toward_foreground"
amount = 0.08

[[base]]
name = "sidebar-ring"
description = "Focus rings in a sidebar."
base = "ring"

[[base]]
name = "radius"
description = "Corner radius."
dark = "8px"

[[base]]
name = "tracking-normal"
description = "Letter spacing."
dark = "0em"

[[base]]
name = "spacing"
description = "The spacing unit."
dark = "0.25rem"

[[base]]
name = "shadow-2xs"
description = "Shadow ramp."
dark = "0 1px 2px rgba(0, 0, 0, 0.35)"
light = "0 1px 2px rgba(0, 0, 0, 0.04)"

[[base]]
name = "shadow-xs"
description = "Shadow ramp."
dark = "0 1px 2px rgba(0, 0, 0, 0.45)"
light = "0 1px 2px rgba(0, 0, 0, 0.06)"

[[base]]
name = "shadow-sm"
description = "Shadow ramp."
dark = "0 1px 3px rgba(0, 0, 0, 0.55)"
light = "0 1px 3px rgba(0, 0, 0, 0.08)"

[[base]]
name = "shadow-md"
description = "Shadow ramp."
dark = "0 4px 12px rgba(0, 0, 0, 0.65)"
light = "0 4px 12px rgba(0, 0, 0, 0.11)"

[[base]]
name = "shadow-lg"
description = "Shadow ramp."
dark = "0 8px 24px rgba(0, 0, 0, 0.75)"
light = "0 8px 24px rgba(0, 0, 0, 0.14)"

[[base]]
name = "shadow-xl"
description = "Shadow ramp."
dark = "0 12px 36px rgba(0, 0, 0, 0.82)"
light = "0 12px 36px rgba(0, 0, 0, 0.18)"

[[base]]
name = "shadow-2xl"
description = "Shadow ramp."
dark = "0 16px 48px rgba(0, 0, 0, 0.9)"
light = "0 16px 48px rgba(0, 0, 0, 0.22)"


# The groups, in order. Every key names one, and a group's keys are contiguous.
[[group]]
name = "Borders"
description = "Separators and control outlines."

[[group]]
name = "Elements and overlays"
description = "Hover/selected/pressed overlays, the raised edge, and the brand fills."

[[group]]
name = "Text"
description = "Prose roles that are not a base token."

[[group]]
name = "Status"
description = "Success / warning / error / info."

[[group]]
name = "Selection"
description = "Document text selection."

[[group]]
name = "Terminal"
description = "The PTY surface and the 16 ANSI colours."

[[group]]
name = "Syntax"
description = "CodeMirror and Markdown highlighting."

[[group]]
name = "Editor"
description = "The code editor's own chrome."

[[group]]
name = "Search"
description = "In-document search matches."

[[group]]
name = "Chrome surfaces"
description = "Scrollbars and panel surfaces — the app frame."

[[group]]
name = "Diff"
description = "Added and removed regions, inline and side-by-side."

[[group]]
name = "Agents and indicators"
description = "The agent identity chip."

[[group]]
name = "Identity hues"
description = "The eight hues that name a thing — a label, a project dot — never a status."


# ── Borders ───────────────────────────────────────────────────────────────────

[[key]]
name = "border.subtle"
group = "Borders"
description = "Low-emphasis separator."
base = "sidebar-border"
dark = "#141414"
light = "#ebe5de"

[[key]]
name = "border.strong"
group = "Borders"
description = "High-emphasis border, including a focused control's."
base = "border"
dark = "#3d3d3d"
light = "#b8b1aa"
note = """
Sourced from `border`, not `ring`. It used to be `ring`, and decision 31 then
made `ring` a real accent — so a theme that set `ring` and left this alone got
a brand-coloured hairline everywhere it wanted a strong grey one. The two roles
are genuinely different: `ring` is the focus RING, this is the strongest
BORDER, and a focused control's border is this rather than a third key.
"""


# ── Elements and overlays ─────────────────────────────────────────────────────

[[key]]
name = "element.hover"
group = "Elements and overlays"
description = "Hover overlay for ordinary elements."
base = "foreground"
op = "alpha"
amount = 0.04
dark = "rgba(255,255,255,0.04)"
light = "rgba(0,0,0,0.04)"

[[key]]
name = "element.selected"
group = "Elements and overlays"
description = "Selected overlay for ordinary elements."
base = "foreground"
op = "alpha"
amount = 0.06
dark = "rgba(255,255,255,0.06)"
light = "rgba(0,0,0,0.06)"

[[key]]
name = "element.active"
group = "Elements and overlays"
description = "Pressed overlay for ordinary elements."
base = "foreground"
op = "alpha"
amount = 0.08
dark = "rgba(255,255,255,0.08)"
light = "rgba(0,0,0,0.08)"

[[key]]
name = "element.highlight"
group = "Elements and overlays"
description = "Top-edge highlight on a raised surface."
base = "foreground"
op = "alpha"
amount = 0.06
dark = "rgba(255,255,255,0.06)"
light = "rgba(0,0,0,0.06)"
note = """
The 1px top edge on raised glass — `inset-highlight` in globals.css. It is
the theme's own foreground at 6%, so a light variant gets a dark edge
instead of the white-on-white one a hardcoded highlight would give it.
"""

[[key]]
name = "primary.hover"
group = "Elements and overlays"
description = "Hovered primary-brand fill."
base = "primary"
op = "toward_foreground"
amount = 0.15
dark = "#cccccc"
light = "#8875a1"

[[key]]
name = "primary.muted"
group = "Elements and overlays"
description = "Muted primary-brand fill."
base = "primary"
op = "alpha"
amount = 0.06
dark = "rgba(255,255,255,0.06)"
light = "rgba(144,122,169,0.08)"


# ── Text ──────────────────────────────────────────────────────────────────────

[[key]]
name = "text.disabled"
group = "Text"
description = "Disabled and unavailable text."
note = """
A small step below `muted-foreground`, not a large one. Every built-in used to
set this key explicitly to a SURFACE colour — an early mapping put a background role
onto a text role — which rendered disabled text and comms timestamps at 1.06:1
to 1.66:1 against their own background, i.e. invisible. With the explicit values
gone and a 0.2 mix (OKLab since ADR-0022), the 28 shipped variants land between
1.99:1 and 4.40:1 (median 3.10) where `muted-foreground` itself has a median of
4.37:1. A larger mix reaches 1.48:1 at the bottom of that range and is what the
old 0.35 did.

The fraction is deliberately ONE value for every theme. The ratio of this key's
contrast to `muted-foreground`'s is near-constant across the fleet (~0.82), so a
variant that lands low here lands low because its own `muted-foreground` is low,
not because the mix is wrong — at a 0.0 mix the three worst still sat at 2.05,
2.15 and 2.21. Varying the fraction per theme would buy almost nothing and cost
the one property that makes a derived key predictable to an author: one key, one
rule. Where the low reading WAS Atlas's to fix — `phosphor`, `chyral` and
`mirage`, Atlas's own designs — it was fixed upstream at `muted-foreground`
instead, which also lifts `syntax.comment`, `editor.gutter.foreground` and
`terminal.ansi.bright_black` in the same themes. The remaining floor (`one-dark`
at 1.98:1) comes from a palette Atlas did not author, and restating someone else's
secondary text colour is exactly what a theme key must not do.
"""
base = "muted-foreground"
op = "toward_background"
amount = 0.2
dark = "#4a4a4a"
light = "#a39d96"


# ── Status ────────────────────────────────────────────────────────────────────

[[key]]
name = "status.success.foreground"
group = "Status"
description = "Success status foreground, and the live-capture indicator."
palette = "green"
dark = "#3fb950"
light = "#286983"

[[key]]
name = "status.warning.foreground"
group = "Status"
description = "Warning status foreground."
palette = "yellow"
dark = "#cd9731"
light = "#ea9d34"

[[key]]
name = "status.error.foreground"
group = "Status"
description = "Error status foreground."
palette = "red"
base = "destructive"
dark = "#f44747"
light = "#b4637a"

[[key]]
name = "status.info.foreground"
group = "Status"
description = "Informational status foreground."
palette = "blue"
dark = "#6796e6"
light = "#56949f"


# ── Selection ─────────────────────────────────────────────────────────────────

[[key]]
name = "selection.background"
group = "Selection"
description = "Document text selection."
base = "primary"
op = "alpha"
amount = 0.18
dark = "rgba(255,255,255,0.18)"
light = "rgba(144,122,169,0.18)"


# ── Terminal ──────────────────────────────────────────────────────────────────

[[key]]
name = "terminal.foreground"
group = "Terminal"
description = "Terminal default foreground."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "terminal.background"
group = "Terminal"
description = "Terminal background."
base = "background"
dark = "#000000"
light = "#faf4ed"

[[key]]
name = "terminal.cursor"
group = "Terminal"
description = "Terminal cursor."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "terminal.ansi.black"
group = "Terminal"
description = "ANSI black."
base = "background"
op = "toward_foreground"
amount = 0.12
dark = "#1e1e1e"
light = "#575279"

[[key]]
name = "terminal.ansi.red"
group = "Terminal"
description = "ANSI red."
palette = "red"
dark = "#f44747"
light = "#b4637a"

[[key]]
name = "terminal.ansi.green"
group = "Terminal"
description = "ANSI green."
palette = "green"
dark = "#98c379"
light = "#286983"

[[key]]
name = "terminal.ansi.yellow"
group = "Terminal"
description = "ANSI yellow."
palette = "yellow"
dark = "#e5c07b"
light = "#ea9d34"

[[key]]
name = "terminal.ansi.blue"
group = "Terminal"
description = "ANSI blue."
palette = "blue"
dark = "#61afef"
light = "#56949f"

[[key]]
name = "terminal.ansi.magenta"
group = "Terminal"
description = "ANSI magenta."
palette = "purple"
dark = "#c678dd"
light = "#907aa9"

[[key]]
name = "terminal.ansi.cyan"
group = "Terminal"
description = "ANSI cyan."
palette = "cyan"
dark = "#56b6c2"
light = "#56949f"

[[key]]
name = "terminal.ansi.white"
group = "Terminal"
description = "ANSI white."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "terminal.ansi.bright_black"
group = "Terminal"
description = "ANSI bright black."
base = "muted-foreground"
dark = "#666666"
light = "#9893a5"

[[key]]
name = "terminal.ansi.bright_red"
group = "Terminal"
description = "ANSI bright red."
palette = "red"
op = "toward_foreground"
amount = 0.15
dark = "#ff6b6b"
light = "#c97991"

[[key]]
name = "terminal.ansi.bright_green"
group = "Terminal"
description = "ANSI bright green."
palette = "green"
op = "toward_foreground"
amount = 0.15
dark = "#b2d89a"
light = "#4d8399"

[[key]]
name = "terminal.ansi.bright_yellow"
group = "Terminal"
description = "ANSI bright yellow."
palette = "yellow"
op = "toward_foreground"
amount = 0.15
dark = "#f2d28c"
light = "#edae52"

[[key]]
name = "terminal.ansi.bright_blue"
group = "Terminal"
description = "ANSI bright blue."
palette = "blue"
op = "toward_foreground"
amount = 0.15
dark = "#82c0f3"
light = "#73a5ae"

[[key]]
name = "terminal.ansi.bright_magenta"
group = "Terminal"
description = "ANSI bright magenta."
palette = "purple"
op = "toward_foreground"
amount = 0.15
dark = "#d493e5"
light = "#a290b5"

[[key]]
name = "terminal.ansi.bright_cyan"
group = "Terminal"
description = "ANSI bright cyan."
palette = "cyan"
op = "toward_foreground"
amount = 0.15
dark = "#78c7d0"
light = "#73a5ae"

[[key]]
name = "terminal.ansi.bright_white"
group = "Terminal"
description = "ANSI bright white."
base = "foreground"
op = "lighten"
amount = 0.18
dark = "#ffffff"
light = "#464261"


# ── Syntax ────────────────────────────────────────────────────────────────────
#
# Every `dark`/`light` here is Pierre's colour for that role (@pierre/theme, the
# Atlas theme's syntax), written by `bun run theme:pierre`. Edit them there.

[[key]]
name = "syntax.comment"
group = "Syntax"
description = "Comments and prose quotes."
base = "muted-foreground"
dark = "#737373"
light = "#737373"

[[key]]
name = "syntax.keyword"
group = "Syntax"
description = "Keywords and control flow."
palette = "purple"
dark = "#ff678d"
light = "#d32a61"

[[key]]
name = "syntax.string"
group = "Syntax"
description = "Strings."
palette = "green"
dark = "#5ecc71"
light = "#199f43"

[[key]]
name = "syntax.number"
group = "Syntax"
description = "Numbers."
palette = "orange"
dark = "#68cdf2"
light = "#1ca1c7"

[[key]]
name = "syntax.type"
group = "Syntax"
description = "Types, classes, and namespaces."
palette = "cyan"
dark = "#d568ea"
light = "#a631be"

[[key]]
name = "syntax.function"
group = "Syntax"
description = "Functions and headings."
palette = "blue"
base = "primary"
dark = "#9d6afb"
light = "#693acf"

[[key]]
name = "syntax.variable"
group = "Syntax"
description = "Variables."
base = "foreground"
dark = "#a3a3a3"
light = "#636363"

[[key]]
name = "syntax.operator"
group = "Syntax"
description = "Operators."
palette = "cyan"
dark = "#636363"
light = "#636363"

[[key]]
name = "syntax.tag"
group = "Syntax"
description = "Markup tags."
palette = "red"
dark = "#ff855e"
light = "#d5512f"

[[key]]
name = "syntax.attribute"
group = "Syntax"
description = "Markup attributes."
palette = "yellow"
dark = "#60d199"
light = "#18a46c"

[[key]]
name = "syntax.constant"
group = "Syntax"
description = "Constants and atoms."
palette = "orange"
dark = "#08c0ef"
light = "#08c0ef"

[[key]]
name = "syntax.regexp"
group = "Syntax"
description = "Regular expressions."
palette = "red"
dark = "#64d1db"
light = "#17a5af"

[[key]]
name = "syntax.escape"
group = "Syntax"
description = "Escape sequences."
palette = "pink"
dark = "#61d5c0"
light = "#16a994"

[[key]]
name = "syntax.definition"
group = "Syntax"
description = "Definitions and strong prose."
base = "foreground"
dark = "#9d6afb"
light = "#693acf"

[[key]]
name = "syntax.property"
group = "Syntax"
description = "Properties and object keys."
palette = "cyan"
dark = "#ffa359"
light = "#d47628"


# ── Editor ────────────────────────────────────────────────────────────────────

[[key]]
name = "editor.background"
group = "Editor"
description = "Code editor background."
base = "background"
dark = "#000000"
light = "#faf4ed"

[[key]]
name = "editor.foreground"
group = "Editor"
description = "Code editor foreground."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "editor.caret"
group = "Editor"
description = "Code editor caret."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "editor.gutter.background"
group = "Editor"
description = "Code editor gutter background."
base = "background"
dark = "#000000"
light = "#faf4ed"

[[key]]
name = "editor.gutter.foreground"
group = "Editor"
description = "Code editor line numbers."
base = "muted-foreground"
dark = "#666666"
light = "#9893a5"

[[key]]
name = "editor.active_line.background"
group = "Editor"
description = "Active editor line."
base = "foreground"
op = "alpha"
amount = 0.04
dark = "rgba(255,255,255,0.04)"
light = "rgba(0,0,0,0.04)"

[[key]]
name = "editor.active_line.gutter_foreground"
group = "Editor"
description = "Active line number."
base = "foreground"
dark = "#d4d4d4"
light = "#575279"

[[key]]
name = "editor.selection.background"
group = "Editor"
description = "Editor selection."
base = "primary"
op = "alpha"
amount = 0.24
dark = "#303030"
light = "#dfdad9"

[[key]]
name = "editor.match_bracket.background"
group = "Editor"
description = "Matching bracket background."
base = "accent"
dark = "#2d2d2d"
light = "#dfdad9"

[[key]]
name = "editor.match_bracket.border"
group = "Editor"
description = "Matching bracket outline."
base = "ring"
dark = "#3d3d3d"
light = "#907aa9"


# ── Search ────────────────────────────────────────────────────────────────────

[[key]]
name = "search.match.background"
group = "Search"
description = "A search match in the document."
palette = "yellow"
op = "alpha"
amount = 0.22
dark = "rgba(229,192,123,0.22)"
light = "rgba(234,157,52,0.22)"
note = """
The editor's find panel painted its matches `rgba(249,115,22,…)` with an
`!important`, which is to say one fixed orange regardless of the theme — legible
on nothing in particular and unreadable on a light background. A search hit is
the one highlight a reader has to find instantly, so it earns a key rather than
a reuse of the selection colour, which is already on screen elsewhere.
"""

[[key]]
name = "search.match.active_background"
group = "Search"
description = "The match the cursor is on."
palette = "yellow"
op = "alpha"
amount = 0.5
dark = "rgba(229,192,123,0.5)"
light = "rgba(234,157,52,0.5)"


# ── Chrome surfaces ───────────────────────────────────────────────────────────

[[key]]
name = "scrollbar.thumb.background"
group = "Chrome surfaces"
description = "Scrollbar thumb."
base = "foreground"
op = "alpha"
amount = 0.16
dark = "rgba(255,255,255,0.16)"
light = "rgba(0,0,0,0.16)"

[[key]]
name = "scrollbar.thumb.hover"
group = "Chrome surfaces"
description = "Hovered scrollbar thumb."
base = "foreground"
op = "alpha"
amount = 0.26
dark = "rgba(255,255,255,0.26)"
light = "rgba(0,0,0,0.26)"

[[key]]
name = "panel.background"
group = "Chrome surfaces"
description = "Panel background."
base = "sidebar"
dark = "#060706"
light = "#fffaf3"

[[key]]
name = "panel.input.background"
group = "Chrome surfaces"
description = "Panel input background."
base = "background"
dark = "#0a0a0a"
light = "#fffaf3"


# ── Diff ──────────────────────────────────────────────────────────────────────

[[key]]
name = "diff.added.background"
group = "Diff"
description = "Added line or hunk."
palette = "green"
op = "alpha"
amount = 0.13
dark = "#0d2211"
light = "rgba(40,105,131,0.13)"

[[key]]
name = "diff.added.emphasis"
group = "Diff"
description = "Changed words inside an added line."
palette = "green"
op = "alpha"
amount = 0.34
dark = "rgba(52,211,153,0.34)"
light = "rgba(40,105,131,0.34)"

[[key]]
name = "diff.added.text"
group = "Diff"
description = "Added diff text, and the +N line statistic."
palette = "green"
dark = "#3fb950"
light = "#286983"

[[key]]
name = "diff.removed.background"
group = "Diff"
description = "Removed line or hunk."
palette = "red"
op = "alpha"
amount = 0.13
dark = "#220d0d"
light = "rgba(180,99,122,0.13)"

[[key]]
name = "diff.removed.emphasis"
group = "Diff"
description = "Changed words inside a removed line."
palette = "red"
op = "alpha"
amount = 0.34
dark = "rgba(244,63,63,0.34)"
light = "rgba(180,99,122,0.34)"

[[key]]
name = "diff.removed.text"
group = "Diff"
description = "Removed diff text, and the -N line statistic."
palette = "red"
dark = "#f85149"
light = "#b4637a"

[[key]]
name = "diff.context.background"
group = "Diff"
description = "Unchanged diff context."
base = "background"
dark = "#0a0a0a"
light = "#faf4ed"


# ── Agents and indicators ─────────────────────────────────────────────────────

[[key]]
name = "agent.chip.foreground"
group = "Agents and indicators"
description = "Agent identity chip text."
base = "foreground"
dark = "#ffffff"
light = "#575279"
note = """
Two keys, not eighteen. There WAS one pair per vendor — and eight of those
named agents that do not exist, while three more were overridden by hardcoded
CSS. ADR-0002 forbids privileging an agent, and the installed set is discovered
at runtime, so a theme author cannot enumerate it in the first place. The
vendors' own brand hues are now plain constants beside `agentMeta()`; this pair
is the neutral chip every identity falls back to, which is what lets a
monochrome theme flatten the lot.
"""

[[key]]
name = "agent.chip.background"
group = "Agents and indicators"
description = "Agent identity chip fill."
base = "foreground"
op = "alpha"
amount = 0.06
dark = "rgba(255,255,255,0.06)"
light = "rgba(0,0,0,0.06)"


# ── Identity hues ─────────────────────────────────────────────────────────────
#
# The `--color-hue-*` utilities (`bg-hue-orange`, `Tag`, `HueDot`) read these.
# They used to borrow other roles — orange was `syntax.number`, pink was
# `syntax.escape`, the rest the ANSI slots — and a theme that coloured those
# roles for code (Atlas's own syntax is Pierre's, where numbers are cyan) turned
# an "orange" label cyan. A hue now reads the theme's own palette hue of the same
# name, so it is whatever that theme means by orange, and a theme that wants a
# different chip colour from its palette sets the key. The defaults, for a
# theme that writes no palette, are the Atlas theme's chips: its palette,
# except dark yellow, where the palette has a terminal's pure #ffff00 and the
# Atlas theme pins a label yellow (see themes/atlas.toml).

[[key]]
name = "hue.red"
group = "Identity hues"
description = "The red identity hue: labels, project dots, meters."
palette = "red"
dark = "#f44747"
light = "#c62828"

[[key]]
name = "hue.orange"
group = "Identity hues"
description = "The orange identity hue: labels, project dots, meters."
palette = "orange"
dark = "#e0b070"
light = "#b06000"

[[key]]
name = "hue.yellow"
group = "Identity hues"
description = "The yellow identity hue: labels, project dots, meters."
palette = "yellow"
dark = "#e0ca66"
light = "#8f7a00"

[[key]]
name = "hue.green"
group = "Identity hues"
description = "The green identity hue: labels, project dots, meters."
palette = "green"
dark = "#9ecf8a"
light = "#3f7f2f"

[[key]]
name = "hue.cyan"
group = "Identity hues"
description = "The cyan identity hue: labels, project dots, meters."
palette = "cyan"
dark = "#7fd1e8"
light = "#1f7f99"

[[key]]
name = "hue.blue"
group = "Identity hues"
description = "The blue identity hue: labels, project dots, meters."
palette = "blue"
dark = "#6796e6"
light = "#1f5fb0"

[[key]]
name = "hue.purple"
group = "Identity hues"
description = "The purple identity hue: labels, project dots, meters."
palette = "purple"
dark = "#c9a2f5"
light = "#7b3fb5"

[[key]]
name = "hue.pink"
group = "Identity hues"
description = "The pink identity hue: labels, project dots, meters."
palette = "pink"
dark = "#f0a0c8"
light = "#b03a6a"


# ── Derived variables ─────────────────────────────────────────────────────────
#
# Not theme keys. See the header for what belongs here.

[[derived]]
name = "status.success.background"
description = "Tinted fill behind a success foreground."
from = "status.success.foreground"
op = "alpha"
amount = 0.12

[[derived]]
name = "status.warning.background"
description = "Tinted fill behind a warning foreground."
from = "status.warning.foreground"
op = "alpha"
amount = 0.12

[[derived]]
name = "status.error.background"
description = "Tinted fill behind an error foreground."
from = "status.error.foreground"
op = "alpha"
amount = 0.12

[[derived]]
name = "status.info.background"
description = "Tinted fill behind an informational foreground."
from = "status.info.foreground"
op = "alpha"
amount = 0.12

[[derived]]
name = "element.emphasis"
description = "The strongest neutral overlay — a chat mention addressed to you."
base = "foreground"
op = "alpha"
amount = 0.16

[[derived]]
name = "terminal.selection"
description = "Terminal selection."
base = "primary"
op = "alpha"
amount = 0.3