README
- ::bg_blackStyle::bg_black
- ::bg_blueStyle::bg_blue
- ::bg_bright_blackStyle::bg_bright_black
- ::bg_bright_blueStyle::bg_bright_blue
- ::bg_bright_cyanStyle::bg_bright_cyan
- ::bg_bright_greenStyle::bg_bright_green
- ::bg_bright_magentaStyle::bg_bright_magenta
- ::bg_bright_redStyle::bg_bright_red
- ::bg_bright_whiteStyle::bg_bright_white
- ::bg_bright_yellowStyle::bg_bright_yellow
- ::bg_cyanStyle::bg_cyan
- ::bg_greenStyle::bg_green
- ::bg_hexStyle::bg_hex
- ::bg_magentaStyle::bg_magenta
- ::bg_redStyle::bg_red
- ::bg_whiteStyle::bg_white
- ::bg_yellowStyle::bg_yellow
- ::blackStyle::black
- ::blueStyle::blue
- ::boldStyle::bold
- ::bright_blackStyle::bright_black
- ::bright_blueStyle::bright_blue
- ::bright_cyanStyle::bright_cyan
- ::bright_greenStyle::bright_green
- ::bright_magentaStyle::bright_magenta
- ::bright_redStyle::bright_red
- ::bright_whiteStyle::bright_white
- ::bright_yellowStyle::bright_yellow
- ::cyanStyle::cyan
- ::greenStyle::green
- ::hexStyle::hex
- ::inverseStyle::inverse
- ::italicStyle::italic
- ::magentaStyle::magenta
- ::redStyle::red
- ::strikethroughStyle::strikethrough
- ::textStyle::text
- ::to_reprStyle::to_repr
- ::underlineStyle::underline
- ::whiteStyle::white
- ::yellowStyle::yellow
V
ESC
V
OSC8_PREFIX
V
OSC8_SUFFIX
V
bg_black
V
bg_blue
V
bg_bright_black
V
bg_bright_blue
V
bg_bright_cyan
V
bg_bright_green
V
bg_bright_magenta
V
bg_bright_red
V
bg_bright_white
V
bg_bright_yellow
V
bg_cyan
V
bg_green
V
bg_magenta
V
bg_red
V
bg_white
V
bg_yellow
V
black
V
blue
V
bold
V
bright_black
V
bright_blue
V
bright_cyan
V
bright_green
V
bright_magenta
V
bright_red
V
bright_white
V
bright_yellow
V
cyan
V
default
V
dim
V
error
V
green
V
hyperlink
V
info
V
inverse
V
is_enabled
V
italic
V
magenta
V
ok
V
red
V
set_enabled
V
strikethrough
V
underline
V
warn
V
white
V
yellow

clicolor

Terminal color and hyperlink escape sequences for MoonBit

ansi

color

terminal

cli

style

Download zip

Author

chensuiyi

Version

0.2.0

License

MIT

Repository

github.com/chenbimo/clicolor

Last updated

11 hours ago

Downloads

#clicolor

终端颜色与超链接转义序列库，moonbit 工作区里渲染类模块（clitable 等）的基建。

样式是不可变的 Style 值：颜色、属性、背景色是公开常量，链式返回新值，text 收尾产出串。坏色值按黑色降级，不中断渲染。

#用法

发布到 mooncakes 之后：

moon add chensuiyi/clicolor

唯一写法：@clicolor.<链首常量>.<链>.text(文本)。链首取实际存在的最前一项：有前景用前景色，没有前景用背景色，两色皆无才用 default（专供纯修饰与运行期色值）。固定顺序 前景 > 背景 > 修饰 不变。链步零参带括号（moonbit 语言规则），带参的只有 hex / bg_hex，收尾永远 text。

// 前景
@clicolor.red.text("失败")
@clicolor.blue.underline().inverse().text("锁定")

// 前景 > 背景
@clicolor.red.bg_blue().text("失败")

// 前景 > 背景 > 修饰
@clicolor.red.bg_blue().bold().text("失败")
@clicolor.green.bold().underline().text("成功")

// 纯背景起步：没有前景，背景常量直接当链首
@clicolor.bg_red.text("背景")

// 两色皆无：default 起步（纯修饰、运行期色值）
@clicolor.default.bold().text("加强")
@clicolor.default.underline().italic().text("标注")

// 预设
@clicolor.error.text("文件缺失")
@clicolor.warn.text("磁盘将满")
@clicolor.ok.text("部署完成")
@clicolor.info.text("提示")
@clicolor.dim.text("2026-10-15 07:00")

常量一览：前景色 red green yellow blue magenta cyan white 与对应 bright_*；背景色 bg_* 全套同上；修饰 bold italic underline inverse strikethrough；预设 error warn ok info dim；起步兜底 default。

运行期色值与运行期背景：

@clicolor.default.hex(c).text(t)
@clicolor.red.bg_hex("#101010").text("hi")

OSC 8 可点击超链接：

@clicolor.hyperlink("https://mooncakes.io", "docs")

#输出开关

不做 TTY 与 NO_COLOR 自动探测，本库保持纯函数。上层调用方自己判定后显式关掉：

@clicolor.set_enabled(false)   // 返回旧值，方便恢复

关闭后所有 text 原样返回文本。

#迁移

Ansi 枚举、wrap_ansi 数组入口、Color::paint、Style::new 均已除名，统一收敛到上面的唯一写法。

#设计要点

攒样式与产串分离。 链上每步只拷贝一个小记录（前景 4 bit、背景 4 bit、属性 5 bit 的位掩码），零字符串分配；text 阶段单个缓冲区一遍走完，发射顺序与书写顺序一致。

空样式不添字节。 default 与关闭开关时 text 都原样返回，一字节转义都不输出。

分工纪律。 转义序列与宽度是两件事：本包只管序列（生成与收尾），宽度、截断、断行由引用它的库自己处理，strip_ansi 一类的宽度剥离不进本包，避免互相依赖成环。

边界（当前明确不做）。 嵌套样式（富文本树，内层关闭时重开外层）暂不实现，等 clitable 出现带色单元格截断的实需求再动；届时会新增独立的组合层，不复用 Style。256 色降级、TTY 自动探测同样在边界外。

#demo

src/main/demo.mbt 是全部写法的实景展示，十段对应用法各一，直接跑：

moon run src/main

#许可证

MIT。

clicolor.moonbitlang.dev 已上线，写法见 docs。

clicolor

#clicolor

#用法

#输出开关

#迁移

#设计要点

#demo

#许可证

#Style

#Style::bg_black

#Style::bg_blue

#Style::bg_bright_black

#Style::bg_bright_blue

#Style::bg_bright_cyan

#Style::bg_bright_green

#Style::bg_bright_magenta

#Style::bg_bright_red

#Style::bg_bright_white

#Style::bg_bright_yellow

#Style::bg_cyan

#Style::bg_green

#Style::bg_hex

#Style::bg_magenta

#Style::bg_red

#Style::bg_white

#Style::bg_yellow

#Style::black

#Style::blue

#Style::bold

#Style::bright_black

#Style::bright_blue

#Style::bright_cyan

#Style::bright_green

#Style::bright_magenta

#Style::bright_red

#Style::bright_white

#Style::bright_yellow

#Style::cyan

#Style::green

#Style::hex

#Style::inverse

#Style::italic

#Style::magenta

#Style::red

#Style::strikethrough

#Style::text

#Style::to_repr

#Style::underline

#Style::white

#Style::yellow

#ESC

#OSC8_PREFIX

#OSC8_SUFFIX

#bg_black

#bg_blue

#bg_bright_black

#bg_bright_blue

#bg_bright_cyan

#bg_bright_green

#bg_bright_magenta

#bg_bright_red

#bg_bright_white

#bg_bright_yellow

#bg_cyan

#bg_green

#bg_magenta

#bg_red

#bg_white

#bg_yellow

#black

#blue

#bold

#bright_black

#bright_blue

#bright_cyan

#bright_green

#bright_magenta

#bright_red

#bright_white

#bright_yellow

Style

Style::bg_black

Style::bg_blue

Style::bg_bright_black

Style::bg_bright_blue

Style::bg_bright_cyan

Style::bg_bright_green

Style::bg_bright_magenta

Style::bg_bright_red

Style::bg_bright_white

Style::bg_bright_yellow

Style::bg_cyan

Style::bg_green

Style::bg_hex

Style::bg_magenta

Style::bg_red

Style::bg_white

Style::bg_yellow

Style::black

Style::blue

Style::bold

Style::bright_black

Style::bright_blue

Style::bright_cyan

Style::bright_green

Style::bright_magenta

Style::bright_red

Style::bright_white

Style::bright_yellow

Style::cyan

Style::green

Style::hex

Style::inverse

Style::italic

Style::magenta

Style::red

Style::strikethrough

Style::text

Style::to_repr

Style::underline

Style::white

Style::yellow

ESC

OSC8_PREFIX

OSC8_SUFFIX

bg_black

bg_blue

bg_bright_black

bg_bright_blue

bg_bright_cyan

bg_bright_green

bg_bright_magenta

bg_bright_red

bg_bright_white

bg_bright_yellow

bg_cyan

bg_green

bg_magenta

bg_red

bg_white

bg_yellow

black

blue

bold

bright_black

bright_blue

bright_cyan

bright_green

bright_magenta

bright_red

bright_white

bright_yellow

cyan

default

dim

error

green

hyperlink

info

inverse