Files
gpui-native-kit/crates/theme/src/typography.rs
T
reya b08516211c Unify theme sizing and spacing on Base UI metrics
- Read only mode, accent, accessibility, and native window material from the OS.
- Replace platform palettes, metrics, type ramps, borders, and elevations with unified tokens.
- Align controls, overlays, and data rows with Base UI sizing.
2026-11-16 18:27:44 +07:00

210 lines
6.2 KiB
Rust

//! One type ladder shared by every platform, scaled by the theme's root font
//! size.
use gpui::{App, FontWeight, Pixels, Styled, px};
use crate::ActiveTheme;
/// The shared ladder at a 16px root: size, line height, then weight.
const LADDER: [Rung; 11] = [
(24.0, 32.0, FontWeight::SEMIBOLD),
(20.0, 28.0, FontWeight::SEMIBOLD),
(18.0, 24.0, FontWeight::SEMIBOLD),
(16.0, 24.0, FontWeight::BOLD),
(14.0, 20.0, FontWeight::BOLD),
(16.0, 24.0, FontWeight::NORMAL),
(14.0, 20.0, FontWeight::NORMAL),
(14.0, 20.0, FontWeight::NORMAL),
(13.0, 18.0, FontWeight::NORMAL),
(12.0, 16.0, FontWeight::NORMAL),
(12.0, 16.0, FontWeight::MEDIUM),
];
/// One rung: size and line height at a 16px root, then the weight.
type Rung = (f32, f32, FontWeight);
/// A role in the unified type ladder.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub enum TextRole {
/// The largest heading — hero panels, greeters, welcome screens.
LargeTitle,
/// Window and page titles.
Title,
/// Section titles.
Title2,
/// Sub-section and dialog headings.
Title3,
/// Body-sized emphasis — list row titles, group labels.
Headline,
/// Control labels and reading text.
Body,
/// Slightly smaller body text.
Callout,
/// Secondary lines under a body row.
Subheadline,
/// Hints and auxiliary notes.
Footnote,
/// Timestamps, badges, and dense metadata.
Caption,
/// Emphasized captions.
Caption2,
}
/// One role as it paints: size, line height, and weight.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct TypeMetrics {
pub size: Pixels,
pub line_height: Pixels,
pub weight: FontWeight,
}
/// The unified type ladder, resolved at the theme's root font size.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct Typography {
pub large_title: TypeMetrics,
pub title: TypeMetrics,
pub title2: TypeMetrics,
pub title3: TypeMetrics,
pub headline: TypeMetrics,
pub body: TypeMetrics,
pub callout: TypeMetrics,
pub subheadline: TypeMetrics,
pub footnote: TypeMetrics,
pub caption: TypeMetrics,
pub caption2: TypeMetrics,
}
impl Typography {
pub(crate) fn resolve(root_font_size: Pixels) -> Self {
let scale = root_font_size / px(16.);
let metrics = |(size, line_height, weight): Rung| TypeMetrics {
size: px(size) * scale,
line_height: px(line_height) * scale,
weight,
};
let [
large_title,
title,
title2,
title3,
headline,
body,
callout,
subheadline,
footnote,
caption,
caption2,
] = LADDER.map(metrics);
Self {
large_title,
title,
title2,
title3,
headline,
body,
callout,
subheadline,
footnote,
caption,
caption2,
}
}
/// The metrics for `role`.
pub fn get(&self, role: TextRole) -> TypeMetrics {
match role {
TextRole::LargeTitle => self.large_title,
TextRole::Title => self.title,
TextRole::Title2 => self.title2,
TextRole::Title3 => self.title3,
TextRole::Headline => self.headline,
TextRole::Body => self.body,
TextRole::Callout => self.callout,
TextRole::Subheadline => self.subheadline,
TextRole::Footnote => self.footnote,
TextRole::Caption => self.caption,
TextRole::Caption2 => self.caption2,
}
}
}
/// Paints a [`TextRole`] from the resolved theme, on anything styled.
pub trait Typeset: Styled + Sized {
/// Sizes, leads, and weights the element as `role`.
fn typeset(self, role: TextRole, cx: &App) -> Self {
let theme = cx.theme();
let metrics = theme.typography.get(role);
self.text_size(metrics.size)
.line_height(metrics.line_height)
.font_weight(metrics.weight)
}
}
impl<E: Styled> Typeset for E {}
#[cfg(test)]
mod tests {
use super::*;
fn typography(root_font_size: f32) -> Typography {
Typography::resolve(px(root_font_size))
}
#[test]
fn the_unified_ladder_matches_the_base_contract() {
let typography = typography(16.0);
let expected = [
(TextRole::LargeTitle, 24.0, 32.0, FontWeight::SEMIBOLD),
(TextRole::Title, 20.0, 28.0, FontWeight::SEMIBOLD),
(TextRole::Title2, 18.0, 24.0, FontWeight::SEMIBOLD),
(TextRole::Title3, 16.0, 24.0, FontWeight::BOLD),
(TextRole::Headline, 14.0, 20.0, FontWeight::BOLD),
(TextRole::Body, 16.0, 24.0, FontWeight::NORMAL),
(TextRole::Callout, 14.0, 20.0, FontWeight::NORMAL),
(TextRole::Subheadline, 14.0, 20.0, FontWeight::NORMAL),
(TextRole::Footnote, 13.0, 18.0, FontWeight::NORMAL),
(TextRole::Caption, 12.0, 16.0, FontWeight::NORMAL),
(TextRole::Caption2, 12.0, 16.0, FontWeight::MEDIUM),
];
for (role, size, line_height, weight) in expected {
assert_eq!(
typography.get(role),
TypeMetrics {
size: px(size),
line_height: px(line_height),
weight,
},
"{role:?}"
);
}
}
#[test]
fn the_ladder_scales_from_a_16px_root() {
let base = typography(16.0);
let raised = typography(20.0);
for role in [
TextRole::LargeTitle,
TextRole::Title,
TextRole::Title2,
TextRole::Title3,
TextRole::Headline,
TextRole::Body,
TextRole::Callout,
TextRole::Subheadline,
TextRole::Footnote,
TextRole::Caption,
TextRole::Caption2,
] {
let base = base.get(role);
let raised = raised.get(role);
assert!((raised.size - base.size * 1.25).abs() < px(0.01));
assert!((raised.line_height - base.line_height * 1.25).abs() < px(0.01));
assert_eq!(raised.weight, base.weight);
}
}
}