# @uttr/tint

> Yet another fast and minimalist console color utility

Latest version **0.1.3** (published 2025-12-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @uttr/tint
pnpm add @uttr/tint
yarn add @uttr/tint
bun add @uttr/tint
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; has provenance.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2025-12-19 |
| First published | 2025-12-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 15.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2 |
| Author | Kohane |
| Maintainers | aimless |
| Keywords | console, color |

## Links

- npm: https://www.npmjs.com/package/@uttr/tint
- Repository: https://github.com/utakotoba/uttr-tint
- Homepage: https://github.com/utakotoba/uttr-tint#readme
- Issues: https://github.com/utakotoba/uttr-tint/issues
- npm.io page: https://npm.io/package/@uttr/tint

## Alternatives

- [postcss-color-hex-alpha](https://npm.io/package/postcss-color-hex-alpha.md) — 6.4M weekly downloads
- [randomcolor](https://npm.io/package/randomcolor.md) — 348.0K weekly downloads
- [bows](https://npm.io/package/bows.md) — 1.3K weekly downloads
- [ep_prefer_color_scheme](https://npm.io/package/ep_prefer_color_scheme.md) — 260 weekly downloads
- [coc-yank](https://npm.io/package/coc-yank.md) — 61 weekly downloads

## Recent versions

- 0.1.3 (latest) — 2025-12-19
- 0.1.2 — 2025-12-18
- 0.1.1 — 2025-12-18
- 0.1.0 — 2025-12-17

## README

### @uttr/tint

a microscopic, fast, zero-dependency ANSI styling library for Node.js, Bun, and Deno.

`tint` is optimized for performance by aggressively caching style chains and pre-compiling regex logic for correct nesting. It provides a familiar chainable API (`tint.red.bold`) and fully supports template literals.

### installation

```sh
npm install @uttr/tint
```

```sh
yarn add @uttr/tint
```

```sh
pnpm add @uttr/tint
```

```sh
bun add @uttr/tint
```

### usage

```typescript
import * as tint from '@uttr/tint'

// Chainable API
console.log(tint.cyan.bold('Hello World'))

// Template Literals (Recommended)
console.log(tint.green`Server running at ${tint.underline`http://localhost:3000`}`)

// Nested styles work correctly
console.log(tint.red`Error: ${tint.yellow.italic`File not found`}`)
```

or using named imports:

```typescript
import { bold, green, red } from '@uttr/tint'

console.log(red.bold`Success!`)
```

### versioning

- `v0.1.x`: breaking changes may occur in patch releases.
- `v0.x.x` (except `v0.1.x`): breaking changes may occur in minor releases.

---

### apis

`tint` exposes standard ANSI colors and modifiers as chainable properties.

#### colors
`black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`, `grey`

#### backgrounds
`bgBlack`, `bgRed`, `bgGreen`, `bgYellow`, `bgBlue`, `bgMagenta`, `bgCyan`, `bgWhite`

#### modifiers
`bold`, `dim`, `italic`, `underline`, `inverse`, `hidden`, `strikethrough`, `reset`

#### utilities
- `strip(string)`: removes all ANSI escape codes from a string.
- `rawLen(string)`: returns the length of a string ignoring ANSI escape codes.

---

### benchmark

`tint` is designed to be the fastest option for both simple and complex nested styling.

> [!WARNING]
> **Implementation Note on Fairness**
>
> `tint` achieves its speed by memoizing (caching) style chains directly inside the module.
>
> When you access `tint.red.bold`, we create and attach the specialized function for that exact combination permanently. Other libraries typically rebuild the chain or traverse prototypes on every access, which may save memory in some JavaScript engines but costs CPU cycles.
>
> This trade-off makes `tint` exceptionally fast for applications with a finite set of style combinations (e.g., CLI tools, loggers) but slightly heavier in memory if you were to dynamically generate thousands of unique, random style chains (which is rare in practice).
>
> We are currently working on measuring the exact memory trade-off in various environments.

benchmark environment: Bun 1.3.4 on M3 Pro MacBook Pro with 36GB of RAM.

```plain
✓ bench/color.bench.ts > cached (local variable) 12981ms
    name                           hz     min     max    mean     p75     p99    p995    p999     rme   samples
  · chalk: cached       29,000,983.59  0.0000  0.0989  0.0000  0.0000  0.0000  0.0000  0.0001  ±0.10%  14500492
  · kleur: cached       30,504,965.94  0.0000  0.1567  0.0000  0.0000  0.0000  0.0000  0.0001  ±0.20%  15252483
  · @uttr/tint: cached  31,888,577.32  0.0000  0.4500  0.0000  0.0000  0.0000  0.0000  0.0001  ±0.32%  15944290

✓ bench/color.bench.ts > simple chained styling 8806ms
    name                                  hz     min     max    mean     p75     p99    p995    p999     rme   samples
  · chalk: chain               11,530,444.41  0.0000  0.9179  0.0001  0.0001  0.0002  0.0002  0.0003  ±0.42%   5765223
  · kleur: chain                7,004,132.84  0.0000  0.2206  0.0001  0.0001  0.0003  0.0003  0.0005  ±0.80%   3502067
  · yocto: chain (functional)   4,337,420.89  0.0002  0.0403  0.0002  0.0003  0.0003  0.0003  0.0004  ±0.06%   2168711
  · @uttr/tint: chain          27,279,009.82  0.0000  0.1281  0.0000  0.0000  0.0000  0.0000  0.0001  ±0.16%  13639506

✓ bench/color.bench.ts > template literal usage 5673ms
    name                                     hz     min     max    mean     p75     p99    p995    p999     rme   samples
  · chalk: template literal        4,309,466.51  0.0001  0.3859  0.0002  0.0003  0.0003  0.0003  0.0004  ±0.46%   2154734
  · kleur: template literal        6,377,511.94  0.0000  0.3431  0.0002  0.0001  0.0003  0.0003  0.0005  ±1.27%   3188756
  · @uttr/tint: template literal  22,340,479.24  0.0000  0.1909  0.0000  0.0000  0.0001  0.0001  0.0001  ±0.22%  11170240

✓ bench/color.bench.ts > cached template literal usage 8910ms
    name                                            hz     min     max    mean     p75     p99    p995    p999     rme   samples
  · chalk: cached template literal        5,777,797.94  0.0001  0.4440  0.0002  0.0002  0.0002  0.0003  0.0003  ±0.84%   2890011
  · kleur: cached template literal       28,170,077.63  0.0000  0.0215  0.0000  0.0000  0.0000  0.0000  0.0001  ±0.04%  14085040
  · @uttr/tint: cached template literal  25,335,944.33  0.0000  0.1888  0.0000  0.0000  0.0000  0.0001  0.0001  ±0.18%  12667973

✓ bench/color.bench.ts > nested template literal usage 5643ms
    name                                            hz     min     max    mean     p75     p99    p995    p999     rme  samples
  · chalk: nested template literal        2,649,470.62  0.0003  0.2142  0.0004  0.0004  0.0005  0.0005  0.0006  ±0.18%  1324736
  · kleur: nested template literal        3,395,413.96  0.0001  0.3937  0.0003  0.0002  0.0005  0.0005  0.0008  ±1.79%  1697885
  · yocto: nested functional              1,716,905.59  0.0004  0.8637  0.0006  0.0006  0.0007  0.0008  0.0024  ±1.08%   858453
  · @uttr/tint: nested template literal  18,378,335.96  0.0000  0.0155  0.0001  0.0001  0.0001  0.0001  0.0001  ±0.04%  9189168

BENCH  Summary

@uttr/tint: cached - bench/color.bench.ts > cached (local variable)
  1.05x faster than kleur: cached
  1.10x faster than chalk: cached

@uttr/tint: chain - bench/color.bench.ts > simple chained styling
  2.37x faster than chalk: chain
  3.89x faster than kleur: chain
  6.29x faster than yocto: chain (functional)

@uttr/tint: template literal - bench/color.bench.ts > template literal usage
  3.50x faster than kleur: template literal
  5.18x faster than chalk: template literal

kleur: cached template literal - bench/color.bench.ts > cached template literal usage
  1.11x faster than @uttr/tint: cached template literal
  4.88x faster than chalk: cached template literal

@uttr/tint: nested template literal - bench/color.bench.ts > nested template literal usage
  5.41x faster than kleur: nested template literal
  6.94x faster than chalk: nested template literal
  10.70x faster than yocto: nested functional
```

---

### license

MIT LICENSE Copyright (c) 2025 Kohane

---
_Source: https://npm.io/package/@uttr/tint · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
