public static trimTextToDisplayWidth(text as String, maxWidth as Int) as String:
Description
Trims plain text to a terminal display width without splitting wide glyphs or emoji grapheme clusters. ANSI sequences are preserved and do not consume width.