ansimax 1.1.1 → 1.1.2

package/CHANGELOG.md

@@ -3,6 +3,56 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.1.2] — maturity & robustness
+
+Patch release focused on maturity: better error semantics, defensive
+defaults, and cleaner type re-exports. No API breaking changes — every
+1.1.1 program runs identically.
+
+### Fixed
+
+- **CI: `jest.config.js` syntax error.** The config file used `export default {}`
+  (ESM syntax), which crashed in Node CommonJS context — including in
+  GitHub Actions runners. Fixed by switching to `module.exports = {}` to
+  match `useESM: false` in the ts-jest configuration. Tests now run
+  correctly across Linux, macOS, and Windows runners.
+
+### Improved
+
+- **`process.setMaxListeners` defensive bump.** Ansimax modules
+  (`animations`, `frames`, `loaders`, `utils/ansi`) each register
+  `SIGINT` / `SIGTERM` / `exit` handlers for crash-safe cursor
+  restoration. With Node's default cap of 10, hot-reload setups
+  (Vite HMR, nodemon, ts-node-dev) could occasionally emit
+  `MaxListenersExceededWarning`. We now bump the cap to 20 on first
+  install — silently and safely, only if the current limit is lower.
+  Production apps unaffected.
+- **Uniform `TypeError` for theme validation.** `themes.register()`
+  now throws `TypeError` for any structural / type issue (missing
+  fields, non-string `name`, invalid hex), matching the rest of the
+  validation surface. Previously it threw a mix of `Error` and
+  `TypeError`, which made `try / catch` filtering inconsistent.
+- **`themes.use()` throws `RangeError`** for unknown theme names
+  (was `Error`). `RangeError` better reflects "value out of allowed
+  set" semantics — same standard library convention as `Array(-1)`.
+  Error message now also says "Available themes:" instead of
+  "Available:" for clarity.
+- **Cleaner type re-exports in the barrel.** Added a header comment
+  explaining the legacy aliases (`stripAnsiColors`, `stripAnsiCodes`)
+  and recommending `stripAnsi` for new code. Version string in the
+  barrel header updated from the stale `v1.0.0` to `v1.1.2`.
+
+### Notes
+
+- All 1848 tests pass; 4 new tests cover the error-type guarantees.
+- The error-type changes are technically observable via `instanceof`
+  checks, but `RangeError` and `TypeError` both extend `Error`, so any
+  `catch (e: Error)` block keeps working. We classify this as a
+  non-breaking quality-of-life improvement.
+- No new dependencies — still zero runtime deps.
+
+---
+
 ## [1.1.1] — bug fixes + improved examples
 
 Patch release with two bug fixes from real-world testing of v1.1.0, plus
@@ -271,4 +321,4 @@ Hierarchical text renderer inspired by Rich's `Tree`.
 - TypeScript types exported.
 - Adaptive color rendering (NO_COLOR / FORCE_COLOR / TTY detection).
 - AbortSignal support across all blocking APIs.
-- 750+ tests, 85%+ coverage.
+- 750+ tests, 85%+ coverage.

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.1.1-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.1.2-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)
@@ -50,14 +50,14 @@ npm install ansimax
 ```
 
 ```ts
-import { color, gradient, ascii, loader } from 'ansimax';
+import { color, gradient, ascii, loader, sleep } from 'ansimax';
 
 console.log(ascii.banner('hola', {
   colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
 }));
 
 const stop = loader.spin('Construyendo proyecto', { color: '#bd93f9' });
-await algunaTareaAsync();
+await sleep(1500);
 stop('Build completado', true);
 ```
 
@@ -123,14 +123,14 @@ yarn add ansimax
 ## ⚡ Ejemplo en 30 segundos
 
 ```ts
-import { color, gradient, loader, ascii } from 'ansimax';
+import { color, gradient, loader, ascii, sleep } from 'ansimax';
 
 console.log(ascii.banner('deploy', {
   colorFn: (t) => gradient(t, ['#ff6b6b', '#feca57', '#48dbfb']),
 }));
 
 const stop = loader.spin('Construyendo proyecto', { color: '#bd93f9' });
-await algunaTareaAsync();
+await sleep(1500);             // simula trabajo asíncrono
 stop('Build completado', true);  // ✓ + color de éxito
 
 console.log(color.green('✓') + ' Listo en ' + color.bold('1.4s'));
@@ -187,12 +187,19 @@ console.log(themes.primary('primary de cyberpunk'));
 <img src="media/colors.png" alt="Colores y gradientes" />
 
 ```ts
-import { color, gradient } from 'ansimax';
+import { color, gradient, rainbow } from 'ansimax';
 
-color.red('rojo');   color.green('verde');  color.blue('azul');
-color.bold(texto);   color.italic(texto);    color.underline(texto);
-gradient('fuego a océano', ['#ff6b6b', '#feca57', '#48dbfb']);
-color.rainbow('preset rainbow integrado');
+// Colores básicos
+console.log(color.red('rojo'), color.green('verde'), color.blue('azul'));
+
+// Modificadores de estilo
+console.log(color.bold('negrita'), color.italic('itálica'), color.underline('subrayado'));
+
+// Gradiente multi-stop
+console.log(gradient('fuego a océano', ['#ff6b6b', '#feca57', '#48dbfb']));
+
+// Preset rainbow integrado
+console.log(rainbow('preset rainbow integrado'));
 ```
 
 ### ASCII Art
@@ -202,13 +209,13 @@ color.rainbow('preset rainbow integrado');
 ```ts
 import { ascii, gradient } from 'ansimax';
 
-ascii.banner('HOLA', {
+console.log(ascii.banner('HOLA', {
   font: 'big',
   align: 'center',
   colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9']),
-});
+}));
 
-ascii.box('¡Caja arcoiris!', { padding: 1, borderStyle: 'rounded' });
+console.log(ascii.box('¡Caja arcoiris!', { padding: 1, borderStyle: 'rounded' }));
 ```
 
 ### Árboles
@@ -235,7 +242,7 @@ console.log(proyecto.render({
 <img src="media/pixel_art.png" alt="Pixel art" />
 
 ```ts
-import { images, createCanvas, gradientRect } from 'ansimax';
+import { images, createCanvas, gradientRect, SPRITES } from 'ansimax';
 
 // Sprite integrado
 console.log(images.sprite('heart'));
@@ -251,7 +258,8 @@ console.log(gradientRect({
 const c = createCanvas(40, 10);
 c.fill({ r: 18, g: 18, b: 38 });
 c.drawCircle(20, 5, 4, { r: 255, g: 200, b: 0 }, true);
-c.drawSprite(2, 2, images.sprites.star!.pixels);
+const starSprite = SPRITES.star;
+if (starSprite) c.drawSprite(2, 2, starSprite.pixels);
 c.print();
 ```
 
@@ -262,15 +270,15 @@ c.print();
 ```ts
 import { components, color } from 'ansimax';
 
-components.table([
+console.log(components.table([
   ['Módulo',     'Estado',                'Cobertura'],
   ['colors',     color.green('● listo'),  '100%'],
   ['animations', color.green('● listo'),  '100%'],
   ['loaders',    color.green('● listo'),  '100%'],
-], { borderStyle: 'rounded' });
+], { borderStyle: 'rounded' }));
 
-components.badge('VERSION', 'v1.1.1');
-components.badge('BUILD',   'passing');
+console.log(components.badge('VERSION', 'v1.1.2'));
+console.log(components.badge('BUILD',   'passing'));
 ```
 
 ### Timeline
@@ -278,22 +286,24 @@ components.badge('BUILD',   'passing');
 <img src="media/timeline.png" alt="Timeline" />
 
 ```ts
-components.timeline([
+import { components } from 'ansimax';
+
+console.log(components.timeline([
   { label: 'Init del proyecto', done: true,  time: '10:00' },
   { label: 'Pipeline de build', done: true,  time: '10:15' },
   { label: 'Correr tests',      done: false, time: '10:32' },
   { label: 'Deploy a npm',      done: false },
-]);
+]));
 ```
 
 ### Loaders y Progreso
 
 ```ts
-import { loader } from 'ansimax';
+import { loader, sleep } from 'ansimax';
 
 // Spinner con éxito/fallo
 const stop = loader.spin('Cargando...', { color: '#bd93f9' });
-await tarea();
+await sleep(1500);
 stop('¡Listo!', true);   // ✓ ícono verde
 
 // Barra de progreso animada
@@ -303,18 +313,22 @@ await loader.progressAnimate(100, 'Descargando', {
 
 // Tareas jerárquicas con ejecución paralela
 await loader.tasks([
-  { text: 'Build', fn: async () => build(), subtasks: [
-    { text: 'TypeScript', fn: async () => tsc() },
-    { text: 'Bundle',     fn: async () => bundle() },
-  ]},
-  { text: 'Test',  fn: async () => test() },
+  {
+    text: 'Build',
+    fn: async () => await sleep(500),
+    subtasks: [
+      { text: 'TypeScript', fn: async () => await sleep(800) },
+      { text: 'Bundle',     fn: async () => await sleep(600) },
+    ],
+  },
+  { text: 'Test', fn: async () => await sleep(700) },
 ], { parallel: true });
 ```
 
 ### Animaciones
 
 ```ts
-import { animate, gradient } from 'ansimax';
+import { animate, gradient, sleep } from 'ansimax';
 
 await animate.typewriter('Bienvenido al wizard de deployment...', {
   speed: 30,
@@ -325,9 +339,9 @@ await animate.fadeIn('Carga completa', { duration: 600 });
 
 // Carrera de pasos contra timeout — nunca se cuelga
 await animate.parallel([
-  async () => await checkNetwork(),
-  async () => await checkDatabase(),
-  async () => await checkAuth(),
+  async () => await sleep(500),   // simulación de chequeo de red
+  async () => await sleep(700),   // simulación de chequeo de base de datos
+  async () => await sleep(400),   // simulación de chequeo de auth
 ], { timeout: 5000 });
 ```
 
@@ -340,7 +354,7 @@ import { themes, createTheme } from 'ansimax';
 
 // Temas built-in
 themes.use('dracula');
-themes.primary('hola');
+console.log(themes.primary('hola'));
 
 // Escuchar cambios
 const off = themes.onChange((nuevo, anterior) => {
@@ -350,7 +364,27 @@ const off = themes.onChange((nuevo, anterior) => {
 // Multi-tenant: cada instancia totalmente aislada
 const tenantA = createTheme('nord');
 const tenantB = createTheme('matrix');
-tenantA.register('custom', miDef);  // no se filtra a tenantB
+
+// Definir un tema personalizado y registrarlo SÓLO en tenantA
+tenantA.register('custom', {
+  name: 'Custom',
+  primary:   '#ff5e5e',
+  secondary: '#5e5eff',
+  accent:    '#5eff5e',
+  success:   '#10b981',
+  warning:   '#fbbf24',
+  error:     '#ef4444',
+  info:      '#06b6d4',
+  muted:     '#6b7280',
+  bg:        '#1e293b',
+  surface:   '#334155',
+  text:      '#f1f5f9',
+  gradient:  ['#ff5e5e', '#5eff5e', '#5e5eff'],
+});
+
+console.log('tenantA incluye custom?', tenantA.list().includes('custom'));
+console.log('tenantB incluye custom?', tenantB.list().includes('custom'));
+//                                     ↑ false — aislamiento total
 ```
 
 ---
@@ -421,11 +455,11 @@ const off = onConfigKeyChange('theme', (nuevo, anterior) => {
 
 // Override temporal + restauración automática al completar o lanzar
 await withConfig({ animationSpeed: 'fast' }, async () => {
-  await correrDemo();
+  // ...tu código en modo fast aquí...
 });
 
 // Modo strict captura typos en config
-configure({ unknwnKey: 'x' }, { strict: true });  // lanza RangeError
+// configure({ unknwnKey: 'x' }, { strict: true });  // lanza RangeError
 ```
 
 ---
@@ -645,6 +679,17 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.1.2 — Madurez y robustez
+
+Release patch enfocado en refinamientos de calidad — sin cambios en la API.
+
+- 🛡️ **Bump defensivo de `process.setMaxListeners`** — previene `MaxListenersExceededWarning` en setups con HMR / nodemon / ts-node-dev donde los módulos de ansimax re-registran handlers de restauración de cursor
+- 🧪 **`TypeError` uniforme para validación de themes** — `themes.register()` ahora arroja consistentemente `TypeError` para errores estructurales / de tipo (antes era mezcla de `Error` y `TypeError`)
+- 🎯 **`themes.use()` arroja `RangeError`** para nombres de tema desconocidos (antes `Error`) — mejor match semántico con "valor fuera del set permitido"
+- 📝 **Re-exports más limpios en el barrel** — comentario de header ahora documenta aliases legacy y recomienda nombres canónicos
+
+Drop-in replacement para `1.1.1`.
+
 ### v1.1.1 — Fixes de bugs + ejemplos limpios
 
 Release patch que arregla dos bugs encontrados en testing real de v1.1.0, más una carpeta de ejemplos refrescada.

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.1.1-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.1.2-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)
@@ -50,14 +50,14 @@ npm install ansimax
 ```
 
 ```ts
-import { color, gradient, ascii, loader } from 'ansimax';
+import { color, gradient, ascii, loader, sleep } from 'ansimax';
 
 console.log(ascii.banner('hello', {
   colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9', '#8be9fd']),
 }));
 
 const stop = loader.spin('Building project', { color: '#bd93f9' });
-await someAsyncWork();
+await sleep(1500);
 stop('Build complete', true);
 ```
 
@@ -123,14 +123,14 @@ yarn add ansimax
 ## ⚡ 30-second example
 
 ```ts
-import { color, gradient, loader, ascii } from 'ansimax';
+import { color, gradient, loader, ascii, sleep } from 'ansimax';
 
 console.log(ascii.banner('deploy', {
   colorFn: (t) => gradient(t, ['#ff6b6b', '#feca57', '#48dbfb']),
 }));
 
 const stop = loader.spin('Building project', { color: '#bd93f9' });
-await someAsyncWork();
+await sleep(1500);             // simulate async work
 stop('Build complete', true);  // ✓ + success color
 
 console.log(color.green('✓') + ' Ready in ' + color.bold('1.4s'));
@@ -187,12 +187,19 @@ console.log(themes.primary('cyberpunk primary'));
 <img src="media/colors.png" alt="Colors and gradients" />
 
 ```ts
-import { color, gradient } from 'ansimax';
+import { color, gradient, rainbow } from 'ansimax';
 
-color.red('red');   color.green('green');  color.blue('blue');
-color.bold(text);   color.italic(text);    color.underline(text);
-gradient('fire to ocean', ['#ff6b6b', '#feca57', '#48dbfb']);
-color.rainbow('built-in rainbow preset');
+// Basic colors
+console.log(color.red('red'), color.green('green'), color.blue('blue'));
+
+// Style modifiers
+console.log(color.bold('bold'), color.italic('italic'), color.underline('underlined'));
+
+// Multi-stop gradient
+console.log(gradient('fire to ocean', ['#ff6b6b', '#feca57', '#48dbfb']));
+
+// Built-in rainbow preset
+console.log(rainbow('built-in rainbow preset'));
 ```
 
 ### ASCII Art
@@ -202,13 +209,13 @@ color.rainbow('built-in rainbow preset');
 ```ts
 import { ascii, gradient } from 'ansimax';
 
-ascii.banner('HELLO', {
+console.log(ascii.banner('HELLO', {
   font: 'big',
   align: 'center',
   colorFn: (t) => gradient(t, ['#ff79c6', '#bd93f9']),
-});
+}));
 
-ascii.box('Rainbow box!', { padding: 1, borderStyle: 'rounded' });
+console.log(ascii.box('Rainbow box!', { padding: 1, borderStyle: 'rounded' }));
 ```
 
 ### Trees
@@ -235,7 +242,7 @@ console.log(project.render({
 <img src="media/pixel_art.png" alt="Pixel art" />
 
 ```ts
-import { images, createCanvas, gradientRect } from 'ansimax';
+import { images, createCanvas, gradientRect, SPRITES } from 'ansimax';
 
 // Built-in sprite
 console.log(images.sprite('heart'));
@@ -251,7 +258,8 @@ console.log(gradientRect({
 const c = createCanvas(40, 10);
 c.fill({ r: 18, g: 18, b: 38 });
 c.drawCircle(20, 5, 4, { r: 255, g: 200, b: 0 }, true);
-c.drawSprite(2, 2, images.sprites.star!.pixels);
+const starSprite = SPRITES.star;
+if (starSprite) c.drawSprite(2, 2, starSprite.pixels);
 c.print();
 ```
 
@@ -262,15 +270,15 @@ c.print();
 ```ts
 import { components, color } from 'ansimax';
 
-components.table([
+console.log(components.table([
   ['Module',     'Status',                'Coverage'],
   ['colors',     color.green('● ready'),  '100%'],
   ['animations', color.green('● ready'),  '100%'],
   ['loaders',    color.green('● ready'),  '100%'],
-], { borderStyle: 'rounded' });
+], { borderStyle: 'rounded' }));
 
-components.badge('VERSION', 'v1.1.1');
-components.badge('BUILD',   'passing');
+console.log(components.badge('VERSION', 'v1.1.2'));
+console.log(components.badge('BUILD',   'passing'));
 ```
 
 ### Timeline
@@ -278,22 +286,24 @@ components.badge('BUILD',   'passing');
 <img src="media/timeline.png" alt="Timeline" />
 
 ```ts
-components.timeline([
+import { components } from 'ansimax';
+
+console.log(components.timeline([
   { label: 'Project init',   done: true,  time: '10:00' },
   { label: 'Build pipeline', done: true,  time: '10:15' },
   { label: 'Run tests',      done: false, time: '10:32' },
   { label: 'Deploy to npm',  done: false },
-]);
+]));
 ```
 
 ### Loaders & Progress
 
 ```ts
-import { loader } from 'ansimax';
+import { loader, sleep } from 'ansimax';
 
 // Spinner with success/failure
 const stop = loader.spin('Loading...', { color: '#bd93f9' });
-await work();
+await sleep(1500);
 stop('Done!', true);   // ✓ green icon
 
 // Animated progress bar
@@ -303,18 +313,22 @@ await loader.progressAnimate(100, 'Downloading', {
 
 // Hierarchical tasks with parallel execution
 await loader.tasks([
-  { text: 'Build', fn: async () => build(), subtasks: [
-    { text: 'TypeScript', fn: async () => tsc() },
-    { text: 'Bundle',     fn: async () => bundle() },
-  ]},
-  { text: 'Test',  fn: async () => test() },
+  {
+    text: 'Build',
+    fn: async () => await sleep(500),
+    subtasks: [
+      { text: 'TypeScript', fn: async () => await sleep(800) },
+      { text: 'Bundle',     fn: async () => await sleep(600) },
+    ],
+  },
+  { text: 'Test', fn: async () => await sleep(700) },
 ], { parallel: true });
 ```
 
 ### Animations
 
 ```ts
-import { animate, gradient } from 'ansimax';
+import { animate, gradient, sleep } from 'ansimax';
 
 await animate.typewriter('Welcome to the deployment wizard...', {
   speed: 30,
@@ -325,9 +339,9 @@ await animate.fadeIn('Loading complete', { duration: 600 });
 
 // Race steps against a timeout — never hang
 await animate.parallel([
-  async () => await checkNetwork(),
-  async () => await checkDatabase(),
-  async () => await checkAuth(),
+  async () => await sleep(500),   // simulated network check
+  async () => await sleep(700),   // simulated database check
+  async () => await sleep(400),   // simulated auth check
 ], { timeout: 5000 });
 ```
 
@@ -340,7 +354,7 @@ import { themes, createTheme } from 'ansimax';
 
 // Built-in themes
 themes.use('dracula');
-themes.primary('hello');
+console.log(themes.primary('hello'));
 
 // Listen for changes
 const off = themes.onChange((newTheme, oldTheme) => {
@@ -350,7 +364,27 @@ const off = themes.onChange((newTheme, oldTheme) => {
 // Multi-tenant: each instance fully isolated
 const tenantA = createTheme('nord');
 const tenantB = createTheme('matrix');
-tenantA.register('custom', myDef);  // doesn't leak to tenantB
+
+// Define a custom theme and register it ONLY in tenantA
+tenantA.register('custom', {
+  name: 'Custom',
+  primary:   '#ff5e5e',
+  secondary: '#5e5eff',
+  accent:    '#5eff5e',
+  success:   '#10b981',
+  warning:   '#fbbf24',
+  error:     '#ef4444',
+  info:      '#06b6d4',
+  muted:     '#6b7280',
+  bg:        '#1e293b',
+  surface:   '#334155',
+  text:      '#f1f5f9',
+  gradient:  ['#ff5e5e', '#5eff5e', '#5e5eff'],
+});
+
+console.log('tenantA themes include custom?', tenantA.list().includes('custom'));
+console.log('tenantB themes include custom?', tenantB.list().includes('custom'));
+//                                            ↑ false — full isolation
 ```
 
 ---
@@ -421,11 +455,11 @@ const off = onConfigKeyChange('theme', (newTheme, oldTheme) => {
 
 // Temporary override + auto-restore on completion or throw
 await withConfig({ animationSpeed: 'fast' }, async () => {
-  await runDemo();
+  // ...your fast-mode code here...
 });
 
 // Strict mode catches config typos
-configure({ unknwnKey: 'x' }, { strict: true });  // throws RangeError
+// configure({ unknwnKey: 'x' }, { strict: true });  // throws RangeError
 ```
 
 ---
@@ -645,6 +679,17 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.1.2 — Maturity & robustness
+
+Patch release focused on quality refinements — no API changes.
+
+- 🛡️ **`process.setMaxListeners` defensive bump** — prevents `MaxListenersExceededWarning` in HMR / nodemon / ts-node-dev setups where ansimax modules re-register cursor-restore handlers
+- 🧪 **Uniform `TypeError` for theme validation** — `themes.register()` now consistently throws `TypeError` for structural / type errors (was a mix of `Error` and `TypeError`)
+- 🎯 **`themes.use()` throws `RangeError`** for unknown theme names (was `Error`) — better semantic match for "value out of allowed set"
+- 📝 **Cleaner barrel re-exports** — header comment now documents legacy aliases and recommends canonical names
+
+Drop-in replacement for `1.1.1`.
+
 ### v1.1.1 — Bug fixes + cleaner examples
 
 Patch release fixing two bugs from real-world v1.1.0 testing, plus a refreshed examples folder.

package/dist/index.js

@@ -225,6 +225,11 @@ var cursor = {
 var _exitHandlerRegistered = false;
 var _isTestEnv = () => process.env["JEST_WORKER_ID"] !== void 0 || process.env["VITEST"] !== void 0 || process.env["NODE_ENV"] === "test";
 var _installCursorRestoreImpl = () => {
+  try {
+    const current = process.getMaxListeners?.() ?? 10;
+    if (current < 20) process.setMaxListeners?.(20);
+  } catch {
+  }
   const restore = () => {
     try {
       safeStreamWrite(process.stdout, cursor.show());
@@ -4113,12 +4118,12 @@ var validateTheme = (t) => {
   }
   const obj = t;
   if (typeof obj.name !== "string" || obj.name.length === 0) {
-    throw new Error('Theme must have a non-empty "name" string.');
+    throw new TypeError('Theme must have a non-empty "name" string.');
   }
   for (const key of REQUIRED_COLOR_KEYS) {
     const value = obj[key];
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}. Expected #RGB or #RRGGBB.`
       );
     }
@@ -4127,20 +4132,20 @@ var validateTheme = (t) => {
     const value = obj[key];
     if (value === void 0) continue;
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}.`
       );
     }
   }
   if (!Array.isArray(obj.gradient) || obj.gradient.length < 2) {
-    throw new Error(
+    throw new TypeError(
       `Theme "${obj.name}" must define a "gradient" array with at least 2 colors.`
     );
   }
   for (let i = 0; i < obj.gradient.length; i++) {
     const stop = obj.gradient[i];
     if (typeof stop !== "string" || !HEX_RE4.test(stop)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 gradient[${i}]: ${JSON.stringify(stop)}.`
       );
     }
@@ -4452,8 +4457,8 @@ var themes = {
   use(name) {
     const t = _globalRegistry.get(name);
     if (!t) {
-      throw new Error(
-        `Theme "${name}" not found. Available: ${[..._globalRegistry.keys()].join(", ")}`
+      throw new RangeError(
+        `Theme "${name}" not found. Available themes: ${[..._globalRegistry.keys()].join(", ")}`
       );
     }
     const old = _globalActive;

package/dist/index.mjs

@@ -53,6 +53,11 @@ var cursor = {
 var _exitHandlerRegistered = false;
 var _isTestEnv = () => process.env["JEST_WORKER_ID"] !== void 0 || process.env["VITEST"] !== void 0 || process.env["NODE_ENV"] === "test";
 var _installCursorRestoreImpl = () => {
+  try {
+    const current = process.getMaxListeners?.() ?? 10;
+    if (current < 20) process.setMaxListeners?.(20);
+  } catch {
+  }
   const restore = () => {
     try {
       safeStreamWrite(process.stdout, cursor.show());
@@ -3941,12 +3946,12 @@ var validateTheme = (t) => {
   }
   const obj = t;
   if (typeof obj.name !== "string" || obj.name.length === 0) {
-    throw new Error('Theme must have a non-empty "name" string.');
+    throw new TypeError('Theme must have a non-empty "name" string.');
   }
   for (const key of REQUIRED_COLOR_KEYS) {
     const value = obj[key];
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}. Expected #RGB or #RRGGBB.`
       );
     }
@@ -3955,20 +3960,20 @@ var validateTheme = (t) => {
     const value = obj[key];
     if (value === void 0) continue;
     if (typeof value !== "string" || !HEX_RE4.test(value)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 ${key}: ${JSON.stringify(value)}.`
       );
     }
   }
   if (!Array.isArray(obj.gradient) || obj.gradient.length < 2) {
-    throw new Error(
+    throw new TypeError(
       `Theme "${obj.name}" must define a "gradient" array with at least 2 colors.`
     );
   }
   for (let i = 0; i < obj.gradient.length; i++) {
     const stop = obj.gradient[i];
     if (typeof stop !== "string" || !HEX_RE4.test(stop)) {
-      throw new Error(
+      throw new TypeError(
         `Invalid hex in theme "${obj.name}" \u2192 gradient[${i}]: ${JSON.stringify(stop)}.`
       );
     }
@@ -4280,8 +4285,8 @@ var themes = {
   use(name) {
     const t = _globalRegistry.get(name);
     if (!t) {
-      throw new Error(
-        `Theme "${name}" not found. Available: ${[..._globalRegistry.keys()].join(", ")}`
+      throw new RangeError(
+        `Theme "${name}" not found. Available themes: ${[..._globalRegistry.keys()].join(", ")}`
       );
     }
     const old = _globalActive;

package/examples/all-in-one.cjs

@@ -118,7 +118,7 @@ async function main() {
   console.log(components.section('🏷️  Badges & Status', { width: 60 }));
   console.log();
   console.log(' ',
-    components.badge('VERSION', 'v1.1.1'),
+    components.badge('VERSION', 'v1.1.2'),
     components.badge('BUILD', 'passing'),
     components.badge('LICENSE', 'Apache 2.0'));
   console.log();

package/examples/all-in-one.mjs

@@ -117,7 +117,7 @@ console.log();
 console.log(components.section('🏷️  Badges & Status', { width: 60 }));
 console.log();
 console.log(' ',
-  components.badge('VERSION', 'v1.1.1'),
+  components.badge('VERSION', 'v1.1.2'),
   components.badge('BUILD', 'passing'),
   components.badge('LICENSE', 'Apache 2.0'));
 console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "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",