Tokens — core primitives

src/tokens/core.rs. The bottom layer: raw const values with no semantic meaning. The semantic layer maps meaning onto these; nothing here references anything else. Every value was decided interactively, value-by-value, against shadcn.

Design rule: atoms never read a raw hex. They read either a core::* primitive (for structural values like spacing/radius) or a Theme field (for colors). The no_raw_values guard enforces it.

Color ramps

Neutral base — Zinc (cool-neutral)

The temperature of every gray surface/border/text token. Tailwind/shadcn zinc, 50→950.

Brand — Ouroboros turquoise (Teal)

The primary hue: buttons, progress/slider fill, switch-on, focus ring, selection. Kept light (300/400 in dark) per brand. The zinc ramp is left untouched, so a pure-zinc theme stays available (see Theme::zinc_dark).

Status hues — Tailwind 500

The semantic layer composites the soft *_bg variants by applying ~15% alpha (STATUS_BG_ALPHA = 38) to these.

Spacing — 4px base

Tailwind numeric keys (key N = N × 4px). Contiguous 1–6, then 8/10/12 for larger gaps. Used for padding, gaps, margins.

SPACE_0 is the semantic “no gap / no padding” sentinel (tight tables, full-bleed).

Corner radius

shadcn classic base (0.5rem). FULL is the pill/circle sentinel.

RADIUS_NONE is the “square corners” sentinel (full-bleed rows, flush panels).

Shadows

Dark-tuned (high alpha to read on the zinc background).

shadow(offset, blur, spread, color) is a const fn builder for elevations beyond the fixed triple (egui’s Shadow is foreign, hence a free fn not an inherent constructor).

Typography primitives

Raw values only — the typography layer composes these into named styles.

Type sizes (px) — dense IDE calibration; body anchors at TEXT_BASE (14).

Line-height multipliers (× font size): LEADING_TIGHT 1.2 (headings/display), LEADING_NORMAL 1.45 (body), LEADING_RELAXED 1.6 (long-form).

Letter-spacing (px) — scale is inverse to size for legibility (big titles stay NORMAL, smaller text gets wider tracking): TRACKING_TIGHT −0.25, TRACKING_NORMAL 0, TRACKING_SM 0.4, TRACKING_MD 0.6, TRACKING_LG 0.8, TRACKING_WIDE 1.0.

Sizing

Control heights — CONTROL_SM 26 · CONTROL_MD 32 · CONTROL_LG 38. Icon box — ICON_SM 14 · ICON_MD 16 · ICON_LG 20 · ICON_XL 24. Strokes — BORDER_THIN 1 (divider) · BORDER_FOCUS 2 (focus ring) · RING_OFFSET 2 (gap to ring). Hit target — HIT_MIN 32 (minimum interactive size).

Size enum — the shared control scale

One source of truth for every form control’s footprint, so density (compact toolbar vs. roomy panel) is expressible uniformly.

#![allow(unused)]
fn main() {
pub enum Size { Sm, Md /* default */, Lg }
}

¹ defined in theme::typography (keeps core a leaf — see typography.md).

Motion

Animation durations (seconds) + easing curves. egui drives hover/focus transitions by duration (ctx.animate_*); Easing shapes the progress.

Durations — DURATION_INSTANT 0 · DURATION_FAST 0.10 · DURATION_NORMAL 0.18 · DURATION_SLOW 0.30. Delays — DURATION_DELAY_SHORT 0.15 · DURATION_DELAY_LONG 0.50.

Easing enum

#![allow(unused)]
fn main() {
pub enum Easing { Linear, EaseOut /* default */, EaseInOut, Spring, Bounce }
}

Easing::apply(t) maps a normalized progress t ∈ 0..=1 through the curve.

Opacity & overlays

Shared helpers

Two functions every atom uses so state is identical everywhere:

#![allow(unused)]
fn main() {
/// Blend a color to its disabled appearance (alpha × OPACITY_DISABLED).
/// Atoms gate it behind `if !enabled` so the veil is applied exactly once.
pub fn disabled_color(c: Color32) -> Color32

/// Eased hover progress in 0..=1 for a widget — animates `hovered` over
/// DURATION_FAST, shaped by EaseOut. Pass a stable id (e.g. response.id).
pub fn hover_t(ctx: &egui::Context, id: egui::Id, hovered: bool) -> f32
}

These are the reason hover/disabled states look the same across the whole library: the math lives in one place, not copy-pasted into 23 atoms.