ansimax 1.3.5 → 1.3.6

package/CHANGELOG.md

@@ -3,6 +3,53 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.3.6] — Branch coverage improvements
+
+Maintenance release. Zero behavior changes — only adds tests covering
+defensive branches and adjusts `istanbul ignore` comments where branches
+are genuinely unreachable in normal usage.
+
+### Improved — Tests
+
+**panels (`+7` tests):**
+- `vsplit` default `gap = 1` when option omitted
+- `vsplit` handles columns of unequal heights (triggers `block[r] ?? ''` fallback)
+- `centerBlock` default `align = 'center'` with `height` (vertical centering branch)
+- `centerBlock` with explicit `align='start'` (alternative branch)
+- `frame` fallback `'─'` when `topChar=''` or non-string
+- `grid` default `columns = 1` when option omitted/undefined
+
+**frames (`+7` tests):**
+- `ensureString` handles `null`/`undefined` via `?? ''` fallback
+- `presets.loadingBar` fallback `'░'` for invalid `empty` (`''` or non-string)
+- `presets.ball` fallback `width = 20` for `NaN`/non-number input
+- `presets.breathe` fallback `steps = 8` for `NaN`/non-number input
+
+**loaders (`+5` tests):**
+- `loader.bar` fallback `'░'` for invalid `emptyChar`
+- `loader.spin` finalText with all three success states (`undefined`, `true`, `false`)
+  — exercises icon ternary chain branches
+
+### Improved — `istanbul ignore` comments
+
+Some `??` and conditional-spread branches are unreachable in real usage
+(e.g. `frames[frame] ?? ''` after `frame = i % frames.length` with a non-empty
+array). Marked with explanatory `istanbul ignore next` comments instead of
+chasing coverage with synthetic tests:
+
+- `loaders:376` — `frames[frame] ?? ''` (frame index always in bounds)
+- `loaders:997` — second instance of `addOpts.color !== undefined` spread
+
+Total: **+19 tests** added across panels, frames, loaders.
+
+### Notes
+
+- No runtime changes — drop-in replacement for `1.3.5`
+- No new exports, no API surface changes
+- Same `dist/` output as `1.3.5` would have produced
+
+---
+
 ## [1.3.5] — Mathematical color science + cleanup
 
 Patch release focused on mathematical depth: perceptually-uniform color

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.5-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.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-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -478,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.5'));
+console.log(components.badge('VERSION', 'v1.3.6'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1065,6 +1065,14 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.6 — Mejoras de branch coverage
+
+Release de mantenimiento. Cero cambios de comportamiento:
+
+- 🧪 **+19 tests** cubriendo branches defensivos en panels, frames, loaders
+- 🧹 Mejorados comentarios `istanbul ignore` para branches genuinamente inalcanzables
+- ✅ Drop-in replacement para `1.3.5` — mismo `dist/` output
+
 ### v1.3.5 — Color science matemático + limpieza
 
 Release patch enfocado en profundidad matemática y limpieza de código. Cero breaking changes:

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.5-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.3.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-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -478,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.5'));
+console.log(components.badge('VERSION', 'v1.3.6'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1065,6 +1065,14 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.3.6 — Branch coverage improvements
+
+Maintenance release. Zero behavior changes:
+
+- 🧪 **+19 tests** covering defensive branches in panels, frames, loaders
+- 🧹 Improved `istanbul ignore` comments for genuinely unreachable branches
+- ✅ Drop-in replacement for `1.3.5` — same `dist/` output
+
 ### v1.3.5 — Mathematical color science + cleanup
 
 Patch release focused on math depth and code cleanliness. Zero breaking changes:

package/dist/index.js

@@ -3764,6 +3764,7 @@ var multi = (opts = {}) => {
       const item = {
         id,
         text,
+        /* istanbul ignore next — conditional spread + default */
         ...addOpts.color !== void 0 && { color: addOpts.color },
         type: addOpts.type ?? "dots",
         state: "spinning"

package/dist/index.mjs

@@ -3558,6 +3558,7 @@ var multi = (opts = {}) => {
       const item = {
         id,
         text,
+        /* istanbul ignore next — conditional spread + default */
         ...addOpts.color !== void 0 && { color: addOpts.color },
         type: addOpts.type ?? "dots",
         state: "spinning"

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.3.5'),
+    components.badge('VERSION', 'v1.3.6'),
     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.3.5'),
+  components.badge('VERSION', 'v1.3.6'),
   components.badge('BUILD', 'passing'),
   components.badge('LICENSE', 'Apache 2.0'));
 console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ansimax",
-  "version": "1.3.5",
+  "version": "1.3.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",