ansimax 1.4.0 → 1.4.2

package/dist/index.js

@@ -62,7 +62,9 @@ __export(index_exports, {
   clamp: () => clamp,
   clampByte: () => clampByte2,
   clampInt: () => clampInt,
+  clampNonNeg: () => clampNonNeg,
   clampPercent: () => clampPercent,
+  clampPositiveInt: () => clampPositiveInt,
   clearAnsiCache: () => clearAnsiCache,
   clearColorCache: () => clearColorCache,
   clearLine: () => clearLine,
@@ -84,6 +86,7 @@ __export(index_exports, {
   default: () => index_default,
   diffLines: () => diffLines,
   easings: () => easings,
+  ensureString: () => ensureString2,
   escapeForRegex: () => escapeForRegex,
   escapeRegex: () => escapeRegex,
   fg256: () => fg256,
@@ -624,6 +627,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) => {
@@ -2576,7 +2588,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}`
@@ -2715,15 +2727,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, {
@@ -2733,7 +2745,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;
@@ -2775,7 +2787,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,
@@ -2789,7 +2801,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",
@@ -2870,7 +2882,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);
@@ -2884,7 +2896,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");
@@ -2892,7 +2904,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;
@@ -3258,11 +3270,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;
@@ -3379,9 +3386,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);
@@ -3393,7 +3400,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();
       }
     };
@@ -3434,7 +3441,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();
@@ -3463,7 +3470,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);
@@ -3653,7 +3660,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);
@@ -3860,7 +3867,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;
@@ -4001,7 +4007,7 @@ var play = (frames2, opts = {}) => {
     } catch {
       rendered = frame2;
     }
-    const safe = ensureString4(rendered);
+    const safe = ensureString2(rendered);
     try {
       write(safe);
     } catch {
@@ -4111,7 +4117,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 "";
     }
@@ -4169,15 +4175,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);
@@ -4204,7 +4210,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);
@@ -4224,7 +4230,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) => {
@@ -4236,7 +4242,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);
@@ -4246,15 +4252,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)));
@@ -4301,7 +4298,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;
     })
@@ -4352,8 +4349,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();
@@ -4377,10 +4374,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);
@@ -4407,7 +4404,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);
@@ -4419,7 +4416,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);
@@ -4434,7 +4431,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;
@@ -4444,7 +4441,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(
@@ -4454,7 +4451,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)
       );
@@ -4477,15 +4474,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());
   });
@@ -4507,8 +4504,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;
@@ -4669,19 +4666,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
   };
@@ -4717,8 +4709,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;
@@ -4812,7 +4804,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 = [];
@@ -6158,37 +6150,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,
@@ -6346,8 +6406,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;
         }
       }
@@ -6426,38 +6486,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+(.+)$/;
@@ -6467,6 +6496,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");
@@ -6562,14 +6596,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 = [];
@@ -6589,6 +6650,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;
@@ -6683,6 +6746,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,
@@ -7048,7 +7113,9 @@ var index_default = ansimax;
   clamp,
   clampByte,
   clampInt,
+  clampNonNeg,
   clampPercent,
+  clampPositiveInt,
   clearAnsiCache,
   clearColorCache,
   clearLine,
@@ -7069,6 +7136,7 @@ var index_default = ansimax;
   debounce,
   diffLines,
   easings,
+  ensureString,
   escapeForRegex,
   escapeRegex,
   fg256,