ansimax 1.4.0 → 1.4.2

package/dist/index.mjs

@@ -412,6 +412,15 @@ var clampInt = (value, min, max, fallback = 0) => {
   }
   return Math.max(min, Math.min(max, Math.floor(value)));
 };
+var ensureString2 = (v) => typeof v === "string" ? v : String(v ?? "");
+var clampNonNeg = (n, fallback = 0) => {
+  if (!isFiniteNumber2(n)) return Math.max(0, Math.floor(fallback));
+  return Math.max(0, Math.floor(n));
+};
+var clampPositiveInt = (n, fallback = 1) => {
+  if (!isFiniteNumber2(n)) return Math.max(1, Math.floor(fallback));
+  return Math.max(1, Math.floor(n));
+};
 var HEX_RE = /^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
 var isHexColor = (hex) => typeof hex === "string" && HEX_RE.test(hex.trim());
 var hexToRgb = (hex) => {
@@ -2364,7 +2373,7 @@ var clearRenderCache = () => {
   _renderCache.clear();
 };
 var getRenderCacheSize = () => _renderCache.size;
-var ensureString2 = (value, paramName) => {
+var ensureString3 = (value, paramName) => {
   if (typeof value !== "string") {
     throw new TypeError(
       `ascii: ${paramName} must be a string, got ${typeof value}`
@@ -2503,15 +2512,15 @@ var BOX_STYLES = {
   ascii: { tl: "+", tr: "+", bl: "+", br: "+", h: "-", v: "|" }
 };
 var big = (text) => {
-  const safe = ensureString2(text, "big(text)");
+  const safe = ensureString3(text, "big(text)");
   return renderFont(safe, BLOCK, { _fontKey: "big" });
 };
 var small = (text) => {
-  const safe = ensureString2(text, "small(text)");
+  const safe = ensureString3(text, "small(text)");
   return renderFont(safe, SMALL, { _fontKey: "small" });
 };
 var figlet = (text, opts = {}) => {
-  const safe = ensureString2(text, "figlet(text)");
+  const safe = ensureString3(text, "figlet(text)");
   const fontName = opts.font ?? "big";
   const fontMap = FONTS[fontName] ?? BLOCK;
   return renderFont(safe, fontMap, {
@@ -2521,7 +2530,7 @@ var figlet = (text, opts = {}) => {
   });
 };
 var stageRender = (text, font, letterSpacing) => {
-  const safe = ensureString2(text, "stageRender(text)");
+  const safe = ensureString3(text, "stageRender(text)");
   const fontMap = FONTS[font] ?? BLOCK;
   const renderOpts = { _fontKey: typeof font === "string" ? font : "big" };
   if (letterSpacing !== void 0) renderOpts.letterSpacing = letterSpacing;
@@ -2563,7 +2572,7 @@ var stageColorize = (rendered, colorFn, perCharColor) => {
   return rendered.split("\n").map(colorFn).join("\n");
 };
 var banner = (text, opts = {}) => {
-  const safe = ensureString2(text, "banner(text)");
+  const safe = ensureString3(text, "banner(text)");
   const {
     font = "big",
     colorFn = null,
@@ -2577,7 +2586,7 @@ var banner = (text, opts = {}) => {
   return result;
 };
 var box = (text, opts = {}) => {
-  const safe = ensureString2(text, "box(text)");
+  const safe = ensureString3(text, "box(text)");
   const {
     padding = 1,
     borderStyle = "rounded",
@@ -2658,7 +2667,7 @@ var divider = (opts = {}) => {
   return fill.repeat(w);
 };
 var logo = (text, opts = {}) => {
-  const safe = ensureString2(text, "logo(text)");
+  const safe = ensureString3(text, "logo(text)");
   const { gradient: gfn = null, boxStyle = "double", centered = true } = opts;
   if (!safe.length) return box("", { borderStyle: boxStyle, padding: 1 });
   const art = big(safe);
@@ -2672,7 +2681,7 @@ var logo = (text, opts = {}) => {
   return box(lines.join("\n"), { borderStyle: boxStyle, padding: 1 });
 };
 var measure = (text, font = "big", letterSpacing) => {
-  const safe = ensureString2(text, "measure(text)");
+  const safe = ensureString3(text, "measure(text)");
   if (!safe.length) return { width: 0, height: 0 };
   const rendered = stageRender(safe, font, letterSpacing);
   const lines = rendered.split("\n");
@@ -2680,7 +2689,7 @@ var measure = (text, font = "big", letterSpacing) => {
   return { width, height: lines.length };
 };
 var stream = async function* (text, opts = {}) {
-  const safe = ensureString2(text, "stream(text)");
+  const safe = ensureString3(text, "stream(text)");
   const { font = "big", letterSpacing, granularity = "row", signal } = opts;
   if (!safe.length) return;
   if (signal?.aborted) return;
@@ -3046,11 +3055,6 @@ var ascii = {
 
 // src/loaders/index.ts
 var canAnimate2 = () => Boolean(process.stdout?.isTTY) && supportsColor() !== "none";
-var ensureString3 = (v) => typeof v === "string" ? v : String(v ?? "");
-var clampPositiveInt = (n, fallback) => {
-  if (!isFiniteNumber2(n)) return fallback;
-  return Math.max(1, Math.floor(n));
-};
 var isUnicodeCapable = () => {
   const env = process.env;
   if (env["CI"]) return true;
@@ -3167,9 +3171,9 @@ var spin = (text = "Loading", opts = {}) => {
     signal,
     reducedMotion = false
   } = opts;
-  const safeText = ensureString3(text);
-  const safePrefix = ensureString3(prefix);
-  const safeSuffix = ensureString3(suffix);
+  const safeText = ensureString2(text);
+  const safePrefix = ensureString2(prefix);
+  const safeSuffix = ensureString2(suffix);
   const safeInterval = clampPositiveInt(interval, 80);
   registerCrashHandlers2();
   const frames2 = resolveSpinnerFrames(type);
@@ -3181,7 +3185,7 @@ var spin = (text = "Loading", opts = {}) => {
     return (finalText, success) => {
       if (finalText !== void 0) {
         const icon = success === false ? "\u2717" : success === true ? "\u2713" : "";
-        write(`${safePrefix}${icon ? icon + " " : ""}${ensureString3(finalText)}${safeSuffix}`);
+        write(`${safePrefix}${icon ? icon + " " : ""}${ensureString2(finalText)}${safeSuffix}`);
         if (persist) writeln();
       }
     };
@@ -3222,7 +3226,7 @@ var spin = (text = "Loading", opts = {}) => {
     if (finalText !== void 0) {
       const icon = success === false ? sgr(FG.red) + "\u2717" + reset() : success === true ? sgr(FG.green) + "\u2713" + reset() : "";
       const line = padToTerminalWidth(
-        `${safePrefix}${icon ? icon + " " : ""}${ensureString3(finalText)}${safeSuffix}`
+        `${safePrefix}${icon ? icon + " " : ""}${ensureString2(finalText)}${safeSuffix}`
       );
       write(line);
       if (persist) writeln();
@@ -3251,7 +3255,7 @@ var progress = (percent, label = "", opts = {}) => {
   const safeWidth = clampPositiveInt(width, 30);
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2588";
   const safeEmpty = typeof emptyChar === "string" && emptyChar.length > 0 ? emptyChar : "\u2591";
-  const safeLabel = ensureString3(label);
+  const safeLabel = ensureString2(label);
   const clamped = clampPercent(percent);
   const filled = Math.floor(clamped / 100 * safeWidth);
   const empty = Math.max(0, safeWidth - filled);
@@ -3441,7 +3445,7 @@ var custom = (frames2, text = "", opts = {}) => {
 var countdown = async (seconds, opts = {}) => {
   const { label = "Starting in", color: hex, signal } = opts;
   const safeSeconds = isFiniteNumber2(seconds) ? Math.max(0, Math.floor(seconds)) : 0;
-  const safeLabel = ensureString3(label);
+  const safeLabel = ensureString2(label);
   const colorToUse = safeColor(hex) ? hex : "#ffd700";
   if (!canAnimate2() || signal?.aborted) {
     const final = applyColor(String(safeSeconds), colorToUse);
@@ -3648,7 +3652,6 @@ var loader = {
 };
 
 // src/frames/index.ts
-var ensureString4 = (v) => typeof v === "string" ? v : String(v ?? "");
 var MAX_FPS = 60;
 var clampFps = (fps, fallback) => {
   if (!isFiniteNumber2(fps)) return fallback;
@@ -3789,7 +3792,7 @@ var play = (frames2, opts = {}) => {
     } catch {
       rendered = frame2;
     }
-    const safe = ensureString4(rendered);
+    const safe = ensureString2(rendered);
     try {
       write(safe);
     } catch {
@@ -3899,7 +3902,7 @@ var generate = (count, fn) => {
   if (typeof fn !== "function") return Array(safeCount).fill("");
   return Array.from({ length: safeCount }, (_, i) => {
     try {
-      return ensureString4(fn(i, safeCount));
+      return ensureString2(fn(i, safeCount));
     } catch {
       return "";
     }
@@ -3957,15 +3960,15 @@ var live = (opts = {}) => {
     if (wasRunning) showCursorSafe2();
   };
   const update = (newFrame) => {
-    currentFrame = ensureString4(newFrame);
+    currentFrame = ensureString2(newFrame);
     if (running) render2();
   };
   if (autoStart) start();
   return { start, stop, update, isRunning: () => running };
 };
 var morph = (frameA, frameB, steps = 8, charset = "\u2591\u2592\u2593\u2588\u2593\u2592\u2591") => {
-  const a0 = ensureString4(frameA);
-  const b0 = ensureString4(frameB);
+  const a0 = ensureString2(frameA);
+  const b0 = ensureString2(frameB);
   if (!a0 && !b0) return [""];
   const n = Math.max(2, isFiniteNumber2(steps) ? Math.floor(steps) : 8);
   const len = Math.max(a0.length, b0.length);
@@ -3992,7 +3995,7 @@ var presets2 = {
     const safeWidth = Math.max(0, isFiniteNumber2(width) ? Math.floor(width) : 20);
     const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2588";
     const safeEmpty = typeof empty === "string" && empty.length > 0 ? empty : "\u2591";
-    const safeLabel = ensureString4(label);
+    const safeLabel = ensureString2(label);
     return generate(safeWidth + 1, (i) => {
       const filled = safeChar.repeat(i);
       const rest = safeEmpty.repeat(safeWidth - i);
@@ -4012,7 +4015,7 @@ var presets2 = {
   /* istanbul ignore next — default opts {} */
   breathe: (text, opts = {}) => {
     const { steps = 8 } = opts;
-    const safeText = ensureString4(text);
+    const safeText = ensureString2(text);
     const safeSteps2 = Math.max(1, isFiniteNumber2(steps) ? Math.floor(steps) : 8);
     const shades = ["\u2591", "\u2592", "\u2593", "\u2588"];
     return generate(safeSteps2 * 2, (i) => {
@@ -4024,7 +4027,7 @@ var presets2 = {
   /* istanbul ignore next — default opts {} */
   typeDelete: (text, opts = {}) => {
     const { cursor: cur = "\u258C" } = opts;
-    const safeText = ensureString4(text);
+    const safeText = ensureString2(text);
     const safeCur = typeof cur === "string" ? cur : "\u258C";
     const typed = generate(safeText.length + 1, (i) => safeText.slice(0, i) + safeCur);
     const deleted = generate(safeText.length + 1, (i) => safeText.slice(0, safeText.length - i) + safeCur);
@@ -4034,15 +4037,6 @@ var presets2 = {
 var frames = { play, generate, live, morph, presets: presets2 };
 
 // src/components/index.ts
-var ensureString5 = (v) => typeof v === "string" ? v : String(v ?? "");
-var clampNonNeg = (n, fallback) => {
-  if (!isFiniteNumber2(n)) return fallback;
-  return Math.max(0, Math.floor(n));
-};
-var clampPositive2 = (n, fallback) => {
-  if (!isFiniteNumber2(n)) return fallback;
-  return Math.max(1, Math.floor(n));
-};
 var safeSgrCode = (code, fallback) => {
   if (!isFiniteNumber2(code)) return fallback;
   return Math.max(0, Math.min(255, Math.floor(code)));
@@ -4089,7 +4083,7 @@ var table = (rows, opts = {}) => {
   if (cols === 0) return "";
   const processedRows = validRows.map(
     (row) => Array.from({ length: cols }, (_, ci) => {
-      const raw = ensureString5(row[ci]);
+      const raw = ensureString2(row[ci]);
       const lines2 = raw.split("\n");
       return safeMaxCol !== null ? lines2.map((l) => truncateVisible(l, safeMaxCol)) : lines2;
     })
@@ -4140,8 +4134,8 @@ var badge = (label, value, opts = {}) => {
     padding = 1,
     border = false
   } = opts;
-  const safeLabel = ensureString5(label);
-  const safeValue = ensureString5(value);
+  const safeLabel = ensureString2(label);
+  const safeValue = ensureString2(value);
   const safePadding = clampNonNeg(padding, 1);
   const pad = " ".repeat(safePadding);
   const lhs = sgr(safeSgrCode(labelBg, BG.blue), safeSgrCode(labelFg, FG.white)) + pad + safeLabel + pad + reset();
@@ -4165,10 +4159,10 @@ var progressBar = (percent, opts = {}) => {
     color: color2 = null,
     gradient: gradientStops2 = null
   } = opts;
-  const safeWidth = clampPositive2(width, 30);
+  const safeWidth = clampPositiveInt(width, 30);
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2588";
   const safeEmpty = typeof emptyChar === "string" && emptyChar.length > 0 ? emptyChar : "\u2591";
-  const safeLabel = ensureString5(label);
+  const safeLabel = ensureString2(label);
   const clamped = clampPercent(percent);
   const filled = Math.floor(clamped / 100 * safeWidth);
   const empty = Math.max(0, safeWidth - filled);
@@ -4195,7 +4189,7 @@ var status = (type, message, opts = {}) => {
   const def = STATUS_MAP[type] ?? STATUS_MAP.info;
   const colorCode = opts.color !== void 0 ? safeSgrCode(opts.color, def.color) : def.color;
   const useIcon = opts.icon === void 0 ? def.icon : opts.icon ?? "";
-  const safeMsg = ensureString5(message);
+  const safeMsg = ensureString2(message);
   const iconPart = useIcon ? sgr(colorCode) + useIcon + reset() + " " : "";
   if (safeMsg.includes("\n")) {
     const indent = " ".repeat(useIcon ? visibleLen(useIcon) + 1 : 0);
@@ -4207,7 +4201,7 @@ var status = (type, message, opts = {}) => {
 var section = (title, opts = {}) => {
   const { char = "\u2500", width = null, color: colorCode = FG.cyan } = opts;
   const { cols } = termSize();
-  const safeTitle = ensureString5(title);
+  const safeTitle = ensureString2(title);
   const safeChar = typeof char === "string" && char.length > 0 ? char : "\u2500";
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const titleLen = visibleLen(safeTitle);
@@ -4222,7 +4216,7 @@ var section = (title, opts = {}) => {
 var columns = (items, opts = {}) => {
   if (!Array.isArray(items) || items.length === 0) return "";
   const { cols: numCols = 2, gap = 2, width = null, overflow = "truncate" } = opts;
-  const safeCols = clampPositive2(numCols, 2);
+  const safeCols = clampPositiveInt(numCols, 2);
   const safeGap = clampNonNeg(gap, 2);
   const { cols: termCols } = termSize();
   const totalW = width !== null && isFiniteNumber2(width) ? Math.max(safeCols, Math.floor(width)) : termCols;
@@ -4232,7 +4226,7 @@ var columns = (items, opts = {}) => {
   for (let i = 0; i < items.length; i += safeCols) {
     const chunk = items.slice(i, i + safeCols);
     if (overflow === "wrap") {
-      const cellLines = chunk.map((it) => wrapVisible(ensureString5(it), colW));
+      const cellLines = chunk.map((it) => wrapVisible(ensureString2(it), colW));
       const rowHeight = Math.max(...cellLines.map((c) => c.length), 1);
       for (let line = 0; line < rowHeight; line++) {
         rows.push(
@@ -4242,7 +4236,7 @@ var columns = (items, opts = {}) => {
     } else {
       rows.push(
         chunk.map((item) => {
-          const t = truncateVisible(ensureString5(item), colW);
+          const t = truncateVisible(ensureString2(item), colW);
           return padEnd(t, colW);
         }).join(gapStr)
       );
@@ -4265,15 +4259,15 @@ var timeline = (events, opts = {}) => {
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const safeDoneColor = safeSgrCode(doneColor, FG.green);
   const safePendingColor = safeSgrCode(pendingColor, FG.brightBlack);
-  const computedTimeWidth = timeColumnWidth !== null && isFiniteNumber2(timeColumnWidth) ? Math.max(0, Math.floor(timeColumnWidth)) : Math.max(0, ...events.map((e) => e.time ? visibleLen(ensureString5(e.time)) : 0));
+  const computedTimeWidth = timeColumnWidth !== null && isFiniteNumber2(timeColumnWidth) ? Math.max(0, Math.floor(timeColumnWidth)) : Math.max(0, ...events.map((e) => e.time ? visibleLen(ensureString2(e.time)) : 0));
   const lines = [];
   events.forEach((ev, i) => {
     const isLast = i === events.length - 1;
-    const evLabel = ensureString5(ev.label);
+    const evLabel = ensureString2(ev.label);
     const clr = ev.done ? safeDoneColor : i === 0 ? safeColor2 : safePendingColor;
     const nodeStr = sgr(clr) + safeNode + reset();
     const textStr = ev.done ? sgr(STYLE.bold) + evLabel + reset() : sgr(safePendingColor) + evLabel + reset();
-    const timePart = ev.time && computedTimeWidth > 0 ? "  " + sgr(FG.brightBlack) + padEnd(ensureString5(ev.time), computedTimeWidth) + reset() : "";
+    const timePart = ev.time && computedTimeWidth > 0 ? "  " + sgr(FG.brightBlack) + padEnd(ensureString2(ev.time), computedTimeWidth) + reset() : "";
     lines.push(`${nodeStr} ${textStr}${timePart}`);
     if (!isLast) lines.push(sgr(safePendingColor) + safeConnector + reset());
   });
@@ -4295,8 +4289,8 @@ var menu = (items, opts = {}) => {
   if (!inp.isTTY) return Promise.resolve(multiSelect ? [] : 0);
   const safeColor2 = safeSgrCode(colorCode, FG.cyan);
   const safePointer = typeof pointer === "string" && pointer.length > 0 ? pointer : "\u25B6";
-  const safeTitle = title === null ? null : ensureString5(title);
-  const safeItems = items.map(ensureString5);
+  const safeTitle = title === null ? null : ensureString2(title);
+  const safeItems = items.map(ensureString2);
   let cursorPos = 0;
   let lastRenderedLines = 0;
   let cursorHidden = false;
@@ -4457,19 +4451,14 @@ var STYLES = {
   heavy: { branch: "\u2523\u2501\u2501 ", last: "\u2517\u2501\u2501 ", vert: "\u2503   ", space: "    " },
   ascii: { branch: "+-- ", last: "`-- ", vert: "|   ", space: "    " }
 };
-var ensureString6 = (v) => typeof v === "string" ? v : String(v ?? "");
-var clampNonNeg2 = (n, fallback) => {
-  if (!isFiniteNumber2(n)) return fallback;
-  return Math.max(0, Math.floor(n));
-};
 var normalizeNewlines = (s) => s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
 var toTreeData = (child) => {
   if (typeof child === "string") return { label: child, children: [] };
   if (typeof child !== "object" || child === null || Array.isArray(child)) {
-    return { label: ensureString6(child), children: [] };
+    return { label: ensureString2(child), children: [] };
   }
   return {
-    label: ensureString6(child.label ?? ""),
+    label: ensureString2(child.label ?? ""),
     children: [],
     ...child
   };
@@ -4505,8 +4494,8 @@ var paletteAt = (palette, depth) => {
 };
 var formatNode = (node, depth, palette) => {
   const colorFn = node.color ?? paletteAt(palette, depth);
-  const safeLabel = normalizeNewlines(ensureString6(node.label));
-  const iconPrefix = node.icon ? ensureString6(node.icon) + " " : "";
+  const safeLabel = normalizeNewlines(ensureString2(node.label));
+  const iconPrefix = node.icon ? ensureString2(node.icon) + " " : "";
   const labelLines = safeLabel.split("\n");
   return labelLines.map((line, i) => {
     const text = i === 0 ? iconPrefix + line : line;
@@ -4600,7 +4589,7 @@ var renderTree = (root, opts = {}) => {
     indent = 0
   } = opts;
   const safeStyle = style && STYLES[style] ? style : "normal";
-  const safeIndent = clampNonNeg2(indent, 0);
+  const safeIndent = clampNonNeg(indent, 0);
   const safeMaxDepth = isFiniteNumber2(maxDepth) ? Math.max(0, Math.floor(maxDepth)) : Infinity;
   const indentStr = " ".repeat(safeIndent);
   const lines = [];
@@ -5946,37 +5935,105 @@ var grid = (blocks, opts) => {
   const alignX = opts.alignX ?? "start";
   const alignY = opts.alignY ?? "start";
   const cellW = opts.cellWidth != null ? Math.max(0, Math.floor(opts.cellWidth)) : null;
-  const rows = [];
-  for (let i = 0; i < blocks.length; i += columns2) {
-    rows.push(blocks.slice(i, i + columns2));
+  const cellH = opts.cellHeight != null ? Math.max(1, Math.floor(opts.cellHeight)) : null;
+  const flow = opts.flow === "column" ? "column" : "row";
+  const spans = blocks.map((_, i) => {
+    const raw = opts.colSpan?.[i];
+    if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 1) return 1;
+    return Math.min(columns2, Math.floor(raw));
+  });
+  const hasSpans = spans.some((s) => s > 1);
+  const cellRows = [];
+  if (flow === "column" && !hasSpans) {
+    const rowCount = Math.ceil(blocks.length / columns2);
+    for (let r = 0; r < rowCount; r++) cellRows.push([]);
+    for (let i = 0; i < blocks.length; i++) {
+      const c = Math.floor(i / rowCount);
+      const r = i % rowCount;
+      cellRows[r].push({ block: blocks[i], span: 1, col: c });
+    }
+  } else {
+    let row = [];
+    let colInRow = 0;
+    for (let i = 0; i < blocks.length; i++) {
+      const span = spans[i];
+      if (colInRow + span > columns2 && row.length > 0) {
+        cellRows.push(row);
+        row = [];
+        colInRow = 0;
+      }
+      row.push({ block: blocks[i], span, col: colInRow });
+      colInRow += span;
+    }
+    if (row.length > 0) cellRows.push(row);
   }
-  let widths = null;
+  let widths;
   if (cellW != null) {
     widths = Array(columns2).fill(cellW);
   } else {
     widths = Array(columns2).fill(0);
-    for (const row of rows) {
-      for (let c = 0; c < row.length; c++) {
-        const { maxWidth } = _splitBlock(row[c]);
-        if (maxWidth > widths[c]) {
-          widths[c] = maxWidth;
+    for (const r of cellRows) {
+      for (const cell of r) {
+        if (cell.span === 1) {
+          const { maxWidth } = _splitBlock(cell.block);
+          if (maxWidth > widths[cell.col]) {
+            widths[cell.col] = maxWidth;
+          }
         }
       }
     }
-  }
-  const renderedRows = rows.map((row) => {
-    const padded = [];
     for (let c = 0; c < columns2; c++) {
-      padded.push(row[c] ?? "");
+      if (widths[c] === 0) {
+        for (const r of cellRows) {
+          for (const cell of r) {
+            if (cell.col <= c && cell.col + cell.span > c) {
+              const { maxWidth } = _splitBlock(cell.block);
+              const each = Math.ceil(maxWidth / cell.span);
+              if (each > widths[c]) widths[c] = each;
+            }
+          }
+        }
+      }
     }
-    return vsplit(padded, {
+  }
+  const renderedRows = cellRows.map((row) => {
+    const mergedBlocks = [];
+    const mergedWidths = [];
+    let nextCol = 0;
+    for (const cell of row) {
+      let w = 0;
+      for (let k = 0; k < cell.span; k++) {
+        w += widths[cell.col + k];
+      }
+      w += Math.max(0, cell.span - 1) * gapX;
+      let blockToRender = cell.block;
+      if (cellH != null) {
+        blockToRender = _fitHeight(cell.block, cellH);
+      }
+      mergedBlocks.push(blockToRender);
+      mergedWidths.push(w);
+      nextCol += cell.span;
+    }
+    while (nextCol < columns2) {
+      mergedBlocks.push("");
+      mergedWidths.push(widths[nextCol]);
+      nextCol++;
+    }
+    return vsplit(mergedBlocks, {
       gap: gapX,
       align: alignY,
-      widths
+      widths: mergedWidths
     });
   });
   return hsplit(renderedRows, { gap: gapY, align: alignX });
 };
+var _fitHeight = (block, targetH) => {
+  const lines = block.split("\n");
+  if (lines.length === targetH) return block;
+  if (lines.length > targetH) return lines.slice(0, targetH).join("\n");
+  const pad = Array(targetH - lines.length).fill("");
+  return [...lines, ...pad].join("\n");
+};
 var panels = {
   vsplit,
   hsplit,
@@ -6134,8 +6191,8 @@ var _renderValue = (value, depth, config) => {
           inlineItems.push(_c(`... (${remaining} more)`, COLORS.comment, useColor));
         }
         const candidate = _c("[", COLORS.bracket, useColor) + inlineItems.join(", ") + _c("]", COLORS.bracket, useColor);
-        const visibleLen3 = candidate.replace(/\x1b\[[0-9;]*m/g, "").length;
-        if (visibleLen3 <= inlineArrayMaxLength) {
+        const visibleLen2 = candidate.replace(/\x1b\[[0-9;]*m/g, "").length;
+        if (visibleLen2 <= inlineArrayMaxLength) {
           return candidate;
         }
       }
@@ -6214,38 +6271,7 @@ var json = {
   pretty
 };
 
-// src/markdown/index.ts
-var THEMES = {
-  dark: {
-    h1: ["#ff79c6", "#bd93f9", "#8be9fd"],
-    h2: "#bd93f9",
-    h3: "#8be9fd",
-    h4: "#50fa7b",
-    h5: "#f1fa8c",
-    h6: "#ffb86c",
-    code: "#ff79c6",
-    codeBlockBorder: "#6272a4",
-    link: "#8be9fd",
-    blockquote: "#6272a4",
-    hr: "#6272a4",
-    tableHeader: "#bd93f9"
-  },
-  light: {
-    h1: ["#d63384", "#6f42c1", "#0d6efd"],
-    h2: "#6f42c1",
-    h3: "#0d6efd",
-    h4: "#198754",
-    h5: "#664d03",
-    h6: "#fd7e14",
-    code: "#d63384",
-    codeBlockBorder: "#adb5bd",
-    link: "#0d6efd",
-    blockquote: "#6c757d",
-    hr: "#adb5bd",
-    tableHeader: "#6f42c1"
-  }
-};
-var _normalize = (text) => typeof text === "string" ? text.replace(/\r\n/g, "\n").replace(/\r/g, "\n") : "";
+// src/markdown/block-parser.ts
 var HEADING_RE = /^(#{1,6})\s+(.+?)\s*#*\s*$/;
 var ORDERED_LIST_RE = /^(\s*)(\d+)[.)]\s+(.+)$/;
 var UNORDERED_LIST_RE = /^(\s*)[-*+]\s+(.+)$/;
@@ -6255,6 +6281,11 @@ var CODEBLOCK_CLOSE_RE = /^```\s*$/;
 var BLOCKQUOTE_RE = /^>\s?(.*)$/;
 var TABLE_SEPARATOR_RE = /^\|?[ \t]*:?-{2,}:?[ \t]*(\|[ \t]*:?-{2,}:?[ \t]*)+\|?[ \t]*$/;
 var TABLE_ROW_RE = /^\|.*\|[ \t]*$/;
+var _normalize = (text) => typeof text === "string" ? text.replace(/\r\n/g, "\n").replace(/\r/g, "\n") : "";
+var _splitTableRow = (row) => {
+  const stripped = row.trim().replace(/^\|/, "").replace(/\|[ \t]*$/, "");
+  return stripped.split("|").map((c) => c.trim());
+};
 var parseBlocks = (source) => {
   if (typeof source !== "string" || source.length === 0) return [];
   const lines = _normalize(source).split("\n");
@@ -6350,14 +6381,41 @@ var parseBlocks = (source) => {
   }
   return out;
 };
-var _splitTableRow = (row) => {
-  const stripped = row.trim().replace(/^\|/, "").replace(/\|[ \t]*$/, "");
-  return stripped.split("|").map((c) => c.trim());
+
+// src/markdown/theme.ts
+var THEMES = {
+  dark: {
+    h1: ["#ff79c6", "#bd93f9", "#8be9fd"],
+    h2: "#bd93f9",
+    h3: "#8be9fd",
+    h4: "#50fa7b",
+    h5: "#f1fa8c",
+    h6: "#ffb86c",
+    code: "#ff79c6",
+    codeBlockBorder: "#6272a4",
+    link: "#8be9fd",
+    blockquote: "#6272a4",
+    hr: "#6272a4",
+    tableHeader: "#bd93f9"
+  },
+  light: {
+    h1: ["#d63384", "#6f42c1", "#0d6efd"],
+    h2: "#6f42c1",
+    h3: "#0d6efd",
+    h4: "#198754",
+    h5: "#664d03",
+    h6: "#fd7e14",
+    code: "#d63384",
+    codeBlockBorder: "#adb5bd",
+    link: "#0d6efd",
+    blockquote: "#6c757d",
+    hr: "#adb5bd",
+    tableHeader: "#6f42c1"
+  }
 };
-var parseInline = (text, opts = {
-  theme: "dark",
-  inlineCodeBackground: true
-}) => {
+
+// src/markdown/inline-parser.ts
+var parseInline = (text, opts = { theme: "dark", inlineCodeBackground: true }) => {
   if (typeof text !== "string" || text.length === 0) return "";
   const t = THEMES[opts.theme];
   const codeSlots = [];
@@ -6377,6 +6435,8 @@ var parseInline = (text, opts = {
   s = s.replace(/\x00CODE(\d+)\x00/g, (_m, idx) => codeSlots[Number(idx)] ?? "");
   return s;
 };
+
+// src/markdown/renderer.ts
 var _detectWidth = () => {
   const w = process.stdout?.columns;
   return isFiniteNumber2(w) && w > 10 ? w : 80;
@@ -6471,6 +6531,8 @@ var render = (source, opts = {}) => {
   while (out.length > 0 && out[out.length - 1] === "") out.pop();
   return out.join("\n");
 };
+
+// src/markdown/index.ts
 var markdown = {
   render,
   parseBlocks,
@@ -6835,7 +6897,9 @@ export {
   clamp,
   clampByte2 as clampByte,
   clampInt,
+  clampNonNeg,
   clampPercent,
+  clampPositiveInt,
   clearAnsiCache,
   clearColorCache,
   clearLine,
@@ -6857,6 +6921,7 @@ export {
   index_default as default,
   diffLines,
   easings,
+  ensureString2 as ensureString,
   escapeForRegex,
   escapeRegex,
   fg256,

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

package/package.json

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