Skip to content

BreatheSpec

Defined in: src/anim/breathe.ts:18

“Breathing” — a slow, eased oscillation used to make an indicator feel alive without moving or strobing. Shares the aesthetic of the smooth caret (smoothCaretIntensity): a cosine driven through an in-out ease so the value lingers at both poles with soft transitions between, rather than the mechanical sweep of a raw sine.

This is the engine behind two distinct ideas:

  • Focus (FOCUS_BREATH) — barely-there ambient pulse marking “you are here”. Whisper-quiet by design.
  • Attention (ATTENTION_BREATH) — a deliberate, more pronounced pulse that pulls the eye to a panel asking for a decision (a permission prompt, a Q&A). Louder, faster, but still smooth.

amplitude: number

Defined in: src/anim/breathe.ts:25

Peak blend fraction toward the highlight colour, in [0,1]. The pulse swings between 0 (base colour) and this value — kept small so focus stays subtle.


periodMs: number

Defined in: src/anim/breathe.ts:20

Full oscillation period (dim → bright → dim) in milliseconds.