copper

ANSI colorizer with a 20+ named palette (basic 4-bit + 256-color hues like `lime`, `teal`, `brown`, `gold`, `chocolate`, `pink`, `purple`, `lavender`, `indigo`, `orange`, `slate`), foreground / background / *Bright* / *bgBright* variants, plus modifiers (`bold`, `italic`, `dim`, `underline`, `inverse`, `hidden`, `strikethrough`, `reset`). Supports BOTH chalk-style chaining (`colors.red.bold("x")`) and picocolors-style composition (`colors.red(colors.bold("x"))`). `NO_COLOR` and `FORCE_COLOR` aware. TRIGGER when: code imports `colors`, `createColors`, `Colors`, `ColorName`, `ChainFormatter`, or `Formatter` from `@mongez/copper`; user asks "how do I color CLI text / chain colors / replace chalk / detect NO_COLOR / force colors / 256-color terminal output / get a typed color name"; calls like `colors.red(x)`, `colors.red.bold(x)`, `colors.bgGold(x)`, `colors.bold(colors.cyan(x))`. SKIP: browser/CSS styling (this is ANSI only); `console.log` without `@mongez/copper`; React/JSX text styling.

End-to-end recipes for @mongez/copper — combining spinner + progress + log + colors + box + link to build CLI experiences: themed deploy script, file-walker with progress, error reporting with boxed callouts, --quiet / --no-color flag handling, dual stdout/stderr logging. TRIGGER when: user asks "show me a real example using @mongez/copper / how do I structure a CLI with @mongez/copper / build a polished CLI experience / wire color + spinner + progress together"; combining two or more `@mongez/copper` primitives in one flow. SKIP: single-function lookups (use the per-feature skill); React/web UI work.

Small CLI utilities — `link` (OSC-8 terminal hyperlinks with `text (url)` fallback), `stripAnsi` (remove every ANSI escape including OSC-8), `symbols` (✔ ✖ ℹ ⚠ → ❯ … • ─ + Braille spinner frames with ASCII fallbacks on legacy Windows), `isColorSupported`, `detectColorSupport`. TRIGGER when: code imports `link`, `stripAnsi`, `symbols`, `SymbolName`, `isColorSupported`, or `detectColorSupport` from `@mongez/copper`; user asks "how do I make a clickable terminal link / strip ANSI from a string / get a check or cross symbol / detect color support / handle NO_COLOR"; calls like `link("docs", url)` or `stripAnsi(output)`. SKIP: HTML anchor tags or React links; emoji-only output with no `@mongez/copper` import.

@mongez/copper is a zero-dependency CLI toolkit: ANSI colors (20+ named hues across foreground / background / bright variants), spinners, progress bars, themed loggers, boxed messages, OSC-8 hyperlinks, and ANSI stripping. `NO_COLOR` / `FORCE_COLOR` aware, browser-safe imports. TRIGGER when: code imports `colors`, `createColors`, `spinner`, `progress`, `log`, `createLogger`, `box`, `link`, `stripAnsi`, `symbols`, `isColorSupported`, or `detectColorSupport` from `@mongez/copper`; user asks "how do I color CLI output / make a spinner / draw a progress bar / build a CLI in Node"; replacing `chalk` / `picocolors` / `ora` / `cli-progress` / `boxen`. SKIP: browser-only styling (use CSS); `console.log` formatting alone with no `@mongez/copper` import; React component theming.

Wrap CLI text in a Unicode (single / double / round / bold) or ASCII border, with padding, margin, color, and alignment. ANSI-aware width measurement so colored content lines up correctly. TRIGGER when: code imports `box`, `BoxOptions`, or `BoxStyle` from `@mongez/copper`; user asks "how do I draw a box around CLI text / banner / framed message / call-out / boxen replacement"; calls like `box("Deploy ok", { borderStyle: "round", borderColor: "green" })`. SKIP: HTML/CSS bordered components; ASCII-art bigger than a small framed message (use a dedicated figlet-style tool).

Themed CLI logger with `debug` / `info` / `success` / `warn` / `error` levels, colored symbol prefixes, level filtering, and a custom output stream. Errors serialize stack traces; plain values pass through `JSON.stringify` for structured printing. TRIGGER when: code imports `log`, `createLogger`, `Logger`, `LogLevel`, or `LoggerOptions` from `@mongez/copper`; user asks "how do I print colored info / warn / error logs in a CLI / silence info messages in quiet mode / log to stderr"; replacing `consola`, `signale`, `ansi-colors` + manual prefix. SKIP: pino/winston-style structured JSON logging for production servers; browser console (this writes to `process.stdout` by default).

Known-total CLI progress bar with `tick` / `update` / `done` / `stop`, customizable width, fill/empty glyphs, color, and template tokens (`:bar` `:current` `:total` `:percent` `:eta` `:elapsed`). TTY-aware — gracefully prints a single completion line in non-TTY streams. TRIGGER when: code imports `progress`, `ProgressHandle`, or `ProgressOptions` from `@mongez/copper`; user asks "how do I draw a progress bar / show percentage of N items processed / ETA in CLI"; replacing `cli-progress`, `progress`, `gauge`. SKIP: unknown-total / indeterminate loading — use the `spinner` skill instead; React/web progress UI.

Single-line animated CLI spinner with `start` / `stop` / `update` / `succeed` / `fail` / `warn` / `info` finalizers, customizable frames, interval, and color. Auto-degrades to a single-line print in non-TTY streams (CI, piped output). TRIGGER when: code imports `spinner`, `SpinnerHandle`, or `SpinnerOptions` from `@mongez/copper`; user asks "how do I show a spinner / loading indicator / ora replacement / busy indicator while awaiting an async task"; replacing `ora`, `cli-spinner`, `node-spinner`. SKIP: progress-with-known-total scenarios — use the `progress` skill instead; browser/React loading indicators (use a CSS animation or React component).