Raxol.Effects.BorderBeam.Effects.Pulse (Raxol v2.6.0)

View Source

The whole border breathes in unison: every perimeter cell shares the same fg color and intensity at any moment, both varying as a smooth cosine wave over the period.

The wave shifts the palette index AND the terminal intensity attr, so the breath is visibly distinct frame-to-frame even on terminals where :dim and :bold of the same color render similarly. At the trough the border drops to the dimmest palette color with :dim; at the peak it climbs to palette[0] with :bold.

Surface support: terminal only. LiveView/MCP currently ignore non-stroke effect types.

Opts

  • :variant -- color palette (uses palette head color)
  • :period_ms -- one full breath cycle (default 1800)
  • :strength -- 0.0-1.0 peak intensity (default 0.95)