ansimax 1.3.2 → 1.3.4

package/CHANGELOG.md

@@ -3,6 +3,288 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.3.4] — Feature additions across animations, configure, utils
+
+Patch release adding small but useful features to several modules. No
+breaking changes — every addition is opt-in.
+
+### Added — `animations` module
+
+**`animate.shake(text, opts)`** — horizontal tremble effect for errors or alerts:
+
+```js
+import { animate } from 'ansimax';
+
+await animate.shake('Connection failed', {
+  times: 5,
+  intensity: 2,
+  interval: 50,
+});
+```
+
+**`animate.countUp(from, to, opts)`** — numeric animation for counters:
+
+```js
+await animate.countUp(0, 100, {
+  duration: 1500,
+  decimals: 0,
+  format: (n) => `$${n.toLocaleString()}`,
+  easing: (t) => 1 - (1 - t) ** 3,   // ease-out cubic
+});
+// Animates from "$0" → "$100" over 1.5 seconds
+```
+
+Both functions support the standard animation pattern: `signal`, `reducedMotion`,
+`onFrame`, `onDone`, `onAbort`.
+
+### Added — `configure` module
+
+**`setConfigValue(key, value)`** — single-key shortcut:
+
+```js
+import { setConfigValue } from 'ansimax';
+
+setConfigValue('theme', 'dracula');
+setConfigValue('animationSpeed', 'fast');
+// equivalent to: configure({ theme: 'dracula' })
+```
+
+**`subscribeConfig(listener)`** — alias for `onConfigChange` matching the
+naming convention used by `themes.onChange`:
+
+```js
+import { subscribeConfig } from 'ansimax';
+
+const unsubscribe = subscribeConfig((newCfg, oldCfg) => {
+  console.log('Config changed:', newCfg);
+});
+```
+
+### Added — `utils/ansi` module
+
+**`hyperlink(url, label?)`** — OSC 8 escape sequence for clickable terminal links:
+
+```js
+import { hyperlink } from 'ansimax';
+
+console.log(`Visit ${hyperlink('https://github.com/Brashkie/ansimax', 'the repo')}`);
+console.log(`Email: ${hyperlink('mailto:hi@example.com')}`);
+```
+
+Supported terminals: VS Code, iTerm2, WezTerm, Kitty, Hyper, Alacritty, modern
+Windows Terminal. Terminals without support just show the label text.
+
+**`clearLine()`** — convenience for clearing current line + carriage return:
+
+```js
+import { clearLine } from 'ansimax';
+
+for (let i = 0; i <= 100; i++) {
+  process.stdout.write(clearLine() + `Progress: ${i}%`);
+  await sleep(30);
+}
+```
+
+### Added — `utils/helpers` module
+
+**`gradientStops(start, end, count)`** — interpolate N hex stops between two colors:
+
+```js
+import { gradientStops } from 'ansimax';
+
+const stops = gradientStops('#ff0000', '#0000ff', 5);
+// → ['#ff0000', '#bf003f', '#7f007f', '#3f00bf', '#0000ff']
+```
+
+**`escapeForRegex(str)`** — escape regex meta-characters in user input:
+
+```js
+import { escapeForRegex } from 'ansimax';
+
+const userInput = 'hello.world+code';
+const re = new RegExp(escapeForRegex(userInput));
+// Matches the literal string, not as a regex pattern
+```
+
+**`measureBlock(block)`** — get dimensions of a multi-line string (ANSI-aware):
+
+```js
+import { measureBlock, ascii } from 'ansimax';
+
+const box = ascii.box('Hello world!');
+const { width, height } = measureBlock(box);
+// → { width: 15, height: 3 }
+```
+
+### Improved — `node-globals.d.ts`
+
+Added ambient declarations for `AsyncIterator`, `AsyncIterable`, `AsyncGenerator`,
+and `Symbol.asyncIterator`. Lets code using `for await...of` type-check without
+needing `@types/node` installed at consumer projects.
+
+### Improved — Tests
+
+- `+6` tests for `gradientStops`
+- `+5` tests for `escapeForRegex`
+- `+7` tests for `measureBlock`
+- `+5` tests for `hyperlink`
+- `+2` tests for `clearLine`
+- `+4` tests for `setConfigValue`
+- `+3` tests for `subscribeConfig`
+- `+5` tests for `animate.shake`
+- `+8` tests for `animate.countUp`
+
+Total: **+45 tests** across utils, ansi, configure, animations.
+
+### Notes
+
+- No runtime dependencies — still zero
+- No breaking changes — drop-in replacement for `1.3.3`
+- All new exports backward-compatible by default
+
+---
+
+## [1.3.3] — Feature additions to panels, json, ascii
+
+Patch release adding new functionality to three modules. No breaking changes —
+all additions are opt-in via new options/exports.
+
+### Added — `panels.grid(blocks, opts)`
+
+N-column grid layout with auto-flow (reading order). Each row auto-sizes to
+the tallest block; each column auto-sizes to its widest member.
+
+```js
+import { panels, ascii } from 'ansimax';
+
+const cards = [
+  ascii.box('FILES\n42',   { padding: 1 }),
+  ascii.box('LINES\n1247', { padding: 1 }),
+  ascii.box('TESTS\n38',   { padding: 1 }),
+  ascii.box('COV\n98%',    { padding: 1 }),
+];
+
+// 2×2 grid
+console.log(panels.grid(cards, { columns: 2, gapX: 2, gapY: 1 }));
+
+// 3-column with auto-flow (7 items → 3 rows: [3, 3, 1])
+console.log(panels.grid(items, { columns: 3, gapX: 4 }));
+
+// Fixed cell width for uniform appearance
+console.log(panels.grid(blocks, {
+  columns: 4,
+  cellWidth: 15,
+  alignX: 'center',
+}));
+```
+
+Options: `columns` (required), `gapX`, `gapY`, `alignX`, `alignY`, `cellWidth`.
+
+### Added — `panels.frame` option `titleAlign`
+
+Frame titles can now be aligned `'left'`, `'center'` (default), or `'right'`.
+
+```js
+panels.frame('Body', { title: 'Section', titleAlign: 'left' });
+// ─ Section ───────────
+//
+// Body
+// ────────────────────
+
+panels.frame('Body', { title: 'Section', titleAlign: 'right' });
+// ─────────── Section ─
+//
+// Body
+// ────────────────────
+```
+
+### Added — `ascii.box` options `title` + `titleAlign`
+
+Boxes can now have a title in the top border. When the title is wider than the
+content, the box expands to fit it.
+
+```js
+console.log(ascii.box('Body content', {
+  title: 'Header',
+  titleAlign: 'left',     // 'left' | 'center' (default) | 'right'
+  borderStyle: 'rounded',
+}));
+
+// ╭─ Header ──────╮
+// │ Body content  │
+// ╰───────────────╯
+```
+
+### Added — `ascii.divider` option `align`
+
+Divider labels can now be aligned similar to box titles.
+
+```js
+ascii.divider({ label: 'Section', align: 'left',   width: 40 });
+// ─ Section ──────────────────────────────
+ascii.divider({ label: 'Section', align: 'center', width: 40 });
+// ─────────────── Section ────────────────
+ascii.divider({ label: 'Section', align: 'right',  width: 40 });
+// ────────────────────────────── Section ─
+```
+
+### Added — `json.pretty` native types support: `Map`, `Set`, `Date`
+
+```js
+import { json } from 'ansimax';
+
+const data = {
+  created: new Date('2026-06-13'),
+  cache: new Map([['user1', 'Alice'], ['user2', 'Bob']]),
+  tags: new Set(['frontend', 'react']),
+};
+
+console.log(json.pretty(data));
+// {
+//   "created": Date(2026-06-13T00:00:00.000Z),
+//   "cache": Map(2) [...],
+//   "tags": Set(2) ["frontend", "react"]
+// }
+```
+
+### Added — `json.pretty` option `mode: 'json'`
+
+Produces **strict, parseable JSON** instead of display-only output. Useful
+for piping to files, scripts, or other tools.
+
+```js
+const out = json.pretty(myData, { mode: 'json' });
+const parsed = JSON.parse(out);   // ✓ works
+```
+
+In `'json'` mode:
+- Colors are forced off (output is always plain text)
+- `undefined` / functions / symbols are dropped from objects, become `null` in arrays
+- `NaN` / `Infinity` / `-Infinity` become `null`
+- `BigInt` becomes a number (if safe) or a string (if out of safe range)
+- `Date` becomes its ISO string
+- `Map` becomes a plain object (string-keys only)
+- `Set` becomes an array
+- Circular references throw `TypeError` (matches `JSON.stringify` behavior)
+
+Default `'display'` mode preserves all v1.3.2 behavior. **No breaking changes.**
+
+### Improved — Tests
+
+- `+8` tests for `panels.grid`
+- `+3` tests for `panels.frame` titleAlign
+- `+5` tests for `ascii.box` title/titleAlign
+- `+4` tests for `ascii.divider` align
+- `+18` tests for `json` Map/Set/Date/mode
+
+### Notes
+
+- No runtime dependencies — still zero
+- No breaking changes — drop-in replacement for `1.3.2`
+- All new options have backward-compatible defaults
+
+---
+
 ## [1.3.2] — Documentation polish for frames + images
 
 Patch release improving JSDoc + IntelliSense coverage for the two largest

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.3.2-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.4-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-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -215,7 +215,7 @@ console.log(rainbow('preset rainbow integrado'));
 
 ### Gradientes animados (v1.2.0)
 
-<img src="media/animated_gradients.png" alt="Vista previa de gradientes animados" />
+<img src="media/animated-gradients.gif" alt="Vista previa de gradientes animados" />
 
 ```js
 import { animateGradient, sleep } from 'ansimax';
@@ -275,7 +275,7 @@ console.log(gradientRect({
 
 ### Gradientes reusables (v1.2.3)
 
-<img src="media/reusable_gradients.png" alt="Vista previa de gradientes reusables" />
+<img src="media/reusable-gradients.gif" alt="Vista previa de gradientes reusables" />
 
 ```js
 import { createGradient, reverseGradient, ascii } from 'ansimax';
@@ -323,7 +323,32 @@ console.log(ascii.box('¡Caja arcoiris!', { padding: 1, borderStyle: 'rounded' }
 
 ### Imagen → ASCII (v1.2.5)
 
-<img src="media/image_to_ascii.png" alt="Vista previa de Image-to-ASCII" />
+<div align="center">
+  <img src="media/image-ascii-original.png" alt="Foto original" width="40%" />
+</div>
+
+<table>
+  <tr>
+    <td align="center">
+      <img src="media/image-ascii-1.png" alt="Modo monocromo" /><br/>
+      <sub><b>1. Monocromo</b></sub>
+    </td>
+    <td align="center">
+      <img src="media/image-ascii-2.png" alt="Color + dithering Floyd-Steinberg" /><br/>
+      <sub><b>2. Color + Floyd-Steinberg</b></sub>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <img src="media/image-ascii-3.png" alt="Detección de bordes (Sobel)" /><br/>
+      <sub><b>3. Detección de bordes (Sobel)</b></sub>
+    </td>
+    <td align="center">
+      <img src="media/image-ascii-4.png" alt="Modo rostro para retratos" /><br/>
+      <sub><b>4. Modo rostro (retratos)</b></sub>
+    </td>
+  </tr>
+</table>
 
 ```js
 import { ascii } from 'ansimax';
@@ -348,10 +373,10 @@ for (let y = 0; y < info.height; y++) {
 
 // Ahora usa ansimax — varias formas:
 
-// Monocromo
+// 1. Monocromo
 console.log(ascii.fromImage(pixels, { width: 80 }));
 
-// Color + dithering Floyd-Steinberg + ramp detallado
+// 2. Color + dithering Floyd-Steinberg + ramp detallado
 console.log(ascii.fromImage(pixels, {
   width: 100,
   color: true,
@@ -359,7 +384,7 @@ console.log(ascii.fromImage(pixels, {
   ramp: 'detailed',
 }));
 
-// Modo detección de bordes (line art)
+// 3. Modo detección de bordes (line art)
 console.log(ascii.fromImage(pixels, {
   width: 80,
   edgeDetect: 'sobel',
@@ -367,7 +392,7 @@ console.log(ascii.fromImage(pixels, {
   ramp: 'blocks',
 }));
 
-// Modo rostro para retratos (mejora contraste de tonos medios)
+// 4. Modo rostro para retratos (mejora contraste de tonos medios)
 console.log(ascii.fromImage(pixels, {
   width: 60,
   ramp: 'detailed',
@@ -453,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.2'));
+console.log(components.badge('VERSION', 'v1.3.4'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -505,7 +530,7 @@ await loader.tasks([
 
 ### Animaciones
 
-<img src="media/animations.png" alt="Vista previa de animaciones" />
+<img src="media/animations-1.gif" alt="Vista previa de animaciones" />
 
 ```js
 import { animate, gradient, sleep } from 'ansimax';
@@ -615,10 +640,12 @@ console.log(json.pretty({
 }));
 
 // Límite de profundidad — colapsa objetos profundos a {...}
+const deeplyNested = { a: { b: { c: { d: { e: 'muy profundo' } } } } };
 console.log(json.pretty(deeplyNested, { maxDepth: 2 }));
 
 // Límite de items — arrays grandes muestran "... (N more)"
-console.log(json.pretty(largeArray, { maxItems: 10 }));
+const largeArray = Array.from({ length: 50 }, (_, i) => `item_${i}`);
+console.log(json.pretty(largeArray, { maxItems: 5 }));
 
 // Referencias circulares manejadas con gracia
 const obj = { name: 'foo' };
@@ -1038,6 +1065,61 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.4 — Features para animations, configure, utils
+
+Release patch con features opt-in en varios módulos. Cero breaking changes:
+
+- 🎬 **`animate.shake(text, opts)`** — efecto tremor horizontal para errores
+- 🔢 **`animate.countUp(from, to, opts)`** — contadores numéricos animados con format/easing
+- ⚙️ **`setConfigValue(key, value)`** — atajo single-key + alias `subscribeConfig`
+- 🔗 **`hyperlink(url, label)`** — links clickables vía OSC 8 (VS Code, iTerm2, WezTerm, Kitty...)
+- 🧹 **`clearLine()`** — helper conveniente para render loops
+- 🎨 **`gradientStops(start, end, count)`** — N stops procedurales entre dos colores
+- 🛡️ **`escapeForRegex(str)`** — escapa input de usuario para regex literals
+- 📏 **`measureBlock(block)`** — dimensiones ANSI-aware de texto multi-línea
+- 📐 **`node-globals.d.ts`** — añadidos tipos `AsyncIterator`/`AsyncIterable`/`AsyncGenerator`
+- 🧪 **+45 tests** entre animations, configure, utils
+
+```js
+import { animate, hyperlink } from 'ansimax';
+
+await animate.countUp(0, 1000, {
+  duration: 1500,
+  format: (n) => `$${n.toLocaleString()}`,
+});
+
+console.log(`Ver ${hyperlink('https://npmjs.com/ansimax', 'la página de npm')}`);
+```
+
+Drop-in replacement para `1.3.3`.
+
+### v1.3.3 — Features para panels, json, ascii
+
+Release patch con nuevas features opt-in. Cero breaking changes:
+
+- 📐 **`panels.grid(blocks, opts)`** — layout de grid en N columnas con auto-flow, gaps, alineación, y opción de ancho uniforme de celda
+- 🎯 **`panels.frame` + `ascii.box` + `ascii.divider`** todos reciben opción `titleAlign` (o `align`): `'left'`, `'center'` (default), `'right'`
+- 🏷️ **`ascii.box` nueva opción `title`** — muestra un label en el borde superior (expande el box si el title es más ancho que el contenido)
+- 📅 **`json.pretty` soporta Map / Set / Date nativamente** — `Date(...)`, `Map(N) [...]`, `Set(N) [...]` en modo display
+- 📤 **`json.pretty` nueva opción `mode: 'json'`** — produce JSON estricto y parseable (sin colores, descarta undefined/functions/symbols, lanza en circulares)
+- 🧪 **+38 tests** entre panels + json + ascii
+
+```js
+import { panels, json, ascii } from 'ansimax';
+
+// Grid de 2×2 con metric cards
+console.log(panels.grid(cards, { columns: 2, gapX: 2 }));
+
+// Title en el borde del box
+console.log(ascii.box('content', { title: 'Section', titleAlign: 'left' }));
+
+// Output JSON estricto (parseable)
+const out = json.pretty(data, { mode: 'json' });
+JSON.parse(out);   // ✓ funciona
+```
+
+Drop-in replacement para `1.3.2`.
+
 ### v1.3.2 — Pulido de documentación para frames + images
 
 Release patch con cobertura JSDoc + IntelliSense significativamente mejorada:

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.3.2-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.4-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-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -215,7 +215,7 @@ console.log(rainbow('built-in rainbow preset'));
 
 ### Animated Gradients (v1.2.0)
 
-<img src="media/animated_gradients.png" alt="Animated gradients preview" />
+<img src="media/animated-gradients.gif" alt="Animated gradients preview" />
 
 ```js
 import { animateGradient, sleep } from 'ansimax';
@@ -275,7 +275,7 @@ console.log(gradientRect({
 
 ### Reusable Gradients (v1.2.3)
 
-<img src="media/reusable_gradients.png" alt="Reusable gradients preview" />
+<img src="media/reusable-gradients.gif" alt="Reusable gradients preview" />
 
 ```js
 import { createGradient, reverseGradient, ascii } from 'ansimax';
@@ -323,7 +323,32 @@ console.log(ascii.box('Rainbow box!', { padding: 1, borderStyle: 'rounded' }));
 
 ### Image → ASCII (v1.2.5)
 
-<img src="media/image_to_ascii.png" alt="Image-to-ASCII preview" />
+<div align="center">
+  <img src="media/image-ascii-original.png" alt="Original photo" width="40%" />
+</div>
+
+<table>
+  <tr>
+    <td align="center">
+      <img src="media/image-ascii-1.png" alt="Monochrome mode" /><br/>
+      <sub><b>1. Monochrome</b></sub>
+    </td>
+    <td align="center">
+      <img src="media/image-ascii-2.png" alt="Color + Floyd-Steinberg dithering" /><br/>
+      <sub><b>2. Color + Floyd-Steinberg</b></sub>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <img src="media/image-ascii-3.png" alt="Edge detection (Sobel)" /><br/>
+      <sub><b>3. Edge detection (Sobel)</b></sub>
+    </td>
+    <td align="center">
+      <img src="media/image-ascii-4.png" alt="Face mode for portraits" /><br/>
+      <sub><b>4. Face mode (portraits)</b></sub>
+    </td>
+  </tr>
+</table>
 
 ```js
 import { ascii } from 'ansimax';
@@ -348,10 +373,10 @@ for (let y = 0; y < info.height; y++) {
 
 // Now use ansimax — multiple ways:
 
-// Monochrome
+// 1. Monochrome
 console.log(ascii.fromImage(pixels, { width: 80 }));
 
-// Color + Floyd-Steinberg dithering + detailed ramp
+// 2. Color + Floyd-Steinberg dithering + detailed ramp
 console.log(ascii.fromImage(pixels, {
   width: 100,
   color: true,
@@ -359,7 +384,7 @@ console.log(ascii.fromImage(pixels, {
   ramp: 'detailed',
 }));
 
-// Edge-detection mode (line art)
+// 3. Edge-detection mode (line art)
 console.log(ascii.fromImage(pixels, {
   width: 80,
   edgeDetect: 'sobel',
@@ -367,7 +392,7 @@ console.log(ascii.fromImage(pixels, {
   ramp: 'blocks',
 }));
 
-// Face mode for portraits (boosts midtone contrast)
+// 4. Face mode for portraits (boosts midtone contrast)
 console.log(ascii.fromImage(pixels, {
   width: 60,
   ramp: 'detailed',
@@ -453,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.2'));
+console.log(components.badge('VERSION', 'v1.3.4'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -505,7 +530,7 @@ await loader.tasks([
 
 ### Animations
 
-<img src="media/animations.png" alt="Animations preview" />
+<img src="media/animations-1.gif" alt="Animations preview" />
 
 ```js
 import { animate, gradient, sleep } from 'ansimax';
@@ -615,10 +640,12 @@ console.log(json.pretty({
 }));
 
 // Depth limit — collapses deep objects to {...}
+const deeplyNested = { a: { b: { c: { d: { e: 'too deep' } } } } };
 console.log(json.pretty(deeplyNested, { maxDepth: 2 }));
 
 // Item limit — huge arrays show "... (N more)"
-console.log(json.pretty(largeArray, { maxItems: 10 }));
+const largeArray = Array.from({ length: 50 }, (_, i) => `item_${i}`);
+console.log(json.pretty(largeArray, { maxItems: 5 }));
 
 // Circular references handled gracefully
 const obj = { name: 'foo' };
@@ -1038,6 +1065,61 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.4 — Feature additions across animations, configure, utils
+
+Patch release with opt-in additions to several modules. Zero breaking changes:
+
+- 🎬 **`animate.shake(text, opts)`** — horizontal tremble effect for error feedback
+- 🔢 **`animate.countUp(from, to, opts)`** — animated numeric counters with format/easing
+- ⚙️ **`setConfigValue(key, value)`** — single-key config shortcut + `subscribeConfig` alias
+- 🔗 **`hyperlink(url, label)`** — OSC 8 clickable terminal links (VS Code, iTerm2, WezTerm, Kitty...)
+- 🧹 **`clearLine()`** — convenience helper for render loops
+- 🎨 **`gradientStops(start, end, count)`** — procedural N-color stops
+- 🛡️ **`escapeForRegex(str)`** — escape user input for regex literals
+- 📏 **`measureBlock(block)`** — get ANSI-aware dimensions of multi-line text
+- 📐 **`node-globals.d.ts`** — added `AsyncIterator`/`AsyncIterable`/`AsyncGenerator` ambient types
+- 🧪 **+45 tests** across animations, configure, utils
+
+```js
+import { animate, hyperlink } from 'ansimax';
+
+await animate.countUp(0, 1000, {
+  duration: 1500,
+  format: (n) => `$${n.toLocaleString()}`,
+});
+
+console.log(`See ${hyperlink('https://npmjs.com/ansimax', 'the npm page')}`);
+```
+
+Drop-in replacement for `1.3.3`.
+
+### v1.3.3 — Features for panels, json, ascii
+
+Patch release with new opt-in features. Zero breaking changes:
+
+- 📐 **`panels.grid(blocks, opts)`** — N-column grid layout with auto-flow, gaps, alignment, and optional uniform cell width
+- 🎯 **`panels.frame` + `ascii.box` + `ascii.divider`** all get a `titleAlign` (or `align`) option: `'left'`, `'center'` (default), `'right'`
+- 🏷️ **`ascii.box` new `title` option** — show a label in the top border (expands box if title is wider than content)
+- 📅 **`json.pretty` supports Map / Set / Date natively** — `Date(...)`, `Map(N) [...]`, `Set(N) [...]` in display mode
+- 📤 **`json.pretty` new `mode: 'json'`** — produces strict, parseable JSON (no colors, drops undefined/functions/symbols, throws on circular)
+- 🧪 **+38 tests** across panels + json + ascii
+
+```js
+import { panels, json, ascii } from 'ansimax';
+
+// 2×2 grid of metric cards
+console.log(panels.grid(cards, { columns: 2, gapX: 2 }));
+
+// Title in box top border
+console.log(ascii.box('content', { title: 'Section', titleAlign: 'left' }));
+
+// Strict JSON output (parseable)
+const out = json.pretty(data, { mode: 'json' });
+JSON.parse(out);   // ✓ works
+```
+
+Drop-in replacement for `1.3.2`.
+
 ### v1.3.2 — Documentation polish for frames + images
 
 Patch release with significantly improved JSDoc + IntelliSense coverage: