ansimax 1.2.5 → 1.2.6

package/CHANGELOG.md

@@ -3,6 +3,96 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.2.6] — ASCII module improvements
+
+Patch release focused on ASCII module quality and feature additions. No
+breaking changes — every 1.2.x program runs identically.
+
+### Added — 4 new built-in ramps
+
+`ASCII_RAMPS` now includes 4 additional ramps for different aesthetic styles:
+
+```js
+import { ASCII_RAMPS, ascii } from 'ansimax';
+
+ASCII_RAMPS.binary    // ' █'         — pure 2-char ramp
+ASCII_RAMPS.dots      // ' ⠁⠃⠇⠧⠷⡷⣷⣿' — Unicode braille (sparse aesthetic)
+ASCII_RAMPS.shades    // ' ⠁⠃⠇⠧⠷⡷⣷⣿█' — combined shading
+ASCII_RAMPS.ascii64   // 64-char printable ASCII — non-Unicode terminals
+
+ascii.fromImage(pixels, { ramp: 'shades' });
+ascii.fromImage(pixels, { ramp: 'binary', bgColor: true });  // photo-like effect
+```
+
+### Added — `bgColor` option in `fromImage`
+
+Render the source pixel's color as the **background** instead of the foreground.
+Pairs especially well with `ramp: 'binary'` for a photo-like effect where each
+character cell becomes a colored block:
+
+```js
+ascii.fromImage(pixels, {
+  width: 80,
+  bgColor: true,        // colors go on background
+  ramp: 'binary',       // chars are spaces/blocks
+});
+```
+
+Implies `color: true` — no need to set both.
+
+### Added — `brightness` and `contrast` in `fromImage`
+
+Pre-adjust the image's tonal range without modifying the source pixels:
+
+```js
+ascii.fromImage(pixels, {
+  width: 80,
+  brightness: 0.2,    // [-1, 1] — positive = lighter, negative = darker
+  contrast: 0.3,      // [-1, 1] — positive = boosted, negative = flattened
+});
+```
+
+Useful for tuning hard-to-read photos without re-processing the source.
+Values are clamped to `[-1, 1]`. Default `0` (no change, identical to v1.2.5).
+
+### Added — `kerning` option in `figletText`
+
+Control horizontal spacing between FIGfont glyphs:
+
+```js
+ascii.figletText('HELLO', font, {
+  kerning: 1,    // 1-space gap between each character glyph
+});
+```
+
+Default `0` (touching glyphs, matches previous behavior).
+
+### Added — Multi-line `figletText`
+
+`figletText` now handles `\n` in input — each line renders as a separate
+FIGfont block:
+
+```js
+ascii.figletText('LINE 1\nLINE 2', font, {
+  lineSpacing: 1,   // 1 blank line between rendered lines
+});
+```
+
+Single-line text takes a fast path (no behavior change for v1.2.5 callers).
+
+### Improved
+
+- Better JSDoc on `ASCII_RAMPS` with `@example` showing every ramp
+- Brightness/contrast use standard photo-editing formulas (linear stretch around midpoint)
+- All 1958 + 25 new tests pass
+
+### Notes
+
+- No new runtime dependencies — still zero
+- Drop-in replacement for `1.2.5`
+
+---
+
 ## [1.2.5] — Phase 3 closure: image-to-ASCII engine
 
 Minor release closing the **ASCII engine roadmap (Phase 3)** with five

package/README.es.md

@@ -7,7 +7,7 @@
 _Colores • Gradientes • Animaciones • ASCII Art • Pixel Art • Árboles • Componentes • Temas_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.2.5-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.2.6-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-1700%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -49,7 +49,7 @@ Ansimax es una **librería de renderizado todo-en-uno** para construir interface
 npm install ansimax
 ```
 
-```ts
+```js
 import { color, gradient, ascii, loader, sleep } from 'ansimax';
 
 console.log(ascii.banner('hola', {
@@ -122,7 +122,7 @@ yarn add ansimax
 
 ## ⚡ Ejemplo en 30 segundos
 
-```ts
+```js
 import { color, gradient, loader, ascii, sleep } from 'ansimax';
 
 console.log(ascii.banner('deploy', {
@@ -140,7 +140,7 @@ console.log(color.green('✓') + ' Listo en ' + color.bold('1.4s'));
 
 ## 🚀 Inicio rápido
 
-```ts
+```js
 import { configure, color, themes, gradient } from 'ansimax';
 
 // Configuración global
@@ -186,7 +186,7 @@ console.log(themes.primary('primary de cyberpunk'));
 
 <img src="media/colors.png" alt="Colores y gradientes" />
 
-```ts
+```js
 import { color, gradient, rainbow } from 'ansimax';
 
 // Colores básicos
@@ -204,7 +204,7 @@ console.log(rainbow('preset rainbow integrado'));
 
 ### Gradientes animados (v1.2.0)
 
-```ts
+```js
 import { animateGradient, sleep } from 'ansimax';
 
 // Animación de flujo de color — corre hasta llamar stop()
@@ -227,7 +227,7 @@ await animateGradient('¡Listo!', ['#50fa7b', '#bd93f9'], {
 
 <img src="media/easing_curves.png" alt="Colors and gradients" />
 
-```ts
+```js
 import { gradient } from 'ansimax';
 
 const stops = ['#ff79c6', '#bd93f9', '#8be9fd'];
@@ -247,7 +247,7 @@ console.log(gradient('hola mundo', stops, { easing: (t) => t * t * t }));
 
 <img src="media/conic_gradients.png" alt="Colors and gradients" />
 
-```ts
+```js
 import { gradientRect } from 'ansimax';
 
 // Barrido radial alrededor del centro — rueda arcoíris
@@ -262,7 +262,7 @@ console.log(gradientRect({
 
 ### Gradientes reusables (v1.2.3)
 
-```ts
+```js
 import { createGradient, reverseGradient, ascii } from 'ansimax';
 
 // Pre-resuelve los stops de hex una vez — significativamente más rápido para uso repetido
@@ -294,7 +294,7 @@ for (let p = 0; p < 1; p += 0.05) {
 
 <img src="media/ascii_art.png" alt="ASCII art" />
 
-```ts
+```js
 import { ascii, gradient } from 'ansimax';
 
 console.log(ascii.banner('HOLA', {
@@ -308,13 +308,28 @@ console.log(ascii.box('¡Caja arcoiris!', { padding: 1, borderStyle: 'rounded' }
 
 ### Imagen → ASCII (v1.2.5)
 
-```ts
+```js
 import { ascii } from 'ansimax';
-import type { PixelGrid } from 'ansimax';
+import sharp from 'sharp';
+
+// Obtén píxeles RGB raw de cualquier librería de imágenes — ejemplo con `sharp`.
+// Puedes usar jimp, pngjs, canvas, o cualquier decoder. Ansimax sigue sin deps.
+const { data, info } = await sharp('./foto.png')
+  .raw()
+  .toBuffer({ resolveWithObject: true });
+
+// Convierte el buffer RGB raw → PixelGrid (un array 2D de objetos { r, g, b })
+const pixels = [];
+for (let y = 0; y < info.height; y++) {
+  const row = [];
+  for (let x = 0; x < info.width; x++) {
+    const i = (y * info.width + x) * info.channels;
+    row.push({ r: data[i], g: data[i + 1], b: data[i + 2] });
+  }
+  pixels.push(row);
+}
 
-// Obtén un PixelGrid de cualquier librería de imágenes (sharp, jimp, pngjs, etc.)
-// Cada Pixel es `{ r, g, b }` o null
-const pixels: PixelGrid = await loadImagePixels('./foto.png');
+// Ahora usa ansimax — varias formas:
 
 // Monocromo
 console.log(ascii.fromImage(pixels, { width: 80 }));
@@ -336,7 +351,7 @@ console.log(ascii.fromImage(pixels, {
 }));
 
 // Modo rostro para retratos (mejora contraste de tonos medios)
-console.log(ascii.fromImage(retratoPixels, {
+console.log(ascii.fromImage(pixels, {
   width: 60,
   ramp: 'detailed',
   faceMode: true,
@@ -345,9 +360,9 @@ console.log(ascii.fromImage(retratoPixels, {
 
 ### Fuentes Figlet (v1.2.5)
 
-```ts
+```js
 import { readFileSync } from 'node:fs';
-import { parseFiglet, ascii } from 'ansimax';
+import { parseFiglet, ascii, gradient } from 'ansimax';
 
 // Descarga fuentes desde http://www.figlet.org/fontdb.cgi
 const font = parseFiglet(readFileSync('./standard.flf', 'utf8'));
@@ -364,7 +379,7 @@ console.log(ascii.figletText('STYLE', font, {
 
 <img src="media/trees.png" alt="Árboles" />
 
-```ts
+```js
 import { tree, color } from 'ansimax';
 
 const proyecto = tree({ label: 'mi-app', icon: '📦', color: color.bold });
@@ -383,7 +398,7 @@ console.log(proyecto.render({
 
 <img src="media/pixel_art.png" alt="Pixel art" />
 
-```ts
+```js
 import { images, createCanvas, gradientRect, SPRITES } from 'ansimax';
 
 // Sprite integrado
@@ -409,7 +424,7 @@ c.print();
 
 <img src="media/components.png" alt="Componentes" />
 
-```ts
+```js
 import { components, color } from 'ansimax';
 
 console.log(components.table([
@@ -419,7 +434,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.2.5'));
+console.log(components.badge('VERSION', 'v1.2.6'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -427,7 +442,7 @@ console.log(components.badge('BUILD',   'passing'));
 
 <img src="media/timeline.png" alt="Timeline" />
 
-```ts
+```js
 import { components } from 'ansimax';
 
 console.log(components.timeline([
@@ -440,7 +455,7 @@ console.log(components.timeline([
 
 ### Loaders y Progreso
 
-```ts
+```js
 import { loader, sleep } from 'ansimax';
 
 // Spinner con éxito/fallo
@@ -469,7 +484,7 @@ await loader.tasks([
 
 ### Animaciones
 
-```ts
+```js
 import { animate, gradient, sleep } from 'ansimax';
 
 await animate.typewriter('Bienvenido al wizard de deployment...', {
@@ -491,7 +506,7 @@ await animate.parallel([
 
 <img src="media/themes.png" alt="Temas" />
 
-```ts
+```js
 import { themes, createTheme } from 'ansimax';
 
 // Temas built-in
@@ -580,7 +595,7 @@ node examples/all-in-one.cjs
 
 La config global afecta cada módulo que la respeta (colores, temas, velocidad de animación, etc.):
 
-```ts
+```js
 import { configure, getConfig, withConfig, onConfigKeyChange } from 'ansimax';
 
 configure({
@@ -822,6 +837,37 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.2.6 — Mejoras del módulo ASCII
+
+Release patch con mejoras al motor ASCII:
+
+- 🎨 **4 ramps built-in nuevos** — `binary`, `dots`, `shades`, `ascii64`
+- 🖼️ **Opción `bgColor`** en `fromImage` — colores van al background (excelente con `ramp: 'binary'` para efecto foto)
+- 🔆 **`brightness` y `contrast`** pre-ajuste en `fromImage` — afina el rango tonal sin re-procesar
+- 📏 **Opción `kerning`** en `figletText` — controla el espacio entre glyphs
+- 📄 **`figletText` multi-línea** — input con `\n` renderiza múltiples bloques FIGfont con `lineSpacing` opcional
+
+```js
+import { ascii, ASCII_RAMPS } from 'ansimax';
+
+// Renderizado tipo-foto con bloques coloreados en background
+console.log(ascii.fromImage(pixels, {
+  width: 80,
+  bgColor: true,
+  ramp: 'binary',
+  brightness: 0.1,
+  contrast: 0.2,
+}));
+
+// Figlet multi-línea con espaciado
+console.log(ascii.figletText('TITULO\nSUBTITULO', font, {
+  kerning: 1,
+  lineSpacing: 1,
+}));
+```
+
+Drop-in replacement para `1.2.5`.
+
 ### v1.2.5 — Fase 3 completa: motor de imagen-a-ASCII
 
 Release minor que cierra el roadmap del motor ASCII con 5 features nuevas:
@@ -833,8 +879,16 @@ Release minor que cierra el roadmap del motor ASCII con 5 features nuevas:
 - 🔠 **Soporte Figlet (.flf)** — `parseFiglet()` + `ascii.figletText()` para 250+ fuentes de comunidad
 - ⚡ **Bonus: detección de bordes Sobel** — `edgeDetect: 'sobel'` para efectos line-art
 
-```ts
-import { ascii } from 'ansimax';
+```js
+import { readFileSync } from 'node:fs';
+import { ascii, parseFiglet } from 'ansimax';
+
+// Construye un PixelGrid pequeño a mano (usa sharp/jimp/etc para imágenes
+// reales — ver sección Imagen → ASCII arriba)
+const pixels = [
+  [{ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 }],
+  [{ r: 0, g: 0, b: 255 }, { r: 255, g: 255, b: 0 }],
+];
 
 // Imagen a ASCII (input desde sharp/jimp/etc, sin dependencia de decoder)
 console.log(ascii.fromImage(pixels, {
@@ -859,7 +913,7 @@ Release patch añadiendo metadata de inspección y un helper `reverseGradient()`
 - 🔄 **Helper `reverseGradient()`** — invierte el orden de stops de un gradiente (funciona con arrays o `ReusableGradient`)
 - 🎯 **`presets` exportado con su nombre canónico** — junto al alias existente `colorPresets`
 
-```ts
+```js
 import { createGradient, reverseGradient } from 'ansimax';
 
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
@@ -880,8 +934,8 @@ Release patch añadiendo una API orientada a performance:
 - 📖 Más JSDoc con ejemplos ejecutables
 - 🎯 Coincide con la firma `ColorFn` — funciona como `colorFn` en `ascii.banner`, themes, etc.
 
-```ts
-import { createGradient } from 'ansimax';
+```js
+import { createGradient, ascii } from 'ansimax';
 
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
 console.log(fire('¡Colores reusados!'));
@@ -910,7 +964,7 @@ Release minor que cierra el roadmap del motor de gradientes con tres features po
 - 📐 **Curvas de interpolación** — `linear` / `ease-in` / `ease-out` / `ease-in-out` / `cubic-bezier` / funciones personalizadas
 - ⭕ **Gradientes cónicos** — `gradientRect({ style: 'conic', startAngle })` para barridos radiales
 
-```ts
+```js
 import { animateGradient } from 'ansimax';
 
 const ctrl = animateGradient('Cargando...', ['#ff79c6', '#bd93f9', '#8be9fd']);

package/README.md

@@ -7,7 +7,7 @@
 _Colors • Gradients • Animations • ASCII Art • Pixel Art • Trees • Components • Themes_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.2.5-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.2.6-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-1700%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -49,7 +49,7 @@ Ansimax is a **batteries-included rendering library** for building beautiful ter
 npm install ansimax
 ```
 
-```ts
+```js
 import { color, gradient, ascii, loader, sleep } from 'ansimax';
 
 console.log(ascii.banner('hello', {
@@ -122,7 +122,7 @@ yarn add ansimax
 
 ## ⚡ 30-second example
 
-```ts
+```js
 import { color, gradient, loader, ascii, sleep } from 'ansimax';
 
 console.log(ascii.banner('deploy', {
@@ -140,7 +140,7 @@ console.log(color.green('✓') + ' Ready in ' + color.bold('1.4s'));
 
 ## 🚀 Quick Start
 
-```ts
+```js
 import { configure, color, themes, gradient } from 'ansimax';
 
 // Global configuration
@@ -186,7 +186,7 @@ console.log(themes.primary('cyberpunk primary'));
 
 <img src="media/colors.png" alt="Colors and gradients" />
 
-```ts
+```js
 import { color, gradient, rainbow } from 'ansimax';
 
 // Basic colors
@@ -204,7 +204,7 @@ console.log(rainbow('built-in rainbow preset'));
 
 ### Animated Gradients (v1.2.0)
 
-```ts
+```js
 import { animateGradient, sleep } from 'ansimax';
 
 // Color flow animation — runs until you call stop()
@@ -227,7 +227,7 @@ await animateGradient('Done!', ['#50fa7b', '#bd93f9'], {
 
 <img src="media/easing_curves.png" alt="Colors and gradients" />
 
-```ts
+```js
 import { gradient } from 'ansimax';
 
 const stops = ['#ff79c6', '#bd93f9', '#8be9fd'];
@@ -247,7 +247,7 @@ console.log(gradient('hello world', stops, { easing: (t) => t * t * t }));
 
 <img src="media/conic_gradients.png" alt="Colors and gradients" />
 
-```ts
+```js
 import { gradientRect } from 'ansimax';
 
 // Radial sweep around center — rainbow wheel
@@ -262,7 +262,7 @@ console.log(gradientRect({
 
 ### Reusable Gradients (v1.2.3)
 
-```ts
+```js
 import { createGradient, reverseGradient, ascii } from 'ansimax';
 
 // Pre-resolve hex stops once — significantly faster for repeated use
@@ -294,7 +294,7 @@ for (let p = 0; p < 1; p += 0.05) {
 
 <img src="media/ascii_art.png" alt="ASCII art" />
 
-```ts
+```js
 import { ascii, gradient } from 'ansimax';
 
 console.log(ascii.banner('HELLO', {
@@ -308,13 +308,28 @@ console.log(ascii.box('Rainbow box!', { padding: 1, borderStyle: 'rounded' }));
 
 ### Image → ASCII (v1.2.5)
 
-```ts
+```js
 import { ascii } from 'ansimax';
-import type { PixelGrid } from 'ansimax';
+import sharp from 'sharp';
+
+// Get raw RGB pixels from any image library — example using `sharp`.
+// You can use jimp, pngjs, canvas, or any decoder. Ansimax stays zero-deps.
+const { data, info } = await sharp('./photo.png')
+  .raw()
+  .toBuffer({ resolveWithObject: true });
+
+// Convert raw RGB buffer → PixelGrid (a 2D array of { r, g, b } objects)
+const pixels = [];
+for (let y = 0; y < info.height; y++) {
+  const row = [];
+  for (let x = 0; x < info.width; x++) {
+    const i = (y * info.width + x) * info.channels;
+    row.push({ r: data[i], g: data[i + 1], b: data[i + 2] });
+  }
+  pixels.push(row);
+}
 
-// Get a PixelGrid from any image library (sharp, jimp, pngjs, etc.)
-// Each Pixel is `{ r, g, b }` or null
-const pixels: PixelGrid = await loadImagePixels('./photo.png');
+// Now use ansimax — multiple ways:
 
 // Monochrome
 console.log(ascii.fromImage(pixels, { width: 80 }));
@@ -336,7 +351,7 @@ console.log(ascii.fromImage(pixels, {
 }));
 
 // Face mode for portraits (boosts midtone contrast)
-console.log(ascii.fromImage(portraitPixels, {
+console.log(ascii.fromImage(pixels, {
   width: 60,
   ramp: 'detailed',
   faceMode: true,
@@ -345,9 +360,9 @@ console.log(ascii.fromImage(portraitPixels, {
 
 ### Figlet Fonts (v1.2.5)
 
-```ts
+```js
 import { readFileSync } from 'node:fs';
-import { parseFiglet, ascii } from 'ansimax';
+import { parseFiglet, ascii, gradient } from 'ansimax';
 
 // Download fonts from http://www.figlet.org/fontdb.cgi
 const font = parseFiglet(readFileSync('./standard.flf', 'utf8'));
@@ -364,7 +379,7 @@ console.log(ascii.figletText('STYLE', font, {
 
 <img src="media/trees.png" alt="Trees" />
 
-```ts
+```js
 import { tree, color } from 'ansimax';
 
 const project = tree({ label: 'my-app', icon: '📦', color: color.bold });
@@ -383,7 +398,7 @@ console.log(project.render({
 
 <img src="media/pixel_art.png" alt="Pixel art" />
 
-```ts
+```js
 import { images, createCanvas, gradientRect, SPRITES } from 'ansimax';
 
 // Built-in sprite
@@ -409,7 +424,7 @@ c.print();
 
 <img src="media/components.png" alt="Components" />
 
-```ts
+```js
 import { components, color } from 'ansimax';
 
 console.log(components.table([
@@ -419,7 +434,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.2.5'));
+console.log(components.badge('VERSION', 'v1.2.6'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -427,7 +442,7 @@ console.log(components.badge('BUILD',   'passing'));
 
 <img src="media/timeline.png" alt="Timeline" />
 
-```ts
+```js
 import { components } from 'ansimax';
 
 console.log(components.timeline([
@@ -440,7 +455,7 @@ console.log(components.timeline([
 
 ### Loaders & Progress
 
-```ts
+```js
 import { loader, sleep } from 'ansimax';
 
 // Spinner with success/failure
@@ -469,7 +484,7 @@ await loader.tasks([
 
 ### Animations
 
-```ts
+```js
 import { animate, gradient, sleep } from 'ansimax';
 
 await animate.typewriter('Welcome to the deployment wizard...', {
@@ -491,7 +506,7 @@ await animate.parallel([
 
 <img src="media/themes.png" alt="Themes" />
 
-```ts
+```js
 import { themes, createTheme } from 'ansimax';
 
 // Built-in themes
@@ -580,7 +595,7 @@ node examples/all-in-one.cjs
 
 Global config affects every module that respects it (colors, themes, animation speed, etc.):
 
-```ts
+```js
 import { configure, getConfig, withConfig, onConfigKeyChange } from 'ansimax';
 
 configure({
@@ -822,6 +837,37 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.2.6 — ASCII module improvements
+
+Patch release with ASCII engine improvements:
+
+- 🎨 **4 new built-in ramps** — `binary`, `dots`, `shades`, `ascii64`
+- 🖼️ **`bgColor` option** in `fromImage` — colors go on background (great with `ramp: 'binary'` for photo effect)
+- 🔆 **`brightness` and `contrast`** pre-adjustment in `fromImage` — tune tonal range without re-processing
+- 📏 **`kerning` option** in `figletText` — control space between glyphs
+- 📄 **Multi-line `figletText`** — input with `\n` renders multiple FIGfont blocks with optional `lineSpacing`
+
+```js
+import { ascii, ASCII_RAMPS } from 'ansimax';
+
+// Photo-like rendering with colored background blocks
+console.log(ascii.fromImage(pixels, {
+  width: 80,
+  bgColor: true,
+  ramp: 'binary',
+  brightness: 0.1,
+  contrast: 0.2,
+}));
+
+// Multi-line figlet with spacing
+console.log(ascii.figletText('TITLE\nSUBTITLE', font, {
+  kerning: 1,
+  lineSpacing: 1,
+}));
+```
+
+Drop-in replacement for `1.2.5`.
+
 ### v1.2.5 — Phase 3 complete: image-to-ASCII engine
 
 Minor release closing the ASCII engine roadmap with 5 new features:
@@ -833,8 +879,16 @@ Minor release closing the ASCII engine roadmap with 5 new features:
 - 🔠 **Figlet (.flf) support** — `parseFiglet()` + `ascii.figletText()` for 250+ community fonts
 - ⚡ **Bonus: Sobel edge detection** — `edgeDetect: 'sobel'` for line-art effects
 
-```ts
-import { ascii } from 'ansimax';
+```js
+import { readFileSync } from 'node:fs';
+import { ascii, parseFiglet } from 'ansimax';
+
+// Build a small PixelGrid by hand (use sharp/jimp/etc for real images —
+// see Image → ASCII section above)
+const pixels = [
+  [{ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 }],
+  [{ r: 0, g: 0, b: 255 }, { r: 255, g: 255, b: 0 }],
+];
 
 // Image to ASCII (input from sharp/jimp/etc, no decoder dependency)
 console.log(ascii.fromImage(pixels, {
@@ -859,7 +913,7 @@ Patch release adding inspection metadata and a `reverseGradient()` helper:
 - 🔄 **`reverseGradient()` helper** — flips a gradient's stop order (works with arrays or `ReusableGradient`)
 - 🎯 **`presets` exported as canonical name** — alongside the existing `colorPresets` alias
 
-```ts
+```js
 import { createGradient, reverseGradient } from 'ansimax';
 
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
@@ -880,8 +934,8 @@ Patch release adding a performance-oriented API:
 - 📖 More JSDoc with runnable examples
 - 🎯 Matches the `ColorFn` signature — works as `colorFn` in `ascii.banner`, themes, etc.
 
-```ts
-import { createGradient } from 'ansimax';
+```js
+import { createGradient, ascii } from 'ansimax';
 
 const fire = createGradient(['#ff5555', '#ffb86c', '#f1fa8c']);
 console.log(fire('Reused colors!'));
@@ -910,7 +964,7 @@ Minor release closing the gradient engine roadmap with three powerful features:
 - 📐 **Easing curves** — `linear` / `ease-in` / `ease-out` / `ease-in-out` / `cubic-bezier` / custom functions
 - ⭕ **Conic gradients** — `gradientRect({ style: 'conic', startAngle })` for radial sweeps
 
-```ts
+```js
 import { animateGradient } from 'ansimax';
 
 const ctrl = animateGradient('Loading...', ['#ff79c6', '#bd93f9', '#8be9fd']);

package/dist/index.d.mts

@@ -1117,16 +1117,38 @@ interface StreamOptions {
  * Character ramps for luminance → glyph mapping.
  * Each ramp is ordered dark → light.
  *
- * - `standard` — balanced 10-char ramp, works for most images
+ * - `standard` — balanced 10-char ramp, works for most images (default)
  * - `detailed` — 70-char ramp from Paul Bourke, max detail at small sizes
  * - `blocks` — Unicode block fills, looks like a real photo at distance
  * - `simple` — 4-char minimal ramp
+ * - `binary` — pure 2-char ramp: space + filled block
+ * - `dots` — Unicode braille dots (sparse aesthetic)
+ * - `shades` — Unicode shading gradient with high tonal range
+ * - `ascii64` — printable ASCII subset, 64 chars, good for non-Unicode terminals
+ *
+ * @example
+ * ```js
+ * import { ascii, ASCII_RAMPS } from 'ansimax';
+ *
+ * console.log(ASCII_RAMPS.blocks);   // ' ░▒▓█'
+ * console.log(ASCII_RAMPS.shades);   // ' ⠁⠃⠇⠧⠷⡷⣷⣿█'
+ *
+ * // Use directly by name
+ * ascii.fromImage(pixels, { ramp: 'shades' });
+ *
+ * // Or pass a custom ramp string
+ * ascii.fromImage(pixels, { ramp: ' .oO@' });
+ * ```
  */
 declare const ASCII_RAMPS: {
     readonly standard: " .:-=+*#%@";
     readonly detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$";
     readonly blocks: " ░▒▓█";
     readonly simple: " .+#";
+    readonly binary: " █";
+    readonly dots: " ⠁⠃⠇⠧⠷⡷⣷⣿";
+    readonly shades: " ⠁⠃⠇⠧⠷⡷⣷⣿█";
+    readonly ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@";
 };
 type AsciiRamp = keyof typeof ASCII_RAMPS | string;
 /**
@@ -1199,6 +1221,32 @@ interface FromImageOptions {
      * midtone detail (where faces typically live). Best for portrait input.
      */
     faceMode?: boolean;
+    /**
+     * Render the source pixel's color as the **background** instead of the
+     * foreground. Useful when paired with `ramp: 'binary'` for a photo-like
+     * effect where chars become "pixels". Default `false`.
+     *
+     * Implies `color: true` — does not need to be set separately.
+     *
+     * @since 1.2.6
+     */
+    bgColor?: boolean;
+    /**
+     * Brightness adjustment applied to luminance before quantization.
+     * Range `[-1, 1]`. `0` = no change, `0.2` = lighter, `-0.2` = darker.
+     * Default `0`.
+     *
+     * @since 1.2.6
+     */
+    brightness?: number;
+    /**
+     * Contrast adjustment applied to luminance before quantization.
+     * Range `[-1, 1]`. `0` = no change, `0.5` = boosted, `-0.5` = flattened.
+     * Default `0`.
+     *
+     * @since 1.2.6
+     */
+    contrast?: number;
 }
 declare const fromImage: (pixels: PixelGrid, opts?: FromImageOptions) => string;
 /** A parsed FIGfont — opaque to the user; pass to `ascii.figlet()`. */
@@ -1244,10 +1292,24 @@ declare const parseFiglet: (flfContent: string) => FigletFont;
  * ```
  */
 interface FigletOptions {
-    /** Trim leading/trailing spaces per row. Default `true`. */
+    /** Trim leading/trailing blank rows. Default `true`. */
     trim?: boolean;
     /** Color function applied to the assembled output. */
     colorFn?: ColorFn | null;
+    /**
+     * Extra spacing (in characters) inserted between each glyph.
+     * `0` = touching glyphs, `1` = one-space gap, etc. Default `0`.
+     *
+     * @since 1.2.6
+     */
+    kerning?: number;
+    /**
+     * Vertical spacing (blank lines) between rendered lines when `text`
+     * contains `\n`. Default `0`.
+     *
+     * @since 1.2.6
+     */
+    lineSpacing?: number;
 }
 declare const figletText: (text: string, font: FigletFont, opts?: FigletOptions) => string;
 declare const ascii: {

package/dist/index.d.ts

@@ -1117,16 +1117,38 @@ interface StreamOptions {
  * Character ramps for luminance → glyph mapping.
  * Each ramp is ordered dark → light.
  *
- * - `standard` — balanced 10-char ramp, works for most images
+ * - `standard` — balanced 10-char ramp, works for most images (default)
  * - `detailed` — 70-char ramp from Paul Bourke, max detail at small sizes
  * - `blocks` — Unicode block fills, looks like a real photo at distance
  * - `simple` — 4-char minimal ramp
+ * - `binary` — pure 2-char ramp: space + filled block
+ * - `dots` — Unicode braille dots (sparse aesthetic)
+ * - `shades` — Unicode shading gradient with high tonal range
+ * - `ascii64` — printable ASCII subset, 64 chars, good for non-Unicode terminals
+ *
+ * @example
+ * ```js
+ * import { ascii, ASCII_RAMPS } from 'ansimax';
+ *
+ * console.log(ASCII_RAMPS.blocks);   // ' ░▒▓█'
+ * console.log(ASCII_RAMPS.shades);   // ' ⠁⠃⠇⠧⠷⡷⣷⣿█'
+ *
+ * // Use directly by name
+ * ascii.fromImage(pixels, { ramp: 'shades' });
+ *
+ * // Or pass a custom ramp string
+ * ascii.fromImage(pixels, { ramp: ' .oO@' });
+ * ```
  */
 declare const ASCII_RAMPS: {
     readonly standard: " .:-=+*#%@";
     readonly detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$";
     readonly blocks: " ░▒▓█";
     readonly simple: " .+#";
+    readonly binary: " █";
+    readonly dots: " ⠁⠃⠇⠧⠷⡷⣷⣿";
+    readonly shades: " ⠁⠃⠇⠧⠷⡷⣷⣿█";
+    readonly ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@";
 };
 type AsciiRamp = keyof typeof ASCII_RAMPS | string;
 /**
@@ -1199,6 +1221,32 @@ interface FromImageOptions {
      * midtone detail (where faces typically live). Best for portrait input.
      */
     faceMode?: boolean;
+    /**
+     * Render the source pixel's color as the **background** instead of the
+     * foreground. Useful when paired with `ramp: 'binary'` for a photo-like
+     * effect where chars become "pixels". Default `false`.
+     *
+     * Implies `color: true` — does not need to be set separately.
+     *
+     * @since 1.2.6
+     */
+    bgColor?: boolean;
+    /**
+     * Brightness adjustment applied to luminance before quantization.
+     * Range `[-1, 1]`. `0` = no change, `0.2` = lighter, `-0.2` = darker.
+     * Default `0`.
+     *
+     * @since 1.2.6
+     */
+    brightness?: number;
+    /**
+     * Contrast adjustment applied to luminance before quantization.
+     * Range `[-1, 1]`. `0` = no change, `0.5` = boosted, `-0.5` = flattened.
+     * Default `0`.
+     *
+     * @since 1.2.6
+     */
+    contrast?: number;
 }
 declare const fromImage: (pixels: PixelGrid, opts?: FromImageOptions) => string;
 /** A parsed FIGfont — opaque to the user; pass to `ascii.figlet()`. */
@@ -1244,10 +1292,24 @@ declare const parseFiglet: (flfContent: string) => FigletFont;
  * ```
  */
 interface FigletOptions {
-    /** Trim leading/trailing spaces per row. Default `true`. */
+    /** Trim leading/trailing blank rows. Default `true`. */
     trim?: boolean;
     /** Color function applied to the assembled output. */
     colorFn?: ColorFn | null;
+    /**
+     * Extra spacing (in characters) inserted between each glyph.
+     * `0` = touching glyphs, `1` = one-space gap, etc. Default `0`.
+     *
+     * @since 1.2.6
+     */
+    kerning?: number;
+    /**
+     * Vertical spacing (blank lines) between rendered lines when `text`
+     * contains `\n`. Default `0`.
+     *
+     * @since 1.2.6
+     */
+    lineSpacing?: number;
 }
 declare const figletText: (text: string, font: FigletFont, opts?: FigletOptions) => string;
 declare const ascii: {

package/dist/index.js

@@ -2523,7 +2523,12 @@ var ASCII_RAMPS = {
   standard: " .:-=+*#%@",
   detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$",
   blocks: " \u2591\u2592\u2593\u2588",
-  simple: " .+#"
+  simple: " .+#",
+  // v1.2.6 — new ramps
+  binary: " \u2588",
+  dots: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF",
+  shades: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF\u2588",
+  ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@"
 };
 var _resolveRamp = (r) => {
   if (typeof r === "string" && r.length > 0) {
@@ -2626,6 +2631,17 @@ var _enhanceForFace = (lum) => {
     })
   );
 };
+var _adjustBrightnessContrast = (lum, brightness, contrast) => {
+  const safeBrightness = Math.max(-1, Math.min(1, brightness)) * 255;
+  const safeContrast = Math.max(-1, Math.min(1, contrast));
+  const contrastFactor = 1 + safeContrast;
+  return lum.map(
+    (row) => row.map((v) => {
+      const adjusted = (v - 128) * contrastFactor + 128 + safeBrightness;
+      return Math.max(0, Math.min(255, adjusted));
+    })
+  );
+};
 var fromImage = (pixels, opts = {}) => {
   if (!Array.isArray(pixels) || pixels.length === 0) return "";
   const firstRow = pixels[0];
@@ -2638,7 +2654,11 @@ var fromImage = (pixels, opts = {}) => {
     edgeDetect = "none",
     edgeThreshold = 40,
     color: color2 = false,
-    faceMode = false
+    faceMode = false,
+    // v1.2.6
+    bgColor = false,
+    brightness = 0,
+    contrast = 0
   } = opts;
   const srcH = pixels.length;
   const srcW = pixels[0].length;
@@ -2647,6 +2667,9 @@ var fromImage = (pixels, opts = {}) => {
   const safeH = opts.height != null ? Math.max(1, Math.floor(opts.height)) : computedH;
   const resized = _resizePixels(pixels, safeW, safeH);
   let lum = _toLuminanceGrid(resized);
+  if (brightness !== 0 || contrast !== 0) {
+    lum = _adjustBrightnessContrast(lum, brightness, contrast);
+  }
   if (faceMode) lum = _enhanceForFace(lum);
   let edgeGrid = null;
   if (edgeDetect === "sobel") {
@@ -2657,7 +2680,7 @@ var fromImage = (pixels, opts = {}) => {
   if (dither === "floyd-steinberg" && !edgeGrid) {
     lum = _floydSteinberg(lum, rampLen);
   }
-  const useColor = color2 && !isNoColor();
+  const useColor = (color2 || bgColor) && !isNoColor();
   const lines = [];
   for (let y = 0; y < safeH; y++) {
     const lumRow = lum[y];
@@ -2679,7 +2702,11 @@ var fromImage = (pixels, opts = {}) => {
       if (useColor) {
         const p = pxRow[x];
         if (p) {
-          line += fgRgb(p.r, p.g, p.b) + ch;
+          if (bgColor) {
+            line += bgRgb(p.r, p.g, p.b) + ch;
+          } else {
+            line += fgRgb(p.r, p.g, p.b) + ch;
+          }
         } else {
           line += ch;
         }
@@ -2733,7 +2760,30 @@ var parseFiglet = (flfContent) => {
 var figletText = (text, font, opts = {}) => {
   if (typeof text !== "string") return "";
   if (!font || !font.glyphs || font.height <= 0) return "";
-  const { trim = true, colorFn = null } = opts;
+  const {
+    trim = true,
+    colorFn = null,
+    // v1.2.6
+    kerning = 0,
+    lineSpacing = 0
+  } = opts;
+  const safeKerning = Math.max(0, Math.floor(kerning));
+  const safeLineSpacing = Math.max(0, Math.floor(lineSpacing));
+  if (text.includes("\n")) {
+    const linesOfText = text.split("\n");
+    const renderedBlocks = linesOfText.map(
+      (line) => _renderFigletLine(line, font, safeKerning, trim)
+    );
+    const spacer = safeLineSpacing > 0 ? "\n".repeat(safeLineSpacing + 1) : "\n";
+    let multiResult = renderedBlocks.join(spacer);
+    if (colorFn) multiResult = colorFn(multiResult);
+    return multiResult;
+  }
+  let result = _renderFigletLine(text, font, safeKerning, trim);
+  if (colorFn) result = colorFn(result);
+  return result;
+};
+var _renderFigletLine = (text, font, kerning, trim) => {
   const glyphsForText = [];
   for (const ch of text) {
     const code = ch.codePointAt(0) ?? 32;
@@ -2745,23 +2795,26 @@ var figletText = (text, font, opts = {}) => {
       glyphsForText.push(fallback ?? new Array(font.height).fill(""));
     }
   }
+  const kerningSpacer = kerning > 0 ? " ".repeat(kerning) : "";
   const hardblankRe = new RegExp(_escapeRe(font.hardblank), "g");
   const rows = [];
   for (let r = 0; r < font.height; r++) {
     let row = "";
-    for (const g of glyphsForText) {
+    for (let i = 0; i < glyphsForText.length; i++) {
+      const g = glyphsForText[i];
       row += g[r] ?? "";
+      if (i < glyphsForText.length - 1 && kerningSpacer) {
+        row += kerningSpacer;
+      }
     }
     row = row.replace(hardblankRe, " ");
     rows.push(row);
   }
-  let result = rows.join("\n");
   if (trim) {
     const trimmed = rows.filter((row) => row.trim().length > 0);
-    result = trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
+    return trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
   }
-  if (colorFn) result = colorFn(result);
-  return result;
+  return rows.join("\n");
 };
 var _escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var ascii = {

package/dist/index.mjs

@@ -2343,7 +2343,12 @@ var ASCII_RAMPS = {
   standard: " .:-=+*#%@",
   detailed: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$",
   blocks: " \u2591\u2592\u2593\u2588",
-  simple: " .+#"
+  simple: " .+#",
+  // v1.2.6 — new ramps
+  binary: " \u2588",
+  dots: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF",
+  shades: " \u2801\u2803\u2807\u2827\u2837\u2877\u28F7\u28FF\u2588",
+  ascii64: " `.'^,_:-+=<>i!lI?/\\|()1{}[]rcvunxzjftLCJUYXZO0Qoahkbdpqwm*WMB8&%$#@"
 };
 var _resolveRamp = (r) => {
   if (typeof r === "string" && r.length > 0) {
@@ -2446,6 +2451,17 @@ var _enhanceForFace = (lum) => {
     })
   );
 };
+var _adjustBrightnessContrast = (lum, brightness, contrast) => {
+  const safeBrightness = Math.max(-1, Math.min(1, brightness)) * 255;
+  const safeContrast = Math.max(-1, Math.min(1, contrast));
+  const contrastFactor = 1 + safeContrast;
+  return lum.map(
+    (row) => row.map((v) => {
+      const adjusted = (v - 128) * contrastFactor + 128 + safeBrightness;
+      return Math.max(0, Math.min(255, adjusted));
+    })
+  );
+};
 var fromImage = (pixels, opts = {}) => {
   if (!Array.isArray(pixels) || pixels.length === 0) return "";
   const firstRow = pixels[0];
@@ -2458,7 +2474,11 @@ var fromImage = (pixels, opts = {}) => {
     edgeDetect = "none",
     edgeThreshold = 40,
     color: color2 = false,
-    faceMode = false
+    faceMode = false,
+    // v1.2.6
+    bgColor = false,
+    brightness = 0,
+    contrast = 0
   } = opts;
   const srcH = pixels.length;
   const srcW = pixels[0].length;
@@ -2467,6 +2487,9 @@ var fromImage = (pixels, opts = {}) => {
   const safeH = opts.height != null ? Math.max(1, Math.floor(opts.height)) : computedH;
   const resized = _resizePixels(pixels, safeW, safeH);
   let lum = _toLuminanceGrid(resized);
+  if (brightness !== 0 || contrast !== 0) {
+    lum = _adjustBrightnessContrast(lum, brightness, contrast);
+  }
   if (faceMode) lum = _enhanceForFace(lum);
   let edgeGrid = null;
   if (edgeDetect === "sobel") {
@@ -2477,7 +2500,7 @@ var fromImage = (pixels, opts = {}) => {
   if (dither === "floyd-steinberg" && !edgeGrid) {
     lum = _floydSteinberg(lum, rampLen);
   }
-  const useColor = color2 && !isNoColor();
+  const useColor = (color2 || bgColor) && !isNoColor();
   const lines = [];
   for (let y = 0; y < safeH; y++) {
     const lumRow = lum[y];
@@ -2499,7 +2522,11 @@ var fromImage = (pixels, opts = {}) => {
       if (useColor) {
         const p = pxRow[x];
         if (p) {
-          line += fgRgb(p.r, p.g, p.b) + ch;
+          if (bgColor) {
+            line += bgRgb(p.r, p.g, p.b) + ch;
+          } else {
+            line += fgRgb(p.r, p.g, p.b) + ch;
+          }
         } else {
           line += ch;
         }
@@ -2553,7 +2580,30 @@ var parseFiglet = (flfContent) => {
 var figletText = (text, font, opts = {}) => {
   if (typeof text !== "string") return "";
   if (!font || !font.glyphs || font.height <= 0) return "";
-  const { trim = true, colorFn = null } = opts;
+  const {
+    trim = true,
+    colorFn = null,
+    // v1.2.6
+    kerning = 0,
+    lineSpacing = 0
+  } = opts;
+  const safeKerning = Math.max(0, Math.floor(kerning));
+  const safeLineSpacing = Math.max(0, Math.floor(lineSpacing));
+  if (text.includes("\n")) {
+    const linesOfText = text.split("\n");
+    const renderedBlocks = linesOfText.map(
+      (line) => _renderFigletLine(line, font, safeKerning, trim)
+    );
+    const spacer = safeLineSpacing > 0 ? "\n".repeat(safeLineSpacing + 1) : "\n";
+    let multiResult = renderedBlocks.join(spacer);
+    if (colorFn) multiResult = colorFn(multiResult);
+    return multiResult;
+  }
+  let result = _renderFigletLine(text, font, safeKerning, trim);
+  if (colorFn) result = colorFn(result);
+  return result;
+};
+var _renderFigletLine = (text, font, kerning, trim) => {
   const glyphsForText = [];
   for (const ch of text) {
     const code = ch.codePointAt(0) ?? 32;
@@ -2565,23 +2615,26 @@ var figletText = (text, font, opts = {}) => {
       glyphsForText.push(fallback ?? new Array(font.height).fill(""));
     }
   }
+  const kerningSpacer = kerning > 0 ? " ".repeat(kerning) : "";
   const hardblankRe = new RegExp(_escapeRe(font.hardblank), "g");
   const rows = [];
   for (let r = 0; r < font.height; r++) {
     let row = "";
-    for (const g of glyphsForText) {
+    for (let i = 0; i < glyphsForText.length; i++) {
+      const g = glyphsForText[i];
       row += g[r] ?? "";
+      if (i < glyphsForText.length - 1 && kerningSpacer) {
+        row += kerningSpacer;
+      }
     }
     row = row.replace(hardblankRe, " ");
     rows.push(row);
   }
-  let result = rows.join("\n");
   if (trim) {
     const trimmed = rows.filter((row) => row.trim().length > 0);
-    result = trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
+    return trimmed.length > 0 ? trimmed.join("\n") : rows.join("\n");
   }
-  if (colorFn) result = colorFn(result);
-  return result;
+  return rows.join("\n");
 };
 var _escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var ascii = {

package/examples/05-components.ts

@@ -42,10 +42,10 @@ console.log();
 
 console.log(color.bold('━━━ Status ━━━'));
 console.log();
-console.log(components.status('Build started', { type: 'info' }));
-console.log(components.status('Linting passed', { type: 'success' }));
-console.log(components.status('5 deprecation warnings', { type: 'warning' }));
-console.log(components.status('Build failed', { type: 'error' }));
+console.log(components.status('info',    'Build started'));
+console.log(components.status('success', 'Linting passed'));
+console.log(components.status('warn',    '5 deprecation warnings'));
+console.log(components.status('error',   'Build failed'));
 console.log();
 
 console.log(color.bold('━━━ Section ━━━'));

package/examples/all-in-one.cjs

@@ -118,14 +118,14 @@ async function main() {
   console.log(components.section('🏷️  Badges & Status', { width: 60 }));
   console.log();
   console.log(' ',
-    components.badge('VERSION', 'v1.2.5'),
+    components.badge('VERSION', 'v1.2.6'),
     components.badge('BUILD', 'passing'),
     components.badge('LICENSE', 'Apache 2.0'));
   console.log();
-  console.log(components.status('Build started', { type: 'info' }));
-  console.log(components.status('Tests passed', { type: 'success' }));
-  console.log(components.status('1 deprecation', { type: 'warning' }));
-  console.log(components.status('Build failed', { type: 'error' }));
+  console.log(components.status('info',    'Build started'));
+  console.log(components.status('success', 'Tests passed'));
+  console.log(components.status('warn',    '1 deprecation'));
+  console.log(components.status('error',   'Build failed'));
   console.log();
 
   // ── 9. Loaders ────────────────────────────────────────────

package/examples/all-in-one.mjs

@@ -117,14 +117,14 @@ console.log();
 console.log(components.section('🏷️  Badges & Status', { width: 60 }));
 console.log();
 console.log(' ',
-  components.badge('VERSION', 'v1.2.5'),
+  components.badge('VERSION', 'v1.2.6'),
   components.badge('BUILD', 'passing'),
   components.badge('LICENSE', 'Apache 2.0'));
 console.log();
-console.log(components.status('Build started', { type: 'info' }));
-console.log(components.status('Tests passed', { type: 'success' }));
-console.log(components.status('1 deprecation', { type: 'warning' }));
-console.log(components.status('Build failed', { type: 'error' }));
+  console.log(components.status('info',    'Build started'));
+  console.log(components.status('success', 'Tests passed'));
+  console.log(components.status('warn',    '1 deprecation'));
+  console.log(components.status('error',   'Build failed'));
 console.log();
 
 // ── 9. Loaders ────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "description": "Zero-dependency CLI rendering library: colors, gradients, animations, ASCII art, pixel art, components, and themes \u2014 all in TypeScript.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",