lacquer 0.1.1

What is Lacquer?

Lacquer is the Rust equivalent of lipgloss from Charmbracelet. It provides declarative style definitions for building beautiful terminal layouts—with padding, margins, borders, colors, and alignment.

use lacquer::{Style, Border, Position, Color};

let style = Style::new()
    .padding(1, 2)
    .margin(1, 0)
    .border(Border::Rounded)
    .border_foreground(Color::from_hex("#7C3AED"))
    .foreground(Color::from_hex("#FAFAFA"))
    .bold()
    .align(Position::Center);

println!("{}", style.render("🔥 Molten Labs"));

╭────────────────────╮
│                    │
│   🔥 Molten Labs   │
│                    │
╰────────────────────╯

Features

📦 Box Model

• Padding (all sides or individual)
• Margins (all sides or individual)
• Width/height constraints
• Max width/height limits

🎨 Colors & Styling

• Foreground & background colors
• Full RGB/hex color support
• Bold, italic, underline, dim
• Strikethrough, reverse video

🔲 Borders

• 8 built-in styles (Rounded, Double, Thick...)
• Custom border characters
• Per-side border colors
• ASCII fallback option

📐 Layout & Alignment

• Horizontal alignment (left, center, right)
• Vertical alignment (top, center, bottom)
• Inline mode for no-wrap rendering
• Unicode-aware width calculation

Installation

cargo add lacquer

Or add to your Cargo.toml:

[dependencies]
lacquer = "0.1"

Quick Start

Basic Styling

use lacquer::{Style, Color};

// Simple colored text
let styled = Style::new()
    .foreground(Color::from_hex("#F97316"))
    .bold()
    .render("Hello, Lacquer!");

println!("{}", styled);

Box with Padding

use lacquer::{Style, Border};

let box_style = Style::new()
    .padding(1, 3)          // 1 vertical, 3 horizontal
    .border(Border::Rounded)
    .render("Content");

println!("{}", box_style);
// ╭─────────────╮
// │             │
// │   Content   │
// │             │
// ╰─────────────╯

Centered Content

use lacquer::{Style, Border, Position};

let centered = Style::new()
    .width(30)
    .border(Border::Double)
    .align(Position::Center)
    .render("Centered!");

println!("{}", centered);
// ╔════════════════════════════╗
// ║          Centered!         ║
// ╚════════════════════════════╝

Multiple Lines

use lacquer::{Style, Border, Color};

let content = "Line 1\nLine 2\nLine 3";

let multiline = Style::new()
    .padding(1, 2)
    .border(Border::Thick)
    .foreground(Color::Green)
    .render(content);

println!("{}", multiline);

Border Styles

use lacquer::Border;

Border::None      // No border
Border::Normal    // ┌──┐ │ └──┘
Border::Rounded   // ╭──╮ │ ╰──╯
Border::Thick     // ┏━━┓ ┃ ┗━━┛
Border::Double    // ╔══╗ ║ ╚══╝
Border::Ascii     // +--+ | +--+
Border::Block     // ████ █ ████
Border::Dashed    // ┌╌╌┐ ╎ └╌╌┘

Custom Borders

use lacquer::{Border, BorderStyle};

let custom = Border::Custom(BorderStyle::new(
    '╭', '─', '╮',  // top-left, top, top-right
    '│',            // right
    '╯', '─', '╰',  // bottom-right, bottom, bottom-left
    '│',            // left
));

Inline Mode

For styling without block rendering (no borders, no padding):

use lacquer::{Style, Color};

let inline = Style::new()
    .foreground(Color::Red)
    .bold()
    .inline()
    .render("Error!");

println!("Status: {}", inline);
// Status: Error! (styled red and bold)

Using with Molten Brand

Enable the brand feature for pre-defined colors:

[dependencies]
lacquer = { version = "0.1", features = ["brand"] }

use lacquer::{Style, Border};
use molten_brand::{colors, products};

let goblin_box = Style::new()
    .border(Border::Rounded)
    .border_foreground(products::lair::PRIMARY.into())
    .foreground(colors::text::PRIMARY.into())
    .render("Lair Terminal");

Why "Lacquer"?

In the forge, lacquer is the hard, protective finish applied to metalwork—transforming raw iron into polished, beautiful artifacts. This library does the same for your terminal output. 💅

Ecosystem

Lacquer is part of the Molten Labs open source ecosystem:

Documentation

• 📖 API Documentation
• 💡 Examples
• 🎨 Molten Brand Colors

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

git clone https://github.com/moltenlabs/lacquer
cd lacquer
cargo test

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.