characters

func ColorizeFrame ¶ added in v0.2.0

func ColorizeFrame(frame domain.Frame, hexColor string) []string

ColorizeFrame compiles pattern codes and applies ANSI RGB colors. Returns compiled lines with color codes applied. If hexColor is empty, returns compiled lines without color.

This is useful for consumers who need pre-colored frames for custom animation systems (e.g., Bubble Tea TUI frameworks).

Example:

agent, _ := characters.LibraryAgent("mercury")
char := agent.GetCharacter()
frame := char.States["wait"].Frames[0]
coloredLines := ColorizeFrame(frame, char.Color)
for _, line := range coloredLines {
    fmt.Println(line)  // Prints in silver color
}

func ColorizeString ¶ added in v0.2.0

func ColorizeString(text, hexColor string) string

ColorizeString wraps text with ANSI RGB color escape codes. Format: \x1b[38;2;R;G;Bm{text}\x1b[0m If hexColor is empty, returns text unchanged.

This is useful for applying colors to arbitrary strings or for consumers who already have compiled frame lines.

Example:

text := "  ▐▛███▜▌  "
colored := ColorizeString(text, "#C0C0C0")
fmt.Println(colored)  // Prints in silver color

func HexToRGB ¶ added in v0.2.0

func HexToRGB(hex string) (r, g, b int)

HexToRGB converts hex color string to RGB values. Accepts both "#RRGGBB" and "RRGGBB" formats. Returns (0, 0, 0) for invalid input.

Example:

r, g, b := HexToRGB("#C0C0C0")  // r=192, g=192, b=192
r, g, b := HexToRGB("FF6B35")   // r=255, g=107, b=53

func LibraryInfo ¶

func LibraryInfo(name string) (string, error)

LibraryInfo returns information about a library character

func ListLibrary ¶

func ListLibrary() []string

ListLibrary returns all available library character names

func ShowIdle ¶

func ShowIdle(writer interface{}, character *domain.Character) error

ShowIdle displays the idle state of a character