ui

终端 UI 工具模块，提供 ANSI 转义码处理功能。

导入方式

// 子模块独立导入（推荐）
import { ANSI } from '@meng-xi/vite-plugin/common/ui'

// barrel 导入
import { ANSI } from '@meng-xi/vite-plugin/common'

ANSI

ANSI 转义码工具集，提供终端文本着色和光标控制功能。

光标控制

属性	值	说明
reset	'\x1b[0G'	将光标重置到行首
clearLine	'\x1b[2K'	清除当前行内容
hideCursor	'\x1b[?25l'	隐藏终端光标
showCursor	'\x1b[?25h'	显示终端光标

文本着色

每个着色函数接收一个字符串参数，返回包含 ANSI 转义码的字符串。

函数	签名	说明
green	(t: string) => string	绿色文本
cyan	(t: string) => string	青色文本
gray	(t: string) => string	灰色文本
bold	(t: string) => string	粗体文本
red	(t: string) => string	红色文本
yellow	(t: string) => string	黄色文本
magenta	(t: string) => string	品红色文本

示例

// 彩色输出
console.log(ANSI.green('✓') + ' 构建成功')
console.log(ANSI.red('✗') + ' 构建失败')
console.log(ANSI.bold(ANSI.cyan('信息:')) + ' 正在处理...')

// 光标控制
process.stdout.write(ANSI.hideCursor)
// ... 动画逻辑 ...
process.stdout.write(ANSI.showCursor)

// 行清理与重写
process.stdout.write(ANSI.clearLine + ANSI.reset + ANSI.green('完成'))