Enum Emphasis 

pub enum Emphasis {
    Full,
    Secondary,
    Muted,
}

How far a tonal step sits from the token it is a step of.

The named ratios. tonal is the same operation with the number written out, and this is the small set of steps the vocabulary has agreed on, so a consumer asking for “the muted form of this” names it rather than picking a number and disagreeing with the next consumer to pick one.

The rule these encode, stated as the three-tone convention:

step	what it means
Full	active, emphasised, the thing itself
Secondary	inactive but usable: a control that still answers
Muted	inert: disabled, or not a control at all

Variants

Full

The token unchanged.

Secondary

One step back. Still legible as content, not competing with Full.

Muted

Two steps back. Present, and saying it is not the point.

Implementations

impl Emphasis

pub const fn ratio(self) -> f32

The fraction of the way to the ground this step travels.

Both numbers are the shipped corpus’ own, not invented: across the 31 bundled themes, hand-authored content.secondary sat at a median 0.115 of the way from content.primary to surface.page, and content.muted at 0.424. So the derivation reproduces what theme authors converged on by eye, and the themes that move are the ones that were off the cluster.

pub const fn suffix(self) -> Option<&'static str>

The suffix a derived token takes, or None for the token itself.

content + Muted is content-muted, which is the naming every consumer already spells by hand. Grouping a family this way is what makes danger-muted or action-secondary nameable without a second table saying what they mean.

pub fn token(self, token: &str) -> String

The derived token key for token at this step.

Trait Implementations

impl Clone for Emphasis

fn clone(&self) -> Emphasis

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Emphasis

impl Debug for Emphasis

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Emphasis

impl Hash for Emphasis

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Emphasis

fn eq(&self, other: &Emphasis) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Emphasis