@crafter/charts
Recharts for your terminal. 15 chart types, zero deps, TypeScript.
cpu ▄▅▆▇███▇▆▅▃▂▁▂▃▄
mem ▁▃▅▇█████▇▅▃▁
err ▁ ▁ ▃█▂▁
│ ⢀⠔⠊⠉⠉⠑⢄
80┤ ⢀⠎ ⠱⡀
│ ⡰⠁ ⠘⢄
60┤ ⡰⠁ ⢣
│ ⠱⡀
40┤ ⠘⢄
│ ⠑⠢⢄⣀⣀⠔⠉
Install
bun add @crafter/charts
Quick Start
import { plot, sparkline, chart, renderToAnsi } from "@crafter/charts";
// One-liner
console.log(plot([1, 5, 3, 7, 2, 8]));
// Sparkline
console.log(sparkline([10, 15, 12, 18, 14, 20], { color: "green" }));
// Full chart
const c = chart({ width: 60, height: 14 })
.data(rows, { xKey: "x" })
.yAxis({ format: (v) => "$" + v.toFixed(0) })
.line({ key: "price", color: "green", label: "Price" });
console.log(renderToAnsi(c));
Chart Types
| Type | Function | Inline? |
|---|---|---|
| Line (braille) | chart().line() | No |
| Line (box) | chart({ charset: "box" }).line() | No |
| Bar | chart().bar() | No |
| Scatter | chart().scatter() | No |
| Candlestick | chart().candlestick() | No |
| Plot | plot(data) | No |
| Sparkline | sparkline() | Yes |
| Column | sparkColumn() | Yes |
| Bar | sparkBar() | Yes |
| Win/Loss | sparkWinLoss() | Yes |
| Area | sparkArea() | Multi-line |
| Heatmap | sparkHeatmap() | Multi-line |
| Histogram | sparkHistogram() | Multi-line |
| Gauge | sparkGauge() | Yes |
| Donut | sparkDonut() | Yes |
Features
- Zero dependencies
- TypeScript strict with exported types
- Braille rendering (4x2 sub-pixel per character)
- 4 charsets: braille, box (╭╮╰╯─│), block, ascii
- 3 render targets:
renderToAnsi(),renderToString(),renderToHtml() - Deterministic snapshots for CI (
toMatchSnapshot()) - Auto-sized to terminal width
- Fixed domain via
.yDomain([min, max]) - Multi-series with colored legend
Links
License
MIT